@bollgade/eslint-config-base 0.0.1

package/LICENSE

@@ -0,0 +1,13 @@
+MIT License Copyright (c) 2025 Чернышев Андрей
+
+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
+
+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,63 @@
+# @bollgade/eslint-config-base
+
+[![npm](https://img.shields.io/npm/v/@bollgade/eslint-config-base)](https://www.npmjs.com/package/@bollgade/eslint-config-base)
+[![downloads](https://img.shields.io/npm/dm/@bollgade/eslint-config-base)](https://www.npmjs.com/package/@bollgade/eslint-config-base)
+
+Base **ESLint flat config** for TypeScript projects: NestJS, Express, and plain TypeScript.  
+It bundles rules from [`@eslint/js`](https://www.npmjs.com/package/@eslint/js), [`typescript-eslint`](https://www.npmjs.com/package/typescript-eslint), [`eslint-plugin-import`](https://www.npmjs.com/package/eslint-plugin-import), [`eslint-plugin-unused-imports`](https://www.npmjs.com/package/eslint-plugin-unused-imports), [`@stylistic/eslint-plugin`](https://www.npmjs.com/package/@stylistic/eslint-plugin), and integrates Prettier via [`eslint-plugin-prettier`](https://www.npmjs.com/package/eslint-plugin-prettier) (using its `recommended` preset).
+
+## Installation
+
+```bash
+npm install -D @bollgade/eslint-config-base
+```
+
+## Usage (ESLint 9 flat config)
+
+Create eslint.config.mts (or eslint.config.js):
+
+```ts
+// eslint.config.mts
+import { defineConfig } from 'eslint/config';
+import baseConfig from '@bollgade/eslint-config-base';
+
+export default defineConfig(
+  baseConfig,
+);
+With local overrides:
+```
+
+```ts
+// eslint.config.mts
+import { defineConfig } from "eslint/config";
+import baseConfig from "@bollgade/eslint-config-base";
+
+export default defineConfig(baseConfig, {
+  rules: {
+    // your overrides
+    "no-console": "off",
+  },
+});
+```
+
+This config assumes you have `tsconfig.json` in your project root; it is used for typed linting via parserOptions.project.
+
+## What’s included
+
+| Category | Purpose                   | Main config / rules                                                                                               |
+| -------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| Core     | Baseline JS linting       | `@eslint/js` → `eslint.configs.recommended` + a few extras (e.g. `no-trailing-spaces`, `max-len`)                 |
+| Language | Runtime globals + parsing | `ecmaVersion: 2024`, `sourceType: 'module'`, `globals: node + jest`                                               |
+| TS rules | Strictness & safety       | `strictTypeChecked` + `stylisticTypeChecked` + extra rules like `no-floating-promises`, `no-unsafe-member-access` |
+| Imports  | Import hygiene            | `eslint-plugin-import` flat configs + `import/order` + `import/no-extraneous-dependencies`                        |
+| Style    | ESLint-first formatting   | `@stylistic/eslint-plugin` preset + a few overrides                                                               |
+| Prettier | Formatting enforcement    | `eslint-plugin-prettier/recommended` + `prettier/prettier` (`singleQuote: true`)                                  |
+
+## Roadmap
+
+Planned improvements:
+
+- Expose a `createBaseConfig(options)` factory to:
+  - Customize `tsconfig` path(s) used for typed linting (e.g. `tsconfig.json`, `tsconfig.eslint.json`).
+  - Toggle strict type-aware linting on/off (switch between strict typed configs and lighter presets).
+  - Enable/disable most rule categories and customize them via options (without requiring users to append manual override blocks).

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import * as eslint_config from 'eslint/config';
+
+declare const config: eslint_config.Config[];
+
+export { config as default };

package/dist/index.js

@@ -0,0 +1,189 @@
+// src/index.ts
+import eslint from "@eslint/js";
+import stylisticPlugin from "@stylistic/eslint-plugin";
+import { defineConfig } from "eslint/config";
+import { flatConfigs as importPluginFlat } from "eslint-plugin-import";
+import eslintPluginPrettierRecommended from "eslint-plugin-prettier/recommended";
+import eslintPluginUnusedImports from "eslint-plugin-unused-imports";
+import globals from "globals";
+import {
+  parser as tseslintParser,
+  configs as tseslintConfigs
+} from "typescript-eslint";
+var shouldBeIgnored = {
+  ignores: [
+    // dependencies
+    "/node_modules",
+    "/.pnp",
+    ".pnp.js",
+    // testing
+    "/coverage",
+    // production
+    "/build",
+    "/dist",
+    "npm-debug.log*",
+    "yarn-debug.log*",
+    "yarn-error.log*"
+  ]
+};
+var overridePrettier = [
+  eslintPluginPrettierRecommended,
+  {
+    rules: {
+      "prettier/prettier": ["error", { singleQuote: true }]
+    }
+  }
+];
+var typescriptLangOpt = {
+  languageOptions: {
+    parser: tseslintParser,
+    parserOptions: {
+      project: ["./tsconfig.json"],
+      tsconfigRootDir: process.cwd()
+    }
+  }
+};
+var typescript = [
+  typescriptLangOpt,
+  ...tseslintConfigs.strictTypeChecked,
+  ...tseslintConfigs.stylisticTypeChecked,
+  {
+    rules: {
+      "@typescript-eslint/no-unsafe-member-access": ["error"],
+      "@typescript-eslint/no-floating-promises": "warn",
+      "@typescript-eslint/no-unused-vars": [
+        "warn",
+        {
+          vars: "all",
+          varsIgnorePattern: "^_",
+          args: "after-used",
+          argsIgnorePattern: "^_"
+        }
+      ]
+    }
+  }
+];
+var overridesForTests = {
+  files: ["**/*.{test,spec}.{ts,js}"],
+  rules: {
+    "max-len": "off"
+  }
+};
+var languageOptions = {
+  languageOptions: {
+    globals: {
+      ...globals.node,
+      ...globals.jest
+    },
+    ecmaVersion: 2024,
+    sourceType: "module"
+  }
+};
+var imports = [
+  importPluginFlat.recommended,
+  {
+    plugins: {
+      "unused-imports": eslintPluginUnusedImports
+    },
+    rules: {
+      "unused-imports/no-unused-imports": "error",
+      "import/order": [
+        "error",
+        {
+          groups: [
+            ["builtin", "external"],
+            "internal",
+            ["parent", "sibling", "index"]
+          ],
+          alphabetize: {
+            order: "asc",
+            caseInsensitive: true
+          }
+        }
+      ],
+      "import/no-extraneous-dependencies": [
+        "error",
+        {
+          devDependencies: [
+            "**/*.config.{ts,js}",
+            "**/eslint.config.*",
+            "**/*.{test,spec}.{ts,js}",
+            "**/{tests,__tests__,test,config}/**/*.{ts,js}"
+          ]
+        }
+      ],
+      "import/extensions": "off",
+      "import/prefer-default-export": "off"
+    }
+  }
+];
+var importsForTS = [
+  importPluginFlat.typescript,
+  {
+    settings: {
+      "import/resolver": {
+        typescript: {
+          alwaysTryTypes: true
+        }
+      }
+    },
+    files: ["**/*.{ts,tsx}"]
+  }
+];
+var stylistic = [
+  stylisticPlugin.configs.customize({
+    semi: true,
+    arrowParens: true,
+    jsx: false
+  }),
+  {
+    rules: {
+      "@stylistic/quote-props": ["error", "as-needed"],
+      "@stylistic/operator-linebreak": "off",
+      "@stylistic/type-annotation-spacing": "error",
+      "@stylistic/space-before-blocks": "error"
+    }
+  }
+];
+var eslintDefaults = [
+  eslint.configs.recommended,
+  {
+    rules: {
+      "no-trailing-spaces": "error",
+      "no-shadow": "off",
+      "no-underscore-dangle": "off",
+      "no-use-before-define": ["error", "nofunc"],
+      "no-param-reassign": [
+        "error",
+        { ignorePropertyModificationsForRegex: ["state"] }
+      ],
+      "no-undef": "off",
+      "no-console": "warn",
+      // Разрешаем в backend
+      // Style
+      "max-len": [
+        "error",
+        {
+          ignoreComments: true,
+          code: 120
+        }
+      ],
+      "prefer-arrow-callback": ["error", { allowNamedFunctions: true }]
+    }
+  }
+];
+var config = defineConfig(
+  shouldBeIgnored,
+  eslintDefaults,
+  overridePrettier,
+  languageOptions,
+  stylistic,
+  typescript,
+  imports,
+  importsForTS,
+  overridesForTests
+);
+var index_default = config;
+export {
+  index_default as default
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@bollgade/eslint-config-base",
+  "version": "0.0.1",
+  "description": "Base ESLint config for TypeScript backend & vanilla JS/TS",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "keywords": [
+    "eslint",
+    "eslintconfig",
+    "eslint-config",
+    "eslint flat config",
+    "flat config",
+    "typescript",
+    "prettier",
+    "import",
+    "unused-imports",
+    "node",
+    "backend",
+    "nestjs"
+  ],
+  "author": "Bollgade <bollgade@gmail.com>",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "prepublishOnly": "npm run build",
+    "lint:ts": "eslint \"**/*.{ts,tsx}\" --max-warnings=0",
+    "lint:ts:fix": "npm run lint:ts -- --fix",
+    "type-check": "tsc --project ./tsconfig.json --noEmit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "eslint": ">=9.0.0"
+  },
+  "dependencies": {
+    "@eslint/js": "^9.18.0",
+    "@stylistic/eslint-plugin": "^5.2.3",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-unused-imports": "^4.1.4",
+    "globals": "^15.0.0",
+    "typescript-eslint": "^8.40.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.10.7",
+    "eslint": "9.39.2",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=18.18.0"
+  }
+}