@fullstacksjs/eslint-config 14.6.0 → 14.7.0

package/cjs/types/modules/react.d.ts

@@ -1,5 +1,10 @@
 import type { ConfigWithOverrides } from '..';
 
 interface ReactOptions extends ConfigWithOverrides {
+  version?: string;
+  importSource?: string;
+  compilationMode?: 'all' | 'annotation' | 'infer' | 'syntax'; // Use the same compilationMode as the React Compiler config for consistent analysis
+  polymorphicPropName?: string;
+  additionalStateHooks?: string;
   additionalEffectHooks?: string;
 }

package/cjs/types/modules/regex.d.ts

@@ -1,5 +1,5 @@
 import type { ConfigWithOverrides } from '..';
 
 interface RegexOptions extends ConfigWithOverrides {
-  allowedCharacterRanges: string[];
+  allowedCharacterRanges?: string[];
 }

package/cjs/types/modules/tailwind.d.ts

@@ -1,18 +1,11 @@
 import type { ConfigWithOverrides } from '..';
 
-interface TailwindOptionsBase extends ConfigWithOverrides {
-  callees?: string[];
-  variables?: string[];
-  attributes?: string[];
-  tags?: string[];
-}
-
-interface TailwindOptionsWithEntryPoint extends TailwindOptionsBase {
+interface TailwindOptionsWithEntryPoint extends ConfigWithOverrides {
   entryPoint: string;
   tailwindConfig?: string;
 }
 
-interface TailwindOptionsWithConfig extends TailwindOptionsBase {
+interface TailwindOptionsWithConfig extends ConfigWithOverrides {
   entryPoint?: string;
   tailwindConfig: string;
 }

package/cjs/utils/nextAllowExportNames.js

@@ -0,0 +1,7 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.nextAllowExportNames = void 0;
+const nextAllowExportNames = exports.nextAllowExportNames = ['experimental_ppr', 'dynamic', 'dynamicParams', 'revalidate', 'fetchCache', 'runtime', 'preferredRegion', 'maxDuration', 'metadata', 'generateMetadata', 'viewport', 'generateViewport', 'generateImageMetadata', 'generateSitemaps', 'generateStaticParams'];

package/cjs/utils/objectOrEmpty.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.objectOrEmpty = objectOrEmpty;
+/**
+ * @template T
+ * @param {T | null | undefined} value
+ * @returns {T | {}}
+ */
+function objectOrEmpty(value) {
+  return typeof value === 'object' && value !== null ? value : {};
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullstacksjs/eslint-config",
-  "version": "14.6.0",
+  "version": "14.7.0",
   "license": "MIT",
   "author": "fullstacks <fullstacksjs@gmail.com>",
   "description": "fullstacks eslint config",
@@ -16,7 +16,7 @@
     "src",
     "cjs"
   ],
-  "packageManager": "npm@11.13.0",
+  "packageManager": "npm@11.16.0",
   "scripts": {
     "lint": "eslint .",
     "spell": "cspell ./* --no-progress",
@@ -38,11 +38,11 @@
     }
   },
   "dependencies": {
-    "@eslint-react/eslint-plugin": "5.8.3",
+    "@eslint-react/eslint-plugin": "5.8.16",
     "@eslint/compat": "2.1.0",
-    "@next/eslint-plugin-next": "16.2.6",
+    "@next/eslint-plugin-next": "16.2.7",
     "@stylistic/eslint-plugin": "5.10.0",
-    "@vitest/eslint-plugin": "1.6.17",
+    "@vitest/eslint-plugin": "1.6.19",
     "deepmerge": "4.3.1",
     "eslint-flat-config-utils": "3.2.0",
     "eslint-plugin-better-tailwindcss": "4.5.0",
@@ -53,14 +53,14 @@
     "eslint-plugin-n": "18.0.1",
     "eslint-plugin-perfectionist": "5.9.0",
     "eslint-plugin-playwright": "2.10.4",
-    "eslint-plugin-prettier": "5.5.5",
+    "eslint-plugin-prettier": "5.5.6",
     "eslint-plugin-promise": "7.3.0",
-    "eslint-plugin-react-hooks": "7.1.1",
+    "eslint-plugin-react-refresh": "0.5.2",
     "eslint-plugin-regexp": "3.1.0",
-    "eslint-plugin-storybook": "10.4.0",
+    "eslint-plugin-storybook": "10.4.2",
     "globals": "17.6.0",
     "local-pkg": "1.2.1",
-    "typescript-eslint": "8.59.4"
+    "typescript-eslint": "8.61.0"
   },
   "devDependencies": {
     "@eslint/eslintrc": "3.3.5",
@@ -69,15 +69,15 @@
     "@semantic-release/npm": "13.1.5",
     "@semantic-release/release-notes-generator": "14.1.1",
     "@types/eslint": "9.6.1",
-    "cspell": "10.0.0",
-    "eslint": "10.4.0",
+    "cspell": "10.0.1",
+    "eslint": "10.4.1",
     "husky": "9.1.7",
     "jest": "30.4.2",
-    "lint-staged": "17.0.5",
+    "lint-staged": "17.0.7",
     "pinst": "3.0.0",
     "prettier": "3.8.3",
     "semantic-release": "25.0.3",
-    "storybook": "10.4.0",
+    "storybook": "10.4.2",
     "typescript": "6.0.3",
     "unbuild": "3.6.1"
   },

package/src/modules/base.mjs

@@ -2,12 +2,15 @@ import { mergeConfigs } from 'eslint-flat-config-utils';
 import globals from 'globals';
 
 import { strict } from '../utils/conditions.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
 
 /**
  * @param { import('../types').Options } options
  * @return { import('eslint').Linter.Config }
  */
 function base(options = {}) {
+  const overrides = objectOrEmpty(options.base.overrides);
+
   const baseConfig = {
     name: 'base',
     languageOptions: {
@@ -197,7 +200,7 @@ function base(options = {}) {
     },
   };
 
-  return mergeConfigs(baseConfig, options.base.overrides ?? {});
+  return mergeConfigs(baseConfig, overrides);
 }
 
 export default base;

package/src/modules/cypress.mjs

@@ -2,12 +2,15 @@ import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-cypress';
 
 import { globs } from '../utils/globs.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
 
 /**
  * @param { import('../types').Options } options
  * @return { import('eslint').Linter.Config }
  */
 function cypress(options = {}) {
+  const overrides = objectOrEmpty(options.cypress.overrides);
+
   const cypressConfig = {
     name: 'cypress',
     files: globs.e2e,
@@ -26,7 +29,7 @@ function cypress(options = {}) {
     },
   };
 
-  return mergeConfigs(cypressConfig, options.cypress.overrides ?? {});
+  return mergeConfigs(cypressConfig, overrides);
 }
 
 export default cypress;

package/src/modules/imports.mjs

@@ -2,6 +2,7 @@ import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-import-x';
 
 import { predicate } from '../utils/conditions.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
 
 const tsExtensions = ['.ts', '.tsx', '.cts', '.mts', '.ctsx', '.mtsx'];
 const jsExtensions = ['.mjs', '.js', '.jsx', '.cjs'];
@@ -13,6 +14,7 @@ const allExtensions = [...jsExtensions, ...tsExtensions];
  */
 function imports(options = {}) {
   const isObject = typeof options.import === 'object';
+  const overrides = objectOrEmpty(options.import.overrides);
 
   const importsConfig = {
     name: 'imports',
@@ -106,7 +108,7 @@ function imports(options = {}) {
     },
   };
 
-  return mergeConfigs(importsConfig, options.import.overrides ?? {});
+  return mergeConfigs(importsConfig, overrides);
 }
 
 export default imports;

package/src/modules/jest.mjs

@@ -4,12 +4,14 @@ import globals from 'globals';
 
 import { predicate } from '../utils/conditions.mjs';
 import { globs } from '../utils/globs.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
 
 /**
  * @param { import('../types').Options } options
  * @return { import('eslint').Linter.Config } */
 function jest(options = {}) {
   const projectService = options.typescript && options.typescript.tsconfigRootDir && options.typescript.projectService;
+  const overrides = objectOrEmpty(options.jest.overrides);
 
   const jestConfig = {
     name: 'jest',
@@ -86,7 +88,7 @@ function jest(options = {}) {
     },
   };
 
-  return mergeConfigs(jestConfig, options.jest.overrides ?? {});
+  return mergeConfigs(jestConfig, overrides);
 }
 
 export default jest;

package/src/modules/next.mjs

@@ -1,11 +1,15 @@
 import plugin from '@next/eslint-plugin-next';
 import { mergeConfigs } from 'eslint-flat-config-utils';
 
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
+
 /**
  * @param { import('../types').Options } options
  * @return { import('eslint').Linter.Config }
  */
 function next(options = {}) {
+  const overrides = objectOrEmpty(options.next.overrides);
+
   const nextConfig = {
     name: 'next',
     plugins: { next: plugin },
@@ -34,7 +38,7 @@ function next(options = {}) {
     },
   };
 
-  return mergeConfigs(nextConfig, options.next.overrides ?? {});
+  return mergeConfigs(nextConfig, overrides);
 }
 
 export default next;

package/src/modules/node.mjs

@@ -2,12 +2,15 @@ import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-n';
 
 import { strict } from '../utils/conditions.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
 
 /**
  * @param { import('../types').Options } options
  * @return { import('eslint').Linter.Config }
  */
 function node(options = {}) {
+  const overrides = objectOrEmpty(options.node.overrides);
+
   const nodeConfig = {
     name: 'node',
     plugins: { n: plugin },
@@ -30,7 +33,7 @@ function node(options = {}) {
       'n/no-sync': strict(options, 'warn'),
       'n/no-top-level-await': 'off',
       'n/no-unpublished-bin': 'warn',
-      'n/no-unpublished-import': 'warn',
+      'n/no-unpublished-import': 'off',
       'n/no-unpublished-require': 'warn',
       'n/no-unsupported-features/es-builtins': 'off', // Nice but not a general rule
       'n/no-unsupported-features/es-syntax': 'off', // Nice but not a general rule
@@ -58,7 +61,7 @@ function node(options = {}) {
     },
   };
 
-  return mergeConfigs(nodeConfig, options.node.overrides ?? {});
+  return mergeConfigs(nodeConfig, overrides);
 }
 
 export default node;

package/src/modules/perfectionist.mjs

@@ -1,11 +1,15 @@
 import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-perfectionist';
 
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
+
 /**
  * @param { import('../types').Options } options
  * @return { Promise<import('eslint').Linter.Config> }
  */
 function perfectionist(options = {}) {
+  const overrides = objectOrEmpty(options.sort.overrides);
+
   const perfectionistConfig = {
     name: 'perfectionist',
     plugins: { perfectionist: plugin },
@@ -72,7 +76,7 @@ function perfectionist(options = {}) {
     },
   };
 
-  return mergeConfigs(perfectionistConfig, options.sort.overrides ?? {});
+  return mergeConfigs(perfectionistConfig, overrides);
 }
 
 export default perfectionist;

package/src/modules/playwright.mjs

@@ -2,12 +2,15 @@ import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-playwright';
 
 import { globs } from '../utils/globs.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
 
 /**
  * @param { import('../types').Options } options
  * @return { Promise<import('eslint').Linter.Config> }
  */
 function playwright(options = {}) {
+  const overrides = objectOrEmpty(options.playwright.overrides);
+
   const playwrightConfig = {
     name: 'playwright',
     plugins: { playwright: plugin },
@@ -74,7 +77,7 @@ function playwright(options = {}) {
     },
   };
 
-  return mergeConfigs(playwrightConfig, options.playwright.overrides ?? {});
+  return mergeConfigs(playwrightConfig, overrides);
 }
 
 export default playwright;

package/src/modules/prettier.mjs

@@ -1,11 +1,15 @@
 import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-prettier';
 
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
+
 /**
  * @param { import('../types').Options } options
  * @return { Promise<import('eslint').Linter.Config> }
  */
 function prettier(options = {}) {
+  const overrides = objectOrEmpty(options.prettier.overrides);
+
   const prettierConfig = {
     name: 'prettier',
     plugins: { prettier: plugin },
@@ -13,24 +17,20 @@ function prettier(options = {}) {
       'prettier/prettier': 'error',
 
       'curly': 'off',
-      'brace-style': 'off',
       'no-unexpected-multiline': 'off',
 
       '@typescript-eslint/lines-around-comment': 'off',
       '@typescript-eslint/quotes': 'off',
       '@typescript-eslint/block-spacing': 'off',
-      '@typescript-eslint/brace-style': 'off',
       '@typescript-eslint/comma-dangle': 'off',
       '@typescript-eslint/comma-spacing': 'off',
       '@typescript-eslint/func-call-spacing': 'off',
       '@typescript-eslint/indent': 'off',
-      '@typescript-eslint/key-spacing': 'off',
       '@typescript-eslint/keyword-spacing': 'off',
       '@typescript-eslint/member-delimiter-style': 'off',
       '@typescript-eslint/no-extra-parens': 'off',
       '@typescript-eslint/no-extra-semi': 'off',
       '@typescript-eslint/semi': 'off',
-      '@typescript-eslint/space-before-blocks': 'off',
       '@typescript-eslint/space-before-function-paren': 'off',
       '@typescript-eslint/space-infix-ops': 'off',
       '@typescript-eslint/type-annotation-spacing': 'off',
@@ -42,12 +42,10 @@ function prettier(options = {}) {
       '@stylistic/jsx-curly-spacing': 'off',
       '@stylistic/jsx-equals-spacing': 'off',
       '@stylistic/jsx-first-prop-new-line': 'off',
-      '@stylistic/jsx-indent': 'off',
       '@stylistic/jsx-indent-props': 'off',
       '@stylistic/jsx-max-props-per-line': 'off',
       '@stylistic/jsx-newline': 'off',
       '@stylistic/jsx-one-expression-per-line': 'off',
-      '@stylistic/jsx-props-no-multi-spaces': 'off',
       '@stylistic/jsx-tag-spacing': 'off',
       '@stylistic/jsx-wrap-multilines': 'off',
 
@@ -93,7 +91,7 @@ function prettier(options = {}) {
     },
   };
 
-  return mergeConfigs(prettierConfig, options.prettier.overrides ?? {});
+  return mergeConfigs(prettierConfig, overrides);
 }
 
 export default prettier;

package/src/modules/promise.mjs

@@ -2,12 +2,15 @@ import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-promise';
 
 import { strict } from '../utils/conditions.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
 
 /**
  * @param { import('../types').Options } options
  * @return { Promise<import('eslint').Linter.Config> }
  */
 function promise(options = {}) {
+  const overrides = objectOrEmpty(options.promise.overrides);
+
   const promiseConfig = {
     name: 'promise',
     plugins: { promise: plugin },
@@ -32,7 +35,7 @@ function promise(options = {}) {
     },
   };
 
-  return mergeConfigs(promiseConfig, options.promise.overrides ?? {});
+  return mergeConfigs(promiseConfig, overrides);
 }
 
 export default promise;

package/src/modules/react.mjs

@@ -1,11 +1,14 @@
 import reactPlugin from '@eslint-react/eslint-plugin';
 import { mergeConfigs } from 'eslint-flat-config-utils';
 import a11yPlugin from 'eslint-plugin-jsx-a11y';
-import hooksPlugin from 'eslint-plugin-react-hooks';
+import { reactRefresh } from 'eslint-plugin-react-refresh';
+import { isPackageExists } from 'local-pkg';
 import { parser } from 'typescript-eslint';
 
 import { predicate, strict } from '../utils/conditions.mjs';
 import { globs } from '../utils/globs.mjs';
+import { nextAllowExportNames } from '../utils/nextAllowExportNames.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
 
 /**
  * @param { import('../types').Options } options
@@ -13,14 +16,16 @@ import { globs } from '../utils/globs.mjs';
  */
 function react(options = {}) {
   const projectService = options.typescript && options.typescript.tsconfigRootDir && options.typescript.projectService;
+  const isObject = typeof options.react === 'object';
+  const overrides = objectOrEmpty(options.react.overrides);
 
   const reactConfig = {
     name: 'react',
     files: [globs.js, globs.jsx, globs.ts, globs.tsx],
     plugins: {
       ...reactPlugin.configs.all.plugins,
-      'react-hooks': hooksPlugin,
       'jsx-a11y': a11yPlugin,
+      'react-refresh': reactRefresh.plugin,
     },
     ...predicate(projectService, {
       languageOptions: {
@@ -29,12 +34,25 @@ function react(options = {}) {
       },
     }),
     settings: {
-      'react': {
-        pragma: 'React',
-        version: 'detect',
-      },
-      'react-hooks': {
-        additionalEffectHooks: options.react.additionalEffectHooks,
+      'react-x': {
+        ...predicate(isObject && 'version' in options.react, {
+          version: options.react.version,
+        }),
+        ...predicate(isObject && 'importSource' in options.react, {
+          importSource: options.react.importSource,
+        }),
+        ...predicate(isObject && 'compilationMode' in options.react, {
+          compilationMode: options.react.compilationMode,
+        }),
+        ...predicate(isObject && 'polymorphicPropName' in options.react, {
+          polymorphicPropName: options.react.polymorphicPropName,
+        }),
+        ...predicate(isObject && 'additionalStateHooks' in options.react, {
+          additionalStateHooks: options.react.additionalStateHooks,
+        }),
+        ...predicate(isObject && 'additionalEffectHooks' in options.react, {
+          additionalEffectHooks: options.react.additionalEffectHooks,
+        }),
       },
     },
     rules: {
@@ -118,24 +136,18 @@ function react(options = {}) {
 
       '@eslint-react/rsc-function-definition': 'error',
 
-      'react-hooks/rules-of-hooks': 'error',
-      'react-hooks/exhaustive-deps': 'warn',
-
-      'react-hooks/config': 'error',
-      'react-hooks/error-boundaries': 'error',
-      'react-hooks/component-hook-factories': 'error',
-      'react-hooks/gating': 'error',
-      'react-hooks/globals': 'error',
-      'react-hooks/immutability': 'error',
-      'react-hooks/preserve-manual-memoization': 'error',
-      'react-hooks/purity': 'error',
-      'react-hooks/refs': 'error',
-      'react-hooks/set-state-in-effect': strict('error'),
-      'react-hooks/set-state-in-render': 'error',
-      'react-hooks/static-components': strict('error'),
-      'react-hooks/unsupported-syntax': 'warn',
-      'react-hooks/use-memo': 'error',
-      'react-hooks/incompatible-library': 'warn',
+      '@eslint-react/rules-of-hooks': 'error',
+      '@eslint-react/exhaustive-deps': 'error',
+      '@eslint-react/error-boundaries': 'error',
+      '@eslint-react/globals': 'error',
+      '@eslint-react/immutability': 'error',
+      '@eslint-react/purity': 'error',
+      '@eslint-react/refs': 'error',
+      '@eslint-react/set-state-in-effect': strict('error'),
+      '@eslint-react/set-state-in-render': 'error',
+      '@eslint-react/static-components': strict('error'),
+      '@eslint-react/unsupported-syntax': 'error',
+      '@eslint-react/use-memo': 'error',
 
       'jsx-a11y/alt-text': 'warn',
       'jsx-a11y/anchor-has-content': 'error',
@@ -173,10 +185,19 @@ function react(options = {}) {
       'jsx-a11y/tabindex-no-positive': 'warn',
       'jsx-a11y/anchor-ambiguous-text': 'off',
       'jsx-a11y/prefer-tag-over-role': 'off',
+
+      'react-refresh/only-export-components': [
+        'error',
+        {
+          allowExportNames: isPackageExists('next') ? nextAllowExportNames : [],
+
+          allowConstantExport: isPackageExists('vite'),
+        },
+      ],
     },
   };
 
-  return mergeConfigs(reactConfig, options.react.overrides ?? {});
+  return mergeConfigs(reactConfig, overrides);
 }
 
 export default react;

package/src/modules/regex.mjs

@@ -1,17 +1,25 @@
 import { mergeConfigs } from 'eslint-flat-config-utils';
 import * as plugin from 'eslint-plugin-regexp';
 
+import { predicate } from '../utils/conditions.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
+
 /**
  * @param { import('../types').Options } options
  * @return { Promise<import('eslint').Linter.Config> }
  */
 function regex(options = {}) {
+  const isObject = typeof options.regex === 'object';
+  const overrides = objectOrEmpty(options.regex.overrides);
+
   const regexConfig = {
     name: 'regex',
     plugins: { regexp: plugin },
     settings: {
       regexp: {
-        allowedCharacterRanges: options.regex.allowedCharacterRanges,
+        ...predicate(isObject && 'allowedCharacterRanges' in options.regex, {
+          allowedCharacterRanges: options.regex.allowedCharacterRanges,
+        }),
       },
     },
     rules: {
@@ -104,7 +112,7 @@ function regex(options = {}) {
     },
   };
 
-  return mergeConfigs(regexConfig, options.regex.overrides ?? {});
+  return mergeConfigs(regexConfig, overrides);
 }
 
 export default regex;

package/src/modules/storybook.mjs

@@ -2,12 +2,15 @@ import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-storybook';
 
 import { globs } from '../utils/globs.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
 
 /**
  * @param { import('../types').Options } options
  * @return { Promise<import('eslint').Linter.Config> }
  */
 function storybook(options = {}) {
+  const overrides = objectOrEmpty(options.storybook.overrides);
+
   const storybookConfig = {
     name: 'storybook',
     files: globs.storybook,
@@ -38,7 +41,7 @@ function storybook(options = {}) {
     },
   };
 
-  return mergeConfigs(storybookConfig, options.storybook.overrides ?? {});
+  return mergeConfigs(storybookConfig, overrides);
 }
 
 export default storybook;

package/src/modules/stylistic.mjs

@@ -1,11 +1,15 @@
 import stylisticPlugin from '@stylistic/eslint-plugin';
 import { mergeConfigs } from 'eslint-flat-config-utils';
 
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
+
 /**
  * @param { import('../types').Options } options
  * @return { Promise<import('eslint').Linter.Config> }
  */
 function stylistic(options = {}) {
+  const overrides = objectOrEmpty(options.stylistic.overrides);
+
   const stylisticConfig = {
     name: 'stylistic',
     plugins: { '@stylistic': stylisticPlugin },
@@ -44,7 +48,7 @@ function stylistic(options = {}) {
       ],
     },
   };
-  return mergeConfigs(stylisticConfig, options.stylistic.overrides ?? {});
+  return mergeConfigs(stylisticConfig, overrides);
 }
 
 export default stylistic;