sh-ui-cli 0.64.2 → 0.64.4

package/data/changelog/versions.json

@@ -2,6 +2,30 @@
   "$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",
+      "title": "patch — Trigger·Close 컴포넌트 7종 소스 JSDoc 에 render-prop 함정 명시",
+      "type": "patch",
+      "highlights": [
+        "**컴포넌트 소스 JSDoc 보강 (7종 × 4 변종)** — `sh_ui_get_component` 와 사용자 프로젝트에 설치된 컴포넌트 모두 소스의 JSDoc 만 보이는데 `render` prop 안내가 거기 없어 AI 가 button 중첩 워크어라운드를 반복하던 문제를 차단. dialog / popover / select / dropdown-menu / accordion / combobox 의 Trigger·Close·SubTrigger·Clear 위에 \"`<button>` 자체 렌더 → 자식 button 중첩 금지 → 다른 엘리먼트 슬롯은 `render` prop\" 패턴을 일관 톤으로 박음.",
+        "**`render` 와 `children` 패턴 구분 명시** — date-picker 의 DatePickerTrigger 는 sh-ui 자체 `<button>` 이라 Base UI 의 `render` prop 이 아닌 `children` 함수 패턴(value/formatted/placeholder 인자) + `className` 직접 스타일링이 정석. 이 차이를 JSDoc + summary 양쪽에 명시.",
+        "**plain / tailwind / vanilla-extract / module 4 변종 + apps/docs 듀얼카피본 모두 동기화** — 28 파일. v0.64.1·v0.64.2 의 summary 정정과 합쳐 AI 가 쓸 수 있는 모든 정보 채널(MCP list/get, llms.txt, 설치 후 IDE 호버) 에서 동일한 가이드 노출."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.64.3"
+    },
     {
       "version": "0.64.2",
       "date": "2026-05-08",

package/data/registry/react/components/accordion/index.module.tsx

@@ -45,8 +45,13 @@ export const AccordionItem = React.forwardRef<
 AccordionItem.displayName = "AccordionItem";
 
 /**
- * Trigger: 헤더 버튼. 우측에 chevron이 자동으로 붙고 expanded 상태에서 회전한다.
- * Base UI의 AccordionHeader(h3)로 감싸 의미론적 헤더 구조를 유지한다.
+ * Trigger: 헤더 버튼. 우측에 chevron 이 자동으로 붙고 expanded 상태에서 회전한다.
+ * Base UI 의 AccordionHeader(h3) 로 감싸 의미론적 헤더 구조를 유지한다.
+ *
+ * 자체로 `<button>` 을 렌더하므로 자식으로 또 다른 button 을 넣지 말 것.
+ * 다른 엘리먼트로 슬롯하려면 Base UI 의 `render` prop:
+ *
+ *   <AccordionTrigger render={<MyHeader>...</MyHeader>} />
  */
 export const AccordionTrigger = React.forwardRef<
   HTMLButtonElement,

package/data/registry/react/components/accordion/index.tailwind.tsx

@@ -37,6 +37,15 @@ export const AccordionItem = React.forwardRef<
 ));
 AccordionItem.displayName = "AccordionItem";
 
+/**
+ * Trigger: 헤더 버튼. 우측에 chevron 이 자동으로 붙고 expanded 상태에서 회전한다.
+ * Base UI 의 AccordionHeader(h3) 로 감싸 의미론적 헤더 구조를 유지한다.
+ *
+ * 자체로 `<button>` 을 렌더하므로 자식으로 또 다른 button 을 넣지 말 것.
+ * 다른 엘리먼트로 슬롯하려면 Base UI 의 `render` prop:
+ *
+ *   <AccordionTrigger render={<MyHeader>...</MyHeader>} />
+ */
 export const AccordionTrigger = React.forwardRef<
   HTMLButtonElement,
   WithStringClassName<React.ComponentPropsWithoutRef<typeof BaseAccordion.Trigger>>

package/data/registry/react/components/accordion/index.tsx

@@ -45,8 +45,13 @@ export const AccordionItem = React.forwardRef<
 AccordionItem.displayName = "AccordionItem";
 
 /**
- * Trigger: 헤더 버튼. 우측에 chevron이 자동으로 붙고 expanded 상태에서 회전한다.
- * Base UI의 AccordionHeader(h3)로 감싸 의미론적 헤더 구조를 유지한다.
+ * Trigger: 헤더 버튼. 우측에 chevron 이 자동으로 붙고 expanded 상태에서 회전한다.
+ * Base UI 의 AccordionHeader(h3) 로 감싸 의미론적 헤더 구조를 유지한다.
+ *
+ * 자체로 `<button>` 을 렌더하므로 자식으로 또 다른 button 을 넣지 말 것.
+ * 다른 엘리먼트로 슬롯하려면 Base UI 의 `render` prop:
+ *
+ *   <AccordionTrigger render={<MyHeader>...</MyHeader>} />
  */
 export const AccordionTrigger = React.forwardRef<
   HTMLButtonElement,

package/data/registry/react/components/combobox/index.module.tsx

@@ -25,8 +25,20 @@ type WithStringClassName<T> = Omit<T, "className"> & { className?: string };
 export const Combobox = BaseCombobox.Root;
 
 export const ComboboxIcon = BaseCombobox.Icon;
+
+/**
+ * Combobox 토글 트리거. 자체로 `<button>` 을 렌더 — 자식으로 또 다른 button
+ * (예: 커스텀 Button) 을 넣지 말 것. 다른 엘리먼트로 슬롯하려면 Base UI 의
+ * `render` prop 사용.
+ */
 export const ComboboxTrigger = BaseCombobox.Trigger;
+
+/**
+ * 입력값 클리어 버튼. 자체로 `<button>` — 자식 button 중첩 금지. 다른
+ * 엘리먼트 슬롯은 `render` prop.
+ */
 export const ComboboxClear = BaseCombobox.Clear;
+
 export const ComboboxValue = BaseCombobox.Value;
 export const ComboboxGroup = BaseCombobox.Group;
 export const ComboboxChips = BaseCombobox.Chips;

package/data/registry/react/components/combobox/index.tailwind.tsx

@@ -9,8 +9,20 @@ type WithStringClassName<T> = Omit<T, "className"> & { className?: string };
 
 export const Combobox = BaseCombobox.Root;
 export const ComboboxIcon = BaseCombobox.Icon;
+
+/**
+ * Combobox 토글 트리거. 자체로 `<button>` 을 렌더 — 자식으로 또 다른 button
+ * (예: 커스텀 Button) 을 넣지 말 것. 다른 엘리먼트로 슬롯하려면 Base UI 의
+ * `render` prop 사용.
+ */
 export const ComboboxTrigger = BaseCombobox.Trigger;
+
+/**
+ * 입력값 클리어 버튼. 자체로 `<button>` — 자식 button 중첩 금지. 다른
+ * 엘리먼트 슬롯은 `render` prop.
+ */
 export const ComboboxClear = BaseCombobox.Clear;
+
 export const ComboboxValue = BaseCombobox.Value;
 export const ComboboxGroup = BaseCombobox.Group;
 export const ComboboxChips = BaseCombobox.Chips;

package/data/registry/react/components/combobox/index.tsx

@@ -25,8 +25,20 @@ type WithStringClassName<T> = Omit<T, "className"> & { className?: string };
 export const Combobox = BaseCombobox.Root;
 
 export const ComboboxIcon = BaseCombobox.Icon;
+
+/**
+ * Combobox 토글 트리거. 자체로 `<button>` 을 렌더 — 자식으로 또 다른 button
+ * (예: 커스텀 Button) 을 넣지 말 것. 다른 엘리먼트로 슬롯하려면 Base UI 의
+ * `render` prop 사용.
+ */
 export const ComboboxTrigger = BaseCombobox.Trigger;
+
+/**
+ * 입력값 클리어 버튼. 자체로 `<button>` — 자식 button 중첩 금지. 다른
+ * 엘리먼트 슬롯은 `render` prop.
+ */
 export const ComboboxClear = BaseCombobox.Clear;
+
 export const ComboboxValue = BaseCombobox.Value;
 export const ComboboxGroup = BaseCombobox.Group;
 export const ComboboxChips = BaseCombobox.Chips;

package/data/registry/react/components/date-picker/index.module.tsx

@@ -246,8 +246,15 @@ export interface DatePickerTriggerProps
 }
 
 /**
- * 캘린더 popover를 여는 트리거 버튼. children에 함수를 넘기면 현재 값/포맷 문자열/placeholder를
- * 받아 직접 렌더할 수 있다.
+ * 캘린더 popover 를 여는 트리거 버튼. 자체로 `<button>` 을 렌더하므로 자식
+ * 으로 또 다른 button (예: 커스텀 Button) 을 넣지 말 것 — button 중첩은
+ * invalid HTML. 트리거 외관 커스터마이즈는 두 가지 방법:
+ *
+ * 1) `children` 에 함수 — 내부 텍스트만 커스터마이즈 (현재 값/포맷/placeholder 받아 직접 렌더):
+ *      <DatePickerTrigger>{({ formatted, placeholder }) => formatted ?? placeholder}</DatePickerTrigger>
+ *
+ * 2) `className` 으로 직접 스타일링 — 별도 Button 컴포넌트로 감싸지 말고
+ *    버튼 자체에 클래스 부여.
  */
 export const DatePickerTrigger = React.forwardRef<HTMLButtonElement, DatePickerTriggerProps>(
   function DatePickerTrigger({ className, children, onClick, ...props }, ref) {

package/data/registry/react/components/date-picker/index.tailwind.tsx

@@ -124,6 +124,12 @@ export interface DatePickerTriggerProps
   }) => React.ReactNode);
 }
 
+/**
+ * 캘린더 popover 를 여는 트리거 버튼. 자체로 `<button>` 을 렌더하므로 자식
+ * 으로 또 다른 button (예: 커스텀 Button) 을 넣지 말 것 — button 중첩은
+ * invalid HTML. 트리거 외관 커스터마이즈는 `children` 함수 패턴 또는
+ * `className` 직접 스타일링 사용.
+ */
 export const DatePickerTrigger = React.forwardRef<HTMLButtonElement, DatePickerTriggerProps>(
   function DatePickerTrigger({ className, children, onClick, ...props }, ref) {
     const ctx = useDatePickerContext("DatePickerTrigger");

package/data/registry/react/components/date-picker/index.tsx

@@ -252,8 +252,15 @@ export interface DatePickerTriggerProps
 }
 
 /**
- * 캘린더 popover를 여는 트리거 버튼. children에 함수를 넘기면 현재 값/포맷 문자열/placeholder를
- * 받아 직접 렌더할 수 있다.
+ * 캘린더 popover 를 여는 트리거 버튼. 자체로 `<button>` 을 렌더하므로 자식
+ * 으로 또 다른 button (예: 커스텀 Button) 을 넣지 말 것 — button 중첩은
+ * invalid HTML. 트리거 외관 커스터마이즈는 두 가지 방법:
+ *
+ * 1) `children` 에 함수 — 내부 텍스트만 커스터마이즈 (현재 값/포맷/placeholder 받아 직접 렌더):
+ *      <DatePickerTrigger>{({ formatted, placeholder }) => formatted ?? placeholder}</DatePickerTrigger>
+ *
+ * 2) `className` 으로 직접 스타일링 — 별도 Button 컴포넌트로 감싸지 말고
+ *    버튼 자체에 클래스 부여.
  */
 export const DatePickerTrigger = React.forwardRef<HTMLButtonElement, DatePickerTriggerProps>(
   function DatePickerTrigger({ className, children, onClick, ...props }, ref) {

package/data/registry/react/components/dialog/index.module.tsx

@@ -12,10 +12,22 @@ type WithStringClassName<T> = Omit<T, "className"> & { className?: string };
  */
 export const Dialog = BaseDialog.Root;
 
-/** Dialog를 여는 트리거. 보통 Button을 감싸 사용. */
+/**
+ * Dialog 를 여는 트리거. 자체로 `<button>` 을 렌더하므로 자식으로 또 다른
+ * button (예: 커스텀 Button) 을 넣지 말 것 — button 중첩은 invalid HTML.
+ * 다른 엘리먼트로 슬롯하려면 Base UI 의 `render` prop 사용:
+ *
+ *   <DialogTrigger render={<Button>열기</Button>} />
+ */
 export const DialogTrigger = BaseDialog.Trigger;
 
-/** 클릭 시 Dialog를 닫는 요소. footer의 취소 버튼 등에 사용. */
+/**
+ * 클릭 시 Dialog 를 닫는 요소 (예: footer 취소 버튼). 자체로 `<button>` 을
+ * 렌더하므로 자식으로 또 다른 button 을 넣지 말 것 — 커스텀 Button 슬롯은
+ * `render` prop 사용:
+ *
+ *   <DialogClose render={<Button variant='ghost'>취소</Button>} />
+ */
 export const DialogClose = BaseDialog.Close;
 
 /** 우상단에 배치되는 X 닫기 버튼. `aria-label="닫기"`가 자동 부여된다. */

package/data/registry/react/components/dialog/index.tailwind.tsx

@@ -6,7 +6,23 @@ type WithStringClassName<T> = Omit<T, "className"> & { className?: string };
 
 
 export const Dialog = BaseDialog.Root;
+
+/**
+ * Dialog 를 여는 트리거. 자체로 `<button>` 을 렌더하므로 자식으로 또 다른
+ * button (예: 커스텀 Button) 을 넣지 말 것 — button 중첩은 invalid HTML.
+ * 다른 엘리먼트로 슬롯하려면 Base UI 의 `render` prop 사용:
+ *
+ *   <DialogTrigger render={<Button>열기</Button>} />
+ */
 export const DialogTrigger = BaseDialog.Trigger;
+
+/**
+ * 클릭 시 Dialog 를 닫는 요소 (예: footer 취소 버튼). 자체로 `<button>` 을
+ * 렌더하므로 자식으로 또 다른 button 을 넣지 말 것 — 커스텀 Button 슬롯은
+ * `render` prop 사용:
+ *
+ *   <DialogClose render={<Button variant='ghost'>취소</Button>} />
+ */
 export const DialogClose = BaseDialog.Close;
 
 export function DialogCloseX({ className, children, ...props }: React.ButtonHTMLAttributes<HTMLButtonElement>) {

package/data/registry/react/components/dialog/index.tsx

@@ -12,10 +12,22 @@ type WithStringClassName<T> = Omit<T, "className"> & { className?: string };
  */
 export const Dialog = BaseDialog.Root;
 
-/** Dialog를 여는 트리거. 보통 Button을 감싸 사용. */
+/**
+ * Dialog 를 여는 트리거. 자체로 `<button>` 을 렌더하므로 자식으로 또 다른
+ * button (예: 커스텀 Button) 을 넣지 말 것 — button 중첩은 invalid HTML.
+ * 다른 엘리먼트로 슬롯하려면 Base UI 의 `render` prop 사용:
+ *
+ *   <DialogTrigger render={<Button>열기</Button>} />
+ */
 export const DialogTrigger = BaseDialog.Trigger;
 
-/** 클릭 시 Dialog를 닫는 요소. footer의 취소 버튼 등에 사용. */
+/**
+ * 클릭 시 Dialog 를 닫는 요소 (예: footer 취소 버튼). 자체로 `<button>` 을
+ * 렌더하므로 자식으로 또 다른 button 을 넣지 말 것 — 커스텀 Button 슬롯은
+ * `render` prop 사용:
+ *
+ *   <DialogClose render={<Button variant='ghost'>취소</Button>} />
+ */
 export const DialogClose = BaseDialog.Close;
 
 /** 우상단에 배치되는 X 닫기 버튼. `aria-label="닫기"`가 자동 부여된다. */

package/data/registry/react/components/dropdown-menu/index.module.tsx

@@ -14,6 +14,13 @@ export const DropdownMenu = BaseMenu.Root;
 
 /* ───────── Trigger ───────── */
 
+/**
+ * DropdownMenu 를 여는 트리거. 자체로 `<button>` 을 렌더 — 자식으로 또 다른
+ * button (예: 커스텀 Button) 을 넣지 말 것. 다른 엘리먼트로 슬롯하려면 Base
+ * UI 의 `render` prop:
+ *
+ *   <DropdownMenuTrigger render={<Button variant='ghost'>메뉴</Button>} />
+ */
 export const DropdownMenuTrigger = React.forwardRef<
   HTMLButtonElement,
   WithStringClassName<React.ComponentPropsWithoutRef<typeof BaseMenu.Trigger>>
@@ -193,6 +200,10 @@ export const DropdownMenuSeparator = React.forwardRef<
 
 export const DropdownMenuSub = BaseMenu.SubmenuRoot;
 
+/**
+ * 서브메뉴 트리거. 부모 메뉴 항목으로 동작하며 hover/우향 화살표로 서브를
+ * 연다. 다른 엘리먼트로 슬롯하려면 Base UI 의 `render` prop 사용.
+ */
 export const DropdownMenuSubTrigger = React.forwardRef<
   HTMLDivElement,
   WithStringClassName<

package/data/registry/react/components/dropdown-menu/index.tailwind.tsx

@@ -13,6 +13,13 @@ const itemCheck = "pl-7";
 
 export const DropdownMenu = BaseMenu.Root;
 
+/**
+ * DropdownMenu 를 여는 트리거. 자체로 `<button>` 을 렌더 — 자식으로 또 다른
+ * button (예: 커스텀 Button) 을 넣지 말 것. 다른 엘리먼트로 슬롯하려면 Base
+ * UI 의 `render` prop:
+ *
+ *   <DropdownMenuTrigger render={<Button variant='ghost'>메뉴</Button>} />
+ */
 export const DropdownMenuTrigger = React.forwardRef<
   HTMLButtonElement,
   WithStringClassName<React.ComponentPropsWithoutRef<typeof BaseMenu.Trigger>>
@@ -152,6 +159,10 @@ export const DropdownMenuSeparator = React.forwardRef<HTMLDivElement, React.HTML
 
 export const DropdownMenuSub = BaseMenu.SubmenuRoot;
 
+/**
+ * 서브메뉴 트리거. 부모 메뉴 항목으로 동작하며 hover/우향 화살표로 서브를
+ * 연다. 다른 엘리먼트로 슬롯하려면 Base UI 의 `render` prop 사용.
+ */
 export const DropdownMenuSubTrigger = React.forwardRef<
   HTMLDivElement,
   WithStringClassName<React.ComponentPropsWithoutRef<typeof BaseMenu.SubmenuTrigger>>

package/data/registry/react/components/dropdown-menu/index.tsx

@@ -14,6 +14,13 @@ export const DropdownMenu = BaseMenu.Root;
 
 /* ───────── Trigger ───────── */
 
+/**
+ * DropdownMenu 를 여는 트리거. 자체로 `<button>` 을 렌더 — 자식으로 또 다른
+ * button (예: 커스텀 Button) 을 넣지 말 것. 다른 엘리먼트로 슬롯하려면 Base
+ * UI 의 `render` prop:
+ *
+ *   <DropdownMenuTrigger render={<Button variant='ghost'>메뉴</Button>} />
+ */
 export const DropdownMenuTrigger = React.forwardRef<
   HTMLButtonElement,
   WithStringClassName<React.ComponentPropsWithoutRef<typeof BaseMenu.Trigger>>
@@ -193,6 +200,10 @@ export const DropdownMenuSeparator = React.forwardRef<
 
 export const DropdownMenuSub = BaseMenu.SubmenuRoot;
 
+/**
+ * 서브메뉴 트리거. 부모 메뉴 항목으로 동작하며 hover/우향 화살표로 서브를
+ * 연다. 다른 엘리먼트로 슬롯하려면 Base UI 의 `render` prop 사용.
+ */
 export const DropdownMenuSubTrigger = React.forwardRef<
   HTMLDivElement,
   WithStringClassName<

package/data/registry/react/components/popover/index.module.tsx

@@ -12,10 +12,18 @@ type WithStringClassName<T> = Omit<T, "className"> & { className?: string };
  */
 export const Popover = BasePopover.Root;
 
-/** Popover를 여는 트리거. */
+/**
+ * Popover 를 여는 트리거. 자체로 `<button>` 을 렌더 — 자식 button 중첩 금지.
+ * 커스텀 Button 등으로 슬롯하려면 `render` prop:
+ *
+ *   <PopoverTrigger render={<Button>열기</Button>} />
+ */
 export const PopoverTrigger = BasePopover.Trigger;
 
-/** Popover를 닫는 요소. */
+/**
+ * Popover 를 닫는 요소. 자체로 `<button>` — 자식 button 중첩 금지. 다른
+ * 엘리먼트 슬롯은 `render` prop.
+ */
 export const PopoverClose = BasePopover.Close;
 
 export interface PopoverContentProps

package/data/registry/react/components/popover/index.tailwind.tsx

@@ -6,7 +6,19 @@ type WithStringClassName<T> = Omit<T, "className"> & { className?: string };
 
 
 export const Popover = BasePopover.Root;
+
+/**
+ * Popover 를 여는 트리거. 자체로 `<button>` 을 렌더 — 자식 button 중첩 금지.
+ * 커스텀 Button 등으로 슬롯하려면 `render` prop:
+ *
+ *   <PopoverTrigger render={<Button>열기</Button>} />
+ */
 export const PopoverTrigger = BasePopover.Trigger;
+
+/**
+ * Popover 를 닫는 요소. 자체로 `<button>` — 자식 button 중첩 금지. 다른
+ * 엘리먼트 슬롯은 `render` prop.
+ */
 export const PopoverClose = BasePopover.Close;
 
 export interface PopoverContentProps

package/data/registry/react/components/popover/index.tsx

@@ -12,10 +12,18 @@ type WithStringClassName<T> = Omit<T, "className"> & { className?: string };
  */
 export const Popover = BasePopover.Root;
 
-/** Popover를 여는 트리거. */
+/**
+ * Popover 를 여는 트리거. 자체로 `<button>` 을 렌더 — 자식 button 중첩 금지.
+ * 커스텀 Button 등으로 슬롯하려면 `render` prop:
+ *
+ *   <PopoverTrigger render={<Button>열기</Button>} />
+ */
 export const PopoverTrigger = BasePopover.Trigger;
 
-/** Popover를 닫는 요소. */
+/**
+ * Popover 를 닫는 요소. 자체로 `<button>` — 자식 button 중첩 금지. 다른
+ * 엘리먼트 슬롯은 `render` prop.
+ */
 export const PopoverClose = BasePopover.Close;
 
 export interface PopoverContentProps

package/data/registry/react/components/select/index.module.tsx

@@ -30,6 +30,13 @@ export function SelectValue({
   );
 }
 
+/**
+ * Select 트리거. 자체로 `<button>` 을 렌더 (chevron icon 포함) — 자식으로
+ * 또 다른 button (예: 커스텀 Button) 을 넣지 말 것. 트리거를 다른 엘리먼트
+ * 로 바꾸려면 Base UI 의 `render` prop:
+ *
+ *   <SelectTrigger render={<Button variant='secondary'>{...}</Button>} />
+ */
 export const SelectTrigger = React.forwardRef<
   HTMLButtonElement,
   Omit<React.ComponentPropsWithoutRef<typeof BaseSelect.Trigger>, "className"> & { className?: string }

package/data/registry/react/components/select/index.tailwind.tsx

@@ -23,6 +23,13 @@ export function SelectValue({ placeholder, className, ...props }: { placeholder?
   );
 }
 
+/**
+ * Select 트리거. 자체로 `<button>` 을 렌더 (chevron icon 포함) — 자식으로
+ * 또 다른 button (예: 커스텀 Button) 을 넣지 말 것. 트리거를 다른 엘리먼트
+ * 로 바꾸려면 Base UI 의 `render` prop:
+ *
+ *   <SelectTrigger render={<Button variant='secondary'>{...}</Button>} />
+ */
 export const SelectTrigger = React.forwardRef<
   HTMLButtonElement,
   Omit<React.ComponentPropsWithoutRef<typeof BaseSelect.Trigger>, "className"> & { className?: string }

package/data/registry/react/components/select/index.tsx

@@ -30,6 +30,13 @@ export function SelectValue({
   );
 }
 
+/**
+ * Select 트리거. 자체로 `<button>` 을 렌더 (chevron icon 포함) — 자식으로
+ * 또 다른 button (예: 커스텀 Button) 을 넣지 말 것. 트리거를 다른 엘리먼트
+ * 로 바꾸려면 Base UI 의 `render` prop:
+ *
+ *   <SelectTrigger render={<Button variant='secondary'>{...}</Button>} />
+ */
 export const SelectTrigger = React.forwardRef<
   HTMLButtonElement,
   Omit<React.ComponentPropsWithoutRef<typeof BaseSelect.Trigger>, "className"> & { className?: string }

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/data/summaries/react.json

@@ -15,7 +15,7 @@
     "select": "네이티브 대체 셀렉트 — separate exports: Select / SelectTrigger / SelectValue / SelectContent / SelectGroup / SelectLabel / SelectItem / SelectSeparator (Base UI). MultiSelect 변형 동봉. SelectTrigger 는 그 자체로 button 이라 자식 button 중첩 금지 — 다른 엘리먼트로 바꾸려면 Base UI 의 `render` prop 사용.",
     "combobox": "검색 가능 셀렉트 — separate exports: Combobox / ComboboxTrigger / ComboboxClear / ComboboxValue / ComboboxIcon / ComboboxInput / ComboboxContent / ComboboxList / ComboboxGroup / ComboboxChips (Base UI). 자동 필터링·키보드 내비. ComboboxTrigger·ComboboxClear 는 자체로 `<button>` — 자식 button 중첩 금지, 다른 엘리먼트로 슬롯하려면 Base UI 의 `render` prop 사용.",
     "color-picker": "색상 선택 — hex/rgb, 프리셋 팔레트.",
-    "date-picker": "날짜 선택 — separate exports: DatePicker / DatePickerTrigger / DatePickerContent / DatePickerCalendar / DatePickerFooter / DateRangePicker + useDatePicker 훅 (Base UI). DatePickerTrigger 는 자체로 `<button>` — 다른 엘리먼트로 슬롯하려면 `render` prop 사용.",
+    "date-picker": "날짜 선택 — separate exports: DatePicker / DatePickerTrigger / DatePickerContent / DatePickerCalendar / DatePickerFooter / DateRangePicker + useDatePicker 훅 (Base UI). DatePickerTrigger 는 sh-ui 자체 `<button>` 이라 자식 button 중첩 금지 — 외관 커스터마이즈는 `children` 함수 패턴(현재 값/포맷/placeholder 인자) 또는 `className` 직접 스타일링 사용 (Base UI 의 `render` prop 패턴 아님).",
     "file-upload": "파일 업로드 — 드롭존, 다중 파일, 진행률.",
     "dialog": "모달 다이얼로그 — separate exports: Dialog / DialogTrigger / DialogClose / DialogContent / DialogTitle / DialogDescription / DialogFooter / DialogCloseX (Base UI, 포커스 트랩). DialogTrigger·DialogClose 는 그 자체로 button 을 렌더 — 자식으로 다른 button 을 넣으면 button 중첩(invalid HTML). 다른 엘리먼트(예: 커스텀 Button)로 슬롯하려면 Base UI 의 `render` prop 사용: `<DialogClose render={<Button>닫기</Button>} />`.",
     "popover": "floating 팝오버 — separate exports: Popover / PopoverTrigger / PopoverClose / PopoverContent / PopoverTitle / PopoverDescription (Base UI). PopoverTrigger·PopoverClose 는 자체로 `<button>` — 자식으로 button 중첩 금지, 다른 엘리먼트로 슬롯하려면 `render` prop 사용.",

package/package.json

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