@hyeon/linter 10.0.1-dev.1.29 → 11.0.1-dev.3.43

package/README.md

@@ -1,25 +1,116 @@
-## Installation
+# @hyeon/linter
 
 ```bash
-npm install --save-dev @hyeon/linter
+npm install --save-dev @hyeon/linter @biomejs/biome
 ```
 
-## Usage
+> AI 사용자용: 설치/셋업 가이드는 [`install.md`](./install.md), 사용 예시는 [`USAGE_EXAMPLES.md`](./USAGE_EXAMPLES.md)를 먼저 확인하세요.
 
-```js
-import hyeonLinter from '@hyeon/linter'
+## 지원 정책
 
-export default [
-  ...hyeonLinter.react,
-  ...hyeonLinter.prettier,
-  ...hyeonLinter.typescript,
-]
-```
+- TypeScript 5.9+ 전용
+- Biome 기반 (lint + format + import organize 단일 도구)
+- ESLint/Prettier 레거시 경로는 v11에서 완전 제거됨
+
+## 왜 Biome인가
+
+### 도구별 속도 벤치마크
+
+> 출처: [oxc-project/bench-linter](https://github.com/oxc-project/bench-linter) (VS Code 코드베이스, M2 Max 12코어)
+
+| 도구 | Lint 시간 | vs ESLint | Format 시간 | vs Prettier |
+|---|---|---|---|---|
+| **ESLint + Prettier** | 31s | 1x | 1x | 1x |
+| **oxlint + oxfmt** | 139ms | **62x** 빠름 | **30x** 빠름 |
+| **Biome** | 377ms | **~20x** 빠름 | **10x** 빠름 |
+
+- oxlint이 Biome보다 ~2.5x 빠르지만, **둘 다 1초 미만**이라 개발자 피드백 루프에 체감 차이 없음
+- 셋 다 **Rust 기반 멀티스레드(rayon)** — 파일 수 증가 시 코어 수에 비례해 스케일
+- ESLint만 **싱글스레드(Node.js)** — 파일 수에 선형 비례해 느려짐
+
+### 룰 커버리지
+
+| 도구 | 총 룰 수 | type-aware | auto-fix | 플러그인 생태계 |
+|---|---|---|---|---|
+| **ESLint** | 700+ (+4000 플러그인) | ✅ 완전 | ✅ 우수 | 4000+ |
+| **Biome v2** | 423+ | ✅ v2 추가 | ✅ 양호 | 성장 중 |
+| **oxlint** | ~300 | ✅ tsgolint 43룰 | ⚠️ 제한적 | 최소 |
+
+### import DX 커버리지 — Biome 선택 이유
+
+| 기능 | ESLint 레거시 | oxlint+oxfmt | Biome |
+|---|:---:|:---:|:---:|
+| import 그룹 정렬 | ✅ | ✅ | ✅ |
+| specifier 정렬 `{ a, B, c }` | ✅ | ❌ | ✅ |
+| 중복 import 병합 | ✅ | ❌ | ✅ 자동 merge |
+| import 최상단 강제 | ✅ | ❌ | ✅ chunk 기반 |
+| import 뒤 빈 줄 | ✅ | ❌ | ✅ `:BLANK_LINE:` |
+| consistent-type-imports | ✅ | ❌ | ✅ `useImportType` |
+| 그룹 간 빈 줄 | ✅ | ⚠️ bool만 | ✅ `:BLANK_LINE:` |
+| side-effect import 처리 | 수동 | 무시 | ✅ auto chunk |
+| custom group (glob) | ❌ | 일부 | ✅ glob + `!` 예외 |
+
+**oxlint+oxfmt은 속도 최강이지만 import DX 격차가 일상 코딩에 매번 영향을 줌. Biome은 기존 ESLint 경험의 대부분을 보존하면서 충분히 빠름.**
+
+### 요약 매트릭스
 
-## vite
+|  | 속도 | 룰 커버리지 | import DX | 단일 도구 | auto-fix |
+|---|:---:|:---:|:---:|:---:|:---:|
+| **oxlint+oxfmt** | ⭐⭐⭐ | ⭐⭐ | ⭐ | ❌ 2개 | ⚠️ |
+| **Biome** | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ✅ 1개 | ✅ |
+| **ESLint+Prettier** | ⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ❌ 2개+ | ✅ |
 
-uninstall
+## 사용 가이드
+
+### 린트 + 포맷 (`biome.json`)
+
+```jsonc
+{
+  "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
+  "linter": {
+    "enabled": true,
+    "rules": { "recommended": true }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120
+  },
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  }
+}
+```
+
+### 실행
 
 ```bash
-eslint-plugin-react-hooks eslint-plugin-react-refresh typescript-eslint globals @eslint/js
+# 린트 + 포맷 + import 정리 한 번에
+npx @biomejs/biome check --write .
+
+# CI (검사만, 수정 없음)
+npx @biomejs/biome ci .
 ```
+
+## v10 → v11 마이그레이션
+
+v11은 **Breaking Change**입니다. ESLint/Prettier를 Biome으로 완전 교체합니다.
+
+### 제거된 항목
+
+- ESLint 설정 export (`./recommended`, `./typescript`, `./react`, `./prettier`, `./hansanghyeon`)
+- `eslint`, `prettier` peerDependencies
+- 모든 ESLint/Prettier 플러그인 의존성
+
+### 마이그레이션 방법
+
+1. `eslint.config.mjs` 삭제
+2. `biome.json` 생성 (위 예시 참고)
+3. `eslint`, `prettier` 및 관련 플러그인 devDependencies 제거
+4. `@biomejs/biome` 설치
+5. lint 스크립트를 `biome check` 또는 `biome ci` 로 변경

package/biome.jsonc

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.11/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noExplicitAny": "off"
+      },
+      "style": {
+        "useImportType": {
+          "level": "error",
+          "options": { "style": "inlineType" }
+        },
+        "noUnusedTemplateLiteral": "off"
+      },
+      "correctness": {
+        "noUnusedVariables": "error",
+        "noUnusedImports": "error"
+      },
+      "nursery": {}
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120,
+    "lineEnding": "lf"
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "jsxQuoteStyle": "double",
+      "trailingCommas": "all",
+      "semicolons": "asNeeded",
+      "arrowParentheses": "always"
+    }
+  },
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": {
+          "level": "on",
+          "options": {
+            "groups": [
+              ":URL:",
+              [":BUN:", ":NODE:"],
+              ":BLANK_LINE:",
+              ":PACKAGE:",
+              ":BLANK_LINE:",
+              ":ALIAS:",
+              ":BLANK_LINE:",
+              ":PATH:"
+            ]
+          }
+        }
+      }
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["*.json", "*.jsonc"],
+      "formatter": {
+        "indentWidth": 2
+      }
+    },
+    {
+      "includes": ["test/src/fixtures/**", "test/src/examples/**"],
+      "linter": { "enabled": false },
+      "assist": { "enabled": false }
+    }
+  ]
+}

package/package.json

@@ -1,70 +1,54 @@
 {
   "name": "@hyeon/linter",
-  "version": "10.0.1-dev.1.29",
-  "description": "Hansanghyun custom eslint settings",
+  "version": "11.0.1-dev.3.43",
+  "description": "Biome-based lint, format, and import organize configuration",
   "main": "./src/index.mjs",
+  "type": "module",
   "scripts": {
-    "lint": "eslint src/",
-    "test": "npm run lint"
+    "lint": "biome ci .",
+    "lint:fix": "biome check --write .",
+    "test": "npm run lint && npm --prefix test run test:all"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://git.hyeon.pro/hansanghyeon/linter.git"
+    "url": "git+https://git.hyeon.pro/space/tools/linter.git"
   },
   "keywords": [
-    "eslint",
-    "eslintconfig",
+    "biome",
+    "linter",
+    "formatter",
     "hyeon",
     "javascript",
     "react",
     "nextjs",
     "nestjs",
-    "typescript",
-    "prettier"
+    "typescript"
   ],
   "author": "hyeon",
   "license": "MIT",
   "bugs": {
-    "url": "https://git.hyeon.pro/hansanghyeon/linter/issues"
+    "url": "https://git.hyeon.pro/space/tools/linter/issues"
   },
-  "homepage": "https://git.hyeon.pro/hansanghyeon/linter#readme",
+  "homepage": "https://git.hyeon.pro/space/tools/linter#readme",
   "dependencies": {
-    "@eslint/js": "^10.0.1",
-    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import-x": "^4.16.1",
-    "eslint-plugin-prettier": "^5.5.5",
-    "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-react-refresh": "^0.5.0",
-    "prettier": "^3.5.3",
-    "prettier-plugin-tailwindcss": "^0.7.2",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.55.0"
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "eslint": "^10.0.0",
-    "prettier": "^3.5.3"
+    "@biomejs/biome": ">=2.0.0"
   },
   "devDependencies": {
-    "eslint": "^10.0.0"
+    "@biomejs/biome": "^2.4.11"
   },
   "exports": {
     ".": {
       "import": "./src/index.mjs",
-      "require": "./src/index.mjs",
       "default": "./src/index.mjs"
     },
-    "./recommended": "./src/base.mjs",
-    "./typescript": "./src/typescript.mjs",
-    "./react": "./src/react.mjs",
-    "./prettier": "./src/prettier.mjs",
-    "./hansanghyeon": "./src/hansanghyeon.mjs",
+    "./biome-config": "./biome.jsonc",
     "./package.json": "./package.json"
   },
   "files": [
-    "typescript",
-    "react",
-    "prettier",
-    "src"
+    "src",
+    "biome.jsonc"
   ]
 }

package/src/index.mjs

@@ -1,29 +1,23 @@
-import hyeonEslintConfigBase from './base.mjs'
-import hyeonEslintConfigHansanghyeon from './hansanghyeon.mjs'
-import hyeonEslintConfigPrettier from './prettier.mjs'
-import hyeonEslintConfigReact from './react.mjs'
-import hyeonEslintConfigTypescript from './typescript.mjs'
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
 
-// 기존 사용자를 위한 객체 형태 유지 (각 속성이 flat config 배열)
+const __dirname = dirname(fileURLToPath(import.meta.url))
 
-const configs = {
-  recommended: hyeonEslintConfigBase,
-  prettier: hyeonEslintConfigPrettier,
-  react: hyeonEslintConfigReact,
-  typescript: hyeonEslintConfigTypescript,
-  hansanghyeon: hyeonEslintConfigHansanghyeon,
-}
-
-// Default export는 설정 객체
-
-export default configs
+/**
+ * @hyeon/linter Biome 설정을 반환합니다.
+ * biome.jsonc를 파싱하여 JSON 객체로 제공합니다.
+ */
+export function getConfig() {
+  const configPath = join(__dirname, '..', 'biome.jsonc')
+  const raw = readFileSync(configPath, 'utf8')
 
-// Named exports로도 개별 설정 제공
-
-export {
-  hyeonEslintConfigBase as recommended,
-  hyeonEslintConfigPrettier as prettier,
-  hyeonEslintConfigReact as react,
-  hyeonEslintConfigTypescript as typescript,
-  hyeonEslintConfigHansanghyeon as hansanghyeon,
+  // JSONC 파싱 (주석/trailing comma 제거)
+  const stripped = raw
+    .replace(/\/\*[\s\S]*?\*\//g, '')
+    .replace(/(^|[^:])\/\/.*$/gm, '$1')
+    .replace(/,\s*([\]}])/g, '$1')
+  return JSON.parse(stripped)
 }
+
+export default getConfig

package/src/base.mjs

@@ -1,3 +0,0 @@
-import js from '@eslint/js'
-
-export default [js.configs.recommended]

package/src/hansanghyeon.mjs

@@ -1,50 +0,0 @@
-import importX from 'eslint-plugin-import-x'
-
-const _import = [
-  importX.flatConfigs.recommended,
-  {
-    rules: {
-      'import-x/first': 'error',
-      'import-x/newline-after-import': 'error',
-      'import-x/no-duplicates': 'error',
-      'import-x/no-unresolved': 'off',
-    },
-  },
-]
-
-const custom = {
-  rules: {
-    'no-empty-pattern': 'off',
-    'lines-around-comment': 'off',
-    camelcase: 'off',
-    'class-methods-use-this': 'off',
-    'no-multi-spaces': [
-      'error',
-      {
-        ignoreEOLComments: true,
-      },
-    ],
-
-    // 보일러플레이트 코드를 생성할때 {} 를 사용하는 경우가 많아서 off
-
-    '@typescript-eslint/no-empty-object-type': 'off',
-    '@typescript-eslint/no-explicit-any': 'off',
-    '@typescript-eslint/no-unused-vars': [
-      'error',
-      {
-        vars: 'all',
-        varsIgnorePattern: '^_.*$|^_$|^P$|^flow$|^pipe$',
-        args: 'all',
-        argsIgnorePattern: '^_.*$|^_$|^P$|^flow$|^pipe$',
-        caughtErrors: 'all',
-        caughtErrorsIgnorePattern: '^_.*$|^_$|^P$|^flow$|^pipe$',
-        destructuredArrayIgnorePattern: '^_.*$|^_$|^P$|^flow$|^pipe$',
-        ignoreRestSiblings: true,
-      },
-    ],
-    'no-confusing-arrow': 'off',
-  },
-  ignores: ['.config/*', 'eslint.config.mjs', 'eslint.config.js'],
-}
-
-export default [custom, ..._import]

package/src/prettier.mjs

@@ -1,68 +0,0 @@
-import eslintConfigPrettier from 'eslint-config-prettier'
-import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended'
-
-export default [
-  eslintConfigPrettier,
-  {
-    ...eslintPluginPrettierRecommended,
-    rules: {
-      'prettier/prettier': [
-        'error',
-        {
-          trailingComma: 'all',
-          singleQuote: true,
-          semi: false,
-          tabWidth: 2,
-          printWidth: 120,
-          arrowParens: 'always',
-          jsxSingleQuote: false,
-          plugins: ['@trivago/prettier-plugin-sort-imports', 'prettier-plugin-tailwindcss'],
-          importOrder: ['^[^.](.*)$', '^[.]{1,2}/.*$'],
-          importOrderSeparation: false,
-          importOrderSortSpecifiers: true,
-
-          /**
-           * @see https://github.com/trivago/prettier-plugin-sort-imports/issues/120
-           */
-
-          importOrderParserPlugins: ['typescript', 'decorators-legacy', 'jsx', 'classProperties'],
-        },
-      ],
-      'arrow-body-style': ['error', 'as-needed'],
-      'prefer-arrow-callback': 'error',
-      curly: ['error', 'all'],
-      'lines-around-comment': [
-        'error',
-        {
-          beforeBlockComment: true,
-          afterBlockComment: true,
-          beforeLineComment: true,
-          afterLineComment: true,
-          allowBlockStart: true,
-          allowBlockEnd: true,
-          allowObjectStart: true,
-          allowObjectEnd: true,
-          allowArrayStart: true,
-          allowArrayEnd: true,
-        },
-      ],
-      'max-len': 'off',
-      'no-confusing-arrow': [
-        'error',
-        {
-          allowParens: false,
-        },
-      ],
-      'no-mixed-operators': 'error',
-      'no-tabs': 'error',
-      quotes: [
-        'error',
-        'single',
-        {
-          avoidEscape: true,
-          allowTemplateLiterals: false,
-        },
-      ],
-    },
-  },
-]

package/src/react.mjs

@@ -1,17 +0,0 @@
-import react from 'eslint-plugin-react'
-import { reactRefresh } from 'eslint-plugin-react-refresh'
-
-export default [
-  {
-    settings: { react: { version: '19.0' } },
-    plugins: {
-      react,
-      'react-refresh': reactRefresh.plugin,
-    },
-    rules: {
-      ...react.configs.recommended.rules,
-      ...react.configs['jsx-runtime'].rules,
-      ...reactRefresh.configs.recommended().rules,
-    },
-  },
-]

package/src/typescript.mjs

@@ -1,50 +0,0 @@
-import js from '@eslint/js'
-import eslintConfigPrettier from 'eslint-config-prettier'
-import tseslint from 'typescript-eslint'
-
-// tseslint.config()는 이미 flat config 배열을 반환
-
-const config = [
-  {
-    ignores: ['**/node_modules/**', '**/dist/**', '**/.turbo/**', '**/coverage/**'],
-  },
-  js.configs.recommended,
-  ...tseslint.configs.recommended,
-  eslintConfigPrettier,
-  {
-    files: ['**/*.ts', '**/*.tsx', '**/*.mts', '**/*.cts'],
-    languageOptions: {
-      parser: tseslint.parser,
-      parserOptions: {
-        ecmaVersion: 'latest',
-        sourceType: 'module',
-        ecmaFeatures: {
-          decorators: true,
-        },
-      },
-    },
-    rules: {
-      '@typescript-eslint/no-explicit-any': 'off',
-      '@typescript-eslint/no-unused-vars': [
-        'error',
-        {
-          argsIgnorePattern: '^_',
-          varsIgnorePattern: '^_',
-        },
-      ],
-      '@typescript-eslint/consistent-type-imports': [
-        'error',
-        {
-          prefer: 'type-imports',
-          fixStyle: 'inline-type-imports',
-          disallowTypeAnnotations: false,
-        },
-      ],
-      '@typescript-eslint/explicit-function-return-type': 'off',
-      '@typescript-eslint/explicit-module-boundary-types': 'off',
-      '@typescript-eslint/no-non-null-assertion': 'off',
-    },
-  },
-]
-
-export default config