@hyeon/linter 10.0.1-dev.1.28 → 11.0.0

package/README.md

@@ -1,25 +1,420 @@
-## 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** 빠름 |
+
+- 셋 다 **Rust 기반 멀티스레드(rayon)** — 파일 수 증가 시 코어 수에 비례해 스케일
+- ESLint만 **싱글스레드(Node.js)** — 파일 수에 선형 비례해 느려짐
+- oxlint이 Biome보다 ~2.5x 빠르지만, **둘 다 1초 미만**이라 체감 차이 없음
+
+### 룰 커버리지
+
+| 도구 | 총 룰 수 | 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 + `!` 예외 |
+
+### ESLint → Biome 규칙 마이그레이션 커버리지
+
+기존 `@hyeon/linter` v10에서 사용하던 ESLint 규칙을 Biome에서 어떻게 커버하는지 전수 매핑입니다.
+
+#### `@eslint/js` recommended (base.mjs)
+
+> `@eslint/js` configs.recommended에 포함된 규칙들. Biome은 `"recommended": true`로 대부분 활성화됩니다.
+
+| ESLint 규칙 | Biome 규칙 | 상태 |
+|---|---|:---:|
+| `constructor-super` | `noInvalidConstructorSuper` | ✅ |
+| `for-direction` | `useValidForDirection` | ✅ |
+| `getter-return` | `useGetterReturn` | ✅ |
+| `no-async-promise-executor` | `noAsyncPromiseExecutor` | ✅ |
+| `no-case-declarations` | `noSwitchDeclarations` | ✅ |
+| `no-class-assign` | `noClassAssign` | ✅ |
+| `no-compare-neg-zero` | `noCompareNegZero` | ✅ |
+| `no-cond-assign` | `noAssignInExpressions` | ✅ |
+| `no-const-assign` | `noConstAssign` | ✅ |
+| `no-constant-condition` | `noConstantCondition` | ✅ |
+| `no-control-regex` | `noControlCharactersInRegex` | ✅ |
+| `no-debugger` | `noDebugger` | ✅ |
+| `no-delete-var` | (TS 환경에서 불필요) | ➖ |
+| `no-dupe-args` | `noDuplicateParameters` | ✅ |
+| `no-dupe-class-members` | `noDuplicateClassMembers` | ✅ |
+| `no-dupe-else-if` | `noDuplicateElseIf` | ✅ |
+| `no-dupe-keys` | `noDuplicateObjectKeys` | ✅ |
+| `no-duplicate-case` | `noDuplicateCase` | ✅ |
+| `no-empty` | `noEmptyBlockStatements` | ✅ |
+| `no-empty-character-class` | `noEmptyCharacterClassInRegex` | ✅ |
+| `no-empty-pattern` | `noEmptyPattern` | ✅ |
+| `no-ex-assign` | `noCatchAssign` | ✅ |
+| `no-extra-boolean-cast` | `noExtraBooleanCast` | ✅ |
+| `no-fallthrough` | `noFallthroughSwitchClause` | ✅ |
+| `no-func-assign` | `noFunctionAssign` | ✅ |
+| `no-global-assign` | `noGlobalAssign` | ✅ |
+| `no-import-assign` | `noImportAssign` | ✅ |
+| `no-inner-declarations` | `noInnerDeclarations` | ✅ |
+| `no-irregular-whitespace` | `noIrregularWhitespace` | ✅ |
+| `no-loss-of-precision` | `noPrecisionLoss` | ✅ |
+| `no-misleading-character-class` | `noMisleadingCharacterClass` | ✅ |
+| `no-new-native-nonconstructor` | `noInvalidBuiltinInstantiation` | ✅ |
+| `no-nonoctal-decimal-escape` | `noNonoctalDecimalEscape` | ✅ |
+| `no-obj-calls` | `noGlobalObjectCalls` | ✅ |
+| `no-prototype-builtins` | `noPrototypeBuiltins` | ✅ |
+| `no-redeclare` | `noRedeclare` | ✅ |
+| `no-regex-spaces` | `noMultipleSpacesInRegex` | ✅ |
+| `no-self-assign` | `noSelfAssign` | ✅ |
+| `no-setter-return` | `noSetterReturn` | ✅ |
+| `no-shadow-restricted-names` | `noShadowRestrictedNames` | ✅ |
+| `no-sparse-arrays` | `noSparseArray` | ✅ |
+| `no-this-before-super` | `noUnreachableSuper` | ✅ |
+| `no-undef` | `noUndeclaredVariables` | ✅ |
+| `no-unreachable` | `noUnreachable` | ✅ |
+| `no-unsafe-finally` | `noUnsafeFinally` | ✅ |
+| `no-unsafe-negation` | `noUnsafeNegation` | ✅ |
+| `no-unsafe-optional-chaining` | `noUnsafeOptionalChaining` | ✅ |
+| `no-unused-labels` | `noUnusedLabels` | ✅ |
+| `no-unused-private-class-members` | `noUnusedPrivateClassMembers` | ✅ |
+| `no-unused-vars` | `noUnusedVariables` | ✅ |
+| `no-useless-catch` | `noUselessCatch` | ✅ |
+| `no-useless-escape` | `noUselessEscapeInRegex` | ✅ |
+| `no-with` | `noWith` | ✅ |
+| `require-yield` | `useYield` | ✅ |
+| `use-isnan` | `useIsNan` | ✅ |
+| `valid-typeof` | `useValidTypeof` | ✅ |
+
+#### `typescript-eslint` recommended (typescript.mjs)
+
+| ESLint 규칙 | Biome 규칙 | 상태 | 비고 |
+|---|---|:---:|---|
+| `@ts/no-explicit-any` | `noExplicitAny` | ✅ | off으로 설정 |
+| `@ts/no-unused-vars` | `noUnusedVariables` + `noUnusedFunctionParameters` | ✅ | `_` 접두사 패턴 지원 |
+| `@ts/consistent-type-imports` | `useImportType` | ✅ | `inlineType` 스타일 지원 |
+| `@ts/explicit-function-return-type` | `useExplicitType` | ✅ | off으로 설정 |
+| `@ts/explicit-module-boundary-types` | `useExplicitType` | ✅ | off으로 설정 |
+| `@ts/no-non-null-assertion` | `noNonNullAssertion` | ✅ | off으로 설정 |
+| `@ts/no-empty-interface` | `noEmptyInterface` | ✅ | |
+| `@ts/no-empty-object-type` | `noBannedTypes` | ✅ | |
+| `@ts/ban-types` | `noBannedTypes` | ✅ | |
+| `@ts/no-inferrable-types` | `noInferrableTypes` | ✅ | |
+| `@ts/no-namespace` | `noNamespace` | ✅ | |
+| `@ts/no-unnecessary-type-constraint` | `noUselessTypeConstraint` | ✅ | |
+| `@ts/prefer-as-const` | `useAsConstAssertion` | ✅ | |
+
+#### `eslint-plugin-react` + `react-refresh` (react.mjs)
+
+| ESLint 규칙 | Biome 규칙 | 상태 | 비고 |
+|---|---|:---:|---|
+| `react/jsx-key` | `useJsxKeyInIterable` | ✅ | |
+| `react/jsx-no-comment-textnodes` | `noCommentText` | ✅ | |
+| `react/jsx-no-duplicate-props` | `noDuplicateJsxProps` | ✅ | |
+| `react/jsx-no-target-blank` | `noBlankTarget` | ✅ | |
+| `react/jsx-no-useless-fragment` | `noUselessFragments` | ✅ | |
+| `react/no-children-prop` | `noChildrenProp` | ✅ | |
+| `react/no-danger-with-children` | `noDangerouslySetInnerHtmlWithChildren` | ✅ | |
+| `react/void-dom-elements-no-children` | `noVoidElementsWithChildren` | ✅ | |
+| `react-hooks/rules-of-hooks` | `useHookAtTopLevel` | ✅ | |
+| `react-hooks/exhaustive-deps` | `useExhaustiveDependencies` | ✅ | |
+| `react-refresh/only-export-components` | `useComponentExportOnlyModules` | ✅ | |
+| `react/display-name` | — | ❌ | Biome 미구현 |
+| `react/no-unescaped-entities` | — | ❌ | Biome 미구현 |
+
+#### Prettier + 스타일 규칙 (prettier.mjs)
+
+| ESLint 규칙 | Biome 처리 | 상태 | 비고 |
+|---|---|:---:|---|
+| `prettier/prettier` (포맷 전체) | Biome formatter | ✅ | 단일 도구로 통합 |
+| ↳ `trailingComma: all` | `trailingCommas: "all"` | ✅ | |
+| ↳ `singleQuote: true` | `quoteStyle: "single"` | ✅ | |
+| ↳ `semi: false` | `semicolons: "asNeeded"` | ✅ | |
+| ↳ `tabWidth: 2` | `indentWidth: 2` | ✅ | |
+| ↳ `printWidth: 120` | `lineWidth: 120` | ✅ | |
+| ↳ `arrowParens: always` | `arrowParentheses: "always"` | ✅ | |
+| ↳ `jsxSingleQuote: false` | `jsxQuoteStyle: "double"` | ✅ | |
+| ↳ `@trivago/sort-imports` | `organizeImports` | ✅ | 그룹/정렬/병합 모두 지원 |
+| ↳ `prettier-plugin-tailwindcss` | `useSortedClasses` | ✅ | Biome 내장 |
+| `arrow-body-style` | — | ❌ | Biome 미구현 |
+| `prefer-arrow-callback` | `useArrowFunction` | ✅ | |
+| `curly` | `useBlockStatements` | ✅ | |
+| `lines-around-comment` | — | ❌ | formatter 영역 |
+| `no-confusing-arrow` | — | ❌ | Biome 미구현 |
+| `no-mixed-operators` | — | ❌ | Biome 미구현 |
+| `no-tabs` | formatter `indentStyle: "space"` | ✅ | |
+| `quotes` | formatter `quoteStyle: "single"` | ✅ | |
+
+#### `eslint-plugin-import-x` + 커스텀 (hansanghyeon.mjs)
+
+| ESLint 규칙 | Biome 처리 | 상태 | 비고 |
+|---|---|:---:|---|
+| `import-x/first` | `organizeImports` chunk | ✅ | |
+| `import-x/newline-after-import` | `organizeImports` `:BLANK_LINE:` | ✅ | |
+| `import-x/no-duplicates` | `organizeImports` 자동 merge | ✅ | |
+| `import-x/no-unresolved` | — | ➖ | 원래 off |
+| `no-empty-pattern` | `noEmptyPattern` | ✅ | off으로 설정 |
+| `camelcase` | `useNamingConvention` | ✅ | off으로 설정 |
+| `class-methods-use-this` | — | ❌ | Biome 미구현 |
+| `no-multi-spaces` | formatter | ✅ | |
+
+### 마이그레이션 커버리지 요약
+
+| 카테고리 | 전체 규칙 | ✅ 커버 | ❌ 미커버 | ➖ 해당없음 |
+|---|---|---|---|---|
+| `@eslint/js` recommended | 52 | **50** | 0 | 2 |
+| `typescript-eslint` | 13 | **13** | 0 | 0 |
+| `eslint-plugin-react` + hooks + refresh | 13 | **11** | 2 | 0 |
+| Prettier + 스타일 | 18 | **14** | 4 | 0 |
+| `import-x` + 커스텀 | 8 | **6** | 1 | 1 |
+| **합계** | **104** | **94 (90%)** | **7 (7%)** | **3 (3%)** |
+
+미커버 7개: `react/display-name`, `react/no-unescaped-entities`, `arrow-body-style`, `lines-around-comment`, `no-confusing-arrow`, `no-mixed-operators`, `class-methods-use-this` — 대부분 스타일 취향 규칙이며 실질적 버그 감지에는 영향 없음.
+
+### 요약 매트릭스
+
+|  | 속도 | 룰 커버리지 | import DX | 단일 도구 | auto-fix |
+|---|:---:|:---:|:---:|:---:|:---:|
+| **oxlint+oxfmt** | ⭐⭐⭐ | ⭐⭐ | ⭐ | ❌ 2개 | ⚠️ |
+| **Biome** | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ✅ 1개 | ✅ |
+| **ESLint+Prettier** | ⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ❌ 2개+ | ✅ |
+
+## 프로젝트별 셋업 가이드
+
+> Biome은 파일 확장자로 언어를 자동 감지합니다. `.ts`, `.tsx` 파일은 TS/React 규칙이 자동 적용됩니다.
+> `@hyeon/linter/biome-config`를 `extends`로 상속하면 포맷+린트+import 정리 설정이 한 번에 적용됩니다.
+
+### 공통 설치
+
+```bash
+npm install --save-dev @hyeon/linter @biomejs/biome
+```
+
+### 공통 scripts
+
+```json
+{
+  "scripts": {
+    "lint": "biome ci .",
+    "lint:fix": "biome check --write ."
+  }
+}
+```
+
+---
+
+### 1) JavaScript 프로젝트
+
+```jsonc
+// biome.jsonc
+{
+  "extends": ["@hyeon/linter/biome-config"]
+}
 ```
 
-## vite
+이것만으로 JS recommended 린트 + 포맷 + import 정리가 활성화됩니다.
 
-uninstall
+---
+
+### 2) TypeScript 프로젝트
+
+```jsonc
+// biome.jsonc
+{
+  "extends": ["@hyeon/linter/biome-config"]
+}
+```
+
+`.ts` 파일에 대해 TypeScript 규칙(`useImportType`, `noExplicitAny` 등)이 자동 적용됩니다.
+추가 커스터마이징:
+
+```jsonc
+{
+  "extends": ["@hyeon/linter/biome-config"],
+  "linter": {
+    "rules": {
+      "suspicious": {
+        // any를 엄격히 금지하고 싶은 경우
+        "noExplicitAny": "error"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 3) React 프로젝트
+
+```jsonc
+// biome.jsonc
+{
+  "extends": ["@hyeon/linter/biome-config"]
+}
+```
+
+`.tsx` 파일에 대해 React 규칙(`useJsxKeyInIterable`, `useHookAtTopLevel`, `useExhaustiveDependencies` 등)이 자동 적용됩니다.
+별도 React 프리셋 설치가 필요 없습니다.
+
+---
+
+### 4) TypeScript + React (풀셋)
+
+```jsonc
+// biome.jsonc
+{
+  "extends": ["@hyeon/linter/biome-config"]
+}
+```
+
+TS + React 규칙이 모두 자동 적용됩니다. ESLint에서는 5개 프리셋을 조합해야 했지만 Biome은 1줄입니다.
+
+---
+
+### 5) Next.js 프로젝트
+
+```jsonc
+// biome.jsonc
+{
+  "extends": ["@hyeon/linter/biome-config"],
+  "linter": {
+    "rules": {
+      "nursery": {
+        // Next.js 전용 규칙 활성화
+        "noImgElement": "error",
+        "noHeadElement": "error"
+      }
+    }
+  },
+  "overrides": [
+    {
+      "includes": [".next/**"],
+      "linter": { "enabled": false },
+      "formatter": { "enabled": false }
+    }
+  ]
+}
+```
+
+---
+
+### 6) NestJS / 백엔드 프로젝트
+
+```jsonc
+// biome.jsonc
+{
+  "extends": ["@hyeon/linter/biome-config"],
+  "linter": {
+    "rules": {
+      "style": {
+        // NestJS 데코레이터 패턴에서 빈 클래스 허용
+        "noUselessConstructor": "off"
+      }
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["dist/**"],
+      "linter": { "enabled": false },
+      "formatter": { "enabled": false }
+    }
+  ]
+}
+```
+
+---
+
+### 7) 모노레포
+
+루트에 `biome.jsonc`를 두고, 각 패키지에서 상속합니다:
+
+```
+monorepo/
+├── biome.jsonc              # extends @hyeon/linter/biome-config
+├── packages/
+│   ├── web/
+│   │   └── biome.jsonc      # extends ../../biome.jsonc + Next.js 오버라이드
+│   └── api/
+│       └── biome.jsonc      # extends ../../biome.jsonc + NestJS 오버라이드
+```
+
+```jsonc
+// packages/web/biome.jsonc
+{
+  "extends": ["../../biome.jsonc"],
+  "linter": {
+    "rules": {
+      "nursery": {
+        "noImgElement": "error"
+      }
+    }
+  }
+}
+```
+
+---
+
+### ESLint 프리셋 대응표
+
+| 기존 ESLint 프리셋 | Biome 설정 |
+|---|---|
+| `@hyeon/linter/recommended` | `"extends": ["@hyeon/linter/biome-config"]` (기본 포함) |
+| `@hyeon/linter/typescript` | 자동 적용 (`.ts` 파일 감지) |
+| `@hyeon/linter/react` | 자동 적용 (`.tsx` 파일 감지) |
+| `@hyeon/linter/prettier` | 기본 formatter로 통합 |
+| `@hyeon/linter/hansanghyeon` | 기본 설정에 통합 (`noExplicitAny: off` 등) |
+
+**ESLint에서 5개 프리셋을 조합하던 것이 Biome에서는 `extends` 1줄로 끝납니다.**
+
+### 실행
 
 ```bash
-eslint-plugin-react-hooks eslint-plugin-react-refresh typescript-eslint globals @eslint/js
+# lint + format + import 정리 한 번에
+npx @biomejs/biome check --write .
+
+# CI (검사만, 수정 없음)
+npx @biomejs/biome ci .
 ```
+
+## v10 → v11 마이그레이션
+
+v11은 **Breaking Change**입니다. ESLint/Prettier를 Biome으로 완전 교체합니다.
+
+### 마이그레이션 방법
+
+1. `eslint.config.mjs` 삭제
+2. `biome.jsonc` 생성 또는 `@hyeon/linter/biome-config` 상속
+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.28",
-  "description": "Hansanghyun custom eslint settings",
+  "version": "11.0.0",
+  "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