sh-ui-cli 0.22.2 → 0.23.1

package/README.md

@@ -1,6 +1,8 @@
 # sh-ui-cli
 
-sh-ui 디자인 시스템의 컴포넌트를 프로젝트로 복사하는 CLI. shadcn 방식 — 프로젝트가 소스를 소유한다.
+sh-ui 디자인 시스템의 통합 CLI. **프로젝트 스캐폴드**(create) + **컴포넌트 추가**(add/list/remove) + **IDE-내 AI용 MCP 서버**.
+
+> v0.23.0 부터 `sh-ui-create` 가 이 패키지로 통합됐습니다. 기존 `sh-ui-create` 사용자는 자동으로 `sh-ui create` 로 위임됩니다.
 
 ## 설치
 
@@ -14,6 +16,21 @@ npx sh-ui-cli <command>
 
 ## 사용법
 
+### create — 프로젝트 스캐폴드
+
+```bash
+# 대화형
+npm create sh-ui my-app
+npx sh-ui-cli create
+
+# 비대화형 (에이전트 / CI)
+npx sh-ui-cli create my-app --platform next --structure standalone --yes
+npx sh-ui-cli create my-app --platform next --structure monorepo --plugins sentry,next-intl --yes
+npx sh-ui-cli create my-app --platform flutter --yes
+```
+
+전체 옵션은 `npx sh-ui-cli create --help`. TTY 없는 환경에서는 누락된 필수 플래그가 있으면 prompt 대신 즉시 에러로 종료한다.
+
 ### init — 설정 파일 생성
 
 ```bash
@@ -150,7 +167,7 @@ npx -y sh-ui-cli mcp init --client claude-code --scope user
 ## 더 알아보기
 
 - sh-ui 디자인 시스템: https://github.com/sanghyeonKim0201/sh-ui
-- `sh-ui-create` (프로젝트 스캐폴드): https://www.npmjs.com/package/sh-ui-create
+- 변경 내역: `npx sh-ui-cli` 의 `sh_ui_get_changelog` MCP 툴 또는 GitHub Releases
 
 ## 라이선스
 

package/bin/sh-ui.mjs

@@ -7,6 +7,8 @@ import { remove } from "../src/remove.mjs";
 const [, , cmd, ...rest] = process.argv;
 
 const usage = `사용법:
+  sh-ui create [name] [options]    Next.js / Flutter 프로젝트 스캐폴드
+                                   sh-ui create --help 로 옵션 전체 확인
   sh-ui init                       설정 파일(sh-ui.config.json) 생성
   sh-ui add <component...>         컴포넌트 소스를 프로젝트로 복사하고
                                    필요한 외부 패키지를 자동 설치
@@ -26,6 +28,11 @@ const usage = `사용법:
 
 try {
   switch (cmd) {
+    case "create": {
+      const { runCreate } = await import("../src/create/index.mjs");
+      await runCreate(rest);
+      break;
+    }
     case "init":
       await init({ cwd: process.cwd(), args: rest });
       break;

package/data/changelog/versions.json

@@ -2,6 +2,32 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.23.1",
+      "date": "2026-04-28",
+      "title": "sh-ui-create 패키지 완전 삭제 — 단일 sh-ui-cli",
+      "type": "patch",
+      "highlights": [
+        "베타 단계라 sh-ui-create 사용자가 없으므로 deprecate shim 도 폐기 — packages/create 디렉토리 + npm 의 sh-ui-create 패키지 둘 다 정리",
+        "publish workflow 매트릭스에서 create 제거 — 앞으로 sh-ui-cli 만 발행",
+        "문서 일괄 갱신: README, getting-started, CLI 레퍼런스, 플레이그라운드 명령 컴포저 모두 `npx sh-ui-cli create` 로 통일"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.23.1"
+    },
+    {
+      "version": "0.23.0",
+      "date": "2026-04-28",
+      "title": "sh-ui-create 가 sh-ui-cli 로 통합 — 단일 CLI",
+      "type": "minor",
+      "highlights": [
+        "프로젝트 스캐폴드가 sh-ui-cli 의 새 서브커맨드로 흡수: `npx sh-ui-cli create my-app --platform next --structure standalone --yes`",
+        "MCP 에 `sh_ui_create_project` 툴 신규 — IDE-내 AI 가 Bash 우회 없이 MCP 만으로 새 프로젝트 스캐폴드 가능. force/cwd/plugins/theme 모두 인자로 노출",
+        "MCP instructions 가 외부 CLI 안내 대신 통합된 명령·새 툴을 가리키도록 정리 — 단일 진실원천, 드리프트 위험 제거",
+        "기존 `sh-ui-create` 패키지는 v0.20.0 deprecated shim 으로 유지 — `npx sh-ui-create` 호출은 자동으로 `npx sh-ui-cli create` 로 위임되어 호환 유지",
+        "내부: 템플릿/스캐폴드 로직/스캐폴드 테스트(52건) 가 packages/cli/{templates,src/create,test}/ 로 이동, paths.mjs 에 getTemplatesRoot() 추가"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.23.0"
+    },
     {
       "version": "0.22.2",
       "date": "2026-04-28",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sh-ui-cli",
-  "version": "0.22.2",
-  "description": "sh-ui CLI — 디자인 시스템 컴포넌트를 프로젝트로 복사하는 CLI (sh-ui init / add / list / remove)",
+  "version": "0.23.1",
+  "description": "sh-ui CLI — 프로젝트 스캐폴드(create) + 컴포넌트 추가(add/list/remove) + IDE-내 AI용 MCP 서버",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -16,14 +16,23 @@
     "sh-ui",
     "cli",
     "mcp",
+    "scaffold",
+    "create",
+    "nextjs",
+    "flutter",
     "design-system",
     "registry",
     "components"
   ],
   "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "fs-extra": "^11.2.0",
     "zod": "^3.25.0"
   },
+  "devDependencies": {
+    "vitest": "^3.2.4"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -33,12 +42,14 @@
   },
   "scripts": {
     "bundle-data": "node scripts/copy-data.mjs",
+    "test": "vitest run",
     "prepublishOnly": "node scripts/copy-data.mjs && node --check bin/sh-ui.mjs"
   },
   "files": [
     "bin",
     "src",
     "data",
+    "templates",
     "LICENSE",
     "README.md"
   ]

package/src/create/cli-args.js

@@ -0,0 +1,63 @@
+const VALID_PLATFORMS = ['next', 'flutter'];
+const VALID_STRUCTURES = ['standalone', 'monorepo'];
+const VALID_PLUGINS = ['sentry', 'next-intl'];
+
+const VALUE_FLAGS = ['platform', 'structure', 'plugins', 'theme', 'app'];
+const BOOL_FLAGS = ['yes', 'help'];
+
+const SUBCOMMANDS = ['add-app', 'add-component'];
+
+export const parseArgs = (argv) => {
+  const rest = argv.slice(2);
+  let command = 'create';
+  if (rest.length > 0 && SUBCOMMANDS.includes(rest[0])) {
+    command = rest.shift();
+  }
+
+  const flags = {};
+  const positional = [];
+
+  for (let i = 0; i < rest.length; i++) {
+    const arg = rest[i];
+    if (arg === '-h') {
+      flags.help = true;
+      continue;
+    }
+    if (!arg.startsWith('--')) {
+      positional.push(arg);
+      continue;
+    }
+    const name = arg.slice(2);
+    if (BOOL_FLAGS.includes(name)) {
+      flags[name] = true;
+      continue;
+    }
+    if (!VALUE_FLAGS.includes(name)) {
+      throw new Error(`알 수 없는 플래그: --${name}`);
+    }
+    const value = rest[i + 1];
+    if (value === undefined || value.startsWith('--')) {
+      throw new Error(`--${name} 값 필요`);
+    }
+    i++;
+    if (name === 'plugins') {
+      const list = value === '' ? [] : value.split(',').map((s) => s.trim()).filter(Boolean);
+      for (const p of list) {
+        if (!VALID_PLUGINS.includes(p)) {
+          throw new Error(`알 수 없는 플러그인: ${p}`);
+        }
+      }
+      flags.plugins = list;
+      continue;
+    }
+    if (name === 'platform' && !VALID_PLATFORMS.includes(value)) {
+      throw new Error(`--platform 은 ${VALID_PLATFORMS.join('/')} 중 하나여야 함 (받은 값: ${value})`);
+    }
+    if (name === 'structure' && !VALID_STRUCTURES.includes(value)) {
+      throw new Error(`--structure 는 ${VALID_STRUCTURES.join('/')} 중 하나여야 함 (받은 값: ${value})`);
+    }
+    flags[name] = value;
+  }
+
+  return { command, flags, positional };
+};