@axis-ds/cli 1.7.8 → 1.7.10

package/dist/index.js

@@ -21,20 +21,24 @@ import {
   findPnpUnpluggedPackages,
   globalCssSelectionNote,
   hasDependency,
+  installCommandPhrase,
   isPlainObject,
   isPnpProject,
   outsideCssPackageResolution,
+  pnpComponentSourceHidden,
   pnpProjectRoot,
   pnpRootOnlyDependency,
+  pnpUnplugSetupPhrase,
   projectFileExists,
   resolveBaseDir,
   rootDeclarationsAllowed,
   runScriptCommand,
   selectGlobalCss,
+  tailwindConfigImportResolution,
   tokensCssResolution,
   workspaceRootPackage,
   workspaceRunCommand
-} from "./chunk-C2T7NVDG.js";
+} from "./chunk-EAUM5S4O.js";
 import {
   V0Client
 } from "./chunk-2PNCUPCG.js";
@@ -1849,11 +1853,199 @@ import ora3 from "ora";
 
 // src/template/post-install.ts
 import fs6 from "fs-extra";
-import path6 from "path";
 import chalk4 from "chalk";
+
+// ../axis-registry-core/src/template/apply-files.ts
+import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmdirSync, unlinkSync, writeFileSync } from "fs";
+import path6 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 {
+      lstatSync(cur);
+      break;
+    } catch {
+      const parent = path6.dirname(cur);
+      if (parent === cur) break;
+      rest.unshift(path6.basename(cur));
+      cur = parent;
+    }
+  }
+  try {
+    return path6.join(realpathSync(cur), ...rest);
+  } catch {
+    return void 0;
+  }
+}
+function isInside(root, target) {
+  const rel3 = path6.relative(root, target);
+  return rel3 !== "" && !rel3.startsWith("..") && !path6.isAbsolute(rel3);
+}
+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 (path6.isAbsolute(relPath) || path6.win32.isAbsolute(relPath)) throw new TemplatePathError(relPath, "\uC808\uB300 \uACBD\uB85C");
+  const base = path6.resolve(baseDir);
+  const dest = path6.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 isPlainObject2(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function parseObject(text) {
+  try {
+    const v = JSON.parse(text);
+    return isPlainObject2(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) && isPlainObject2(tpl)) {
+      out[key] = isPlainObject2(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 = existsSync(dest) ? readFileSync(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 = path6.dirname(item.dest);
+      if (!existsSync(dir)) {
+        const fresh = [];
+        for (let d = dir; !existsSync(d); d = path6.dirname(d)) fresh.unshift(d);
+        mkdirSync(dir, { recursive: true });
+        madeDirs.push(...fresh);
+      }
+      writeFileSync(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 (existsSync(item.dest)) unlinkSync(item.dest);
+        } else {
+          writeFileSync(item.dest, item.before);
+        }
+        restored.push(item.path);
+      } catch {
+        unrestored.push(item.path);
+      }
+    }
+    for (const d of madeDirs.reverse()) {
+      try {
+        if (existsSync(d) && readdirSync(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/template/post-install.ts
 async function runPostInstall(patches, baseDir, dryRun = false) {
+  assertTemplatePaths(baseDir, patches.map((p) => p.file));
   for (const patch of patches) {
-    const filePath = path6.resolve(baseDir, patch.file);
+    const filePath = resolveTemplatePath(baseDir, patch.file);
     if (dryRun) {
       console.log(chalk4.gray(`  [dry-run] patch ${patch.type}: ${patch.file}`));
       continue;
@@ -1940,15 +2132,12 @@ async function readAxisConfig(baseDir) {
 }
 
 // ../axis-registry-core/src/template/tailwind-core.ts
-import { existsSync, lstatSync, readdirSync, readFileSync, realpathSync, statSync } from "fs";
+import { existsSync as existsSync2, lstatSync as lstatSync2, readdirSync as readdirSync2, readFileSync as readFileSync2, realpathSync as realpathSync2, statSync } from "fs";
 import { basename, dirname, extname, isAbsolute, join, 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) {
+function isPlainObject3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var VERSION = String.raw`v?(\d+)(?:\.(\d+|[xX*]))?(?:\.(\d+|[xX*]))?(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?`;
@@ -2125,10 +2314,10 @@ function regularFile(file) {
 }
 function expandGlobalCss(baseDirInput, entryPath, entryRel, entryCssDir) {
   const baseDir = resolveBaseDir(baseDirInput);
-  const entry = readFileSync(entryPath, "utf8");
+  const entry = readFileSync2(entryPath, "utf8");
   let entryReal = entryPath;
   try {
-    entryReal = realpathSync(entryPath);
+    entryReal = realpathSync2(entryPath);
   } catch {
   }
   const raws = /* @__PURE__ */ new Map([[entryReal, entry]]);
@@ -2185,7 +2374,7 @@ function walkRelativeCssImports(baseDir, entryReal, raws, limit, includeConditio
       if (target === void 0) continue;
       let real;
       try {
-        real = realpathSync(target);
+        real = realpathSync2(target);
       } catch {
         continue;
       }
@@ -2198,7 +2387,7 @@ function walkRelativeCssImports(baseDir, entryReal, raws, limit, includeConditio
       if (rel3 === "" || rel3 === ".." || rel3.startsWith(`..${sep}`) || isAbsolute(rel3)) continue;
       if (!raws.has(real)) {
         try {
-          raws.set(real, readFileSync(real, "utf8"));
+          raws.set(real, readFileSync2(real, "utf8"));
         } catch {
           continue;
         }
@@ -2228,10 +2417,10 @@ function findLayoutTokensCssImport(baseDirInput) {
   const baseDir = resolveBaseDir(baseDirInput);
   for (const candidate of ROOT_LAYOUT_FILES) {
     const file = join(baseDir, candidate);
-    if (!existsSync(file)) continue;
+    if (!existsSync2(file)) continue;
     let text;
     try {
-      text = readFileSync(file, "utf8");
+      text = readFileSync2(file, "utf8");
     } catch {
       continue;
     }
@@ -2273,18 +2462,19 @@ function packageNameOfSpec(spec) {
 function displayRel(baseDir, p) {
   return relative(baseDir, p).split(sep).join("/");
 }
-function packageLineShadowIssue(baseDir, expanded, origin, spec) {
+function packageLineShadowIssue(baseDir, expanded, origin, spec, opts = {}) {
   const name = packageNameOfSpec(spec);
   const lineDir = dirname(origin.path);
   const others = () => [...new Set(expanded.files.map((f) => dirname(f.path)))].filter((d) => d !== lineDir);
   const r = cssPackageLineResolution(baseDir, lineDir, spec, others);
   const head = `${spec} import \uAC00 \uC788\uC9C0\uB9CC \uADF8 \uC904\uC774 \uC788\uB294 \uD30C\uC77C \uC704\uCE58\uC5D0\uC11C`;
   const label = (pkgDir, version) => `${displayRel(baseDir, pkgDir)}(${version ?? "\uBC84\uC804 \uBAA8\uB984"})`;
+  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 = r.version !== void 0 && (compareExactVersions(r.version, TAILWIND4_MIN_AXIS_VERSION) ?? -1) >= 0;
+      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}`;
     }
@@ -2327,13 +2517,20 @@ function judgeGlobalsCss(baseDir, selection, candidate, expanded) {
     const origin = evidenceOrigin(expanded, (f) => findTokensCssImport(f) === imported);
     via = cssImportViaNote(viaFiles([origin]));
     const tailwind4 = (detectTailwind(baseDir, pkg).major ?? 0) >= 4;
-    const issue = tailwind4 && origin !== void 0 && !isOutsideEntry(origin) ? tokensCssUnresolvedIssue(
+    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));
+    ) : 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))) {
@@ -2537,6 +2734,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));
 }
@@ -2564,7 +2763,7 @@ function hasBareCjsPresetRequire(code) {
 function isCommonJsConfig(file, source) {
   return extname(file) === ".cjs" || /\bmodule\.exports\b/.test(source);
 }
-function presetTokensUnresolvedMessage(baseDir, pkg, file, bareCjs) {
+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") {
@@ -2573,6 +2772,14 @@ function presetTokensUnresolvedMessage(baseDir, pkg, file, bareCjs) {
   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 = {}) {
@@ -2604,8 +2811,8 @@ function versionGateLabel(gate) {
 }
 function readPackageJson(baseDir) {
   try {
-    const parsed = JSON.parse(readFileSync(join(baseDir, "package.json"), "utf8"));
-    return isPlainObject2(parsed) ? parsed : void 0;
+    const parsed = JSON.parse(readFileSync2(join(baseDir, "package.json"), "utf8"));
+    return isPlainObject3(parsed) ? parsed : void 0;
   } catch {
     return void 0;
   }
@@ -2627,7 +2834,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) {
@@ -2643,12 +2851,17 @@ 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 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;
@@ -2667,6 +2880,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) {
@@ -2763,12 +2983,12 @@ function checkTailwindSetup(baseDirInput) {
   }
   for (const file of TAILWIND_CONFIG_FILES) {
     const path17 = join(baseDir, file);
-    if (!existsSync(path17)) continue;
-    const content = readFileSync(path17, "utf8");
+    if (!existsSync2(path17)) continue;
+    const content = readFileSync2(path17, "utf8");
     if (hasTokensPresetReference(content)) {
       const code = stripJsComments(content);
       const bareCjs = isCommonJsConfig(file, code) && hasBareCjsPresetRequire(code);
-      const unresolved = presetTokensUnresolvedMessage(baseDir, pkg, file, bareCjs);
+      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 });
@@ -2801,8 +3021,8 @@ function checkTailwindSetup(baseDirInput) {
 }
 function readAxisConfigLike(baseDir) {
   try {
-    const parsed = JSON.parse(readFileSync(join(baseDir, "axis.config.json"), "utf8"));
-    return isPlainObject2(parsed) ? parsed : void 0;
+    const parsed = JSON.parse(readFileSync2(join(baseDir, "axis.config.json"), "utf8"));
+    return isPlainObject3(parsed) ? parsed : void 0;
   } catch {
     return void 0;
   }
@@ -2904,7 +3124,7 @@ function realpathPosix(p) {
   const tail = [];
   for (let i = 0; i < 64; i++) {
     try {
-      return [realpathSync(cur), ...tail].join(sep).split(sep).join("/");
+      return [realpathSync2(cur), ...tail].join(sep).split(sep).join("/");
     } catch {
       const parent = dirname(cur);
       if (parent === cur) return void 0;
@@ -2960,15 +3180,15 @@ function relDirOf(baseDir, dir) {
 }
 function realDir(dir) {
   try {
-    return realpathSync(dir);
+    return realpathSync2(dir);
   } catch {
     return void 0;
   }
 }
 function packageVersion(dir) {
   try {
-    const parsed = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
-    return isPlainObject2(parsed) && typeof parsed.version === "string" ? parsed.version : void 0;
+    const parsed = JSON.parse(readFileSync2(join(dir, "package.json"), "utf8"));
+    return isPlainObject3(parsed) && typeof parsed.version === "string" ? parsed.version : void 0;
   } catch {
     return void 0;
   }
@@ -3003,7 +3223,7 @@ function packageContentTarget(baseDir, name, pkg) {
     let dir = dirname(resolve(found.dir, ...name.split("/").map(() => ".."), ".."));
     for (; ; ) {
       const candidate = join(dir, "node_modules", ...name.split("/"));
-      const rel3 = existsSync(join(candidate, "package.json")) ? relDirOf(baseDir, candidate) : void 0;
+      const rel3 = existsSync2(join(candidate, "package.json")) ? relDirOf(baseDir, candidate) : void 0;
       if (rel3 !== void 0) {
         const candidateReal = realDir(candidate);
         if (candidateReal === real) alternates.push(`${rel3}/dist/index.js`);
@@ -3080,7 +3300,7 @@ function inspectTailwindContent(baseDirInput) {
   const pkg = readPackageJson(baseDir);
   const tailwind = detectTailwind(baseDir, pkg);
   if (tailwind.major !== void 0 && tailwind.major >= 4) return null;
-  const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync(join(baseDir, f)));
+  const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync2(join(baseDir, f)));
   if (configFile === void 0) return null;
   const targets = [];
   const componentsDir = readAxisConfigLike(baseDir)?.componentsDir;
@@ -3094,7 +3314,7 @@ function inspectTailwindContent(baseDirInput) {
     }
   }
   if (targets.length === 0) return null;
-  const read = readTailwindContent(readFileSync(join(baseDir, configFile), "utf8"));
+  const read = readTailwindContent(readFileSync2(join(baseDir, configFile), "utf8"));
   const globs = (read?.globs ?? []).filter((g) => !g.trim().startsWith("!"));
   return {
     configFile,
@@ -3162,7 +3382,7 @@ function componentsUseAnimation(baseDir, componentsDir) {
     const [dir, depth] = stack.pop();
     let names;
     try {
-      names = readdirSync(dir);
+      names = readdirSync2(dir);
     } catch {
       continue;
     }
@@ -3171,7 +3391,7 @@ function componentsUseAnimation(baseDir, componentsDir) {
       const p = join(dir, name);
       let st;
       try {
-        st = lstatSync(p);
+        st = lstatSync2(p);
       } catch {
         continue;
       }
@@ -3179,12 +3399,39 @@ function componentsUseAnimation(baseDir, componentsDir) {
       if (st.isDirectory()) {
         if (name !== "node_modules" && depth < ANIMATION_SCAN_DEPTH_LIMIT) stack.push([p, depth + 1]);
       } else if (st.isFile() && st.size <= ANIMATION_SCAN_FILE_BYTES && /\.(tsx|ts|jsx|js)$/.test(name)) {
-        if (/\banimate-(?:in|out)\b/.test(readFileSync(p, "utf8"))) return true;
+        if (/\banimate-(?:in|out)\b/.test(readFileSync2(p, "utf8"))) return true;
       }
     }
   }
   return false;
 }
+function animationPluginProblem(baseDir, pkg, name, pnp) {
+  const declared = declaredDependency(baseDir, pkg, name, void 0, { appOnlyInPnp: true });
+  if (declared === void 0) {
+    return pnpRootOnlyDependency(baseDir, pkg, name) !== void 0 ? { name, kind: "pnpRootOnly", why: `${name} \uAC00 ${PNP_ROOT_ONLY_NOTE}` } : { name, kind: "undeclared", why: `${name} \uC120\uC5B8 \uC5C6\uC74C` };
+  }
+  if (!pnp && findInstalledPackage(baseDir, name) === void 0) {
+    return { name, kind: "notInstalled", why: `${name} \uBBF8\uC124\uCE58(\uC120\uC5B8\uB9CC \uC788\uC74C)`, root: declared.source === "root" };
+  }
+  return void 0;
+}
+function inspectTailwind4Animation(baseDirInput, pkgInput) {
+  const baseDir = resolveBaseDir(baseDirInput);
+  const pkg = pkgInput ?? readPackageJson(baseDir);
+  const pnp = isPnpProject(baseDir);
+  const selection = selectCheckGlobalCss(baseDir);
+  const note = globalCssSelectionNote(selection);
+  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))])) : "";
+  const problems = lines.map((name) => animationPluginProblem(baseDir, pkg, name, pnp)).filter((p) => p !== void 0);
+  return { selection, file: selection.rel, note, via, lines, problems };
+}
 function checkAnimationPlugin(baseDirInput) {
   const baseDir = resolveBaseDir(baseDirInput);
   const pkg = readPackageJson(baseDir);
@@ -3195,25 +3442,8 @@ function checkAnimationPlugin(baseDirInput) {
   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 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))])) : "";
+    const { file, note, via, lines, problems } = inspectTailwind4Animation(baseDir, pkg);
     if (lines.length === 0) {
       return {
         name: "animation",
@@ -3221,7 +3451,6 @@ function checkAnimationPlugin(baseDirInput) {
         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",
@@ -3229,10 +3458,10 @@ function checkAnimationPlugin(baseDirInput) {
       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) => existsSync(join(baseDir, f)));
-  const source = configFile !== void 0 ? stripJsComments(readFileSync(join(baseDir, configFile), "utf8")) : "";
+  const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync2(join(baseDir, f)));
+  const source = configFile !== void 0 ? stripJsComments(readFileSync2(join(baseDir, configFile), "utf8")) : "";
   const plugins = configFile !== void 0 ? readAnimationPluginUse(source) : "absent";
-  const pluginReason = pluginProblem(ANIMATION_PLUGIN_TAILWIND3);
+  const pluginReason = animationPluginProblem(baseDir, pkg, ANIMATION_PLUGIN_TAILWIND3, pnp)?.why;
   if (plugins === "found" && pluginReason === void 0) {
     return { name: "animation", severity: "pass", message: `${configFile}\uC758 plugins \uC5D0 ${ANIMATION_PLUGIN_TAILWIND3} \uAC00 \uC788\uC2B5\uB2C8\uB2E4` };
   }
@@ -3318,6 +3547,12 @@ function splitTopLevel(body) {
 }
 
 // src/template/template-apply.ts
+var ACTION_LABEL = {
+  created: "\uC0DD\uC131",
+  overwritten: "\uB36E\uC5B4\uC4F0\uAE30",
+  merged: "\uD569\uCE58\uAE30"
+};
+var MERGED_HINT = "\uAE30\uC874 \uD544\uB4DC\uB97C \uB450\uACE0 \uD15C\uD50C\uB9BF \uD0A4\uB97C \uD569\uCE68";
 function templateDependencyCommands(installCommand, detail) {
   const lines = [];
   const deps = detail.dependencies ?? {};
@@ -3372,18 +3607,21 @@ async function applyTemplate(slug, options) {
   for (const w of await templateApplyWarnings(baseDir, detail)) {
     console.log(chalk5.yellow(`! ${w}`));
   }
-  const conflicts = [];
-  for (const file of detail.files) {
-    const dest = path8.join(baseDir, file.path);
-    if (await fs8.pathExists(dest)) {
-      conflicts.push(file.path);
-    }
+  let plan;
+  try {
+    plan = planTemplateFiles(baseDir, detail.files, (detail.postInstall ?? []).map((p) => p.file));
+  } catch (err) {
+    if (!(err instanceof TemplatePathError)) throw err;
+    console.error(chalk5.red(err.message));
+    process.exitCode = 1;
+    return false;
   }
+  const conflicts = plan.filter((p) => p.action !== "created");
   if (conflicts.length > 0 && !options.yes && !options.dryRun) {
     console.log(chalk5.yellow(`
 \uAE30\uC874 \uD30C\uC77C\uACFC \uCDA9\uB3CC\uD558\uB294 ${conflicts.length}\uAC1C \uD30C\uC77C:`));
     for (const c of conflicts) {
-      console.log(chalk5.gray(`  - ${c}`));
+      console.log(chalk5.gray(`  - ${c.path}${c.action === "merged" ? ` (${MERGED_HINT})` : ""}`));
     }
     const interactive = options.interactive ?? isInteractive();
     if (!interactive) {
@@ -3391,7 +3629,7 @@ async function applyTemplate(slug, options) {
         `\uB36E\uC5B4\uC4F0\uB824\uBA74: axis template apply ${slug} -y`,
         `\uBBF8\uB9AC\uBCF4\uAE30: axis template apply ${slug} --dry-run`
       ]);
-      return;
+      return false;
     }
     const { proceed } = await ask(
       {
@@ -3404,16 +3642,16 @@ async function applyTemplate(slug, options) {
     );
     if (!proceed) {
       console.log(chalk5.gray("\uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
-      return;
+      return false;
     }
   }
   if (options.dryRun) {
     console.log(chalk5.blue("\n[\uBBF8\uB9AC\uBCF4\uAE30] \uC0DD\uC131\uB420 \uD30C\uC77C:"));
-    for (const file of detail.files) {
-      const dest = path8.join(baseDir, file.path);
-      const exists = conflicts.includes(file.path);
-      const label = exists ? chalk5.yellow("\uB36E\uC5B4\uC4F0\uAE30") : chalk5.green("\uC0DD\uC131");
-      console.log(`  ${label} ${dest}`);
+    for (const item of plan) {
+      const text = ACTION_LABEL[item.action];
+      const label = item.action === "created" ? chalk5.green(text) : chalk5.yellow(text);
+      console.log(`  ${label} ${item.dest}${item.action === "merged" ? chalk5.gray(` (${MERGED_HINT})`) : ""}`);
+      if (item.note) console.log(chalk5.yellow(`    ! ${item.note}`));
     }
     if (detail.postInstall?.length) {
       console.log(chalk5.blue("\n[\uBBF8\uB9AC\uBCF4\uAE30] postInstall \uD328\uCE58:"));
@@ -3421,15 +3659,21 @@ async function applyTemplate(slug, options) {
         console.log(chalk5.gray(`  ${p.type}: ${p.file}`));
       }
     }
-    return;
+    return false;
   }
   const writeSpinner = ora3("\uD30C\uC77C \uC0DD\uC131 \uC911...").start();
-  for (const file of detail.files) {
-    const dest = path8.join(baseDir, file.path);
-    await fs8.ensureDir(path8.dirname(dest));
-    await fs8.writeFile(dest, file.content);
+  try {
+    writeTemplateFiles(plan);
+  } catch (err) {
+    writeSpinner.fail(err.message);
+    process.exitCode = 1;
+    return false;
   }
   writeSpinner.succeed(`${detail.files.length}\uAC1C \uD30C\uC77C \uC0DD\uC131 \uC644\uB8CC`);
+  for (const item of plan) {
+    if (item.action === "merged") console.log(chalk5.gray(`  ${item.path}: ${MERGED_HINT}`));
+    if (item.note) console.log(chalk5.yellow(`! ${item.note}`));
+  }
   if (detail.postInstall?.length) {
     console.log(chalk5.blue("\npostInstall \uD328\uCE58 \uC2E4\uD589 \uC911..."));
     await runPostInstall(detail.postInstall, baseDir);
@@ -3443,6 +3687,7 @@ async function applyTemplate(slug, options) {
   }
   console.log(chalk5.green(`
 '${detail.name}' \uD15C\uD50C\uB9BF \uC801\uC6A9 \uC644\uB8CC!`));
+  return true;
 }
 async function initTemplate(slug, options) {
   const interactive = options.interactive ?? isInteractive();
@@ -3528,7 +3773,7 @@ async function initTemplate(slug, options) {
     await fs8.ensureDir(resolved);
   }
   const nextSteps = templateInitNextSteps(resolved);
-  await applyTemplate(selectedSlug, { dir: targetDir, yes: true });
+  if (!await applyTemplate(selectedSlug, { dir: targetDir, yes: true })) return;
   const configPath = path8.join(resolved, "axis.config.json");
   if (!await fs8.pathExists(configPath)) {
     const axisConfig = createTemplateConfig(selectedSlug);
@@ -3558,8 +3803,17 @@ async function diffTemplate(slug, options) {
   }
   const baseDir = path9.resolve(options.dir || ".");
   const entries = [];
-  for (const file of detail.files) {
-    const localPath = path9.join(baseDir, file.path);
+  let localPaths;
+  try {
+    localPaths = detail.files.map((file) => resolveTemplatePath(baseDir, file.path));
+  } catch (err) {
+    if (!(err instanceof TemplatePathError)) throw err;
+    console.error(chalk6.red(err.message));
+    process.exitCode = 1;
+    return;
+  }
+  for (const [i, file] of detail.files.entries()) {
+    const localPath = localPaths[i];
     if (!await fs9.pathExists(localPath)) {
       entries.push({ path: file.path, status: "added" });
       continue;
@@ -3658,7 +3912,7 @@ import chalk7 from "chalk";
 
 // src/theme/brand-core.ts
 import { createHash } from "crypto";
-import { existsSync as existsSync2, readFileSync as readFileSync2, statSync as statSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
 import { createRequire } from "module";
 import { dirname as dirname2, join as join2, relative as relative2, resolve as resolve2, sep as sep2 } from "path";
 import { MessageChannel, Worker, receiveMessageOnPort } from "worker_threads";
@@ -3682,7 +3936,7 @@ var KEY_TOKENS = [
 ];
 var BRAND_ADJUSTMENT_REFERENCE = "WI-0025 PRD \uBD80\uB85D B (docs/workitems/WI-0025-brand-theme/prd.md)";
 function readJsonFile(file) {
-  return JSON.parse(readFileSync2(file, "utf8"));
+  return JSON.parse(readFileSync3(file, "utf8"));
 }
 function errorCode(err) {
   return typeof err === "object" && err !== null && "code" in err ? String(err.code) : void 0;
@@ -3693,7 +3947,7 @@ function tokensPackageJsonCandidates(baseDir) {
   for (; ; ) {
     const candidate = join2(dir, "node_modules", TOKENS_PACKAGE, "package.json");
     candidates.push(candidate);
-    if (existsSync2(candidate)) return { found: candidate, candidates };
+    if (existsSync3(candidate)) return { found: candidate, candidates };
     const parent = dirname2(dir);
     if (parent === dir) return { candidates };
     dir = parent;
@@ -3839,7 +4093,7 @@ function openTokensResolver(baseDir, candidates, pkgJson, pkgText) {
         postChecked = true;
         let after;
         try {
-          after = sha256(readFileSync2(pkgJson, "utf8"));
+          after = sha256(readFileSync3(pkgJson, "utf8"));
         } catch {
           after = UNKNOWN;
         }
@@ -3873,13 +4127,13 @@ function readVersion(pkgText) {
 function openTokens(baseDir) {
   const { found: pkgJson, candidates } = tokensPackageJsonCandidates(baseDir);
   if (!pkgJson) return { resolution: { status: "not-installed" } };
-  const pkgText = readFileSync2(pkgJson, "utf8");
+  const pkgText = readFileSync3(pkgJson, "utf8");
   let version = readVersion(pkgText);
   const resolver = openTokensResolver(baseDir, candidates, pkgJson, pkgText);
   const finish = (status, indexPath) => {
     if (resolver.raced) {
       try {
-        version = readVersion(readFileSync2(pkgJson, "utf8"));
+        version = readVersion(readFileSync3(pkgJson, "utf8"));
       } catch {
       }
     }
@@ -3931,7 +4185,7 @@ var AXIS_CONFIG_FILE_NAME = "axis.config.json";
 function readBrandConfig(baseDir) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync2(join2(resolve2(baseDir), AXIS_CONFIG_FILE_NAME), "utf8"));
+    parsed = JSON.parse(readFileSync3(join2(resolve2(baseDir), AXIS_CONFIG_FILE_NAME), "utf8"));
   } catch {
     return null;
   }
@@ -4080,13 +4334,13 @@ function findBrandActivation(baseDir) {
     const file = join2(root, candidate);
     if (!isFile(file)) continue;
     layoutFiles.push(candidate);
-    const text = stripJsLikeComments(readFileSync2(file, "utf8"));
+    const text = stripJsLikeComments(readFileSync3(file, "utf8"));
     const providerTexts = [];
     for (const m of text.matchAll(/from\s+["']\.\/(providers?)["']/g)) {
       for (const ext of [".tsx", ".jsx", ".ts", ".js"]) {
         const rel3 = `${dirname2(candidate)}/${m[1]}${ext}`;
         const p = join2(root, rel3);
-        if (isFile(p)) providerTexts.push({ rel: rel3, text: stripJsLikeComments(readFileSync2(p, "utf8")) });
+        if (isFile(p)) providerTexts.push({ rel: rel3, text: stripJsLikeComments(readFileSync3(p, "utf8")) });
       }
     }
     const all = [text, ...providerTexts.map((x) => x.text)];
@@ -4117,7 +4371,7 @@ function inspectBrandActivation(baseDir) {
 var THEME_PACKAGE = "@axis-ds/theme";
 function readProjectPackageJson(baseDir) {
   try {
-    const parsed = JSON.parse(readFileSync2(join2(resolve2(baseDir), "package.json"), "utf8"));
+    const parsed = JSON.parse(readFileSync3(join2(resolve2(baseDir), "package.json"), "utf8"));
     return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : void 0;
   } catch {
     return void 0;
@@ -4146,7 +4400,7 @@ function getBrandWith(tokens, resolver, name) {
   try {
     summary = readSummary(resolver, entry);
     const cssPath = resolver.resolve(summary.importPath);
-    parsed = parseBrandCss(readFileSync2(cssPath, "utf8"), name);
+    parsed = parseBrandCss(readFileSync3(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") {
@@ -4168,7 +4422,7 @@ function getBrandWith(tokens, resolver, name) {
 }
 
 // ../axis-registry-core/src/template/dependencies-core.ts
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 import { join as join3 } from "path";
 var REQUIRED_DEPENDENCIES = ["tailwindcss"];
 var RECOMMENDED_DEPENDENCIES = ["clsx", "tailwind-merge"];
@@ -4185,7 +4439,7 @@ function checkDependencies(baseDirInput) {
   const baseDir = resolveBaseDir(baseDirInput);
   let pkg;
   try {
-    const parsed = JSON.parse(readFileSync3(join3(baseDir, "package.json"), "utf8"));
+    const parsed = JSON.parse(readFileSync4(join3(baseDir, "package.json"), "utf8"));
     if (!isPlainObject(parsed)) throw new Error("not object");
     pkg = parsed;
   } catch (err) {
@@ -4227,11 +4481,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})` : "") };
@@ -4511,13 +4769,13 @@ import chalk9 from "chalk";
 import path12 from "path";
 
 // src/theme/theme-add.ts
-import { accessSync, constants, existsSync as existsSync3, readFileSync as readFileSync4, realpathSync as realpathSync2, unlinkSync, writeFileSync } from "fs";
+import { accessSync, constants, existsSync as existsSync4, readFileSync as readFileSync5, realpathSync as realpathSync3, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "fs";
 import path11 from "path";
 var TOKENS_DEPENDENCY_RANGE = `^${TOKENS_DEPENDENCY_MIN_VERSION}`;
 var TAILWIND3_BASE_IMPORTS = [`${TOKENS_PACKAGE}/css`, `${TOKENS_PACKAGE}/css/shadcn`];
 var THEME_MIN_VERSION = "1.3.0";
 function readText(file) {
-  return existsSync3(file) ? readFileSync4(file, "utf8") : null;
+  return existsSync4(file) ? readFileSync5(file, "utf8") : null;
 }
 function eolOf(text) {
   return text.includes("\r\n") ? "\r\n" : "\n";
@@ -4608,8 +4866,8 @@ function compareVersions(a, b) {
   return 0;
 }
 function realPathInside(baseDir, file) {
-  const realBase = realpathSync2(baseDir);
-  const realPath = realpathSync2(file);
+  const realBase = realpathSync3(baseDir);
+  const realPath = realpathSync3(file);
   const relPath = path11.relative(realBase, realPath);
   const inside = relPath !== "" && !relPath.startsWith("..") && !path11.isAbsolute(relPath);
   return { inside, realPath };
@@ -4652,7 +4910,7 @@ function planThemeAdd(baseDirInput, brand) {
   }
   plan.tokens = resolveTokens(baseDir);
   if (plan.tokens.status === "ok" && plan.tokens.indexPath) {
-    const data = JSON.parse(readFileSync4(plan.tokens.indexPath, "utf8"));
+    const data = JSON.parse(readFileSync5(plan.tokens.indexPath, "utf8"));
     const entries = Array.isArray(data.brands) ? data.brands : [];
     const entry = entries.find((e) => e.name === brand);
     if (!entry) {
@@ -4711,7 +4969,7 @@ function planThemeAdd(baseDirInput, brand) {
       plan.writes = [];
       return plan;
     }
-    const before = readFileSync4(location.path, "utf8");
+    const before = readFileSync5(location.path, "utf8");
     const imported = findBrandImports(before);
     const otherBrands = [...new Set(imported.filter((n) => n !== brand))];
     const brandAdded = !imported.includes(brand);
@@ -4747,11 +5005,11 @@ function planThemeAdd(baseDirInput, brand) {
     };
   }
   if (!tailwind4) {
-    const configFile2 = TAILWIND_CONFIG_FILES.find((f) => existsSync3(path11.join(baseDir, f)));
+    const configFile2 = TAILWIND_CONFIG_FILES.find((f) => existsSync4(path11.join(baseDir, f)));
     const content = inspectTailwindContent(baseDir);
     plan.tailwindConfig = {
       configFile: configFile2,
-      presetMissing: configFile2 === void 0 || !hasTokensPresetReference(readFileSync4(path11.join(baseDir, configFile2), "utf8")),
+      presetMissing: configFile2 === void 0 || !hasTokensPresetReference(readFileSync5(path11.join(baseDir, configFile2), "utf8")),
       contentMissing: content?.targets.filter((t) => !t.covered) ?? [],
       contentUnknown: content !== null && (content.unreadable || content.dynamic)
     };
@@ -4836,15 +5094,15 @@ function applyThemeAdd(plan) {
   const done = [];
   for (const w of plan.writes) {
     try {
-      writeFileSync(w.file, w.after);
+      writeFileSync2(w.file, w.after);
       done.push(w);
     } catch (err) {
       const restored = [];
       const restoreFailed = [];
       for (const d of done.reverse()) {
         try {
-          if (d.before === null) unlinkSync(d.file);
-          else writeFileSync(d.file, d.before);
+          if (d.before === null) unlinkSync2(d.file);
+          else writeFileSync2(d.file, d.before);
           restored.push(d.file);
         } catch {
           restoreFailed.push(d.file);
@@ -4896,6 +5154,10 @@ function installPhrase(g) {
   if (g.kind === "install-at-root") return `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uC11C ${chalk9.cyan(g.installCommand)}`;
   return chalk9.cyan(g.kind === "install" ? g.installCommand : g.addCommand);
 }
+function rootInstallPhrase(installCommand) {
+  const phrase = installCommandPhrase(installCommand, true);
+  return phrase === installCommand ? chalk9.cyan(installCommand) : `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uC11C ${chalk9.cyan(installCommand)}`;
+}
 function rebuildGuide(g) {
   return `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uBA74 ${chalk9.cyan(workspaceRunCommand(g.installCommand, TOKENS_PACKAGE, "build"))}, \uC544\uB2C8\uBA74 \uC7AC\uC124\uCE58: ${installPhrase(g)}`;
 }
@@ -5109,7 +5371,7 @@ function renderThemeAdd(plan, written) {
     );
   }
   for (const d of css?.deferredComponentImports ?? []) {
-    lines.push(chalk9.yellow(`  ! ${deferredComponentImportReason(d, plan.installCommand)}`));
+    lines.push(chalk9.yellow(`  ! ${deferredComponentImportReason(d, installCommandPhrase(plan.installCommand, true))}`));
   }
   if (css && css.otherBrands.length > 0) {
     lines.push(
@@ -5130,7 +5392,7 @@ function renderThemeAdd(plan, written) {
     lines.push(
       `  ${chalk9.gray("-")} package.json: ${TOKENS_PACKAGE} ${dep.declaredRange} \uAC00 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC120\uC5B8\uB3FC \uC788\uC5B4 \uC571 package.json \uC740 \uBC14\uAFB8\uC9C0 \uC54A\uC74C`
     );
-    if (plan.tokens.status === "not-installed") lines.push(`    \uC124\uCE58: ${chalk9.cyan(plan.installCommand)}`);
+    if (plan.tokens.status === "not-installed") lines.push(`    \uC124\uCE58: ${rootInstallPhrase(plan.installCommand)}`);
     else if (plan.tokens.status === "not-built") lines.push(`    ${rebuildGuide(tokensGuide)}`);
   } else if (dep?.action === "present") {
     lines.push(`  ${chalk9.gray("-")} package.json: ${TOKENS_PACKAGE} ${dep.declaredRange} \uAC00 \uC774\uBBF8 \uC788\uC5B4 \uBC94\uC704\uB97C \uBC14\uAFB8\uC9C0 \uC54A\uC74C`);
@@ -5556,13 +5818,13 @@ async function fetchRegistryJson(url, options = {}) {
 }
 
 // src/init/init.ts
-import { accessSync as accessSync2, constants as constants2, existsSync as existsSync5, lstatSync as lstatSync3, readFileSync as readFileSync5, realpathSync as realpathSync4, statSync as statSync4, writeFileSync as writeFileSync2 } from "fs";
+import { accessSync as accessSync2, constants as constants2, existsSync as existsSync6, lstatSync as lstatSync4, readFileSync as readFileSync6, realpathSync as realpathSync5, statSync as statSync4, writeFileSync as writeFileSync3 } from "fs";
 import path14 from "path";
 import chalk10 from "chalk";
 import fs12 from "fs-extra";
 
 // ../axis-registry-core/src/add/safe-write.ts
-import { constants as fsConstants, existsSync as existsSync4, lstatSync as lstatSync2, realpathSync as realpathSync3, statSync as statSync3 } from "fs";
+import { constants as fsConstants, existsSync as existsSync5, lstatSync as lstatSync3, realpathSync as realpathSync4, statSync as statSync3 } from "fs";
 import path13 from "path";
 import fs11 from "fs-extra";
 var NEW_FILE_FLAGS = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL | (fsConstants.O_NOFOLLOW ?? 0);
@@ -5581,7 +5843,7 @@ function isSameOrInside(parent, child, impl = path13) {
 }
 function nearestExisting(p) {
   let cur = p;
-  while (!existsSync4(cur)) {
+  while (!existsSync5(cur)) {
     const up = path13.dirname(cur);
     if (up === cur) return cur;
     cur = up;
@@ -5589,18 +5851,18 @@ function nearestExisting(p) {
   return cur;
 }
 function escapeReason(root, target, options = {}) {
-  const realRoot = realpathSync3(root);
+  const realRoot = realpathSync4(root);
   if (!isSameOrInside(path13.resolve(root), path13.resolve(target)) || path13.resolve(target) === path13.resolve(root)) {
     return `\uACBD\uB85C\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4(${target})`;
   }
   const anchor = nearestExisting(path13.dirname(target));
-  const realAnchor = realpathSync3(anchor);
+  const realAnchor = realpathSync4(anchor);
   if (!isSameOrInside(realRoot, realAnchor)) {
     return `\uC0C1\uC704 \uB514\uB809\uD130\uB9AC\uC758 \uC2E4\uC81C \uC704\uCE58(${realAnchor})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4`;
   }
   let st = null;
   try {
-    st = lstatSync2(target);
+    st = lstatSync3(target);
   } catch {
     st = null;
   }
@@ -5609,7 +5871,7 @@ function escapeReason(root, target, options = {}) {
     const shown = path13.relative(path13.resolve(root), path13.resolve(target)).split(path13.sep).join("/");
     let realTarget;
     try {
-      realTarget = realpathSync3(target);
+      realTarget = realpathSync4(target);
     } catch {
       return `\uAE30\uC874 \uD30C\uC77C ${shown} \uC774 \uAE68\uC9C4 \uC2EC\uBCFC\uB9AD \uB9C1\uD06C\uB77C \uB530\uB77C\uAC08 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(\uB9C1\uD06C\uB97C \uC9C0\uC6B0\uAC70\uB098 \uACE0\uCE5C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694)`;
     }
@@ -5634,7 +5896,7 @@ function escapeReason(root, target, options = {}) {
 }
 function isSymlink(p) {
   try {
-    return lstatSync2(p).isSymbolicLink();
+    return lstatSync3(p).isSymbolicLink();
   } catch {
     return false;
   }
@@ -5642,15 +5904,15 @@ function isSymlink(p) {
 function outsideLinkTarget(root, target) {
   if (!isSymlink(target)) return null;
   try {
-    const realTarget = realpathSync3(target);
-    return isSameOrInside(realpathSync3(root), realTarget) ? null : realTarget;
+    const realTarget = realpathSync4(target);
+    return isSameOrInside(realpathSync4(root), realTarget) ? null : realTarget;
   } catch {
     return null;
   }
 }
 function hardLinkCount(target) {
   try {
-    const st = lstatSync2(target);
+    const st = lstatSync3(target);
     return st.isFile() && st.nlink >= 2 ? st.nlink : null;
   } catch {
     return null;
@@ -5660,10 +5922,10 @@ function hardLinkMessage(shownPath, nlink) {
   return `\uAE30\uC874 \uD30C\uC77C ${shownPath} \uC774 \uB2E4\uB978 \uACBD\uB85C\uC640 \uD558\uB4DC\uB9C1\uD06C\uB85C \uC774\uC5B4\uC9C4 \uD30C\uC77C\uC774\uB77C(\uB9C1\uD06C \uC218 ${nlink}) \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uB36E\uC5B4\uC4F0\uBA74 \uC774\uC5B4\uC9C4 \uB2E4\uB978 \uACBD\uB85C\uC758 \uB0B4\uC6A9\uB3C4 \uBC14\uB01D\uB2C8\uB2E4. \uD558\uB4DC\uB9C1\uD06C\uB97C \uB04A\uC740(\uD30C\uC77C\uC744 \uBCF5\uC0AC\uD574 \uBC14\uAFBC) \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694`;
 }
 function writtenOutside(root, target) {
-  const realRoot = realpathSync3(root);
+  const realRoot = realpathSync4(root);
   let realTarget;
   try {
-    realTarget = realpathSync3(target);
+    realTarget = realpathSync4(target);
   } catch {
     return target;
   }
@@ -5709,8 +5971,8 @@ async function overwriteFollowingLinks(target, content) {
   }
 }
 function checkParentInside(root, target) {
-  const realRoot = realpathSync3(root);
-  const realParent = realpathSync3(path13.dirname(target));
+  const realRoot = realpathSync4(root);
+  const realParent = realpathSync4(path13.dirname(target));
   if (!isSameOrInside(realRoot, realParent)) {
     return `\uBD80\uBAA8 \uB514\uB809\uD130\uB9AC\uC758 \uC2E4\uC81C \uC704\uCE58(${realParent})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4`;
   }
@@ -5813,6 +6075,7 @@ async function resolveInitAnswers(baseDirInput, tailwind4) {
 }
 function animationGuideLine(pkg, tailwind4, installCommand, baseDir) {
   const name = tailwind4 ? ANIMATION_PLUGIN_TAILWIND4 : ANIMATION_PLUGIN_TAILWIND3;
+  const setupOf = (candidate) => !tailwind4 ? `tailwind.config \uC758 plugins \uC5D0 require("${candidate}") \uB97C \uB123\uC73C\uC138\uC694` : `\uC804\uC5ED CSS \uC5D0 ${tailwind4AnimationLine(candidate)} \uB97C \uB123\uC73C\uC138\uC694`;
   if (baseDir !== void 0) {
     const pnp = isPnpProject(baseDir);
     const candidates = tailwind4 ? [ANIMATION_PLUGIN_TAILWIND4, ANIMATION_PLUGIN_TAILWIND3] : [ANIMATION_PLUGIN_TAILWIND3];
@@ -5821,13 +6084,26 @@ function animationGuideLine(pkg, tailwind4, installCommand, baseDir) {
       if (pnp) return hasDependency(pkg, n) !== void 0 ? { source: "app" } : void 0;
       return declaredDependency(baseDir, pkg, n);
     };
+    const usable = (n) => declaredOf(n) !== void 0 && (pnp || findInstalledPackage(baseDir, n) !== void 0);
+    const css = tailwind4 && pkg !== void 0 ? inspectTailwind4Animation(baseDir, pkg) : void 0;
+    const cssFile = css?.file !== void 0 ? `${css.file}${css.via}` : void 0;
+    if (css !== void 0 && cssFile !== void 0 && css.lines.length > 0) {
+      if (css.problems.length === 0) return void 0;
+      return tailwind4AnimationProblemLine(cssFile, css.lines, css.problems, installCommand, candidates.filter(usable));
+    }
     for (const candidate of candidates) {
       const declared = declaredOf(candidate);
       if (declared === void 0) continue;
-      if (pnp || findInstalledPackage(baseDir, candidate) !== void 0) return void 0;
+      if (pnp || findInstalledPackage(baseDir, candidate) !== void 0) {
+        if (css !== void 0 && cssFile !== void 0 && css.lines.length === 0) {
+          return `\uC560\uB2C8\uBA54\uC774\uC158: ${candidate} \uB294 ${pnp ? "\uC120\uC5B8" : "\uC124\uCE58"}\uB3FC \uC788\uC9C0\uB9CC ${cssFile}\uC5D0 \uC560\uB2C8\uBA54\uC774\uC158 \uC904\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. ${setupOf(candidate)}.`;
+        }
+        return void 0;
+      }
       const declaredWhere = declared.source === "root" ? "\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 " : "";
-      const setup = !tailwind4 ? `tailwind.config \uC758 plugins \uC5D0 require("${candidate}") \uB97C \uB123\uC73C\uC138\uC694` : candidate === ANIMATION_PLUGIN_TAILWIND4 ? `\uC804\uC5ED CSS \uC5D0 @import "${candidate}"; \uB97C \uB123\uC73C\uC138\uC694` : `\uC804\uC5ED CSS \uC5D0 @plugin "${candidate}"; \uB97C \uB123\uC73C\uC138\uC694`;
-      return `\uC560\uB2C8\uBA54\uC774\uC158: ${candidate} \uB294 ${declaredWhere}\uC120\uC5B8\uB3FC \uC788\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. ${installCommand} \uB4A4 ${setup}.`;
+      const setup = setupOf(candidate);
+      const install = installCommandPhrase(installCommand, declared.source === "root");
+      return `\uC560\uB2C8\uBA54\uC774\uC158: ${candidate} \uB294 ${declaredWhere}\uC120\uC5B8\uB3FC \uC788\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. ${install} \uB4A4 ${setup}.`;
     }
   } else if (pkg !== void 0 && (hasDependency(pkg, ANIMATION_PLUGIN_TAILWIND3) !== void 0 || hasDependency(pkg, ANIMATION_PLUGIN_TAILWIND4) !== void 0)) {
     return void 0;
@@ -5836,6 +6112,25 @@ function animationGuideLine(pkg, tailwind4, installCommand, baseDir) {
   const where = tailwind4 ? `\uC804\uC5ED CSS \uC5D0 @import "${name}"; \uB97C \uB123\uC73C\uC138\uC694` : `tailwind.config \uC758 plugins \uC5D0 require("${name}") \uB97C \uB123\uC73C\uC138\uC694`;
   return `\uC560\uB2C8\uBA54\uC774\uC158: Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158(animate-in \uB958)\uC740 \uD50C\uB7EC\uADF8\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. ${add} \uB4A4 ${where}.`;
 }
+function pnpRootOnlyTailwindLine(baseDir, pkg) {
+  return pnpRootOnlyDependency(baseDir, pkg, "tailwindcss") !== void 0 ? `! \uD544\uC218 \uC758\uC874\uC131 tailwindcss \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD558\uC138\uC694` : void 0;
+}
+function tailwind4AnimationLine(name) {
+  return name === ANIMATION_PLUGIN_TAILWIND4 ? `@import "${name}";` : `@plugin "${name}";`;
+}
+function tailwind4AnimationProblemLine(cssFile, lines, problems, installCommand, usable) {
+  const commands = [];
+  const undeclared = problems.filter((p) => p.kind !== "notInstalled").map((p) => p.name);
+  if (undeclared.length > 0) commands.push(`${addCommandFor(installCommand, {}).trimEnd()} ${undeclared.join(" ")}`);
+  const notInstalled = problems.filter((p) => p.kind === "notInstalled");
+  if (notInstalled.length > 0) commands.push(installCommandPhrase(installCommand, notInstalled.some((p) => p.root === true)));
+  const why = problems.map((p) => p.why).join(" \xB7 ");
+  const problemLines = problems.map((p) => tailwind4AnimationLine(p.name)).join(" \xB7 ");
+  const other = usable.find((n) => !problems.some((p) => p.name === n));
+  const install = `\uC124\uCE58\uD558\uC138\uC694: ${commands.join(" \xB7 ")}`;
+  const action = other === void 0 ? install : lines.includes(other) ? `\uC774\uBBF8 \uC124\uCE58\uB41C ${other} \uB9CC \uC4F0\uB824\uBA74 ${problemLines} \uC904\uC744 \uC9C0\uC6B0\uACE0, \uC544\uB2C8\uBA74 ${install}` : `\uC774\uBBF8 \uC124\uCE58\uB41C ${other} \uB97C \uC4F0\uB824\uBA74 ${problemLines} \uC904\uC744 ${tailwind4AnimationLine(other)} \uB85C \uBC14\uAFB8\uACE0, \uC544\uB2C8\uBA74 ${install}`;
+  return `\uC560\uB2C8\uBA54\uC774\uC158: ${cssFile}\uC758 \uC560\uB2C8\uBA54\uC774\uC158 \uC904\uC744 \uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${why}). ${action}`;
+}
 var INIT_NEXT_STEP_COMMAND = "npx @axis-ds/cli add button";
 function isTailwind4(tailwind) {
   return tailwind.major !== void 0 && tailwind.major >= 4;
@@ -5844,7 +6139,7 @@ var TAILWIND4_TOKENS_VERSION = TAILWIND4_MIN_AXIS_VERSION;
 var TAILWIND4_CONFLICT_LINE = "  ! create-next-app \uAE30\uBCF8 globals.css \uC758 :root \xB7 @theme inline \xB7 @media (prefers-color-scheme: dark) \xB7 body \uBE14\uB85D\uC740 AXIS \uC640 \uAC19\uC740 \uC774\uB984(--background \xB7 --foreground \xB7 --color-background \xB7 --font-sans \xB7 --font-mono)\uC744 \uB2E4\uB978 \uAC12\uC73C\uB85C \uC815\uC758\uD569\uB2C8\uB2E4. \uC774 \uBE14\uB85D\uB4E4\uC744 \uC9C0\uC6B0\uC138\uC694.";
 function readPackageJsonSafe(baseDir) {
   try {
-    const text = readFileSync5(path14.join(baseDir, "package.json"), "utf8");
+    const text = readFileSync6(path14.join(baseDir, "package.json"), "utf8");
     const parsed = JSON.parse(text.startsWith(BOM) ? text.slice(1) : text);
     return isPlainObject(parsed) ? parsed : void 0;
   } catch {
@@ -5852,15 +6147,20 @@ function readPackageJsonSafe(baseDir) {
   }
 }
 function tailwind4GuideLines(pkg, installCommand, globalCss, baseDir) {
-  const declared = (name) => pkg !== void 0 && (baseDir !== void 0 ? declaredDependency(baseDir, pkg, name) : hasDependency(pkg, name)) !== void 0;
+  const declared = (name) => pkg !== void 0 && (baseDir !== void 0 ? declaredDependency(baseDir, pkg, name, void 0, { appOnlyInPnp: true }) : hasDependency(pkg, name)) !== void 0;
+  const pnpRootOnly = (name) => baseDir !== void 0 && pnpRootOnlyDependency(baseDir, pkg, name) !== void 0;
   const used = TAILWIND4_COMPONENT_PACKAGES.filter((name) => declared(name));
+  const rootOnlyComponents = TAILWIND4_COMPONENT_PACKAGES.filter((name) => pnpRootOnly(name));
   const lines = [
     `Tailwind 4: \uC804\uC5ED CSS(${globalCss}) \uB9E8 \uC704\uC5D0 \uB2E4\uC74C \uC904\uC744 \uB123\uC73C\uC138\uC694(\uD30C\uC77C\uC740 \uACE0\uCE58\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4).`,
     '  @import "tailwindcss";',
     `  ${TOKENS_TAILWIND4_IMPORT_LINE}`,
     ...used.map((name) => `  ${componentTailwindImportLine(name)}`)
   ];
-  if (used.length === 0) {
+  for (const name of rootOnlyComponents) {
+    lines.push(`  ! ${name} \uAC00 ${PNP_ROOT_ONLY_NOTE} \u2192 \uC571 package.json \uC5D0 \uC120\uC5B8\uD55C \uB4A4 ${componentTailwindImportLine(name)}`);
+  }
+  if (used.length === 0 && rootOnlyComponents.length === 0) {
     lines.push(
       `  npm \uD328\uD0A4\uC9C0 \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uC4F0\uBA74 \uADF8 \uD328\uD0A4\uC9C0\uC758 tailwind.css \uB3C4 \uB123\uC73C\uC138\uC694(\uC608: @import "${TAILWIND4_COMPONENT_PACKAGES[0]}/tailwind.css";).`
     );
@@ -5868,7 +6168,8 @@ function tailwind4GuideLines(pkg, installCommand, globalCss, baseDir) {
   lines.push(TAILWIND4_CONFLICT_LINE);
   if (!declared(TOKENS_PACKAGE)) {
     const add = addCommandFor(installCommand, { [TOKENS_PACKAGE]: `^${TAILWIND4_TOKENS_VERSION}` });
-    lines.push(`  ${TOKENS_PACKAGE} \uC124\uCE58: ${add}`);
+    const why = pnpRootOnly(TOKENS_PACKAGE) ? `(${PNP_ROOT_ONLY_NOTE})` : "";
+    lines.push(`  ${TOKENS_PACKAGE} \uC124\uCE58${why}: ${add}`);
   }
   const versions = axisPackagesBelowTailwind4(pkg, baseDir);
   const unknown = versions.filter((v) => v.status === "unknown");
@@ -5912,13 +6213,14 @@ function planUtilsDependencies(baseDirInput) {
     action: "no-package-json",
     added: [],
     present: [],
+    pnpRootOnly: [],
     ranges: ranges0,
     tailwind: tailwind0,
     installCommand,
     addCommand: addCommandFor(installCommand, ranges0)
   };
   const pkgFile = path14.join(baseDir, "package.json");
-  if (!existsSync5(pkgFile)) return plan;
+  if (!existsSync6(pkgFile)) return plan;
   const unwritable = (reason) => ({ ...plan, action: "unwritable", reason });
   let where;
   try {
@@ -5929,7 +6231,7 @@ function planUtilsDependencies(baseDirInput) {
   if (!where.inside) return unwritable(`\uC2E4\uC81C \uC704\uCE58(${where.realPath})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4`);
   let text;
   try {
-    text = readFileSync5(pkgFile, "utf8");
+    text = readFileSync6(pkgFile, "utf8");
   } catch (err) {
     return unwritable(err.message);
   }
@@ -5948,9 +6250,12 @@ function planUtilsDependencies(baseDirInput) {
   plan.addCommand = addCommandFor(installCommand, plan.ranges);
   const missing = {};
   for (const [name, range] of Object.entries(plan.ranges)) {
-    const declared = declaredDependency(baseDir, pkg, name);
+    const declared = declaredDependency(baseDir, pkg, name, void 0, { appOnlyInPnp: true });
     if (declared !== void 0) plan.present.push({ name, range: declared.range, source: declared.source });
-    else missing[name] = range;
+    else {
+      missing[name] = range;
+      if (pnpRootOnlyDependency(baseDir, pkg, name) !== void 0) plan.pnpRootOnly.push(name);
+    }
   }
   plan.added = Object.keys(missing);
   plan.addCommand = addCommandFor(installCommand, plan.added.length > 0 ? missing : plan.ranges);
@@ -5967,12 +6272,12 @@ function planUtilsDependencies(baseDirInput) {
   const after = bom + formatJsonLike(body, { ...pkg, dependencies: deps });
   return { ...plan, action: "add", write: { file: pkgFile, before: text, after } };
 }
-var defaultWriteFile = (file, data) => writeFileSync2(file, data);
+var defaultWriteFile = (file, data) => writeFileSync3(file, data);
 function applyUtilsDependencies(baseDirInput, plan, writeFile = defaultWriteFile) {
   const w = plan.write;
   if (plan.action !== "add" || !w) return false;
   const baseDir = path14.resolve(baseDirInput);
-  const current = existsSync5(w.file) ? readFileSync5(w.file, "utf8") : null;
+  const current = existsSync6(w.file) ? readFileSync6(w.file, "utf8") : null;
   if (current !== w.before) {
     throw new Error(`${w.file} \uC774 \uACC4\uD68D \uB4A4\uC5D0 \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.`);
   }
@@ -5988,7 +6293,7 @@ function applyUtilsDependencies(baseDirInput, plan, writeFile = defaultWriteFile
     let restored;
     try {
       writeFile(w.file, w.before);
-      if (readFileSync5(w.file, "utf8") !== w.before) throw new Error("\uB418\uB3CC\uB9B0 \uB0B4\uC6A9\uC774 \uC6D0\uB798 \uB0B4\uC6A9\uACFC \uB2E4\uB985\uB2C8\uB2E4");
+      if (readFileSync6(w.file, "utf8") !== w.before) throw new Error("\uB418\uB3CC\uB9B0 \uB0B4\uC6A9\uC774 \uC6D0\uB798 \uB0B4\uC6A9\uACFC \uB2E4\uB985\uB2C8\uB2E4");
       restored = "\uC6D0\uB798 \uB0B4\uC6A9\uC73C\uB85C \uB418\uB3CC\uB838\uC2B5\uB2C8\uB2E4";
     } catch (restoreErr) {
       restored = `\uC6D0\uB798 \uB0B4\uC6A9\uC73C\uB85C \uB418\uB3CC\uB9AC\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${restoreErr.message}). \uD30C\uC77C\uC774 \uC798\uB838\uAC70\uB098 \uBE44\uC5C8\uC744 \uC218 \uC788\uC73C\uB2C8 \uBC84\uC804 \uAD00\uB9AC \uB3C4\uAD6C \uB4F1\uC73C\uB85C \uBCF5\uAD6C\uD558\uC138\uC694`;
@@ -6002,6 +6307,8 @@ function reportDependencies(plan, log) {
   const rootPresent = plan.present.filter((p) => p.source === "root").map((p) => p.name);
   const rootNote = rootPresent.length > 0 ? ` (\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0 \uC120\uC5B8: ${rootPresent.join(", ")})` : "";
   const basis = `  tailwind-merge \uBC94\uC704 \uAE30\uC900: ${describeTailwindBasis(plan.tailwind)}`;
+  const installPhrase2 = installCommandPhrase(plan.installCommand, rootPresent.length > 0);
+  const installText = installPhrase2 === plan.installCommand ? chalk10.cyan(plan.installCommand) : `\uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uB8E8\uD2B8\uC5D0\uC11C ${chalk10.cyan(plan.installCommand)}`;
   const logBasis = () => {
     log(chalk10.gray(basis));
     for (const w of tailwindWarnings(plan.tailwind, plan.installCommand)) log(chalk10.yellow(`  ${w}`));
@@ -6009,12 +6316,13 @@ function reportDependencies(plan, log) {
   if (plan.action === "add") {
     const addedText = plan.added.map((n) => `${n}@${plan.ranges[n]}`).join(", ");
     log(chalk10.green(`\u2713 package.json dependencies \uC5D0 \uCD94\uAC00: ${addedText}`));
+    if (plan.pnpRootOnly.length > 0) log(chalk10.gray(`  ${plan.pnpRootOnly.join(", ")} \uB294 ${PNP_ROOT_ONLY_NOTE}`));
     if (plan.present.length > 0) log(chalk10.gray(`  \uC774\uBBF8 \uC788\uC74C(\uBC84\uC804 \uC720\uC9C0): ${presentText}${rootNote}`));
     if (plan.added.includes("tailwind-merge")) logBasis();
-    log(chalk10.yellow(`  \uC124\uCE58\uB294 \uC2E4\uD589\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC124\uCE58: ${chalk10.cyan(plan.installCommand)}`));
+    log(chalk10.yellow(`  \uC124\uCE58\uB294 \uC2E4\uD589\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC124\uCE58: ${installText}`));
   } else if (plan.action === "present") {
     log(chalk10.green(`\u2713 utils.ts \uC758\uC874\uC131\uC774 package.json \uC5D0 \uC774\uBBF8 \uC788\uC2B5\uB2C8\uB2E4(\uBC84\uC804 \uC720\uC9C0): ${presentText}${rootNote}`));
-    log(chalk10.yellow(`  \uC124\uCE58\uB294 \uC2E4\uD589\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC124\uCE58: ${chalk10.cyan(plan.installCommand)}`));
+    log(chalk10.yellow(`  \uC124\uCE58\uB294 \uC2E4\uD589\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC124\uCE58: ${installText}`));
   } else if (plan.action === "no-package-json") {
     log(chalk10.yellow("! package.json \uC774 \uC5C6\uC5B4 utils.ts \uC758\uC874\uC131(clsx, tailwind-merge)\uC744 \uCD94\uAC00\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4."));
     log(chalk10.yellow(`  \uC124\uCE58: ${chalk10.cyan(plan.addCommand)}`));
@@ -6073,7 +6381,7 @@ function planUtilsWrite(baseDirInput, utilsPath) {
   const shown = path14.relative(baseDir, utilsPath).split(path14.sep).join("/") || utilsPath;
   let st;
   try {
-    st = lstatSync3(utilsPath);
+    st = lstatSync4(utilsPath);
   } catch (e) {
     if (e.code === "ENOENT") return { action: "create" };
     return { action: "reject", reason: `${shown} \uC758 \uC815\uBCF4\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${errCode(e)})` };
@@ -6081,13 +6389,13 @@ function planUtilsWrite(baseDirInput, utilsPath) {
   if (st.isSymbolicLink()) {
     let real;
     try {
-      real = realpathSync4(utilsPath);
+      real = realpathSync5(utilsPath);
     } catch {
       return { action: "reject", reason: `${shown} \uC774 \uAE68\uC9C4 \uC2EC\uBCFC\uB9AD \uB9C1\uD06C\uB77C \uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uB9C1\uD06C\uB97C \uC9C0\uC6B0\uAC70\uB098 \uACE0\uCE5C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694` };
     }
     let outside = null;
     try {
-      outside = isSameOrInside(realpathSync4(baseDir), real) ? null : real;
+      outside = isSameOrInside(realpathSync5(baseDir), real) ? null : real;
     } catch {
       outside = null;
     }
@@ -6101,7 +6409,7 @@ function planUtilsWrite(baseDirInput, utilsPath) {
     if (!target.isFile()) return { action: "reject", reason: `${shown} \uB9C1\uD06C \uB300\uC0C1(${real})\uC774 \uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2D9\uB2C8\uB2E4` };
     let content2;
     try {
-      content2 = readFileSync5(utilsPath, "utf8");
+      content2 = readFileSync6(utilsPath, "utf8");
     } catch (e) {
       return { action: "reject", reason: `${shown} \uB9C1\uD06C \uB300\uC0C1(${real})\uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${errCode(e)})` };
     }
@@ -6116,7 +6424,7 @@ function planUtilsWrite(baseDirInput, utilsPath) {
   if (!st.isFile()) return { action: "reject", reason: `${shown} \uC774 \uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2C8\uB77C \uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4` };
   let content;
   try {
-    content = readFileSync5(utilsPath, "utf8");
+    content = readFileSync6(utilsPath, "utf8");
   } catch (e) {
     return { action: "reject", reason: `\uAE30\uC874 ${shown} \uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${errCode(e)})` };
   }
@@ -6268,6 +6576,8 @@ async function runInit(baseDirInput, answers, registryUrl, log = console.log, op
     return;
   }
   reportDependencies(plan, log);
+  const tailwindRootOnly = pnpRootOnlyTailwindLine(baseDir, readPackageJsonSafe(baseDir));
+  if (tailwindRootOnly !== void 0) log(chalk10.yellow(`  ${tailwindRootOnly}`));
   const animation = animationGuideLine(readPackageJsonSafe(baseDir), tailwind4, plan.installCommand, baseDir);
   if (animation !== void 0) log(chalk10.yellow(`  ${animation}`));
   if (tailwind4) {
@@ -6328,18 +6638,18 @@ function registerInitCommand(program2, registryUrl = DEFAULT_REGISTRY_URL, deps
 import chalk12 from "chalk";
 
 // ../axis-registry-core/src/add/add.ts
-import { existsSync as existsSync7, readFileSync as readFileSync7, statSync as statSync5 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
 import path16 from "path";
 import fs13 from "fs-extra";
 
 // ../axis-registry-core/src/registry/bundled.ts
-import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
 import path15 from "path";
 import { fileURLToPath } from "url";
 function findBundledRegistryDir(moduleUrl = import.meta.url) {
   const here = path15.dirname(fileURLToPath(moduleUrl));
   for (const dir of [path15.join(here, "registry"), path15.join(here, "..", "registry")]) {
-    if (existsSync6(path15.join(dir, "index.json"))) return dir;
+    if (existsSync7(path15.join(dir, "index.json"))) return dir;
   }
   return null;
 }
@@ -6347,7 +6657,7 @@ function readBundledJson(dir, fileName) {
   const file = path15.join(dir, fileName);
   let text;
   try {
-    text = readFileSync6(file, "utf8");
+    text = readFileSync7(file, "utf8");
   } catch {
     throw new Error(`\uB3D9\uBD09 \uB808\uC9C0\uC2A4\uD2B8\uB9AC\uC5D0 ${fileName} \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4(${dir})`);
   }
@@ -7062,7 +7372,7 @@ function missingDependencies(root, items) {
   const installCommand = detectInstallCommand(root);
   let pkg;
   try {
-    const text = readFileSync7(path16.join(root, "package.json"), "utf8").replace(/^\uFEFF/, "");
+    const text = readFileSync8(path16.join(root, "package.json"), "utf8").replace(/^\uFEFF/, "");
     const parsed = JSON.parse(text);
     pkg = isPlainObject(parsed) ? parsed : void 0;
   } catch {
@@ -7074,7 +7384,7 @@ function missingDependencies(root, items) {
   for (const item of items) {
     for (const dep of item.dependencies) {
       const name = dependencyName(dep);
-      if (declaredDependency(root, pkg, name, rootPkg) !== void 0) continue;
+      if (declaredDependency(root, pkg, name, rootPkg, { appOnlyInPnp: true }) !== void 0) continue;
       if (name in specs) continue;
       const explicit = dep.length > name.length ? dep.slice(name.length + 1) : void 0;
       specs[name] = explicit ?? ranges[name];
@@ -7177,12 +7487,12 @@ async function runAdd(cwd, requested, options, ctx) {
   const existing = /* @__PURE__ */ new Map();
   const readErrors = [];
   for (const file of plan.files) {
-    if (!existsSync7(file.target)) {
+    if (!existsSync8(file.target)) {
       existing.set(file, null);
       continue;
     }
     try {
-      existing.set(file, readFileSync7(file.target, "utf8"));
+      existing.set(file, readFileSync8(file.target, "utf8"));
     } catch (e) {
       readErrors.push(
         `${file.item.name}: \uAE30\uC874 \uD30C\uC77C ${rel2(root, file.target)} \uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${e.code ?? e.message})`