@bastidood/oxlint-config-tanstack-query 0.0.0-stage → 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Basti Ortiz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# `@bastidood/oxlint-config-tanstack-query`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+TanStack Query entries for `@bastidood/oxlint-config`, including the rules of `@tanstack/eslint-plugin-query`.
+
+## Installation
+
+```sh
+pnpm add --save-dev @bastidood/oxlint-config-tanstack-query eslint typescript
+```
+
+The plugin loads `eslint` and `typescript` at runtime, so both must be installed even though Oxlint runs the rules.
+
+## Configuration
+
+```ts
+// oxlint.config.ts
+import { compose } from '@bastidood/oxlint-config';
+import { TANSTACK_REACT_QUERY } from '@bastidood/oxlint-config-tanstack-query/react';
+import { CORE } from '@bastidood/oxlint-config/core';
+import { REACT } from '@bastidood/oxlint-config/react';
+import { TANSTACK_QUERY } from '@bastidood/oxlint-config/tanstack/query';
+import { defineConfig } from 'oxlint';
+
+export default defineConfig({
+	extends: [compose(CORE, REACT, TANSTACK_QUERY, TANSTACK_REACT_QUERY)],
+});
+```
+
+## Entry Points
+
+| Entry point                                     | Contents                                                                                                                                                          |
+| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@bastidood/oxlint-config-tanstack-query/react` | Enables `@tanstack/eslint-plugin-query` except `no-void-query-fn`, which needs type information; bans `useQueryClient` and keeping the whole `useMutation` result |
+
+## Limitations
+
+- Rules are not configurable.
+- `no-void-query-fn` is off because Oxlint does not give type information to JS plugins.

package/dist/react.d.mts

@@ -0,0 +1,33 @@
+/**
+ * TanStack React Query rules from `@tanstack/eslint-plugin-query`. `no-void-query-fn` is off because it needs type
+ * information, which Oxlint does not give to JS plugins. The plugin specifier resolves from this package, so that the
+ * consumer does not install the plugin itself.
+ */
+export declare const TANSTACK_REACT_QUERY: {
+  config: {
+    jsPlugins: {
+      name: string;
+      specifier: string;
+    }[];
+    rules: {
+      '@tanstack/query/exhaustive-deps': "error";
+      '@tanstack/query/infinite-query-property-order': "error";
+      '@tanstack/query/mutation-property-order': "error";
+      '@tanstack/query/no-rest-destructuring': "error";
+      '@tanstack/query/no-unstable-deps': "error";
+      '@tanstack/query/prefer-query-options': "error";
+      '@tanstack/query/stable-query-client': "error";
+    };
+  };
+  restrictions: {
+    importPaths: {
+      name: string;
+      importNames: string[];
+      message: string;
+    }[];
+    syntax: {
+      selector: string;
+      message: string;
+    }[];
+  };
+};

package/dist/react.mjs

@@ -0,0 +1,35 @@
+// src/react.ts
+/**
+* TanStack React Query rules from `@tanstack/eslint-plugin-query`. `no-void-query-fn` is off because it needs type
+* information, which Oxlint does not give to JS plugins. The plugin specifier resolves from this package, so that the
+* consumer does not install the plugin itself.
+*/
+const TANSTACK_REACT_QUERY = {
+	config: {
+		jsPlugins: [{
+			name: "@tanstack/query",
+			specifier: import.meta.resolve("@tanstack/eslint-plugin-query")
+		}],
+		rules: {
+			"@tanstack/query/exhaustive-deps": "error",
+			"@tanstack/query/infinite-query-property-order": "error",
+			"@tanstack/query/mutation-property-order": "error",
+			"@tanstack/query/no-rest-destructuring": "error",
+			"@tanstack/query/no-unstable-deps": "error",
+			"@tanstack/query/prefer-query-options": "error",
+			"@tanstack/query/stable-query-client": "error"
+		}
+	},
+	restrictions: {
+		importPaths: [{
+			name: "@tanstack/react-query",
+			importNames: ["useQueryClient"],
+			message: "Perform client actions in mutation success or failure hooks, which receive the query client in context, instead of capturing `useQueryClient`. Suppress this only to call `prefetchQuery` on hover or `ensureQueryData` in an event handler, and name that use in the suppression reason."
+		}],
+		syntax: [{
+			selector: "VariableDeclarator[id.type=\"Identifier\"] > CallExpression[callee.name=\"useMutation\"]",
+			message: "Destructure the fields that you use from `useMutation(...)`. The result object changes identity on every render, so keeping it whole makes it an unstable dependency."
+		}]
+	}
+};
+export { TANSTACK_REACT_QUERY };

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@bastidood/oxlint-config-tanstack-query",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.1",
+  "description": "TanStack Query rules for @bastidood/oxlint-config, including @tanstack/eslint-plugin-query.",
+  "license": "MIT",
+  "homepage": "https://github.com/BastiDood/slopstopper",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BastiDood/slopstopper.git",
+    "directory": "configs/oxlint-tanstack-query"
+  },
+  "type": "module",
+  "exports": {
+    "./react": "./dist/react.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tanstack/eslint-plugin-query": "^5.106.1"
+  },
+  "devDependencies": {
+    "@bastidood/oxlint-config": "0.6.1",
+    "@bastidood/tsconfig": "0.1.1",
+    "@types/node": "^26.6.6",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "oxlint": "^1.92.0",
+    "tsdown": "0.23.5",
+    "typescript": "npm:@typescript/typescript6@^6.0.2"
+  },
+  "peerDependencies": {
+    "@bastidood/oxlint-config": "^0.6.1",
+    "eslint": "^10.0.0",
+    "oxlint": "^1.92.0",
+    "typescript": ">=4.8.4 <6.1.0"
+  },
+  "scripts": {
+    "check": "tsc"
+  }
 }