@yopem/eslint-config 0.1.0

package/README.md

@@ -0,0 +1,22 @@
+# @yopem/eslint-config
+
+Yopem ESLint configuration.
+
+## Installation
+
+```sh
+npm install @yopem/eslint-config
+# or
+pnpm add @yopem/eslint-config
+# or
+yarn add @yopem/eslint-config
+# or
+bun add @yopem/eslint-config
+# or
+deno install npm:@yopem/eslint-config
+```
+
+## Licence
+
+This project is licensed under the terms of the
+[MIT license](https://github.com/yopem/tooling/blob/main/LICENSE.md).

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@yopem/eslint-config",
+  "version": "0.1.0",
+  "description": "",
+  "keywords": [
+    "eslint",
+    "eslint-config",
+    "tooling"
+  ],
+  "type": "module",
+  "main": "src/base.js",
+  "module": "src/base.js",
+  "types": "src/types.d.ts",
+  "files": [
+    "src"
+  ],
+  "exports": {
+    "./base": {
+      "source": "./src/base.js",
+      "import": {
+        "types": "./src/types.d.ts",
+        "default": "./src/base.js"
+      }
+    },
+    "./nextjs": {
+      "source": "./src/nextjs.js",
+      "import": {
+        "types": "./src/types.d.ts",
+        "default": "./src/nextjs.js"
+      }
+    },
+    "./react": {
+      "source": "./src/react.js",
+      "import": {
+        "types": "./src/types.d.ts",
+        "default": "./src/react.js"
+      }
+    },
+    "./tailwindcss": {
+      "source": "./src/tailwindcss.js",
+      "import": {
+        "types": "./src/types.d.ts",
+        "default": "./src/tailwindcss.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Karyana Yandi <karyana@yandi.me>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yopem/tooling",
+    "directory": "packages/tooling/eslint"
+  },
+  "bugs": {
+    "url": "https://github.com/yopem/tooling/issues"
+  },
+  "scripts": {
+    "lint": "eslint ./src",
+    "lint:fix": "eslint ./src --fix",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@eslint/compat": "1.2.5",
+    "@eslint/js": "9.19.0",
+    "@next/eslint-plugin-next": "15.1.6",
+    "eslint": "9.19.0",
+    "eslint-config-prettier": "10.0.1",
+    "eslint-plugin-import": "2.31.0",
+    "eslint-plugin-jsx-a11y": "6.10.2",
+    "eslint-plugin-prettier": "5.2.3",
+    "eslint-plugin-react": "7.37.4",
+    "eslint-plugin-react-hooks": "5.1.0",
+    "eslint-plugin-tailwindcss": "3.18.0",
+    "eslint-plugin-turbo": "2.3.4",
+    "typescript-eslint": "8.22.0"
+  },
+  "devDependencies": {
+    "@types/eslint__js": "8.42.3",
+    "@yopem/prettier-config": "*",
+    "@yopem/typescript-config": "*",
+    "prettier": "3.4.2",
+    "typescript": "5.7.3"
+  },
+  "prettier": "@yopem/prettier-config/base"
+}

package/src/base.js

@@ -0,0 +1,108 @@
+/// <reference types="./types.d.ts" />
+
+import fs from "fs"
+import path from "node:path"
+import { fileURLToPath } from "node:url"
+import { includeIgnoreFile } from "@eslint/compat"
+import eslint from "@eslint/js"
+import eslintConfigPrettier from "eslint-config-prettier"
+import importPlugin from "eslint-plugin-import"
+import eslintPluginPrettierRecommended from "eslint-plugin-prettier/recommended"
+import turboPlugin from "eslint-plugin-turbo"
+import tseslint from "typescript-eslint"
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const gitignorePath = path.resolve(__dirname, ".gitignore")
+
+export default tseslint.config(
+  fs.existsSync(gitignorePath) && includeIgnoreFile(gitignorePath),
+  { ignores: ["**/*.config.*"] },
+
+  eslintConfigPrettier,
+  eslintPluginPrettierRecommended,
+  {
+    files: ["**/*.js", "**/*.ts", "**/*.tsx"],
+    plugins: {
+      import: importPlugin,
+      turbo: turboPlugin,
+    },
+    extends: [
+      eslint.configs.recommended,
+      ...tseslint.configs.recommended,
+      ...tseslint.configs.recommendedTypeChecked,
+      ...tseslint.configs.stylisticTypeChecked,
+    ],
+    rules: {
+      ...turboPlugin.configs.recommended.rules,
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
+      ],
+      "@typescript-eslint/consistent-type-imports": [
+        "warn",
+        { prefer: "type-imports", fixStyle: "separate-type-imports" },
+      ],
+      "@typescript-eslint/no-misused-promises": [
+        2,
+        { checksVoidReturn: { attributes: false } },
+      ],
+      "@typescript-eslint/no-unnecessary-condition": [
+        "error",
+        {
+          allowConstantLoopConditions: true,
+        },
+      ],
+      "@typescript-eslint/ban-ts-comment": "off",
+      "@typescript-eslint/no-non-null-assertion": "error",
+      "@typescript-eslint/no-unsafe-argument": "off",
+      "@typescript-eslint/no-unsafe-assignment": "off",
+      "@typescript-eslint/no-unsafe-call": "off",
+      "@typescript-eslint/no-unsafe-member-access": "off",
+      "@typescript-eslint/unbound-method": "off",
+      "import/consistent-type-specifier-style": ["off"],
+      "no-restricted-imports": [
+        "error",
+        {
+          patterns: [
+            {
+              group: ["../"],
+              message: `Relative imports are not allowed. Please use '@/' instead.`,
+            },
+          ],
+        },
+      ],
+    },
+  },
+  {
+    linterOptions: { reportUnusedDisableDirectives: true },
+    languageOptions: { parserOptions: { projectService: true } },
+  },
+)
+
+export const restrictEnvAccess = tseslint.config(
+  { ignores: ["**/env.ts"] },
+  {
+    files: ["**/*.js", "**/*.ts", "**/*.tsx"],
+    rules: {
+      "no-restricted-properties": [
+        "error",
+        {
+          object: "process",
+          property: "env",
+          message:
+            "Use `import env from '@/env'` instead to ensure validated types.",
+        },
+      ],
+      "no-restricted-imports": [
+        "error",
+        {
+          name: "process",
+          importNames: ["env"],
+          message:
+            "Use `import env from '@/env'` instead to ensure validated types.",
+        },
+      ],
+    },
+  },
+)

package/src/nextjs.js

@@ -0,0 +1,16 @@
+import nextPlugin from "@next/eslint-plugin-next"
+
+/** @type {Awaited<import('typescript-eslint').Config>} */
+export default [
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    plugins: {
+      "@next/next": nextPlugin,
+    },
+    rules: {
+      ...nextPlugin.configs.recommended.rules,
+      ...nextPlugin.configs["core-web-vitals"].rules,
+      "@next/next/no-duplicate-head": "off",
+    },
+  },
+]

package/src/react.js

@@ -0,0 +1,22 @@
+import reactPlugin from "eslint-plugin-react"
+import hooksPlugin from "eslint-plugin-react-hooks"
+
+/** @type {Awaited<import('typescript-eslint').Config>} */
+export default [
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    plugins: {
+      react: reactPlugin,
+      "react-hooks": hooksPlugin,
+    },
+    rules: {
+      ...reactPlugin.configs["jsx-runtime"].rules,
+      ...hooksPlugin.configs.recommended.rules,
+    },
+    languageOptions: {
+      globals: {
+        React: "writable",
+      },
+    },
+  },
+]

package/src/tailwindcss.js

@@ -0,0 +1,19 @@
+import tailwindcss from "eslint-plugin-tailwindcss"
+
+/** @type {Awaited<import('typescript-eslint').Config>} */
+export default [
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    plugins: {
+      tailwindcss: tailwindcss,
+    },
+    rules: {
+      ...tailwindcss.configs.recommended.rules,
+    },
+    languageOptions: {
+      globals: {
+        React: "writable",
+      },
+    },
+  },
+]

package/src/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Since the ecosystem hasn't fully migrated to ESLint's new FlatConfig system yet,
+ * we "need" to type some of the plugins manually :(
+ */
+
+declare module "eslint-plugin-import" {
+  import type { Linter, Rule } from "eslint"
+
+  export const configs: {
+    recommended: { rules: Linter.RulesRecord }
+  }
+  export const rules: Record<string, Rule.RuleModule>
+}
+
+declare module "eslint-plugin-react" {
+  import type { Linter, Rule } from "eslint"
+
+  export const configs: {
+    recommended: { rules: Linter.RulesRecord }
+    all: { rules: Linter.RulesRecord }
+    "jsx-runtime": { rules: Linter.RulesRecord }
+  }
+  export const rules: Record<string, Rule.RuleModule>
+}
+
+declare module "eslint-plugin-react-hooks" {
+  import type { Linter, Rule } from "eslint"
+
+  export const configs: {
+    recommended: {
+      rules: {
+        "rules-of-hooks": Linter.RuleEntry
+        "exhaustive-deps": Linter.RuleEntry
+      }
+    }
+  }
+  export const rules: Record<string, Rule.RuleModule>
+}
+
+declare module "eslint-plugin-tailwindcss" {
+  import type { Linter, Rule } from "eslint"
+
+  export const configs: {
+    recommended: {
+      rules: {
+        "classnames-order": Linter.RuleEntry
+        "enforces-negative-arbitrary-values": Linter.RuleEntry
+        "enforces-shorthand": Linter.RuleEntry
+        "migration-from-tailwind-2": Linter.RuleEntry
+        "no-arbitrary-value": Linter.RuleEntry
+        "no-contradicting-classname": Linter.RuleEntry
+        "no-custom-classname": Linter.RuleEntry
+        "no-unnecessary-arbitrary-value": Linter.RuleEntry
+      }
+    }
+  }
+  export const rules: Record<string, Rule.RuleModule>
+}
+
+declare module "@next/eslint-plugin-next" {
+  import type { Linter, Rule } from "eslint"
+
+  export const configs: {
+    recommended: { rules: Linter.RulesRecord }
+    "core-web-vitals": { rules: Linter.RulesRecord }
+  }
+  export const rules: Record<string, Rule.RuleModule>
+}