sh-ui-cli 0.66.0 → 0.67.1

package/bin/sh-ui.mjs

@@ -3,6 +3,7 @@ import { init } from "../src/init.mjs";
 import { add } from "../src/add.mjs";
 import { list } from "../src/list.mjs";
 import { remove } from "../src/remove.mjs";
+import { findShUiContext } from "../src/resolve-context.mjs";
 
 const [, , cmd, ...rest] = process.argv;
 
@@ -29,6 +30,8 @@ const usage = `사용법:
     --force                        (add) 기존 파일을 모두 덮어쓰기 (prompt 없음)
                                    (remove) 사용자가 수정한 파일도 삭제
     --keep                         (add) 기존 파일을 모두 유지 (prompt 없음)
+    --app <name>                   (add) monorepo 라우팅 시 대상 ui-{name} 명시
+                                   (apps/<name>/ 안에서 실행하면 자동 추론)
     --all                          (list) 설치되지 않은 컴포넌트까지 표시
     --dry-run                      (remove, rename-app) 변경 대상만 출력하고 실행 안 함
     --yes                          (rename-app) 대화형 확인 생략
@@ -54,13 +57,41 @@ try {
         process.exit(1);
       }
       const onConflict = force ? "overwrite" : keepFlag ? "keep" : "prompt";
-      const names = rest.filter((a) => !a.startsWith("--"));
+      // --app 은 모노레포 라우팅 시 ui-{app} 명시 (tokens 또는 v0.64.x fallback).
+      const appIdx = rest.indexOf("--app");
+      const app = appIdx !== -1 ? rest[appIdx + 1] : null;
+      const names = rest.filter((a, i) => !a.startsWith("--") && rest[i - 1] !== "--app");
       if (names.length === 0) {
         console.error("에러: 추가할 컴포넌트 이름이 필요합니다.\n");
         console.error(usage);
         process.exit(1);
       }
-      await add({ cwd: process.cwd(), names, skipInstall, diffMode, onConflict });
+
+      // v0.67+: cwd 부터 walk-up 으로 sh-ui.config.json (standalone/ui-core/ui-app)
+      // 또는 pnpm-workspace.yaml (monorepo 루트) 발견. monorepo 면 자동 라우팅 (tokens →
+      // ui-app, 그 외 → ui-core), apps/<name>/ 안에서 실행하면 그 앱이 hintApp.
+      const ctx = findShUiContext(process.cwd());
+      if (!ctx) {
+        console.error(
+          "✗ sh-ui.config.json 또는 pnpm-workspace.yaml 을 cwd 부터 부모 트리에서 찾지 못했습니다.\n" +
+            "  먼저 `sh-ui init` 또는 `sh-ui create` 로 프로젝트를 초기화하세요.",
+        );
+        process.exit(1);
+      }
+      if (ctx.kind === "config") {
+        await add({ cwd: ctx.root, names, skipInstall, diffMode, onConflict });
+      } else {
+        const { addComponent } = await import("../src/create/generator.js");
+        await addComponent({
+          cwd: ctx.root,
+          names,
+          app,
+          hintApp: ctx.hintApp,
+          skipInstall,
+          diffMode,
+          onConflict,
+        });
+      }
       break;
     }
     case "list": {

package/data/changelog/versions.json

@@ -2,6 +2,33 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.67.1",
+      "date": "2026-05-09",
+      "title": "patch — sh-ui add tokens 가 rose/emerald/violet preset 에서 throw 하던 회귀 수정",
+      "type": "patch",
+      "highlights": [
+        "**`sh-ui add tokens` 가 rose/emerald/violet preset 에서 `해석 실패: {color.rose.50}` 로 throw 하던 회귀 수정** — CLI 의 풍부한 preset (rose/emerald/violet) 은 packages/tokens 의 primitives.json 에 색 스케일이 없어 `buildTokens` 가 해석 불가. injectCssTheme 이 create 시점에 resolved hex 를 박아둔 tokens.css 를 단일 진실로 두고, 재실행 시 'custom' 과 동일하게 보존하도록 가드 확장.",
+        "**tokens.css 미존재 + non-buildable preset → 친절한 에러** — `sh-ui init --theme rose` 후 `sh-ui add tokens` 같은 흐름은 preset 사용법 안내와 함께 종료 (해결책: `sh-ui create --theme rose` 또는 theme.base 를 neutral/slate/zinc 로 변경).",
+        "**buildable bases (neutral/slate/zinc) 는 정상 빌드** — 회귀 가드 6개 (`add-tokens-presets.test.js`) — 보존 / 친절한 에러 / 정상 빌드 모두 검증."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.67.1"
+    },
+    {
+      "version": "0.67.0",
+      "date": "2026-05-09",
+      "title": "monorepo 어디서든 sh-ui add — walk-up 컨텍스트 라우팅",
+      "type": "minor",
+      "highlights": [
+        "**`sh-ui add` 가 monorepo 전 디렉토리에서 동작** — `apps/web/`, monorepo 루트, `packages/ui/ui-core/`, `packages/ui/ui-apps/ui-{name}/` 어디서든. cwd 부터 부모 트리 walk-up 으로 `sh-ui.config.json` (standalone) 또는 `pnpm-workspace.yaml` (monorepo 루트) 자동 발견.",
+        "**hintApp 자동 추출** — `apps/web/`에서 `sh-ui add tokens` 실행 시 자동으로 ui-web 으로 라우팅 (별도 `--app` 불필요). `apps/admin/` 에선 ui-admin. monorepo 루트면 prompt (TTY) 또는 모든 앱 (비대화형 + tokens).",
+        "**npx subprocess 제거** — orchestrator 가 inner `npx sh-ui add` 대신 `add()` 함수를 in-process 호출. sh-ui-cli 가 모노레포에 local 설치 안 돼도 동작.",
+        "**다중 컴포넌트 + tokens 혼합** — `sh-ui add button card tokens` 한 줄로 ui-core 와 ui-app 양쪽에 라우팅 (이름별 그룹화).",
+        "**`--app <name>` 플래그 신규 (sh-ui add)** — hintApp 자동 추론을 명시적으로 덮어쓸 때.",
+        "**호환** — `sh-ui create add-component <name>` 는 alias 로 유지. v0.65/v0.66 의 ui-core SoT 라우팅 그대로."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.67.0"
+    },
     {
       "version": "0.66.0",
       "date": "2026-05-09",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh-ui-cli",
-  "version": "0.66.0",
+  "version": "0.67.1",
   "description": "sh-ui CLI — 프로젝트 스캐폴드(create) + 컴포넌트 추가(add/list/remove) + IDE-내 AI용 MCP 서버",
   "license": "MIT",
   "repository": {

package/src/add.mjs

@@ -6,6 +6,7 @@ import { spawn } from "node:child_process";
 import { select } from "@inquirer/prompts";
 import { formatUnifiedDiff } from "./diff.mjs";
 import { getRegistryRoot, getTokensRoot, getPeerVersionsPath } from "./paths.mjs";
+import { THEME_BASES } from "./constants.js";
 
 /**
  * 기존 파일과 registry 파일 내용이 다를 때 keep/overwrite 결정.
@@ -185,6 +186,29 @@ async function addTokens(config, cwd, diffMode, summary, conflictResolver) {
     return;
   }
 
+  // CLI 가 THEME_PRESETS 에서 알지만 primitives.json 의 THEME_BASES 에 없는 풍부한 preset
+  // (rose/emerald/violet 등) 도 buildTokens 가 `{color.rose.50}` 등을 해석할 수 없어 throw.
+  // create 시점에 injectCssTheme 이 resolved hex 를 박아둔 tokens.css 가 단일 진실 —
+  // sh-ui add tokens 는 보존만. base 가 buildable 하지 않으면 같은 정책 적용.
+  const base = config.theme?.base;
+  if (base && !THEME_BASES.includes(base)) {
+    if (!existsSync(dest)) {
+      throw new Error(
+        `'${base}' preset 의 tokens.css 가 아직 없습니다. 이 preset 은 ` +
+        `sh-ui add tokens 로 빌드 불가 (primitives 미정의 — buildable: ${THEME_BASES.join('/')}). ` +
+        `해결: sh-ui create --theme ${base} 로 새 프로젝트 스캐폴드, 또는 ` +
+        `sh-ui.config.json 의 theme.base 를 ${THEME_BASES.join('/')} 중 하나로 변경 후 재실행.`,
+      );
+    }
+    if (!diffMode) {
+      console.log(
+        `↷ tokens → ${relative(cwd, dest)} ('${base}' preset — tokens.css 보존, ` +
+        `색 조정은 파일 직접 편집 또는 sh-ui create --theme <new> 로 재스캐폴드)`
+      );
+    }
+    return;
+  }
+
   const { buildTokens } = await loadTokensBuilder();
   const content = await buildTokens(config);
 

package/src/create/generator.js

@@ -423,108 +423,163 @@ export async function addApp(options = {}) {
 
 // ─── Add component to ui packages ───
 
-export async function addComponent(componentName, appName) {
-  const cwd = process.cwd();
-  const isMonorepo = await fs.pathExists(path.join(cwd, 'pnpm-workspace.yaml'));
+/**
+ * 컴포넌트/토큰 추가 오케스트레이터 — monorepo 의 어느 디렉토리에서든 의도대로 라우팅.
+ *
+ * **v0.67+ 시그니처**: 옵션 객체 받음. `bin/sh-ui.mjs` 가 walk-up 으로 monorepo 루트를 찾아
+ * 호출하고, `add()` 를 in-process 로 호출 (npx subprocess 없음 — 외부 sh-ui-cli 설치 의존 X).
+ *
+ * 라우팅 (monorepo, v0.65+):
+ *   - `tokens` → `packages/ui/ui-apps/ui-{hintApp 또는 app 또는 prompt 또는 단일}`
+ *   - 그 외(컴포넌트/훅/lib) → `packages/ui/ui-core` 단일 SoT
+ *
+ * v0.64.x 호환: ui-core/sh-ui.config.json 부재 시 모든 add 는 ui-apps/ui-{app} 으로 폴백.
+ *
+ * @param {Object} options
+ * @param {string} [options.cwd]                  monorepo 루트. 기본 process.cwd()
+ * @param {string[]} options.names                추가할 이름들 (예: ['button', 'tokens'])
+ * @param {string|null} [options.app]             명시적 --app 플래그 (있으면 hintApp 무시)
+ * @param {string|null} [options.hintApp]         walk-up 결과의 힌트 (apps/web → 'web')
+ * @param {boolean} [options.skipInstall]
+ * @param {boolean} [options.diffMode]
+ * @param {string} [options.onConflict]           'prompt' | 'keep' | 'overwrite'
+ */
+export async function addComponent(options = {}) {
+  const { add } = await import('../add.mjs');
 
-  if (!isMonorepo) {
-    // Standalone: 현재 디렉토리에서 바로 실행
-    if (!componentName) {
-      componentName = await input({ message: '컴포넌트 이름:' });
+  const cwd = options.cwd ? path.resolve(options.cwd) : process.cwd();
+  const names = (options.names ?? []).filter(Boolean);
+  const app = options.app ?? null;
+  const hintApp = options.hintApp ?? null;
+  const skipInstall = options.skipInstall === true;
+  const diffMode = options.diffMode === true;
+  const onConflict = options.onConflict ?? 'prompt';
+
+  if (names.length === 0) {
+    if (!process.stdin.isTTY) {
+      throw new Error('비대화형 환경(TTY 없음)에서는 추가할 이름이 필요합니다.');
     }
-    console.log(`\n📦 sh-ui 컴포넌트 추가: ${componentName}`);
-    execSync(`npx sh-ui add ${componentName}`, { cwd, stdio: 'inherit' });
-    console.log(`\n✅ ${componentName} 추가 완료!`);
+    const single = await input({ message: '컴포넌트 이름:' });
+    names.push(single);
+  }
+
+  const isMonorepo = await fs.pathExists(path.join(cwd, 'pnpm-workspace.yaml'));
+  if (!isMonorepo) {
+    // Standalone: cwd 자체가 sh-ui.config.json 보유 — 그대로 add 호출.
+    await add({ cwd, names, skipInstall, diffMode, onConflict });
     return;
   }
 
-  // Monorepo (v0.65+): tokens 는 packages/ui/ui-apps/ui-{app} 으로, 그 외 컴포넌트/훅은
-  // packages/ui/ui-core 단일 SoT 로 라우팅. 컴포넌트 중복 emit 제거가 v0.65 의 핵심.
-  // v0.64.x 호환: ui-core/sh-ui.config.json 미존재 시 (구 모노레포 레이아웃) 기존 ui-apps
-  //   직접 라우팅 분기로 내려감.
   const uiCoreDir = path.join(cwd, 'packages', 'ui', 'ui-core');
   const uiAppsDir = path.join(cwd, 'packages', 'ui', 'ui-apps');
   const hasUiCore = await fs.pathExists(path.join(uiCoreDir, 'sh-ui.config.json'));
   const hasUiApps = await fs.pathExists(uiAppsDir);
 
   if (!hasUiCore && !hasUiApps) {
-    console.log('❌ packages/ui/ui-core 또는 packages/ui/ui-apps/ 디렉토리가 없습니다.');
-    return;
+    throw new Error('packages/ui/ui-core 또는 packages/ui/ui-apps/ 디렉토리가 없습니다.');
   }
 
-  if (!componentName) {
-    componentName = await input({ message: '컴포넌트 이름:' });
-  }
+  // 이름을 라우팅 그룹별로 분리: tokens → ui-app, 그 외 → ui-core.
+  const tokenNames = names.filter((n) => n === 'tokens');
+  const componentNames = names.filter((n) => n !== 'tokens');
 
-  const isTokens = componentName === 'tokens';
+  // ─── 비-tokens → ui-core (또는 v0.64.x fallback 시 ui-apps) ───
+  if (componentNames.length > 0) {
+    if (hasUiCore) {
+      if (app) {
+        console.log(
+          `ℹ️  v0.65+ 에서 컴포넌트는 packages/ui/ui-core 에 단일 emit (--app ${app} 무시).`,
+        );
+      }
+      console.log(`\n📦 packages/ui/ui-core ← ${componentNames.join(', ')}`);
+      await add({ cwd: uiCoreDir, names: componentNames, skipInstall, diffMode, onConflict });
+    } else {
+      // v0.64.x 호환: ui-core 없으니 모든 ui-app 에 컴포넌트 직접 emit (구 동작).
+      const targets = await pickUiAppTargets({ uiAppsDir, app, hintApp, kind: 'component' });
+      for (const pkg of targets) {
+        const pkgDir = path.join(uiAppsDir, pkg);
+        console.log(`\n📦 packages/ui/ui-apps/${pkg} ← ${componentNames.join(', ')}`);
+        await add({ cwd: pkgDir, names: componentNames, skipInstall, diffMode, onConflict });
+      }
+    }
+  }
 
-  // ─── 비-tokens (컴포넌트/훅/lib) → ui-core 단일 라우팅 ───
-  if (!isTokens && hasUiCore) {
-    if (appName) {
-      console.log(
-        `ℹ️  v0.65+ 에서 컴포넌트는 packages/ui/ui-core 에 단일 emit 됩니다 (--app ${appName} 무시).`,
-      );
+  // ─── tokens → ui-app(s) ───
+  if (tokenNames.length > 0) {
+    if (!hasUiApps) {
+      throw new Error('tokens 추가에는 packages/ui/ui-apps/ 가 필요합니다.');
     }
-    console.log(`\n📦 packages/ui/ui-core 에 ${componentName} 추가 중...`);
-    try {
-      execSync(`npx sh-ui add ${componentName}`, { cwd: uiCoreDir, stdio: 'inherit' });
-      console.log(`✅ packages/ui/ui-core 완료`);
-    } catch (error) {
-      console.log(`❌ packages/ui/ui-core 실패: ${error.message}`);
+    const targets = await pickUiAppTargets({ uiAppsDir, app, hintApp, kind: 'tokens' });
+    for (const pkg of targets) {
+      const pkgDir = path.join(uiAppsDir, pkg);
+      console.log(`\n📦 packages/ui/ui-apps/${pkg} ← tokens`);
+      await add({ cwd: pkgDir, names: tokenNames, skipInstall, diffMode, onConflict });
     }
-    return;
   }
 
-  // ─── tokens → ui-apps/ui-{app}(s), 또는 v0.64.x 호환 fallback (ui-core 없음) ───
-  if (!hasUiApps) {
-    console.log('❌ packages/ui/ui-apps/ 디렉토리가 없습니다.');
-    return;
-  }
+  console.log('\n✅ 추가 완료');
+}
 
+/**
+ * monorepo 의 ui-app 패키지 후보를 정해 1+ 개 반환.
+ *
+ * 우선순위:
+ *   1. 명시적 `--app` 플래그
+ *   2. walk-up 결과의 hintApp (apps/<name>/ 또는 ui-apps/ui-<name>/ 컨텍스트)
+ *   3. 단일 ui-app 만 존재 → 자동 선택
+ *   4. TTY → 사용자에게 select prompt
+ *   5. 비대화형 + 다중 ui-app → tokens 는 'all', 컴포넌트(v0.64.x fallback)는 throw
+ */
+async function pickUiAppTargets({ uiAppsDir, app, hintApp, kind }) {
   const entries = await fs.readdir(uiAppsDir, { withFileTypes: true });
   const uiPackages = entries
     .filter((e) => e.isDirectory() && e.name.startsWith('ui-') && e.name !== 'ui-app-template')
     .map((e) => e.name);
 
   if (uiPackages.length === 0) {
-    console.log('❌ ui-* 패키지가 없습니다.');
-    return;
+    throw new Error('packages/ui/ui-apps/ui-* 패키지가 없습니다.');
   }
 
-  let targets;
-  if (appName) {
-    const pkgName = `ui-${appName}`;
+  if (app) {
+    const pkgName = `ui-${app}`;
     if (!uiPackages.includes(pkgName)) {
-      console.log(`❌ packages/ui/ui-apps/${pkgName} 이 존재하지 않습니다.`);
-      console.log(`   사용 가능: ${uiPackages.join(', ')}`);
-      return;
+      throw new Error(
+        `packages/ui/ui-apps/${pkgName} 이 존재하지 않습니다. 사용 가능: ${uiPackages.join(', ')}`,
+      );
     }
-    targets = [pkgName];
-  } else if (uiPackages.length === 1) {
-    targets = uiPackages;
-  } else {
-    const choice = await select({
-      message: isTokens ? '어느 ui 패키지에 토큰을 추가할까요?' : '어디에 추가할까요?',
-      choices: [
-        { name: '모든 ui 패키지', value: 'all' },
-        ...uiPackages.map((name) => ({ name: `packages/ui/ui-apps/${name}`, value: name })),
-      ],
-    });
-    targets = choice === 'all' ? uiPackages : [choice];
+    return [pkgName];
   }
 
-  for (const pkg of targets) {
-    const pkgDir = path.join(uiAppsDir, pkg);
-    console.log(`\n📦 packages/ui/ui-apps/${pkg}에 ${componentName} 추가 중...`);
-    try {
-      execSync(`npx sh-ui add ${componentName}`, { cwd: pkgDir, stdio: 'inherit' });
-      console.log(`✅ packages/ui/ui-apps/${pkg} 완료`);
-    } catch (error) {
-      console.log(`❌ packages/ui/ui-apps/${pkg} 실패: ${error.message}`);
+  if (hintApp) {
+    const pkgName = `ui-${hintApp}`;
+    if (uiPackages.includes(pkgName)) {
+      return [pkgName];
+    }
+    // hintApp 이 가리키는 앱의 ui-패키지가 없으면 일반 흐름으로 떨어짐 (드문 케이스).
+  }
+
+  if (uiPackages.length === 1) {
+    return uiPackages;
+  }
+
+  if (!process.stdin.isTTY) {
+    if (kind === 'tokens') {
+      // 비대화형 + 다중 ui-app + tokens: 모든 앱에 적용 (가장 안전한 기본값).
+      return uiPackages;
     }
+    throw new Error(
+      `여러 ui-app 후보 (${uiPackages.join(', ')}) — 비대화형 환경에서는 --app 으로 명시하세요.`,
+    );
   }
 
-  console.log('\n✅ 컴포넌트 추가 완료!');
+  const choice = await select({
+    message: kind === 'tokens' ? '어느 ui 패키지에 토큰을 추가할까요?' : '어디에 추가할까요?',
+    choices: [
+      { name: '모든 ui 패키지', value: 'all' },
+      ...uiPackages.map((name) => ({ name: `packages/ui/ui-apps/${name}`, value: name })),
+    ],
+  });
+  return choice === 'all' ? uiPackages : [choice];
 }
 
 // ─── Generators ───

package/src/create/index.mjs

@@ -75,7 +75,11 @@ export async function runCreate(rest) {
       css: flags.css,
     });
   } else if (command === 'add-component') {
-    await addComponent(positional[0], flags.app);
+    // 호환 별칭 — 신규 진입점은 `sh-ui add <name>` (bin/sh-ui.mjs 가 walk-up 으로 라우팅).
+    await addComponent({
+      names: positional.filter(Boolean),
+      app: flags.app ?? null,
+    });
   } else {
     await createProject({
       name: positional[0],

package/src/resolve-context.mjs

@@ -0,0 +1,56 @@
+// sh-ui 의 동작 컨텍스트 해석 — `sh-ui add` 등이 cwd 부터 부모 트리를 walk up 해
+// **standalone (sh-ui.config.json 발견)** 또는 **monorepo (pnpm-workspace.yaml 발견)** 컨텍스트 결정.
+//
+// monorepo 에서 사용자가 어디서 명령을 실행했는지 (apps/web, packages/ui/ui-apps/ui-admin 등)
+// 까지 추출해 hintApp 으로 넘김 — `sh-ui add tokens` 가 어느 ui-app 으로 라우팅될지의 기본값.
+
+import { existsSync } from "node:fs";
+import path from "node:path";
+
+/**
+ * @param {string} startDir - 검색 시작점 (보통 process.cwd())
+ * @returns {{kind: 'config', root: string} | {kind: 'monorepo', root: string, hintApp: string|null} | null}
+ */
+export function findShUiContext(startDir) {
+  let dir = path.resolve(startDir);
+  while (true) {
+    if (existsSync(path.join(dir, "sh-ui.config.json"))) {
+      return { kind: "config", root: dir };
+    }
+    if (existsSync(path.join(dir, "pnpm-workspace.yaml"))) {
+      const hintApp = extractHintApp(dir, startDir);
+      return { kind: "monorepo", root: dir, hintApp };
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+
+/**
+ * monorepo 루트가 정해진 뒤 startDir 의 상대 경로에서 어느 앱 컨텍스트인지 추출.
+ *
+ * 매칭 패턴 (모노레포 루트 기준):
+ *   - `apps/<name>/...`                            → <name>
+ *   - `packages/ui/ui-apps/ui-<name>/...`          → <name>
+ *
+ * 그 외(루트 자체, packages/ui/ui-core 등)는 null — 호출자가 prompt 또는 fallback.
+ */
+function extractHintApp(monorepoRoot, startDir) {
+  const rel = path.relative(monorepoRoot, path.resolve(startDir));
+  if (!rel || rel.startsWith("..")) return null;
+  const parts = rel.split(path.sep);
+  if (parts[0] === "apps" && parts[1]) {
+    return parts[1];
+  }
+  if (
+    parts[0] === "packages" &&
+    parts[1] === "ui" &&
+    parts[2] === "ui-apps" &&
+    parts[3] &&
+    parts[3].startsWith("ui-")
+  ) {
+    return parts[3].slice(3);
+  }
+  return null;
+}