boottent-design 0.1.274 → 0.1.276

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (274) hide show
  1. package/dist/{article-asset-card-DGa_XWK1.js → article-asset-card-F9Dj50Za.js} +45 -21
  2. package/dist/article-asset-card-c0FMg3Zo.cjs +1 -0
  3. package/dist/{boottent-event-card-BRn8qOSa.js → boottent-event-card-B3EG4IVn.js} +55 -31
  4. package/dist/boottent-event-card-aiZe0UP_.cjs +1 -0
  5. package/dist/camp-card-CFPjeQn1.cjs +1 -0
  6. package/dist/{camp-card-nUdSAdXo.js → camp-card-CmPL-PGH.js} +66 -42
  7. package/dist/{company-info-card-DJTgItPu.js → company-info-card-CiXUplZe.js} +44 -20
  8. package/dist/company-info-card-dgqjyKwP.cjs +1 -0
  9. package/dist/components/article-asset-card.cjs.js +1 -1
  10. package/dist/components/article-asset-card.es.js +1 -1
  11. package/dist/components/boottent-event-card.cjs.js +1 -1
  12. package/dist/components/boottent-event-card.es.js +1 -1
  13. package/dist/components/camp-card.cjs.js +1 -1
  14. package/dist/components/camp-card.es.js +1 -1
  15. package/dist/components/company-info-card.cjs.js +1 -1
  16. package/dist/components/company-info-card.es.js +1 -1
  17. package/dist/components/dday-card.cjs.js +1 -1
  18. package/dist/components/dday-card.es.js +1 -1
  19. package/dist/components/event-card.cjs.js +1 -1
  20. package/dist/components/event-card.es.js +1 -1
  21. package/dist/components/lecturer-card.cjs.js +1 -1
  22. package/dist/components/lecturer-card.es.js +1 -1
  23. package/dist/components/main-banner-image.cjs.js +1 -1
  24. package/dist/components/main-banner-image.es.js +1 -1
  25. package/dist/components/mobile-camp-card.cjs.js +1 -1
  26. package/dist/components/mobile-camp-card.es.js +1 -1
  27. package/dist/components/portfolio-asset-card.cjs.js +1 -1
  28. package/dist/components/portfolio-asset-card.es.js +1 -1
  29. package/dist/components/premium-card.cjs.js +1 -1
  30. package/dist/components/premium-card.es.js +1 -1
  31. package/dist/components/title-tag-card.cjs.js +1 -1
  32. package/dist/components/title-tag-card.es.js +1 -1
  33. package/dist/components/youtube-video-modal.cjs.js +1 -1
  34. package/dist/components/youtube-video-modal.es.js +1 -1
  35. package/dist/components.cjs.js +1 -1
  36. package/dist/components.es.js +13 -13
  37. package/dist/{dday-card-Bkqv7KsQ.js → dday-card-DN2Qz4Qk.js} +50 -26
  38. package/dist/dday-card-DlvwukPX.cjs +1 -0
  39. package/dist/design-system/components/article-asset-card.md +1 -1
  40. package/dist/design-system/components/article-card.md +1 -1
  41. package/dist/design-system/components/blog-review-card.md +1 -1
  42. package/dist/design-system/components/boottent-event-card.md +1 -1
  43. package/dist/design-system/components/camp-card.md +1 -1
  44. package/dist/design-system/components/company-info-card.md +1 -1
  45. package/dist/design-system/components/crew-content-card.md +1 -1
  46. package/dist/design-system/components/dday-card.md +1 -1
  47. package/dist/design-system/components/environment-asset-photo.md +1 -1
  48. package/dist/design-system/components/event-asset-banner.md +1 -1
  49. package/dist/design-system/components/event-card.md +1 -1
  50. package/dist/design-system/components/lecturer-card.md +1 -1
  51. package/dist/design-system/components/main-banner-image.md +1 -1
  52. package/dist/design-system/components/mobile-camp-card.md +1 -1
  53. package/dist/design-system/components/partner-list-card.md +1 -1
  54. package/dist/design-system/components/portfolio-asset-card.md +1 -1
  55. package/dist/design-system/components/premium-card.md +1 -1
  56. package/dist/design-system/components/question-card.md +1 -1
  57. package/dist/design-system/components/story-preview-card.md +1 -1
  58. package/dist/design-system/components/title-tag-card.md +1 -1
  59. package/dist/design-system/components/youtube-video-modal.md +1 -1
  60. package/dist/design-system/consumer-setup.md +1 -1
  61. package/dist/design-system/design-system.md +27 -2
  62. package/dist/design-system/tokens.md +1 -1
  63. package/dist/design-system/ui/accordion.md +1 -1
  64. package/dist/design-system/ui/alert-dialog.md +1 -1
  65. package/dist/design-system/ui/alert.md +62 -0
  66. package/dist/design-system/ui/anchor.md +1 -1
  67. package/dist/design-system/ui/aspect-ratio.md +1 -1
  68. package/dist/design-system/ui/avatar.md +1 -1
  69. package/dist/design-system/ui/badge.md +1 -1
  70. package/dist/design-system/ui/breadcrumb.md +56 -0
  71. package/dist/design-system/ui/button-group.md +65 -0
  72. package/dist/design-system/ui/button.md +1 -1
  73. package/dist/design-system/ui/calendar.md +1 -1
  74. package/dist/design-system/ui/callout.md +4 -1
  75. package/dist/design-system/ui/card-label.md +1 -1
  76. package/dist/design-system/ui/card.md +1 -1
  77. package/dist/design-system/ui/carousel.md +53 -0
  78. package/dist/design-system/ui/chart.md +58 -0
  79. package/dist/design-system/ui/checkbox.md +1 -1
  80. package/dist/design-system/ui/circled-check-button.md +1 -1
  81. package/dist/design-system/ui/collapsible.md +47 -0
  82. package/dist/design-system/ui/combobox.md +65 -0
  83. package/dist/design-system/ui/command.md +1 -1
  84. package/dist/design-system/ui/context-menu.md +46 -0
  85. package/dist/design-system/ui/data-table.md +68 -0
  86. package/dist/design-system/ui/date-picker.md +51 -0
  87. package/dist/design-system/ui/dialog.md +1 -1
  88. package/dist/design-system/ui/drawer.md +49 -0
  89. package/dist/design-system/ui/dropdown-menu.md +1 -1
  90. package/dist/design-system/ui/empty.md +63 -0
  91. package/dist/design-system/ui/file-uploader.md +1 -1
  92. package/dist/design-system/ui/form.md +1 -1
  93. package/dist/design-system/ui/highlight-text.md +1 -1
  94. package/dist/design-system/ui/hover-card.md +36 -0
  95. package/dist/design-system/ui/icons.md +1 -1
  96. package/dist/design-system/ui/image.md +1 -1
  97. package/dist/design-system/ui/input-group.md +66 -0
  98. package/dist/design-system/ui/input-otp.md +57 -0
  99. package/dist/design-system/ui/input.md +1 -1
  100. package/dist/design-system/ui/item.md +67 -0
  101. package/dist/design-system/ui/kbd.md +40 -0
  102. package/dist/design-system/ui/label.md +1 -1
  103. package/dist/design-system/ui/menubar.md +44 -0
  104. package/dist/design-system/ui/month-picker.md +1 -1
  105. package/dist/design-system/ui/multi-select.md +1 -1
  106. package/dist/design-system/ui/native-select.md +44 -0
  107. package/dist/design-system/ui/navigation-menu.md +1 -1
  108. package/dist/design-system/ui/pagination.md +58 -0
  109. package/dist/design-system/ui/popover.md +1 -1
  110. package/dist/design-system/ui/portal.md +1 -1
  111. package/dist/design-system/ui/progress.md +1 -1
  112. package/dist/design-system/ui/radio-group.md +1 -1
  113. package/dist/design-system/ui/resizable.md +54 -0
  114. package/dist/design-system/ui/scroll-area.md +1 -1
  115. package/dist/design-system/ui/select.md +1 -1
  116. package/dist/design-system/ui/separator.md +1 -1
  117. package/dist/design-system/ui/sheet.md +68 -0
  118. package/dist/design-system/ui/sidebar.md +101 -0
  119. package/dist/design-system/ui/simple-table.md +1 -1
  120. package/dist/design-system/ui/skeleton.md +1 -1
  121. package/dist/design-system/ui/slider.md +1 -1
  122. package/dist/design-system/ui/spinner.md +53 -0
  123. package/dist/design-system/ui/switch.md +1 -1
  124. package/dist/design-system/ui/symbols.md +1 -1
  125. package/dist/design-system/ui/table.md +48 -0
  126. package/dist/design-system/ui/tabs.md +1 -1
  127. package/dist/design-system/ui/tag.md +1 -1
  128. package/dist/design-system/ui/text.md +1 -1
  129. package/dist/design-system/ui/textarea.md +1 -1
  130. package/dist/design-system/ui/toast.md +1 -1
  131. package/dist/design-system/ui/toggle-group.md +1 -1
  132. package/dist/design-system/ui/toggle.md +1 -1
  133. package/dist/design-system/ui/tooltip.md +1 -1
  134. package/dist/design-system/usage.md +1 -1
  135. package/dist/design-system/when-to-use.md +26 -1
  136. package/dist/event-card-BUaM6jEN.cjs +1 -0
  137. package/dist/{event-card-DC0zxBA4.js → event-card-ktAq1IGX.js} +48 -24
  138. package/dist/foundation.css +7 -0
  139. package/dist/lecturer-card-BFsWx1-7.cjs +1 -0
  140. package/dist/{lecturer-card-h44ZjbBL.js → lecturer-card-CtarJjco.js} +40 -16
  141. package/dist/{main-banner-image-BYIEit_f.js → main-banner-image-BfKkmCb7.js} +36 -12
  142. package/dist/main-banner-image-CQOdwlQB.cjs +1 -0
  143. package/dist/{mobile-camp-card-1dxI-BCc.js → mobile-camp-card-CIevolL-.js} +75 -51
  144. package/dist/mobile-camp-card-CaJJoEu5.cjs +1 -0
  145. package/dist/{portfolio-asset-card-mAkXH6Qc.js → portfolio-asset-card-Byj89Rgd.js} +51 -27
  146. package/dist/portfolio-asset-card-tVPhZekK.cjs +1 -0
  147. package/dist/{premium-card-CLC7dc-g.js → premium-card-Bdl5lysX.js} +38 -14
  148. package/dist/premium-card-DX3Idzk1.cjs +1 -0
  149. package/dist/styles.css +1 -1
  150. package/dist/tailwind-preset.cjs +4 -1
  151. package/dist/title-tag-card-CAJSUTuQ.cjs +1 -0
  152. package/dist/{title-tag-card-hb6ub3gc.js → title-tag-card-Ce3URzel.js} +68 -44
  153. package/dist/types/alert.d.ts +18 -0
  154. package/dist/types/badge.d.ts +1 -1
  155. package/dist/types/breadcrumb.d.ts +23 -0
  156. package/dist/types/button-group.d.ts +22 -0
  157. package/dist/types/carousel.d.ts +42 -0
  158. package/dist/types/chart.d.ts +57 -0
  159. package/dist/types/collapsible.d.ts +10 -0
  160. package/dist/types/combobox.d.ts +27 -0
  161. package/dist/types/command.d.ts +6 -6
  162. package/dist/types/context-menu.d.ts +44 -0
  163. package/dist/types/data-table.d.ts +20 -0
  164. package/dist/types/date-picker.d.ts +16 -0
  165. package/dist/types/drawer.d.ts +34 -0
  166. package/dist/types/empty.d.ts +24 -0
  167. package/dist/types/hover-card.d.ts +10 -0
  168. package/dist/types/input-group.d.ts +39 -0
  169. package/dist/types/input-otp.d.ts +26 -0
  170. package/dist/types/item.d.ts +30 -0
  171. package/dist/types/kbd.d.ts +7 -0
  172. package/dist/types/menubar.d.ts +46 -0
  173. package/dist/types/multi-select.d.ts +2 -2
  174. package/dist/types/native-select.d.ts +7 -0
  175. package/dist/types/pagination.d.ts +23 -0
  176. package/dist/types/resizable.d.ts +23 -0
  177. package/dist/types/sheet.d.ts +40 -0
  178. package/dist/types/sidebar.d.ts +152 -0
  179. package/dist/types/spinner.d.ts +14 -0
  180. package/dist/types/table.d.ts +19 -0
  181. package/dist/types/ui/alert.d.ts +2 -0
  182. package/dist/types/ui/breadcrumb.d.ts +2 -0
  183. package/dist/types/ui/button-group.d.ts +2 -0
  184. package/dist/types/ui/carousel.d.ts +2 -0
  185. package/dist/types/ui/chart.d.ts +2 -0
  186. package/dist/types/ui/collapsible.d.ts +2 -0
  187. package/dist/types/ui/combobox.d.ts +2 -0
  188. package/dist/types/ui/context-menu.d.ts +2 -0
  189. package/dist/types/ui/data-table.d.ts +2 -0
  190. package/dist/types/ui/date-picker.d.ts +2 -0
  191. package/dist/types/ui/drawer.d.ts +2 -0
  192. package/dist/types/ui/empty.d.ts +2 -0
  193. package/dist/types/ui/hover-card.d.ts +2 -0
  194. package/dist/types/ui/input-group.d.ts +2 -0
  195. package/dist/types/ui/input-otp.d.ts +2 -0
  196. package/dist/types/ui/item.d.ts +2 -0
  197. package/dist/types/ui/kbd.d.ts +2 -0
  198. package/dist/types/ui/menubar.d.ts +2 -0
  199. package/dist/types/ui/native-select.d.ts +2 -0
  200. package/dist/types/ui/pagination.d.ts +2 -0
  201. package/dist/types/ui/resizable.d.ts +2 -0
  202. package/dist/types/ui/sheet.d.ts +2 -0
  203. package/dist/types/ui/sidebar.d.ts +2 -0
  204. package/dist/types/ui/spinner.d.ts +2 -0
  205. package/dist/types/ui/table.d.ts +2 -0
  206. package/dist/types/ui.d.ts +521 -9
  207. package/dist/ui/alert.cjs.js +1 -0
  208. package/dist/ui/alert.es.js +34 -0
  209. package/dist/ui/breadcrumb.cjs.js +1 -0
  210. package/dist/ui/breadcrumb.es.js +84 -0
  211. package/dist/ui/button-group.cjs.js +1 -0
  212. package/dist/ui/button-group.es.js +49 -0
  213. package/dist/ui/carousel.cjs.js +1 -0
  214. package/dist/ui/carousel.es.js +165 -0
  215. package/dist/ui/chart.cjs.js +7 -0
  216. package/dist/ui/chart.es.js +189 -0
  217. package/dist/ui/collapsible.cjs.js +1 -0
  218. package/dist/ui/collapsible.es.js +22 -0
  219. package/dist/ui/combobox.cjs.js +1 -0
  220. package/dist/ui/combobox.es.js +69 -0
  221. package/dist/ui/context-menu.cjs.js +1 -0
  222. package/dist/ui/context-menu.es.js +129 -0
  223. package/dist/ui/data-table.cjs.js +1 -0
  224. package/dist/ui/data-table.es.js +96 -0
  225. package/dist/ui/date-picker.cjs.js +1 -0
  226. package/dist/ui/date-picker.es.js +46 -0
  227. package/dist/ui/drawer.cjs.js +1 -0
  228. package/dist/ui/drawer.es.js +70 -0
  229. package/dist/ui/empty.cjs.js +1 -0
  230. package/dist/ui/empty.es.js +54 -0
  231. package/dist/ui/hover-card.cjs.js +1 -0
  232. package/dist/ui/hover-card.es.js +24 -0
  233. package/dist/ui/input-group.cjs.js +1 -0
  234. package/dist/ui/input-group.es.js +113 -0
  235. package/dist/ui/input-otp.cjs.js +1 -0
  236. package/dist/ui/input-otp.es.js +55 -0
  237. package/dist/ui/item.cjs.js +1 -0
  238. package/dist/ui/item.es.js +85 -0
  239. package/dist/ui/kbd.cjs.js +1 -0
  240. package/dist/ui/kbd.es.js +24 -0
  241. package/dist/ui/menubar.cjs.js +1 -0
  242. package/dist/ui/menubar.es.js +151 -0
  243. package/dist/ui/native-select.cjs.js +1 -0
  244. package/dist/ui/native-select.es.js +33 -0
  245. package/dist/ui/pagination.cjs.js +1 -0
  246. package/dist/ui/pagination.es.js +108 -0
  247. package/dist/ui/resizable.cjs.js +1 -0
  248. package/dist/ui/resizable.es.js +32 -0
  249. package/dist/ui/sheet.cjs.js +1 -0
  250. package/dist/ui/sheet.es.js +68 -0
  251. package/dist/ui/sidebar.cjs.js +1 -0
  252. package/dist/ui/sidebar.es.js +504 -0
  253. package/dist/ui/spinner.cjs.js +1 -0
  254. package/dist/ui/spinner.es.js +37 -0
  255. package/dist/ui/table.cjs.js +1 -0
  256. package/dist/ui/table.es.js +63 -0
  257. package/dist/ui.cjs.js +1 -1
  258. package/dist/ui.es.js +350 -191
  259. package/dist/youtube-video-modal-D_5yKyG7.cjs +1 -0
  260. package/dist/{youtube-video-modal-CAy1hYoA.js → youtube-video-modal-OJGn-yRE.js} +37 -13
  261. package/package.json +11 -3
  262. package/dist/article-asset-card-DRRl2BH8.cjs +0 -1
  263. package/dist/boottent-event-card-Bx4iFf2w.cjs +0 -1
  264. package/dist/camp-card-DM2V71SW.cjs +0 -1
  265. package/dist/company-info-card-BXAempVI.cjs +0 -1
  266. package/dist/dday-card-D5SqIn0Y.cjs +0 -1
  267. package/dist/event-card-D3wzSDI2.cjs +0 -1
  268. package/dist/lecturer-card-C0AeVE2l.cjs +0 -1
  269. package/dist/main-banner-image-By44s_XP.cjs +0 -1
  270. package/dist/mobile-camp-card-D-5N6bex.cjs +0 -1
  271. package/dist/portfolio-asset-card-8mBpumTp.cjs +0 -1
  272. package/dist/premium-card-CThRJYXd.cjs +0 -1
  273. package/dist/title-tag-card-C-AvnXtC.cjs +0 -1
  274. package/dist/youtube-video-modal-C2GWcF5u.cjs +0 -1
@@ -0,0 +1,58 @@
1
+ # ui/chart.md — boottent-design
2
+
3
+ > [!WARNING]
4
+ > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
+ > UI 프리미티브 — chart.
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
+
8
+ [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
+
10
+ ## chart
11
+
12
+ > recharts 위에 얇게 얹는 차트 프리미티브입니다. `ChartContainer`가 반응형 컨테이너(`ResponsiveContainer`)와
13
+ 색상 컨텍스트(`ChartConfig` → 스코프드 CSS 변수)를 제공하고, 실제 `<BarChart>`/`<LineChart>`/`<AreaChart>` 등은
14
+ recharts에서 그대로 가져와 children으로 조합합니다. recharts를 감싸 숨기지 않으므로 recharts의 모든 기능을 그대로 쓸 수 있습니다.
15
+
16
+ ### ✅ 언제 사용
17
+ - 캠프 신청자 수, 조회수, 매출 등 시계열·카테고리 지표를 막대/선/영역 그래프로 시각화할 때
18
+ - 여러 데이터 시리즈에 동일한 툴팁·범례 UX(색상 인디케이터, 라벨 매핑, 포맷팅)를 일관되게 적용하고 싶을 때
19
+
20
+ ### 🚫 주의
21
+ - `<BarChart>`, `<LineChart>` 등 실제 차트 타입은 이 패키지가 아니라 `recharts`에서 직접 임포트해 `ChartContainer`의
22
+ - children으로 구성하세요. `ChartContainer` 자체는 차트 종류를 알지 못하는 chart-type-agnostic 래퍼입니다.
23
+ - 시리즈 색상은 `config[key].color`(또는 다크모드까지 구분하는 `theme.light`/`theme.dark`)로 지정하고, recharts 쪽
24
+ - `fill`/`stroke`는 `var(--color-<key>)`로 참조하세요. `--chart-1` ~ `--chart-5`는 이 패키지의 main/blue/green/orange/grey
25
+ - 토큰에서 파생된 기본 브랜드 팔레트이며 `src/index.css`(전역)와 `src/foundation.css`(Tailwind 통합 모드)에 정의돼 있습니다.
26
+
27
+ ### Import
28
+ ```tsx
29
+ import { /* ... */ } from "boottent-design/ui/chart";
30
+ ```
31
+
32
+ ### Props
33
+ ```typescript
34
+ type ChartContextProps = {
35
+ config: ChartConfig;
36
+ }
37
+ ```
38
+
39
+ ### 예시
40
+ ```tsx
41
+ import { Bar, BarChart, CartesianGrid, XAxis } from "recharts";
42
+ import { ChartContainer, ChartTooltip, ChartTooltipContent, type ChartConfig } from "boottent-design/ui/chart";
43
+ const chartConfig = {
44
+ applicants: { label: "신청자 수", color: "var(--chart-1)" },
45
+ } satisfies ChartConfig;
46
+ <ChartContainer config={chartConfig} className="h-[300px] w-full">
47
+ <BarChart data={data}>
48
+ <CartesianGrid vertical={false} />
49
+ <XAxis dataKey="month" tickLine={false} axisLine={false} />
50
+ <ChartTooltip content={<ChartTooltipContent />} />
51
+ <Bar dataKey="applicants" fill="var(--color-applicants)" radius={4} />
52
+ </BarChart>
53
+ </ChartContainer>
54
+ ```
55
+
56
+ ### 🔗 관련 · 대안
57
+ - Card
58
+
@@ -3,7 +3,7 @@
3
3
  > [!WARNING]
4
4
  > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
5
  > UI 프리미티브 — checkbox.
6
- > 버전: boottent-design v0.1.274 · 생성: 2026. 7. 27. 오전 11:13:49
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
7
 
8
8
  [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
9
 
@@ -3,7 +3,7 @@
3
3
  > [!WARNING]
4
4
  > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
5
  > UI 프리미티브 — circled-check-button.
6
- > 버전: boottent-design v0.1.274 · 생성: 2026. 7. 27. 오전 11:13:49
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
7
 
8
8
  [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
9
 
@@ -0,0 +1,47 @@
1
+ # ui/collapsible.md — boottent-design
2
+
3
+ > [!WARNING]
4
+ > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
+ > UI 프리미티브 — collapsible.
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
+
8
+ [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
+
10
+ ## collapsible
11
+
12
+ > 단일 콘텐츠 영역을 펼치고 접을 수 있는 독립형(standalone) 토글 컴포넌트입니다.
13
+
14
+ ### ✅ 언제 사용
15
+ - "더보기" / "접기"로 목록이나 텍스트의 나머지 부분을 노출할 때
16
+ - 폼의 고급 옵션(advanced options) 섹션을 기본적으로 숨겨둘 때
17
+ - 여러 섹션을 그룹으로 관리할 필요 없이, 하나의 영역만 펼치고 접으면 되는 UI일 때
18
+
19
+ ### 🚫 주의
20
+ - 여러 섹션을 묶어 하나씩만(또는 여러 개) 열리게 관리해야 한다면 Accordion을 사용하세요. Collapsible은 상호 배타적 관리 기능이 없는, 독립된 단일 토글입니다.
21
+ - 트리거에는 현재 열림/닫힘 상태를 시각적으로 알려주는 아이콘 변화나 텍스트 변화가 필요합니다.
22
+
23
+ ### Import
24
+ ```tsx
25
+ import { /* ... */ } from "boottent-design/ui/collapsible";
26
+ ```
27
+
28
+ ### 예시
29
+ ```tsx
30
+ <Collapsible>
31
+ <div className="flex items-center justify-between">
32
+ <span className="text-sm font-semibold">최근 항목 3개</span>
33
+ <CollapsibleTrigger asChild>
34
+ <Button variant="outline" size="sm" theme="secondary">
35
+ 더보기
36
+ </Button>
37
+ </CollapsibleTrigger>
38
+ </div>
39
+ <CollapsibleContent>
40
+ <p>펼쳐지는 추가 콘텐츠입니다.</p>
41
+ </CollapsibleContent>
42
+ </Collapsible>
43
+ ```
44
+
45
+ ### 🔗 관련 · 대안
46
+ - Accordion
47
+
@@ -0,0 +1,65 @@
1
+ # ui/combobox.md — boottent-design
2
+
3
+ > [!WARNING]
4
+ > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
+ > UI 프리미티브 — combobox.
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
+
8
+ [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
+
10
+ ## combobox
11
+
12
+ > Popover와 Command를 조합해 검색 가능한 목록에서 값 하나를 선택하는 콤보박스 컴포넌트입니다.
13
+
14
+ ### ✅ 언제 사용
15
+ - 옵션 개수가 많아 검색/필터링이 필요한 단일 선택 드롭다운을 구현할 때
16
+ - 국가, 카테고리, 관심 분야 등 긴 목록에서 값을 빠르게 찾아 선택해야 할 때
17
+
18
+ ### 🚫 주의
19
+ - 옵션이 적고(5개 미만) 검색이 필요 없다면 `Select`가 더 가볍고 적합합니다.
20
+ - `options`는 화면 표시용 데이터(`{ value, label }`)만 받습니다 — 서비스 도메인 객체를 그대로 넘기지 마세요.
21
+
22
+ ### Import
23
+ ```tsx
24
+ import { /* ... */ } from "boottent-design/ui/combobox";
25
+ ```
26
+
27
+ ### Props
28
+ ```typescript
29
+ export interface ComboboxProps {
30
+ /** 선택 가능한 옵션 목록. 화면 표시용 프리미티브 데이터만 전달하세요. */
31
+ options: ComboboxOption[];
32
+ /** 현재 선택된 옵션의 value (제어 컴포넌트). */
33
+ value?: string;
34
+ /** 선택이 바뀔 때 호출됩니다. 이미 선택된 항목을 다시 클릭하면 선택 해제(`""`)됩니다. */
35
+ onValueChange?: (value: string) => void;
36
+ /** 아무 값도 선택되지 않았을 때 트리거 버튼에 보여줄 텍스트. */
37
+ placeholder?: string;
38
+ /** Command 입력창의 placeholder 텍스트. */
39
+ searchPlaceholder?: string;
40
+ /** 검색 결과가 없을 때 보여줄 텍스트. */
41
+ emptyText?: string;
42
+ className?: string;
43
+ disabled?: boolean;
44
+ }
45
+ ```
46
+
47
+ ### 예시
48
+ ```tsx
49
+ const [value, setValue] = React.useState("");
50
+ <Combobox
51
+ options={[
52
+ { value: "frontend", label: "프론트엔드" },
53
+ { value: "backend", label: "백엔드" },
54
+ ]}
55
+ value={value}
56
+ onValueChange={setValue}
57
+ placeholder="관심 분야 선택..."
58
+ />
59
+ ```
60
+
61
+ ### 🔗 관련 · 대안
62
+ - Select
63
+ - Command
64
+ - Popover
65
+
@@ -3,7 +3,7 @@
3
3
  > [!WARNING]
4
4
  > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
5
  > UI 프리미티브 — command.
6
- > 버전: boottent-design v0.1.274 · 생성: 2026. 7. 27. 오전 11:13:49
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
7
 
8
8
  [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
9
 
@@ -0,0 +1,46 @@
1
+ # ui/context-menu.md — boottent-design
2
+
3
+ > [!WARNING]
4
+ > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
+ > UI 프리미티브 — context-menu.
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
+
8
+ [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
+
10
+ ## context-menu
11
+
12
+ > 마우스 우클릭(또는 롱프레스) 시 커서 위치를 기준으로 나타나는 컨텍스트 메뉴 컴포넌트입니다.
13
+
14
+ ### ✅ 언제 사용
15
+ - 파일, 카드, 테이블 행 등을 우클릭했을 때 복사/수정/삭제 같은 컨텍스트 액션을 제공할 때
16
+ - 데스크톱 애플리케이션과 유사한 우클릭 기반 단축 메뉴를 구성할 때
17
+ - 트리거 요소 없이 커서 위치에 따라 유동적으로 나타나야 하는 메뉴가 필요할 때
18
+
19
+ ### 🚫 주의
20
+ - 모바일/터치 환경에는 우클릭 이벤트가 없으므로, 해당 환경에서는 별도의 진입 지점(길게 누르기, 더보기 버튼 등)을 함께 고려하세요.
21
+ - 트리거로 감싼 영역 전체가 컨텍스트 메뉴 대상이 되므로, 브라우저 기본 컨텍스트 메뉴가 필요한 텍스트/이미지 영역과 겹치지 않도록 주의하세요.
22
+
23
+ ### Import
24
+ ```tsx
25
+ import { /* ... */ } from "boottent-design/ui/context-menu";
26
+ ```
27
+
28
+ ### 예시
29
+ ```tsx
30
+ <ContextMenu>
31
+ <ContextMenuTrigger className="flex h-32 items-center justify-center rounded-md border border-dashed">
32
+ 이 영역을 우클릭하세요
33
+ </ContextMenuTrigger>
34
+ <ContextMenuContent>
35
+ <ContextMenuItem>복사</ContextMenuItem>
36
+ <ContextMenuItem>붙여넣기</ContextMenuItem>
37
+ <ContextMenuSeparator />
38
+ <ContextMenuItem>삭제</ContextMenuItem>
39
+ </ContextMenuContent>
40
+ </ContextMenu>
41
+ ```
42
+
43
+ ### 🔗 관련 · 대안
44
+ - DropdownMenu
45
+ - Popover
46
+
@@ -0,0 +1,68 @@
1
+ # ui/data-table.md — boottent-design
2
+
3
+ > [!WARNING]
4
+ > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
+ > UI 프리미티브 — data-table.
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
+
8
+ [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
+
10
+ ## data-table
11
+
12
+ > `
13
+
14
+ ### ✅ 언제 사용
15
+ - 신청자 목록, 주문 내역 등 여러 행/열로 구성된 데이터셋을 표 형태로 보여줄 때
16
+ - 특정 컬럼 기준 정렬이나 검색어 기반 필터링이 필요한 목록 화면에서
17
+ - 한 화면에 다 보여주기엔 많은 행을 페이지 단위로 나눠 보여줄 때
18
+
19
+ ### 🚫 주의
20
+ - 단순 라벨:값 요약 정보를 보여줄 때는 SimpleTable을 사용하세요. DataTable은 여러 행/열의 데이터셋에 적합합니다.
21
+ - `data`/`columns`는 소비자가 직접 준비한 순수 표시용 객체여야 합니다. 도메인 객체나 DTO를 그대로 넘기지 말고,
22
+ - 소비자 측에서 표시에 필요한 값만 매핑한 뒤 전달하세요.
23
+ - 서버사이드 페이지네이션/정렬/필터링은 지원하지 않습니다(모두 클라이언트 사이드로 동작).
24
+
25
+ ### Import
26
+ ```tsx
27
+ import { /* ... */ } from "boottent-design/ui/data-table";
28
+ ```
29
+
30
+ ### Props
31
+ ```typescript
32
+ export interface DataTableProps<TData, TValue> {
33
+ /** 컬럼 정의(`@tanstack/react-table`의 `ColumnDef`). 정렬을 켜려면 `enableSorting: true`를 지정하세요. */
34
+ columns: ColumnDef<TData, TValue>[];
35
+ /** 렌더링할 행 데이터. 순수 표시용 객체 배열이어야 합니다(도메인 객체/DTO 금지). */
36
+ data: TData[];
37
+ /** 지정 시 테이블 상단에 필터 Input을 렌더링하고, 이 컬럼 값을 기준으로 검색합니다. */
38
+ searchKey?: string;
39
+ /** 필터 Input의 placeholder 문구. */
40
+ searchPlaceholder?: string;
41
+ /** 페이지당 행 수(내장 페이지네이션 기준값). 기본값 10. */
42
+ pageSize?: number;
43
+ className?: string;
44
+ }
45
+ ```
46
+
47
+ ### 예시
48
+ ```tsx
49
+ type Applicant = { name: string; email: string; status: string; appliedAt: string };
50
+ const columns: ColumnDef<Applicant>[] = [
51
+ { accessorKey: "name", header: "이름", enableSorting: true },
52
+ { accessorKey: "email", header: "이메일" },
53
+ { accessorKey: "status", header: "상태" },
54
+ { accessorKey: "appliedAt", header: "신청일", enableSorting: true },
55
+ ];
56
+ <DataTable
57
+ columns={columns}
58
+ data={applicants}
59
+ searchKey="name"
60
+ searchPlaceholder="이름으로 검색"
61
+ pageSize={5}
62
+ />
63
+ ```
64
+
65
+ ### 🔗 관련 · 대안
66
+ - Table
67
+ - SimpleTable
68
+
@@ -0,0 +1,51 @@
1
+ # ui/date-picker.md — boottent-design
2
+
3
+ > [!WARNING]
4
+ > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
+ > UI 프리미티브 — date-picker.
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
+
8
+ [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
+
10
+ ## date-picker
11
+
12
+ > Popover와 Calendar를 조합해 트리거 버튼 클릭으로 단일 날짜를 선택하는 데이트 피커 컴포넌트입니다.
13
+
14
+ ### ✅ 언제 사용
15
+ - 예약일, 마감일 등 하나의 특정 날짜를 입력받아야 할 때
16
+ - 폼에서 캘린더 UI로 날짜를 시각적으로 선택하게 하고 싶을 때
17
+
18
+ ### 🚫 주의
19
+ - '연-월' 단위만 필요하다면 `MonthPicker`를 사용하세요 — 이 컴포넌트는 일(day) 단위까지 포함한 전체 날짜 선택용입니다.
20
+ - 기간(범위) 선택은 지원하지 않습니다 — 단일 날짜 선택에 한정됩니다.
21
+
22
+ ### Import
23
+ ```tsx
24
+ import { /* ... */ } from "boottent-design/ui/date-picker";
25
+ ```
26
+
27
+ ### Props
28
+ ```typescript
29
+ export interface DatePickerProps {
30
+ /** 현재 선택된 날짜 (제어 컴포넌트). */
31
+ date?: Date;
32
+ /** 날짜 선택이 바뀔 때 호출됩니다. Calendar에서 선택 해제 시 `undefined`가 전달될 수 있습니다. */
33
+ onSelect?: (date: Date | undefined) => void;
34
+ /** 아무 날짜도 선택되지 않았을 때 트리거 버튼에 보여줄 텍스트. */
35
+ placeholder?: string;
36
+ className?: string;
37
+ disabled?: boolean;
38
+ }
39
+ ```
40
+
41
+ ### 예시
42
+ ```tsx
43
+ const [date, setDate] = React.useState<Date | undefined>();
44
+ <DatePicker date={date} onSelect={setDate} placeholder="날짜 선택..." />
45
+ ```
46
+
47
+ ### 🔗 관련 · 대안
48
+ - Calendar
49
+ - Popover
50
+ - MonthPicker
51
+
@@ -3,7 +3,7 @@
3
3
  > [!WARNING]
4
4
  > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
5
  > UI 프리미티브 — dialog.
6
- > 버전: boottent-design v0.1.274 · 생성: 2026. 7. 27. 오전 11:13:49
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
7
 
8
8
  [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
9
 
@@ -0,0 +1,49 @@
1
+ # ui/drawer.md — boottent-design
2
+
3
+ > [!WARNING]
4
+ > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
+ > UI 프리미티브 — drawer.
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
+
8
+ [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
+
10
+ ## drawer
11
+
12
+ > 화면 가장자리에서 스와이프(swipe)로 열고 닫는 드래그형 패널 컴포넌트입니다. `vaul` 기반으로 드래그하여 닫기(drag-to-dismiss), 배경 스케일 축소 효과 등 네이티브 모바일 제스처를 제공합니다.
13
+
14
+ ### ✅ 언제 사용
15
+ - 모바일에서 바텀 시트(bottom sheet) 형태의 액션 목록이나 상세 옵션을 보여줄 때
16
+ - 손가락으로 끌어서 닫는 제스처가 자연스러운 흐름일 때
17
+ - 배경이 살짝 축소되는 네이티브 앱과 유사한 인터랙션이 필요할 때
18
+
19
+ ### 🚫 주의
20
+ - `Sheet`/`Dialog`는 Radix 기반의 고정된 슬라이드 패널이고, `Drawer`는 vaul 기반의 스와이프 가능한 패널입니다. 제스처 기반 상호작용이 필요 없다면 `Sheet`를 사용하세요.
21
+ - `direction` prop으로 top/right/bottom/left를 지정할 수 있지만, 상단 드래그 핸들 바는 기본값인 `bottom` 방향에서만 표시됩니다.
22
+ - 드로어가 열렸을 때 백그라운드 스크롤이 차단되는지 확인하세요.
23
+
24
+ ### Import
25
+ ```tsx
26
+ import { /* ... */ } from "boottent-design/ui/drawer";
27
+ ```
28
+
29
+ ### 예시
30
+ ```tsx
31
+ // 기본 바텀 시트
32
+ <Drawer>
33
+ <DrawerTrigger asChild><Button>드로어 열기</Button></DrawerTrigger>
34
+ <DrawerContent>
35
+ <DrawerHeader>
36
+ <DrawerTitle>제목</DrawerTitle>
37
+ <DrawerDescription>내용 설명입니다.</DrawerDescription>
38
+ </DrawerHeader>
39
+ <DrawerFooter><Button>확인</Button></DrawerFooter>
40
+ </DrawerContent>
41
+ </Drawer>
42
+ // 방향 지정 (top / right / bottom / left)
43
+ <Drawer direction="right">...</Drawer>
44
+ ```
45
+
46
+ ### 🔗 관련 · 대안
47
+ - Sheet
48
+ - Dialog
49
+
@@ -3,7 +3,7 @@
3
3
  > [!WARNING]
4
4
  > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
5
  > UI 프리미티브 — dropdown-menu.
6
- > 버전: boottent-design v0.1.274 · 생성: 2026. 7. 27. 오전 11:13:49
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
7
 
8
8
  [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
9
 
@@ -0,0 +1,63 @@
1
+ # ui/empty.md — boottent-design
2
+
3
+ > [!WARNING]
4
+ > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
+ > UI 프리미티브 — empty.
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
+
8
+ [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
+
10
+ ## empty
11
+
12
+ > 검색 결과, 리스트, 장바구니 등 화면에 표시할 데이터가 없는 상태를 안내하는 빈 상태(empty state) 컴포넌트입니다.
13
+
14
+ ### ✅ 언제 사용
15
+ - 검색 결과 없음을 안내할 때
16
+ - 리스트/테이블에 표시할 데이터가 없을 때
17
+ - 빈 장바구니, 빈 알림함 등 초기 상태를 안내할 때
18
+
19
+ ### 🚫 주의
20
+ - 이 컴포넌트는 표현(presentational)에만 머무릅니다. 데이터 조회, 라우팅 로직을 내장하지 마세요.
21
+ - 액션이 필요하면 EmptyContent 안에 소비자가 직접 Button 등을 배치해서 사용하세요.
22
+
23
+ ### Import
24
+ ```tsx
25
+ import { /* ... */ } from "boottent-design/ui/empty";
26
+ ```
27
+
28
+ ### Props
29
+ ```typescript
30
+ export interface EmptyMediaProps
31
+ extends React.HTMLAttributes<HTMLDivElement>,
32
+ VariantProps<typeof emptyMediaVariants> {}
33
+ ```
34
+
35
+ ### Variants
36
+ ```javascript
37
+ {
38
+ variant: {
39
+ default: "bg-transparent text-foreground",
40
+ icon: "h-12 w-12 rounded-full border border-muted-border bg-muted text-muted-foreground",
41
+ },
42
+ }
43
+ ```
44
+
45
+ ### 예시
46
+ ```tsx
47
+ <Empty>
48
+ <EmptyHeader>
49
+ <EmptyMedia variant="icon">
50
+ <Inbox />
51
+ </EmptyMedia>
52
+ <EmptyTitle>검색 결과가 없어요</EmptyTitle>
53
+ <EmptyDescription>다른 검색어로 다시 시도해보세요.</EmptyDescription>
54
+ </EmptyHeader>
55
+ <EmptyContent>
56
+ <Button size="sm">전체 목록 보기</Button>
57
+ </EmptyContent>
58
+ </Empty>
59
+ ```
60
+
61
+ ### 🔗 관련 · 대안
62
+ - Callout
63
+
@@ -3,7 +3,7 @@
3
3
  > [!WARNING]
4
4
  > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
5
  > UI 프리미티브 — file-uploader.
6
- > 버전: boottent-design v0.1.274 · 생성: 2026. 7. 27. 오전 11:13:49
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
7
 
8
8
  [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
9
 
@@ -3,7 +3,7 @@
3
3
  > [!WARNING]
4
4
  > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
5
  > UI 프리미티브 — form.
6
- > 버전: boottent-design v0.1.274 · 생성: 2026. 7. 27. 오전 11:13:49
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
7
 
8
8
  [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
9
 
@@ -3,7 +3,7 @@
3
3
  > [!WARNING]
4
4
  > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
5
  > UI 프리미티브 — highlight-text.
6
- > 버전: boottent-design v0.1.274 · 생성: 2026. 7. 27. 오전 11:13:49
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
7
 
8
8
  [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
9
 
@@ -0,0 +1,36 @@
1
+ # ui/hover-card.md — boottent-design
2
+
3
+ > [!WARNING]
4
+ > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
+ > UI 프리미티브 — hover-card.
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
+
8
+ [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
+
10
+ ## hover-card
11
+
12
+ > 링크나 요소에 마우스를 올렸을 때, 짧은 지연 후 관련 콘텐츠를 미리 보여주는 컴포넌트입니다.
13
+
14
+ ### ✅ 언제 사용
15
+ - 사용자명·아이디 링크에 호버 시 프로필 사진·소개 등 요약 카드를 보여줄 때
16
+ - 클릭해서 이동하지 않고도 링크 뒤의 콘텐츠를 빠르게 미리 확인시켜주고 싶을 때
17
+
18
+ ### 🚫 주의
19
+ - 터치 전용(모바일) 환경에서는 호버 이벤트가 발생하지 않으므로, 모바일에서도 필요한 정보라면 대체 인터랙션을 함께 고려하세요.
20
+ - `openDelay`/`closeDelay` prop으로 노출·해제 타이밍을 조절할 수 있습니다.
21
+
22
+ ### Import
23
+ ```tsx
24
+ import { /* ... */ } from "boottent-design/ui/hover-card";
25
+ ```
26
+
27
+ ### 예시
28
+ ```tsx
29
+ <HoverCard>
30
+ <HoverCardTrigger asChild>
31
+ <Anchor href="/users/kody">
32
+
33
+ ### 🔗 관련 · 대안
34
+ - Tooltip (Tooltip은 짧은 텍스트 라벨을 보여주는 용도이고, HoverCard는 프로필 카드처럼 더 풍부한 미리보기 콘텐츠를 보여주는 용도입니다)
35
+ - Popover
36
+
@@ -3,7 +3,7 @@
3
3
  > [!WARNING]
4
4
  > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
5
  > UI 프리미티브 — icons.
6
- > 버전: boottent-design v0.1.274 · 생성: 2026. 7. 27. 오전 11:13:49
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
7
 
8
8
  [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
9
 
@@ -3,7 +3,7 @@
3
3
  > [!WARNING]
4
4
  > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
5
  > UI 프리미티브 — image.
6
- > 버전: boottent-design v0.1.274 · 생성: 2026. 7. 27. 오전 11:13:49
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
7
 
8
8
  [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
9
 
@@ -0,0 +1,66 @@
1
+ # ui/input-group.md — boottent-design
2
+
3
+ > [!WARNING]
4
+ > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
5
+ > UI 프리미티브 — input-group.
6
+ > 버전: boottent-design v0.1.276 · 생성: 2026. 8. 5. 오후 6:55:02
7
+
8
+ [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
9
+
10
+ ## input-group
11
+
12
+ > 아이콘, 텍스트, 버튼 등의 부가 요소(addon)를 입력창과 하나의 테두리 안에 결합해 보여주는 입력 그룹 컴포넌트입니다.
13
+
14
+ ### ✅ 언제 사용
15
+ - 검색창처럼 입력창 앞에 아이콘을 붙여야 할 때
16
+ - 입력값 지우기, 검색 실행처럼 입력창 안쪽에 버튼을 붙여야 할 때
17
+ - 금액 입력 뒤에 "원", "%" 같은 단위를 붙여야 할 때
18
+
19
+ ### 🚫 주의
20
+ - `InputGroupInput`은 테두리가 없는 상태로 그룹 안에 들어가도록 설계되어 있습니다. 단독으로 쓸 때는 `Input` 컴포넌트를 사용하세요.
21
+ - `InputGroupAddon`은 반드시 `InputGroup`의 자식으로 배치해야 정렬(align)과 포커스 위임이 올바르게 동작합니다.
22
+
23
+ ### Import
24
+ ```tsx
25
+ import { /* ... */ } from "boottent-design/ui/input-group";
26
+ ```
27
+
28
+ ### Props
29
+ ```typescript
30
+ export interface InputGroupAddonProps
31
+ extends React.HTMLAttributes<HTMLDivElement>,
32
+ VariantProps<typeof inputGroupAddonVariants> {}
33
+ ```
34
+
35
+ ### Variants
36
+ ```javascript
37
+ {
38
+ align: {
39
+ "inline-start": "order-first pl-3 md:pl-4",
40
+ "inline-end": "order-last pr-3 md:pr-4",
41
+ },
42
+ }
43
+ ```
44
+
45
+ ### 예시
46
+ ```tsx
47
+ // 검색 아이콘이 붙은 입력창
48
+ <InputGroup>
49
+ <InputGroupAddon align="inline-start">
50
+ <Search className="size-4" />
51
+ </InputGroupAddon>
52
+ <InputGroupInput placeholder="검색어를 입력하세요" />
53
+ </InputGroup>
54
+ // 단위 텍스트가 붙은 입력창
55
+ <InputGroup>
56
+ <InputGroupInput placeholder="10000" />
57
+ <InputGroupAddon align="inline-end">
58
+ <InputGroupText>원</InputGroupText>
59
+ </InputGroupAddon>
60
+ </InputGroup>
61
+ ```
62
+
63
+ ### 🔗 관련 · 대안
64
+ - Input
65
+ - Button
66
+