fix(react-form): remap listener paths in withFieldGroup

[kusiewicz]

Closes #1644

Currently, when using the withFieldGroup HOC, the field names provided in the validators.onChangeListenTo and validators.onBlurListenTo arrays are not remapped to their full paths within the form state. This causes linked field validation to fail, as the form cannot find the fields it's supposed to be listening to.

• new method, remapFieldProps, has been added to the FieldGroupApi.
• the useFieldGroup hook in @tanstack/react-form now calls this new core method for each Field and AppField rendered within the group.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit c1d8eb1

Command	Status	Duration	Result
nx affected --targets=test:sherif,test:knip,tes...	✅ Succeeded	2m 8s	View ↗
nx run-many --target=build --exclude=examples/**	✅ Succeeded	19s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-08-02 15:06:25 UTC

[pkg-pr-new]

More templates

• @tanstack/form-example-angular-array
• @tanstack/form-example-angular-large-form
• @tanstack/form-example-angular-simple
• @tanstack/form-example-lit-simple
• @tanstack/form-example-lit-ui-libraries
• @tanstack/form-example-react-array
• @tanstack/form-example-react-compiler
• @tanstack/field-errors-from-form-validators
• @tanstack/form-example-react-large-form
• @tanstack/form-example-react-next-server-actions
• @tanstack/form-example-react-query-integration
• @tanstack/form-example-remix
• @tanstack/form-example-react-simple
• @tanstack/form-example-react-standard-schema
• @tanstack/form-example-react-tanstack-start
• @tanstack/form-example-react-ui-libraries
• @tanstack/form-example-solid-array
• @tanstack/form-example-solid-large-form
• @tanstack/form-example-solid-simple
• @tanstack/form-example-svelte-array
• @tanstack/form-example-svelte-simple
• @tanstack/form-example-vue-array
• @tanstack/form-example-vue-simple

@tanstack/angular-form

npm i https://pkg.pr.new/@tanstack/angular-form@1654

@tanstack/form-core

npm i https://pkg.pr.new/@tanstack/form-core@1654

@tanstack/lit-form

npm i https://pkg.pr.new/@tanstack/lit-form@1654

@tanstack/react-form

npm i https://pkg.pr.new/@tanstack/react-form@1654

@tanstack/solid-form

npm i https://pkg.pr.new/@tanstack/solid-form@1654

@tanstack/svelte-form

npm i https://pkg.pr.new/@tanstack/svelte-form@1654

@tanstack/vue-form

npm i https://pkg.pr.new/@tanstack/vue-form@1654

commit: c1d8eb1

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.48%. Comparing base (f975f03) to head (c1d8eb1).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1654      +/-   ##
==========================================
+ Coverage   90.38%   90.48%   +0.09%     
==========================================
  Files          36       36              
  Lines        1623     1640      +17     
  Branches      386      390       +4     
==========================================
+ Hits         1467     1484      +17     
  Misses        139      139              
  Partials       17       17              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[LeCarbonator]

The function to remap listeners should go in form-core/FieldGroupApi instead.

However, I like the idea and approach! Let me know if you want help on this PR.

[kusiewicz]

The function to remap listeners should go in form-core/FieldGroupApi instead.

However, I like the idea and approach! Let me know if you want help on this PR.

Yes... make sense :) Updated and added tests