Merge branch 'main' into patch-1

Author: TkDodo

docs/framework/react/guides/advanced-ssr.md

@@ -390,11 +390,7 @@ Then, all we need to do is provide a `HydrationBoundary`, but we don't need to `
 
 ```tsx
 // app/posts/page.jsx
-import {
-  dehydrate,
-  HydrationBoundary,
-  QueryClient,
-} from '@tanstack/react-query'
+import { dehydrate, HydrationBoundary } from '@tanstack/react-query'
 import { getQueryClient } from './get-query-client'
 import Posts from './posts'
 

docs/framework/react/reference/useQuery.md

@@ -88,11 +88,12 @@ const {
   - This function receives a `retryAttempt` integer and the actual Error and returns the delay to apply before the next attempt in milliseconds.
   - A function like `attempt => Math.min(attempt > 1 ? 2 ** attempt * 1000 : 1000, 30 * 1000)` applies exponential backoff.
   - A function like `attempt => attempt * 1000` applies linear backoff.
-- `staleTime: number | Infinity`
+- `staleTime: number | ((query: Query) => number)`
   - Optional
   - Defaults to `0`
   - The time in milliseconds after data is considered stale. This value only applies to the hook it is defined on.
   - If set to `Infinity`, the data will never be considered stale
+  - If set to a function, the function will be executed with the query to compute a `staleTime`.
 - `gcTime: number | Infinity`
   - Defaults to `5 * 60 * 1000` (5 minutes) or `Infinity` during SSR
   - The time in milliseconds that unused/inactive cache data remains in memory. When a query's cache becomes unused or inactive, that cache data will be garbage collected after this duration. When different garbage collection times are specified, the longest one will be used.

examples/angular/basic/package.json

@@ -14,7 +14,7 @@
     "@angular/core": "^17.3.10",
     "@angular/platform-browser": "^17.3.10",
     "@angular/platform-browser-dynamic": "^17.3.10",
-    "@tanstack/angular-query-experimental": "^5.40.1",
+    "@tanstack/angular-query-experimental": "^5.44.0",
     "rxjs": "^7.8.1",
     "tslib": "^2.6.2",
     "zone.js": "^0.14.6"
@@ -23,7 +23,7 @@
     "@angular-devkit/build-angular": "^17.3.8",
     "@angular/cli": "^17.3.8",
     "@angular/compiler-cli": "^17.3.10",
-    "@tanstack/angular-query-devtools-experimental": "^5.40.1",
+    "@tanstack/angular-query-devtools-experimental": "^5.44.0",
     "typescript": "5.3.3"
   }
 }

examples/angular/infinite-query-with-max-pages/package.json

@@ -14,7 +14,7 @@
     "@angular/core": "^17.3.10",
     "@angular/platform-browser": "^17.3.10",
     "@angular/platform-browser-dynamic": "^17.3.10",
-    "@tanstack/angular-query-experimental": "^5.40.1",
+    "@tanstack/angular-query-experimental": "^5.44.0",
     "rxjs": "^7.8.1",
     "tslib": "^2.6.2",
     "zone.js": "^0.14.6"
@@ -23,7 +23,7 @@
     "@angular-devkit/build-angular": "^17.3.8",
     "@angular/cli": "^17.3.8",
     "@angular/compiler-cli": "^17.3.10",
-    "@tanstack/angular-query-devtools-experimental": "^5.40.1",
+    "@tanstack/angular-query-devtools-experimental": "^5.44.0",
     "typescript": "5.3.3"
   }
 }

examples/angular/router/package.json

@@ -15,7 +15,7 @@
     "@angular/platform-browser": "^17.3.10",
     "@angular/platform-browser-dynamic": "^17.3.10",
     "@angular/router": "^17.3.10",
-    "@tanstack/angular-query-experimental": "^5.40.1",
+    "@tanstack/angular-query-experimental": "^5.44.0",
     "rxjs": "^7.8.1",
     "tslib": "^2.6.2",
     "zone.js": "^0.14.6"
@@ -24,7 +24,7 @@
     "@angular-devkit/build-angular": "^17.3.8",
     "@angular/cli": "^17.3.8",
     "@angular/compiler-cli": "^17.3.10",
-    "@tanstack/angular-query-devtools-experimental": "^5.40.1",
+    "@tanstack/angular-query-devtools-experimental": "^5.44.0",
     "typescript": "5.3.3"
   }
 }

examples/angular/simple/package.json

@@ -15,7 +15,7 @@
     "@angular/platform-browser": "^17.3.10",
     "@angular/platform-browser-dynamic": "^17.3.10",
     "@angular/router": "^17.3.10",
-    "@tanstack/angular-query-experimental": "^5.40.1",
+    "@tanstack/angular-query-experimental": "^5.44.0",
     "rxjs": "^7.8.1",
     "tslib": "^2.6.2",
     "zone.js": "^0.14.6"
@@ -24,7 +24,7 @@
     "@angular-devkit/build-angular": "^17.3.8",
     "@angular/cli": "^17.3.8",
     "@angular/compiler-cli": "^17.3.10",
-    "@tanstack/angular-query-devtools-experimental": "^5.40.1",
+    "@tanstack/angular-query-devtools-experimental": "^5.44.0",
     "typescript": "5.3.3"
   }
 }

examples/react/algolia/package.json

@@ -11,8 +11,8 @@
   "dependencies": {
     "@algolia/client-search": "4.23.3",
     "@algolia/transporter": "4.23.3",
-    "@tanstack/react-query": "^5.40.1",
-    "@tanstack/react-query-devtools": "^5.40.1",
+    "@tanstack/react-query": "^5.44.0",
+    "@tanstack/react-query-devtools": "^5.44.0",
     "algoliasearch": "4.23.3",
     "react": "19.0.0-rc-4c2e457c7c-20240522",
     "react-dom": "19.0.0-rc-4c2e457c7c-20240522"

examples/react/auto-refetching/package.json

@@ -7,8 +7,8 @@
     "start": "next start"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.40.1",
-    "@tanstack/react-query-devtools": "^5.40.1",
+    "@tanstack/react-query": "^5.44.0",
+    "@tanstack/react-query-devtools": "^5.44.0",
     "axios": "^1.6.8",
     "isomorphic-unfetch": "4.0.2",
     "next": "^14.0.0",

examples/react/basic-graphql-request/package.json

@@ -8,8 +8,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.40.1",
-    "@tanstack/react-query-devtools": "^5.40.1",
+    "@tanstack/react-query": "^5.44.0",
+    "@tanstack/react-query-devtools": "^5.44.0",
     "graphql": "^16.8.1",
     "graphql-request": "^7.0.1",
     "react": "19.0.0-rc-4c2e457c7c-20240522",

examples/react/basic-typescript/package.json

@@ -9,10 +9,10 @@
     "test:types": "tsc"
   },
   "dependencies": {
-    "@tanstack/query-sync-storage-persister": "^5.40.0",
-    "@tanstack/react-query": "^5.40.1",
-    "@tanstack/react-query-devtools": "^5.40.1",
-    "@tanstack/react-query-persist-client": "^5.40.1",
+    "@tanstack/query-sync-storage-persister": "^5.44.0",
+    "@tanstack/react-query": "^5.44.0",
+    "@tanstack/react-query-devtools": "^5.44.0",
+    "@tanstack/react-query-persist-client": "^5.44.0",
     "axios": "^1.6.8",
     "react": "19.0.0-rc-4c2e457c7c-20240522",
     "react-dom": "19.0.0-rc-4c2e457c7c-20240522"