@dr.pogodin/eslint-configs 0.0.1

package/LICENSE.md

@@ -0,0 +1,22 @@
+# MIT License
+
+_Copyright © 2025, Dr. Sergey Pogodin_
+  &mdash; <doc@pogodin.studio> (https://dr.pogodin.studio)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# ESLint Configs
+
+[![Latest NPM Release](https://img.shields.io/npm/v/@dr.pogodin/eslint-configs.svg)](https://www.npmjs.com/package/@dr.pogodin/eslint-configs)
+[![NPM monthly downloads](https://img.shields.io/npm/dm/@dr.pogodin/eslint-configs)](https://www.npmjs.com/package/@dr.pogodin/eslint-configs)
+[![CircleCI](https://dl.circleci.com/status-badge/img/gh/birdofpreyru/eslint-configs/tree/master.svg?style=shield)](https://app.circleci.com/pipelines/github/birdofpreyru/eslint-configs)
+[![GitHub Repo stars](https://img.shields.io/github/stars/birdofpreyru/eslint-configs?style=social)](https://github.com/birdofpreyru/eslint-configs)
+[![Dr. Pogodin Studio](https://raw.githubusercontent.com/birdofpreyru/eslint-configs/master/.README/logo-dr-pogodin-studio.svg)](https://dr.pogodin.studio/docs/eslint-configs)
+
+ESLint configurations for TypeScript and/or React projects. This project is
+invisioned as a replacement of AirBnB ESLint Configs, which are completely
+neglected by AirBnB lately, and are deaf to well justified complaigns of users.
+Thus, the aims of this project are:
+
+- Code style similar to that of AirBnB configs + Some opionated improvements on
+  top of them.
+
+- Support of the latest ESLint releases.
+
+- Timely upgrades of dependencies.
+
+[![Sponsor](https://raw.githubusercontent.com/birdofpreyru/eslint-configs/master/.README/sponsor.svg)](https://github.com/sponsors/birdofpreyru)
+
+## Getting Started
+
+**BEWARE:** These early releases are the very first take on the problem, to get
+things moving. It is definitely needs more attention both to the configurations,
+and to their necessary customization options, and for the config variants
+necessary for different kinds of projects and use cases.
+
+For now, if you want to try on your own risk, you can install the package as
+```sh
+npm install --save-dev @dr.pogodin/eslint-configs
+```
+
+Then use it in your ESLint config:
+```js
+// eslint.config.mjs
+
+import base from '@dr.pogodin/eslint-configs/react-ts';
+// or import from '@dr.pogodin/eslint-config/typescript'; for non-react projects.
+
+export default base;
+// or you may further tune imported "base" config to your project needs.
+```
+
+These configs assume that Babel is configured in the host project to transpile
+TypeScript code into JS.

package/babel.config.cjs

@@ -0,0 +1,10 @@
+module.exports = {
+  presets: [
+    ['@babel/env', {
+      modules: 'cjs',
+      targets: 'defaults',
+    }],
+    ['@babel/react', { runtime: 'automatic' }],
+    '@babel/typescript',
+  ],
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@dr.pogodin/eslint-configs",
+  "version": "0.0.1",
+  "description": "ESLint configurations for TypeScript and/or React projects",
+  "type": "module",
+  "exports": {
+    "./react-ts": "./react-ts.mjs",
+    "./typescript": "./typescript.mjs"
+  },
+  "scripts": {
+    "lint": "eslint -c typescript.mjs",
+    "test": "npm run lint"
+  },
+  "repository": "github:birdofpreyru/eslint-configs",
+  "keywords": [
+    "ESLint",
+    "Config",
+    "React",
+    "TypeScript",
+    "Configuration",
+    "ESLint-Config",
+    "Linter"
+  ],
+  "author": "Dr. Sergey Pogodin <doc@pogodin.studio> (https://dr.pogodin.studio)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/birdofpreyru/eslint-configs/issues"
+  },
+  "homepage": "https://dr.pogodin.studio/docs/eslint-configs",
+  "dependencies": {
+    "@babel/eslint-parser": "^7.26.8",
+    "@babel/eslint-plugin": "^7.25.9",
+    "@babel/preset-env": "^7.26.9",
+    "@babel/preset-react": "^7.26.3",
+    "@babel/preset-typescript": "^7.26.0",
+    "@eslint/js": "^9.21.0",
+    "@stylistic/eslint-plugin": "^4.1.0",
+    "eslint": "^9.21.0",
+    "eslint-import-resolver-typescript": "^4.3.2",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jest": "^28.11.0",
+    "eslint-plugin-react": "^7.37.4",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "globals": "^16.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.25.0"
+  }
+}

package/react-ts.mjs

@@ -0,0 +1,37 @@
+import reactPlugin from 'eslint-plugin-react';
+import reactHooks from 'eslint-plugin-react-hooks';
+
+import base from './typescript.mjs';
+
+export default [
+  ...base,
+  {
+    files: ['**/*.{js,mjs,cjs,ts,jsx,tsx}'],
+    settings: {
+      react: { version: '19' },
+    },
+  },
+
+  reactPlugin.configs.flat.recommended,
+  reactPlugin.configs.flat['jsx-runtime'],
+
+  // TODO: This does not work because a bug in eslint-plugin-react-hooks:
+  // https://github.com/facebook/react/issues/32431
+  // thus, the workaround below.
+  // reactHooks.configs.recommended
+  {
+    plugins: { 'react-hooks': reactHooks },
+    rules: { ...reactHooks.configs.recommended.rules },
+  },
+
+  {
+    rules: {
+      'react/function-component-definition': ['error', {
+        namedComponents: 'arrow-function',
+        unnamedComponents: 'arrow-function',
+      }],
+      'react-hooks/exhaustive-deps': 'error',
+      'react/prop-types': 'off',
+    },
+  },
+];

package/typescript.mjs

@@ -0,0 +1,141 @@
+import babelParser from '@babel/eslint-parser';
+import babelPlugin from '@babel/eslint-plugin';
+import pluginJest from 'eslint-plugin-jest';
+import importPlugin from 'eslint-plugin-import';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+import pluginJs from '@eslint/js';
+import stylisticPlugin from '@stylistic/eslint-plugin';
+
+export default tseslint.config(
+  { ignores: ['__coverage__', 'build/'] },
+  {
+    files: ['**/*.{js,mjs,cjs,ts,jsx,tsx}'],
+    languageOptions: {
+      globals: { ...globals.browser, ...globals.node },
+      parser: babelParser,
+    },
+    linterOptions: {
+      reportUnusedDisableDirectives: 'error',
+      reportUnusedInlineConfigs: 'error',
+    },
+    plugins: {
+      '@babel': babelPlugin,
+    },
+    settings: {
+      'import/resolver': {
+        node: true,
+        typescript: true,
+      },
+    },
+  },
+
+  importPlugin.flatConfigs.recommended,
+
+  pluginJs.configs.recommended,
+
+  stylisticPlugin.configs.all,
+
+  {
+    rules: {
+      '@babel/new-cap': 'error',
+      '@babel/no-invalid-this': 'error',
+      '@babel/no-undef': 'error',
+      '@babel/no-unused-expressions': 'error',
+
+      '@stylistic/object-curly-spacing': 'off',
+      '@babel/object-curly-spacing': ['error', 'always'],
+
+      '@babel/semi': 'error',
+      '@stylistic/array-bracket-newline': ['error', 'consistent'],
+      '@stylistic/array-element-newline': ['error', 'consistent'],
+      '@stylistic/comma-dangle': ['error', 'always-multiline'],
+      '@stylistic/dot-location': ['error', 'property'],
+      '@stylistic/function-call-argument-newline': ['error', 'consistent'],
+      '@stylistic/function-paren-newline': ['error', 'multiline-arguments'],
+      '@stylistic/indent': ['error', 2, {
+        SwitchCase: 1,
+      }],
+      '@stylistic/lines-around-comment': ['error', {
+        allowBlockStart: true,
+        allowClassStart: true,
+        allowObjectStart: true,
+        allowTypeStart: true,
+      }],
+      '@stylistic/max-len': ['error', {
+        ignoreStrings: true,
+        ignoreTemplateLiterals: true,
+      }],
+      '@stylistic/multiline-comment-style': 'off',
+      '@stylistic/multiline-ternary': ['error', 'always-multiline'],
+      '@stylistic/no-extra-parens': ['error', 'all', {
+        enforceForArrowConditionals: false,
+        ignoreJSX: 'multi-line',
+        nestedBinaryExpressions: false,
+        returnAssign: false,
+      }],
+      '@stylistic/no-multiple-empty-lines': ['error', { max: 1 }],
+      '@stylistic/object-curly-newline': ['error', {
+        consistent: true,
+        minProperties: 4,
+      }],
+
+      '@stylistic/object-property-newline': ['error', {
+        allowAllPropertiesOnSameLine: true,
+      }],
+      '@stylistic/operator-linebreak': ['error', 'before'],
+      '@stylistic/padded-blocks': ['error', 'never'],
+      '@stylistic/quote-props': ['error', 'as-needed'],
+      '@stylistic/quotes': ['error', 'single'],
+      '@stylistic/space-before-function-paren': ['error', {
+        named: 'never',
+      }],
+      'import/no-cycle': 'error',
+      'import/no-extraneous-dependencies': 'error',
+
+      'no-use-before-define': 'error',
+    },
+  },
+
+  {
+    // TypeScript-specific configuration.
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    extends: [
+      ...tseslint.configs.recommendedTypeChecked,
+      ...tseslint.configs.stylisticTypeChecked,
+    ],
+    rules: {
+      '@typescript-eslint/array-type': 'off',
+      '@typescript-eslint/consistent-type-definitions': ['error', 'type'],
+      '@typescript-eslint/no-inferrable-types': 'off',
+
+      // TODO: Its current implementation seems to give false positive.
+      '@typescript-eslint/no-invalid-void-type': 'off',
+
+      // NOTE: According to its documentation
+      // "@typescript-eslint/no-unused-vars"
+      // requires to disable "no-unused-vars".
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': 'error',
+
+      '@typescript-eslint/prefer-nullish-coalescing': 'error',
+      '@typescript-eslint/unbound-method': 'off',
+    },
+  },
+
+  {
+    files: ['__tests__/**/*.{js,mjs,cjs,ts,jsx,tsx}'],
+    // TODO: Is this "extends" really necessary?
+    extends: [pluginJest.configs['flat/recommended']],
+    rules: {
+      'jest/unbound-method': 'error',
+    },
+  },
+);