Open History to see the last commit
1# @tanstack/react-form
2β
3## 2.0.0-alpha.3
4β
5### Major Changes
6β
7- Release the first alpha of TanStack Form v2.
8β
9### Minor Changes
10β
11- Feature: Specify default options for `createFormHook`
12β
13- Add default form, field, and form group options to `createFormHook`.
14β
15- [#2426](https://github.com/TanStack/form/pull/2426) [`395d61c`](https://github.com/TanStack/form/commit/395d61ccec8ed6d7ee75b0e00e6196909e866cb7) - BREAKING: `schemaOutputs` no longer exists. It is superceded by `validatorOutputs`. This is only a name change, the schema's result is the same as before
16β
17 `validatorOutputs` now allows a callback validator to specify data that the submit function should know. Schemas do this
18 automatically, but now you can do it manually as well:
19 `run: ({ createOutput }) => createOutput('This is not a validation error and onSubmit can use this')`
20β
21 The current map is:
22β
23 | Validator | `onSubmit: ({ validatorOutputs }) => ...` |
24 | -------------------------- | ----------------------------------------- |
25 | Schema | Schema's output data |
26 | `createOutput(X)` | `X` |
27 | Default callback validator | `undefined` |
28 | Validation error | N/A, `onSubmit` doesn't run |
29β
30- [#2365](https://github.com/TanStack/form/pull/2365) [`f8bbc25`](https://github.com/TanStack/form/commit/f8bbc25affcf5560b1da0c9c357fd62ef2108dd9) - Feat: Field groups may now omit identity bindings like `fields={{ a: 'a' }}`
31β
32- [#2369](https://github.com/TanStack/form/pull/2369) [`28c693f`](https://github.com/TanStack/form/commit/28c693fdeccd4efcbbdbf68c76db05dd5b3b4be8) - Feat: Field and Form components can now be nested to create namespaces.
33β
34### Patch Changes
35β
36- Refactor: Adapter `formOptions`/`appFormOptions` no longer shim the core types and runtime.
37β
38 BREAKING: `formOptions.looseSchema` and `formOptions.strictSchema` now require a schema as
39 first parameter. This locks down inference to get the best type safety out of it vs. the options object alone.
40β
41 Fix: `formOptions.looseSchema` now allows `defaultValues` to omit properties instead of
42 requiring them to be explicitly undefined.
43β
44- Fix: Subscription selectors now infer tuple return values without requiring `as const`.
45β
46- [#2434](https://github.com/TanStack/form/pull/2434) [`fceed8a`](https://github.com/TanStack/form/commit/fceed8a15888a7d9d8bbfaceeae6efeeb02779c2) - Provide the field context inside App Form `ArrayField`, so registered field components render there instead of throwing.
47- Updated dependencies [[`584fcd9`](https://github.com/TanStack/form/commit/584fcd960a02590fe17a56fdd0648c50a5d584d6), [`a679245`](https://github.com/TanStack/form/commit/a679245889285779747444c2e64de5473aacc4db), [`395d61c`](https://github.com/TanStack/form/commit/395d61ccec8ed6d7ee75b0e00e6196909e866cb7), [`f8bbc25`](https://github.com/TanStack/form/commit/f8bbc25affcf5560b1da0c9c357fd62ef2108dd9)]:
48 - @tanstack/form-core@2.0.0-alpha.3
49β
50## 2.0.0-alpha.2
51β
52### Minor Changes
53β
54- [#2343](https://github.com/TanStack/form/pull/2343) [`532cba4`](https://github.com/TanStack/form/commit/532cba44680609577f75020918cdf264dadf51dd) - Feature: Specify default options for `createFormHook`
55β
56### Patch Changes
57β
58- [#2348](https://github.com/TanStack/form/pull/2348) [`4e37c69`](https://github.com/TanStack/form/commit/4e37c69b8acc1428149ece979ffe2ba3190c15d3) - Refactor: Adapter `formOptions`/`appFormOptions` no longer shim the core types and runtime.
59β
60 BREAKING: `formOptions.looseSchema` and `formOptions.strictSchema` now require a schema as
61 first parameter. This locks down inference to get the best type safety out of it vs. the options object alone.
62β
63 Fix: `formOptions.looseSchema` now allows `defaultValues` to omit properties instead of
64 requiring them to be explicitly undefined.
65β
66- [#2339](https://github.com/TanStack/form/pull/2339) [`c7e102b`](https://github.com/TanStack/form/commit/c7e102bcf134b12a402d6f80f6c3c63ce377a1e9) - Fix: Subscription selectors now infer tuple return values without requiring `as const`.
67β
68- Updated dependencies [[`532cba4`](https://github.com/TanStack/form/commit/532cba44680609577f75020918cdf264dadf51dd), [`4e37c69`](https://github.com/TanStack/form/commit/4e37c69b8acc1428149ece979ffe2ba3190c15d3), [`c7e102b`](https://github.com/TanStack/form/commit/c7e102bcf134b12a402d6f80f6c3c63ce377a1e9), [`63c9ea3`](https://github.com/TanStack/form/commit/63c9ea32b4efa95897e42a729406b89e0e92a708)]:
69 - @tanstack/form-core@2.0.0-alpha.2
70β
71## 2.0.0-alpha.1
72β
73### Minor Changes
74β
75- [#2336](https://github.com/TanStack/form/pull/2336) [`2ebad6a`](https://github.com/TanStack/form/commit/2ebad6a45dc2b9dd129bb44e9131f0515a789617) - Add default form, field, and form group options to `createFormHook`.
76β
77### Patch Changes
78β
79- Updated dependencies [[`547cbea`](https://github.com/TanStack/form/commit/547cbea2eebeb0b9ec8a6e9141d35fbf4d963429), [`46c12c7`](https://github.com/TanStack/form/commit/46c12c773932c0e7c89a2deb9c4aadd747973348), [`4341660`](https://github.com/TanStack/form/commit/43416603987c14a2c9435ba367488068805589a6), [`fc424c0`](https://github.com/TanStack/form/commit/fc424c072197e70549460ca221c687562d138b9b)]:
80 - @tanstack/form-core@2.0.0-alpha.1
81β
82## 2.0.0-alpha.0
83β
84### Major Changes
85β
86- [#2288](https://github.com/TanStack/form/pull/2288) [`e68d53b`](https://github.com/TanStack/form/commit/e68d53b6882904f4606eae3481d11a0ca50ccd24) - Release the first alpha of TanStack Form v2.
87β
88### Patch Changes
89β
90- Updated dependencies [[`e68d53b`](https://github.com/TanStack/form/commit/e68d53b6882904f4606eae3481d11a0ca50ccd24)]:
91 - @tanstack/form-core@2.0.0-alpha.0
92β
93## 1.33.3
94β
95### Patch Changes
96β
97- Updated dependencies []:
98 - @tanstack/form-core@1.33.3
99β
100## 1.33.2
101β
102### Patch Changes
103β
104- [#2240](https://github.com/TanStack/form/pull/2240) [`d756476`](https://github.com/TanStack/form/commit/d756476b3ce5e6618a062b929a4a256fa0f4d683) - Use fresh FieldApi in current render on name change
105β
106- Updated dependencies []:
107 - @tanstack/form-core@1.33.2
108β
109## 1.33.1
110β
111### Patch Changes
112β
113- [#2206](https://github.com/TanStack/form/pull/2206) [`df52a12`](https://github.com/TanStack/form/commit/df52a12c8772cb025bfba6773c5ff0a488211662) - Re-export `useSelector` from TanStack Store adapters and document migration from deprecated `useStore` (fixes [#2203](https://github.com/TanStack/form/issues/2203)).
114β
115- Updated dependencies [[`3c57f6d`](https://github.com/TanStack/form/commit/3c57f6d4311f823ab39374417edb5fae544ad15a), [`7b3012b`](https://github.com/TanStack/form/commit/7b3012b03e706cc409c2952964145a11a300d7fe), [`741da6b`](https://github.com/TanStack/form/commit/741da6bb659a319acaa55292564999fcbbc90012), [`3c57f6d`](https://github.com/TanStack/form/commit/3c57f6d4311f823ab39374417edb5fae544ad15a), [`6cd477a`](https://github.com/TanStack/form/commit/6cd477a97df9612019d8a2d9c97f2e86b1b59256), [`887a129`](https://github.com/TanStack/form/commit/887a1293375a168452e82b0fb482841ec02ad77f)]:
116 - @tanstack/form-core@1.33.1
117β
118## 1.33.1
119β
120### Patch Changes
121β
122- Re-export `useSelector` from `@tanstack/react-store` (fixes [#2203](https://github.com/TanStack/form/issues/2203)). `useStore` remains available but is deprecated; prefer `import { useSelector } from '@tanstack/react-form'`.
123β
124## 1.33.0
125β
126### Minor Changes
127β
128- [#2128](https://github.com/TanStack/form/pull/2128) [`808f158`](https://github.com/TanStack/form/commit/808f158b62c08f69689a7b652c35989d717f9014) - Added FormGroup API
129β
130### Patch Changes
131β
132- Updated dependencies [[`808f158`](https://github.com/TanStack/form/commit/808f158b62c08f69689a7b652c35989d717f9014)]:
133 - @tanstack/form-core@1.33.0
134β
135## 1.32.1
136β
137### Patch Changes
138β
139- Updated dependencies [[`b402d7a`](https://github.com/TanStack/form/commit/b402d7ab134adca0d0d4647af12fde9b490c08f7), [`d0d941d`](https://github.com/TanStack/form/commit/d0d941dc1a4bd4ac15bb38a9ca1b4a863a3f418e)]:
140 - @tanstack/form-core@1.32.1
141β
142## 1.32.0
143β
144### Patch Changes
145β
146- re-render arrays when length doesn't change but values do ([#2172](https://github.com/TanStack/form/pull/2172))
147β
148- Updated dependencies [[`5dd1ed4`](https://github.com/TanStack/form/commit/5dd1ed4e9eb0fb9c3f8909dfb58236c07c27739d), [`556e35e`](https://github.com/TanStack/form/commit/556e35e30ad75f536ae253960a371c32ae138e29), [`427b3d9`](https://github.com/TanStack/form/commit/427b3d9fd516b8222339ae7e8e38844f198c5d7a), [`01f51b5`](https://github.com/TanStack/form/commit/01f51b54f551e1cb052b222652fbf6e05c9f2b44), [`4d250c0`](https://github.com/TanStack/form/commit/4d250c0c10433484ba6f622d94ca1a56bd0768d0)]:
149 - @tanstack/form-core@1.32.0
150β
151## 1.31.0
152β
153### Patch Changes
154β
155- Updated dependencies []:
156 - @tanstack/form-core@1.31.0
157β
158## 1.30.0
159β
160### Patch Changes
161β
162- Updated dependencies []:
163 - @tanstack/form-core@1.30.0
164β
165## 1.29.3
166β
167### Patch Changes
168β
169- Updated dependencies []:
170 - @tanstack/form-core@1.29.3
171β
172## 1.29.2
173β
174### Patch Changes
175β
176- Remove errant `Field.Field` usage and `useForm().useField()` ([`94f9841`](https://github.com/TanStack/form/commit/94f984161a8d4c5cb41aa37b61d63d5744ef01d5))
177β
178- Updated dependencies []:
179 - @tanstack/form-core@1.29.2
180β
181## 1.29.1
182β
183### Patch Changes
184β
185- Updated dependencies [[`6b8aa1e`](https://github.com/TanStack/form/commit/6b8aa1e92d883dfbdddbd5f0393a31d2e7120d3d)]:
186 - @tanstack/form-core@1.29.1
187β
188## 1.29.0
189β
190### Minor Changes
191β
192- Adds extension method to AppForm allowing for teams to extend upstream AppForms ([#2106](https://github.com/TanStack/form/pull/2106))
193β
194### Patch Changes
195β
196- Updated dependencies []:
197 - @tanstack/form-core@1.29.0
198β
199## 1.28.6
200β
201### Patch Changes
202β
203- fix(core): field unmount ([#2068](https://github.com/TanStack/form/pull/2068))
204β
205- Updated dependencies [[`7a1428d`](https://github.com/TanStack/form/commit/7a1428d6ce2806069b3d7b8f8b2aacc26315b771)]:
206 - @tanstack/form-core@1.28.6
207β
208## 1.28.5
209β
210### Patch Changes
211β
212- Reimplement fallback selector for Subscribe component ([#2071](https://github.com/TanStack/form/pull/2071))
213β
214- Use a named function for the `withForm` HOC return to enable Fast Refresh. ([#2067](https://github.com/TanStack/form/pull/2067))
215β
216- Updated dependencies [[`39932c1`](https://github.com/TanStack/form/commit/39932c1da28b5e4ea4b73f8b488d92fc100ccc41)]:
217 - @tanstack/form-core@1.28.5
218β
219## 1.28.4
220β
221### Patch Changes
222β
223- Refactor internals for substancially faster performance ([#2035](https://github.com/TanStack/form/pull/2035))
224β
225- Updated dependencies [[`f88faaf`](https://github.com/TanStack/form/commit/f88faaf72d265fdcbe99887421bd97dd03cb703e)]:
226 - @tanstack/form-core@1.28.4
227β
228## 1.28.3
229β
230### Patch Changes
231β
232- form arrays now work again ([#2041](https://github.com/TanStack/form/pull/2041))
233β
234- Updated dependencies [[`0b3952d`](https://github.com/TanStack/form/commit/0b3952d9805b4f1756829faa012e4112c14859a7)]:
235 - @tanstack/form-core@1.28.3
236β
237## 1.28.2
238β
239### Patch Changes
240β
241- Updated dependencies [[`a07862d`](https://github.com/TanStack/form/commit/a07862de23ea008c7dd3821edd880b6ebc569016)]:
242 - @tanstack/form-core@1.28.2
243β
244## 1.28.1
245β
246### Patch Changes
247β
248- Fix compile error with webpack when using react v17 ([#1982](https://github.com/TanStack/form/pull/1982))
249β
250- Fix various issues with SSR. Things should now work as-expected in many many more scenarios than before ([#1890](https://github.com/TanStack/form/pull/1890))
251β
252- Updated dependencies [[`72d970a`](https://github.com/TanStack/form/commit/72d970add6ab682d733e35a95e5e1f44efb695d2)]:
253 - @tanstack/form-core@1.28.1
254β
255## 1.28.0
256β
257### Minor Changes
258β
259- add `useTypedAppFormContext` ([#1826](https://github.com/TanStack/form/pull/1826))
260β
261### Patch Changes
262β
263- fix: flatten errors consistently when validating before field mount ([#2003](https://github.com/TanStack/form/pull/2003))
264β
265 Fixed an issue where `field.errors` was incorrectly nested as `[[error]]` instead of `[error]` when `form.validate()` was called manually before a field was mounted. The `flat(1)` operation is now applied by default unless `disableErrorFlat` is explicitly set to true, ensuring consistent error structure regardless of when validation occurs.
266β
267- Updated dependencies [[`41faffe`](https://github.com/TanStack/form/commit/41faffee657e753b37132275c2255d29fdd3f325), [`7f2453b`](https://github.com/TanStack/form/commit/7f2453baf8c852adfab2475fa3f110f597b24c52)]:
268 - @tanstack/form-core@1.28.0
269β
270## 1.27.7
271β
272### Patch Changes
273β
274- Updated dependencies [[`3519cce`](https://github.com/TanStack/form/commit/3519cce63072e87989bfa1b83b845e8d645d2725)]:
275 - @tanstack/form-core@1.27.7
276β
277## 1.27.6
278β
279### Patch Changes
280β
281- Updated dependencies [[`c526378`](https://github.com/TanStack/form/commit/c5263786ed8b12144837ddb87f43c87fa4efc2d4)]:
282 - @tanstack/form-core@1.27.6
283β
284## 1.27.5
285β
286### Patch Changes
287β
288- Updated dependencies [[`36fa503`](https://github.com/TanStack/form/commit/36fa503f21c59e68138a21de7038bf941a579b55), [`01b24a9`](https://github.com/TanStack/form/commit/01b24a9aa54f7d908830af352cacd51fddf65bbe)]:
289 - @tanstack/form-core@1.27.5
290β
291## 1.27.4
292β
293### Patch Changes
294β
295- fix(react-form): prevent array field re-render when child property changes ([#1930](https://github.com/TanStack/form/pull/1930))
296β
297 Array fields with `mode="array"` were incorrectly re-rendering when a property on any array element was mutated. This was a regression introduced in v1.27.0 by the React Compiler compatibility changes.
298β
299 The fix ensures that `mode="array"` fields only re-render when the array length changes (items added/removed), not when individual item properties are modified.
300β
301 Fixes #1925
302β
303- Updated dependencies [[`c753d5e`](https://github.com/TanStack/form/commit/c753d5eca5021c231bcdfd5f0a337156958fcde1)]:
304 - @tanstack/form-core@1.27.4
305β
306## 1.27.3
307β
308### Patch Changes
309β
310- Updated dependencies [[`c2ecf5d`](https://github.com/TanStack/form/commit/c2ecf5d6df0034d2db982f9b55aed963d94a76a3)]:
311 - @tanstack/form-core@1.27.3
312β
313## 1.27.2
314β
315### Patch Changes
316β
317- use React 18's useId hook by default for formId generation, only calling Math.random() as a fallback if no formId is provided. ([#1913](https://github.com/TanStack/form/pull/1913))
318β
319- fix(react-form): ensure `FormApi.handleSubmit` returns a promise again ([#1924](https://github.com/TanStack/form/pull/1924))
320β
321- Updated dependencies []:
322 - @tanstack/form-core@1.27.2
323β
324## 1.27.1
325β
326### Patch Changes
327β
328- Fix issues with methods not being present in React adapter ([#1903](https://github.com/TanStack/form/pull/1903))
329β
330- Updated dependencies [[`3b080ec`](https://github.com/TanStack/form/commit/3b080ec1faefa9894c0f73880dbff680888e6a9a)]:
331 - @tanstack/form-core@1.27.1
332β
333## 1.27.0
334β
335### Patch Changes
336β
337- Minorly improve performance and fix issues with Start ([#1882](https://github.com/TanStack/form/pull/1882))
338β
339- Fixed issues with React Compiler ([#1893](https://github.com/TanStack/form/pull/1893))
340β
341- Remove useId for react 17 user compatibility, replaced with uuid ([#1850](https://github.com/TanStack/form/pull/1850))
342β
343- Updated dependencies [[`8afbfc3`](https://github.com/TanStack/form/commit/8afbfc39d7373ec2b516f7c8ff5585ca44098cc1), [`4e92a91`](https://github.com/TanStack/form/commit/4e92a913e109f54463be572cdc3f09232e9d2701)]:
344 - @tanstack/form-core@1.27.0
345β
346## 1.26.0
347β
348### Patch Changes
349β
350- Updated dependencies [[`74f40e7`](https://github.com/TanStack/form/commit/74f40e7d0a862dcb4dbda3481b3a23482883a0a2)]:
351 - @tanstack/form-core@1.26.0
352β
353## 1.25.0
354β
355### Minor Changes
356β
357- Update Start to Release Candidate version. Extracted start, remix and nextJs adapters to the respective libraries @tanstack/react-form-start, @tanstack/react-form-remix, and @tanstack/react-form-nextjs, ([#1771](https://github.com/TanStack/form/pull/1771))
358β
359### Patch Changes
360β
361- Updated dependencies [[`004835f`](https://github.com/TanStack/form/commit/004835fbc113f36ac32fc5691ad27bc00813f389)]:
362 - @tanstack/form-core@1.25.0
363β
364## 1.23.9
365β
366### Patch Changes
367β
368- Updated dependencies [[`8ede6d0`](https://github.com/TanStack/form/commit/8ede6d0bb5615a105f54c13d3160d0243ea6c041)]:
369 - @tanstack/form-core@1.24.5
370β
371## 1.23.8
372β
373### Patch Changes
374β
375- Allow interfaces to be assigned to `withFieldGroup`'s `props`. ([#1816](https://github.com/TanStack/form/pull/1816))
376β
377- Allow returning all other `ReactNode`s not just `JSX.Element` in the `render` function of `withForm` and `withFieldGroup`. ([#1817](https://github.com/TanStack/form/pull/1817))
378β
379- form-core: Optimise event client emissions and minor layout tweaks ([#1758](https://github.com/TanStack/form/pull/1758))
380β
381- Updated dependencies [[`94631cb`](https://github.com/TanStack/form/commit/94631cb97dea611de69a900c89b7e8dfe0eeee37)]:
382 - @tanstack/form-core@1.24.4
383β
384## 1.23.7
385β
386### Patch Changes
387β
388- Updated dependencies [[`33cce81`](https://github.com/TanStack/form/commit/33cce812cbfeb42aa7457bab220a807ff5c4ba7f)]:
389 - @tanstack/form-core@1.24.3: respect dontValidate option in formApi array modifiers ([#1775](https://github.com/TanStack/form/pull/1775))
390β
391## 1.23.6
392β
393### Patch Changes
394β
395- Updated dependencies [[`74af33e`](https://github.com/TanStack/form/commit/74af33eb80218b8cec8642b64ce7e69a62a65248)]:
396 - @tanstack/form-core@1.24.2: prevent runtime errors when using `deleteField` ([#1706](https://github.com/TanStack/form/pull/1706))
397β
398## 1.23.5
399β
400### Patch Changes
401β
402- Updated dependencies [[`2cfe44c`](https://github.com/TanStack/form/commit/2cfe44ce1e35235ae37ee260dc943a94c9feb71d)]:
403 - @tanstack/form-core@1.24.1
404β
405## 1.23.4
406β
407### Patch Changes
408β
409- Updated dependencies [[`c978946`](https://github.com/TanStack/form/commit/c97894688c6f5f1953a87c26890e156ecb0bcaab)]:
410 - @tanstack/form-core@1.24.0
411β
412## 1.23.3
413β
414### Patch Changes
415β
416- Updated dependencies [[`f608267`](https://github.com/TanStack/form/commit/f6082674290a2ec5bc1d3ae33f193539ac7fc4b6)]:
417 - @tanstack/form-core@1.23.3
418β
419## 1.23.2
420β
421### Patch Changes
422β
423- Updated dependencies [[`7cf3728`](https://github.com/TanStack/form/commit/7cf3728a7b75e077802b427db2a387e36b23682a)]:
424 - @tanstack/form-core@1.23.2
425β
426## 1.23.1
427β
428### Patch Changes
429β
430- Updated dependencies [[`db96886`](https://github.com/TanStack/form/commit/db96886a8bf9d3d944bf09fc050b4c2c4b514851)]:
431 - @tanstack/form-core@1.23.1
432β
433## 1.23.0
434β
435### Patch Changes
436β
437- Updated dependencies [[`773c1b8`](https://github.com/TanStack/form/commit/773c1b8d9e1b82b5403633691de22f1a1e188d4f), [`1e36222`](https://github.com/TanStack/form/commit/1e362224d3086f67d8a49839d196edd7aa78c04d)]:
438 - @tanstack/form-core@1.23.0
439β
440## 1.21.1
441β
442### Patch Changes
443β
444- Updated dependencies [[`d2b6063`](https://github.com/TanStack/form/commit/d2b6063c0fc5406235f8be5462c19497717dfd0d)]:
445 - @tanstack/form-core@1.22.0