@perfective/eslint-config

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-sonarjs;
• 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

1. Require @perfective/eslint-config and its peer dependencies as dev dependencies.

   npm install --save-dev \
       @perfective/eslint-config \
       @babel/eslint-parser \
       @stylistic/eslint-plugin \
       @stylistic/eslint-plugin-js \
       @stylistic/eslint-plugin-jsx \
       @stylistic/eslint-plugin-ts \
       @stylistic/eslint-plugin-plus \
       @typescript-eslint/eslint-plugin \
       @typescript-eslint/parser \
       eslint \
       eslint-import-resolver-typescript \
       eslint-plugin-array-func \
       eslint-plugin-eslint-comments \
       eslint-plugin-import \
       eslint-plugin-jsdoc \
       eslint-plugin-n \
       eslint-plugin-prefer-arrow \
       eslint-plugin-promise \
       eslint-plugin-security \
       eslint-plugin-simple-import-sort \
       eslint-plugin-sonarjs \
       eslint-plugin-unicorn
   

2. Install optional peer dependencies that add linting rules for the tools you use.

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

   The @perfective/eslint-config automatically includes rules for these plugins, if the dependency is installed.

3. Require the configuration in your root .eslintrc.js.

   module.exports = {
       extends: ['@perfective/eslint-config'],
   };