fix(query-core): infer query data from query filters

[raashish1601]

Summary

• Infer getQueriesData and setQueriesData generic data types from QueryFilters generic, so tags propagate to typed data/update signatures.
• Add type test coverage in queryClient.test-d.tsx for typed queryFilters with DataTag.

Validation

• corepack pnpm --filter @tanstack/query-core test:types:ts59
• corepack pnpm --filter @tanstack/query-core test:types:ts60
• corepack pnpm --filter @tanstack/query-core test:lib (passes tests, but reports existing config parse errors in
  oot.eslint.config.js and
  oot.tsup.config.js)

Summary by CodeRabbit

• New Features

  • Enhanced TypeScript type inference for query data methods to better preserve data types across operations

• Bug Fixes

  • Resolved devtools crashes when cached query state is temporarily unavailable during query row rendering

• Tests

  • Added test case to verify proper status color determination when query state is undefined

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3a1eb68f-2cc7-4eb7-ad9f-6f64a2103fa0

📥 Commits

Reviewing files that changed from the base of the PR and between 7fa2781 and 4bdcba7.

📒 Files selected for processing (6)

• .changeset/query-devtools-missing-state.md
• packages/query-core/src/__tests__/queryClient.test-d.tsx
• packages/query-core/src/queryClient.ts
• packages/query-devtools/src/Devtools.tsx
• packages/query-devtools/src/__tests__/utils.test.ts
• packages/query-devtools/src/utils.tsx

---

📝 Walkthrough

Walkthrough

This PR enhances TanStack Query's type system and devtools robustness. First, it introduces FilteredQueryData, a conditional type that infers data types from QueryFilters, enabling overloads for getQueriesData and setQueriesData to eliminate unnecessary type arguments. Second, it hardens devtools by making getQueryStatusColor accept optional query state, preventing crashes when state is transiently unavailable.

Changes

QueryClient Type System for Batch Query Operations

Layer / File(s)	Summary
FilteredQueryData conditional type and method overloads packages/query-core/src/queryClient.ts	Introduces FilteredQueryData conditional type that maps QueryFilters to inferred data types, then wires it into new overload signatures for getQueriesData<TQueryFilters>() and setQueriesData<TQueryFilters>() to eliminate the need for explicit TQueryFnData type arguments.
QueryClient type test updates packages/query-core/src/__tests__/queryClient.test-d.tsx	Type assertions updated to validate that getQueriesData and setQueriesData preserve the tagged `TData

Devtools Resilience for Undefined Query State

Layer / File(s)	Summary
getQueryStatusColor undefined state handling packages/query-devtools/src/utils.tsx	getQueryStatusColor signature updated to accept queryState: Query['state'] | undefined and internal fetch-status checks now use optional chaining to safely determine color when state is unavailable.
QueryRow integration and devtools testing packages/query-devtools/src/Devtools.tsx, packages/query-devtools/src/__tests__/utils.test.ts	QueryRow color memo removes non-null assertion and passes potentially undefined queryState() to getQueryStatusColor; new test case verifies the function returns "gray" when queryState is undefined.
Devtools patch release notes .changeset/query-devtools-missing-state.md	Changesets entry documents the patch release for @tanstack/query-devtools addressing the fix for preventing devtools crashes when cached query state is temporarily unavailable.

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly Related PRs

• TanStack/query#10750: Addresses the same "query row state can be undefined" failure by finding live queryState via queryHash, complementing this PR's defensive handling in getQueryStatusColor.
• TanStack/query#10772: Implements the same core devtools fix—updating getQueryStatusColor to accept optional queryState and adjusting QueryRow color computation with the gray fallback test case.

Suggested Labels

package: query-core, package: query-devtools, typescript

Suggested Reviewers

• TkDodo

Poem

🐰 A rabbit hops through types so fine,
FilteredData makes them align,
When states go missing, colors stay gray,
Devtools won't crash—hooray, hooray! ✨

🚥 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
Title check	✅ Passed	The title accurately and concisely describes the main change: inferring query data types from query filters in query-core, which is the primary objective of the PR.
Description check	✅ Passed	The PR description includes a clear summary of changes and validation steps, addressing the main objectives and providing evidence of testing.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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.}