@axis-ds/cli 1.2.0 → 1.3.0

package/README.md

@@ -44,6 +44,13 @@ axis theme add ontology
 - `@axis-ds/tokens` 가 없거나 1.3.0 미만이면 목록 대신 설치 · 업그레이드 안내를 내고 종료 코드 1 로 끝납니다.
 - `axis check` 는 `axis.config.json` 의 `brand` 와 CSS 의 브랜드 import 가 맞는지도 봅니다.
 
+## 프로젝트 검증 (`axis check`)
+
+- Tailwind 구성 항목: Tailwind 4 이상(설치본, 없으면 `package.json` 선언으로 판정)은 설정 파일 대신 전역 CSS(`globals.css` · `app/globals.css` · `src/app/globals.css` · `src/globals.css` · `styles/globals.css` 순)의 `@import "tailwindcss"` 를 봅니다. Tailwind 3 이하는 `tailwind.config.ts` · `.js` · `.mjs` · `.cjs` 를 찾습니다.
+  - 이 항목은 Tailwind 진입 import 만 봅니다. `@axis-ds/tokens` 의 Tailwind 연동은 Tailwind 3 preset(`@axis-ds/tokens/tailwind`)뿐이라, Tailwind 4 에서 PASS 여도 `bg-primary` 같은 AXIS 색 클래스가 만들어진다는 뜻은 아닙니다.
+- FAIL 이 하나라도 있으면 종료 코드 1 로 끝납니다. WARN 만 있으면 0 입니다(1.3.0 부터, 이전에는 결과와 관계없이 0).
+- MCP `axis.check_project` 도 같은 항목 · 문구를 냅니다.
+
 ## 문서
 
 자세한 사용법은 [AXIS Design System 문서](https://axis.minu.best)를 참고하세요.

package/dist/{chunk-GCOWKKXG.js → chunk-AHQT77FJ.js}

@@ -84,7 +84,7 @@ ${result}`;
     console.log(chalk.bold("\uBC29\uBC95 3: \uCF54\uB4DC \uBCF5\uC0AC"));
     console.log(chalk.gray("  1. v0.app\uC5D0\uC11C \uCF54\uB4DC \uD0ED \uC5F4\uAE30"));
     console.log(chalk.gray("  2. \uD30C\uC77C\uBCC4\uB85C \uCF54\uB4DC \uBCF5\uC0AC"));
-    console.log(chalk.gray("  3. axis-cli v0 convert\uB85C \uBCC0\uD658\n"));
+    console.log(chalk.gray("  3. npx @axis-ds/cli v0 convert\uB85C \uBCC0\uD658\n"));
     const { method } = await prompts({
       type: "select",
       name: "method",
@@ -118,7 +118,7 @@ ${result}`;
     console.log(chalk.bold("3. \uB85C\uCEEC\uC5D0\uC11C \uD074\uB860:"));
     console.log(chalk.cyan("   git clone https://github.com/your-org/v0-project.git\n"));
     console.log(chalk.bold("4. AXIS \uBCC0\uD658:"));
-    console.log(chalk.cyan("   axis-cli v0 convert ./v0-project/components/*.tsx\n"));
+    console.log(chalk.cyan("   npx @axis-ds/cli v0 convert ./v0-project/components/*.tsx\n"));
     console.log(chalk.gray("\uD301: GitHub Actions\uB85C \uC790\uB3D9 \uBCC0\uD658 \uC6CC\uD06C\uD50C\uB85C\uB3C4 \uC124\uC815 \uAC00\uB2A5\uD569\uB2C8\uB2E4.\n"));
   }
   // ZIP 파일에서 변환
@@ -134,7 +134,7 @@ ${result}`;
     console.log(chalk.yellow("\nZIP \uBCC0\uD658 \uAE30\uB2A5\uC740 \uCD94\uD6C4 \uAD6C\uD604 \uC608\uC815\uC785\uB2C8\uB2E4."));
     console.log(chalk.gray("\uD604\uC7AC\uB294 \uC218\uB3D9\uC73C\uB85C \uC555\uCD95 \uD574\uC81C \uD6C4 convert \uBA85\uB839\uC5B4\uB97C \uC0AC\uC6A9\uD558\uC138\uC694:\n"));
     console.log(chalk.cyan("  unzip v0-project.zip -d ./v0-project"));
-    console.log(chalk.cyan("  axis-cli v0 convert ./v0-project/components/*.tsx\n"));
+    console.log(chalk.cyan("  npx @axis-ds/cli v0 convert ./v0-project/components/*.tsx\n"));
   }
   // 클립보드에서 변환
   async convertFromClipboard() {
@@ -185,7 +185,7 @@ ${result}`;
     console.log(chalk.gray("   AI/LLM \uAD00\uB828 UI\uC5D0\uB294 @axis-ds/agentic-ui \uC0AC\uC6A9:"));
     console.log(chalk.cyan("     import { StreamingText } from '@axis-ds/agentic-ui'\n"));
     console.log(chalk.bold("5. \uC790\uB3D9 \uBCC0\uD658"));
-    console.log(chalk.cyan("   axis-cli v0 convert <file.tsx>\n"));
+    console.log(chalk.cyan("   npx @axis-ds/cli v0 convert <file.tsx>\n"));
   }
 };
 function getV0Url(path2 = "") {

package/dist/{chunk-D26GW2HO.js → chunk-QORBOSUA.js}

@@ -852,7 +852,7 @@ async function initSync(owner, repo, projectNumber) {
     console.log(chalk.gray(`  \uD504\uB85C\uC81D\uD2B8: #${projectNumber}`));
     console.log();
     console.log(chalk.cyan("\uB2E4\uC74C \uBA85\uB839\uC5B4\uB85C \uB3D9\uAE30\uD654\uB97C \uC2DC\uC791\uD558\uC138\uC694:"));
-    console.log(chalk.cyan("  npx axis-cli sync"));
+    console.log(chalk.cyan("  npx @axis-ds/cli sync"));
     console.log();
   } catch (error) {
     spinner.fail(`\uC624\uB958: ${error.message}`);

package/dist/{chunk-WRDOGNSG.js → chunk-ZVVACWEW.js}

@@ -35,8 +35,8 @@ var MonetClient = class {
       );
     }
     console.log(chalk.gray("\n\uC0AC\uC6A9\uBC95:"));
-    console.log(chalk.gray("  axis-cli monet browse <category>  # \uCE74\uD14C\uACE0\uB9AC \uCEF4\uD3EC\uB10C\uD2B8 \uBCF4\uAE30"));
-    console.log(chalk.gray("  axis-cli monet search <query>     # \uCEF4\uD3EC\uB10C\uD2B8 \uAC80\uC0C9\n"));
+    console.log(chalk.gray("  npx @axis-ds/cli monet browse <category>  # \uCE74\uD14C\uACE0\uB9AC \uCEF4\uD3EC\uB10C\uD2B8 \uBCF4\uAE30"));
+    console.log(chalk.gray("  npx @axis-ds/cli monet search <query>     # \uCEF4\uD3EC\uB10C\uD2B8 \uAC80\uC0C9\n"));
   }
   // 컴포넌트 검색 (웹 URL 안내)
   async searchComponents(query) {
@@ -82,7 +82,7 @@ var MonetClient = class {
     console.log(chalk.gray("\n\uCEF4\uD3EC\uB10C\uD2B8 \uAC00\uC838\uC624\uAE30:"));
     console.log(chalk.gray("  1. \uC6F9\uC5D0\uC11C \uCEF4\uD3EC\uB10C\uD2B8 \uC120\uD0DD"));
     console.log(chalk.gray("  2. Copy Code \uBC84\uD2BC \uD074\uB9AD"));
-    console.log(chalk.gray("  3. axis-cli monet import \uC2E4\uD589\n"));
+    console.log(chalk.gray("  3. npx @axis-ds/cli monet import \uC2E4\uD589\n"));
   }
   // 카테고리별 예시 컴포넌트
   getCategoryExamples(category) {

package/dist/index.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   MonetClient
-} from "./chunk-WRDOGNSG.js";
+} from "./chunk-ZVVACWEW.js";
 import {
   V0Client
-} from "./chunk-GCOWKKXG.js";
+} from "./chunk-AHQT77FJ.js";
 import {
   registerSyncCommand
-} from "./chunk-D26GW2HO.js";
+} from "./chunk-QORBOSUA.js";
 import {
   fetchTemplateDetail,
   fetchTemplateIndex
@@ -15,12 +15,12 @@ import {
 
 // src/index.ts
 import { Command } from "commander";
-import chalk9 from "chalk";
+import chalk11 from "chalk";
 import ora6 from "ora";
-import fs10 from "fs-extra";
-import path11 from "path";
+import fs11 from "fs-extra";
+import path12 from "path";
 import { createRequire as createRequire2 } from "module";
-import prompts2 from "prompts";
+import prompts3 from "prompts";
 
 // src/library/base-collector.ts
 import crypto from "crypto";
@@ -484,11 +484,11 @@ var ShadcnCollector = class extends BaseCollector {
   /**
    * 파일 타입 추론
    */
-  getFileType(path12) {
-    if (path12.includes("hook") || path12.startsWith("use")) return "hook";
-    if (path12.includes("util") || path12.includes("lib")) return "util";
-    if (path12.endsWith(".css")) return "style";
-    if (path12.endsWith(".d.ts") || path12.includes("types")) return "type";
+  getFileType(path13) {
+    if (path13.includes("hook") || path13.startsWith("use")) return "hook";
+    if (path13.includes("util") || path13.includes("lib")) return "util";
+    if (path13.endsWith(".css")) return "style";
+    if (path13.endsWith(".d.ts") || path13.includes("types")) return "type";
     return "component";
   }
 };
@@ -1474,7 +1474,7 @@ var LibraryCurator = class {
     const index = await this.loadIndex();
     if (!index) {
       console.log(chalk2.yellow("\n\u26A0\uFE0F  \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC778\uB371\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
-      console.log(chalk2.gray("   axis-cli library collect \uBA85\uB839\uC5B4\uB85C \uC218\uC9D1\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.\n"));
+      console.log(chalk2.gray("   npx @axis-ds/cli library collect \uBA85\uB839\uC5B4\uB85C \uC218\uC9D1\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.\n"));
       return;
     }
     console.log(chalk2.blue("\n\u{1F4CA} Library Curator - \uD1B5\uACC4\n"));
@@ -2099,6 +2099,178 @@ function getBrand(baseDir, name) {
   };
 }
 
+// src/template/tailwind-core.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { join as join2, resolve as resolve2 } from "path";
+function hasDependency(pkg, name) {
+  for (const field of ["dependencies", "devDependencies"]) {
+    const deps = pkg[field];
+    if (typeof deps === "object" && deps !== null && name in deps) {
+      return String(deps[name]);
+    }
+  }
+  return void 0;
+}
+function isPlainObject(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.-]+)?`;
+function versionParts(token) {
+  const m = new RegExp(`^${VERSION}$`).exec(token);
+  if (!m) return void 0;
+  if (/^v?0\.0\.0-/.test(token)) return void 0;
+  return { major: Number(m[1]), minor: m[2], patch: m[3] };
+}
+var isWild = (part) => part === void 0 || /^[xX*]$/.test(part);
+function comparatorBounds(op, v) {
+  switch (op) {
+    case ">=":
+      return { lower: v.major };
+    case ">":
+      return { lower: isWild(v.minor) ? v.major + 1 : v.major };
+    case "<=":
+      return { upper: v.major };
+    case "<": {
+      const zeroOrWild = (part) => isWild(part) || Number(part) === 0;
+      return { upper: zeroOrWild(v.minor) && zeroOrWild(v.patch) ? v.major - 1 : v.major };
+    }
+    default:
+      return { lower: v.major, upper: v.major };
+  }
+}
+function tailwindMajorBounds(range) {
+  const r = range.trim();
+  if (r === "" || r.includes("||")) return void 0;
+  const simple = new RegExp(`^(?:\\^|~|=)?\\s*(${VERSION})$`).exec(r);
+  if (simple) {
+    const v = versionParts(simple[1]);
+    return v ? { lower: v.major, upper: v.major } : void 0;
+  }
+  const hyphen = new RegExp(`^(${VERSION})\\s+-\\s+(${VERSION})$`).exec(r);
+  if (hyphen) {
+    const tokens2 = r.split(/\s+-\s+/);
+    const a = versionParts(tokens2[0]);
+    const b = versionParts(tokens2[1]);
+    return a && b && a.major <= b.major ? { lower: a.major, upper: b.major } : void 0;
+  }
+  const tokens = r.replace(/(>=|<=|>|<|=)\s+/g, "$1").split(/\s+/);
+  const lowers = [];
+  const uppers = [];
+  for (const t of tokens) {
+    const c = /^(>=|<=|>|<|=)(.+)$/.exec(t);
+    if (!c) return void 0;
+    const v = versionParts(c[2]);
+    if (v === void 0) return void 0;
+    const b = comparatorBounds(c[1], v);
+    if (b.lower !== void 0) lowers.push(b.lower);
+    if (b.upper !== void 0) uppers.push(b.upper);
+  }
+  if (lowers.length === 0) return void 0;
+  const lower = Math.max(...lowers);
+  const upper = uppers.length > 0 ? Math.min(...uppers) : void 0;
+  if (upper !== void 0 && upper < lower) return void 0;
+  return upper !== void 0 ? { lower, upper } : { lower };
+}
+function majorWithin(major, bounds) {
+  return major >= bounds.lower && (bounds.upper === void 0 || major <= bounds.upper);
+}
+function majorFromVersion(version) {
+  if (typeof version !== "string") return void 0;
+  const v = version.trim();
+  const m = /^v?(\d+)\.\d+\.\d+(?:[-+][0-9A-Za-z.+-]*)?$/.exec(v);
+  if (!m || /^v?0\.0\.0-/.test(v)) return void 0;
+  return Number(m[1]);
+}
+function detectTailwind(baseDirInput, pkg) {
+  const baseDir = resolve2(baseDirInput);
+  const installedFile = join2(baseDir, "node_modules", "tailwindcss", "package.json");
+  const declared = pkg ? hasDependency(pkg, "tailwindcss") : void 0;
+  const bounds = declared !== void 0 ? tailwindMajorBounds(declared) : void 0;
+  const declaredMajor = bounds?.lower;
+  try {
+    const installed = JSON.parse(readFileSync2(installedFile, "utf8"));
+    const version = isPlainObject(installed) ? installed.version : void 0;
+    const major = majorFromVersion(version);
+    if (major !== void 0) {
+      const found = { major, source: "installed", value: String(version) };
+      if (declared !== void 0 && bounds !== void 0 && !majorWithin(major, bounds)) {
+        found.mismatch = { declared, declaredMajor: bounds.lower };
+      }
+      return found;
+    }
+  } catch {
+  }
+  if (declared !== void 0) {
+    if (declaredMajor !== void 0) return { major: declaredMajor, source: "declared", value: declared };
+    return { source: "none", value: declared };
+  }
+  return { source: "none" };
+}
+var TAILWIND_CONFIG_FILES = [
+  "tailwind.config.ts",
+  "tailwind.config.js",
+  "tailwind.config.mjs",
+  "tailwind.config.cjs"
+];
+var TAILWIND_CSS_CANDIDATES = [
+  "globals.css",
+  "app/globals.css",
+  "src/app/globals.css",
+  "src/globals.css",
+  "styles/globals.css"
+];
+var TAILWIND_IMPORT = /@import\s+(?:url\(\s*)?["']tailwindcss["']/;
+function hasTailwindImport(css) {
+  return TAILWIND_IMPORT.test(css.replace(/\/\*[\s\S]*?\*\//g, ""));
+}
+function readPackageJson(baseDir) {
+  try {
+    const parsed = JSON.parse(readFileSync2(join2(baseDir, "package.json"), "utf8"));
+    return isPlainObject(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function checkTailwindSetup(baseDirInput) {
+  const baseDir = resolve2(baseDirInput);
+  const tailwind = detectTailwind(baseDir, readPackageJson(baseDir));
+  if (tailwind.major !== void 0 && tailwind.major >= 4) {
+    const label = `Tailwind ${tailwind.major}`;
+    for (const candidate of TAILWIND_CSS_CANDIDATES) {
+      const file = join2(baseDir, candidate);
+      if (!existsSync2(file)) continue;
+      const found = hasTailwindImport(readFileSync2(file, "utf8"));
+      return {
+        name: "tailwind.config",
+        severity: found ? "pass" : "warn",
+        message: found ? `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uAC00 \uC788\uC2B5\uB2C8\uB2E4` : `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4`
+      };
+    }
+    return {
+      name: "tailwind.config",
+      severity: "warn",
+      message: `${label}: @import "tailwindcss" \uB97C \uD655\uC778\uD560 CSS \uD30C\uC77C\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4`
+    };
+  }
+  const [tsFile, ...otherFiles] = TAILWIND_CONFIG_FILES;
+  const tsPath = join2(baseDir, tsFile);
+  if (existsSync2(tsPath)) {
+    const content = readFileSync2(tsPath, "utf8");
+    const hasTokens = content.includes("--background") || content.includes("hsl(var(");
+    return {
+      name: "tailwind.config",
+      severity: hasTokens ? "pass" : "warn",
+      message: hasTokens ? "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070\uC774 \uC124\uC815\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4" : "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070 \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4"
+    };
+  }
+  for (const file of otherFiles) {
+    if (existsSync2(join2(baseDir, file))) {
+      return { name: "tailwind.config", severity: "warn", message: `${file} \uC874\uC7AC (TypeScript \uAD8C\uC7A5)` };
+    }
+  }
+  return { name: "tailwind.config", severity: "fail", message: "tailwind.config \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" };
+}
+
 // src/template/template-check.ts
 var SEVERITY_ICON = {
   pass: chalk6.green("PASS"),
@@ -2109,7 +2281,7 @@ async function collectCheckResults(dir) {
   const baseDir = path8.resolve(dir || ".");
   const results = [];
   results.push(await checkFileExists(baseDir, "axis.config.json", "axis.config.json"));
-  results.push(await checkTailwindConfig(baseDir));
+  results.push(checkTailwindSetup(baseDir));
   results.push(await checkGlobalsCss(baseDir));
   results.push(await checkUtils(baseDir));
   results.push(await checkDependencies(baseDir));
@@ -2148,6 +2320,7 @@ async function runCheck(dir) {
   } else {
     console.log(chalk6.green("\n\uBAA8\uB4E0 \uAC80\uC99D\uC744 \uD1B5\uACFC\uD588\uC2B5\uB2C8\uB2E4!"));
   }
+  return { pass: passCount, warn: warnCount, fail: failCount };
 }
 async function checkFileExists(baseDir, fileName, label) {
   const exists = await fs9.pathExists(path8.join(baseDir, fileName));
@@ -2157,31 +2330,6 @@ async function checkFileExists(baseDir, fileName, label) {
     message: exists ? `${label} \uD30C\uC77C\uC774 \uC874\uC7AC\uD569\uB2C8\uB2E4` : `${label} \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 'axis init'\uC744 \uC2E4\uD589\uD558\uC138\uC694`
   };
 }
-async function checkTailwindConfig(baseDir) {
-  const tsPath = path8.join(baseDir, "tailwind.config.ts");
-  const jsPath = path8.join(baseDir, "tailwind.config.js");
-  if (await fs9.pathExists(tsPath)) {
-    const content = await fs9.readFile(tsPath, "utf-8");
-    const hasTokens = content.includes("--background") || content.includes("hsl(var(");
-    return {
-      name: "tailwind.config",
-      severity: hasTokens ? "pass" : "warn",
-      message: hasTokens ? "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070\uC774 \uC124\uC815\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4" : "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070 \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4"
-    };
-  }
-  if (await fs9.pathExists(jsPath)) {
-    return {
-      name: "tailwind.config",
-      severity: "warn",
-      message: "tailwind.config.js \uC874\uC7AC (TypeScript \uAD8C\uC7A5)"
-    };
-  }
-  return {
-    name: "tailwind.config",
-    severity: "fail",
-    message: "tailwind.config \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4"
-  };
-}
 async function checkGlobalsCss(baseDir) {
   const candidates = [
     "globals.css",
@@ -2402,7 +2550,8 @@ function registerTemplateCommand(program2) {
 }
 function registerCheckCommand(program2) {
   program2.command("check").description("AXIS \uD504\uB85C\uC81D\uD2B8 \uC124\uC815 \uAC80\uC99D").option("-d, --dir <path>", "\uB300\uC0C1 \uB514\uB809\uD1A0\uB9AC").action(async (options) => {
-    await runCheck(options.dir);
+    const summary = await runCheck(options.dir);
+    if (summary.fail > 0) process.exitCode = 1;
   });
 }
 
@@ -2411,12 +2560,12 @@ import chalk8 from "chalk";
 import path10 from "path";
 
 // src/theme/theme-add.ts
-import { accessSync, constants, existsSync as existsSync2, readFileSync as readFileSync2, realpathSync, unlinkSync, writeFileSync } from "fs";
+import { accessSync, constants, existsSync as existsSync3, readFileSync as readFileSync3, realpathSync, unlinkSync, writeFileSync } from "fs";
 import path9 from "path";
 var TOKENS_DEPENDENCY_RANGE = `^${MIN_BRAND_TOKENS_VERSION}`;
 var THEME_PACKAGE = "@axis-ds/theme";
 function readText(file) {
-  return existsSync2(file) ? readFileSync2(file, "utf8") : null;
+  return existsSync3(file) ? readFileSync3(file, "utf8") : null;
 }
 function eolOf(text) {
   return text.includes("\r\n") ? "\r\n" : "\n";
@@ -2492,12 +2641,12 @@ function isStylesheet(realPath) {
   return path9.extname(realPath).toLowerCase() === ".css";
 }
 function detectInstallCommand(baseDir) {
-  if (existsSync2(path9.join(baseDir, "pnpm-lock.yaml"))) return "pnpm install";
-  if (existsSync2(path9.join(baseDir, "yarn.lock"))) return "yarn install";
-  if (existsSync2(path9.join(baseDir, "package-lock.json"))) return "npm install";
+  if (existsSync3(path9.join(baseDir, "pnpm-lock.yaml"))) return "pnpm install";
+  if (existsSync3(path9.join(baseDir, "yarn.lock"))) return "yarn install";
+  if (existsSync3(path9.join(baseDir, "package-lock.json"))) return "npm install";
   return "pnpm install";
 }
-function hasDependency(pkg, name) {
+function hasDependency2(pkg, name) {
   for (const field of ["dependencies", "devDependencies"]) {
     const deps = pkg[field];
     if (typeof deps === "object" && deps !== null && name in deps) {
@@ -2506,7 +2655,7 @@ function hasDependency(pkg, name) {
   }
   return void 0;
 }
-function isPlainObject(value) {
+function isPlainObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function planThemeAdd(baseDirInput, brand) {
@@ -2531,7 +2680,7 @@ function planThemeAdd(baseDirInput, brand) {
   let config;
   try {
     const parsed = JSON.parse(configText);
-    if (!isPlainObject(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
+    if (!isPlainObject2(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
     config = parsed;
   } catch (err) {
     plan.errors.push({ kind: "invalid-config", message: err.message });
@@ -2543,7 +2692,7 @@ function planThemeAdd(baseDirInput, brand) {
   }
   plan.tokens = resolveTokens(baseDir);
   if (plan.tokens.status === "ok" && plan.tokens.indexPath) {
-    const data = JSON.parse(readFileSync2(plan.tokens.indexPath, "utf8"));
+    const data = JSON.parse(readFileSync3(plan.tokens.indexPath, "utf8"));
     const entries = Array.isArray(data.brands) ? data.brands : [];
     const entry = entries.find((e) => e.name === brand);
     if (!entry) {
@@ -2572,7 +2721,7 @@ function planThemeAdd(baseDirInput, brand) {
       plan.writes = [];
       return plan;
     }
-    const before = readFileSync2(location.path, "utf8");
+    const before = readFileSync3(location.path, "utf8");
     const imported = findBrandImports(before);
     const otherBrands = [...new Set(imported.filter((n) => n !== brand))];
     if (imported.includes(brand)) {
@@ -2598,19 +2747,19 @@ function planThemeAdd(baseDirInput, brand) {
     let pkg;
     try {
       const parsed = JSON.parse(pkgText);
-      if (!isPlainObject(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
+      if (!isPlainObject2(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
       pkg = parsed;
     } catch (err) {
       plan.errors.push({ kind: "invalid-package-json", message: err.message });
       plan.writes = [];
       return plan;
     }
-    const themeMissing = hasDependency(pkg, THEME_PACKAGE) === void 0;
-    const declared = hasDependency(pkg, TOKENS_PACKAGE);
+    const themeMissing = hasDependency2(pkg, THEME_PACKAGE) === void 0;
+    const declared = hasDependency2(pkg, TOKENS_PACKAGE);
     if (declared !== void 0) {
       plan.dependency = { action: "present", declaredRange: declared, upgrade, themeMissing };
     } else {
-      const deps = isPlainObject(pkg.dependencies) ? { ...pkg.dependencies } : {};
+      const deps = isPlainObject2(pkg.dependencies) ? { ...pkg.dependencies } : {};
       deps[TOKENS_PACKAGE] = TOKENS_DEPENDENCY_RANGE;
       const next = { ...pkg, dependencies: deps };
       plan.dependency = { action: "add", upgrade, themeMissing };
@@ -2985,74 +3134,265 @@ function registerThemeCommand(program2) {
   });
 }
 
-// src/index.ts
-var { version: CLI_VERSION } = createRequire2(import.meta.url)("../package.json");
-var REGISTRY_URL = process.env.AXIS_REGISTRY_URL || "https://axis.minu.best/r";
-var program = new Command();
-program.name("axis").description("AXIS Design System CLI - shadcn \uD638\uD658 \uCEF4\uD3EC\uB10C\uD2B8 \uC124\uCE58 \uB3C4\uAD6C").version(CLI_VERSION);
-program.command("init").description("\uD504\uB85C\uC81D\uD2B8\uC5D0 AXIS Design System \uCD08\uAE30\uD654").option("-y, --yes", "\uAE30\uBCF8\uAC12\uC73C\uB85C \uC790\uB3D9 \uC124\uC815").action(async (options) => {
-  console.log(chalk9.blue("\n\u{1F3A8} AXIS Design System \uCD08\uAE30\uD654\n"));
-  const config = options.yes ? {
-    componentsDir: "./src/components/ui",
-    tailwindConfig: "./tailwind.config.ts",
-    globalCss: "./src/app/globals.css"
-  } : await prompts2([
-    {
-      type: "text",
-      name: "componentsDir",
-      message: "\uCEF4\uD3EC\uB10C\uD2B8 \uB514\uB809\uD1A0\uB9AC:",
-      initial: "./src/components/ui"
-    },
-    {
-      type: "text",
-      name: "tailwindConfig",
-      message: "Tailwind \uC124\uC815 \uD30C\uC77C:",
-      initial: "./tailwind.config.ts"
-    },
-    {
-      type: "text",
-      name: "globalCss",
-      message: "\uAE00\uB85C\uBC8C CSS \uD30C\uC77C:",
-      initial: "./src/app/globals.css"
-    }
-  ]);
+// src/init/index.ts
+import chalk10 from "chalk";
+import prompts2 from "prompts";
+
+// src/init/init.ts
+import { accessSync as accessSync2, constants as constants2, existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
+import path11 from "path";
+import chalk9 from "chalk";
+import fs10 from "fs-extra";
+var CLSX_RANGE = "^2.1.1";
+var TAILWIND_MERGE_RANGES = {
+  tailwind4: "^3.4.0",
+  tailwind3: "^2.6.0"
+};
+function selectUtilsDependencies(tailwind) {
+  return {
+    clsx: CLSX_RANGE,
+    "tailwind-merge": tailwind.major !== void 0 && tailwind.major >= 4 ? TAILWIND_MERGE_RANGES.tailwind4 : TAILWIND_MERGE_RANGES.tailwind3
+  };
+}
+function tailwindWarnings(tailwind, installCommand) {
+  const out = [];
+  if (tailwind.source === "none" && tailwind.value !== void 0) {
+    out.push(
+      `! tailwindcss \uC120\uC5B8(${tailwind.value})\uC740 \uD310\uC815 \uBD88\uAC00 - \uAE30\uBCF8\uAC12 \uC0AC\uC6A9(Tailwind 3, tailwind-merge ${TAILWIND_MERGE_RANGES.tailwind3}). Tailwind 4 \uC774\uC0C1\uC774\uBA74 tailwind-merge \uB97C ${TAILWIND_MERGE_RANGES.tailwind4} \uC73C\uB85C \uBC14\uAFB8\uC138\uC694.`
+    );
+  }
+  if (tailwind.mismatch) {
+    out.push(
+      `! \uC124\uCE58\uBCF8 tailwindcss ${tailwind.value}(major ${tailwind.major})\uC640 package.json \uC120\uC5B8 ${tailwind.mismatch.declared}(major ${tailwind.mismatch.declaredMajor})\uAC00 \uB2E4\uB984 - \uC124\uCE58\uBCF8\uC744 \uB530\uB790\uC2B5\uB2C8\uB2E4. ${installCommand} \uB4A4 tailwind-merge \uBC94\uC704\uB97C \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694.`
+    );
+  }
+  return out;
+}
+function describeTailwindBasis(tailwind) {
+  if (tailwind.source === "installed") return `\uC124\uCE58\uB41C tailwindcss ${tailwind.value}`;
+  if (tailwind.source === "declared") return `package.json \uC758 tailwindcss ${tailwind.value}`;
+  if (tailwind.value !== void 0) {
+    return `package.json \uC758 tailwindcss ${tailwind.value} \uB85C \uBC84\uC804\uC744 \uD310\uC815\uD558\uC9C0 \uBABB\uD574 \uAE30\uBCF8\uAC12(Tailwind 3)`;
+  }
+  return "tailwindcss \uB97C \uCC3E\uC9C0 \uBABB\uD574 \uAE30\uBCF8\uAC12(Tailwind 3)";
+}
+var UTILS_TS_CONTENT = `import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+`;
+var INIT_DEFAULTS = {
+  componentsDir: "./src/components/ui",
+  tailwindConfig: "./tailwind.config.ts",
+  globalCss: "./src/app/globals.css"
+};
+var INIT_NEXT_STEP_COMMAND = "npx @axis-ds/cli add button";
+var BOM = "\uFEFF";
+function addCommandFor(installCommand, deps) {
+  const specs = Object.entries(deps).map(([name, range]) => `"${name}@${range}"`).join(" ");
+  if (installCommand.startsWith("yarn")) return `yarn add ${specs}`;
+  if (installCommand.startsWith("npm")) return `npm install ${specs}`;
+  return `pnpm add ${specs}`;
+}
+function planUtilsDependencies(baseDirInput) {
+  const baseDir = path11.resolve(baseDirInput);
+  const installCommand = detectInstallCommand(baseDir);
+  const tailwind0 = detectTailwind(baseDir);
+  const ranges0 = selectUtilsDependencies(tailwind0);
+  const plan = {
+    action: "no-package-json",
+    added: [],
+    present: [],
+    ranges: ranges0,
+    tailwind: tailwind0,
+    installCommand,
+    addCommand: addCommandFor(installCommand, ranges0)
+  };
+  const pkgFile = path11.join(baseDir, "package.json");
+  if (!existsSync4(pkgFile)) return plan;
+  const unwritable = (reason) => ({ ...plan, action: "unwritable", reason });
+  let where;
+  try {
+    where = realPathInside(baseDir, pkgFile);
+  } catch (err) {
+    return unwritable(err.message);
+  }
+  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 = readFileSync4(pkgFile, "utf8");
+  } catch (err) {
+    return unwritable(err.message);
+  }
+  const bom = text.startsWith(BOM) ? BOM : "";
+  const body = bom ? text.slice(1) : text;
+  let pkg;
+  try {
+    const parsed = JSON.parse(body);
+    if (!isPlainObject2(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
+    pkg = parsed;
+  } catch (err) {
+    return unwritable(`JSON \uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${err.message}`);
+  }
+  plan.tailwind = detectTailwind(baseDir, pkg);
+  plan.ranges = selectUtilsDependencies(plan.tailwind);
+  plan.addCommand = addCommandFor(installCommand, plan.ranges);
+  const missing = {};
+  for (const [name, range] of Object.entries(plan.ranges)) {
+    const declared = hasDependency2(pkg, name);
+    if (declared !== void 0) plan.present.push({ name, range: declared });
+    else missing[name] = range;
+  }
+  plan.added = Object.keys(missing);
+  plan.addCommand = addCommandFor(installCommand, plan.added.length > 0 ? missing : plan.ranges);
+  if (plan.added.length === 0) return { ...plan, action: "present" };
+  if (pkg.dependencies !== void 0 && !isPlainObject2(pkg.dependencies)) {
+    return unwritable("dependencies \uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
+  }
+  try {
+    accessSync2(pkgFile, constants2.W_OK);
+  } catch (err) {
+    return unwritable(`\uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${err.message})`);
+  }
+  const deps = { ...pkg.dependencies ?? {}, ...missing };
+  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);
+function applyUtilsDependencies(baseDirInput, plan, writeFile = defaultWriteFile) {
+  const w = plan.write;
+  if (plan.action !== "add" || !w) return false;
+  const baseDir = path11.resolve(baseDirInput);
+  const current = existsSync4(w.file) ? readFileSync4(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.`);
+  }
+  const where = realPathInside(baseDir, w.file);
+  if (!where.inside) {
+    throw new Error(`${w.file} \uC758 \uC2E4\uC81C \uC704\uCE58(${where.realPath})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4. \uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`);
+  }
+  JSON.parse(w.after.startsWith(BOM) ? w.after.slice(1) : w.after);
+  try {
+    writeFile(w.file, w.after);
+  } catch (err) {
+    const cause = err.message;
+    let restored;
+    try {
+      writeFile(w.file, w.before);
+      if (readFileSync4(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`;
+    }
+    throw new Error(`${w.file} \uC744 \uC4F0\uB294 \uB3C4\uC911 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4(${cause}). ${restored}.`);
+  }
+  return true;
+}
+function reportDependencies(plan, log) {
+  const presentText = plan.present.map((p) => `${p.name} (${p.range})`).join(", ");
+  const basis = `  tailwind-merge \uBC94\uC704 \uAE30\uC900: ${describeTailwindBasis(plan.tailwind)}`;
+  const logBasis = () => {
+    log(chalk9.gray(basis));
+    for (const w of tailwindWarnings(plan.tailwind, plan.installCommand)) log(chalk9.yellow(`  ${w}`));
+  };
+  if (plan.action === "add") {
+    const addedText = plan.added.map((n) => `${n}@${plan.ranges[n]}`).join(", ");
+    log(chalk9.green(`\u2713 package.json dependencies \uC5D0 \uCD94\uAC00: ${addedText}`));
+    if (plan.present.length > 0) log(chalk9.gray(`  \uC774\uBBF8 \uC788\uC74C(\uBC84\uC804 \uC720\uC9C0): ${presentText}`));
+    if (plan.added.includes("tailwind-merge")) logBasis();
+    log(chalk9.yellow(`  \uC124\uCE58\uB294 \uC2E4\uD589\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC124\uCE58: ${chalk9.cyan(plan.installCommand)}`));
+  } else if (plan.action === "present") {
+    log(chalk9.green(`\u2713 utils.ts \uC758\uC874\uC131\uC774 package.json \uC5D0 \uC774\uBBF8 \uC788\uC2B5\uB2C8\uB2E4(\uBC84\uC804 \uC720\uC9C0): ${presentText}`));
+    log(chalk9.yellow(`  \uC124\uCE58\uB294 \uC2E4\uD589\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC124\uCE58: ${chalk9.cyan(plan.installCommand)}`));
+  } else if (plan.action === "no-package-json") {
+    log(chalk9.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(chalk9.yellow(`  \uC124\uCE58: ${chalk9.cyan(plan.addCommand)}`));
+    logBasis();
+  } else {
+    log(chalk9.yellow(`! package.json \uC744 \uBC14\uAFB8\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4(${plan.reason}).`));
+    log(chalk9.yellow(`  utils.ts \uC758\uC874\uC131 \uC124\uCE58: ${chalk9.cyan(plan.addCommand)}`));
+    if (plan.addCommand.includes('"tailwind-merge@')) logBasis();
+  }
+}
+async function runInit(baseDirInput, answers, registryUrl, log = console.log) {
+  const baseDir = path11.resolve(baseDirInput);
   const axisConfig = createInitConfig(
     {
-      componentsDir: config.componentsDir,
-      tailwindConfig: config.tailwindConfig,
-      globalCss: config.globalCss
+      componentsDir: answers.componentsDir,
+      tailwindConfig: answers.tailwindConfig,
+      globalCss: answers.globalCss
     },
-    REGISTRY_URL
+    registryUrl
   );
-  await fs10.writeJSON("axis.config.json", axisConfig, { spaces: 2 });
-  console.log(chalk9.green("\u2713 axis.config.json \uC0DD\uC131 \uC644\uB8CC"));
-  const utilsPath = path11.join(config.componentsDir, "utils.ts");
+  await fs10.writeJSON(path11.join(baseDir, "axis.config.json"), axisConfig, { spaces: 2 });
+  log(chalk9.green("\u2713 axis.config.json \uC0DD\uC131 \uC644\uB8CC"));
+  const utilsPath = path11.resolve(baseDir, answers.componentsDir, "utils.ts");
   await fs10.ensureDir(path11.dirname(utilsPath));
-  await fs10.writeFile(
-    utilsPath,
-    `import { type ClassValue, clsx } from "clsx";
-import { twMerge } from "tailwind-merge";
+  await fs10.writeFile(utilsPath, UTILS_TS_CONTENT);
+  log(chalk9.green("\u2713 utils.ts \uC0DD\uC131 \uC644\uB8CC"));
+  const plan = planUtilsDependencies(baseDir);
+  try {
+    applyUtilsDependencies(baseDir, plan);
+  } catch (err) {
+    log(chalk9.red(`\u2717 package.json \uC744 \uC4F0\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${err.message}`));
+    log(chalk9.yellow("  axis.config.json \uACFC utils.ts \uB294 \uC774\uBBF8 \uB9CC\uB4E4\uC5B4\uC84C\uC2B5\uB2C8\uB2E4."));
+    log(chalk9.yellow(`  utils.ts \uC758\uC874\uC131 \uC124\uCE58: ${chalk9.cyan(plan.addCommand)}`));
+    process.exitCode = 1;
+    return;
+  }
+  reportDependencies(plan, log);
+  log(chalk9.blue("\n\uCD08\uAE30\uD654 \uC644\uB8CC! \uC774\uC81C \uB2E4\uC74C \uBA85\uB839\uC5B4\uB85C \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uCD94\uAC00\uD558\uC138\uC694:"));
+  log(chalk9.cyan(`  ${INIT_NEXT_STEP_COMMAND}
+`));
+}
 
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs));
+// src/init/index.ts
+function registerInitCommand(program2, registryUrl) {
+  program2.command("init").description("\uD504\uB85C\uC81D\uD2B8\uC5D0 AXIS Design System \uCD08\uAE30\uD654").option("-y, --yes", "\uAE30\uBCF8\uAC12\uC73C\uB85C \uC790\uB3D9 \uC124\uC815").action(async (options) => {
+    console.log(chalk10.blue("\n\u{1F3A8} AXIS Design System \uCD08\uAE30\uD654\n"));
+    const config = options.yes ? { ...INIT_DEFAULTS } : await prompts2([
+      {
+        type: "text",
+        name: "componentsDir",
+        message: "\uCEF4\uD3EC\uB10C\uD2B8 \uB514\uB809\uD1A0\uB9AC:",
+        initial: INIT_DEFAULTS.componentsDir
+      },
+      {
+        type: "text",
+        name: "tailwindConfig",
+        message: "Tailwind \uC124\uC815 \uD30C\uC77C:",
+        initial: INIT_DEFAULTS.tailwindConfig
+      },
+      {
+        type: "text",
+        name: "globalCss",
+        message: "\uAE00\uB85C\uBC8C CSS \uD30C\uC77C:",
+        initial: INIT_DEFAULTS.globalCss
+      }
+    ]);
+    await runInit(process.cwd(), config, registryUrl);
+  });
 }
-`
-  );
-  console.log(chalk9.green("\u2713 utils.ts \uC0DD\uC131 \uC644\uB8CC"));
-  console.log(chalk9.blue("\n\uCD08\uAE30\uD654 \uC644\uB8CC! \uC774\uC81C \uB2E4\uC74C \uBA85\uB839\uC5B4\uB85C \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uCD94\uAC00\uD558\uC138\uC694:"));
-  console.log(chalk9.cyan("  npx axis-cli add button\n"));
-});
+
+// src/index.ts
+var { version: CLI_VERSION } = createRequire2(import.meta.url)("../package.json");
+var REGISTRY_URL = process.env.AXIS_REGISTRY_URL || "https://axis.minu.best/r";
+var program = new Command();
+program.name("axis").description("AXIS Design System CLI - shadcn \uD638\uD658 \uCEF4\uD3EC\uB10C\uD2B8 \uC124\uCE58 \uB3C4\uAD6C").version(CLI_VERSION);
+registerInitCommand(program, REGISTRY_URL);
 program.command("add <component>").description("\uCEF4\uD3EC\uB10C\uD2B8 \uCD94\uAC00").option("--agentic", "Agentic UI \uCEF4\uD3EC\uB10C\uD2B8 \uCD94\uAC00").option("-y, --yes", "\uD655\uC778 \uC5C6\uC774 \uB36E\uC5B4\uC4F0\uAE30").action(async (component, options) => {
   const spinner = ora6(`${component} \uCEF4\uD3EC\uB10C\uD2B8 \uAC00\uC838\uC624\uB294 \uC911...`).start();
   try {
-    const configPath = path11.resolve("axis.config.json");
-    if (!await fs10.pathExists(configPath)) {
+    const configPath = path12.resolve("axis.config.json");
+    if (!await fs11.pathExists(configPath)) {
       spinner.fail(
         "axis.config.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.\n  \uD574\uACB0: \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8\uC5D0\uC11C 'npx @axis-ds/cli init'\uC744 \uC2E4\uD589\uD558\uC138\uC694.\n  \uCC38\uACE0: https://axis.minu.best/docs/guides/quick-start"
       );
       process.exit(1);
     }
-    const config = await fs10.readJSON(configPath);
+    const config = await fs11.readJSON(configPath);
     const category = options.agentic ? "agentic" : "ui";
     const componentInfo = await getComponentInfo(component, category);
     if (!componentInfo) {
@@ -3065,10 +3405,10 @@ program.command("add <component>").description("\uCEF4\uD3EC\uB10C\uD2B8 \uCD94\
     }
     spinner.text = `${component} \uCEF4\uD3EC\uB10C\uD2B8 \uC124\uCE58 \uC911...`;
     for (const file of componentInfo.files) {
-      const filePath = path11.join(config.componentsDir, file.path);
-      if (await fs10.pathExists(filePath)) {
+      const filePath = path12.join(config.componentsDir, file.path);
+      if (await fs11.pathExists(filePath)) {
         if (!options.yes) {
-          const { overwrite } = await prompts2({
+          const { overwrite } = await prompts3({
             type: "confirm",
             name: "overwrite",
             message: `${file.path}\uC774(\uAC00) \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4. \uB36E\uC5B4\uC4F0\uC2DC\uACA0\uC2B5\uB2C8\uAE4C?`,
@@ -3077,13 +3417,13 @@ program.command("add <component>").description("\uCEF4\uD3EC\uB10C\uD2B8 \uCD94\
           if (!overwrite) continue;
         }
       }
-      await fs10.ensureDir(path11.dirname(filePath));
-      await fs10.writeFile(filePath, file.content);
+      await fs11.ensureDir(path12.dirname(filePath));
+      await fs11.writeFile(filePath, file.content);
     }
-    spinner.succeed(chalk9.green(`${component} \uCEF4\uD3EC\uB10C\uD2B8 \uCD94\uAC00 \uC644\uB8CC`));
+    spinner.succeed(chalk11.green(`${component} \uCEF4\uD3EC\uB10C\uD2B8 \uCD94\uAC00 \uC644\uB8CC`));
     if (componentInfo.dependencies.length > 0) {
-      console.log(chalk9.yellow("\n\uD544\uC694\uD55C \uC758\uC874\uC131:"));
-      console.log(chalk9.cyan(`  pnpm add ${componentInfo.dependencies.join(" ")}`));
+      console.log(chalk11.yellow("\n\uD544\uC694\uD55C \uC758\uC874\uC131:"));
+      console.log(chalk11.cyan(`  pnpm add ${componentInfo.dependencies.join(" ")}`));
     }
   } catch (error) {
     spinner.fail(
@@ -3095,7 +3435,7 @@ program.command("add <component>").description("\uCEF4\uD3EC\uB10C\uD2B8 \uCD94\
   }
 });
 program.command("list").description("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uCEF4\uD3EC\uB10C\uD2B8 \uBAA9\uB85D").option("--category <type>", "\uCE74\uD14C\uACE0\uB9AC \uD544\uD130 (ui, agentic)").action(async (options) => {
-  console.log(chalk9.blue("\n\u{1F4E6} AXIS Design System \uCEF4\uD3EC\uB10C\uD2B8\n"));
+  console.log(chalk11.blue("\n\u{1F4E6} AXIS Design System \uCEF4\uD3EC\uB10C\uD2B8\n"));
   const components = {
     ui: [
       { name: "button", description: "\uAE30\uBCF8 \uBC84\uD2BC \uCEF4\uD3EC\uB10C\uD2B8" },
@@ -3123,9 +3463,9 @@ program.command("list").description("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uCEF4\uD3E
     ]
   };
   const showCategory = (category, items) => {
-    console.log(chalk9.bold(category === "ui" ? "Core UI" : "Agentic UI"));
+    console.log(chalk11.bold(category === "ui" ? "Core UI" : "Agentic UI"));
     items.forEach((c) => {
-      console.log(`  ${chalk9.cyan(c.name.padEnd(20))} ${chalk9.gray(c.description)}`);
+      console.log(`  ${chalk11.cyan(c.name.padEnd(20))} ${chalk11.gray(c.description)}`);
     });
     console.log();
   };
@@ -3135,8 +3475,8 @@ program.command("list").description("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uCEF4\uD3E
   if (!options.category || options.category === "agentic") {
     showCategory("agentic", components.agentic);
   }
-  console.log(chalk9.gray("\uC0AC\uC6A9\uBC95: npx axis-cli add <component-name>"));
-  console.log(chalk9.gray("Agentic: npx axis-cli add <component-name> --agentic\n"));
+  console.log(chalk11.gray("\uC0AC\uC6A9\uBC95: npx @axis-ds/cli add <component-name>"));
+  console.log(chalk11.gray("Agentic: npx @axis-ds/cli add <component-name> --agentic\n"));
 });
 var monetCmd = program.command("monet").description("Monet Design \uCEF4\uD3EC\uB10C\uD2B8 \uAD00\uB9AC (https://monet.design)");
 monetCmd.command("list").alias("ls").description("Monet \uCE74\uD14C\uACE0\uB9AC \uBAA9\uB85D").action(async () => {
@@ -3156,24 +3496,24 @@ monetCmd.command("import").alias("i").description("\uD074\uB9BD\uBCF4\uB4DC\uC5D
   await client.importFromClipboard();
 });
 monetCmd.command("setup").description("Monet MCP \uC11C\uBC84 \uC124\uC815 \uC548\uB0B4").action(() => {
-  console.log(chalk9.blue("\n\u{1F527} Monet MCP \uC11C\uBC84 \uC124\uC815\n"));
-  console.log(chalk9.bold("1. API \uD0A4 \uBC1C\uAE09:"));
-  console.log(chalk9.cyan("   https://monet.design/mcp\n"));
-  console.log(chalk9.bold("2. \uD658\uACBD \uBCC0\uC218 \uC124\uC815:"));
-  console.log(chalk9.gray("   .env \uD30C\uC77C\uC5D0 \uCD94\uAC00:"));
-  console.log(chalk9.cyan("   MONET_API_KEY=your-api-key-here\n"));
-  console.log(chalk9.bold("3. Claude Code MCP \uC124\uC815:"));
-  console.log(chalk9.gray("   .claude/mcp.json\uC5D0\uC11C monet \uC11C\uBC84 \uD65C\uC131\uD654:\n"));
+  console.log(chalk11.blue("\n\u{1F527} Monet MCP \uC11C\uBC84 \uC124\uC815\n"));
+  console.log(chalk11.bold("1. API \uD0A4 \uBC1C\uAE09:"));
+  console.log(chalk11.cyan("   https://monet.design/mcp\n"));
+  console.log(chalk11.bold("2. \uD658\uACBD \uBCC0\uC218 \uC124\uC815:"));
+  console.log(chalk11.gray("   .env \uD30C\uC77C\uC5D0 \uCD94\uAC00:"));
+  console.log(chalk11.cyan("   MONET_API_KEY=your-api-key-here\n"));
+  console.log(chalk11.bold("3. Claude Code MCP \uC124\uC815:"));
+  console.log(chalk11.gray("   .claude/mcp.json\uC5D0\uC11C monet \uC11C\uBC84 \uD65C\uC131\uD654:\n"));
   console.log(
-    chalk9.cyan(`   "monet": {
+    chalk11.cyan(`   "monet": {
      "url": "https://www.monet.design/api/remote/mcp",
      "headers": { "Authorization": "Bearer \${MONET_API_KEY}" },
      "disabled": false
    }
 `)
   );
-  console.log(chalk9.bold("4. Claude Code \uC7AC\uC2DC\uC791 \uD6C4 \uC0AC\uC6A9:"));
-  console.log(chalk9.gray('   "monet\uC5D0\uC11C hero \uCEF4\uD3EC\uB10C\uD2B8 \uCC3E\uC544\uC918"\n'));
+  console.log(chalk11.bold("4. Claude Code \uC7AC\uC2DC\uC791 \uD6C4 \uC0AC\uC6A9:"));
+  console.log(chalk11.gray('   "monet\uC5D0\uC11C hero \uCEF4\uD3EC\uB10C\uD2B8 \uCC3E\uC544\uC918"\n'));
 });
 var v0Cmd = program.command("v0").description("V0 (v0.app) \uCF54\uB4DC \uBCC0\uD658 \uBC0F \uD1B5\uD569");
 v0Cmd.command("convert <file>").alias("c").description("V0 \uCF54\uB4DC\uB97C AXIS \uC2A4\uD0C0\uC77C\uB85C \uBCC0\uD658").option("-o, --output <path>", "\uCD9C\uB825 \uD30C\uC77C \uACBD\uB85C").action(async (file, options) => {
@@ -3210,18 +3550,18 @@ libraryCmd.command("collect").alias("c").description("\uC678\uBD80 \uC18C\uC2A4\
     total += result.collected;
     failed += result.failed;
   }
-  console.log(chalk9.blue(`
+  console.log(chalk11.blue(`
 \u{1F4CA} \uC218\uC9D1 \uC644\uB8CC: ${total}\uAC1C \uCEF4\uD3EC\uB10C\uD2B8`));
   if (failed > 0) {
-    console.log(chalk9.yellow(`   \uC2E4\uD328: ${failed}\uAC1C`));
+    console.log(chalk11.yellow(`   \uC2E4\uD328: ${failed}\uAC1C`));
   }
 });
 libraryCmd.command("list").alias("ls").description("\uB77C\uC774\uBE0C\uB7EC\uB9AC \uCEF4\uD3EC\uB10C\uD2B8 \uBAA9\uB85D").option("-c, --category <category>", "\uCE74\uD14C\uACE0\uB9AC \uD544\uD130").option("-s, --source <source>", "\uC18C\uC2A4 \uD544\uD130").action(async (options) => {
   const curator = new LibraryCurator();
   const index = await curator.loadIndex();
   if (!index) {
-    console.log(chalk9.yellow("\n\u26A0\uFE0F  \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC778\uB371\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
-    console.log(chalk9.gray("   \uD574\uACB0: npx @axis-ds/cli library collect \uBA85\uB839\uC5B4\uB85C \uC218\uC9D1\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.\n"));
+    console.log(chalk11.yellow("\n\u26A0\uFE0F  \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC778\uB371\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk11.gray("   \uD574\uACB0: npx @axis-ds/cli library collect \uBA85\uB839\uC5B4\uB85C \uC218\uC9D1\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.\n"));
     return;
   }
   let components = index.components;
@@ -3231,7 +3571,7 @@ libraryCmd.command("list").alias("ls").description("\uB77C\uC774\uBE0C\uB7EC\uB9
   if (options.source) {
     components = components.filter((c) => c.source.type === options.source);
   }
-  console.log(chalk9.blue(`
+  console.log(chalk11.blue(`
 \u{1F4E6} Library Components (${components.length}\uAC1C)
 `));
   const byCategory = /* @__PURE__ */ new Map();
@@ -3243,14 +3583,14 @@ libraryCmd.command("list").alias("ls").description("\uB77C\uC774\uBE0C\uB7EC\uB9
     byCategory.get(cat).push(comp);
   }
   for (const [category, items] of byCategory) {
-    console.log(chalk9.bold(`${category} (${items.length})`));
+    console.log(chalk11.bold(`${category} (${items.length})`));
     for (const item of items.slice(0, 10)) {
       console.log(
-        `  ${chalk9.cyan(item.name.padEnd(25))} ${chalk9.gray(item.source.type.padEnd(8))} ${chalk9.gray(item.description.slice(0, 40))}`
+        `  ${chalk11.cyan(item.name.padEnd(25))} ${chalk11.gray(item.source.type.padEnd(8))} ${chalk11.gray(item.description.slice(0, 40))}`
       );
     }
     if (items.length > 10) {
-      console.log(chalk9.gray(`  ... \uC678 ${items.length - 10}\uAC1C`));
+      console.log(chalk11.gray(`  ... \uC678 ${items.length - 10}\uAC1C`));
     }
     console.log();
   }
@@ -3262,21 +3602,21 @@ libraryCmd.command("search <query>").alias("s").description("\uCEF4\uD3EC\uB10C\
     source: options.source
   });
   if (results.length === 0) {
-    console.log(chalk9.yellow(`
+    console.log(chalk11.yellow(`
 '${query}'\uC5D0 \uB300\uD55C \uAC80\uC0C9 \uACB0\uACFC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.
 `));
     return;
   }
-  console.log(chalk9.blue(`
+  console.log(chalk11.blue(`
 \u{1F50D} '${query}' \uAC80\uC0C9 \uACB0\uACFC (${results.length}\uAC1C)
 `));
   for (const comp of results.slice(0, 20)) {
     console.log(
-      `  ${chalk9.cyan(comp.name.padEnd(25))} ${chalk9.gray(comp.source.type.padEnd(8))} ${chalk9.gray(comp.category.padEnd(12))} ${chalk9.gray(comp.description.slice(0, 30))}`
+      `  ${chalk11.cyan(comp.name.padEnd(25))} ${chalk11.gray(comp.source.type.padEnd(8))} ${chalk11.gray(comp.category.padEnd(12))} ${chalk11.gray(comp.description.slice(0, 30))}`
     );
   }
   if (results.length > 20) {
-    console.log(chalk9.gray(`
+    console.log(chalk11.gray(`
   ... \uC678 ${results.length - 20}\uAC1C`));
   }
   console.log();
@@ -3290,12 +3630,12 @@ libraryCmd.command("publish").description("\uC0AC\uC774\uD2B8\uC5D0 \uB77C\uC774
   const publisher2 = new Publisher();
   const index = await curator.loadIndex();
   if (!index) {
-    console.log(chalk9.yellow("\n\u26A0\uFE0F  \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC778\uB371\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
-    console.log(chalk9.gray("   \uD574\uACB0: npx @axis-ds/cli library collect \uBA85\uB839\uC5B4\uB85C \uC218\uC9D1\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.\n"));
+    console.log(chalk11.yellow("\n\u26A0\uFE0F  \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC778\uB371\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk11.gray("   \uD574\uACB0: npx @axis-ds/cli library collect \uBA85\uB839\uC5B4\uB85C \uC218\uC9D1\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.\n"));
     return;
   }
-  console.log(chalk9.blue("\n\u{1F4E4} Library \uBC30\uCE58\n"));
-  console.log(chalk9.gray(`\uCD1D ${index.stats.total}\uAC1C \uCEF4\uD3EC\uB10C\uD2B8
+  console.log(chalk11.blue("\n\u{1F4E4} Library \uBC30\uCE58\n"));
+  console.log(chalk11.gray(`\uCD1D ${index.stats.total}\uAC1C \uCEF4\uD3EC\uB10C\uD2B8
 `));
   if (options.clean) {
     await publisher2.clean(options.output);
@@ -3306,17 +3646,17 @@ libraryCmd.command("publish").description("\uC0AC\uC774\uD2B8\uC5D0 \uB77C\uC774
     generateSearchIndex: true
   });
   if (result.success) {
-    console.log(chalk9.green(`
+    console.log(chalk11.green(`
 \u2713 \uBC30\uCE58 \uC644\uB8CC`));
-    console.log(chalk9.gray(`  - \uCD9C\uB825 \uB514\uB809\uD1A0\uB9AC: ${result.outputDir}`));
-    console.log(chalk9.gray(`  - \uC0DD\uC131\uB41C \uD30C\uC77C: ${result.files.length}\uAC1C`));
-    console.log(chalk9.gray(`  - \uCE74\uD14C\uACE0\uB9AC: ${result.stats.categoriesPublished}\uAC1C`));
-    console.log(chalk9.gray(`  - \uAC80\uC0C9 \uC778\uB371\uC2A4: ${result.stats.searchIndexSize}\uAC1C \uD56D\uBAA9`));
+    console.log(chalk11.gray(`  - \uCD9C\uB825 \uB514\uB809\uD1A0\uB9AC: ${result.outputDir}`));
+    console.log(chalk11.gray(`  - \uC0DD\uC131\uB41C \uD30C\uC77C: ${result.files.length}\uAC1C`));
+    console.log(chalk11.gray(`  - \uCE74\uD14C\uACE0\uB9AC: ${result.stats.categoriesPublished}\uAC1C`));
+    console.log(chalk11.gray(`  - \uAC80\uC0C9 \uC778\uB371\uC2A4: ${result.stats.searchIndexSize}\uAC1C \uD56D\uBAA9`));
   } else {
-    console.log(chalk9.red(`
+    console.log(chalk11.red(`
 \u2717 \uBC30\uCE58 \uC2E4\uD328`));
     for (const error of result.errors) {
-      console.log(chalk9.red(`  - ${error}`));
+      console.log(chalk11.red(`  - ${error}`));
     }
   }
   console.log();

package/dist/monet.d.ts

@@ -4,9 +4,9 @@
  * Monet (https://monet.design) 컴포넌트를 검색하고 AXIS 프로젝트에 가져옵니다.
  *
  * 사용법:
- *   axis-cli monet list              # 카테고리 목록
- *   axis-cli monet search <query>    # 컴포넌트 검색
- *   axis-cli monet add <id>          # 컴포넌트 추가
+ *   npx @axis-ds/cli monet list              # 카테고리 목록
+ *   npx @axis-ds/cli monet search <query>    # 컴포넌트 검색
+ *   npx @axis-ds/cli monet add <id>          # 컴포넌트 추가
  */
 declare const MONET_CATEGORIES: readonly [{
     readonly id: "hero";

package/dist/monet.js

@@ -3,7 +3,7 @@ import {
   MonetClient,
   getMonetMcpConfig,
   getMonetUrl
-} from "./chunk-WRDOGNSG.js";
+} from "./chunk-ZVVACWEW.js";
 export {
   MONET_CATEGORIES,
   MonetClient,

package/dist/sync/index.js

@@ -9,7 +9,7 @@ import {
   parseContent,
   parseProjectTodo,
   registerSyncCommand
-} from "../chunk-D26GW2HO.js";
+} from "../chunk-QORBOSUA.js";
 export {
   GitHubClient,
   STATUS_MAP,

package/dist/v0.d.ts

@@ -4,9 +4,9 @@
  * V0 (https://v0.app) 생성 코드를 AXIS 프로젝트에 통합합니다.
  *
  * 사용법:
- *   axis-cli v0 convert <file>     # V0 코드를 AXIS 스타일로 변환
- *   axis-cli v0 import <url>       # V0 URL에서 가져오기
- *   axis-cli v0 setup              # GitHub 연동 안내
+ *   npx @axis-ds/cli v0 convert <file>     # V0 코드를 AXIS 스타일로 변환
+ *   npx @axis-ds/cli v0 import <url>       # V0 URL에서 가져오기
+ *   npx @axis-ds/cli v0 setup              # GitHub 연동 안내
  */
 declare class V0Client {
     convertCode(code: string, options?: {

package/dist/v0.js

@@ -2,7 +2,7 @@ import {
   V0Client,
   getV0Url,
   isV0Code
-} from "./chunk-GCOWKKXG.js";
+} from "./chunk-AHQT77FJ.js";
 export {
   V0Client,
   getV0Url,

package/package.json

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