docs: use new query methods

docs/router/eslint/create-route-property-order.md

@@ -37,7 +37,7 @@ import { createFileRoute } from '@tanstack/react-router'
 
 export const Route = createFileRoute('/path')({
   loader: async ({ context }) => {
-    await context.queryClient.ensureQueryData(getQueryOptions(context.hello))
+    await context.queryClient.query({ ...getQueryOptions(context.hello), staleTime: 'static' })
   },
   beforeLoad: () => ({ hello: 'world' }),
 })
@@ -55,7 +55,7 @@ import { createFileRoute } from '@tanstack/solid-router'
 
 export const Route = createFileRoute('/path')({
   loader: async ({ context }) => {
-    await context.queryClient.ensureQueryData(getQueryOptions(context.hello))
+    await context.queryClient.query({ ...getQueryOptions(context.hello), staleTime: 'static' })
   },
   beforeLoad: () => ({ hello: 'world' }),
 })
@@ -80,7 +80,7 @@ import { createFileRoute } from '@tanstack/react-router'
 export const Route = createFileRoute('/path')({
   beforeLoad: () => ({ hello: 'world' }),
   loader: async ({ context }) => {
-    await context.queryClient.ensureQueryData(getQueryOptions(context.hello))
+    await context.queryClient.query({ ...getQueryOptions(context.hello), staleTime: 'static' })
   },
 })
 ```
@@ -98,7 +98,7 @@ import { createFileRoute } from '@tanstack/solid-router'
 export const Route = createFileRoute('/path')({
   beforeLoad: () => ({ hello: 'world' }),
   loader: async ({ context }) => {
-    await context.queryClient.ensureQueryData(getQueryOptions(context.hello))
+    await context.queryClient.query({ ...getQueryOptions(context.hello), staleTime: 'static' })
   },
 })
 ```

docs/router/guide/deferred-data-loading.md

@@ -95,10 +95,10 @@ import { slowDataOptions, fastDataOptions } from '~/api/query-options'
 export const Route = createFileRoute('/posts/$postId')({
   loader: async ({ context: { queryClient } }) => {
     // Kick off the fetching of some slower data, but do not await it
-    queryClient.prefetchQuery(slowDataOptions())
+    void queryClient.query(slowDataOptions()).catch(noop)
 
     // Fetch and await some data that resolves quickly
-    await queryClient.ensureQueryData(fastDataOptions())
+    await queryClient.query({...fastDataOptions(), staleTime: 'static')
   },
 })
 ```
@@ -113,10 +113,10 @@ import { slowDataOptions, fastDataOptions } from '~/api/query-options'
 export const Route = createFileRoute('/posts/$postId')({
   loader: async ({ context: { queryClient } }) => {
     // Kick off the fetching of some slower data, but do not await it
-    queryClient.prefetchQuery(slowDataOptions())
+    void queryClient.query(slowDataOptions()).catch(noop)
 
     // Fetch and await some data that resolves quickly
-    await queryClient.ensureQueryData(fastDataOptions())
+    await queryClient.query({...fastDataOptions(), staleTime: 'static')
   },
 })
 ```

docs/router/guide/external-data-loading.md

@@ -82,7 +82,7 @@ const postsQueryOptions = queryOptions({
 
 export const Route = createFileRoute('/posts')({
   // Use the `loader` option to ensure that the data is loaded
-  loader: () => queryClient.ensureQueryData(postsQueryOptions),
+  loader: () => queryClient.query({...postsQueryOptions, staleTime: 'static'),
   component: () => {
     // Read the data from the cache and subscribe to updates
     const {
@@ -106,7 +106,7 @@ When an error occurs while using `suspense` with `TanStack Query`, you need to l
 
 ```tsx
 export const Route = createFileRoute('/')({
-  loader: () => queryClient.ensureQueryData(postsQueryOptions),
+  loader: () => queryClient.query({...postsQueryOptions, staleTime: 'static' }),
   errorComponent: ({ error, reset }) => {
     const router = useRouter()
     const queryErrorResetBoundary = useQueryErrorResetBoundary()

docs/router/guide/router-context.md

@@ -278,9 +278,10 @@ Then, in your route:
 export const Route = createFileRoute('/todos')({
   component: Todos,
   loader: async ({ context }) => {
-    await context.queryClient.ensureQueryData({
+    await context.queryClient.query({
       queryKey: ['todos', { userId: user.id }],
       queryFn: fetchTodos,
+      staleTime: 'static'
     })
   },
 })

docs/router/guide/type-safety.md

@@ -137,12 +137,12 @@ As your application scales, TypeScript check times will naturally increase. Ther
 
 ### Only infer types you need
 
-A great pattern with client side data caches (TanStack Query, etc.) is to prefetch data. For example with TanStack Query you might have a route which calls `queryClient.ensureQueryData` in a `loader`.
+A great pattern with client side data caches (TanStack Query, etc.) is to prefetch data. For example with TanStack Query you might have a route which calls `queryClient.query` in a `loader`.
 
 ```tsx
 export const Route = createFileRoute('/posts/$postId/deep')({
   loader: ({ context: { queryClient }, params: { postId } }) =>
-    queryClient.ensureQueryData(postQueryOptions(postId)),
+    queryClient.query({ ...postQueryOptions(postId), staleTime: 'static' }),
   component: PostDeepComponent,
 })
 
@@ -159,7 +159,7 @@ This may look fine and for small route trees and you may not notice any TS perfo
 ```tsx
 export const Route = createFileRoute('/posts/$postId/deep')({
   loader: async ({ context: { queryClient }, params: { postId } }) => {
-    await queryClient.ensureQueryData(postQueryOptions(postId))
+    await queryClient.query({ ...postQueryOptions(postId), staleTime: 'static' })
   },
   component: PostDeepComponent,
 })

docs/router/how-to/setup-testing.md

@@ -651,9 +651,10 @@ describe('React Query Integration', () => {
       path: '/posts',
       component: PostsList,
       loader: ({ context: { queryClient } }) =>
-        queryClient.ensureQueryData({
+        queryClient.query({
           queryKey: ['posts'],
           queryFn: mockFetchPosts,
+          staleTime: 'static'
         }),
     })
 

docs/router/integrations/query.md

@@ -118,7 +118,7 @@ const postsQuery = queryOptions({
 
 export const Route = createFileRoute('/posts')({
   // Ensure the data is in the cache before render
-  loader: ({ context }) => context.queryClient.ensureQueryData(postsQuery),
+  loader: ({ context }) => context.queryClient.query({...postsQuery, staleTime: 'static' }),
   component: PostsPage,
 })
 
@@ -133,7 +133,7 @@ function PostsPage() {
 
 ### Prefetching and streaming
 
-You can also prefetch with `fetchQuery` or `ensureQueryData` in a loader without consuming the data in a component. If you return the promise directly from the loader, it will be awaited and thus block the SSR request until the query finishes. If you don't await the promise nor return it, the query will be started on the server and will be streamed to the client without blocking the SSR request.
+You can also prefetch with `query` in a loader without consuming the data in a component. If you return the promise directly from the loader, it will be awaited and thus block the SSR request until the query finishes. If you don't await the promise nor return it, the query will be started on the server and will be streamed to the client without blocking the SSR request.
 
 <!-- ::start:framework -->
 

docs/start/framework/react/comparison.md

@@ -168,7 +168,7 @@ const postQueryOptions = (postId: string) =>
 
 export const Route = createFileRoute('/posts/$postId')({
   loader: ({ context, params }) =>
-    context.queryClient.ensureQueryData(postQueryOptions(params.postId)),
+    context.queryClient.query({ ...postQueryOptions(params.postId), staleTime: `static` }),
 })
 
 function Post() {