sh-ui-cli 0.64.3 → 0.64.4

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.64.4",
+      "date": "2026-05-08",
+      "title": "patch — Flutter summary 16건 정확성 audit",
+      "type": "patch",
+      "highlights": [
+        "**사실관계 정정 6건** — `card`/`dialog` 의 'header/body/footer named slot' (실제는 separate widget, Body 가 아니라 Content), `dialog` 의 'showDialog 로 호출' (실제는 `ShUiDialog.show<T>()` static, Flutter 빌트인 `showDialog` 와 다름), `checkbox` 의 'tristate' (실제 prop 은 `indeterminate`), `toast` 의 'ShUiToastOverlay' (실재 X — `ShUiToaster` + `ShUiToast.show()`), `tabs` 의 'ShUiTabsController' (실재 X — `ShUiTabs` + `ShUiTab` 데이터).",
+        "**exports 명시 보강 10건** — select/combobox 의 Multi 변종 (`ShUiMultiSelect<T>`, `ShUiMultiCombobox<T>`), date-picker 의 `ShUiDateRangePicker`, dropdown-menu 의 sealed `ShUiDropdownMenuEntry<T>` 자식들 (Item / CheckboxItem / RadioItem / Divider / Label), menubar 의 `ShUiMenubarMenu`, sidebar 의 Provider/Trigger/Header/Footer/Inset + `.of(ctx)` 패턴, app-shell 의 `ShUiAppShellGroup`/`Item`, header 의 `ShUiHeaderItem`, breadcrumb 의 `ShUiBreadcrumbItem`, popover 의 Title/Description, checkbox 의 `ShUiCheckboxGroup`. v0.64.1·v0.64.2 의 React audit 과 동일 톤으로 통일.",
+        "**MCP 양 플랫폼 정보 일관성 마무리** — React (v0.64.1·v0.64.2·v0.64.3) + Flutter (이번) 모두 source-of-truth 정확도 확보. AI 가 sh-ui MCP 로 컴포넌트 요청 시 환각으로 잘못된 위젯명·prop·호출 패턴을 만들어 내던 실패 모드 해소."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.64.4"
+    },
     {
       "version": "0.64.3",
       "date": "2026-05-08",

package/data/summaries/flutter.json

@@ -3,34 +3,34 @@
   "summaries": {
     "tokens": "ShUiTheme (ThemeExtension) — 색상/간격/타이포/반경/지속시간 토큰. Theme.of(ctx).extension<ShUiTheme>()로 접근.",
     "button": "ShUiButton — variant(primary/secondary/ghost/danger/link) + size(sm/md/lg).",
-    "card": "ShUiCard — header/body/footer named slot.",
+    "card": "ShUiCard — separate widgets: ShUiCard / ShUiCardHeader / ShUiCardTitle / ShUiCardDescription / ShUiCardContent / ShUiCardFooter (named slot 아님, Body 가 아니라 Content).",
     "input": "ShUiInput — TextField 래퍼 + sh-ui 토큰 스타일.",
     "textarea": "ShUiTextarea — 다중 행 입력.",
     "label": "ShUiLabel — 폼 레이블.",
-    "checkbox": "ShUiCheckbox — tristate 지원.",
+    "checkbox": "ShUiCheckbox / ShUiCheckboxGroup — `indeterminate` prop 으로 중간 상태 (Material 의 `tristate` 아님).",
     "radio": "ShUiRadio / ShUiRadioGroup — 단일 선택.",
     "switch": "ShUiSwitch — 토글 스위치.",
     "toggle": "ShUiToggle — 프레스 상태 유지 버튼.",
     "slider": "ShUiSlider — 단일 값, step.",
-    "select": "ShUiSelect — 네이티브 대체 드롭다운 셀렉트.",
-    "combobox": "ShUiCombobox — 검색 가능 셀렉트.",
-    "date-picker": "ShUiDatePicker — 캘린더 팝업.",
+    "select": "ShUiSelect<T> + ShUiSelectItem<T> / ShUiSelectGroup / ShUiSelectSeparator (모두 ShUiSelectElement). 다중 선택은 ShUiMultiSelect<T>.",
+    "combobox": "ShUiCombobox<T> + ShUiComboboxItem<T> — 검색 가능 셀렉트. 다중 선택은 ShUiMultiCombobox<T>.",
+    "date-picker": "ShUiDatePicker (단일) + ShUiDateRangePicker (범위) — 캘린더 팝업.",
     "color-picker": "ShUiColorPicker — 색상 선택.",
     "file-upload": "ShUiFileUpload — 파일 선택/드롭.",
-    "dialog": "ShUiDialog — header/body/footer named slot, showDialog로 호출.",
-    "popover": "ShUiPopover — 트리거 기준 오버레이.",
+    "dialog": "ShUiDialog + ShUiDialogTrigger / ShUiDialogContent / ShUiDialogHeader 분리 위젯. 명령형 호출은 `ShUiDialog.show<T>(...)` static (Flutter 빌트인 `showDialog` 아님).",
+    "popover": "ShUiPopover + ShUiPopoverTitle / ShUiPopoverDescription — 트리거 기준 오버레이.",
     "tooltip": "ShUiTooltip — long-press / hover 힌트.",
-    "toast": "ShUiToast — ShUiToastOverlay로 스택 관리.",
-    "dropdown-menu": "ShUiDropdownMenu — 트리거 기준 메뉴.",
+    "toast": "임시 알림 — `ShUiToast.show(ctx, ...)` static (또는 `.success` / `.danger` / `.warning`) + `ShUiToaster` 위젯 (앱 루트에 배치, 스택 관리). `ShUiToastOverlay` 클래스 아님.",
+    "dropdown-menu": "ShUiDropdownMenu<T> + ShUiDropdownMenuItem<T> / ShUiDropdownMenuCheckboxItem<T> / ShUiDropdownMenuRadioItem<T> / ShUiDropdownMenuDivider<T> / ShUiDropdownMenuLabel<T> (모두 ShUiDropdownMenuEntry<T> 의 sealed 자식).",
     "context-menu": "ShUiContextMenu — 길게 누르기/우클릭 메뉴.",
-    "menubar": "ShUiMenubar — 수평 메뉴바.",
-    "tabs": "ShUiTabs / ShUiTabsController — 탭 내비.",
+    "menubar": "ShUiMenubar + ShUiMenubarMenu — 수평 메뉴바, 각 ShUiMenubarMenu 가 하나의 드롭다운.",
+    "tabs": "ShUiTabs + ShUiTab (data class) — 탭 내비. `ShUiTabsController` 클래스 아님.",
     "accordion": "ShUiAccordion — 펼침/접힘. single/multiple.",
     "carousel": "ShUiCarousel — PageView 기반, autoplay/dots.",
-    "sidebar": "ShUiSidebar — 접이식 사이드바.",
-    "app-shell": "ShUiAppShell — 사이드바 + 상단 바 + 본문 레이아웃.",
-    "header": "ShUiHeader — 로고/네비/액션 영역.",
-    "breadcrumb": "ShUiBreadcrumb(items: [...]) — items 기반 경로 내비.",
+    "sidebar": "ShUiSidebar + ShUiSidebarProvider (앱 루트, 접힘 상태 보유) / ShUiSidebarTrigger / ShUiSidebarHeader / ShUiSidebarFooter / ShUiSidebarInset (본문 영역). 자식에서 상태 접근은 `ShUiSidebar.of(context)`.",
+    "app-shell": "ShUiAppShell — 사이드바 + 상단 바 + 본문 레이아웃. nav 항목은 `ShUiAppShellItem` (label/icon/route 등) 을 `ShUiAppShellGroup` 에 묶어 전달.",
+    "header": "ShUiHeader — 로고/네비/액션 영역. nav 항목은 `ShUiHeaderItem` (label/route/onTap 등) 을 items 에 전달.",
+    "breadcrumb": "ShUiBreadcrumb(items: [...]) — items 기반 경로 내비. items 원소는 `ShUiBreadcrumbItem` 위젯.",
     "pagination": "ShUiPagination(page:, pageCount:, siblingCount:, onPageChanged:) — 페이지 범위 계산 내장.",
     "avatar": "ShUiAvatar — 이미지/initials fallback.",
     "badge": "ShUiBadge — 상태 뱃지.",

package/package.json

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