@fullstacksjs/eslint-config 14.5.0 → 14.7.0

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

@@ -0,0 +1,38 @@
+import type { ConfigWithOverrides } from '..';
+
+/**
+ * Granular options to configure the project service.
+ */
+interface ProjectServiceOptions {
+  /**
+   * Globs of files to allow running with the default project compiler options
+   * despite not being matched by the project service.
+   */
+  allowDefaultProject?: string[];
+
+  /**
+   * Path to a TSConfig to use instead of TypeScript's default project configuration.
+   * @default 'tsconfig.json'
+   */
+  defaultProject?: string;
+
+  /**
+   * Whether to allow TypeScript plugins as configured in the TSConfig.
+   */
+  loadTypeScriptPlugins?: boolean;
+
+  /**
+   * The maximum number of files {@link allowDefaultProject} may match.
+   * Each file match slows down linting, so if you do need to use this, please
+   * file an informative issue on typescript-eslint explaining why - so we can
+   * help you avoid using it!
+   * @default 8
+   */
+  maximumDefaultProjectFileMatchCount_THIS_WILL_SLOW_DOWN_LINTING?: number;
+}
+
+interface TypeScriptOptions extends ConfigWithOverrides {
+  projectService?: boolean | ProjectServiceOptions;
+  tsconfigRootDir?: string;
+  cacheLifetime?: number;
+}

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.5.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",
@@ -34,16 +34,17 @@
     ".": {
       "import": "./src/index.mjs",
       "require": "./cjs/index.js",
-      "types": "./src/index.d.ts"
+      "types": "./src/types/index.d.ts"
     }
   },
   "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",
     "eslint-plugin-cypress": "6.4.1",
     "eslint-plugin-import-x": "4.16.2",
@@ -52,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",
@@ -68,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/index.mjs

@@ -12,6 +12,7 @@ import node from './modules/node.mjs';
 import perfectionist from './modules/perfectionist.mjs';
 import playwright from './modules/playwright.mjs';
 import prettier from './modules/prettier.mjs';
+import promise from './modules/promise.mjs';
 import react from './modules/react.mjs';
 import regex from './modules/regex.mjs';
 import storybook from './modules/storybook.mjs';
@@ -25,11 +26,14 @@ const testPackages = ['jest', 'vitest', 'cypress', '@playwright/test'];
 
 /**
  * @typedef {import('eslint').Linter.Config} Config
- * @typedef {import('.').Options} Options
+ * @typedef {import('./types').Options} Options
  * /
 
 /** @type {Options} */
 const defaultOptions = {
+  base: true,
+  promise: true,
+  stylistic: true,
   cypress: isPackageExists('cypress'),
   disableExpensiveRules: false,
   esm: false,
@@ -74,6 +78,9 @@ export function defineConfig(initOptions = {}, ...extend) {
   }
 
   const {
+    base: enableBase,
+    promise: enablePromise,
+    stylistic: enableStylistic,
     sort: enableSort,
     cypress: enableCypress,
     disableExpensiveRules,
@@ -97,8 +104,11 @@ export function defineConfig(initOptions = {}, ...extend) {
     ...eslintOptions
   } = options;
 
-  const rules = [ignores(options), base(options), stylistic(options)];
+  const rules = [ignores(options)];
 
+  if (enableBase) rules.push(base(options));
+  if (enablePromise) rules.push(promise(options));
+  if (enableStylistic) rules.push(stylistic(options));
   if (enableSort) rules.push(perfectionist(options));
   if (enableImport) rules.push(imports(options));
   if (enableTailwind) rules.push(tailwind(options));

package/src/modules/base.mjs

@@ -1,13 +1,17 @@
+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('..').Options } options
+ * @param { import('../types').Options } options
  * @return { import('eslint').Linter.Config }
  */
 function base(options = {}) {
-  return {
+  const overrides = objectOrEmpty(options.base.overrides);
+
+  const baseConfig = {
     name: 'base',
     languageOptions: {
       ecmaVersion: 'latest',
@@ -195,6 +199,8 @@ function base(options = {}) {
       'no-console': strict(options, 'warn'),
     },
   };
+
+  return mergeConfigs(baseConfig, overrides);
 }
 
 export default base;

package/src/modules/cypress.mjs

@@ -1,10 +1,17 @@
+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';
 
-/** @return { import('eslint').Linter.Config } */
-function cypress() {
-  return {
+/**
+ * @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,
     plugins: { cypress: plugin },
@@ -21,6 +28,8 @@ function cypress() {
       '@typescript-eslint/no-namespace': 'off',
     },
   };
+
+  return mergeConfigs(cypressConfig, overrides);
 }
 
 export default cypress;

package/src/modules/ignore.mjs

@@ -4,7 +4,7 @@ import { getGitignorePatterns } from '../utils/getGitignorePatterns.mjs';
 import { ignoreGlobs } from '../utils/globs.mjs';
 
 /**
- * @param { import('..').Options } options
+ * @param { import('../types').Options } options
  * @return { import('eslint').Linter.Config }
  */
 function ignores(options = {}) {

package/src/modules/imports.mjs

@@ -1,19 +1,22 @@
+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'];
 const allExtensions = [...jsExtensions, ...tsExtensions];
 
 /**
- * @param { import('..').Options } options
+ * @param { import('../types').Options } options
  * @return { import('eslint').Linter.Config }
  */
 function imports(options = {}) {
   const isObject = typeof options.import === 'object';
+  const overrides = objectOrEmpty(options.import.overrides);
 
-  const config = {
+  const importsConfig = {
     name: 'imports',
     plugins: { import: plugin },
     settings: {
@@ -105,7 +108,7 @@ function imports(options = {}) {
     },
   };
 
-  return config;
+  return mergeConfigs(importsConfig, overrides);
 }
 
 export default imports;

package/src/modules/jest.mjs

@@ -1,16 +1,19 @@
+import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-jest';
 import globals from 'globals';
 
 import { predicate } from '../utils/conditions.mjs';
 import { globs } from '../utils/globs.mjs';
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
 
 /**
- * @param { import('..').Options } options
+ * @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);
 
-  return {
+  const jestConfig = {
     name: 'jest',
     files: globs.test,
     plugins: { jest: plugin },
@@ -84,6 +87,8 @@ function jest(options = {}) {
       // }),
     },
   };
+
+  return mergeConfigs(jestConfig, overrides);
 }
 
 export default jest;

package/src/modules/next.mjs

@@ -1,8 +1,16 @@
 import plugin from '@next/eslint-plugin-next';
+import { mergeConfigs } from 'eslint-flat-config-utils';
 
-/** @type { import('eslint').Linter.Config } */
-function next() {
-  return {
+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 },
     rules: {
@@ -29,6 +37,8 @@ function next() {
       'next/no-unwanted-polyfillio': 'warn',
     },
   };
+
+  return mergeConfigs(nextConfig, overrides);
 }
 
 export default next;

package/src/modules/node.mjs

@@ -1,13 +1,17 @@
+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('..').Options } options
+ * @param { import('../types').Options } options
  * @return { import('eslint').Linter.Config }
  */
 function node(options = {}) {
-  return {
+  const overrides = objectOrEmpty(options.node.overrides);
+
+  const nodeConfig = {
     name: 'node',
     plugins: { n: plugin },
     rules: {
@@ -29,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
@@ -56,6 +60,8 @@ function node(options = {}) {
       'n/no-missing-require': 'off',
     },
   };
+
+  return mergeConfigs(nodeConfig, overrides);
 }
 
 export default node;

package/src/modules/perfectionist.mjs

@@ -1,10 +1,16 @@
+import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-perfectionist';
 
+import { objectOrEmpty } from '../utils/objectOrEmpty.mjs';
+
 /**
- * @return { import('eslint').Linter.Config }
+ * @param { import('../types').Options } options
+ * @return { Promise<import('eslint').Linter.Config> }
  */
-function perfectionist() {
-  return {
+function perfectionist(options = {}) {
+  const overrides = objectOrEmpty(options.sort.overrides);
+
+  const perfectionistConfig = {
     name: 'perfectionist',
     plugins: { perfectionist: plugin },
     rules: {
@@ -69,6 +75,8 @@ function perfectionist() {
       'perfectionist/sort-variable-declarations': 'warn',
     },
   };
+
+  return mergeConfigs(perfectionistConfig, overrides);
 }
 
 export default perfectionist;

package/src/modules/playwright.mjs

@@ -1,10 +1,17 @@
+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';
 
-/** @return { import('eslint').Linter.Config } */
-function playwright() {
-  return {
+/**
+ * @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 },
     files: globs.e2e,
@@ -69,6 +76,8 @@ function playwright() {
       'playwright/valid-title': 'warn',
     },
   };
+
+  return mergeConfigs(playwrightConfig, overrides);
 }
 
 export default playwright;

package/src/modules/prettier.mjs

@@ -1,32 +1,36 @@
+import { mergeConfigs } from 'eslint-flat-config-utils';
 import plugin from 'eslint-plugin-prettier';
 
-/** @return { import('eslint').Linter.Config } */
-function prettier() {
-  return {
+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 },
     rules: {
       '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',
@@ -38,12 +42,10 @@ function prettier() {
       '@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',
 
@@ -88,6 +90,8 @@ function prettier() {
       'vue/template-curly-spacing': 'off',
     },
   };
+
+  return mergeConfigs(prettierConfig, overrides);
 }
 
 export default prettier;

package/src/modules/promise.mjs

@@ -1,10 +1,17 @@
+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';
 
-/** @return { import('eslint').Linter.Config } */
+/**
+ * @param { import('../types').Options } options
+ * @return { Promise<import('eslint').Linter.Config> }
+ */
 function promise(options = {}) {
-  return {
+  const overrides = objectOrEmpty(options.promise.overrides);
+
+  const promiseConfig = {
     name: 'promise',
     plugins: { promise: plugin },
     rules: {
@@ -27,6 +34,8 @@ function promise(options = {}) {
       'promise/spec-only': 'warn',
     },
   };
+
+  return mergeConfigs(promiseConfig, overrides);
 }
 
 export default promise;

package/src/modules/react.mjs

@@ -1,22 +1,31 @@
 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';
 
-/** @return { import('eslint').Linter.Config } */
+/**
+ * @param { import('../types').Options } options
+ * @return { Promise<import('eslint').Linter.Config> }
+ */
 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);
 
-  return {
+  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: {
@@ -25,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: {
@@ -114,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',
@@ -169,8 +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, overrides);
 }
 
 export default react;