@hyeon/linter 11.0.1-dev.3.47 → 11.0.1-dev.3.48

package/README.md

@@ -210,7 +210,192 @@ npm install --save-dev @hyeon/linter @biomejs/biome
 | **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"]
+}
+```
+
+이것만으로 JS recommended 린트 + 포맷 + import 정리가 활성화됩니다.
+
+---
+
+### 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줄로 끝납니다.**
 
 ### 실행
 

package/package.json

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