@antipain/eslint-config 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wojciech Kosztyła
+
+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,102 @@
+# @antipain/eslint-config
+
+An opinionated, batteries-included ESLint Flat Config (ESLint v9+) for modern **TypeScript**, **JavaScript**, **Stylistic Formatting**, **JSON**, and **CSS**.
+
+---
+
+## Features
+
+- **⚡ ESLint v9 Flat Config:** Native support for the modern `eslint.config.js` format.
+- **🔷 TypeScript & JS:** Modern best practices powered by `typescript-eslint` and `@eslint/js`.
+- **🎨 Code Style & Formatting:** Zero-Prettier setup using `@stylistic/eslint-plugin` (2 spaces, single quotes, 140 line length limit).
+- **📄 Multi-Format Linting:** Built-in linting for `.json` and `.css` files via `@eslint/json` and `@eslint/css`.
+- **⚛️ React Ready:** Ships pre-configured with React Hooks, React Refresh, and JSX Accessibility plugins.
+- **🧩 Modular:** Use the complete bundle or pick only the specific configurations you need.
+
+---
+
+## Installation
+
+Install the package alongside `eslint` as dev dependencies:
+
+```bash
+pnpm add -D @antipain/eslint-config eslint
+# or
+npm install -D @antipain/eslint-config eslint
+# or
+yarn add -D @antipain/eslint-config eslint
+```
+
+## Quick Start
+
+Create an `eslint.config.js` file in the root of your project:
+
+```js
+// eslint.config.js
+import antipainConfig from '@antipain/eslint-config';
+
+export default [
+  ...antipainConfig,
+
+  // Add project-specific ignores or overrides below
+  {
+    ignores: ['dist/**', 'build/**', 'coverage/**'],
+  },
+];
+```
+
+## Modular Usage
+
+If you don't need the entire suite (for example, 
+if you don't want CSS or JSON linting), you can import individual configurations:
+
+```js
+// eslint.config.js
+import { typescript, stylistic } from '@antipain/eslint-config';
+
+export default [
+  ...typescript,
+  ...stylistic,
+
+  // Custom project rule overrides
+  {
+    rules: {
+      'no-console': 'off',
+    },
+  },
+];
+```
+
+## Available Named Exports
+
+| Export        | Files Targeted                 | Key Tools / Plugins                |
+| ------------- | ------------------------------ | ---------------------------------- |
+| `typescript`  | `**/*.{ts,tsx,js,jsx,mjs,cjs}` | `@typescript-eslint`, `@eslint/js` |
+| `stylistic`   | `**/*.{ts,tsx,js,jsx,mjs,cjs}` | `@stylistic/eslint-plugin`         |
+| `json`        | `**/*.json`                    | `@eslint/json`                     |
+| `css`         | `**/*.css`                     | `@eslint/css`                      |
+
+## Recommended `package.json` Scripts
+
+Add these scripts to your `package.json` to run and automatically fix lint issues across your project:
+
+```json
+{
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  }
+}
+```
+
+## Key Style Defaults
+
+- **Indentation:** 2 spaces
+- **Quotes:** Single (`'`), avoiding escapes
+- **Semicolons:** Always required
+- **Line Length:** 140 characters
+- **Unused Variables:** Ignore variables prefixed with `_` (e.g. `_req`)
+
+## License
+
+[MIT](LICENSE) © [Antipain](https://github.com/antipainK)

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@antipain/eslint-config",
+  "version": "0.0.2",
+  "description": "Antipain's shared ESLint configuration for modern TypeScript & JavaScript projects",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/antipainK/lint-configs.git",
+    "directory": "typescript"
+  },
+  "keywords": [
+    "eslint",
+    "eslintconfig",
+    "config",
+    "lint",
+    "typescript",
+    "javascript",
+    "flat-config"
+  ],
+  "author": "Antipain",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "eslint": ">=8.57.0"
+  },
+  "dependencies": {
+    "@eslint/css": "^2.0.0",
+    "@eslint/js": "^10.0.1",
+    "@eslint/json": "^2.1.0",
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-refresh": "^0.5.7",
+    "globals": "^17.12.0",
+    "typescript-eslint": "^8.71.0"
+  },
+  "devDependencies": {
+    "eslint": "^10.11.0"
+  },
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "node --test test/config.test.mjs"
+  }
+}

package/src/configs/css.js

@@ -0,0 +1,19 @@
+import cssPlugin from '@eslint/css';
+
+export default [
+  {
+    ...cssPlugin.configs.recommended,
+    files: [ '**/*.css' ],
+  },
+  {
+    files: [ '**/*.css' ],
+    language: 'css/css',
+    plugins: {
+      css: cssPlugin,
+    },
+    rules: {
+      'css/no-duplicate-imports': 'error',
+      'css/no-empty-blocks': 'error',
+    },
+  },
+];

package/src/configs/json.js

@@ -0,0 +1,23 @@
+import jsonPlugin from '@eslint/json';
+
+export default [
+  {
+    ...jsonPlugin.configs.recommended,
+    files: [ '**/*.json' ],
+    ignores: [ '**/*lock.json' ],
+  },
+  {
+    files: [ '**/*.json' ],
+    ignores: [ '**/coverage/**' ],
+    language: 'json/jsonc',
+    plugins: {
+      json: jsonPlugin,
+    },
+    rules: {
+      'json/no-empty-keys': 'error',
+      'json/no-unnormalized-keys': 'error',
+      'json/no-unsafe-values': 'error',
+      'json/no-duplicate-keys': 'error',
+    },
+  },
+];

package/src/configs/stylistic.js

@@ -0,0 +1,40 @@
+import stylisticPlugin from '@stylistic/eslint-plugin';
+
+export default [
+  {
+    ...stylisticPlugin.configs.recommended,
+    files: [ '**/*.{ts,tsx,js,jsx,mjs,cjs}' ],
+  },
+  {
+    files: [ '**/*.{ts,tsx,js,jsx,mjs,cjs}' ],
+    rules: {
+      '@stylistic/array-bracket-spacing': [ 'error', 'always', { arraysInArrays: false } ],
+      '@stylistic/arrow-parens': [ 'error', 'always' ],
+      '@stylistic/brace-style': [ 'error', '1tbs' ],
+      '@stylistic/comma-dangle': [ 'error', 'always-multiline' ],
+      '@stylistic/comma-spacing': [ 'error', { before: false, after: true } ],
+      '@stylistic/indent': [ 'error', 2 ],
+      '@stylistic/jsx-quotes': [ 'error', 'prefer-single' ],
+      '@stylistic/max-len': [ 'warn', { code: 140, ignoreUrls: true, ignoreStrings: true } ],
+      '@stylistic/no-multiple-empty-lines': [ 'error', { max: 2, maxBOF: 1, maxEOF: 1 } ],
+      '@stylistic/no-trailing-spaces': 'error',
+      '@stylistic/object-curly-spacing': [ 'error', 'always', { arraysInObjects: false, objectsInObjects: false } ],
+      '@stylistic/padding-line-between-statements': [
+        'error',
+        {
+          blankLine: 'always',
+          prev: [ 'block', 'block-like', 'multiline-expression', 'class', 'multiline-const', 'const' ],
+          next: '*',
+        },
+        { blankLine: 'always', prev: '*', next: [ 'multiline-expression', 'if', 'return' ]},
+        { blankLine: 'any', prev: [ 'singleline-const' ], next: [ 'singleline-const' ]} ],
+      '@stylistic/quotes': [ 'error', 'single', { avoidEscape: true } ],
+      '@stylistic/semi': [ 'error', 'always', { omitLastInOneLineClassBody: true } ],
+      'arrow-body-style': [ 'error', 'as-needed', { requireReturnForObjectLiteral: true } ],
+      'sort-imports': [ 'error', { ignoreCase: true, ignoreDeclarationSort: true } ],
+      'sort-keys': [ 'warn', 'asc', { caseSensitive: false, minKeys: 5 } ],
+      'yoda': [ 'warn', 'never', { onlyEquality: true } ],
+
+    },
+  },
+];

package/src/configs/typescript.js

@@ -0,0 +1,42 @@
+import tseslint from 'typescript-eslint';
+import js from '@eslint/js';
+
+export default tseslint.config({
+  extends: [
+    js.configs.recommended,
+    ...tseslint.configs.recommended,
+  ],
+  files: [ '**/*.{ts,tsx,js,jsx,mjs,cjs}' ],
+  linterOptions: {
+    reportUnusedInlineConfigs: 'error',
+    reportUnusedDisableDirectives: 'error',
+  },
+  rules: {
+    '@typescript-eslint/ban-ts-comment': 'error',
+    '@typescript-eslint/no-empty-function': 'warn',
+    '@typescript-eslint/no-unused-vars': [ 'error', {
+      argsIgnorePattern: '^_',
+      varsIgnorePattern: '^_',
+      ignoreRestSiblings: true,
+    } ],
+    'class-methods-use-this': [ 'warn', { enforceForClassFields: false, ignoreOverrideMethods: true } ],
+    'curly': 'error',
+    'default-param-last': 'error',
+    'dot-notation': 'error',
+    'eqeqeq': [ 'error', 'smart' ],
+    'no-await-in-loop': 'warn',
+    'no-console': 'warn',
+    'no-constructor-return': 'warn',
+    'no-duplicate-imports': 'error',
+    'no-else-return': 'error',
+    'no-implicit-coercion': 'warn',
+    'no-param-reassign': [ 'error', { props: false } ],
+    'no-promise-executor-return': 'error',
+    'no-self-compare': 'warn',
+    'no-unneeded-ternary': 'warn',
+    'no-useless-return': 'error',
+    'no-var': 'error',
+    'prefer-const': [ 'error', { destructuring: 'all' } ],
+    'prefer-template': 'warn',
+  },
+});

package/src/index.js

@@ -0,0 +1,13 @@
+import css from './configs/css.js';
+import json from './configs/json.js';
+import typescript from './configs/typescript.js';
+import stylistic from './configs/stylistic.js';
+
+export { css, json, typescript, stylistic };
+
+export default [
+  ...typescript,
+  ...stylistic,
+  ...json,
+  ...css,
+];