sh-ui-cli 0.64.1 → 0.64.3

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.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",
+      "title": "patch — llms summary 13건 정확성 audit + Base UI render-prop 함정 일괄 명시",
+      "type": "patch",
+      "highlights": [
+        "**summary 사실관계 정정 5건** — `radio` 의 'RadioGroupItem' (실제는 `Radio + RadioGroup`), `toast` 의 'useToast 훅 + ToastProvider' (실제는 `toast()` 함수 + `<Toaster />`, sonner-style), `textarea` 의 'autoResize' (실제 prop 없음), `cn` 의 'tailwind-merge 미사용' (tailwind 변종은 사용함), `pagination` 의 dot/축약 표기. AI 가 헛 import 하던 회귀 차단.",
+        "**`render` prop 함정 일괄 명시 (6건)** — popover / tooltip / dropdown-menu / accordion / date-picker / combobox 의 Trigger·Close 가 자체로 `<button>` 을 렌더한다는 점 + 자식 button 중첩 대신 Base UI 의 `render` prop 으로 슬롯하는 패턴을 summary 에 박음. (`<PopoverClose render={<Button>닫기</Button>} />`). v0.64.1 의 dialog/select 노트와 동일 톤으로 통일.",
+        "**exports 명시 보강 (8건)** — popover / tooltip / dropdown-menu / context-menu / menubar / accordion / date-picker / combobox 의 실제 export 이름을 summary 에 펼쳐 적음. AI 가 namespace attach (`Popover.Trigger` 등) 환각으로 import 하던 문제 해소."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.64.2"
+    },
     {
       "version": "0.64.1",
       "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/react.json

@@ -5,32 +5,32 @@
     "card": "카드 컨테이너 — separate exports: Card / CardHeader / CardTitle / CardDescription / CardAction / CardContent / CardFooter. dot syntax(`Card.Header`) 아님.",
     "input": "단일 행 텍스트 입력 — hasError 지원. 같은 모듈에 NumberInput / PhoneInput / BusinessNumberInput 변형 포함. 비밀번호 토글은 InputGroup + InputAdornment 레시피로 조립.",
     "numeric-input": "슬라이더 동반·토큰 편집기용 컴팩트 숫자 입력 — onChange 즉시 min/max clamp, focus select-all, 단위(px/ms/%/° 등) suffix. 일반 폼 입력은 NumberInput 권장.",
-    "textarea": "여러 행 텍스트 입력 — rows, autoResize.",
+    "textarea": "여러 행 텍스트 입력 — rows. autoResize 같은 추가 prop 없음.",
     "label": "폼 레이블 — htmlFor로 입력과 연결.",
     "checkbox": "체크박스 — indeterminate 지원 (Base UI).",
-    "radio": "라디오 그룹 — RadioGroup + RadioGroupItem (Base UI).",
+    "radio": "라디오 그룹 — Radio (단일 선택지) + RadioGroup (컨테이너) (Base UI). `RadioGroupItem` 이름 아님. 단일 즉시 적용은 Switch, 다중은 Checkbox 권장.",
     "switch": "토글 스위치 — controlled/uncontrolled 모두 지원 (Base UI).",
     "toggle": "단일 토글 / 토글 그룹 — pressed 상태 (Base UI).",
     "slider": "수평 슬라이더 — 단일/범위 값, step.",
     "select": "네이티브 대체 셀렉트 — separate exports: Select / SelectTrigger / SelectValue / SelectContent / SelectGroup / SelectLabel / SelectItem / SelectSeparator (Base UI). MultiSelect 변형 동봉. SelectTrigger 는 그 자체로 button 이라 자식 button 중첩 금지 — 다른 엘리먼트로 바꾸려면 Base UI 의 `render` prop 사용.",
-    "combobox": "검색 가능 셀렉트 — 자동 필터링, 키보드 내비 (Base UI).",
+    "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": "날짜 선택 — 캘린더 팝업 (Base UI).",
+    "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 팝오버 — 트리거 기준 위치 (Base UI).",
-    "tooltip": "짧은 힌트 — hover/focus 표시, delay/closeDelay (Base UI).",
-    "toast": "임시 알림 — useToast 훅 + ToastProvider. aria-live 자동.",
-    "dropdown-menu": "드롭다운 메뉴 — compound, sub-menu 지원 (Base UI).",
-    "context-menu": "우클릭 컨텍스트 메뉴 — DropdownMenu와 같은 구조 (Base UI).",
-    "menubar": "수평 메뉴바 — dropdown-menu 위에 구성 (Base UI).",
+    "popover": "floating 팝오버 — separate exports: Popover / PopoverTrigger / PopoverClose / PopoverContent / PopoverTitle / PopoverDescription (Base UI). PopoverTrigger·PopoverClose 는 자체로 `<button>` — 자식으로 button 중첩 금지, 다른 엘리먼트로 슬롯하려면 `render` prop 사용.",
+    "tooltip": "짧은 힌트 — separate exports: TooltipProvider (앱 루트에 한 번 두어 delay 공유) / Tooltip / TooltipTrigger / TooltipContent (Base UI). hover/focus 표시, delay/closeDelay. TooltipTrigger 는 임의 엘리먼트를 트리거로 슬롯하는 용도라 Button 등과 결합하려면 `render` prop 사용.",
+    "toast": "임시 알림 — `toast()` 함수 호출 + `<Toaster />` 컴포넌트 (sonner-style). useToast 훅·ToastProvider 아님. aria-live 자동.",
+    "dropdown-menu": "드롭다운 메뉴 — separate exports: DropdownMenu / DropdownMenuTrigger / DropdownMenuContent / DropdownMenuItem / DropdownMenuCheckboxItem / DropdownMenuRadioGroup / DropdownMenuRadioItem / DropdownMenuGroup / DropdownMenuLabel / DropdownMenuSeparator / DropdownMenuSub / DropdownMenuSubTrigger / DropdownMenuSubContent (Base UI). DropdownMenuTrigger·SubTrigger 는 자체로 `<button>` — 자식 button 중첩 금지, 다른 엘리먼트로 슬롯하려면 `render` prop 사용.",
+    "context-menu": "우클릭 컨텍스트 메뉴 — DropdownMenu 와 동일 export 패턴 (`Context-` 접두사: ContextMenu / ContextMenuTrigger / ContextMenuContent / ContextMenuItem 등). ContextMenuTrigger 는 임의 엘리먼트를 우클릭 수신 영역으로 지정하는 용도라 자체가 button 은 아니지만, 자식 슬롯이 필요하면 `render` prop 사용.",
+    "menubar": "수평 메뉴바 — Menubar 단일 export. 내부에 DropdownMenu 들을 나란히 배치하는 컨테이너로, 좌우 화살표로 메뉴 간 이동 (Base UI).",
     "tabs": "탭 — separate exports: Tabs / TabsList / TabsTrigger / TabsContent / TabsIndicator (Base UI). dot syntax(`Tabs.List`) 아님.",
-    "accordion": "펼침/접힘 아코디언 — single/multiple (Base UI).",
+    "accordion": "펼침/접힘 아코디언 — separate exports: Accordion / AccordionItem / AccordionTrigger / AccordionContent (Base UI). single/multiple 모드. AccordionTrigger 는 자체로 `<button>` — 다른 엘리먼트로 슬롯하려면 `render` prop 사용.",
     "carousel": "슬라이드 캐러셀 — Embla 기반, autoplay/autoscroll.",
     "sidebar": "앱 사이드바 — collapsible, SidebarMenu/SidebarGroup 조합.",
     "header": "앱 헤더 — 로고/네비/액션 compound, 데스크탑 inline / 모바일 drawer 자동 전환. drawer focus trap·ESC·focus restore. HeaderNav value(controlled) / defaultValue+onValueChange(uncontrolled) 로 자식 HeaderItem active 자동 매칭 (aria-current 자동, match 커스터마이즈). HeaderMenu(서브메뉴, 데스크탑 portal dropdown / drawer collapsible) · HeaderNavGroup(섹션 라벨) · HeaderDesktopOnly/HeaderMobileOnly(가시성 토글, drawer 이동 없음). variant(solid/transparent/blur) · stickyHide(prefers-reduced-motion 존중, 컨테이너 스크롤 자동 감지) 정식 지원. backdrop-filter @supports 폴백.",
     "breadcrumb": "경로 내비게이션 — separate exports: Breadcrumb / BreadcrumbList / BreadcrumbItem / BreadcrumbLink / BreadcrumbPage / BreadcrumbSeparator / BreadcrumbEllipsis. dot syntax 아님. aria-current 자동.",
-    "pagination": "페이지 단위 내비게이션 — compound (PaginationContent/Item/Link/Previous/Next/Ellipsis). getPaginationRange 유틸 동봉. aria-current 자동.",
+    "pagination": "페이지 단위 내비게이션 — separate exports: Pagination / PaginationContent / PaginationItem / PaginationLink / PaginationPrevious / PaginationNext / PaginationEllipsis. getPaginationRange 유틸 동봉. aria-current 자동.",
     "avatar": "프로필 아바타 — 이미지 fallback → initials (Base UI).",
     "badge": "상태 뱃지 — variant, size.",
     "progress": "선형 진행률 — value 0~100, indeterminate.",
@@ -48,7 +48,7 @@
     "focus-ring": "공용 포커스 링 스타일 — focus-ring.css.",
     "z-index": "z-index 레이어 토큰 — z-index.css.",
     "animations": "공용 애니메이션 키프레임 — animations.css.",
-    "cn": "className 머지 유틸 (tailwind-merge 미사용, 순수 concat).",
+    "cn": "className 합성 헬퍼. plain 변종(`cn.ts`)은 순수 concat, tailwind 변종(`cn.tailwind.ts`)은 clsx + tailwind-merge 로 utility 충돌 자동 머지 (`cn('bg-red-500', 'bg-blue-500')` → `'bg-blue-500'`).",
     "use-media-query": "미디어 쿼리 매칭 훅.",
     "use-active-section": "스크롤 위치로 현재 섹션 감지 훅."
   }

package/package.json

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