sh-ui-cli 0.14.0 → 0.21.0

package/bin/sh-ui.mjs

@@ -13,6 +13,7 @@ const usage = `사용법:
                                    특수값: tokens → 설정 기반 토큰 파일 생성
   sh-ui list                       현재 설치된 컴포넌트 목록 표시
   sh-ui remove <component...>      설치된 컴포넌트 파일 삭제
+  sh-ui mcp                        MCP 서버(stdio) 시작 — IDE-내 AI용
   옵션:
     --skip-install                 (add) 외부 패키지 자동 설치 생략
     --diff                         (add) 파일을 쓰지 않고 변경 내역만 출력
@@ -43,6 +44,11 @@ try {
       await list({ cwd: process.cwd(), all });
       break;
     }
+    case "mcp": {
+      const { startMcpServer } = await import("../src/mcp.mjs");
+      await startMcpServer();
+      break;
+    }
     case "remove":
     case "rm": {
       const force = rest.includes("--force");

package/data/changelog/versions.json

@@ -0,0 +1,354 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
+  "versions": [
+    {
+      "version": "0.21.0",
+      "date": "2026-04-27",
+      "title": "MCP 서버 + standalone CLI — AI 친화 세팅",
+      "type": "minor",
+      "highlights": [
+        "sh-ui mcp 서브커맨드 — IDE-내 AI(Claude Code, Cursor 등)가 stdio MCP 로 컴포넌트 검색·설치·삭제. 등록 한 줄(`npx -y sh-ui-cli mcp`)로 AI 가 sh-ui 를 자동 인지",
+        "MCP 툴 7개 — describe_init / init / list_components / get_component / add_component / remove_component / get_changelog. 자연어 의도(\"다크 모던\")를 enum 값으로 매핑하는 describe_init 포함",
+        "출고 모드 데이터 번들 — 그동안 `npx sh-ui-cli`가 모노레포 밖에서 동작하지 않던 문제 수정. prepublishOnly 가 registry/tokens/summaries/versions 를 패키지에 포함",
+        "paths.mjs 헬퍼 — 모노레포·출고 모드 자동 감지로 add/list/remove 가 양쪽에서 동일하게 동작"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.21.0"
+    },
+    {
+      "version": "0.20.1",
+      "date": "2026-04-27",
+      "title": "TSDoc·dartdoc 보강 — IDE 호버 안내 강화",
+      "type": "patch",
+      "highlights": [
+        "React 24개 컴포넌트의 prop·옵션별 한글 TSDoc 추가 — IDE 호버에서 variant/size/orientation 등 enum 옵션별 의미가 즉시 표시",
+        "Flutter 4개 위젯(button·header·sidebar·app_shell)의 클래스·필드 dartdoc 보강 — `[paramName]` 참조와 옵션 설명 정리",
+        "isValidBRN·getPaginationRange·yupSchema 등 유틸 함수에 @param·@returns·@example 추가 — 자동완성 시그니처 헬프에서 인자 의미 안내",
+        "런타임 동작 변경 없음 (docs only). registry와 docs/showcase 듀얼 카피 동기화"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.20.1"
+    },
+    {
+      "version": "0.20.0",
+      "date": "2026-04-23",
+      "title": "Form 기본 레이아웃 + 루트 컴포넌트 style/className 개방",
+      "type": "minor",
+      "highlights": [
+        "Form · Form.Section · Form.Field 에 기본 세로 flex 레이아웃 적용 — 수동 margin 없이 토큰 간격(--space-4, --space-1)으로 자동 정렬",
+        "Form.Field / Form.Error 가 HTMLAttributes 를 그대로 수용 — <Form.Field style={{ gap: \"0.5rem\" }}> · className=\"gap-2\" 같이 네이티브 CSS 경로로 직접 덮어쓰기",
+        "CodePanel · CodePanel.Body · ColorPicker 루트가 HTMLAttributes 확장 — style · className · data-* 로 바로 오버라이드 가능",
+        "FileUpload 루트 래퍼에 style prop 추가 (ref 는 기존대로 input 유지)",
+        "CSS 변수 API 최소화 원칙 — 컴포넌트별 간격 변수는 노출하지 않고 style/className/외부 CSS 로 일관"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.20.0"
+    },
+    {
+      "version": "0.19.1",
+      "date": "2026-04-23",
+      "title": "Form 타입 정밀화 + placeholder 색 완화 + 문서 확장",
+      "type": "patch",
+      "highlights": [
+        "Zod v4 호환 — StandardSchemaV1.path 에 PathSegment 객체 형태 허용, schema 캐스트 없이 Form schema/useShUiForm schema 에 직접 전달",
+        "TanStack Form 어댑터 — adaptTanStackForm 이 useForm 반환을 캐스트 없이 수용 (ReactFormExtendedApi 의 12개 제네릭 중 TFormData 만 추론 유지)",
+        "placeholder 색 완화 — Input·Textarea·Select·Combobox·DatePicker 에서 --foreground-muted → --foreground-subtle 로 입력값과 명도 차이 확대",
+        "Form 문서 대폭 확장 — 데모 9종 추가 (useShUiForm·Zod·TanStack·Yup·async validate·서버 에러·교차 필드·checked 바인딩·custom render), 사용 모드 비교·검증·API 레퍼런스 섹션 정리"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.19.1"
+    },
+    {
+      "version": "0.19.0",
+      "date": "2026-04-23",
+      "title": "Form 컴포넌트 — 라이브러리 비종속 + 멀티스텝·섹션 1급",
+      "type": "minor",
+      "highlights": [
+        "Form + Form.Field / Section / Steps / Step — compound API 로 멀티스텝·멀티섹션 폼 지원 (값은 스텝 이동에도 보존)",
+        "3가지 사용 모드 (네이티브 / useShUiForm / RHF·TanStack·Yup 어댑터) 를 FormStore 인터페이스로 통일",
+        "재사용 블록은 Form 루트 없이 Section 패턴으로 이식 가능 — AddressFields 스타일 권장",
+        "Standard Schema 표준 채택 (Zod v3.24+/Valibot/Arktype 네이티브, Yup 은 form-yup 래퍼)"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.19.0"
+    },
+    {
+      "version": "0.18.1",
+      "date": "2026-04-22",
+      "title": "sh-ui-create — 입력 하드닝",
+      "type": "patch",
+      "highlights": [
+        "--theme base64 입력에 10KB 상한 추가 — 큰 악성 입력을 JSON 파싱 전에 명확한 에러로 거부",
+        "플레이그라운드 Dialog 의 프로젝트 이름 검증 — 영문·숫자·'-'·'_' 만 허용, 첫 글자 영문/숫자. 잘못되면 에러 메시지 + 복사 버튼 비활성화",
+        "UX: 잘못된 이름으로 생성된 명령어를 터미널에 붙여넣는 사고 방지"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.18.1"
+    },
+    {
+      "version": "0.18.0",
+      "date": "2026-04-22",
+      "title": "sh-ui-create — 비대화형 플래그와 theme 주입",
+      "type": "minor",
+      "highlights": [
+        "--platform / --structure / --plugins / --theme / --yes 플래그 지원 — 완전 비대화형 실행 가능",
+        "--theme <base64> 로 커스텀 색·radius 를 프로젝트 생성 시점에 바로 주입 (플레이그라운드 연동 준비)",
+        "템플릿의 tokens.css / sh_ui_tokens.dart 에 theme 섹션 마커 삽입 — 토큰만 교체되고 다른 값(spacing 등)은 유지"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.18.0"
+    },
+    {
+      "version": "0.17.0",
+      "date": "2026-04-21",
+      "title": "sh-ui-create — Flutter 스타터 지원",
+      "type": "minor",
+      "highlights": [
+        "sh-ui-create — 프로젝트 생성 시 플랫폼 선택(Next.js / Flutter) 신규",
+        "Flutter 선택 시 pubspec + main.dart + sh-ui.config.json + 토큰 복사본까지 완성된 스타터 제공",
+        "생성 직후 `flutter run`으로 테마 적용된 초기 화면 확인, 이어서 `sh-ui add <widget>` 로 위젯 추가"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.17.0"
+    },
+    {
+      "version": "0.16.0",
+      "date": "2026-04-21",
+      "title": "sh-ui-create — 프로젝트 스캐폴드 CLI",
+      "type": "minor",
+      "highlights": [
+        "sh-ui-create 신규 패키지 — npx sh-ui-create 로 sh-ui 가 사전 설정된 Next.js 프로젝트 스캐폴드",
+        "단독 / 모노레포(Turborepo + pnpm workspace) 템플릿 — FSD 폴더 구조 + sh-ui.config.json + tokens.css 선반영",
+        "Sentry / next-intl 플러그인 — 체크박스 선택으로 파일·의존성·next.config 래핑 자동 구성",
+        "add-app / add-component 보조 명령 — 모노레포 앱 추가, 앱별 ui 패키지에 sh-ui add 위임",
+        "docs: /create 페이지 추가 — 전체 레퍼런스 + 단독 vs 모노레포 구조 비교 + FSD 레이어 규칙"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.16.0"
+    },
+    {
+      "version": "0.15.1",
+      "date": "2026-04-21",
+      "title": "ColorPicker — StrictMode 렌더 중 부모 setState 경고 수정",
+      "type": "patch",
+      "highlights": [
+        "setHsv 업데이터 콜백 내부에서 onChange를 호출하던 부작용을 업데이터 밖으로 이동",
+        "React StrictMode가 updater를 두 번 invoke할 때 발생하던 'setState while rendering' 경고 제거",
+        "controlled 모드에서 부모 상태를 동기화하는 시나리오(예: playground 토큰 에디터) 안정성 개선"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.15.1"
+    },
+    {
+      "version": "0.15.0",
+      "date": "2026-04-21",
+      "title": "llms.txt — AI 도구용 컴포넌트 인벤토리",
+      "type": "minor",
+      "highlights": [
+        "apps/docs/public/llms.txt — 전 컴포넌트 한 줄 요약 + 설치 플로우 + 관용 규칙 (llms.txt 표준 따름)",
+        "apps/docs/public/llms-full.txt — 각 컴포넌트별 설치 커맨드/import 경로/의존성 + 최근 릴리즈 5개",
+        "packages/llms 신규 워크스페이스 — registry.json + summaries/*.json을 읽어 자동 생성. next build 훅에 연결",
+        "pnpm gen:llms — 루트 스크립트로 수동 재생성 가능"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.15.0"
+    },
+    {
+      "version": "0.14.0",
+      "date": "2026-04-20",
+      "title": "Pagination — 페이지 단위 내비게이션 컴포넌트",
+      "type": "minor",
+      "highlights": [
+        "React: Pagination / PaginationContent / Item / Link / Previous / Next / Ellipsis 컴파운드 구성 — Breadcrumb와 동일한 관용",
+        "getPaginationRange({page, totalPages, siblings}) 유틸 — 현재 페이지 주변 + 양 끝 + 생략(…) 토큰 배열 생성",
+        "Flutter: ShUiPagination(page:, pageCount:, siblingCount:, onPageChanged:) — 페이지 범위 계산 내장",
+        "nav + ol/ul 시맨틱, 현재 페이지 aria-current=\"page\", 이전/다음 aria-label 자동 부여"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.14.0"
+    },
+    {
+      "version": "0.13.1",
+      "date": "2026-04-20",
+      "title": "토큰 대비 감사 — WCAG AA 통과",
+      "type": "patch",
+      "highlights": [
+        "light mode foreground-muted를 base.500 → base.600로 (muted 텍스트 on muted background 4.35:1 → 7.17:1)",
+        "light mode danger를 red.500 → red.600로 통일 (danger 버튼 3.76:1 → 4.83:1)",
+        "감사 스크립트 추가: pnpm --filter @sh-ui/tokens audit:contrast — 3 base × 2 mode 조합 일괄 검증",
+        "주의: 기존 설치자는 sh-ui add tokens로 tokens.css 재생성 필요"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.13.1"
+    },
+    {
+      "version": "0.13.0",
+      "date": "2026-04-20",
+      "title": "CLI list / remove — 설치 관리 사이클 완결",
+      "type": "minor",
+      "highlights": [
+        "sh-ui list — 설치된 컴포넌트 목록 (--all로 레지스트리 전체)",
+        "sh-ui remove <name...> — 설치 파일 삭제, 빈 폴더 자동 정리",
+        "사용자 수정 파일은 기본 보호, --force로만 강제 삭제. --dry-run 미리보기 지원"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.13.0"
+    },
+    {
+      "version": "0.12.0",
+      "date": "2026-04-20",
+      "title": "CLI --diff 플래그 — 업데이트 미리보기",
+      "type": "minor",
+      "highlights": [
+        "sh-ui add <name> --diff — 파일을 쓰지 않고 변경 내역(unified diff)만 출력",
+        "신규/변경/동일 파일을 분류해 요약, 수정해둔 파일이 있는지 사전 확인 가능",
+        "의존성 없는 LCS 기반 line-diff 내장 (packages/cli/src/diff.mjs)"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.12.0"
+    },
+    {
+      "version": "0.11.0",
+      "date": "2026-04-20",
+      "title": "Progress / Spinner / Separator — 기본 원자 3종",
+      "type": "minor",
+      "highlights": [
+        "신규: Progress (determinate + indeterminate) — React / Flutter 양쪽",
+        "신규: Spinner (sm/md/lg) — aria-live 로딩 상태 노출",
+        "신규: Separator (horizontal/vertical) — 기본 decorative, 필요 시 role=separator"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.11.0"
+    },
+    {
+      "version": "0.10.0",
+      "date": "2026-04-20",
+      "title": "Flutter 파리티 라운드 — 최근 7종 위젯 추가",
+      "type": "minor",
+      "highlights": [
+        "신규: ShUiDropdownMenu (PopupMenuButton 기반)",
+        "신규: ShUiContextMenu (우클릭 + long-press)",
+        "신규: ShUiMenubar (가로 메뉴바)",
+        "신규: ShUiTooltip (Flutter Tooltip 래핑)",
+        "신규: ShUiBreadcrumb (items 리스트)",
+        "신규: ShUiAvatar (이미지 + fallback, 4사이즈)",
+        "신규: ShUiBadge (6 variant × 2 size)"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.10.0"
+    },
+    {
+      "version": "0.9.0",
+      "date": "2026-04-20",
+      "title": "Menu 계열 완결 + Tooltip/Breadcrumb/Avatar/Badge",
+      "type": "minor",
+      "highlights": [
+        "신규: ContextMenu (우클릭/long-press)",
+        "신규: Menubar (상단 가로 메뉴바, DropdownMenu 재사용)",
+        "신규: Tooltip (hover/focus, Provider로 delay 공유)",
+        "신규: Breadcrumb (nav + ol 시맨틱 compound)",
+        "신규: Avatar (이미지 + 이니셜 fallback, 4사이즈)",
+        "신규: Badge (6 variant × 2 size)"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.9.0"
+    },
+    {
+      "version": "0.8.0",
+      "date": "2026-04-20",
+      "title": "DropdownMenu 신규",
+      "type": "minor",
+      "highlights": [
+        "신규: DropdownMenu (Base UI Menu 기반 compound)",
+        "체크박스·라디오·서브메뉴·구분선 지원",
+        "키보드 네비게이션 기본 제공 (↑↓, Enter, →/←, Home/End, Esc, type-ahead)"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.8.0"
+    },
+    {
+      "version": "0.7.1",
+      "date": "2026-04-19",
+      "title": "접근성 감사 라운드 1",
+      "type": "patch",
+      "highlights": [
+        "원자 8종(Button/Toggle/Radio/Checkbox/Dialog/Popover/Sidebar/Toast)에 reduced-motion 블록 추가",
+        "Carousel autoPlay: 키보드 focus 시 일시정지 (WCAG 2.2.2)"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.7.1"
+    },
+    {
+      "version": "0.7.0",
+      "date": "2026-04-19",
+      "title": "Slider / CodePanel compound 전환",
+      "type": "minor",
+      "highlights": [
+        "Slider: SliderTrack / SliderRange / SliderThumb + useSliderState",
+        "CodePanel: CodePanelHeader / Filename / Copy / Body",
+        "기존 prop API 호환 유지"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.7.0"
+    },
+    {
+      "version": "0.6.0",
+      "date": "2026-04-19",
+      "title": "Header + Compound 리팩터",
+      "type": "minor",
+      "highlights": [
+        "신규: Header (Flutter prop-based + React compound)",
+        "Carousel / Input / FileUpload / ColorPicker / DatePicker compound 전환"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.6.0"
+    },
+    {
+      "version": "0.5.0",
+      "date": "2026-04-19",
+      "title": "Flutter 파리티 v1",
+      "type": "minor",
+      "highlights": [
+        "Flutter 위젯 대량 추가 + API 확장 + multi-select 지원",
+        "ShUiAppShell 고수준 레이아웃 + Sidebar 개선"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.5.0"
+    },
+    {
+      "version": "0.4.0",
+      "date": "2026-04-19",
+      "title": "디자인 토큰 v2 + Flutter 쇼케이스",
+      "type": "minor",
+      "highlights": [
+        "디자인 토큰 v2 (primitives / semantic 분리)",
+        "Flutter 쇼케이스 앱 + pnpm 실행 스크립트",
+        "테마 커스터마이징 가이드 페이지"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.4.0"
+    },
+    {
+      "version": "0.3.1",
+      "date": "2026-04-17",
+      "title": "Input prefix / Select className 타입 수정",
+      "type": "patch",
+      "highlights": [
+        "Input prefix 타입 충돌 해결",
+        "Select className 타입 에러 수정"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.3.1"
+    },
+    {
+      "version": "0.3.0",
+      "date": "2026-04-17",
+      "title": "컴포넌트 레지스트리 정리",
+      "type": "minor",
+      "highlights": [
+        "사이드바 네비게이션 정렬",
+        "신규 컴포넌트 레지스트리 등록"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.3.0"
+    },
+    {
+      "version": "0.2.0",
+      "date": "2026-04-17",
+      "title": "컴포넌트 확장 + 문서 강화 + 모바일 안정화",
+      "type": "minor",
+      "highlights": [
+        "컴포넌트 라인업 확장 (Tabs / Popover / Dialog / Combobox / Label / base.css)",
+        "Sidebar 보조 패널·Popover flyout·접근성 개선",
+        "모바일 레이아웃 안정화"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.2.0"
+    },
+    {
+      "version": "0.1.0",
+      "date": "2026-04-15",
+      "title": "sh-ui 초기 릴리스",
+      "type": "minor",
+      "highlights": [
+        "초기 컴포넌트 셋 + CLI 스캐폴딩",
+        "React/Flutter 듀얼 레지스트리 구조"
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.1.0"
+    }
+  ]
+}