eslint-config-airbnb-extended 2.0.0-beta-2 → 2.0.0-beta-4

package/README.md

@@ -20,6 +20,8 @@ To learn more about the configuration options available for `create-airbnb-x-con
 
 ### Steps
 
+First, you need to decide whether you want to use the `legacy` config or the `extended` config. If you're not sure about the difference between the two, you can refer to the [Extended vs Legacy Config](https://github.com/NishargShah/eslint-config-airbnb-extended/tree/master/packages/eslint-config-airbnb-extended#difference-between-extended-vs-legacy-config) for a brief explanation. For more information specifically about the Legacy config, check out the [Legacy Config](https://github.com/NishargShah/eslint-config-airbnb-extended/tree/master/packages/eslint-config-airbnb-extended#legacy-config). If you decide to use the Extended config, you can proceed with the steps below. Otherwise, feel free to switch to the Legacy config if that better fits your requirements.
+
 You can choose whether to **install** or **not install** based on your needs.
 
 - If you choose **installation**, the package will automatically detect your project's package manager and install all the required dependencies.
@@ -33,6 +35,67 @@ While **manual installation** is possible, we strongly recommend using `create-a
 
 The configuration may change over time, and `create-airbnb-x-config` will always stay up-to-date with the latest versions. If you're confident in handling manual installations, refer to the [Packages Used](https://github.com/NishargShah/eslint-config-airbnb-extended/tree/master/packages/eslint-config-airbnb-extended#packages-used) section for more information on the individual packages.
 
+## Legacy Config
+
+Many people are currently using Airbnb's ESLint configs, like `eslint-config-airbnb`, and they want a way to switch or upgrade without making any changes to their existing config setup.
+
+Right now, the new process for setting up configs is more complex, and not everyone wants to go through it. What developers really need is a simple and direct replacement for the existing Airbnb configs, a solution that keeps everything working the same way as before, with no rule or behavior changes. It should also make sure all packages used are updated to the latest versions.
+
+In short, the goal is:
+
+- No need to learn or adopt new config styles
+- No changes in rule behavior or structure
+- Easy to migrate by just changing the import path
+- All packages should be latest
+
+Here’s the way to use the **Airbnb legacy configurations** with the flat config format under `eslint-config-airbnb-extended/legacy`.
+
+#### For `eslint-config-airbnb-base`
+
+```ts
+import { configs } from 'eslint-config-airbnb-extended/legacy';
+
+// Equivalent to airbnb-base/legacy
+export default [...configs.base.legacy];
+
+// Equivalent to airbnb-base
+export default [...configs.base.recommended];
+```
+
+---
+
+#### For `eslint-config-airbnb`
+
+```ts
+import { configs } from 'eslint-config-airbnb-extended/legacy';
+
+// Equivalent to airbnb/legacy
+export default [...configs.react.legacy];
+
+// Equivalent to airbnb/base
+export default [...configs.react.base];
+
+// Equivalent to airbnb
+export default [...configs.react.recommended];
+
+// Equivalent to airbnb/hooks
+export default [...configs.react.hooks];
+```
+
+---
+
+#### For `eslint-config-airbnb-typescript`
+
+```ts
+import { configs } from 'eslint-config-airbnb-extended/legacy';
+
+// Equivalent to airbnb-typescript/base
+export default [...configs.base.typescript];
+
+// Equivalent to airbnb-typescript
+export default [...configs.react.typescript];
+```
+
 ## Packages Used
 
 This configuration relies on the following essential packages:
@@ -92,6 +155,12 @@ export default [
 
 ## FAQs
 
+### Difference between Extended vs Legacy Config
+
+**Legacy Config** – Designed to be a one-to-one replacement of the original Airbnb ESLint configurations using the new flat config format. Its main purpose is to maintain backward compatibility by continuing to use the same packages as the original setup. For more details, see the [Legacy Config](https://github.com/NishargShah/eslint-config-airbnb-extended/tree/master/packages/eslint-config-airbnb-extended#legacy-config).
+
+**Extended Config** – A modern ESLint configuration based on `eslint-config-airbnb`, built from scratch with updated rules, replacement of deprecated ones using community recommended alternatives, and the adoption of the latest best-practice packages. For more details on the packages used, refer to the [Packages Used](https://github.com/NishargShah/eslint-config-airbnb-extended/tree/master/packages/eslint-config-airbnb-extended#packages-used) section.
+
 ### How to Configure for a Monorepo?
 
 If you're working in a monorepo setup, it's recommended to run the installation command in the specific sub-folder where you want the configuration. Alternatively, you can choose to skip the package installation, and we'll provide a customized set of commands based on your selection, allowing you to install it according to your preferred method.

package/dist/@types/legacy.d.ts

@@ -4,7 +4,7 @@
 export declare const rules: {
     readonly base: Record<"strict" | "imports" | "variables" | "bestPractices" | "errors" | "es6" | "style" | "node", import("eslint").Linter.Config>;
     readonly react: Record<"base" | "jsxA11y" | "hooks", import("eslint").Linter.Config>;
-    readonly typescript: Record<"overrides" | "base", import("eslint").Linter.Config>;
+    readonly typescript: Record<"overrides" | "base" | "settings", import("eslint").Linter.Config>;
 };
 export declare const configs: {
     readonly base: Record<"recommended" | "typescript" | "legacy", import("eslint").Linter.Config[]>;

package/dist/legacy/configs/react/typescript.js

@@ -3,23 +3,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const config_1 = __importDefault(require("../../../legacy/configs/typescript/config"));
+const typescript_1 = __importDefault(require("../../../legacy/configs/base/typescript"));
 const utils_1 = require("../../../utils");
 const legacyReactTypescriptConfig = [
-    ...Object.values(config_1.default),
+    ...typescript_1.default,
     {
         name: 'airbnb/config/react-configurations/typescript/legacy',
         files: utils_1.tsFiles,
-        settings: {
-            // Append 'ts' extensions to Airbnb 'import/resolver' setting
-            // Prepend 'mjs' to match shared config
-            // Original: ['.js', '.jsx', '.json']
-            'import/resolver': {
-                node: {
-                    extensions: ['.mjs', '.js', '.jsx', '.json', '.ts', '.tsx', '.d.ts'],
-                },
-            },
-        },
         rules: {
             // Append 'tsx' to Airbnb 'react/jsx-filename-extension' rule
             // Original: ['.jsx']
@@ -31,5 +21,27 @@ const legacyReactTypescriptConfig = [
             ],
         },
     },
+    {
+        name: 'airbnb/config/react-configurations/typescript-settings/legacy',
+        files: utils_1.allFiles,
+        settings: {
+            // Apply special parsing for TypeScript files
+            'import/parsers': {
+                '@typescript-eslint/parser': utils_1.tsExtensionsWithReactDTS,
+            },
+            // Append 'ts' extensions to Airbnb 'import/resolver' setting
+            // Prepend 'mjs' to match shared config
+            // Original: ['.js', '.jsx', '.json']
+            'import/resolver': {
+                node: {
+                    extensions: [...utils_1.tsExtensionsWithReactDTS, '.json'],
+                },
+                typescript: true,
+            },
+            // Append 'ts' extensions to Airbnb 'import/extensions' setting
+            // Original: ['.js', '.mjs', '.jsx']
+            'import/extensions': utils_1.tsExtensionsWithReactDTS,
+        },
+    },
 ];
 exports.default = legacyReactTypescriptConfig;

package/dist/legacy/configs/typescript/config.js

@@ -5,8 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const typescript_1 = __importDefault(require("../../../legacy/rules/typescript/typescript"));
 const typescriptOverrides_1 = __importDefault(require("../../../legacy/rules/typescript/typescriptOverrides"));
+const typescriptSettings_1 = __importDefault(require("../../../legacy/rules/typescript/typescriptSettings"));
 const legacyTypescriptConfig = {
     base: typescript_1.default,
     overrides: typescriptOverrides_1.default,
+    settings: typescriptSettings_1.default,
 };
 exports.default = legacyTypescriptConfig;

package/dist/legacy/rules/imports.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const globals_1 = __importDefault(require("globals"));
+const getDevDepsList_1 = __importDefault(require("../../helpers/getDevDepsList"));
 const utils_1 = require("../../utils");
 // eslint-disable-next-line @typescript-eslint/no-require-imports, unicorn/prefer-module
 const plugin = require('eslint-plugin-import');
@@ -23,10 +24,10 @@ const legacyImportsRules = {
     settings: {
         'import/resolver': {
             node: {
-                extensions: ['.mjs', '.js', '.json'],
+                extensions: [...utils_1.jsExtensions, '.json'],
             },
         },
-        'import/extensions': ['.js', '.mjs', '.jsx'],
+        'import/extensions': utils_1.jsExtensionsWithReact,
         'import/core-modules': [],
         'import/ignore': ['node_modules', String.raw `\.(coffee|scss|css|less|hbs|svg|json)$`],
     },
@@ -68,30 +69,7 @@ const legacyImportsRules = {
         'import/no-extraneous-dependencies': [
             'error',
             {
-                devDependencies: [
-                    'test/**', // tape, common npm pattern
-                    'tests/**', // also common npm pattern
-                    'spec/**', // mocha, rspec-like pattern
-                    '**/__tests__/**', // jest pattern
-                    '**/__mocks__/**', // jest pattern
-                    'test.{js,jsx}', // repos with a single test file
-                    'test-*.{js,jsx}', // repos with multiple top-level test files
-                    '**/*{.,_}{test,spec}.{js,jsx}', // tests where the extension or filename suffix denotes that it is a test
-                    '**/jest.config.js', // jest config
-                    '**/jest.setup.js', // jest setup
-                    '**/vue.config.js', // vue-cli config
-                    '**/webpack.config.js', // webpack config
-                    '**/webpack.config.*.js', // webpack config
-                    '**/rollup.config.js', // rollup config
-                    '**/rollup.config.*.js', // rollup config
-                    '**/gulpfile.js', // gulp config
-                    '**/gulpfile.*.js', // gulp config
-                    '**/Gruntfile{,.js}', // grunt config
-                    '**/protractor.conf.js', // protractor config
-                    '**/protractor.conf.*.js', // protractor config
-                    '**/karma.conf.js', // karma config
-                    '**/.eslintrc.js', // eslint config
-                ],
+                devDependencies: (0, getDevDepsList_1.default)(utils_1.jsExtensions.map((ext) => ext.slice(1)).join(',')),
                 optionalDependencies: false,
             },
         ],

package/dist/legacy/rules/react/react.js

@@ -25,7 +25,7 @@ const legacyReactBaseRules = {
     settings: {
         'import/resolver': {
             node: {
-                extensions: ['.js', '.jsx', '.json'],
+                extensions: [...utils_1.jsExtensionsWithReact, '.json'],
             },
         },
         react: {

package/dist/legacy/rules/typescript/typescript.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const typescript_eslint_1 = require("typescript-eslint");
+const getDevDepsList_1 = __importDefault(require("../../../helpers/getDevDepsList"));
 const best_practices_1 = __importDefault(require("../../../legacy/rules/best-practices"));
 const errors_1 = __importDefault(require("../../../legacy/rules/errors"));
 const es6_1 = __importDefault(require("../../../legacy/rules/es6"));
@@ -29,25 +30,6 @@ const legacyTypescriptBaseRules = {
             projectService: true,
         },
     },
-    settings: {
-        // Apply special parsing for TypeScript files
-        'import/parsers': {
-            '@typescript-eslint/parser': ['.ts', '.tsx', '.d.ts'],
-        },
-        // Append 'ts' extensions to Airbnb 'import/resolver' setting
-        // Original: ['.mjs', '.js', '.json']
-        'import/resolver': {
-            node: {
-                extensions: ['.mjs', '.js', '.json', '.ts', '.d.ts'],
-            },
-            typescript: true,
-        },
-        // Append 'ts' extensions to Airbnb 'import/extensions' setting
-        // Original: ['.js', '.mjs', '.jsx']
-        'import/extensions': ['.js', '.mjs', '.jsx', '.ts', '.tsx', '.d.ts'],
-        // Resolve type definition packages
-        'import/external-module-folders': ['node_modules', 'node_modules/@types'],
-    },
     rules: {
         // Replace Airbnb 'brace-style' rule with '@typescript-eslint' version
         // https://github.com/typescript-eslint/typescript-eslint/blob/master/packages/eslint-plugin/docs/rules/brace-style.md
@@ -238,15 +220,11 @@ const legacyTypescriptBaseRules = {
         // Append 'ts' and 'tsx' extensions to Airbnb 'import/no-extraneous-dependencies' rule
         // https://github.com/benmosher/eslint-plugin-import/blob/master/docs/rules/no-extraneous-dependencies.md
         'import/no-extraneous-dependencies': [
-            baseImportsRules['import/no-extraneous-dependencies'][0],
-            Object.assign(Object.assign({}, baseImportsRules['import/no-extraneous-dependencies'][1]), { devDependencies: baseImportsRules['import/no-extraneous-dependencies'][1].devDependencies.reduce((result, devDep) => {
-                    const toAppend = [devDep];
-                    const devDepWithTs = devDep.replaceAll(/\bjs(x?)\b/g, 'ts$1');
-                    if (devDepWithTs !== devDep) {
-                        toAppend.push(devDepWithTs);
-                    }
-                    return [...result, ...toAppend];
-                }, []) }),
+            'error',
+            {
+                devDependencies: (0, getDevDepsList_1.default)([...utils_1.jsExtensions, ...utils_1.tsExtensions].map((ext) => ext.slice(1)).join(',')),
+                optionalDependencies: false,
+            },
         ],
     },
 };

package/dist/legacy/rules/typescript/typescriptSettings.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../../utils");
+const legacyTypescriptSettingsRules = {
+    name: 'airbnb/config/typescript/settings/legacy',
+    files: utils_1.allFiles,
+    settings: {
+        // Apply special parsing for TypeScript files
+        'import/parsers': {
+            '@typescript-eslint/parser': utils_1.tsExtensionsResolver,
+        },
+        // Append 'ts' extensions to Airbnb 'import/resolver' setting
+        // Original: ['.mjs', '.js', '.json']
+        'import/resolver': {
+            node: {
+                extensions: [...utils_1.tsExtensionsResolver, '.json'],
+            },
+            typescript: true,
+        },
+        // Append 'ts' extensions to Airbnb 'import/extensions' setting
+        // Original: ['.js', '.mjs', '.jsx']
+        'import/extensions': utils_1.tsExtensionsResolver,
+        // Resolve type definition packages
+        'import/external-module-folders': ['node_modules', 'node_modules/@types'],
+    },
+};
+exports.default = legacyTypescriptSettingsRules;

package/dist/rules/node/nodeBase.js

@@ -88,6 +88,9 @@ const nodeBaseRules = {
                 ignores: [],
             },
         ],
+        // Disallow top-level await in published modules
+        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-top-level-await.md
+        'n/no-top-level-await': 'off',
         // Disallow bin files that npm ignores
         // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-unpublished-bin.md
         'n/no-unpublished-bin': 'error',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-config-airbnb-extended",
-  "version": "2.0.0-beta-2",
+  "version": "2.0.0-beta-4",
   "description": "Eslint Airbnb Config Extended",
   "keywords": [
     "eslint",
@@ -45,12 +45,12 @@
   "devDependencies": {
     "@stylistic/eslint-plugin": "^3.1.0",
     "@types/confusing-browser-globals": "^1.0.3",
-    "@types/node": "^22.15.29",
+    "@types/node": "^24.0.1",
     "rimraf": "^6.0.1",
     "tsc-alias": "^1.8.16",
-    "tsx": "^4.19.4",
+    "tsx": "^4.20.3",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.33.0"
+    "typescript-eslint": "^8.34.0"
   },
   "peerDependencies": {
     "@next/eslint-plugin-next": "15.x",