@axis-ds/mcp 1.4.6 → 1.4.8

package/README.md

@@ -42,6 +42,7 @@ Claude Desktop 또는 기타 MCP 호환 클라이언트에서 설정:
 - `targetDir` 는 이미 있는 프로젝트 루트입니다(상대 경로는 서버의 현재 디렉터리 기준). `axis.config.json` 이 있으면 그 `componentsDir` · `agenticDir` 에, 없으면 `components/ui` · `components/agentic` 에 설치하고 그 사실을 알립니다. 프로젝트 밖으로 나가는 경로는 아무것도 쓰지 않고 실패합니다.
 - 내용이 다른 기존 파일은 덮어쓰지 않고 건너뛰며 응답 첫머리에 건너뛴 수를 적습니다. `overwrite: true` 일 때만 덮어씁니다.
 - 의존성은 설치하지 않고 lockfile 에 맞는 명령(`pnpm add` · `npm install` · `yarn add`)만 안내합니다. lockfile 이 없으면 `package.json` 의 `packageManager` 를 봅니다(1.4.2 부터). `axis.apply_template` 의 「필요한 의존성」 · `axis.list_brands` · `axis.get_brand` 의 설치 안내도 1.4.2 부터 같은 방식으로 `targetDir` 의 매니저를 따릅니다(1.4.1 까지는 `pnpm` 고정).
+- `axis.apply_template` 은 `targetDir` 에 이미 있는 `package.json` · `axis.config.json`(템플릿 루트의 것)을 덮어쓰지 않고 CLI `axis template apply` 와 같은 규칙으로 합칩니다(WI-0088). `packageManager` 등 사용자 필드가 남고, 결과의 파일 목록에 「합치기」로 표시합니다. 파일을 쓰는 도중 실패하면 건드린 파일을 되돌리고 오류로 응답합니다. 템플릿 경로가 `targetDir` 밖(절대 경로 · `..` · 밖을 가리키는 심볼릭 링크 경유)이면 `axis.apply_template` · `axis.diff_template` 은 아무 파일도 쓰거나 읽지 않고 오류로 응답합니다.
 
 ## 토큰 도구
 

package/dist/index.js

@@ -58,8 +58,8 @@ function listTokens(category) {
   }
   return tokens;
 }
-function getToken(path11) {
-  const q = path11.trim().toLowerCase();
+function getToken(path12) {
+  const q = path12.trim().toLowerCase();
   return loadTokens().tokens.find(
     (t) => t.path.toLowerCase() === q || (t.aliases ?? []).some((a) => a.toLowerCase() === q) || t.cssVariable.toLowerCase() === q
   );
@@ -237,8 +237,8 @@ function validateRegistryIndex(data, where = "index.json") {
     if (!isValidRegistryName(raw.name)) throw new Error(`${at}: name \uC774 slug \uADDC\uCE59\uC5D0 \uB9DE\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`);
     if (seen.has(raw.name)) throw new Error(`${at}: name '${raw.name}' \uAC00 \uC911\uBCF5\uC785\uB2C8\uB2E4`);
     seen.add(raw.name);
-    const sha256 = optionalString(raw, "sha256", at);
-    if (sha256 !== void 0 && !/^[0-9a-f]{64}$/.test(sha256)) {
+    const sha2562 = optionalString(raw, "sha256", at);
+    if (sha2562 !== void 0 && !/^[0-9a-f]{64}$/.test(sha2562)) {
       throw new Error(`${at}: sha256 \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4`);
     }
     return {
@@ -246,7 +246,7 @@ function validateRegistryIndex(data, where = "index.json") {
       type: requireType(raw, at),
       title: optionalString(raw, "title", at),
       description: optionalString(raw, "description", at),
-      ...sha256 !== void 0 ? { sha256 } : {}
+      ...sha2562 !== void 0 ? { sha256: sha2562 } : {}
     };
   });
   return {
@@ -1020,6 +1020,9 @@ function dependencyInstallGuide(baseDirInput, name, range) {
     ...base
   };
 }
+function installCommandPhrase(installCommand, rootDeclared) {
+  return rootDeclared && packageManagerOf(installCommand) === "npm" ? `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uC11C ${installCommand}` : installCommand;
+}
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -1062,6 +1065,13 @@ function isFile(file) {
     return false;
   }
 }
+function isDirectory(dir) {
+  try {
+    return statSync(dir).isDirectory();
+  } catch {
+    return false;
+  }
+}
 function selectGlobalCss(baseDir, configured, candidates, options = {}) {
   const result = {};
   if (typeof configured === "string" && configured.trim() !== "") {
@@ -1181,6 +1191,144 @@ function outsideCssPackageResolution(baseDir, cssDir, name, file) {
   if (!usable(findInstalledPackage(baseDir, name))) return "unknown";
   return usable(findInstalledPackage(cssDir, name)) ? "resolved" : "unresolved";
 }
+var CSS_EXPORT_CONDITIONS = /* @__PURE__ */ new Set(["style", "default"]);
+function splitPackageSpec(spec) {
+  const parts = spec.split("/");
+  const n = spec.startsWith("@") ? 2 : 1;
+  if (parts.length < n || parts.slice(0, n).some((p) => p === "" || p === "." || p === "..")) return void 0;
+  return { name: parts.slice(0, n).join("/"), rest: parts.slice(n).join("/") };
+}
+function resolveExportTarget(value, conditions = CSS_EXPORT_CONDITIONS) {
+  if (typeof value === "string") return value;
+  if (Array.isArray(value)) {
+    for (const v of value) {
+      const r = resolveExportTarget(v, conditions);
+      if (r !== void 0) return r;
+    }
+    return void 0;
+  }
+  if (isPlainObject(value)) {
+    for (const [key, v] of Object.entries(value)) {
+      if (!conditions.has(key)) continue;
+      if (v === null) return void 0;
+      const r = resolveExportTarget(v, conditions);
+      if (r !== void 0) return r;
+    }
+  }
+  return void 0;
+}
+function cssFileCandidates(p) {
+  return [p, `${p}.css`, path3.join(p, "index.css")];
+}
+function exportsTarget(exportsField, subpath, conditions = CSS_EXPORT_CONDITIONS) {
+  const map = isPlainObject(exportsField) && Object.keys(exportsField).some((k) => k.startsWith(".")) ? exportsField : { ".": exportsField };
+  if (Object.prototype.hasOwnProperty.call(map, subpath)) {
+    const t = resolveExportTarget(map[subpath], conditions);
+    if (t === void 0) return void 0;
+    return t.includes("*") || !t.startsWith("./") ? "?" : t;
+  }
+  if (Object.keys(map).some((k) => k.includes("*") || k.endsWith("/") && subpath.startsWith(k))) return "?";
+  return void 0;
+}
+function resolveCssPackageImport(fromDir, spec) {
+  return resolvePackageSubpath(fromDir, spec, CSS_EXPORT_CONDITIONS, cssFileCandidates);
+}
+function resolvePackageSubpath(fromDir, spec, conditions, candidates) {
+  const parsed = splitPackageSpec(spec);
+  if (parsed === void 0 || parsed.rest === "") return { kind: "unknown" };
+  const subpath = `./${parsed.rest}`;
+  let dir = resolveBaseDir(fromDir);
+  for (; ; ) {
+    const pkgDir = path3.join(dir, "node_modules", ...parsed.name.split("/"));
+    if (isDirectory(pkgDir)) {
+      let manifest;
+      try {
+        const raw = JSON.parse(readFileSync3(path3.join(pkgDir, "package.json"), "utf8"));
+        manifest = isPlainObject(raw) ? raw : void 0;
+      } catch {
+        manifest = void 0;
+      }
+      if (manifest !== void 0 && manifest.exports) {
+        const version = exactVersionOf(manifest.version);
+        const target = exportsTarget(manifest.exports, subpath, conditions);
+        if (target === "?") return { kind: "unknown" };
+        if (target === void 0) {
+          return version !== void 0 ? { kind: "not-exported", pkgDir, subpath, version } : { kind: "not-exported", pkgDir, subpath };
+        }
+        const file = candidates(path3.join(pkgDir, target)).find(isFile);
+        if (file !== void 0) return { kind: "resolved", pkgDir, file };
+        return version !== void 0 ? { kind: "target-missing", pkgDir, subpath, target, version } : { kind: "target-missing", pkgDir, subpath, target };
+      }
+      const bare = candidates(path3.join(pkgDir, parsed.rest)).find(isFile);
+      if (bare !== void 0) return { kind: "resolved", pkgDir, file: bare };
+    }
+    const parent = path3.dirname(dir);
+    if (parent === dir) return { kind: "not-found" };
+    dir = parent;
+  }
+}
+function installBase(pkgDir, name) {
+  let base = pkgDir;
+  for (let i = 0; i < name.split("/").length + 1; i++) base = path3.dirname(base);
+  try {
+    return realpathSync(base);
+  } catch {
+    return path3.resolve(base);
+  }
+}
+function isAncestorInstall(hit, app, name) {
+  const h = installBase(hit, name);
+  const a = installBase(app, name);
+  return a !== h && a.startsWith(h.endsWith(path3.sep) ? h : h + path3.sep);
+}
+function sameRealDir(a, b) {
+  const real = (p) => {
+    try {
+      return realpathSync(p);
+    } catch {
+      return path3.resolve(p);
+    }
+  };
+  return real(a) === real(b);
+}
+function cssPackageLineResolution(baseDir, lineDir, spec, otherDirs = []) {
+  if (isPnpProject(baseDir)) return { kind: "ok" };
+  const parsed = splitPackageSpec(spec);
+  if (parsed === void 0) return { kind: "ok" };
+  const r = resolveCssPackageImport(lineDir, spec);
+  if (r.kind === "resolved" || r.kind === "unknown") return { kind: "ok" };
+  const app = findInstalledPackage(baseDir, parsed.name);
+  if (r.kind === "not-exported" || r.kind === "target-missing") {
+    if (app !== void 0 && sameRealDir(app.dir, r.pkgDir)) return { kind: "ok" };
+    if (app !== void 0 && isAncestorInstall(r.pkgDir, app.dir, parsed.name)) return { kind: "ok" };
+    return r.kind === "not-exported" ? { ...r, kind: "shadow-not-exported" } : { ...r, kind: "shadow-target-missing" };
+  }
+  if (app !== void 0) return { kind: "ok" };
+  for (const other of typeof otherDirs === "function" ? otherDirs() : otherDirs) {
+    const o = resolveCssPackageImport(other, spec);
+    if (o.kind === "resolved") return { kind: "not-visible", pkgDir: o.pkgDir, fromDir: resolveBaseDir(other) };
+  }
+  return { kind: "ok" };
+}
+var JS_REQUIRE_CONDITIONS = /* @__PURE__ */ new Set(["require", "node", "module-sync", "default"]);
+var JS_IMPORT_CONDITIONS = /* @__PURE__ */ new Set(["import", "node", "module-sync", "default"]);
+function jsFileCandidates(p) {
+  return [p, `${p}.js`, `${p}.json`, `${p}.node`, path3.join(p, "index.js"), path3.join(p, "index.json"), path3.join(p, "index.node")];
+}
+function tailwindConfigImportResolution(baseDir, spec, refs) {
+  if (isPnpProject(baseDir)) return { kind: "ok" };
+  const blocked = (conditions) => {
+    const r = resolvePackageSubpath(baseDir, spec, conditions, jsFileCandidates);
+    return r.kind === "not-exported" ? r : void 0;
+  };
+  const viaRequire = refs.require || refs.import ? blocked(JS_REQUIRE_CONDITIONS) : void 0;
+  if (refs.require && viaRequire !== void 0) return viaRequire;
+  if (refs.import && viaRequire !== void 0) {
+    const viaImport = blocked(JS_IMPORT_CONDITIONS);
+    if (viaImport !== void 0) return viaImport;
+  }
+  return { kind: "ok" };
+}
 function findPnpUnpluggedPackages(baseDirInput, name, range) {
   const root = pnpProjectRoot(baseDirInput);
   if (root === void 0) return [];
@@ -1205,6 +1353,17 @@ function findPnpUnpluggedPackages(baseDirInput, name, range) {
   }
   return found;
 }
+var PNP_REAL_DIR_RANGE = /^(?:workspace|portal|link):/;
+function pnpComponentSourceHidden(baseDirInput, name, range) {
+  if (!isPnpProject(baseDirInput)) return false;
+  const r = range.trim();
+  if (PNP_REAL_DIR_RANGE.test(r)) return false;
+  const probe = versionSatisfiesRange("0.0.0", r) === void 0 ? "*" : r;
+  return findPnpUnpluggedPackages(baseDirInput, name, probe).length === 0;
+}
+function pnpUnplugSetupPhrase(name) {
+  return `Plug'n'Play \uB8E8\uD2B8(.pnp.cjs \uAC00 \uC788\uB294 \uACF3) package.json \uC758 dependenciesMeta \uC5D0 "${name}": { "unplugged": true } \uB97C \uB450\uACE0 yarn install`;
+}
 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;
@@ -1618,12 +1777,12 @@ function outsideCssDir(selection) {
 function outsideCssUnresolvedIssue(spec, name) {
   return `${spec} import \uAC00 \uC788\uC9C0\uB9CC \uC774 \uD30C\uC77C \uC704\uCE58\uC5D0\uC11C ${name} \uB97C \uCC3E\uC9C0 \uBABB\uD574 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uC124\uCE58\uBCF8\uC774 \uC571 \uCABD node_modules \uC5D0\uB9CC \uC788\uC74C) \u2192 \uC774 \uD30C\uC77C\uC758 \uC0C1\uC704 node_modules(\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8 \uB4F1)\uC5D0 \uC124\uCE58\uD558\uAC70\uB098 globalCss \uB97C \uC571 \uC548 \uD30C\uC77C\uB85C \uBC14\uAFB8\uC138\uC694`;
 }
-function tokensInstallPhrase(baseDir) {
-  const g = dependencyInstallGuide(baseDir, TOKENS_PACKAGE_NAME, `^${TAILWIND4_MIN_AXIS_VERSION}`);
+function tokensInstallPhrase(baseDir, range = `^${TAILWIND4_MIN_AXIS_VERSION}`) {
+  const g = dependencyInstallGuide(baseDir, TOKENS_PACKAGE_NAME, range);
   if (g.kind === "install-at-root") return `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uC11C ${g.installCommand}`;
   return g.kind === "install" ? g.installCommand : g.addCommand;
 }
-function tokensCssUnresolvedIssue(baseDir, pkg, spec, cssDir) {
+function tokensCssUnresolvedIssue(baseDir, pkg, spec, cssDir, lineIssue) {
   const r = tokensCssResolution(baseDir, pkg, TOKENS_PACKAGE_NAME);
   const head = `${spec} import \uAC00 \uC788\uC9C0\uB9CC`;
   if (r.kind === "pnp-root-only") return `${head} ${TOKENS_PACKAGE_NAME} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694`;
@@ -1633,7 +1792,42 @@ function tokensCssUnresolvedIssue(baseDir, pkg, spec, cssDir) {
   if (cssDir !== void 0 && outsideCssPackageResolution(baseDir, cssDir, TOKENS_PACKAGE_NAME) === "unresolved") {
     return outsideCssUnresolvedIssue(spec, TOKENS_PACKAGE_NAME);
   }
-  return void 0;
+  return lineIssue?.();
+}
+function packageNameOfSpec(spec) {
+  const parts = spec.split("/");
+  return parts.slice(0, spec.startsWith("@") ? 2 : 1).join("/");
+}
+function displayRel(baseDir, p) {
+  return relative(baseDir, p).split(sep).join("/");
+}
+function packageLineShadowIssue(baseDir, expanded, origin, spec, opts = {}) {
+  const name = packageNameOfSpec(spec);
+  const lineDir = dirname2(origin.path);
+  const others = () => [...new Set(expanded.files.map((f) => dirname2(f.path)))].filter((d) => d !== lineDir);
+  const r = cssPackageLineResolution(baseDir, lineDir, spec, others);
+  const head = `${spec} import \uAC00 \uC788\uC9C0\uB9CC \uADF8 \uC904\uC774 \uC788\uB294 \uD30C\uC77C \uC704\uCE58\uC5D0\uC11C`;
+  const label = (pkgDir, version) => `${displayRel(baseDir, pkgDir)}(${version ?? "\uBC84\uC804 \uBAA8\uB984"})`;
+  if (opts.tailwind3 === true && r.kind !== "shadow-not-exported") return void 0;
+  switch (r.kind) {
+    case "ok":
+      return void 0;
+    case "shadow-not-exported": {
+      const current = opts.tailwind3 === true || r.version !== void 0 && (compareExactVersions(r.version, TAILWIND4_MIN_AXIS_VERSION) ?? -1) >= 0;
+      const todo = current ? "\uB2E4\uC2DC \uC124\uCE58\uD558\uC138\uC694" : `${TAILWIND4_MIN_AXIS_VERSION} \uC774\uC0C1\uC73C\uB85C \uB9DE\uCD94\uC138\uC694`;
+      return `${head} \uBA3C\uC800 \uC7A1\uD788\uB294 ${label(r.pkgDir, r.version)}\uAC00 ${r.subpath} \uB97C \uB0B4\uBCF4\uB0B4\uC9C0 \uC54A\uC544 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uADF8 \uC911\uCCA9 node_modules \uC758 ${name} \uB97C \uC9C0\uC6B0\uAC70\uB098 ${todo}`;
+    }
+    case "shadow-target-missing":
+      return `${head} \uBA3C\uC800 \uC7A1\uD788\uB294 ${label(r.pkgDir, r.version)}\uC5D0 \uB0B4\uBCF4\uB0B8 \uD30C\uC77C(${r.target})\uC774 \uC5C6\uC5B4 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uADF8 \uC911\uCCA9 node_modules \uC758 ${name} \uB97C \uC9C0\uC6B0\uAC70\uB098 \uB2E4\uC2DC \uC124\uCE58\uD558\uC138\uC694`;
+    case "not-visible": {
+      const there = expanded.files.find((f) => dirname2(f.path) === r.fromDir);
+      const move = there !== void 0 ? `\uC774 \uC904(${origin.rel})\uC744 ${there.rel} \uB85C \uC62E\uAE30\uC138\uC694` : `\uC774 \uC904(${origin.rel})\uC744 \uADF8 \uC704\uCE58\uC758 CSS \uD30C\uC77C\uB85C \uC62E\uAE30\uC138\uC694`;
+      return `${head} ${name} \uB97C \uCC3E\uC9C0 \uBABB\uD574 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uC124\uCE58\uBCF8\uC774 ${displayRel(baseDir, r.pkgDir)} \uC5D0\uB9CC \uC788\uC74C) \u2192 \uC571 \uB610\uB294 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC124\uCE58\uD558\uAC70\uB098 ${move}`;
+    }
+  }
+}
+function isOutsideEntry(origin) {
+  return origin.depth === 0 && origin.cssDir !== void 0;
 }
 function checkGlobalsCss(baseDirInput) {
   const baseDir = resolveBaseDir(baseDirInput);
@@ -1661,7 +1855,21 @@ function judgeGlobalsCss(baseDir, selection, candidate, expanded) {
   if (imported !== void 0) {
     const origin = evidenceOrigin(expanded, (f) => findTokensCssImport(f) === imported);
     via = cssImportViaNote(viaFiles([origin]));
-    const issue = tokensCssUnresolvedIssue(baseDir, pkg, imported, origin !== void 0 ? origin.cssDir : outsideCssDir(selection));
+    const tailwind4 = (detectTailwind(baseDir, pkg).major ?? 0) >= 4;
+    const inside = origin !== void 0 && !isOutsideEntry(origin);
+    const issue = tailwind4 && inside ? tokensCssUnresolvedIssue(
+      baseDir,
+      pkg,
+      imported,
+      void 0,
+      () => packageLineShadowIssue(baseDir, expanded, origin, imported)
+    ) : tokensCssUnresolvedIssue(
+      baseDir,
+      pkg,
+      imported,
+      origin !== void 0 ? origin.cssDir : outsideCssDir(selection),
+      inside ? () => packageLineShadowIssue(baseDir, expanded, origin, imported, { tailwind3: true }) : void 0
+    );
     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))) {
@@ -1865,6 +2073,8 @@ function stripJsComments(src) {
 }
 var TOKENS_TAILWIND3_PRESET = "@axis-ds/tokens/tailwind";
 var PRESET_REFERENCE = /(?:\brequire\s*\(\s*|\bimport\s*\(\s*|\bfrom\s*|\bimport\s+)(["'])@axis-ds\/tokens\/tailwind\1/;
+var PRESET_REQUIRE_REFERENCE = /\brequire\s*\(\s*(["'])@axis-ds\/tokens\/tailwind\1/;
+var PRESET_IMPORT_REFERENCE = /(?:\bimport\s*\(\s*|\bfrom\s*|\bimport\s+)(["'])@axis-ds\/tokens\/tailwind\1/;
 function hasTokensPresetReference(source) {
   return PRESET_REFERENCE.test(stripJsComments(source));
 }
@@ -1892,6 +2102,25 @@ function hasBareCjsPresetRequire(code) {
 function isCommonJsConfig(file, source) {
   return extname(file) === ".cjs" || /\bmodule\.exports\b/.test(source);
 }
+function presetTokensUnresolvedMessage(baseDir, pkg, file, bareCjs, code) {
+  const r = tokensCssResolution(baseDir, pkg, TOKENS_PACKAGE_NAME);
+  const head = `${file}\uC5D0 AXIS preset \uCC38\uC870\uAC00 \uC788\uC9C0\uB9CC ${TOKENS_PACKAGE_NAME} \uAC00`;
+  if (r.kind === "not-installed") {
+    return `${head} \uC124\uCE58\uB418\uC9C0 \uC54A\uC544 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uC124\uCE58(${tokensInstallPhrase(baseDir, `^${TOKENS_CJS_PRESET_FIXED_VERSION}`)})`;
+  }
+  if (r.kind === "pnp-root-only" && !bareCjs) {
+    return `${head} ${PNP_ROOT_ONLY_NOTE}(\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8 \uC120\uC5B8 ${r.range}) \u2192 \uC571 package.json \uC5D0 ${TOKENS_PACKAGE_NAME} \uB97C \uC120\uC5B8\uD558\uC138\uC694`;
+  }
+  const e = tailwindConfigImportResolution(baseDir, TOKENS_TAILWIND3_PRESET, {
+    require: PRESET_REQUIRE_REFERENCE.test(code),
+    import: PRESET_IMPORT_REFERENCE.test(code)
+  });
+  if (e.kind === "not-exported") {
+    const label = `${displayRel(baseDir, e.pkgDir)}(${e.version ?? "\uBC84\uC804 \uBAA8\uB984"})`;
+    return `${file}\uC5D0 AXIS preset \uCC38\uC870\uAC00 \uC788\uC9C0\uB9CC \uBA3C\uC800 \uC7A1\uD788\uB294 ${label}\uAC00 ${e.subpath} \uB97C \uB0B4\uBCF4\uB0B4\uC9C0 \uC54A\uC544 \uD574\uC11D\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 \uADF8 node_modules \uC758 ${TOKENS_PACKAGE_NAME} \uB97C \uC9C0\uC6B0\uAC70\uB098 \uB2E4\uC2DC \uC124\uCE58\uD558\uC138\uC694`;
+  }
+  return void 0;
+}
 function packageVersionGate(baseDirInput, pkg, name, min, options = {}) {
   const baseDir = resolveBaseDir(baseDirInput);
   if (!isPnpProject(baseDir)) {
@@ -1944,7 +2173,8 @@ function tailwind4Issues(input, pkg, versions, baseDir) {
     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);
+    if (r.kind === "app" && pnpComponentSourceHidden(baseDir, name, r.range)) unresolvedMissing.push(componentCssPnpMissingIssue(name));
+    else if (componentCssResolvable(r)) missing.push(name);
     else unresolvedMissing.push(componentCssMissingIssue(baseDir, name, r));
   }
   if (missing.length > 0) {
@@ -1960,12 +2190,28 @@ function tailwind4Issues(input, pkg, versions, baseDir) {
   }
   for (const name of TAILWIND4_COMPONENT_PACKAGES) {
     if (!hasComponentTailwindImport(evidence, name)) continue;
-    const unresolved = componentCssPresentIssue(baseDir, name, resolutions.get(name));
-    const componentDir = cssDirOf(`${name}/tailwind.css`);
-    if (unresolved !== void 0) issues.push(unresolved);
-    else if (componentDir !== void 0 && outsideCssPackageResolution(baseDir, componentDir, name, "tailwind.css") === "unresolved") {
-      issues.push(outsideCssUnresolvedIssue(`${name}/tailwind.css`, name));
-    } else if (versions.some((v) => v.name === name)) issues.push(`${name}/tailwind.css import \uAC00 \uC788\uC9C0\uB9CC ${name} \uBC84\uC804 \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4`);
+    const r = resolutions.get(name);
+    const unresolved = componentCssPresentIssue(baseDir, name, r);
+    const spec = `${name}/tailwind.css`;
+    if (unresolved !== void 0) {
+      issues.push(unresolved);
+      continue;
+    }
+    if (r.kind === "app" && pnpComponentSourceHidden(baseDir, name, r.range)) {
+      issues.push(componentCssPnpPresentIssue(name));
+      continue;
+    }
+    const shadow = input.lineIssue === void 0 ? false : input.lineIssue(spec);
+    let lineProblem;
+    if (shadow !== false) lineProblem = shadow;
+    else {
+      const componentDir = cssDirOf(spec);
+      if (componentDir !== void 0 && outsideCssPackageResolution(baseDir, componentDir, name, "tailwind.css") === "unresolved") {
+        lineProblem = outsideCssUnresolvedIssue(spec, name);
+      }
+    }
+    if (lineProblem !== void 0) issues.push(lineProblem);
+    else if (versions.some((v) => v.name === name)) issues.push(`${name}/tailwind.css import \uAC00 \uC788\uC9C0\uB9CC ${name} \uBC84\uC804 \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4`);
   }
   return issues;
 }
@@ -1973,6 +2219,13 @@ 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;
 }
+var PNP_ZIP_SOURCE_NOTE = `Plug'n'Play \uC5D0\uC11C @source "./dist" \uAC00 .yarn/cache zip \uC548\uC744 \uAC00\uB9AC\uCF1C \uCEF4\uD3EC\uB10C\uD2B8 \uD074\uB798\uC2A4\uAC00 \uC0DD\uC131\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`;
+function componentCssPnpMissingIssue(name) {
+  return `${name} \uC758 tailwind.css \uB294 ${PNP_ZIP_SOURCE_NOTE} \u2192 ${pnpUnplugSetupPhrase(name)} \uB4A4 ${componentTailwindImportLine(name)}`;
+}
+function componentCssPnpPresentIssue(name) {
+  return `${name}/tailwind.css import \uAC00 \uC788\uC9C0\uB9CC ${PNP_ZIP_SOURCE_NOTE} \u2192 ${pnpUnplugSetupPhrase(name)} \uD558\uC138\uC694`;
+}
 function componentCssMissingIssue(baseDir, name, r) {
   const line = componentTailwindImportLine(name);
   switch (r.kind) {
@@ -2033,7 +2286,17 @@ function checkTailwindSetup(baseDirInput) {
       );
       const versions = axisPackagesBelowTailwind4(pkg, baseDir);
       const issues = tailwind4Issues(
-        { entry: expanded.entry, evidence: expanded.evidence, cssDirOf: (spec) => packageLineCssDir(expanded, spec) },
+        {
+          entry: expanded.entry,
+          evidence: expanded.evidence,
+          cssDirOf: (spec) => packageLineCssDir(expanded, spec),
+          lineIssue: (spec) => {
+            const line = expanded.packageLines.find((l) => l.spec === spec);
+            const origin = line !== void 0 ? expanded.files.find((f) => f.rel === line.file) : void 0;
+            if (origin === void 0 || isOutsideEntry(origin)) return false;
+            return packageLineShadowIssue(baseDir, expanded, origin, spec);
+          }
+        },
         pkg,
         versions,
         baseDir
@@ -2058,12 +2321,15 @@ function checkTailwindSetup(baseDirInput) {
     };
   }
   for (const file of TAILWIND_CONFIG_FILES) {
-    const path11 = join2(baseDir, file);
-    if (!existsSync3(path11)) continue;
-    const content = readFileSync4(path11, "utf8");
+    const path12 = join2(baseDir, file);
+    if (!existsSync3(path12)) continue;
+    const content = readFileSync4(path12, "utf8");
     if (hasTokensPresetReference(content)) {
       const code = stripJsComments(content);
-      if (isCommonJsConfig(file, code) && hasBareCjsPresetRequire(code)) {
+      const bareCjs = isCommonJsConfig(file, code) && hasBareCjsPresetRequire(code);
+      const unresolved = presetTokensUnresolvedMessage(baseDir, pkg, file, bareCjs, code);
+      if (unresolved !== void 0) return { name: "tailwind.config", severity: "warn", message: unresolved };
+      if (bareCjs) {
         const gate = packageVersionGate(baseDir, pkg, "@axis-ds/tokens", TOKENS_CJS_PRESET_FIXED_VERSION, { appOnlyInPnp: true });
         if (gate.status === "unresolved") {
           return {
@@ -3491,11 +3757,11 @@ async function handleGetComponent(params, deps = {}) {
   return { component, source: describeOrigin(client, latest.version), notices };
 }
 function handleGetToken(params) {
-  const { path: path11 } = params;
-  if (!path11 || path11.trim() === "") {
+  const { path: path12 } = params;
+  if (!path12 || path12.trim() === "") {
     throw new Error("\uD1A0\uD070 \uACBD\uB85C(path)\uB294 \uD544\uC218\uC785\uB2C8\uB2E4.");
   }
-  const token = getToken(path11);
+  const token = getToken(path12);
   if (!token) {
     return null;
   }
@@ -3576,9 +3842,9 @@ function cssUsage(token) {
   const shadcnColor = !token.cssVariable.startsWith("--axis-") && token.value.startsWith("hsl(");
   return shadcnColor ? `hsl(var(${token.cssVariable}))` : `var(${token.cssVariable})`;
 }
-function formatTokenNotFound(path11) {
+function formatTokenNotFound(path12) {
   return [
-    `\uD1A0\uD070\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: \`${path11}\``,
+    `\uD1A0\uD070\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: \`${path12}\``,
     "",
     "- \uACBD\uB85C\uB294 `axis.list_tokens` \uB85C \uD655\uC778\uD558\uC138\uC694. \uACBD\uB85C \xB7 tokens \uC774\uB984 \uAE30\uBC18 \uACBD\uB85C(\uC608: `control.h.md`) \xB7 CSS \uBCC0\uC218 \uC774\uB984(\uC608: `--axis-control-h-md`)\uC744 \uBC1B\uC2B5\uB2C8\uB2E4.",
     "- \uBE0C\uB79C\uB4DC \uAC12\uC740 `axis.list_brands` \xB7 `axis.get_brand` \uB85C \uC870\uD68C\uD558\uC138\uC694."
@@ -5276,12 +5542,14 @@ function formatSaveResult(result) {
 // src/tools/template.ts
 import fetch from "node-fetch";
 import fs6 from "fs-extra";
-import path9 from "path";
+import path10 from "path";
 
 // src/tools/brand-core.ts
+import { createHash as createHash2 } from "crypto";
 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";
+import { MessageChannel, Worker, receiveMessageOnPort } from "worker_threads";
 var TOKENS_PACKAGE = "@axis-ds/tokens";
 var MIN_BRAND_TOKENS_VERSION = "1.3.0";
 var TOKENS_DEPENDENCY_MIN_VERSION = "1.6.0";
@@ -5306,13 +5574,15 @@ function readJsonFile(file) {
 function errorCode(err) {
   return typeof err === "object" && err !== null && "code" in err ? String(err.code) : void 0;
 }
-function findTokensPackageJson(baseDir) {
+function tokensPackageJsonCandidates(baseDir) {
+  const candidates = [];
   let dir = resolve3(baseDir);
   for (; ; ) {
     const candidate = join4(dir, "node_modules", TOKENS_PACKAGE, "package.json");
-    if (existsSync8(candidate)) return candidate;
+    candidates.push(candidate);
+    if (existsSync8(candidate)) return { found: candidate, candidates };
     const parent = dirname4(dir);
-    if (parent === dir) return void 0;
+    if (parent === dir) return { candidates };
     dir = parent;
   }
 }
@@ -5322,18 +5592,195 @@ function projectRequire(baseDir) {
 function tokensSpecifier(subpath) {
   return `${TOKENS_PACKAGE}/${subpath.replace(/^\.\//, "")}`;
 }
-function resolveTokens(baseDir) {
-  const pkgJson = findTokensPackageJson(baseDir);
-  if (!pkgJson) return { status: "not-installed" };
-  const pkg = readJsonFile(pkgJson);
-  const version = typeof pkg.version === "string" ? pkg.version : void 0;
+var nodeSeenStates = /* @__PURE__ */ new Map();
+var ABSENT = "absent";
+var UNKNOWN = "unknown";
+var isolationDisabled = false;
+var isolatedStats = { workers: 0, resolves: 0, fallbacks: 0 };
+var ISOLATED_RESOLVE_TIMEOUT_MS = 5e3;
+var ISOLATED_RESOLVE_SOURCE = `
+const { workerData } = require("node:worker_threads");
+const { createRequire } = require("node:module");
+const { port, signal, from } = workerData;
+const req = createRequire(from);
+port.on("message", (spec) => {
+  let reply;
   try {
-    const indexPath = projectRequire(baseDir).resolve(tokensSpecifier("./brands"));
-    return { status: "ok", version, indexPath };
+    reply = { path: req.resolve(spec) };
+  } catch (err) {
+    const code = err && typeof err === "object" && "code" in err ? String(err.code) : undefined;
+    reply = { code, message: err && err.message ? String(err.message) : String(err) };
+  }
+  port.postMessage(reply);
+  Atomics.store(signal, 0, 1);
+  Atomics.notify(signal, 0);
+});
+`;
+var IsolationFailure = class extends Error {
+};
+function createWorkerResolveSession(from, source, timeoutMs) {
+  const { port1, port2 } = new MessageChannel();
+  const signal = new Int32Array(new SharedArrayBuffer(4));
+  const worker = new Worker(source, {
+    eval: true,
+    workerData: { port: port2, signal, from },
+    transferList: [port2]
+  });
+  worker.on("error", () => {
+  });
+  worker.unref();
+  return {
+    resolve(spec) {
+      Atomics.store(signal, 0, 0);
+      port1.postMessage(spec);
+      const waited = Atomics.wait(signal, 0, 0, timeoutMs);
+      const received = receiveMessageOnPort(port1);
+      if (waited === "timed-out" || !received) throw new IsolationFailure("\uACA9\uB9AC \uD574\uC11D\uC774 \uC751\uB2F5\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4");
+      const reply = received.message;
+      if (typeof reply.path === "string") return reply.path;
+      throw Object.assign(new Error(reply.message ?? spec), reply.code === void 0 ? {} : { code: reply.code });
+    },
+    close() {
+      port1.close();
+      void worker.terminate();
+    }
+  };
+}
+function workerResolveSession(from) {
+  return createWorkerResolveSession(from, ISOLATED_RESOLVE_SOURCE, ISOLATED_RESOLVE_TIMEOUT_MS);
+}
+var isolatedFactory = workerResolveSession;
+function sha256(text) {
+  return createHash2("sha256").update(text).digest("hex");
+}
+function openTokensResolver(baseDir, candidates, pkgJson, pkgText) {
+  const nodeRequire = projectRequire(baseDir);
+  const key = sha256(pkgText);
+  const current = candidates.map((c) => c === pkgJson ? key : ABSENT);
+  const changed = candidates.some((c, i) => {
+    const seen = nodeSeenStates.get(c);
+    return seen !== void 0 && seen !== current[i];
+  });
+  let mode = changed ? "isolated" : "node";
+  if (mode === "node") {
+    candidates.forEach((c, i) => {
+      if (!nodeSeenStates.has(c)) nodeSeenStates.set(c, current[i]);
+    });
+  }
+  let session = null;
+  let stale = false;
+  let raced = false;
+  let postChecked = false;
+  const markStale = () => {
+    if (!stale) isolatedStats.fallbacks += 1;
+    stale = true;
+  };
+  const fallBack = () => {
+    markStale();
+    isolationDisabled = true;
+    session?.close();
+    session = null;
+  };
+  const startIsolation = () => {
+    if (isolationDisabled) {
+      markStale();
+      return;
+    }
+    try {
+      session = isolatedFactory(join4(resolve3(baseDir), "package.json"));
+      isolatedStats.workers += 1;
+    } catch {
+      fallBack();
+    }
+  };
+  if (mode === "isolated") startIsolation();
+  const isolatedResolve = (spec) => {
+    if (session) {
+      try {
+        const resolved = session.resolve(spec);
+        isolatedStats.resolves += 1;
+        return resolved;
+      } catch (err) {
+        if (!(err instanceof IsolationFailure)) {
+          isolatedStats.resolves += 1;
+          throw err;
+        }
+        fallBack();
+      }
+    }
+    return nodeRequire.resolve(spec);
+  };
+  return {
+    resolve(spec) {
+      if (mode === "isolated") return isolatedResolve(spec);
+      let resolved;
+      let failure;
+      let failed = false;
+      try {
+        resolved = nodeRequire.resolve(spec);
+      } catch (err) {
+        failed = true;
+        failure = err;
+      }
+      if (!postChecked) {
+        postChecked = true;
+        let after;
+        try {
+          after = sha256(readFileSync8(pkgJson, "utf8"));
+        } catch {
+          after = UNKNOWN;
+        }
+        if (after !== key) {
+          nodeSeenStates.set(pkgJson, UNKNOWN);
+          raced = true;
+          mode = "isolated";
+          startIsolation();
+          return isolatedResolve(spec);
+        }
+      }
+      if (failed) throw failure;
+      return resolved;
+    },
+    get stale() {
+      return stale;
+    },
+    get raced() {
+      return raced;
+    },
+    close() {
+      session?.close();
+      session = null;
+    }
+  };
+}
+function readVersion(pkgText) {
+  const pkg = JSON.parse(pkgText);
+  return typeof pkg.version === "string" ? pkg.version : void 0;
+}
+function openTokens(baseDir) {
+  const { found: pkgJson, candidates } = tokensPackageJsonCandidates(baseDir);
+  if (!pkgJson) return { resolution: { status: "not-installed" } };
+  const pkgText = readFileSync8(pkgJson, "utf8");
+  let version = readVersion(pkgText);
+  const resolver = openTokensResolver(baseDir, candidates, pkgJson, pkgText);
+  const finish = (status, indexPath) => {
+    if (resolver.raced) {
+      try {
+        version = readVersion(readFileSync8(pkgJson, "utf8"));
+      } catch {
+      }
+    }
+    const resolution = indexPath === void 0 ? { status, version } : { status, version, indexPath };
+    return { resolution: resolver.stale ? { ...resolution, stale: true } : resolution, resolver };
+  };
+  try {
+    const indexPath = resolver.resolve(tokensSpecifier("./brands"));
+    return finish("ok", indexPath);
   } catch (err) {
     const code = errorCode(err);
-    if (code === "ERR_PACKAGE_PATH_NOT_EXPORTED") return { status: "unsupported", version };
-    if (code === "MODULE_NOT_FOUND") return { status: "not-built", version };
+    if (code === "ERR_PACKAGE_PATH_NOT_EXPORTED") return finish("unsupported");
+    if (code === "MODULE_NOT_FOUND") return finish("not-built");
+    resolver.close();
     throw err;
   }
 }
@@ -5402,8 +5849,8 @@ function readBrandIndex(indexPath) {
   }
   return data.brands;
 }
-function readSummary(baseDir, entry) {
-  const metaPath = projectRequire(baseDir).resolve(tokensSpecifier(entry.meta));
+function readSummary(resolver, entry) {
+  const metaPath = resolver.resolve(tokensSpecifier(entry.meta));
   const meta = readJsonFile(metaPath);
   return {
     name: entry.name,
@@ -5414,20 +5861,33 @@ function readSummary(baseDir, entry) {
   };
 }
 function listBrands(baseDir) {
-  const tokens = resolveTokens(baseDir);
-  if (tokens.status !== "ok" || !tokens.indexPath) {
+  const { resolution: tokens, resolver } = openTokens(baseDir);
+  try {
+    return withStaleOf(resolver, listBrandsWith(tokens, resolver));
+  } finally {
+    resolver?.close();
+  }
+}
+function listBrandsWith(tokens, resolver) {
+  if (tokens.status !== "ok" || !tokens.indexPath || !resolver) {
     return { status: tokens.status, version: tokens.version, brands: [] };
   }
   const entries = readBrandIndex(tokens.indexPath);
-  let brands;
-  try {
-    brands = entries.map((entry) => readSummary(baseDir, entry));
-  } catch (err) {
-    if (isMissingBuildFile(err)) return { status: "not-built", version: tokens.version, brands: [] };
-    throw err;
+  const brands = [];
+  for (const entry of entries) {
+    try {
+      brands.push(readSummary(resolver, entry));
+    } catch (err) {
+      if (isMissingBuildFile(err)) return { status: "not-built", version: tokens.version, brands: [] };
+      if (resolver.stale && errorCode(err) === "ERR_PACKAGE_PATH_NOT_EXPORTED") continue;
+      throw err;
+    }
   }
   return { status: "ok", version: tokens.version, brands };
 }
+function withStaleOf(resolver, result) {
+  return resolver?.stale ? { ...result, stale: true } : result;
+}
 function stripComments(css) {
   return css.replace(/\/\*[\s\S]*?\*\//g, "");
 }
@@ -5539,8 +5999,15 @@ function readProjectPackageJson(baseDir) {
   }
 }
 function getBrand(baseDir, name) {
-  const tokens = resolveTokens(baseDir);
-  if (tokens.status !== "ok" || !tokens.indexPath) {
+  const { resolution: tokens, resolver } = openTokens(baseDir);
+  try {
+    return withStaleOf(resolver, getBrandWith(tokens, resolver, name));
+  } finally {
+    resolver?.close();
+  }
+}
+function getBrandWith(tokens, resolver, name) {
+  if (tokens.status !== "ok" || !tokens.indexPath || !resolver) {
     return { status: tokens.status, version: tokens.version, brand: null, available: [] };
   }
   const entries = readBrandIndex(tokens.indexPath);
@@ -5552,11 +6019,14 @@ function getBrand(baseDir, name) {
   let summary;
   let parsed;
   try {
-    summary = readSummary(baseDir, entry);
-    const cssPath = projectRequire(baseDir).resolve(summary.importPath);
+    summary = readSummary(resolver, entry);
+    const cssPath = resolver.resolve(summary.importPath);
     parsed = parseBrandCss(readFileSync8(cssPath, "utf8"), name);
   } catch (err) {
     if (isMissingBuildFile(err)) return { status: "not-built", version: tokens.version, brand: null, available: [] };
+    if (resolver.stale && errorCode(err) === "ERR_PACKAGE_PATH_NOT_EXPORTED") {
+      return { status: "ok", version: tokens.version, brand: null, available: available.filter((n) => n !== name) };
+    }
     throw err;
   }
   return {
@@ -5632,11 +6102,15 @@ function checkDependencies(baseDirInput) {
   if (missingRecommended.length > 0) problems.push(`\uAD8C\uC7A5 \uC758\uC874\uC131 \uB204\uB77D: ${missingRecommended.join(", ")}`);
   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`);
+  const installCommand = detectInstallCommand(baseDir);
   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)}`);
+    const phrase = installCommandPhrase(installCommand, notInstalledOther.some((d) => fromRoot(d)));
+    problems.push(`\uC120\uC5B8\uB410\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC740 \uC758\uC874\uC131: ${notInstalledOther.join(", ")} \u2192 ${phrase}`);
   }
   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)}`);
+    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 ${installCommandPhrase(installCommand, true)}`
+    );
   }
   if (problems.length > 0) {
     return { name: "dependencies", severity: "warn", message: problems.join(" / ") + (rootNote ? ` (${rootNote})` : "") };
@@ -5649,6 +6123,192 @@ function checkDependencies(baseDirInput) {
   };
 }
 
+// ../axis-registry-core/src/template/apply-files.ts
+import { existsSync as existsSync9, lstatSync as lstatSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync10, readdirSync as readdirSync3, realpathSync as realpathSync4, rmdirSync, unlinkSync, writeFileSync as writeFileSync2 } from "fs";
+import path9 from "path";
+var TemplatePathError = class extends Error {
+  constructor(relPath, reason) {
+    super(`\uD15C\uD50C\uB9BF \uACBD\uB85C '${relPath}' \uAC00 \uB300\uC0C1 \uB514\uB809\uD130\uB9AC \uBC16\uC744 \uAC00\uB9AC\uCF1C(${reason}) \uC911\uB2E8\uD588\uC2B5\uB2C8\uB2E4. \uC544\uBB34 \uD30C\uC77C\uB3C4 \uBC14\uAFB8\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4`);
+    this.relPath = relPath;
+    this.reason = reason;
+    this.name = "TemplatePathError";
+  }
+};
+function realpathOfExisting(p) {
+  const rest = [];
+  let cur = p;
+  for (; ; ) {
+    try {
+      lstatSync3(cur);
+      break;
+    } catch {
+      const parent = path9.dirname(cur);
+      if (parent === cur) break;
+      rest.unshift(path9.basename(cur));
+      cur = parent;
+    }
+  }
+  try {
+    return path9.join(realpathSync4(cur), ...rest);
+  } catch {
+    return void 0;
+  }
+}
+function isInside(root, target) {
+  const rel2 = path9.relative(root, target);
+  return rel2 !== "" && !rel2.startsWith("..") && !path9.isAbsolute(rel2);
+}
+function resolveTemplatePath(baseDir, relPath) {
+  if (typeof relPath !== "string" || relPath === "" || relPath.includes("\0")) {
+    throw new TemplatePathError(String(relPath), "\uBE48 \uACBD\uB85C \uB610\uB294 \uC798\uBABB\uB41C \uBB38\uC790");
+  }
+  if (path9.isAbsolute(relPath) || path9.win32.isAbsolute(relPath)) throw new TemplatePathError(relPath, "\uC808\uB300 \uACBD\uB85C");
+  const base = path9.resolve(baseDir);
+  const dest = path9.resolve(base, relPath);
+  if (!isInside(base, dest)) throw new TemplatePathError(relPath, "\uC0C1\uC704 \uB514\uB809\uD130\uB9AC\uB85C \uB098\uAC10");
+  const baseReal = realpathOfExisting(base);
+  const destReal = realpathOfExisting(dest);
+  if (!baseReal || !destReal || !isInside(baseReal, destReal)) {
+    throw new TemplatePathError(relPath, "\uC2EC\uBCFC\uB9AD \uB9C1\uD06C\uAC00 \uB300\uC0C1 \uB514\uB809\uD130\uB9AC \uBC16\uC744 \uAC00\uB9AC\uD0B4");
+  }
+  return dest;
+}
+function assertTemplatePaths(baseDir, relPaths) {
+  for (const p of relPaths) resolveTemplatePath(baseDir, p);
+}
+var PACKAGE_JSON_MERGED_MAPS = [
+  "scripts",
+  "dependencies",
+  "devDependencies",
+  "peerDependencies",
+  "optionalDependencies"
+];
+function isPlainObject3(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function parseObject(text) {
+  try {
+    const v = JSON.parse(text);
+    return isPlainObject3(v) ? v : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function mergePackageJson(user, template) {
+  const maps = new Set(PACKAGE_JSON_MERGED_MAPS);
+  const out = {};
+  for (const [key, value] of Object.entries(user)) {
+    const tpl = template[key];
+    if (maps.has(key) && isPlainObject3(tpl)) {
+      out[key] = isPlainObject3(value) ? { ...value, ...tpl } : tpl;
+    } else {
+      out[key] = value;
+    }
+  }
+  for (const [key, value] of Object.entries(template)) {
+    if (!(key in out)) out[key] = value;
+  }
+  return out;
+}
+function mergeAxisConfigJson(user, template) {
+  return { ...user, ...template };
+}
+function detectJsonIndent(text) {
+  const m = /^([ \t]+)\S/m.exec(text);
+  if (!m) return 2;
+  return m[1].startsWith("	") ? "	" : m[1].length;
+}
+function serializeLike(before, value) {
+  const crlf = before.includes("\r\n");
+  const trailing = /\r?\n$/.test(before);
+  let text = JSON.stringify(value, null, detectJsonIndent(before));
+  if (trailing) text += "\n";
+  return crlf ? text.replace(/\n/g, "\r\n") : text;
+}
+var MERGERS = {
+  "package.json": mergePackageJson,
+  "axis.config.json": mergeAxisConfigJson
+};
+function planTemplateFileContent(relPath, templateContent, before) {
+  if (before === void 0) return { action: "created", content: templateContent };
+  const merger = MERGERS[relPath.replace(/^\.\//, "")];
+  if (!merger) return { action: "overwritten", content: templateContent };
+  const user = parseObject(before);
+  const template = parseObject(templateContent);
+  if (!user || !template) {
+    return {
+      action: "overwritten",
+      content: templateContent,
+      note: `\uAE30\uC874 ${relPath} \uC744 JSON \uAC1D\uCCB4\uB85C \uC77D\uC744 \uC218 \uC5C6\uC5B4 \uD15C\uD50C\uB9BF \uB0B4\uC6A9\uC73C\uB85C \uB36E\uC5B4\uC501\uB2C8\uB2E4`
+    };
+  }
+  return { action: "merged", content: serializeLike(before, merger(user, template)) };
+}
+function planTemplateFiles(baseDir, files, extraPaths = []) {
+  const dests = files.map((file) => resolveTemplatePath(baseDir, file.path));
+  assertTemplatePaths(baseDir, extraPaths);
+  return files.map((file, i) => {
+    const dest = dests[i];
+    const before = existsSync9(dest) ? readFileSync10(dest, "utf8") : void 0;
+    return { path: file.path, dest, before, ...planTemplateFileContent(file.path, file.content, before) };
+  });
+}
+var TemplateApplyError = class extends Error {
+  constructor(message, restored, unrestored) {
+    super(message);
+    this.restored = restored;
+    this.unrestored = unrestored;
+    this.name = "TemplateApplyError";
+  }
+};
+function writeTemplateFiles(plan) {
+  const done = [];
+  const madeDirs = [];
+  try {
+    for (const item of plan) {
+      const dir = path9.dirname(item.dest);
+      if (!existsSync9(dir)) {
+        const fresh = [];
+        for (let d = dir; !existsSync9(d); d = path9.dirname(d)) fresh.unshift(d);
+        mkdirSync2(dir, { recursive: true });
+        madeDirs.push(...fresh);
+      }
+      writeFileSync2(item.dest, item.content);
+      done.push(item);
+    }
+  } catch (err) {
+    const restored = [];
+    const unrestored = [];
+    const failed = plan[done.length];
+    const targets = failed ? [...done, failed] : done;
+    for (const item of targets.reverse()) {
+      try {
+        if (item.before === void 0) {
+          if (existsSync9(item.dest)) unlinkSync(item.dest);
+        } else {
+          writeFileSync2(item.dest, item.before);
+        }
+        restored.push(item.path);
+      } catch {
+        unrestored.push(item.path);
+      }
+    }
+    for (const d of madeDirs.reverse()) {
+      try {
+        if (existsSync9(d) && readdirSync3(d).length === 0) rmdirSync(d);
+      } catch {
+      }
+    }
+    const reason = err instanceof Error ? err.message : String(err);
+    const tail = unrestored.length > 0 ? ` \uB418\uB3CC\uB9AC\uC9C0 \uBABB\uD55C \uD30C\uC77C: ${unrestored.join(", ")}` : "";
+    throw new TemplateApplyError(
+      `\uD15C\uD50C\uB9BF \uD30C\uC77C\uC744 \uC4F0\uB294 \uB3C4\uC911 \uC2E4\uD328\uD574 \uAC74\uB4DC\uB9B0 \uD30C\uC77C ${restored.length}\uAC1C\uB97C \uC6D0\uB798\uB300\uB85C \uB418\uB3CC\uB838\uC2B5\uB2C8\uB2E4(${reason}).${tail}`,
+      restored.reverse(),
+      unrestored
+    );
+  }
+}
+
 // src/site.ts
 var AXIS_SITE_URL2 = "https://axis-design-system.pages.dev";
 
@@ -5702,24 +6362,18 @@ async function handleGetTemplate(params) {
 }
 async function handleApplyTemplate(params) {
   const detail = await fetchTemplateDetail(params.name);
-  const baseDir = path9.resolve(params.targetDir);
+  const baseDir = path10.resolve(params.targetDir);
   const installCommand = detectInstallCommand(baseDir);
-  const files = [];
-  for (const file of detail.files) {
-    const dest = path9.join(baseDir, file.path);
-    const exists = await fs6.pathExists(dest);
-    if (!params.dryRun) {
-      await fs6.ensureDir(path9.dirname(dest));
-      await fs6.writeFile(dest, file.content);
-    }
-    files.push({
-      path: file.path,
-      action: exists ? "overwritten" : "created"
-    });
-  }
+  const plan = planTemplateFiles(baseDir, detail.files, (detail.postInstall ?? []).map((p) => p.file));
+  if (!params.dryRun) writeTemplateFiles(plan);
+  const files = plan.map((item) => ({
+    path: item.path,
+    action: item.action,
+    ...item.note ? { note: item.note } : {}
+  }));
   if (!params.dryRun && detail.postInstall?.length) {
     for (const patch of detail.postInstall) {
-      const target = path9.join(baseDir, patch.file);
+      const target = resolveTemplatePath(baseDir, patch.file);
       if (!await fs6.pathExists(target)) continue;
       if (patch.type === "replace" && patch.search && patch.value) {
         const content = await fs6.readFile(target, "utf-8");
@@ -5747,10 +6401,11 @@ async function handleApplyTemplate(params) {
 }
 async function handleDiffTemplate(params) {
   const detail = await fetchTemplateDetail(params.name);
-  const baseDir = path9.resolve(params.targetDir || ".");
+  const baseDir = path10.resolve(params.targetDir || ".");
   const entries = [];
-  for (const file of detail.files) {
-    const localPath = path9.join(baseDir, file.path);
+  const localPaths = detail.files.map((file) => resolveTemplatePath(baseDir, file.path));
+  for (const [i, file] of detail.files.entries()) {
+    const localPath = localPaths[i];
     if (!await fs6.pathExists(localPath)) {
       entries.push({ path: file.path, status: "added" });
       continue;
@@ -5838,9 +6493,9 @@ function brandActivationResult(check) {
   };
 }
 async function handleCheckProject(params) {
-  const baseDir = path9.resolve(params.targetDir || ".");
+  const baseDir = path10.resolve(params.targetDir || ".");
   const results = [];
-  const configExists = await fs6.pathExists(path9.join(baseDir, "axis.config.json"));
+  const configExists = await fs6.pathExists(path10.join(baseDir, "axis.config.json"));
   results.push({
     name: "axis.config.json",
     severity: configExists ? "pass" : "fail",
@@ -5857,7 +6512,7 @@ async function handleCheckProject(params) {
   ];
   let utilsFound = false;
   for (const candidate of utilsCandidates) {
-    const fullPath = path9.join(baseDir, candidate);
+    const fullPath = path10.join(baseDir, candidate);
     if (await fs6.pathExists(fullPath)) {
       const content2 = await fs6.readFile(fullPath, "utf-8");
       const hasCn = content2.includes("function cn");
@@ -5948,9 +6603,15 @@ function formatApplyTemplateResult(result) {
 `);
   if (result.files.length > 0) {
     lines.push("### \uD30C\uC77C", "");
+    const label = {
+      created: "\uC0DD\uC131",
+      overwritten: "\uB36E\uC5B4\uC4F0\uAE30",
+      merged: "\uD569\uCE58\uAE30: \uAE30\uC874 \uD544\uB4DC\uB97C \uB450\uACE0 \uD15C\uD50C\uB9BF \uD0A4\uB97C \uD569\uCE68"
+    };
     for (const f of result.files) {
       const icon = f.action === "created" ? "+" : "~";
-      lines.push(`- ${icon} ${f.path} (${f.action === "created" ? "\uC0DD\uC131" : "\uB36E\uC5B4\uC4F0\uAE30"})`);
+      lines.push(`- ${icon} ${f.path} (${label[f.action]})`);
+      if (f.note) lines.push(`  - ! ${f.note}`);
     }
   }
   const deps = Object.entries(result.dependencies);
@@ -6002,10 +6663,10 @@ function formatCheckProjectResult(result) {
 }
 
 // src/tools/brand.ts
-import path10 from "path";
+import path11 from "path";
 var TOKENS_INSTALL_COMMAND = addCommandFor("pnpm install", { [TOKENS_PACKAGE]: `^${TOKENS_DEPENDENCY_MIN_VERSION}` });
 function baseDirOf(targetDir) {
-  return path10.resolve(targetDir || process.cwd());
+  return path11.resolve(targetDir || process.cwd());
 }
 function tokensInstallGuideFor(targetDir) {
   return dependencyInstallGuide(baseDirOf(targetDir), TOKENS_PACKAGE, `^${TOKENS_DEPENDENCY_MIN_VERSION}`);
@@ -6043,7 +6704,16 @@ function formatTokensStatusGuide(status, version, installCommand = TOKENS_INSTAL
       ].join("\n");
   }
 }
+var STALE_TOKENS_NOTE = `- \uC8FC\uC758: \uC774 MCP \uC11C\uBC84\uAC00 ${TOKENS_PACKAGE} \uB97C \uCC98\uC74C \uC77D\uC740 \uB4A4 \uB0B4\uC6A9\uC774 \uBC14\uB00C\uC5C8\uB294\uB370 \uC0C8 \uC0C1\uD0DC\uB97C \uB2E4\uC2DC \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uC704 \uACB0\uACFC\uB294 \uC774\uC804 \uC124\uCE58 \uAE30\uC900\uC77C \uC218 \uC788\uC73C\uB2C8 MCP \uC11C\uBC84\uB97C \uB2E4\uC2DC \uC2DC\uC791\uD558\uC138\uC694.`;
+function withStaleNote(text, result) {
+  return result.stale ? `${text}
+
+${STALE_TOKENS_NOTE}` : text;
+}
 function formatListBrandsResult(result, installCommand) {
+  return withStaleNote(listBrandsText(result, installCommand), result);
+}
+function listBrandsText(result, installCommand) {
   const lines = ["## AXIS \uBE0C\uB79C\uB4DC\n"];
   if (result.status !== "ok") {
     lines.push(formatTokensStatusGuide(result.status, result.version, installCommand));
@@ -6081,6 +6751,9 @@ function tokenTable(brand) {
   return lines;
 }
 function formatGetBrandResult(result, name, installCommand) {
+  return withStaleNote(getBrandText(result, name, installCommand), result);
+}
+function getBrandText(result, name, installCommand) {
   if (result.status !== "ok") {
     return [`## \uBE0C\uB79C\uB4DC: ${name}
 `, formatTokensStatusGuide(result.status, result.version, installCommand)].join("\n");
@@ -6281,10 +6954,10 @@ server.tool(
   {
     path: z.string().describe("\uD1A0\uD070 \uACBD\uB85C (\uC608: colors.primary, spacing.4, control.h.md) \uB610\uB294 CSS \uBCC0\uC218 \uC774\uB984 (\uC608: --axis-control-h-md)")
   },
-  async ({ path: path11 }) => {
+  async ({ path: path12 }) => {
     try {
-      const token = handleGetToken({ path: path11 });
-      const formatted = formatTokenDetail(token, path11);
+      const token = handleGetToken({ path: path12 });
+      const formatted = formatTokenDetail(token, path12);
       return {
         content: [
           {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axis-ds/mcp",
-  "version": "1.4.6",
+  "version": "1.4.8",
   "type": "module",
   "description": "AXIS Design System - MCP Server for AI-assisted component discovery",
   "bin": {