Sync

docs/framework/react/guides/render-optimizations.md

@@ -17,11 +17,11 @@ The top level object returned from `useQuery`, `useInfiniteQuery`, `useMutation`
 
 ## tracked properties
 
-React Query will only trigger a re-render if one of the properties returned from `useQuery` is actually "used". This is done by using [custom getters](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty#custom_setters_and_getters). This avoids a lot of unnecessary re-renders, e.g. because properties like `isFetching` or `isStale` might change often, but are not used in the component.
+React Query will only trigger a re-render if one of the properties returned from `useQuery` is actually "used". This is done by using [Proxy object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy). This avoids a lot of unnecessary re-renders, e.g. because properties like `isFetching` or `isStale` might change often, but are not used in the component.
 
 You can customize this feature by setting `notifyOnChangeProps` manually globally or on a per-query basis. If you want to turn that feature off, you can set `notifyOnChangeProps: 'all'`.
 
-> Note: Custom getters are invoked by accessing a property, either via destructuring or by accessing it directly. If you use object rest destructuring, you will disable this optimization. We have a [lint rule](../../../eslint/no-rest-destructuring.md) to guard against this pitfall.
+> Note: The get trap of a proxy is invoked by accessing a property, either via destructuring or by accessing it directly. If you use object rest destructuring, you will disable this optimization. We have a [lint rule](../../../eslint/no-rest-destructuring.md) to guard against this pitfall.
 
 ## select
 

docs/framework/vue/reactivity.md

@@ -157,10 +157,17 @@ export function useUserProjects(userId: MaybeRef<string>) {
 
 More details on this option can be found on the [useQuery reference](./reference/useQuery.md) page.
 
+## Immutability
+
+Results from `useQuery` are always immutable. This is necessary for performance and caching purposes. If you need to mutate a value returned from `useQuery`, you must create a copy of the data.
+
+One implication of this design is that passing values from `useQuery` to a two-way binding such as `v-model` will not work. You must create a mutable copy of the data before attempting to update it in place.
+
 # Key Takeaways
 
 - `enabled` and `queryKey` are the two query options that can accept reactive values.
 - Pass query option that accept all three types of values in Vue: refs, plain values, and reactive getters.
 - If you expect a query to react to changes based on the values it consumes, ensure that the values are reactive. (i.e. pass in refs directly to the query, or use reactive getters)
 - If you don't need a query to be reactive pass in a plain value.
 - For trivial derived state such as property access consider using a reactive getter in place of a `computed`.
+- Results from `useQuery` are always immutable.

docs/reference/QueryCache.md

@@ -75,8 +75,8 @@ const queries = queryCache.findAll(queryKey)
 
 **Options**
 
-- `queryKey?: QueryKey`: [Query Keys](../../framework/react/guides/query-keys)
-- `filters?: QueryFilters`: [Query Filters](../../framework/react/guides/filters#query-filters)
+- `queryKey?: QueryKey`: [Query Keys](../framework/react/guides/query-keys.md)
+- `filters?: QueryFilters`: [Query Filters](../framework/react/guides/filters.md#query-filters)
 
 **Returns**
 
@@ -118,6 +118,6 @@ queryCache.clear()
 ## Further reading
 
 To get a better understanding how the QueryCache works internally, have a look at [#18: Inside React Query
-](../../framework/react/community/tkdodos-blog#18-inside-react-query) from the Community Resources.
+](../framework/react/community/tkdodos-blog.md#18-inside-react-query) from the Community Resources.
 
 [//]: # 'Materials'

docs/reference/streamedQuery.md

@@ -26,8 +26,10 @@ const query = queryOptions({
   - **Required**
   - The function that returns a Promise of an AsyncIterable of data to stream in.
   - Receives a [QueryFunctionContext](../guides/query-functions.md#queryfunctioncontext)
-- `refetchMode?: 'append' | 'reset'`
-  - optional
-  - when set to `'reset'`, the query will erase all data and go back into `pending` state when a refetch occurs.
-  - when set to `'append'`, data will be appended on a refetch.
-  - defaults to `'reset'`
+- `refetchMode?: 'append' | 'reset' | 'replace`
+  - Optional
+  - Defines how refetches are handled.
+  - Defaults to `'reset'`
+  - When set to `'reset'`, the query will erase all data and go back into `pending` state.
+  - When set to `'append'`, data will be appended to existing data.
+  - When set to `'replace'`, data will be written to the cache at the end of the stream.

eslint.config.js

@@ -45,10 +45,7 @@ export default [
   {
     files: ['**/*.spec.ts*', '**/*.test.ts*', '**/*.test-d.ts*'],
     plugins: { vitest },
-    rules: {
-      ...vitest.configs.recommended.rules,
-      'vitest/expect-expect': 'warn',
-    },
+    rules: vitest.configs.recommended.rules,
     settings: { vitest: { typecheck: true } },
   },
 ]

examples/angular/auto-refetching/package.json

@@ -14,7 +14,7 @@
     "@angular/core": "^19.2.4",
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

examples/angular/basic-persister/package.json

@@ -14,9 +14,9 @@
     "@angular/core": "^19.2.4",
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "@tanstack/angular-query-persist-client": "^5.62.7",
-    "@tanstack/query-sync-storage-persister": "^5.74.6",
+    "@tanstack/query-sync-storage-persister": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "^0.15.0"

examples/angular/basic/package.json

@@ -14,7 +14,7 @@
     "@angular/core": "^19.2.4",
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

examples/angular/devtools-panel/package.json

@@ -15,8 +15,8 @@
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
     "@angular/router": "^19.2.4",
-    "@tanstack/angular-query-devtools-experimental": "^5.74.6",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-devtools-experimental": "^5.75.4",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

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

@@ -14,7 +14,7 @@
     "@angular/core": "^19.2.4",
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

examples/angular/optimistic-updates/package.json

@@ -15,7 +15,7 @@
     "@angular/forms": "^19.2.4",
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

examples/angular/pagination/package.json

@@ -14,7 +14,7 @@
     "@angular/core": "^19.2.4",
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

examples/angular/query-options-from-a-service/package.json

@@ -15,7 +15,7 @@
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
     "@angular/router": "^19.2.4",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

examples/angular/router/package.json

@@ -15,7 +15,7 @@
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
     "@angular/router": "^19.2.4",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

examples/angular/rxjs/package.json

@@ -15,7 +15,7 @@
     "@angular/forms": "^19.2.4",
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

examples/angular/simple/package.json

@@ -14,7 +14,7 @@
     "@angular/core": "^19.2.4",
     "@angular/platform-browser": "^19.2.4",
     "@angular/platform-browser-dynamic": "^19.2.4",
-    "@tanstack/angular-query-experimental": "^5.74.6",
+    "@tanstack/angular-query-experimental": "^5.75.4",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

examples/react/algolia/package.json

@@ -9,13 +9,13 @@
   },
   "dependencies": {
     "@algolia/client-search": "5.2.1",
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@tanstack/eslint-plugin-query": "^5.73.3",
+    "@tanstack/eslint-plugin-query": "^5.74.7",
     "@types/react": "^18.2.79",
     "@types/react-dom": "^18.2.25",
     "@vitejs/plugin-react": "^4.3.4",

examples/react/auto-refetching/package.json

@@ -8,9 +8,9 @@
     "start": "next start"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
-    "next": "^15.1.2",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
+    "next": "^15.3.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },

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

@@ -8,8 +8,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
     "graphql": "^16.9.0",
     "graphql-request": "^7.1.2",
     "react": "^19.0.0",

examples/react/basic/package.json

@@ -9,15 +9,15 @@
     "test:eslint": "eslint ./src"
   },
   "dependencies": {
-    "@tanstack/query-sync-storage-persister": "^5.74.6",
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
-    "@tanstack/react-query-persist-client": "^5.74.6",
+    "@tanstack/query-sync-storage-persister": "^5.75.4",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
+    "@tanstack/react-query-persist-client": "^5.75.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@tanstack/eslint-plugin-query": "^5.73.3",
+    "@tanstack/eslint-plugin-query": "^5.74.7",
     "@types/react": "^18.2.79",
     "@types/react-dom": "^18.2.25",
     "@vitejs/plugin-react": "^4.3.4",

examples/react/chat/package.json

@@ -8,8 +8,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

examples/react/default-query-function/package.json

@@ -8,8 +8,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

examples/react/devtools-panel/package.json

@@ -8,8 +8,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

examples/react/eslint-legacy/package.json

@@ -9,15 +9,15 @@
     "test:eslint": "ESLINT_USE_FLAT_CONFIG=false eslint ./src/**/*.tsx"
   },
   "dependencies": {
-    "@tanstack/query-sync-storage-persister": "^5.74.6",
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
-    "@tanstack/react-query-persist-client": "^5.74.6",
+    "@tanstack/query-sync-storage-persister": "^5.75.4",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
+    "@tanstack/react-query-persist-client": "^5.75.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@tanstack/eslint-plugin-query": "^5.73.3",
+    "@tanstack/eslint-plugin-query": "^5.74.7",
     "@types/react": "^18.2.79",
     "@types/react-dom": "^18.2.25",
     "@vitejs/plugin-react": "^4.3.4",

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

@@ -8,9 +8,9 @@
     "start": "next start"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
-    "next": "^15.1.2",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
+    "next": "^15.3.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },

examples/react/load-more-infinite-scroll/package.json

@@ -8,9 +8,9 @@
     "start": "next start"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
-    "next": "^15.1.2",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
+    "next": "^15.3.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "react-intersection-observer": "^9.16.0"

examples/react/nextjs-app-prefetching/package.json

@@ -8,9 +8,9 @@
     "start": "next start"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
-    "next": "^15.1.2",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
+    "next": "^15.3.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

examples/react/nextjs-suspense-streaming/package.json

@@ -8,10 +8,10 @@
     "start": "next start"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
-    "@tanstack/react-query-next-experimental": "^5.74.4",
-    "next": "^15.1.2",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
+    "@tanstack/react-query-next-experimental": "^5.75.4",
+    "next": "^15.3.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },

examples/react/nextjs/package.json

@@ -8,9 +8,9 @@
     "start": "next start"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
-    "next": "^15.1.2",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
+    "next": "^15.3.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },

examples/react/offline/package.json

@@ -8,11 +8,11 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/query-sync-storage-persister": "^5.74.6",
+    "@tanstack/query-sync-storage-persister": "^5.75.4",
     "@tanstack/react-location": "^3.7.4",
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
-    "@tanstack/react-query-persist-client": "^5.74.6",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
+    "@tanstack/react-query-persist-client": "^5.75.4",
     "msw": "^2.6.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",

examples/react/optimistic-updates-cache/package.json

@@ -8,9 +8,9 @@
     "start": "next start"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.74.4",
-    "@tanstack/react-query-devtools": "^5.74.6",
-    "next": "^15.1.2",
+    "@tanstack/react-query": "^5.75.4",
+    "@tanstack/react-query-devtools": "^5.75.4",
+    "next": "^15.3.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },