fix(react-form): widen return type of render prop

[xotea]

Fixes: #1815

🎯 Changes

In React JSX.Element is only a subset of the valid children described by ReactNode. By widening this type we allow returning all valid React children now in a non-breaking fashion allowing

withForm({
  // Type 'null' is not assignable to type 'Element'.
  render: function Render() {
    return null
  },
})

withFieldGroup({
  // Type 'null' is not assignable to type 'Element'.
  render: function Render() {
    return null
  },
})

to work without TypeScript errors.

✅ Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm test:pr.

🚀 Release Impact

• This change affects published code, and I have generated a changeset.

[changeset-bot]

🦋 Changeset detected

Latest commit: 7b913e8

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@tanstack/react-form	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 7b913e8

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

---

☁️ Nx Cloud last updated this comment at 2025-10-23 08:33:02 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-angular-standard-schema
• @tanstack/form-example-lit-array
• @tanstack/form-example-lit-simple
• @tanstack/form-example-lit-standard-schema
• @tanstack/form-example-lit-ui-libraries
• @tanstack/form-example-react-array
• @tanstack/form-example-react-compiler
• @tanstack/form-example-react-devtools
• @tanstack/form-example-react-dynamic
• @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-solid-standard-schema
• @tanstack/form-example-svelte-array
• @tanstack/form-example-svelte-simple
• @tanstack/form-example-svelte-standard-schema
• @tanstack/form-example-vue-array
• @tanstack/form-example-vue-simple
• @tanstack/form-example-vue-standard-schema

@tanstack/angular-form

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

@tanstack/form-core

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

@tanstack/form-devtools

npm i https://pkg.pr.new/@tanstack/form-devtools@1817

@tanstack/lit-form

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

@tanstack/react-form

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

@tanstack/react-form-devtools

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

@tanstack/solid-form

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

@tanstack/svelte-form

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

@tanstack/vue-form

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

commit: 7b913e8

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 51.91%. Comparing base (6892ed0) to head (7b913e8).
⚠️ Report is 36 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff             @@
##             main    #1817       +/-   ##
===========================================
- Coverage   90.35%   51.91%   -38.45%     
===========================================
  Files          38       14       -24     
  Lines        1752      183     -1569     
  Branches      444       29      -415     
===========================================
- Hits         1583       95     -1488     
+ Misses        149       77       -72     
+ Partials       20       11        -9     

☔ 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]

Also LGTM! The code coverage appears to complain, but this isn't affected by this PR.