sh-ui-cli 0.64.7 → 0.65.0

package/data/changelog/versions.json

@@ -2,6 +2,19 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.65.0",
+      "date": "2026-05-09",
+      "title": "monorepo 컴포넌트 단일 SoT — ui-core 도입, ui-app 은 tokens-only",
+      "type": "minor",
+      "highlights": [
+        "**컴포넌트 중복 emit 제거** — monorepo 에서 `sh-ui add <component>` 가 `packages/ui/ui-core` 한 곳에만 컴포넌트/훅을 떨어뜨림. 이전엔 ui-{app} 마다 같은 파일이 복제돼 sync 비용이 컸다.",
+        "**역할 분리** — `ui-core` 가 컴포넌트/훅/lib SoT, `ui-{app}` 은 토큰/스타일 전용 (`role: \"tokens-only\"` 마커). `sh-ui add tokens` 만 ui-app 으로 라우팅, 그 외는 모두 ui-core.",
+        "**친절한 거부 메시지** — 사용자가 ui-app 에서 직접 `sh-ui add button` 을 실행하면 \"ui-core 에 추가하세요\" 안내 후 종료. 잘못된 위치에 컴포넌트 누적 차단.",
+        "**v0.64.x 호환 fallback** — 기존 monorepo 레이아웃(ui-core 부재)에서는 자동으로 ui-apps 직접 라우팅으로 폴백. 마이그레이션 자동 도구는 후속 v0.66.0 (PR-D)."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.65.0"
+    },
     {
       "version": "0.64.7",
       "date": "2026-05-08",

package/package.json

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

package/src/add.mjs

@@ -363,6 +363,19 @@ export async function add({
     );
   }
 
+  // role: "tokens-only" 패키지 (v0.65+ ui-app) 는 tokens 만 허용.
+  // 컴포넌트는 sibling ui-core 패키지로 라우팅되도록 친절한 에러로 안내.
+  if (config.role === "tokens-only") {
+    const offending = names.filter((n) => n !== "tokens");
+    if (offending.length > 0) {
+      throw new Error(
+        `이 패키지는 'tokens-only' role 입니다 — ${offending.map((n) => `'${n}'`).join(', ')} 컴포넌트를 추가할 수 없습니다.\n` +
+          `컴포넌트는 sibling ui-core 패키지에 추가하세요 (예: cd ../ui-core && sh-ui add ${offending[0]}).\n` +
+          `또는 monorepo 루트에서 \`sh-ui add ${offending[0]}\` 실행 시 자동으로 ui-core 로 라우팅됩니다.`,
+      );
+    }
+  }
+
   // 비대화형(non-TTY)이면 prompt 를 못 띄우니 안전하게 keep 으로 강등.
   const effectiveStrategy =
     onConflict === "prompt" && !process.stdin.isTTY ? "keep" : onConflict;

package/src/create/generator.js

@@ -401,9 +401,45 @@ export async function addComponent(componentName, appName) {
     return;
   }
 
-  // Monorepo: packages/ui/ui-apps/* 에서 실행
+  // 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');
-  if (!(await fs.pathExists(uiAppsDir))) {
+  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;
+  }
+
+  if (!componentName) {
+    componentName = await input({ message: '컴포넌트 이름:' });
+  }
+
+  const isTokens = componentName === 'tokens';
+
+  // ─── 비-tokens (컴포넌트/훅/lib) → ui-core 단일 라우팅 ───
+  if (!isTokens && hasUiCore) {
+    if (appName) {
+      console.log(
+        `ℹ️  v0.65+ 에서 컴포넌트는 packages/ui/ui-core 에 단일 emit 됩니다 (--app ${appName} 무시).`,
+      );
+    }
+    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}`);
+    }
+    return;
+  }
+
+  // ─── tokens → ui-apps/ui-{app}(s), 또는 v0.64.x 호환 fallback (ui-core 없음) ───
+  if (!hasUiApps) {
     console.log('❌ packages/ui/ui-apps/ 디렉토리가 없습니다.');
     return;
   }
@@ -418,10 +454,6 @@ export async function addComponent(componentName, appName) {
     return;
   }
 
-  if (!componentName) {
-    componentName = await input({ message: '컴포넌트 이름:' });
-  }
-
   let targets;
   if (appName) {
     const pkgName = `ui-${appName}`;
@@ -431,9 +463,11 @@ export async function addComponent(componentName, appName) {
       return;
     }
     targets = [pkgName];
+  } else if (uiPackages.length === 1) {
+    targets = uiPackages;
   } else {
     const choice = await select({
-      message: '어디에 추가할까요?',
+      message: isTokens ? '어느 ui 패키지에 토큰을 추가할까요?' : '어디에 추가할까요?',
       choices: [
         { name: '모든 ui 패키지', value: 'all' },
         ...uiPackages.map((name) => ({ name: `packages/ui/ui-apps/${name}`, value: name })),

package/templates/monorepo/packages/ui/ui-core/package.json

@@ -7,17 +7,29 @@
     "lint": "eslint . --max-warnings 0"
   },
   "dependencies": {
+    "@base-ui/react": "^1.4.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "tailwind-merge": "^3.5.0"
+    "lucide-react": "^0.563.0",
+    "next-themes": "^0.4.6",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-hook-form": "^7.56.4",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.5.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@types/react": "^19.2.10",
+    "@types/react-dom": "^19.2.3",
     "@workspace/eslint-config": "workspace:*",
     "@workspace/typescript-config": "workspace:*",
     "eslint": "^9.39.2",
     "typescript": "^5.9.3"
   },
   "exports": {
+    "./components/*": "./src/components/*.tsx",
+    "./hooks/*": "./src/hooks/*.ts",
     "./lib/*": "./src/lib/*.ts"
   }
 }

package/templates/monorepo/packages/ui/ui-core/sh-ui.config.json

@@ -0,0 +1,15 @@
+{
+  "platform": "react",
+  "cssFramework": "plain",
+  "paths": {
+    "components": "src/components",
+    "hooks": "src/hooks",
+    "utils": "src/lib/utils.ts"
+  },
+  "aliases": {
+    "components": "@workspace/ui-core/components",
+    "hooks": "@workspace/ui-core/hooks",
+    "utils": "@workspace/ui-core/lib/utils",
+    "ui": "@workspace/ui-core/components"
+  }
+}

package/templates/ui-app-template/package.json

@@ -7,15 +7,9 @@
     "lint": "eslint . --max-warnings 0"
   },
   "dependencies": {
-    "@base-ui/react": "^1.4.1",
     "@workspace/ui-core": "workspace:*",
-    "lucide-react": "^0.563.0",
-    "next-themes": "^0.4.6",
     "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "react-hook-form": "^7.56.4",
-    "sonner": "^2.0.7",
-    "zod": "^4.3.6"
+    "react-dom": "^19.2.4"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.18",
@@ -30,9 +24,6 @@
   },
   "exports": {
     "./globals.css": "./src/styles/globals.css",
-    "./postcss.config": "./postcss.config.mjs",
-    "./lib/*": "./src/lib/*.ts",
-    "./components/*": "./src/components/*.tsx",
-    "./hooks/*": "./src/hooks/*.ts"
+    "./postcss.config": "./postcss.config.mjs"
   }
 }

package/templates/ui-app-template/sh-ui.config.json

@@ -1,6 +1,7 @@
 {
   "platform": "react",
   "cssFramework": "plain",
+  "role": "tokens-only",
   "theme": {
     "base": "neutral",
     "radius": "md",
@@ -8,13 +9,6 @@
   },
   "paths": {
     "tokens": "src/styles/tokens.css",
-    "styles": "src/styles",
-    "components": "src/components",
-    "utils": "src/lib/utils.ts"
-  },
-  "aliases": {
-    "components": "@workspace/ui-app-name/components",
-    "utils": "@workspace/ui-app-name/lib/utils",
-    "ui": "@workspace/ui-app-name/components"
+    "styles": "src/styles"
   }
 }