sh-ui-cli 0.114.0 → 0.116.0

package/bin/sh-ui.mjs

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
-import { init } from "../src/init.mjs";
+import { init, HELP_TEXT as INIT_HELP } 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";
+import { suggest } from "../src/levenshtein.mjs";
+import { KNOWN_COMMANDS } from "../src/commands.mjs";
 
 const [, , cmd, ...rest] = process.argv;
 
@@ -36,6 +38,9 @@ const usage = `사용법:
   sh-ui mcp                        MCP 서버(stdio) 시작 — IDE-내 AI용
   sh-ui mcp init --client <name>   IDE MCP 설정 파일에 sh-ui 엔트리 자동 추가
                                    (claude-code | cursor | claude-desktop | codex)
+
+  각 명령의 상세 옵션은 \`sh-ui <command> --help\` 로 확인.
+
   옵션:
     --skip-install                 (add, rename-app) 외부 패키지 자동 설치 생략
     --diff                         (add) 파일을 쓰지 않고 변경 내역만 출력
@@ -57,9 +62,18 @@ try {
       break;
     }
     case "init":
+      if (rest.includes("--help") || rest.includes("-h")) {
+        console.log(INIT_HELP);
+        break;
+      }
       await init({ cwd: process.cwd(), args: rest });
       break;
     case "add": {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        const { HELP_TEXT } = await import("../src/add.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       const skipInstall = rest.includes("--skip-install");
       const diffMode = rest.includes("--diff");
       const force = rest.includes("--force");
@@ -107,11 +121,21 @@ try {
       break;
     }
     case "list": {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        const { HELP_TEXT } = await import("../src/list.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       const all = rest.includes("--all");
       await list({ cwd: process.cwd(), all });
       break;
     }
     case "doctor": {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        const { HELP_TEXT } = await import("../src/doctor.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       const { doctor } = await import("../src/doctor.mjs");
       const { existsSync, readdirSync } = await import("node:fs");
       const { resolve } = await import("node:path");
@@ -157,12 +181,22 @@ try {
       break;
     }
     case "upgrade-cli": {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        const { HELP_TEXT } = await import("../src/upgrade-cli.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       const apply = rest.includes("--apply");
       const { runUpgradeCli } = await import("../src/upgrade-cli.mjs");
       await runUpgradeCli({ cwd: process.cwd(), apply });
       break;
     }
     case "theme": {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        const { HELP_TEXT } = await import("../src/theme-extract.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       const sub = rest[0];
       const flags = rest.slice(1);
       if (sub === "extract") {
@@ -177,6 +211,11 @@ try {
       break;
     }
     case "tokens": {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        const { HELP_TEXT } = await import("../src/tokens-cmd.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       // sh-ui tokens diff
       // sh-ui tokens upgrade --apply | --replace
       const sub = rest[0];
@@ -210,6 +249,12 @@ try {
     case "mcp": {
       // `sh-ui mcp init ...` → 설정 파일에 엔트리 추가
       // `sh-ui mcp`         → MCP 서버 시작
+      // 단, `sh-ui mcp --help` 는 mcp HELP_TEXT 출력 (mcp init 의 인자 처리는 mcp-init.mjs 가 담당).
+      if (rest[0] !== "init" && (rest.includes("--help") || rest.includes("-h"))) {
+        const { HELP_TEXT } = await import("../src/mcp.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       if (rest[0] === "init") {
         const { mcpInit } = await import("../src/mcp-init.mjs");
         await mcpInit({ cwd: process.cwd(), args: rest.slice(1) });
@@ -220,6 +265,11 @@ try {
       break;
     }
     case "rename-app": {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        const { HELP_TEXT } = await import("../src/rename-app.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       const yes = rest.includes("--yes");
       const dryRun = rest.includes("--dry-run");
       const skipInstall = rest.includes("--skip-install");
@@ -235,6 +285,11 @@ try {
       break;
     }
     case "migrate": {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        const { HELP_TEXT } = await import("../src/migrate-bundled.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       // sh-ui migrate bundled [--apply] [--bundle <path>]
       const sub = rest[0];
       const flags = rest.slice(1);
@@ -251,6 +306,11 @@ try {
       break;
     }
     case "migrate-v065": {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        const { HELP_TEXT } = await import("../src/migrate-v065.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       const apply = rest.includes("--apply");
       const skipImportRewrite = rest.includes("--skip-import-rewrite");
       const { migrateToV065 } = await import("../src/migrate-v065.mjs");
@@ -264,6 +324,11 @@ try {
     }
     case "remove":
     case "rm": {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        const { HELP_TEXT } = await import("../src/remove.mjs");
+        console.log(HELP_TEXT);
+        break;
+      }
       const force = rest.includes("--force");
       const dryRun = rest.includes("--dry-run");
       const names = rest.filter((a) => !a.startsWith("--"));
@@ -280,10 +345,12 @@ try {
     case "--help":
       console.log(usage);
       break;
-    default:
-      console.error(`알 수 없는 명령: ${cmd}\n`);
+    default: {
+      const hits = suggest(cmd, KNOWN_COMMANDS);
+      console.error(`알 수 없는 명령: ${cmd}` + (hits.length ? ` — 혹시 ${hits.join(", ")}?` : "") + "\n");
       console.error(usage);
       process.exit(1);
+    }
   }
 } catch (err) {
   console.error(`✗ ${err.message}`);

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.116.0",
+      "date": "2026-06-17",
+      "title": "CLI 발견성 — 서브명령 --help + 오타 추천",
+      "type": "minor",
+      "highlights": [
+        "모든 서브명령에 --help — init·add·remove·doctor·tokens·theme·migrate·rename-app·upgrade-cli·mcp 전용 도움말",
+        "did-you-mean — 없는 컴포넌트/명령 입력 시 가까운 후보를 '혹시 …?' 로 제안",
+        "의존성 없는 levenshtein 유틸 내장 (packages/cli/src/levenshtein.mjs)"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.116.0"
+    },
+    {
+      "version": "0.115.0",
+      "date": "2026-06-01",
+      "title": "rich-text-editor — 밑줄·텍스트 컬러·인라인 링크 편집 + compact·focus 툴바 + i18n 라벨",
+      "type": "minor",
+      "highlights": [
+        "**밑줄 + 텍스트 컬러** — Underline 버튼(v3 StarterKit 내장)과 글자색 팔레트를 툴바에 추가. 색은 하드 hex 가 아니라 CSS 변수(`var(--sh-ui-rte-c-moss|red|orange|blue)`)로 저장돼 라이트/다크 테마를 추종한다. 변수 정의부는 `styles.css`/`styles.module.css`(plain·css-modules) 와 런타임 주입 스타일(tailwind) — 세 variant 모두 동일하게 동작. moss 는 accent 토큰과 맞춘 톤.",
+        "**인라인 링크 편집** — 기존 `window.prompt` 를 제거하고 툴바 아래로 펼쳐지는 인라인 입력 행으로 교체(URL 입력 + 적용/제거/취소 아이콘, Enter 적용·Esc 취소). 메일 클라이언트식 UX. 읽기 전용일 때만 링크가 클릭으로 열리고(`openOnClick`), 편집 중엔 이탈 방지.",
+        "**`compact` + `toolbarMode=\"focus\"`** — `compact` 는 핵심 버튼(굵게·기울임·밑줄·취소선·글자색·링크·목록)만 노출해 좁은 패널에 맞춘다. `toolbarMode=\"focus\"` 는 포커스 전 툴바를 숨겨 인라인 입력처럼 보이게 한다. 포커스 추적은 래퍼의 `focusin`/`focusout`(relatedTarget 가드)으로 처리 — 링크 입력·컬러 스와치로 포커스가 옮겨가도 패널이 닫히지 않는다.",
+        "**활성표시 반응성 + i18n** — 툴바를 `useEditorState` 로 트랜잭션마다 구독해 굵게/밑줄 등 활성 상태가 즉시 반영된다(v3 `useEditor` 는 기본적으로 트랜잭션마다 리렌더하지 않음). `labels` prop(`RichTextEditorLabels`)으로 모든 버튼 라벨/툴팁을 현지화 가능 — 누락 키는 영어 기본값으로 폴백.",
+        "**의존성** — `@tiptap/extension-text-style` 추가(`TextStyle` + `Color` 제공). 설치: `pnpm add @tiptap/extension-text-style`. 기존 RTE 사용처는 변경 없이 동작(신규 props 전부 optional)."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.115.0"
+    },
     {
       "version": "0.114.0",
       "date": "2026-05-27",