From ebe6dd56d6bf2ff3a46f36cf96cedd92d22d9476 Mon Sep 17 00:00:00 2001
From: xiaoyu2er <xiaoyu2er@users.noreply.github.com>
Date: Thu, 8 May 2025 23:55:18 +0000
Subject: [PATCH] docs: update documentation translations

---
 .../framework/react/guides/basic-concepts.md  | 77 +++++++++------
 docs/ar/reference/classes/fieldapi.md         | 58 ++++++------
 docs/ar/reference/classes/formapi.md          | 72 +++++++-------
 docs/ar/reference/functions/evaluate.md       | 34 +++++++
 docs/ar/reference/index.md                    |  6 +-
 docs/ar/reference/interfaces/formstate.md     | 30 ++++--
 docs/ar/reference/type-aliases/anyfieldapi.md |  6 +-
 .../ar/reference/type-aliases/anyfieldmeta.md |  6 +-
 .../type-aliases/anyfieldmetaderived.md       |  6 +-
 docs/ar/reference/type-aliases/anyformapi.md  |  6 +-
 .../ar/reference/type-aliases/anyformstate.md |  6 +-
 .../type-aliases/derivedformstate.md          | 12 ++-
 docs/ar/reference/type-aliases/fieldmeta.md   |  6 +-
 .../type-aliases/fieldmetaderived.md          | 12 ++-
 docs/ar/reference/type-aliases/fieldstate.md  |  6 +-
 .../framework/react/guides/basic-concepts.md  | 81 ++++++++++------
 docs/de/reference/classes/fieldapi.md         | 58 ++++++------
 docs/de/reference/classes/formapi.md          | 72 +++++++-------
 docs/de/reference/functions/evaluate.md       | 34 +++++++
 docs/de/reference/index.md                    |  6 +-
 docs/de/reference/interfaces/formstate.md     | 30 ++++--
 docs/de/reference/type-aliases/anyfieldapi.md |  6 +-
 .../de/reference/type-aliases/anyfieldmeta.md |  6 +-
 .../type-aliases/anyfieldmetaderived.md       |  6 +-
 docs/de/reference/type-aliases/anyformapi.md  |  6 +-
 .../de/reference/type-aliases/anyformstate.md |  6 +-
 .../type-aliases/derivedformstate.md          | 12 ++-
 docs/de/reference/type-aliases/fieldmeta.md   |  6 +-
 .../type-aliases/fieldmetaderived.md          | 12 ++-
 docs/de/reference/type-aliases/fieldstate.md  |  6 +-
 .../framework/react/guides/basic-concepts.md  | 57 ++++++++----
 docs/es/reference/classes/fieldapi.md         | 58 ++++++------
 docs/es/reference/classes/formapi.md          | 72 +++++++-------
 docs/es/reference/functions/evaluate.md       | 34 +++++++
 docs/es/reference/index.md                    |  6 +-
 docs/es/reference/interfaces/formstate.md     | 30 ++++--
 docs/es/reference/type-aliases/anyfieldapi.md |  6 +-
 .../es/reference/type-aliases/anyfieldmeta.md |  6 +-
 .../type-aliases/anyfieldmetaderived.md       |  6 +-
 docs/es/reference/type-aliases/anyformapi.md  |  6 +-
 .../es/reference/type-aliases/anyformstate.md |  6 +-
 .../type-aliases/derivedformstate.md          | 12 ++-
 docs/es/reference/type-aliases/fieldmeta.md   |  6 +-
 .../type-aliases/fieldmetaderived.md          | 12 ++-
 docs/es/reference/type-aliases/fieldstate.md  |  6 +-
 .../framework/react/guides/basic-concepts.md  | 81 ++++++++++------
 docs/fr/reference/classes/fieldapi.md         | 58 ++++++------
 docs/fr/reference/classes/formapi.md          | 72 +++++++-------
 docs/fr/reference/functions/evaluate.md       | 34 +++++++
 docs/fr/reference/index.md                    |  6 +-
 docs/fr/reference/interfaces/formstate.md     | 30 ++++--
 docs/fr/reference/type-aliases/anyfieldapi.md |  6 +-
 .../fr/reference/type-aliases/anyfieldmeta.md |  6 +-
 .../type-aliases/anyfieldmetaderived.md       |  6 +-
 docs/fr/reference/type-aliases/anyformapi.md  |  6 +-
 .../fr/reference/type-aliases/anyformstate.md |  6 +-
 .../type-aliases/derivedformstate.md          | 12 ++-
 docs/fr/reference/type-aliases/fieldmeta.md   |  6 +-
 .../type-aliases/fieldmetaderived.md          | 12 ++-
 docs/fr/reference/type-aliases/fieldstate.md  |  6 +-
 .../framework/react/guides/basic-concepts.md  | 84 ++++++++++-------
 docs/ja/reference/classes/fieldapi.md         | 58 ++++++------
 docs/ja/reference/classes/formapi.md          | 72 +++++++-------
 docs/ja/reference/functions/evaluate.md       | 34 +++++++
 docs/ja/reference/index.md                    |  6 +-
 docs/ja/reference/interfaces/formstate.md     | 30 ++++--
 docs/ja/reference/type-aliases/anyfieldapi.md |  6 +-
 .../ja/reference/type-aliases/anyfieldmeta.md |  6 +-
 .../type-aliases/anyfieldmetaderived.md       |  6 +-
 docs/ja/reference/type-aliases/anyformapi.md  |  6 +-
 .../ja/reference/type-aliases/anyformstate.md |  6 +-
 .../type-aliases/derivedformstate.md          | 12 ++-
 docs/ja/reference/type-aliases/fieldmeta.md   |  6 +-
 .../type-aliases/fieldmetaderived.md          | 12 ++-
 docs/ja/reference/type-aliases/fieldstate.md  |  6 +-
 .../framework/react/guides/basic-concepts.md  | 93 ++++++++++++-------
 docs/ru/reference/classes/fieldapi.md         | 58 ++++++------
 docs/ru/reference/classes/formapi.md          | 72 +++++++-------
 docs/ru/reference/functions/evaluate.md       | 34 +++++++
 docs/ru/reference/index.md                    |  6 +-
 docs/ru/reference/interfaces/formstate.md     | 30 ++++--
 docs/ru/reference/type-aliases/anyfieldapi.md |  6 +-
 .../ru/reference/type-aliases/anyfieldmeta.md |  6 +-
 .../type-aliases/anyfieldmetaderived.md       |  6 +-
 docs/ru/reference/type-aliases/anyformapi.md  |  6 +-
 .../ru/reference/type-aliases/anyformstate.md |  6 +-
 .../type-aliases/derivedformstate.md          | 12 ++-
 docs/ru/reference/type-aliases/fieldmeta.md   |  6 +-
 .../type-aliases/fieldmetaderived.md          | 12 ++-
 docs/ru/reference/type-aliases/fieldstate.md  |  6 +-
 .../framework/react/guides/basic-concepts.md  | 75 +++++++++------
 docs/zh-hans/reference/classes/fieldapi.md    | 58 ++++++------
 docs/zh-hans/reference/classes/formapi.md     | 72 +++++++-------
 docs/zh-hans/reference/functions/evaluate.md  | 34 +++++++
 docs/zh-hans/reference/index.md               |  6 +-
 .../zh-hans/reference/interfaces/formstate.md | 30 ++++--
 .../reference/type-aliases/anyfieldapi.md     |  6 +-
 .../reference/type-aliases/anyfieldmeta.md    |  6 +-
 .../type-aliases/anyfieldmetaderived.md       |  6 +-
 .../reference/type-aliases/anyformapi.md      |  6 +-
 .../reference/type-aliases/anyformstate.md    |  6 +-
 .../type-aliases/derivedformstate.md          | 12 ++-
 .../reference/type-aliases/fieldmeta.md       |  6 +-
 .../type-aliases/fieldmetaderived.md          | 12 ++-
 .../reference/type-aliases/fieldstate.md      |  6 +-
 .../framework/react/guides/basic-concepts.md  | 79 ++++++++++------
 docs/zh-hant/reference/classes/fieldapi.md    | 58 ++++++------
 docs/zh-hant/reference/classes/formapi.md     | 72 +++++++-------
 docs/zh-hant/reference/functions/evaluate.md  | 34 +++++++
 docs/zh-hant/reference/index.md               |  6 +-
 .../zh-hant/reference/interfaces/formstate.md | 30 ++++--
 .../reference/type-aliases/anyfieldapi.md     |  6 +-
 .../reference/type-aliases/anyfieldmeta.md    |  6 +-
 .../type-aliases/anyfieldmetaderived.md       |  6 +-
 .../reference/type-aliases/anyformapi.md      |  6 +-
 .../reference/type-aliases/anyformstate.md    |  6 +-
 .../type-aliases/derivedformstate.md          | 12 ++-
 .../reference/type-aliases/fieldmeta.md       |  6 +-
 .../type-aliases/fieldmetaderived.md          | 12 ++-
 .../reference/type-aliases/fieldstate.md      |  6 +-
 120 files changed, 1742 insertions(+), 1013 deletions(-)
 create mode 100644 docs/ar/reference/functions/evaluate.md
 create mode 100644 docs/de/reference/functions/evaluate.md
 create mode 100644 docs/es/reference/functions/evaluate.md
 create mode 100644 docs/fr/reference/functions/evaluate.md
 create mode 100644 docs/ja/reference/functions/evaluate.md
 create mode 100644 docs/ru/reference/functions/evaluate.md
 create mode 100644 docs/zh-hans/reference/functions/evaluate.md
 create mode 100644 docs/zh-hant/reference/functions/evaluate.md

diff --git a/docs/ar/framework/react/guides/basic-concepts.md b/docs/ar/framework/react/guides/basic-concepts.md
index eb3c1a8d9..61a98fa94 100644
--- a/docs/ar/framework/react/guides/basic-concepts.md
+++ b/docs/ar/framework/react/guides/basic-concepts.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-16T08:45:06.000Z'
-translation-updated-at: '2025-04-30T22:06:06.532Z'
+source-updated-at: '2025-05-08T07:42:29.000Z'
+translation-updated-at: '2025-05-08T23:54:45.818Z'
 id: basic-concepts
 title: المفاهيم الأساسية
 ---
@@ -9,7 +9,7 @@ title: المفاهيم الأساسية
 
 ## خيارات النموذج (Form Options)
 
-يمكنك إنشاء خيارات للنموذج بحيث يمكن مشاركتها بين عدة نماذج باستخدام الدالة `formOptions`.
+يمكنك إنشاء خيارات لنموذجك حتى يمكن مشاركتها بين عدة نماذج باستخدام دالة `formOptions`.
 
 مثال:
 
@@ -28,19 +28,19 @@ const formOpts = formOptions({
 
 ## نسخة النموذج (Form Instance)
 
-نسخة النموذج (Form Instance) هي كائن يمثل نموذجًا فرديًا ويوفر طرقًا وخصائص للعمل مع النموذج. يمكنك إنشاء نسخة نموذج باستخدام الخطاف `useForm` المقدم من خيارات النموذج. يقبل الخطاف كائنًا يحتوي على دالة `onSubmit`، والتي يتم استدعاؤها عند إرسال النموذج.
+نسخة النموذج (Form Instance) هي كائن يمثل نموذجًا فرديًا ويوفر طرقًا وخصائص للعمل مع النموذج. يمكنك إنشاء نسخة نموذج باستخدام الخطاف (hook) `useForm` المقدم من خيارات النموذج. يقبل الخطاف كائنًا يحتوي على دالة `onSubmit`، والتي يتم استدعاؤها عند تقديم النموذج.
 
 ```tsx
 const form = useForm({
   ...formOpts,
   onSubmit: async ({ value }) => {
-    // افعل شيئًا ببيانات النموذج
+    // القيام بشيء ما ببيانات النموذج
     console.log(value)
   },
 })
 ```
 
-يمكنك أيضًا إنشاء نسخة نموذج دون استخدام `formOptions` باستخدام واجهة `useForm` المستقلة:
+يمكنك أيضًا إنشاء نسخة نموذج دون استخدام `formOptions` باستخدام واجهة برمجة التطبيقات (API) المستقلة `useForm`:
 
 ```tsx
 interface User {
@@ -53,7 +53,7 @@ const defaultUser: User = { firstName: '', lastName: '', hobbies: [] }
 const form = useForm({
   defaultValues: defaultUser,
   onSubmit: async ({ value }) => {
-    // افعل شيئًا ببيانات النموذج
+    // القيام بشيء ما ببيانات النموذج
     console.log(value)
   },
 })
@@ -61,7 +61,7 @@ const form = useForm({
 
 ## الحقل (Field)
 
-الحقل (Field) يمثل عنصر إدخال فردي في النموذج، مثل حقل نصي أو خانة اختيار. يتم إنشاء الحقول باستخدام مكون `form.Field` المقدم من نسخة النموذج. يقبل المكون خاصية `name`، والتي يجب أن تطابق مفتاحًا في القيم الافتراضية للنموذج. كما يقبل خاصية `children`، وهي دالة عرض تأخذ كائن الحقل كوسيط.
+الحقل (Field) يمثل عنصر إدخال فردي في النموذج، مثل حقل نصي أو خانة اختيار. يتم إنشاء الحقول باستخدام مكون `form.Field` المقدم من نسخة النموذج. يقبل المكون خاصية `name`، والتي يجب أن تطابق مفتاحًا في القيم الافتراضية للنموذج. كما يقبل خاصية `children`، وهي دالة عرض (render prop) تأخذ كائن حقل كوسيط لها.
 
 مثال:
 
@@ -94,7 +94,11 @@ const {
 } = field.state
 ```
 
-هناك ثلاث حالات للحقل يمكن أن تكون مفيدة لمعرفة كيفية تفاعل المستخدم مع الحقل: الحقل يكون _"ملموسًا" (touched)_ عندما ينقر/ينتقل إليه المستخدم، _"نقيًا" (pristine)_ حتى يغير المستخدم قيمته، و _"متسخًا" (dirty)_ بعد تغيير القيمة. يمكنك التحقق من هذه الحالات عبر العلامات `isTouched`، `isPristine` و `isDirty`، كما هو موضح أدناه.
+هناك ثلاث حالات في البيانات الوصفية يمكن أن تكون مفيدة لمعرفة كيفية تفاعل المستخدم مع الحقل:
+
+- _"isTouched"_: بعد أن ينقر المستخدم/ينتقل إلى الحقل
+- _"isPristine"_: حتى يغير المستخدم قيمة الحقل
+- _"isDirty"_: بعد تغيير قيمة الحقل
 
 ```tsx
 const { isTouched, isPristine, isDirty } = field.state.meta
@@ -102,13 +106,32 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 
 ![حالات الحقل](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states.png)
 
-> **ملاحظة مهمة للمستخدمين القادمين من `React Hook Form`**: العلامة `isDirty` في `TanStack/form` تختلف عن العلامة بنفس الاسم في RHF.
-> في RHF، `isDirty = true`، عندما تكون قيم النموذج مختلفة عن القيم الأصلية. إذا قام المستخدم بتغيير القيم في نموذج، ثم غيرها مرة أخرى لينتهي بقيم تطابق القيم الافتراضية للنموذج، فإن `isDirty` ستكون `false` في RHF، ولكن `true` في `TanStack/form`.
-> القيم الافتراضية متاحة على مستوى النموذج والحقل في `TanStack/form` (`form.options.defaultValues`، `field.options.defaultValue`)، لذا يمكنك كتابة مساعد `isDefaultValue()` الخاص بك إذا كنت بحاجة إلى محاكاة سلوك RHF.
+## فهم 'isDirty' في المكتبات المختلفة
+
+حالة `dirty` غير الدائمة (Non-Persistent)
+
+- **المكتبات**: React Hook Form (RHF), Formik, Final Form.
+- **السلوك**: الحقل يكون 'dirty' إذا اختلفت قيمته عن القيمة الافتراضية. العودة إلى القيمة الافتراضية تجعله 'نظيفًا' مرة أخرى.
+
+حالة `dirty` الدائمة (Persistent)
+
+- **المكتبات**: Angular Form, Vue FormKit.
+- **السلوك**: يبقى الحقل 'dirty' بمجرد تغييره، حتى إذا عاد إلى القيمة الافتراضية.
+
+لقد اخترنا نموذج حالة 'dirty' الدائمة. لدعم حالة 'dirty' غير الدائمة أيضًا، نقدم العلامة `isDefault`. تعمل هذه العلامة كعكس لحالة 'dirty' غير الدائمة.
+
+```tsx
+const { isTouched, isPristine, isDirty, isDefaultValue } = field.state.meta
+
+// السطر التالي يعيد إنشاء وظيفة حالة `dirty` غير الدائمة.
+const nonPersistentIsDirty = !isDefaultValue
+```
+
+![حالات الحقل الممتدة](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states-extended.png)
 
-## واجهة الحقل (Field API)
+## واجهة برمجة تطبيقات الحقل (Field API)
 
-واجهة الحقل (Field API) هي كائن يتم تمريره إلى دالة العرض عند إنشاء حقل. توفر طرقًا للعمل مع حالة الحقل.
+واجهة برمجة تطبيقات الحقل (Field API) هي كائن يتم تمريره إلى دالة العرض (render prop) عند إنشاء حقل. توفر طرقًا للعمل مع حالة الحقل.
 
 مثال:
 
@@ -132,13 +155,13 @@ const { isTouched, isPristine, isDirty } = field.state.meta
   validators={{
     onChange: ({ value }) =>
       !value
-        ? 'اسم الأول مطلوب'
+        ? 'الاسم الأول مطلوب'
         : value.length < 3
-          ? 'يجب أن يكون اسم الأول على الأقل 3 أحرف'
+          ? 'يجب أن يكون الاسم الأول على الأقل 3 أحرف'
           : undefined,
     onChangeAsync: async ({ value }) => {
       await new Promise((resolve) => setTimeout(resolve, 1000))
-      return value.includes('error') && 'غير مسموح بـ "error" في اسم الأول'
+      return value.includes('error') && 'غير مسموح بكلمة "error" في الاسم الأول'
     },
   }}
   children={(field) => (
@@ -197,7 +220,7 @@ function App() {
 
 ## التفاعلية (Reactivity)
 
-توفر `@tanstack/react-form` طرقًا مختلفة للاشتراك في تغييرات حالة النموذج والحقل، أبرزها خطاف `useStore(form.store)` ومكون `form.Subscribe`. تتيح لك هذه الطرق تحسين أداء عرض النموذج عن طريق تحديث المكونات فقط عند الضرورة.
+توفر `@tanstack/react-form` طرقًا مختلفة للاشتراك في تغييرات حالة النموذج والحقل، أبرزها الخطاف `useStore(form.store)` ومكون `form.Subscribe`. تتيح لك هذه الطرق تحسين أداء عرض النموذج عن طريق تحديث المكونات فقط عند الضرورة.
 
 مثال:
 
@@ -214,21 +237,21 @@ const firstName = useStore(form.store, (state) => state.values.firstName)
 />
 ```
 
-من المهم تذكر أنه بينما خاصية `selector` لخطاف `useStore` اختيارية، يوصى بشدة بتوفير واحدة، لأن حذفها سيؤدي إلى إعادة عرض غير ضرورية.
+من المهم تذكر أنه بينما خاصية `selector` في الخطاف `useStore` اختيارية، يوصى بشدة بتوفير واحدة، لأن حذفها سيؤدي إلى إعادة عرض غير ضرورية.
 
 ```tsx
-// استخدام صحيح
+// الاستخدام الصحيح
 const firstName = useStore(form.store, (state) => state.values.firstName)
 const errors = useStore(form.store, (state) => state.errorMap)
-// استخدام غير صحيح
+// الاستخدام غير الصحيح
 const store = useStore(form.store)
 ```
 
-ملاحظة: استخدام خطاف `useField` لتحقيق التفاعلية غير موصى به لأنه مصمم لاستخدام مدروس داخل مكون `form.Field`. قد ترغب في استخدام `useStore(form.store)` بدلاً من ذلك.
+ملاحظة: يُنصح بعدم استخدام الخطاف `useField` لتحقيق التفاعلية لأنه مصمم لاستخدام مدروس داخل مكون `form.Field`. قد ترغب في استخدام `useStore(form.store)` بدلاً من ذلك.
 
 ## المستمعون (Listeners)
 
-تسمح لك `@tanstack/react-form` بالتفاعل مع محفزات محدثة و"الاستماع" إليها لتنفيذ تأثيرات جانبية.
+تتيح لك `@tanstack/react-form` الاستجابة لمحفزات محددة و"الاستماع" إليها لتنفيذ تأثيرات جانبية.
 
 مثال:
 
@@ -244,11 +267,11 @@ const store = useStore(form.store)
 />
 ```
 
-يمكن العثور على مزيد من المعلومات في [المستمعون](./listeners.md)
+يمكن العثور على المزيد من المعلومات في [المستمعون](./listeners.md)
 
 ## حقول المصفوفة (Array Fields)
 
-تسمح حقول المصفوفة (Array Fields) بإدارة قائمة من القيم داخل النموذج، مثل قائمة الهوايات. يمكنك إنشاء حقل مصفوفة باستخدام مكون `form.Field` مع خاصية `mode="array"`.
+تتيح لك حقول المصفوفة (Array Fields) إدارة قائمة من القيم داخل النموذج، مثل قائمة الهوايات. يمكنك إنشاء حقل مصفوفة باستخدام مكون `form.Field` مع خاصية `mode="array"`.
 
 عند العمل مع حقول المصفوفة، يمكنك استخدام طرق الحقول `pushValue`، `removeValue`، `swapValues` و `moveValue` لإضافة، إزالة، وتبديل القيم في المصفوفة.
 
@@ -330,8 +353,8 @@ const store = useStore(form.store)
 
 ## أزرار إعادة التعيين (Reset Buttons)
 
-عند استخدام `<button type="reset">` بالاقتران مع `form.reset()` من TanStack Form، تحتاج إلى منع سلوك إعادة تعيين HTML الافتراضي لتجنب إعادة تعيين غير متوقعة لعناصر النموذج (خاصة عناصر `<select>`) إلى قيم HTML الأولية.
-استخدم `event.preventDefault()` داخل معالج `onClick` للزر لمنع إعادة التعيين الأصلية للنموذج.
+عند استخدام `<button type="reset">` مع دالة `form.reset()` من TanStack Form، تحتاج إلى منع سلوك إعادة تعيين HTML الافتراضي لتجنب إعادة تعيين غير متوقعة لعناصر النموذج (خاصة عناصر `<select>`) إلى قيم HTML الأولية.
+استخدم `event.preventDefault()` داخل معالج النقر (`onClick`) للزر لمنع إعادة التعيين الأصلية.
 
 مثال:
 
diff --git a/docs/ar/reference/classes/fieldapi.md b/docs/ar/reference/classes/fieldapi.md
index 9772e2882..7a95b76db 100644
--- a/docs/ar/reference/classes/fieldapi.md
+++ b/docs/ar/reference/classes/fieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:53:48.944Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.068Z'
 id: FieldApi
 title: FieldApi
 ---
@@ -9,7 +9,7 @@ title: FieldApi
 
 # Class: FieldApi\<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta\>
 
-Defined in: [packages/form-core/src/FieldApi.ts:859](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L859)
+Defined in: [packages/form-core/src/FieldApi.ts:863](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L863)
 
 A class representing the API for managing a form field.
 
@@ -67,7 +67,7 @@ the `new FieldApi` constructor.
 new FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>(opts): FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:991](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L991)
+Defined in: [packages/form-core/src/FieldApi.ts:995](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L995)
 
 Initializes a new `FieldApi` instance.
 
@@ -89,7 +89,7 @@ Initializes a new `FieldApi` instance.
 form: FormApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:903](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L903)
+Defined in: [packages/form-core/src/FieldApi.ts:907](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L907)
 
 A reference to the form API instance.
 
@@ -101,7 +101,7 @@ A reference to the form API instance.
 name: DeepKeys<TParentData>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:927](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L927)
+Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
 
 The field name.
 
@@ -113,7 +113,7 @@ The field name.
 options: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
+Defined in: [packages/form-core/src/FieldApi.ts:935](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L935)
 
 The field options.
 
@@ -125,7 +125,7 @@ The field options.
 store: Derived<FieldState<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:955](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L955)
+Defined in: [packages/form-core/src/FieldApi.ts:959](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L959)
 
 The field state store.
 
@@ -137,7 +137,7 @@ The field state store.
 timeoutIds: object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:982](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L982)
+Defined in: [packages/form-core/src/FieldApi.ts:986](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L986)
 
 #### formListeners
 
@@ -167,7 +167,7 @@ validations: Record<ValidationCause, null | Timeout>;
 get state(): FieldState<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:979](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L979)
+Defined in: [packages/form-core/src/FieldApi.ts:983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L983)
 
 The current field state.
 
@@ -183,7 +183,7 @@ The current field state.
 getInfo(): FieldInfo<TParentData>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1245](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1245)
+Defined in: [packages/form-core/src/FieldApi.ts:1249](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1249)
 
 Gets the field information object.
 
@@ -199,7 +199,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:1213](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1213)
+Defined in: [packages/form-core/src/FieldApi.ts:1217](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1217)
 
 #### Returns
 
@@ -213,7 +213,7 @@ Defined in: [packages/form-core/src/FieldApi.ts:1213](https://github.com/TanStac
 getValue(): TData
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1198](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1198)
+Defined in: [packages/form-core/src/FieldApi.ts:1202](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1202)
 
 Gets the current field value.
 
@@ -233,7 +233,7 @@ Use `field.state.value` instead.
 handleBlur(): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1657](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1657)
+Defined in: [packages/form-core/src/FieldApi.ts:1661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1661)
 
 Handles the blur event.
 
@@ -249,7 +249,7 @@ Handles the blur event.
 handleChange(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1650](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1650)
+Defined in: [packages/form-core/src/FieldApi.ts:1654](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1654)
 
 Handles the change event.
 
@@ -274,7 +274,7 @@ insertValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1262](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1262)
+Defined in: [packages/form-core/src/FieldApi.ts:1266](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1266)
 
 Inserts a value at the specified index, shifting the subsequent values to the right.
 
@@ -304,7 +304,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:1088](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1088)
+Defined in: [packages/form-core/src/FieldApi.ts:1092](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1092)
 
 Mounts the field instance to the form.
 
@@ -327,7 +327,7 @@ moveValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1306](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1306)
+Defined in: [packages/form-core/src/FieldApi.ts:1310](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1310)
 
 Moves the value at the first specified index to the second specified index.
 
@@ -359,7 +359,7 @@ parseValueWithSchema(schema):
   | StandardSchemaV1Issue[]
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1699](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1699)
+Defined in: [packages/form-core/src/FieldApi.ts:1703](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1703)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -387,7 +387,7 @@ parseValueWithSchemaAsync(schema): Promise<
 | StandardSchemaV1Issue[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1711](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1711)
+Defined in: [packages/form-core/src/FieldApi.ts:1715](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1715)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -414,7 +414,7 @@ The standard schema to parse this field's value with.
 pushValue(value, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1250](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1250)
+Defined in: [packages/form-core/src/FieldApi.ts:1254](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1254)
 
 Pushes a new value to the field.
 
@@ -440,7 +440,7 @@ Pushes a new value to the field.
 removeValue(index, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1288](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1288)
+Defined in: [packages/form-core/src/FieldApi.ts:1292](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1292)
 
 Removes a value at the specified index.
 
@@ -469,7 +469,7 @@ replaceValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1275](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1275)
+Defined in: [packages/form-core/src/FieldApi.ts:1279](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1279)
 
 Replaces a value at the specified index.
 
@@ -499,7 +499,7 @@ Replaces a value at the specified index.
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1674](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1674)
+Defined in: [packages/form-core/src/FieldApi.ts:1678](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1678)
 
 Updates the field's errorMap
 
@@ -521,7 +521,7 @@ Updates the field's errorMap
 setMeta(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1218](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1218)
+Defined in: [packages/form-core/src/FieldApi.ts:1222](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1222)
 
 Sets the field metadata.
 
@@ -543,7 +543,7 @@ Sets the field metadata.
 setValue(updater, options?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1205](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1205)
+Defined in: [packages/form-core/src/FieldApi.ts:1209](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1209)
 
 Sets the field value and run the `change` validator.
 
@@ -572,7 +572,7 @@ swapValues(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1297](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1297)
+Defined in: [packages/form-core/src/FieldApi.ts:1301](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1301)
 
 Swaps the values at the specified indices.
 
@@ -602,7 +602,7 @@ Swaps the values at the specified indices.
 update(opts): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1141](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1141)
+Defined in: [packages/form-core/src/FieldApi.ts:1145](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1145)
 
 Updates the field instance with new options.
 
@@ -624,7 +624,7 @@ Updates the field instance with new options.
 validate(cause, opts?): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1617](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1617)
+Defined in: [packages/form-core/src/FieldApi.ts:1621](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1621)
 
 Validates the field value.
 
diff --git a/docs/ar/reference/classes/formapi.md b/docs/ar/reference/classes/formapi.md
index 173f14333..af4f17ed0 100644
--- a/docs/ar/reference/classes/formapi.md
+++ b/docs/ar/reference/classes/formapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:53:48.940Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.063Z'
 id: FormApi
 title: FormApi
 ---
@@ -9,7 +9,7 @@ title: FormApi
 
 # Class: FormApi\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta\>
 
-Defined in: [packages/form-core/src/FormApi.ts:767](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L767)
+Defined in: [packages/form-core/src/FormApi.ts:771](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L771)
 
 A class representing the Form API. It handles the logic and interactions with the form state.
 
@@ -47,7 +47,7 @@ However, if you need to create a new instance manually, you can do so by calling
 new FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>(opts?): FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:838](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L838)
+Defined in: [packages/form-core/src/FormApi.ts:842](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L842)
 
 Constructs a new `FormApi` instance with the given form options.
 
@@ -69,7 +69,7 @@ Constructs a new `FormApi` instance with the given form options.
 baseStore: Store<BaseFormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L794)
+Defined in: [packages/form-core/src/FormApi.ts:798](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L798)
 
 ***
 
@@ -79,7 +79,7 @@ Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/
 fieldInfo: Record<DeepKeys<TFormData>, FieldInfo<TFormData>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:824](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L824)
+Defined in: [packages/form-core/src/FormApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L828)
 
 A record of field information for each field in the form.
 
@@ -91,7 +91,7 @@ A record of field information for each field in the form.
 fieldMetaDerived: Derived<Record<DeepKeys<TFormData>, AnyFieldMeta>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L807)
+Defined in: [packages/form-core/src/FormApi.ts:811](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L811)
 
 ***
 
@@ -101,7 +101,7 @@ Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/
 options: FormOptions<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta> = {};
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:782](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L782)
+Defined in: [packages/form-core/src/FormApi.ts:786](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L786)
 
 The options for the form.
 
@@ -113,7 +113,7 @@ The options for the form.
 store: Derived<FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L808)
+Defined in: [packages/form-core/src/FormApi.ts:812](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L812)
 
 ## Accessors
 
@@ -125,7 +125,7 @@ Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/
 get state(): FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L826)
+Defined in: [packages/form-core/src/FormApi.ts:830](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L830)
 
 ##### Returns
 
@@ -139,7 +139,7 @@ Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/
 deleteField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1912)
+Defined in: [packages/form-core/src/FormApi.ts:1938](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1938)
 
 #### Type Parameters
 
@@ -163,7 +163,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack
 getAllErrors(): object
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2148](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2148)
+Defined in: [packages/form-core/src/FormApi.ts:2174](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2174)
 
 Returns form and field level errors
 
@@ -214,7 +214,7 @@ errors: (
 getFieldInfo<TField>(field): FieldInfo<TFormData>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1826)
+Defined in: [packages/form-core/src/FormApi.ts:1852](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1852)
 
 Gets the field info of the specified field.
 
@@ -240,7 +240,7 @@ Gets the field info of the specified field.
 getFieldMeta<TField>(field): undefined | AnyFieldMeta
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1817](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1817)
+Defined in: [packages/form-core/src/FormApi.ts:1843](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1843)
 
 Gets the metadata of the specified field.
 
@@ -266,7 +266,7 @@ Gets the metadata of the specified field.
 getFieldValue<TField>(field): DeepValue<TFormData, TField>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1810](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1810)
+Defined in: [packages/form-core/src/FormApi.ts:1836](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1836)
 
 Gets the value of the specified field.
 
@@ -294,7 +294,7 @@ Gets the value of the specified field.
 handleSubmit(): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1712](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1712)
+Defined in: [packages/form-core/src/FormApi.ts:1738](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1738)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -308,7 +308,7 @@ Handles the form submission, performs validation, and calls the appropriate onSu
 handleSubmit(submitMeta): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1713](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1713)
+Defined in: [packages/form-core/src/FormApi.ts:1739](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1739)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -334,7 +334,7 @@ insertFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1951)
+Defined in: [packages/form-core/src/FormApi.ts:1977](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1977)
 
 #### Type Parameters
 
@@ -370,7 +370,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack
 mount(): () => void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1142](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1142)
+Defined in: [packages/form-core/src/FormApi.ts:1168](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1168)
 
 #### Returns
 
@@ -392,7 +392,7 @@ moveFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2075](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2075)
+Defined in: [packages/form-core/src/FormApi.ts:2101](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2101)
 
 Moves the value at the first specified index to the second specified index within an array field.
 
@@ -435,7 +435,7 @@ parseValuesWithSchema(schema):
 }
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2208](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2208)
+Defined in: [packages/form-core/src/FormApi.ts:2234](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2234)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -469,7 +469,7 @@ parseValuesWithSchemaAsync(schema): Promise<
 }>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2220](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2220)
+Defined in: [packages/form-core/src/FormApi.ts:2246](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2246)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -502,7 +502,7 @@ pushFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1936](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1936)
+Defined in: [packages/form-core/src/FormApi.ts:1962](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1962)
 
 Pushes a value into an array field.
 
@@ -539,7 +539,7 @@ removeFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
+Defined in: [packages/form-core/src/FormApi.ts:2035](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2035)
 
 Removes a value from an array field at the specified index.
 
@@ -577,7 +577,7 @@ replaceFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1983)
+Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
 
 Replaces a value into an array field at the specified index.
 
@@ -615,7 +615,7 @@ Replaces a value into an array field at the specified index.
 reset(values?, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1230](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1230)
+Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
 
 Resets the form state to the default values.
 If values are provided, the form will be reset to those values instead and the default values will be updated.
@@ -648,7 +648,7 @@ Optional options to control the reset behavior.
 resetField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2103](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2103)
+Defined in: [packages/form-core/src/FormApi.ts:2129](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2129)
 
 Resets the field value and meta to default state
 
@@ -674,7 +674,7 @@ Resets the field value and meta to default state
 resetFieldMeta<TField>(fieldMeta): Record<TField, AnyFieldMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1866](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1866)
+Defined in: [packages/form-core/src/FormApi.ts:1892](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1892)
 
 resets every field's meta
 
@@ -700,7 +700,7 @@ resets every field's meta
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2124](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2124)
+Defined in: [packages/form-core/src/FormApi.ts:2150](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2150)
 
 Updates the form's errorMap
 
@@ -722,7 +722,7 @@ Updates the form's errorMap
 setFieldMeta<TField>(field, updater): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1845](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1845)
+Defined in: [packages/form-core/src/FormApi.ts:1871](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1871)
 
 Updates the metadata of the specified field.
 
@@ -755,7 +755,7 @@ setFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1882](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1882)
+Defined in: [packages/form-core/src/FormApi.ts:1908](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1908)
 
 Sets the value of the specified field and optionally updates the touched state.
 
@@ -793,7 +793,7 @@ swapFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2046](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2046)
+Defined in: [packages/form-core/src/FormApi.ts:2072](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2072)
 
 Swaps the values at the specified indices within an array field.
 
@@ -831,7 +831,7 @@ Swaps the values at the specified indices within an array field.
 update(options?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1162](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1162)
+Defined in: [packages/form-core/src/FormApi.ts:1188](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1188)
 
 Updates the form options and form state.
 
@@ -853,7 +853,7 @@ Updates the form options and form state.
 validateAllFields(cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
+Defined in: [packages/form-core/src/FormApi.ts:1282](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1282)
 
 Validates all fields using the correct handlers for a given validation cause.
 
@@ -878,7 +878,7 @@ validateArrayFieldsStartingFrom<TField>(
 cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1286](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1286)
+Defined in: [packages/form-core/src/FormApi.ts:1312](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1312)
 
 Validates the children of a specified array in the form starting from a given index until the end using the correct handlers for a given validation type.
 
@@ -912,7 +912,7 @@ Validates the children of a specified array in the form starting from a given in
 validateField<TField>(field, cause): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1325](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1325)
+Defined in: [packages/form-core/src/FormApi.ts:1351](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1351)
 
 Validates a specified field in the form using the correct handlers for a given validation type.
 
diff --git a/docs/ar/reference/functions/evaluate.md b/docs/ar/reference/functions/evaluate.md
new file mode 100644
index 000000000..5491cf19f
--- /dev/null
+++ b/docs/ar/reference/functions/evaluate.md
@@ -0,0 +1,34 @@
+---
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.060Z'
+id: evaluate
+title: evaluate
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: evaluate()
+
+```ts
+function evaluate<T>(objA, objB): boolean
+```
+
+Defined in: [packages/form-core/src/utils.ts:339](https://github.com/TanStack/form/blob/main/packages/form-core/src/utils.ts#L339)
+
+## Type Parameters
+
+• **T**
+
+## Parameters
+
+### objA
+
+`T`
+
+### objB
+
+`T`
+
+## Returns
+
+`boolean`
diff --git a/docs/ar/reference/index.md b/docs/ar/reference/index.md
index dc0af0f66..f05546368 100644
--- a/docs/ar/reference/index.md
+++ b/docs/ar/reference/index.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-25T12:58:29.000Z'
-translation-updated-at: '2025-04-30T22:44:29.661Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.024Z'
 id: '@tanstack/form-core'
 title: '@tanstack/form-core'
 ---
@@ -84,8 +84,8 @@ title: '@tanstack/form-core'
 
 ## Functions
 
+- [evaluate](functions/evaluate.md)
 - [formOptions](functions/formoptions.md)
 - [isGlobalFormValidationError](functions/isglobalformvalidationerror.md)
 - [isStandardSchemaValidator](functions/isstandardschemavalidator.md)
 - [mergeForm](functions/mergeform.md)
-- [shallow](functions/shallow.md)
diff --git a/docs/ar/reference/interfaces/formstate.md b/docs/ar/reference/interfaces/formstate.md
index f2abc97da..6c28f0694 100644
--- a/docs/ar/reference/interfaces/formstate.md
+++ b/docs/ar/reference/interfaces/formstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:27:39.463Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.016Z'
 id: FormState
 title: FormState
 ---
@@ -9,7 +9,7 @@ title: FormState
 
 # Interface: FormState\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer\>
 
-Defined in: [packages/form-core/src/FormApi.ts:643](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L643)
+Defined in: [packages/form-core/src/FormApi.ts:647](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L647)
 
 An object representing the current state of the form.
 
@@ -63,7 +63,7 @@ BaseFormState._force_re_eval
 canSubmit: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
+Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
 
 A boolean indicating if the form can be submitted based on its current state.
 
@@ -125,7 +125,7 @@ DerivedFormState.errors
 fieldMeta: Record<DeepKeys<TFormData>, AnyFieldMeta>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
+Defined in: [packages/form-core/src/FormApi.ts:644](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L644)
 
 A record of field metadata for each field in the form.
 
@@ -173,6 +173,24 @@ DerivedFormState.isBlurred
 
 ***
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+
+A boolean indicating if all of the form's fields are the same as default values.
+
+#### Inherited from
+
+```ts
+DerivedFormState.isDefaultValue
+```
+
+***
+
 ### isDirty
 
 ```ts
@@ -371,7 +389,7 @@ DerivedFormState.isTouched
 isValid: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
 
 A boolean indicating if the form and all its fields are valid. Evaluates `true` if there are no errors.
 
diff --git a/docs/ar/reference/type-aliases/anyfieldapi.md b/docs/ar/reference/type-aliases/anyfieldapi.md
index b1602f304..4e0c8af4f 100644
--- a/docs/ar/reference/type-aliases/anyfieldapi.md
+++ b/docs/ar/reference/type-aliases/anyfieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:27:39.418Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.056Z'
 id: AnyFieldApi
 title: AnyFieldApi
 ---
@@ -13,6 +13,6 @@ title: AnyFieldApi
 type AnyFieldApi = FieldApi<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L828)
+Defined in: [packages/form-core/src/FieldApi.ts:832](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L832)
 
 A type representing the Field API with all generics set to `any` for convenience.
diff --git a/docs/ar/reference/type-aliases/anyfieldmeta.md b/docs/ar/reference/type-aliases/anyfieldmeta.md
index e889c31ff..5979f32c0 100644
--- a/docs/ar/reference/type-aliases/anyfieldmeta.md
+++ b/docs/ar/reference/type-aliases/anyfieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:27:39.414Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.050Z'
 id: AnyFieldMeta
 title: AnyFieldMeta
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMeta
 type AnyFieldMeta = FieldMeta<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L747)
+Defined in: [packages/form-core/src/FieldApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L751)
diff --git a/docs/ar/reference/type-aliases/anyfieldmetaderived.md b/docs/ar/reference/type-aliases/anyfieldmetaderived.md
index 8864f0a18..9e803b0fc 100644
--- a/docs/ar/reference/type-aliases/anyfieldmetaderived.md
+++ b/docs/ar/reference/type-aliases/anyfieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:27:39.403Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.047Z'
 id: AnyFieldMetaDerived
 title: AnyFieldMetaDerived
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMetaDerived
 type AnyFieldMetaDerived = FieldMetaDerived<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L661)
+Defined in: [packages/form-core/src/FieldApi.ts:665](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L665)
diff --git a/docs/ar/reference/type-aliases/anyformapi.md b/docs/ar/reference/type-aliases/anyformapi.md
index 815abe81c..a910af03c 100644
--- a/docs/ar/reference/type-aliases/anyformapi.md
+++ b/docs/ar/reference/type-aliases/anyformapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:27:39.399Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.043Z'
 id: AnyFormApi
 title: AnyFormApi
 ---
@@ -13,6 +13,6 @@ title: AnyFormApi
 type AnyFormApi = FormApi<any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L747)
+Defined in: [packages/form-core/src/FormApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L751)
 
 A type representing the Form API with all generics set to `any` for convenience.
diff --git a/docs/ar/reference/type-aliases/anyformstate.md b/docs/ar/reference/type-aliases/anyformstate.md
index 630afbd24..0bb41bec0 100644
--- a/docs/ar/reference/type-aliases/anyformstate.md
+++ b/docs/ar/reference/type-aliases/anyformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:27:39.395Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.039Z'
 id: AnyFormState
 title: AnyFormState
 ---
@@ -13,4 +13,4 @@ title: AnyFormState
 type AnyFormState = FormState<any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:676](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L676)
+Defined in: [packages/form-core/src/FormApi.ts:680](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L680)
diff --git a/docs/ar/reference/type-aliases/derivedformstate.md b/docs/ar/reference/type-aliases/derivedformstate.md
index 9e126bec1..a4228cbeb 100644
--- a/docs/ar/reference/type-aliases/derivedformstate.md
+++ b/docs/ar/reference/type-aliases/derivedformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:44:30.300Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.035Z'
 id: DerivedFormState
 title: DerivedFormState
 ---
@@ -77,6 +77,14 @@ isBlurred: boolean;
 
 A boolean indicating if any of the form fields have been blurred.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A boolean indicating if all of the form's fields are the same as default values.
+
 ### isDirty
 
 ```ts
diff --git a/docs/ar/reference/type-aliases/fieldmeta.md b/docs/ar/reference/type-aliases/fieldmeta.md
index 1a101748c..8275238e1 100644
--- a/docs/ar/reference/type-aliases/fieldmeta.md
+++ b/docs/ar/reference/type-aliases/fieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:44:30.262Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.032Z'
 id: FieldMeta
 title: FieldMeta
 ---
@@ -13,7 +13,7 @@ title: FieldMeta
 type FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = FieldMetaBase<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> & FieldMetaDerived<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:684](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L684)
+Defined in: [packages/form-core/src/FieldApi.ts:688](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L688)
 
 An object type representing the metadata of a field in a form.
 
diff --git a/docs/ar/reference/type-aliases/fieldmetaderived.md b/docs/ar/reference/type-aliases/fieldmetaderived.md
index 25f2228cb..4a20d4dec 100644
--- a/docs/ar/reference/type-aliases/fieldmetaderived.md
+++ b/docs/ar/reference/type-aliases/fieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:27:39.354Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.028Z'
 id: FieldMetaDerived
 title: FieldMetaDerived
 ---
@@ -68,6 +68,14 @@ errors: (
 
 An array of errors related to the field value.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A flag indicating whether the field's current value is the default value
+
 ### isPristine
 
 ```ts
diff --git a/docs/ar/reference/type-aliases/fieldstate.md b/docs/ar/reference/type-aliases/fieldstate.md
index 02df4632d..f9e07c19a 100644
--- a/docs/ar/reference/type-aliases/fieldstate.md
+++ b/docs/ar/reference/type-aliases/fieldstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:44:30.143Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:52:53.020Z'
 id: FieldState
 title: FieldState
 ---
@@ -13,7 +13,7 @@ title: FieldState
 type FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:770](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L770)
+Defined in: [packages/form-core/src/FieldApi.ts:774](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L774)
 
 An object type representing the state of a field.
 
diff --git a/docs/de/framework/react/guides/basic-concepts.md b/docs/de/framework/react/guides/basic-concepts.md
index 716a35724..33df3b7af 100644
--- a/docs/de/framework/react/guides/basic-concepts.md
+++ b/docs/de/framework/react/guides/basic-concepts.md
@@ -1,15 +1,15 @@
 ---
-source-updated-at: '2025-04-16T08:45:06.000Z'
-translation-updated-at: '2025-04-30T21:54:28.077Z'
+source-updated-at: '2025-05-08T07:42:29.000Z'
+translation-updated-at: '2025-05-08T23:49:15.520Z'
 id: basic-concepts
 title: Grundkonzepte
 ---
 
-Diese Seite führt die grundlegenden Konzepte und Begriffe ein, die in der `@tanstack/react-form`-Bibliothek verwendet werden. Wenn Sie sich mit diesen Konzepten vertraut machen, können Sie die Bibliothek besser verstehen und damit arbeiten.
+Diese Seite führt die grundlegenden Konzepte und Begriffe ein, die in der `@tanstack/react-form`-Bibliothek verwendet werden. Das Vertrautmachen mit diesen Konzepten hilft Ihnen, die Bibliothek besser zu verstehen und effektiver damit zu arbeiten.
 
-## Formularoptionen
+## Formular-Optionen
 
-Sie können Optionen für Ihr Formular erstellen, damit es zwischen mehreren Formularen gemeinsam genutzt werden kann, indem Sie die Funktion `formOptions` verwenden.
+Sie können Optionen für Ihr Formular erstellen, um sie zwischen mehreren Formularen zu teilen, indem Sie die Funktion `formOptions` verwenden.
 
 Beispiel:
 
@@ -26,9 +26,9 @@ const formOpts = formOptions({
 })
 ```
 
-## Formularinstanz
+## Formular-Instanz
 
-Eine Formularinstanz ist ein Objekt, das ein einzelnes Formular repräsentiert und Methoden und Eigenschaften zur Arbeit mit dem Formular bereitstellt. Sie erstellen eine Formularinstanz mit dem Hook `useForm`, der von den Formularoptionen bereitgestellt wird. Der Hook akzeptiert ein Objekt mit einer `onSubmit`-Funktion, die aufgerufen wird, wenn das Formular abgesendet wird.
+Eine Formular-Instanz ist ein Objekt, das ein individuelles Formular repräsentiert und Methoden sowie Eigenschaften für die Arbeit mit dem Formular bereitstellt. Sie erstellen eine Formular-Instanz mit dem Hook `useForm`, der von den Formular-Optionen bereitgestellt wird. Der Hook akzeptiert ein Objekt mit einer `onSubmit`-Funktion, die beim Absenden des Formulars aufgerufen wird.
 
 ```tsx
 const form = useForm({
@@ -40,7 +40,7 @@ const form = useForm({
 })
 ```
 
-Sie können auch eine Formularinstanz erstellen, ohne `formOptions` zu verwenden, indem Sie die eigenständige `useForm`-API nutzen:
+Sie können auch eine Formular-Instanz ohne `formOptions` erstellen, indem Sie die eigenständige `useForm`-API verwenden:
 
 ```tsx
 interface User {
@@ -61,7 +61,7 @@ const form = useForm({
 
 ## Feld
 
-Ein Feld (Field) repräsentiert ein einzelnes Formulareingabeelement, wie z.B. ein Textfeld oder eine Checkbox. Felder werden mit der Komponente `form.Field` erstellt, die von der Formularinstanz bereitgestellt wird. Die Komponente akzeptiert eine `name`-Prop, die mit einem Schlüssel in den Standardwerten des Formulars übereinstimmen sollte. Sie akzeptiert auch eine `children`-Prop, die eine Render-Prop-Funktion ist, die ein Feldobjekt als Argument erhält.
+Ein Feld repräsentiert ein einzelnes Formular-Eingabeelement, wie z.B. ein Textfeld oder eine Checkbox. Felder werden mit der Komponente `form.Field` erstellt, die von der Formular-Instanz bereitgestellt wird. Die Komponente akzeptiert eine `name`-Prop, die mit einem Schlüssel in den Standardwerten des Formulars übereinstimmen sollte. Sie akzeptiert auch eine `children`-Prop, eine Render-Prop-Funktion, die ein Feldobjekt als Argument erhält.
 
 Beispiel:
 
@@ -81,9 +81,9 @@ Beispiel:
 />
 ```
 
-## Feldzustand
+## Feld-Status
 
-Jedes Feld hat seinen eigenen Zustand (State), der seinen aktuellen Wert, Validierungsstatus, Fehlermeldungen und andere Metadaten enthält. Sie können den Zustand eines Felds über die Eigenschaft `field.state` abrufen.
+Jedes Feld hat seinen eigenen Status, der seinen aktuellen Wert, Validierungsstatus, Fehlermeldungen und weitere Metadaten enthält. Sie können den Status eines Felds über die Eigenschaft `field.state` abrufen.
 
 Beispiel:
 
@@ -94,21 +94,44 @@ const {
 } = field.state
 ```
 
-Es gibt drei Feldzustände, die nützlich sein können, um zu sehen, wie der Benutzer mit einem Feld interagiert: Ein Feld ist _"touched"_ (berührt), wenn der Benutzer hineinklickt/-tabuliert, _"pristine"_ (unverändert), bis der Benutzer den Wert ändert, und _"dirty"_ (verändert), nachdem der Wert geändert wurde. Sie können diese Zustände über die Flags `isTouched`, `isPristine` und `isDirty` überprüfen, wie unten gezeigt.
+Es gibt drei Status in den Metadaten, die nützlich sein können, um die Interaktion des Benutzers mit einem Feld nachzuvollziehen:
+
+- _"isTouched"_, nachdem der Benutzer in das Feld geklickt/getabt hat
+- _"isPristine"_, bis der Benutzer den Feldwert ändert
+- _"isDirty"_, nachdem der Feldwert geändert wurde
 
 ```tsx
 const { isTouched, isPristine, isDirty } = field.state.meta
 ```
 
-![Feldzustände](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states.png)
+![Feld-Status](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states.png)
+
+## Verständnis von 'isDirty' in verschiedenen Bibliotheken
+
+Nicht-persistenter `dirty`-Status
+
+- **Bibliotheken**: React Hook Form (RHF), Formik, Final Form.
+- **Verhalten**: Ein Feld ist 'dirty', wenn sein Wert vom Standardwert abweicht. Die Rückkehr zum Standardwert macht es wieder 'clean'.
+
+Persistenter `dirty`-Status
+
+- **Bibliotheken**: Angular Form, Vue FormKit.
+- **Verhalten**: Ein Feld bleibt 'dirty', sobald es geändert wurde, selbst wenn es auf den Standardwert zurückgesetzt wird.
+
+Wir haben uns für das Modell des persistenten 'dirty'-Status entschieden. Um auch einen nicht-persistenten 'dirty'-Status zu unterstützen, führen wir das Flag `isDefault` ein. Dieses Flag fungiert als Umkehrung des nicht-persistenten 'dirty'-Status.
+
+```tsx
+const { isTouched, isPristine, isDirty, isDefaultValue } = field.state.meta
+
+// Die folgende Zeile reproduziert die Funktionalität des nicht-persistenten `dirty`-Status.
+const nonPersistentIsDirty = !isDefaultValue
+```
 
-> **Wichtiger Hinweis für Benutzer von `React Hook Form`**: Das `isDirty`-Flag in `TanStack/form` unterscheidet sich von dem Flag mit demselben Namen in RHF.
-> In RHF ist `isDirty = true`, wenn die Formularwerte von den ursprünglichen Werten abweichen. Wenn der Benutzer die Werte in einem Formular ändert und sie dann wieder ändert, sodass sie mit den Standardwerten des Formulars übereinstimmen, ist `isDirty` in RHF `false`, aber in `TanStack/form` `true`.
-> Die Standardwerte sind sowohl auf Formular- als auch auf Feldebene in `TanStack/form` verfügbar (`form.options.defaultValues`, `field.options.defaultValue`), sodass Sie Ihre eigene `isDefaultValue()`-Hilfsfunktion schreiben können, wenn Sie das Verhalten von RHF nachbilden müssen.
+![Erweiterte Feld-Status](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states-extended.png)
 
 ## Feld-API
 
-Die Feld-API (Field API) ist ein Objekt, das an die Render-Prop-Funktion übergeben wird, wenn ein Feld erstellt wird. Sie bietet Methoden zur Arbeit mit dem Zustand des Felds.
+Die Feld-API ist ein Objekt, das an die Render-Prop-Funktion übergeben wird, wenn ein Feld erstellt wird. Sie bietet Methoden für die Arbeit mit dem Feldstatus.
 
 Beispiel:
 
@@ -138,7 +161,7 @@ Beispiel:
           : undefined,
     onChangeAsync: async ({ value }) => {
       await new Promise((resolve) => setTimeout(resolve, 1000))
-      return value.includes('error') && '„error“ ist im Vornamen nicht erlaubt'
+      return value.includes('error') && '"error" ist im Vornamen nicht erlaubt'
     },
   }}
   children={(field) => (
@@ -158,9 +181,9 @@ Beispiel:
 
 Zusätzlich zu manuell erstellten Validierungsoptionen unterstützen wir auch die [Standard-Schema](https://github.com/standard-schema/standard-schema)-Spezifikation.
 
-Sie können ein Schema mit einer der Bibliotheken definieren, die die Spezifikation implementieren, und es einem Formular- oder Feldvalidator übergeben.
+Sie können ein Schema mit einer der Bibliotheken definieren, die die Spezifikation implementieren, und es einem Formular- oder Feld-Validator übergeben.
 
-Unterstützte Bibliotheken umfassen:
+Unterstützte Bibliotheken sind:
 
 - [Zod](https://zod.dev/)
 - [Valibot](https://valibot.dev/)
@@ -202,7 +225,7 @@ function App() {
 
 ## Reaktivität
 
-`@tanstack/react-form` bietet verschiedene Möglichkeiten, um Änderungen am Formular- und Feldzustand zu abonnieren, insbesondere den Hook `useStore(form.store)` und die Komponente `form.Subscribe`. Diese Methoden ermöglichen es Ihnen, die Rendering-Performance Ihres Formulars zu optimieren, indem Komponenten nur bei Bedarf aktualisiert werden.
+`@tanstack/react-form` bietet verschiedene Möglichkeiten, um Änderungen am Formular- und Feldstatus zu abonnieren, insbesondere den Hook `useStore(form.store)` und die Komponente `form.Subscribe`. Diese Methoden ermöglichen es Ihnen, die Rendering-Performance Ihres Formulars zu optimieren, indem Komponenten nur bei Bedarf aktualisiert werden.
 
 Beispiel:
 
@@ -219,7 +242,7 @@ const firstName = useStore(form.store, (state) => state.values.firstName)
 />
 ```
 
-Es ist wichtig zu beachten, dass die `selector`-Prop des `useStore`-Hooks optional ist, aber dringend empfohlen wird, da das Weglassen zu unnötigen Neu-Renderings führt.
+Es ist wichtig zu beachten, dass die `selector`-Prop des `useStore`-Hooks optional ist, aber dringend empfohlen wird, da das Weglassen unnötige Neu-Renderings verursacht.
 
 ```tsx
 // Korrekte Verwendung
@@ -229,11 +252,11 @@ const errors = useStore(form.store, (state) => state.errorMap)
 const store = useStore(form.store)
 ```
 
-Hinweis: Die Verwendung des `useField`-Hooks zur Erzielung von Reaktivität wird nicht empfohlen, da er gezielt innerhalb der `form.Field`-Komponente verwendet werden soll. Stattdessen können Sie `useStore(form.store)` verwenden.
+Hinweis: Die Verwendung des `useField`-Hooks zur Erzielung von Reaktivität wird nicht empfohlen, da er gezielt innerhalb der `form.Field`-Komponente verwendet werden sollte. Stattdessen können Sie `useStore(form.store)` verwenden.
 
 ## Listener
 
-`@tanstack/react-form` ermöglicht es Ihnen, auf bestimmte Trigger zu reagieren und sie zu "überwachen", um Nebenwirkungen auszulösen.
+`@tanstack/react-form` ermöglicht es Ihnen, auf bestimmte Trigger zu reagieren und diese zu "überwachen", um Nebenwirkungen auszulösen.
 
 Beispiel:
 
@@ -249,13 +272,13 @@ Beispiel:
 />
 ```
 
-Weitere Informationen finden Sie unter [Listener](./listeners.md).
+Weitere Informationen finden Sie unter [Listener](./listeners.md)
 
 ## Array-Felder
 
-Array-Felder (Array Fields) ermöglichen es Ihnen, eine Liste von Werten innerhalb eines Formulars zu verwalten, wie z.B. eine Liste von Hobbys. Sie können ein Array-Feld mit der `form.Field`-Komponente und der `mode="array"`-Prop erstellen.
+Array-Felder ermöglichen es Ihnen, eine Liste von Werten innerhalb eines Formulars zu verwalten, wie z.B. eine Liste von Hobbys. Sie können ein Array-Feld mit der `form.Field`-Komponente und der `mode="array"`-Prop erstellen.
 
-Bei der Arbeit mit Array-Feldern können Sie die Methoden `pushValue`, `removeValue`, `swapValues` und `moveValue` verwenden, um Werte im Array hinzuzufügen, zu entfernen und zu vertauschen.
+Bei der Arbeit mit Array-Feldern können Sie die Methoden `pushValue`, `removeValue`, `swapValues` und `moveValue` verwenden, um Werte im Array hinzuzufügen, zu entfernen oder zu vertauschen.
 
 Beispiel:
 
@@ -335,7 +358,7 @@ Beispiel:
 
 ## Reset-Buttons
 
-Wenn Sie `<button type="reset">` in Verbindung mit `form.reset()` von TanStack Form verwenden, müssen Sie das standardmäßige HTML-Reset-Verhalten verhindern, um unerwartete Zurücksetzungen von Formularelementen (insbesondere `<select>`-Elementen) auf ihre anfänglichen HTML-Werte zu vermeiden.
+Wenn Sie `<button type="reset">` in Kombination mit `form.reset()` von TanStack Form verwenden, müssen Sie das standardmäßige HTML-Reset-Verhalten verhindern, um unerwartete Zurücksetzungen von Formularelementen (insbesondere `<select>`-Elementen) auf ihre initialen HTML-Werte zu vermeiden.
 Verwenden Sie `event.preventDefault()` im `onClick`-Handler des Buttons, um das native Formular-Reset zu verhindern.
 
 Beispiel:
@@ -365,4 +388,4 @@ Alternativ können Sie `<button type="button">` verwenden, um das native HTML-Re
 </button>
 ```
 
-Dies sind die grundlegenden Konzepte und Begriffe, die in der `@tanstack/react-form`-Bibliothek verwendet werden. Wenn Sie diese Konzepte verstehen, können Sie effektiver mit der Bibliothek arbeiten und komplexe Formulare mühelos erstellen.
+Dies sind die grundlegenden Konzepte und Begriffe, die in der `@tanstack/react-form`-Bibliothek verwendet werden. Das Verständnis dieser Konzepte hilft Ihnen, effektiver mit der Bibliothek zu arbeiten und komplexe Formulare mühelos zu erstellen.
diff --git a/docs/de/reference/classes/fieldapi.md b/docs/de/reference/classes/fieldapi.md
index e423989a5..8b595ef24 100644
--- a/docs/de/reference/classes/fieldapi.md
+++ b/docs/de/reference/classes/fieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:52:11.915Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.879Z'
 id: FieldApi
 title: FieldApi
 ---
@@ -9,7 +9,7 @@ title: FieldApi
 
 # Class: FieldApi\<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta\>
 
-Defined in: [packages/form-core/src/FieldApi.ts:859](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L859)
+Defined in: [packages/form-core/src/FieldApi.ts:863](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L863)
 
 A class representing the API for managing a form field.
 
@@ -67,7 +67,7 @@ the `new FieldApi` constructor.
 new FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>(opts): FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:991](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L991)
+Defined in: [packages/form-core/src/FieldApi.ts:995](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L995)
 
 Initializes a new `FieldApi` instance.
 
@@ -89,7 +89,7 @@ Initializes a new `FieldApi` instance.
 form: FormApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:903](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L903)
+Defined in: [packages/form-core/src/FieldApi.ts:907](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L907)
 
 A reference to the form API instance.
 
@@ -101,7 +101,7 @@ A reference to the form API instance.
 name: DeepKeys<TParentData>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:927](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L927)
+Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
 
 The field name.
 
@@ -113,7 +113,7 @@ The field name.
 options: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
+Defined in: [packages/form-core/src/FieldApi.ts:935](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L935)
 
 The field options.
 
@@ -125,7 +125,7 @@ The field options.
 store: Derived<FieldState<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:955](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L955)
+Defined in: [packages/form-core/src/FieldApi.ts:959](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L959)
 
 The field state store.
 
@@ -137,7 +137,7 @@ The field state store.
 timeoutIds: object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:982](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L982)
+Defined in: [packages/form-core/src/FieldApi.ts:986](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L986)
 
 #### formListeners
 
@@ -167,7 +167,7 @@ validations: Record<ValidationCause, null | Timeout>;
 get state(): FieldState<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:979](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L979)
+Defined in: [packages/form-core/src/FieldApi.ts:983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L983)
 
 The current field state.
 
@@ -183,7 +183,7 @@ The current field state.
 getInfo(): FieldInfo<TParentData>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1245](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1245)
+Defined in: [packages/form-core/src/FieldApi.ts:1249](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1249)
 
 Gets the field information object.
 
@@ -199,7 +199,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:1213](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1213)
+Defined in: [packages/form-core/src/FieldApi.ts:1217](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1217)
 
 #### Returns
 
@@ -213,7 +213,7 @@ Defined in: [packages/form-core/src/FieldApi.ts:1213](https://github.com/TanStac
 getValue(): TData
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1198](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1198)
+Defined in: [packages/form-core/src/FieldApi.ts:1202](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1202)
 
 Gets the current field value.
 
@@ -233,7 +233,7 @@ Use `field.state.value` instead.
 handleBlur(): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1657](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1657)
+Defined in: [packages/form-core/src/FieldApi.ts:1661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1661)
 
 Handles the blur event.
 
@@ -249,7 +249,7 @@ Handles the blur event.
 handleChange(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1650](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1650)
+Defined in: [packages/form-core/src/FieldApi.ts:1654](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1654)
 
 Handles the change event.
 
@@ -274,7 +274,7 @@ insertValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1262](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1262)
+Defined in: [packages/form-core/src/FieldApi.ts:1266](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1266)
 
 Inserts a value at the specified index, shifting the subsequent values to the right.
 
@@ -304,7 +304,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:1088](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1088)
+Defined in: [packages/form-core/src/FieldApi.ts:1092](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1092)
 
 Mounts the field instance to the form.
 
@@ -327,7 +327,7 @@ moveValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1306](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1306)
+Defined in: [packages/form-core/src/FieldApi.ts:1310](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1310)
 
 Moves the value at the first specified index to the second specified index.
 
@@ -359,7 +359,7 @@ parseValueWithSchema(schema):
   | StandardSchemaV1Issue[]
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1699](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1699)
+Defined in: [packages/form-core/src/FieldApi.ts:1703](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1703)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -387,7 +387,7 @@ parseValueWithSchemaAsync(schema): Promise<
 | StandardSchemaV1Issue[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1711](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1711)
+Defined in: [packages/form-core/src/FieldApi.ts:1715](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1715)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -414,7 +414,7 @@ The standard schema to parse this field's value with.
 pushValue(value, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1250](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1250)
+Defined in: [packages/form-core/src/FieldApi.ts:1254](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1254)
 
 Pushes a new value to the field.
 
@@ -440,7 +440,7 @@ Pushes a new value to the field.
 removeValue(index, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1288](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1288)
+Defined in: [packages/form-core/src/FieldApi.ts:1292](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1292)
 
 Removes a value at the specified index.
 
@@ -469,7 +469,7 @@ replaceValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1275](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1275)
+Defined in: [packages/form-core/src/FieldApi.ts:1279](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1279)
 
 Replaces a value at the specified index.
 
@@ -499,7 +499,7 @@ Replaces a value at the specified index.
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1674](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1674)
+Defined in: [packages/form-core/src/FieldApi.ts:1678](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1678)
 
 Updates the field's errorMap
 
@@ -521,7 +521,7 @@ Updates the field's errorMap
 setMeta(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1218](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1218)
+Defined in: [packages/form-core/src/FieldApi.ts:1222](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1222)
 
 Sets the field metadata.
 
@@ -543,7 +543,7 @@ Sets the field metadata.
 setValue(updater, options?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1205](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1205)
+Defined in: [packages/form-core/src/FieldApi.ts:1209](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1209)
 
 Sets the field value and run the `change` validator.
 
@@ -572,7 +572,7 @@ swapValues(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1297](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1297)
+Defined in: [packages/form-core/src/FieldApi.ts:1301](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1301)
 
 Swaps the values at the specified indices.
 
@@ -602,7 +602,7 @@ Swaps the values at the specified indices.
 update(opts): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1141](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1141)
+Defined in: [packages/form-core/src/FieldApi.ts:1145](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1145)
 
 Updates the field instance with new options.
 
@@ -624,7 +624,7 @@ Updates the field instance with new options.
 validate(cause, opts?): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1617](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1617)
+Defined in: [packages/form-core/src/FieldApi.ts:1621](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1621)
 
 Validates the field value.
 
diff --git a/docs/de/reference/classes/formapi.md b/docs/de/reference/classes/formapi.md
index fd0c40d68..0ba2869d1 100644
--- a/docs/de/reference/classes/formapi.md
+++ b/docs/de/reference/classes/formapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:52:11.910Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.875Z'
 id: FormApi
 title: FormApi
 ---
@@ -9,7 +9,7 @@ title: FormApi
 
 # Class: FormApi\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta\>
 
-Defined in: [packages/form-core/src/FormApi.ts:767](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L767)
+Defined in: [packages/form-core/src/FormApi.ts:771](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L771)
 
 A class representing the Form API. It handles the logic and interactions with the form state.
 
@@ -47,7 +47,7 @@ However, if you need to create a new instance manually, you can do so by calling
 new FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>(opts?): FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:838](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L838)
+Defined in: [packages/form-core/src/FormApi.ts:842](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L842)
 
 Constructs a new `FormApi` instance with the given form options.
 
@@ -69,7 +69,7 @@ Constructs a new `FormApi` instance with the given form options.
 baseStore: Store<BaseFormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L794)
+Defined in: [packages/form-core/src/FormApi.ts:798](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L798)
 
 ***
 
@@ -79,7 +79,7 @@ Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/
 fieldInfo: Record<DeepKeys<TFormData>, FieldInfo<TFormData>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:824](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L824)
+Defined in: [packages/form-core/src/FormApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L828)
 
 A record of field information for each field in the form.
 
@@ -91,7 +91,7 @@ A record of field information for each field in the form.
 fieldMetaDerived: Derived<Record<DeepKeys<TFormData>, AnyFieldMeta>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L807)
+Defined in: [packages/form-core/src/FormApi.ts:811](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L811)
 
 ***
 
@@ -101,7 +101,7 @@ Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/
 options: FormOptions<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta> = {};
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:782](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L782)
+Defined in: [packages/form-core/src/FormApi.ts:786](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L786)
 
 The options for the form.
 
@@ -113,7 +113,7 @@ The options for the form.
 store: Derived<FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L808)
+Defined in: [packages/form-core/src/FormApi.ts:812](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L812)
 
 ## Accessors
 
@@ -125,7 +125,7 @@ Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/
 get state(): FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L826)
+Defined in: [packages/form-core/src/FormApi.ts:830](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L830)
 
 ##### Returns
 
@@ -139,7 +139,7 @@ Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/
 deleteField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1912)
+Defined in: [packages/form-core/src/FormApi.ts:1938](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1938)
 
 #### Type Parameters
 
@@ -163,7 +163,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack
 getAllErrors(): object
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2148](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2148)
+Defined in: [packages/form-core/src/FormApi.ts:2174](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2174)
 
 Returns form and field level errors
 
@@ -214,7 +214,7 @@ errors: (
 getFieldInfo<TField>(field): FieldInfo<TFormData>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1826)
+Defined in: [packages/form-core/src/FormApi.ts:1852](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1852)
 
 Gets the field info of the specified field.
 
@@ -240,7 +240,7 @@ Gets the field info of the specified field.
 getFieldMeta<TField>(field): undefined | AnyFieldMeta
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1817](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1817)
+Defined in: [packages/form-core/src/FormApi.ts:1843](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1843)
 
 Gets the metadata of the specified field.
 
@@ -266,7 +266,7 @@ Gets the metadata of the specified field.
 getFieldValue<TField>(field): DeepValue<TFormData, TField>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1810](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1810)
+Defined in: [packages/form-core/src/FormApi.ts:1836](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1836)
 
 Gets the value of the specified field.
 
@@ -294,7 +294,7 @@ Gets the value of the specified field.
 handleSubmit(): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1712](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1712)
+Defined in: [packages/form-core/src/FormApi.ts:1738](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1738)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -308,7 +308,7 @@ Handles the form submission, performs validation, and calls the appropriate onSu
 handleSubmit(submitMeta): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1713](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1713)
+Defined in: [packages/form-core/src/FormApi.ts:1739](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1739)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -334,7 +334,7 @@ insertFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1951)
+Defined in: [packages/form-core/src/FormApi.ts:1977](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1977)
 
 #### Type Parameters
 
@@ -370,7 +370,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack
 mount(): () => void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1142](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1142)
+Defined in: [packages/form-core/src/FormApi.ts:1168](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1168)
 
 #### Returns
 
@@ -392,7 +392,7 @@ moveFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2075](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2075)
+Defined in: [packages/form-core/src/FormApi.ts:2101](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2101)
 
 Moves the value at the first specified index to the second specified index within an array field.
 
@@ -435,7 +435,7 @@ parseValuesWithSchema(schema):
 }
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2208](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2208)
+Defined in: [packages/form-core/src/FormApi.ts:2234](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2234)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -469,7 +469,7 @@ parseValuesWithSchemaAsync(schema): Promise<
 }>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2220](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2220)
+Defined in: [packages/form-core/src/FormApi.ts:2246](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2246)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -502,7 +502,7 @@ pushFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1936](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1936)
+Defined in: [packages/form-core/src/FormApi.ts:1962](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1962)
 
 Pushes a value into an array field.
 
@@ -539,7 +539,7 @@ removeFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
+Defined in: [packages/form-core/src/FormApi.ts:2035](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2035)
 
 Removes a value from an array field at the specified index.
 
@@ -577,7 +577,7 @@ replaceFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1983)
+Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
 
 Replaces a value into an array field at the specified index.
 
@@ -615,7 +615,7 @@ Replaces a value into an array field at the specified index.
 reset(values?, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1230](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1230)
+Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
 
 Resets the form state to the default values.
 If values are provided, the form will be reset to those values instead and the default values will be updated.
@@ -648,7 +648,7 @@ Optional options to control the reset behavior.
 resetField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2103](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2103)
+Defined in: [packages/form-core/src/FormApi.ts:2129](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2129)
 
 Resets the field value and meta to default state
 
@@ -674,7 +674,7 @@ Resets the field value and meta to default state
 resetFieldMeta<TField>(fieldMeta): Record<TField, AnyFieldMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1866](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1866)
+Defined in: [packages/form-core/src/FormApi.ts:1892](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1892)
 
 resets every field's meta
 
@@ -700,7 +700,7 @@ resets every field's meta
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2124](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2124)
+Defined in: [packages/form-core/src/FormApi.ts:2150](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2150)
 
 Updates the form's errorMap
 
@@ -722,7 +722,7 @@ Updates the form's errorMap
 setFieldMeta<TField>(field, updater): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1845](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1845)
+Defined in: [packages/form-core/src/FormApi.ts:1871](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1871)
 
 Updates the metadata of the specified field.
 
@@ -755,7 +755,7 @@ setFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1882](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1882)
+Defined in: [packages/form-core/src/FormApi.ts:1908](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1908)
 
 Sets the value of the specified field and optionally updates the touched state.
 
@@ -793,7 +793,7 @@ swapFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2046](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2046)
+Defined in: [packages/form-core/src/FormApi.ts:2072](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2072)
 
 Swaps the values at the specified indices within an array field.
 
@@ -831,7 +831,7 @@ Swaps the values at the specified indices within an array field.
 update(options?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1162](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1162)
+Defined in: [packages/form-core/src/FormApi.ts:1188](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1188)
 
 Updates the form options and form state.
 
@@ -853,7 +853,7 @@ Updates the form options and form state.
 validateAllFields(cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
+Defined in: [packages/form-core/src/FormApi.ts:1282](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1282)
 
 Validates all fields using the correct handlers for a given validation cause.
 
@@ -878,7 +878,7 @@ validateArrayFieldsStartingFrom<TField>(
 cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1286](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1286)
+Defined in: [packages/form-core/src/FormApi.ts:1312](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1312)
 
 Validates the children of a specified array in the form starting from a given index until the end using the correct handlers for a given validation type.
 
@@ -912,7 +912,7 @@ Validates the children of a specified array in the form starting from a given in
 validateField<TField>(field, cause): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1325](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1325)
+Defined in: [packages/form-core/src/FormApi.ts:1351](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1351)
 
 Validates a specified field in the form using the correct handlers for a given validation type.
 
diff --git a/docs/de/reference/functions/evaluate.md b/docs/de/reference/functions/evaluate.md
new file mode 100644
index 000000000..cd32e8a4a
--- /dev/null
+++ b/docs/de/reference/functions/evaluate.md
@@ -0,0 +1,34 @@
+---
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.871Z'
+id: evaluate
+title: evaluate
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: evaluate()
+
+```ts
+function evaluate<T>(objA, objB): boolean
+```
+
+Defined in: [packages/form-core/src/utils.ts:339](https://github.com/TanStack/form/blob/main/packages/form-core/src/utils.ts#L339)
+
+## Type Parameters
+
+• **T**
+
+## Parameters
+
+### objA
+
+`T`
+
+### objB
+
+`T`
+
+## Returns
+
+`boolean`
diff --git a/docs/de/reference/index.md b/docs/de/reference/index.md
index e9290afe6..def7aa08f 100644
--- a/docs/de/reference/index.md
+++ b/docs/de/reference/index.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-25T12:58:29.000Z'
-translation-updated-at: '2025-04-30T22:41:47.307Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.831Z'
 id: '@tanstack/form-core'
 title: '@tanstack/form-core'
 ---
@@ -84,8 +84,8 @@ title: '@tanstack/form-core'
 
 ## Functions
 
+- [evaluate](functions/evaluate.md)
 - [formOptions](functions/formoptions.md)
 - [isGlobalFormValidationError](functions/isglobalformvalidationerror.md)
 - [isStandardSchemaValidator](functions/isstandardschemavalidator.md)
 - [mergeForm](functions/mergeform.md)
-- [shallow](functions/shallow.md)
diff --git a/docs/de/reference/interfaces/formstate.md b/docs/de/reference/interfaces/formstate.md
index 267b1e5d9..2573e29c6 100644
--- a/docs/de/reference/interfaces/formstate.md
+++ b/docs/de/reference/interfaces/formstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:21:10.200Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.827Z'
 id: FormState
 title: FormState
 ---
@@ -9,7 +9,7 @@ title: FormState
 
 # Interface: FormState\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer\>
 
-Defined in: [packages/form-core/src/FormApi.ts:643](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L643)
+Defined in: [packages/form-core/src/FormApi.ts:647](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L647)
 
 An object representing the current state of the form.
 
@@ -63,7 +63,7 @@ BaseFormState._force_re_eval
 canSubmit: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
+Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
 
 A boolean indicating if the form can be submitted based on its current state.
 
@@ -125,7 +125,7 @@ DerivedFormState.errors
 fieldMeta: Record<DeepKeys<TFormData>, AnyFieldMeta>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
+Defined in: [packages/form-core/src/FormApi.ts:644](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L644)
 
 A record of field metadata for each field in the form.
 
@@ -173,6 +173,24 @@ DerivedFormState.isBlurred
 
 ***
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+
+A boolean indicating if all of the form's fields are the same as default values.
+
+#### Inherited from
+
+```ts
+DerivedFormState.isDefaultValue
+```
+
+***
+
 ### isDirty
 
 ```ts
@@ -371,7 +389,7 @@ DerivedFormState.isTouched
 isValid: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
 
 A boolean indicating if the form and all its fields are valid. Evaluates `true` if there are no errors.
 
diff --git a/docs/de/reference/type-aliases/anyfieldapi.md b/docs/de/reference/type-aliases/anyfieldapi.md
index a21ec8036..2398ac3c3 100644
--- a/docs/de/reference/type-aliases/anyfieldapi.md
+++ b/docs/de/reference/type-aliases/anyfieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:21:10.170Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.867Z'
 id: AnyFieldApi
 title: AnyFieldApi
 ---
@@ -13,6 +13,6 @@ title: AnyFieldApi
 type AnyFieldApi = FieldApi<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L828)
+Defined in: [packages/form-core/src/FieldApi.ts:832](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L832)
 
 A type representing the Field API with all generics set to `any` for convenience.
diff --git a/docs/de/reference/type-aliases/anyfieldmeta.md b/docs/de/reference/type-aliases/anyfieldmeta.md
index 40593baed..b48823f22 100644
--- a/docs/de/reference/type-aliases/anyfieldmeta.md
+++ b/docs/de/reference/type-aliases/anyfieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:21:10.165Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.862Z'
 id: AnyFieldMeta
 title: AnyFieldMeta
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMeta
 type AnyFieldMeta = FieldMeta<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L747)
+Defined in: [packages/form-core/src/FieldApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L751)
diff --git a/docs/de/reference/type-aliases/anyfieldmetaderived.md b/docs/de/reference/type-aliases/anyfieldmetaderived.md
index dce4b7620..e2346f147 100644
--- a/docs/de/reference/type-aliases/anyfieldmetaderived.md
+++ b/docs/de/reference/type-aliases/anyfieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:21:10.155Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.858Z'
 id: AnyFieldMetaDerived
 title: AnyFieldMetaDerived
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMetaDerived
 type AnyFieldMetaDerived = FieldMetaDerived<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L661)
+Defined in: [packages/form-core/src/FieldApi.ts:665](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L665)
diff --git a/docs/de/reference/type-aliases/anyformapi.md b/docs/de/reference/type-aliases/anyformapi.md
index 851bbccd1..5b184ac2d 100644
--- a/docs/de/reference/type-aliases/anyformapi.md
+++ b/docs/de/reference/type-aliases/anyformapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:21:10.150Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.854Z'
 id: AnyFormApi
 title: AnyFormApi
 ---
@@ -13,6 +13,6 @@ title: AnyFormApi
 type AnyFormApi = FormApi<any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L747)
+Defined in: [packages/form-core/src/FormApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L751)
 
 A type representing the Form API with all generics set to `any` for convenience.
diff --git a/docs/de/reference/type-aliases/anyformstate.md b/docs/de/reference/type-aliases/anyformstate.md
index b7ad65c3a..f35231b91 100644
--- a/docs/de/reference/type-aliases/anyformstate.md
+++ b/docs/de/reference/type-aliases/anyformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:21:10.146Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.850Z'
 id: AnyFormState
 title: AnyFormState
 ---
@@ -13,4 +13,4 @@ title: AnyFormState
 type AnyFormState = FormState<any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:676](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L676)
+Defined in: [packages/form-core/src/FormApi.ts:680](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L680)
diff --git a/docs/de/reference/type-aliases/derivedformstate.md b/docs/de/reference/type-aliases/derivedformstate.md
index 335671c43..49a5075ad 100644
--- a/docs/de/reference/type-aliases/derivedformstate.md
+++ b/docs/de/reference/type-aliases/derivedformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:47.958Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.846Z'
 id: DerivedFormState
 title: DerivedFormState
 ---
@@ -77,6 +77,14 @@ isBlurred: boolean;
 
 A boolean indicating if any of the form fields have been blurred.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A boolean indicating if all of the form's fields are the same as default values.
+
 ### isDirty
 
 ```ts
diff --git a/docs/de/reference/type-aliases/fieldmeta.md b/docs/de/reference/type-aliases/fieldmeta.md
index 512d88ea9..864ee73fb 100644
--- a/docs/de/reference/type-aliases/fieldmeta.md
+++ b/docs/de/reference/type-aliases/fieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:47.885Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.842Z'
 id: FieldMeta
 title: FieldMeta
 ---
@@ -13,7 +13,7 @@ title: FieldMeta
 type FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = FieldMetaBase<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> & FieldMetaDerived<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:684](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L684)
+Defined in: [packages/form-core/src/FieldApi.ts:688](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L688)
 
 An object type representing the metadata of a field in a form.
 
diff --git a/docs/de/reference/type-aliases/fieldmetaderived.md b/docs/de/reference/type-aliases/fieldmetaderived.md
index eac8e90ba..7160a7d6c 100644
--- a/docs/de/reference/type-aliases/fieldmetaderived.md
+++ b/docs/de/reference/type-aliases/fieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:21:10.103Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.839Z'
 id: FieldMetaDerived
 title: FieldMetaDerived
 ---
@@ -68,6 +68,14 @@ errors: (
 
 An array of errors related to the field value.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A flag indicating whether the field's current value is the default value
+
 ### isPristine
 
 ```ts
diff --git a/docs/de/reference/type-aliases/fieldstate.md b/docs/de/reference/type-aliases/fieldstate.md
index a728a0265..2f8599be9 100644
--- a/docs/de/reference/type-aliases/fieldstate.md
+++ b/docs/de/reference/type-aliases/fieldstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:47.852Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:47:24.835Z'
 id: FieldState
 title: FieldState
 ---
@@ -13,7 +13,7 @@ title: FieldState
 type FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:770](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L770)
+Defined in: [packages/form-core/src/FieldApi.ts:774](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L774)
 
 An object type representing the state of a field.
 
diff --git a/docs/es/framework/react/guides/basic-concepts.md b/docs/es/framework/react/guides/basic-concepts.md
index f9fe81fe7..01635d979 100644
--- a/docs/es/framework/react/guides/basic-concepts.md
+++ b/docs/es/framework/react/guides/basic-concepts.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-16T08:45:06.000Z'
-translation-updated-at: '2025-04-30T21:48:43.089Z'
+source-updated-at: '2025-05-08T07:42:29.000Z'
+translation-updated-at: '2025-05-08T23:47:23.997Z'
 id: basic-concepts
 title: Conceptos básicos
 ---
@@ -11,7 +11,7 @@ Esta página introduce los conceptos básicos y la terminología utilizada en la
 
 ## Opciones del Formulario
 
-Puede crear opciones para su formulario para que puedan compartirse entre múltiples formularios utilizando la función `formOptions`.
+Puede crear opciones para su formulario para que pueda ser compartido entre múltiples formularios utilizando la función `formOptions`.
 
 Ejemplo:
 
@@ -96,7 +96,11 @@ const {
 } = field.state
 ```
 
-Hay tres estados de campo que pueden ser útiles para ver cómo interactúa el usuario con un campo: un campo está _"touched"_ (tocado) cuando el usuario hace clic o tabula en él, _"pristine"_ (prístino) hasta que el usuario cambia su valor, y _"dirty"_ (modificado) después de que el valor ha sido cambiado. Puede verificar estos estados a través de las banderas `isTouched`, `isPristine` e `isDirty`, como se muestra a continuación.
+Hay tres estados en los metadatos que pueden ser útiles para ver cómo interactúa el usuario con un campo:
+
+- _"isTouched"_, después de que el usuario hace clic o tabula en el campo
+- _"isPristine"_, hasta que el usuario cambia el valor del campo
+- _"isDirty"_, después de que el valor del campo ha sido cambiado
 
 ```tsx
 const { isTouched, isPristine, isDirty } = field.state.meta
@@ -104,9 +108,28 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 
 ![Estados del campo](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states.png)
 
-> **Nota importante para usuarios que vienen de `React Hook Form`**: la bandera `isDirty` en `TanStack/form` es diferente de la bandera con el mismo nombre en RHF.
-> En RHF, `isDirty = true`, cuando los valores del formulario son diferentes de los valores originales. Si el usuario cambia los valores en un formulario y luego los cambia nuevamente para terminar con valores que coinciden con los valores predeterminados del formulario, `isDirty` será `false` en RHF, pero `true` en `TanStack/form`.
-> Los valores predeterminados se exponen tanto a nivel del formulario como del campo en `TanStack/form` (`form.options.defaultValues`, `field.options.defaultValue`), por lo que puede escribir su propia función auxiliar `isDefaultValue()` si necesita emular el comportamiento de RHF.
+## Entendiendo 'isDirty' en Diferentes Bibliotecas
+
+Estado `dirty` no persistente
+
+- **Bibliotecas**: React Hook Form (RHF), Formik, Final Form.
+- **Comportamiento**: Un campo está 'dirty' si su valor difiere del predeterminado. Revertir al valor predeterminado lo vuelve 'clean' nuevamente.
+
+Estado `dirty` persistente
+
+- **Bibliotecas**: Angular Form, Vue FormKit.
+- **Comportamiento**: Un campo permanece 'dirty' una vez cambiado, incluso si se revierte al valor predeterminado.
+
+Hemos elegido el modelo de estado 'dirty' persistente. Para también admitir un estado 'dirty' no persistente, introducimos la bandera `isDefault`. Esta bandera actúa como un inverso del estado 'dirty' no persistente.
+
+```tsx
+const { isTouched, isPristine, isDirty, isDefaultValue } = field.state.meta
+
+// La siguiente línea recreará la funcionalidad `dirty` no persistente.
+const nonPersistentIsDirty = !isDefaultValue
+```
+
+![Estados del campo extendidos](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states-extended.png)
 
 ## API del Campo
 
@@ -124,7 +147,7 @@ Ejemplo:
 
 ## Validación
 
-`@tanstack/react-form` proporciona validación tanto síncrona como asíncrona de forma predeterminada. Las funciones de validación se pueden pasar al componente `form.Field` utilizando la propiedad `validators`.
+`@tanstack/react-form` proporciona validación sincrónica y asincrónica de forma predeterminada. Las funciones de validación se pueden pasar al componente `form.Field` utilizando la propiedad `validators`.
 
 Ejemplo:
 
@@ -160,7 +183,7 @@ Ejemplo:
 
 Además de las opciones de validación personalizadas, también admitimos la especificación [Standard Schema](https://github.com/standard-schema/standard-schema).
 
-Puede definir un esquema utilizando cualquiera de las bibliotecas que implementan la especificación y pasarlo a un validador de formulario o campo.
+Puede definir un esquema utilizando cualquiera de las bibliotecas que implementen la especificación y pasarlo a un validador de formulario o campo.
 
 Las bibliotecas admitidas incluyen:
 
@@ -199,7 +222,7 @@ function App() {
 
 ## Reactividad
 
-`@tanstack/react-form` ofrece varias formas de suscribirse a cambios de estado del formulario y de los campos, más notablemente el hook `useStore(form.store)` y el componente `form.Subscribe`. Estos métodos le permiten optimizar el rendimiento de renderizado de su formulario actualizando solo los componentes cuando sea necesario.
+`@tanstack/react-form` ofrece varias formas de suscribirse a cambios de estado del formulario y campos, más notablemente el hook `useStore(form.store)` y el componente `form.Subscribe`. Estos métodos le permiten optimizar el rendimiento de renderizado de su formulario actualizando solo los componentes cuando sea necesario.
 
 Ejemplo:
 
@@ -246,9 +269,9 @@ Ejemplo:
 />
 ```
 
-Más información se puede encontrar en [Oyentes](./listeners.md)
+Puede encontrar más información en [Oyentes (Listeners)](./listeners.md)
 
-## Campos de Arreglo
+## Campos de Arreglo (Array Fields)
 
 Los campos de arreglo le permiten administrar una lista de valores dentro de un formulario, como una lista de pasatiempos. Puede crear un campo de arreglo utilizando el componente `form.Field` con la propiedad `mode="array"`.
 
@@ -330,10 +353,10 @@ Ejemplo:
 />
 ```
 
-## Botones de Reinicio
+## Botones de Reinicio (Reset Buttons)
 
-Cuando se utiliza `<button type="reset">` junto con `form.reset()` de TanStack Form, debe evitar el comportamiento de reinicio HTML predeterminado para evitar reinicios inesperados de elementos del formulario (especialmente elementos `<select>`) a sus valores HTML iniciales.
-Use `event.preventDefault()` dentro del manejador `onClick` del botón para evitar el reinicio nativo del formulario.
+Cuando se utiliza `<button type="reset">` junto con `form.reset()` de TanStack Form, debe prevenir el comportamiento de reinicio HTML predeterminado para evitar reinicios inesperados de elementos del formulario (especialmente elementos `<select>`) a sus valores HTML iniciales.
+Use `event.preventDefault()` dentro del manejador `onClick` del botón para prevenir el reinicio nativo del formulario.
 
 Ejemplo:
 
@@ -349,7 +372,7 @@ Ejemplo:
 </button>
 ```
 
-Alternativamente, puede usar `<button type="button">` para evitar el reinicio HTML nativo.
+Alternativamente, puede usar `<button type="button">` para prevenir el reinicio HTML nativo.
 
 ```tsx
 <button
@@ -362,4 +385,4 @@ Alternativamente, puede usar `<button type="button">` para evitar el reinicio HT
 </button>
 ```
 
-Estos son los conceptos básicos y la terminología utilizada en la biblioteca `@tanstack/react-form`. Comprender estos conceptos le ayudará a trabajar de manera más efectiva con la biblioteca y crear formularios complejos con facilidad.
+Estos son los conceptos básicos y la terminología utilizados en la biblioteca `@tanstack/react-form`. Comprender estos conceptos le ayudará a trabajar de manera más efectiva con la biblioteca y crear formularios complejos con facilidad.
diff --git a/docs/es/reference/classes/fieldapi.md b/docs/es/reference/classes/fieldapi.md
index 6566bd4ed..2345c6317 100644
--- a/docs/es/reference/classes/fieldapi.md
+++ b/docs/es/reference/classes/fieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:51:40.649Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:39.013Z'
 id: FieldApi
 title: FieldApi
 ---
@@ -9,7 +9,7 @@ title: FieldApi
 
 # Class: FieldApi\<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta\>
 
-Defined in: [packages/form-core/src/FieldApi.ts:859](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L859)
+Defined in: [packages/form-core/src/FieldApi.ts:863](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L863)
 
 A class representing the API for managing a form field.
 
@@ -67,7 +67,7 @@ the `new FieldApi` constructor.
 new FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>(opts): FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:991](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L991)
+Defined in: [packages/form-core/src/FieldApi.ts:995](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L995)
 
 Initializes a new `FieldApi` instance.
 
@@ -89,7 +89,7 @@ Initializes a new `FieldApi` instance.
 form: FormApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:903](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L903)
+Defined in: [packages/form-core/src/FieldApi.ts:907](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L907)
 
 A reference to the form API instance.
 
@@ -101,7 +101,7 @@ A reference to the form API instance.
 name: DeepKeys<TParentData>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:927](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L927)
+Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
 
 The field name.
 
@@ -113,7 +113,7 @@ The field name.
 options: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
+Defined in: [packages/form-core/src/FieldApi.ts:935](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L935)
 
 The field options.
 
@@ -125,7 +125,7 @@ The field options.
 store: Derived<FieldState<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:955](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L955)
+Defined in: [packages/form-core/src/FieldApi.ts:959](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L959)
 
 The field state store.
 
@@ -137,7 +137,7 @@ The field state store.
 timeoutIds: object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:982](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L982)
+Defined in: [packages/form-core/src/FieldApi.ts:986](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L986)
 
 #### formListeners
 
@@ -167,7 +167,7 @@ validations: Record<ValidationCause, null | Timeout>;
 get state(): FieldState<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:979](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L979)
+Defined in: [packages/form-core/src/FieldApi.ts:983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L983)
 
 The current field state.
 
@@ -183,7 +183,7 @@ The current field state.
 getInfo(): FieldInfo<TParentData>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1245](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1245)
+Defined in: [packages/form-core/src/FieldApi.ts:1249](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1249)
 
 Gets the field information object.
 
@@ -199,7 +199,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:1213](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1213)
+Defined in: [packages/form-core/src/FieldApi.ts:1217](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1217)
 
 #### Returns
 
@@ -213,7 +213,7 @@ Defined in: [packages/form-core/src/FieldApi.ts:1213](https://github.com/TanStac
 getValue(): TData
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1198](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1198)
+Defined in: [packages/form-core/src/FieldApi.ts:1202](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1202)
 
 Gets the current field value.
 
@@ -233,7 +233,7 @@ Use `field.state.value` instead.
 handleBlur(): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1657](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1657)
+Defined in: [packages/form-core/src/FieldApi.ts:1661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1661)
 
 Handles the blur event.
 
@@ -249,7 +249,7 @@ Handles the blur event.
 handleChange(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1650](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1650)
+Defined in: [packages/form-core/src/FieldApi.ts:1654](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1654)
 
 Handles the change event.
 
@@ -274,7 +274,7 @@ insertValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1262](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1262)
+Defined in: [packages/form-core/src/FieldApi.ts:1266](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1266)
 
 Inserts a value at the specified index, shifting the subsequent values to the right.
 
@@ -304,7 +304,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:1088](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1088)
+Defined in: [packages/form-core/src/FieldApi.ts:1092](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1092)
 
 Mounts the field instance to the form.
 
@@ -327,7 +327,7 @@ moveValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1306](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1306)
+Defined in: [packages/form-core/src/FieldApi.ts:1310](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1310)
 
 Moves the value at the first specified index to the second specified index.
 
@@ -359,7 +359,7 @@ parseValueWithSchema(schema):
   | StandardSchemaV1Issue[]
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1699](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1699)
+Defined in: [packages/form-core/src/FieldApi.ts:1703](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1703)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -387,7 +387,7 @@ parseValueWithSchemaAsync(schema): Promise<
 | StandardSchemaV1Issue[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1711](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1711)
+Defined in: [packages/form-core/src/FieldApi.ts:1715](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1715)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -414,7 +414,7 @@ The standard schema to parse this field's value with.
 pushValue(value, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1250](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1250)
+Defined in: [packages/form-core/src/FieldApi.ts:1254](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1254)
 
 Pushes a new value to the field.
 
@@ -440,7 +440,7 @@ Pushes a new value to the field.
 removeValue(index, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1288](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1288)
+Defined in: [packages/form-core/src/FieldApi.ts:1292](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1292)
 
 Removes a value at the specified index.
 
@@ -469,7 +469,7 @@ replaceValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1275](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1275)
+Defined in: [packages/form-core/src/FieldApi.ts:1279](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1279)
 
 Replaces a value at the specified index.
 
@@ -499,7 +499,7 @@ Replaces a value at the specified index.
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1674](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1674)
+Defined in: [packages/form-core/src/FieldApi.ts:1678](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1678)
 
 Updates the field's errorMap
 
@@ -521,7 +521,7 @@ Updates the field's errorMap
 setMeta(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1218](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1218)
+Defined in: [packages/form-core/src/FieldApi.ts:1222](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1222)
 
 Sets the field metadata.
 
@@ -543,7 +543,7 @@ Sets the field metadata.
 setValue(updater, options?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1205](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1205)
+Defined in: [packages/form-core/src/FieldApi.ts:1209](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1209)
 
 Sets the field value and run the `change` validator.
 
@@ -572,7 +572,7 @@ swapValues(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1297](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1297)
+Defined in: [packages/form-core/src/FieldApi.ts:1301](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1301)
 
 Swaps the values at the specified indices.
 
@@ -602,7 +602,7 @@ Swaps the values at the specified indices.
 update(opts): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1141](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1141)
+Defined in: [packages/form-core/src/FieldApi.ts:1145](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1145)
 
 Updates the field instance with new options.
 
@@ -624,7 +624,7 @@ Updates the field instance with new options.
 validate(cause, opts?): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1617](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1617)
+Defined in: [packages/form-core/src/FieldApi.ts:1621](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1621)
 
 Validates the field value.
 
diff --git a/docs/es/reference/classes/formapi.md b/docs/es/reference/classes/formapi.md
index 80136bfdf..07156df7f 100644
--- a/docs/es/reference/classes/formapi.md
+++ b/docs/es/reference/classes/formapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:51:40.645Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:39.009Z'
 id: FormApi
 title: FormApi
 ---
@@ -9,7 +9,7 @@ title: FormApi
 
 # Class: FormApi\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta\>
 
-Defined in: [packages/form-core/src/FormApi.ts:767](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L767)
+Defined in: [packages/form-core/src/FormApi.ts:771](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L771)
 
 A class representing the Form API. It handles the logic and interactions with the form state.
 
@@ -47,7 +47,7 @@ However, if you need to create a new instance manually, you can do so by calling
 new FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>(opts?): FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:838](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L838)
+Defined in: [packages/form-core/src/FormApi.ts:842](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L842)
 
 Constructs a new `FormApi` instance with the given form options.
 
@@ -69,7 +69,7 @@ Constructs a new `FormApi` instance with the given form options.
 baseStore: Store<BaseFormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L794)
+Defined in: [packages/form-core/src/FormApi.ts:798](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L798)
 
 ***
 
@@ -79,7 +79,7 @@ Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/
 fieldInfo: Record<DeepKeys<TFormData>, FieldInfo<TFormData>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:824](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L824)
+Defined in: [packages/form-core/src/FormApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L828)
 
 A record of field information for each field in the form.
 
@@ -91,7 +91,7 @@ A record of field information for each field in the form.
 fieldMetaDerived: Derived<Record<DeepKeys<TFormData>, AnyFieldMeta>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L807)
+Defined in: [packages/form-core/src/FormApi.ts:811](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L811)
 
 ***
 
@@ -101,7 +101,7 @@ Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/
 options: FormOptions<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta> = {};
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:782](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L782)
+Defined in: [packages/form-core/src/FormApi.ts:786](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L786)
 
 The options for the form.
 
@@ -113,7 +113,7 @@ The options for the form.
 store: Derived<FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L808)
+Defined in: [packages/form-core/src/FormApi.ts:812](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L812)
 
 ## Accessors
 
@@ -125,7 +125,7 @@ Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/
 get state(): FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L826)
+Defined in: [packages/form-core/src/FormApi.ts:830](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L830)
 
 ##### Returns
 
@@ -139,7 +139,7 @@ Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/
 deleteField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1912)
+Defined in: [packages/form-core/src/FormApi.ts:1938](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1938)
 
 #### Type Parameters
 
@@ -163,7 +163,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack
 getAllErrors(): object
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2148](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2148)
+Defined in: [packages/form-core/src/FormApi.ts:2174](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2174)
 
 Returns form and field level errors
 
@@ -214,7 +214,7 @@ errors: (
 getFieldInfo<TField>(field): FieldInfo<TFormData>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1826)
+Defined in: [packages/form-core/src/FormApi.ts:1852](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1852)
 
 Gets the field info of the specified field.
 
@@ -240,7 +240,7 @@ Gets the field info of the specified field.
 getFieldMeta<TField>(field): undefined | AnyFieldMeta
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1817](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1817)
+Defined in: [packages/form-core/src/FormApi.ts:1843](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1843)
 
 Gets the metadata of the specified field.
 
@@ -266,7 +266,7 @@ Gets the metadata of the specified field.
 getFieldValue<TField>(field): DeepValue<TFormData, TField>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1810](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1810)
+Defined in: [packages/form-core/src/FormApi.ts:1836](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1836)
 
 Gets the value of the specified field.
 
@@ -294,7 +294,7 @@ Gets the value of the specified field.
 handleSubmit(): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1712](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1712)
+Defined in: [packages/form-core/src/FormApi.ts:1738](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1738)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -308,7 +308,7 @@ Handles the form submission, performs validation, and calls the appropriate onSu
 handleSubmit(submitMeta): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1713](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1713)
+Defined in: [packages/form-core/src/FormApi.ts:1739](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1739)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -334,7 +334,7 @@ insertFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1951)
+Defined in: [packages/form-core/src/FormApi.ts:1977](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1977)
 
 #### Type Parameters
 
@@ -370,7 +370,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack
 mount(): () => void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1142](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1142)
+Defined in: [packages/form-core/src/FormApi.ts:1168](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1168)
 
 #### Returns
 
@@ -392,7 +392,7 @@ moveFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2075](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2075)
+Defined in: [packages/form-core/src/FormApi.ts:2101](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2101)
 
 Moves the value at the first specified index to the second specified index within an array field.
 
@@ -435,7 +435,7 @@ parseValuesWithSchema(schema):
 }
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2208](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2208)
+Defined in: [packages/form-core/src/FormApi.ts:2234](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2234)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -469,7 +469,7 @@ parseValuesWithSchemaAsync(schema): Promise<
 }>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2220](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2220)
+Defined in: [packages/form-core/src/FormApi.ts:2246](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2246)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -502,7 +502,7 @@ pushFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1936](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1936)
+Defined in: [packages/form-core/src/FormApi.ts:1962](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1962)
 
 Pushes a value into an array field.
 
@@ -539,7 +539,7 @@ removeFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
+Defined in: [packages/form-core/src/FormApi.ts:2035](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2035)
 
 Removes a value from an array field at the specified index.
 
@@ -577,7 +577,7 @@ replaceFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1983)
+Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
 
 Replaces a value into an array field at the specified index.
 
@@ -615,7 +615,7 @@ Replaces a value into an array field at the specified index.
 reset(values?, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1230](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1230)
+Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
 
 Resets the form state to the default values.
 If values are provided, the form will be reset to those values instead and the default values will be updated.
@@ -648,7 +648,7 @@ Optional options to control the reset behavior.
 resetField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2103](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2103)
+Defined in: [packages/form-core/src/FormApi.ts:2129](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2129)
 
 Resets the field value and meta to default state
 
@@ -674,7 +674,7 @@ Resets the field value and meta to default state
 resetFieldMeta<TField>(fieldMeta): Record<TField, AnyFieldMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1866](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1866)
+Defined in: [packages/form-core/src/FormApi.ts:1892](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1892)
 
 resets every field's meta
 
@@ -700,7 +700,7 @@ resets every field's meta
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2124](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2124)
+Defined in: [packages/form-core/src/FormApi.ts:2150](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2150)
 
 Updates the form's errorMap
 
@@ -722,7 +722,7 @@ Updates the form's errorMap
 setFieldMeta<TField>(field, updater): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1845](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1845)
+Defined in: [packages/form-core/src/FormApi.ts:1871](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1871)
 
 Updates the metadata of the specified field.
 
@@ -755,7 +755,7 @@ setFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1882](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1882)
+Defined in: [packages/form-core/src/FormApi.ts:1908](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1908)
 
 Sets the value of the specified field and optionally updates the touched state.
 
@@ -793,7 +793,7 @@ swapFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2046](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2046)
+Defined in: [packages/form-core/src/FormApi.ts:2072](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2072)
 
 Swaps the values at the specified indices within an array field.
 
@@ -831,7 +831,7 @@ Swaps the values at the specified indices within an array field.
 update(options?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1162](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1162)
+Defined in: [packages/form-core/src/FormApi.ts:1188](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1188)
 
 Updates the form options and form state.
 
@@ -853,7 +853,7 @@ Updates the form options and form state.
 validateAllFields(cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
+Defined in: [packages/form-core/src/FormApi.ts:1282](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1282)
 
 Validates all fields using the correct handlers for a given validation cause.
 
@@ -878,7 +878,7 @@ validateArrayFieldsStartingFrom<TField>(
 cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1286](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1286)
+Defined in: [packages/form-core/src/FormApi.ts:1312](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1312)
 
 Validates the children of a specified array in the form starting from a given index until the end using the correct handlers for a given validation type.
 
@@ -912,7 +912,7 @@ Validates the children of a specified array in the form starting from a given in
 validateField<TField>(field, cause): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1325](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1325)
+Defined in: [packages/form-core/src/FormApi.ts:1351](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1351)
 
 Validates a specified field in the form using the correct handlers for a given validation type.
 
diff --git a/docs/es/reference/functions/evaluate.md b/docs/es/reference/functions/evaluate.md
new file mode 100644
index 000000000..268dbde14
--- /dev/null
+++ b/docs/es/reference/functions/evaluate.md
@@ -0,0 +1,34 @@
+---
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:39.005Z'
+id: evaluate
+title: evaluate
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: evaluate()
+
+```ts
+function evaluate<T>(objA, objB): boolean
+```
+
+Defined in: [packages/form-core/src/utils.ts:339](https://github.com/TanStack/form/blob/main/packages/form-core/src/utils.ts#L339)
+
+## Type Parameters
+
+• **T**
+
+## Parameters
+
+### objA
+
+`T`
+
+### objB
+
+`T`
+
+## Returns
+
+`boolean`
diff --git a/docs/es/reference/index.md b/docs/es/reference/index.md
index bf032e195..7c0262fd7 100644
--- a/docs/es/reference/index.md
+++ b/docs/es/reference/index.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-25T12:58:29.000Z'
-translation-updated-at: '2025-04-30T22:41:41.726Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:38.961Z'
 id: '@tanstack/form-core'
 title: '@tanstack/form-core'
 ---
@@ -84,8 +84,8 @@ title: '@tanstack/form-core'
 
 ## Functions
 
+- [evaluate](functions/evaluate.md)
 - [formOptions](functions/formoptions.md)
 - [isGlobalFormValidationError](functions/isglobalformvalidationerror.md)
 - [isStandardSchemaValidator](functions/isstandardschemavalidator.md)
 - [mergeForm](functions/mergeform.md)
-- [shallow](functions/shallow.md)
diff --git a/docs/es/reference/interfaces/formstate.md b/docs/es/reference/interfaces/formstate.md
index 074cf9e6f..f2f2e80cb 100644
--- a/docs/es/reference/interfaces/formstate.md
+++ b/docs/es/reference/interfaces/formstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:19:27.691Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:38.965Z'
 id: FormState
 title: FormState
 ---
@@ -9,7 +9,7 @@ title: FormState
 
 # Interface: FormState\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer\>
 
-Defined in: [packages/form-core/src/FormApi.ts:643](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L643)
+Defined in: [packages/form-core/src/FormApi.ts:647](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L647)
 
 An object representing the current state of the form.
 
@@ -63,7 +63,7 @@ BaseFormState._force_re_eval
 canSubmit: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
+Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
 
 A boolean indicating if the form can be submitted based on its current state.
 
@@ -125,7 +125,7 @@ DerivedFormState.errors
 fieldMeta: Record<DeepKeys<TFormData>, AnyFieldMeta>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
+Defined in: [packages/form-core/src/FormApi.ts:644](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L644)
 
 A record of field metadata for each field in the form.
 
@@ -173,6 +173,24 @@ DerivedFormState.isBlurred
 
 ***
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+
+A boolean indicating if all of the form's fields are the same as default values.
+
+#### Inherited from
+
+```ts
+DerivedFormState.isDefaultValue
+```
+
+***
+
 ### isDirty
 
 ```ts
@@ -371,7 +389,7 @@ DerivedFormState.isTouched
 isValid: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
 
 A boolean indicating if the form and all its fields are valid. Evaluates `true` if there are no errors.
 
diff --git a/docs/es/reference/type-aliases/anyfieldapi.md b/docs/es/reference/type-aliases/anyfieldapi.md
index 74ba2b71c..468bc937c 100644
--- a/docs/es/reference/type-aliases/anyfieldapi.md
+++ b/docs/es/reference/type-aliases/anyfieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:19:27.661Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:39.002Z'
 id: AnyFieldApi
 title: AnyFieldApi
 ---
@@ -13,6 +13,6 @@ title: AnyFieldApi
 type AnyFieldApi = FieldApi<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L828)
+Defined in: [packages/form-core/src/FieldApi.ts:832](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L832)
 
 A type representing the Field API with all generics set to `any` for convenience.
diff --git a/docs/es/reference/type-aliases/anyfieldmeta.md b/docs/es/reference/type-aliases/anyfieldmeta.md
index 80d26e87a..c9a809ab5 100644
--- a/docs/es/reference/type-aliases/anyfieldmeta.md
+++ b/docs/es/reference/type-aliases/anyfieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:19:27.657Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:38.995Z'
 id: AnyFieldMeta
 title: AnyFieldMeta
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMeta
 type AnyFieldMeta = FieldMeta<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L747)
+Defined in: [packages/form-core/src/FieldApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L751)
diff --git a/docs/es/reference/type-aliases/anyfieldmetaderived.md b/docs/es/reference/type-aliases/anyfieldmetaderived.md
index f8c6677a0..1dafbc470 100644
--- a/docs/es/reference/type-aliases/anyfieldmetaderived.md
+++ b/docs/es/reference/type-aliases/anyfieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:19:27.646Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:38.992Z'
 id: AnyFieldMetaDerived
 title: AnyFieldMetaDerived
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMetaDerived
 type AnyFieldMetaDerived = FieldMetaDerived<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L661)
+Defined in: [packages/form-core/src/FieldApi.ts:665](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L665)
diff --git a/docs/es/reference/type-aliases/anyformapi.md b/docs/es/reference/type-aliases/anyformapi.md
index 16224748b..dd41891c7 100644
--- a/docs/es/reference/type-aliases/anyformapi.md
+++ b/docs/es/reference/type-aliases/anyformapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:19:27.642Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:38.988Z'
 id: AnyFormApi
 title: AnyFormApi
 ---
@@ -13,6 +13,6 @@ title: AnyFormApi
 type AnyFormApi = FormApi<any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L747)
+Defined in: [packages/form-core/src/FormApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L751)
 
 A type representing the Form API with all generics set to `any` for convenience.
diff --git a/docs/es/reference/type-aliases/anyformstate.md b/docs/es/reference/type-aliases/anyformstate.md
index 7937635eb..5cd594c97 100644
--- a/docs/es/reference/type-aliases/anyformstate.md
+++ b/docs/es/reference/type-aliases/anyformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:19:27.638Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:38.984Z'
 id: AnyFormState
 title: AnyFormState
 ---
@@ -13,4 +13,4 @@ title: AnyFormState
 type AnyFormState = FormState<any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:676](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L676)
+Defined in: [packages/form-core/src/FormApi.ts:680](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L680)
diff --git a/docs/es/reference/type-aliases/derivedformstate.md b/docs/es/reference/type-aliases/derivedformstate.md
index 391906ed1..f6fa3c097 100644
--- a/docs/es/reference/type-aliases/derivedformstate.md
+++ b/docs/es/reference/type-aliases/derivedformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:42.409Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:38.980Z'
 id: DerivedFormState
 title: DerivedFormState
 ---
@@ -77,6 +77,14 @@ isBlurred: boolean;
 
 A boolean indicating if any of the form fields have been blurred.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A boolean indicating if all of the form's fields are the same as default values.
+
 ### isDirty
 
 ```ts
diff --git a/docs/es/reference/type-aliases/fieldmeta.md b/docs/es/reference/type-aliases/fieldmeta.md
index 261937053..488f4ef1f 100644
--- a/docs/es/reference/type-aliases/fieldmeta.md
+++ b/docs/es/reference/type-aliases/fieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:42.286Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:38.977Z'
 id: FieldMeta
 title: FieldMeta
 ---
@@ -13,7 +13,7 @@ title: FieldMeta
 type FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = FieldMetaBase<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> & FieldMetaDerived<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:684](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L684)
+Defined in: [packages/form-core/src/FieldApi.ts:688](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L688)
 
 An object type representing the metadata of a field in a form.
 
diff --git a/docs/es/reference/type-aliases/fieldmetaderived.md b/docs/es/reference/type-aliases/fieldmetaderived.md
index 1e5b44041..bccc64902 100644
--- a/docs/es/reference/type-aliases/fieldmetaderived.md
+++ b/docs/es/reference/type-aliases/fieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:19:27.599Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:38.973Z'
 id: FieldMetaDerived
 title: FieldMetaDerived
 ---
@@ -68,6 +68,14 @@ errors: (
 
 An array of errors related to the field value.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A flag indicating whether the field's current value is the default value
+
 ### isPristine
 
 ```ts
diff --git a/docs/es/reference/type-aliases/fieldstate.md b/docs/es/reference/type-aliases/fieldstate.md
index 980cf832b..d7d76cc20 100644
--- a/docs/es/reference/type-aliases/fieldstate.md
+++ b/docs/es/reference/type-aliases/fieldstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:42.325Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:45:38.969Z'
 id: FieldState
 title: FieldState
 ---
@@ -13,7 +13,7 @@ title: FieldState
 type FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:770](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L770)
+Defined in: [packages/form-core/src/FieldApi.ts:774](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L774)
 
 An object type representing the state of a field.
 
diff --git a/docs/fr/framework/react/guides/basic-concepts.md b/docs/fr/framework/react/guides/basic-concepts.md
index d22d5f33d..66ee12e0d 100644
--- a/docs/fr/framework/react/guides/basic-concepts.md
+++ b/docs/fr/framework/react/guides/basic-concepts.md
@@ -1,13 +1,13 @@
 ---
-source-updated-at: '2025-04-16T08:45:06.000Z'
-translation-updated-at: '2025-04-30T21:36:23.772Z'
+source-updated-at: '2025-05-08T07:42:29.000Z'
+translation-updated-at: '2025-05-08T23:51:04.723Z'
 id: basic-concepts
 title: Concepts de base
 ---
 
 Cette page présente les concepts de base et la terminologie utilisés dans la bibliothèque `@tanstack/react-form`. Se familiariser avec ces concepts vous aidera à mieux comprendre et travailler avec la bibliothèque.
 
-## Options de formulaire
+## Options de formulaire (Form Options)
 
 Vous pouvez créer des options pour votre formulaire afin qu'elles puissent être partagées entre plusieurs formulaires en utilisant la fonction `formOptions`.
 
@@ -26,9 +26,9 @@ const formOpts = formOptions({
 })
 ```
 
-## Instance de formulaire
+## Instance de formulaire (Form Instance)
 
-Une Instance de formulaire est un objet qui représente un formulaire individuel et fournit des méthodes et propriétés pour travailler avec le formulaire. Vous créez une instance de formulaire en utilisant le hook `useForm` fourni par les options de formulaire. Le hook accepte un objet avec une fonction `onSubmit`, qui est appelée lorsque le formulaire est soumis.
+Une instance de formulaire (Form Instance) est un objet qui représente un formulaire individuel et fournit des méthodes et des propriétés pour travailler avec le formulaire. Vous créez une instance de formulaire en utilisant le hook `useForm` fourni par les options de formulaire. Le hook accepte un objet avec une fonction `onSubmit`, qui est appelée lorsque le formulaire est soumis.
 
 ```tsx
 const form = useForm({
@@ -59,9 +59,9 @@ const form = useForm({
 })
 ```
 
-## Champ
+## Champ (Field)
 
-Un Champ représente un seul élément de saisie de formulaire, comme un champ de texte ou une case à cocher. Les champs sont créés en utilisant le composant `form.Field` fourni par l'instance de formulaire. Le composant accepte une prop `name`, qui doit correspondre à une clé dans les valeurs par défaut du formulaire. Il accepte également une prop `children`, qui est une fonction de rendu qui prend un objet champ comme argument.
+Un champ (Field) représente un seul élément de saisie de formulaire, comme un champ de texte ou une case à cocher. Les champs sont créés en utilisant le composant `form.Field` fourni par l'instance de formulaire. Le composant accepte une prop `name`, qui doit correspondre à une clé dans les valeurs par défaut du formulaire. Il accepte également une prop `children`, qui est une fonction de rendu (render prop) prenant un objet field comme argument.
 
 Exemple :
 
@@ -81,9 +81,9 @@ Exemple :
 />
 ```
 
-## État d'un champ
+## État du champ (Field State)
 
-Chaque champ a son propre état, qui inclut sa valeur actuelle, son statut de validation, ses messages d'erreur et d'autres métadonnées. Vous pouvez accéder à l'état d'un champ en utilisant la propriété `field.state`.
+Chaque champ a son propre état (Field State), qui inclut sa valeur actuelle, son statut de validation, ses messages d'erreur et d'autres métadonnées. Vous pouvez accéder à l'état d'un champ en utilisant la propriété `field.state`.
 
 Exemple :
 
@@ -94,21 +94,44 @@ const {
 } = field.state
 ```
 
-Il existe trois états de champ qui peuvent être utiles pour voir comment l'utilisateur interagit avec un champ : un champ est _"touché"_ lorsque l'utilisateur clique/tabule dessus, _"vierge"_ jusqu'à ce que l'utilisateur modifie sa valeur, et _"modifié"_ après que la valeur a été changée. Vous pouvez vérifier ces états via les indicateurs `isTouched`, `isPristine` et `isDirty`, comme vu ci-dessous.
+Il existe trois états dans les métadonnées qui peuvent être utiles pour voir comment l'utilisateur interagit avec un champ :
+
+- _"isTouched"_, après que l'utilisateur a cliqué ou est passé sur le champ
+- _"isPristine"_, jusqu'à ce que l'utilisateur modifie la valeur du champ
+- _"isDirty"_, après que la valeur du champ a été modifiée
 
 ```tsx
 const { isTouched, isPristine, isDirty } = field.state.meta
 ```
 
-![États d'un champ](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states.png)
+![États du champ](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states.png)
+
+## Comprendre 'isDirty' dans différentes bibliothèques
+
+État `dirty` non persistant
+
+- **Bibliothèques** : React Hook Form (RHF), Formik, Final Form.
+- **Comportement** : Un champ est 'dirty' si sa valeur diffère de la valeur par défaut. Revenir à la valeur par défaut le rend 'clean' à nouveau.
+
+État `dirty` persistant
+
+- **Bibliothèques** : Angular Form, Vue FormKit.
+- **Comportement** : Un champ reste 'dirty' une fois modifié, même s'il revient à la valeur par défaut.
+
+Nous avons choisi le modèle d'état 'dirty' persistant. Pour également supporter un état 'dirty' non persistant, nous introduisons le flag `isDefault`. Ce flag agit comme l'inverse de l'état 'dirty' non persistant.
+
+```tsx
+const { isTouched, isPristine, isDirty, isDefaultValue } = field.state.meta
+
+// La ligne suivante recrée la fonctionnalité `dirty` non persistante.
+const nonPersistentIsDirty = !isDefaultValue
+```
 
-> **Note importante pour les utilisateurs venant de `React Hook Form`** : l'indicateur `isDirty` dans `TanStack/form` est différent de l'indicateur du même nom dans RHF.
-> Dans RHF, `isDirty = true` lorsque les valeurs du formulaire sont différentes des valeurs originales. Si l'utilisateur modifie les valeurs d'un formulaire, puis les modifie à nouveau pour revenir aux valeurs par défaut du formulaire, `isDirty` sera `false` dans RHF, mais `true` dans `TanStack/form`.
-> Les valeurs par défaut sont exposées à la fois au niveau du formulaire et du champ dans `TanStack/form` (`form.options.defaultValues`, `field.options.defaultValue`), vous pouvez donc écrire votre propre helper `isDefaultValue()` si vous avez besoin d'émuler le comportement de RHF.
+![États du champ étendus](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states-extended.png)
 
-## API de champ
+## API de champ (Field API)
 
-L'API de champ est un objet passé à la fonction de rendu lors de la création d'un champ. Elle fournit des méthodes pour travailler avec l'état du champ.
+L'API de champ (Field API) est un objet passé à la fonction de rendu lors de la création d'un champ. Elle fournit des méthodes pour travailler avec l'état du champ.
 
 Exemple :
 
@@ -122,7 +145,7 @@ Exemple :
 
 ## Validation
 
-`@tanstack/react-form` fournit à la fois une validation synchrone et asynchrone prête à l'emploi. Les fonctions de validation peuvent être passées au composant `form.Field` en utilisant la prop `validators`.
+`@tanstack/react-form` fournit une validation synchrone et asynchrone prête à l'emploi. Les fonctions de validation peuvent être passées au composant `form.Field` en utilisant la prop `validators`.
 
 Exemple :
 
@@ -154,13 +177,13 @@ Exemple :
 />
 ```
 
-## Validation avec des bibliothèques de schéma standard
+## Validation avec les bibliothèques de schéma standard
 
-En plus des options de validation personnalisées, nous prenons également en charge la spécification [Standard Schema](https://github.com/standard-schema/standard-schema).
+En plus des options de validation personnalisées, nous supportons également la spécification [Standard Schema](https://github.com/standard-schema/standard-schema).
 
 Vous pouvez définir un schéma en utilisant n'importe quelle bibliothèque implémentant la spécification et le passer à un validateur de formulaire ou de champ.
 
-Les bibliothèques prises en charge incluent :
+Les bibliothèques supportées incluent :
 
 - [Zod](https://zod.dev/)
 - [Valibot](https://valibot.dev/)
@@ -195,7 +218,7 @@ function App() {
 }
 ```
 
-## Réactivité
+## Réactivité (Reactivity)
 
 `@tanstack/react-form` offre diverses façons de s'abonner aux changements d'état du formulaire et des champs, notamment le hook `useStore(form.store)` et le composant `form.Subscribe`. Ces méthodes vous permettent d'optimiser les performances de rendu de votre formulaire en ne mettant à jour les composants que lorsque nécessaire.
 
@@ -214,7 +237,7 @@ const firstName = useStore(form.store, (state) => state.values.firstName)
 />
 ```
 
-Il est important de se rappeler que bien que la prop `selector` du hook `useStore` soit optionnelle, il est fortement recommandé de la fournir, car son omission entraînera des re-rendus inutiles.
+Il est important de se rappeler que bien que la prop `selector` du hook `useStore` soit optionnelle, il est fortement recommandé de la fournir, car l'omettre entraînera des re-rendus inutiles.
 
 ```tsx
 // Utilisation correcte
@@ -226,7 +249,7 @@ const store = useStore(form.store)
 
 Remarque : L'utilisation du hook `useField` pour obtenir de la réactivité est déconseillée car il est conçu pour être utilisé avec précaution dans le composant `form.Field`. Vous devriez plutôt utiliser `useStore(form.store)`.
 
-## Écouteurs
+## Écouteurs (Listeners)
 
 `@tanstack/react-form` vous permet de réagir à des déclencheurs spécifiques et de les "écouter" pour déclencher des effets secondaires.
 
@@ -244,11 +267,11 @@ Exemple :
 />
 ```
 
-Plus d'informations peuvent être trouvées sur [Écouteurs](./listeners.md)
+Plus d'informations sont disponibles sur [Écouteurs](./listeners.md)
 
-## Champs de tableau
+## Champs de tableau (Array Fields)
 
-Les champs de tableau vous permettent de gérer une liste de valeurs dans un formulaire, comme une liste de hobbies. Vous pouvez créer un champ de tableau en utilisant le composant `form.Field` avec la prop `mode="array"`.
+Les champs de tableau (Array Fields) vous permettent de gérer une liste de valeurs dans un formulaire, comme une liste de hobbies. Vous pouvez créer un champ de tableau en utilisant le composant `form.Field` avec la prop `mode="array"`.
 
 Lorsque vous travaillez avec des champs de tableau, vous pouvez utiliser les méthodes `pushValue`, `removeValue`, `swapValues` et `moveValue` des champs pour ajouter, supprimer et échanger des valeurs dans le tableau.
 
@@ -328,9 +351,9 @@ Exemple :
 />
 ```
 
-## Boutons de réinitialisation
+## Boutons de réinitialisation (Reset Buttons)
 
-Lorsque vous utilisez `<button type="reset">` en conjonction avec `form.reset()` de TanStack Form, vous devez empêcher le comportement de réinitialisation HTML par défaut pour éviter des réinitialisations inattendues des éléments de formulaire (en particulier les éléments `<select>`) à leurs valeurs HTML initiales.
+Lorsque vous utilisez `<button type="reset">` avec la fonction `form.reset()` de TanStack Form, vous devez empêcher le comportement de réinitialisation HTML par défaut pour éviter des réinitialisations inattendues des éléments de formulaire (en particulier les éléments `<select>`) à leurs valeurs HTML initiales.
 Utilisez `event.preventDefault()` dans le gestionnaire `onClick` du bouton pour empêcher la réinitialisation native du formulaire.
 
 Exemple :
@@ -360,4 +383,4 @@ Alternativement, vous pouvez utiliser `<button type="button">` pour empêcher la
 </button>
 ```
 
-Voici les concepts de base et la terminologie utilisés dans la bibliothèque `@tanstack/react-form`. Comprendre ces concepts vous aidera à travailler plus efficacement avec la bibliothèque et à créer des formulaires complexes avec facilité.
+Ce sont les concepts de base et la terminologie utilisés dans la bibliothèque `@tanstack/react-form`. Comprendre ces concepts vous aidera à travailler plus efficacement avec la bibliothèque et à créer des formulaires complexes avec facilité.
diff --git a/docs/fr/reference/classes/fieldapi.md b/docs/fr/reference/classes/fieldapi.md
index 965446e6c..c5a65987c 100644
--- a/docs/fr/reference/classes/fieldapi.md
+++ b/docs/fr/reference/classes/fieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:52:43.224Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.410Z'
 id: FieldApi
 title: FieldApi
 ---
@@ -9,7 +9,7 @@ title: FieldApi
 
 # Class: FieldApi\<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta\>
 
-Defined in: [packages/form-core/src/FieldApi.ts:859](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L859)
+Defined in: [packages/form-core/src/FieldApi.ts:863](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L863)
 
 A class representing the API for managing a form field.
 
@@ -67,7 +67,7 @@ the `new FieldApi` constructor.
 new FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>(opts): FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:991](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L991)
+Defined in: [packages/form-core/src/FieldApi.ts:995](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L995)
 
 Initializes a new `FieldApi` instance.
 
@@ -89,7 +89,7 @@ Initializes a new `FieldApi` instance.
 form: FormApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:903](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L903)
+Defined in: [packages/form-core/src/FieldApi.ts:907](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L907)
 
 A reference to the form API instance.
 
@@ -101,7 +101,7 @@ A reference to the form API instance.
 name: DeepKeys<TParentData>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:927](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L927)
+Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
 
 The field name.
 
@@ -113,7 +113,7 @@ The field name.
 options: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
+Defined in: [packages/form-core/src/FieldApi.ts:935](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L935)
 
 The field options.
 
@@ -125,7 +125,7 @@ The field options.
 store: Derived<FieldState<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:955](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L955)
+Defined in: [packages/form-core/src/FieldApi.ts:959](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L959)
 
 The field state store.
 
@@ -137,7 +137,7 @@ The field state store.
 timeoutIds: object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:982](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L982)
+Defined in: [packages/form-core/src/FieldApi.ts:986](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L986)
 
 #### formListeners
 
@@ -167,7 +167,7 @@ validations: Record<ValidationCause, null | Timeout>;
 get state(): FieldState<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:979](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L979)
+Defined in: [packages/form-core/src/FieldApi.ts:983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L983)
 
 The current field state.
 
@@ -183,7 +183,7 @@ The current field state.
 getInfo(): FieldInfo<TParentData>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1245](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1245)
+Defined in: [packages/form-core/src/FieldApi.ts:1249](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1249)
 
 Gets the field information object.
 
@@ -199,7 +199,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:1213](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1213)
+Defined in: [packages/form-core/src/FieldApi.ts:1217](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1217)
 
 #### Returns
 
@@ -213,7 +213,7 @@ Defined in: [packages/form-core/src/FieldApi.ts:1213](https://github.com/TanStac
 getValue(): TData
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1198](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1198)
+Defined in: [packages/form-core/src/FieldApi.ts:1202](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1202)
 
 Gets the current field value.
 
@@ -233,7 +233,7 @@ Use `field.state.value` instead.
 handleBlur(): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1657](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1657)
+Defined in: [packages/form-core/src/FieldApi.ts:1661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1661)
 
 Handles the blur event.
 
@@ -249,7 +249,7 @@ Handles the blur event.
 handleChange(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1650](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1650)
+Defined in: [packages/form-core/src/FieldApi.ts:1654](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1654)
 
 Handles the change event.
 
@@ -274,7 +274,7 @@ insertValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1262](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1262)
+Defined in: [packages/form-core/src/FieldApi.ts:1266](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1266)
 
 Inserts a value at the specified index, shifting the subsequent values to the right.
 
@@ -304,7 +304,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:1088](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1088)
+Defined in: [packages/form-core/src/FieldApi.ts:1092](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1092)
 
 Mounts the field instance to the form.
 
@@ -327,7 +327,7 @@ moveValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1306](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1306)
+Defined in: [packages/form-core/src/FieldApi.ts:1310](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1310)
 
 Moves the value at the first specified index to the second specified index.
 
@@ -359,7 +359,7 @@ parseValueWithSchema(schema):
   | StandardSchemaV1Issue[]
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1699](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1699)
+Defined in: [packages/form-core/src/FieldApi.ts:1703](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1703)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -387,7 +387,7 @@ parseValueWithSchemaAsync(schema): Promise<
 | StandardSchemaV1Issue[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1711](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1711)
+Defined in: [packages/form-core/src/FieldApi.ts:1715](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1715)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -414,7 +414,7 @@ The standard schema to parse this field's value with.
 pushValue(value, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1250](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1250)
+Defined in: [packages/form-core/src/FieldApi.ts:1254](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1254)
 
 Pushes a new value to the field.
 
@@ -440,7 +440,7 @@ Pushes a new value to the field.
 removeValue(index, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1288](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1288)
+Defined in: [packages/form-core/src/FieldApi.ts:1292](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1292)
 
 Removes a value at the specified index.
 
@@ -469,7 +469,7 @@ replaceValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1275](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1275)
+Defined in: [packages/form-core/src/FieldApi.ts:1279](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1279)
 
 Replaces a value at the specified index.
 
@@ -499,7 +499,7 @@ Replaces a value at the specified index.
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1674](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1674)
+Defined in: [packages/form-core/src/FieldApi.ts:1678](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1678)
 
 Updates the field's errorMap
 
@@ -521,7 +521,7 @@ Updates the field's errorMap
 setMeta(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1218](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1218)
+Defined in: [packages/form-core/src/FieldApi.ts:1222](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1222)
 
 Sets the field metadata.
 
@@ -543,7 +543,7 @@ Sets the field metadata.
 setValue(updater, options?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1205](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1205)
+Defined in: [packages/form-core/src/FieldApi.ts:1209](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1209)
 
 Sets the field value and run the `change` validator.
 
@@ -572,7 +572,7 @@ swapValues(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1297](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1297)
+Defined in: [packages/form-core/src/FieldApi.ts:1301](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1301)
 
 Swaps the values at the specified indices.
 
@@ -602,7 +602,7 @@ Swaps the values at the specified indices.
 update(opts): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1141](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1141)
+Defined in: [packages/form-core/src/FieldApi.ts:1145](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1145)
 
 Updates the field instance with new options.
 
@@ -624,7 +624,7 @@ Updates the field instance with new options.
 validate(cause, opts?): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1617](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1617)
+Defined in: [packages/form-core/src/FieldApi.ts:1621](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1621)
 
 Validates the field value.
 
diff --git a/docs/fr/reference/classes/formapi.md b/docs/fr/reference/classes/formapi.md
index 9b387408e..b88cde13f 100644
--- a/docs/fr/reference/classes/formapi.md
+++ b/docs/fr/reference/classes/formapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:52:43.220Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.406Z'
 id: FormApi
 title: FormApi
 ---
@@ -9,7 +9,7 @@ title: FormApi
 
 # Class: FormApi\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta\>
 
-Defined in: [packages/form-core/src/FormApi.ts:767](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L767)
+Defined in: [packages/form-core/src/FormApi.ts:771](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L771)
 
 A class representing the Form API. It handles the logic and interactions with the form state.
 
@@ -47,7 +47,7 @@ However, if you need to create a new instance manually, you can do so by calling
 new FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>(opts?): FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:838](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L838)
+Defined in: [packages/form-core/src/FormApi.ts:842](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L842)
 
 Constructs a new `FormApi` instance with the given form options.
 
@@ -69,7 +69,7 @@ Constructs a new `FormApi` instance with the given form options.
 baseStore: Store<BaseFormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L794)
+Defined in: [packages/form-core/src/FormApi.ts:798](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L798)
 
 ***
 
@@ -79,7 +79,7 @@ Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/
 fieldInfo: Record<DeepKeys<TFormData>, FieldInfo<TFormData>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:824](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L824)
+Defined in: [packages/form-core/src/FormApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L828)
 
 A record of field information for each field in the form.
 
@@ -91,7 +91,7 @@ A record of field information for each field in the form.
 fieldMetaDerived: Derived<Record<DeepKeys<TFormData>, AnyFieldMeta>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L807)
+Defined in: [packages/form-core/src/FormApi.ts:811](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L811)
 
 ***
 
@@ -101,7 +101,7 @@ Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/
 options: FormOptions<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta> = {};
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:782](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L782)
+Defined in: [packages/form-core/src/FormApi.ts:786](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L786)
 
 The options for the form.
 
@@ -113,7 +113,7 @@ The options for the form.
 store: Derived<FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L808)
+Defined in: [packages/form-core/src/FormApi.ts:812](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L812)
 
 ## Accessors
 
@@ -125,7 +125,7 @@ Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/
 get state(): FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L826)
+Defined in: [packages/form-core/src/FormApi.ts:830](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L830)
 
 ##### Returns
 
@@ -139,7 +139,7 @@ Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/
 deleteField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1912)
+Defined in: [packages/form-core/src/FormApi.ts:1938](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1938)
 
 #### Type Parameters
 
@@ -163,7 +163,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack
 getAllErrors(): object
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2148](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2148)
+Defined in: [packages/form-core/src/FormApi.ts:2174](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2174)
 
 Returns form and field level errors
 
@@ -214,7 +214,7 @@ errors: (
 getFieldInfo<TField>(field): FieldInfo<TFormData>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1826)
+Defined in: [packages/form-core/src/FormApi.ts:1852](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1852)
 
 Gets the field info of the specified field.
 
@@ -240,7 +240,7 @@ Gets the field info of the specified field.
 getFieldMeta<TField>(field): undefined | AnyFieldMeta
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1817](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1817)
+Defined in: [packages/form-core/src/FormApi.ts:1843](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1843)
 
 Gets the metadata of the specified field.
 
@@ -266,7 +266,7 @@ Gets the metadata of the specified field.
 getFieldValue<TField>(field): DeepValue<TFormData, TField>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1810](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1810)
+Defined in: [packages/form-core/src/FormApi.ts:1836](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1836)
 
 Gets the value of the specified field.
 
@@ -294,7 +294,7 @@ Gets the value of the specified field.
 handleSubmit(): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1712](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1712)
+Defined in: [packages/form-core/src/FormApi.ts:1738](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1738)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -308,7 +308,7 @@ Handles the form submission, performs validation, and calls the appropriate onSu
 handleSubmit(submitMeta): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1713](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1713)
+Defined in: [packages/form-core/src/FormApi.ts:1739](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1739)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -334,7 +334,7 @@ insertFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1951)
+Defined in: [packages/form-core/src/FormApi.ts:1977](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1977)
 
 #### Type Parameters
 
@@ -370,7 +370,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack
 mount(): () => void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1142](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1142)
+Defined in: [packages/form-core/src/FormApi.ts:1168](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1168)
 
 #### Returns
 
@@ -392,7 +392,7 @@ moveFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2075](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2075)
+Defined in: [packages/form-core/src/FormApi.ts:2101](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2101)
 
 Moves the value at the first specified index to the second specified index within an array field.
 
@@ -435,7 +435,7 @@ parseValuesWithSchema(schema):
 }
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2208](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2208)
+Defined in: [packages/form-core/src/FormApi.ts:2234](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2234)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -469,7 +469,7 @@ parseValuesWithSchemaAsync(schema): Promise<
 }>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2220](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2220)
+Defined in: [packages/form-core/src/FormApi.ts:2246](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2246)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -502,7 +502,7 @@ pushFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1936](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1936)
+Defined in: [packages/form-core/src/FormApi.ts:1962](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1962)
 
 Pushes a value into an array field.
 
@@ -539,7 +539,7 @@ removeFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
+Defined in: [packages/form-core/src/FormApi.ts:2035](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2035)
 
 Removes a value from an array field at the specified index.
 
@@ -577,7 +577,7 @@ replaceFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1983)
+Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
 
 Replaces a value into an array field at the specified index.
 
@@ -615,7 +615,7 @@ Replaces a value into an array field at the specified index.
 reset(values?, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1230](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1230)
+Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
 
 Resets the form state to the default values.
 If values are provided, the form will be reset to those values instead and the default values will be updated.
@@ -648,7 +648,7 @@ Optional options to control the reset behavior.
 resetField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2103](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2103)
+Defined in: [packages/form-core/src/FormApi.ts:2129](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2129)
 
 Resets the field value and meta to default state
 
@@ -674,7 +674,7 @@ Resets the field value and meta to default state
 resetFieldMeta<TField>(fieldMeta): Record<TField, AnyFieldMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1866](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1866)
+Defined in: [packages/form-core/src/FormApi.ts:1892](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1892)
 
 resets every field's meta
 
@@ -700,7 +700,7 @@ resets every field's meta
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2124](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2124)
+Defined in: [packages/form-core/src/FormApi.ts:2150](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2150)
 
 Updates the form's errorMap
 
@@ -722,7 +722,7 @@ Updates the form's errorMap
 setFieldMeta<TField>(field, updater): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1845](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1845)
+Defined in: [packages/form-core/src/FormApi.ts:1871](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1871)
 
 Updates the metadata of the specified field.
 
@@ -755,7 +755,7 @@ setFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1882](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1882)
+Defined in: [packages/form-core/src/FormApi.ts:1908](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1908)
 
 Sets the value of the specified field and optionally updates the touched state.
 
@@ -793,7 +793,7 @@ swapFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2046](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2046)
+Defined in: [packages/form-core/src/FormApi.ts:2072](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2072)
 
 Swaps the values at the specified indices within an array field.
 
@@ -831,7 +831,7 @@ Swaps the values at the specified indices within an array field.
 update(options?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1162](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1162)
+Defined in: [packages/form-core/src/FormApi.ts:1188](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1188)
 
 Updates the form options and form state.
 
@@ -853,7 +853,7 @@ Updates the form options and form state.
 validateAllFields(cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
+Defined in: [packages/form-core/src/FormApi.ts:1282](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1282)
 
 Validates all fields using the correct handlers for a given validation cause.
 
@@ -878,7 +878,7 @@ validateArrayFieldsStartingFrom<TField>(
 cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1286](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1286)
+Defined in: [packages/form-core/src/FormApi.ts:1312](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1312)
 
 Validates the children of a specified array in the form starting from a given index until the end using the correct handlers for a given validation type.
 
@@ -912,7 +912,7 @@ Validates the children of a specified array in the form starting from a given in
 validateField<TField>(field, cause): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1325](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1325)
+Defined in: [packages/form-core/src/FormApi.ts:1351](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1351)
 
 Validates a specified field in the form using the correct handlers for a given validation type.
 
diff --git a/docs/fr/reference/functions/evaluate.md b/docs/fr/reference/functions/evaluate.md
new file mode 100644
index 000000000..df3420958
--- /dev/null
+++ b/docs/fr/reference/functions/evaluate.md
@@ -0,0 +1,34 @@
+---
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.402Z'
+id: evaluate
+title: evaluate
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: evaluate()
+
+```ts
+function evaluate<T>(objA, objB): boolean
+```
+
+Defined in: [packages/form-core/src/utils.ts:339](https://github.com/TanStack/form/blob/main/packages/form-core/src/utils.ts#L339)
+
+## Type Parameters
+
+• **T**
+
+## Parameters
+
+### objA
+
+`T`
+
+### objB
+
+`T`
+
+## Returns
+
+`boolean`
diff --git a/docs/fr/reference/index.md b/docs/fr/reference/index.md
index e046931a9..7720fc4ee 100644
--- a/docs/fr/reference/index.md
+++ b/docs/fr/reference/index.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-25T12:58:29.000Z'
-translation-updated-at: '2025-04-30T22:41:54.487Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.353Z'
 id: '@tanstack/form-core'
 title: '@tanstack/form-core'
 ---
@@ -84,8 +84,8 @@ title: '@tanstack/form-core'
 
 ## Functions
 
+- [evaluate](functions/evaluate.md)
 - [formOptions](functions/formoptions.md)
 - [isGlobalFormValidationError](functions/isglobalformvalidationerror.md)
 - [isStandardSchemaValidator](functions/isstandardschemavalidator.md)
 - [mergeForm](functions/mergeform.md)
-- [shallow](functions/shallow.md)
diff --git a/docs/fr/reference/interfaces/formstate.md b/docs/fr/reference/interfaces/formstate.md
index 1c1487804..846133df6 100644
--- a/docs/fr/reference/interfaces/formstate.md
+++ b/docs/fr/reference/interfaces/formstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:23:29.732Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.358Z'
 id: FormState
 title: FormState
 ---
@@ -9,7 +9,7 @@ title: FormState
 
 # Interface: FormState\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer\>
 
-Defined in: [packages/form-core/src/FormApi.ts:643](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L643)
+Defined in: [packages/form-core/src/FormApi.ts:647](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L647)
 
 An object representing the current state of the form.
 
@@ -63,7 +63,7 @@ BaseFormState._force_re_eval
 canSubmit: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
+Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
 
 A boolean indicating if the form can be submitted based on its current state.
 
@@ -125,7 +125,7 @@ DerivedFormState.errors
 fieldMeta: Record<DeepKeys<TFormData>, AnyFieldMeta>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
+Defined in: [packages/form-core/src/FormApi.ts:644](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L644)
 
 A record of field metadata for each field in the form.
 
@@ -173,6 +173,24 @@ DerivedFormState.isBlurred
 
 ***
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+
+A boolean indicating if all of the form's fields are the same as default values.
+
+#### Inherited from
+
+```ts
+DerivedFormState.isDefaultValue
+```
+
+***
+
 ### isDirty
 
 ```ts
@@ -371,7 +389,7 @@ DerivedFormState.isTouched
 isValid: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
 
 A boolean indicating if the form and all its fields are valid. Evaluates `true` if there are no errors.
 
diff --git a/docs/fr/reference/type-aliases/anyfieldapi.md b/docs/fr/reference/type-aliases/anyfieldapi.md
index 66efa9194..1b89f19e4 100644
--- a/docs/fr/reference/type-aliases/anyfieldapi.md
+++ b/docs/fr/reference/type-aliases/anyfieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:23:29.702Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.398Z'
 id: AnyFieldApi
 title: AnyFieldApi
 ---
@@ -13,6 +13,6 @@ title: AnyFieldApi
 type AnyFieldApi = FieldApi<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L828)
+Defined in: [packages/form-core/src/FieldApi.ts:832](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L832)
 
 A type representing the Field API with all generics set to `any` for convenience.
diff --git a/docs/fr/reference/type-aliases/anyfieldmeta.md b/docs/fr/reference/type-aliases/anyfieldmeta.md
index 8d57c4a84..42f08ff54 100644
--- a/docs/fr/reference/type-aliases/anyfieldmeta.md
+++ b/docs/fr/reference/type-aliases/anyfieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:23:29.698Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.392Z'
 id: AnyFieldMeta
 title: AnyFieldMeta
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMeta
 type AnyFieldMeta = FieldMeta<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L747)
+Defined in: [packages/form-core/src/FieldApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L751)
diff --git a/docs/fr/reference/type-aliases/anyfieldmetaderived.md b/docs/fr/reference/type-aliases/anyfieldmetaderived.md
index d34a7a1c1..32321c26e 100644
--- a/docs/fr/reference/type-aliases/anyfieldmetaderived.md
+++ b/docs/fr/reference/type-aliases/anyfieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:23:29.688Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.388Z'
 id: AnyFieldMetaDerived
 title: AnyFieldMetaDerived
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMetaDerived
 type AnyFieldMetaDerived = FieldMetaDerived<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L661)
+Defined in: [packages/form-core/src/FieldApi.ts:665](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L665)
diff --git a/docs/fr/reference/type-aliases/anyformapi.md b/docs/fr/reference/type-aliases/anyformapi.md
index 5c347f906..fc916a7bf 100644
--- a/docs/fr/reference/type-aliases/anyformapi.md
+++ b/docs/fr/reference/type-aliases/anyformapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:23:29.684Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.384Z'
 id: AnyFormApi
 title: AnyFormApi
 ---
@@ -13,6 +13,6 @@ title: AnyFormApi
 type AnyFormApi = FormApi<any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L747)
+Defined in: [packages/form-core/src/FormApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L751)
 
 A type representing the Form API with all generics set to `any` for convenience.
diff --git a/docs/fr/reference/type-aliases/anyformstate.md b/docs/fr/reference/type-aliases/anyformstate.md
index aa6c87405..5f21f781f 100644
--- a/docs/fr/reference/type-aliases/anyformstate.md
+++ b/docs/fr/reference/type-aliases/anyformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:23:29.680Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.380Z'
 id: AnyFormState
 title: AnyFormState
 ---
@@ -13,4 +13,4 @@ title: AnyFormState
 type AnyFormState = FormState<any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:676](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L676)
+Defined in: [packages/form-core/src/FormApi.ts:680](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L680)
diff --git a/docs/fr/reference/type-aliases/derivedformstate.md b/docs/fr/reference/type-aliases/derivedformstate.md
index c1ee356a2..9fd471877 100644
--- a/docs/fr/reference/type-aliases/derivedformstate.md
+++ b/docs/fr/reference/type-aliases/derivedformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:55.143Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.376Z'
 id: DerivedFormState
 title: DerivedFormState
 ---
@@ -77,6 +77,14 @@ isBlurred: boolean;
 
 A boolean indicating if any of the form fields have been blurred.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A boolean indicating if all of the form's fields are the same as default values.
+
 ### isDirty
 
 ```ts
diff --git a/docs/fr/reference/type-aliases/fieldmeta.md b/docs/fr/reference/type-aliases/fieldmeta.md
index 0af6db8c8..21d7f53d3 100644
--- a/docs/fr/reference/type-aliases/fieldmeta.md
+++ b/docs/fr/reference/type-aliases/fieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:55.018Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.372Z'
 id: FieldMeta
 title: FieldMeta
 ---
@@ -13,7 +13,7 @@ title: FieldMeta
 type FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = FieldMetaBase<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> & FieldMetaDerived<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:684](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L684)
+Defined in: [packages/form-core/src/FieldApi.ts:688](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L688)
 
 An object type representing the metadata of a field in a form.
 
diff --git a/docs/fr/reference/type-aliases/fieldmetaderived.md b/docs/fr/reference/type-aliases/fieldmetaderived.md
index d40482b7b..52d97b85c 100644
--- a/docs/fr/reference/type-aliases/fieldmetaderived.md
+++ b/docs/fr/reference/type-aliases/fieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:23:29.640Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.363Z'
 id: FieldMetaDerived
 title: FieldMetaDerived
 ---
@@ -68,6 +68,14 @@ errors: (
 
 An array of errors related to the field value.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A flag indicating whether the field's current value is the default value
+
 ### isPristine
 
 ```ts
diff --git a/docs/fr/reference/type-aliases/fieldstate.md b/docs/fr/reference/type-aliases/fieldstate.md
index 53afcdbfa..6ddd53bb5 100644
--- a/docs/fr/reference/type-aliases/fieldstate.md
+++ b/docs/fr/reference/type-aliases/fieldstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:55.048Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:49:16.367Z'
 id: FieldState
 title: FieldState
 ---
@@ -13,7 +13,7 @@ title: FieldState
 type FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:770](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L770)
+Defined in: [packages/form-core/src/FieldApi.ts:774](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L774)
 
 An object type representing the state of a field.
 
diff --git a/docs/ja/framework/react/guides/basic-concepts.md b/docs/ja/framework/react/guides/basic-concepts.md
index 104d18f82..dbf9f6301 100644
--- a/docs/ja/framework/react/guides/basic-concepts.md
+++ b/docs/ja/framework/react/guides/basic-concepts.md
@@ -1,11 +1,11 @@
 ---
-source-updated-at: '2025-04-16T08:45:06.000Z'
-translation-updated-at: '2025-04-30T21:26:06.581Z'
+source-updated-at: '2025-05-08T07:42:29.000Z'
+translation-updated-at: '2025-05-08T23:45:38.105Z'
 id: basic-concepts
 title: 基本概念
 ---
 
-このページでは、`@tanstack/react-form` ライブラリで使用される基本的な概念と用語を紹介します。これらの概念を理解することで、ライブラリをより効果的に活用できるようになります。
+このページでは、`@tanstack/react-form` ライブラリで使用される基本概念と用語を紹介します。これらの概念を理解することで、ライブラリをより効果的に活用できるようになります。
 
 ## フォームオプション
 
@@ -28,19 +28,19 @@ const formOpts = formOptions({
 
 ## フォームインスタンス
 
-フォームインスタンスは個々のフォームを表すオブジェクトで、フォームを操作するためのメソッドとプロパティを提供します。フォームインスタンスは、フォームオプションが提供する `useForm` フックを使用して作成します。このフックは、フォームが送信されたときに呼び出される `onSubmit` 関数を含むオブジェクトを受け取ります。
+フォームインスタンスは個々のフォームを表現するオブジェクトで、フォームを操作するためのメソッドやプロパティを提供します。フォームインスタンスは、フォームオプションから提供される `useForm` フックを使用して作成します。このフックは、フォームが送信されたときに呼び出される `onSubmit` 関数を含むオブジェクトを受け取ります。
 
 ```tsx
 const form = useForm({
   ...formOpts,
   onSubmit: async ({ value }) => {
-    // フォームデータを処理
+    // フォームデータで何か処理を行う
     console.log(value)
   },
 })
 ```
 
-`formOptions` を使用せずにスタンドアロンの `useForm` API でフォームインスタンスを作成することも可能です:
+`formOptions` を使用せずにスタンドアロンの `useForm` API を使用してフォームインスタンスを作成することもできます:
 
 ```tsx
 interface User {
@@ -53,7 +53,7 @@ const defaultUser: User = { firstName: '', lastName: '', hobbies: [] }
 const form = useForm({
   defaultValues: defaultUser,
   onSubmit: async ({ value }) => {
-    // フォームデータを処理
+    // フォームデータで何か処理を行う
     console.log(value)
   },
 })
@@ -61,7 +61,7 @@ const form = useForm({
 
 ## フィールド
 
-フィールドは、テキスト入力やチェックボックスなどの単一のフォーム入力要素を表します。フィールドは、フォームインスタンスが提供する `form.Field` コンポーネントを使用して作成します。このコンポーネントは、フォームのデフォルト値のキーと一致する `name` プロパティと、フィールドオブジェクトを引数に取るレンダープロップ関数である `children` プロパティを受け取ります。
+フィールドは、テキスト入力やチェックボックスなどの単一のフォーム入力要素を表します。フィールドは、フォームインスタンスから提供される `form.Field` コンポーネントを使用して作成します。このコンポーネントは、フォームのデフォルト値のキーと一致する `name` プロパティと、フィールドオブジェクトを引数として受け取るレンダープロップ関数である `children` プロパティを受け取ります。
 
 例:
 
@@ -83,7 +83,7 @@ const form = useForm({
 
 ## フィールド状態
 
-各フィールドには、現在の値、検証ステータス、エラーメッセージなどのメタデータを含む独自の状態があります。フィールドの状態には `field.state` プロパティでアクセスできます。
+各フィールドには、現在の値、検証ステータス、エラーメッセージ、その他のメタデータを含む独自の状態があります。フィールドの状態には `field.state` プロパティを使用してアクセスできます。
 
 例:
 
@@ -94,7 +94,11 @@ const {
 } = field.state
 ```
 
-ユーザーがフィールドとどのようにやり取りしているかを確認するのに役立つ3つのフィールド状態があります: ユーザーがクリック/タブでフィールドに入ると「touched」、値が変更されるまでは「pristine」、値が変更されると「dirty」になります。これらの状態は、以下のように `isTouched`、`isPristine`、`isDirty` フラグで確認できます。
+ユーザーがフィールドとどのようにやり取りしているかを確認するのに役立つ、メタデータ内の3つの状態があります:
+
+- _"isTouched"_: ユーザーがフィールドをクリック/タップした後
+- _"isPristine"_: ユーザーがフィールドの値を変更するまで
+- _"isDirty"_: フィールドの値が変更された後
 
 ```tsx
 const { isTouched, isPristine, isDirty } = field.state.meta
@@ -102,13 +106,32 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 
 ![フィールド状態](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states.png)
 
-> **`React Hook Form` からの移行に関する重要な注意**: `TanStack/form` の `isDirty` フラグは、RHF の同名フラグとは異なります。
-> RHF では、フォームの値が元の値と異なる場合に `isDirty = true` になります。ユーザーがフォームの値を変更し、再度変更してフォームのデフォルト値と一致する値になった場合、RHF では `isDirty` は `false` になりますが、`TanStack/form` では `true` のままです。
-> デフォルト値は `TanStack/form` のフォームレベルとフィールドレベルで公開されています（`form.options.defaultValues`、`field.options.defaultValue`）。RHF の動作をエミュレートする必要がある場合は、独自の `isDefaultValue()` ヘルパーを記述できます。
+## 異なるライブラリにおける 'isDirty' の理解
+
+非永続的な `dirty` 状態
+
+- **ライブラリ**: React Hook Form (RHF), Formik, Final Form
+- **動作**: フィールドの値がデフォルトと異なる場合に 'dirty' となる。デフォルト値に戻すと 'clean' に戻る
+
+永続的な `dirty` 状態
+
+- **ライブラリ**: Angular Form, Vue FormKit
+- **動作**: 一度変更されると、デフォルト値に戻しても 'dirty' のまま
+
+私たちは永続的な 'dirty' 状態モデルを選択しました。非永続的な 'dirty' 状態もサポートするために、`isDefault` フラグを導入しています。このフラグは非永続的な 'dirty' 状態の逆として機能します。
+
+```tsx
+const { isTouched, isPristine, isDirty, isDefaultValue } = field.state.meta
+
+// 以下の行で非永続的な `dirty` 機能を再現できます
+const nonPersistentIsDirty = !isDefaultValue
+```
+
+![拡張されたフィールド状態](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states-extended.png)
 
 ## フィールドAPI
 
-フィールドAPIは、フィールドを作成する際にレンダープロップ関数に渡されるオブジェクトで、フィールドの状態を操作するためのメソッドを提供します。
+フィールドAPIは、フィールドを作成するときにレンダープロップ関数に渡されるオブジェクトで、フィールドの状態を操作するためのメソッドを提供します。
 
 例:
 
@@ -122,7 +145,7 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 
 ## バリデーション
 
-`@tanstack/react-form` は、同期および非同期のバリデーションを標準で提供しています。バリデーション関数は `form.Field` コンポーネントの `validators` プロパティに渡すことができます。
+`@tanstack/react-form` は、同期および非同期バリデーションを標準で提供しています。バリデーション関数は、`validators` プロパティを使用して `form.Field` コンポーネントに渡すことができます。
 
 例:
 
@@ -138,7 +161,7 @@ const { isTouched, isPristine, isDirty } = field.state.meta
           : undefined,
     onChangeAsync: async ({ value }) => {
       await new Promise((resolve) => setTimeout(resolve, 1000))
-      return value.includes('error') && '名に「error」を含めることはできません'
+      return value.includes('error') && '名に"error"を含めることはできません'
     },
   }}
   children={(field) => (
@@ -154,11 +177,11 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 />
 ```
 
-## 標準スキーマライブラリを使用したバリデーション
+## 標準スキーマライブラリによるバリデーション
 
 手動で作成したバリデーションオプションに加えて、[Standard Schema](https://github.com/standard-schema/standard-schema) 仕様もサポートしています。
 
-この仕様を実装した任意のライブラリを使用してスキーマを定義し、フォームまたはフィールドのバリデータに渡すことができます。
+仕様を実装した任意のライブラリを使用してスキーマを定義し、フォームまたはフィールドバリデータに渡すことができます。
 
 サポートされているライブラリ:
 
@@ -170,9 +193,7 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 import { z } from 'zod'
 
 const userSchema = z.object({
-  age: z
-    .number()
-    .gte(13, 'アカウントを作成するには13歳以上である必要があります'),
+  age: z.number().gte(13, 'アカウント作成には13歳以上である必要があります'),
 })
 
 function App() {
@@ -199,7 +220,7 @@ function App() {
 
 ## リアクティビティ
 
-`@tanstack/react-form` は、フォームとフィールドの状態変更をサブスクライブするためのさまざまな方法を提供しており、特に `useStore(form.store)` フックと `form.Subscribe` コンポーネントが注目されます。これらの方法を使用すると、必要な時だけコンポーネントを更新することで、フォームのレンダリングパフォーマンスを最適化できます。
+`@tanstack/react-form` は、フォームやフィールドの状態変化をサブスクライブするさまざまな方法を提供しており、特に `useStore(form.store)` フックと `form.Subscribe` コンポーネントが注目されます。これらの方法を使用すると、必要な時だけコンポーネントを更新することで、フォームのレンダリングパフォーマンスを最適化できます。
 
 例:
 
@@ -216,21 +237,21 @@ const firstName = useStore(form.store, (state) => state.values.firstName)
 />
 ```
 
-`useStore` フックの `selector` プロパティはオプションですが、これを省略すると不要な再レンダリングが発生するため、強く推奨される点に注意してください。
+`useStore` フックの `selector` プロパティはオプションですが、省略すると不要な再レンダリングが発生するため、提供することを強く推奨します。
 
 ```tsx
-// 正しい使用法
+// 正しい使い方
 const firstName = useStore(form.store, (state) => state.values.firstName)
 const errors = useStore(form.store, (state) => state.errorMap)
-// 誤った使用法
+// 間違った使い方
 const store = useStore(form.store)
 ```
 
-注: リアクティビティを実現するための `useField` フックの使用は推奨されません。このフックは `form.Field` コンポーネント内で慎重に使用するように設計されています。代わりに `useStore(form.store)` の使用を検討してください。
+注: リアクティビティを実現するための `useField` フックの使用は推奨されません。このフックは `form.Field` コンポーネント内で慎重に使用するように設計されています。代わりに `useStore(form.store)` を使用することを検討してください。
 
 ## リスナー
 
-`@tanstack/react-form` では、特定のトリガーに反応してサイドエフェクトをディスパッチする「リスナー」を設定できます。
+`@tanstack/react-form` では、特定のトリガーに反応して副作用をディスパッチする「リスナー」を設定できます。
 
 例:
 
@@ -250,9 +271,9 @@ const store = useStore(form.store)
 
 ## 配列フィールド
 
-配列フィールドを使用すると、趣味のリストなど、フォーム内の値のリストを管理できます。配列フィールドは `mode="array"` プロパティを指定した `form.Field` コンポーネントを使用して作成します。
+配列フィールドを使用すると、趣味のリストなどの値のリストをフォーム内で管理できます。配列フィールドは、`mode="array"` プロパティを指定した `form.Field` コンポーネントを使用して作成します。
 
-配列フィールドを操作する際は、`pushValue`、`removeValue`、`swapValues`、`moveValue` メソッドを使用して、配列内の値を追加、削除、入れ替えできます。
+配列フィールドを操作する際には、`pushValue`、`removeValue`、`swapValues`、`moveValue` メソッドを使用して、配列内の値を追加、削除、交換できます。
 
 例:
 
@@ -332,7 +353,8 @@ const store = useStore(form.store)
 
 ## リセットボタン
 
-`<button type="reset">` を TanStack Form の `form.reset()` と併用する場合、HTMLのデフォルトのリセット動作を防ぐ必要があります（特に `<select>` 要素が初期HTML値にリセットされるのを避けるため）。ボタンの `onClick` ハンドラー内で `event.preventDefault()` を使用して、ネイティブのフォームリセットを防ぎます。
+`<button type="reset">` を TanStack Form の `form.reset()` と組み合わせて使用する場合、特に `<select>` 要素が初期HTML値に予期せずリセットされるのを防ぐために、デフォルトのHTMLリセット動作を防ぐ必要があります。
+ボタンの `onClick` ハンドラ内で `event.preventDefault()` を使用して、ネイティブのフォームリセットを防ぎます。
 
 例:
 
@@ -361,4 +383,4 @@ const store = useStore(form.store)
 </button>
 ```
 
-これらは `@tanstack/react-form` ライブラリで使用される基本的な概念と用語です。これらの概念を理解することで、ライブラリをより効果的に活用し、複雑なフォームを簡単に作成できるようになります。
+これらは `@tanstack/react-form` ライブラリで使用される基本概念と用語です。これらの概念を理解することで、ライブラリをより効果的に使用し、複雑なフォームを簡単に作成できるようになります。
diff --git a/docs/ja/reference/classes/fieldapi.md b/docs/ja/reference/classes/fieldapi.md
index 76d9add79..b1d052994 100644
--- a/docs/ja/reference/classes/fieldapi.md
+++ b/docs/ja/reference/classes/fieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:51:10.810Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.736Z'
 id: FieldApi
 title: FieldApi
 ---
@@ -9,7 +9,7 @@ title: FieldApi
 
 # Class: FieldApi\<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta\>
 
-Defined in: [packages/form-core/src/FieldApi.ts:859](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L859)
+Defined in: [packages/form-core/src/FieldApi.ts:863](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L863)
 
 A class representing the API for managing a form field.
 
@@ -67,7 +67,7 @@ the `new FieldApi` constructor.
 new FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>(opts): FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:991](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L991)
+Defined in: [packages/form-core/src/FieldApi.ts:995](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L995)
 
 Initializes a new `FieldApi` instance.
 
@@ -89,7 +89,7 @@ Initializes a new `FieldApi` instance.
 form: FormApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:903](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L903)
+Defined in: [packages/form-core/src/FieldApi.ts:907](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L907)
 
 A reference to the form API instance.
 
@@ -101,7 +101,7 @@ A reference to the form API instance.
 name: DeepKeys<TParentData>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:927](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L927)
+Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
 
 The field name.
 
@@ -113,7 +113,7 @@ The field name.
 options: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
+Defined in: [packages/form-core/src/FieldApi.ts:935](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L935)
 
 The field options.
 
@@ -125,7 +125,7 @@ The field options.
 store: Derived<FieldState<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:955](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L955)
+Defined in: [packages/form-core/src/FieldApi.ts:959](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L959)
 
 The field state store.
 
@@ -137,7 +137,7 @@ The field state store.
 timeoutIds: object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:982](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L982)
+Defined in: [packages/form-core/src/FieldApi.ts:986](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L986)
 
 #### formListeners
 
@@ -167,7 +167,7 @@ validations: Record<ValidationCause, null | Timeout>;
 get state(): FieldState<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:979](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L979)
+Defined in: [packages/form-core/src/FieldApi.ts:983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L983)
 
 The current field state.
 
@@ -183,7 +183,7 @@ The current field state.
 getInfo(): FieldInfo<TParentData>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1245](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1245)
+Defined in: [packages/form-core/src/FieldApi.ts:1249](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1249)
 
 Gets the field information object.
 
@@ -199,7 +199,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:1213](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1213)
+Defined in: [packages/form-core/src/FieldApi.ts:1217](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1217)
 
 #### Returns
 
@@ -213,7 +213,7 @@ Defined in: [packages/form-core/src/FieldApi.ts:1213](https://github.com/TanStac
 getValue(): TData
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1198](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1198)
+Defined in: [packages/form-core/src/FieldApi.ts:1202](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1202)
 
 Gets the current field value.
 
@@ -233,7 +233,7 @@ Use `field.state.value` instead.
 handleBlur(): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1657](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1657)
+Defined in: [packages/form-core/src/FieldApi.ts:1661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1661)
 
 Handles the blur event.
 
@@ -249,7 +249,7 @@ Handles the blur event.
 handleChange(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1650](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1650)
+Defined in: [packages/form-core/src/FieldApi.ts:1654](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1654)
 
 Handles the change event.
 
@@ -274,7 +274,7 @@ insertValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1262](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1262)
+Defined in: [packages/form-core/src/FieldApi.ts:1266](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1266)
 
 Inserts a value at the specified index, shifting the subsequent values to the right.
 
@@ -304,7 +304,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:1088](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1088)
+Defined in: [packages/form-core/src/FieldApi.ts:1092](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1092)
 
 Mounts the field instance to the form.
 
@@ -327,7 +327,7 @@ moveValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1306](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1306)
+Defined in: [packages/form-core/src/FieldApi.ts:1310](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1310)
 
 Moves the value at the first specified index to the second specified index.
 
@@ -359,7 +359,7 @@ parseValueWithSchema(schema):
   | StandardSchemaV1Issue[]
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1699](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1699)
+Defined in: [packages/form-core/src/FieldApi.ts:1703](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1703)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -387,7 +387,7 @@ parseValueWithSchemaAsync(schema): Promise<
 | StandardSchemaV1Issue[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1711](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1711)
+Defined in: [packages/form-core/src/FieldApi.ts:1715](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1715)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -414,7 +414,7 @@ The standard schema to parse this field's value with.
 pushValue(value, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1250](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1250)
+Defined in: [packages/form-core/src/FieldApi.ts:1254](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1254)
 
 Pushes a new value to the field.
 
@@ -440,7 +440,7 @@ Pushes a new value to the field.
 removeValue(index, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1288](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1288)
+Defined in: [packages/form-core/src/FieldApi.ts:1292](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1292)
 
 Removes a value at the specified index.
 
@@ -469,7 +469,7 @@ replaceValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1275](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1275)
+Defined in: [packages/form-core/src/FieldApi.ts:1279](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1279)
 
 Replaces a value at the specified index.
 
@@ -499,7 +499,7 @@ Replaces a value at the specified index.
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1674](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1674)
+Defined in: [packages/form-core/src/FieldApi.ts:1678](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1678)
 
 Updates the field's errorMap
 
@@ -521,7 +521,7 @@ Updates the field's errorMap
 setMeta(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1218](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1218)
+Defined in: [packages/form-core/src/FieldApi.ts:1222](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1222)
 
 Sets the field metadata.
 
@@ -543,7 +543,7 @@ Sets the field metadata.
 setValue(updater, options?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1205](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1205)
+Defined in: [packages/form-core/src/FieldApi.ts:1209](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1209)
 
 Sets the field value and run the `change` validator.
 
@@ -572,7 +572,7 @@ swapValues(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1297](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1297)
+Defined in: [packages/form-core/src/FieldApi.ts:1301](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1301)
 
 Swaps the values at the specified indices.
 
@@ -602,7 +602,7 @@ Swaps the values at the specified indices.
 update(opts): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1141](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1141)
+Defined in: [packages/form-core/src/FieldApi.ts:1145](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1145)
 
 Updates the field instance with new options.
 
@@ -624,7 +624,7 @@ Updates the field instance with new options.
 validate(cause, opts?): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1617](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1617)
+Defined in: [packages/form-core/src/FieldApi.ts:1621](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1621)
 
 Validates the field value.
 
diff --git a/docs/ja/reference/classes/formapi.md b/docs/ja/reference/classes/formapi.md
index cf21651aa..f388dc599 100644
--- a/docs/ja/reference/classes/formapi.md
+++ b/docs/ja/reference/classes/formapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:51:10.804Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.731Z'
 id: FormApi
 title: FormApi
 ---
@@ -9,7 +9,7 @@ title: FormApi
 
 # Class: FormApi\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta\>
 
-Defined in: [packages/form-core/src/FormApi.ts:767](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L767)
+Defined in: [packages/form-core/src/FormApi.ts:771](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L771)
 
 A class representing the Form API. It handles the logic and interactions with the form state.
 
@@ -47,7 +47,7 @@ However, if you need to create a new instance manually, you can do so by calling
 new FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>(opts?): FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:838](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L838)
+Defined in: [packages/form-core/src/FormApi.ts:842](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L842)
 
 Constructs a new `FormApi` instance with the given form options.
 
@@ -69,7 +69,7 @@ Constructs a new `FormApi` instance with the given form options.
 baseStore: Store<BaseFormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L794)
+Defined in: [packages/form-core/src/FormApi.ts:798](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L798)
 
 ***
 
@@ -79,7 +79,7 @@ Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/
 fieldInfo: Record<DeepKeys<TFormData>, FieldInfo<TFormData>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:824](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L824)
+Defined in: [packages/form-core/src/FormApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L828)
 
 A record of field information for each field in the form.
 
@@ -91,7 +91,7 @@ A record of field information for each field in the form.
 fieldMetaDerived: Derived<Record<DeepKeys<TFormData>, AnyFieldMeta>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L807)
+Defined in: [packages/form-core/src/FormApi.ts:811](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L811)
 
 ***
 
@@ -101,7 +101,7 @@ Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/
 options: FormOptions<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta> = {};
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:782](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L782)
+Defined in: [packages/form-core/src/FormApi.ts:786](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L786)
 
 The options for the form.
 
@@ -113,7 +113,7 @@ The options for the form.
 store: Derived<FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L808)
+Defined in: [packages/form-core/src/FormApi.ts:812](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L812)
 
 ## Accessors
 
@@ -125,7 +125,7 @@ Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/
 get state(): FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L826)
+Defined in: [packages/form-core/src/FormApi.ts:830](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L830)
 
 ##### Returns
 
@@ -139,7 +139,7 @@ Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/
 deleteField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1912)
+Defined in: [packages/form-core/src/FormApi.ts:1938](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1938)
 
 #### Type Parameters
 
@@ -163,7 +163,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack
 getAllErrors(): object
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2148](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2148)
+Defined in: [packages/form-core/src/FormApi.ts:2174](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2174)
 
 Returns form and field level errors
 
@@ -214,7 +214,7 @@ errors: (
 getFieldInfo<TField>(field): FieldInfo<TFormData>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1826)
+Defined in: [packages/form-core/src/FormApi.ts:1852](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1852)
 
 Gets the field info of the specified field.
 
@@ -240,7 +240,7 @@ Gets the field info of the specified field.
 getFieldMeta<TField>(field): undefined | AnyFieldMeta
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1817](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1817)
+Defined in: [packages/form-core/src/FormApi.ts:1843](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1843)
 
 Gets the metadata of the specified field.
 
@@ -266,7 +266,7 @@ Gets the metadata of the specified field.
 getFieldValue<TField>(field): DeepValue<TFormData, TField>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1810](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1810)
+Defined in: [packages/form-core/src/FormApi.ts:1836](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1836)
 
 Gets the value of the specified field.
 
@@ -294,7 +294,7 @@ Gets the value of the specified field.
 handleSubmit(): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1712](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1712)
+Defined in: [packages/form-core/src/FormApi.ts:1738](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1738)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -308,7 +308,7 @@ Handles the form submission, performs validation, and calls the appropriate onSu
 handleSubmit(submitMeta): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1713](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1713)
+Defined in: [packages/form-core/src/FormApi.ts:1739](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1739)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -334,7 +334,7 @@ insertFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1951)
+Defined in: [packages/form-core/src/FormApi.ts:1977](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1977)
 
 #### Type Parameters
 
@@ -370,7 +370,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack
 mount(): () => void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1142](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1142)
+Defined in: [packages/form-core/src/FormApi.ts:1168](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1168)
 
 #### Returns
 
@@ -392,7 +392,7 @@ moveFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2075](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2075)
+Defined in: [packages/form-core/src/FormApi.ts:2101](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2101)
 
 Moves the value at the first specified index to the second specified index within an array field.
 
@@ -435,7 +435,7 @@ parseValuesWithSchema(schema):
 }
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2208](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2208)
+Defined in: [packages/form-core/src/FormApi.ts:2234](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2234)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -469,7 +469,7 @@ parseValuesWithSchemaAsync(schema): Promise<
 }>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2220](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2220)
+Defined in: [packages/form-core/src/FormApi.ts:2246](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2246)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -502,7 +502,7 @@ pushFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1936](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1936)
+Defined in: [packages/form-core/src/FormApi.ts:1962](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1962)
 
 Pushes a value into an array field.
 
@@ -539,7 +539,7 @@ removeFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
+Defined in: [packages/form-core/src/FormApi.ts:2035](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2035)
 
 Removes a value from an array field at the specified index.
 
@@ -577,7 +577,7 @@ replaceFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1983)
+Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
 
 Replaces a value into an array field at the specified index.
 
@@ -615,7 +615,7 @@ Replaces a value into an array field at the specified index.
 reset(values?, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1230](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1230)
+Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
 
 Resets the form state to the default values.
 If values are provided, the form will be reset to those values instead and the default values will be updated.
@@ -648,7 +648,7 @@ Optional options to control the reset behavior.
 resetField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2103](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2103)
+Defined in: [packages/form-core/src/FormApi.ts:2129](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2129)
 
 Resets the field value and meta to default state
 
@@ -674,7 +674,7 @@ Resets the field value and meta to default state
 resetFieldMeta<TField>(fieldMeta): Record<TField, AnyFieldMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1866](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1866)
+Defined in: [packages/form-core/src/FormApi.ts:1892](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1892)
 
 resets every field's meta
 
@@ -700,7 +700,7 @@ resets every field's meta
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2124](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2124)
+Defined in: [packages/form-core/src/FormApi.ts:2150](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2150)
 
 Updates the form's errorMap
 
@@ -722,7 +722,7 @@ Updates the form's errorMap
 setFieldMeta<TField>(field, updater): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1845](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1845)
+Defined in: [packages/form-core/src/FormApi.ts:1871](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1871)
 
 Updates the metadata of the specified field.
 
@@ -755,7 +755,7 @@ setFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1882](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1882)
+Defined in: [packages/form-core/src/FormApi.ts:1908](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1908)
 
 Sets the value of the specified field and optionally updates the touched state.
 
@@ -793,7 +793,7 @@ swapFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2046](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2046)
+Defined in: [packages/form-core/src/FormApi.ts:2072](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2072)
 
 Swaps the values at the specified indices within an array field.
 
@@ -831,7 +831,7 @@ Swaps the values at the specified indices within an array field.
 update(options?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1162](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1162)
+Defined in: [packages/form-core/src/FormApi.ts:1188](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1188)
 
 Updates the form options and form state.
 
@@ -853,7 +853,7 @@ Updates the form options and form state.
 validateAllFields(cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
+Defined in: [packages/form-core/src/FormApi.ts:1282](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1282)
 
 Validates all fields using the correct handlers for a given validation cause.
 
@@ -878,7 +878,7 @@ validateArrayFieldsStartingFrom<TField>(
 cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1286](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1286)
+Defined in: [packages/form-core/src/FormApi.ts:1312](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1312)
 
 Validates the children of a specified array in the form starting from a given index until the end using the correct handlers for a given validation type.
 
@@ -912,7 +912,7 @@ Validates the children of a specified array in the form starting from a given in
 validateField<TField>(field, cause): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1325](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1325)
+Defined in: [packages/form-core/src/FormApi.ts:1351](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1351)
 
 Validates a specified field in the form using the correct handlers for a given validation type.
 
diff --git a/docs/ja/reference/functions/evaluate.md b/docs/ja/reference/functions/evaluate.md
new file mode 100644
index 000000000..d333efc3e
--- /dev/null
+++ b/docs/ja/reference/functions/evaluate.md
@@ -0,0 +1,34 @@
+---
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.726Z'
+id: evaluate
+title: evaluate
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: evaluate()
+
+```ts
+function evaluate<T>(objA, objB): boolean
+```
+
+Defined in: [packages/form-core/src/utils.ts:339](https://github.com/TanStack/form/blob/main/packages/form-core/src/utils.ts#L339)
+
+## Type Parameters
+
+• **T**
+
+## Parameters
+
+### objA
+
+`T`
+
+### objB
+
+`T`
+
+## Returns
+
+`boolean`
diff --git a/docs/ja/reference/index.md b/docs/ja/reference/index.md
index 8e9aac113..354b4d568 100644
--- a/docs/ja/reference/index.md
+++ b/docs/ja/reference/index.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-25T12:58:29.000Z'
-translation-updated-at: '2025-04-30T22:41:35.569Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.681Z'
 id: '@tanstack/form-core'
 title: '@tanstack/form-core'
 ---
@@ -84,8 +84,8 @@ title: '@tanstack/form-core'
 
 ## Functions
 
+- [evaluate](functions/evaluate.md)
 - [formOptions](functions/formoptions.md)
 - [isGlobalFormValidationError](functions/isglobalformvalidationerror.md)
 - [isStandardSchemaValidator](functions/isstandardschemavalidator.md)
 - [mergeForm](functions/mergeform.md)
-- [shallow](functions/shallow.md)
diff --git a/docs/ja/reference/interfaces/formstate.md b/docs/ja/reference/interfaces/formstate.md
index 8945d5518..0d121eebb 100644
--- a/docs/ja/reference/interfaces/formstate.md
+++ b/docs/ja/reference/interfaces/formstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:18:21.518Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.722Z'
 id: FormState
 title: FormState
 ---
@@ -9,7 +9,7 @@ title: FormState
 
 # Interface: FormState\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer\>
 
-Defined in: [packages/form-core/src/FormApi.ts:643](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L643)
+Defined in: [packages/form-core/src/FormApi.ts:647](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L647)
 
 An object representing the current state of the form.
 
@@ -63,7 +63,7 @@ BaseFormState._force_re_eval
 canSubmit: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
+Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
 
 A boolean indicating if the form can be submitted based on its current state.
 
@@ -125,7 +125,7 @@ DerivedFormState.errors
 fieldMeta: Record<DeepKeys<TFormData>, AnyFieldMeta>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
+Defined in: [packages/form-core/src/FormApi.ts:644](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L644)
 
 A record of field metadata for each field in the form.
 
@@ -173,6 +173,24 @@ DerivedFormState.isBlurred
 
 ***
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+
+A boolean indicating if all of the form's fields are the same as default values.
+
+#### Inherited from
+
+```ts
+DerivedFormState.isDefaultValue
+```
+
+***
+
 ### isDirty
 
 ```ts
@@ -371,7 +389,7 @@ DerivedFormState.isTouched
 isValid: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
 
 A boolean indicating if the form and all its fields are valid. Evaluates `true` if there are no errors.
 
diff --git a/docs/ja/reference/type-aliases/anyfieldapi.md b/docs/ja/reference/type-aliases/anyfieldapi.md
index 866df6312..3f20447aa 100644
--- a/docs/ja/reference/type-aliases/anyfieldapi.md
+++ b/docs/ja/reference/type-aliases/anyfieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:18:21.677Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.716Z'
 id: AnyFieldApi
 title: AnyFieldApi
 ---
@@ -13,6 +13,6 @@ title: AnyFieldApi
 type AnyFieldApi = FieldApi<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L828)
+Defined in: [packages/form-core/src/FieldApi.ts:832](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L832)
 
 A type representing the Field API with all generics set to `any` for convenience.
diff --git a/docs/ja/reference/type-aliases/anyfieldmeta.md b/docs/ja/reference/type-aliases/anyfieldmeta.md
index 2a0025155..5c9d9efab 100644
--- a/docs/ja/reference/type-aliases/anyfieldmeta.md
+++ b/docs/ja/reference/type-aliases/anyfieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:18:21.670Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.712Z'
 id: AnyFieldMeta
 title: AnyFieldMeta
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMeta
 type AnyFieldMeta = FieldMeta<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L747)
+Defined in: [packages/form-core/src/FieldApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L751)
diff --git a/docs/ja/reference/type-aliases/anyfieldmetaderived.md b/docs/ja/reference/type-aliases/anyfieldmetaderived.md
index 12e2b247d..e8cb4a756 100644
--- a/docs/ja/reference/type-aliases/anyfieldmetaderived.md
+++ b/docs/ja/reference/type-aliases/anyfieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:18:21.662Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.708Z'
 id: AnyFieldMetaDerived
 title: AnyFieldMetaDerived
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMetaDerived
 type AnyFieldMetaDerived = FieldMetaDerived<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L661)
+Defined in: [packages/form-core/src/FieldApi.ts:665](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L665)
diff --git a/docs/ja/reference/type-aliases/anyformapi.md b/docs/ja/reference/type-aliases/anyformapi.md
index 9388393eb..6017f7cc1 100644
--- a/docs/ja/reference/type-aliases/anyformapi.md
+++ b/docs/ja/reference/type-aliases/anyformapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:18:21.658Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.700Z'
 id: AnyFormApi
 title: AnyFormApi
 ---
@@ -13,6 +13,6 @@ title: AnyFormApi
 type AnyFormApi = FormApi<any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L747)
+Defined in: [packages/form-core/src/FormApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L751)
 
 A type representing the Form API with all generics set to `any` for convenience.
diff --git a/docs/ja/reference/type-aliases/anyformstate.md b/docs/ja/reference/type-aliases/anyformstate.md
index c63abdd2b..905cfa024 100644
--- a/docs/ja/reference/type-aliases/anyformstate.md
+++ b/docs/ja/reference/type-aliases/anyformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:18:21.654Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.704Z'
 id: AnyFormState
 title: AnyFormState
 ---
@@ -13,4 +13,4 @@ title: AnyFormState
 type AnyFormState = FormState<any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:676](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L676)
+Defined in: [packages/form-core/src/FormApi.ts:680](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L680)
diff --git a/docs/ja/reference/type-aliases/derivedformstate.md b/docs/ja/reference/type-aliases/derivedformstate.md
index a2a009107..21eaa9d09 100644
--- a/docs/ja/reference/type-aliases/derivedformstate.md
+++ b/docs/ja/reference/type-aliases/derivedformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:36.177Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.697Z'
 id: DerivedFormState
 title: DerivedFormState
 ---
@@ -77,6 +77,14 @@ isBlurred: boolean;
 
 A boolean indicating if any of the form fields have been blurred.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A boolean indicating if all of the form's fields are the same as default values.
+
 ### isDirty
 
 ```ts
diff --git a/docs/ja/reference/type-aliases/fieldmeta.md b/docs/ja/reference/type-aliases/fieldmeta.md
index 513424dc7..908d5ca33 100644
--- a/docs/ja/reference/type-aliases/fieldmeta.md
+++ b/docs/ja/reference/type-aliases/fieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:36.064Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.693Z'
 id: FieldMeta
 title: FieldMeta
 ---
@@ -13,7 +13,7 @@ title: FieldMeta
 type FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = FieldMetaBase<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> & FieldMetaDerived<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:684](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L684)
+Defined in: [packages/form-core/src/FieldApi.ts:688](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L688)
 
 An object type representing the metadata of a field in a form.
 
diff --git a/docs/ja/reference/type-aliases/fieldmetaderived.md b/docs/ja/reference/type-aliases/fieldmetaderived.md
index e714cf1da..b21c10ac9 100644
--- a/docs/ja/reference/type-aliases/fieldmetaderived.md
+++ b/docs/ja/reference/type-aliases/fieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:18:21.614Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.689Z'
 id: FieldMetaDerived
 title: FieldMetaDerived
 ---
@@ -68,6 +68,14 @@ errors: (
 
 An array of errors related to the field value.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A flag indicating whether the field's current value is the default value
+
 ### isPristine
 
 ```ts
diff --git a/docs/ja/reference/type-aliases/fieldstate.md b/docs/ja/reference/type-aliases/fieldstate.md
index 6e99f9113..e2d03ae70 100644
--- a/docs/ja/reference/type-aliases/fieldstate.md
+++ b/docs/ja/reference/type-aliases/fieldstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:36.103Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:43:49.685Z'
 id: FieldState
 title: FieldState
 ---
@@ -13,7 +13,7 @@ title: FieldState
 type FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:770](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L770)
+Defined in: [packages/form-core/src/FieldApi.ts:774](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L774)
 
 An object type representing the state of a field.
 
diff --git a/docs/ru/framework/react/guides/basic-concepts.md b/docs/ru/framework/react/guides/basic-concepts.md
index f4b9e268a..164439e52 100644
--- a/docs/ru/framework/react/guides/basic-concepts.md
+++ b/docs/ru/framework/react/guides/basic-concepts.md
@@ -1,11 +1,13 @@
 ---
-source-updated-at: '2025-04-16T08:45:06.000Z'
-translation-updated-at: '2025-04-30T22:00:19.778Z'
+source-updated-at: '2025-05-08T07:42:29.000Z'
+translation-updated-at: '2025-05-08T23:52:52.172Z'
 id: basic-concepts
-title: Основные концепции
+title: Основные понятия
 ---
 
-Эта страница знакомит с основными концепциями и терминологией, используемыми в библиотеке `@tanstack/react-form`. Ознакомление с этими понятиями поможет вам лучше понять и эффективнее работать с библиотекой.
+# Основные концепции и терминология
+
+На этой странице представлены основные концепции и терминология, используемые в библиотеке `@tanstack/react-form`. Ознакомление с этими понятиями поможет вам лучше понять и эффективнее работать с библиотекой.
 
 ## Настройки формы (Form Options)
 
@@ -28,19 +30,19 @@ const formOpts = formOptions({
 
 ## Экземпляр формы (Form Instance)
 
-Экземпляр формы — это объект, представляющий отдельную форму и предоставляющий методы и свойства для работы с ней. Экземпляр формы создаётся с помощью хука `useForm`, предоставляемого настройками формы. Хук принимает объект с функцией `onSubmit`, которая вызывается при отправке формы.
+Экземпляр формы (Form Instance) — это объект, представляющий отдельную форму и предоставляющий методы и свойства для работы с ней. Экземпляр формы создаётся с помощью хука `useForm`, который принимает объект с функцией `onSubmit`, вызываемой при отправке формы.
 
 ```tsx
 const form = useForm({
   ...formOpts,
   onSubmit: async ({ value }) => {
-    // Обработка данных формы
+    // Действия с данными формы
     console.log(value)
   },
 })
 ```
 
-Вы также можете создать экземпляр формы без использования `formOptions`, воспользовавшись автономным API `useForm`:
+Также можно создать экземпляр формы без использования `formOptions`, используя автономный API `useForm`:
 
 ```tsx
 interface User {
@@ -53,7 +55,7 @@ const defaultUser: User = { firstName: '', lastName: '', hobbies: [] }
 const form = useForm({
   defaultValues: defaultUser,
   onSubmit: async ({ value }) => {
-    // Обработка данных формы
+    // Действия с данными формы
     console.log(value)
   },
 })
@@ -61,7 +63,7 @@ const form = useForm({
 
 ## Поле (Field)
 
-Поле представляет собой отдельный элемент ввода формы, например текстовое поле или чекбокс. Поля создаются с помощью компонента `form.Field`, предоставляемого экземпляром формы. Компонент принимает проп `name`, который должен соответствовать ключу в значениях формы по умолчанию. Также он принимает проп `children` — функцию рендера, которая получает объект поля в качестве аргумента.
+Поле (Field) представляет собой отдельный элемент ввода формы, например, текстовое поле или чекбокс. Поля создаются с помощью компонента `form.Field`, предоставляемого экземпляром формы. Компонент принимает проп `name`, который должен соответствовать ключу в значениях формы по умолчанию, а также проп `children` — функцию рендера, принимающую объект поля в качестве аргумента.
 
 Пример:
 
@@ -83,7 +85,7 @@ const form = useForm({
 
 ## Состояние поля (Field State)
 
-Каждое поле имеет собственное состояние, включающее текущее значение, статус валидации, сообщения об ошибках и другие метаданные. Доступ к состоянию поля можно получить через свойство `field.state`.
+Каждое поле имеет собственное состояние (Field State), включающее текущее значение, статус валидации, сообщения об ошибках и другие метаданные. Доступ к состоянию поля можно получить через свойство `field.state`.
 
 Пример:
 
@@ -94,7 +96,11 @@ const {
 } = field.state
 ```
 
-Существует три состояния поля, которые могут быть полезны для отслеживания взаимодействия пользователя с полем: поле считается _"touched"_, когда пользователь кликает/переходит в него, _"pristine"_ до изменения значения и _"dirty"_ после изменения. Эти состояния можно проверить с помощью флагов `isTouched`, `isPristine` и `isDirty`, как показано ниже.
+В метаданных есть три состояния, которые могут быть полезны для отслеживания взаимодействия пользователя с полем:
+
+- `"isTouched"` — после того, как пользователь кликнул/перешёл в поле.
+- `"isPristine"` — пока пользователь не изменил значение поля.
+- `"isDirty"` — после изменения значения поля.
 
 ```tsx
 const { isTouched, isPristine, isDirty } = field.state.meta
@@ -102,13 +108,32 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 
 ![Состояния поля](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states.png)
 
-> **Важное примечание для пользователей `React Hook Form`**: флаг `isDirty` в `TanStack/form` отличается от одноимённого флага в RHF.
-> В RHF `isDirty = true`, когда значения формы отличаются от исходных. Если пользователь изменит значения формы, а затем вернёт их к значениям по умолчанию, в RHF `isDirty` будет `false`, а в `TanStack/form` — `true`.
-> Значения по умолчанию доступны как на уровне формы, так и на уровне поля в `TanStack/form` (`form.options.defaultValues`, `field.options.defaultValue`), поэтому вы можете написать собственный хелпер `isDefaultValue()`, если нужно эмулировать поведение RHF.
+## Понимание `isDirty` в разных библиотеках
+
+**Непостоянное (Non-Persistent) состояние `dirty`**
+
+- **Библиотеки**: React Hook Form (RHF), Formik, Final Form.
+- **Поведение**: Поле считается `dirty`, если его значение отличается от значения по умолчанию. Возврат к значению по умолчанию делает его `clean`.
+
+**Постоянное (Persistent) состояние `dirty`**
+
+- **Библиотеки**: Angular Form, Vue FormKit.
+- **Поведение**: Поле остаётся `dirty` после изменения, даже если вернуться к значению по умолчанию.
+
+Мы выбрали модель с **постоянным `dirty`**. Для поддержки непостоянного `dirty` введён флаг `isDefault`. Этот флаг действует как инверсия непостоянного `dirty`.
+
+```tsx
+const { isTouched, isPristine, isDirty, isDefaultValue } = field.state.meta
+
+// Следующая строка воссоздаёт функциональность непостоянного `dirty`.
+const nonPersistentIsDirty = !isDefaultValue
+```
+
+![Расширенные состояния поля](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states-extended.png)
 
 ## API поля (Field API)
 
-API поля — это объект, передаваемый в функцию рендера при создании поля. Он предоставляет методы для работы с состоянием поля.
+API поля (Field API) — это объект, передаваемый в функцию рендера при создании поля. Он предоставляет методы для работы с состоянием поля.
 
 Пример:
 
@@ -120,9 +145,9 @@ API поля — это объект, передаваемый в функцию
 />
 ```
 
-## Валидация (Validation)
+## Валидация
 
-`@tanstack/react-form` предоставляет как синхронную, так и асинхронную валидацию "из коробки". Функции валидации можно передать в компонент `form.Field` через проп `validators`.
+`@tanstack/react-form` поддерживает синхронную и асинхронную валидацию "из коробки". Функции валидации можно передать в компонент `form.Field` через проп `validators`.
 
 Пример:
 
@@ -132,9 +157,9 @@ API поля — это объект, передаваемый в функцию
   validators={{
     onChange: ({ value }) =>
       !value
-        ? 'Укажите имя'
+        ? 'Имя обязательно'
         : value.length < 3
-          ? 'Имя должно содержать не менее 3 символов'
+          ? 'Имя должно содержать минимум 3 символа'
           : undefined,
     onChangeAsync: async ({ value }) => {
       await new Promise((resolve) => setTimeout(resolve, 1000))
@@ -154,11 +179,11 @@ API поля — это объект, передаваемый в функцию
 />
 ```
 
-## Валидация со стандартными библиотеками схем (Validation with Standard Schema Libraries)
+## Валидация с использованием стандартных библиотек схем (Standard Schema Libraries)
 
-Помимо ручной валидации, также поддерживается спецификация [Standard Schema](https://github.com/standard-schema/standard-schema).
+Помимо ручной валидации, поддерживается спецификация [Standard Schema](https://github.com/standard-schema/standard-schema).
 
-Вы можете определить схему с помощью любой библиотеки, реализующей спецификацию, и передать её в валидатор формы или поля.
+Вы можете определить схему с помощью любой библиотеки, реализующей эту спецификацию, и передать её в валидатор формы или поля.
 
 Поддерживаемые библиотеки:
 
@@ -197,7 +222,7 @@ function App() {
 
 ## Реактивность (Reactivity)
 
-`@tanstack/react-form` предлагает различные способы подписки на изменения состояния формы и полей, в частности хук `useStore(form.store)` и компонент `form.Subscribe`. Эти методы позволяют оптимизировать производительность рендеринга формы, обновляя компоненты только при необходимости.
+`@tanstack/react-form` предлагает различные способы подписки на изменения состояния формы и полей, включая хук `useStore(form.store)` и компонент `form.Subscribe`. Эти методы позволяют оптимизировать производительность рендеринга, обновляя компоненты только при необходимости.
 
 Пример:
 
@@ -214,7 +239,7 @@ const firstName = useStore(form.store, (state) => state.values.firstName)
 />
 ```
 
-Важно помнить, что хотя проп `selector` в хуке `useStore` необязателен, настоятельно рекомендуется его указывать, так как его отсутствие приведёт к лишним перерисовкам.
+Важно помнить, что хотя проп `selector` в хуке `useStore` необязателен, его использование рекомендуется, так как его отсутствие приведёт к лишним ререндерам.
 
 ```tsx
 // Правильное использование
@@ -224,7 +249,7 @@ const errors = useStore(form.store, (state) => state.errorMap)
 const store = useStore(form.store)
 ```
 
-Примечание: Использование хука `useField` для реактивности не рекомендуется, так как он предназначен для осмысленного использования внутри компонента `form.Field`. Вместо него можно использовать `useStore(form.store)`.
+Примечание: Использование хука `useField` для реактивности не рекомендуется, так как он предназначен для аккуратного использования внутри компонента `form.Field`. Вместо него можно использовать `useStore(form.store)`.
 
 ## Слушатели (Listeners)
 
@@ -237,20 +262,20 @@ const store = useStore(form.store)
   name="country"
   listeners={{
     onChange: ({ value }) => {
-      console.log(`Страна изменена на: ${value}, сброс провинции`)
+      console.log(`Страна изменена на: ${value}, сброс региона`)
       form.setFieldValue('province', '')
     },
   }}
 />
 ```
 
-Подробнее см. в [Слушатели](./listeners.md).
+Подробнее: [Слушатели](./listeners.md)
 
 ## Поля-массивы (Array Fields)
 
-Поля-массивы позволяют управлять списками значений в форме, например списком хобби. Поле-массив создаётся с помощью компонента `form.Field` с пропом `mode="array"`.
+Поля-массивы (Array Fields) позволяют управлять списками значений в форме, например, списком хобби. Такое поле создаётся с помощью компонента `form.Field` с пропом `mode="array"`.
 
-При работе с полями-массивами можно использовать методы `pushValue`, `removeValue`, `swapValues` и `moveValue` для добавления, удаления и перестановки значений в массиве.
+Для работы с массивами можно использовать методы `pushValue`, `removeValue`, `swapValues` и `moveValue` для добавления, удаления и перестановки значений.
 
 Пример:
 
@@ -263,7 +288,7 @@ const store = useStore(form.store)
       Хобби
       <div>
         {!hobbiesField.state.value.length
-          ? 'Хобби не указаны.'
+          ? 'Хобби не найдены.'
           : hobbiesField.state.value.map((_, i) => (
               <div key={i}>
                 <form.Field
@@ -330,9 +355,9 @@ const store = useStore(form.store)
 
 ## Кнопки сброса (Reset Buttons)
 
-При использовании `<button type="reset">` вместе с методом `form.reset()` в TanStack Form необходимо предотвратить стандартное поведение HTML-сброса, чтобы избежать неожиданного сброса элементов формы (особенно `<select>`) к их начальным HTML-значениям. Используйте `event.preventDefault()` в обработчике `onClick` кнопки, чтобы предотвратить нативный сброс формы.
+При использовании `<button type="reset">` вместе с методом `form.reset()` из TanStack Form необходимо предотвратить стандартное поведение HTML, чтобы избежать неожиданного сброса элементов формы (особенно `<select>`) к их начальным значениям.
 
-Пример:
+Используйте `event.preventDefault()` в обработчике `onClick` кнопки:
 
 ```tsx
 <button
@@ -346,7 +371,7 @@ const store = useStore(form.store)
 </button>
 ```
 
-Альтернативно можно использовать `<button type="button">`, чтобы избежать нативного сброса HTML.
+Либо можно использовать `<button type="button">`:
 
 ```tsx
 <button
@@ -359,4 +384,4 @@ const store = useStore(form.store)
 </button>
 ```
 
-Это основные концепции и терминология, используемые в библиотеке `@tanstack/react-form`. Понимание этих концепций поможет вам эффективнее работать с библиотекой и легко создавать сложные формы.
+Это основные концепции и терминология, используемые в библиотеке `@tanstack/react-form`. Их понимание поможет вам эффективнее работать с библиотекой и создавать сложные формы с лёгкостью.
diff --git a/docs/ru/reference/classes/fieldapi.md b/docs/ru/reference/classes/fieldapi.md
index 8d1352d4e..b8fd85fcd 100644
--- a/docs/ru/reference/classes/fieldapi.md
+++ b/docs/ru/reference/classes/fieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:53:14.083Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.573Z'
 id: FieldApi
 title: FieldApi
 ---
@@ -9,7 +9,7 @@ title: FieldApi
 
 # Class: FieldApi\<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta\>
 
-Defined in: [packages/form-core/src/FieldApi.ts:859](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L859)
+Defined in: [packages/form-core/src/FieldApi.ts:863](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L863)
 
 A class representing the API for managing a form field.
 
@@ -67,7 +67,7 @@ the `new FieldApi` constructor.
 new FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>(opts): FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:991](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L991)
+Defined in: [packages/form-core/src/FieldApi.ts:995](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L995)
 
 Initializes a new `FieldApi` instance.
 
@@ -89,7 +89,7 @@ Initializes a new `FieldApi` instance.
 form: FormApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:903](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L903)
+Defined in: [packages/form-core/src/FieldApi.ts:907](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L907)
 
 A reference to the form API instance.
 
@@ -101,7 +101,7 @@ A reference to the form API instance.
 name: DeepKeys<TParentData>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:927](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L927)
+Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
 
 The field name.
 
@@ -113,7 +113,7 @@ The field name.
 options: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
+Defined in: [packages/form-core/src/FieldApi.ts:935](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L935)
 
 The field options.
 
@@ -125,7 +125,7 @@ The field options.
 store: Derived<FieldState<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:955](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L955)
+Defined in: [packages/form-core/src/FieldApi.ts:959](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L959)
 
 The field state store.
 
@@ -137,7 +137,7 @@ The field state store.
 timeoutIds: object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:982](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L982)
+Defined in: [packages/form-core/src/FieldApi.ts:986](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L986)
 
 #### formListeners
 
@@ -167,7 +167,7 @@ validations: Record<ValidationCause, null | Timeout>;
 get state(): FieldState<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:979](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L979)
+Defined in: [packages/form-core/src/FieldApi.ts:983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L983)
 
 The current field state.
 
@@ -183,7 +183,7 @@ The current field state.
 getInfo(): FieldInfo<TParentData>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1245](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1245)
+Defined in: [packages/form-core/src/FieldApi.ts:1249](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1249)
 
 Gets the field information object.
 
@@ -199,7 +199,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:1213](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1213)
+Defined in: [packages/form-core/src/FieldApi.ts:1217](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1217)
 
 #### Returns
 
@@ -213,7 +213,7 @@ Defined in: [packages/form-core/src/FieldApi.ts:1213](https://github.com/TanStac
 getValue(): TData
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1198](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1198)
+Defined in: [packages/form-core/src/FieldApi.ts:1202](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1202)
 
 Gets the current field value.
 
@@ -233,7 +233,7 @@ Use `field.state.value` instead.
 handleBlur(): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1657](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1657)
+Defined in: [packages/form-core/src/FieldApi.ts:1661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1661)
 
 Handles the blur event.
 
@@ -249,7 +249,7 @@ Handles the blur event.
 handleChange(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1650](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1650)
+Defined in: [packages/form-core/src/FieldApi.ts:1654](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1654)
 
 Handles the change event.
 
@@ -274,7 +274,7 @@ insertValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1262](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1262)
+Defined in: [packages/form-core/src/FieldApi.ts:1266](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1266)
 
 Inserts a value at the specified index, shifting the subsequent values to the right.
 
@@ -304,7 +304,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:1088](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1088)
+Defined in: [packages/form-core/src/FieldApi.ts:1092](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1092)
 
 Mounts the field instance to the form.
 
@@ -327,7 +327,7 @@ moveValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1306](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1306)
+Defined in: [packages/form-core/src/FieldApi.ts:1310](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1310)
 
 Moves the value at the first specified index to the second specified index.
 
@@ -359,7 +359,7 @@ parseValueWithSchema(schema):
   | StandardSchemaV1Issue[]
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1699](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1699)
+Defined in: [packages/form-core/src/FieldApi.ts:1703](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1703)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -387,7 +387,7 @@ parseValueWithSchemaAsync(schema): Promise<
 | StandardSchemaV1Issue[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1711](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1711)
+Defined in: [packages/form-core/src/FieldApi.ts:1715](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1715)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -414,7 +414,7 @@ The standard schema to parse this field's value with.
 pushValue(value, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1250](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1250)
+Defined in: [packages/form-core/src/FieldApi.ts:1254](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1254)
 
 Pushes a new value to the field.
 
@@ -440,7 +440,7 @@ Pushes a new value to the field.
 removeValue(index, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1288](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1288)
+Defined in: [packages/form-core/src/FieldApi.ts:1292](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1292)
 
 Removes a value at the specified index.
 
@@ -469,7 +469,7 @@ replaceValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1275](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1275)
+Defined in: [packages/form-core/src/FieldApi.ts:1279](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1279)
 
 Replaces a value at the specified index.
 
@@ -499,7 +499,7 @@ Replaces a value at the specified index.
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1674](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1674)
+Defined in: [packages/form-core/src/FieldApi.ts:1678](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1678)
 
 Updates the field's errorMap
 
@@ -521,7 +521,7 @@ Updates the field's errorMap
 setMeta(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1218](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1218)
+Defined in: [packages/form-core/src/FieldApi.ts:1222](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1222)
 
 Sets the field metadata.
 
@@ -543,7 +543,7 @@ Sets the field metadata.
 setValue(updater, options?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1205](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1205)
+Defined in: [packages/form-core/src/FieldApi.ts:1209](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1209)
 
 Sets the field value and run the `change` validator.
 
@@ -572,7 +572,7 @@ swapValues(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1297](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1297)
+Defined in: [packages/form-core/src/FieldApi.ts:1301](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1301)
 
 Swaps the values at the specified indices.
 
@@ -602,7 +602,7 @@ Swaps the values at the specified indices.
 update(opts): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1141](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1141)
+Defined in: [packages/form-core/src/FieldApi.ts:1145](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1145)
 
 Updates the field instance with new options.
 
@@ -624,7 +624,7 @@ Updates the field instance with new options.
 validate(cause, opts?): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1617](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1617)
+Defined in: [packages/form-core/src/FieldApi.ts:1621](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1621)
 
 Validates the field value.
 
diff --git a/docs/ru/reference/classes/formapi.md b/docs/ru/reference/classes/formapi.md
index 75400bb6f..49b8f5960 100644
--- a/docs/ru/reference/classes/formapi.md
+++ b/docs/ru/reference/classes/formapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:53:14.078Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.569Z'
 id: FormApi
 title: FormApi
 ---
@@ -9,7 +9,7 @@ title: FormApi
 
 # Class: FormApi\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta\>
 
-Defined in: [packages/form-core/src/FormApi.ts:767](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L767)
+Defined in: [packages/form-core/src/FormApi.ts:771](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L771)
 
 A class representing the Form API. It handles the logic and interactions with the form state.
 
@@ -47,7 +47,7 @@ However, if you need to create a new instance manually, you can do so by calling
 new FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>(opts?): FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:838](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L838)
+Defined in: [packages/form-core/src/FormApi.ts:842](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L842)
 
 Constructs a new `FormApi` instance with the given form options.
 
@@ -69,7 +69,7 @@ Constructs a new `FormApi` instance with the given form options.
 baseStore: Store<BaseFormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L794)
+Defined in: [packages/form-core/src/FormApi.ts:798](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L798)
 
 ***
 
@@ -79,7 +79,7 @@ Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/
 fieldInfo: Record<DeepKeys<TFormData>, FieldInfo<TFormData>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:824](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L824)
+Defined in: [packages/form-core/src/FormApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L828)
 
 A record of field information for each field in the form.
 
@@ -91,7 +91,7 @@ A record of field information for each field in the form.
 fieldMetaDerived: Derived<Record<DeepKeys<TFormData>, AnyFieldMeta>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L807)
+Defined in: [packages/form-core/src/FormApi.ts:811](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L811)
 
 ***
 
@@ -101,7 +101,7 @@ Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/
 options: FormOptions<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta> = {};
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:782](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L782)
+Defined in: [packages/form-core/src/FormApi.ts:786](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L786)
 
 The options for the form.
 
@@ -113,7 +113,7 @@ The options for the form.
 store: Derived<FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L808)
+Defined in: [packages/form-core/src/FormApi.ts:812](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L812)
 
 ## Accessors
 
@@ -125,7 +125,7 @@ Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/
 get state(): FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L826)
+Defined in: [packages/form-core/src/FormApi.ts:830](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L830)
 
 ##### Returns
 
@@ -139,7 +139,7 @@ Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/
 deleteField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1912)
+Defined in: [packages/form-core/src/FormApi.ts:1938](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1938)
 
 #### Type Parameters
 
@@ -163,7 +163,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack
 getAllErrors(): object
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2148](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2148)
+Defined in: [packages/form-core/src/FormApi.ts:2174](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2174)
 
 Returns form and field level errors
 
@@ -214,7 +214,7 @@ errors: (
 getFieldInfo<TField>(field): FieldInfo<TFormData>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1826)
+Defined in: [packages/form-core/src/FormApi.ts:1852](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1852)
 
 Gets the field info of the specified field.
 
@@ -240,7 +240,7 @@ Gets the field info of the specified field.
 getFieldMeta<TField>(field): undefined | AnyFieldMeta
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1817](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1817)
+Defined in: [packages/form-core/src/FormApi.ts:1843](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1843)
 
 Gets the metadata of the specified field.
 
@@ -266,7 +266,7 @@ Gets the metadata of the specified field.
 getFieldValue<TField>(field): DeepValue<TFormData, TField>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1810](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1810)
+Defined in: [packages/form-core/src/FormApi.ts:1836](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1836)
 
 Gets the value of the specified field.
 
@@ -294,7 +294,7 @@ Gets the value of the specified field.
 handleSubmit(): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1712](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1712)
+Defined in: [packages/form-core/src/FormApi.ts:1738](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1738)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -308,7 +308,7 @@ Handles the form submission, performs validation, and calls the appropriate onSu
 handleSubmit(submitMeta): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1713](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1713)
+Defined in: [packages/form-core/src/FormApi.ts:1739](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1739)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -334,7 +334,7 @@ insertFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1951)
+Defined in: [packages/form-core/src/FormApi.ts:1977](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1977)
 
 #### Type Parameters
 
@@ -370,7 +370,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack
 mount(): () => void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1142](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1142)
+Defined in: [packages/form-core/src/FormApi.ts:1168](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1168)
 
 #### Returns
 
@@ -392,7 +392,7 @@ moveFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2075](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2075)
+Defined in: [packages/form-core/src/FormApi.ts:2101](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2101)
 
 Moves the value at the first specified index to the second specified index within an array field.
 
@@ -435,7 +435,7 @@ parseValuesWithSchema(schema):
 }
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2208](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2208)
+Defined in: [packages/form-core/src/FormApi.ts:2234](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2234)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -469,7 +469,7 @@ parseValuesWithSchemaAsync(schema): Promise<
 }>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2220](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2220)
+Defined in: [packages/form-core/src/FormApi.ts:2246](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2246)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -502,7 +502,7 @@ pushFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1936](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1936)
+Defined in: [packages/form-core/src/FormApi.ts:1962](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1962)
 
 Pushes a value into an array field.
 
@@ -539,7 +539,7 @@ removeFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
+Defined in: [packages/form-core/src/FormApi.ts:2035](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2035)
 
 Removes a value from an array field at the specified index.
 
@@ -577,7 +577,7 @@ replaceFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1983)
+Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
 
 Replaces a value into an array field at the specified index.
 
@@ -615,7 +615,7 @@ Replaces a value into an array field at the specified index.
 reset(values?, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1230](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1230)
+Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
 
 Resets the form state to the default values.
 If values are provided, the form will be reset to those values instead and the default values will be updated.
@@ -648,7 +648,7 @@ Optional options to control the reset behavior.
 resetField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2103](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2103)
+Defined in: [packages/form-core/src/FormApi.ts:2129](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2129)
 
 Resets the field value and meta to default state
 
@@ -674,7 +674,7 @@ Resets the field value and meta to default state
 resetFieldMeta<TField>(fieldMeta): Record<TField, AnyFieldMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1866](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1866)
+Defined in: [packages/form-core/src/FormApi.ts:1892](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1892)
 
 resets every field's meta
 
@@ -700,7 +700,7 @@ resets every field's meta
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2124](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2124)
+Defined in: [packages/form-core/src/FormApi.ts:2150](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2150)
 
 Updates the form's errorMap
 
@@ -722,7 +722,7 @@ Updates the form's errorMap
 setFieldMeta<TField>(field, updater): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1845](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1845)
+Defined in: [packages/form-core/src/FormApi.ts:1871](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1871)
 
 Updates the metadata of the specified field.
 
@@ -755,7 +755,7 @@ setFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1882](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1882)
+Defined in: [packages/form-core/src/FormApi.ts:1908](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1908)
 
 Sets the value of the specified field and optionally updates the touched state.
 
@@ -793,7 +793,7 @@ swapFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2046](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2046)
+Defined in: [packages/form-core/src/FormApi.ts:2072](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2072)
 
 Swaps the values at the specified indices within an array field.
 
@@ -831,7 +831,7 @@ Swaps the values at the specified indices within an array field.
 update(options?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1162](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1162)
+Defined in: [packages/form-core/src/FormApi.ts:1188](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1188)
 
 Updates the form options and form state.
 
@@ -853,7 +853,7 @@ Updates the form options and form state.
 validateAllFields(cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
+Defined in: [packages/form-core/src/FormApi.ts:1282](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1282)
 
 Validates all fields using the correct handlers for a given validation cause.
 
@@ -878,7 +878,7 @@ validateArrayFieldsStartingFrom<TField>(
 cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1286](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1286)
+Defined in: [packages/form-core/src/FormApi.ts:1312](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1312)
 
 Validates the children of a specified array in the form starting from a given index until the end using the correct handlers for a given validation type.
 
@@ -912,7 +912,7 @@ Validates the children of a specified array in the form starting from a given in
 validateField<TField>(field, cause): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1325](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1325)
+Defined in: [packages/form-core/src/FormApi.ts:1351](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1351)
 
 Validates a specified field in the form using the correct handlers for a given validation type.
 
diff --git a/docs/ru/reference/functions/evaluate.md b/docs/ru/reference/functions/evaluate.md
new file mode 100644
index 000000000..8fa7a5e31
--- /dev/null
+++ b/docs/ru/reference/functions/evaluate.md
@@ -0,0 +1,34 @@
+---
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.564Z'
+id: evaluate
+title: evaluate
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: evaluate()
+
+```ts
+function evaluate<T>(objA, objB): boolean
+```
+
+Defined in: [packages/form-core/src/utils.ts:339](https://github.com/TanStack/form/blob/main/packages/form-core/src/utils.ts#L339)
+
+## Type Parameters
+
+• **T**
+
+## Parameters
+
+### objA
+
+`T`
+
+### objB
+
+`T`
+
+## Returns
+
+`boolean`
diff --git a/docs/ru/reference/index.md b/docs/ru/reference/index.md
index a637ddfe2..81674b33b 100644
--- a/docs/ru/reference/index.md
+++ b/docs/ru/reference/index.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-25T12:58:29.000Z'
-translation-updated-at: '2025-04-30T22:42:00.099Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.555Z'
 id: '@tanstack/form-core'
 title: '@tanstack/form-core'
 ---
@@ -84,8 +84,8 @@ title: '@tanstack/form-core'
 
 ## Functions
 
+- [evaluate](functions/evaluate.md)
 - [formOptions](functions/formoptions.md)
 - [isGlobalFormValidationError](functions/isglobalformvalidationerror.md)
 - [isStandardSchemaValidator](functions/isstandardschemavalidator.md)
 - [mergeForm](functions/mergeform.md)
-- [shallow](functions/shallow.md)
diff --git a/docs/ru/reference/interfaces/formstate.md b/docs/ru/reference/interfaces/formstate.md
index b6fe9a5f6..d4a7e73f4 100644
--- a/docs/ru/reference/interfaces/formstate.md
+++ b/docs/ru/reference/interfaces/formstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:25:45.693Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.560Z'
 id: FormState
 title: FormState
 ---
@@ -9,7 +9,7 @@ title: FormState
 
 # Interface: FormState\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer\>
 
-Defined in: [packages/form-core/src/FormApi.ts:643](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L643)
+Defined in: [packages/form-core/src/FormApi.ts:647](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L647)
 
 An object representing the current state of the form.
 
@@ -63,7 +63,7 @@ BaseFormState._force_re_eval
 canSubmit: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
+Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
 
 A boolean indicating if the form can be submitted based on its current state.
 
@@ -125,7 +125,7 @@ DerivedFormState.errors
 fieldMeta: Record<DeepKeys<TFormData>, AnyFieldMeta>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
+Defined in: [packages/form-core/src/FormApi.ts:644](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L644)
 
 A record of field metadata for each field in the form.
 
@@ -173,6 +173,24 @@ DerivedFormState.isBlurred
 
 ***
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+
+A boolean indicating if all of the form's fields are the same as default values.
+
+#### Inherited from
+
+```ts
+DerivedFormState.isDefaultValue
+```
+
+***
+
 ### isDirty
 
 ```ts
@@ -371,7 +389,7 @@ DerivedFormState.isTouched
 isValid: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
 
 A boolean indicating if the form and all its fields are valid. Evaluates `true` if there are no errors.
 
diff --git a/docs/ru/reference/type-aliases/anyfieldapi.md b/docs/ru/reference/type-aliases/anyfieldapi.md
index c0fb25045..660bd72c8 100644
--- a/docs/ru/reference/type-aliases/anyfieldapi.md
+++ b/docs/ru/reference/type-aliases/anyfieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:25:45.851Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.612Z'
 id: AnyFieldApi
 title: AnyFieldApi
 ---
@@ -13,6 +13,6 @@ title: AnyFieldApi
 type AnyFieldApi = FieldApi<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L828)
+Defined in: [packages/form-core/src/FieldApi.ts:832](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L832)
 
 A type representing the Field API with all generics set to `any` for convenience.
diff --git a/docs/ru/reference/type-aliases/anyfieldmeta.md b/docs/ru/reference/type-aliases/anyfieldmeta.md
index fabf65190..1f56943b8 100644
--- a/docs/ru/reference/type-aliases/anyfieldmeta.md
+++ b/docs/ru/reference/type-aliases/anyfieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:25:45.845Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.608Z'
 id: AnyFieldMeta
 title: AnyFieldMeta
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMeta
 type AnyFieldMeta = FieldMeta<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L747)
+Defined in: [packages/form-core/src/FieldApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L751)
diff --git a/docs/ru/reference/type-aliases/anyfieldmetaderived.md b/docs/ru/reference/type-aliases/anyfieldmetaderived.md
index 2e1a57a13..6d8ecc3fc 100644
--- a/docs/ru/reference/type-aliases/anyfieldmetaderived.md
+++ b/docs/ru/reference/type-aliases/anyfieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:25:45.832Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.604Z'
 id: AnyFieldMetaDerived
 title: AnyFieldMetaDerived
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMetaDerived
 type AnyFieldMetaDerived = FieldMetaDerived<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L661)
+Defined in: [packages/form-core/src/FieldApi.ts:665](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L665)
diff --git a/docs/ru/reference/type-aliases/anyformapi.md b/docs/ru/reference/type-aliases/anyformapi.md
index 4a6a1b131..00a38659b 100644
--- a/docs/ru/reference/type-aliases/anyformapi.md
+++ b/docs/ru/reference/type-aliases/anyformapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:25:45.836Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.600Z'
 id: AnyFormApi
 title: AnyFormApi
 ---
@@ -13,6 +13,6 @@ title: AnyFormApi
 type AnyFormApi = FormApi<any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L747)
+Defined in: [packages/form-core/src/FormApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L751)
 
 A type representing the Form API with all generics set to `any` for convenience.
diff --git a/docs/ru/reference/type-aliases/anyformstate.md b/docs/ru/reference/type-aliases/anyformstate.md
index 7c5a5d8eb..91619778b 100644
--- a/docs/ru/reference/type-aliases/anyformstate.md
+++ b/docs/ru/reference/type-aliases/anyformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:25:45.828Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.594Z'
 id: AnyFormState
 title: AnyFormState
 ---
@@ -13,4 +13,4 @@ title: AnyFormState
 type AnyFormState = FormState<any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:676](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L676)
+Defined in: [packages/form-core/src/FormApi.ts:680](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L680)
diff --git a/docs/ru/reference/type-aliases/derivedformstate.md b/docs/ru/reference/type-aliases/derivedformstate.md
index 19fd4d806..1c7f3ad5c 100644
--- a/docs/ru/reference/type-aliases/derivedformstate.md
+++ b/docs/ru/reference/type-aliases/derivedformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:42:00.777Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.591Z'
 id: DerivedFormState
 title: DerivedFormState
 ---
@@ -77,6 +77,14 @@ isBlurred: boolean;
 
 A boolean indicating if any of the form fields have been blurred.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A boolean indicating if all of the form's fields are the same as default values.
+
 ### isDirty
 
 ```ts
diff --git a/docs/ru/reference/type-aliases/fieldmeta.md b/docs/ru/reference/type-aliases/fieldmeta.md
index 2e8f83f54..4b48a1fc8 100644
--- a/docs/ru/reference/type-aliases/fieldmeta.md
+++ b/docs/ru/reference/type-aliases/fieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:42:00.672Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.586Z'
 id: FieldMeta
 title: FieldMeta
 ---
@@ -13,7 +13,7 @@ title: FieldMeta
 type FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = FieldMetaBase<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> & FieldMetaDerived<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:684](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L684)
+Defined in: [packages/form-core/src/FieldApi.ts:688](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L688)
 
 An object type representing the metadata of a field in a form.
 
diff --git a/docs/ru/reference/type-aliases/fieldmetaderived.md b/docs/ru/reference/type-aliases/fieldmetaderived.md
index 0f7d53fd7..802d6dca7 100644
--- a/docs/ru/reference/type-aliases/fieldmetaderived.md
+++ b/docs/ru/reference/type-aliases/fieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:25:45.788Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.582Z'
 id: FieldMetaDerived
 title: FieldMetaDerived
 ---
@@ -68,6 +68,14 @@ errors: (
 
 An array of errors related to the field value.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A flag indicating whether the field's current value is the default value
+
 ### isPristine
 
 ```ts
diff --git a/docs/ru/reference/type-aliases/fieldstate.md b/docs/ru/reference/type-aliases/fieldstate.md
index 8049a0058..651471133 100644
--- a/docs/ru/reference/type-aliases/fieldstate.md
+++ b/docs/ru/reference/type-aliases/fieldstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:42:00.713Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:51:05.578Z'
 id: FieldState
 title: FieldState
 ---
@@ -13,7 +13,7 @@ title: FieldState
 type FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:770](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L770)
+Defined in: [packages/form-core/src/FieldApi.ts:774](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L774)
 
 An object type representing the state of a field.
 
diff --git a/docs/zh-hans/framework/react/guides/basic-concepts.md b/docs/zh-hans/framework/react/guides/basic-concepts.md
index 3f0751b4c..37f6ca904 100644
--- a/docs/zh-hans/framework/react/guides/basic-concepts.md
+++ b/docs/zh-hans/framework/react/guides/basic-concepts.md
@@ -1,15 +1,15 @@
 ---
-source-updated-at: '2025-04-16T08:45:06.000Z'
-translation-updated-at: '2025-04-29T23:15:30.242Z'
+source-updated-at: '2025-05-08T07:42:29.000Z'
+translation-updated-at: '2025-05-08T23:42:08.511Z'
 id: basic-concepts
 title: 基础概念
 ---
 
-本页介绍 `@tanstack/react-form` 库中使用的基本概念和术语。熟悉这些概念将帮助您更好地理解和使用该库。
+本页面介绍了 `@tanstack/react-form` 库中使用的基本概念和术语。熟悉这些概念将帮助您更好地理解和使用该库。
 
 ## 表单选项 (Form Options)
 
-您可以通过 `formOptions` 函数创建表单选项，以便在多个表单之间共享配置。
+您可以使用 `formOptions` 函数创建表单选项，以便在多个表单之间共享配置。
 
 示例：
 
@@ -28,7 +28,7 @@ const formOpts = formOptions({
 
 ## 表单实例 (Form Instance)
 
-表单实例是一个表示单个表单的对象，提供了操作表单的方法和属性。您可以通过表单选项提供的 `useForm` 钩子创建表单实例。该钩子接受一个包含 `onSubmit` 函数的对象，该函数在表单提交时被调用。
+表单实例 (Form Instance) 是一个表示单个表单的对象，提供了操作表单的方法和属性。您可以通过表单选项提供的 `useForm` 钩子创建表单实例。该钩子接受一个包含 `onSubmit` 函数的对象，该函数在表单提交时被调用。
 
 ```tsx
 const form = useForm({
@@ -61,7 +61,7 @@ const form = useForm({
 
 ## 字段 (Field)
 
-字段表示单个表单输入元素，例如文本输入框或复选框。字段通过表单实例提供的 `form.Field` 组件创建。该组件接受一个 `name` 属性，应与表单默认值中的键匹配。它还接受一个 `children` 属性，这是一个渲染函数，接收字段对象作为参数。
+字段 (Field) 表示单个表单输入元素，例如文本输入框或复选框。字段通过表单实例提供的 `form.Field` 组件创建。该组件接受一个 `name` 属性，应与表单默认值中的键匹配。它还接受一个 `children` 属性，这是一个渲染函数，接收字段对象作为参数。
 
 示例：
 
@@ -83,7 +83,7 @@ const form = useForm({
 
 ## 字段状态 (Field State)
 
-每个字段都有自己的状态，包括当前值、验证状态、错误消息和其他元数据。您可以通过 `field.state` 属性访问字段状态。
+每个字段都有自己的状态，包括当前值、验证状态、错误消息和其他元数据。您可以通过 `field.state` 属性访问字段的状态。
 
 示例：
 
@@ -94,7 +94,11 @@ const {
 } = field.state
 ```
 
-有三种字段状态可用于观察用户交互行为：当用户点击/聚焦字段时为 _"touched"_，用户未修改字段值为 _"pristine"_，修改字段值后为 _"dirty"_。您可以通过 `isTouched`、`isPristine` 和 `isDirty` 标志检查这些状态，如下所示。
+元数据中有三个状态可用于观察用户与字段的交互：
+
+- _"isTouched"_，用户点击/聚焦到字段后
+- _"isPristine"_，用户未更改字段值前
+- _"isDirty"_，字段值被更改后
 
 ```tsx
 const { isTouched, isPristine, isDirty } = field.state.meta
@@ -102,13 +106,32 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 
 ![字段状态](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states.png)
 
-> **对于从 `React Hook Form` 迁移的用户的重要提示**：`TanStack/form` 中的 `isDirty` 标志与 RHF 中的同名标志不同。
-> 在 RHF 中，当表单值与原始值不同时 `isDirty = true`。如果用户修改表单值后又改回与默认值相同的值，RHF 中的 `isDirty` 将为 `false`，但 `TanStack/form` 中仍为 `true`。
-> `TanStack/form` 在表单和字段级别都暴露了默认值 (`form.options.defaultValues`, `field.options.defaultValue`)，因此如果需要模拟 RHF 的行为，您可以编写自己的 `isDefaultValue()` 辅助函数。
+## 不同库中的 'isDirty' 理解
+
+非持久化 `dirty` 状态
+
+- **库**：React Hook Form (RHF)、Formik、Final Form
+- **行为**：字段值不同于默认值时标记为 'dirty'，恢复默认值后变为 'clean'
+
+持久化 `dirty` 状态
+
+- **库**：Angular Form、Vue FormKit
+- **行为**：字段一旦被更改，即使恢复默认值也保持 'dirty' 状态
+
+我们选择了持久化 'dirty' 状态模型。为了同时支持非持久化 'dirty' 状态，我们引入了 `isDefault` 标志。该标志作为非持久化 'dirty' 状态的反向标记。
+
+```tsx
+const { isTouched, isPristine, isDirty, isDefaultValue } = field.state.meta
+
+// 以下代码行将重现非持久化 `dirty` 功能
+const nonPersistentIsDirty = !isDefaultValue
+```
+
+![扩展字段状态](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states-extended.png)
 
 ## 字段 API (Field API)
 
-字段 API 是创建字段时传递给渲染函数的对象，提供了操作字段状态的方法。
+字段 API (Field API) 是创建字段时传递给渲染函数的对象，提供了操作字段状态的方法。
 
 示例：
 
@@ -122,7 +145,7 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 
 ## 验证 (Validation)
 
-`@tanstack/react-form` 内置支持同步和异步验证。验证函数可以通过 `validators` 属性传递给 `form.Field` 组件。
+`@tanstack/react-form` 提供了开箱即用的同步和异步验证功能。验证函数可以通过 `validators` 属性传递给 `form.Field` 组件。
 
 示例：
 
@@ -134,11 +157,11 @@ const { isTouched, isPristine, isDirty } = field.state.meta
       !value
         ? '必须填写名字'
         : value.length < 3
-          ? '名字至少需要 3 个字符'
+          ? '名字至少需要3个字符'
           : undefined,
     onChangeAsync: async ({ value }) => {
       await new Promise((resolve) => setTimeout(resolve, 1000))
-      return value.includes('error') && '名字中不能包含 "error"'
+      return value.includes('error') && '名字中不能包含"error"'
     },
   }}
   children={(field) => (
@@ -154,9 +177,9 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 />
 ```
 
-## 使用标准模式库验证 (Validation with Standard Schema Libraries)
+## 标准模式库验证 (Validation with Standard Schema Libraries)
 
-除了手动编写验证逻辑外，我们还支持 [Standard Schema](https://github.com/standard-schema/standard-schema) 规范。
+除了手动验证选项外，我们还支持 [Standard Schema](https://github.com/standard-schema/standard-schema) 规范。
 
 您可以使用任何实现该规范的库定义模式，并将其传递给表单或字段验证器。
 
@@ -170,7 +193,7 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 import { z } from 'zod'
 
 const userSchema = z.object({
-  age: z.number().gte(13, '必须年满 13 岁才能创建账户'),
+  age: z.number().gte(13, '必须年满13岁才能创建账户'),
 })
 
 function App() {
@@ -197,7 +220,7 @@ function App() {
 
 ## 响应式 (Reactivity)
 
-`@tanstack/react-form` 提供了多种订阅表单和字段状态变化的方式，最突出的是 `useStore(form.store)` 钩子和 `form.Subscribe` 组件。这些方法允许您通过仅在必要时更新组件来优化表单的渲染性能。
+`@tanstack/react-form` 提供了多种订阅表单和字段状态变化的方式，最显著的是 `useStore(form.store)` 钩子和 `form.Subscribe` 组件。这些方法允许您通过仅在必要时更新组件来优化表单的渲染性能。
 
 示例：
 
@@ -224,11 +247,11 @@ const errors = useStore(form.store, (state) => state.errorMap)
 const store = useStore(form.store)
 ```
 
-注意：不推荐使用 `useField` 钩子来实现响应式，因为它设计用于在 `form.Field` 组件内谨慎使用。您可能需要改用 `useStore(form.store)`。
+注意：不推荐使用 `useField` 钩子来实现响应式，因为它设计用于在 `form.Field` 组件内谨慎使用。您可能希望改用 `useStore(form.store)`。
 
 ## 监听器 (Listeners)
 
-`@tanstack/react-form` 允许您响应特定触发器并"监听"它们以派发副作用。
+`@tanstack/react-form` 允许您对特定触发器做出反应并"监听"它们以派发副作用。
 
 示例：
 
@@ -237,7 +260,7 @@ const store = useStore(form.store)
   name="country"
   listeners={{
     onChange: ({ value }) => {
-      console.log(`国家已更改为: ${value}, 重置省份`)
+      console.log(`国家更改为: ${value}, 重置省份`)
       form.setFieldValue('province', '')
     },
   }}
@@ -248,9 +271,9 @@ const store = useStore(form.store)
 
 ## 数组字段 (Array Fields)
 
-数组字段允许您管理表单中的值列表，例如爱好列表。您可以通过设置 `mode="array"` 属性的 `form.Field` 组件创建数组字段。
+数组字段允许您管理表单中的值列表，例如爱好列表。您可以通过带有 `mode="array"` 属性的 `form.Field` 组件创建数组字段。
 
-处理数组字段时，可以使用 `pushValue`、`removeValue`、`swapValues` 和 `moveValue` 方法来添加、删除和交换数组中的值。
+处理数组字段时，可以使用字段的 `pushValue`、`removeValue`、`swapValues` 和 `moveValue` 方法来添加、删除和交换数组中的值。
 
 示例：
 
@@ -263,7 +286,7 @@ const store = useStore(form.store)
       爱好
       <div>
         {!hobbiesField.state.value.length
-          ? '未找到爱好。'
+          ? '未找到爱好'
           : hobbiesField.state.value.map((_, i) => (
               <div key={i}>
                 <form.Field
@@ -360,4 +383,4 @@ const store = useStore(form.store)
 </button>
 ```
 
-以上是 `@tanstack/react-form` 库中使用的基本概念和术语。理解这些概念将帮助您更高效地使用该库，轻松创建复杂的表单。
+以上是 `@tanstack/react-form` 库中使用的基本概念和术语。理解这些概念将帮助您更有效地使用该库，轻松创建复杂的表单。
diff --git a/docs/zh-hans/reference/classes/fieldapi.md b/docs/zh-hans/reference/classes/fieldapi.md
index 684948869..09be5a23a 100644
--- a/docs/zh-hans/reference/classes/fieldapi.md
+++ b/docs/zh-hans/reference/classes/fieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:50:15.497Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.075Z'
 id: FieldApi
 title: FieldApi
 ---
@@ -9,7 +9,7 @@ title: FieldApi
 
 # Class: FieldApi\<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta\>
 
-Defined in: [packages/form-core/src/FieldApi.ts:859](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L859)
+Defined in: [packages/form-core/src/FieldApi.ts:863](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L863)
 
 A class representing the API for managing a form field.
 
@@ -67,7 +67,7 @@ the `new FieldApi` constructor.
 new FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>(opts): FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:991](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L991)
+Defined in: [packages/form-core/src/FieldApi.ts:995](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L995)
 
 Initializes a new `FieldApi` instance.
 
@@ -89,7 +89,7 @@ Initializes a new `FieldApi` instance.
 form: FormApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:903](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L903)
+Defined in: [packages/form-core/src/FieldApi.ts:907](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L907)
 
 A reference to the form API instance.
 
@@ -101,7 +101,7 @@ A reference to the form API instance.
 name: DeepKeys<TParentData>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:927](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L927)
+Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
 
 The field name.
 
@@ -113,7 +113,7 @@ The field name.
 options: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
+Defined in: [packages/form-core/src/FieldApi.ts:935](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L935)
 
 The field options.
 
@@ -125,7 +125,7 @@ The field options.
 store: Derived<FieldState<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:955](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L955)
+Defined in: [packages/form-core/src/FieldApi.ts:959](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L959)
 
 The field state store.
 
@@ -137,7 +137,7 @@ The field state store.
 timeoutIds: object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:982](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L982)
+Defined in: [packages/form-core/src/FieldApi.ts:986](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L986)
 
 #### formListeners
 
@@ -167,7 +167,7 @@ validations: Record<ValidationCause, null | Timeout>;
 get state(): FieldState<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:979](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L979)
+Defined in: [packages/form-core/src/FieldApi.ts:983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L983)
 
 The current field state.
 
@@ -183,7 +183,7 @@ The current field state.
 getInfo(): FieldInfo<TParentData>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1245](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1245)
+Defined in: [packages/form-core/src/FieldApi.ts:1249](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1249)
 
 Gets the field information object.
 
@@ -199,7 +199,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:1213](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1213)
+Defined in: [packages/form-core/src/FieldApi.ts:1217](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1217)
 
 #### Returns
 
@@ -213,7 +213,7 @@ Defined in: [packages/form-core/src/FieldApi.ts:1213](https://github.com/TanStac
 getValue(): TData
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1198](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1198)
+Defined in: [packages/form-core/src/FieldApi.ts:1202](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1202)
 
 Gets the current field value.
 
@@ -233,7 +233,7 @@ Use `field.state.value` instead.
 handleBlur(): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1657](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1657)
+Defined in: [packages/form-core/src/FieldApi.ts:1661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1661)
 
 Handles the blur event.
 
@@ -249,7 +249,7 @@ Handles the blur event.
 handleChange(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1650](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1650)
+Defined in: [packages/form-core/src/FieldApi.ts:1654](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1654)
 
 Handles the change event.
 
@@ -274,7 +274,7 @@ insertValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1262](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1262)
+Defined in: [packages/form-core/src/FieldApi.ts:1266](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1266)
 
 Inserts a value at the specified index, shifting the subsequent values to the right.
 
@@ -304,7 +304,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:1088](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1088)
+Defined in: [packages/form-core/src/FieldApi.ts:1092](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1092)
 
 Mounts the field instance to the form.
 
@@ -327,7 +327,7 @@ moveValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1306](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1306)
+Defined in: [packages/form-core/src/FieldApi.ts:1310](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1310)
 
 Moves the value at the first specified index to the second specified index.
 
@@ -359,7 +359,7 @@ parseValueWithSchema(schema):
   | StandardSchemaV1Issue[]
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1699](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1699)
+Defined in: [packages/form-core/src/FieldApi.ts:1703](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1703)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -387,7 +387,7 @@ parseValueWithSchemaAsync(schema): Promise<
 | StandardSchemaV1Issue[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1711](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1711)
+Defined in: [packages/form-core/src/FieldApi.ts:1715](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1715)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -414,7 +414,7 @@ The standard schema to parse this field's value with.
 pushValue(value, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1250](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1250)
+Defined in: [packages/form-core/src/FieldApi.ts:1254](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1254)
 
 Pushes a new value to the field.
 
@@ -440,7 +440,7 @@ Pushes a new value to the field.
 removeValue(index, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1288](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1288)
+Defined in: [packages/form-core/src/FieldApi.ts:1292](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1292)
 
 Removes a value at the specified index.
 
@@ -469,7 +469,7 @@ replaceValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1275](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1275)
+Defined in: [packages/form-core/src/FieldApi.ts:1279](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1279)
 
 Replaces a value at the specified index.
 
@@ -499,7 +499,7 @@ Replaces a value at the specified index.
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1674](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1674)
+Defined in: [packages/form-core/src/FieldApi.ts:1678](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1678)
 
 Updates the field's errorMap
 
@@ -521,7 +521,7 @@ Updates the field's errorMap
 setMeta(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1218](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1218)
+Defined in: [packages/form-core/src/FieldApi.ts:1222](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1222)
 
 Sets the field metadata.
 
@@ -543,7 +543,7 @@ Sets the field metadata.
 setValue(updater, options?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1205](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1205)
+Defined in: [packages/form-core/src/FieldApi.ts:1209](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1209)
 
 Sets the field value and run the `change` validator.
 
@@ -572,7 +572,7 @@ swapValues(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1297](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1297)
+Defined in: [packages/form-core/src/FieldApi.ts:1301](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1301)
 
 Swaps the values at the specified indices.
 
@@ -602,7 +602,7 @@ Swaps the values at the specified indices.
 update(opts): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1141](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1141)
+Defined in: [packages/form-core/src/FieldApi.ts:1145](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1145)
 
 Updates the field instance with new options.
 
@@ -624,7 +624,7 @@ Updates the field instance with new options.
 validate(cause, opts?): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1617](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1617)
+Defined in: [packages/form-core/src/FieldApi.ts:1621](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1621)
 
 Validates the field value.
 
diff --git a/docs/zh-hans/reference/classes/formapi.md b/docs/zh-hans/reference/classes/formapi.md
index b82af867d..4ecc68165 100644
--- a/docs/zh-hans/reference/classes/formapi.md
+++ b/docs/zh-hans/reference/classes/formapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:50:15.492Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.071Z'
 id: FormApi
 title: FormApi
 ---
@@ -9,7 +9,7 @@ title: FormApi
 
 # Class: FormApi\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta\>
 
-Defined in: [packages/form-core/src/FormApi.ts:767](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L767)
+Defined in: [packages/form-core/src/FormApi.ts:771](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L771)
 
 A class representing the Form API. It handles the logic and interactions with the form state.
 
@@ -47,7 +47,7 @@ However, if you need to create a new instance manually, you can do so by calling
 new FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>(opts?): FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:838](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L838)
+Defined in: [packages/form-core/src/FormApi.ts:842](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L842)
 
 Constructs a new `FormApi` instance with the given form options.
 
@@ -69,7 +69,7 @@ Constructs a new `FormApi` instance with the given form options.
 baseStore: Store<BaseFormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L794)
+Defined in: [packages/form-core/src/FormApi.ts:798](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L798)
 
 ***
 
@@ -79,7 +79,7 @@ Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/
 fieldInfo: Record<DeepKeys<TFormData>, FieldInfo<TFormData>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:824](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L824)
+Defined in: [packages/form-core/src/FormApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L828)
 
 A record of field information for each field in the form.
 
@@ -91,7 +91,7 @@ A record of field information for each field in the form.
 fieldMetaDerived: Derived<Record<DeepKeys<TFormData>, AnyFieldMeta>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L807)
+Defined in: [packages/form-core/src/FormApi.ts:811](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L811)
 
 ***
 
@@ -101,7 +101,7 @@ Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/
 options: FormOptions<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta> = {};
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:782](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L782)
+Defined in: [packages/form-core/src/FormApi.ts:786](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L786)
 
 The options for the form.
 
@@ -113,7 +113,7 @@ The options for the form.
 store: Derived<FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L808)
+Defined in: [packages/form-core/src/FormApi.ts:812](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L812)
 
 ## Accessors
 
@@ -125,7 +125,7 @@ Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/
 get state(): FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L826)
+Defined in: [packages/form-core/src/FormApi.ts:830](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L830)
 
 ##### Returns
 
@@ -139,7 +139,7 @@ Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/
 deleteField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1912)
+Defined in: [packages/form-core/src/FormApi.ts:1938](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1938)
 
 #### Type Parameters
 
@@ -163,7 +163,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack
 getAllErrors(): object
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2148](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2148)
+Defined in: [packages/form-core/src/FormApi.ts:2174](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2174)
 
 Returns form and field level errors
 
@@ -214,7 +214,7 @@ errors: (
 getFieldInfo<TField>(field): FieldInfo<TFormData>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1826)
+Defined in: [packages/form-core/src/FormApi.ts:1852](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1852)
 
 Gets the field info of the specified field.
 
@@ -240,7 +240,7 @@ Gets the field info of the specified field.
 getFieldMeta<TField>(field): undefined | AnyFieldMeta
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1817](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1817)
+Defined in: [packages/form-core/src/FormApi.ts:1843](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1843)
 
 Gets the metadata of the specified field.
 
@@ -266,7 +266,7 @@ Gets the metadata of the specified field.
 getFieldValue<TField>(field): DeepValue<TFormData, TField>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1810](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1810)
+Defined in: [packages/form-core/src/FormApi.ts:1836](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1836)
 
 Gets the value of the specified field.
 
@@ -294,7 +294,7 @@ Gets the value of the specified field.
 handleSubmit(): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1712](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1712)
+Defined in: [packages/form-core/src/FormApi.ts:1738](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1738)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -308,7 +308,7 @@ Handles the form submission, performs validation, and calls the appropriate onSu
 handleSubmit(submitMeta): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1713](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1713)
+Defined in: [packages/form-core/src/FormApi.ts:1739](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1739)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -334,7 +334,7 @@ insertFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1951)
+Defined in: [packages/form-core/src/FormApi.ts:1977](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1977)
 
 #### Type Parameters
 
@@ -370,7 +370,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack
 mount(): () => void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1142](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1142)
+Defined in: [packages/form-core/src/FormApi.ts:1168](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1168)
 
 #### Returns
 
@@ -392,7 +392,7 @@ moveFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2075](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2075)
+Defined in: [packages/form-core/src/FormApi.ts:2101](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2101)
 
 Moves the value at the first specified index to the second specified index within an array field.
 
@@ -435,7 +435,7 @@ parseValuesWithSchema(schema):
 }
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2208](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2208)
+Defined in: [packages/form-core/src/FormApi.ts:2234](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2234)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -469,7 +469,7 @@ parseValuesWithSchemaAsync(schema): Promise<
 }>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2220](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2220)
+Defined in: [packages/form-core/src/FormApi.ts:2246](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2246)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -502,7 +502,7 @@ pushFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1936](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1936)
+Defined in: [packages/form-core/src/FormApi.ts:1962](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1962)
 
 Pushes a value into an array field.
 
@@ -539,7 +539,7 @@ removeFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
+Defined in: [packages/form-core/src/FormApi.ts:2035](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2035)
 
 Removes a value from an array field at the specified index.
 
@@ -577,7 +577,7 @@ replaceFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1983)
+Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
 
 Replaces a value into an array field at the specified index.
 
@@ -615,7 +615,7 @@ Replaces a value into an array field at the specified index.
 reset(values?, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1230](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1230)
+Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
 
 Resets the form state to the default values.
 If values are provided, the form will be reset to those values instead and the default values will be updated.
@@ -648,7 +648,7 @@ Optional options to control the reset behavior.
 resetField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2103](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2103)
+Defined in: [packages/form-core/src/FormApi.ts:2129](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2129)
 
 Resets the field value and meta to default state
 
@@ -674,7 +674,7 @@ Resets the field value and meta to default state
 resetFieldMeta<TField>(fieldMeta): Record<TField, AnyFieldMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1866](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1866)
+Defined in: [packages/form-core/src/FormApi.ts:1892](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1892)
 
 resets every field's meta
 
@@ -700,7 +700,7 @@ resets every field's meta
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2124](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2124)
+Defined in: [packages/form-core/src/FormApi.ts:2150](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2150)
 
 Updates the form's errorMap
 
@@ -722,7 +722,7 @@ Updates the form's errorMap
 setFieldMeta<TField>(field, updater): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1845](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1845)
+Defined in: [packages/form-core/src/FormApi.ts:1871](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1871)
 
 Updates the metadata of the specified field.
 
@@ -755,7 +755,7 @@ setFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1882](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1882)
+Defined in: [packages/form-core/src/FormApi.ts:1908](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1908)
 
 Sets the value of the specified field and optionally updates the touched state.
 
@@ -793,7 +793,7 @@ swapFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2046](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2046)
+Defined in: [packages/form-core/src/FormApi.ts:2072](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2072)
 
 Swaps the values at the specified indices within an array field.
 
@@ -831,7 +831,7 @@ Swaps the values at the specified indices within an array field.
 update(options?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1162](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1162)
+Defined in: [packages/form-core/src/FormApi.ts:1188](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1188)
 
 Updates the form options and form state.
 
@@ -853,7 +853,7 @@ Updates the form options and form state.
 validateAllFields(cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
+Defined in: [packages/form-core/src/FormApi.ts:1282](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1282)
 
 Validates all fields using the correct handlers for a given validation cause.
 
@@ -878,7 +878,7 @@ validateArrayFieldsStartingFrom<TField>(
 cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1286](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1286)
+Defined in: [packages/form-core/src/FormApi.ts:1312](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1312)
 
 Validates the children of a specified array in the form starting from a given index until the end using the correct handlers for a given validation type.
 
@@ -912,7 +912,7 @@ Validates the children of a specified array in the form starting from a given in
 validateField<TField>(field, cause): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1325](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1325)
+Defined in: [packages/form-core/src/FormApi.ts:1351](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1351)
 
 Validates a specified field in the form using the correct handlers for a given validation type.
 
diff --git a/docs/zh-hans/reference/functions/evaluate.md b/docs/zh-hans/reference/functions/evaluate.md
new file mode 100644
index 000000000..2658535f3
--- /dev/null
+++ b/docs/zh-hans/reference/functions/evaluate.md
@@ -0,0 +1,34 @@
+---
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.068Z'
+id: evaluate
+title: evaluate
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: evaluate()
+
+```ts
+function evaluate<T>(objA, objB): boolean
+```
+
+Defined in: [packages/form-core/src/utils.ts:339](https://github.com/TanStack/form/blob/main/packages/form-core/src/utils.ts#L339)
+
+## Type Parameters
+
+• **T**
+
+## Parameters
+
+### objA
+
+`T`
+
+### objB
+
+`T`
+
+## Returns
+
+`boolean`
diff --git a/docs/zh-hans/reference/index.md b/docs/zh-hans/reference/index.md
index dd487500a..5dd84ea35 100644
--- a/docs/zh-hans/reference/index.md
+++ b/docs/zh-hans/reference/index.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-25T12:58:29.000Z'
-translation-updated-at: '2025-04-30T22:53:22.296Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.019Z'
 id: '@tanstack/form-core'
 title: '@tanstack/form-core'
 ---
@@ -84,8 +84,8 @@ title: '@tanstack/form-core'
 
 ## Functions
 
+- [evaluate](functions/evaluate.md)
 - [formOptions](functions/formoptions.md)
 - [isGlobalFormValidationError](functions/isglobalformvalidationerror.md)
 - [isStandardSchemaValidator](functions/isstandardschemavalidator.md)
 - [mergeForm](functions/mergeform.md)
-- [shallow](functions/shallow.md)
diff --git a/docs/zh-hans/reference/interfaces/formstate.md b/docs/zh-hans/reference/interfaces/formstate.md
index 9647ae6f4..7bc7f6858 100644
--- a/docs/zh-hans/reference/interfaces/formstate.md
+++ b/docs/zh-hans/reference/interfaces/formstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:16:46.695Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.024Z'
 id: FormState
 title: FormState
 ---
@@ -9,7 +9,7 @@ title: FormState
 
 # Interface: FormState\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer\>
 
-Defined in: [packages/form-core/src/FormApi.ts:643](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L643)
+Defined in: [packages/form-core/src/FormApi.ts:647](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L647)
 
 An object representing the current state of the form.
 
@@ -63,7 +63,7 @@ BaseFormState._force_re_eval
 canSubmit: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
+Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
 
 A boolean indicating if the form can be submitted based on its current state.
 
@@ -125,7 +125,7 @@ DerivedFormState.errors
 fieldMeta: Record<DeepKeys<TFormData>, AnyFieldMeta>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
+Defined in: [packages/form-core/src/FormApi.ts:644](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L644)
 
 A record of field metadata for each field in the form.
 
@@ -173,6 +173,24 @@ DerivedFormState.isBlurred
 
 ***
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+
+A boolean indicating if all of the form's fields are the same as default values.
+
+#### Inherited from
+
+```ts
+DerivedFormState.isDefaultValue
+```
+
+***
+
 ### isDirty
 
 ```ts
@@ -371,7 +389,7 @@ DerivedFormState.isTouched
 isValid: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
 
 A boolean indicating if the form and all its fields are valid. Evaluates `true` if there are no errors.
 
diff --git a/docs/zh-hans/reference/type-aliases/anyfieldapi.md b/docs/zh-hans/reference/type-aliases/anyfieldapi.md
index 1e4b3f957..eebef2563 100644
--- a/docs/zh-hans/reference/type-aliases/anyfieldapi.md
+++ b/docs/zh-hans/reference/type-aliases/anyfieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:16:46.653Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.064Z'
 id: AnyFieldApi
 title: AnyFieldApi
 ---
@@ -13,6 +13,6 @@ title: AnyFieldApi
 type AnyFieldApi = FieldApi<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L828)
+Defined in: [packages/form-core/src/FieldApi.ts:832](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L832)
 
 A type representing the Field API with all generics set to `any` for convenience.
diff --git a/docs/zh-hans/reference/type-aliases/anyfieldmeta.md b/docs/zh-hans/reference/type-aliases/anyfieldmeta.md
index 05ef88eab..62cd77a72 100644
--- a/docs/zh-hans/reference/type-aliases/anyfieldmeta.md
+++ b/docs/zh-hans/reference/type-aliases/anyfieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:16:46.649Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.057Z'
 id: AnyFieldMeta
 title: AnyFieldMeta
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMeta
 type AnyFieldMeta = FieldMeta<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L747)
+Defined in: [packages/form-core/src/FieldApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L751)
diff --git a/docs/zh-hans/reference/type-aliases/anyfieldmetaderived.md b/docs/zh-hans/reference/type-aliases/anyfieldmetaderived.md
index f45bbd4c6..7c029210d 100644
--- a/docs/zh-hans/reference/type-aliases/anyfieldmetaderived.md
+++ b/docs/zh-hans/reference/type-aliases/anyfieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:16:46.638Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.053Z'
 id: AnyFieldMetaDerived
 title: AnyFieldMetaDerived
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMetaDerived
 type AnyFieldMetaDerived = FieldMetaDerived<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L661)
+Defined in: [packages/form-core/src/FieldApi.ts:665](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L665)
diff --git a/docs/zh-hans/reference/type-aliases/anyformapi.md b/docs/zh-hans/reference/type-aliases/anyformapi.md
index cf11566cc..5781eb98b 100644
--- a/docs/zh-hans/reference/type-aliases/anyformapi.md
+++ b/docs/zh-hans/reference/type-aliases/anyformapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:16:46.634Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.049Z'
 id: AnyFormApi
 title: AnyFormApi
 ---
@@ -13,6 +13,6 @@ title: AnyFormApi
 type AnyFormApi = FormApi<any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L747)
+Defined in: [packages/form-core/src/FormApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L751)
 
 A type representing the Form API with all generics set to `any` for convenience.
diff --git a/docs/zh-hans/reference/type-aliases/anyformstate.md b/docs/zh-hans/reference/type-aliases/anyformstate.md
index adda55b1e..d0f9ea255 100644
--- a/docs/zh-hans/reference/type-aliases/anyformstate.md
+++ b/docs/zh-hans/reference/type-aliases/anyformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:16:46.630Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.045Z'
 id: AnyFormState
 title: AnyFormState
 ---
@@ -13,4 +13,4 @@ title: AnyFormState
 type AnyFormState = FormState<any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:676](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L676)
+Defined in: [packages/form-core/src/FormApi.ts:680](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L680)
diff --git a/docs/zh-hans/reference/type-aliases/derivedformstate.md b/docs/zh-hans/reference/type-aliases/derivedformstate.md
index 792c4d553..83a8f6de6 100644
--- a/docs/zh-hans/reference/type-aliases/derivedformstate.md
+++ b/docs/zh-hans/reference/type-aliases/derivedformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:25:38.743Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.040Z'
 id: DerivedFormState
 title: DerivedFormState
 ---
@@ -77,6 +77,14 @@ isBlurred: boolean;
 
 A boolean indicating if any of the form fields have been blurred.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A boolean indicating if all of the form's fields are the same as default values.
+
 ### isDirty
 
 ```ts
diff --git a/docs/zh-hans/reference/type-aliases/fieldmeta.md b/docs/zh-hans/reference/type-aliases/fieldmeta.md
index 0cc454b78..2545b18f5 100644
--- a/docs/zh-hans/reference/type-aliases/fieldmeta.md
+++ b/docs/zh-hans/reference/type-aliases/fieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:25:38.635Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.036Z'
 id: FieldMeta
 title: FieldMeta
 ---
@@ -13,7 +13,7 @@ title: FieldMeta
 type FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = FieldMetaBase<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> & FieldMetaDerived<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:684](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L684)
+Defined in: [packages/form-core/src/FieldApi.ts:688](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L688)
 
 An object type representing the metadata of a field in a form.
 
diff --git a/docs/zh-hans/reference/type-aliases/fieldmetaderived.md b/docs/zh-hans/reference/type-aliases/fieldmetaderived.md
index 83bae8b5a..5f7ab9f87 100644
--- a/docs/zh-hans/reference/type-aliases/fieldmetaderived.md
+++ b/docs/zh-hans/reference/type-aliases/fieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:16:46.586Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.032Z'
 id: FieldMetaDerived
 title: FieldMetaDerived
 ---
@@ -68,6 +68,14 @@ errors: (
 
 An array of errors related to the field value.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A flag indicating whether the field's current value is the default value
+
 ### isPristine
 
 ```ts
diff --git a/docs/zh-hans/reference/type-aliases/fieldstate.md b/docs/zh-hans/reference/type-aliases/fieldstate.md
index 6e125e350..9966ea288 100644
--- a/docs/zh-hans/reference/type-aliases/fieldstate.md
+++ b/docs/zh-hans/reference/type-aliases/fieldstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:25:38.672Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:40:36.028Z'
 id: FieldState
 title: FieldState
 ---
@@ -13,7 +13,7 @@ title: FieldState
 type FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:770](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L770)
+Defined in: [packages/form-core/src/FieldApi.ts:774](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L774)
 
 An object type representing the state of a field.
 
diff --git a/docs/zh-hant/framework/react/guides/basic-concepts.md b/docs/zh-hant/framework/react/guides/basic-concepts.md
index 8e6389cce..033447cfe 100644
--- a/docs/zh-hant/framework/react/guides/basic-concepts.md
+++ b/docs/zh-hant/framework/react/guides/basic-concepts.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-16T08:45:06.000Z'
-translation-updated-at: '2025-04-25T20:33:31.771Z'
+source-updated-at: '2025-05-08T07:42:29.000Z'
+translation-updated-at: '2025-05-08T23:43:48.828Z'
 id: basic-concepts
 title: 基本概念
 ---
@@ -9,7 +9,7 @@ title: 基本概念
 
 ## 表單選項 (Form Options)
 
-您可以使用 `formOptions` 函式建立表單選項，以便在多個表單間共享設定。
+您可以使用 `formOptions` 函式建立表單選項，以便在多個表單之間共享配置。
 
 範例：
 
@@ -28,7 +28,7 @@ const formOpts = formOptions({
 
 ## 表單實例 (Form Instance)
 
-表單實例是一個代表單一表單的物件，提供操作表單的方法與屬性。您可透過表單選項提供的 `useForm` 鉤子來建立表單實例。此鉤子接受包含 `onSubmit` 函式的物件，該函式會在表單提交時被呼叫。
+表單實例是一個代表個別表單的物件，提供操作表單的方法與屬性。您可以使用表單選項提供的 `useForm` 鉤子 (hook) 來建立表單實例。此鉤子接受包含 `onSubmit` 函式的物件，該函式會在表單提交時被呼叫。
 
 ```tsx
 const form = useForm({
@@ -61,7 +61,7 @@ const form = useForm({
 
 ## 欄位 (Field)
 
-欄位代表單一表單輸入元素，例如文字輸入框或核取方塊。欄位是透過表單實例提供的 `form.Field` 元件來建立。此元件接受 `name` 屬性，需與表單預設值中的鍵名匹配，以及 `children` 屬性（這是一個接收欄位物件作為參數的渲染函式）。
+欄位代表單一表單輸入元素，例如文字輸入框或核取方塊。欄位是透過表單實例提供的 `form.Field` 元件建立的。此元件接受 `name` 屬性，應與表單預設值中的鍵名相符。同時也接受 `children` 屬性，這是一個渲染函式 (render prop)，接收欄位物件作為參數。
 
 範例：
 
@@ -83,7 +83,7 @@ const form = useForm({
 
 ## 欄位狀態 (Field State)
 
-每個欄位都有自身的狀態，包含當前值、驗證狀態、錯誤訊息及其他元資料。您可透過 `field.state` 屬性存取欄位狀態。
+每個欄位都有自己的狀態，包含當前值、驗證狀態、錯誤訊息及其他元資料。您可以透過 `field.state` 屬性存取欄位狀態。
 
 範例：
 
@@ -94,7 +94,11 @@ const {
 } = field.state
 ```
 
-有三種欄位狀態有助於觀察使用者互動：當使用者點擊/切換至欄位時為「已觸碰 _(touched)_」、使用者未改變值前為「原始狀態 _(pristine)_」、值變更後則為「已修改 _(dirty)_」。可透過以下標誌檢查這些狀態：
+在元資料中有三個狀態對於觀察使用者與欄位的互動特別有用：
+
+- _"isTouched"_：當使用者點擊/切換到該欄位後
+- _"isPristine"_：直到使用者改變欄位值之前
+- _"isDirty"_：當欄位值被改變後
 
 ```tsx
 const { isTouched, isPristine, isDirty } = field.state.meta
@@ -102,13 +106,32 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 
 ![欄位狀態](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states.png)
 
-> **給從 `React Hook Form` 轉換的使用者重要提示**：`TanStack/form` 中的 `isDirty` 標誌與 RHF 中同名的標誌意義不同。
-> 在 RHF 中，當表單值與原始值不同時 `isDirty = true`。若使用者修改表單值後又改回與預設值相同，RHF 的 `isDirty` 會是 `false`，但在 `TanStack/form` 中會是 `true`。
-> `TanStack/form` 同時在表單與欄位層級暴露預設值 (`form.options.defaultValues`, `field.options.defaultValue`)，因此若需模擬 RHF 的行為，您可以自行編寫 `isDefaultValue()` 輔助函式。
+## 理解不同函式庫中的 'isDirty'
+
+非持久性 `dirty` 狀態
+
+- **函式庫**：React Hook Form (RHF)、Formik、Final Form。
+- **行為**：當欄位值與預設值不同時視為 'dirty'。若恢復為預設值則變回 'clean'。
+
+持久性 `dirty` 狀態
+
+- **函式庫**：Angular Form、Vue FormKit。
+- **行為**：欄位一旦被改變即保持 'dirty' 狀態，即使恢復為預設值。
+
+我們選擇採用持久性 'dirty' 狀態模型。為了同時支援非持久性 'dirty' 狀態，我們引入了 `isDefault` 標記。此標記可作為非持久性 'dirty' 狀態的反向指標。
+
+```tsx
+const { isTouched, isPristine, isDirty, isDefaultValue } = field.state.meta
+
+// 以下程式碼可重現非持久性 `dirty` 功能
+const nonPersistentIsDirty = !isDefaultValue
+```
+
+![延伸欄位狀態](https://raw.githubusercontent.com/TanStack/form/main/docs/assets/field-states-extended.png)
 
 ## 欄位 API (Field API)
 
-欄位 API 是建立欄位時傳遞給渲染函式的物件，提供操作欄位狀態的方法。
+欄位 API 是在建立欄位時傳遞給渲染函式的物件，提供操作欄位狀態的方法。
 
 範例：
 
@@ -122,7 +145,7 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 
 ## 驗證 (Validation)
 
-`@tanstack/react-form` 原生支援同步與非同步驗證。驗證函式可透過 `validators` 屬性傳遞給 `form.Field` 元件。
+`@tanstack/react-form` 提供同步與非同步驗證功能。驗證函式可透過 `validators` 屬性傳遞給 `form.Field` 元件。
 
 範例：
 
@@ -134,11 +157,11 @@ const { isTouched, isPristine, isDirty } = field.state.meta
       !value
         ? '必須填寫名字'
         : value.length < 3
-          ? '名字至少需 3 個字元'
+          ? '名字至少需要 3 個字元'
           : undefined,
     onChangeAsync: async ({ value }) => {
       await new Promise((resolve) => setTimeout(resolve, 1000))
-      return value.includes('error') && '名字中不得包含 "error"'
+      return value.includes('error') && '名字中不能包含 "error"'
     },
   }}
   children={(field) => (
@@ -156,9 +179,9 @@ const { isTouched, isPristine, isDirty } = field.state.meta
 
 ## 使用標準結構描述函式庫驗證 (Validation with Standard Schema Libraries)
 
-除了手動驗證選項外，我們也支援 [Standard Schema](https://github.com/standard-schema/standard-schema) 規範。
+除了手動編寫驗證選項外，我們也支援 [Standard Schema](https://github.com/standard-schema/standard-schema) 規範。
 
-您可以使用任何實作此規範的函式庫定義結構描述，並將其傳遞給表單或欄位驗證器。
+您可以使用任何實現此規範的函式庫定義結構描述 (schema)，並將其傳遞給表單或欄位驗證器。
 
 支援的函式庫包括：
 
@@ -197,7 +220,7 @@ function App() {
 
 ## 響應式 (Reactivity)
 
-`@tanstack/react-form` 提供多種訂閱表單與欄位狀態變更的方式，最顯著的是 `useStore(form.store)` 鉤子與 `form.Subscribe` 元件。這些方法讓您能透過僅在必要時更新元件來優化表單渲染效能。
+`@tanstack/react-form` 提供多種訂閱表單與欄位狀態變更的方式，最值得注意的是 `useStore(form.store)` 鉤子與 `form.Subscribe` 元件。這些方法讓您可以最佳化表單的渲染效能，只在必要時更新元件。
 
 範例：
 
@@ -214,7 +237,7 @@ const firstName = useStore(form.store, (state) => state.values.firstName)
 />
 ```
 
-需特別注意，雖然 `useStore` 鉤子的 `selector` 屬性是可選的，但強烈建議提供此參數，因為省略它會導致不必要的重新渲染。
+請注意，雖然 `useStore` 鉤子的 `selector` 屬性是選填的，但強烈建議提供此屬性，因為省略它會導致不必要的重新渲染。
 
 ```tsx
 // 正確用法
@@ -224,11 +247,11 @@ const errors = useStore(form.store, (state) => state.errorMap)
 const store = useStore(form.store)
 ```
 
-注意：不建議使用 `useField` 鉤子來實現響應式，因為它設計上是供 `form.Field` 元件內部謹慎使用的。您應考慮改用 `useStore(form.store)`。
+注意：不建議使用 `useField` 鉤子來實現響應式功能，因為它設計上是為了在 `form.Field` 元件中謹慎使用。您應該考慮改用 `useStore(form.store)`。
 
 ## 監聽器 (Listeners)
 
-`@tanstack/react-form` 允許您對特定觸發事件作出反應並「監聽」它們以執行副作用。
+`@tanstack/react-form` 允許您對特定觸發事件做出反應並「監聽」這些事件以執行副作用。
 
 範例：
 
@@ -237,7 +260,7 @@ const store = useStore(form.store)
   name="country"
   listeners={{
     onChange: ({ value }) => {
-      console.log(`國家已變更為: ${value}, 重置省份選項`)
+      console.log(`國家已變更為：${value}，正在重設省份`)
       form.setFieldValue('province', '')
     },
   }}
@@ -248,9 +271,9 @@ const store = useStore(form.store)
 
 ## 陣列欄位 (Array Fields)
 
-陣列欄位讓您能管理表單中的值列表，例如興趣愛好清單。您可透過 `form.Field` 元件加上 `mode="array"` 屬性來建立陣列欄位。
+陣列欄位讓您能管理表單中的值列表，例如興趣愛好清單。您可以使用 `form.Field` 元件並設定 `mode="array"` 屬性來建立陣列欄位。
 
-操作陣列欄位時，可使用欄位的 `pushValue`、`removeValue`、`swapValues` 和 `moveValue` 方法來新增、移除與交換陣列中的值。
+操作陣列欄位時，可以使用欄位的 `pushValue`、`removeValue`、`swapValues` 和 `moveValue` 方法來新增、刪除和交換陣列中的值。
 
 範例：
 
@@ -263,7 +286,7 @@ const store = useStore(form.store)
       興趣愛好
       <div>
         {!hobbiesField.state.value.length
-          ? '尚未新增任何興趣愛好。'
+          ? '沒有找到興趣愛好。'
           : hobbiesField.state.value.map((_, i) => (
               <div key={i}>
                 <form.Field
@@ -321,7 +344,7 @@ const store = useStore(form.store)
           })
         }
       >
-        新增興趣愛好
+        新增興趣
       </button>
     </div>
   )}
@@ -330,7 +353,7 @@ const store = useStore(form.store)
 
 ## 重設按鈕 (Reset Buttons)
 
-當結合使用 `<button type="reset">` 與 TanStack Form 的 `form.reset()` 時，需阻止預設的 HTML 重設行為，以避免表單元素（特別是 `<select>` 元素）意外重設至初始 HTML 值。在按鈕的 `onClick` 處理程序中使用 `event.preventDefault()` 來阻止原生表單重設。
+當在 TanStack Form 中使用 `<button type="reset">` 與 `form.reset()` 時，您需要阻止預設的 HTML 重設行為，以避免表單元素（特別是 `<select>` 元素）意外重設為其初始 HTML 值。在按鈕的 `onClick` 處理程式中使用 `event.preventDefault()` 來阻止原生表單重設。
 
 範例：
 
@@ -346,7 +369,7 @@ const store = useStore(form.store)
 </button>
 ```
 
-或者，您可以使用 `<button type="button">` 來避免原生 HTML 重設行為。
+或者，您也可以使用 `<button type="button">` 來避免原生的 HTML 重設行為。
 
 ```tsx
 <button
@@ -359,4 +382,4 @@ const store = useStore(form.store)
 </button>
 ```
 
-以上是 `@tanstack/react-form` 函式庫中使用的基本概念與術語。理解這些概念將幫助您更有效率地運用此函式庫，輕鬆建立複雜的表單。
+以上是 `@tanstack/react-form` 函式庫中使用的基本概念與術語。理解這些概念將幫助您更有效地運用此函式庫，輕鬆建立複雜的表單。
diff --git a/docs/zh-hant/reference/classes/fieldapi.md b/docs/zh-hant/reference/classes/fieldapi.md
index 0c811f432..d75deb7d9 100644
--- a/docs/zh-hant/reference/classes/fieldapi.md
+++ b/docs/zh-hant/reference/classes/fieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:50:40.401Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.414Z'
 id: FieldApi
 title: FieldApi
 ---
@@ -9,7 +9,7 @@ title: FieldApi
 
 # Class: FieldApi\<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta\>
 
-Defined in: [packages/form-core/src/FieldApi.ts:859](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L859)
+Defined in: [packages/form-core/src/FieldApi.ts:863](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L863)
 
 A class representing the API for managing a form field.
 
@@ -67,7 +67,7 @@ the `new FieldApi` constructor.
 new FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>(opts): FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:991](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L991)
+Defined in: [packages/form-core/src/FieldApi.ts:995](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L995)
 
 Initializes a new `FieldApi` instance.
 
@@ -89,7 +89,7 @@ Initializes a new `FieldApi` instance.
 form: FormApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:903](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L903)
+Defined in: [packages/form-core/src/FieldApi.ts:907](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L907)
 
 A reference to the form API instance.
 
@@ -101,7 +101,7 @@ A reference to the form API instance.
 name: DeepKeys<TParentData>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:927](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L927)
+Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
 
 The field name.
 
@@ -113,7 +113,7 @@ The field name.
 options: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer, TParentSubmitMeta>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:931](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L931)
+Defined in: [packages/form-core/src/FieldApi.ts:935](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L935)
 
 The field options.
 
@@ -125,7 +125,7 @@ The field options.
 store: Derived<FieldState<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:955](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L955)
+Defined in: [packages/form-core/src/FieldApi.ts:959](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L959)
 
 The field state store.
 
@@ -137,7 +137,7 @@ The field state store.
 timeoutIds: object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:982](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L982)
+Defined in: [packages/form-core/src/FieldApi.ts:986](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L986)
 
 #### formListeners
 
@@ -167,7 +167,7 @@ validations: Record<ValidationCause, null | Timeout>;
 get state(): FieldState<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:979](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L979)
+Defined in: [packages/form-core/src/FieldApi.ts:983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L983)
 
 The current field state.
 
@@ -183,7 +183,7 @@ The current field state.
 getInfo(): FieldInfo<TParentData>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1245](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1245)
+Defined in: [packages/form-core/src/FieldApi.ts:1249](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1249)
 
 Gets the field information object.
 
@@ -199,7 +199,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:1213](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1213)
+Defined in: [packages/form-core/src/FieldApi.ts:1217](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1217)
 
 #### Returns
 
@@ -213,7 +213,7 @@ Defined in: [packages/form-core/src/FieldApi.ts:1213](https://github.com/TanStac
 getValue(): TData
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1198](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1198)
+Defined in: [packages/form-core/src/FieldApi.ts:1202](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1202)
 
 Gets the current field value.
 
@@ -233,7 +233,7 @@ Use `field.state.value` instead.
 handleBlur(): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1657](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1657)
+Defined in: [packages/form-core/src/FieldApi.ts:1661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1661)
 
 Handles the blur event.
 
@@ -249,7 +249,7 @@ Handles the blur event.
 handleChange(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1650](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1650)
+Defined in: [packages/form-core/src/FieldApi.ts:1654](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1654)
 
 Handles the change event.
 
@@ -274,7 +274,7 @@ insertValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1262](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1262)
+Defined in: [packages/form-core/src/FieldApi.ts:1266](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1266)
 
 Inserts a value at the specified index, shifting the subsequent values to the right.
 
@@ -304,7 +304,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:1088](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1088)
+Defined in: [packages/form-core/src/FieldApi.ts:1092](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1092)
 
 Mounts the field instance to the form.
 
@@ -327,7 +327,7 @@ moveValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1306](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1306)
+Defined in: [packages/form-core/src/FieldApi.ts:1310](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1310)
 
 Moves the value at the first specified index to the second specified index.
 
@@ -359,7 +359,7 @@ parseValueWithSchema(schema):
   | StandardSchemaV1Issue[]
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1699](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1699)
+Defined in: [packages/form-core/src/FieldApi.ts:1703](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1703)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -387,7 +387,7 @@ parseValueWithSchemaAsync(schema): Promise<
 | StandardSchemaV1Issue[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1711](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1711)
+Defined in: [packages/form-core/src/FieldApi.ts:1715](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1715)
 
 Parses the field's value with the given schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -414,7 +414,7 @@ The standard schema to parse this field's value with.
 pushValue(value, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1250](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1250)
+Defined in: [packages/form-core/src/FieldApi.ts:1254](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1254)
 
 Pushes a new value to the field.
 
@@ -440,7 +440,7 @@ Pushes a new value to the field.
 removeValue(index, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1288](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1288)
+Defined in: [packages/form-core/src/FieldApi.ts:1292](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1292)
 
 Removes a value at the specified index.
 
@@ -469,7 +469,7 @@ replaceValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1275](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1275)
+Defined in: [packages/form-core/src/FieldApi.ts:1279](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1279)
 
 Replaces a value at the specified index.
 
@@ -499,7 +499,7 @@ Replaces a value at the specified index.
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1674](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1674)
+Defined in: [packages/form-core/src/FieldApi.ts:1678](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1678)
 
 Updates the field's errorMap
 
@@ -521,7 +521,7 @@ Updates the field's errorMap
 setMeta(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1218](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1218)
+Defined in: [packages/form-core/src/FieldApi.ts:1222](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1222)
 
 Sets the field metadata.
 
@@ -543,7 +543,7 @@ Sets the field metadata.
 setValue(updater, options?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1205](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1205)
+Defined in: [packages/form-core/src/FieldApi.ts:1209](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1209)
 
 Sets the field value and run the `change` validator.
 
@@ -572,7 +572,7 @@ swapValues(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1297](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1297)
+Defined in: [packages/form-core/src/FieldApi.ts:1301](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1301)
 
 Swaps the values at the specified indices.
 
@@ -602,7 +602,7 @@ Swaps the values at the specified indices.
 update(opts): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1141](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1141)
+Defined in: [packages/form-core/src/FieldApi.ts:1145](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1145)
 
 Updates the field instance with new options.
 
@@ -624,7 +624,7 @@ Updates the field instance with new options.
 validate(cause, opts?): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1617](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1617)
+Defined in: [packages/form-core/src/FieldApi.ts:1621](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1621)
 
 Validates the field value.
 
diff --git a/docs/zh-hant/reference/classes/formapi.md b/docs/zh-hant/reference/classes/formapi.md
index ce0c296dc..3a68efc15 100644
--- a/docs/zh-hant/reference/classes/formapi.md
+++ b/docs/zh-hant/reference/classes/formapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-05-06T20:51:58.000Z'
-translation-updated-at: '2025-05-06T22:50:40.396Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.411Z'
 id: FormApi
 title: FormApi
 ---
@@ -9,7 +9,7 @@ title: FormApi
 
 # Class: FormApi\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta\>
 
-Defined in: [packages/form-core/src/FormApi.ts:767](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L767)
+Defined in: [packages/form-core/src/FormApi.ts:771](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L771)
 
 A class representing the Form API. It handles the logic and interactions with the form state.
 
@@ -47,7 +47,7 @@ However, if you need to create a new instance manually, you can do so by calling
 new FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>(opts?): FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:838](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L838)
+Defined in: [packages/form-core/src/FormApi.ts:842](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L842)
 
 Constructs a new `FormApi` instance with the given form options.
 
@@ -69,7 +69,7 @@ Constructs a new `FormApi` instance with the given form options.
 baseStore: Store<BaseFormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L794)
+Defined in: [packages/form-core/src/FormApi.ts:798](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L798)
 
 ***
 
@@ -79,7 +79,7 @@ Defined in: [packages/form-core/src/FormApi.ts:794](https://github.com/TanStack/
 fieldInfo: Record<DeepKeys<TFormData>, FieldInfo<TFormData>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:824](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L824)
+Defined in: [packages/form-core/src/FormApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L828)
 
 A record of field information for each field in the form.
 
@@ -91,7 +91,7 @@ A record of field information for each field in the form.
 fieldMetaDerived: Derived<Record<DeepKeys<TFormData>, AnyFieldMeta>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L807)
+Defined in: [packages/form-core/src/FormApi.ts:811](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L811)
 
 ***
 
@@ -101,7 +101,7 @@ Defined in: [packages/form-core/src/FormApi.ts:807](https://github.com/TanStack/
 options: FormOptions<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta> = {};
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:782](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L782)
+Defined in: [packages/form-core/src/FormApi.ts:786](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L786)
 
 The options for the form.
 
@@ -113,7 +113,7 @@ The options for the form.
 store: Derived<FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L808)
+Defined in: [packages/form-core/src/FormApi.ts:812](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L812)
 
 ## Accessors
 
@@ -125,7 +125,7 @@ Defined in: [packages/form-core/src/FormApi.ts:808](https://github.com/TanStack/
 get state(): FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L826)
+Defined in: [packages/form-core/src/FormApi.ts:830](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L830)
 
 ##### Returns
 
@@ -139,7 +139,7 @@ Defined in: [packages/form-core/src/FormApi.ts:826](https://github.com/TanStack/
 deleteField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1912)
+Defined in: [packages/form-core/src/FormApi.ts:1938](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1938)
 
 #### Type Parameters
 
@@ -163,7 +163,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1912](https://github.com/TanStack
 getAllErrors(): object
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2148](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2148)
+Defined in: [packages/form-core/src/FormApi.ts:2174](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2174)
 
 Returns form and field level errors
 
@@ -214,7 +214,7 @@ errors: (
 getFieldInfo<TField>(field): FieldInfo<TFormData>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1826](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1826)
+Defined in: [packages/form-core/src/FormApi.ts:1852](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1852)
 
 Gets the field info of the specified field.
 
@@ -240,7 +240,7 @@ Gets the field info of the specified field.
 getFieldMeta<TField>(field): undefined | AnyFieldMeta
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1817](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1817)
+Defined in: [packages/form-core/src/FormApi.ts:1843](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1843)
 
 Gets the metadata of the specified field.
 
@@ -266,7 +266,7 @@ Gets the metadata of the specified field.
 getFieldValue<TField>(field): DeepValue<TFormData, TField>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1810](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1810)
+Defined in: [packages/form-core/src/FormApi.ts:1836](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1836)
 
 Gets the value of the specified field.
 
@@ -294,7 +294,7 @@ Gets the value of the specified field.
 handleSubmit(): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1712](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1712)
+Defined in: [packages/form-core/src/FormApi.ts:1738](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1738)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -308,7 +308,7 @@ Handles the form submission, performs validation, and calls the appropriate onSu
 handleSubmit(submitMeta): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1713](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1713)
+Defined in: [packages/form-core/src/FormApi.ts:1739](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1739)
 
 Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.
 
@@ -334,7 +334,7 @@ insertFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1951)
+Defined in: [packages/form-core/src/FormApi.ts:1977](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1977)
 
 #### Type Parameters
 
@@ -370,7 +370,7 @@ Defined in: [packages/form-core/src/FormApi.ts:1951](https://github.com/TanStack
 mount(): () => void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1142](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1142)
+Defined in: [packages/form-core/src/FormApi.ts:1168](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1168)
 
 #### Returns
 
@@ -392,7 +392,7 @@ moveFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2075](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2075)
+Defined in: [packages/form-core/src/FormApi.ts:2101](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2101)
 
 Moves the value at the first specified index to the second specified index within an array field.
 
@@ -435,7 +435,7 @@ parseValuesWithSchema(schema):
 }
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2208](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2208)
+Defined in: [packages/form-core/src/FormApi.ts:2234](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2234)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -469,7 +469,7 @@ parseValuesWithSchemaAsync(schema): Promise<
 }>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2220](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2220)
+Defined in: [packages/form-core/src/FormApi.ts:2246](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2246)
 
 Parses the form's values with a given standard schema and returns
 issues (if any). This method does NOT set any internal errors.
@@ -502,7 +502,7 @@ pushFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1936](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1936)
+Defined in: [packages/form-core/src/FormApi.ts:1962](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1962)
 
 Pushes a value into an array field.
 
@@ -539,7 +539,7 @@ removeFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
+Defined in: [packages/form-core/src/FormApi.ts:2035](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2035)
 
 Removes a value from an array field at the specified index.
 
@@ -577,7 +577,7 @@ replaceFieldValue<TField>(
 opts?): Promise<void>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1983](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1983)
+Defined in: [packages/form-core/src/FormApi.ts:2009](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2009)
 
 Replaces a value into an array field at the specified index.
 
@@ -615,7 +615,7 @@ Replaces a value into an array field at the specified index.
 reset(values?, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1230](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1230)
+Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
 
 Resets the form state to the default values.
 If values are provided, the form will be reset to those values instead and the default values will be updated.
@@ -648,7 +648,7 @@ Optional options to control the reset behavior.
 resetField<TField>(field): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2103](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2103)
+Defined in: [packages/form-core/src/FormApi.ts:2129](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2129)
 
 Resets the field value and meta to default state
 
@@ -674,7 +674,7 @@ Resets the field value and meta to default state
 resetFieldMeta<TField>(fieldMeta): Record<TField, AnyFieldMeta>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1866](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1866)
+Defined in: [packages/form-core/src/FormApi.ts:1892](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1892)
 
 resets every field's meta
 
@@ -700,7 +700,7 @@ resets every field's meta
 setErrorMap(errorMap): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2124](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2124)
+Defined in: [packages/form-core/src/FormApi.ts:2150](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2150)
 
 Updates the form's errorMap
 
@@ -722,7 +722,7 @@ Updates the form's errorMap
 setFieldMeta<TField>(field, updater): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1845](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1845)
+Defined in: [packages/form-core/src/FormApi.ts:1871](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1871)
 
 Updates the metadata of the specified field.
 
@@ -755,7 +755,7 @@ setFieldValue<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1882](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1882)
+Defined in: [packages/form-core/src/FormApi.ts:1908](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1908)
 
 Sets the value of the specified field and optionally updates the touched state.
 
@@ -793,7 +793,7 @@ swapFieldValues<TField>(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:2046](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2046)
+Defined in: [packages/form-core/src/FormApi.ts:2072](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L2072)
 
 Swaps the values at the specified indices within an array field.
 
@@ -831,7 +831,7 @@ Swaps the values at the specified indices within an array field.
 update(options?): void
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1162](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1162)
+Defined in: [packages/form-core/src/FormApi.ts:1188](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1188)
 
 Updates the form options and form state.
 
@@ -853,7 +853,7 @@ Updates the form options and form state.
 validateAllFields(cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1256](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1256)
+Defined in: [packages/form-core/src/FormApi.ts:1282](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1282)
 
 Validates all fields using the correct handlers for a given validation cause.
 
@@ -878,7 +878,7 @@ validateArrayFieldsStartingFrom<TField>(
 cause): Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1286](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1286)
+Defined in: [packages/form-core/src/FormApi.ts:1312](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1312)
 
 Validates the children of a specified array in the form starting from a given index until the end using the correct handlers for a given validation type.
 
@@ -912,7 +912,7 @@ Validates the children of a specified array in the form starting from a given in
 validateField<TField>(field, cause): unknown[] | Promise<unknown[]>
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:1325](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1325)
+Defined in: [packages/form-core/src/FormApi.ts:1351](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L1351)
 
 Validates a specified field in the form using the correct handlers for a given validation type.
 
diff --git a/docs/zh-hant/reference/functions/evaluate.md b/docs/zh-hant/reference/functions/evaluate.md
new file mode 100644
index 000000000..6a686cd6c
--- /dev/null
+++ b/docs/zh-hant/reference/functions/evaluate.md
@@ -0,0 +1,34 @@
+---
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.407Z'
+id: evaluate
+title: evaluate
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: evaluate()
+
+```ts
+function evaluate<T>(objA, objB): boolean
+```
+
+Defined in: [packages/form-core/src/utils.ts:339](https://github.com/TanStack/form/blob/main/packages/form-core/src/utils.ts#L339)
+
+## Type Parameters
+
+• **T**
+
+## Parameters
+
+### objA
+
+`T`
+
+### objB
+
+`T`
+
+## Returns
+
+`boolean`
diff --git a/docs/zh-hant/reference/index.md b/docs/zh-hant/reference/index.md
index 2129d335b..5631cef55 100644
--- a/docs/zh-hant/reference/index.md
+++ b/docs/zh-hant/reference/index.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-25T12:58:29.000Z'
-translation-updated-at: '2025-04-30T22:41:29.558Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.362Z'
 id: '@tanstack/form-core'
 title: '@tanstack/form-core'
 ---
@@ -84,8 +84,8 @@ title: '@tanstack/form-core'
 
 ## Functions
 
+- [evaluate](functions/evaluate.md)
 - [formOptions](functions/formoptions.md)
 - [isGlobalFormValidationError](functions/isglobalformvalidationerror.md)
 - [isStandardSchemaValidator](functions/isstandardschemavalidator.md)
 - [mergeForm](functions/mergeform.md)
-- [shallow](functions/shallow.md)
diff --git a/docs/zh-hant/reference/interfaces/formstate.md b/docs/zh-hant/reference/interfaces/formstate.md
index cdc4a764b..b909a277d 100644
--- a/docs/zh-hant/reference/interfaces/formstate.md
+++ b/docs/zh-hant/reference/interfaces/formstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:17:25.852Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.366Z'
 id: FormState
 title: FormState
 ---
@@ -9,7 +9,7 @@ title: FormState
 
 # Interface: FormState\<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer\>
 
-Defined in: [packages/form-core/src/FormApi.ts:643](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L643)
+Defined in: [packages/form-core/src/FormApi.ts:647](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L647)
 
 An object representing the current state of the form.
 
@@ -63,7 +63,7 @@ BaseFormState._force_re_eval
 canSubmit: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
+Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
 
 A boolean indicating if the form can be submitted based on its current state.
 
@@ -125,7 +125,7 @@ DerivedFormState.errors
 fieldMeta: Record<DeepKeys<TFormData>, AnyFieldMeta>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:640](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L640)
+Defined in: [packages/form-core/src/FormApi.ts:644](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L644)
 
 A record of field metadata for each field in the form.
 
@@ -173,6 +173,24 @@ DerivedFormState.isBlurred
 
 ***
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+
+A boolean indicating if all of the form's fields are the same as default values.
+
+#### Inherited from
+
+```ts
+DerivedFormState.isDefaultValue
+```
+
+***
+
 ### isDirty
 
 ```ts
@@ -371,7 +389,7 @@ DerivedFormState.isTouched
 isValid: boolean;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:632](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L632)
+Defined in: [packages/form-core/src/FormApi.ts:636](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L636)
 
 A boolean indicating if the form and all its fields are valid. Evaluates `true` if there are no errors.
 
diff --git a/docs/zh-hant/reference/type-aliases/anyfieldapi.md b/docs/zh-hant/reference/type-aliases/anyfieldapi.md
index 53bc44f2a..6d0e02c5a 100644
--- a/docs/zh-hant/reference/type-aliases/anyfieldapi.md
+++ b/docs/zh-hant/reference/type-aliases/anyfieldapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:17:26.009Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.403Z'
 id: AnyFieldApi
 title: AnyFieldApi
 ---
@@ -13,6 +13,6 @@ title: AnyFieldApi
 type AnyFieldApi = FieldApi<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:828](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L828)
+Defined in: [packages/form-core/src/FieldApi.ts:832](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L832)
 
 A type representing the Field API with all generics set to `any` for convenience.
diff --git a/docs/zh-hant/reference/type-aliases/anyfieldmeta.md b/docs/zh-hant/reference/type-aliases/anyfieldmeta.md
index c621e537f..97bfdec18 100644
--- a/docs/zh-hant/reference/type-aliases/anyfieldmeta.md
+++ b/docs/zh-hant/reference/type-aliases/anyfieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:17:26.003Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.396Z'
 id: AnyFieldMeta
 title: AnyFieldMeta
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMeta
 type AnyFieldMeta = FieldMeta<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L747)
+Defined in: [packages/form-core/src/FieldApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L751)
diff --git a/docs/zh-hant/reference/type-aliases/anyfieldmetaderived.md b/docs/zh-hant/reference/type-aliases/anyfieldmetaderived.md
index fb4e16467..a0546487c 100644
--- a/docs/zh-hant/reference/type-aliases/anyfieldmetaderived.md
+++ b/docs/zh-hant/reference/type-aliases/anyfieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:17:25.995Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.393Z'
 id: AnyFieldMetaDerived
 title: AnyFieldMetaDerived
 ---
@@ -13,4 +13,4 @@ title: AnyFieldMetaDerived
 type AnyFieldMetaDerived = FieldMetaDerived<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:661](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L661)
+Defined in: [packages/form-core/src/FieldApi.ts:665](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L665)
diff --git a/docs/zh-hant/reference/type-aliases/anyformapi.md b/docs/zh-hant/reference/type-aliases/anyformapi.md
index b53fdc9ec..84271919c 100644
--- a/docs/zh-hant/reference/type-aliases/anyformapi.md
+++ b/docs/zh-hant/reference/type-aliases/anyformapi.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:17:25.991Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.389Z'
 id: AnyFormApi
 title: AnyFormApi
 ---
@@ -13,6 +13,6 @@ title: AnyFormApi
 type AnyFormApi = FormApi<any, any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:747](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L747)
+Defined in: [packages/form-core/src/FormApi.ts:751](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L751)
 
 A type representing the Form API with all generics set to `any` for convenience.
diff --git a/docs/zh-hant/reference/type-aliases/anyformstate.md b/docs/zh-hant/reference/type-aliases/anyformstate.md
index b7117cdb6..47c026c55 100644
--- a/docs/zh-hant/reference/type-aliases/anyformstate.md
+++ b/docs/zh-hant/reference/type-aliases/anyformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-27T15:56:02.000Z'
-translation-updated-at: '2025-05-06T20:17:25.987Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.385Z'
 id: AnyFormState
 title: AnyFormState
 ---
@@ -13,4 +13,4 @@ title: AnyFormState
 type AnyFormState = FormState<any, any, any, any, any, any, any, any, any>;
 ```
 
-Defined in: [packages/form-core/src/FormApi.ts:676](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L676)
+Defined in: [packages/form-core/src/FormApi.ts:680](https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L680)
diff --git a/docs/zh-hant/reference/type-aliases/derivedformstate.md b/docs/zh-hant/reference/type-aliases/derivedformstate.md
index e20c366db..8b0b65261 100644
--- a/docs/zh-hant/reference/type-aliases/derivedformstate.md
+++ b/docs/zh-hant/reference/type-aliases/derivedformstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:30.437Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.381Z'
 id: DerivedFormState
 title: DerivedFormState
 ---
@@ -77,6 +77,14 @@ isBlurred: boolean;
 
 A boolean indicating if any of the form fields have been blurred.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A boolean indicating if all of the form's fields are the same as default values.
+
 ### isDirty
 
 ```ts
diff --git a/docs/zh-hant/reference/type-aliases/fieldmeta.md b/docs/zh-hant/reference/type-aliases/fieldmeta.md
index 554611aa5..1176d9126 100644
--- a/docs/zh-hant/reference/type-aliases/fieldmeta.md
+++ b/docs/zh-hant/reference/type-aliases/fieldmeta.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:30.294Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.377Z'
 id: FieldMeta
 title: FieldMeta
 ---
@@ -13,7 +13,7 @@ title: FieldMeta
 type FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = FieldMetaBase<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> & FieldMetaDerived<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:684](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L684)
+Defined in: [packages/form-core/src/FieldApi.ts:688](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L688)
 
 An object type representing the metadata of a field in a form.
 
diff --git a/docs/zh-hant/reference/type-aliases/fieldmetaderived.md b/docs/zh-hant/reference/type-aliases/fieldmetaderived.md
index 5a9ea9b4a..f3788dd48 100644
--- a/docs/zh-hant/reference/type-aliases/fieldmetaderived.md
+++ b/docs/zh-hant/reference/type-aliases/fieldmetaderived.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-05-06T20:17:25.947Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.373Z'
 id: FieldMetaDerived
 title: FieldMetaDerived
 ---
@@ -68,6 +68,14 @@ errors: (
 
 An array of errors related to the field value.
 
+### isDefaultValue
+
+```ts
+isDefaultValue: boolean;
+```
+
+A flag indicating whether the field's current value is the default value
+
 ### isPristine
 
 ```ts
diff --git a/docs/zh-hant/reference/type-aliases/fieldstate.md b/docs/zh-hant/reference/type-aliases/fieldstate.md
index 079303580..293263beb 100644
--- a/docs/zh-hant/reference/type-aliases/fieldstate.md
+++ b/docs/zh-hant/reference/type-aliases/fieldstate.md
@@ -1,6 +1,6 @@
 ---
-source-updated-at: '2025-04-29T10:22:55.000Z'
-translation-updated-at: '2025-04-30T22:41:30.329Z'
+source-updated-at: '2025-05-08T07:43:38.000Z'
+translation-updated-at: '2025-05-08T23:42:09.370Z'
 id: FieldState
 title: FieldState
 ---
@@ -13,7 +13,7 @@ title: FieldState
 type FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> = object;
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:770](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L770)
+Defined in: [packages/form-core/src/FieldApi.ts:774](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L774)
 
 An object type representing the state of a field.