@hyeon/linter 11.0.1-dev.3.50 → 11.0.2

package/README.md

@@ -1,16 +1,92 @@
 # @hyeon/linter
 
+패키지 매니저에 맞춰 설치하세요.
+
 ```bash
 npm install --save-dev @hyeon/linter @biomejs/biome
+pnpm add -D @hyeon/linter @biomejs/biome
+yarn add -D @hyeon/linter @biomejs/biome
+bun add -d @hyeon/linter @biomejs/biome
+```
+
+
+## AI 셋업 프롬프트
+
+아래 코드블럭을 복사해서 AI에게 붙여넣으세요.
+
+````
+@hyeon/linter를 이 프로젝트에 설치해줘.
+
+설치:
+프로젝트의 `packageManager`를 확인하고 맞는 명령을 사용해 설치해줘. `packageManager`가 없으면 npm을 사용해줘.
+```bash
+npm install --save-dev @hyeon/linter @biomejs/biome
+pnpm add -D @hyeon/linter @biomejs/biome
+yarn add -D @hyeon/linter @biomejs/biome
+bun add -d @hyeon/linter @biomejs/biome
+```
+
+프로젝트 루트에 biome.jsonc 파일을 생성하고 아래 내용을 넣어줘:
+```jsonc
+{
+  "extends": ["@hyeon/linter/biome-config"]
+}
+```
+
+package.json scripts에 아래를 추가해줘:
+```json
+{
+  "lint": "biome ci .",
+  "lint:fix": "biome check --write .",
+  "lint:fix:unsafe": "biome check --write --unsafe ."
+}
+```
+
+.vscode/settings.json에 아래를 추가해줘:
+```json
+{
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.biome": "explicit",
+    "source.organizeImports.biome": "explicit"
+  },
+  "biome.enabled": true,
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  }
+}
 ```
 
-> AI 사용자용: 설치/셋업 가이드는 [`install.md`](./install.md), 사용 예시는 [`USAGE_EXAMPLES.md`](./USAGE_EXAMPLES.md)를 먼저 확인하세요.
+VS Code Biome 확장에서 `Request textDocument/codeAction failed` 또는 `failed to access range` 오류가 발생하면 `editor.codeActionsOnSave` 블록만 제거하고 `biome check --write .` 또는 `lint:fix` 스크립트로 import 정리와 fix를 수동 적용해줘. 이 오류는 설정 파일보다 Biome VS Code/LSP의 저장 시 codeAction 경로에서 발생하는 경우가 많아 formatter만 저장 시 적용하는 구성이 더 안정적이야.
+
+.vscode/extensions.json에 아래를 추가해줘:
+```json
+{
+  "recommendations": ["biomejs.biome"]
+}
+```
+
+설치 후 biome check --write . 로 전체 포맷을 적용해줘.
+`useOptionalChain`처럼 Biome이 unsafe fix로 분류한 수정까지 적용해야 하면 biome check --write --unsafe . 를 별도로 실행해줘.
+````
+
 
 ## 지원 정책
 
-- TypeScript 5.9+ 전용
+- TypeScript 프로젝트는 TypeScript 5.9+ 기준
 - Biome 기반 (lint + format + import organize 단일 도구)
 - ESLint/Prettier 레거시 경로는 v11에서 완전 제거됨
+- Tailwind CSS v4의 `@theme`, `@utility` 같은 CSS 지시문은 기본 설정에서 파싱 가능
 
 ## 왜 Biome인가
 
@@ -30,10 +106,10 @@ npm install --save-dev @hyeon/linter @biomejs/biome
 
 ### 룰 커버리지
 
-| 도구 | 총 룰 수 | type-aware | auto-fix | 플러그인 생태계 |
+| 도구 | 총 룰 수 | 타입 기반 분석 | auto-fix | 플러그인 생태계 |
 |---|---|---|---|---|
 | **ESLint** | 700+ (+4000 플러그인) | ✅ 완전 | ✅ 우수 | 4000+ |
-| **Biome v2** | 423+ | ✅ v2 추가 | ✅ 양호 | 성장 중 |
+| **Biome v2** | 423+ | ⚠️ 일부 프로젝트 기반 분석 | ✅ 양호 | 성장 중 |
 | **oxlint** | ~300 | ✅ tsgolint 43룰 | ⚠️ 제한적 | 최소 |
 
 ### import DX 커버리지 — Biome 선택 이유
@@ -124,8 +200,8 @@ npm install --save-dev @hyeon/linter @biomejs/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/explicit-function-return-type` | `useExplicitType` | ✅ | nursery 규칙이라 기본 미활성화 |
+| `@ts/explicit-module-boundary-types` | `useExplicitType` | ✅ | nursery 규칙이라 기본 미활성화 |
 | `@ts/no-non-null-assertion` | `noNonNullAssertion` | ✅ | off으로 설정 |
 | `@ts/no-empty-interface` | `noEmptyInterface` | ✅ | |
 | `@ts/no-empty-object-type` | `noBannedTypes` | ✅ | |
@@ -150,6 +226,7 @@ npm install --save-dev @hyeon/linter @biomejs/biome
 | `react-hooks/rules-of-hooks` | `useHookAtTopLevel` | ✅ | |
 | `react-hooks/exhaustive-deps` | `useExhaustiveDependencies` | ✅ | |
 | `react-refresh/only-export-components` | `useComponentExportOnlyModules` | ✅ | |
+| `react/jsx-curly-brace-presence` | `useConsistentCurlyBraces` | ✅ | 문자열 JSX props/children은 중괄호 없이 작성 |
 | `react/display-name` | — | ❌ | Biome 미구현 |
 | `react/no-unescaped-entities` | — | ❌ | Biome 미구현 |
 
@@ -166,7 +243,7 @@ npm install --save-dev @hyeon/linter @biomejs/biome
 | ↳ `arrowParens: always` | `arrowParentheses: "always"` | ✅ | |
 | ↳ `jsxSingleQuote: false` | `jsxQuoteStyle: "double"` | ✅ | |
 | ↳ `@trivago/sort-imports` | `organizeImports` | ✅ | 그룹/정렬/병합 모두 지원 |
-| ↳ `prettier-plugin-tailwindcss` | `useSortedClasses` | ✅ | Biome 내장 |
+| ↳ `prettier-plugin-tailwindcss` | `useSortedClasses` | ⚠️ | Biome 내장 규칙이지만 unsafe fix라 기본 미활성화 |
 | `arrow-body-style` | — | ❌ | Biome 미구현 |
 | `prefer-arrow-callback` | `useArrowFunction` | ✅ | |
 | `curly` | `useBlockStatements` | ✅ | |
@@ -185,7 +262,7 @@ npm install --save-dev @hyeon/linter @biomejs/biome
 | `import-x/no-duplicates` | `organizeImports` 자동 merge | ✅ | |
 | `import-x/no-unresolved` | — | ➖ | 원래 off |
 | `no-empty-pattern` | `noEmptyPattern` | ✅ | off으로 설정 |
-| `camelcase` | `useNamingConvention` | ✅ | off으로 설정 |
+| `camelcase` | `useNamingConvention` | ✅ | 기본 미활성화 |
 | `class-methods-use-this` | — | ❌ | Biome 미구현 |
 | `no-multi-spaces` | formatter | ✅ | |
 
@@ -219,6 +296,9 @@ npm install --save-dev @hyeon/linter @biomejs/biome
 
 ```bash
 npm install --save-dev @hyeon/linter @biomejs/biome
+pnpm add -D @hyeon/linter @biomejs/biome
+yarn add -D @hyeon/linter @biomejs/biome
+bun add -d @hyeon/linter @biomejs/biome
 ```
 
 ### 공통 scripts
@@ -227,11 +307,14 @@ npm install --save-dev @hyeon/linter @biomejs/biome
 {
   "scripts": {
     "lint": "biome ci .",
-    "lint:fix": "biome check --write ."
+    "lint:fix": "biome check --write .",
+    "lint:fix:unsafe": "biome check --write --unsafe ."
   }
 }
 ```
 
+`lint:fix`는 safe fix와 formatter를 적용합니다. `useOptionalChain` 같은 unsafe fix까지 적용해야 할 때만 `lint:fix:unsafe`를 수동으로 실행하세요.
+
 ---
 
 ### 1) JavaScript 프로젝트
@@ -310,9 +393,12 @@ TS + React 규칙이 모두 자동 적용됩니다. ESLint에서는 5개 프리
   "extends": ["@hyeon/linter/biome-config"],
   "linter": {
     "rules": {
-      "nursery": {
-        // Next.js 전용 규칙 활성화
-        "noImgElement": "error",
+      "performance": {
+        // Next.js 전용 이미지 최적화 규칙 활성화
+        "noImgElement": "error"
+      },
+      "style": {
+        // Next.js 전용 head 요소 규칙 활성화
         "noHeadElement": "error"
       }
     }
@@ -337,7 +423,7 @@ TS + React 규칙이 모두 자동 적용됩니다. ESLint에서는 5개 프리
   "extends": ["@hyeon/linter/biome-config"],
   "linter": {
     "rules": {
-      "style": {
+      "complexity": {
         // NestJS 데코레이터 패턴에서 빈 클래스 허용
         "noUselessConstructor": "off"
       }
@@ -375,7 +461,7 @@ monorepo/
   "extends": ["../../biome.jsonc"],
   "linter": {
     "rules": {
-      "nursery": {
+      "performance": {
         "noImgElement": "error"
       }
     }
@@ -401,10 +487,13 @@ monorepo/
 
 ```bash
 # lint + format + import 정리 한 번에
-npx @biomejs/biome check --write .
+npx biome check --write .
+
+# unsafe fix까지 적용해야 할 때만 수동 실행
+npx biome check --write --unsafe .
 
 # CI (검사만, 수정 없음)
-npx @biomejs/biome ci .
+npx biome ci .
 ```
 
 ## v10 → v11 마이그레이션

package/biome.jsonc

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.4.11/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.13/schema.json",
   "vcs": {
     "enabled": true,
     "clientKind": "git",
@@ -17,11 +17,14 @@
           "level": "error",
           "options": { "style": "inlineType" }
         },
-        "noUnusedTemplateLiteral": "off"
+        "noUnusedTemplateLiteral": "off",
+        "noNonNullAssertion": "off",
+        "useConsistentCurlyBraces": "error"
       },
       "correctness": {
         "noUnusedVariables": "error",
-        "noUnusedImports": "error"
+        "noUnusedImports": "error",
+        "noEmptyPattern": "off"
       },
       "nursery": {}
     }
@@ -42,6 +45,11 @@
       "arrowParentheses": "always"
     }
   },
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  },
   "assist": {
     "actions": {
       "source": {

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@hyeon/linter",
-  "version": "11.0.1-dev.3.50",
+  "version": "11.0.2",
   "description": "Biome-based lint, format, and import organize configuration",
   "main": "./src/index.mjs",
   "type": "module",
   "scripts": {
     "lint": "biome ci .",
     "lint:fix": "biome check --write .",
+    "lint:fix:unsafe": "biome check --write --unsafe .",
     "test": "npm run lint && npm --prefix test run test:all"
   },
   "repository": {
@@ -37,7 +38,7 @@
     "@biomejs/biome": ">=2.0.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.11"
+    "@biomejs/biome": "^2.4.13"
   },
   "exports": {
     ".": {

package/src/index.mjs

@@ -12,12 +12,140 @@ 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)
+  return JSON.parse(stripJsonc(raw))
+}
+
+function stripJsonc(raw) {
+  return stripTrailingCommas(stripComments(raw))
+}
+
+function stripComments(raw) {
+  let result = ''
+  let inString = false
+  let stringQuote = ''
+  let escaped = false
+  let inLineComment = false
+  let inBlockComment = false
+
+  for (let index = 0; index < raw.length; index += 1) {
+    const char = raw[index]
+    const nextChar = raw[index + 1]
+
+    if (inLineComment) {
+      if (char === '\n' || char === '\r') {
+        inLineComment = false
+        result += char
+      }
+      continue
+    }
+
+    if (inBlockComment) {
+      if (char === '*' && nextChar === '/') {
+        inBlockComment = false
+        index += 1
+        continue
+      }
+      if (char === '\n' || char === '\r') {
+        result += char
+      }
+      continue
+    }
+
+    if (inString) {
+      result += char
+
+      if (escaped) {
+        escaped = false
+      } else if (char === '\\') {
+        escaped = true
+      } else if (char === stringQuote) {
+        inString = false
+        stringQuote = ''
+      }
+
+      continue
+    }
+
+    if (char === '"' || char === "'") {
+      inString = true
+      stringQuote = char
+      result += char
+      continue
+    }
+
+    if (char === '/' && nextChar === '/') {
+      inLineComment = true
+      index += 1
+      continue
+    }
+
+    if (char === '/' && nextChar === '*') {
+      inBlockComment = true
+      index += 1
+      continue
+    }
+
+    result += char
+  }
+
+  return result
+}
+
+function stripTrailingCommas(raw) {
+  let result = ''
+  let inString = false
+  let stringQuote = ''
+  let escaped = false
+
+  for (let index = 0; index < raw.length; index += 1) {
+    const char = raw[index]
+
+    if (inString) {
+      result += char
+
+      if (escaped) {
+        escaped = false
+      } else if (char === '\\') {
+        escaped = true
+      } else if (char === stringQuote) {
+        inString = false
+        stringQuote = ''
+      }
+
+      continue
+    }
+
+    if (char === '"' || char === "'") {
+      inString = true
+      stringQuote = char
+      result += char
+      continue
+    }
+
+    if (char === ',') {
+      const nextNonWhitespace = findNextNonWhitespace(raw, index + 1)
+
+      if (nextNonWhitespace === '}' || nextNonWhitespace === ']') {
+        continue
+      }
+    }
+
+    result += char
+  }
+
+  return result
+}
+
+function findNextNonWhitespace(raw, startIndex) {
+  for (let index = startIndex; index < raw.length; index += 1) {
+    const char = raw[index]
+
+    if (!/\s/u.test(char)) {
+      return char
+    }
+  }
+
+  return undefined
 }
 
 export default getConfig