@hyeon/linter 11.0.1 → 11.0.3

package/README.md

@@ -37,7 +37,8 @@ package.json scripts에 아래를 추가해줘:
 ```json
 {
   "lint": "biome ci .",
-  "lint:fix": "biome check --write ."
+  "lint:fix": "biome check --write .",
+  "lint:fix:unsafe": "biome check --write --unsafe ."
 }
 ```
 
@@ -49,10 +50,25 @@ package.json scripts에 아래를 추가해줘:
   "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"
   }
 }
 ```
 
+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
 {
@@ -61,6 +77,7 @@ package.json scripts에 아래를 추가해줘:
 ```
 
 설치 후 biome check --write . 로 전체 포맷을 적용해줘.
+`useSortedClasses` Tailwind class 정렬과 `useOptionalChain`처럼 Biome이 unsafe fix로 분류한 수정까지 적용해야 하면 biome check --write --unsafe . 를 별도로 실행해줘.
 ````
 
 
@@ -70,6 +87,8 @@ package.json scripts에 아래를 추가해줘:
 - Biome 기반 (lint + format + import organize 단일 도구)
 - ESLint/Prettier 레거시 경로는 v11에서 완전 제거됨
 - Tailwind CSS v4의 `@theme`, `@utility` 같은 CSS 지시문은 기본 설정에서 파싱 가능
+- Tailwind CSS class 정렬은 `useSortedClasses`를 기본 `error`로 활성화하며, `clsx`/`cva`/`cn`/`tw` 계열 함수 문자열도 검사
+- Tailwind class 정렬 적용은 Biome unsafe fix에 해당하므로 `lint:fix:unsafe` 또는 `biome check --write --unsafe .` 사용
 
 ## 왜 Biome인가
 
@@ -290,11 +309,14 @@ bun add -d @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 프로젝트
@@ -469,6 +491,9 @@ monorepo/
 # lint + format + import 정리 한 번에
 npx biome check --write .
 
+# unsafe fix까지 적용해야 할 때만 수동 실행
+npx biome check --write --unsafe .
+
 # CI (검사만, 수정 없음)
 npx biome ci .
 ```

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",
@@ -26,7 +26,14 @@
         "noUnusedImports": "error",
         "noEmptyPattern": "off"
       },
-      "nursery": {}
+      "nursery": {
+        "useSortedClasses": {
+          "level": "error",
+          "options": {
+            "functions": ["clsx", "cva", "cn", "tw", "tw.*"]
+          }
+        }
+      }
     }
   },
   "formatter": {

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@hyeon/linter",
-  "version": "11.0.1",
+  "version": "11.0.3",
   "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": {
     ".": {