@axis-ds/mcp 1.4.4 → 1.4.6

package/dist/index.js

@@ -77,7 +77,7 @@ function getTokenStats() {
 }
 
 // ../axis-registry-core/src/add/add.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5, statSync as statSync3 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync5, statSync as statSync4 } from "fs";
 import path5 from "path";
 import fs3 from "fs-extra";
 
@@ -871,7 +871,7 @@ var RegistryClient = class {
 };
 
 // ../axis-registry-core/src/project.ts
-import { existsSync as existsSync2, readFileSync as readFileSync3, realpathSync, statSync } from "fs";
+import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync3, realpathSync, statSync } from "fs";
 import path3 from "path";
 function resolveBaseDir(baseDirInput) {
   const resolved = path3.resolve(baseDirInput);
@@ -970,14 +970,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 = path3.resolve(baseDirInput);
+  return APP_LOCKFILES.some((f) => existsSync2(path3.join(baseDir, f)));
+}
+function rootDeclarationsAllowed(baseDir, pkg) {
+  return pkg !== void 0 && !isPnpProject(baseDir) && !hasAppLockfile(baseDir);
+}
+function readPackageJsonAt(dir) {
+  try {
+    const parsed = JSON.parse(readFileSync3(path3.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);
 }
@@ -1020,6 +1062,32 @@ function isFile(file) {
     return false;
   }
 }
+function selectGlobalCss(baseDir, configured, candidates, options = {}) {
+  const result = {};
+  if (typeof configured === "string" && configured.trim() !== "") {
+    const file = path3.resolve(baseDir, configured);
+    if (!isFile(file)) result.configuredMissing = configured;
+    else if (options.requireStylesheet && path3.extname(file).toLowerCase() !== ".css") result.configuredRejected = configured;
+    else return { path: file, rel: path3.relative(baseDir, file).split(path3.sep).join("/") };
+  }
+  for (const candidate of candidates) {
+    const file = path3.join(baseDir, candidate);
+    if (isFile(file)) {
+      result.path = file;
+      result.rel = candidate;
+      break;
+    }
+  }
+  return result;
+}
+function globalCssSelectionNote(selection) {
+  if (selection.configuredMissing !== void 0) return ` (globalCss ${selection.configuredMissing} \uC5C6\uC74C)`;
+  if (selection.configuredRejected !== void 0) return ` (globalCss ${selection.configuredRejected}: .css \uD30C\uC77C\uC774 \uC544\uB2D8)`;
+  return "";
+}
+function cssImportViaNote(files) {
+  return files !== void 0 && files.length > 0 ? ` (${files.join(" \xB7 ")} \uC758 import)` : "";
+}
 var ROOT_LAYOUT_FILES = [
   "app/layout.tsx",
   "app/layout.jsx",
@@ -1063,14 +1131,174 @@ function findInstalledPackage(baseDirInput, name) {
   }
 }
 function isPnpProject(baseDirInput) {
+  return pnpProjectRoot(baseDirInput) !== void 0;
+}
+function pnpProjectRoot(baseDirInput) {
   let dir = resolveBaseDir(baseDirInput);
   for (; ; ) {
-    if (isFile(path3.join(dir, ".pnp.cjs")) || isFile(path3.join(dir, ".pnp.js"))) return true;
+    if (isFile(path3.join(dir, ".pnp.cjs")) || isFile(path3.join(dir, ".pnp.js"))) return dir;
+    if (existsSync2(path3.join(dir, ".git"))) return void 0;
     const parent = path3.dirname(dir);
-    if (parent === dir) return false;
+    if (parent === dir) return void 0;
     dir = parent;
   }
 }
+var TAILWIND4_MIN_AXIS_VERSION = "1.4.0";
+var COMPONENT_TAILWIND_CSS_MIN_VERSION = TAILWIND4_MIN_AXIS_VERSION;
+function componentCssResolution(baseDir, pkg, name) {
+  if (pkg === void 0) return { kind: "undeclared" };
+  const own = hasDependency(pkg, name);
+  if (own !== void 0) return { kind: "app", range: own };
+  const pnpRoot = pnpRootOnlyDependency(baseDir, pkg, name);
+  if (pnpRoot !== void 0) return { kind: "pnp-root-only", range: pnpRoot.range };
+  const declared = declaredDependency(baseDir, pkg, name);
+  if (declared?.source !== "root") return { kind: "undeclared" };
+  if (!rootDeclarationsAllowed(baseDir, pkg)) return { kind: "app-lockfile", range: declared.range };
+  const installed = findInstalledPackage(baseDir, name);
+  if (installed === void 0) return { kind: "root-not-installed", range: declared.range };
+  if (isFile(path3.join(installed.dir, "tailwind.css"))) {
+    return installed.version !== void 0 ? { kind: "root-ok", range: declared.range, installedVersion: installed.version } : { kind: "root-ok", range: declared.range };
+  }
+  const installedVersion = installed.version ?? "?";
+  const current = installedVersion !== "?" && (compareExactVersions(installedVersion, COMPONENT_TAILWIND_CSS_MIN_VERSION) ?? -1) >= 0;
+  return current ? { kind: "root-missing-file", range: declared.range, installedVersion } : { kind: "root-old", range: declared.range, installedVersion };
+}
+function componentCssResolvable(resolution) {
+  return resolution.kind === "app" || resolution.kind === "root-ok";
+}
+function tokensCssResolution(baseDir, pkg, name = "@axis-ds/tokens") {
+  const own = pkg !== void 0 ? hasDependency(pkg, name) : void 0;
+  if (own !== void 0) return { kind: "app", range: own };
+  const pnpRoot = pnpRootOnlyDependency(baseDir, pkg, name);
+  if (pnpRoot !== void 0) return { kind: "pnp-root-only", range: pnpRoot.range };
+  if (!isPnpProject(baseDir) && findInstalledPackage(baseDir, name) !== void 0) return { kind: "installed" };
+  const declared = rootDeclarationsAllowed(baseDir, pkg) ? declaredDependency(baseDir, pkg, name) : void 0;
+  return declared?.source === "root" ? { kind: "not-installed", source: "root", range: declared.range } : { kind: "not-installed", source: "none" };
+}
+function outsideCssPackageResolution(baseDir, cssDir, name, file) {
+  if (isPnpProject(baseDir)) return "unknown";
+  const usable = (p) => p !== void 0 && (file === void 0 || isFile(path3.join(p.dir, file)));
+  if (!usable(findInstalledPackage(baseDir, name))) return "unknown";
+  return usable(findInstalledPackage(cssDir, name)) ? "resolved" : "unresolved";
+}
+function findPnpUnpluggedPackages(baseDirInput, name, range) {
+  const root = pnpProjectRoot(baseDirInput);
+  if (root === void 0) return [];
+  const unplugged = path3.join(root, ".yarn", "unplugged");
+  let entries;
+  try {
+    entries = readdirSync(unplugged).sort();
+  } catch {
+    return [];
+  }
+  const found = [];
+  for (const entry of entries) {
+    const pkgDir = path3.join(unplugged, entry, "node_modules", ...name.split("/"));
+    let version;
+    try {
+      const parsed = JSON.parse(readFileSync3(path3.join(pkgDir, "package.json"), "utf8"));
+      version = isPlainObject(parsed) && parsed.name === name ? exactVersionOf(parsed.version) : void 0;
+    } catch {
+      version = void 0;
+    }
+    if (version !== void 0 && versionSatisfiesRange(version, range) === true) found.push(pkgDir);
+  }
+  return found;
+}
+function parsePartialVersion(token) {
+  const m = /^v?(\d+|[xX*])(?:\.(\d+|[xX*]))?(?:\.(\d+|[xX*]))?(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(token.trim());
+  if (!m) return void 0;
+  const num = (s) => s === void 0 || /^[xX*]$/.test(s) ? void 0 : Number(s);
+  const major = num(m[1]);
+  const minor = major === void 0 ? void 0 : num(m[2]);
+  const patch = minor === void 0 ? void 0 : num(m[3]);
+  return { major, minor, patch, pre: patch === void 0 ? void 0 : m[4] };
+}
+function coreOf(v) {
+  return v.replace(/^v/, "").replace(/[-+].*$/, "");
+}
+function intervalsOfToken(token) {
+  const t = token.trim();
+  if (t === "" || t === "*" || /^[xX]$/.test(t)) return [{ preCores: [] }];
+  const op = /^(\^|~>?|>=|<=|>|<|=)?\s*(.+)$/.exec(t);
+  if (!op) return void 0;
+  const p = parsePartialVersion(op[2]);
+  if (!p) return void 0;
+  const full = (maj, min, pat, pre) => `${maj}.${min}.${pat}${pre ? `-${pre}` : ""}`;
+  const preCores = p.pre !== void 0 ? [full(p.major ?? 0, p.minor ?? 0, p.patch ?? 0)] : [];
+  const lower = full(p.major ?? 0, p.minor ?? 0, p.patch ?? 0, p.pre);
+  const kind = op[1] ?? "";
+  if (p.major === void 0) return kind === "" || kind === "=" || kind === ">=" ? [{ preCores }] : void 0;
+  const next = p.minor === void 0 ? full(p.major + 1, 0, 0) : p.patch === void 0 ? full(p.major, p.minor + 1, 0) : void 0;
+  switch (kind) {
+    case "":
+    case "=":
+      return [next === void 0 ? { min: { v: lower, inclusive: true }, max: { v: lower, inclusive: true }, preCores } : { min: { v: lower, inclusive: true }, max: { v: next, inclusive: false, coreOnly: true }, preCores }];
+    case ">=":
+      return [{ min: { v: lower, inclusive: true }, preCores }];
+    case ">":
+      return [next === void 0 ? { min: { v: lower, inclusive: false }, preCores } : { min: { v: next, inclusive: true }, preCores }];
+    case "<":
+      return [{ max: { v: lower, inclusive: false, coreOnly: p.pre === void 0 }, preCores }];
+    case "<=":
+      return [next === void 0 ? { max: { v: lower, inclusive: true }, preCores } : { max: { v: next, inclusive: false, coreOnly: true }, preCores }];
+    case "~":
+    case "~>": {
+      const upper = p.minor === void 0 ? full(p.major + 1, 0, 0) : full(p.major, p.minor + 1, 0);
+      return [{ min: { v: lower, inclusive: true }, max: { v: upper, inclusive: false, coreOnly: true }, preCores }];
+    }
+    case "^": {
+      const upper = p.major > 0 || p.minor === void 0 ? full(p.major + 1, 0, 0) : p.minor > 0 || p.patch === void 0 ? full(0, p.minor + 1, 0) : full(0, 0, p.patch + 1);
+      return [{ min: { v: lower, inclusive: true }, max: { v: upper, inclusive: false, coreOnly: true }, preCores }];
+    }
+  }
+  return void 0;
+}
+function satisfiesInterval(version, iv) {
+  if (iv.min !== void 0) {
+    const c = compareExactVersions(version, iv.min.v);
+    if (c === void 0) return void 0;
+    if (c < 0 || c === 0 && !iv.min.inclusive) return false;
+  }
+  if (iv.max !== void 0) {
+    const c = iv.max.coreOnly ? compareExactVersions(coreOf(version), coreOf(iv.max.v)) : compareExactVersions(version, iv.max.v);
+    if (c === void 0) return void 0;
+    if (c > 0 || c === 0 && !iv.max.inclusive) return false;
+  }
+  return true;
+}
+function versionSatisfiesRange(version, range) {
+  if (exactVersionOf(version) === void 0) return void 0;
+  const alternatives = range.trim().split("||");
+  let unknown = false;
+  for (const alt of alternatives) {
+    const a = alt.trim();
+    let intervals;
+    const hyphen = /^(\S+)\s+-\s+(\S+)$/.exec(a);
+    if (hyphen) {
+      const lo = intervalsOfToken(`>=${hyphen[1]}`);
+      const hi = intervalsOfToken(`<=${hyphen[2]}`);
+      intervals = lo && hi ? [...lo, ...hi] : void 0;
+    } else {
+      const tokens = a === "" ? [""] : a.replace(/(>=|<=|>|<|=|\^|~>?)\s+/g, "$1").split(/\s+/);
+      const parts = tokens.map(intervalsOfToken);
+      intervals = parts.every((x) => x !== void 0) ? parts.flat() : void 0;
+    }
+    if (intervals === void 0) {
+      unknown = true;
+      continue;
+    }
+    const pre = /-/.test(version.replace(/\+.*$/, ""));
+    if (pre && !intervals.some((iv) => iv.preCores.includes(coreOf(version)))) continue;
+    const results = intervals.map((iv) => satisfiesInterval(version, iv));
+    if (results.some((x) => x === void 0)) {
+      unknown = true;
+      continue;
+    }
+    if (results.every((x) => x === true)) return true;
+  }
+  return unknown ? void 0 : false;
+}
 function compareExactVersions(a, b) {
   const parse = (v) => {
     const m = /^v?(\d+)\.(\d+)\.(\d+)(-[0-9A-Za-z.-]+)?/.exec(v.trim());
@@ -1084,11 +1312,14 @@ function compareExactVersions(a, b) {
 }
 
 // ../axis-registry-core/src/template/tailwind-core.ts
-import { existsSync as existsSync3, lstatSync, readdirSync, readFileSync as readFileSync4, realpathSync as realpathSync2 } from "fs";
+import { existsSync as existsSync3, lstatSync, readdirSync as readdirSync2, readFileSync as readFileSync4, realpathSync as realpathSync2, statSync as statSync2 } from "fs";
 import { basename, dirname as dirname2, extname, isAbsolute, join as join2, relative, resolve, sep } from "path";
 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);
 }
@@ -1209,6 +1440,157 @@ var TOKENS_CSS_IMPORT = /@import\s+(?:url\(\s*)?["'](@axis-ds\/tokens\/css(?:\/s
 function findTokensCssImport(css) {
   return TOKENS_CSS_IMPORT.exec(stripCssComments(css))?.[1];
 }
+var CSS_IMPORT_DEPTH_LIMIT = 32;
+var CSS_IMPORT_CYCLE_DEPTH_LIMIT = 100;
+var RELATIVE_CSS_IMPORT = /@import\s*(?:"(\.{1,2}\/[^"\n]*)"|'(\.{1,2}\/[^'\n]*)')(?=([^;{}]*))/g;
+function isConditionalCssImport(tail) {
+  return tail !== void 0 && tail.trim() !== "";
+}
+function resolveRelativeCssImport(fromDir, spec) {
+  if (spec.endsWith("/")) return void 0;
+  const target = resolve(fromDir, spec);
+  if (regularFile(target)) return target;
+  if (regularFile(`${target}.css`)) return `${target}.css`;
+  return void 0;
+}
+var CSS_IMPORT_SPEC = /@import\s+(?:url\(\s*)?(["'])([^"'\n]+)\1/g;
+function isPackageCssSpec(spec) {
+  return !spec.startsWith("./") && !spec.startsWith("../") && !spec.startsWith("/") && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(spec);
+}
+function cssImportCycleIssue(files) {
+  if (files.length === 1) return `${files[0]} \uC774 \uC790\uAE30 \uC790\uC2E0\uC744 @import \uD574 \uBE4C\uB4DC\uAC00 \uC21C\uD658\uC73C\uB85C \uC2E4\uD328\uD569\uB2C8\uB2E4 \u2192 \uC21C\uD658\uD558\uB294 @import \uB97C \uC5C6\uC560\uC138\uC694`;
+  return `${files.join(" \xB7 ")} \uC774 \uC11C\uB85C @import \uD574 \uBE4C\uB4DC\uAC00 \uC21C\uD658\uC73C\uB85C \uC2E4\uD328\uD569\uB2C8\uB2E4 \u2192 \uC21C\uD658\uD558\uB294 @import \uB97C \uC5C6\uC560\uC138\uC694`;
+}
+function findImportCycle(start, edges) {
+  const state = /* @__PURE__ */ new Map();
+  const trail = [start];
+  const stack = [{ node: start, next: 0 }];
+  state.set(start, "open");
+  while (stack.length > 0) {
+    const top = stack[stack.length - 1];
+    const out = edges.get(top.node) ?? [];
+    if (top.next >= out.length) {
+      state.set(top.node, "done");
+      stack.pop();
+      trail.pop();
+      continue;
+    }
+    const to = out[top.next++];
+    const s = state.get(to);
+    if (s === "open") return trail.slice(trail.indexOf(to));
+    if (s === "done") continue;
+    state.set(to, "open");
+    trail.push(to);
+    stack.push({ node: to, next: 0 });
+  }
+  return void 0;
+}
+function regularFile(file) {
+  try {
+    return statSync2(file).isFile();
+  } catch {
+    return false;
+  }
+}
+function expandGlobalCss(baseDirInput, entryPath, entryRel, entryCssDir) {
+  const baseDir = resolveBaseDir(baseDirInput);
+  const entry = readFileSync4(entryPath, "utf8");
+  let entryReal = entryPath;
+  try {
+    entryReal = realpathSync2(entryPath);
+  } catch {
+  }
+  const raws = /* @__PURE__ */ new Map([[entryReal, entry]]);
+  const files = [];
+  const packageLines = [];
+  const evidenceWalk = walkRelativeCssImports(baseDir, entryReal, raws, CSS_IMPORT_DEPTH_LIMIT, false);
+  const relOfReal = /* @__PURE__ */ new Map([[entryReal, entryRel]]);
+  for (const node of evidenceWalk.order) {
+    const isEntry = node.real === entryReal;
+    const rel2 = isEntry ? entryRel : node.rel;
+    const css = stripCssComments(raws.get(node.real) ?? "");
+    const file = { rel: rel2, path: node.real, css, depth: node.depth };
+    const cssDir = isEntry ? entryCssDir : dirname2(node.real);
+    if (cssDir !== void 0) file.cssDir = cssDir;
+    files.push(file);
+    relOfReal.set(node.real, rel2);
+    for (const m of css.matchAll(CSS_IMPORT_SPEC)) {
+      if (!isPackageCssSpec(m[2])) continue;
+      const line = { spec: m[2], file: rel2 };
+      if (cssDir !== void 0) line.cssDir = cssDir;
+      packageLines.push(line);
+    }
+  }
+  const cycleWalk = walkRelativeCssImports(baseDir, entryReal, raws, CSS_IMPORT_CYCLE_DEPTH_LIMIT, true);
+  const cycle = findImportCycle(entryReal, cycleWalk.edges);
+  if (cycle !== void 0) {
+    for (const node of cycleWalk.order) if (!relOfReal.has(node.real)) relOfReal.set(node.real, node.rel);
+    const head = files[0];
+    return {
+      entry,
+      evidence: entry,
+      files: [head],
+      packageLines: packageLines.filter((l) => l.file === head.rel),
+      cycle: cycle.map((p) => relOfReal.get(p) ?? p)
+    };
+  }
+  const evidence = files.length === 1 ? entry : files.map((f) => f.css).join("\n");
+  return { entry, evidence, files, packageLines };
+}
+function walkRelativeCssImports(baseDir, entryReal, raws, limit, includeConditional) {
+  const order = [];
+  const edges = /* @__PURE__ */ new Map();
+  const visited = /* @__PURE__ */ new Set([entryReal]);
+  const queue = [{ real: entryReal, rel: "", depth: 0 }];
+  while (queue.length > 0) {
+    const cur = queue.shift();
+    order.push(cur);
+    const css = stripCssComments(raws.get(cur.real) ?? "");
+    const out = [];
+    edges.set(cur.real, out);
+    for (const m of css.matchAll(RELATIVE_CSS_IMPORT)) {
+      if (!includeConditional && isConditionalCssImport(m[3])) continue;
+      const target = resolveRelativeCssImport(dirname2(cur.real), m[1] ?? m[2]);
+      if (target === void 0) continue;
+      let real;
+      try {
+        real = realpathSync2(target);
+      } catch {
+        continue;
+      }
+      if (visited.has(real)) {
+        out.push(real);
+        continue;
+      }
+      if (cur.depth >= limit) continue;
+      const rel2 = relative(baseDir, real);
+      if (rel2 === "" || rel2 === ".." || rel2.startsWith(`..${sep}`) || isAbsolute(rel2)) continue;
+      if (!raws.has(real)) {
+        try {
+          raws.set(real, readFileSync4(real, "utf8"));
+        } catch {
+          continue;
+        }
+      }
+      visited.add(real);
+      out.push(real);
+      queue.push({ real, rel: rel2.split(sep).join("/"), depth: cur.depth + 1 });
+    }
+  }
+  return { order, edges };
+}
+function evidenceOrigin(expanded, test) {
+  return expanded.files.find((f) => test(f.css));
+}
+function packageLineCssDir(expanded, spec) {
+  const line = expanded.packageLines.find((l) => l.spec === spec);
+  return line !== void 0 ? line.cssDir : expanded.files[0]?.cssDir;
+}
+function viaFiles(origins) {
+  const out = [];
+  for (const o of origins) if (o !== void 0 && o.depth > 0 && !out.includes(o.rel)) out.push(o.rel);
+  return out;
+}
 var TOKENS_CSS_JS_IMPORT = /(?:\bimport\s+|\bfrom\s+|\brequire\s*\(\s*)(["'])(@axis-ds\/tokens\/css(?:\/shadcn|\/tailwind4)?)\1/;
 var AXIS_VARIABLE_DEFINITION = /(?<![\w-])--axis-[\w-]+\s*:/;
 function findLayoutTokensCssImport(baseDirInput) {
@@ -1227,45 +1609,92 @@ function findLayoutTokensCssImport(baseDirInput) {
   }
   return void 0;
 }
+var TOKENS_PACKAGE_NAME = "@axis-ds/tokens";
+function outsideCssDir(selection) {
+  if (selection.path === void 0 || selection.rel === void 0) return void 0;
+  const outside = selection.rel === ".." || selection.rel.startsWith("../") || isAbsolute(selection.rel);
+  return outside ? dirname2(selection.path) : void 0;
+}
+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}`);
+  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) {
+  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`;
+  if (r.kind === "not-installed") {
+    return `${head} ${TOKENS_PACKAGE_NAME} \uAC00 \uC124\uCE58\uB418\uC9C0 \uC54A\uC544 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uC124\uCE58(${tokensInstallPhrase(baseDir)})`;
+  }
+  if (cssDir !== void 0 && outsideCssPackageResolution(baseDir, cssDir, TOKENS_PACKAGE_NAME) === "unresolved") {
+    return outsideCssUnresolvedIssue(spec, TOKENS_PACKAGE_NAME);
+  }
+  return void 0;
+}
 function checkGlobalsCss(baseDirInput) {
   const baseDir = resolveBaseDir(baseDirInput);
-  for (const candidate of TAILWIND_CSS_CANDIDATES) {
-    const file = join2(baseDir, candidate);
-    if (!existsSync3(file)) continue;
-    const content = readFileSync4(file, "utf8");
-    const css = stripCssComments(content);
-    const imported = findTokensCssImport(content);
-    let pass;
-    if (imported !== void 0) pass = `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (${imported} import)`;
-    else if (AXIS_VARIABLE_DEFINITION.test(css)) pass = `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218(--axis-*)\uAC00 \uC815\uC758\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4`;
-    else {
-      const layout = findLayoutTokensCssImport(baseDir);
-      if (layout) pass = `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (${layout.file}\uC758 ${layout.spec} import)`;
-    }
-    if (pass !== void 0) {
-      const tailwind = detectTailwind(baseDir, readPackageJson(baseDir));
-      const tailwind4 = tailwind.major !== void 0 && tailwind.major >= 4;
-      if (!tailwind4 && findCreateNextAppDefaults(content).some((d) => d.includes("font-family: Arial"))) {
-        return {
-          name: "globals.css",
-          severity: "warn",
-          message: `${pass}. \uB2E4\uB9CC create-next-app \uAE30\uBCF8 body font-family: Arial \uC774 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4 \u2192 \uC9C0\uC6B0\uC138\uC694(AXIS \uAE00\uAF34 \uB300\uC2E0 Arial \uC774 \uC801\uC6A9\uB428)`
-        };
-      }
-      return { name: "globals.css", severity: "pass", message: pass };
-    }
-    if (css.includes("--background") && css.includes("--primary")) {
+  const selection = selectCheckGlobalCss(baseDir);
+  const note = globalCssSelectionNote(selection);
+  if (selection.path !== void 0 && selection.rel !== void 0) {
+    const candidate = selection.rel;
+    const expanded = expandGlobalCss(baseDir, selection.path, candidate, outsideCssDir(selection));
+    const judged = judgeGlobalsCss(baseDir, selection, candidate, expanded);
+    if (expanded.cycle !== void 0) {
+      return { name: "globals.css", severity: "warn", message: `${judged.message} / ${cssImportCycleIssue(expanded.cycle)}${note}` };
+    }
+    return { name: "globals.css", severity: judged.severity, message: `${judged.message}${note}` };
+  }
+  return { name: "globals.css", severity: "fail", message: `globals.css \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4${note}` };
+}
+function judgeGlobalsCss(baseDir, selection, candidate, expanded) {
+  const content = expanded.entry;
+  const css = stripCssComments(content);
+  const imported = findTokensCssImport(expanded.evidence);
+  const pkg = readPackageJson(baseDir);
+  let pass;
+  let unresolved;
+  let via = "";
+  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));
+    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))) {
+    via = cssImportViaNote(viaFiles([evidenceOrigin(expanded, (f) => AXIS_VARIABLE_DEFINITION.test(f))]));
+    pass = `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218(--axis-*)\uAC00 \uC815\uC758\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4`;
+  } else {
+    const layout = findLayoutTokensCssImport(baseDir);
+    if (layout) {
+      const issue = tokensCssUnresolvedIssue(baseDir, pkg, layout.spec);
+      if (issue !== void 0) unresolved = `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC5C6\uACE0 ${layout.file}\uC758 ${issue}`;
+      else pass = `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (${layout.file}\uC758 ${layout.spec} import)`;
+    }
+  }
+  const head = pass ?? unresolved;
+  if (head !== void 0) {
+    const tailwind = detectTailwind(baseDir, pkg);
+    const tailwind4 = tailwind.major !== void 0 && tailwind.major >= 4;
+    if (!tailwind4 && findCreateNextAppDefaults(content).some((d) => d.includes("font-family: Arial"))) {
       return {
-        name: "globals.css",
         severity: "warn",
-        message: `${candidate}\uC5D0 \uC790\uCCB4 CSS \uBCC0\uC218(--background \xB7 --primary)\uB9CC \uC788\uACE0 AXIS \uD1A0\uD070\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 @axis-ds/tokens CSS \uB97C import \uD558\uC138\uC694`
+        message: `${head}. \uB2E4\uB9CC create-next-app \uAE30\uBCF8 body font-family: Arial \uC774 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4 \u2192 \uC9C0\uC6B0\uC138\uC694(AXIS \uAE00\uAF34 \uB300\uC2E0 Arial \uC774 \uC801\uC6A9\uB428)${via}`
       };
     }
-    return { name: "globals.css", severity: "warn", message: `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4` };
+    return { severity: pass !== void 0 ? "pass" : "warn", message: `${head}${via}` };
+  }
+  if (css.includes("--background") && css.includes("--primary")) {
+    return {
+      severity: "warn",
+      message: `${candidate}\uC5D0 \uC790\uCCB4 CSS \uBCC0\uC218(--background \xB7 --primary)\uB9CC \uC788\uACE0 AXIS \uD1A0\uD070\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 @axis-ds/tokens CSS \uB97C import \uD558\uC138\uC694`
+    };
   }
-  return { name: "globals.css", severity: "fail", message: "globals.css \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4" };
+  return { severity: "warn", message: `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4` };
 }
-var TAILWIND4_MIN_AXIS_VERSION = "1.4.0";
 var TAILWIND4_AXIS_PACKAGES = ["@axis-ds/tokens", "@axis-ds/ui-react", "@axis-ds/agentic-ui"];
 function lowerOf(token) {
   const v = versionParts(token);
@@ -1463,7 +1892,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;
@@ -1472,7 +1901,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 };
@@ -1481,6 +1914,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";
@@ -1493,66 +1927,134 @@ function readPackageJson(baseDir) {
     return void 0;
   }
 }
-function tailwind4Issues(css, pkg, versions, baseDir) {
+function tailwind4Issues(input, pkg, versions, baseDir) {
+  const { entry, evidence } = input;
+  const cssDirOf = input.cssDirOf ?? (() => void 0);
   const issues = [];
-  const hasEntry = hasTokensTailwind4Import(css);
+  const tailwindDir = cssDirOf("tailwindcss");
+  if (tailwindDir !== void 0 && outsideCssPackageResolution(baseDir, tailwindDir, "tailwindcss") === "unresolved") {
+    issues.push(outsideCssUnresolvedIssue("tailwindcss", "tailwindcss"));
+  }
+  const hasEntry = hasTokensTailwind4Import(evidence);
   if (!hasEntry) issues.push(`AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 ${TOKENS_TAILWIND4_IMPORT_LINE}`);
-  const missing = TAILWIND4_COMPONENT_PACKAGES.filter(
-    (name) => declaredRange(baseDir, pkg, name) !== void 0 && !hasComponentTailwindImport(css, name) && !hasComponentSource(css, name)
-  );
+  const resolutions = new Map(TAILWIND4_COMPONENT_PACKAGES.map((name) => [name, componentCssResolution(baseDir, pkg, name)]));
+  const missing = [];
+  const unresolvedMissing = [];
+  for (const name of TAILWIND4_COMPONENT_PACKAGES) {
+    const r = resolutions.get(name);
+    if (r.kind === "undeclared" || r.kind === "app-lockfile") continue;
+    if (hasComponentTailwindImport(evidence, name) || hasComponentSource(evidence, name)) continue;
+    if (componentCssResolvable(r)) missing.push(name);
+    else unresolvedMissing.push(componentCssMissingIssue(baseDir, name, r));
+  }
   if (missing.length > 0) {
     issues.push(`\uCEF4\uD3EC\uB10C\uD2B8 \uC2A4\uCE94 \uACBD\uB85C(tailwind.css)\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 ${missing.map(componentTailwindImportLine).join(" ")}`);
   }
+  issues.push(...unresolvedMissing);
   if (hasEntry) {
-    const defaults = findCreateNextAppDefaults(css);
+    const defaults = findCreateNextAppDefaults(entry);
     if (defaults.length > 0) issues.push(`create-next-app \uAE30\uBCF8 \uC815\uC758\uAC00 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4(${defaults.join(" \xB7 ")}) \u2192 \uC9C0\uC6B0\uC138\uC694`);
     if (versions.some((v) => v.name === TAILWIND4_AXIS_PACKAGES[0])) {
       issues.push(`AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC788\uC9C0\uB9CC ${TAILWIND4_AXIS_PACKAGES[0]} \uBC84\uC804 \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4`);
     }
   }
   for (const name of TAILWIND4_COMPONENT_PACKAGES) {
-    if (hasComponentTailwindImport(css, name) && 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`);
-    }
+    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`);
   }
   return issues;
 }
+function componentInstallPhrase(baseDir, name, range) {
+  const g = dependencyInstallGuide(baseDir, name, range);
+  return g.kind === "install-at-root" ? `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uC11C ${g.installCommand}` : g.installCommand;
+}
+function componentCssMissingIssue(baseDir, name, r) {
+  const line = componentTailwindImportLine(name);
+  switch (r.kind) {
+    case "pnp-root-only":
+      return `${name} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD55C \uB4A4 ${line}`;
+    case "root-not-installed":
+      return `${name} \uAC00 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC120\uC5B8\uB410\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4 \u2192 \uC124\uCE58(${componentInstallPhrase(baseDir, name, r.range)}) \uB4A4 ${line}`;
+    case "root-old":
+      return `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC120\uC5B8\uB41C ${name} \uC758 \uC124\uCE58\uBCF8(${r.installedVersion === "?" ? "\uBC84\uC804 \uBAA8\uB984" : r.installedVersion})\uC5D0 tailwind.css \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4(${TAILWIND4_MIN_AXIS_VERSION} \uBD80\uD130 \uC81C\uACF5) \u2192 ${TAILWIND4_MIN_AXIS_VERSION} \uC774\uC0C1\uC73C\uB85C \uC62C\uB9B0 \uB4A4 ${line}`;
+    case "root-missing-file":
+      return `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC120\uC5B8\uB41C ${name} \uC758 \uC124\uCE58\uBCF8(${r.installedVersion})\uC5D0 tailwind.css \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4(\uC124\uCE58\uAC00 \uC190\uC0C1\uB410\uC744 \uC218 \uC788\uC74C) \u2192 \uB2E4\uC2DC \uC124\uCE58(${componentInstallPhrase(baseDir, name, r.range)}) \uB4A4 ${line}`;
+    default:
+      return line;
+  }
+}
+function componentCssPresentIssue(baseDir, name, r) {
+  const head = `${name}/tailwind.css import \uAC00 \uC788\uC9C0\uB9CC`;
+  switch (r.kind) {
+    case "pnp-root-only":
+      return `${head} ${name} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694`;
+    case "root-not-installed":
+      return `${head} ${name} \uAC00 \uC124\uCE58\uB418\uC9C0 \uC54A\uC544 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uC124\uCE58(${componentInstallPhrase(baseDir, name, r.range)})`;
+    case "root-missing-file":
+      return `${head} ${name} \uC124\uCE58\uBCF8(${r.installedVersion})\uC5D0 tailwind.css \uAC00 \uC5C6\uC5B4 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uB2E4\uC2DC \uC124\uCE58(${componentInstallPhrase(baseDir, name, r.range)})`;
+    case "root-old":
+      return r.installedVersion === "?" ? `${head} ${name} \uC124\uCE58\uBCF8(\uBC84\uC804 \uBAA8\uB984)\uC5D0 tailwind.css \uAC00 \uC5C6\uC5B4 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 ${TAILWIND4_MIN_AXIS_VERSION} \uC774\uC0C1\uC73C\uB85C \uC62C\uB9AC\uC138\uC694` : void 0;
+    default:
+      return void 0;
+  }
+}
 function checkTailwindSetup(baseDirInput) {
   const baseDir = resolveBaseDir(baseDirInput);
   const pkg = readPackageJson(baseDir);
   const tailwind = detectTailwind(baseDir, pkg);
   if (tailwind.major !== void 0 && tailwind.major >= 4) {
     const label = `Tailwind ${tailwind.major}`;
-    for (const candidate of TAILWIND_CSS_CANDIDATES) {
-      const file = join2(baseDir, candidate);
-      if (!existsSync3(file)) continue;
-      const css = readFileSync4(file, "utf8");
-      if (!hasTailwindImport(css)) {
+    const selection = selectCheckGlobalCss(baseDir);
+    const note = globalCssSelectionNote(selection);
+    if (selection.path !== void 0 && selection.rel !== void 0) {
+      const candidate = selection.rel;
+      const expanded = expandGlobalCss(baseDir, selection.path, candidate, outsideCssDir(selection));
+      if (!hasTailwindImport(expanded.evidence)) {
         return {
           name: "tailwind.config",
           severity: "warn",
-          message: `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4`
+          message: `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4${note}`
         };
       }
+      const via = cssImportViaNote(
+        viaFiles([
+          evidenceOrigin(expanded, hasTailwindImport),
+          evidenceOrigin(expanded, hasTokensTailwind4Import),
+          ...TAILWIND4_COMPONENT_PACKAGES.flatMap((name) => [
+            evidenceOrigin(expanded, (f) => hasComponentTailwindImport(f, name)),
+            evidenceOrigin(expanded, (f) => hasComponentSource(f, name))
+          ])
+        ])
+      );
       const versions = axisPackagesBelowTailwind4(pkg, baseDir);
-      const issues = tailwind4Issues(css, pkg, versions, baseDir);
+      const issues = tailwind4Issues(
+        { entry: expanded.entry, evidence: expanded.evidence, cssDirOf: (spec) => packageLineCssDir(expanded, spec) },
+        pkg,
+        versions,
+        baseDir
+      );
       if (issues.length > 0) {
         return {
           name: "tailwind.config",
           severity: "warn",
-          message: `${label}: ${candidate}\uC5D0 ${issues.join(" / ")}${tailwind4VersionNote(versions)}`
+          message: `${label}: ${candidate}\uC5D0 ${issues.join(" / ")}${tailwind4VersionNote(versions)}${via}${note}`
         };
       }
       return {
         name: "tailwind.config",
         severity: "pass",
-        message: `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uC640 AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC788\uC2B5\uB2C8\uB2E4`
+        message: `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uC640 AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC788\uC2B5\uB2C8\uB2E4${via}${note}`
       };
     }
     return {
       name: "tailwind.config",
       severity: "warn",
-      message: `${label}: @import "tailwindcss" \uB97C \uD655\uC778\uD560 CSS \uD30C\uC77C\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4`
+      message: `${label}: @import "tailwindcss" \uB97C \uD655\uC778\uD560 CSS \uD30C\uC77C\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4${note}`
     };
   }
   for (const file of TAILWIND_CONFIG_FILES) {
@@ -1562,7 +2064,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 {
@@ -1591,31 +2100,45 @@ function readAxisConfigLike(baseDir) {
     return void 0;
   }
 }
-function contentGlobToRegExp(glob) {
+function selectCheckGlobalCss(baseDir) {
+  return selectGlobalCss(baseDir, readAxisConfigLike(baseDir)?.globalCss, TAILWIND_CSS_CANDIDATES, { requireStylesheet: true });
+}
+function contentGlobToRegExp(glob, opts = {}) {
+  const noDot = opts.noDot === true;
   const g = glob.trim().replace(/^\.\//, "");
+  const lead = (i) => noDot && (i === 0 || g[i - 1] === "/") ? "(?!\\.)" : "";
   let re = "";
   for (let i = 0; i < g.length; i++) {
     const c = g[i];
     if (c === "*") {
       if (g[i + 1] === "*") {
         const slash = g[i + 2] === "/";
-        re += slash ? "(?:.*/)?" : ".*";
+        if (noDot) re += slash ? `(?:${lead(i)}[^/]*/(?:(?!\\.)[^/]*/)*)?` : `${lead(i)}[^/]*(?:/(?!\\.)[^/]*)*`;
+        else re += slash ? "(?:.*/)?" : ".*";
         i += slash ? 2 : 1;
-      } else re += "[^/]*";
-    } else if (c === "?") re += "[^/]";
+      } else re += `${lead(i)}[^/]*`;
+    } else if (c === "?") re += `${lead(i)}[^/]`;
     else if (c === "{") {
       const end = g.indexOf("}", i);
       if (end === -1) {
         re += "\\{";
         continue;
       }
-      re += `(?:${g.slice(i + 1, end).split(",").map((part) => part.replace(/[.+^$()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*")).join("|")})`;
+      const atStart = lead(i) !== "";
+      re += `(?:${g.slice(i + 1, end).split(",").map((part) => {
+        const body = part.replace(/[.+^$()|[\]\\]/g, "\\$&");
+        if (!noDot) return body.replace(/\*/g, "[^/]*");
+        return body.replace(
+          /(\/)?\*/g,
+          (_m, slash, off) => slash !== void 0 || off === 0 && atStart ? `${slash ?? ""}(?!\\.)[^/]*` : "[^/]*"
+        );
+      }).join("|")})`;
       i = end;
     } else if (c === "[") {
       const end = g.indexOf("]", i);
       if (end === -1) re += "\\[";
       else {
-        re += g.slice(i, end + 1);
+        re += lead(i) + g.slice(i, end + 1);
         i = end;
       }
     } else re += c.replace(/[.+^$()|\\]/g, "\\$&");
@@ -1684,22 +2207,46 @@ function realpathPosix(p) {
   }
   return void 0;
 }
-function contentGlobBranchCovers(glob, sample, baseDir) {
+function contentGlobBranchCovers(glob, sample, baseDir, noDot) {
   if (isAbsoluteGlob(glob)) {
-    const re = contentGlobToRegExp(glob.trim().replace(/\\/g, "/"));
+    const re = contentGlobToRegExp(glob.trim().replace(/\\/g, "/"), { noDot });
     const absSample = resolve(baseDir, sample);
     if (re.test(absSample.split(sep).join("/"))) return true;
     const real = realpathPosix(absSample);
     return real !== void 0 && re.test(real);
   }
-  return leadingParentSegments(glob) === leadingParentSegments(sample) && contentGlobToRegExp(glob).test(sample);
+  return leadingParentSegments(glob) === leadingParentSegments(sample) && contentGlobToRegExp(glob, { noDot }).test(sample);
 }
-function contentGlobCovers(glob, sample, baseDirInput) {
+function contentGlobCovers(glob, sample, baseDirInput, opts = {}) {
   const baseDir = resolveBaseDir(baseDirInput);
   const branches = expandBraces(glob.trim()) ?? [glob];
-  return branches.some((b) => contentGlobBranchCovers(b, sample, baseDir));
+  return branches.some((b) => contentGlobBranchCovers(b, sample, baseDir, opts.noDot === true));
+}
+var CONTENT_PARENT_PATH_NOTE = "\uC0C1\uC704 \uACBD\uB85C\uB294 Tailwind 3 \uAC00 \uBE4C\uB4DC\uB97C \uC2E4\uD589\uD55C \uB514\uB809\uD130\uB9AC \uAE30\uC900\uC73C\uB85C \uD480\uB9BD\uB2C8\uB2E4. \uBAA8\uB178\uB808\uD3EC \uB8E8\uD2B8 \uB4F1 \uC571 \uB514\uB809\uD130\uB9AC \uBC16\uC5D0\uC11C \uBE4C\uB4DC\uD558\uBA74 content: { relative: true, files: [...] } \uB85C \uC124\uC815 \uD30C\uC77C \uAE30\uC900\uC73C\uB85C \uBC14\uAFB8\uC138\uC694";
+function contentPnpNote(names, unplugged = []) {
+  const list = [...new Set(typeof names === "string" ? [names] : names)];
+  const dyn = list.map((n) => `path.join(path.dirname(require.resolve("${n}")), "..", "dist/**/*.{js,mjs}")`).join(", ");
+  const needsSetup = list.filter((n) => !unplugged.includes(n));
+  const meta = needsSetup.map((n) => `"${n}": { "unplugged": true }`).join(", ");
+  const setup = needsSetup.length > 0 ? ` \uC815\uC801 \uACBD\uB85C\uB97C \uC4F0\uB824\uBA74 package.json \uC758 dependenciesMeta \uC5D0 ${meta} \uB97C \uB450\uACE0 yarn install \uB4A4 .yarn/unplugged \uACBD\uB85C\uB97C \uB123\uC73C\uC138\uC694` : "";
+  return `Plug'n'Play \uC5D0\uB294 node_modules \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. content \uC5D0 ${dyn} \uCC98\uB7FC \uC2E4\uC81C \uC704\uCE58\uB97C \uB123\uC73C\uC138\uC694(\uC815\uC801\uC73C\uB85C \uD655\uC778\uD560 \uC218 \uC5C6\uC5B4 WARN \uC73C\uB85C \uB0A8\uC2B5\uB2C8\uB2E4).${setup}`;
+}
+function contentPnpNoteTargets(targets) {
+  return targets.filter((t) => t.pnp !== void 0 && t.pnp.state !== "rootOnly").map((t) => t.label);
+}
+function contentPnpNoteFor(targets) {
+  const names = contentPnpNoteTargets(targets);
+  if (names.length === 0) return void 0;
+  const unplugged = targets.filter((t) => t.pnp?.state === "unplugged").map((t) => t.label);
+  return contentPnpNote(names, unplugged);
+}
+var CONTENT_PNP_ROOT_ONLY_ACTION = "\uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694";
+var CONTENT_PNP_NO_NODE_MODULES = "Plug'n'Play \uB77C node_modules \uACBD\uB85C\uAC00 \uC5C6\uC74C";
+function contentTargetText(t) {
+  if (t.pnp?.state === "noNodeModules") return `${t.label}(${CONTENT_PNP_NO_NODE_MODULES})`;
+  if (t.pnp?.state === "rootOnly") return `${t.label} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 ${CONTENT_PNP_ROOT_ONLY_ACTION}`;
+  return `${t.label} \u2192 "${t.suggest}"${t.note === void 0 ? "" : ` (${t.note})`}`;
 }
-var CONTENT_PARENT_PATH_NOTE = "\uC0C1\uC704 \uACBD\uB85C\uB294 Tailwind 3 \uAC00 \uBE4C\uB4DC\uB97C \uC2E4\uD589\uD55C \uB514\uB809\uD130\uB9AC \uAE30\uC900\uC73C\uB85C \uD480\uB824\uC694. \uBAA8\uB178\uB808\uD3EC \uB8E8\uD2B8 \uB4F1 \uC571 \uB514\uB809\uD130\uB9AC \uBC16\uC5D0\uC11C \uBE4C\uB4DC\uD558\uBA74 content: { relative: true, files: [...] } \uB85C \uC124\uC815 \uD30C\uC77C \uAE30\uC900\uC73C\uB85C \uBC14\uAFB8\uC138\uC694";
 function relDirOf(baseDir, dir) {
   const rel2 = relative(baseDir, dir);
   return rel2 === "" || isAbsolute(rel2) ? void 0 : rel2.split(sep).join("/");
@@ -1719,8 +2266,26 @@ function packageVersion(dir) {
     return void 0;
   }
 }
-function packageContentTarget(baseDir, name) {
-  const found = isPnpProject(baseDir) ? void 0 : findInstalledPackage(baseDir, name);
+function pnpPackageContentTarget(baseDir, name, pkg) {
+  const legacySample = `node_modules/${name}/dist/index.js`;
+  const none = { sample: "", suggest: "", alternates: [], others: [] };
+  if (pnpRootOnlyDependency(baseDir, pkg, name) !== void 0) return { ...none, pnp: { state: "rootOnly", legacySample } };
+  const range = pkg === void 0 ? void 0 : hasDependency(pkg, name);
+  const rels = (range === void 0 ? [] : findPnpUnpluggedPackages(baseDir, name, range)).map((d) => relDirOf(baseDir, d)).filter((r) => r !== void 0);
+  const root = pnpProjectRoot(baseDir);
+  if (rels.length === 0 || root === void 0) return { ...none, pnp: { state: "noNodeModules", legacySample } };
+  const rootRel = relDirOf(baseDir, root);
+  return {
+    sample: `${rels[0]}/dist/index.js`,
+    suggest: `${rootRel === void 0 ? "." : rootRel}/.yarn/unplugged/*/node_modules/${name}/dist/**/*.{js,mjs}`,
+    alternates: rels.slice(1).map((r) => `${r}/dist/index.js`),
+    others: [],
+    pnp: { state: "unplugged", legacySample }
+  };
+}
+function packageContentTarget(baseDir, name, pkg) {
+  if (isPnpProject(baseDir)) return pnpPackageContentTarget(baseDir, name, pkg);
+  const found = findInstalledPackage(baseDir, name);
   const relDir = (found === void 0 ? void 0 : relDirOf(baseDir, found.dir)) ?? `node_modules/${name}`;
   const alternates = [];
   const others = [];
@@ -1741,7 +2306,7 @@ function packageContentTarget(baseDir, name) {
           const versions = theirs === void 0 || ours === void 0 ? "" : theirs === ours ? `(\uBC84\uC804\uC740 ${ours} \uB85C \uAC19\uC74C)` : `(${theirs}, \uC571 ${ours})`;
           others.push({
             sample: `${rel2}/dist/index.js`,
-            note: `\uC0C1\uC704 \uACBD\uB85C ${rel2} \uB294 \uC571\uC774 \uC4F0\uB294 \uC124\uCE58\uBCF8\uACFC \uB2E4\uB978 \uC124\uCE58\uBCF8${versions}\uC774\uB77C \uB36E\uC74C\uC73C\uB85C \uBCF4\uC9C0 \uC54A\uC544\uC694`
+            note: `\uC0C1\uC704 \uACBD\uB85C ${rel2} \uB294 \uC571\uC774 \uC4F0\uB294 \uC124\uCE58\uBCF8\uACFC \uB2E4\uB978 \uC124\uCE58\uBCF8${versions}\uC774\uB77C \uB36E\uC74C\uC73C\uB85C \uBCF4\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`
           });
         }
       }
@@ -1818,7 +2383,7 @@ function inspectTailwindContent(baseDirInput) {
   }
   for (const name of TAILWIND4_COMPONENT_PACKAGES) {
     if (declaredRange(baseDir, pkg, name) !== void 0) {
-      targets.push({ label: name, ...packageContentTarget(baseDir, name) });
+      targets.push({ label: name, ...packageContentTarget(baseDir, name, pkg) });
     }
   }
   if (targets.length === 0) return null;
@@ -1828,11 +2393,14 @@ function inspectTailwindContent(baseDirInput) {
     configFile,
     unreadable: read === void 0,
     dynamic: read?.dynamic ?? false,
-    targets: targets.map(({ alternates = [], others = [], ...t }) => {
+    targets: targets.map(({ alternates = [], others = [], pnp, ...t }) => {
       const covers = (sample) => globs.some((g) => contentGlobCovers(g, sample, baseDir));
-      const covered = [t.sample, ...alternates].some(covers);
+      const samples = pnp !== void 0 && pnp.state !== "unplugged" ? [] : [t.sample, ...alternates];
+      const coversSample = pnp?.state === "unplugged" ? (sample) => globs.some((g) => contentGlobCovers(g, sample, baseDir, { noDot: true })) : covers;
+      const covered = samples.some(coversSample);
       const note = covered ? void 0 : others.find((o) => covers(o.sample))?.note;
-      return note === void 0 ? { ...t, covered } : { ...t, covered, note };
+      const base = note === void 0 ? { ...t, covered } : { ...t, covered, note };
+      return pnp === void 0 ? base : { ...base, pnp: { state: pnp.state, legacyCovered: covers(pnp.legacySample) } };
     })
   };
 }
@@ -1847,19 +2415,30 @@ function checkTailwindContent(baseDir) {
       message: `${r.configFile}\uC758 content \uAC00 ${r.targets.map((t) => t.label).join(" \xB7 ")} \uB97C \uB36E\uC2B5\uB2C8\uB2E4`
     };
   }
-  const list = missing.map((t) => `${t.label} \u2192 "${t.suggest}"${t.note === void 0 ? "" : ` (${t.note})`}`).join(" \xB7 ");
+  const list = missing.map(contentTargetText).join(" \xB7 ");
   const note = missing.some((t) => t.suggest.startsWith("../")) ? ` (${CONTENT_PARENT_PATH_NOTE})` : "";
+  const pnpText = contentPnpNoteFor(missing);
+  const pnpNote = pnpText === void 0 ? "" : ` (${pnpText})`;
   if (r.unreadable || r.dynamic) {
     return {
       name: "tailwind.content",
       severity: "warn",
-      message: `${r.configFile}\uC758 content \uB97C \uC815\uC801\uC73C\uB85C \uB2E4 \uC77D\uC9C0 \uBABB\uD574 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${list}${note}`
+      message: `${r.configFile}\uC758 content \uB97C \uC815\uC801\uC73C\uB85C \uB2E4 \uC77D\uC9C0 \uBABB\uD574 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${list}${note}${pnpNote}`
+    };
+  }
+  if (missing.every((t) => t.pnp?.legacyCovered === true)) {
+    const labels = missing.map((t) => t.label).join(" \xB7 ");
+    const details = missing.filter((t) => t.pnp?.state !== "noNodeModules").map(contentTargetText);
+    return {
+      name: "tailwind.content",
+      severity: "warn",
+      message: `${r.configFile}\uC758 content \uAC00 Plug'n'Play \uC5D0\uC11C \uC2A4\uCE94\uB418\uC9C0 \uC54A\uB294 \uACBD\uB85C\uB85C ${labels} \uB97C \uB36E\uC2B5\uB2C8\uB2E4(node_modules \uACBD\uB85C \xB7 ./** \uB294 \uC2A4\uCE94\uB418\uC9C0 \uC54A\uC74C)${details.length > 0 ? `: ${details.join(" \xB7 ")}` : ""}${note}${pnpNote}`
     };
   }
   return {
     name: "tailwind.content",
     severity: "fail",
-    message: `${r.configFile}\uC758 content \uAC00 \uCEF4\uD3EC\uB10C\uD2B8 \uACBD\uB85C\uB97C \uB36E\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uD074\uB798\uC2A4\uAC00 \uC0DD\uC131\uB418\uC9C0 \uC54A\uC74C): ${list}${note}`
+    message: `${r.configFile}\uC758 content \uAC00 \uCEF4\uD3EC\uB10C\uD2B8 \uACBD\uB85C\uB97C \uB36E\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uD074\uB798\uC2A4\uAC00 \uC0DD\uC131\uB418\uC9C0 \uC54A\uC74C): ${list}${note}${pnpNote}`
   };
 }
 var ANIMATION_PLUGIN_TAILWIND3 = "tailwindcss-animate";
@@ -1876,7 +2455,7 @@ function componentsUseAnimation(baseDir, componentsDir) {
     const [dir, depth] = stack.pop();
     let names;
     try {
-      names = readdirSync(dir);
+      names = readdirSync2(dir);
     } catch {
       continue;
     }
@@ -1908,30 +2487,62 @@ 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) => existsSync3(join2(baseDir, c)));
-    const css = file !== void 0 ? stripCssComments(readFileSync4(join2(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 selection = selectCheckGlobalCss(baseDir);
+    const note = globalCssSelectionNote(selection);
+    const file = selection.rel;
+    const expanded = selection.path !== void 0 && selection.rel !== void 0 ? expandGlobalCss(baseDir, selection.path, selection.rel, outsideCssDir(selection)) : void 0;
+    const css = expanded !== void 0 ? stripCssComments(expanded.evidence) : "";
+    const twAnimate = new RegExp(`@import\\s+(?:url\\(\\s*)?["']${ANIMATION_PLUGIN_TAILWIND4}["']`);
+    const animatePlugin = new RegExp(`@plugin\\s+["']${ANIMATION_PLUGIN_TAILWIND3}["']`);
+    const lines = [];
+    if (twAnimate.test(css)) lines.push(ANIMATION_PLUGIN_TAILWIND4);
+    if (animatePlugin.test(css)) lines.push(ANIMATION_PLUGIN_TAILWIND3);
+    const via = expanded !== void 0 ? cssImportViaNote(viaFiles([evidenceOrigin(expanded, (f) => twAnimate.test(f)), evidenceOrigin(expanded, (f) => animatePlugin.test(f))])) : "";
+    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}";${note}`
+      };
+    }
+    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${via}${note}` };
+    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${via}${note}`
     };
   }
   const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync3(join2(baseDir, f)));
   const source = configFile !== void 0 ? stripJsComments(readFileSync4(join2(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",
@@ -2013,7 +2624,7 @@ function selectUtilsDependencies(tailwind) {
 }
 
 // ../axis-registry-core/src/add/safe-write.ts
-import { constants as fsConstants, existsSync as existsSync4, lstatSync as lstatSync2, realpathSync as realpathSync3, statSync as statSync2 } from "fs";
+import { constants as fsConstants, existsSync as existsSync4, lstatSync as lstatSync2, realpathSync as realpathSync3, statSync as statSync3 } from "fs";
 import path4 from "path";
 import fs2 from "fs-extra";
 var NEW_FILE_FLAGS = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL | (fsConstants.O_NOFOLLOW ?? 0);
@@ -2069,7 +2680,7 @@ function escapeReason(root, target, options = {}) {
     }
     let followed;
     try {
-      followed = statSync2(realTarget);
+      followed = statSync3(realTarget);
     } catch {
       return `\uAE30\uC874 \uD30C\uC77C \uC815\uBCF4\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${target})`;
     }
@@ -2341,7 +2952,7 @@ function relativeSpecifierResolves(fromFile, spec) {
   const base = path5.resolve(path5.dirname(fromFile), spec);
   return RESOLVE_EXTS.some((ext) => {
     try {
-      return statSync3(base + ext).isFile();
+      return statSync4(base + ext).isFile();
     } catch {
       return false;
     }
@@ -3124,7 +3735,7 @@ function formatTokenList(result) {
 }
 
 // src/tools/install.ts
-import { statSync as statSync4 } from "fs";
+import { statSync as statSync5 } from "fs";
 import path6 from "path";
 var DEFAULT_LAYOUT_CONFIG = { componentsDir: "components/ui" };
 var MCP_ADD_HINTS = {
@@ -3163,7 +3774,7 @@ async function handleInstallComponent(params, deps = {}) {
   const root = path6.resolve(params.targetDir);
   let isDir = false;
   try {
-    isDir = statSync4(root).isDirectory();
+    isDir = statSync5(root).isDirectory();
   } catch {
     isDir = false;
   }
@@ -4668,7 +5279,7 @@ import fs6 from "fs-extra";
 import path9 from "path";
 
 // src/tools/brand-core.ts
-import { existsSync as existsSync8, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync8, statSync as statSync6 } from "fs";
 import { createRequire } from "module";
 import { dirname as dirname4, join as join4, relative as relative2, resolve as resolve3, sep as sep2 } from "path";
 var TOKENS_PACKAGE = "@axis-ds/tokens";
@@ -4731,29 +5342,11 @@ function brandImportPath(entry) {
 }
 function isFile2(file) {
   try {
-    return statSync5(file).isFile();
+    return statSync6(file).isFile();
   } catch {
     return false;
   }
 }
-function findGlobalCss(baseDir, config) {
-  const root = resolve3(baseDir);
-  const result = {};
-  const configured = config?.globalCss;
-  if (typeof configured === "string" && configured.trim() !== "") {
-    const file = resolve3(root, configured);
-    if (isFile2(file)) return { path: file };
-    result.configuredMissing = configured;
-  }
-  for (const candidate of GLOBAL_CSS_CANDIDATES) {
-    const file = join4(root, candidate);
-    if (isFile2(file)) {
-      result.path = file;
-      break;
-    }
-  }
-  return result;
-}
 function findBrandImports(css) {
   const names = [];
   const pattern = /@import\s+(?:url\(\s*)?["']?@axis-ds\/tokens\/css\/brands\/([a-z][a-z0-9-]*)(?:\.css)?["']?\s*\)?\s*(?=[;\s]|$)/g;
@@ -4778,18 +5371,24 @@ function inspectBrandImport(baseDir) {
   const brand = config?.brand;
   if (typeof brand !== "string" || brand.trim() === "") return null;
   const root = resolve3(baseDir);
-  const location = findGlobalCss(root, config);
+  const location = selectGlobalCss(root, config?.globalCss, GLOBAL_CSS_CANDIDATES, { requireStylesheet: true });
   const base = { brand };
   if (location.configuredMissing !== void 0) base.configuredMissing = location.configuredMissing;
+  if (location.configuredRejected !== void 0) base.configuredRejected = location.configuredRejected;
   if (!location.path) {
     return { ...base, state: "css-missing", imports: [] };
   }
   const cssFile = relative2(root, location.path).split(sep2).join("/");
-  const imports = [...new Set(findBrandImports(readFileSync8(location.path, "utf8")))];
+  const expanded = expandGlobalCss(root, location.path, cssFile);
+  const imports = [...new Set(findBrandImports(expanded.evidence))];
   let state;
   if (imports.includes(brand)) state = "match";
   else if (imports.length === 0) state = "import-missing";
   else state = "other-brand";
+  const sub = expanded.files.filter((f) => f.depth > 0);
+  const via = state === "match" ? sub.filter((f) => findBrandImports(f.css).includes(brand)).slice(0, 1) : state === "other-brand" ? sub.filter((f) => findBrandImports(f.css).length > 0) : [];
+  const entryHas = state === "match" && findBrandImports(expanded.files[0].css).includes(brand);
+  if (via.length > 0 && !entryHas) return { ...base, state, cssFile, imports, importVia: via.map((f) => f.rel) };
   return { ...base, state, cssFile, imports };
 }
 function isMissingBuildFile(err) {
@@ -4924,7 +5523,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) {
@@ -4997,25 +5600,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})` : "") };
@@ -5156,13 +5777,14 @@ async function handleDiffTemplate(params) {
 }
 function brandCheckResult(check) {
   const { brand } = check;
-  const suffix = check.configuredMissing !== void 0 ? ` (globalCss ${check.configuredMissing} \uC5C6\uC74C)` : "";
+  const suffix = globalCssSelectionNote(check);
+  const via = cssImportViaNote(check.importVia);
   switch (check.state) {
     case "match":
       return {
         name: "brand",
         severity: "pass",
-        message: `brand "${brand}" import \uAC00 ${check.cssFile}\uC5D0 \uC788\uC2B5\uB2C8\uB2E4${suffix}`
+        message: `brand "${brand}" import \uAC00 ${check.cssFile}\uC5D0 \uC788\uC2B5\uB2C8\uB2E4${via}${suffix}`
       };
     case "css-missing":
       return {
@@ -5180,11 +5802,18 @@ function brandCheckResult(check) {
       return {
         name: "brand",
         severity: "warn",
-        message: `brand "${brand}" \uC640 import(${check.imports.join(", ")})\uAC00 \uB2E4\uB985\uB2C8\uB2E4${suffix}`
+        message: `brand "${brand}" \uC640 import(${check.imports.join(", ")})\uAC00 \uB2E4\uB985\uB2C8\uB2E4${via}${suffix}`
       };
   }
 }
 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`;
@@ -5378,10 +6007,8 @@ var TOKENS_INSTALL_COMMAND = addCommandFor("pnpm install", { [TOKENS_PACKAGE]: `
 function baseDirOf(targetDir) {
   return path10.resolve(targetDir || process.cwd());
 }
-function tokensInstallCommandFor(targetDir) {
-  return addCommandFor(detectInstallCommand(baseDirOf(targetDir)), {
-    [TOKENS_PACKAGE]: `^${TOKENS_DEPENDENCY_MIN_VERSION}`
-  });
+function tokensInstallGuideFor(targetDir) {
+  return dependencyInstallGuide(baseDirOf(targetDir), TOKENS_PACKAGE, `^${TOKENS_DEPENDENCY_MIN_VERSION}`);
 }
 async function handleListBrands(params) {
   return listBrands(baseDirOf(params.targetDir));
@@ -5394,24 +6021,25 @@ async function handleGetBrand(params) {
   return getBrand(baseDirOf(params.targetDir), name);
 }
 function formatTokensStatusGuide(status, version, installCommand = TOKENS_INSTALL_COMMAND) {
+  const g = typeof installCommand === "string" ? { kind: "add", installCommand, addCommand: installCommand } : installCommand;
+  if (g.kind === "pnp") {
+    return `${TOKENS_PACKAGE}${g.range ? ` ${g.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.`;
+  }
+  const install = g.kind === "install-at-root" ? `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uC11C \`${g.installCommand}\`` : `\`${g.kind === "install" ? g.installCommand : g.addCommand}\``;
   switch (status) {
     case "not-installed":
-      return [
-        `${TOKENS_PACKAGE} \uAC00 \uC124\uCE58\uB3FC \uC788\uC9C0 \uC54A\uC544 \uBE0C\uB79C\uB4DC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`,
-        "",
-        `- \uC124\uCE58: \`${installCommand}\``
-      ].join("\n");
+      return [`${TOKENS_PACKAGE} \uAC00 \uC124\uCE58\uB3FC \uC788\uC9C0 \uC54A\uC544 \uBE0C\uB79C\uB4DC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`, "", `- \uC124\uCE58: ${install}`].join("\n");
     case "unsupported":
       return [
         `${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: \`${installCommand}\``
+        g.source === "root" ? `- \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.` : `- \uC5C5\uADF8\uB808\uC774\uB4DC: \`${g.addCommand}\``
       ].join("\n");
     case "not-built":
       return [
         `${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 \`${workspaceRunCommand(installCommand, TOKENS_PACKAGE, "build")}\`, \uC544\uB2C8\uBA74 \uC7AC\uC124\uCE58: \`${installCommand}\``
+        `- \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uBA74 \`${workspaceRunCommand(g.installCommand, TOKENS_PACKAGE, "build")}\`, \uC544\uB2C8\uBA74 \uC7AC\uC124\uCE58: ${install}`
       ].join("\n");
   }
 }
@@ -6069,7 +6697,7 @@ server.tool(
   async ({ targetDir }) => {
     try {
       const result = await handleListBrands({ targetDir });
-      const formatted = formatListBrandsResult(result, tokensInstallCommandFor(targetDir));
+      const formatted = formatListBrandsResult(result, tokensInstallGuideFor(targetDir));
       return {
         content: [
           {
@@ -6102,7 +6730,7 @@ server.tool(
   async ({ name, targetDir }) => {
     try {
       const result = await handleGetBrand({ name, targetDir });
-      const formatted = formatGetBrandResult(result, name, tokensInstallCommandFor(targetDir));
+      const formatted = formatGetBrandResult(result, name, tokensInstallGuideFor(targetDir));
       return {
         content: [
           {