@hyeon/linter 11.0.1-dev.2.41 → 11.0.1-dev.3.43

package/README.md

@@ -1,7 +1,7 @@
 # @hyeon/linter
 
 ```bash
-npm install --save-dev @hyeon/linter oxlint
+npm install --save-dev @hyeon/linter @biomejs/biome
 ```
 
 > AI 사용자용: 설치/셋업 가이드는 [`install.md`](./install.md), 사용 예시는 [`USAGE_EXAMPLES.md`](./USAGE_EXAMPLES.md)를 먼저 확인하세요.
@@ -9,72 +9,108 @@ npm install --save-dev @hyeon/linter oxlint
 ## 지원 정책
 
 - TypeScript 5.9+ 전용
-- OXC 기반 (oxlint + oxfmt)
+- Biome 기반 (lint + format + import organize 단일 도구)
 - ESLint/Prettier 레거시 경로는 v11에서 완전 제거됨
 
-## 사용 가이드
+## 왜 Biome인가
 
-### 린트 설정 (`oxlint.config.ts`)
+### 도구별 속도 벤치마크
 
-```ts
-import { defineConfig } from "oxlint";
-import { hansanghyeon, recommended, react, typescript } from "@hyeon/linter";
+> 출처: [oxc-project/bench-linter](https://github.com/oxc-project/bench-linter) (VS Code 코드베이스, M2 Max 12코어)
 
-export default defineConfig({
-  extends: [recommended, typescript, react, hansanghyeon],
-  options: {
-    typeAware: true,
-  },
-});
-```
+| 도구 | 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)** — 파일 수에 선형 비례해 느려짐
 
-```ts
-import { defineConfig } from "oxlint";
-import { recommended, typescript } from "@hyeon/linter";
+### 룰 커버리지
 
-export default defineConfig({
-  extends: [recommended, typescript],
-});
-```
+| 도구 | 총 룰 수 | type-aware | auto-fix | 플러그인 생태계 |
+|---|---|---|---|---|
+| **ESLint** | 700+ (+4000 플러그인) | ✅ 완전 | ✅ 우수 | 4000+ |
+| **Biome v2** | 423+ | ✅ v2 추가 | ✅ 양호 | 성장 중 |
+| **oxlint** | ~300 | ✅ tsgolint 43룰 | ⚠️ 제한적 | 최소 |
 
-## 포맷터 템플릿 가이드
+### import DX 커버리지 — Biome 선택 이유
 
-- `@hyeon/linter/oxfmt-template`는 코드로 import할 수 있는 모듈이 아니라
-  프로젝트로 복사해 두어야 하는 **정적 템플릿 파일**입니다.
+| 기능 | 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 + `!` 예외 |
 
-```bash
-# 최초 복사
-cp ./node_modules/@hyeon/linter/templates/oxfmt.base.jsonc ./.oxfmtrc.jsonc
+**oxlint+oxfmt은 속도 최강이지만 import DX 격차가 일상 코딩에 매번 영향을 줌. Biome은 기존 ESLint 경험의 대부분을 보존하면서 충분히 빠름.**
+
+### 요약 매트릭스
+
+|  | 속도 | 룰 커버리지 | import DX | 단일 도구 | auto-fix |
+|---|:---:|:---:|:---:|:---:|:---:|
+| **oxlint+oxfmt** | ⭐⭐⭐ | ⭐⭐ | ⭐ | ❌ 2개 | ⚠️ |
+| **Biome** | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ✅ 1개 | ✅ |
+| **ESLint+Prettier** | ⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ❌ 2개+ | ✅ |
+
+## 사용 가이드
+
+### 린트 + 포맷 (`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"
+      }
+    }
+  }
+}
+```
 
-# 포맷 검사
-npx --no-install oxfmt --config ./.oxfmtrc.jsonc --check ./src
+### 실행
+
+```bash
+# 린트 + 포맷 + import 정리 한 번에
+npx @biomejs/biome check --write .
 
-# 포맷 적용
-npx --no-install oxfmt --config ./.oxfmtrc.jsonc --write ./src
+# CI (검사만, 수정 없음)
+npx @biomejs/biome ci .
 ```
 
 ## v10 → v11 마이그레이션
 
-v11은 **Breaking Change**입니다. ESLint/Prettier 레거시 경로가 모두 제거되었습니다.
+v11은 **Breaking Change**입니다. ESLint/Prettier를 Biome으로 완전 교체합니다.
 
 ### 제거된 항목
 
-- `@hyeon/linter` (기존 ESLint 설정 객체 export) → `@hyeon/linter` (oxlint 설정으로 대체)
-- `@hyeon/linter/legacy`
-- `@hyeon/linter/recommended` (ESLint base)
-- `@hyeon/linter/typescript` (typescript-eslint)
-- `@hyeon/linter/react` (eslint-plugin-react)
-- `@hyeon/linter/prettier` (eslint-plugin-prettier)
-- `@hyeon/linter/hansanghyeon` (ESLint custom)
+- ESLint 설정 export (`./recommended`, `./typescript`, `./react`, `./prettier`, `./hansanghyeon`)
 - `eslint`, `prettier` peerDependencies
-- `fallbackRules` export
+- 모든 ESLint/Prettier 플러그인 의존성
 
 ### 마이그레이션 방법
 
 1. `eslint.config.mjs` 삭제
-2. `oxlint.config.ts` 생성 (위 예시 참고)
-3. `.oxfmtrc.jsonc` 복사 (위 포맷터 가이드 참고)
-4. `eslint`, `prettier` 및 관련 플러그인 devDependencies 제거
-5. lint 스크립트를 `oxlint --config oxlint.config.ts` 으로 변경
+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,24 +1,20 @@
 {
   "name": "@hyeon/linter",
-  "version": "11.0.1-dev.2.41",
-  "description": "OXC-based lint and format configuration (oxlint + oxfmt)",
-  "main": "./src/oxlint.mjs",
+  "version": "11.0.1-dev.3.43",
+  "description": "Biome-based lint, format, and import organize configuration",
+  "main": "./src/index.mjs",
+  "type": "module",
   "scripts": {
-    "lint": "npm run lint:oxlint && npm run format:check",
-    "lint:oxlint": "oxlint --type-aware --config oxlint.config.ts src test/src",
-    "lint:oxlint:syntax": "oxlint --config oxlint.config.ts src test/src",
-    "format:write": "npx --no-install oxfmt --config ./.oxfmtrc.jsonc ./templates/oxfmt.base.jsonc",
-    "format:check": "npx --no-install oxfmt --config ./.oxfmtrc.jsonc --check ./templates/oxfmt.base.jsonc",
+    "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": [
-    "oxlint",
-    "oxfmt",
-    "oxc",
+    "biome",
     "linter",
     "formatter",
     "hyeon",
@@ -31,36 +27,28 @@
   "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": {
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "oxlint": ">=1.0.0"
+    "@biomejs/biome": ">=2.0.0"
   },
   "devDependencies": {
-    "oxfmt": "^0.37.0",
-    "oxlint": "^1.52.0",
-    "oxlint-tsgolint": "^0.16.0"
+    "@biomejs/biome": "^2.4.11"
   },
   "exports": {
     ".": {
-      "types": "./src/oxlint.d.ts",
-      "import": "./src/oxlint.mjs",
-      "default": "./src/oxlint.mjs"
+      "import": "./src/index.mjs",
+      "default": "./src/index.mjs"
     },
-    "./oxlint": {
-      "types": "./src/oxlint.d.ts",
-      "import": "./src/oxlint.mjs",
-      "default": "./src/oxlint.mjs"
-    },
-    "./oxfmt-template": "./templates/oxfmt.base.jsonc",
+    "./biome-config": "./biome.jsonc",
     "./package.json": "./package.json"
   },
   "files": [
     "src",
-    "templates"
+    "biome.jsonc"
   ]
 }

package/src/index.mjs

@@ -0,0 +1,23 @@
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+/**
+ * @hyeon/linter Biome 설정을 반환합니다.
+ * biome.jsonc를 파싱하여 JSON 객체로 제공합니다.
+ */
+export function getConfig() {
+  const configPath = join(__dirname, '..', 'biome.jsonc')
+  const raw = readFileSync(configPath, 'utf8')
+
+  // 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/oxlint.d.ts

@@ -1,8 +0,0 @@
-import type { OxlintConfig } from "oxlint";
-
-type OxlintConfigSnippet = Omit<OxlintConfig, "extends" | "$schema">;
-
-export declare const recommended: OxlintConfigSnippet;
-export declare const typescript: OxlintConfigSnippet;
-export declare const react: OxlintConfigSnippet;
-export declare const hansanghyeon: OxlintConfigSnippet;

package/src/oxlint.mjs

@@ -1,38 +0,0 @@
-const fullRepoIgnorePatterns = [
-  "**/node_modules/**",
-  "**/dist/**",
-  "**/.turbo/**",
-  "**/coverage/**",
-];
-
-export const recommended = {
-  ignorePatterns: fullRepoIgnorePatterns,
-  categories: {
-    correctness: "warn",
-    suspicious: "warn",
-    pedantic: "off",
-    perf: "off",
-    style: "off",
-    restriction: "off",
-    nursery: "off",
-  },
-};
-
-export const typescript = {
-  plugins: ["typescript"],
-  rules: {
-    "typescript/no-explicit-any": "off",
-  },
-};
-
-export const react = {
-  plugins: ["react"],
-};
-
-export const hansanghyeon = {
-  rules: {
-    "no-empty-pattern": "off",
-    camelcase: "off",
-    "no-multi-spaces": "off",
-  },
-};

package/templates/oxfmt.base.jsonc

@@ -1,23 +0,0 @@
-{
-  "printWidth": 120,
-  "tabWidth": 2,
-  "useTabs": false,
-  "semi": false,
-  "singleQuote": true,
-  "jsxSingleQuote": false,
-  "trailingComma": "all",
-  "sortImports": {
-    "newlinesBetween": false,
-    "internalPattern": ["~/", "@/"],
-    "groups": [
-      ["value-builtin", "value-external", "value-internal", "value-subpath"],
-      ["type-builtin", "type-external", "type-internal", "type-subpath"],
-      ["value-parent", "value-sibling", "value-index"],
-      ["type-parent", "type-sibling", "type-index"],
-      "unknown",
-    ],
-  },
-  "sortTailwindcss": {
-    "functions": ["clsx", "cn"],
-  },
-}