sh-ui-cli 0.21.0 → 0.21.1

package/data/changelog/versions.json

@@ -2,6 +2,18 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.21.1",
+      "date": "2026-04-27",
+      "title": "외부 패키지 자동 설치 버전 해석",
+      "type": "patch",
+      "highlights": [
+        "registry/react/peer-versions.json — registry.json deps 의 패키지명을 실제 버전 범위로 매핑하는 단일 출처 추가",
+        "sh-ui add 가 npm install <name>@<range> 로 호출 — RC 만 있는 패키지(@base-ui-components/react 등) 자동 설치 시 latest 못 찾아 ETARGET 으로 실패하던 사전 이슈 수정",
+        "패키지명에 이미 @version 이 포함돼 있거나 peer-versions 맵에 없는 경우는 그대로 통과 (Flutter·기타 platform 호환)"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.21.1"
+    },
     {
       "version": "0.21.0",
       "date": "2026-04-27",

package/data/registry/react/peer-versions.json

@@ -0,0 +1,10 @@
+{
+  "$description": "registry.json 의 dependencies 에 등장하는 npm 패키지의 버전 범위. CLI 가 add 시 npm install <name>@<range> 로 호출하기 위함.",
+  "versions": {
+    "@base-ui-components/react": "^1.0.0-rc.0",
+    "@tanstack/react-form": "^1.29.1",
+    "lucide-react": "^1.11.0",
+    "react-hook-form": "^7.74.0",
+    "shiki": "^4.0.2"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh-ui-cli",
-  "version": "0.21.0",
+  "version": "0.21.1",
   "description": "sh-ui CLI — 디자인 시스템 컴포넌트를 프로젝트로 복사하는 CLI (sh-ui init / add / list / remove)",
   "license": "MIT",
   "repository": {

package/src/add.mjs

@@ -4,7 +4,30 @@ import { dirname, resolve, relative } from "node:path";
 import { pathToFileURL } from "node:url";
 import { spawn } from "node:child_process";
 import { formatUnifiedDiff } from "./diff.mjs";
-import { getRegistryRoot, getTokensRoot } from "./paths.mjs";
+import { getRegistryRoot, getTokensRoot, getPeerVersionsPath } from "./paths.mjs";
+
+/**
+ * `dependencies` 에 적힌 패키지명을 peer-versions.json 의 버전 범위와 결합.
+ * 패키지 자체에 이미 `@version` 이 붙어 있거나 맵에 없으면 그대로 둔다.
+ *
+ * 왜: registry.json 은 deps 를 패키지명만 적어 두고, 실제 호환 버전은
+ * peer-versions.json 가 단일 출처로 관리한다. 이게 없으면 npm install 이
+ * latest 태그를 찾는데, RC 만 있는 패키지(@base-ui-components/react 등)
+ * 에서 ETARGET 으로 실패한다.
+ */
+async function resolveDepVersions(deps, platform) {
+  let map = {};
+  try {
+    const data = JSON.parse(await readFile(getPeerVersionsPath(platform), "utf8"));
+    map = data.versions ?? {};
+  } catch {
+    // peer-versions.json 이 없는 platform 은 그대로 패스 (Flutter 등)
+  }
+  return deps.map((d) => {
+    if (d.includes("@", 1)) return d; // 이미 name@range 형식
+    return map[d] ? `${d}@${map[d]}` : d;
+  });
+}
 
 // tokens/build.mjs 는 모노레포·출고 모드에 따라 위치가 달라서 동적 import.
 async function loadTokensBuilder() {
@@ -209,22 +232,24 @@ export async function add({ cwd, names, skipInstall = false, diffMode = false })
     return;
   }
 
+  const versioned = await resolveDepVersions(missing, config.platform);
+
   if (skipInstall) {
     const pm = detectPackageManager(cwd);
     const addCmd = pm === "npm" ? "install" : "add";
     console.log(
-      `\n  ⚠ 외부 패키지 필요. 다음을 실행하세요:\n    ${pm} ${addCmd} ${missing.join(" ")}`,
+      `\n  ⚠ 외부 패키지 필요. 다음을 실행하세요:\n    ${pm} ${addCmd} ${versioned.join(" ")}`,
     );
     return;
   }
 
   const pm = detectPackageManager(cwd);
   try {
-    await runInstall(pm, missing, cwd);
+    await runInstall(pm, versioned, cwd);
   } catch (err) {
     const addCmd = pm === "npm" ? "install" : "add";
     console.error(
-      `\n✗ 자동 설치 실패 (${err.message}). 수동으로 실행하세요:\n    ${pm} ${addCmd} ${missing.join(" ")}`,
+      `\n✗ 자동 설치 실패 (${err.message}). 수동으로 실행하세요:\n    ${pm} ${addCmd} ${versioned.join(" ")}`,
     );
     throw err;
   }

package/src/mcp.mjs

@@ -102,7 +102,7 @@ function resolveCwd(input) {
 
 export async function startMcpServer() {
   const server = new McpServer(
-    { name: "sh-ui", version: "0.21.0" },
+    { name: "sh-ui", version: "0.21.1" },
     { capabilities: { tools: {} } },
   );
 

package/src/paths.mjs

@@ -33,6 +33,13 @@ export function getTokensRoot() {
     : resolve(MONOREPO_PACKAGES, "tokens");
 }
 
+/** registry.json deps 에 등장하는 npm 패키지의 버전 범위 맵 */
+export function getPeerVersionsPath(platform) {
+  return isBundled
+    ? resolve(BUNDLED_DATA, "registry", platform, "peer-versions.json")
+    : resolve(MONOREPO_PACKAGES, "registry", platform, "peer-versions.json");
+}
+
 /** llms 요약 JSON (platform별) */
 export function getSummariesPath(platform) {
   return isBundled