sh-ui-cli 0.71.1 → 0.72.0

package/bin/sh-ui.mjs

@@ -29,6 +29,9 @@ const usage = `사용법:
                                    디렉토리 + 모든 import/path 패턴)
   sh-ui migrate-v065               v0.64.x → v0.65 자동 마이그레이션
                                    (--dry-run 기본, --apply 로 실제 적용)
+  sh-ui migrate bundled            cssStrategy=bundled 로 전환 (per-component
+                                   styles.css → 단일 sh-ui-components.css)
+                                   (--apply 로 실제 적용)
   sh-ui mcp                        MCP 서버(stdio) 시작 — IDE-내 AI용
   sh-ui mcp init --client <name>   IDE MCP 설정 파일에 sh-ui 엔트리 자동 추가
                                    (claude-code | cursor | claude-desktop)
@@ -109,7 +112,47 @@ try {
     }
     case "doctor": {
       const { doctor } = await import("../src/doctor.mjs");
-      await doctor({ cwd: process.cwd() });
+      const { existsSync, readdirSync } = await import("node:fs");
+      const { resolve } = await import("node:path");
+      // add 와 같은 walk-up + monorepo 라우팅. standalone 이면 그 root 1개,
+      // monorepo 면 packages/ui/ui-core + ui-apps/ui-* 모두 순회.
+      const ctx = findShUiContext(process.cwd());
+      if (!ctx) {
+        console.error(
+          "✗ sh-ui.config.json 또는 pnpm-workspace.yaml 을 cwd 부터 부모 트리에서 찾지 못했습니다.",
+        );
+        process.exit(1);
+      }
+      let anyFailed = false;
+      const targets = [];
+      if (ctx.kind === "config") {
+        targets.push(ctx.root);
+      } else {
+        const uiCore = resolve(ctx.root, "packages/ui/ui-core");
+        if (existsSync(resolve(uiCore, "sh-ui.config.json"))) targets.push(uiCore);
+        const uiAppsRoot = resolve(ctx.root, "packages/ui/ui-apps");
+        if (existsSync(uiAppsRoot)) {
+          for (const name of readdirSync(uiAppsRoot)) {
+            const dir = resolve(uiAppsRoot, name);
+            if (existsSync(resolve(dir, "sh-ui.config.json"))) targets.push(dir);
+          }
+        }
+        if (targets.length === 0) {
+          console.error(
+            "✗ monorepo 에서 sh-ui.config.json 가지는 패키지를 찾지 못했습니다.\n" +
+              "  packages/ui/ui-core/ 또는 packages/ui/ui-apps/ui-*/ 에 있어야 합니다.",
+          );
+          process.exit(1);
+        }
+      }
+      for (const target of targets) {
+        if (targets.length > 1) {
+          console.log(`\n────  ${target.replace(ctx.root + "/", "")}  ────`);
+        }
+        const result = await doctor({ cwd: target });
+        if (!result.ok) anyFailed = true;
+      }
+      if (anyFailed) process.exit(1);
       break;
     }
     case "theme": {
@@ -184,6 +227,22 @@ try {
       await renameApp({ cwd: process.cwd(), oldName, newName, yes, dryRun, skipInstall });
       break;
     }
+    case "migrate": {
+      // sh-ui migrate bundled [--apply] [--bundle <path>]
+      const sub = rest[0];
+      const flags = rest.slice(1);
+      if (sub === "bundled") {
+        const apply = flags.includes("--apply");
+        const bIdx = flags.indexOf("--bundle");
+        const bundleArg = bIdx !== -1 ? flags[bIdx + 1] : null;
+        const { runMigrateBundled } = await import("../src/migrate-bundled.mjs");
+        await runMigrateBundled({ cwd: process.cwd(), apply, bundleArg });
+      } else {
+        console.error(`에러: 알 수 없는 migrate 서브명령 '${sub ?? ""}'. 'bundled' 만 지원.\n`);
+        process.exit(1);
+      }
+      break;
+    }
     case "migrate-v065": {
       const apply = rest.includes("--apply");
       const skipImportRewrite = rest.includes("--skip-import-rewrite");

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.72.0",
+      "date": "2026-05-10",
+      "title": "sh-ui migrate bundled — per-component → bundled 자동 전환 (Phase D 후속)",
+      "type": "minor",
+      "highlights": [
+        "**`sh-ui migrate bundled` 명령** — 기존 per-component 프로젝트를 bundled 로 한 번에 전환. paths.components 아래 모든 styles.css 를 bundle 의 마커 섹션으로 누적 + 원본 파일 삭제 + .tsx import 제거 + config 갱신.",
+        "**dry-run 기본** — 변경 매트릭스 (대상 컴포넌트 + 파일 목록) 출력 후 사용자 확인. `--apply` 로만 실제 변경.",
+        "**`--bundle <path>` 옵션** — bundle 파일 위치 명시. 미지정 시 paths.styles 또는 paths.tokens 디렉토리 + sh-ui-components.css 를 자동 사용.",
+        "**완료 후 안내** — globals.css 에 `@import './sh-ui-components.css';` 한 줄 추가하라는 메시지 (자동 편집 안 함 — 사용자 entry CSS 위치/스타일 다양해서).",
+        "**제약** — cssFramework: plain + React 만. tailwind/css-modules/vanilla-extract 면 친절 에러. 이미 bundled 면 noop."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.72.0"
+    },
+    {
+      "version": "0.71.2",
+      "date": "2026-05-09",
+      "title": "fix(doctor) — monorepo walk-up + 컴포넌트-only 패키지 인식",
+      "type": "patch",
+      "highlights": [
+        "**doctor 의 walk-up + monorepo 라우팅** — `add` 와 같은 정책을 적용. monorepo 어느 디렉토리 (apps/web, ui-core 안 등) 에서 실행해도 `packages/ui/ui-core` 와 모든 `packages/ui/ui-apps/ui-*` 를 자동 순회. 각 패키지마다 헤더 출력 + 결과 집계, 하나라도 fail 이면 exit 1.",
+        "**컴포넌트-only 패키지 인식** — ui-core 처럼 `paths.tokens` 가 없는 패키지는 의도된 형태. 이전엔 'theme 미설정 / 토큰 검증 스킵' 로 fail/warn 폭발 → 이제 ✓ '(컴포넌트 only — 토큰 없음, 검증 스킵)' 한 줄로 정리.",
+        "**doctor 함수 시그니처** — `process.exit()` 직접 호출 대신 `{ ok, failCount, warnCount }` 반환. 호출부 (bin) 가 monorepo 순회 후 집계 exit. API consumer (테스트, 향후 lint:doctor 등) 도 활용 가능."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.71.2"
+    },
     {
       "version": "0.71.1",
       "date": "2026-05-09",

package/package.json

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

package/src/doctor.mjs

@@ -72,16 +72,18 @@ async function loadConfig(cwd, report) {
     const config = JSON.parse(await readFile(configPath, "utf8"));
     const issues = [];
     if (!config.platform) issues.push("platform 미설정");
-    if (!config.theme) issues.push("theme 미설정");
     if (!config.paths) issues.push("paths 미설정");
+    // theme 은 컴포넌트-only 패키지 (monorepo ui-core, paths.tokens 없음) 에서는
+    // 의도적으로 비어 있다 — 그땐 누락이라고 보지 않음.
+    if (!config.theme && config.paths?.tokens) issues.push("theme 미설정");
     if (issues.length > 0) {
       report.fail("sh-ui.config.json", `필수 필드 누락: ${issues.join(", ")}`);
       return null;
     }
+    const themeInfo = config.theme?.base ? `theme.base=${config.theme.base}` : "(컴포넌트 only)";
     report.ok(
       "sh-ui.config.json",
-      `platform=${config.platform} theme.base=${config.theme?.base ?? "?"} ` +
-        `cssFramework=${config.cssFramework ?? "(기본 plain)"}`,
+      `platform=${config.platform} ${themeInfo} cssFramework=${config.cssFramework ?? "(기본 plain)"}`,
     );
     return config;
   } catch (err) {
@@ -93,10 +95,11 @@ async function loadConfig(cwd, report) {
 function checkTokensFile(config, cwd, report) {
   const rel = config.paths?.tokens;
   if (!rel) {
-    // 모노레포 ui-core 처럼 tokens 를 가지지 않는 패키지 — 이 경우 검사 스킵.
-    report.warn(
+    // 모노레포 ui-core 처럼 토큰을 가지지 않는 컴포넌트-only 패키지 — 이 케이스는
+    // 정상이라 안내 한 줄만 ok 로 표시 (warn 으로 노이즈 만들지 않음).
+    report.ok(
       "paths.tokens",
-      "config 에 paths.tokens 가 없습니다 — 토큰 검증 스킵.",
+      "(컴포넌트 only — 토큰 없음, 검증 스킵)",
     );
     return null;
   }
@@ -171,6 +174,14 @@ async function checkCssEntry(config, cwd, tokensPath, report) {
  */
 async function checkInstalledComponents(config, cwd, definedVars, report) {
   if (!definedVars) {
+    // tokens 없는 컴포넌트-only 패키지 — 의존성 검증은 의미 없음. 조용히 ok.
+    if (!config.paths?.tokens) {
+      report.ok(
+        "컴포넌트 토큰 의존성",
+        "(컴포넌트 only — 검증 스킵)",
+      );
+      return;
+    }
     report.warn(
       "컴포넌트 토큰 의존성",
       "tokens.css 가 없어 검증 스킵.",
@@ -290,6 +301,10 @@ function effectiveFramework(entry, cssFramework) {
   return hasVariant ? cssFramework : "plain";
 }
 
+/**
+ * @returns {Promise<{ ok: boolean, failCount: number, warnCount: number }>}
+ *          호출부가 exit code 결정. 한 cwd 에서 다른 cwd 로 이어 호출 가능 (monorepo 순회).
+ */
 export async function doctor({ cwd }) {
   console.log(`sh-ui doctor — ${relative(process.cwd(), cwd) || "."}\n`);
   const report = new Report();
@@ -297,7 +312,7 @@ export async function doctor({ cwd }) {
   const config = await loadConfig(cwd, report);
   if (!config) {
     report.render();
-    process.exit(1);
+    return { ok: false, failCount: report.failCount, warnCount: report.warnCount };
   }
 
   const tokensPath = checkTokensFile(config, cwd, report);
@@ -312,5 +327,5 @@ export async function doctor({ cwd }) {
   await checkInstalledComponents(config, cwd, definedVars, report);
 
   report.render();
-  if (report.failCount > 0) process.exit(1);
+  return { ok: report.failCount === 0, failCount: report.failCount, warnCount: report.warnCount };
 }

package/src/migrate-bundled.mjs

@@ -0,0 +1,172 @@
+// `sh-ui migrate bundled` — 기존 per-component 프로젝트를 cssStrategy: bundled 로 전환.
+//
+// 동작:
+//   1) sh-ui.config.json 의 cssStrategy 가 미설정/per-component 인지 확인.
+//   2) 사용자에게 paths.cssBundle 위치 안내 (기본값 자동 결정 — paths.styles 또는
+//      paths.tokens 의 디렉토리 + `sh-ui-components.css`).
+//   3) paths.components 아래 모든 `<name>/styles.css` 를 읽어 bundle 에 섹션으로 누적.
+//   4) 각 컴포넌트 .tsx 의 `import "./styles.css";` 라인 제거.
+//   5) per-component styles.css 파일 삭제.
+//   6) sh-ui.config.json 에 `cssStrategy: "bundled"` + `paths.cssBundle` 저장.
+//
+// dry-run 기본 — 실제 변경은 --apply 로만. 실행 전 사용자에게 변경 매트릭스 안내.
+
+import { readFile, writeFile, readdir, rm, mkdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { resolve, relative, dirname, join } from "node:path";
+import { upsertSection, stripStylesImport } from "./css-bundle.mjs";
+
+async function loadConfig(cwd) {
+  const configPath = resolve(cwd, "sh-ui.config.json");
+  if (!existsSync(configPath)) {
+    throw new Error(
+      "sh-ui.config.json 을 찾을 수 없습니다. 먼저 `sh-ui init` 또는 `sh-ui create`.",
+    );
+  }
+  return { configPath, config: JSON.parse(await readFile(configPath, "utf8")) };
+}
+
+/**
+ * paths.cssBundle 기본값 — 기존 paths.styles 또는 paths.tokens 의 부모 디렉토리에
+ * `sh-ui-components.css` 를 둔다.
+ */
+function defaultBundlePath(config) {
+  const stylesDir = config.paths?.styles
+    ?? (config.paths?.tokens && dirname(config.paths.tokens));
+  if (!stylesDir) {
+    throw new Error(
+      "paths.styles 또는 paths.tokens 를 설정에서 찾을 수 없어 cssBundle 기본 경로를 정할 수 없습니다.\n" +
+        "  --bundle <path> 로 명시하세요 (예: --bundle src/styles/sh-ui-components.css).",
+    );
+  }
+  return join(stylesDir, "sh-ui-components.css");
+}
+
+/**
+ * paths.components 아래 컴포넌트 폴더 (직속 디렉토리 한 단계만).
+ */
+async function listComponentDirs(componentsAbs) {
+  if (!existsSync(componentsAbs)) return [];
+  const entries = await readdir(componentsAbs, { withFileTypes: true });
+  return entries
+    .filter((e) => e.isDirectory())
+    .map((e) => ({ name: e.name, dir: resolve(componentsAbs, e.name) }));
+}
+
+/**
+ * 컴포넌트 디렉토리에서 styles.css / styles.module.css 를 찾아 (있으면) 반환.
+ * .tsx 변종은 별도 — `migrateOne` 이 처리.
+ */
+function findStyleFiles(componentDir) {
+  return [
+    resolve(componentDir, "styles.css"),
+    resolve(componentDir, "styles.module.css"),
+  ].filter((p) => existsSync(p));
+}
+
+function findTsxFiles(componentDir) {
+  return [
+    resolve(componentDir, "index.tsx"),
+    resolve(componentDir, "index.module.tsx"),
+  ].filter((p) => existsSync(p));
+}
+
+export async function runMigrateBundled({ cwd, apply, bundleArg }) {
+  const { configPath, config } = await loadConfig(cwd);
+
+  if (config.cssStrategy === "bundled") {
+    console.log("이미 cssStrategy='bundled' 로 설정돼 있습니다 — 마이그레이션 불필요.");
+    return;
+  }
+
+  if ((config.cssFramework ?? "plain") !== "plain") {
+    throw new Error(
+      `cssFramework='${config.cssFramework}' 에선 bundled 모드가 동작하지 않습니다 (plain 만 지원).`,
+    );
+  }
+
+  if (config.platform !== "react") {
+    throw new Error("bundled 마이그레이션은 React 만 지원합니다.");
+  }
+
+  const componentsRel = config.paths?.components;
+  if (!componentsRel) {
+    throw new Error("paths.components 가 sh-ui.config.json 에 없습니다.");
+  }
+  const componentsAbs = resolve(cwd, componentsRel);
+  const components = await listComponentDirs(componentsAbs);
+  if (components.length === 0) {
+    console.log(`${componentsRel} 아래에 컴포넌트가 없습니다. 마이그레이션할 게 없음.`);
+  }
+
+  const bundleRel = bundleArg ?? defaultBundlePath(config);
+  const bundleAbs = resolve(cwd, bundleRel);
+
+  // 변경 매트릭스 계산
+  const plan = []; // { name, styleFiles: [], tsxFiles: [] }
+  for (const c of components) {
+    const styleFiles = findStyleFiles(c.dir);
+    const tsxFiles = findTsxFiles(c.dir);
+    if (styleFiles.length === 0 && tsxFiles.length === 0) continue;
+    plan.push({ name: c.name, dir: c.dir, styleFiles, tsxFiles });
+  }
+
+  console.log(`\n── bundled 마이그레이션 ${apply ? "(실행)" : "(dry-run)"} ──`);
+  console.log(`  bundle 파일: ${bundleRel}`);
+  console.log(`  대상 컴포넌트: ${plan.length}개`);
+  for (const p of plan) {
+    const styleNames = p.styleFiles.map((f) => relative(cwd, f));
+    const tsxNames = p.tsxFiles.map((f) => relative(cwd, f));
+    console.log(`    · ${p.name}`);
+    for (const f of styleNames) console.log(`        styles → bundle 섹션 + 파일 삭제: ${f}`);
+    for (const f of tsxNames) console.log(`        .tsx import 제거: ${f}`);
+  }
+
+  if (!apply) {
+    console.log(`\n실제 적용은 \`sh-ui migrate bundled --apply\`.`);
+    return;
+  }
+
+  // 적용 시작 — 번들 텍스트를 먼저 빌드, 마지막에 한 번에 쓴다.
+  let bundleText = existsSync(bundleAbs)
+    ? await readFile(bundleAbs, "utf8")
+    : `/* sh-ui — 컴포넌트 CSS 번들 (cssStrategy: bundled). 마커 사이는 sh-ui 가 관리, 그 밖은 사용자 자유. */\n\n`;
+
+  for (const p of plan) {
+    let cssAccum = "";
+    for (const f of p.styleFiles) {
+      const text = await readFile(f, "utf8");
+      cssAccum += (cssAccum ? "\n\n" : "") + text.trim();
+    }
+    if (cssAccum) {
+      bundleText = upsertSection(bundleText, p.name, cssAccum);
+    }
+    for (const f of p.tsxFiles) {
+      const before = await readFile(f, "utf8");
+      const after = stripStylesImport(before);
+      if (before !== after) await writeFile(f, after, "utf8");
+    }
+    for (const f of p.styleFiles) {
+      await rm(f);
+    }
+  }
+
+  await mkdir(dirname(bundleAbs), { recursive: true });
+  await writeFile(bundleAbs, bundleText, "utf8");
+
+  // config 갱신
+  const nextConfig = {
+    ...config,
+    cssStrategy: "bundled",
+    paths: { ...config.paths, cssBundle: bundleRel },
+  };
+  await writeFile(configPath, JSON.stringify(nextConfig, null, 2) + "\n", "utf8");
+
+  console.log(
+    `\n✓ 마이그레이션 완료.\n` +
+      `  bundle: ${bundleRel}\n` +
+      `  config: cssStrategy='bundled', paths.cssBundle 추가\n\n` +
+      `다음 단계: globals.css (또는 entry CSS) 에서 한 번 import 하세요:\n` +
+      `  @import './${bundleRel.replace(/^.*\//, "")}';`,
+  );
+}