@shayanthenerd/eslint-config 0.31.0 → 0.33.0

package/README.md

@@ -25,44 +25,45 @@ ESLint configuration for enforcing best practices and maintaining a consistent c
 ## Plugin Support
 Legend:
 - ✅ — **Enabled** by default
+- 🔍 — [**Automatically detected**](#automatic-dependency-detection)
 - ⚙️ — **Opt-in** (requires manual configuration)
-- 🔍 — [**Automatically detected**](#automatic-dependency-detection) (based on project dependencies)
-
-| Category                                                                                              | Activation |
-| :---------------------------------------------------------------------------------------------------- | :--------: |
-| **Languages**                                                                                         |            |
-| [JavaScript][eslint]                                                                                  |     ✅      |
-| [TypeScript][plugin-ts]                                                                               |     🔍      |
-| [Markdown][plugin-md]                                                                                 |     ✅      |
-| [HTML][plugin-html]                                                                                   |     ⚙️      |
-| [CSS][plugin-css]                                                                                     |     ⚙️      |
-| **Formatting**                                                                                        |            |
-| [Stylistic][plugin-stylistic]                                                                         |     ✅      |
-| [Perfectionist][plugin-perfectionist]                                                                 |     ✅      |
-| **Frameworks & Libraries**                                                                            |            |
-| [Astro][plugin-astro] ([jsx-accessibility][plugin-jsx-a11y])                                          |     🔍      |
-| [React][plugin-react] ([jsx-accessibility][plugin-jsx-a11y], [@html-eslint/react][plugin-html-react]) |     🔍      |
-| [Next][plugin-next]                                                                                   |     🔍      |
-| [Vue & Nuxt][plugin-vue] ([vue-accessibility][plugin-vue-a11y])                                       |     🔍      |
-| [Tailwind][plugin-tailwind]                                                                           |     ⚙️      |
-| [Zod & Zod Mini][plugin-zod]                                                                          |     🔍      |
-| **Testing Tools**                                                                                     |            |
-| [Storybook][plugin-storybook]                                                                         |     🔍      |
-| [Vitest][plugin-vitest]                                                                               |     🔍      |
-| [Cypress][plugin-cypress]                                                                             |     🔍      |
-| [Playwright][plugin-playwright]                                                                       |     🔍      |
-| **Miscellaneous**                                                                                     |            |
-| [_package.json_][plugin-package-json]                                                                 |     ✅      |
-| [Node][plugin-n]                                                                                      |     ✅      |
-| [Promises][plugin-promise]                                                                            |     ✅      |
-| [Imports][plugin-import-x]                                                                            |     ✅      |
-| [Unicorn][plugin-unicorn]                                                                             |     ✅      |
-| [Baseline][plugin-baseline] ([css/use-baseline], [@html-eslint/use-baseline], [@html-eslint/react/use-baseline])                                                                                        |     🔍      |
+
+| Category                                                                                                | Activation |
+| :------------------------------------------------------------------------------------------------------ | :--------: |
+| **Languages**                                                                                           |            |
+| [JavaScript][eslint]                                                                                    |     ✅      |
+| [TypeScript][plugin-ts]                                                                                 |     🔍      |
+| [Markdown][plugin-md]                                                                                   |     ✅      |
+| [HTML][plugin-html]                                                                                     |     ⚙️      |
+| [CSS][plugin-css]                                                                                       |     ⚙️      |
+| **Formatting**                                                                                          |            |
+| [Stylistic][plugin-stylistic]                                                                           |     ✅      |
+| [Perfectionist][plugin-perfectionist]                                                                   |     ✅      |
+| **Frameworks & Libraries**                                                                              |            |
+| [Astro][plugin-astro] ([jsx-accessibility][plugin-jsx-a11y-x])                                          |     🔍      |
+| [React][plugin-react] ([jsx-accessibility][plugin-jsx-a11y-x], [@html-eslint/react][plugin-html-react]) |     🔍      |
+| [Next][plugin-next]                                                                                     |     🔍      |
+| [TanStack Start][plugin-tanstack-start], [TanStack Query][plugin-tanstack-query], [TanStack Router][plugin-tanstack-router]                                                                                |     🔍      |
+| [Vue & Nuxt][plugin-vue] ([vue-accessibility][plugin-vue-a11y])                                         |     🔍      |
+| [Tailwind][plugin-tailwind]                                                                             |     ⚙️      |
+| [Zod & Zod Mini][plugin-zod]                                                                            |     🔍      |
+| **Testing Tools**                                                                                       |            |
+| [Storybook][plugin-storybook]                                                                           |     🔍      |
+| [Vitest][plugin-vitest]                                                                                 |     🔍      |
+| [Cypress][plugin-cypress]                                                                               |     🔍      |
+| [Playwright][plugin-playwright]                                                                         |     🔍      |
+| **Miscellaneous**                                                                                       |            |
+| [_package.json_][plugin-package-json]                                                                   |     ✅      |
+| [Node][plugin-n]                                                                                        |     ✅      |
+| [Promises][plugin-promise]                                                                              |     ✅      |
+| [Imports][plugin-import-x]                                                                              |     ✅      |
+| [Unicorn][plugin-unicorn]                                                                               |     ✅      |
+| [Baseline][plugin-baseline] ([css/use-baseline], [@html-eslint/use-baseline], [@html-eslint/react/use-baseline])                                                                                          |     🔍      |
 
 ## Installation and Configuration
 1. Install the package and ESLint as dev dependencies:
    ```shell
-   npm i -D @shayanthenerd/eslint-config eslint
+   pnpm i -D @shayanthenerd/eslint-config eslint
    ```
 
 2. Create an ESLint configuration file (_eslint.config.js_) at the root of your project:
@@ -80,7 +81,7 @@ Legend:
      "scripts": {
        "lint": "eslint --max-warnings=0 --cache --cache-location='node_modules/.cache/.eslintcache'",
        "lint:fix": "eslint --fix --max-warnings=0 --cache --cache-location='node_modules/.cache/.eslintcache'",
-       "lint:inspect": "npx @eslint/config-inspector"
+       "lint:inspect": "pnpx @eslint/config-inspector"
      }
    }
    ```
@@ -88,9 +89,9 @@ Legend:
 ---
 
 After installation:
-- Use `npm run lint` to lint files without modifying them (useful for CI).
-- Use `npm run lint:fix` to lint and fix files.
-- Use `npm run lint:inspect` to see a visual breakdown of your configuration.
+- Use `pnpm run lint` to lint files without modifying them (useful for CI).
+- Use `pnpm run lint:fix` to lint and fix files.
+- Use `pnpm run lint:inspect` to see a visual breakdown of your configuration.
 - See [IDE Support](#ide-support) for editor integration.
 - See [Customization](#customization) for advanced configuration.
 - See [Formatting](#formatting) for formatting options and Prettier integration.
@@ -213,8 +214,27 @@ For editor integration, to reduce noise and avoid inconsistent diagnostics from
 }
 ```
 
+### Astro
+The accessibility rules in [eslint-plugin-astro][plugin-astro] require [eslint-plugin-jsx-a11y-x][plugin-jsx-a11y-x] as a peer dependency. Install it with:
+```shell
+pnpm add -D eslint-plugin-jsx-a11y-x
+```
+When both `astro` and `eslint-plugin-jsx-a11y-x` are detected as dependencies, `configs.astro.accessibility` is set to `true` automatically. To disable the accessibility rules, set `configs.astro.accessibility` to `false`.
+
+### Vue
+[ESLint Stylistic][plugin-stylistic] and [eslint-plugin-vue][plugin-vue] don't format `<style>` blocks inside Vue SFCs. On the other hand, [Prettier][prettier] cannot be limited to just `<style>` blocks, and formats the whole file, including `<script>` and `<template>` blocks, which could conflict with ESLint. To work around this, you may use Tailwind, format styles manually, keep styles in separate `.css` files, or use Prettier and resolve any resulting conflicts.
+
+Read more about the formatting options and Prettier integration in the [Formatting](#formatting) section.
+
 ### Nuxt
-The required Nuxt configurations and rules are already included, so there's no need to install or configure the [@nuxt/eslint][eslint-nuxt] module.
+The required Nuxt configurations and rules are already included, so there's no need to use the [@nuxt/eslint][eslint-nuxt] module.
+
+### React/Next
+The required Next configurations and rules, including for core web vitals, are already provided, so there's no need to use [eslint-config-next][eslint-next]. Similarly, the React integration also provides React-specific configurations and rules for accessibility and React Hooks.
+
+### TanStack Start
+> [!NOTE]
+> The rules in [@tanstack/eslint-plugin-start][plugin-tanstack-start] require type information, and will be disabled automatically if the TypeScript integration is not enabled.
 
 ### Markdown
 Markdown linting is powered by [@eslint/markdown][plugin-md].
@@ -313,7 +333,7 @@ For file types that ESLint Stylistic does not handle—such as CSS, JSON, YAML,
 
   1. Install Prettier as a dev dependency:
      ```shell
-     npm i -D prettier
+     pnpm i -D prettier
      ```
 
   2. Create a Prettier config file in the root of your project (_prettier.config.js_):
@@ -343,7 +363,7 @@ For file types that ESLint Stylistic does not handle—such as CSS, JSON, YAML,
      ```json title="package.json"
      {
        "scripts": {
-         "format": "prettier --write . '!**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx,html,vue,astro}' --cache"
+         "format": "prettier --write . '!pnpm-lock.yaml' '!**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx,html,vue,astro}' --cache"
        }
      }
      ```
@@ -426,7 +446,7 @@ For file types that ESLint Stylistic does not handle—such as CSS, JSON, YAML,
      ```json title="package.json"
      {
        "scripts": {
-         "format": "prettier --write . --cache",
+         "format": "prettier --write . '!pnpm-lock.yaml' --cache",
        }
      }
      ```
@@ -516,6 +536,7 @@ For file types that ESLint Stylistic does not handle—such as CSS, JSON, YAML,
 
     configs?: {
       astro?: boolean | {
+        accessibility?: boolean,
         overrides?: Overrides,
       },
       baseline?: boolean | {
@@ -536,6 +557,7 @@ For file types that ESLint Stylistic does not handle—such as CSS, JSON, YAML,
         overrides?: Overrides,
       },
       css?: boolean | {
+        allowedUnknownPseudoSelectors?: string[],
         overrides?: Overrides,
       },
       html?: boolean | {
@@ -573,6 +595,8 @@ For file types that ESLint Stylistic does not handle—such as CSS, JSON, YAML,
         overrides?: Overrides,
       },
       packageJson?: boolean | {
+        allowedDistTags?: string[],
+        allowedDistTagsFor?: ('dependencies' | 'devDependencies' | 'peerDependencies' | 'optionalDependencies')[],
         overrides?: Overrides,
       },
       perfectionist?: boolean | {
@@ -619,6 +643,12 @@ For file types that ESLint Stylistic does not handle—such as CSS, JSON, YAML,
         multilineSort?: boolean,
         overrides?: Overrides,
       },
+      tanstack?: boolean | {
+        query?: boolean,
+        router?: boolean,
+        start?: boolean,
+        overrides?: Overrides,
+      },
       test?: {
         maxNestedDescribe?: number,
         testFunction?: 'it' | 'test',
@@ -756,7 +786,7 @@ This project was inspired by the work of [Anthony Fu][antfu], whose generous con
 [plugin-html]: https://html-eslint.org
 [plugin-html-react]: https://html-eslint.org/docs/react/getting-started
 [plugin-import-x]: https://github.com/un-ts/eslint-plugin-import-x
-[plugin-jsx-a11y]: https://github.com/jsx-eslint/eslint-plugin-jsx-a11y
+[plugin-jsx-a11y-x]: https://github.com/jsx-eslint/eslint-plugin-jsx-a11y-x
 [plugin-md]: https://github.com/eslint/markdown
 [plugin-n]: https://github.com/eslint-community/eslint-plugin-n
 [plugin-next]: https://github.com/vercel/next.js/tree/HEAD/packages/eslint-plugin-next
@@ -768,6 +798,9 @@ This project was inspired by the work of [Anthony Fu][antfu], whose generous con
 [plugin-storybook]: https://storybook.js.org/docs/configure/integration/eslint-plugin
 [plugin-stylistic]: https://eslint.style
 [plugin-tailwind]: https://github.com/schoero/eslint-plugin-better-tailwindcss
+[plugin-tanstack-query]: https://tanstack.com/query/latest/docs/eslint/eslint-plugin-query
+[plugin-tanstack-router]: https://tanstack.com/router/latest/docs/eslint/eslint-plugin-router
+[plugin-tanstack-start]: https://tanstack.com/start/latest/docs/eslint/eslint-plugin-start
 [plugin-ts]: https://typescript-eslint.io
 [plugin-unicorn]: https://github.com/sindresorhus/eslint-plugin-unicorn
 [plugin-vitest]: https://github.com/vitest-dev/eslint-plugin-vitest
@@ -786,6 +819,7 @@ This project was inspired by the work of [Anthony Fu][antfu], whose generous con
 [eslint]: https://eslint.org
 [online-preview]: https://eslintconfig.netlify.app
 [eslint-config-ts-setup]: https://eslint.org/docs/latest/use/configure/configuration-files#typescript-configuration-files
+[eslint-next]: https://nextjs.org/docs/app/api-reference/config/eslint
 [eslint-nuxt]: https://eslint.nuxt.com
 [local-pkg]: https://github.com/antfu-collective/local-pkg
 [prettier]: https://prettier.io

package/dist/configs/astro.mjs

@@ -6,9 +6,10 @@ import * as eslintParserAstro from "astro-eslint-parser";
 import { mergeConfigs } from "eslint-flat-config-utils";
 import eslintPluginAstro from "eslint-plugin-astro";
 import { parser } from "typescript-eslint";
+import path from "node:path";
 //#region src/configs/astro.ts
 function getAstroConfig(options) {
-	const { astro } = options.configs;
+	const { tsConfig, configs: { astro } } = options;
 	const { overrides } = isEnabled(astro) ? astro : defaultOptions.configs.astro;
 	const astroConfig = {
 		name: "shayanthenerd/astro",
@@ -22,6 +23,9 @@ function getAstroConfig(options) {
 			parser: eslintParserAstro,
 			parserOptions: {
 				parser,
+				projectService: false,
+				project: tsConfig ? path.resolve(tsConfig.rootDir, tsConfig.filename) : void 0,
+				tsconfigRootDir: tsConfig ? path.resolve(tsConfig.rootDir) : void 0,
 				extraFileExtensions: [".astro"]
 			}
 		},

package/dist/configs/javascript.mjs

@@ -9,7 +9,7 @@ import globals from "globals";
 function getJavascriptConfig(options) {
 	const { env, configs: { vue, astro, javascript: { overrides } }, project: { globals: { bun, node, deno, vitest, worker, browser, commonjs, nodeBuiltin, audioWorklet, webextension, sharedWorker, serviceworker, vue: vueGlobals, astro: astroGlobals, custom: userGlobals } } } = options;
 	const baseConfig = {
-		name: "shayanthenerd/base",
+		name: "shayanthenerd/javascript",
 		files: [
 			globs.src,
 			globs.jsxTsx,

package/dist/configs/packageJson.mjs

@@ -13,7 +13,7 @@ function getPackageJsonConfig(options) {
 		files: [globs.packageJson],
 		plugins: { "package-json": eslintPluginPackageJson },
 		languageOptions: { parser: eslintPluginPackageJson.configs.recommended.languageOptions.parser },
-		rules: getPackageJsonRules()
+		rules: getPackageJsonRules(options)
 	};
 	return mergeConfigs(packageJsonConfig, overrides);
 }

package/dist/configs/react.mjs

@@ -4,7 +4,7 @@ import { isEnabled } from "../utils/isEnabled.mjs";
 import { getReactRules } from "../rules/react.mjs";
 import { mergeConfigs } from "eslint-flat-config-utils";
 import eslintPluginUnicorn from "eslint-plugin-unicorn";
-import eslintPluginJsxA11y from "eslint-plugin-jsx-a11y";
+import eslintPluginJsxA11yX from "eslint-plugin-jsx-a11y-x";
 import eslintPluginReact from "@eslint-react/eslint-plugin";
 import eslintPluginHtmlReact from "@html-eslint/eslint-plugin-react";
 //#region src/configs/react.ts
@@ -18,7 +18,7 @@ function getReactConfig(options) {
 			"@eslint-react": eslintPluginReact,
 			"@html-eslint/react": eslintPluginHtmlReact,
 			...isEnabled(unicorn) && { unicorn: eslintPluginUnicorn },
-			...isEnabled(accessibility) && { "jsx-a11y": eslintPluginJsxA11y }
+			...isEnabled(accessibility) && { "jsx-a11y-x": eslintPluginJsxA11yX }
 		},
 		rules: getReactRules(options)
 	};

package/dist/configs/tailwind.mjs

@@ -14,6 +14,11 @@ const astroAttributes = {
 	name: "^class:list$",
 	match: [{ type: MatcherType.String }, { type: MatcherType.ObjectKey }]
 };
+const reactAttributes = {
+	kind: SelectorKind.Attribute,
+	name: "^(?:className|.*Class)$",
+	match: [{ type: MatcherType.String }, { type: MatcherType.ObjectKey }]
+};
 const vueAttributes = {
 	kind: SelectorKind.Attribute,
 	name: "^(?:v-bind:)?(exactActiveClass|activeClass|inactiveClass|active-class|inactive-class)$",
@@ -43,13 +48,14 @@ const nuxtUiAppConfigUiFields = {
 	}]
 };
 function getTailwindConfig(options) {
-	const { tsConfig, configs: { vue, nuxt, html, astro, tailwind } } = options;
+	const { tsConfig, configs: { vue, nuxt, html, astro, react, tailwind } } = options;
 	const { cwd, config, overrides, entryPoint } = isEnabled(tailwind) ? tailwind : defaultOptions.configs.tailwind;
 	const tsconfigPath = tsConfig ? path.resolve(tsConfig.rootDir, tsConfig.filename) : void 0;
 	const isNuxtUiEnabled = isEnabled(nuxt) && isEnabled(nuxt.ui);
 	const selectors = [
 		...getDefaultSelectors(),
 		isEnabled(astro) ? astroAttributes : void 0,
+		isEnabled(react) ? reactAttributes : void 0,
 		isEnabled(vue) ? vueAttributes : void 0,
 		isNuxtUiEnabled ? nuxtUiAttributes : void 0,
 		isNuxtUiEnabled ? nuxtUiAppConfigUiFields : void 0

package/dist/configs/tanstack.mjs

@@ -0,0 +1,26 @@
+import { globs } from "../helpers/globs.mjs";
+import { defaultOptions } from "../helpers/options/defaultOptions.mjs";
+import { isEnabled } from "../utils/isEnabled.mjs";
+import { getTanstackRules } from "../rules/tanstack.mjs";
+import { mergeConfigs } from "eslint-flat-config-utils";
+import eslintPluginTanstackQuery from "@tanstack/eslint-plugin-query";
+import eslintPluginTanstackRouter from "@tanstack/eslint-plugin-router";
+import eslintPluginTanstackStart from "@tanstack/eslint-plugin-start";
+//#region src/configs/tanstack.ts
+function getTanstackConfig(options) {
+	const { tanstack } = options.configs;
+	const { overrides } = isEnabled(tanstack) ? tanstack : defaultOptions.configs.tanstack;
+	const tanstackConfig = {
+		name: "shayanthenerd/tanstack",
+		files: [globs.src, globs.jsxTsx],
+		plugins: isEnabled(tanstack) ? {
+			...isEnabled(tanstack.start) && { "@tanstack/start": eslintPluginTanstackStart },
+			...isEnabled(tanstack.query) && { "@tanstack/query": eslintPluginTanstackQuery },
+			...isEnabled(tanstack.router) && { "@tanstack/router": eslintPluginTanstackRouter }
+		} : {},
+		rules: getTanstackRules(options)
+	};
+	return mergeConfigs(tanstackConfig, overrides);
+}
+//#endregion
+export { getTanstackConfig };

package/dist/configs/typescript.mjs

@@ -8,26 +8,24 @@ import { parser, plugin } from "typescript-eslint";
 import path from "node:path";
 //#region src/configs/typescript.ts
 function getTypescriptConfig(options) {
-	const { tsConfig, configs: { vue, astro, typescript } } = options;
-	const { allowedDefaultProjects } = isEnabled(typescript) ? typescript : defaultOptions.configs.typescript;
+	const { tsConfig, configs: { vue, typescript } } = options;
+	const { allowedDefaultProjects: userAllowedDefaultProjects } = isEnabled(typescript) ? typescript : defaultOptions.configs.typescript;
 	const { overrides } = isEnabled(typescript) ? typescript : defaultOptions.configs.typescript;
 	const typescriptConfig = {
 		name: "shayanthenerd/typescript",
 		files: [
 			globs.src,
 			globs.jsxTsx,
-			isEnabled(vue) ? globs.vue : "",
-			isEnabled(astro) ? globs.astro : ""
+			isEnabled(vue) ? globs.vue : ""
 		].filter(isTruthy),
 		plugins: { "@typescript-eslint": plugin },
 		languageOptions: {
 			parser,
 			parserOptions: {
-				warnOnUnsupportedTypeScriptVersion: false,
 				tsconfigRootDir: tsConfig ? path.resolve(tsConfig.rootDir) : void 0,
 				projectService: {
 					defaultProject: tsConfig ? tsConfig.filename : void 0,
-					allowDefaultProject: ["{prettier,eslint}.config.?([mc])ts", ...allowedDefaultProjects]
+					allowDefaultProject: userAllowedDefaultProjects
 				}
 			}
 		},

package/dist/helpers/ignores/defaultIgnorePatterns.mjs

@@ -1,9 +1,7 @@
 //#region src/helpers/ignores/defaultIgnorePatterns.ts
 const defaultIgnorePatterns = [
-	"**/*.min.*",
 	"**/jspm_packages",
 	"**/pnpm-lock.yaml",
-	"**/bower_components",
 	"**/package-lock.json",
 	"**/typegen.d.ts",
 	"**/next-env.d.ts",
@@ -18,6 +16,7 @@ const defaultIgnorePatterns = [
 	"**/public",
 	"**/output",
 	"**/.output",
+	"**/*.min.*",
 	"**/.serverless",
 	"**/.eslint-config-inspector",
 	"**/tmp",
@@ -29,22 +28,18 @@ const defaultIgnorePatterns = [
 	"**/.cache",
 	"**/deno_dir",
 	"**/.parcel-cache",
-	"**/*.lerna_backup",
 	"**/.postcss-cache",
 	"**/.vitepress/cache",
 	"**/vite.config.*.timestamp-*",
 	"**/.nx",
 	"**/.vite",
-	"**/.yarn",
 	"**/.nuxt",
 	"**/.next",
 	"**/.astro",
 	"**/.vitest",
 	"**/.vercel",
-	"**/.svelte-kit",
 	"**/.vite-inspect",
 	"**/coverage",
-	"**/_fixtures",
 	"**/.nyc_output",
 	"**/__snapshots__",
 	"**/.idea",

package/dist/helpers/options/defaultOptions.mjs

@@ -34,7 +34,10 @@ const defaultOptions = {
 		settings: {}
 	},
 	configs: {
-		astro: { overrides: {} },
+		astro: {
+			accessibility: false,
+			overrides: {}
+		},
 		baseline: {
 			baseline: "widely",
 			css: {
@@ -52,7 +55,10 @@ const defaultOptions = {
 			},
 			overrides: {}
 		},
-		css: { overrides: {} },
+		css: {
+			allowedUnknownPseudoSelectors: [],
+			overrides: {}
+		},
 		html: {
 			idNamingConvention: "snake_case",
 			overrides: {}
@@ -77,7 +83,11 @@ const defaultOptions = {
 			ui: { prefix: "U" },
 			overrides: {}
 		},
-		packageJson: { overrides: {} },
+		packageJson: {
+			allowedDistTags: [],
+			allowedDistTagsFor: [],
+			overrides: {}
+		},
 		perfectionist: {
 			sortType: "line-length",
 			overrides: {}
@@ -131,6 +141,12 @@ const defaultOptions = {
 			multilineSort: true,
 			overrides: {}
 		},
+		tanstack: {
+			query: false,
+			router: false,
+			start: false,
+			overrides: {}
+		},
 		test: {
 			maxNestedDescribe: 1,
 			testFunction: "test",

package/dist/helpers/options/enableDetectedConfigs.mjs

@@ -7,8 +7,12 @@ function enableDetectedConfigs(options) {
 		"typescript": options.configs?.typescript === false,
 		"zod": options.configs?.zod === false,
 		"astro": options.configs?.astro === false,
+		"eslint-plugin-jsx-a11y-x": isEnabled(options.configs?.astro) && options.configs?.astro?.accessibility === false,
 		"react": options.configs?.react === false,
 		"next": options.configs?.next === false,
+		"@tanstack/react-router": isEnabled(options.configs?.tanstack) && options.configs?.tanstack?.router === false,
+		"@tanstack/react-start": isEnabled(options.configs?.tanstack) && options.configs?.tanstack?.start === false,
+		"@tanstack/react-query": isEnabled(options.configs?.tanstack) && options.configs?.tanstack?.query === false,
 		"vue": options.configs?.vue === false,
 		"nuxt": options.configs?.nuxt === false,
 		"@nuxt/ui": isEnabled(options.configs?.nuxt) && options.configs?.nuxt?.ui === false,
@@ -23,8 +27,12 @@ function enableDetectedConfigs(options) {
 		typescript: isPackageDetected("typescript", options),
 		zod: isPackageDetected("zod", options),
 		astro: isPackageDetected("astro", options),
+		eslintPluginJsxA11yX: isPackageDetected("eslint-plugin-jsx-a11y-x", options),
 		react: isPackageDetected("react", options),
 		next: isPackageDetected("next", options),
+		tanstackStart: isPackageDetected("@tanstack/react-start", options),
+		tanstackQuery: isPackageDetected("@tanstack/react-query", options),
+		tanstackRouter: isPackageDetected("@tanstack/react-router", options),
 		vue: isPackageDetected("vue", options),
 		nuxt: isPackageDetected("nuxt", options),
 		nuxtUI: isPackageDetected("@nuxt/ui", options),
@@ -35,6 +43,8 @@ function enableDetectedConfigs(options) {
 		storybook: isPackageDetected("storybook", options),
 		playwright: isPackageDetected("@playwright/test", options)
 	};
+	options.autoDetectDeps ??= defaultOptions.autoDetectDeps;
+	options.env ??= defaultOptions.env;
 	options.configs ??= {};
 	options.configs.test ??= {};
 	options.configs.node ??= true;
@@ -47,7 +57,7 @@ function enableDetectedConfigs(options) {
 	options.configs.importX ??= true;
 	options.configs.stylistic ??= true;
 	options.configs.perfectionist ??= true;
-	options.configs.baseline ??= options.env === "browser";
+	options.configs.baseline ??= options.autoDetectDeps && options.env === "browser";
 	options.configs.typescript ??= autoDetectedPackages.typescript;
 	options.configs.zod ??= autoDetectedPackages.zod;
 	options.configs.astro ??= autoDetectedPackages.astro;
@@ -55,6 +65,7 @@ function enableDetectedConfigs(options) {
 	options.configs.nuxt ??= autoDetectedPackages.nuxt;
 	options.configs.react ??= autoDetectedPackages.react;
 	options.configs.next ??= autoDetectedPackages.next;
+	options.configs.tanstack ??= autoDetectedPackages.tanstackStart || autoDetectedPackages.tanstackQuery || autoDetectedPackages.tanstackRouter;
 	options.configs.test.vitest ??= autoDetectedPackages.vitest;
 	options.configs.test.cypress ??= autoDetectedPackages.cypress;
 	options.configs.test.storybook ??= autoDetectedPackages.storybook;
@@ -82,6 +93,16 @@ function enableDetectedConfigs(options) {
 		options.configs.nuxt.icon ??= autoDetectedPackages.nuxtIcon;
 		options.configs.nuxt.image ??= autoDetectedPackages.nuxtImage;
 	}
+	if (options.configs.astro) {
+		options.configs.astro = options.configs.astro === true ? {} : options.configs.astro;
+		options.configs.astro.accessibility ??= autoDetectedPackages.eslintPluginJsxA11yX;
+	}
+	if (options.configs.tanstack) {
+		if (options.configs.tanstack === true) options.configs.tanstack = {};
+		options.configs.tanstack.start ??= autoDetectedPackages.tanstackStart;
+		options.configs.tanstack.query ??= autoDetectedPackages.tanstackQuery;
+		options.configs.tanstack.router ??= autoDetectedPackages.tanstackRouter;
+	}
 	if (options.autoDetectDeps === "verbose") logDetectedPackages(explicitlyDisabledConfigs);
 	return options;
 }

package/dist/index.d.mts

@@ -1,8 +1,6 @@
 import { Options } from "./types/index.mjs";
 import { Linter } from "eslint";
 //#region src/index.d.ts
-/** Valid argument combinations for `defineConfig`. */
-type DefineConfigArguments = [] | [options: Options] | [configs: Linter.Config[]] | [options: Options, configs: Linter.Config[]];
 /**
  * Define your ESLint configuration based on the provided options and/or custom Flat Config Objects.
  *
@@ -37,6 +35,9 @@ type DefineConfigArguments = [] | [options: Options] | [configs: Linter.Config[]
  *   ],
  * );
  */
-declare function defineConfig(...args: DefineConfigArguments): Linter.Config[];
+declare function defineConfig(): Linter.Config[];
+declare function defineConfig(options: Options): Linter.Config[];
+declare function defineConfig(configs: Linter.Config[]): Linter.Config[];
+declare function defineConfig(options: Options, configs: Linter.Config[]): Linter.Config[];
 //#endregion
 export { defineConfig };

package/dist/index.mjs

@@ -19,6 +19,7 @@ import { getReactConfig } from "./configs/react.mjs";
 import { getStorybookConfig } from "./configs/storybook.mjs";
 import { getStylisticConfig } from "./configs/stylistic.mjs";
 import { getTailwindConfig } from "./configs/tailwind.mjs";
+import { getTanstackConfig } from "./configs/tanstack.mjs";
 import { getTypescriptConfig } from "./configs/typescript.mjs";
 import { getUnicornConfig } from "./configs/unicorn.mjs";
 import { getVitestConfig } from "./configs/vitest.mjs";
@@ -28,40 +29,6 @@ import { getIgnorePatterns } from "./helpers/ignores/getIgnorePatterns.mjs";
 import { mergeWithDefaults } from "./helpers/options/mergeWithDefaults.mjs";
 import { defineConfig as defineConfig$1, globalIgnores } from "eslint/config";
 //#region src/index.ts
-/**
-* Define your ESLint configuration based on the provided options and/or custom Flat Config Objects.
-*
-* @param {...DefineConfigArguments} args The configuration options and/or custom Flat Config objects.
-* @returns {Linter.Config[]} The merged ESLint configuration array
-*
-* @example
-* defineConfig();
-* // or
-* defineConfig({ autoDetectDeps: 'verbose' });
-* // or
-* defineConfig([
-*   {
-*     name: 'custom',
-*     rules: {
-*       'no-console': 'error',
-*     },
-*   },
-*   { ... },
-* ]);
-* // or
-* defineConfig(
-*   { autoDetectDeps: 'verbose' },
-*   [
-*     {
-*       name: 'custom',
-*       rules: {
-*         'no-console': 'error',
-*       },
-*     },
-*     { ... },
-*   ],
-* );
-*/
 function defineConfig(...args) {
 	let options = {};
 	let userConfigs = [];
@@ -72,7 +39,7 @@ function defineConfig(...args) {
 		userConfigs = secondArgument ?? [];
 	}
 	const mergedOptions = mergeWithDefaults(options);
-	const { gitignore, project: { rules, ignores, settings, linterOptions }, configs: { css, vue, zod, html, next, node, nuxt, react, astro, unicorn, importX, promise, baseline, markdown, tailwind, stylistic, typescript, packageJson, perfectionist, test: { vitest, cypress, storybook, playwright } } } = mergedOptions;
+	const { gitignore, project: { rules, ignores, settings, linterOptions }, configs: { css, vue, zod, html, next, node, nuxt, react, astro, unicorn, importX, promise, baseline, markdown, tailwind, tanstack, stylistic, typescript, packageJson, perfectionist, test: { vitest, cypress, storybook, playwright } } } = mergedOptions;
 	const ignorePatterns = getIgnorePatterns({
 		gitignore,
 		patterns: ignores
@@ -103,6 +70,7 @@ function defineConfig(...args) {
 		isEnabled(astro) && getAstroConfig(mergedOptions),
 		isEnabled(react) && getReactConfig(mergedOptions),
 		isEnabled(next) && getNextConfig(mergedOptions),
+		isEnabled(tanstack) && getTanstackConfig(mergedOptions),
 		isEnabled(vue) && getVueConfig(mergedOptions),
 		...isEnabled(nuxt) ? getNuxtConfigs(mergedOptions) : [],
 		isEnabled(storybook) && getStorybookConfig(mergedOptions),