fix(react-query): improve useQueries select inference

[ganyudedog]

Summary

This PR addresses two TypeScript typing issues in @tanstack/react-query:

• Type checking select works differently on useQueries compared to useQuery #6556: useQueries / useSuspenseQueries could lose type inference for the select callback input (degrading to any/unknown) when options were provided without explicit generics.
• TypeScript errors when using exported queryOptions factory in @tanstack/react-query 5.62.8 #8453: exporting the result of queryOptions() / infiniteQueryOptions() could trigger TS4023 ("cannot be named") in consumer declaration output.

Changes

• Improves the inferred-options path in useQueries and useSuspenseQueries so TQueryFnData is derived from the queryFn return type and TData from the select output, restoring correct select(data) contextual typing.
• Refactors queryOptions / infiniteQueryOptions overload return types to named *Result aliases to make declaration output more stable.
• Updates type tests to assert inference without requiring explicit select parameter annotations.

Tests

• pnpm -C packages/react-query run test:types:tscurrent

Fixes #6556.
Addresses #8453.

Summary by CodeRabbit

Release Notes

• New Features

  • Added new public result variant types for both query options and infinite query options, offering more specific TypeScript type selections for query configuration.

• Improvements

  • Improved type inference for query select callbacks with stricter type constraints and enhanced accuracy in type resolution.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

⚠️ No Changeset found

Latest commit: 787714f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR improves TypeScript type inference for the select function in useQueries and useSuspenseQueries hooks to match useQuery behavior. It introduces new Result types using DataTag for queryKey type safety in queryOptions and infiniteQueryOptions, and updates conditional type logic to narrow select callback parameters from any to TQueryFnData.

Changes

Cohort / File(s)	Summary
Type Declarations & Public API packages/react-query/src/index.ts	Adds 6 new public type exports: DefinedInitialDataOptionsResult, UndefinedInitialDataOptionsResult, UnusedSkipTokenOptionsResult (for queryOptions) and their *InfiniteOptions variants. Re-exports from respective modules.
Query Options Result Types packages/react-query/src/queryOptions.ts	Introduces three new *Result types that wrap base option types by omitting queryKey and redefining it as a DataTag. Updates function overloads to return DefinedInitialDataOptionsResult, UnusedSkipTokenOptionsResult, and UndefinedInitialDataOptionsResult instead of base types.
Infinite Query Options Result Types packages/react-query/src/infiniteQueryOptions.ts	Introduces three new *InfiniteOptionsResult types with the same DataTag pattern. Updates infiniteQueryOptions function overloads to return the new Result variants, removing explicit queryKey properties from return shapes.
Hook Type Inference — useQueries packages/react-query/src/useQueries.ts	Refines conditional type logic in GetUseQueryOptionsForUseQueries and GetUseQueryResult to check for select?: (data: TQueryFnData) => infer TData pattern instead of any, tightening type inference when select is present.
Hook Type Inference — useSuspenseQueries packages/react-query/src/useSuspenseQueries.ts	Updates GetUseSuspenseQueryOptions and GetUseSuspenseQueryResult to replace select?: (data: any) with select?: (data: TQueryFnData), narrowing the callback parameter type in conditional branches.
Type Tests packages/react-query/src/__tests__/useQueries.test-d.tsx, packages/react-query/src/__tests__/useSuspenseQueries.test-d.tsx	Refactor test definitions to use shared constants (queryKey, queryFn, TQueryFnData) and inline second query objects with satisfies UseQueryOptions constraints, improving type assertion coverage and clarity.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• fix(solid-query): export queryOptions without type errors #9668: Modifies type signatures for queryOptions/infiniteQueryOptions with queryKey DataTag typing and overload return types.
• test(react-query/ssr): add 'useQueries' test for SSR #9996: Updates useQueries hook type logic and related test exports.

Suggested labels

package: react-query

Suggested reviewers

• TkDodo
• manudeli

Poem

🐰 Our types now dance with graceful care,
The select function finds its proper pair,
From any mists to TQueryFnData light,
The queries sing in harmony so bright! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately captures the main objective of the PR—improving type inference for the select callback in useQueries, which aligns with the core changes in useQueries.ts and useSuspenseQueries.ts.
Linked Issues check	✅ Passed	The PR successfully addresses #6556 by improving select callback inference in useQueries and useSuspenseQueries, and partially addresses #8453 by exporting new *Result type aliases to stabilize declaration output.
Out of Scope Changes check	✅ Passed	All changes are scoped to addressing the linked issues: type inference improvements in useQueries/useSuspenseQueries (direct fix for #6556), and new *Result type exports (addressing #8453).

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}