manudeli · pull · Mar 22, 2026 · Mar 22, 2026 · Mar 22, 2026 · Mar 22, 2026
diff --git a/docs/eslint/exhaustive-deps.md b/docs/eslint/exhaustive-deps.md
@@ -26,13 +26,64 @@ const todoQueries = {
 Examples of **correct** code for this rule:
 
 ```tsx
-useQuery({
-  queryKey: ['todo', todoId],
-  queryFn: () => api.getTodo(todoId),
-})
+const Component = ({ todoId }) => {
+  const todos = useTodos()
+  useQuery({
+    queryKey: ['todo', todos, todoId],
+    queryFn: () => todos.getTodo(todoId),
+  })
+}
+```
 
+```tsx
+const todos = createTodos()
 const todoQueries = {
-  detail: (id) => ({ queryKey: ['todo', id], queryFn: () => api.getTodo(id) }),
+  detail: (id) => ({
+    queryKey: ['todo', id],
+    queryFn: () => todos.getTodo(id),
+  }),
+}
+```
+
+```tsx
+// with { allowlist: { variables: ["todos"] }}
+const Component = ({ todoId }) => {
+  const todos = useTodos()
+  useQuery({
+    queryKey: ['todo', todoId],
+    queryFn: () => todos.getTodo(todoId),
+  })
+}
+```
+
+```tsx
+// with { allowlist: { types: ["TodosClient"] }}
+class TodosClient { ... }
+const Component = ({ todoId }) => {
+  const todos: TodosClient = new TodosClient()
+  useQuery({
+    queryKey: ['todo', todoId],
+    queryFn: () => todos.getTodo(todoId),
+  })
+}
+```
+
+### Options
+
+- `allowlist.variables`: An array of variable names that should be ignored when checking dependencies
+- `allowlist.types`: An array of TypeScript type names that should be ignored when checking dependencies
+
+```json
+{
+  "@tanstack/query/exhaustive-deps": [
+    "error",
+    {
+      "allowlist": {
+        "variables": ["api", "config"],
+        "types": ["ApiClient", "Config"]
+      }
+    }
+  ]
 }
 ```
 

diff --git a/examples/angular/auto-refetching/package.json b/examples/angular/auto-refetching/package.json
@@ -13,7 +13,7 @@
     "@angular/compiler": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/angular/basic-persister/package.json b/examples/angular/basic-persister/package.json
@@ -13,9 +13,9 @@
     "@angular/compiler": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
-    "@tanstack/angular-query-persist-client": "^5.94.5",
-    "@tanstack/query-async-storage-persister": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
+    "@tanstack/angular-query-persist-client": "^5.95.0",
+    "@tanstack/query-async-storage-persister": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/angular/basic/package.json b/examples/angular/basic/package.json
@@ -13,7 +13,7 @@
     "@angular/compiler": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/angular/devtools-panel/package.json b/examples/angular/devtools-panel/package.json
@@ -14,7 +14,7 @@
     "@angular/core": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
     "@angular/router": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/angular/infinite-query-with-max-pages/package.json b/examples/angular/infinite-query-with-max-pages/package.json
@@ -13,7 +13,7 @@
     "@angular/compiler": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/angular/optimistic-updates/package.json b/examples/angular/optimistic-updates/package.json
@@ -14,7 +14,7 @@
     "@angular/core": "^20.0.0",
     "@angular/forms": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/angular/pagination/package.json b/examples/angular/pagination/package.json
@@ -13,7 +13,7 @@
     "@angular/compiler": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/angular/query-options-from-a-service/package.json b/examples/angular/query-options-from-a-service/package.json
@@ -14,7 +14,7 @@
     "@angular/core": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
     "@angular/router": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/angular/router/package.json b/examples/angular/router/package.json
@@ -14,7 +14,7 @@
     "@angular/core": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
     "@angular/router": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/angular/rxjs/package.json b/examples/angular/rxjs/package.json
@@ -14,7 +14,7 @@
     "@angular/core": "^20.0.0",
     "@angular/forms": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/angular/simple/package.json b/examples/angular/simple/package.json
@@ -13,7 +13,7 @@
     "@angular/compiler": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/platform-browser": "^20.0.0",
-    "@tanstack/angular-query-experimental": "^5.94.5",
+    "@tanstack/angular-query-experimental": "^5.95.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "0.15.0"

diff --git a/examples/react/algolia/package.json b/examples/react/algolia/package.json
@@ -9,13 +9,13 @@
   },
   "dependencies": {
     "@algolia/client-search": "5.2.1",
-    "@tanstack/react-query": "^5.94.5",
-    "@tanstack/react-query-devtools": "^5.94.5",
+    "@tanstack/react-query": "^5.95.0",
+    "@tanstack/react-query-devtools": "^5.95.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@tanstack/eslint-plugin-query": "^5.94.5",
+    "@tanstack/eslint-plugin-query": "^5.95.0",
     "@types/react": "^18.2.79",
     "@types/react-dom": "^18.2.25",
     "@vitejs/plugin-react": "^4.3.4",

diff --git a/examples/react/algolia/src/index.tsx b/examples/react/algolia/src/index.tsx
@@ -2,5 +2,6 @@ import ReactDOM from 'react-dom/client'
 
 import App from './App'
 
-const rootElement = document.getElementById('root') as HTMLElement
+const rootElement = document.getElementById('root')
+if (!rootElement) throw new Error('Missing #root element')
 ReactDOM.createRoot(rootElement).render(<App />)
diff --git a/examples/react/auto-refetching/package.json b/examples/react/auto-refetching/package.json
@@ -8,8 +8,8 @@
     "start": "next start"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.94.5",
-    "@tanstack/react-query-devtools": "^5.94.5",
+    "@tanstack/react-query": "^5.95.0",
+    "@tanstack/react-query-devtools": "^5.95.0",
     "next": "^16.0.7",
     "react": "^19.2.1",
     "react-dom": "^19.2.1"

diff --git a/examples/react/basic-graphql-request/package.json b/examples/react/basic-graphql-request/package.json
@@ -8,8 +8,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.94.5",
-    "@tanstack/react-query-devtools": "^5.94.5",
+    "@tanstack/react-query": "^5.95.0",
+    "@tanstack/react-query-devtools": "^5.95.0",
     "graphql": "^16.9.0",
     "graphql-request": "^7.1.2",
     "react": "^19.0.0",

diff --git a/examples/react/basic-graphql-request/src/index.tsx b/examples/react/basic-graphql-request/src/index.tsx
@@ -172,5 +172,6 @@ function Post({
   )
 }
 
-const rootElement = document.getElementById('root') as HTMLElement
+const rootElement = document.getElementById('root')
+if (!rootElement) throw new Error('Missing #root element')
 ReactDOM.createRoot(rootElement).render(<App />)
diff --git a/examples/react/basic/package.json b/examples/react/basic/package.json
@@ -9,15 +9,15 @@
     "test:eslint": "eslint ./src"
   },
   "dependencies": {
-    "@tanstack/query-async-storage-persister": "^5.94.5",
-    "@tanstack/react-query": "^5.94.5",
-    "@tanstack/react-query-devtools": "^5.94.5",
-    "@tanstack/react-query-persist-client": "^5.94.5",
+    "@tanstack/query-async-storage-persister": "^5.95.0",
+    "@tanstack/react-query": "^5.95.0",
+    "@tanstack/react-query-devtools": "^5.95.0",
+    "@tanstack/react-query-persist-client": "^5.95.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@tanstack/eslint-plugin-query": "^5.94.5",
+    "@tanstack/eslint-plugin-query": "^5.95.0",
     "@types/react": "^18.2.79",
     "@types/react-dom": "^18.2.25",
     "@vitejs/plugin-react": "^4.3.4",

diff --git a/examples/react/chat/package.json b/examples/react/chat/package.json
@@ -8,8 +8,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.94.5",
-    "@tanstack/react-query-devtools": "^5.94.5",
+    "@tanstack/react-query": "^5.95.0",
+    "@tanstack/react-query-devtools": "^5.95.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

diff --git a/examples/react/chat/src/index.tsx b/examples/react/chat/src/index.tsx
@@ -96,5 +96,6 @@ function Example() {
   )
 }
 
-const rootElement = document.getElementById('root') as HTMLElement
+const rootElement = document.getElementById('root')
+if (!rootElement) throw new Error('Missing #root element')
 ReactDOM.createRoot(rootElement).render(<App />)
diff --git a/examples/react/default-query-function/package.json b/examples/react/default-query-function/package.json
@@ -8,8 +8,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.94.5",
-    "@tanstack/react-query-devtools": "^5.94.5",
+    "@tanstack/react-query": "^5.95.0",
+    "@tanstack/react-query-devtools": "^5.95.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

diff --git a/examples/react/default-query-function/src/index.tsx b/examples/react/default-query-function/src/index.tsx
@@ -146,5 +146,6 @@ function Post({
   )
 }
 
-const rootElement = document.getElementById('root') as HTMLElement
+const rootElement = document.getElementById('root')
+if (!rootElement) throw new Error('Missing #root element')
 ReactDOM.createRoot(rootElement).render(<App />)
diff --git a/examples/react/devtools-panel/package.json b/examples/react/devtools-panel/package.json
@@ -8,8 +8,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.94.5",
-    "@tanstack/react-query-devtools": "^5.94.5",
+    "@tanstack/react-query": "^5.95.0",
+    "@tanstack/react-query-devtools": "^5.95.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

diff --git a/examples/react/devtools-panel/src/index.tsx b/examples/react/devtools-panel/src/index.tsx
@@ -54,5 +54,6 @@ function Example() {
   )
 }
 
-const rootElement = document.getElementById('root') as HTMLElement
+const rootElement = document.getElementById('root')
+if (!rootElement) throw new Error('Missing #root element')
 ReactDOM.createRoot(rootElement).render(<App />)
diff --git a/examples/react/eslint-legacy/package.json b/examples/react/eslint-legacy/package.json
@@ -9,15 +9,15 @@
     "test:eslint": "ESLINT_USE_FLAT_CONFIG=false eslint ./src/**/*.tsx"
   },
   "dependencies": {
-    "@tanstack/query-async-storage-persister": "^5.94.5",
-    "@tanstack/react-query": "^5.94.5",
-    "@tanstack/react-query-devtools": "^5.94.5",
-    "@tanstack/react-query-persist-client": "^5.94.5",
+    "@tanstack/query-async-storage-persister": "^5.95.0",
+    "@tanstack/react-query": "^5.95.0",
+    "@tanstack/react-query-devtools": "^5.95.0",
+    "@tanstack/react-query-persist-client": "^5.95.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@tanstack/eslint-plugin-query": "^5.94.5",
+    "@tanstack/eslint-plugin-query": "^5.95.0",
     "@types/react": "^18.2.79",
     "@types/react-dom": "^18.2.25",
     "@vitejs/plugin-react": "^4.3.4",

diff --git a/examples/react/eslint-legacy/src/index.tsx b/examples/react/eslint-legacy/src/index.tsx
@@ -157,5 +157,6 @@ function App() {
   )
 }
 
-const rootElement = document.getElementById('root') as HTMLElement
+const rootElement = document.getElementById('root')
+if (!rootElement) throw new Error('Missing #root element')
 ReactDOM.createRoot(rootElement).render(<App />)
diff --git a/examples/react/eslint-plugin-demo/eslint.config.js b/examples/react/eslint-plugin-demo/eslint.config.js
@@ -0,0 +1,21 @@
+import pluginQuery from '@tanstack/eslint-plugin-query'
+import tseslint from 'typescript-eslint'
+
+export default [
+  ...tseslint.configs.recommended,
+  ...pluginQuery.configs['flat/recommended'],
+  {
+    files: ['src/**/*.ts', 'src/**/*.tsx'],
+    rules: {
+      '@tanstack/query/exhaustive-deps': [
+        'error',
+        {
+          allowlist: {
+            variables: ['api'],
+            types: ['AnalyticsClient'],
+          },
+        },
+      ],
+    },
+  },
+]
diff --git a/examples/react/eslint-plugin-demo/package.json b/examples/react/eslint-plugin-demo/package.json
@@ -0,0 +1,27 @@
+{
+  "name": "@tanstack/query-example-eslint-plugin-demo",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test:eslint": "eslint ./src"
+  },
+  "dependencies": {
+    "@tanstack/react-query": "^5.95.0",
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "@tanstack/eslint-plugin-query": "^5.95.0",
+    "eslint": "^9.39.0",
+    "typescript": "5.8.3",
+    "typescript-eslint": "^8.48.0"
+  },
+  "nx": {
+    "targets": {
+      "test:eslint": {
+        "dependsOn": [
+          "^build"
+        ]
+      }
+    }
+  }
+}