@chotot/clad-ui 3.0.0-next.3 → 3.0.0-next.4

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 (541) hide show
  1. package/CHANGELOG.md +675 -0
  2. package/README.md +156 -156
  3. package/dist/brand/ChototLogoText.d.ts +5 -0
  4. package/dist/brand/CtC2C.d.ts +5 -0
  5. package/dist/brand/CtProperty.d.ts +5 -0
  6. package/dist/brand/CtVehicle.d.ts +5 -0
  7. package/dist/brand/Tot.d.ts +5 -0
  8. package/dist/brand/index.d.ts +5 -0
  9. package/dist/chunk-Bmb41Sf3.cjs +1 -0
  10. package/dist/clad-ui.cjs +2 -0
  11. package/dist/clad-ui.d.ts +2 -0
  12. package/dist/clad-ui.es.js +9000 -4224
  13. package/dist/components/Announcer/Announcer.d.ts +3 -54
  14. package/dist/components/Announcer/announcer.styles.d.ts +39 -0
  15. package/dist/components/Announcer/index.d.ts +2 -0
  16. package/dist/components/Announcer/types.d.ts +41 -0
  17. package/dist/components/Badge/Badge.d.ts +2 -44
  18. package/dist/components/Badge/badge.styles.d.ts +57 -0
  19. package/dist/components/Badge/index.d.ts +4 -0
  20. package/dist/components/Badge/types.d.ts +33 -0
  21. package/dist/components/Box/Box.d.ts +7 -99
  22. package/dist/components/Box/index.d.ts +2 -0
  23. package/dist/components/Box/types.d.ts +89 -0
  24. package/dist/components/Breadcrumbs/BreadcrumbItem.d.ts +3 -5
  25. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +3 -17
  26. package/dist/components/Breadcrumbs/breadcrumbs.styles.d.ts +2 -0
  27. package/dist/components/Breadcrumbs/index.d.ts +3 -0
  28. package/dist/components/Breadcrumbs/types.d.ts +18 -0
  29. package/dist/components/Button/Button.d.ts +3 -76
  30. package/dist/components/Button/ButtonLink.d.ts +2 -3
  31. package/dist/components/Button/GhostButton.d.ts +3 -47
  32. package/dist/components/Button/IconButton.d.ts +2 -10
  33. package/dist/components/Button/button.styles.d.ts +242 -0
  34. package/dist/components/Button/constant.d.ts +1 -2
  35. package/dist/components/Button/index.d.ts +5 -0
  36. package/dist/components/Button/types.d.ts +72 -0
  37. package/dist/components/Checkbox/Checkbox.d.ts +3 -46
  38. package/dist/components/Checkbox/checkbox.styles.d.ts +27 -0
  39. package/dist/components/Checkbox/index.d.ts +2 -0
  40. package/dist/components/Checkbox/types.d.ts +40 -0
  41. package/dist/components/Chip/Chip.d.ts +3 -70
  42. package/dist/components/Chip/chip.styles.d.ts +66 -0
  43. package/dist/components/Chip/index.d.ts +2 -0
  44. package/dist/components/Chip/types.d.ts +22 -0
  45. package/dist/components/CurrencyInput/CurrencyInput.d.ts +3 -39
  46. package/dist/components/CurrencyInput/currency-input.styles.d.ts +21 -0
  47. package/dist/components/CurrencyInput/index.d.ts +5 -0
  48. package/dist/components/CurrencyInput/types.d.ts +96 -0
  49. package/dist/components/CurrencyInput/utils.d.ts +18 -0
  50. package/dist/components/DatePicker/DatePicker.d.ts +2 -138
  51. package/dist/components/DatePicker/DateTimePicker.d.ts +2 -137
  52. package/dist/components/DatePicker/date-picker.styles.d.ts +9 -0
  53. package/dist/components/DatePicker/date-time-picker.styles.d.ts +10 -0
  54. package/dist/components/DatePicker/index.d.ts +4 -0
  55. package/dist/components/DatePicker/types.d.ts +286 -0
  56. package/dist/components/Drawer/Drawer.d.ts +36 -0
  57. package/dist/components/Drawer/Drawer.pw.fixtures.d.ts +9 -0
  58. package/dist/components/Drawer/index.d.ts +3 -0
  59. package/dist/components/Drawer/types.d.ts +191 -0
  60. package/dist/components/Dropdown/Dropdown.d.ts +3 -94
  61. package/dist/components/Dropdown/dropdown.styles.d.ts +18 -0
  62. package/dist/components/Dropdown/index.d.ts +4 -0
  63. package/dist/components/Dropdown/types.d.ts +89 -0
  64. package/dist/components/EmptyState/EmptyState.d.ts +4 -0
  65. package/dist/components/EmptyState/empty-state.styles.d.ts +3 -0
  66. package/dist/components/EmptyState/index.d.ts +2 -0
  67. package/dist/components/EmptyState/types.d.ts +55 -0
  68. package/dist/components/Grid/Col.d.ts +4 -35
  69. package/dist/components/Grid/Grid.d.ts +8 -55
  70. package/dist/components/Grid/Grid.pw.fixtures.d.ts +3 -0
  71. package/dist/components/Grid/index.d.ts +3 -0
  72. package/dist/components/Grid/types.d.ts +66 -0
  73. package/dist/components/Input/Input.d.ts +3 -116
  74. package/dist/components/Input/index.d.ts +2 -0
  75. package/dist/components/Input/input.styles.d.ts +24 -0
  76. package/dist/components/Input/types.d.ts +55 -0
  77. package/dist/components/InputGroup/InputGroup.d.ts +4 -0
  78. package/dist/components/InputGroup/index.d.ts +4 -0
  79. package/dist/components/InputGroup/input-group.styles.d.ts +18 -0
  80. package/dist/components/InputGroup/types.d.ts +20 -0
  81. package/dist/components/LegacyDialog/DialogMainIcon.d.ts +3 -0
  82. package/dist/components/LegacyDialog/LegacyDialog.d.ts +5 -0
  83. package/dist/components/LegacyDialog/index.d.ts +3 -0
  84. package/dist/{patterns/LegacyDialog/LegacyDialog.d.ts → components/LegacyDialog/types.d.ts} +2 -10
  85. package/dist/components/LegacyPopup/LegacyPopup.d.ts +6 -0
  86. package/dist/components/LegacyPopup/index.d.ts +2 -0
  87. package/dist/{patterns/LegacyPopup/LegacyPopup.d.ts → components/LegacyPopup/types.d.ts} +4 -15
  88. package/dist/components/MultiSearchDropdown/MultiSearchDropdown.d.ts +10 -0
  89. package/dist/components/MultiSearchDropdown/index.d.ts +4 -0
  90. package/dist/components/MultiSearchDropdown/multi-search-dropdown.styles.d.ts +18 -0
  91. package/dist/{patterns/MultiSearchDropdown/MultiSearchDropdown.d.ts → components/MultiSearchDropdown/types.d.ts} +6 -19
  92. package/dist/components/Pagination/PageItem.d.ts +3 -21
  93. package/dist/components/Pagination/Pagination.d.ts +2 -46
  94. package/dist/components/Pagination/index.d.ts +5 -0
  95. package/dist/components/Pagination/pagination.styles.d.ts +37 -0
  96. package/dist/components/Pagination/types.d.ts +66 -0
  97. package/dist/components/Popover/Popover.d.ts +4 -44
  98. package/dist/components/Popover/Popover.pw.fixtures.d.ts +6 -0
  99. package/dist/components/Popover/index.d.ts +2 -0
  100. package/dist/components/Popover/popover.styles.d.ts +1 -0
  101. package/dist/components/Popover/types.d.ts +44 -0
  102. package/dist/components/Popup/Popup.d.ts +31 -0
  103. package/dist/components/Popup/Popup.pw.fixtures.d.ts +5 -0
  104. package/dist/components/Popup/index.d.ts +3 -0
  105. package/dist/components/Popup/types.d.ts +145 -0
  106. package/dist/components/RadioButton/RadioButton.d.ts +3 -51
  107. package/dist/components/RadioButton/index.d.ts +4 -0
  108. package/dist/components/RadioButton/radio-button.styles.d.ts +27 -0
  109. package/dist/components/RadioButton/types.d.ts +46 -0
  110. package/dist/components/RangeInput/RangeInput.d.ts +4 -0
  111. package/dist/components/RangeInput/index.d.ts +3 -0
  112. package/dist/components/RangeInput/range-input.styles.d.ts +1 -0
  113. package/dist/{patterns/RangeInput/RangeInput.d.ts → components/RangeInput/types.d.ts} +1 -4
  114. package/dist/components/RowItem/RowItem.d.ts +8 -76
  115. package/dist/components/RowItem/index.d.ts +2 -0
  116. package/dist/components/RowItem/rowitem.styles.d.ts +36 -0
  117. package/dist/components/RowItem/types.d.ts +66 -0
  118. package/dist/components/SearchInput/SearchInput.d.ts +5 -0
  119. package/dist/components/SearchInput/index.d.ts +3 -0
  120. package/dist/components/SearchInput/search-input.styles.d.ts +18 -0
  121. package/dist/{patterns/SearchInput/SearchInput.d.ts → components/SearchInput/types.d.ts} +19 -25
  122. package/dist/components/Searchbar/Searchbar.d.ts +3 -0
  123. package/dist/components/Searchbar/index.d.ts +3 -0
  124. package/dist/components/Searchbar/searchbar.styles.d.ts +1 -0
  125. package/dist/{patterns/Searchbar/Searchbar.d.ts → components/Searchbar/types.d.ts} +6 -9
  126. package/dist/components/ShapeIcon/ShapeIcon.d.ts +3 -53
  127. package/dist/components/ShapeIcon/index.d.ts +2 -0
  128. package/dist/components/ShapeIcon/shape-icon.styles.d.ts +156 -0
  129. package/dist/components/ShapeIcon/types.d.ts +5 -0
  130. package/dist/components/Slider/Slider.d.ts +3 -57
  131. package/dist/components/Slider/index.d.ts +3 -0
  132. package/dist/components/Slider/slider.styles.d.ts +1 -0
  133. package/dist/components/Slider/types.d.ts +59 -0
  134. package/dist/components/Snack/Snack.d.ts +4 -48
  135. package/dist/components/Snack/index.d.ts +3 -0
  136. package/dist/components/Snack/snack.styles.d.ts +21 -0
  137. package/dist/components/Snack/types.d.ts +48 -0
  138. package/dist/components/Tabs/Tab.d.ts +3 -67
  139. package/dist/components/Tabs/Tabs.d.ts +14 -61
  140. package/dist/components/Tabs/index.d.ts +4 -0
  141. package/dist/components/Tabs/tabs.styles.d.ts +59 -0
  142. package/dist/components/Tabs/types.d.ts +97 -0
  143. package/dist/components/TagCloud/TagCloud.d.ts +11 -0
  144. package/dist/components/TagCloud/index.d.ts +2 -0
  145. package/dist/components/TagCloud/tagcloud.styles.d.ts +18 -0
  146. package/dist/components/TagCloud/types.d.ts +26 -0
  147. package/dist/components/TextArea/TextArea.d.ts +3 -100
  148. package/dist/components/TextArea/index.d.ts +4 -0
  149. package/dist/components/TextArea/text-area.styles.d.ts +21 -0
  150. package/dist/components/TextArea/types.d.ts +98 -0
  151. package/dist/components/TextLabel/TextLabel.d.ts +3 -35
  152. package/dist/components/TextLabel/index.d.ts +2 -0
  153. package/dist/components/TextLabel/textlabel.styles.d.ts +51 -0
  154. package/dist/components/TextLabel/types.d.ts +32 -0
  155. package/dist/components/ToggleSwitch/ToggleSwitch.d.ts +3 -41
  156. package/dist/components/ToggleSwitch/index.d.ts +4 -0
  157. package/dist/components/ToggleSwitch/toggle-switch.styles.d.ts +39 -0
  158. package/dist/components/ToggleSwitch/types.d.ts +33 -0
  159. package/dist/components/Tooltip/Tooltip.d.ts +4 -98
  160. package/dist/components/Tooltip/Tooltip.pw.fixtures.d.ts +1 -0
  161. package/dist/components/Tooltip/index.d.ts +2 -0
  162. package/dist/components/Tooltip/tooltip.styles.d.ts +18 -0
  163. package/dist/components/Tooltip/types.d.ts +24 -0
  164. package/dist/forge/index.cjs +0 -0
  165. package/dist/forge/index.d.ts +8 -0
  166. package/dist/forge/index.es.js +0 -0
  167. package/dist/icons.cjs +1 -0
  168. package/dist/icons.d.ts +1 -0
  169. package/dist/icons.es.js +1 -0
  170. package/dist/index.d.ts +82 -71
  171. package/dist/styles.css +2 -0
  172. package/dist/{utils/types.d.ts → types/index.d.ts} +0 -1
  173. package/dist/typography/BodyAnnotation.d.ts +8 -6
  174. package/dist/typography/BodyCaption.d.ts +8 -6
  175. package/dist/typography/BodyPage.d.ts +8 -6
  176. package/dist/typography/BodySection.d.ts +8 -6
  177. package/dist/typography/DisplayAnnotation.d.ts +8 -6
  178. package/dist/typography/DisplayCaption.d.ts +8 -6
  179. package/dist/typography/DisplayPage.d.ts +8 -6
  180. package/dist/typography/DisplayPrice.d.ts +21 -0
  181. package/dist/typography/DisplaySection.d.ts +8 -6
  182. package/dist/typography/HeaderAnnotation.d.ts +8 -6
  183. package/dist/typography/HeaderCaption.d.ts +8 -6
  184. package/dist/typography/HeaderPage.d.ts +8 -6
  185. package/dist/typography/HeaderSection.d.ts +8 -6
  186. package/dist/typography/LabelAnnotation.d.ts +8 -6
  187. package/dist/typography/LabelCaption.d.ts +8 -6
  188. package/dist/typography/LabelPage.d.ts +8 -6
  189. package/dist/typography/LabelSection.d.ts +8 -6
  190. package/dist/typography/NoteCaption.d.ts +8 -6
  191. package/dist/typography/NotePage.d.ts +8 -6
  192. package/dist/typography/NoteSection.d.ts +8 -6
  193. package/dist/typography/TaglineAnnotation.d.ts +8 -6
  194. package/dist/typography/TaglineCaption.d.ts +8 -6
  195. package/dist/typography/TaglineFootext.d.ts +8 -6
  196. package/dist/typography/TaglineSection.d.ts +8 -6
  197. package/dist/typography/index.d.ts +25 -24
  198. package/dist/utils/_inlineCreatePortal.d.ts +0 -1
  199. package/dist/utils/bundleCss.cjs +1 -0
  200. package/dist/utils/bundleCss.d.ts +6 -0
  201. package/dist/utils/bundleCss.es.js +18 -0
  202. package/dist/utils/cleanHtml.d.ts +4 -7
  203. package/dist/utils/cn.d.ts +5 -0
  204. package/dist/utils/createUniversalPortal.d.ts +4 -14
  205. package/dist/utils/floating.d.ts +52 -0
  206. package/dist/utils/getBreakpointsValues.d.ts +4 -9
  207. package/dist/utils/sizes.d.ts +28 -0
  208. package/dist/utils/storyStyles.d.ts +21 -0
  209. package/dist/utils/themeTokens.d.ts +327 -0
  210. package/dist/utils/{scrollLock/useBodyScrollLock.d.ts → useBodyScrollLock.d.ts} +0 -1
  211. package/dist/utils/useScrollTop.d.ts +8 -0
  212. package/package.json +98 -104
  213. package/scripts/postinstall.cjs +180 -0
  214. package/skills/clad-ui/SKILL.md +109 -0
  215. package/skills/clad-ui/agents/openai.yaml +4 -0
  216. package/skills/clad-ui/references/components-display-layout.md +295 -0
  217. package/skills/clad-ui/references/components-inputs.md +449 -0
  218. package/skills/clad-ui/references/components-overlays-nav.md +314 -0
  219. package/skills/clad-ui/references/tokens.md +134 -0
  220. package/skills/clad-ui-feedback/SKILL.md +128 -0
  221. package/skills/migrate-clad-ui-v3/SKILL.md +123 -0
  222. package/skills/migrate-clad-ui-v3/agents/openai.yaml +4 -0
  223. package/skills/migrate-clad-ui-v3/references/component-api-changes.md +139 -0
  224. package/skills/migrate-clad-ui-v3/references/token-and-linaria-mapping.md +186 -0
  225. package/src/styles/base/base.css +440 -0
  226. package/src/styles/components/announcer.css +182 -0
  227. package/src/styles/components/badge.css +102 -0
  228. package/src/styles/components/box.css +61 -0
  229. package/src/styles/components/breadcrumbs.css +75 -0
  230. package/src/styles/components/button.css +527 -0
  231. package/src/styles/components/checkbox.css +115 -0
  232. package/src/styles/components/chip.css +155 -0
  233. package/src/styles/components/currency-input.css +146 -0
  234. package/src/styles/components/date-picker.css +305 -0
  235. package/src/styles/components/date-time-picker.css +64 -0
  236. package/src/styles/components/drawer.css +496 -0
  237. package/src/styles/components/dropdown.css +186 -0
  238. package/src/styles/components/empty-state.css +30 -0
  239. package/src/styles/components/grid.css +212 -0
  240. package/src/styles/components/index.css +36 -0
  241. package/src/styles/components/input-group.css +85 -0
  242. package/src/styles/components/input.css +255 -0
  243. package/src/styles/components/legacy-dialog.css +129 -0
  244. package/src/styles/components/legacy-popup.css +209 -0
  245. package/src/styles/components/multi-search-dropdown.css +240 -0
  246. package/src/styles/components/pagination.css +68 -0
  247. package/src/styles/components/popover.css +8 -0
  248. package/src/styles/components/popup.css +331 -0
  249. package/src/styles/components/radio-button.css +130 -0
  250. package/src/styles/components/range-input.css +40 -0
  251. package/src/styles/components/rowitem.css +75 -0
  252. package/src/styles/components/search-input.css +89 -0
  253. package/src/styles/components/searchbar.css +46 -0
  254. package/src/styles/components/shape-icon.css +199 -0
  255. package/src/styles/components/slider.css +232 -0
  256. package/src/styles/components/snack.css +144 -0
  257. package/src/styles/components/tabs.css +128 -0
  258. package/src/styles/components/tagcloud.css +50 -0
  259. package/src/styles/components/text-area.css +176 -0
  260. package/src/styles/components/textlabel.css +75 -0
  261. package/src/styles/components/toggle-switch.css +147 -0
  262. package/src/styles/components/tooltip.css +93 -0
  263. package/src/styles/index.css +10 -0
  264. package/src/styles/preset.css +6 -0
  265. package/src/styles/theme/colors/base.css +108 -0
  266. package/src/styles/theme/colors/semantic.css +135 -0
  267. package/src/styles/theme/index.css +57 -0
  268. package/src/styles/theme/typography/base.css +53 -0
  269. package/src/styles/theme/typography/semantic.css +176 -0
  270. package/src/styles/theme/variables.css +83 -0
  271. package/ai/clad-ui-helper.js +0 -267
  272. package/ai/knowledge-base/README.md +0 -154
  273. package/ai/knowledge-base/clad-ui-database.json +0 -9378
  274. package/ai/knowledge-base/component-categories.json +0 -616
  275. package/ai/knowledge-base/components/metadata/charts-axis.json +0 -31
  276. package/ai/knowledge-base/components/metadata/charts-barchart.json +0 -57
  277. package/ai/knowledge-base/components/metadata/charts-basechart.tsx.json +0 -31
  278. package/ai/knowledge-base/components/metadata/charts-chartshared.json +0 -31
  279. package/ai/knowledge-base/components/metadata/charts-linechart.json +0 -189
  280. package/ai/knowledge-base/components/metadata/charts-piechart.json +0 -57
  281. package/ai/knowledge-base/components/metadata/components-announcer.json +0 -215
  282. package/ai/knowledge-base/components/metadata/components-badge.json +0 -168
  283. package/ai/knowledge-base/components/metadata/components-box.json +0 -348
  284. package/ai/knowledge-base/components/metadata/components-breadcrumbs.json +0 -75
  285. package/ai/knowledge-base/components/metadata/components-button.json +0 -187
  286. package/ai/knowledge-base/components/metadata/components-checkbox.json +0 -161
  287. package/ai/knowledge-base/components/metadata/components-chip.json +0 -266
  288. package/ai/knowledge-base/components/metadata/components-currencyinput.json +0 -136
  289. package/ai/knowledge-base/components/metadata/components-datepicker.json +0 -87
  290. package/ai/knowledge-base/components/metadata/components-dropdown.json +0 -282
  291. package/ai/knowledge-base/components/metadata/components-grid.json +0 -92
  292. package/ai/knowledge-base/components/metadata/components-input.json +0 -432
  293. package/ai/knowledge-base/components/metadata/components-pagination.json +0 -111
  294. package/ai/knowledge-base/components/metadata/components-popover.json +0 -63
  295. package/ai/knowledge-base/components/metadata/components-radiobutton.json +0 -170
  296. package/ai/knowledge-base/components/metadata/components-rowitem.json +0 -281
  297. package/ai/knowledge-base/components/metadata/components-shapeicon.json +0 -139
  298. package/ai/knowledge-base/components/metadata/components-slider.json +0 -177
  299. package/ai/knowledge-base/components/metadata/components-snack.json +0 -181
  300. package/ai/knowledge-base/components/metadata/components-tabs.json +0 -169
  301. package/ai/knowledge-base/components/metadata/components-textarea.json +0 -285
  302. package/ai/knowledge-base/components/metadata/components-textlabel.json +0 -129
  303. package/ai/knowledge-base/components/metadata/components-toggleswitch.json +0 -134
  304. package/ai/knowledge-base/components/metadata/components-tooltip.json +0 -291
  305. package/ai/knowledge-base/components/metadata/patterns-drawer.json +0 -310
  306. package/ai/knowledge-base/components/metadata/patterns-emptystate.json +0 -106
  307. package/ai/knowledge-base/components/metadata/patterns-inputgroup.json +0 -105
  308. package/ai/knowledge-base/components/metadata/patterns-legacydialog.json +0 -177
  309. package/ai/knowledge-base/components/metadata/patterns-legacypopup.json +0 -236
  310. package/ai/knowledge-base/components/metadata/patterns-multisearchdropdown.json +0 -249
  311. package/ai/knowledge-base/components/metadata/patterns-popup.json +0 -268
  312. package/ai/knowledge-base/components/metadata/patterns-rangeinput.json +0 -105
  313. package/ai/knowledge-base/components/metadata/patterns-searchbar.json +0 -150
  314. package/ai/knowledge-base/components/metadata/patterns-searchinput.json +0 -312
  315. package/ai/knowledge-base/components/metadata/patterns-tagcloud.json +0 -244
  316. package/ai/knowledge-base/components/metadata/summaries.json +0 -610
  317. package/ai/knowledge-base/design-tokens/tokens.json +0 -483
  318. package/ai/knowledge-base/patterns/documentation.json +0 -131
  319. package/ai/knowledge-base/prompts/common-system-prompt.md +0 -592
  320. package/ai/knowledge-base/prompts/figma-system-prompt.md +0 -396
  321. package/ai/knowledge-base/search-index/icons/asset-icons.json +0 -1
  322. package/ai/knowledge-base/search-index/icons/collection.json +0 -5
  323. package/ai/knowledge-base/search-index/icons/system-icons.json +0 -1
  324. package/ai/knowledge-base/search-index/search-index.json +0 -899
  325. package/ai/knowledge-base/validation-rules/component-rules.json +0 -658
  326. package/ai/skill/SKILL.md +0 -103
  327. package/dist/components/Announcer/Announcer.d.ts.map +0 -1
  328. package/dist/components/Announcer/Announcer.styles.d.ts +0 -30
  329. package/dist/components/Announcer/Announcer.styles.d.ts.map +0 -1
  330. package/dist/components/Badge/Badge.d.ts.map +0 -1
  331. package/dist/components/Badge/Badge.styles.d.ts +0 -26
  332. package/dist/components/Badge/Badge.styles.d.ts.map +0 -1
  333. package/dist/components/Box/Box.d.ts.map +0 -1
  334. package/dist/components/Box/Box.styles.d.ts +0 -21
  335. package/dist/components/Box/Box.styles.d.ts.map +0 -1
  336. package/dist/components/Breadcrumbs/BreadcrumbItem.d.ts.map +0 -1
  337. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts.map +0 -1
  338. package/dist/components/Breadcrumbs/Breadcrumbs.styles.d.ts +0 -10
  339. package/dist/components/Breadcrumbs/Breadcrumbs.styles.d.ts.map +0 -1
  340. package/dist/components/Button/Button.d.ts.map +0 -1
  341. package/dist/components/Button/Button.styles.d.ts +0 -3
  342. package/dist/components/Button/Button.styles.d.ts.map +0 -1
  343. package/dist/components/Button/ButtonLink.d.ts.map +0 -1
  344. package/dist/components/Button/GhostButton.d.ts.map +0 -1
  345. package/dist/components/Button/GhostButton.styles.d.ts +0 -3
  346. package/dist/components/Button/GhostButton.styles.d.ts.map +0 -1
  347. package/dist/components/Button/IconButton.d.ts.map +0 -1
  348. package/dist/components/Button/constant.d.ts.map +0 -1
  349. package/dist/components/Checkbox/Checkbox.d.ts.map +0 -1
  350. package/dist/components/Checkbox/Checkbox.styles.d.ts +0 -5
  351. package/dist/components/Checkbox/Checkbox.styles.d.ts.map +0 -1
  352. package/dist/components/Chip/Chip.d.ts.map +0 -1
  353. package/dist/components/Chip/Chip.styles.d.ts +0 -13
  354. package/dist/components/Chip/Chip.styles.d.ts.map +0 -1
  355. package/dist/components/CurrencyInput/CurrencyInput.d.ts.map +0 -1
  356. package/dist/components/CurrencyInput/CurrencyInput.styles.d.ts +0 -27
  357. package/dist/components/CurrencyInput/CurrencyInput.styles.d.ts.map +0 -1
  358. package/dist/components/CurrencyInput/utils/_cleanValue.d.ts +0 -12
  359. package/dist/components/CurrencyInput/utils/_cleanValue.d.ts.map +0 -1
  360. package/dist/components/CurrencyInput/utils/_formatValue.d.ts +0 -6
  361. package/dist/components/CurrencyInput/utils/_formatValue.d.ts.map +0 -1
  362. package/dist/components/DatePicker/DatePicker.d.ts.map +0 -1
  363. package/dist/components/DatePicker/DateTimePicker.d.ts.map +0 -1
  364. package/dist/components/DatePicker/DateTimePicker.styles.d.ts +0 -61
  365. package/dist/components/DatePicker/DateTimePicker.styles.d.ts.map +0 -1
  366. package/dist/components/Dropdown/Dropdown.d.ts.map +0 -1
  367. package/dist/components/Dropdown/Dropdown.styles.d.ts +0 -11
  368. package/dist/components/Dropdown/Dropdown.styles.d.ts.map +0 -1
  369. package/dist/components/Grid/Col.d.ts.map +0 -1
  370. package/dist/components/Grid/Grid.d.ts.map +0 -1
  371. package/dist/components/Grid/Grid.styles.d.ts +0 -33
  372. package/dist/components/Grid/Grid.styles.d.ts.map +0 -1
  373. package/dist/components/Input/Input.d.ts.map +0 -1
  374. package/dist/components/Input/Input.styles.d.ts +0 -36
  375. package/dist/components/Input/Input.styles.d.ts.map +0 -1
  376. package/dist/components/Pagination/PageItem.d.ts.map +0 -1
  377. package/dist/components/Pagination/Pagination.d.ts.map +0 -1
  378. package/dist/components/Pagination/Pagination.style.d.ts +0 -7
  379. package/dist/components/Pagination/Pagination.style.d.ts.map +0 -1
  380. package/dist/components/Popover/Popover.d.ts.map +0 -1
  381. package/dist/components/Popover/Popover.styles.d.ts +0 -4
  382. package/dist/components/Popover/Popover.styles.d.ts.map +0 -1
  383. package/dist/components/RadioButton/RadioButton.d.ts.map +0 -1
  384. package/dist/components/RadioButton/RadioButton.styles.d.ts +0 -12
  385. package/dist/components/RadioButton/RadioButton.styles.d.ts.map +0 -1
  386. package/dist/components/RowItem/RowItem.d.ts.map +0 -1
  387. package/dist/components/RowItem/RowItem.styles.d.ts +0 -33
  388. package/dist/components/RowItem/RowItem.styles.d.ts.map +0 -1
  389. package/dist/components/ShapeIcon/ShapeIcon.d.ts.map +0 -1
  390. package/dist/components/ShapeIcon/ShapeIcon.styles.d.ts +0 -15
  391. package/dist/components/ShapeIcon/ShapeIcon.styles.d.ts.map +0 -1
  392. package/dist/components/Slider/Slider.d.ts.map +0 -1
  393. package/dist/components/Slider/Slider.styles.d.ts +0 -24
  394. package/dist/components/Slider/Slider.styles.d.ts.map +0 -1
  395. package/dist/components/Snack/Snack.d.ts.map +0 -1
  396. package/dist/components/Snack/Snack.styles.d.ts +0 -20
  397. package/dist/components/Snack/Snack.styles.d.ts.map +0 -1
  398. package/dist/components/Tabs/Tab.d.ts.map +0 -1
  399. package/dist/components/Tabs/Tabs.d.ts.map +0 -1
  400. package/dist/components/Tabs/Tabs.styles.d.ts +0 -43
  401. package/dist/components/Tabs/Tabs.styles.d.ts.map +0 -1
  402. package/dist/components/TextArea/TextArea.d.ts.map +0 -1
  403. package/dist/components/TextArea/TextArea.styles.d.ts +0 -19
  404. package/dist/components/TextArea/TextArea.styles.d.ts.map +0 -1
  405. package/dist/components/TextLabel/TextLabel.d.ts.map +0 -1
  406. package/dist/components/TextLabel/TextLabel.styles.d.ts +0 -10
  407. package/dist/components/TextLabel/TextLabel.styles.d.ts.map +0 -1
  408. package/dist/components/ToggleSwitch/ToggleSwitch.d.ts.map +0 -1
  409. package/dist/components/ToggleSwitch/ToggleSwitch.styles.d.ts +0 -22
  410. package/dist/components/ToggleSwitch/ToggleSwitch.styles.d.ts.map +0 -1
  411. package/dist/components/Tooltip/Tooltip.d.ts.map +0 -1
  412. package/dist/components/Tooltip/Tooltip.styles.d.ts +0 -33
  413. package/dist/components/Tooltip/Tooltip.styles.d.ts.map +0 -1
  414. package/dist/components/index.d.ts +0 -62
  415. package/dist/components/index.d.ts.map +0 -1
  416. package/dist/css/baseline.d.ts +0 -15
  417. package/dist/css/baseline.d.ts.map +0 -1
  418. package/dist/index.d.ts.map +0 -1
  419. package/dist/patterns/Drawer/Drawer.d.ts +0 -110
  420. package/dist/patterns/Drawer/Drawer.d.ts.map +0 -1
  421. package/dist/patterns/Drawer/Drawer.styles.d.ts +0 -39
  422. package/dist/patterns/Drawer/Drawer.styles.d.ts.map +0 -1
  423. package/dist/patterns/EmptyState/EmptyState.d.ts +0 -36
  424. package/dist/patterns/EmptyState/EmptyState.d.ts.map +0 -1
  425. package/dist/patterns/EmptyState/EmptyState.styles.d.ts +0 -4
  426. package/dist/patterns/EmptyState/EmptyState.styles.d.ts.map +0 -1
  427. package/dist/patterns/InputGroup/InputGroup.d.ts +0 -26
  428. package/dist/patterns/InputGroup/InputGroup.d.ts.map +0 -1
  429. package/dist/patterns/InputGroup/InputGroup.styles.d.ts +0 -8
  430. package/dist/patterns/InputGroup/InputGroup.styles.d.ts.map +0 -1
  431. package/dist/patterns/LegacyDialog/DialogMainIcon.d.ts +0 -2
  432. package/dist/patterns/LegacyDialog/DialogMainIcon.d.ts.map +0 -1
  433. package/dist/patterns/LegacyDialog/LegacyDialog.d.ts.map +0 -1
  434. package/dist/patterns/LegacyDialog/LegacyDialog.styles.d.ts +0 -13
  435. package/dist/patterns/LegacyDialog/LegacyDialog.styles.d.ts.map +0 -1
  436. package/dist/patterns/LegacyPopup/LegacyPopup.d.ts.map +0 -1
  437. package/dist/patterns/LegacyPopup/LegacyPopup.styles.d.ts +0 -27
  438. package/dist/patterns/LegacyPopup/LegacyPopup.styles.d.ts.map +0 -1
  439. package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.d.ts.map +0 -1
  440. package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.styles.d.ts +0 -26
  441. package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.styles.d.ts.map +0 -1
  442. package/dist/patterns/Popup/Popup.d.ts +0 -92
  443. package/dist/patterns/Popup/Popup.d.ts.map +0 -1
  444. package/dist/patterns/Popup/Popup.styles.d.ts +0 -41
  445. package/dist/patterns/Popup/Popup.styles.d.ts.map +0 -1
  446. package/dist/patterns/RangeInput/RangeInput.d.ts.map +0 -1
  447. package/dist/patterns/RangeInput/RangeInput.styles.d.ts +0 -5
  448. package/dist/patterns/RangeInput/RangeInput.styles.d.ts.map +0 -1
  449. package/dist/patterns/SearchInput/SearchInput.d.ts.map +0 -1
  450. package/dist/patterns/SearchInput/SearchInput.styles.d.ts +0 -10
  451. package/dist/patterns/SearchInput/SearchInput.styles.d.ts.map +0 -1
  452. package/dist/patterns/Searchbar/Searchbar.d.ts.map +0 -1
  453. package/dist/patterns/Searchbar/Searchbar.styles.d.ts +0 -3
  454. package/dist/patterns/Searchbar/Searchbar.styles.d.ts.map +0 -1
  455. package/dist/patterns/TagCloud/TagCloud.d.ts +0 -76
  456. package/dist/patterns/TagCloud/TagCloud.d.ts.map +0 -1
  457. package/dist/patterns/TagCloud/TagCloud.styles.d.ts +0 -15
  458. package/dist/patterns/TagCloud/TagCloud.styles.d.ts.map +0 -1
  459. package/dist/patterns/TagCloud/TagCloudMultiActive.d.ts +0 -25
  460. package/dist/patterns/TagCloud/TagCloudMultiActive.d.ts.map +0 -1
  461. package/dist/patterns/TagCloud/TagCloudSingleActive.d.ts +0 -22
  462. package/dist/patterns/TagCloud/TagCloudSingleActive.d.ts.map +0 -1
  463. package/dist/patterns/index.d.ts +0 -23
  464. package/dist/patterns/index.d.ts.map +0 -1
  465. package/dist/theme/chotot.d.ts +0 -1371
  466. package/dist/theme/chotot.d.ts.map +0 -1
  467. package/dist/theme/ct-job.d.ts +0 -826
  468. package/dist/theme/ct-job.d.ts.map +0 -1
  469. package/dist/theme/ct-pty.d.ts +0 -826
  470. package/dist/theme/ct-pty.d.ts.map +0 -1
  471. package/dist/theme/ct-veh.d.ts +0 -591
  472. package/dist/theme/ct-veh.d.ts.map +0 -1
  473. package/dist/theme/index.d.ts +0 -5
  474. package/dist/theme/index.d.ts.map +0 -1
  475. package/dist/theme/mudah.d.ts +0 -248
  476. package/dist/theme/mudah.d.ts.map +0 -1
  477. package/dist/theme/types.d.ts +0 -58
  478. package/dist/theme/types.d.ts.map +0 -1
  479. package/dist/theme-chotot.css +0 -2
  480. package/dist/theme-job.css +0 -2
  481. package/dist/theme-pty.css +0 -2
  482. package/dist/theme-veh.css +0 -2
  483. package/dist/typography/BodyAnnotation.d.ts.map +0 -1
  484. package/dist/typography/BodyCaption.d.ts.map +0 -1
  485. package/dist/typography/BodyPage.d.ts.map +0 -1
  486. package/dist/typography/BodySection.d.ts.map +0 -1
  487. package/dist/typography/DisplayAnnotation.d.ts.map +0 -1
  488. package/dist/typography/DisplayCaption.d.ts.map +0 -1
  489. package/dist/typography/DisplayPage.d.ts.map +0 -1
  490. package/dist/typography/DisplaySection.d.ts.map +0 -1
  491. package/dist/typography/HeaderAnnotation.d.ts.map +0 -1
  492. package/dist/typography/HeaderCaption.d.ts.map +0 -1
  493. package/dist/typography/HeaderPage.d.ts.map +0 -1
  494. package/dist/typography/HeaderSection.d.ts.map +0 -1
  495. package/dist/typography/LabelAnnotation.d.ts.map +0 -1
  496. package/dist/typography/LabelCaption.d.ts.map +0 -1
  497. package/dist/typography/LabelPage.d.ts.map +0 -1
  498. package/dist/typography/LabelSection.d.ts.map +0 -1
  499. package/dist/typography/NoteCaption.d.ts.map +0 -1
  500. package/dist/typography/NotePage.d.ts.map +0 -1
  501. package/dist/typography/NoteSection.d.ts.map +0 -1
  502. package/dist/typography/TaglineAnnotation.d.ts.map +0 -1
  503. package/dist/typography/TaglineCaption.d.ts.map +0 -1
  504. package/dist/typography/TaglineFootext.d.ts.map +0 -1
  505. package/dist/typography/TaglineSection.d.ts.map +0 -1
  506. package/dist/typography/index.d.ts.map +0 -1
  507. package/dist/utils/_inlineCreatePortal.d.ts.map +0 -1
  508. package/dist/utils/_normalizeArrowKey.d.ts +0 -10
  509. package/dist/utils/_normalizeArrowKey.d.ts.map +0 -1
  510. package/dist/utils/_simulateChangeEvent.d.ts +0 -25
  511. package/dist/utils/_simulateChangeEvent.d.ts.map +0 -1
  512. package/dist/utils/cleanHtml.d.ts.map +0 -1
  513. package/dist/utils/createUniversalPortal.d.ts.map +0 -1
  514. package/dist/utils/cx.d.ts +0 -22
  515. package/dist/utils/cx.d.ts.map +0 -1
  516. package/dist/utils/getBreakpointsValues.d.ts.map +0 -1
  517. package/dist/utils/index.d.ts +0 -7
  518. package/dist/utils/index.d.ts.map +0 -1
  519. package/dist/utils/noop.d.ts +0 -9
  520. package/dist/utils/noop.d.ts.map +0 -1
  521. package/dist/utils/scrollLock/index.d.ts +0 -7
  522. package/dist/utils/scrollLock/index.d.ts.map +0 -1
  523. package/dist/utils/scrollLock/scrollLock.styles.d.ts +0 -6
  524. package/dist/utils/scrollLock/scrollLock.styles.d.ts.map +0 -1
  525. package/dist/utils/scrollLock/useBodyScrollLock.d.ts.map +0 -1
  526. package/dist/utils/scrollTop.d.ts +0 -8
  527. package/dist/utils/scrollTop.d.ts.map +0 -1
  528. package/dist/utils/sx.d.ts +0 -174
  529. package/dist/utils/sx.d.ts.map +0 -1
  530. package/dist/utils/types.d.ts.map +0 -1
  531. package/theme/__snapshots__/chotot.spec.js.snap +0 -519
  532. package/theme/__snapshots__/mudah.spec.js.snap +0 -161
  533. package/theme/chotot.js +0 -1336
  534. package/theme/chotot.spec.js +0 -72
  535. package/theme/ct-job.js +0 -92
  536. package/theme/ct-pty.js +0 -92
  537. package/theme/ct-veh.js +0 -92
  538. package/theme/index.ts +0 -10
  539. package/theme/mudah.js +0 -333
  540. package/theme/mudah.spec.js +0 -9
  541. package/theme/types.ts +0 -61
@@ -0,0 +1,449 @@
1
+ # Clad UI Tailwind — Form, Input & Selection Components
2
+
3
+ ## Contents
4
+
5
+ - [Event Payload Quick Summary](#event-payload-quick-summary)
6
+ - [1. Input](#1-input)
7
+ - [2. TextArea](#2-textarea)
8
+ - [3. CurrencyInput](#3-currencyinput)
9
+ - [4. InputGroup](#4-inputgroup)
10
+ - [5. RangeInput](#5-rangeinput)
11
+ - [6. Searchbar](#6-searchbar)
12
+ - [7. SearchInput](#7-searchinput)
13
+ - [8. Dropdown](#8-dropdown)
14
+ - [9. MultiSearchDropdown](#9-multisearchdropdown)
15
+ - [10. DatePicker](#10-datepicker)
16
+ - [11. DateTimePicker](#11-datetimepicker)
17
+ - [12. Slider](#12-slider)
18
+ - [13. Checkbox](#13-checkbox)
19
+ - [14. RadioButton](#14-radiobutton)
20
+ - [15. ToggleSwitch](#15-toggleswitch)
21
+
22
+ ---
23
+
24
+ ## Event Payload Quick Summary
25
+
26
+ Do **not** assume every form component passes a standard `e.target.value` string:
27
+
28
+ | Component | `onChange` / Selection Signature | How to Read Value |
29
+ |---|---|---|
30
+ | `Input`, `TextArea`, `Searchbar` | `(e: ChangeEvent<HTMLInputElement \| HTMLTextAreaElement>) => void` | `e.target.value` |
31
+ | `Checkbox`, `RadioButton`, `ToggleSwitch` | `(e: ChangeEvent<HTMLInputElement>) => void` | `e.target.checked` (or `e.target.value`) |
32
+ | `CurrencyInput` | `ChangeEventHandler<HTMLInputElement>` + `onFormatChange?: (val?: string) => void` | `e.target.value` (numeric string) / `onFormatChange` (formatted string) |
33
+ | `Dropdown` | `ChangeEventHandler<HTMLSelectElement>` | `e.target.value` |
34
+ | `SearchInput` | `(e: SearchInputEvent) => void` | `e.value` (`{ text, selected? }`) |
35
+ | `MultiSearchDropdown` | `onSelect={(opt, e) => ...}`, `onRemoveOption={(opt, e) => ...}` | `opt` (`{ text, html, data }`) |
36
+ | `DatePicker` | `(v: DatePickerValue, e?) => void` | `v.dateObj` (`Date \| null`), `v.year`, `v.month`, `v.date` |
37
+ | `DateTimePicker` | `(v: DateTimePickerValue, e?) => void` | `v.dateObj` (`Date \| null`), `v.hour`, `v.minute` |
38
+ | `Slider` | `(e: SliderOnChangeEvent) => void` | `e.value` (`number \| [number, number]`) |
39
+
40
+ ---
41
+
42
+ ## 1. Input
43
+
44
+ Controlled text input with floating label, helptext, clear button, password reveal toggle, tooltip, and validation icon.
45
+
46
+ ```tsx
47
+ import { Input } from '@chotot/clad-ui';
48
+
49
+ <Input
50
+ label="Số điện thoại"
51
+ value={phone}
52
+ onChange={(e) => setPhone(e.target.value)}
53
+ status={hasError ? 'error' : 'default'}
54
+ helptext={hasError ? 'Số điện thoại không hợp lệ' : 'Nhập 10 chữ số'}
55
+ allowClear
56
+ />
57
+ ```
58
+
59
+ | Prop | Type | Default |
60
+ |---|---|---|
61
+ | `label` | `string` — floating label | — |
62
+ | `value` | `string \| number` (controlled) | `''` |
63
+ | `onChange` | `ChangeEventHandler<HTMLInputElement>` | — |
64
+ | `status` | `'default' \| 'warning' \| 'error' \| 'success'` | `'default'` |
65
+ | `helptext` | `string` — shown below input | — |
66
+ | `allowClear` | `boolean` — shows clear `×` button when non-empty | `true` |
67
+ | `showPassword` | `boolean` — reveal toggle when `type="password"` | `false` |
68
+ | `showValidationIcon` | `boolean` — status icon on right | `false` |
69
+ | `icon` | `ReactNode` — left icon | — |
70
+ | `tooltip` | `string` — hover tooltip on `(i)` icon | — |
71
+ | `characterLimit` | `number` | — |
72
+ | `disabled` / `required` | `boolean` | `false` |
73
+ | `placeholder` | `string` (also floats label) | — |
74
+ | `type` | `'text' \| 'email' \| 'number' \| 'password' \| 'tel'` | `'text'` |
75
+ | `onClear` | `MouseEventHandler` | — |
76
+ | `ref` | `Ref<HTMLInputElement>` | — |
77
+ | `className` | `string` (applied to outer container `div`) | — |
78
+
79
+ ---
80
+
81
+ ## 2. TextArea
82
+
83
+ Controlled multiline input with floating label, optional clear button, and character limit counter.
84
+
85
+ ```tsx
86
+ import { TextArea } from '@chotot/clad-ui';
87
+
88
+ <TextArea
89
+ label="Mô tả chi tiết"
90
+ lines={4}
91
+ value={desc}
92
+ onChange={(e) => setDesc(e.target.value)}
93
+ characterLimit={300}
94
+ helptext="Tối đa 300 ký tự"
95
+ />
96
+ ```
97
+
98
+ | Prop | Type | Default |
99
+ |---|---|---|
100
+ | `label` | `string` | — |
101
+ | `value` | `string` (controlled) | `''` |
102
+ | `lines` | `number` | `5` |
103
+ | `status` | `'default' \| 'warning' \| 'error'` | `'default'` |
104
+ | `helptext` | `string` | — |
105
+ | `allowClear` | `boolean` | `false` |
106
+ | `characterLimit` | `number` | — |
107
+ | `disabled` / `required` | `boolean` | `false` |
108
+
109
+ ---
110
+
111
+ ## 3. CurrencyInput
112
+
113
+ Formatted currency field with thousands/decimal separators, suffix, and dual change callbacks (`onChange` for raw numeric value and `onFormatChange` for formatted display string).
114
+
115
+ ```tsx
116
+ import { CurrencyInput } from '@chotot/clad-ui';
117
+
118
+ <CurrencyInput
119
+ label="Giá bán"
120
+ value={price}
121
+ suffix=" đ"
122
+ onChange={(e) => setPrice(e.target.value)}
123
+ onFormatChange={(formatted) => setFormattedPrice(formatted)}
124
+ />
125
+ ```
126
+
127
+ | Prop | Type | Default |
128
+ |---|---|---|
129
+ | `value` | `string \| number` | `''` |
130
+ | `status` | `'default' \| 'warning' \| 'error'` | `'default'` |
131
+ | `suffix` | `string` | `'đ'` |
132
+ | `separator` / `decimalSeparator` | `string` | `'.'` / `','` |
133
+ | `maxDigits` / `decimalsLimit` | `number` | `12` / `0` |
134
+ | `allowNegativeValue` | `boolean` | `false` |
135
+ | `onChange` | `ChangeEventHandler<HTMLInputElement>` (`e.target.value` is unformatted numeric string) | — |
136
+ | `onFormatChange` | `(value: string \| undefined) => void` | — |
137
+
138
+ ---
139
+
140
+ ## 4. InputGroup
141
+
142
+ Composes adjacent `Input`, `Dropdown`, or `CurrencyInput` elements into a single bordered group with shared `status` and `helptext`.
143
+
144
+ ```tsx
145
+ import { InputGroup, Dropdown, Input } from '@chotot/clad-ui';
146
+
147
+ <InputGroup status="default" helptext="Số điện thoại liên hệ">
148
+ <Dropdown label="Mã vùng" value="+84" options={[{ value: '+84', label: '+84' }]} width="xxxl" />
149
+ <Input label="Số điện thoại" value={phone} onChange={(e) => setPhone(e.target.value)} />
150
+ </InputGroup>
151
+ ```
152
+
153
+ | Prop | Type | Default |
154
+ |---|---|---|
155
+ | `children` | `ReactNode` | required |
156
+ | `status` | `'default' \| 'error'` | `'default'` |
157
+ | `helptext` | `string` | `''` |
158
+ | `helptextClassName` / `className` | `string` | `''` |
159
+
160
+ ---
161
+
162
+ ## 5. RangeInput
163
+
164
+ Groups two or more inputs horizontally with a separator (`-` by default or custom `separatorComponent`) and shared `helptext`.
165
+
166
+ ```tsx
167
+ import { RangeInput, Input } from '@chotot/clad-ui';
168
+
169
+ <RangeInput helptext="Nhập khoảng giá">
170
+ <Input label="Từ" value={min} onChange={(e) => setMin(e.target.value)} />
171
+ <Input label="Đến" value={max} onChange={(e) => setMax(e.target.value)} />
172
+ </RangeInput>
173
+ ```
174
+
175
+ | Prop | Type | Default |
176
+ |---|---|---|
177
+ | `children` | `ReactNode` | required |
178
+ | `status` | `'default' \| 'error'` | `'default'` |
179
+ | `helptext` | `string` | `''` |
180
+ | `separatorComponent` | `ReactNode` | `<p className="range-input-separator">-</p>` |
181
+
182
+ ---
183
+
184
+ ## 6. Searchbar
185
+
186
+ Pill-shaped search input (`40px` height) with leading search icon and optional clear button.
187
+
188
+ ```tsx
189
+ import { Searchbar } from '@chotot/clad-ui';
190
+
191
+ <Searchbar value={q} onChange={(e) => setQ(e.target.value)} placeholder="Tìm sản phẩm..." allowClear />
192
+ ```
193
+
194
+ | Prop | Type | Default |
195
+ |---|---|---|
196
+ | `value` / `defaultValue` | `string` | `''` |
197
+ | `placeholder` | `string` | `'Tìm sản phẩm...'` |
198
+ | `allowClear` | `boolean` | `true` |
199
+ | `disabled` | `boolean` | `false` |
200
+ | `classNames` | `{ container?, input?, actionBtn? }` | — |
201
+
202
+ ---
203
+
204
+ ## 7. SearchInput
205
+
206
+ Autocomplete / combobox input wrapping `Input` with a floating portal listbox (`@floating-ui/react-dom`).
207
+
208
+ ```tsx
209
+ import { SearchInput } from '@chotot/clad-ui';
210
+
211
+ <SearchInput
212
+ label="Địa điểm"
213
+ variant="dropdown"
214
+ value={val}
215
+ options={[{ text: 'TP. Hồ Chí Minh', html: '<b>TP.</b> Hồ Chí Minh', data: { id: 1 } }]}
216
+ onChange={(e) => setVal(e.value)}
217
+ showSearchIcon
218
+ />
219
+ ```
220
+
221
+ | Prop | Type | Default |
222
+ |---|---|---|
223
+ | `value` | `SearchInputValue \| null` (`{ text: string, selected?: SearchInputOption }`) | — |
224
+ | `variant` | `'input' \| 'dropdown'` | `'input'` |
225
+ | `options` | `SearchInputOption[]` (`{ text, html?, data? }`) | `[]` |
226
+ | `onInput` / `onSelect` / `onChange` | `((event: SearchInputEvent) => void) \| null` (`event.value`) | — |
227
+ | `label` / `helptext` / `tooltip` | `string` | — |
228
+ | `status` | `'default' \| 'error'` | `'default'` |
229
+ | `allowClear` | `boolean` | `true` |
230
+ | `showSearchIcon` | `boolean` | `false` |
231
+ | `disabled` / `required` | `boolean` | `false` |
232
+ | `width` / `menuMaxHeight` | `CladSize` | — / `'$sm'` |
233
+
234
+ ---
235
+
236
+ ## 8. Dropdown
237
+
238
+ Select menu built on `@floating-ui/react-dom` with floating label, option icons, and keyboard navigation.
239
+
240
+ ```tsx
241
+ import { Dropdown } from '@chotot/clad-ui';
242
+
243
+ <Dropdown
244
+ label="Tỉnh / Thành phố"
245
+ options={[{ value: 'hcm', label: 'TP.HCM' }, { value: 'hn', label: 'Hà Nội' }]}
246
+ value={city}
247
+ onChange={(e) => setCity(e.target.value)}
248
+ />
249
+ ```
250
+
251
+ | Prop | Type | Default |
252
+ |---|---|---|
253
+ | `options` | `DropdownOption[]` (`{ value, label, icon? }`) | `[]` |
254
+ | `value` | `string \| number` | — |
255
+ | `label` / `placeholder` / `helptext` | `string` | — / `''` / `''` |
256
+ | `status` | `'default' \| 'error'` | `'default'` |
257
+ | `disabled` / `required` | `boolean` | `false` |
258
+ | `icon` | `ReactNode` — left icon | — |
259
+ | `onChange` | `ChangeEventHandler<HTMLSelectElement>` (`e.target.value`) | — |
260
+
261
+ ---
262
+
263
+ ## 9. MultiSearchDropdown
264
+
265
+ Multi-select searchable dropdown with Vietnamese diacritic-insensitive filtering and `Chip` tags.
266
+
267
+ ```tsx
268
+ import { MultiSearchDropdown } from '@chotot/clad-ui';
269
+
270
+ <MultiSearchDropdown
271
+ label="Ngành nghề"
272
+ options={opts}
273
+ value={selected}
274
+ onSelect={(opt) => setSelected([...selected, opt])}
275
+ onRemoveOption={(opt) => setSelected(selected.filter((x) => x.text !== opt.text))}
276
+ onClearData={() => setSelected([])}
277
+ />
278
+ ```
279
+
280
+ | Prop | Type | Default |
281
+ |---|---|---|
282
+ | `options` / `value` | `MultiSearchDropdownOption[]` (`{ text, html, data }`) | `[]` |
283
+ | `label` / `helptext` | `string` | `''` |
284
+ | `status` | `'default' \| 'error'` | `'default'` |
285
+ | `disabled` / `required` | `boolean` | `false` |
286
+ | `width` / `menuMaxHeight` | `CladSize` | `'full'` / `'$sm'` |
287
+ | `onSelect` / `onRemoveOption` / `onChange` | `(option, e) => void` | — |
288
+ | `onClearData` | `(e) => void` | — |
289
+
290
+ ---
291
+
292
+ ## 10. DatePicker
293
+
294
+ Controlled date picker (`Input` + floating Vietnamese calendar) supporting typed input, 3 date formats, year/month panels, and min/max/disabled dates.
295
+
296
+ ```tsx
297
+ import { DatePicker, DateFormat } from '@chotot/clad-ui';
298
+
299
+ const [date, setDate] = useState<Date | null>(null);
300
+ <DatePicker
301
+ label="Ngày sinh"
302
+ value={date}
303
+ onChange={(v) => setDate(v.dateObj)}
304
+ format={DateFormat.DdMmYyyy}
305
+ />
306
+ ```
307
+
308
+ | Prop | Type | Default |
309
+ |---|---|---|
310
+ | `value` | `Date \| null` (controlled) | required |
311
+ | `onChange` | `(value: DatePickerValue, event?) => void` (`{ dateObj, year, month, date }`) | required |
312
+ | `defaultValue` | `Date` — seeds displayed month when `value` is null | `new Date(2025, 1, 1)` |
313
+ | `label` / `helptext` | `string` | — / `''` |
314
+ | `format` | `DateFormat` (`'dd/mm/yyyy' \| 'dd/mm' \| 'mm/yyyy'`) | `DateFormat.DdMmYyyy` |
315
+ | `minDate` / `maxDate` | `Date \| null` | `null` |
316
+ | `minYear` / `maxYear` | `number` | `1900` / `2100` |
317
+ | `disabledDates` / `disabledDatesFn` | `Date[]` / `(date: Date) => boolean` | `[]` / — |
318
+ | `allowClear` / `allowInput` / `hightlightCurrentDate` | `boolean` | `true` |
319
+ | `disabled` / `required` / `defaultOpen` | `boolean` | `false` |
320
+
321
+ ---
322
+
323
+ ## 11. DateTimePicker
324
+
325
+ Extends `DatePicker` with a trailing time-selection column (`timeRange`). Picking both date and time closes the calendar.
326
+
327
+ ```tsx
328
+ import { DateTimePicker } from '@chotot/clad-ui';
329
+
330
+ <DateTimePicker
331
+ label="Thời gian hẹn"
332
+ value={date}
333
+ onChange={(v) => setDate(v.dateObj)}
334
+ timeRange={Array.from({ length: 19 }, (_, i) => 9 + i / 2)} // 09:00 -> 18:00 (30m steps)
335
+ />
336
+ ```
337
+
338
+ | Prop | Type | Default |
339
+ |---|---|---|
340
+ | `value` | `Date \| null` (controlled) | required |
341
+ | `onChange` | `(value: DateTimePickerValue, event?) => void` (`{ dateObj, year, month, date, hour, minute }`) | required |
342
+ | `timeRange` | `number[]` — hours; `.5` = `:30` (e.g. `13.5` = `13:30`) | `[0, 1, ..., 23]` |
343
+ | *(All `DatePicker` props)* | Same as `DatePicker` | — |
344
+
345
+ ---
346
+
347
+ ## 12. Slider
348
+
349
+ Single or dual-thumb (`type="range"`) slider with optional companion `Input` field(s).
350
+
351
+ ```tsx
352
+ import { Slider } from '@chotot/clad-ui';
353
+
354
+ <Slider
355
+ type="range"
356
+ value={[20, 80]}
357
+ min={0}
358
+ max={100}
359
+ unit=" triệu"
360
+ inputField
361
+ onChange={(e) => setRange(e.value)}
362
+ />
363
+ ```
364
+
365
+ | Prop | Type | Default |
366
+ |---|---|---|
367
+ | `type` | `'single' \| 'range'` | `'single'` |
368
+ | `value` | `number \| number[]` | `0` |
369
+ | `min` / `max` / `step` | `number` | `0` / `100` / `1` |
370
+ | `unit` | `string` | `''` |
371
+ | `inputField` | `boolean` — renders companion text input(s) | `false` |
372
+ | `width` / `inputWidth` | `CladSize` | `'buttonMaxWidth'` / `'xxxl'` |
373
+ | `disabled` | `boolean` | `false` |
374
+ | `onChange` | `(e: SliderOnChangeEvent) => void` (`e.value`) | — |
375
+
376
+ ---
377
+
378
+ ## 13. Checkbox
379
+
380
+ Controlled checkbox with optional text label on the right.
381
+
382
+ ```tsx
383
+ import { Checkbox } from '@chotot/clad-ui';
384
+
385
+ <Checkbox
386
+ name="agree"
387
+ checked={agreed}
388
+ onChange={(e) => setAgreed(e.target.checked)}
389
+ label="Tôi đồng ý với điều khoản"
390
+ />
391
+ ```
392
+
393
+ | Prop | Type | Default |
394
+ |---|---|---|
395
+ | `color` | `'primary' \| 'info' \| 'success' \| 'error' \| 'neutral'` | `'primary'` |
396
+ | `checked` | `boolean` | `false` |
397
+ | `indeterminate` | `boolean` — bulk partially-selected minus state | `false` |
398
+ | `onChange` | `ChangeEventHandler<HTMLInputElement>` | — |
399
+ | `label` | `string` | — |
400
+ | `disabled` | `boolean` | `false` |
401
+ | `id` / `name` / `value` | `string` | — |
402
+
403
+ ---
404
+
405
+ ## 14. RadioButton
406
+
407
+ Controlled radio input with indicator placed on the right when `label` is set.
408
+
409
+ ```tsx
410
+ import { RadioButton } from '@chotot/clad-ui';
411
+
412
+ <RadioButton
413
+ name="plan"
414
+ value="basic"
415
+ label="Gói cơ bản"
416
+ width="buttonMaxWidth"
417
+ checked={plan === 'basic'}
418
+ onChange={(e) => setPlan(e.target.value)}
419
+ />
420
+ ```
421
+
422
+ | Prop | Type | Default |
423
+ |---|---|---|
424
+ | `color` | `'primary' \| 'info' \| 'success' \| 'error' \| 'neutral'` | `'primary'` |
425
+ | `checked` | `boolean` | `false` |
426
+ | `label` | `string` | `''` |
427
+ | `width` | `RadioButtonWidth` (`'xs'`, `'xxl'`, `'buttonMaxWidth'`, `'full'`, ...) | `'xs'` |
428
+ | `disabled` | `boolean` | `false` |
429
+ | `onChange` | `ChangeEventHandler<HTMLInputElement>` | — |
430
+
431
+ ---
432
+
433
+ ## 15. ToggleSwitch
434
+
435
+ Controlled binary toggle switch (`md` 52×32 or `sm` 36×20).
436
+
437
+ ```tsx
438
+ import { ToggleSwitch } from '@chotot/clad-ui';
439
+
440
+ <ToggleSwitch id="notif" size="md" color="primary" checked={on} onChange={(e) => setOn(e.target.checked)} />
441
+ ```
442
+
443
+ | Prop | Type | Default |
444
+ |---|---|---|
445
+ | `size` | `'md' \| 'sm'` | `'md'` |
446
+ | `color` | `'primary' \| 'info' \| 'success' \| 'error' \| 'neutral'` | `'primary'` |
447
+ | `checked` | `boolean` | `false` |
448
+ | `disabled` | `boolean` | `false` |
449
+ | `onChange` | `(event: ChangeEvent<HTMLInputElement>) => void` | — |