@axis-ds/cli 1.7.5 → 1.7.6

package/README.md

@@ -89,6 +89,8 @@ axis theme add ontology
 - 브랜드 CSS 는 `[data-brand="<brand>"]` 선택자로 적용되므로 루트 레이아웃의 `<html data-brand>` 나 `ThemeProvider` 의 `setBrand` 가 있어야 화면이 바뀝니다. 코드는 고치지 않고, 레이아웃에서 찾지 못하면 두 방법의 예시를 냅니다(`defaultBrand` 는 `@axis-ds/theme` 1.6.2 이하에서 `setBrand(undefined)` 로 끈 상태가 새로고침 뒤 유지되지 않아 예시에 쓰지 않습니다). 마크업 `data-brand` 와 `ThemeProvider` 를 함께 쓰는 레이아웃이면 theme 1.7.0 이상이 필요하다고 한 줄 더 알립니다(1.6.1 부터). Tailwind 3 이면 preset · content 가 빠졌을 때 넣을 줄도 안내합니다(설정 파일은 고치지 않음). preset 안내는 1.6.1 부터 CommonJS 에서 모든 tokens 버전에 되는 `require("@axis-ds/tokens/tailwind").default` 입니다(1.6.0 의 `.default` 없는 형태는 tokens 1.6.2 이하에서 preset 이 빠짐).
 - 넣은 import 줄의 출력은 1.6.1 부터 실제 위치 · 분류를 따릅니다. 컴포넌트 `tailwind.css` 는 「컴포넌트 스캔 경로, 위치 무관」, 기본 토큰 CSS 는 브랜드 줄보다 앞에 들어갔을 때만 「브랜드 앞」이고 뒤에 들어가면 옮기라고 경고합니다.
 - `@axis-ds/tokens` 가 없거나 1.3.0 미만이면 목록 대신 설치 · 업그레이드 안내를 내고 종료 코드 1 로 끝납니다.
+  - 1.7.6 부터 `theme list` · `theme info` 의 안내는 선언 출처를 따릅니다. 앱이나 pnpm · yarn 워크스페이스 루트에 선언돼 있으면 「설치: <pm> install」, npm 워크스페이스 루트에 선언돼 있으면 「설치: 워크스페이스 루트에서 npm install」, 루트 선언이 1.3.0 미만이면 루트 선언을 올리라는 줄, 빌드 전 재설치도 install 입니다. Yarn PnP 에서 앱에 선언이 있으면 설치본을 판정하지 못했다는 한 줄을 냅니다. 선언이 없으면(또는 PnP · 앱 자체 lockfile 이라 루트 선언을 보지 않으면) 종전 추가 명령입니다.
+  - 같은 1.7.6 부터 `theme add` 는 앱에 선언된 tokens 가 설치되지 않았으면 「설치: <pm> install」을, 설치본이 빌드 전이면 선언 출처(앱 · 루트)와 상관없이 `theme list` 와 같은 재설치 안내(npm 워크스페이스 루트 선언이면 「워크스페이스 루트에서 npm install」)를 더합니다. Yarn PnP 에서 앱에 선언이 있으면 설치 · 재설치 · 업그레이드 줄 대신 `theme list` 와 같은 판정하지 못했다는 한 줄을 냅니다. 루트 선언 미설치의 「설치: <pm> install」 줄은 npm 이어도 앱 디렉터리 명령 그대로입니다.
 - `axis check` 는 `axis.config.json` 의 `brand` 와 CSS 의 브랜드 import 가 맞는지도 봅니다.
 
 ## 프로젝트 검증 (`axis check`)
@@ -106,10 +108,12 @@ axis theme add ontology
   - 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 입니다.
 - globals.css 항목: 같은 후보에서 처음 찾은 CSS 하나를 봅니다. 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"`. 자체 `--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).
+  - 1.7.6 부터 Plug'n'Play 는 워크스페이스 루트 선언을 인정하지 않습니다. 앱이 자기 `package.json` 에 없는 패키지를 해석하지 못하기 때문입니다. 루트에만 있는 `tailwindcss` 는 「워크스페이스 루트에만 선언돼 Plug'n'Play 에서 앱이 해석하지 못합니다」 FAIL, `clsx` · `tailwind-merge` · `@axis-ds/*` 는 같은 문구의 WARN 입니다(1.7.5 까지는 PASS). `.pnp.cjs` 는 `.git` 이 있는 층에서 찾기를 멈춥니다. `pnpFallbackMode: all` 설정은 읽지 않습니다.
 - 해당할 때만 더하는 항목(1.6.0 부터, brand 항목 뒤 이 순서):
-  - `brand.activation`: `brand` 가 있을 때 루트 레이아웃(`app/layout.tsx` · `src/app/layout.tsx` · `pages/_app` 등, 그 레이아웃이 import 하는 같은 디렉터리의 `./providers` 한 단계 포함)에 `data-brand` · `setBrand(` · `defaultBrand=` 가 없으면 WARN 입니다(휴리스틱, `ThemeProvider` 단독은 켜는 코드가 아님). 1.6.1 부터 마크업 `data-brand` 와 `ThemeProvider` 만 있고 `setBrand(` · `defaultBrand=` 가 없으면 설치본(없으면 선언) `@axis-ds/theme` 가 1.7.0 미만이거나 판정할 수 없을 때 WARN 입니다(1.6.2 이하는 마운트 때 속성을 지움).
+  - `brand.activation`: `brand` 가 있을 때 루트 레이아웃(`app/layout.tsx` · `src/app/layout.tsx` · `pages/_app` 등, 그 레이아웃이 import 하는 같은 디렉터리의 `./providers` 한 단계 포함)에 `data-brand` · `setBrand(` · `defaultBrand=` 가 없으면 WARN 입니다(휴리스틱, `ThemeProvider` 단독은 켜는 코드가 아님). 1.6.1 부터 마크업 `data-brand` 와 `ThemeProvider` 만 있고 `setBrand(` · `defaultBrand=` 가 없으면 설치본(없으면 선언) `@axis-ds/theme` 가 1.7.0 미만이거나 판정할 수 없을 때 WARN 입니다(1.6.2 이하는 마운트 때 속성을 지움). 1.7.6 부터 Plug'n'Play 에서 `@axis-ds/theme` 가 워크스페이스 루트에만 선언돼 있으면 「앱이 해석하지 못합니다」 WARN 입니다(Tailwind 3 CommonJS preset 의 `@axis-ds/tokens` 판정도 같음).
   - `tailwind.content`: Tailwind 3 설정 파일이 있고 `componentsDir` 나 선언된 `@axis-ds/ui-react` · `@axis-ds/agentic-ui` 가 있을 때, `content` 의 문자열 glob 이 그 경로를 덮지 않으면 FAIL 입니다(그 경로의 클래스가 생성되지 않음). `content` 를 정적으로 다 읽지 못하면(변수 · 펼침) WARN 입니다. 패키지 경로는 프로젝트 디렉터리부터 상위로 찾은 설치본 위치 기준이라, npm workspaces · pnpm hoisted 처럼 루트에만 설치된 앱은 `../../node_modules/@axis-ds/ui-react/dist/**/*.{js,mjs}` 를 안내합니다(1.7.1 부터, 설치본이 없거나 Plug'n'Play 면 `./node_modules/...`). `**` 는 `../` 를 넘지 않는 것으로, 절대경로 glob 은 실제 위치와 비교해 판정합니다. 1.7.4 부터 pnpm 기본 레이아웃처럼 앱 설치본이 링크이면 실경로가 같은 상위 설치본(`../../node_modules/...`)과 `.pnpm` 스토어 실경로를 상대 경로로 쓴 glob 도 인정하고, 실경로가 다른 상위 설치본을 가리키면 FAIL 문구에 그 이유를 붙입니다. 상위 경로는 Tailwind 3 가 빌드를 실행한 디렉터리 기준으로 풀리므로 모노레포 루트에서 빌드하면 `content: { relative: true, files: [...] }` 를 쓰세요(판정은 프로젝트 디렉터리에서 빌드한다고 보고 함).
-  - `animation`: `@axis-ds/ui-react` 선언이나 `componentsDir` 의 `animate-in` 류 클래스가 있을 때 애니메이션 플러그인(Tailwind 3 `tailwindcss-animate` 선언 + 설치본 + `plugins` 배열 참조, Tailwind 4 `@import "tw-animate-css"`)이 없으면 WARN 입니다. 1.6.1 부터 Tailwind 3 은 `plugins` 배열 안의 `require("tailwindcss-animate")` 나 그 패키지를 받은 식별자(`import animate from` · `const animate = require(...)`)만 인정합니다(import 만 있거나 다른 곳의 같은 문자열은 아님). 배열을 정적으로 다 읽지 못하면(펼침 · 단축 속성) 「확인하지 못함」 WARN 입니다.
+  - `animation`: `@axis-ds/ui-react` 선언이나 `componentsDir` 의 `animate-in` 류 클래스가 있을 때 애니메이션 플러그인(Tailwind 3 `tailwindcss-animate` 선언 + 설치본 + `plugins` 배열 참조, Tailwind 4 `@import "tw-animate-css"`)이 없으면 WARN 입니다. 1.6.1 부터 Tailwind 3 은 `plugins` 배열 안의 `require("tailwindcss-animate")` 나 그 패키지를 받은 식별자(`import animate from` · `const animate = require(...)`)만 인정합니다(import 만 있거나 다른 곳의 같은 문자열은 아님). 배열을 정적으로 다 읽지 못하면(펼침 · 단축 속성) 「확인하지 못함」 WARN 입니다. 1.7.6 부터 Tailwind 4 는 CSS 의 줄마다 그 줄의 패키지(`tw-animate-css` · `tailwindcss-animate`)가 선언 · 설치돼 있어야 PASS 이고, 줄은 있는데 선언이나 설치본이 없으면 「애니메이션 플러그인을 쓸 수 없습니다」 WARN 입니다(1.7.5 까지는 줄만 보고 PASS, 실제 빌드는 실패). Plug'n'Play 에서는 플러그인 선언을 앱 `package.json` 에서만 봅니다.
 - FAIL 이 하나라도 있으면 종료 코드 1 로 끝납니다. WARN 만 있으면 0 입니다(1.3.0 부터, 이전에는 결과와 관계없이 0).
 - MCP `axis.check_project` 도 같은 항목 · 문구를 냅니다.
 

package/dist/{chunk-YYSEFWYD.js → chunk-I3HWV7Y5.js}

@@ -109,14 +109,56 @@ function workspaceRootPackage(baseDirInput) {
     return void 0;
   }
 }
-function declaredDependency(baseDir, pkg, name, rootPkg) {
+function declaredDependency(baseDir, pkg, name, rootPkg, options = {}) {
   if (pkg === void 0) return void 0;
   const own = hasDependency(pkg, name);
   if (own !== void 0) return { range: own, source: "app" };
+  if (options.appOnlyInPnp && isPnpProject(baseDir)) return void 0;
   const root = rootPkg === void 0 ? workspaceRootPackage(baseDir) : rootPkg ?? void 0;
   const fromRoot = root !== void 0 ? hasDependency(root, name) : void 0;
   return fromRoot !== void 0 ? { range: fromRoot, source: "root" } : void 0;
 }
+function pnpRootOnlyDependency(baseDir, pkg, name, rootPkg) {
+  if (pkg === void 0 || hasDependency(pkg, name) !== void 0 || !isPnpProject(baseDir)) return void 0;
+  const found = declaredDependency(baseDir, pkg, name, rootPkg);
+  return found?.source === "root" ? found : void 0;
+}
+var PNP_ROOT_ONLY_NOTE = "\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uB9CC \uC120\uC5B8\uB3FC Plug'n'Play \uC5D0\uC11C \uC571\uC774 \uD574\uC11D\uD558\uC9C0 \uBABB\uD569\uB2C8\uB2E4";
+var APP_LOCKFILES = ["package-lock.json", "pnpm-lock.yaml", "yarn.lock", "bun.lockb", "bun.lock"];
+function hasAppLockfile(baseDirInput) {
+  const baseDir = path.resolve(baseDirInput);
+  return APP_LOCKFILES.some((f) => existsSync(path.join(baseDir, f)));
+}
+function rootDeclarationsAllowed(baseDir, pkg) {
+  return pkg !== void 0 && !isPnpProject(baseDir) && !hasAppLockfile(baseDir);
+}
+function readPackageJsonAt(dir) {
+  try {
+    const parsed = JSON.parse(readFileSync(path.join(dir, "package.json"), "utf8"));
+    return isPlainObject(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function dependencyInstallGuide(baseDirInput, name, range) {
+  const baseDir = resolveBaseDir(baseDirInput);
+  const installCommand = detectInstallCommand(baseDir);
+  const base = { installCommand, addCommand: addCommandFor(installCommand, { [name]: range }) };
+  const pkg = readPackageJsonAt(baseDir);
+  if (pkg === void 0) return { kind: "add", ...base };
+  const own = hasDependency(pkg, name);
+  if (isPnpProject(baseDir)) return own !== void 0 ? { kind: "pnp", source: "app", range: own, ...base } : { kind: "add", ...base };
+  if (own !== void 0) return { kind: "install", source: "app", range: own, ...base };
+  if (!rootDeclarationsAllowed(baseDir, pkg)) return { kind: "add", ...base };
+  const declared = declaredDependency(baseDir, pkg, name);
+  if (declared?.source !== "root") return { kind: "add", ...base };
+  return {
+    kind: packageManagerOf(installCommand) === "npm" ? "install-at-root" : "install",
+    source: "root",
+    range: declared.range,
+    ...base
+  };
+}
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -247,6 +289,7 @@ function isPnpProject(baseDirInput) {
   let dir = resolveBaseDir(baseDirInput);
   for (; ; ) {
     if (isFile(path.join(dir, ".pnp.cjs")) || isFile(path.join(dir, ".pnp.js"))) return true;
+    if (existsSync(path.join(dir, ".git"))) return false;
     const parent = path.dirname(dir);
     if (parent === dir) return false;
     dir = parent;
@@ -453,6 +496,10 @@ export {
   hasDependency,
   workspaceRootPackage,
   declaredDependency,
+  pnpRootOnlyDependency,
+  PNP_ROOT_ONLY_NOTE,
+  rootDeclarationsAllowed,
+  dependencyInstallGuide,
   isPlainObject,
   addCommandPrefix,
   addCommandFor,

package/dist/index.js

@@ -2,23 +2,27 @@
 import {
   GLOBAL_CSS_CANDIDATES,
   MonetClient,
+  PNP_ROOT_ONLY_NOTE,
   ROOT_LAYOUT_FILES,
   addCommandFor,
   addCommandPrefix,
   compareExactVersions,
   declaredDependency,
+  dependencyInstallGuide,
   detectInstallCommand,
   detectProjectPaths,
   findInstalledPackage,
   hasDependency,
   isPlainObject,
   isPnpProject,
+  pnpRootOnlyDependency,
   projectFileExists,
   resolveBaseDir,
+  rootDeclarationsAllowed,
   runScriptCommand,
   workspaceRootPackage,
   workspaceRunCommand
-} from "./chunk-YYSEFWYD.js";
+} from "./chunk-I3HWV7Y5.js";
 import {
   V0Client
 } from "./chunk-2PNCUPCG.js";
@@ -1929,6 +1933,9 @@ import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep }
 function declaredRange(baseDir, pkg, name) {
   return declaredDependency(baseDir, pkg, name)?.range;
 }
+function declaredRangeForCheck(baseDir, pkg, name) {
+  return declaredDependency(baseDir, pkg, name, void 0, { appOnlyInPnp: true })?.range;
+}
 function isPlainObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -2306,7 +2313,7 @@ function hasBareCjsPresetRequire(code) {
 function isCommonJsConfig(file, source) {
   return extname(file) === ".cjs" || /\bmodule\.exports\b/.test(source);
 }
-function packageVersionGate(baseDirInput, pkg, name, min) {
+function packageVersionGate(baseDirInput, pkg, name, min, options = {}) {
   const baseDir = resolveBaseDir(baseDirInput);
   if (!isPnpProject(baseDir)) {
     const installed = findInstalledPackage(baseDir, name)?.version;
@@ -2315,7 +2322,11 @@ function packageVersionGate(baseDirInput, pkg, name, min) {
       if (cmp !== void 0) return { status: cmp >= 0 ? "ok" : "below", source: "installed", value: installed };
     }
   }
-  const declared = pkg ? declaredRange(baseDir, pkg, name) : void 0;
+  const declared = pkg ? declaredDependency(baseDir, pkg, name, void 0, options)?.range : void 0;
+  if (declared === void 0 && options.appOnlyInPnp) {
+    const rootOnly = pnpRootOnlyDependency(baseDir, pkg, name);
+    if (rootOnly !== void 0) return { status: "unresolved", source: "declared", value: rootOnly.range };
+  }
   if (declared !== void 0) {
     const atLeast = rangeLowerAtLeast(declared, min);
     if (atLeast !== void 0) return { status: atLeast ? "ok" : "below", source: "declared", value: declared };
@@ -2324,6 +2335,7 @@ function packageVersionGate(baseDirInput, pkg, name, min) {
   return { status: "unknown", source: "none" };
 }
 function versionGateLabel(gate) {
+  if (gate.status === "unresolved") return `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8 \uC120\uC5B8 ${gate.value}`;
   if (gate.source === "installed") return `\uC124\uCE58\uBCF8 ${gate.value}`;
   if (gate.source === "declared") return `\uC120\uC5B8 ${gate.value}`;
   return "\uC124\uCE58\uBCF8 \xB7 \uC120\uC5B8 \uC5C6\uC74C";
@@ -2405,7 +2417,14 @@ function checkTailwindSetup(baseDirInput) {
     if (hasTokensPresetReference(content)) {
       const code = stripJsComments(content);
       if (isCommonJsConfig(file, code) && hasBareCjsPresetRequire(code)) {
-        const gate = packageVersionGate(baseDir, pkg, "@axis-ds/tokens", TOKENS_CJS_PRESET_FIXED_VERSION);
+        const gate = packageVersionGate(baseDir, pkg, "@axis-ds/tokens", TOKENS_CJS_PRESET_FIXED_VERSION, { appOnlyInPnp: true });
+        if (gate.status === "unresolved") {
+          return {
+            name: "tailwind.config",
+            severity: "warn",
+            message: `${file}\uC5D0 AXIS preset \uCC38\uC870\uAC00 \uC788\uC9C0\uB9CC @axis-ds/tokens \uAC00 ${PNP_ROOT_ONLY_NOTE}(${versionGateLabel(gate)}) \u2192 \uC571 package.json \uC5D0 @axis-ds/tokens ${TOKENS_CJS_PRESET_FIXED_VERSION} \uC774\uC0C1\uC744 \uC120\uC5B8\uD558\uC138\uC694`
+          };
+        }
         if (gate.status !== "ok") {
           const why = gate.status === "below" ? `@axis-ds/tokens ${versionGateLabel(gate)} \uC5D0\uC11C\uB294 CommonJS \uC758 require("${TOKENS_TAILWIND3_PRESET}") \uAC00 preset \uC774 \uC544\uB2C8\uB77C { default } \uB97C \uB3CC\uB824\uC918 \uC0C9 \xB7 keyframes \uAC00 \uC801\uC6A9\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4` : `@axis-ds/tokens \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${versionGateLabel(gate)}). ${TOKENS_CJS_PRESET_FIXED_VERSION} \uBBF8\uB9CC\uC774\uBA74 CommonJS \uC758 require("${TOKENS_TAILWIND3_PRESET}") \uB85C\uB294 preset \uC774 \uC801\uC6A9\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`;
           return {
@@ -2751,30 +2770,56 @@ function checkAnimationPlugin(baseDirInput) {
   if (!declared && !copied) return null;
   const by = declared ? "@axis-ds/ui-react \uC120\uC5B8" : "componentsDir \uC758 animate-in \uB958 \uD074\uB798\uC2A4";
   const tailwind = detectTailwind(baseDir, pkg);
+  const pnp = isPnpProject(baseDir);
+  const pluginProblem = (name) => {
+    if (declaredRangeForCheck(baseDir, pkg, name) === void 0) {
+      return pnpRootOnlyDependency(baseDir, pkg, name) !== void 0 ? `${name} \uAC00 ${PNP_ROOT_ONLY_NOTE}` : `${name} \uC120\uC5B8 \uC5C6\uC74C`;
+    }
+    if (!pnp && findInstalledPackage(baseDir, name) === void 0) return `${name} \uBBF8\uC124\uCE58(\uC120\uC5B8\uB9CC \uC788\uC74C)`;
+    return void 0;
+  };
   if (tailwind.major !== void 0 && tailwind.major >= 4) {
     const file = TAILWIND_CSS_CANDIDATES.find((c) => existsSync(join(baseDir, c)));
     const css = file !== void 0 ? stripCssComments(readFileSync(join(baseDir, file), "utf8")) : "";
-    const ok = new RegExp(`@import\\s+(?:url\\(\\s*)?["']${ANIMATION_PLUGIN_TAILWIND4}["']`).test(css) || new RegExp(`@plugin\\s+["']${ANIMATION_PLUGIN_TAILWIND3}["']`).test(css);
-    return ok ? { name: "animation", severity: "pass", message: `${file}\uC5D0 \uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC788\uC2B5\uB2C8\uB2E4` } : {
+    const lines = [];
+    if (new RegExp(`@import\\s+(?:url\\(\\s*)?["']${ANIMATION_PLUGIN_TAILWIND4}["']`).test(css)) lines.push(ANIMATION_PLUGIN_TAILWIND4);
+    if (new RegExp(`@plugin\\s+["']${ANIMATION_PLUGIN_TAILWIND3}["']`).test(css)) lines.push(ANIMATION_PLUGIN_TAILWIND3);
+    if (lines.length === 0) {
+      return {
+        name: "animation",
+        severity: "warn",
+        message: `\uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC5C6\uC2B5\uB2C8\uB2E4(${by}): Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 ${ANIMATION_PLUGIN_TAILWIND4} \uC124\uCE58 \uB4A4 @import "${ANIMATION_PLUGIN_TAILWIND4}";`
+      };
+    }
+    const problems = lines.map((name) => ({ name, why: pluginProblem(name) })).filter((x) => x.why !== void 0);
+    if (problems.length === 0) return { name: "animation", severity: "pass", message: `${file}\uC5D0 \uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC788\uC2B5\uB2C8\uB2E4` };
+    return {
       name: "animation",
       severity: "warn",
-      message: `\uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC5C6\uC2B5\uB2C8\uB2E4(${by}): Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 ${ANIMATION_PLUGIN_TAILWIND4} \uC124\uCE58 \uB4A4 @import "${ANIMATION_PLUGIN_TAILWIND4}";`
+      message: `${file}\uC758 \uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC744 \uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${by}, ${problems.map((x) => x.why).join(" \xB7 ")}): Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uACE0 \uBE4C\uB4DC\uAC00 \uC2E4\uD328\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4 \u2192 ${problems.map((x) => x.name).join(" \xB7 ")} \uB97C package.json \uC5D0 \uC120\uC5B8 \xB7 \uC124\uCE58\uD558\uC138\uC694`
     };
   }
   const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync(join(baseDir, f)));
   const source = configFile !== void 0 ? stripJsComments(readFileSync(join(baseDir, configFile), "utf8")) : "";
   const plugins = configFile !== void 0 ? readAnimationPluginUse(source) : "absent";
-  const pluginDeclared = declaredRange(baseDir, pkg, ANIMATION_PLUGIN_TAILWIND3) !== void 0;
-  const pluginInstalled = pluginDeclared && (isPnpProject(baseDir) || findInstalledPackage(baseDir, ANIMATION_PLUGIN_TAILWIND3) !== void 0);
-  if (plugins === "found" && pluginDeclared && pluginInstalled) {
+  const pluginReason = pluginProblem(ANIMATION_PLUGIN_TAILWIND3);
+  if (plugins === "found" && pluginReason === void 0) {
     return { name: "animation", severity: "pass", message: `${configFile}\uC758 plugins \uC5D0 ${ANIMATION_PLUGIN_TAILWIND3} \uAC00 \uC788\uC2B5\uB2C8\uB2E4` };
   }
   const cfg = configFile ?? "tailwind.config";
+  const configReason = plugins === "dynamic" ? `${cfg} plugins \uB97C \uC815\uC801\uC73C\uB85C \uB2E4 \uC77D\uC9C0 \uBABB\uD574 \uD655\uC778\uD558\uC9C0 \uBABB\uD568` : plugins !== "found" ? `${cfg} plugins \uC5D0 \uC5C6\uC74C` : void 0;
+  if (pluginReason !== void 0 && pnpRootOnlyDependency(baseDir, pkg, ANIMATION_PLUGIN_TAILWIND3) !== void 0) {
+    const extra = configReason !== void 0 ? `, ${configReason}` : "";
+    const plug = configReason !== void 0 ? ` \xB7 plugins \uC5D0 require("${ANIMATION_PLUGIN_TAILWIND3}")` : "";
+    return {
+      name: "animation",
+      severity: "warn",
+      message: `\uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778 ${ANIMATION_PLUGIN_TAILWIND3} \uAC00 ${PNP_ROOT_ONLY_NOTE}(${by}${extra}): Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uC571 package.json \uC5D0 ${ANIMATION_PLUGIN_TAILWIND3} \uB97C \uC120\uC5B8\uD558\uC138\uC694${plug}`
+    };
+  }
   const reasons = [];
-  if (!pluginDeclared) reasons.push(`${ANIMATION_PLUGIN_TAILWIND3} \uC120\uC5B8 \uC5C6\uC74C`);
-  else if (!pluginInstalled) reasons.push(`${ANIMATION_PLUGIN_TAILWIND3} \uBBF8\uC124\uCE58(\uC120\uC5B8\uB9CC \uC788\uC74C)`);
-  if (plugins === "dynamic") reasons.push(`${cfg} plugins \uB97C \uC815\uC801\uC73C\uB85C \uB2E4 \uC77D\uC9C0 \uBABB\uD574 \uD655\uC778\uD558\uC9C0 \uBABB\uD568`);
-  else if (plugins !== "found") reasons.push(`${cfg} plugins \uC5D0 \uC5C6\uC74C`);
+  if (pluginReason !== void 0) reasons.push(pluginReason);
+  if (configReason !== void 0) reasons.push(configReason);
   return {
     name: "animation",
     severity: "warn",
@@ -3439,7 +3484,11 @@ function inspectBrandActivation(baseDir) {
   if (typeof brand !== "string" || brand.trim() === "") return null;
   const location = findBrandActivation(baseDir);
   if (!location.markupWithProvider) return { brand, ...location };
-  return { brand, ...location, theme: packageVersionGate(baseDir, readProjectPackageJson(baseDir), THEME_PACKAGE, THEME_MARKUP_BRAND_MIN_VERSION) };
+  return {
+    brand,
+    ...location,
+    theme: packageVersionGate(baseDir, readProjectPackageJson(baseDir), THEME_PACKAGE, THEME_MARKUP_BRAND_MIN_VERSION, { appOnlyInPnp: true })
+  };
 }
 var THEME_PACKAGE = "@axis-ds/theme";
 function readProjectPackageJson(baseDir) {
@@ -3512,25 +3561,43 @@ function checkDependencies(baseDirInput) {
     return { name: "dependencies", severity: "fail", message: "package.json \uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(JSON \uD655\uC778)" };
   }
   const rootPkg = workspaceRootPackage(baseDir) ?? null;
-  const declared = (d) => declaredDependency(baseDir, pkg, d, rootPkg);
+  const pnp = isPnpProject(baseDir);
+  const declared = (d) => declaredDependency(baseDir, pkg, d, rootPkg, { appOnlyInPnp: true });
+  const pnpRootOnly = (d) => pnpRootOnlyDependency(baseDir, pkg, d, rootPkg) !== void 0;
   const fromRoot = (d) => declared(d)?.source === "root";
-  const missingRequired = REQUIRED_DEPENDENCIES.filter((d) => declared(d) === void 0);
-  if (missingRequired.length > 0) {
-    return { name: "dependencies", severity: "fail", message: `\uD544\uC218 \uC758\uC874\uC131 \uB204\uB77D: ${missingRequired.join(", ")}` };
-  }
-  const missingRecommended = RECOMMENDED_DEPENDENCIES.filter((d) => declared(d) === void 0);
-  const rootDeclared = [...REQUIRED_DEPENDENCIES, ...RECOMMENDED_DEPENDENCIES].filter((d) => fromRoot(d));
+  const missingRequired = REQUIRED_DEPENDENCIES.filter((d) => declared(d) === void 0 && !pnpRootOnly(d));
+  const pnpRootRequired = REQUIRED_DEPENDENCIES.filter((d) => pnpRootOnly(d));
+  if (missingRequired.length > 0 || pnpRootRequired.length > 0) {
+    const fails = [];
+    if (missingRequired.length > 0) fails.push(`\uD544\uC218 \uC758\uC874\uC131 \uB204\uB77D: ${missingRequired.join(", ")}`);
+    if (pnpRootRequired.length > 0) fails.push(`\uD544\uC218 \uC758\uC874\uC131 ${pnpRootRequired.join(", ")} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694`);
+    return { name: "dependencies", severity: "fail", message: fails.join(" / ") };
+  }
+  const missingRecommended = RECOMMENDED_DEPENDENCIES.filter((d) => declared(d) === void 0 && !pnpRootOnly(d));
+  const pnpRootRecommended = RECOMMENDED_DEPENDENCIES.filter((d) => pnpRootOnly(d));
+  const appAxis = declaredAxisPackages(pkg);
+  const rootOnlyAxis = rootPkg !== null ? declaredAxisPackages(rootPkg).filter((d) => !appAxis.includes(d)) : [];
+  const rootAxis = pnp ? [] : rootOnlyAxis;
+  const pnpRootAxis = pnp ? rootOnlyAxis : [];
+  const rootDeclared = [...[...REQUIRED_DEPENDENCIES, ...RECOMMENDED_DEPENDENCIES].filter((d) => fromRoot(d)), ...rootAxis];
   const rootNote = rootDeclared.length > 0 ? `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC120\uC5B8: ${rootDeclared.join(", ")}` : void 0;
   const targets = [
     ...[...REQUIRED_DEPENDENCIES, ...RECOMMENDED_DEPENDENCIES].filter((d) => declared(d) !== void 0),
-    ...declaredAxisPackages(pkg)
+    ...appAxis,
+    ...rootAxis
   ];
-  const pnp = isPnpProject(baseDir);
   const notInstalled = pnp ? [] : targets.filter((d) => findInstalledPackage(baseDir, d) === void 0);
+  const notInstalledRoot = notInstalled.filter((d) => rootAxis.includes(d));
+  const notInstalledOther = notInstalled.filter((d) => !rootAxis.includes(d));
   const problems = [];
   if (missingRecommended.length > 0) problems.push(`\uAD8C\uC7A5 \uC758\uC874\uC131 \uB204\uB77D: ${missingRecommended.join(", ")}`);
-  if (notInstalled.length > 0) {
-    problems.push(`\uC120\uC5B8\uB410\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC740 \uC758\uC874\uC131: ${notInstalled.join(", ")} \u2192 ${detectInstallCommand(baseDir)}`);
+  if (pnpRootRecommended.length > 0) problems.push(`\uAD8C\uC7A5 \uC758\uC874\uC131 ${pnpRootRecommended.join(", ")} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694`);
+  if (pnpRootAxis.length > 0) problems.push(`${pnpRootAxis.join(", ")} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694`);
+  if (notInstalledOther.length > 0) {
+    problems.push(`\uC120\uC5B8\uB410\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC740 \uC758\uC874\uC131: ${notInstalledOther.join(", ")} \u2192 ${detectInstallCommand(baseDir)}`);
+  }
+  if (notInstalledRoot.length > 0) {
+    problems.push(`\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC120\uC5B8\uB3FC \uC788\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4: ${notInstalledRoot.join(", ")} \u2192 ${detectInstallCommand(baseDir)}`);
   }
   if (problems.length > 0) {
     return { name: "dependencies", severity: "warn", message: problems.join(" / ") + (rootNote ? ` (${rootNote})` : "") };
@@ -3669,6 +3736,13 @@ function brandCheckResult(check) {
   }
 }
 function brandActivationResult(check) {
+  if (check.found && check.theme?.status === "unresolved") {
+    return {
+      name: "brand.activation",
+      severity: "warn",
+      message: `${check.found}\uC758 <html data-brand> \uB97C ThemeProvider \uC640 \uD568\uAED8 \uC4F0\uB294\uB370 @axis-ds/theme \uAC00 ${PNP_ROOT_ONLY_NOTE}(${versionGateLabel(check.theme)}) \u2192 \uC571 package.json \uC5D0 @axis-ds/theme ${THEME_MARKUP_BRAND_MIN_VERSION} \uC774\uC0C1\uC744 \uC120\uC5B8\uD558\uAC70\uB098 setBrand("${check.brand}")`
+    };
+  }
   if (check.found && check.theme && check.theme.status !== "ok") {
     const label = versionGateLabel(check.theme);
     const why = check.theme.status === "below" ? `@axis-ds/theme ${label} \uC758 ThemeProvider \uAC00 \uB9C8\uC6B4\uD2B8 \uB54C \uC9C0\uC6C1\uB2C8\uB2E4` : `@axis-ds/theme \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${label}). ${THEME_MARKUP_BRAND_MIN_VERSION} \uBBF8\uB9CC\uC774\uBA74 ThemeProvider \uAC00 \uB9C8\uC6B4\uD2B8 \uB54C \uC9C0\uC6C1\uB2C8\uB2E4`;
@@ -3808,7 +3882,6 @@ var TOKENS_DEPENDENCY_RANGE = `^${TOKENS_DEPENDENCY_MIN_VERSION}`;
 var TAILWIND3_BASE_IMPORTS = [`${TOKENS_PACKAGE}/css`, `${TOKENS_PACKAGE}/css/shadcn`];
 var THEME_MIN_VERSION = "1.3.0";
 var COMPONENT_TAILWIND_CSS_MIN_VERSION = "1.4.0";
-var APP_LOCKFILES = ["package-lock.json", "pnpm-lock.yaml", "yarn.lock", "bun.lockb", "bun.lock"];
 function readText(file) {
   return existsSync3(file) ? readFileSync4(file, "utf8") : null;
 }
@@ -3928,6 +4001,7 @@ function planThemeAdd(baseDirInput, brand) {
     unverifiedBrand: false,
     configChanged: false,
     installCommand: detectInstallCommand(baseDir),
+    tokensGuide: dependencyInstallGuide(baseDir, TOKENS_PACKAGE, TOKENS_DEPENDENCY_RANGE),
     writes: []
   };
   const configFile = path11.join(baseDir, AXIS_CONFIG_FILE);
@@ -3981,8 +4055,7 @@ function planThemeAdd(baseDirInput, brand) {
       return plan;
     }
   }
-  const rootDeclarationsAllowed = pkg !== void 0 && !isPnpProject(baseDir) && !APP_LOCKFILES.some((f) => existsSync3(path11.join(baseDir, f)));
-  const rootPkg = rootDeclarationsAllowed ? workspaceRootPackage(baseDir) ?? null : null;
+  const rootPkg = rootDeclarationsAllowed(baseDir, pkg) ? workspaceRootPackage(baseDir) ?? null : null;
   const tailwind = detectTailwind(baseDir, pkg);
   const tailwind4 = tailwind.major !== void 0 && tailwind.major >= 4;
   const componentImports = [];
@@ -4186,30 +4259,44 @@ function baseImportLines(after, spec, brandImportPath2, file) {
     chalk9.yellow(`  ! \uC774 \uC904\uC774 \uBE0C\uB79C\uB4DC import \uB4A4\uC5D0 \uB4E4\uC5B4\uAC14\uC2B5\uB2C8\uB2E4. \uBE0C\uB79C\uB4DC \uAC12\uC774 \uAE30\uBCF8 \uD1A0\uD070\uC5D0 \uB36E\uC774\uBBC0\uB85C @import "${brandImportPath2}"; \uC55E\uC73C\uB85C \uC62E\uAE30\uC138\uC694`)
   ];
 }
-function tokensInstallCommand(baseDir) {
-  return addCommandFor(detectInstallCommand(baseDir), { [TOKENS_PACKAGE]: TOKENS_DEPENDENCY_RANGE });
-}
 var TOKENS_INSTALL_COMMAND = addCommandFor("pnpm install", { [TOKENS_PACKAGE]: TOKENS_DEPENDENCY_RANGE });
-function tokensStatusGuide(status, version, installCommand = TOKENS_INSTALL_COMMAND) {
+function tokensInstallGuide(baseDir) {
+  return dependencyInstallGuide(baseDir, TOKENS_PACKAGE, TOKENS_DEPENDENCY_RANGE);
+}
+function asGuide(guide) {
+  return typeof guide === "string" ? { kind: "add", installCommand: guide, addCommand: guide } : guide;
+}
+function tokensPnpMessage(range) {
+  return `${TOKENS_PACKAGE}${range ? ` ${range}` : ""} \uAC00 package.json \uC5D0 \uC120\uC5B8\uB3FC \uC788\uC9C0\uB9CC Plug'n'Play \uC124\uCE58\uB77C \uC124\uCE58\uBCF8\uC744 \uD310\uC815\uD558\uC9C0 \uBABB\uD574 \uBE0C\uB79C\uB4DC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`;
+}
+var ROOT_TOKENS_UPGRADE_GUIDE = `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8 package.json \uC758 ${TOKENS_PACKAGE} \uC120\uC5B8\uC744 ^${MIN_BRAND_TOKENS_VERSION} \uC774\uC0C1\uC73C\uB85C \uC62C\uB9AC\uACE0 \uC124\uCE58\uD558\uC138\uC694.`;
+function installPhrase(g) {
+  if (g.kind === "install-at-root") return `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uC11C ${chalk9.cyan(g.installCommand)}`;
+  return chalk9.cyan(g.kind === "install" ? g.installCommand : g.addCommand);
+}
+function rebuildGuide(g) {
+  return `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uBA74 ${chalk9.cyan(workspaceRunCommand(g.installCommand, TOKENS_PACKAGE, "build"))}, \uC544\uB2C8\uBA74 \uC7AC\uC124\uCE58: ${installPhrase(g)}`;
+}
+function tokensStatusGuide(status, version, guide = TOKENS_INSTALL_COMMAND) {
+  const g = asGuide(guide);
+  if (g.kind === "pnp") return [chalk9.yellow(tokensPnpMessage(g.range))];
+  const install = installPhrase(g);
   switch (status) {
     case "not-installed":
-      return [
-        chalk9.yellow(`${TOKENS_PACKAGE} \uAC00 \uC124\uCE58\uB3FC \uC788\uC9C0 \uC54A\uC544 \uBE0C\uB79C\uB4DC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`),
-        `  \uC124\uCE58: ${chalk9.cyan(installCommand)}`
-      ];
+      return [chalk9.yellow(`${TOKENS_PACKAGE} \uAC00 \uC124\uCE58\uB3FC \uC788\uC9C0 \uC54A\uC544 \uBE0C\uB79C\uB4DC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`), `  \uC124\uCE58: ${install}`];
     case "unsupported":
       return [
         chalk9.yellow(
           `${TOKENS_PACKAGE} ${version ?? "(\uBC84\uC804 \uBAA8\uB984)"} \uC740 \uBE0C\uB79C\uB4DC\uB97C \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(${MIN_BRAND_TOKENS_VERSION} \uC774\uC0C1 \uD544\uC694).`
         ),
-        `  \uC5C5\uADF8\uB808\uC774\uB4DC: ${chalk9.cyan(installCommand)}`
+        g.source === "root" ? `  ${ROOT_TOKENS_UPGRADE_GUIDE}` : `  \uC5C5\uADF8\uB808\uC774\uB4DC: ${chalk9.cyan(g.addCommand)}`
       ];
     case "not-built":
       return [
         chalk9.yellow(
           `${TOKENS_PACKAGE}${version ? ` ${version}` : ""} \uB294 \uC788\uC9C0\uB9CC \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C\uC774 \uC5C6\uC5B4 \uBE0C\uB79C\uB4DC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`
         ),
-        `  \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uBA74 ${chalk9.cyan(workspaceRunCommand(installCommand, TOKENS_PACKAGE, "build"))}, \uC544\uB2C8\uBA74 \uC7AC\uC124\uCE58: ${chalk9.cyan(installCommand)}`
+        `  ${rebuildGuide(g)}`
       ];
   }
 }
@@ -4416,6 +4503,8 @@ function renderThemeAdd(plan, written) {
     );
   }
   const dep = plan.dependency;
+  const tokensGuide = plan.tokensGuide;
+  const pnpTokens = tokensGuide.kind === "pnp" && plan.tokens.status !== "ok";
   if (dep?.action === "add") {
     lines.push(
       `  ${chalk9.green("\u2713")} package.json: dependencies \uC5D0 "${TOKENS_PACKAGE}": "${TOKENS_DEPENDENCY_RANGE}" \uCD94\uAC00`,
@@ -4426,12 +4515,16 @@ function renderThemeAdd(plan, written) {
       `  ${chalk9.gray("-")} package.json: ${TOKENS_PACKAGE} ${dep.declaredRange} \uAC00 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC120\uC5B8\uB3FC \uC788\uC5B4 \uC571 package.json \uC740 \uBC14\uAFB8\uC9C0 \uC54A\uC74C`
     );
     if (plan.tokens.status === "not-installed") lines.push(`    \uC124\uCE58: ${chalk9.cyan(plan.installCommand)}`);
+    else if (plan.tokens.status === "not-built") lines.push(`    ${rebuildGuide(tokensGuide)}`);
   } else if (dep?.action === "present") {
     lines.push(`  ${chalk9.gray("-")} package.json: ${TOKENS_PACKAGE} ${dep.declaredRange} \uAC00 \uC774\uBBF8 \uC788\uC5B4 \uBC94\uC704\uB97C \uBC14\uAFB8\uC9C0 \uC54A\uC74C`);
+    if (pnpTokens) lines.push(`    ${chalk9.yellow(tokensPnpMessage(tokensGuide.range))}`);
+    else if (plan.tokens.status === "not-installed") lines.push(`    \uC124\uCE58: ${chalk9.cyan(plan.installCommand)}`);
+    else if (plan.tokens.status === "not-built") lines.push(`    ${rebuildGuide(tokensGuide)}`);
   } else if (dep?.action === "no-package-json") {
     lines.push(chalk9.yellow(`  ! package.json \uC774 \uC5C6\uC5B4 \uC758\uC874\uC131\uC744 \uCD94\uAC00\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC124\uCE58: ${dep.tokensAddCommand}`));
   }
-  if (dep?.upgrade) {
+  if (dep?.upgrade && !pnpTokens) {
     lines.push(
       chalk9.yellow(
         `  ! \uC124\uCE58\uB41C ${TOKENS_PACKAGE} ${plan.tokens.version} \uC740 \uBE0C\uB79C\uB4DC\uB97C \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(${MIN_BRAND_TOKENS_VERSION} \uC774\uC0C1 \uD544\uC694).`
@@ -4520,11 +4613,11 @@ function registerThemeCommand(program2) {
   const themeCmd = program2.command("theme").description("\uBE0C\uB79C\uB4DC \uD14C\uB9C8 (@axis-ds/tokens \uBE0C\uB79C\uB4DC)");
   themeCmd.command("list").alias("ls").description("\uC124\uCE58\uB41C @axis-ds/tokens \uC758 \uBE0C\uB79C\uB4DC \uBAA9\uB85D").option("-d, --dir <path>", "\uB300\uC0C1 \uB514\uB809\uD1A0\uB9AC").action((options) => {
     const baseDir = path12.resolve(options.dir || ".");
-    print(renderThemeList(listBrands(baseDir), tokensInstallCommand(baseDir)));
+    print(renderThemeList(listBrands(baseDir), tokensInstallGuide(baseDir)));
   });
   themeCmd.command("info <brand>").description("\uBE0C\uB79C\uB4DC \uC0C1\uC138: import \uACBD\uB85C \xB7 Provider \uC608\uC2DC \xB7 \uC8FC\uC694 \uD1A0\uD070 \xB7 \uBCF4\uC815 \uB0B4\uC5ED").option("-d, --dir <path>", "\uB300\uC0C1 \uB514\uB809\uD1A0\uB9AC").action((name, options) => {
     const baseDir = path12.resolve(options.dir || ".");
-    print(renderThemeInfo(getBrand(baseDir, name), name, tokensInstallCommand(baseDir)));
+    print(renderThemeInfo(getBrand(baseDir, name), name, tokensInstallGuide(baseDir)));
   });
   themeCmd.command("add <brand>").description("\uBE0C\uB79C\uB4DC \uC801\uC6A9: CSS import \xB7 package.json \uC758\uC874\uC131 \xB7 axis.config.json brand (\uC124\uCE58\uB294 \uC548\uB0B4\uB9CC)").option("-d, --dir <path>", "\uB300\uC0C1 \uB514\uB809\uD1A0\uB9AC").action((name, options) => {
     const baseDir = path12.resolve(options.dir || ".");

package/dist/monet.js

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

package/package.json

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