@hyeon/linter 11.0.1-dev.3.44 → 11.0.1-dev.3.46

package/README.md

@@ -24,9 +24,9 @@ npm install --save-dev @hyeon/linter @biomejs/biome
 | **oxlint + oxfmt** | 139ms | **62x** 빠름 | **30x** 빠름 |
 | **Biome** | 377ms | **~20x** 빠름 | **10x** 빠름 |
 
-- oxlint이 Biome보다 ~2.5x 빠르지만, **둘 다 1초 미만**이라 개발자 피드백 루프에 체감 차이 없음
 - 셋 다 **Rust 기반 멀티스레드(rayon)** — 파일 수 증가 시 코어 수에 비례해 스케일
 - ESLint만 **싱글스레드(Node.js)** — 파일 수에 선형 비례해 느려짐
+- oxlint이 Biome보다 ~2.5x 빠르지만, **둘 다 1초 미만**이라 체감 차이 없음
 
 ### 룰 커버리지
 
@@ -50,7 +50,157 @@ npm install --save-dev @hyeon/linter @biomejs/biome
 | side-effect import 처리 | 수동 | 무시 | ✅ auto chunk |
 | custom group (glob) | ❌ | 일부 | ✅ glob + `!` 예외 |
 
-**oxlint+oxfmt은 속도 최강이지만 import DX 격차가 일상 코딩에 매번 영향을 줌. Biome은 기존 ESLint 경험의 대부분을 보존하면서 충분히 빠름.**
+### 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` — 대부분 스타일 취향 규칙이며 실질적 버그 감지에는 영향 없음.
 
 ### 요약 매트릭스
 
@@ -62,35 +212,10 @@ npm install --save-dev @hyeon/linter @biomejs/biome
 
 ## 사용 가이드
 
-### 린트 + 포맷 (`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
-# 린트 + 포맷 + import 정리 한 번에
+# lint + format + import 정리 한 번에
 npx @biomejs/biome check --write .
 
 # CI (검사만, 수정 없음)
@@ -101,16 +226,10 @@ npx @biomejs/biome ci .
 
 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` 생성 (위 예시 참고)
+2. `biome.jsonc` 생성 또는 `@hyeon/linter/biome-config` 상속
 3. `eslint`, `prettier` 및 관련 플러그인 devDependencies 제거
 4. `@biomejs/biome` 설치
 5. lint 스크립트를 `biome check` 또는 `biome ci` 로 변경

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyeon/linter",
-  "version": "11.0.1-dev.3.44",
+  "version": "11.0.1-dev.3.46",
   "description": "Biome-based lint, format, and import organize configuration",
   "main": "./src/index.mjs",
   "type": "module",