@miskamyasa/eslint-config 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Denis Zaitsev
+
+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,87 @@
+# @miskamyasa/eslint-config
+
+Opinionated ESLint config for React + TypeScript projects.
+
+## What's included
+
+- ESLint recommended rules
+- TypeScript strict type checking (`typescript-eslint` recommended + strictTypeChecked + stylisticTypeChecked)
+- React rules (`@eslint-react/eslint-plugin` recommended-typescript + `react-hooks`)
+- Import ordering and validation (`eslint-plugin-import-x` + `eslint-plugin-unused-imports`)
+- Stylistic formatting (`@stylistic/eslint-plugin` with double quotes, no semicolons, 2-space indent, stroustrup brace style)
+- CommonJS overrides for `.js`/`.cjs` files
+
+## Requirements
+
+- Node.js >= 22
+- ESLint >= 9
+- TypeScript >= 5
+
+## Install
+
+```sh
+pnpm add -D @miskamyasa/eslint-config eslint typescript
+```
+
+## Usage
+
+Create `eslint.config.ts` in your project root:
+
+```ts
+import createConfig from "@miskamyasa/eslint-config"
+
+export default createConfig({
+  tsconfigRootDir: import.meta.dirname,
+})
+```
+
+> ESLint 10 requires `jiti` for TypeScript config files: `pnpm add -D jiti`
+
+## Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `tsconfigRootDir` | `string` | `process.cwd()` | Root directory for TypeScript project service |
+| `ignores` | `string[]` | `[]` | Additional glob patterns to ignore |
+
+## Overrides
+
+Pass additional ESLint config objects after the options to override or extend rules:
+
+```ts
+import createConfig from "@miskamyasa/eslint-config"
+
+export default createConfig(
+  {tsconfigRootDir: import.meta.dirname},
+  {
+    rules: {
+      "no-console": "off",
+    },
+  },
+)
+```
+
+## Named exports
+
+Individual config functions are available for advanced composition:
+
+```ts
+import {typescript, stylistic, imports, react, javascript} from "@miskamyasa/eslint-config"
+```
+
+## Key style decisions
+
+- Double quotes
+- No semicolons
+- 2-space indentation
+- Stroustrup brace style
+- No curly spacing (`{a}` not `{ a }`)
+- Max line length: 120 (warning)
+- Unix line endings
+- Default exports disallowed (`import-x/no-default-export`)
+- Imports sorted alphabetically with React first
+- Unused imports auto-removed
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+import { Linter } from 'eslint';
+
+declare function createImportsConfig(): Linter.Config[];
+
+declare function javascript(): Linter.Config[];
+
+declare function react(): Linter.Config[];
+
+declare function stylistic(): Linter.Config[];
+
+declare function typescript(options: {
+    tsconfigRootDir: string;
+}): Linter.Config[];
+
+type ConfigItem = Linter.Config;
+type OptionsConfig = {
+    tsconfigRootDir?: string;
+    ignores?: string[];
+};
+
+/**
+ * Construct an array of ESLint flat config items.
+ *
+ * @param options - The options for generating the ESLint configurations.
+ * @param userConfigs - Additional user configurations to be appended.
+ * @returns The composed ESLint configurations.
+ *
+ * @example
+ * ```js
+ * // eslint.config.js
+ * import createConfig from "@miskamyasa/eslint-config"
+ *
+ * export default createConfig({
+ *   tsconfigRootDir: import.meta.dirname,
+ * })
+ * ```
+ */
+declare function createConfig(options?: OptionsConfig, ...userConfigs: Linter.Config[]): Linter.Config[];
+
+declare const GLOB_JS = "**/*.js";
+declare const GLOB_CJS = "**/*.cjs";
+declare const GLOB_TS = "**/*.ts";
+declare const GLOB_TSX = "**/*.tsx";
+declare const GLOB_SRC: string[];
+declare const GLOB_EXCLUDE: string[];
+
+export { type ConfigItem, GLOB_CJS, GLOB_EXCLUDE, GLOB_JS, GLOB_SRC, GLOB_TS, GLOB_TSX, type OptionsConfig, createConfig, createConfig as default, createImportsConfig as imports, javascript, react, stylistic, typescript };

package/dist/index.js

@@ -0,0 +1,388 @@
+// src/configs/imports.ts
+import { createTypeScriptImportResolver } from "eslint-import-resolver-typescript";
+import { flatConfigs as imports } from "eslint-plugin-import-x";
+import unusedImports from "eslint-plugin-unused-imports";
+function createImportsConfig() {
+  return [
+    {
+      ...imports.recommended,
+      name: "miskamyasa/imports/recommended"
+    },
+    {
+      ...imports.react,
+      name: "miskamyasa/imports/react"
+    },
+    {
+      name: "miskamyasa/imports/typescript",
+      settings: {
+        "import-x/resolver-next": [
+          createTypeScriptImportResolver()
+        ]
+      }
+    },
+    {
+      name: "miskamyasa/imports/rules",
+      plugins: {
+        "unused-imports": unusedImports
+      },
+      rules: {
+        "import-x/namespace": "off",
+        "import-x/newline-after-import": [
+          "error",
+          { count: 1 }
+        ],
+        "import-x/named": "off",
+        "import-x/no-cycle": [
+          "error",
+          { ignoreExternal: true, maxDepth: 10 }
+        ],
+        "import-x/no-duplicates": "error",
+        "import-x/no-useless-path-segments": "error",
+        "import-x/no-anonymous-default-export": "error",
+        "import-x/no-default-export": "error",
+        "import-x/order": [
+          "error",
+          {
+            alphabetize: { caseInsensitive: true, order: "asc" },
+            groups: ["builtin", "external", "internal", "parent", "sibling"],
+            "newlines-between": "always",
+            pathGroups: [{ group: "external", pattern: "react+(|-native)", position: "before" }],
+            pathGroupsExcludedImportTypes: ["react", "react-native"]
+          }
+        ],
+        "import-x/no-absolute-path": "error",
+        "unused-imports/no-unused-imports": "error",
+        "unused-imports/no-unused-vars": [
+          "error",
+          { vars: "all", varsIgnorePattern: "^_", args: "after-used", argsIgnorePattern: "^_" }
+        ]
+      }
+    }
+  ];
+}
+
+// src/globs.ts
+var GLOB_JS = "**/*.js";
+var GLOB_CJS = "**/*.cjs";
+var GLOB_TS = "**/*.ts";
+var GLOB_TSX = "**/*.tsx";
+var GLOB_SRC = [
+  GLOB_JS,
+  GLOB_CJS,
+  GLOB_TS,
+  GLOB_TSX
+];
+var GLOB_EXCLUDE = [
+  "**/node_modules",
+  "**/dist",
+  "**/package-lock.json",
+  "**/yarn.lock",
+  "**/pnpm-lock.yaml",
+  "**/bun.lockb"
+];
+
+// src/configs/javascript.ts
+function javascript() {
+  return [
+    {
+      name: "miskamyasa/javascript/overrides",
+      files: [GLOB_JS, GLOB_CJS],
+      languageOptions: {
+        globals: {
+          require: "readonly",
+          module: "readonly",
+          __dirname: "readonly"
+        }
+      },
+      rules: {
+        "@typescript-eslint/explicit-function-return-type": "off",
+        "@typescript-eslint/no-require-imports": "off",
+        "@typescript-eslint/no-var-requires": "off"
+      }
+    }
+  ];
+}
+
+// src/configs/react.ts
+import reactPlugin from "@eslint-react/eslint-plugin";
+import reactHooksPlugin from "eslint-plugin-react-hooks";
+function react() {
+  return [
+    {
+      ...reactPlugin.configs["recommended-typescript"],
+      name: "miskamyasa/react/recommended-typescript"
+    },
+    {
+      name: "miskamyasa/react/rules",
+      plugins: {
+        "react-hooks": reactHooksPlugin
+      },
+      rules: {
+        "react-hooks/rules-of-hooks": "error",
+        "react-hooks/exhaustive-deps": "error"
+      }
+    }
+  ];
+}
+
+// src/configs/stylistic.ts
+import stylisticPlugin from "@stylistic/eslint-plugin";
+function stylistic() {
+  const stylistic2 = stylisticPlugin;
+  return [
+    {
+      ...stylistic2.configs["disable-legacy"],
+      name: "miskamyasa/stylistic/disable-legacy"
+    },
+    {
+      name: "miskamyasa/stylistic/rules",
+      plugins: {
+        "@stylistic": stylistic2
+      },
+      rules: {
+        "@stylistic/block-spacing": ["error", "never"],
+        "@stylistic/comma-dangle": ["error", "always-multiline"],
+        "@stylistic/indent": ["error", 2],
+        "@stylistic/jsx-closing-bracket-location": [
+          "error",
+          { "nonEmpty": "after-props", "selfClosing": "after-props" }
+        ],
+        "@stylistic/jsx-curly-spacing": [
+          "error",
+          {
+            "attributes": {
+              "allowMultiline": false
+            },
+            "children": true,
+            "when": "never"
+          }
+        ],
+        "@stylistic/jsx-first-prop-new-line": ["error", "multiline-multiprop"],
+        "@stylistic/jsx-indent-props": ["error", 2],
+        "@stylistic/jsx-max-props-per-line": ["error", { "maximum": 1 }],
+        "@stylistic/jsx-sort-props": [
+          "error",
+          {
+            "callbacksLast": true,
+            "ignoreCase": true,
+            "noSortAlphabetically": false,
+            "reservedFirst": true,
+            "shorthandFirst": true,
+            "shorthandLast": false
+          }
+        ],
+        "@stylistic/jsx-tag-spacing": [
+          "error",
+          {
+            "afterOpening": "never",
+            "beforeClosing": "allow",
+            "beforeSelfClosing": "allow",
+            "closingSlash": "never"
+          }
+        ],
+        "@stylistic/jsx-wrap-multilines": [
+          "error",
+          {
+            "arrow": "parens",
+            "assignment": "parens",
+            "condition": "ignore",
+            "declaration": "parens",
+            "logical": "ignore",
+            "prop": "ignore",
+            "return": "parens"
+          }
+        ],
+        "@stylistic/key-spacing": [
+          "error",
+          {
+            "afterColon": true,
+            "mode": "strict"
+          }
+        ],
+        "@stylistic/keyword-spacing": [
+          "error",
+          {
+            "after": true,
+            "before": true
+          }
+        ],
+        "@stylistic/linebreak-style": [
+          "error",
+          "unix"
+        ],
+        "@stylistic/max-len": [
+          "warn",
+          {
+            "code": 120
+          }
+        ],
+        "@stylistic/no-multiple-empty-lines": [
+          "error",
+          {
+            "max": 1,
+            "maxEOF": 0,
+            "maxBOF": 0
+          }
+        ],
+        "no-multi-spaces": "error",
+        "@stylistic/object-curly-newline": [
+          "error",
+          {
+            "consistent": true,
+            "multiline": true
+          }
+        ],
+        "@stylistic/object-curly-spacing": ["error", "never"],
+        "@stylistic/object-property-newline": [
+          "error",
+          { "allowAllPropertiesOnSameLine": true }
+        ],
+        "@stylistic/operator-linebreak": [
+          "error",
+          "before",
+          { "overrides": { "=": "after" } }
+        ],
+        "@stylistic/quotes": [
+          "error",
+          "double",
+          {
+            "avoidEscape": true
+          }
+        ],
+        "@stylistic/semi": [
+          "error",
+          "never"
+        ],
+        "@stylistic/space-before-blocks": [
+          "error",
+          "always"
+        ],
+        "@stylistic/space-infix-ops": "error",
+        "@stylistic/switch-colon-spacing": [
+          "error",
+          { "after": true, "before": false }
+        ],
+        "@stylistic/type-annotation-spacing": "error",
+        "@stylistic/member-delimiter-style": [
+          "error",
+          {
+            "multilineDetection": "brackets",
+            "multiline": {
+              "delimiter": "comma",
+              "requireLast": true
+            },
+            "singleline": {
+              "delimiter": "comma",
+              "requireLast": false
+            },
+            "overrides": {
+              "interface": {
+                "multiline": {
+                  "delimiter": "none"
+                },
+                "singleline": {
+                  "delimiter": "comma"
+                }
+              }
+            }
+          }
+        ],
+        "comma-spacing": ["error", { "before": false, "after": true }],
+        "no-console": ["warn", { allow: ["warn", "error"] }],
+        "brace-style": ["error", "stroustrup"],
+        "no-use-before-define": "error"
+      }
+    }
+  ];
+}
+
+// src/configs/typescript.ts
+import { configs } from "typescript-eslint";
+function typescript(options) {
+  return [
+    ...configs.recommended,
+    ...configs.strictTypeChecked,
+    ...configs.stylisticTypeChecked,
+    {
+      name: "miskamyasa/typescript/language-options",
+      languageOptions: {
+        parserOptions: {
+          projectService: true,
+          tsconfigRootDir: options.tsconfigRootDir
+        }
+      }
+    },
+    {
+      name: "miskamyasa/typescript/rules",
+      rules: {
+        "@typescript-eslint/consistent-type-definitions": ["error", "type"],
+        "@typescript-eslint/no-unused-vars": "off",
+        "@typescript-eslint/restrict-template-expressions": [
+          "error",
+          {
+            allowNumber: true,
+            allowBoolean: false,
+            allowAny: false,
+            allowNullish: false,
+            allowRegExp: false
+          }
+        ],
+        "@typescript-eslint/no-misused-promises": [
+          "error",
+          { checksVoidReturn: { attributes: false } }
+        ]
+      }
+    }
+  ];
+}
+
+// src/factory.ts
+import eslint from "@eslint/js";
+function createConfig(options = {}, ...userConfigs) {
+  const {
+    tsconfigRootDir = process.cwd(),
+    ignores = []
+  } = options;
+  return [
+    // Global ignores
+    {
+      name: "miskamyasa/ignores",
+      ignores: [
+        ...GLOB_EXCLUDE,
+        ...ignores
+      ]
+    },
+    // ESLint recommended
+    {
+      ...eslint.configs.recommended,
+      name: "miskamyasa/eslint/recommended"
+    },
+    // TypeScript
+    ...typescript({ tsconfigRootDir }),
+    // Imports
+    ...createImportsConfig(),
+    // React
+    ...react(),
+    // Stylistic
+    ...stylistic(),
+    // JavaScript/CJS overrides (must come after TypeScript rules)
+    ...javascript(),
+    // User configs (appended last for maximum override power)
+    ...userConfigs
+  ];
+}
+export {
+  GLOB_CJS,
+  GLOB_EXCLUDE,
+  GLOB_JS,
+  GLOB_SRC,
+  GLOB_TS,
+  GLOB_TSX,
+  createConfig,
+  createConfig as default,
+  createImportsConfig as imports,
+  javascript,
+  react,
+  stylistic,
+  typescript
+};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@miskamyasa/eslint-config",
+  "type": "module",
+  "version": "1.0.1",
+  "description": "Opinionated ESLint config for React + TypeScript projects",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "eslint",
+    "eslint-config",
+    "typescript",
+    "react",
+    "stylistic"
+  ],
+  "author": "Denis <MiskaMyasa> Zaitsev",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "@eslint-react/eslint-plugin": "2.13.0",
+    "@eslint/js": "10.0.1",
+    "@stylistic/eslint-plugin": "5.10.0",
+    "eslint-import-resolver-typescript": "4.4.4",
+    "eslint-plugin-import-x": "4.16.2",
+    "eslint-plugin-react-hooks": "7.0.1",
+    "eslint-plugin-unused-imports": "4.4.1",
+    "typescript-eslint": "8.57.0"
+  },
+  "peerDependencies": {
+    "eslint": ">=9.0.0",
+    "typescript": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.5.0",
+    "eslint": "10.0.3",
+    "jiti": "2.6.1",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  }
+}