@tinkoff/eslint-config 5.0.1 → 5.2.1

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+### [5.2.1](https://github.com/tramvaijs/linters/compare/v5.2.0...v5.2.1) (2026-04-23)
+
+**Note:** Version bump only for package @tinkoff/eslint-config
+
+
+
+
+
+## [5.2.0](https://github.com/tramvaijs/linters/compare/v5.1.0...v5.2.0) (2026-03-04)
+
+
+### Features
+
+* **eslint-config:** support mjs extension for resolver ([311578e](https://github.com/tramvaijs/linters/commit/311578e57a578cb942fc2f88135850620ae0e591))
+
+
+
 ### [5.0.1](https://github.com/tramvaijs/linters/compare/v5.0.0...v5.0.1) (2025-01-09)
 
 

package/README.md

@@ -1,6 +1,10 @@
 # @tinkoff/eslint-config
 
-ESlint plugin includes rules for JS and TS codebase. Better to use with framework-oriented packages `@tinkoff/eslint-config-react` or `@tinkoff/eslint-config-angular`
+ESLint config includes rules for JS and TS codebase. Better to use with framework-oriented packages `@tinkoff/eslint-config-react` or `@tinkoff/eslint-config-angular`.
+
+## Requirements
+
+ESLint >= 9 is required.
 
 ## Usage
 
@@ -10,62 +14,60 @@ Install from npm
 npm i --save-dev @tinkoff/eslint-config
 ```
 
-Then, need to include necessary configurations sets to `.eslintrc`. Wee need to choose base configuration, and any
-necessary additional configs. Package include eslint and prettier dependencies, so you should remove eslint, prettier from your project package.json because those packages are transitive dependencies.
+Create `eslint.config.js` at the project root. Package includes eslint and prettier as dependencies, so you should remove them from your project `package.json`.
 
 ### Base configurations
 
 #### For application
 
-```bash
-{
-  "extends": ["@tinkoff/eslint-config/app"]
-}
+```js
+import appConfig from '@tinkoff/eslint-config/app';
+
+export default [...appConfig];
 ```
 
 #### For library
 
-```bash
-{
-  "extends": ["@tinkoff/eslint-config/lib"]
-}
+```js
+import libConfig from '@tinkoff/eslint-config/lib';
+
+export default [...libConfig];
 ```
 
 ### Additional configurations
 
-#### If we use Jest
+#### With Jest
 
-```bash
-{
-  "extends": ["@tinkoff/eslint-config/app", "@tinkoff/eslint-config/jest"]
-}
+```js
+import appConfig from '@tinkoff/eslint-config/app';
+import jestConfig from '@tinkoff/eslint-config/jest';
+
+export default [...appConfig, ...jestConfig];
 ```
 
 ## Configurations overview
 
-Main configurations sets contains common rules
+Main configurations include common rules:
 
-- `@tinkoff/eslint-config/app` - common rules and specific rules for applications
-- `@tinkoff/eslint-config/lib` - common rules and specific rules for libraries
+- `@tinkoff/eslint-config/app` — common rules and specific rules for applications
+- `@tinkoff/eslint-config/lib` — common rules and specific rules for libraries
 
-Additional configurations sets. This configs **not** contain common eslint rules, and must be included with main
-configurations
+Additional configurations. These configs **do not** include common eslint rules and must be included alongside main configurations:
 
-- `@tinkoff/eslint-config/jest` - rules for lint Jest test suits
+- `@tinkoff/eslint-config/jest` — rules for linting Jest test suites
 
 ## Internal used plugins
 
 `@tinkoff/eslint-config/app` and `@tinkoff/eslint-config/lib` include:
 
-- `eslint-config-airbnb` - common and popular configuration
-- `eslint-plugin-eslint-comments` - validate `eslint` comments
-- `eslint-plugin-import` - validate proper imports
-- `eslint-plugin-promise` - enforce best practices for promises
-- `eslint-plugin-jest` - validate jest tests
-- `@typescript-eslint/eslint-plugin` - lint TypeScript files, adopt many eslint rules to TS code, and provide specific
-  TS rules
-- `eslint-plugin-prettier` - disable code formatting using eslint tools and transfers all the logic to a prettier, and
-  report differences as eslint issues
+- `eslint-config-airbnb-extended` — updated version of common and popular configuration `eslint-config-airbnb`
+- `@eslint-community/eslint-plugin-eslint-comments` — validate `eslint` comments
+- `eslint-plugin-import` — validate proper imports
+- `eslint-plugin-promise` — enforce best practices for promises
+- `eslint-plugin-jest` — validate jest tests
+- `@typescript-eslint/eslint-plugin` — lint TypeScript files, adopt many eslint rules to TS code, and provide specific TS rules
+- `eslint-plugin-prettier` — disable code formatting using eslint tools and transfer all the logic to prettier,
+  and report differences as eslint issues
 
 ## Troubleshooting
 
@@ -80,86 +82,80 @@ then reinstall dependencies.
 
 #### In root config
 
-1. Add `"@tinkoff/eslint-config"` to extends section on config.
-2. Set parserOptions.project for typescript files
+Create `eslint.config.js` at the workspace root:
 
-```json5
-{
+```js
+import appConfig from '@tinkoff/eslint-config';
 
-    "root": true,
-    "ignorePatterns": ["**/*"],
-    "extends": ["@tinkoff/eslint-config"]
-    // ...optionally some other configs
-    "overrides": [
-        {
-            "files": ["*.ts", "*.tsx"],
-            "parserOptions": {
-                "project": ["./tsconfig.base.json"]
-            }
-        }
-    ]
-}
+export default [
+  ...appConfig,
+  {
+    ignores: ['**/*'],
+  },
+];
 ```
 
 #### In apps and non-buildable/non-publishable libs
 
-Add `"@tinkoff/eslint-config/app"` in extends section after root config
-
-```json
-{
-    "extends": ["../../.eslintrc.json", "@tinkoff/eslint-config/app"],
-    "ignorePatterns": ["!**/*"]
-    ...optionally some other configs
-}
-```
-
-#### In buildable/publishable libs
+Create `eslint.config.js` in the project directory:
 
-Add `"@tinkoff/eslint-config/lib"` in extends section after root config
+```js
+import rootConfig from '../../eslint.config';
+import appConfig from '@tinkoff/eslint-config/app';
 
-```json
-{
-    "extends": ["../../.eslintrc.json", "@tinkoff/eslint-config/lib"],
-    "ignorePatterns": ["!**/*"]
-    ...optionally some other configs
-}
+export default [
+  ...rootConfig,
+  ...appConfig,
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.json'],
+      },
+    },
+  },
+];
 ```
 
-### Non-JSON configs usage
-
-Nx means usage `.eslintrc.json` for configure ESLint. Just provide it! In `.eslintrc.json` add extension of actual root config file:
+#### In buildable/publishable libs
 
-```
-{
-  "extends": ["./.eslintrc.js"]
-}
+```js
+import rootConfig from '../../eslint.config';
+import libConfig from '@tinkoff/eslint-config/lib';
+
+export default [
+  ...rootConfig,
+  ...libConfig,
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.json'],
+      },
+    },
+  },
+];
 ```
 
-After that:
+### Disable false-positive detections from `import/no-unresolved`
 
-- Nx see what they need and don't re-initialize lint infrastructure
-- You can use [better config formats](https://eslint.org/docs/latest/user-guide/configuring/configuration-files#configuration-file-formats) and nx generators
+Override the rule in the project's `eslint.config.js`:
 
-### Disable false-positive detections from `import/no-unresolved`
+```js
+import appConfig from '@tinkoff/eslint-config/app';
 
-override rule in `.eslintrc` of apps/libs that contains problem:
-
-```json5
-{
-  // ...some other configs...
-  // disable detection for packages starts with @tinkoff/
-  overrides: [
-    {
-      files: ['*.ts', '*.tsx', '*.js', '*.jsx'],
-      rules: {
-        'import/no-unresolved': [
-          'error',
-          {
-            ignore: ['^@tinkoff/'],
-          },
-        ],
-      },
+export default [
+  ...appConfig,
+  {
+    files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+    rules: {
+      'import/no-unresolved': [
+        'error',
+        {
+          ignore: ['^@tinkoff/'],
+        },
+      ],
     },
-  ],
-}
+  },
+];
 ```

package/app.js

@@ -1,7 +1,3 @@
-module.exports = {
-  extends: ['./index'],
+import index from './index.js';
 
-  plugins: [],
-
-  rules: {},
-};
+export default [...index];

package/errors/index.js

@@ -1,14 +1,17 @@
-module.exports = {
-  overrides: [
-    {
-      files: ['*.js', '*.ts', '*.tsx'],
-      parser: '@typescript-eslint/parser',
-      extends: ['eslint-config-airbnb-base/rules/errors'],
-      rules: {
-        // eslint-config-airbnb-base/errors
-        'no-empty': ['error', { allowEmptyCatch: true }],
-        'no-await-in-loop': 'off',
-      },
+import { rules } from 'eslint-config-airbnb-extended/legacy';
+import typescriptParser from '@typescript-eslint/parser';
+
+export default [
+  {
+    files: ['**/*.js', '**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: typescriptParser,
     },
-  ],
-};
+    rules: {
+      ...rules.base.errors.rules,
+      // Overrides
+      'no-empty': ['error', { allowEmptyCatch: true }],
+      'no-await-in-loop': 'off',
+    },
+  },
+];

package/index.js

@@ -1,16 +1,26 @@
-module.exports = {
-  extends: [
-    './internal/base',
-    './internal/sort-class-members',
-    './internal/import',
-    './internal/promise',
-    './internal/test-files',
-    './internal/typescript',
-    './internal/prettier',
-  ],
+import globals from 'globals';
+import base from './internal/base.js';
+import sortClassMembers from './internal/sort-class-members.js';
+import importConfig from './internal/import.js';
+import promise from './internal/promise.js';
+import testFiles from './internal/test-files.js';
+import typescript from './internal/typescript.js';
+import prettier from './internal/prettier.js';
 
-  env: {
-    browser: true,
-    node: true,
+export default [
+  ...base,
+  ...sortClassMembers,
+  ...importConfig,
+  ...promise,
+  ...testFiles,
+  ...typescript,
+  ...prettier,
+  {
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+    },
   },
-};
+];

package/internal/base.js

@@ -1,83 +1,94 @@
-module.exports = {
-  extends: [
-    'eslint-config-airbnb-base',
-    'plugin:eslint-comments/recommended',
-    '../errors/index.js',
-  ],
+import eslintCommentsPlugin from '@eslint-community/eslint-plugin-eslint-comments';
+import babelParser from '@babel/eslint-parser';
+import { configs } from 'eslint-config-airbnb-extended/legacy';
+import errorsConfig from '../errors/index.js';
 
-  parser: '@babel/eslint-parser',
-
-  settings: {
-    'import/parser': '@babel/eslint-parser',
-  },
-
-  plugins: ['@babel'],
-
-  parserOptions: {
-    ecmaFeatures: {
-      legacyDecorators: true,
+export default [
+  ...configs.base.recommended,
+  ...errorsConfig,
+  {
+    plugins: {
+      'eslint-comments': eslintCommentsPlugin,
     },
-    requireConfigFile: false,
-  },
-
-  rules: {
-    'no-unused-expressions': [
-      'error',
-      {
-        allowShortCircuit: true,
-        allowTernary: true,
+    languageOptions: {
+      parser: babelParser,
+      parserOptions: {
+        ecmaFeatures: {
+          legacyDecorators: true,
+        },
+        requireConfigFile: false,
       },
-    ],
-    'no-use-before-define': [
-      'error',
-      {
-        functions: false,
-        classes: false,
-        variables: true,
-      },
-    ],
-    'func-name-matching': 'off',
-    'global-require': 'off',
-    'class-methods-use-this': 'off',
-    'no-continue': 'off',
-    'no-restricted-syntax': 'off',
-    'guard-for-in': 'off',
-    'default-case': 'off',
-    'no-plusplus': 'off',
-    'func-names': 'off',
-    'consistent-return': 'warn',
-    'vars-on-top': 'warn',
-    'no-var': 'warn',
-    camelcase: [
-      'warn',
-      {
-        allow: ['^UNSAFE_'],
-        ignoreDestructuring: false,
-        properties: 'never',
-      },
-    ],
-    'func-style': [
-      'error',
-      'declaration',
-      {
-        allowArrowFunctions: true,
+    },
+    settings: {
+      'import/parser': {
+        '@babel/eslint-parser': ['.js', '.jsx', '.ts', '.tsx'],
       },
-    ],
-    'max-depth': 'off',
-    'max-params': 'off',
-    'max-classes-per-file': ['error', 4],
-    complexity: ['error', 25],
-    'max-statements': ['error', 25],
-    'no-underscore-dangle': 'off',
-    'no-return-assign': ['error', 'except-parens'],
-    'lines-between-class-members': [
-      'error',
-      'always',
-      { exceptAfterSingleLine: true },
-    ],
-    'spaced-comment': ['error', 'always', { exceptions: ['*'] }],
-    'max-nested-callbacks': ['error', 4],
-    'no-bitwise': 'warn',
-    'no-useless-escape': 'warn',
+    },
+    rules: {
+      'eslint-comments/disable-enable-pair': 'error',
+      'eslint-comments/no-aggregating-enable': 'error',
+      'eslint-comments/no-duplicate-disable': 'error',
+      'eslint-comments/no-unlimited-disable': 'error',
+      'eslint-comments/no-unused-enable': 'error',
+
+      'no-unused-expressions': [
+        'error',
+        {
+          allowShortCircuit: true,
+          allowTernary: true,
+        },
+      ],
+      'no-use-before-define': [
+        'error',
+        {
+          functions: false,
+          classes: false,
+          variables: true,
+        },
+      ],
+      'func-name-matching': 'off',
+      'global-require': 'off',
+      'class-methods-use-this': 'off',
+      'no-continue': 'off',
+      'no-restricted-syntax': 'off',
+      'guard-for-in': 'off',
+      'default-case': 'off',
+      'no-plusplus': 'off',
+      'func-names': 'off',
+      'consistent-return': 'warn',
+      'vars-on-top': 'warn',
+      'no-var': 'warn',
+      camelcase: [
+        'warn',
+        {
+          allow: ['^UNSAFE_'],
+          ignoreDestructuring: false,
+          properties: 'never',
+        },
+      ],
+      'func-style': [
+        'error',
+        'declaration',
+        {
+          allowArrowFunctions: true,
+        },
+      ],
+      'max-depth': 'off',
+      'max-params': 'off',
+      'max-classes-per-file': ['error', 4],
+      complexity: ['error', 25],
+      'max-statements': ['error', 25],
+      'no-underscore-dangle': 'off',
+      'no-return-assign': ['error', 'except-parens'],
+      'lines-between-class-members': [
+        'error',
+        'always',
+        { exceptAfterSingleLine: true },
+      ],
+      'spaced-comment': ['error', 'always', { exceptions: ['*'] }],
+      'max-nested-callbacks': ['error', 4],
+      'no-bitwise': 'warn',
+      'no-useless-escape': 'warn',
+    },
   },
-};
+];

package/internal/import.js

@@ -1,34 +1,45 @@
-module.exports = {
-  plugins: ['import'],
+import importPlugin from 'eslint-plugin-import';
 
-  settings: {
-    'import/resolver': {
-      node: {
-        extensions: ['.js', '.ts'],
-      },
-      typescript: {},
-      webpack: {},
+export default [
+  {
+    plugins: {
+      import: importPlugin,
     },
-  },
 
-  rules: {
-    'import/no-commonjs': 'off',
-    'import/unambiguous': 'off',
-    'import/prefer-default-export': 'off', // default imports is evil
-    'import/no-deprecated': 'warn',
-    'import/default': 'error', // enable default import validation
-    'import/extensions': [
-      'error',
-      'always',
-      {
-        js: 'never',
-        jsx: 'never',
-        ts: 'never',
-        tsx: 'never',
+    settings: {
+      'import/resolver': {
+        node: {
+          extensions: ['.js', '.mjs', '.cjs', '.ts'],
+        },
+        typescript: {},
+        webpack: {},
       },
-    ],
-    'import/order': ['warn', { groups: [['builtin', 'external', 'internal']] }],
-    'import/no-extraneous-dependencies': 'off', // need fine tuning
-    'import/no-cycle': 'error',
+    },
+
+    rules: {
+      'import/no-commonjs': 'off',
+      'import/unambiguous': 'off',
+      'import/prefer-default-export': 'off', // default imports is evil
+      'import/no-deprecated': 'warn',
+      'import/default': 'error', // enable default import validation
+      'import/extensions': [
+        'error',
+        'always',
+        {
+          js: 'never',
+          mjs: 'never',
+          cjs: 'never',
+          jsx: 'never',
+          ts: 'never',
+          tsx: 'never',
+        },
+      ],
+      'import/order': [
+        'warn',
+        { groups: [['builtin', 'external', 'internal']] },
+      ],
+      'import/no-extraneous-dependencies': 'off', // need fine tuning
+      'import/no-cycle': 'error',
+    },
   },
-};
+];

package/internal/prettier.js

@@ -1,3 +1,16 @@
-module.exports = {
-  extends: ['plugin:prettier/recommended'],
-};
+import prettierPlugin from 'eslint-plugin-prettier';
+import prettierConfig from 'eslint-config-prettier';
+
+export default [
+  {
+    plugins: {
+      prettier: prettierPlugin,
+    },
+    rules: {
+      ...prettierConfig.rules,
+      'prettier/prettier': 'error',
+      'arrow-body-style': 'off',
+      'prefer-arrow-callback': 'off',
+    },
+  },
+];

package/internal/promise.js

@@ -1,10 +1,13 @@
-module.exports = {
-  extends: ['plugin:promise/recommended'],
+import promisePlugin from 'eslint-plugin-promise';
 
-  rules: {
-    'promise/always-return': 'off',
-    'promise/no-callback-in-promise': 'off',
-    'promise/catch-or-return': 'warn',
-    'promise/param-names': 'warn',
+export default [
+  promisePlugin.configs['flat/recommended'],
+  {
+    rules: {
+      'promise/always-return': 'off',
+      'promise/no-callback-in-promise': 'off',
+      'promise/catch-or-return': 'warn',
+      'promise/param-names': 'warn',
+    },
   },
-};
+];