Perfective ESLint Config

@perfective/eslint-config provides a shareable ESLint configuration that is used for the development of the @perfective packages. These rules are primarily configured for TypeScript projects.

In addition to the core ESLint rules, @typescript-eslint, and ESlint Stylistic plugin rules, @perfective/eslint-config includes configurations for the ESLint plugins:

• eslint-plugin-array-func;
• eslint-plugin-cypress (optional);
• eslint-plugin-eslint-comments;
• eslint-plugin-import;
• eslint-plugin-jest (optional);
• eslint-plugin-jest-dom (optional);
• eslint-plugin-jsdoc;
• eslint-plugin-n;
• eslint-plugin-prefer-arrow;
• eslint-plugin-promise;
• eslint-plugin-rxjs (optional);
• eslint-plugin-security;
• eslint-plugin-simple-import-sort;
• eslint-plugin-testing-library (optional);
• eslint-plugin-unicorn.

To simplify configuring ESLint support in the IDEs and editors, the severity of all fixable rules is a warning. In addition, it allows distinguishing errors that have to be fixed manually from issues that will be fixed automatically.

Setup

@perfective/eslint-config only support ES module syntax. If your project uses CommonJS by default you need to use eslint.config.mjs file instead of eslint.config.js to run it in ESM mode.

1. Install @perfective/eslint-config as a dev dependency:

   npm install --save-dev \
       @perfective/eslint-config

   Required peer dependencies are installed automatically.

2. Import perfectiveEslintConfig to eslint.config.js.

   import { perfectiveEslintConfig } from '@perfective/eslint-config';
   
   const eslintConfig = perfectiveEslintConfig();
   
   export default eslintConfig;

3. Optional Install optional peer dependencies to add tool-specific linting rules.

   npm install --save-dev \
       eslint-plugin-cypress \
       eslint-plugin-jest \
       eslint-plugin-jest-dom \
       eslint-plugin-rxjs-x \
       eslint-plugin-testing-library

   Import configurations to eslint.config.js.

   import { perfectiveEslintConfig } from '@perfective/eslint-config';
   
   // Optional dependencies.
   import { cypressConfig } from '@perfective/eslint-config/cypress';
   import { jestConfig } from '@perfective/eslint-config/jest';
   import { jestDomConfig } from '@perfective/eslint-config/jest-dom';
   import { rxjsConfig } from '@perfective/eslint-config/rxjs';
   import { testingLibraryConfig } from '@perfective/eslint-config/testing-library';
   
   const eslintConfig = perfectiveEslintConfig([
       cypressConfig,
       jestConfig,
       jestDomConfig,
       rxjsConfig,
       testingLibraryConfig,
   ]);
   
   export default eslintConfig;

4. Optional Customize configuration rules in eslint.config.js

   import { perfectiveEslintConfig, typescriptFiles } from '@perfective/eslint-config';
   
   const eslintConfig = perfectiveEslintConfig([
       // ...Optional configurations...
       {
           // These rules are overridden to all files
           rules: {
               '@stylistic/indent': ['warn', 2],
           },
       },
       {
           // These rules are overridden to TypeScript files only
           files: typescriptFiles,
           rules: {
               '@stylistic/indent': ['warn', 4],
           },
       },
   ]);
   
   export default eslintConfig;

Read full documentation in the repo.