@tanstack/query-core

Minor Changes

• Export the FocusManager, OnlineManager, and TimeoutManager types so their methods appear in the generated reference docs.

Patch Changes

• Reuse the shared query option resolver for refetch intervals to reduce bundle size.

• ref(hydration): remove outdated dehydratedAt fallback

• Prevent longer partial query-key filters with trailing undefined values from matching shorter query keys.

Minor Changes

• add query and infiniteQuery methods, deprecate old imperative methods

Patch Changes

• query-core: clear a stale select error when the observer switches to a query without data, and reset isPlaceholderData on select-error results to match the declared result types, so a previous query's select error no longer leaks into the new result

• Improve hydration performance by skipping no-op data transforms and default error-redaction callbacks.
  Export dehydrateQuery.

• Reduce observer churn overhead by removing observers in place instead of copying the observer list for every unsubscribe.

• query-core: reset isPlaceholderData when select throws on placeholder data

• Fix queryOptions and infiniteQueryOptions return types so exported inferred options can be emitted in declaration files without leaking internal data tag symbols.

• Skip unused result tracking when notifying useQueries listeners without a combine function.

• Avoid repeatedly synchronizing the same tracked property across all observers in useQueries.

• Reattach MutationObserver to its current mutation when a listener subscribes again, so a useMutation result no longer stays pending after React tears down and re-establishes the subscription mid-mutation.

• Ignore a retained pendingThenable settlement callback invoked after the thenable has settled. Holding a reference to resolve/reject and calling it later used to overwrite status and reason even though the underlying promise had already settled, leaving the thenable advertising a state that disagreed with its value.

• make mutation variables optional when undefined extends TVariables

• removed

  Remove experimental render-time prefetching and the promise property from query results.

• Release a mutation's retryer once its execution settles, so the settled promise no longer keeps that mutation's result, variables and context in memory for as long as the mutation cache retains it.

• Release a query's retryer once its fetch settles, so the settled promise no longer keeps that fetch's raw result in memory alongside the structurally shared state.data (or after the query is reset or removed).

• Resolve suspense when query data is set programmatically via setQueryData or streamedQuery. Previously, fetchOptimistic returned only the fetch promise, which left the Suspense boundary stuck until the queryFn completed — even when data already existed in the cache. The fix uses Promise.race with a cache subscriber to release suspense as soon as data becomes available.

• Notify every query observer when another observer unsubscribes synchronously during the same query update.

• resetQueries now preserves the queries matched before query.reset() changes their state.

• Memoize falsy combine results when the function and query results are unchanged.