@axis-ds/cli 1.7.7 → 1.7.8

package/README.md

@@ -96,19 +96,21 @@ axis theme add ontology
 ## 프로젝트 검증 (`axis check`)
 
 - 전역 CSS 선택(1.7.7 부터): 전역 CSS 를 읽는 세 항목(Tailwind 4 의 Tailwind 구성 항목 · globals.css 항목 · Tailwind 4 의 animation 항목)은 같은 파일 하나를 봅니다. `axis.config.json` 의 `globalCss` 가 가리키는 파일이 있고 `.css` 이면 그 파일입니다. 모노레포의 `../shared/globals.css` 처럼 프로젝트 밖 경로도 읽기만 합니다(`axis theme add` 는 종전대로 밖 파일에 쓰지 않습니다). `globalCss` 키가 없거나 그 파일을 쓸 수 없으면 `globals.css` · `app/globals.css` · `src/app/globals.css` · `src/globals.css` · `styles/globals.css` 순으로 처음 찾은 파일이고, 쓸 수 없었던 이유를 항목 문구 끝에 붙입니다. 없는 파일 · 디렉터리면 `(globalCss ./nope.css 없음)`, `.css` 가 아닌 파일이면 `(globalCss ./package.json: .css 파일이 아님)` 입니다. brand 항목도 같은 `globalCss` 규칙과 표기를 쓰지만 후보 목록이 다릅니다(`app/globals.css` → `src/app/globals.css` → `styles/globals.css` → `src/styles/globals.css` → 루트 `globals.css`). 세 항목도 후보 이름과 같은 디렉터리(예: 루트 `globals.css/`)는 건너뜁니다(1.7.6 까지는 check 가 `EISDIR` 로 멈췄습니다). 1.7.6 까지는 세 항목이 `globalCss` 를 보지 않아, CSS 를 후보 밖(`src/styles/globals.css` 등)에 두고 `globalCss` 로 가리킨 프로젝트도 globals.css FAIL(종료 코드 1)이었고, 루트에 다른 `globals.css` 가 있으면 brand 와 다른 파일을 판정했습니다.
-- 상대 `@import` 펼침(1.7.7 부터): 고른 파일이 `@import "./axis.css";` · `@import '../styles/axis.css';` 처럼 따옴표 안 상대 경로(`./` · `../`, 공백 없는 `@import"./axis.css"` · 확장자 없는 `"./axis"` 포함)로 들여온 프로젝트 안 CSS 도 근거 줄(`@import "tailwindcss"` · 토큰 진입점 · tokens CSS import · `--axis-*` 정의 · 컴포넌트 `tailwind.css` · `@source` · `tw-animate-css` · `@plugin "tailwindcss-animate"` · 브랜드 import)을 찾을 때 함께 봅니다. 근거를 하위 파일에서 찾으면 문구 끝(`globalCss` 표기 앞)에 `(app/axis.css 의 import)` 처럼 출처를 붙이고, 하위 파일이 없으면 종전 문구 그대로입니다. 확장자 없는 이름은 적힌 이름의 파일이 먼저이고 없으면 끝에 `.css` 를 붙인 파일을 봅니다(Tailwind 4 와 같음). 하위 파일이 다시 import 한 파일도 진입 파일에서 32단계까지 따라가고, 같은 파일은 한 번만 읽습니다. 프로젝트 밖으로 나가는 경로(`../` · 밖을 가리키는 심볼릭 링크), 없는 파일 · 디렉터리, `url(...)` 형태, `layer()` · `supports()` · media 조건이 붙은 import(조건 안의 토큰 진입점은 Tailwind 4 빌드가 실패함. Tailwind 3 은 조건이 붙은 import 도 펼쳐 빌드하지만 check 는 따라가지 않아 그 파일의 줄을 근거로 보지 않습니다), `./` 없는 이름(`"axis.css"`, 패키지 경로로 풀림)은 따라가지 않습니다. 프로젝트 밖 전역 CSS 가 다시 밖 파일을 import 해도 읽지 않습니다. 상대 import 가 순환하면(a → b → a · 자기 import) 빌드가 실패하므로 globals.css 항목은 진입 파일만으로 판정한 문구 뒤에 ` / ` 로 순환 문구를 붙여 WARN 을 냅니다(예: `app/globals.css에 AXIS CSS 변수가 없습니다 / app/globals.css · app/b.css 이 서로 @import 해 빌드가 순환으로 실패합니다 → 순환하는 @import 를 없애세요`, 자기 자신을 import 하면 `app/globals.css 이 자기 자신을 @import 해 빌드가 순환으로 실패합니다 → 순환하는 @import 를 없애세요`). 진입 파일이 PASS 여도 WARN 이고, 이때는 모든 항목이 진입 파일만 보며 순환 문구는 globals.css 항목에만 붙습니다. 순환은 조건이 붙은 import 까지 넣어 Tailwind 4 의 재귀 한도와 같은 100단계까지 찾습니다(근거는 위와 같이 조건 없는 import · 32단계까지만 봄). 하위 파일의 패키지 경로 줄은 진입 파일에 같은 줄이 있을 때와 같은 해석 판정(아래 Tailwind 구성 항목 2 · 5번 · globals.css 항목)을 그 하위 파일의 디렉터리 기준(그 디렉터리의 중첩 `node_modules` 포함)으로 거치고, 브랜드 import 는 종전대로 그 판정 없이 위치만 봅니다. create-next-app 기본 정의 · `font-family: Arial` 같은 결함은 진입 파일에서만 봅니다. 1.7.6 까지는 하위 파일을 보지 않아, 근거를 하위 파일에 둔 프로젝트도 「없습니다」 WARN 이었습니다(종료 코드는 그대로).
+- 상대 `@import` 펼침(1.7.7 부터): 고른 파일이 `@import "./axis.css";` · `@import '../styles/axis.css';` 처럼 따옴표 안 상대 경로(`./` · `../`, 공백 없는 `@import"./axis.css"` · 확장자 없는 `"./axis"` 포함)로 들여온 프로젝트 안 CSS 도 근거 줄(`@import "tailwindcss"` · 토큰 진입점 · tokens CSS import · `--axis-*` 정의 · 컴포넌트 `tailwind.css` · `@source` · `tw-animate-css` · `@plugin "tailwindcss-animate"` · 브랜드 import)을 찾을 때 함께 봅니다. 근거를 하위 파일에서 찾으면 문구 끝(`globalCss` 표기 앞)에 `(app/axis.css 의 import)` 처럼 출처를 붙이고, 하위 파일이 없으면 종전 문구 그대로입니다. 확장자 없는 이름은 적힌 이름의 파일이 먼저이고 없으면 끝에 `.css` 를 붙인 파일을 봅니다(Tailwind 4 와 같음). 하위 파일이 다시 import 한 파일도 진입 파일에서 32단계까지 따라가고, 같은 파일은 한 번만 읽습니다. 프로젝트 밖으로 나가는 경로(`../` · 밖을 가리키는 심볼릭 링크), 없는 파일 · 디렉터리, `url(...)` 형태, `layer()` · `supports()` · media 조건이 붙은 import(조건 안의 토큰 진입점은 Tailwind 4 빌드가 실패함. Tailwind 3 은 조건이 붙은 import 도 펼쳐 빌드하지만 check 는 따라가지 않아 그 파일의 줄을 근거로 보지 않습니다), `./` 없는 이름(`"axis.css"`, 패키지 경로로 풀림)은 따라가지 않습니다. 프로젝트 밖 전역 CSS 가 다시 밖 파일을 import 해도 읽지 않습니다. 상대 import 가 순환하면(a → b → a · 자기 import) 빌드가 실패하므로 globals.css 항목은 진입 파일만으로 판정한 문구 뒤에 ` / ` 로 순환 문구를 붙여 WARN 을 냅니다(예: `app/globals.css에 AXIS CSS 변수가 없습니다 / app/globals.css · app/b.css 이 서로 @import 해 빌드가 순환으로 실패합니다 → 순환하는 @import 를 없애세요`, 자기 자신을 import 하면 `app/globals.css 이 자기 자신을 @import 해 빌드가 순환으로 실패합니다 → 순환하는 @import 를 없애세요`). 진입 파일이 PASS 여도 WARN 이고, 이때는 모든 항목이 진입 파일만 보며 순환 문구는 globals.css 항목에만 붙습니다. 순환은 조건이 붙은 import 까지 넣어 Tailwind 4 의 재귀 한도와 같은 100단계까지 찾습니다(근거는 위와 같이 조건 없는 import · 32단계까지만 봄). 하위 파일의 패키지 경로 줄은 진입 파일에 같은 줄이 있을 때와 같은 해석 판정(아래 Tailwind 구성 항목 2 · 5번 · globals.css 항목)을 그 하위 파일의 디렉터리 기준(그 디렉터리의 중첩 `node_modules` 포함)으로 거치고(1.7.8 부터 Tailwind 4 의 tokens CSS import · 컴포넌트 `tailwind.css` 줄은 아래 「중첩 설치본」 규칙, `@import "tailwindcss"` 줄과 Tailwind 3 은 이 규칙 그대로), 브랜드 import 는 종전대로 그 판정 없이 위치만 봅니다. create-next-app 기본 정의 · `font-family: Arial` 같은 결함은 진입 파일에서만 봅니다. 1.7.6 까지는 하위 파일을 보지 않아, 근거를 하위 파일에 둔 프로젝트도 「없습니다」 WARN 이었습니다(종료 코드는 그대로).
 - Tailwind 구성 항목: Tailwind 4 이상(설치본, 없으면 `package.json` 선언으로 판정)은 설정 파일 대신 위 전역 CSS 선택이 고른 파일 하나(상대 `@import` 로 들여온 하위 파일 포함)를 봅니다. Tailwind 3 이하는 `tailwind.config.ts` · `.js` · `.mjs` · `.cjs` 를 찾습니다.
   - Tailwind 4: `@import "tailwindcss"` 가 있는 CSS 에서 아래 문제가 하나도 없으면 PASS 이고, 하나라도 있으면 WARN 입니다(블록 주석 안은 없는 것으로 봅니다). `@import "tailwindcss"` 가 없으면 그 WARN 하나만 냅니다.
     1. 토큰 진입점 `@import "@axis-ds/tokens/css/tailwind4";` 이 없음 → 문구에 넣을 import 줄. 진입점이 없으면 `bg-primary` · `rounded-md` 같은 AXIS 매핑이 만들어지지 않습니다. `@axis-ds/tokens/css` · `css/shadcn` · `tailwind`(Tailwind 3 preset)는 진입점으로 치지 않습니다.
     2. `package.json` 에 선언된 `@axis-ds/ui-react` · `@axis-ds/agentic-ui` 의 `tailwind.css` import 가 없음 → 빠진 import 줄. 선언이 없으면(복사 설치) 요구하지 않습니다. 1.7.7 부터는 그 줄이 이 앱에서 해석될 때만 줄을 바로 안내합니다. 앱 `package.json` 선언과, 설치본에 `tailwind.css` 가 있는 워크스페이스 루트 선언은 종전대로 줄을 안내합니다. 해석되지 않는 루트 선언은 먼저 할 일을 안내합니다: Plug'n'Play 에서 루트에만 선언(→ 앱 `package.json` 에 선언한 뒤 줄), 설치본 없음(→ 설치 뒤 줄), 설치본이 1.4.0 미만이거나 버전을 읽지 못함(→ 1.4.0 이상으로 올린 뒤 줄), 1.4.0 이상인데 `tailwind.css` 가 없음(→ 다시 설치 뒤 줄). 앱 디렉터리에 lockfile 이 있으면 루트 선언을 선언으로 보지 않습니다(`axis theme add` 와 같은 판정). 1.7.6 까지는 선언만 보고 줄을 안내해, 그대로 넣으면 빌드가 `Can't resolve` 로 깨질 수 있었습니다. `tailwind.css` 대신 그 패키지를 가리키는 `@source` 를 같은 CSS 에 직접 썼으면(예: `@source "../node_modules/@axis-ds/ui-react/dist";`, 작은따옴표 · 다른 상대 경로 포함) 스캔 경로가 있는 것으로 봅니다. 경로 문자열에 `@axis-ds/<패키지>` 가 들어 있고 그 바로 뒤가 경로 끝 · `/` · `\` 이면(`@axis-ds/ui-react-extra` 같은 다른 이름은 아님) 그 패키지를 가리킨다고 판정합니다(경로가 실제로 있는지는 보지 않음). 주석 안 · `@source not` · `@source inline()` 은 인정하지 않고, brace 확장(`@source "{…/@axis-ds/ui-react,…}/dist"`) · `@import "…" source("…")` 형태도 인정하지 않습니다(WARN 쪽으로 판정).
     3. 진입점이 있는데 create-next-app 기본 정의가 남음 → 실제로 남은 정의 이름(예: `--font-sans` 만 남았으면 `@theme --font-sans: var(--font-geist-sans)` 만 표시). `--background` · `--foreground` 를 색값(`#ffffff` · `rgb()` · `oklch()` 등)으로 정의, `--color-background: var(--background)` 류, `--font-sans` · `--font-mono: var(--font-geist-*)`, `background` · `color: var(--background)` 류 직접 사용을 봅니다(create-next-app 15.5.28 기본 `globals.css` 실물 기준). AXIS 의 HSL 삼중값(`0 0% 100%`) 재정의나 `hsl(var(--background))` 는 걸리지 않습니다. 표시 앞머리(`:root 색값` · `@theme` · `body`)는 create-next-app 기본 블록 이름이라, 같은 선언이 다른 선택자에 있어도 그 이름으로 표시됩니다.
     4. 진입점이 있는데 `@axis-ds/tokens` 가 아래 버전 조건에 걸림.
-    5. `@axis-ds/ui-react/tailwind.css` · `@axis-ds/agentic-ui/tailwind.css` 를 import 하는데 그 패키지가 아래 버전 조건에 걸림(`tailwind.css` 는 1.4.0 부터 있음). 직접 `@source` 로 스캔하는 패키지는 `tailwind.css` 가 필요 없으므로 이 문제를 만들지 않습니다. 1.7.7 부터는 줄이 이미 있어도 2번의 해석되지 않는 루트 선언(Plug'n'Play 루트 전용 · 설치본 없음 · 설치본에 `tailwind.css` 없음 · 버전을 읽지 못함)이면 버전 조건 대신 「`<패키지>/tailwind.css` import 가 있지만 … 해석되지 않습니다」 WARN 입니다(1.4.0 미만 설치본은 종전 버전 조건 문구, 1.7.6 까지는 버전 조건만 봐서 PASS 일 수 있었음).
+    5. `@axis-ds/ui-react/tailwind.css` · `@axis-ds/agentic-ui/tailwind.css` 를 import 하는데 그 패키지가 아래 버전 조건에 걸림(`tailwind.css` 는 1.4.0 부터 있음). 직접 `@source` 로 스캔하는 패키지는 `tailwind.css` 가 필요 없으므로 이 문제를 만들지 않습니다. 1.7.7 부터는 줄이 이미 있어도 2번의 해석되지 않는 루트 선언(Plug'n'Play 루트 전용 · 설치본 없음 · 설치본에 `tailwind.css` 없음 · 버전을 읽지 못함)이면 버전 조건 대신 「`<패키지>/tailwind.css` import 가 있지만 … 해석되지 않습니다」 WARN 입니다(1.4.0 미만 설치본은 종전 버전 조건 문구, 1.7.6 까지는 버전 조건만 봐서 PASS 일 수 있었음). 1.7.8 부터는 아래 중첩 설치본 판정도 이 자리에 나옵니다.
   - 프로젝트 밖 전역 CSS(1.7.7 부터): 고른 파일이 앱 밖(`globalCss` 가 `../shared/globals.css` 등)이면 그 파일의 `@import "tailwindcss"` 와 컴포넌트 `tailwind.css` 줄을 그 파일 위치 기준으로도 봅니다. 빌드 도구가 패키지 경로를 그 CSS 파일 위치부터 상위 `node_modules` 로 풀기 때문입니다(설치본이 앱 아래에만 있으면 빌드가 `Can't resolve` 로 실패, 공통 상위로 호이스팅하면 성공). 앱에서는 설치본을 찾는데 그 파일 위치에서는 찾지 못하면 「import 가 있지만 이 파일 위치에서 <패키지> 를 찾지 못해 해석되지 않습니다」 WARN 입니다(`tailwindcss` 줄은 문제 목록 맨 앞, 컴포넌트 줄은 5번 자리). 토큰 진입점 줄은 globals.css 항목이 같은 기준으로 알립니다. Plug'n'Play 이거나 앱 위치에서 설치본을 찾지 못하면 이 판정을 하지 않습니다.
+  - 중첩 설치본(그림자, 1.7.8 부터): 앱 안 CSS(진입 파일 · 상대 `@import` 로 들여온 하위 파일)의 tokens CSS import 줄(`@axis-ds/tokens/css` · `css/shadcn` · `css/tailwind4`, globals.css 항목)과 컴포넌트 `tailwind.css` 줄(위 5번 자리)은 그 줄이 있는 파일 위치부터 Tailwind 4 빌드 도구와 같은 순서로 풉니다. 위로 올라가며 `node_modules/<패키지>` 를 찾고, 먼저 잡힌 설치본에 `exports` 가 있으면 그 `exports`(조건 `style` · `default`)로만 풉니다. 그 설치본이 앱 기준 설치본과 실경로가 다르고(예: `app/node_modules` 에 남은 1.3.0) subpath 를 내보내지 않거나 내보낸 파일이 없으면 빌드가 실패하므로 「import 가 있지만 그 줄이 있는 파일 위치에서 먼저 잡히는 app/node_modules/@axis-ds/ui-react(1.3.0)가 ./tailwind.css 를 내보내지 않아 해석되지 않습니다 → 그 중첩 node_modules 의 @axis-ds/ui-react 를 지우거나 1.4.0 이상으로 맞추세요」 같은 WARN 입니다(이미 1.4.0 이상이면 「다시 설치하세요」). `exports` 도 그 파일도 없는 중첩 디렉터리는 빌드 도구처럼 건너뛰고 상위 설치본으로 봅니다. 앱과 워크스페이스 루트에 설치본이 없고, 그 줄이 있는 파일 위치에서는 풀리지 않는데 같은 전역 CSS 의 다른 파일 위치에서만 풀리면 「설치본이 <경로> 에만 있음」 WARN 입니다. 그림자 파일의 내용은 보지 않고, 프로젝트 밖 전역 CSS · `@import "tailwindcss"` 줄 · Tailwind 3 은 종전대로입니다. 1.7.7 까지는 앱 안 진입 파일의 줄은 앱 기준으로만, 하위 파일의 줄은 처음 만난 설치본(tokens 는 디렉터리, 컴포넌트는 `tailwind.css` 파일)만 봐서 빌드가 실패하는 그림자도 PASS 일 수 있었습니다.
   - 문제가 여럿이면 위 순서대로 ` / ` 로 이어 한 항목에 냅니다. 끝에는 `package.json` 에 선언된 세 AXIS 패키지 가운데 1.4.0 미만인 것을 `(1.4.0 이상 필요: @axis-ds/tokens ^1.3.0)`, 판정할 수 없는 것을 `(설치된 버전이 1.4.0 이상인지 확인하세요: @axis-ds/agentic-ui catalog:)` 로 한 번 덧붙입니다. 버전은 `axis init` 과 같은 함수로 판정합니다: 설치본(`node_modules/<패키지>/package.json` 의 정확한 `version`)이 있으면 그것으로 보고(`(1.4.0 이상 필요: @axis-ds/ui-react 설치본 1.3.0)`, 1.4.0 이상이면 선언과 관계없이 넣지 않음), 없으면 선언 범위의 하한, 하한도 읽을 수 없으면(`catalog:` · `latest` · `||` 등) 판정 불가입니다. `workspace:` 는 넣지 않습니다.
   - 문구 예: `Tailwind 4: globals.css에 AXIS 토큰 진입점이 없습니다 → @import "@axis-ds/tokens/css/tailwind4"; / 컴포넌트 스캔 경로(tailwind.css)가 없습니다 → @import "@axis-ds/ui-react/tailwind.css"; (1.4.0 이상 필요: @axis-ds/tokens ^1.3.0 · @axis-ds/ui-react ^1.3.0)`
-  - Tailwind 3: 설정 파일(`.ts` · `.js` · `.mjs` · `.cjs`)이 `@axis-ds/tokens/tailwind` preset 을 `require` · `import` 하면(주석 밖) `tailwind.config.ts에 AXIS 토큰이 설정되어 있습니다 (@axis-ds/tokens/tailwind preset)` 처럼 PASS 이고, 없으면 WARN 입니다(1.6.0 부터. 이전에는 `--background` · `hsl(var(` 문자열만 있어도 PASS 여서 AXIS 참조가 없는 자체 매핑도 통과했습니다).
-  - Tailwind 3 CommonJS(1.6.1 부터): 설정이 `.cjs` 이거나 `module.exports` 를 쓰고 `.default` 없는 `require("@axis-ds/tokens/tailwind")` 가 있으면, 설치본(없으면 선언 하한) `@axis-ds/tokens` 가 1.7.0 미만일 때 WARN 입니다. 1.6.2 이하의 이 형태는 preset 이 아니라 `{ default }` 를 받아 색 · keyframes 가 빠집니다(1.1.0 부터). `.ts` · `.mjs` 의 `export default` 안 `require` 와 `import` 형태는 Tailwind 가 `.default` 를 꺼내 줘서 PASS 입니다.
+  - Tailwind 3: 설정 파일(`.ts` · `.js` · `.mjs` · `.cjs`)이 `@axis-ds/tokens/tailwind` preset 을 `require` · `import` 하면(주석 밖) `tailwind.config.ts에 AXIS 토큰이 설정되어 있습니다 (@axis-ds/tokens/tailwind preset)` 처럼 PASS 이고(1.7.8 부터는 아래 tokens 해석 조건도 맞아야 함), 없으면 WARN 입니다(1.6.0 부터. 이전에는 `--background` · `hsl(var(` 문자열만 있어도 PASS 여서 AXIS 참조가 없는 자체 매핑도 통과했습니다).
+  - Tailwind 3 CommonJS(1.6.1 부터): 설정이 `.cjs` 이거나 `module.exports` 를 쓰고 `.default` 없는 `require("@axis-ds/tokens/tailwind")` 가 있으면, 설치본(없으면 선언 하한. 1.7.8 부터 선언 하한으로 가는 것은 아래 tokens 해석 조건을 통과한 경우뿐) `@axis-ds/tokens` 가 1.7.0 미만일 때 WARN 입니다. 1.6.2 이하의 이 형태는 preset 이 아니라 `{ default }` 를 받아 색 · keyframes 가 빠집니다(1.1.0 부터). `.ts` · `.mjs` 의 `export default` 안 `require` 와 `import` 형태는 Tailwind 가 `.default` 를 꺼내 줘서 이 버전 판정을 하지 않습니다.
+  - Tailwind 3 preset 의 tokens 해석(1.7.8 부터): 위 두 판정 앞에서, preset 을 어떤 모양(`require` · `.default` · `import` · `.ts`)으로 받든 `@axis-ds/tokens` 가 이 앱에서 해석되는지 봅니다. globals.css 항목과 같은 기준이라, 앱 `package.json` 에 선언했으면 설치 여부와 상관없이 종전 판정(미설치는 dependencies 항목이 알림)이고, 선언이 없거나 워크스페이스 루트에만 선언했으면 설치본 디렉터리가 있을 때만 종전 판정입니다. 설치본이 없으면 「tailwind.config.mjs에 AXIS preset 참조가 있지만 @axis-ds/tokens 가 설치되지 않아 해석되지 않습니다 → 설치(…)」, Plug'n'Play 에서 루트에만 선언했으면 「… 워크스페이스 루트에만 선언돼 Plug'n'Play 에서 앱이 해석하지 못합니다(워크스페이스 루트 선언 …) → 앱 package.json 에 @axis-ds/tokens 를 선언하세요」 WARN 입니다(CommonJS bare require 는 바로 위 단락의 종전 문구 「… 1.7.0 이상을 선언하세요」). 1.7.7 까지는 PASS 였고, CommonJS bare require 는 이미 WARN 이었던 경우(미선언 · 미설치, 루트 1.7.0 미만 선언 · 미설치)에 문구만 바뀝니다. 종료 코드는 그대로입니다. 이 레이아웃은 Tailwind 빌드가 `Cannot find module '@axis-ds/tokens/tailwind'` 로 실패합니다. 1.7.0 버전 판정은 종전대로 CommonJS bare require 만 봅니다.
 - globals.css 항목: 위 전역 CSS 선택이 고른 CSS 하나(상대 `@import` 로 들여온 하위 파일 포함, Arial 은 진입 파일만)를 봅니다(Tailwind 3 이하도 같음). 고를 파일이 하나도 없으면 FAIL 입니다. 1.6.1 부터 AXIS 근거가 있을 때만 PASS 입니다: `@axis-ds/tokens/css` · `@axis-ds/tokens/css/shadcn` · `@axis-ds/tokens/css/tailwind4` import(블록 주석 밖, 작은따옴표 · `url()` · `layer()` 표기 포함, 문구 끝에 `(@axis-ds/tokens/css/tailwind4 import)` 처럼 경로), `--axis-*` 변수 정의, 또는 루트 레이아웃(`app/layout.tsx` 등)의 `import "@axis-ds/tokens/css"`. 1.7.7 부터 tokens import(CSS · 루트 레이아웃 JS)는 이 앱에서 해석될 때만 근거로 칩니다. 앱 `package.json` 에 `@axis-ds/tokens` 를 선언했으면 설치 여부와 상관없이 종전대로 PASS 이고(미설치는 dependencies 항목이 알림), 선언이 없거나 워크스페이스 루트에만 선언했으면 설치본 디렉터리(`node_modules/@axis-ds/tokens`, 상위 디렉터리 포함)가 있을 때 PASS 입니다. 설치본이 없으면 「<경로> import 가 있지만 @axis-ds/tokens 가 설치되지 않아 해석되지 않습니다 → 설치(…)」, Plug'n'Play 에서 루트에만 선언했으면 「… 워크스페이스 루트에만 선언돼 Plug'n'Play 에서 앱이 해석하지 못합니다 → 앱 package.json 에 선언하세요」 WARN 입니다(1.7.6 까지는 PASS, 종료 코드는 그대로). 고른 파일이 프로젝트 밖이면 Tailwind 구성 항목과 같이 그 파일 위치에서 설치본이 보이는지도 봅니다. `--axis-*` 변수 정의는 이 판정을 거치지 않습니다. 단, 해석되지 않는 tokens import 가 함께 있으면 import 판정을 따라 WARN 입니다. 자체 `--background` · `--primary` 만 있으면 「자체 CSS 변수만 있고 AXIS 토큰이 없습니다」 WARN 입니다(1.6.0 까지는 PASS). Tailwind 3 에서 create-next-app 기본 `body` 의 `font-family: Arial` 이 남아 있으면 PASS 조건을 채워도 WARN 입니다(Tailwind 4 는 tailwind.config 항목의 create-next-app 기본 정의로 냅니다).
 - dependencies 항목(1.6.1 부터): `tailwindcss` 선언이 없으면 FAIL, `clsx` · `tailwind-merge` 선언이 없으면 WARN(종전과 같음). 여기에 선언된 `tailwindcss` · `clsx` · `tailwind-merge` · `@axis-ds/*` 가 `node_modules` 에 없으면 「선언됐지만 설치되지 않은 의존성」 WARN 과 lockfile 에 맞는 설치 명령을 냅니다. 상위 디렉터리의 `node_modules`(모노레포 호이스팅)도 찾고, Plug'n'Play(`.pnp.cjs`)는 설치본을 읽지 않고 선언 기준입니다. 1.6.0 까지는 선언만 보고 「모두 설치되어 있습니다」였습니다.
   - 1.7.6 부터 워크스페이스 루트 `package.json` 에 선언한 `@axis-ds/*`(앱에 없는 것)도 설치 확인 대상이고, 설치되지 않았으면 「워크스페이스 루트에 선언돼 있지만 설치되지 않았습니다」 WARN 입니다(종료 코드는 그대로, 1.7.5 까지는 앱 선언만 봐서 PASS).

package/dist/{chunk-EBFXCLSV.js → chunk-C2T7NVDG.js}

@@ -362,6 +362,122 @@ function outsideCssPackageResolution(baseDir, cssDir, name, file) {
   if (!usable(findInstalledPackage(baseDir, name))) return "unknown";
   return usable(findInstalledPackage(cssDir, name)) ? "resolved" : "unresolved";
 }
+var CSS_EXPORT_CONDITIONS = /* @__PURE__ */ new Set(["style", "default"]);
+function splitPackageSpec(spec) {
+  const parts = spec.split("/");
+  const n = spec.startsWith("@") ? 2 : 1;
+  if (parts.length < n || parts.slice(0, n).some((p) => p === "" || p === "." || p === "..")) return void 0;
+  return { name: parts.slice(0, n).join("/"), rest: parts.slice(n).join("/") };
+}
+function resolveExportTarget(value) {
+  if (typeof value === "string") return value;
+  if (Array.isArray(value)) {
+    for (const v of value) {
+      const r = resolveExportTarget(v);
+      if (r !== void 0) return r;
+    }
+    return void 0;
+  }
+  if (isPlainObject(value)) {
+    for (const [key, v] of Object.entries(value)) {
+      if (!CSS_EXPORT_CONDITIONS.has(key)) continue;
+      if (v === null) return void 0;
+      const r = resolveExportTarget(v);
+      if (r !== void 0) return r;
+    }
+  }
+  return void 0;
+}
+function cssFileCandidates(p) {
+  return [p, `${p}.css`, path.join(p, "index.css")];
+}
+function exportsTarget(exportsField, subpath) {
+  const map = isPlainObject(exportsField) && Object.keys(exportsField).some((k) => k.startsWith(".")) ? exportsField : { ".": exportsField };
+  if (Object.prototype.hasOwnProperty.call(map, subpath)) {
+    const t = resolveExportTarget(map[subpath]);
+    if (t === void 0) return void 0;
+    return t.includes("*") || !t.startsWith("./") ? "?" : t;
+  }
+  if (Object.keys(map).some((k) => k.includes("*") || k.endsWith("/") && subpath.startsWith(k))) return "?";
+  return void 0;
+}
+function resolveCssPackageImport(fromDir, spec) {
+  const parsed = splitPackageSpec(spec);
+  if (parsed === void 0 || parsed.rest === "") return { kind: "unknown" };
+  const subpath = `./${parsed.rest}`;
+  let dir = resolveBaseDir(fromDir);
+  for (; ; ) {
+    const pkgDir = path.join(dir, "node_modules", ...parsed.name.split("/"));
+    if (isDirectory(pkgDir)) {
+      let manifest;
+      try {
+        const raw = JSON.parse(readFileSync(path.join(pkgDir, "package.json"), "utf8"));
+        manifest = isPlainObject(raw) ? raw : void 0;
+      } catch {
+        manifest = void 0;
+      }
+      if (manifest !== void 0 && manifest.exports) {
+        const version = exactVersionOf(manifest.version);
+        const target = exportsTarget(manifest.exports, subpath);
+        if (target === "?") return { kind: "unknown" };
+        if (target === void 0) {
+          return version !== void 0 ? { kind: "not-exported", pkgDir, subpath, version } : { kind: "not-exported", pkgDir, subpath };
+        }
+        const file = cssFileCandidates(path.join(pkgDir, target)).find(isFile);
+        if (file !== void 0) return { kind: "resolved", pkgDir, file };
+        return version !== void 0 ? { kind: "target-missing", pkgDir, subpath, target, version } : { kind: "target-missing", pkgDir, subpath, target };
+      }
+      const bare = cssFileCandidates(path.join(pkgDir, parsed.rest)).find(isFile);
+      if (bare !== void 0) return { kind: "resolved", pkgDir, file: bare };
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) return { kind: "not-found" };
+    dir = parent;
+  }
+}
+function installBase(pkgDir, name) {
+  let base = pkgDir;
+  for (let i = 0; i < name.split("/").length + 1; i++) base = path.dirname(base);
+  try {
+    return realpathSync(base);
+  } catch {
+    return path.resolve(base);
+  }
+}
+function isAncestorInstall(hit, app, name) {
+  const h = installBase(hit, name);
+  const a = installBase(app, name);
+  return a !== h && a.startsWith(h.endsWith(path.sep) ? h : h + path.sep);
+}
+function sameRealDir(a, b) {
+  const real = (p) => {
+    try {
+      return realpathSync(p);
+    } catch {
+      return path.resolve(p);
+    }
+  };
+  return real(a) === real(b);
+}
+function cssPackageLineResolution(baseDir, lineDir, spec, otherDirs = []) {
+  if (isPnpProject(baseDir)) return { kind: "ok" };
+  const parsed = splitPackageSpec(spec);
+  if (parsed === void 0) return { kind: "ok" };
+  const r = resolveCssPackageImport(lineDir, spec);
+  if (r.kind === "resolved" || r.kind === "unknown") return { kind: "ok" };
+  const app = findInstalledPackage(baseDir, parsed.name);
+  if (r.kind === "not-exported" || r.kind === "target-missing") {
+    if (app !== void 0 && sameRealDir(app.dir, r.pkgDir)) return { kind: "ok" };
+    if (app !== void 0 && isAncestorInstall(r.pkgDir, app.dir, parsed.name)) return { kind: "ok" };
+    return r.kind === "not-exported" ? { ...r, kind: "shadow-not-exported" } : { ...r, kind: "shadow-target-missing" };
+  }
+  if (app !== void 0) return { kind: "ok" };
+  for (const other of typeof otherDirs === "function" ? otherDirs() : otherDirs) {
+    const o = resolveCssPackageImport(other, spec);
+    if (o.kind === "resolved") return { kind: "not-visible", pkgDir: o.pkgDir, fromDir: resolveBaseDir(other) };
+  }
+  return { kind: "ok" };
+}
 function deferredComponentImportReason(d, installCommand) {
   const line = `@import "${d.name}/tailwind.css";`;
   const current = d.installedVersion !== void 0 && d.installedVersion !== "?" && (compareExactVersions(d.installedVersion, COMPONENT_TAILWIND_CSS_MIN_VERSION) ?? -1) >= 0;
@@ -710,6 +826,7 @@ export {
   componentCssResolvable,
   tokensCssResolution,
   outsideCssPackageResolution,
+  cssPackageLineResolution,
   deferredComponentImportReason,
   findPnpUnpluggedPackages,
   compareExactVersions,

package/dist/index.js

@@ -11,6 +11,7 @@ import {
   componentCssResolution,
   componentCssResolvable,
   cssImportViaNote,
+  cssPackageLineResolution,
   declaredDependency,
   deferredComponentImportReason,
   dependencyInstallGuide,
@@ -33,7 +34,7 @@ import {
   tokensCssResolution,
   workspaceRootPackage,
   workspaceRunCommand
-} from "./chunk-EBFXCLSV.js";
+} from "./chunk-C2T7NVDG.js";
 import {
   V0Client
 } from "./chunk-2PNCUPCG.js";
@@ -2248,12 +2249,12 @@ function outsideCssDir(selection) {
 function outsideCssUnresolvedIssue(spec, name) {
   return `${spec} import \uAC00 \uC788\uC9C0\uB9CC \uC774 \uD30C\uC77C \uC704\uCE58\uC5D0\uC11C ${name} \uB97C \uCC3E\uC9C0 \uBABB\uD574 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uC124\uCE58\uBCF8\uC774 \uC571 \uCABD node_modules \uC5D0\uB9CC \uC788\uC74C) \u2192 \uC774 \uD30C\uC77C\uC758 \uC0C1\uC704 node_modules(\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8 \uB4F1)\uC5D0 \uC124\uCE58\uD558\uAC70\uB098 globalCss \uB97C \uC571 \uC548 \uD30C\uC77C\uB85C \uBC14\uAFB8\uC138\uC694`;
 }
-function tokensInstallPhrase(baseDir) {
-  const g = dependencyInstallGuide(baseDir, TOKENS_PACKAGE_NAME, `^${TAILWIND4_MIN_AXIS_VERSION}`);
+function tokensInstallPhrase(baseDir, range = `^${TAILWIND4_MIN_AXIS_VERSION}`) {
+  const g = dependencyInstallGuide(baseDir, TOKENS_PACKAGE_NAME, range);
   if (g.kind === "install-at-root") return `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uC11C ${g.installCommand}`;
   return g.kind === "install" ? g.installCommand : g.addCommand;
 }
-function tokensCssUnresolvedIssue(baseDir, pkg, spec, cssDir) {
+function tokensCssUnresolvedIssue(baseDir, pkg, spec, cssDir, lineIssue) {
   const r = tokensCssResolution(baseDir, pkg, TOKENS_PACKAGE_NAME);
   const head = `${spec} import \uAC00 \uC788\uC9C0\uB9CC`;
   if (r.kind === "pnp-root-only") return `${head} ${TOKENS_PACKAGE_NAME} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694`;
@@ -2263,7 +2264,41 @@ function tokensCssUnresolvedIssue(baseDir, pkg, spec, cssDir) {
   if (cssDir !== void 0 && outsideCssPackageResolution(baseDir, cssDir, TOKENS_PACKAGE_NAME) === "unresolved") {
     return outsideCssUnresolvedIssue(spec, TOKENS_PACKAGE_NAME);
   }
-  return void 0;
+  return lineIssue?.();
+}
+function packageNameOfSpec(spec) {
+  const parts = spec.split("/");
+  return parts.slice(0, spec.startsWith("@") ? 2 : 1).join("/");
+}
+function displayRel(baseDir, p) {
+  return relative(baseDir, p).split(sep).join("/");
+}
+function packageLineShadowIssue(baseDir, expanded, origin, spec) {
+  const name = packageNameOfSpec(spec);
+  const lineDir = dirname(origin.path);
+  const others = () => [...new Set(expanded.files.map((f) => dirname(f.path)))].filter((d) => d !== lineDir);
+  const r = cssPackageLineResolution(baseDir, lineDir, spec, others);
+  const head = `${spec} import \uAC00 \uC788\uC9C0\uB9CC \uADF8 \uC904\uC774 \uC788\uB294 \uD30C\uC77C \uC704\uCE58\uC5D0\uC11C`;
+  const label = (pkgDir, version) => `${displayRel(baseDir, pkgDir)}(${version ?? "\uBC84\uC804 \uBAA8\uB984"})`;
+  switch (r.kind) {
+    case "ok":
+      return void 0;
+    case "shadow-not-exported": {
+      const current = r.version !== void 0 && (compareExactVersions(r.version, TAILWIND4_MIN_AXIS_VERSION) ?? -1) >= 0;
+      const todo = current ? "\uB2E4\uC2DC \uC124\uCE58\uD558\uC138\uC694" : `${TAILWIND4_MIN_AXIS_VERSION} \uC774\uC0C1\uC73C\uB85C \uB9DE\uCD94\uC138\uC694`;
+      return `${head} \uBA3C\uC800 \uC7A1\uD788\uB294 ${label(r.pkgDir, r.version)}\uAC00 ${r.subpath} \uB97C \uB0B4\uBCF4\uB0B4\uC9C0 \uC54A\uC544 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uADF8 \uC911\uCCA9 node_modules \uC758 ${name} \uB97C \uC9C0\uC6B0\uAC70\uB098 ${todo}`;
+    }
+    case "shadow-target-missing":
+      return `${head} \uBA3C\uC800 \uC7A1\uD788\uB294 ${label(r.pkgDir, r.version)}\uC5D0 \uB0B4\uBCF4\uB0B8 \uD30C\uC77C(${r.target})\uC774 \uC5C6\uC5B4 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uADF8 \uC911\uCCA9 node_modules \uC758 ${name} \uB97C \uC9C0\uC6B0\uAC70\uB098 \uB2E4\uC2DC \uC124\uCE58\uD558\uC138\uC694`;
+    case "not-visible": {
+      const there = expanded.files.find((f) => dirname(f.path) === r.fromDir);
+      const move = there !== void 0 ? `\uC774 \uC904(${origin.rel})\uC744 ${there.rel} \uB85C \uC62E\uAE30\uC138\uC694` : `\uC774 \uC904(${origin.rel})\uC744 \uADF8 \uC704\uCE58\uC758 CSS \uD30C\uC77C\uB85C \uC62E\uAE30\uC138\uC694`;
+      return `${head} ${name} \uB97C \uCC3E\uC9C0 \uBABB\uD574 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uC124\uCE58\uBCF8\uC774 ${displayRel(baseDir, r.pkgDir)} \uC5D0\uB9CC \uC788\uC74C) \u2192 \uC571 \uB610\uB294 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC124\uCE58\uD558\uAC70\uB098 ${move}`;
+    }
+  }
+}
+function isOutsideEntry(origin) {
+  return origin.depth === 0 && origin.cssDir !== void 0;
 }
 function checkGlobalsCss(baseDirInput) {
   const baseDir = resolveBaseDir(baseDirInput);
@@ -2291,7 +2326,14 @@ function judgeGlobalsCss(baseDir, selection, candidate, expanded) {
   if (imported !== void 0) {
     const origin = evidenceOrigin(expanded, (f) => findTokensCssImport(f) === imported);
     via = cssImportViaNote(viaFiles([origin]));
-    const issue = tokensCssUnresolvedIssue(baseDir, pkg, imported, origin !== void 0 ? origin.cssDir : outsideCssDir(selection));
+    const tailwind4 = (detectTailwind(baseDir, pkg).major ?? 0) >= 4;
+    const issue = tailwind4 && origin !== void 0 && !isOutsideEntry(origin) ? tokensCssUnresolvedIssue(
+      baseDir,
+      pkg,
+      imported,
+      void 0,
+      () => packageLineShadowIssue(baseDir, expanded, origin, imported)
+    ) : tokensCssUnresolvedIssue(baseDir, pkg, imported, origin !== void 0 ? origin.cssDir : outsideCssDir(selection));
     if (issue !== void 0) unresolved = `${candidate}\uC5D0 ${issue}`;
     else pass = `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (${imported} import)`;
   } else if (AXIS_VARIABLE_DEFINITION.test(stripCssComments(expanded.evidence))) {
@@ -2522,6 +2564,17 @@ function hasBareCjsPresetRequire(code) {
 function isCommonJsConfig(file, source) {
   return extname(file) === ".cjs" || /\bmodule\.exports\b/.test(source);
 }
+function presetTokensUnresolvedMessage(baseDir, pkg, file, bareCjs) {
+  const r = tokensCssResolution(baseDir, pkg, TOKENS_PACKAGE_NAME);
+  const head = `${file}\uC5D0 AXIS preset \uCC38\uC870\uAC00 \uC788\uC9C0\uB9CC ${TOKENS_PACKAGE_NAME} \uAC00`;
+  if (r.kind === "not-installed") {
+    return `${head} \uC124\uCE58\uB418\uC9C0 \uC54A\uC544 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uC124\uCE58(${tokensInstallPhrase(baseDir, `^${TOKENS_CJS_PRESET_FIXED_VERSION}`)})`;
+  }
+  if (r.kind === "pnp-root-only" && !bareCjs) {
+    return `${head} ${PNP_ROOT_ONLY_NOTE}(\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8 \uC120\uC5B8 ${r.range}) \u2192 \uC571 package.json \uC5D0 ${TOKENS_PACKAGE_NAME} \uB97C \uC120\uC5B8\uD558\uC138\uC694`;
+  }
+  return void 0;
+}
 function packageVersionGate(baseDirInput, pkg, name, min, options = {}) {
   const baseDir = resolveBaseDir(baseDirInput);
   if (!isPnpProject(baseDir)) {
@@ -2591,11 +2644,22 @@ function tailwind4Issues(input, pkg, versions, baseDir) {
   for (const name of TAILWIND4_COMPONENT_PACKAGES) {
     if (!hasComponentTailwindImport(evidence, name)) continue;
     const unresolved = componentCssPresentIssue(baseDir, name, resolutions.get(name));
-    const componentDir = cssDirOf(`${name}/tailwind.css`);
-    if (unresolved !== void 0) issues.push(unresolved);
-    else if (componentDir !== void 0 && outsideCssPackageResolution(baseDir, componentDir, name, "tailwind.css") === "unresolved") {
-      issues.push(outsideCssUnresolvedIssue(`${name}/tailwind.css`, name));
-    } else if (versions.some((v) => v.name === name)) issues.push(`${name}/tailwind.css import \uAC00 \uC788\uC9C0\uB9CC ${name} \uBC84\uC804 \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4`);
+    const spec = `${name}/tailwind.css`;
+    if (unresolved !== void 0) {
+      issues.push(unresolved);
+      continue;
+    }
+    const shadow = input.lineIssue === void 0 ? false : input.lineIssue(spec);
+    let lineProblem;
+    if (shadow !== false) lineProblem = shadow;
+    else {
+      const componentDir = cssDirOf(spec);
+      if (componentDir !== void 0 && outsideCssPackageResolution(baseDir, componentDir, name, "tailwind.css") === "unresolved") {
+        lineProblem = outsideCssUnresolvedIssue(spec, name);
+      }
+    }
+    if (lineProblem !== void 0) issues.push(lineProblem);
+    else if (versions.some((v) => v.name === name)) issues.push(`${name}/tailwind.css import \uAC00 \uC788\uC9C0\uB9CC ${name} \uBC84\uC804 \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4`);
   }
   return issues;
 }
@@ -2663,7 +2727,17 @@ function checkTailwindSetup(baseDirInput) {
       );
       const versions = axisPackagesBelowTailwind4(pkg, baseDir);
       const issues = tailwind4Issues(
-        { entry: expanded.entry, evidence: expanded.evidence, cssDirOf: (spec) => packageLineCssDir(expanded, spec) },
+        {
+          entry: expanded.entry,
+          evidence: expanded.evidence,
+          cssDirOf: (spec) => packageLineCssDir(expanded, spec),
+          lineIssue: (spec) => {
+            const line = expanded.packageLines.find((l) => l.spec === spec);
+            const origin = line !== void 0 ? expanded.files.find((f) => f.rel === line.file) : void 0;
+            if (origin === void 0 || isOutsideEntry(origin)) return false;
+            return packageLineShadowIssue(baseDir, expanded, origin, spec);
+          }
+        },
         pkg,
         versions,
         baseDir
@@ -2693,7 +2767,10 @@ function checkTailwindSetup(baseDirInput) {
     const content = readFileSync(path17, "utf8");
     if (hasTokensPresetReference(content)) {
       const code = stripJsComments(content);
-      if (isCommonJsConfig(file, code) && hasBareCjsPresetRequire(code)) {
+      const bareCjs = isCommonJsConfig(file, code) && hasBareCjsPresetRequire(code);
+      const unresolved = presetTokensUnresolvedMessage(baseDir, pkg, file, bareCjs);
+      if (unresolved !== void 0) return { name: "tailwind.config", severity: "warn", message: unresolved };
+      if (bareCjs) {
         const gate = packageVersionGate(baseDir, pkg, "@axis-ds/tokens", TOKENS_CJS_PRESET_FIXED_VERSION, { appOnlyInPnp: true });
         if (gate.status === "unresolved") {
           return {
@@ -3580,9 +3657,11 @@ import path10 from "path";
 import chalk7 from "chalk";
 
 // src/theme/brand-core.ts
+import { createHash } from "crypto";
 import { existsSync as existsSync2, readFileSync as readFileSync2, statSync as statSync2 } from "fs";
 import { createRequire } from "module";
 import { dirname as dirname2, join as join2, relative as relative2, resolve as resolve2, sep as sep2 } from "path";
+import { MessageChannel, Worker, receiveMessageOnPort } from "worker_threads";
 var TOKENS_PACKAGE = "@axis-ds/tokens";
 var BRAND_NAME_PATTERN = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 var MIN_BRAND_TOKENS_VERSION = "1.3.0";
@@ -3608,13 +3687,15 @@ function readJsonFile(file) {
 function errorCode(err) {
   return typeof err === "object" && err !== null && "code" in err ? String(err.code) : void 0;
 }
-function findTokensPackageJson(baseDir) {
+function tokensPackageJsonCandidates(baseDir) {
+  const candidates = [];
   let dir = resolve2(baseDir);
   for (; ; ) {
     const candidate = join2(dir, "node_modules", TOKENS_PACKAGE, "package.json");
-    if (existsSync2(candidate)) return candidate;
+    candidates.push(candidate);
+    if (existsSync2(candidate)) return { found: candidate, candidates };
     const parent = dirname2(dir);
-    if (parent === dir) return void 0;
+    if (parent === dir) return { candidates };
     dir = parent;
   }
 }
@@ -3624,21 +3705,203 @@ function projectRequire(baseDir) {
 function tokensSpecifier(subpath) {
   return `${TOKENS_PACKAGE}/${subpath.replace(/^\.\//, "")}`;
 }
-function resolveTokens(baseDir) {
-  const pkgJson = findTokensPackageJson(baseDir);
-  if (!pkgJson) return { status: "not-installed" };
-  const pkg = readJsonFile(pkgJson);
-  const version = typeof pkg.version === "string" ? pkg.version : void 0;
+var nodeSeenStates = /* @__PURE__ */ new Map();
+var ABSENT = "absent";
+var UNKNOWN = "unknown";
+var isolationDisabled = false;
+var isolatedStats = { workers: 0, resolves: 0, fallbacks: 0 };
+var ISOLATED_RESOLVE_TIMEOUT_MS = 5e3;
+var ISOLATED_RESOLVE_SOURCE = `
+const { workerData } = require("node:worker_threads");
+const { createRequire } = require("node:module");
+const { port, signal, from } = workerData;
+const req = createRequire(from);
+port.on("message", (spec) => {
+  let reply;
   try {
-    const indexPath = projectRequire(baseDir).resolve(tokensSpecifier("./brands"));
-    return { status: "ok", version, indexPath };
+    reply = { path: req.resolve(spec) };
+  } catch (err) {
+    const code = err && typeof err === "object" && "code" in err ? String(err.code) : undefined;
+    reply = { code, message: err && err.message ? String(err.message) : String(err) };
+  }
+  port.postMessage(reply);
+  Atomics.store(signal, 0, 1);
+  Atomics.notify(signal, 0);
+});
+`;
+var IsolationFailure = class extends Error {
+};
+function createWorkerResolveSession(from, source, timeoutMs) {
+  const { port1, port2 } = new MessageChannel();
+  const signal = new Int32Array(new SharedArrayBuffer(4));
+  const worker = new Worker(source, {
+    eval: true,
+    workerData: { port: port2, signal, from },
+    transferList: [port2]
+  });
+  worker.on("error", () => {
+  });
+  worker.unref();
+  return {
+    resolve(spec) {
+      Atomics.store(signal, 0, 0);
+      port1.postMessage(spec);
+      const waited = Atomics.wait(signal, 0, 0, timeoutMs);
+      const received = receiveMessageOnPort(port1);
+      if (waited === "timed-out" || !received) throw new IsolationFailure("\uACA9\uB9AC \uD574\uC11D\uC774 \uC751\uB2F5\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4");
+      const reply = received.message;
+      if (typeof reply.path === "string") return reply.path;
+      throw Object.assign(new Error(reply.message ?? spec), reply.code === void 0 ? {} : { code: reply.code });
+    },
+    close() {
+      port1.close();
+      void worker.terminate();
+    }
+  };
+}
+function workerResolveSession(from) {
+  return createWorkerResolveSession(from, ISOLATED_RESOLVE_SOURCE, ISOLATED_RESOLVE_TIMEOUT_MS);
+}
+var isolatedFactory = workerResolveSession;
+function sha256(text) {
+  return createHash("sha256").update(text).digest("hex");
+}
+function openTokensResolver(baseDir, candidates, pkgJson, pkgText) {
+  const nodeRequire = projectRequire(baseDir);
+  const key = sha256(pkgText);
+  const current = candidates.map((c) => c === pkgJson ? key : ABSENT);
+  const changed = candidates.some((c, i) => {
+    const seen = nodeSeenStates.get(c);
+    return seen !== void 0 && seen !== current[i];
+  });
+  let mode = changed ? "isolated" : "node";
+  if (mode === "node") {
+    candidates.forEach((c, i) => {
+      if (!nodeSeenStates.has(c)) nodeSeenStates.set(c, current[i]);
+    });
+  }
+  let session = null;
+  let stale = false;
+  let raced = false;
+  let postChecked = false;
+  const markStale = () => {
+    if (!stale) isolatedStats.fallbacks += 1;
+    stale = true;
+  };
+  const fallBack = () => {
+    markStale();
+    isolationDisabled = true;
+    session?.close();
+    session = null;
+  };
+  const startIsolation = () => {
+    if (isolationDisabled) {
+      markStale();
+      return;
+    }
+    try {
+      session = isolatedFactory(join2(resolve2(baseDir), "package.json"));
+      isolatedStats.workers += 1;
+    } catch {
+      fallBack();
+    }
+  };
+  if (mode === "isolated") startIsolation();
+  const isolatedResolve = (spec) => {
+    if (session) {
+      try {
+        const resolved = session.resolve(spec);
+        isolatedStats.resolves += 1;
+        return resolved;
+      } catch (err) {
+        if (!(err instanceof IsolationFailure)) {
+          isolatedStats.resolves += 1;
+          throw err;
+        }
+        fallBack();
+      }
+    }
+    return nodeRequire.resolve(spec);
+  };
+  return {
+    resolve(spec) {
+      if (mode === "isolated") return isolatedResolve(spec);
+      let resolved;
+      let failure;
+      let failed = false;
+      try {
+        resolved = nodeRequire.resolve(spec);
+      } catch (err) {
+        failed = true;
+        failure = err;
+      }
+      if (!postChecked) {
+        postChecked = true;
+        let after;
+        try {
+          after = sha256(readFileSync2(pkgJson, "utf8"));
+        } catch {
+          after = UNKNOWN;
+        }
+        if (after !== key) {
+          nodeSeenStates.set(pkgJson, UNKNOWN);
+          raced = true;
+          mode = "isolated";
+          startIsolation();
+          return isolatedResolve(spec);
+        }
+      }
+      if (failed) throw failure;
+      return resolved;
+    },
+    get stale() {
+      return stale;
+    },
+    get raced() {
+      return raced;
+    },
+    close() {
+      session?.close();
+      session = null;
+    }
+  };
+}
+function readVersion(pkgText) {
+  const pkg = JSON.parse(pkgText);
+  return typeof pkg.version === "string" ? pkg.version : void 0;
+}
+function openTokens(baseDir) {
+  const { found: pkgJson, candidates } = tokensPackageJsonCandidates(baseDir);
+  if (!pkgJson) return { resolution: { status: "not-installed" } };
+  const pkgText = readFileSync2(pkgJson, "utf8");
+  let version = readVersion(pkgText);
+  const resolver = openTokensResolver(baseDir, candidates, pkgJson, pkgText);
+  const finish = (status, indexPath) => {
+    if (resolver.raced) {
+      try {
+        version = readVersion(readFileSync2(pkgJson, "utf8"));
+      } catch {
+      }
+    }
+    const resolution = indexPath === void 0 ? { status, version } : { status, version, indexPath };
+    return { resolution: resolver.stale ? { ...resolution, stale: true } : resolution, resolver };
+  };
+  try {
+    const indexPath = resolver.resolve(tokensSpecifier("./brands"));
+    return finish("ok", indexPath);
   } catch (err) {
     const code = errorCode(err);
-    if (code === "ERR_PACKAGE_PATH_NOT_EXPORTED") return { status: "unsupported", version };
-    if (code === "MODULE_NOT_FOUND") return { status: "not-built", version };
+    if (code === "ERR_PACKAGE_PATH_NOT_EXPORTED") return finish("unsupported");
+    if (code === "MODULE_NOT_FOUND") return finish("not-built");
+    resolver.close();
     throw err;
   }
 }
+function resolveTokens(baseDir) {
+  const { resolution, resolver } = openTokens(baseDir);
+  resolver?.close();
+  return resolution;
+}
 function brandImportPath(entry) {
   return tokensSpecifier(entry.css);
 }
@@ -3711,8 +3974,8 @@ function readBrandIndex(indexPath) {
   }
   return data.brands;
 }
-function readSummary(baseDir, entry) {
-  const metaPath = projectRequire(baseDir).resolve(tokensSpecifier(entry.meta));
+function readSummary(resolver, entry) {
+  const metaPath = resolver.resolve(tokensSpecifier(entry.meta));
   const meta = readJsonFile(metaPath);
   return {
     name: entry.name,
@@ -3723,20 +3986,33 @@ function readSummary(baseDir, entry) {
   };
 }
 function listBrands(baseDir) {
-  const tokens = resolveTokens(baseDir);
-  if (tokens.status !== "ok" || !tokens.indexPath) {
+  const { resolution: tokens, resolver } = openTokens(baseDir);
+  try {
+    return withStaleOf(resolver, listBrandsWith(tokens, resolver));
+  } finally {
+    resolver?.close();
+  }
+}
+function listBrandsWith(tokens, resolver) {
+  if (tokens.status !== "ok" || !tokens.indexPath || !resolver) {
     return { status: tokens.status, version: tokens.version, brands: [] };
   }
   const entries = readBrandIndex(tokens.indexPath);
-  let brands;
-  try {
-    brands = entries.map((entry) => readSummary(baseDir, entry));
-  } catch (err) {
-    if (isMissingBuildFile(err)) return { status: "not-built", version: tokens.version, brands: [] };
-    throw err;
+  const brands = [];
+  for (const entry of entries) {
+    try {
+      brands.push(readSummary(resolver, entry));
+    } catch (err) {
+      if (isMissingBuildFile(err)) return { status: "not-built", version: tokens.version, brands: [] };
+      if (resolver.stale && errorCode(err) === "ERR_PACKAGE_PATH_NOT_EXPORTED") continue;
+      throw err;
+    }
   }
   return { status: "ok", version: tokens.version, brands };
 }
+function withStaleOf(resolver, result) {
+  return resolver?.stale ? { ...result, stale: true } : result;
+}
 function stripComments(css) {
   return css.replace(/\/\*[\s\S]*?\*\//g, "");
 }
@@ -3848,8 +4124,15 @@ function readProjectPackageJson(baseDir) {
   }
 }
 function getBrand(baseDir, name) {
-  const tokens = resolveTokens(baseDir);
-  if (tokens.status !== "ok" || !tokens.indexPath) {
+  const { resolution: tokens, resolver } = openTokens(baseDir);
+  try {
+    return withStaleOf(resolver, getBrandWith(tokens, resolver, name));
+  } finally {
+    resolver?.close();
+  }
+}
+function getBrandWith(tokens, resolver, name) {
+  if (tokens.status !== "ok" || !tokens.indexPath || !resolver) {
     return { status: tokens.status, version: tokens.version, brand: null, available: [] };
   }
   const entries = readBrandIndex(tokens.indexPath);
@@ -3861,11 +4144,14 @@ function getBrand(baseDir, name) {
   let summary;
   let parsed;
   try {
-    summary = readSummary(baseDir, entry);
-    const cssPath = projectRequire(baseDir).resolve(summary.importPath);
+    summary = readSummary(resolver, entry);
+    const cssPath = resolver.resolve(summary.importPath);
     parsed = parseBrandCss(readFileSync2(cssPath, "utf8"), name);
   } catch (err) {
     if (isMissingBuildFile(err)) return { status: "not-built", version: tokens.version, brand: null, available: [] };
+    if (resolver.stale && errorCode(err) === "ERR_PACKAGE_PATH_NOT_EXPORTED") {
+      return { status: "ok", version: tokens.version, brand: null, available: available.filter((n) => n !== name) };
+    }
     throw err;
   }
   return {
@@ -4970,7 +5256,7 @@ function registerThemeCommand(program2) {
 import chalk11 from "chalk";
 
 // ../axis-registry-core/src/registry/schema.ts
-import { createHash } from "crypto";
+import { createHash as createHash2 } from "crypto";
 var REGISTRY_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var REGISTRY_NAME_MAX_LENGTH = 64;
 function isValidRegistryName(name) {
@@ -5103,8 +5389,8 @@ function validateRegistryIndex(data, where = "index.json") {
     if (!isValidRegistryName(raw.name)) throw new Error(`${at}: name \uC774 slug \uADDC\uCE59\uC5D0 \uB9DE\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`);
     if (seen.has(raw.name)) throw new Error(`${at}: name '${raw.name}' \uAC00 \uC911\uBCF5\uC785\uB2C8\uB2E4`);
     seen.add(raw.name);
-    const sha256 = optionalString(raw, "sha256", at);
-    if (sha256 !== void 0 && !/^[0-9a-f]{64}$/.test(sha256)) {
+    const sha2562 = optionalString(raw, "sha256", at);
+    if (sha2562 !== void 0 && !/^[0-9a-f]{64}$/.test(sha2562)) {
       throw new Error(`${at}: sha256 \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4`);
     }
     return {
@@ -5112,7 +5398,7 @@ function validateRegistryIndex(data, where = "index.json") {
       type: requireType(raw, at),
       title: optionalString(raw, "title", at),
       description: optionalString(raw, "description", at),
-      ...sha256 !== void 0 ? { sha256 } : {}
+      ...sha2562 !== void 0 ? { sha256: sha2562 } : {}
     };
   });
   return {
@@ -5160,7 +5446,7 @@ function validateRegistryItem(data, expectedName, where = `${expectedName}.json`
   };
 }
 function sha256Hex(text) {
-  return createHash("sha256").update(text, "utf8").digest("hex");
+  return createHash2("sha256").update(text, "utf8").digest("hex");
 }
 function checkItemSha256(item, entry, where = `${item.name}.json`) {
   if (entry.sha256 === void 0) return;

package/dist/monet.js

@@ -4,7 +4,7 @@ import {
   getMonetMcpConfig,
   getMonetUrl,
   monetImportNextSteps
-} from "./chunk-EBFXCLSV.js";
+} from "./chunk-C2T7NVDG.js";
 import "./chunk-HFMMK6R4.js";
 export {
   MONET_CATEGORIES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axis-ds/cli",
-  "version": "1.7.7",
+  "version": "1.7.8",
   "type": "module",
   "description": "AXIS Design System - CLI for adding components (shadcn compatible)",
   "publishConfig": {