@fullstacksjs/eslint-config 11.9.0 → 11.10.0

package/README.md

@@ -16,9 +16,11 @@
 $ npm install --save-dev @fullstacksjs/eslint-config eslint prettier
 ```
 
+⚡️ That's it, you don't need to install any eslint-plugin!  If you already have some plugins installed, please remove them.
+
 ## Usage
 
-To use the configuration, all you need is to export the generated config by the `defineConfig` function. The configuration reads the metadata from your root `package.json` file and automatically adds the rules and plugins that are needed.
+To use the configuration, all you need is to export the generated config by the `defineConfig` function. It automatically enables required plugins with **Auto Module Detection**.
 
 ### ESM
 
@@ -36,7 +38,13 @@ const { defineConfig } = require('@fullstacksjs/eslint-config');
 module.exports = defineConfig();
 ```
 
-## Modules API
+## How Module Detection Works
+
+Automatic module detection enables ESLint plugins based on the dependencies listed in your `package.json`. It scans your project to identify which tools you're using, and then activates the corresponding ESLint plugins accordingly.
+
+For example, if your `package.json` includes `vitest` as a dependency, the configuration will automatically enable `eslint-plugin-vitest` for you. (You don't need to install the plugin itself)
+
+### Modules API
 
 You can fine-tune module detection by overriding it, the `defineConfig` function accepts options as its first argument to control enabled modules.
 
@@ -69,7 +77,7 @@ interface Options {
 }
 ```
 
-## Extra configuration
+## What if I want to add my one rules
 
 You can pass any number of arbitrary custom config overrides to `defineConfig` function:
 
@@ -93,11 +101,25 @@ export default defineConfig(
   })
 ```
 
-## Next.JS Warning
+## What If I Want to Use a Plugin That Isn't Supported?
+
+You can still use any ESLint plugin, even if it's not supported by automatic detection. Simply install the plugin manually and add it to the `defineConfig`. There are no limitations.
+
+```js
+import { defineConfig } from '@fullstacksjs/eslint-config';
+import pluginVue from 'eslint-plugin-vue';
+
+export default defineConfig(
+  { typescript: true },
+  ...pluginVue.configs['flat/recommended']
+)
+```
+
+## I'm Getting a Next.js Warning: Plugin Was Not Detected
 
-**Question**: I'm getting "The Next.js plugin was not detected in your ESLint" warning.
+This configuration includes built-in support for [Next.js](https://nextjs.org). The warning you're seeing from Next.js is misleading—it simply checks whether the plugin is explicitly listed in your package.json.
 
-**Answer**: This plugin has built-in support for Next.js. The warning from Next.js is misleading—Next.js simply checks `package.json` to see if the plugin is listed. You can safely ignore the warning or update your lint script from `next lint` to `eslint`.
+You can safely ignore this warning. Alternatively, you can update your lint script from next lint to eslint to avoid it entirely.
 
 ## Speed Optimization!
 

package/cjs/modules/imports.js

@@ -41,7 +41,22 @@ function imports(options = {}) {
     },
     rules: {
       'import/consistent-type-specifier-style': ['warn', 'prefer-top-level'],
-      // 'import/extensions': ['error', 'ignorePackages', ignorePackages: true, js: opt, jsx: opt, mjs: opt, cjs: opt, ...(options.typescript && { ts: opt, tsx: opt, mts: opt, cts: opt, }), ], FIXME: This rule is broken!
+      /*
+      * FIXME: This rule is broken!
+        const opt = options.esm ? 'always' : 'never';
+      'import/extensions': [
+        'error',
+        opt,
+        {
+          ignorePackages: true,
+          js: opt,
+          jsx: opt,
+          mjs: opt,
+          cjs: opt,
+          ...(options.typescript && { ts: opt, tsx: opt, mts: opt, cts: opt }),
+        },
+      ],
+      */
       'import/first': 'error',
       'import/newline-after-import': 'warn',
       'import/no-absolute-path': 'error',

package/cjs/modules/react.js

@@ -24,17 +24,20 @@ function react() {
     },
     rules: {
       '@eslint-react/dom/no-children-in-void-dom-elements': 'warn',
-      '@eslint-react/dom/no-dangerously-set-innerhtml': 'off',
       '@eslint-react/dom/no-dangerously-set-innerhtml-with-children': 'error',
+      '@eslint-react/dom/no-dangerously-set-innerhtml': 'off',
       '@eslint-react/dom/no-find-dom-node': 'error',
+      '@eslint-react/dom/no-flush-sync': 'off',
+      '@eslint-react/dom/no-hydrate': 'warn',
       '@eslint-react/dom/no-missing-button-type': 'warn',
       '@eslint-react/dom/no-missing-iframe-sandbox': 'warn',
       '@eslint-react/dom/no-namespace': 'error',
       '@eslint-react/dom/no-render-return-value': 'error',
+      '@eslint-react/dom/no-render': 'warn',
       '@eslint-react/dom/no-script-url': 'warn',
       '@eslint-react/dom/no-unsafe-iframe-sandbox': 'warn',
       '@eslint-react/dom/no-unsafe-target-blank': 'warn',
-      '@eslint-react/ensure-forward-ref-using-ref': 'warn',
+      '@eslint-react/ensure-forward-ref-using-ref': 'off',
       '@eslint-react/no-access-state-in-setstate': 'error',
       '@eslint-react/no-array-index-key': 'warn',
       '@eslint-react/no-children-count': 'warn',
@@ -52,8 +55,9 @@ function react() {
       '@eslint-react/no-direct-mutation-state': 'error',
       '@eslint-react/no-duplicate-key': 'error',
       '@eslint-react/no-implicit-key': 'error',
+      '@eslint-react/no-missing-context-display-name': 'off',
       '@eslint-react/no-missing-key': 'error',
-      '@eslint-react/no-nested-components': 'warn',
+      '@eslint-react/no-nested-component-definitions': 'warn',
       '@eslint-react/no-redundant-should-component-update': 'error',
       '@eslint-react/no-set-state-in-component-did-mount': 'warn',
       '@eslint-react/no-set-state-in-component-did-update': 'warn',
@@ -66,6 +70,7 @@ function react() {
       '@eslint-react/no-unstable-default-props': 'error',
       '@eslint-react/no-unused-class-component-members': 'warn',
       '@eslint-react/no-unused-state': 'warn',
+      '@eslint-react/no-useless-forward-ref': 'warn',
       '@eslint-react/no-useless-fragment': 'warn',
       '@eslint-react/prefer-destructuring-assignment': 'warn',
       '@eslint-react/prefer-shorthand-boolean': 'warn',
@@ -75,11 +80,12 @@ function react() {
       '@eslint-react/hooks-extra/prefer-use-state-lazy-initialization': 'warn',
       '@eslint-react/hooks-extra/no-useless-custom-hooks': 'warn',
       '@eslint-react/naming-convention/component-name': 'warn',
-      '@eslint-react/naming-convention/filename': 'off',
+      '@eslint-react/naming-convention/context-name': 'warn',
       '@eslint-react/naming-convention/filename-extension': ['error', {
         allow: 'always',
         extensions: ['.jsx', '.tsx']
       }],
+      '@eslint-react/naming-convention/filename': 'off',
       '@eslint-react/naming-convention/use-state': 'off',
       'react-hooks/exhaustive-deps': 'warn',
       'react-hooks/rules-of-hooks': 'error',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullstacksjs/eslint-config",
-  "version": "11.9.0",
+  "version": "11.10.0",
   "license": "MIT",
   "author": "fullstacks <fullstacksjs@gmail.com>",
   "description": "fullstacks eslint config",
@@ -34,22 +34,22 @@
     }
   },
   "dependencies": {
-    "@eslint-react/eslint-plugin": "1.28.0",
-    "@next/eslint-plugin-next": "15.1.7",
-    "@stylistic/eslint-plugin": "4.1.0",
+    "@eslint-react/eslint-plugin": "1.37.3",
+    "@next/eslint-plugin-next": "15.2.3",
+    "@stylistic/eslint-plugin": "4.2.0",
     "deepmerge": "4.3.1",
-    "eslint-plugin-cypress": "4.1.0",
-    "eslint-plugin-import-x": "4.6.1",
+    "eslint-plugin-cypress": "4.2.0",
+    "eslint-plugin-import-x": "4.9.1",
     "eslint-plugin-jest": "28.11.0",
     "eslint-plugin-jest-formatting": "3.1.0",
     "eslint-plugin-jsx-a11y": "6.10.2",
-    "eslint-plugin-n": "17.15.1",
-    "eslint-plugin-perfectionist": "4.9.0",
+    "eslint-plugin-n": "17.16.2",
+    "eslint-plugin-perfectionist": "4.10.1",
     "eslint-plugin-playwright": "2.2.0",
     "eslint-plugin-prettier": "5.2.3",
     "eslint-plugin-promise": "7.2.1",
-    "eslint-plugin-react-hooks": "5.1.0",
-    "eslint-plugin-storybook": "0.11.3",
+    "eslint-plugin-react-hooks": "5.2.0",
+    "eslint-plugin-storybook": "0.11.6",
     "eslint-plugin-tailwindcss": "3.18.0",
     "eslint-plugin-vitest": "0.5.4",
     "globals": "16.0.0",
@@ -57,14 +57,14 @@
     "typescript-eslint": "8.27.0"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "3.3.0",
-    "@eslint/js": "9.22.0",
+    "@eslint/eslintrc": "3.3.1",
+    "@eslint/js": "9.23.0",
     "@semantic-release/github": "11.0.1",
     "@semantic-release/npm": "12.0.1",
     "@semantic-release/release-notes-generator": "14.0.3",
     "@types/eslint": "9.6.1",
     "cspell": "8.17.5",
-    "eslint": "9.22.0",
+    "eslint": "9.23.0",
     "husky": "9.1.7",
     "jest": "29.7.0",
     "lint-staged": "15.5.0",
@@ -77,7 +77,7 @@
   },
   "peerDependencies": {
     "cypress": ">=8",
-    "eslint": "^9",
+    "eslint": ">=9.22",
     "prettier": "3",
     "react": ">=16",
     "typescript": ">=4.7"

package/src/modules/imports.mjs

@@ -32,7 +32,22 @@ function imports(options = {}) {
 
     rules: {
       'import/consistent-type-specifier-style': ['warn', 'prefer-top-level'],
-      // 'import/extensions': ['error', 'ignorePackages', ignorePackages: true, js: opt, jsx: opt, mjs: opt, cjs: opt, ...(options.typescript && { ts: opt, tsx: opt, mts: opt, cts: opt, }), ], FIXME: This rule is broken!
+      /*
+      * FIXME: This rule is broken!
+        const opt = options.esm ? 'always' : 'never';
+      'import/extensions': [
+        'error',
+        opt,
+        {
+          ignorePackages: true,
+          js: opt,
+          jsx: opt,
+          mjs: opt,
+          cjs: opt,
+          ...(options.typescript && { ts: opt, tsx: opt, mts: opt, cts: opt }),
+        },
+      ],
+      */
       'import/first': 'error',
       'import/newline-after-import': 'warn',
       'import/no-absolute-path': 'error',

package/src/modules/react.mjs

@@ -18,18 +18,20 @@ function react() {
     },
     rules: {
       '@eslint-react/dom/no-children-in-void-dom-elements': 'warn',
-      '@eslint-react/dom/no-dangerously-set-innerhtml': 'off',
       '@eslint-react/dom/no-dangerously-set-innerhtml-with-children': 'error',
+      '@eslint-react/dom/no-dangerously-set-innerhtml': 'off',
       '@eslint-react/dom/no-find-dom-node': 'error',
+      '@eslint-react/dom/no-flush-sync': 'off',
+      '@eslint-react/dom/no-hydrate': 'warn',
       '@eslint-react/dom/no-missing-button-type': 'warn',
       '@eslint-react/dom/no-missing-iframe-sandbox': 'warn',
       '@eslint-react/dom/no-namespace': 'error',
       '@eslint-react/dom/no-render-return-value': 'error',
+      '@eslint-react/dom/no-render': 'warn',
       '@eslint-react/dom/no-script-url': 'warn',
       '@eslint-react/dom/no-unsafe-iframe-sandbox': 'warn',
       '@eslint-react/dom/no-unsafe-target-blank': 'warn',
-
-      '@eslint-react/ensure-forward-ref-using-ref': 'warn',
+      '@eslint-react/ensure-forward-ref-using-ref': 'off',
       '@eslint-react/no-access-state-in-setstate': 'error',
       '@eslint-react/no-array-index-key': 'warn',
       '@eslint-react/no-children-count': 'warn',
@@ -47,8 +49,9 @@ function react() {
       '@eslint-react/no-direct-mutation-state': 'error',
       '@eslint-react/no-duplicate-key': 'error',
       '@eslint-react/no-implicit-key': 'error',
+      '@eslint-react/no-missing-context-display-name': 'off',
       '@eslint-react/no-missing-key': 'error',
-      '@eslint-react/no-nested-components': 'warn',
+      '@eslint-react/no-nested-component-definitions': 'warn',
       '@eslint-react/no-redundant-should-component-update': 'error',
       '@eslint-react/no-set-state-in-component-did-mount': 'warn',
       '@eslint-react/no-set-state-in-component-did-update': 'warn',
@@ -61,6 +64,7 @@ function react() {
       '@eslint-react/no-unstable-default-props': 'error',
       '@eslint-react/no-unused-class-component-members': 'warn',
       '@eslint-react/no-unused-state': 'warn',
+      '@eslint-react/no-useless-forward-ref': 'warn',
       '@eslint-react/no-useless-fragment': 'warn',
       '@eslint-react/prefer-destructuring-assignment': 'warn',
       '@eslint-react/prefer-shorthand-boolean': 'warn',
@@ -72,8 +76,9 @@ function react() {
       '@eslint-react/hooks-extra/no-useless-custom-hooks': 'warn',
 
       '@eslint-react/naming-convention/component-name': 'warn',
-      '@eslint-react/naming-convention/filename': 'off',
+      '@eslint-react/naming-convention/context-name': 'warn',
       '@eslint-react/naming-convention/filename-extension': ['error', { allow: 'always', extensions: ['.jsx', '.tsx'] }],
+      '@eslint-react/naming-convention/filename': 'off',
       '@eslint-react/naming-convention/use-state': 'off',
 
       'react-hooks/exhaustive-deps': 'warn',