0
Fork 0
mirror of https://github.com/TanStack/form.git synced 2026-11-18 07:36:42 +00:00
Commit graph

207 commits

Author SHA1 Message Date
autofix-ci[bot]
7368d9eb41
ci: apply automated fixes and generate docs 2026-09-22 02:24:35 +00:00
Tanner Linsley
e066b93afa
docs(react): connect Start form workflow guidance (#2387) 2026-09-14 11:45:20 +02:00
Fabian Hiller
83944bfc21
docs: add Valibot examples to validation guide (#2324)
* docs: add Valibot example to validation guide

* ci: apply automated fixes and generate docs

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-08-11 22:21:39 +02:00
autofix-ci[bot]
b9c453934a
ci: apply automated fixes and generate docs 2026-07-13 04:10:50 +00:00
Sora Morimoto
42c866a336
fix(react-form-start): replace deprecated inputValidator with validator (#2230)
* fix(react-form-start): replace deprecated inputValidator with validator

TanStack Start has deprecated createServerFn().inputValidator() in favour
of .validator(). Update the react-form-start package, example, and SSR docs
accordingly, and bump the @tanstack/react-start peer dependency to ^1.168.27
where the new API is available.

* chore: fix pnpm lock

* fix: remove errant peerdeps

---------

Co-authored-by: Corbin Crutchley <git@crutchcorn.dev>
2026-07-09 03:15:04 -07:00
autofix-ci[bot]
c988753b5e
ci: apply automated fixes and generate docs 2026-07-09 09:58:26 +00:00
Hemraj bhatia
df52a12c87
fix: re-export useSelector and document useStore migration (#2206)
* fix: re-export useSelector and document useStore migration
Re-export useSelector from TanStack Store adapters so consumers can
import it from @tanstack/form packages instead of only the deprecated
useStore alias. Updates docs, examples, and adds form.useSelector for
Vue, Solid, and Svelte.
Fixes #2203

* docs(preact): use selector-form useSelector in prose

---------

Co-authored-by: Corbin Crutchley <git@crutchcorn.dev>
2026-07-09 02:54:09 -07:00
Patrick Wehbe
b730192a02
docs: correct withFieldGroup props runtime note (#2217)
The withFieldGroup props comment said the props are "not used at
runtime", but they are. In createFormHook the render call spreads them
(render({ ...props, ...innerProps, group })), so they act as default
values that innerProps can override, the same as withForm does with
render({ ...props, ...innerProps }). The withForm docs already describe
this correctly as default values, so this updates the react, solid and
preact copies to match.

Closes #2099

Co-authored-by: Patrick Wehbe <patrick.wehbe.applications@gmail.com>
2026-07-09 02:43:41 -07:00
autofix-ci[bot]
6a73479f2c
ci: apply automated fixes and generate docs 2026-05-28 16:57:24 +00:00
Corbin Crutchley
808f158b62
Form Groups (#2128)
* feat: initial work on FormGroupApi in core

* chore: initial (and wrong) per-form-group-validation

This is wrong because instead of keeping the state inside of `FormGroupApi` itself, we need to follow the same pattern of `FieldApi` and keep the state in `FormApi` and reference that state in a derived way.

* chore: create a common FieldLikeAPI to adopt in form groups shortly

* chore: implement FieldLike API on FormGroup

* chore: revert changes to FormApi validation logic

* chore: fix type issues with validation kind

* chore: minor fixes

* Revert "chore: revert changes to FormApi validation logic"

This reverts commit 756ddf8402.

* chore: filter fields to validate in formgroup

* chore: improve store

* chore: fix tests

* chore: fix another test

* chore: add submitmeta test

* ci: apply automated fixes and generate docs

* chore: add FormLike methods to FormGroup

* chore: add type tests

* chore: fix build

* chore: fix type tests

* ci: apply automated fixes and generate docs

* chore: export two missing items

* chore: add new interop FormGroupOptions type

* chore: initial implement of useFormGroup in React

* ci: apply automated fixes and generate docs

* chore: add formGroup to useForm

* chore: add initial React implementation tests

* ci: apply automated fixes and generate docs

* chore: add type tests for React adapter

* ci: apply automated fixes and generate docs

* chore: fix eslint

* ci: apply automated fixes and generate docs

* chore: add multi-step wizard

* ci: apply automated fixes and generate docs

* fix: handle resubmissions

* fix: validate on resubmit

* feat: add better onDynamic handling to FormGroupApi

* chore: first attempt to fix onDynamic change handling on groups

* chore: attempt 2

* chore: attempt 3

* chore: attempt 4

* Revert "chore: attempt 4"

This reverts commit 7546f08b94.

* chore: finalize fixing form errors

* chore: fix eslint

* chore: regenerate lockfile

* ci: apply automated fixes and generate docs

* docs: update the wizard example

* ci: apply automated fixes and generate docs

* chore: initial work on Vue FormGroup API

* ci: apply automated fixes and generate docs

* chore: revert useContext changes

* feat: add preact form group

* chore: fix tests and export names

* chore: add Preact wizard demo

* feat: add FormGroup support for Solid adapter

* chore: add formgroup tests for Solid

* chore: add type tests for Solid

* ci: apply automated fixes and generate docs

* chore: add Solid group example

* ci: apply automated fixes and generate docs

* chore: fix test

* feat: add FormGroup impl to Svelte

* ci: apply automated fixes and generate docs

* chore: add formGroup tests for Svelte

* ci: apply automated fixes and generate docs

* chore: add Svelte example

* chore: fix sherif

* feat: add Lit FormGroup API

* chore: add Lit FormGroup tests

* chore: refactor Lit tests

* ci: apply automated fixes and generate docs

* feat: implement FormGroup in Angular

* chore: add FormGroup Angular spec

* ci: apply automated fixes and generate docs

* feat: add withForm feature to Angular

* chore: update Angular large-form example to use new `withForm` API

* docs: add docs to Angular withForm example

* chore: add changeset

* chore: fix knip

* chore: initial multi-step-wizard Angular example

* chore: update the multi-step-wizard to use new API

* chore: add multi-step-wizard example to Lit

* ci: apply automated fixes and generate docs

* chore: add Vue example

* chore: fix CI

* chore: update to use Testing Library

* chore: make tests more Testing Library-y

* fix: isSubmitting now works with FormGroup

Thank you @gaganref!

* chore: fix Lit warning

* ci: apply automated fixes and generate docs

* chore: add currently failing tests

* fix: handle validation better in form groups

* chore: add test for duped group schema

* chore: update `form` error field to `group`

* chore: fix CI

* ci: apply automated fixes and generate docs

* chore: add test for isGroupValid and isFieldsValid

* ci: apply automated fixes and generate docs

* chore: refactor FormGroup to core

* chore: refactor Lit Form to use Lit Store properly

* chore: fix eslint

* ci: apply automated fixes and generate docs

* chore: remove temp changeset

* docs: initial docs for React adapter

* docs: add multi-step-wizard examples to docs site

* docs: add form group state docs for React

* docs: mirror React docs to Preact

* docs: add Solid docs

* docs: add Vue docs

* ci: apply automated fixes and generate docs

* docs: add groups docs for Svelte

* docs: add groups docs for Lit

* docs: add groups docs for Angular

* fix: handle issue with field group names

* ci: apply automated fixes and generate docs

* chore: fix CI

* chore: remove onXListenTo APIs

* chore: add onMount errors to groups

* chore: add onChange listeners to form

* chore: handle group validation async cleanup, onmount listener, et al

* chore: fix Group change listeners

* chore: add changeset

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-05-28 09:25:07 -07:00
autofix-ci[bot]
a769fbfd12
ci: apply automated fixes and generate docs 2026-05-26 17:44:33 +00:00
autofix-ci[bot]
e25aeee51a
ci: apply automated fixes and generate docs 2026-05-08 14:17:38 +00:00
dfedoryshchev
cab571a170
docs(react-form): show how to render formErrorMap.onChange when using Standard Schema (#2139)
* docs(react-form): show how to render formErrorMap.onChange when using Standard Schema

The form-level error rendering example uses a function validator
returning a string, which renders directly. Readers applying the same
pattern to a Standard Schema validator (Zod, Valibot, ArkType,
Effect/Schema) hit a TypeScript error because errorMap.onChange is then
Record<string, StandardSchemaV1Issue[]>, not a string.

Add a note after the example with the iteration pattern needed for the
Standard Schema case.

Closes #1564

* ci: apply automated fixes and generate docs

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-05-07 02:29:49 -07:00
Andy Cochrane
3c508895e2
docs(react): fix incorrect form component reference in code comment (#2126) 2026-05-06 02:56:28 -07:00
autofix-ci[bot]
070caca0d9
ci: apply automated fixes and generate docs 2026-04-10 11:40:46 +00:00
Harry Whorlow
d6ab662cdf
feat(react-from): extend appform (#2106)
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-04-10 13:39:45 +02:00
Dominik Dorfmeister 🔮
7a1428d6ce
fix(core): field unmount (#2068)
* fix: make field unmount

* more tests

* ref: prefer object.entries

* jsdoc

* Fix field unmount issue in core

Fixes the issue with field unmount in core.

* ci: apply automated fixes and generate docs

* fix: update fieldInfo type to be partial and handle unmounted fields

* fix: cleanupFieldsOnUnmount flag

* fix: eslint

* fix: coderabbit findings

* fix: ensure async validation cancellation on field unmount

* more tests

* chore: remove default

* feat: listeners

* ci: apply automated fixes and generate docs

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
Co-authored-by: Harry Whorlow <79278353+harry-whorlow@users.noreply.github.com>
Co-authored-by: Harry Whorlow <whorlowharry@gmail.com>
2026-03-27 18:46:47 +01:00
Jhoan J. Ramírez
200aa7e24d
docs(*): fix broken code examples in Vue and React SSR guides (#2046)
* docs(*): fix broken code examples in Vue and React SSR guides

* docs(*): update useStore import to use re-export from react-form-start

* ci: apply automated fixes and generate docs

---------

Co-authored-by: dojhoanrd-jw <dojhoanrd-jw@gmail.com>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-03-09 09:01:39 +01:00
autofix-ci[bot]
f3d3dba4e5
ci: apply automated fixes and generate docs 2026-03-04 13:04:25 +00:00
autofix-ci[bot]
0c4d5b51dd
ci: apply automated fixes and generate docs 2026-02-15 08:49:55 +00:00
autofix-ci[bot]
eea2a42c4a
ci: apply automated fixes and generate docs 2026-02-13 03:44:51 +00:00
autofix-ci[bot]
638be14efc
ci: apply automated fixes and generate docs 2026-01-24 10:18:52 +00:00
LeCarbonator
a7eda7a388
feat(react-form): add useTypedAppFormContext (#1826)
* add useTypedAppFormContext

* remove unused ts-expect-error

* Add great-ghosts-sin.md

* ci: apply automated fixes and generate docs

* chore: fix PR

* chore: add unit tests

* docs(react-form): amend form composition with context

* chore: fix changeset

* chore: fix wrong version bump

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2026-01-23 09:39:11 +01:00
Adebesin Tolulope (Lope)
16dca2689f
docs(react-form): add Chakra UI integration guide (#1909)
* docs(react-form): add Chakra UI integration guide to ui-libraries documentation

Add comprehensive Chakra UI integration examples to the UI libraries guide,
covering both composable (Checkbox.Root) and pre-composed Checkbox components.
Includes code examples demonstrating how to integrate Chakra UI's Input and
Checkbox components with TanStack Form's Field component, maintaining
consistency with existing Mantine, Material UI, and shadcn/ui examples.

* docs: Update Chakra UI Checkbox example in UI libraries guide
2026-01-15 15:57:15 +01:00
Andrew Taylor
b75d4fe436
docs(react-form): Fix validator typo in TanStack Start docs (#1972) 2026-01-05 07:13:23 +01:00
Hodeem
11cab495cb
docs(form): Fix grammar issues in the guides (#1965)
* docs(form): Fix grammar issues in the guides

* docs(form): Fix grammar issues in the guides

* ci: apply automated fixes and generate docs

* Update docs/framework/react/guides/devtools.md

Co-authored-by: LeCarbonator <18158911+LeCarbonator@users.noreply.github.com>

* Update docs/framework/react/guides/dynamic-validation.md

Co-authored-by: LeCarbonator <18158911+LeCarbonator@users.noreply.github.com>

* Removed duplicates from validation.md

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
Co-authored-by: LeCarbonator <18158911+LeCarbonator@users.noreply.github.com>
2026-01-04 10:51:28 +01:00
Patrick Patenaude
6877c23570
docs: fix punctuation and grammar issues (#1970)
- Fix pronoun agreement (yourselves → yourself)
- Add missing punctuation (periods, commas)
- Correct grammar (ran → run, etc.)
- Fix JSX comment spacing
- Repair malformed HTML tag
- Standardize TypeScript formatting

10 files changed, 14 corrections applied.
2026-01-03 12:49:06 +01:00
Hodeem
d2ae76a3ce
[Docs] Refine language and formatting in react basic concepts guide (#1943)
* Refine language and formatting in basic concepts guide

Hey team,

These are some suggestions I have for how we could improve this page. It's mostly grammar and consistency fixes, but includes slight re-wording to improve clarity. I'm open to feedback.

* docs(form): Removed links to references and moved `isDefaultValue`

* ci: apply automated fixes and generate docs

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-12-21 12:28:55 +01:00
autofix-ci[bot]
e6e280b802
ci: apply automated fixes and generate docs 2025-12-15 11:55:55 +00:00
autofix-ci[bot]
2559a0f8bb
ci: apply automated fixes and generate docs 2025-12-08 22:24:07 +00:00
Divyansh Soni
c4283ae662
docs: Simplify focus-management example for invalid inputs (#1922)
Refactor onSubmitInvalid to focus on invalid input directly.
2025-12-08 14:23:08 -08:00
autofix-ci[bot]
883867d2bb
ci: apply automated fixes and generate docs 2025-12-07 12:21:18 +00:00
Lachlan Collins
ffa4fb8b9d
docs: correct local relative links (#1906)
* docs: correct local relative links

* String
2025-12-05 22:39:01 +11:00
autofix-ci[bot]
eb60e85bd3
ci: apply automated fixes and generate docs 2025-12-01 18:53:09 +00:00
autofix-ci[bot]
7d19027162
ci: apply automated fixes and generate docs 2025-12-01 18:39:13 +00:00
autofix-ci[bot]
949db5865a
ci: apply automated fixes and generate docs 2025-12-01 09:38:25 +00:00
Reese Hayman
92a9fc76ed
docs: add ESLint rule exception for react/no-children-prop (#1413)
* Making docs more robus

I ran into some errors caused by ESLint and I have found that a few other people did too, I think it would be good to include this in the docs.

* Wording change for linting issues
2025-12-01 01:37:34 -08:00
Lachlan Collins
ae5d57275b
ci: remove @tanstack/publish-config (#1881)
* ci: remove @tanstack/publish-config

* Update docs

* Fix links

* Fix workflow

* Use prettier experimental cli

* Add back test command
2025-11-29 19:26:37 +11:00
autofix-ci[bot]
a298ff3166
ci: apply automated fixes and generate docs 2025-11-27 12:08:27 +00:00
autofix-ci[bot]
235257c3b4
ci: apply automated fixes and generate docs 2025-11-24 12:51:15 +00:00
autofix-ci[bot]
b286f60666
ci: apply automated fixes and generate docs 2025-11-13 18:47:18 +00:00
Leonardo Montini
d3883e9c40
feat: update start to rc (#1771)
Co-authored-by: Lachlan Collins <1667261+lachlancollins@users.noreply.github.com>
Co-authored-by: Harry Whorlow <whorlowharry@gmail.com>
Co-authored-by: Harry Whorlow <79278353+harry-whorlow@users.noreply.github.com>
Co-authored-by: Corbin Crutchley <git@crutchcorn.dev>
2025-11-13 19:46:25 +01:00
Harry Whorlow
154ac183a6
feat(devtools): update to devtools utils, add solid devtools (#1789) 2025-11-12 19:57:01 +01:00
Alex Kostyniuk
2debbd5c67
docs: enhance array field methods description with additional methods (#1827)
enhance array field description
2025-11-05 07:05:41 +01:00
Sarah
fd94e6769b
docs: add community resources page (#1837)
* add community resources page

* ci: apply automated fixes and generate docs

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-11-01 11:35:51 +01:00
Alex Kostyniuk
c3a9b61a05
docs: enhance validation guide with tip on preventing submission when form is untouched (#1814)
* Enhance validation guide with preventing submission tip

Added guidance on preventing form submission before interaction.

* move the tip after the code block to no break logic

* enhance guide for all frameworks
2025-10-29 07:03:47 +01:00
Alex Kostyniuk
67dde9ffaf
docs: enhance UI libraries guide with official ShadCN integration link (#1825)
## 🎯 Changes

Add link to the ShadCN library guide for integrating TanStack Form.

## ✅ Checklist

- [x] I have followed the steps in the [Contributing guide](https://github.com/TanStack/form/blob/main/CONTRIBUTING.md).
- [x] I have tested this code locally with `pnpm test:pr`.

## 🚀 Release Impact

- [ ] This change affects published code, and I have generated a [changeset](https://github.com/changesets/changesets/blob/main/docs/adding-a-changeset.md).
- [x] This change is docs/CI/dev-only (no release).
2025-10-27 10:13:05 +01:00
autofix-ci[bot]
a29602d881
ci: apply automated fixes and generate docs 2025-10-23 08:39:28 +00:00
autofix-ci[bot]
0c9c55ab15
ci: apply automated fixes and generate docs 2025-10-23 08:32:48 +00:00
Felipe Stanzani
888bfcd643
docs(react): add shadcn/ui examples to React ui-libraries documentation (#1757)
* Adds shadcn/ui examples to ui-libraries doc

* ci: apply automated fixes and generate docs

* Update docs/framework/react/guides/ui-libraries.md

Changes input defaultValue to value

Co-authored-by: LeCarbonator <18158911+LeCarbonator@users.noreply.github.com>

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
Co-authored-by: LeCarbonator <18158911+LeCarbonator@users.noreply.github.com>
2025-09-24 15:03:45 +02:00