@axis-ds/cli 1.7.0 → 1.7.2

package/README.md

@@ -84,7 +84,7 @@ axis theme add ontology
 ```
 
 - `axis theme add` 는 `axis.config.json` 의 `globalCss` → `app/globals.css` → `src/app/globals.css` → `styles/globals.css` → `src/styles/globals.css` → 루트 `globals.css` 순으로 찾은 파일의 앞쪽 import 구간 끝(`@tailwind` 등 규칙보다 앞)에 줄을 넣습니다. 1.6.0 부터 브랜드 import 앞에 기본 토큰 CSS 도 넣습니다: Tailwind 3 은 `@axis-ds/tokens/css` · `@axis-ds/tokens/css/shadcn`, Tailwind 4 는 `@axis-ds/tokens/css/tailwind4` 와 `package.json` 에 선언된 `@axis-ds/ui-react` · `@axis-ds/agentic-ui` 의 `tailwind.css` 입니다. 이미 있는 줄은 다시 넣지 않으므로 여러 번 실행해도 같습니다. 규칙 뒤에 있는 기존 `@import` 는 CSS 규칙상 무시될 수 있어 맨 앞으로 옮기라고 알립니다(Next.js 15 는 위치와 관계없이 앞으로 끌어올려 적용함을 측정).
-- `package.json` 에 `@axis-ds/tokens` 가 없으면 `dependencies` 에 `^1.6.0`(1.6.0 부터, 이전에는 `^1.3.0`)을 더하고 설치 명령만 안내합니다. 설치는 실행하지 않습니다. 설치 · 업그레이드 안내 명령은 lockfile 로 고릅니다(`npm install` · `yarn add` · `pnpm add`).
+- `package.json` 에 `@axis-ds/tokens` 가 없으면 `dependencies` 에 `^1.6.0`(1.6.0 부터, 이전에는 `^1.3.0`)을 더하고 설치 명령만 안내합니다. 설치는 실행하지 않습니다. 설치 · 업그레이드 안내 명령은 lockfile 로 고릅니다(`npm install` · `yarn add` · `pnpm add`). lockfile 이 없으면 `package.json` 의 `packageManager`(`npm@…` · `yarn@…` · `pnpm@…`)를 보고, 둘 다 없으면 `pnpm` 입니다(1.7.2 부터 `packageManager` 를 봄).
 - 브랜드 CSS 는 `[data-brand="<brand>"]` 선택자로 적용되므로 루트 레이아웃의 `<html data-brand>` 나 `ThemeProvider` 의 `setBrand` 가 있어야 화면이 바뀝니다. 코드는 고치지 않고, 레이아웃에서 찾지 못하면 두 방법의 예시를 냅니다(`defaultBrand` 는 `@axis-ds/theme` 1.6.2 이하에서 `setBrand(undefined)` 로 끈 상태가 새로고침 뒤 유지되지 않아 예시에 쓰지 않습니다). 마크업 `data-brand` 와 `ThemeProvider` 를 함께 쓰는 레이아웃이면 theme 1.7.0 이상이 필요하다고 한 줄 더 알립니다(1.6.1 부터). Tailwind 3 이면 preset · content 가 빠졌을 때 넣을 줄도 안내합니다(설정 파일은 고치지 않음). preset 안내는 1.6.1 부터 CommonJS 에서 모든 tokens 버전에 되는 `require("@axis-ds/tokens/tailwind").default` 입니다(1.6.0 의 `.default` 없는 형태는 tokens 1.6.2 이하에서 preset 이 빠짐).
 - 넣은 import 줄의 출력은 1.6.1 부터 실제 위치 · 분류를 따릅니다. 컴포넌트 `tailwind.css` 는 「컴포넌트 스캔 경로, 위치 무관」, 기본 토큰 CSS 는 브랜드 줄보다 앞에 들어갔을 때만 「브랜드 앞」이고 뒤에 들어가면 옮기라고 경고합니다.
 - `@axis-ds/tokens` 가 없거나 1.3.0 미만이면 목록 대신 설치 · 업그레이드 안내를 내고 종료 코드 1 로 끝납니다.
@@ -107,7 +107,7 @@ axis theme add ontology
 - dependencies 항목(1.6.1 부터): `tailwindcss` 선언이 없으면 FAIL, `clsx` · `tailwind-merge` 선언이 없으면 WARN(종전과 같음). 여기에 선언된 `tailwindcss` · `clsx` · `tailwind-merge` · `@axis-ds/*` 가 `node_modules` 에 없으면 「선언됐지만 설치되지 않은 의존성」 WARN 과 lockfile 에 맞는 설치 명령을 냅니다. 상위 디렉터리의 `node_modules`(모노레포 호이스팅)도 찾고, Plug'n'Play(`.pnp.cjs`)는 설치본을 읽지 않고 선언 기준입니다. 1.6.0 까지는 선언만 보고 「모두 설치되어 있습니다」였습니다.
 - 해당할 때만 더하는 항목(1.6.0 부터, brand 항목 뒤 이 순서):
   - `brand.activation`: `brand` 가 있을 때 루트 레이아웃(`app/layout.tsx` · `src/app/layout.tsx` · `pages/_app` 등, 그 레이아웃이 import 하는 같은 디렉터리의 `./providers` 한 단계 포함)에 `data-brand` · `setBrand(` · `defaultBrand=` 가 없으면 WARN 입니다(휴리스틱, `ThemeProvider` 단독은 켜는 코드가 아님). 1.6.1 부터 마크업 `data-brand` 와 `ThemeProvider` 만 있고 `setBrand(` · `defaultBrand=` 가 없으면 설치본(없으면 선언) `@axis-ds/theme` 가 1.7.0 미만이거나 판정할 수 없을 때 WARN 입니다(1.6.2 이하는 마운트 때 속성을 지움).
-  - `tailwind.content`: Tailwind 3 설정 파일이 있고 `componentsDir` 나 선언된 `@axis-ds/ui-react` · `@axis-ds/agentic-ui` 가 있을 때, `content` 의 문자열 glob 이 그 경로를 덮지 않으면 FAIL 입니다(그 경로의 클래스가 생성되지 않음). `content` 를 정적으로 다 읽지 못하면(변수 · 펼침) WARN 입니다.
+  - `tailwind.content`: Tailwind 3 설정 파일이 있고 `componentsDir` 나 선언된 `@axis-ds/ui-react` · `@axis-ds/agentic-ui` 가 있을 때, `content` 의 문자열 glob 이 그 경로를 덮지 않으면 FAIL 입니다(그 경로의 클래스가 생성되지 않음). `content` 를 정적으로 다 읽지 못하면(변수 · 펼침) WARN 입니다. 패키지 경로는 프로젝트 디렉터리부터 상위로 찾은 설치본 위치 기준이라, npm workspaces · pnpm hoisted 처럼 루트에만 설치된 앱은 `../../node_modules/@axis-ds/ui-react/dist/**/*.{js,mjs}` 를 안내합니다(1.7.1 부터, 설치본이 없거나 Plug'n'Play 면 `./node_modules/...`). `**` 는 `../` 를 넘지 않는 것으로, 절대경로 glob 은 실제 위치와 비교해 판정합니다. 상위 경로는 Tailwind 3 가 빌드를 실행한 디렉터리 기준으로 풀리므로 모노레포 루트에서 빌드하면 `content: { relative: true, files: [...] }` 를 쓰세요(판정은 프로젝트 디렉터리에서 빌드한다고 보고 함).
   - `animation`: `@axis-ds/ui-react` 선언이나 `componentsDir` 의 `animate-in` 류 클래스가 있을 때 애니메이션 플러그인(Tailwind 3 `tailwindcss-animate` 선언 + 설치본 + `plugins` 배열 참조, Tailwind 4 `@import "tw-animate-css"`)이 없으면 WARN 입니다. 1.6.1 부터 Tailwind 3 은 `plugins` 배열 안의 `require("tailwindcss-animate")` 나 그 패키지를 받은 식별자(`import animate from` · `const animate = require(...)`)만 인정합니다(import 만 있거나 다른 곳의 같은 문자열은 아님). 배열을 정적으로 다 읽지 못하면(펼침 · 단축 속성) 「확인하지 못함」 WARN 입니다.
 - FAIL 이 하나라도 있으면 종료 코드 1 로 끝납니다. WARN 만 있으면 0 입니다(1.3.0 부터, 이전에는 결과와 관계없이 0).
 - MCP `axis.check_project` 도 같은 항목 · 문구를 냅니다.
@@ -128,6 +128,7 @@ stdin 이 터미널이 아니면 질문을 띄우지 않습니다(1.7.0 부터).
 
 - `axis template init -y` 는 질문을 기본값으로 답하고, 비어 있지 않은 디렉터리도 진행합니다(`template apply -y` 와 같은 뜻). 터미널에서도 같습니다.
 - 판정은 stdin 이 터미널인지 하나로 합니다. 그래서 `printf '\n' | axis template init dashboard` 처럼 파이프로 응답을 넣던 스크립트도 이제는 묻지 않고 위 표대로 동작합니다. 값은 `--dir` · `-y` 같은 옵션으로 주세요.
+- `axis template apply` 의 「필요한 의존성」 명령과 `axis template init` 의 다음 단계(`install` · `dev`)는 대상 디렉터리의 lockfile(없으면 `packageManager`)로 매니저를 고르고 범위를 따옴표로 감쌉니다(1.7.2 부터, 1.7.1 까지는 `pnpm` 고정).
 - Windows Git Bash(mintty)처럼 사람이 앞에 있어도 stdin 이 터미널로 잡히지 않는 환경에서는 질문 없이 위 표대로 동작할 수 있습니다(실측 전). 질문이 뜨지 않으면 `winpty npx axis ...` 로 실행하거나, PowerShell · Windows Terminal 에서 실행하거나, `--dir` · `-y` 같은 옵션으로 값을 주세요.
 
 ## 문서

package/dist/chunk-YYSEFWYD.js

@@ -0,0 +1,473 @@
+import {
+  ask,
+  failNonInteractive,
+  isInteractive
+} from "./chunk-HFMMK6R4.js";
+
+// src/monet.ts
+import chalk from "chalk";
+import fs from "fs-extra";
+import path2 from "path";
+
+// ../axis-registry-core/src/project.ts
+import { existsSync, readFileSync, realpathSync, statSync } from "fs";
+import path from "path";
+function resolveBaseDir(baseDirInput) {
+  const resolved = path.resolve(baseDirInput);
+  try {
+    return realpathSync(resolved);
+  } catch {
+    return resolved;
+  }
+}
+var LOCKFILE_COMMANDS = [
+  ["pnpm-lock.yaml", "pnpm install"],
+  ["yarn.lock", "yarn install"],
+  ["package-lock.json", "npm install"]
+];
+function lockfileCommandAt(dir) {
+  return LOCKFILE_COMMANDS.find(([file]) => existsSync(path.join(dir, file)))?.[1];
+}
+function isWorkspaceRootDir(dir) {
+  if (isFile(path.join(dir, "pnpm-workspace.yaml"))) return true;
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(path.join(dir, "package.json"), "utf8"));
+  } catch {
+    return false;
+  }
+  if (!isPlainObject(parsed)) return false;
+  const ws = parsed.workspaces;
+  return Array.isArray(ws) || isPlainObject(ws) && Array.isArray(ws.packages);
+}
+function findWorkspaceRoot(baseDirInput) {
+  let dir = resolveBaseDir(baseDirInput);
+  for (; ; ) {
+    if (isWorkspaceRootDir(dir)) return dir;
+    if (existsSync(path.join(dir, ".git"))) return void 0;
+    const parent = path.dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+var PACKAGE_MANAGER_COMMANDS = {
+  pnpm: "pnpm install",
+  yarn: "yarn install",
+  npm: "npm install"
+};
+function packageManagerCommandAt(dir) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(path.join(dir, "package.json"), "utf8"));
+  } catch {
+    return void 0;
+  }
+  if (!isPlainObject(parsed) || typeof parsed.packageManager !== "string") return void 0;
+  const name = /^(pnpm|yarn|npm)@/.exec(parsed.packageManager.trim())?.[1];
+  return name !== void 0 ? PACKAGE_MANAGER_COMMANDS[name] : void 0;
+}
+function detectInstallCommand(baseDirInput) {
+  const baseDir = resolveBaseDir(baseDirInput);
+  const own = lockfileCommandAt(baseDir);
+  if (own !== void 0) return own;
+  const found = findWorkspaceRoot(baseDir);
+  const root = found !== void 0 && found !== baseDir ? found : void 0;
+  if (root !== void 0) {
+    const fromRoot = lockfileCommandAt(root);
+    if (fromRoot !== void 0) return fromRoot;
+  }
+  const ownManager = packageManagerCommandAt(baseDir);
+  if (ownManager !== void 0) return ownManager;
+  if (root !== void 0) {
+    const rootManager = packageManagerCommandAt(root);
+    if (rootManager !== void 0) return rootManager;
+  }
+  return "pnpm install";
+}
+function packageManagerOf(command) {
+  if (command.startsWith("yarn")) return "yarn";
+  if (command.startsWith("npm")) return "npm";
+  return "pnpm";
+}
+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 workspaceRootPackage(baseDirInput) {
+  const baseDir = resolveBaseDir(baseDirInput);
+  const root = findWorkspaceRoot(baseDir);
+  if (root === void 0 || root === baseDir) return void 0;
+  try {
+    const parsed = JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
+    return isPlainObject(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function declaredDependency(baseDir, pkg, name, rootPkg) {
+  if (pkg === void 0) return void 0;
+  const own = hasDependency(pkg, name);
+  if (own !== void 0) return { range: own, source: "app" };
+  const root = rootPkg === void 0 ? workspaceRootPackage(baseDir) : rootPkg ?? void 0;
+  const fromRoot = root !== void 0 ? hasDependency(root, name) : void 0;
+  return fromRoot !== void 0 ? { range: fromRoot, source: "root" } : void 0;
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function addCommandPrefix(installCommand, options = {}) {
+  const dev = options.dev ? " -D" : "";
+  switch (packageManagerOf(installCommand)) {
+    case "yarn":
+      return `yarn add${dev}`;
+    case "npm":
+      return `npm install${dev}`;
+    default:
+      return `pnpm add${dev}`;
+  }
+}
+function addCommandFor(installCommand, deps, options = {}) {
+  const specs = Object.entries(deps).map(([name, range]) => `"${name}@${range}"`).join(" ");
+  return `${addCommandPrefix(installCommand, options)} ${specs}`;
+}
+function runScriptCommand(installCommand, script) {
+  switch (packageManagerOf(installCommand)) {
+    case "yarn":
+      return `yarn ${script}`;
+    case "npm":
+      return `npm run ${script}`;
+    default:
+      return `pnpm ${script}`;
+  }
+}
+function workspaceRunCommand(installCommand, pkg, script) {
+  switch (packageManagerOf(installCommand)) {
+    case "yarn":
+      return `yarn workspace ${pkg} ${script}`;
+    case "npm":
+      return `npm run ${script} -w ${pkg}`;
+    default:
+      return `pnpm --filter ${pkg} ${script}`;
+  }
+}
+var GLOBAL_CSS_CANDIDATES = [
+  "app/globals.css",
+  "src/app/globals.css",
+  "styles/globals.css",
+  "src/styles/globals.css",
+  "globals.css"
+];
+var TAILWIND_CONFIG_CANDIDATES = [
+  "tailwind.config.ts",
+  "tailwind.config.js",
+  "tailwind.config.mjs",
+  "tailwind.config.cjs"
+];
+function isFile(file) {
+  try {
+    return statSync(file).isFile();
+  } catch {
+    return false;
+  }
+}
+function isDirectory(dir) {
+  try {
+    return statSync(dir).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function findFirstFile(baseDir, candidates) {
+  return candidates.find((c) => isFile(path.join(baseDir, c)));
+}
+function detectProjectPaths(baseDirInput) {
+  const baseDir = path.resolve(baseDirInput);
+  const hasSrc = isDirectory(path.join(baseDir, "src"));
+  const css = findFirstFile(baseDir, GLOBAL_CSS_CANDIDATES);
+  const tw = findFirstFile(baseDir, TAILWIND_CONFIG_CANDIDATES);
+  return {
+    componentsDir: hasSrc ? "./src/components/ui" : "./components/ui",
+    globalCss: css !== void 0 ? `./${css}` : hasSrc ? "./src/app/globals.css" : "./app/globals.css",
+    globalCssSource: css !== void 0 ? "found" : "default",
+    tailwindConfig: tw !== void 0 ? `./${tw}` : "./tailwind.config.ts",
+    tailwindConfigSource: tw !== void 0 ? "found" : "default"
+  };
+}
+function projectFileExists(baseDir, relPath) {
+  return isFile(path.resolve(baseDir, relPath));
+}
+var ROOT_LAYOUT_FILES = [
+  "app/layout.tsx",
+  "app/layout.jsx",
+  "app/layout.js",
+  "src/app/layout.tsx",
+  "src/app/layout.jsx",
+  "src/app/layout.js",
+  "pages/_app.tsx",
+  "pages/_app.jsx",
+  "pages/_document.tsx",
+  "pages/_document.jsx",
+  "src/pages/_app.tsx",
+  "src/pages/_app.jsx",
+  "src/pages/_document.tsx",
+  "src/pages/_document.jsx"
+];
+function exactVersionOf(version) {
+  if (typeof version !== "string") return void 0;
+  const v = version.trim();
+  if (!/^v?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(v) || /^v?0\.0\.0-/.test(v)) return void 0;
+  return v;
+}
+function findInstalledPackage(baseDirInput, name) {
+  let dir = resolveBaseDir(baseDirInput);
+  for (; ; ) {
+    const pkgDir = path.join(dir, "node_modules", ...name.split("/"));
+    const file = path.join(pkgDir, "package.json");
+    if (isFile(file)) {
+      let version;
+      try {
+        const parsed = JSON.parse(readFileSync(file, "utf8"));
+        version = isPlainObject(parsed) ? exactVersionOf(parsed.version) : void 0;
+      } catch {
+        version = void 0;
+      }
+      return { dir: pkgDir, version };
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+function isPnpProject(baseDirInput) {
+  let dir = resolveBaseDir(baseDirInput);
+  for (; ; ) {
+    if (isFile(path.join(dir, ".pnp.cjs")) || isFile(path.join(dir, ".pnp.js"))) return true;
+    const parent = path.dirname(dir);
+    if (parent === dir) return false;
+    dir = parent;
+  }
+}
+function compareExactVersions(a, b) {
+  const parse = (v) => {
+    const m = /^v?(\d+)\.(\d+)\.(\d+)(-[0-9A-Za-z.-]+)?/.exec(v.trim());
+    return m ? { core: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] !== void 0 } : void 0;
+  };
+  const x = parse(a);
+  const y = parse(b);
+  if (!x || !y) return void 0;
+  for (let i = 0; i < 3; i++) if (x.core[i] !== y.core[i]) return x.core[i] - y.core[i];
+  return Number(y.pre) - Number(x.pre);
+}
+
+// src/monet.ts
+var MONET_CATEGORIES = [
+  { id: "hero", name: "Hero Sections", count: 120 },
+  { id: "feature", name: "Feature Sections", count: 191 },
+  { id: "testimonial", name: "Testimonials", count: 47 },
+  { id: "pricing", name: "Pricing Tables", count: 35 },
+  { id: "cta", name: "Call to Action", count: 42 },
+  { id: "stats", name: "Statistics", count: 28 },
+  { id: "footer", name: "Footers", count: 38 },
+  { id: "header", name: "Headers/Navigation", count: 45 },
+  { id: "logo-cloud", name: "Logo Clouds", count: 22 },
+  { id: "team", name: "Team Sections", count: 31 },
+  { id: "faq", name: "FAQ Sections", count: 24 },
+  { id: "contact", name: "Contact Forms", count: 29 },
+  { id: "newsletter", name: "Newsletter", count: 18 },
+  { id: "landing", name: "Full Landing Pages", count: 28 }
+];
+var MonetClient = class {
+  apiKey;
+  baseUrl = "https://www.monet.design";
+  constructor(apiKey) {
+    this.apiKey = apiKey || process.env.MONET_API_KEY;
+  }
+  // 카테고리 목록 출력
+  async listCategories() {
+    console.log(chalk.blue("\n\u{1F3A8} Monet Design \uCE74\uD14C\uACE0\uB9AC\n"));
+    console.log(chalk.gray("https://monet.design - 1000+ React UI \uCEF4\uD3EC\uB10C\uD2B8\n"));
+    for (const cat of MONET_CATEGORIES) {
+      console.log(
+        `  ${chalk.cyan(cat.id.padEnd(15))} ${cat.name.padEnd(25)} ${chalk.gray(`(${cat.count}\uAC1C)`)}`
+      );
+    }
+    console.log(chalk.gray("\n\uC0AC\uC6A9\uBC95:"));
+    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) {
+    console.log(chalk.blue(`
+\u{1F50D} "${query}" \uAC80\uC0C9 \uC911...
+`));
+    const searchUrl = `${this.baseUrl}/c?q=${encodeURIComponent(query)}`;
+    console.log(chalk.yellow("Monet\uC740 \uC9C1\uC811 API\uB97C \uC81C\uACF5\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk.gray("\uB2E4\uC74C \uBC29\uBC95\uC73C\uB85C \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uAC00\uC838\uC62C \uC218 \uC788\uC2B5\uB2C8\uB2E4:\n"));
+    console.log(chalk.bold("1. \uC6F9\uC5D0\uC11C \uAC80\uC0C9:"));
+    console.log(chalk.cyan(`   ${searchUrl}
+`));
+    console.log(chalk.bold("2. MCP \uC5F0\uB3D9 (Claude Code):"));
+    console.log(chalk.gray("   .claude/mcp.json\uC5D0 monet \uC11C\uBC84 \uD65C\uC131\uD654 \uD6C4"));
+    console.log(chalk.cyan('   "monet\uC5D0\uC11C hero \uCEF4\uD3EC\uB10C\uD2B8 \uCC3E\uC544\uC918"'));
+    console.log(chalk.gray("   \u2192 API \uD0A4 \uD544\uC694: https://monet.design/mcp\n"));
+    console.log(chalk.bold("3. \uC218\uB3D9 \uBCF5\uC0AC-\uBD99\uC5EC\uB123\uAE30:"));
+    console.log(chalk.gray("   \uC6F9\uC5D0\uC11C \uCEF4\uD3EC\uB10C\uD2B8 \uC120\uD0DD \u2192 Copy Code \u2192 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uBD99\uC5EC\uB123\uAE30\n"));
+  }
+  // 카테고리별 컴포넌트 브라우징
+  async browseCategory(category) {
+    const cat = MONET_CATEGORIES.find((c) => c.id === category);
+    if (!cat) {
+      console.log(chalk.red(`
+\u274C '${category}' \uCE74\uD14C\uACE0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.
+`));
+      console.log(chalk.gray("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uCE74\uD14C\uACE0\uB9AC:"));
+      MONET_CATEGORIES.forEach((c) => console.log(chalk.cyan(`  ${c.id}`)));
+      return;
+    }
+    console.log(chalk.blue(`
+\u{1F4C2} ${cat.name} (${cat.count}\uAC1C \uCEF4\uD3EC\uB10C\uD2B8)
+`));
+    const browseUrl = `${this.baseUrl}/c?category=${category}`;
+    console.log(chalk.gray("\uC6F9\uC5D0\uC11C \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uD655\uC778\uD558\uC138\uC694:"));
+    console.log(chalk.cyan(`${browseUrl}
+`));
+    console.log(chalk.bold("\uC778\uAE30 \uCEF4\uD3EC\uB10C\uD2B8 \uC608\uC2DC:"));
+    const examples = this.getCategoryExamples(category);
+    examples.forEach((ex) => {
+      console.log(`  ${chalk.cyan(ex.id.padEnd(30))} ${chalk.gray(ex.desc)}`);
+    });
+    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. npx @axis-ds/cli monet import \uC2E4\uD589\n"));
+  }
+  // 카테고리별 예시 컴포넌트
+  getCategoryExamples(category) {
+    const examples = {
+      hero: [
+        { id: "hero-with-image", desc: "\uC774\uBBF8\uC9C0 \uBC30\uACBD \uD788\uC5B4\uB85C" },
+        { id: "hero-centered", desc: "\uC911\uC559 \uC815\uB82C \uD788\uC5B4\uB85C" },
+        { id: "hero-split", desc: "\uBD84\uD560 \uB808\uC774\uC544\uC6C3 \uD788\uC5B4\uB85C" }
+      ],
+      feature: [
+        { id: "feature-grid", desc: "\uADF8\uB9AC\uB4DC \uD615\uC2DD \uAE30\uB2A5 \uC18C\uAC1C" },
+        { id: "feature-alternating", desc: "\uAD50\uCC28 \uB808\uC774\uC544\uC6C3 \uAE30\uB2A5" },
+        { id: "feature-icons", desc: "\uC544\uC774\uCF58 \uAE30\uBC18 \uAE30\uB2A5" }
+      ],
+      pricing: [
+        { id: "pricing-three-tiers", desc: "3\uB2E8 \uC694\uAE08\uC81C" },
+        { id: "pricing-comparison", desc: "\uBE44\uAD50 \uD14C\uC774\uBE14 \uC694\uAE08\uC81C" },
+        { id: "pricing-toggle", desc: "\uC6D4/\uC5F0 \uD1A0\uAE00 \uC694\uAE08\uC81C" }
+      ],
+      landing: [
+        { id: "deepcon-ai-landing", desc: "AI SaaS \uB79C\uB529\uD398\uC774\uC9C0" },
+        { id: "saas-landing", desc: "SaaS \uC2A4\uD0C0\uD130 \uB79C\uB529" },
+        { id: "agency-landing", desc: "\uC5D0\uC774\uC804\uC2DC \uB79C\uB529\uD398\uC774\uC9C0" }
+      ]
+    };
+    return examples[category] || [{ id: `${category}-basic`, desc: "\uAE30\uBCF8 \uD15C\uD50C\uB9BF" }];
+  }
+  // 클립보드에서 Monet 코드 가져오기
+  /** opts.interactive: 질문을 띄울 수 있는지(WI-0075). 없으면 stdin 이 TTY 인지로 정합니다 */
+  async importFromClipboard(opts = {}) {
+    console.log(chalk.blue("\n\u{1F4CB} \uD074\uB9BD\uBCF4\uB4DC\uC5D0\uC11C Monet \uCEF4\uD3EC\uB10C\uD2B8 \uAC00\uC838\uC624\uAE30\n"));
+    console.log(chalk.yellow("\uC900\uBE44 \uB2E8\uACC4:"));
+    console.log(chalk.gray("  1. monet.design\uC5D0\uC11C \uCEF4\uD3EC\uB10C\uD2B8 \uC120\uD0DD"));
+    console.log(chalk.gray("  2. 'Copy Code' \uBC84\uD2BC\uC73C\uB85C \uCF54\uB4DC \uBCF5\uC0AC"));
+    console.log(chalk.gray("  3. \uC774 \uBA85\uB839\uC5B4 \uC2E4\uD589\n"));
+    const interactive = opts.interactive ?? isInteractive();
+    if (!interactive) {
+      failNonInteractive("\uCEF4\uD3EC\uB10C\uD2B8 \uC774\uB984\uACFC \uBD99\uC5EC \uB123\uC744 \uCF54\uB4DC\uB97C \uBB3C\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC544\uBB34\uAC83\uB3C4 \uC4F0\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.", [
+        "\uB300\uD654\uD615 \uD130\uBBF8\uB110\uC5D0\uC11C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694: axis monet import"
+      ]);
+      return;
+    }
+    const { componentName } = await ask(
+      {
+        type: "text",
+        name: "componentName",
+        message: "\uCEF4\uD3EC\uB10C\uD2B8 \uC774\uB984 (\uC608: hero-section):",
+        validate: (v) => v.length > 0 ? true : "\uC774\uB984\uC744 \uC785\uB825\uD558\uC138\uC694"
+      },
+      interactive
+    );
+    if (!componentName) return;
+    const { componentCode } = await ask(
+      {
+        type: "text",
+        name: "componentCode",
+        message: "\uBCF5\uC0AC\uD55C \uCF54\uB4DC\uB97C \uBD99\uC5EC\uB123\uC73C\uC138\uC694 (\uD55C \uC904\uB85C):"
+      },
+      interactive
+    );
+    if (!componentCode) {
+      console.log(chalk.yellow("\n\uCF54\uB4DC\uAC00 \uC785\uB825\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4."));
+      return;
+    }
+    const configPath = path2.resolve("axis.config.json");
+    let componentsDir = "./src/components/monet";
+    if (await fs.pathExists(configPath)) {
+      const config = await fs.readJSON(configPath);
+      componentsDir = config.monetDir || path2.join(path2.dirname(config.componentsDir), "monet");
+    }
+    const fileName = `${componentName}.tsx`;
+    const filePath = path2.join(componentsDir, fileName);
+    await fs.ensureDir(componentsDir);
+    await fs.writeFile(filePath, componentCode);
+    console.log(chalk.green(`
+\u2713 ${filePath} \uC800\uC7A5 \uC644\uB8CC`));
+    console.log(chalk.gray("\n\uB2E4\uC74C \uB2E8\uACC4:"));
+    for (const line of monetImportNextSteps(process.cwd())) console.log(chalk.gray(`  ${line}`));
+    console.log("");
+  }
+};
+function monetImportNextSteps(baseDir) {
+  return [
+    "1. \uD30C\uC77C\uC744 \uC5F4\uC5B4 import \uACBD\uB85C \uC218\uC815",
+    `2. \uD544\uC694\uD55C \uC758\uC874\uC131 \uC124\uCE58 (${addCommandPrefix(detectInstallCommand(baseDir))} ...)`,
+    "3. \uCEF4\uD3EC\uB10C\uD2B8 \uC0AC\uC6A9"
+  ];
+}
+function getMonetUrl(path3) {
+  return `https://monet.design${path3}`;
+}
+function getMonetMcpConfig() {
+  return {
+    monet: {
+      url: "https://www.monet.design/api/remote/mcp",
+      headers: {
+        Authorization: "Bearer ${MONET_API_KEY}"
+      }
+    }
+  };
+}
+
+export {
+  resolveBaseDir,
+  detectInstallCommand,
+  hasDependency,
+  workspaceRootPackage,
+  declaredDependency,
+  isPlainObject,
+  addCommandPrefix,
+  addCommandFor,
+  runScriptCommand,
+  workspaceRunCommand,
+  GLOBAL_CSS_CANDIDATES,
+  detectProjectPaths,
+  projectFileExists,
+  ROOT_LAYOUT_FILES,
+  findInstalledPackage,
+  isPnpProject,
+  compareExactVersions,
+  MONET_CATEGORIES,
+  MonetClient,
+  monetImportNextSteps,
+  getMonetUrl,
+  getMonetMcpConfig
+};