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

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 +9127 -4278
  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 +294 -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 +196 -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} +3 -11
  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} +5 -16
  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} +2 -5
  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 +5 -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 +275 -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 +297 -0
  217. package/skills/clad-ui/references/components-inputs.md +451 -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 +124 -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 +145 -0
  224. package/skills/migrate-clad-ui-v3/references/token-and-linaria-mapping.md +194 -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,451 @@
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
+ > **Standard HTML Attributes (`id`, `data-testid`, `data-*`, `aria-*`):** All form components accept `id` and `{...rest}` attributes (`Input`, `TextArea`, `CurrencyInput`, `Dropdown`, `Checkbox`, `RadioButton`, `ToggleSwitch` forward `id` + `{...rest}` to their native `<input>`/`<textarea>`/`<select>` control; composite controls like `InputGroup`, `RangeInput`, `Searchbar`, `SearchInput`, `MultiSearchDropdown`, `DatePicker`, `DateTimePicker`, `Slider` forward them to their root container). Every component root renders `data-clad="<ComponentName>"`.
41
+
42
+ ---
43
+
44
+ ## 1. Input
45
+
46
+ Controlled text input with floating label, helptext, clear button, password reveal toggle, tooltip, and validation icon.
47
+
48
+ ```tsx
49
+ import { Input } from '@chotot/clad-ui';
50
+
51
+ <Input
52
+ label="Số điện thoại"
53
+ value={phone}
54
+ onChange={(e) => setPhone(e.target.value)}
55
+ status={hasError ? 'error' : 'default'}
56
+ helptext={hasError ? 'Số điện thoại không hợp lệ' : 'Nhập 10 chữ số'}
57
+ allowClear
58
+ />
59
+ ```
60
+
61
+ | Prop | Type | Default |
62
+ |---|---|---|
63
+ | `label` | `string` — floating label | — |
64
+ | `value` | `string \| number` (controlled) | `''` |
65
+ | `onChange` | `ChangeEventHandler<HTMLInputElement>` | — |
66
+ | `status` | `'default' \| 'warning' \| 'error' \| 'success'` | `'default'` |
67
+ | `helptext` | `string` — shown below input | — |
68
+ | `allowClear` | `boolean` — shows clear `×` button when non-empty | `true` |
69
+ | `showPassword` | `boolean` — reveal toggle when `type="password"` | `false` |
70
+ | `showValidationIcon` | `boolean` — status icon on right | `false` |
71
+ | `icon` | `ReactNode` — left icon | — |
72
+ | `tooltip` | `string` — hover tooltip on `(i)` icon | — |
73
+ | `characterLimit` | `number` | — |
74
+ | `disabled` / `required` | `boolean` | `false` |
75
+ | `placeholder` | `string` (also floats label) | — |
76
+ | `type` | `'text' \| 'email' \| 'number' \| 'password' \| 'tel'` | `'text'` |
77
+ | `onClear` | `MouseEventHandler` | — |
78
+ | `ref` | `Ref<HTMLInputElement>` | — |
79
+ | `className` | `string` (applied to outer container `div`) | — |
80
+
81
+ ---
82
+
83
+ ## 2. TextArea
84
+
85
+ Controlled multiline input with floating label, optional clear button, and character limit counter.
86
+
87
+ ```tsx
88
+ import { TextArea } from '@chotot/clad-ui';
89
+
90
+ <TextArea
91
+ label="Mô tả chi tiết"
92
+ lines={4}
93
+ value={desc}
94
+ onChange={(e) => setDesc(e.target.value)}
95
+ characterLimit={300}
96
+ helptext="Tối đa 300 ký tự"
97
+ />
98
+ ```
99
+
100
+ | Prop | Type | Default |
101
+ |---|---|---|
102
+ | `label` | `string` | — |
103
+ | `value` | `string` (controlled) | `''` |
104
+ | `lines` | `number` | `5` |
105
+ | `status` | `'default' \| 'warning' \| 'error'` | `'default'` |
106
+ | `helptext` | `string` | — |
107
+ | `allowClear` | `boolean` | `true` |
108
+ | `characterLimit` | `number` | — |
109
+ | `disabled` / `required` | `boolean` | `false` |
110
+
111
+ ---
112
+
113
+ ## 3. CurrencyInput
114
+
115
+ Formatted currency field with thousands/decimal separators, suffix, and dual change callbacks (`onChange` for raw numeric value and `onFormatChange` for formatted display string).
116
+
117
+ ```tsx
118
+ import { CurrencyInput } from '@chotot/clad-ui';
119
+
120
+ <CurrencyInput
121
+ label="Giá bán"
122
+ value={price}
123
+ suffix=" đ"
124
+ onChange={(e) => setPrice(e.target.value)}
125
+ onFormatChange={(formatted) => setFormattedPrice(formatted)}
126
+ />
127
+ ```
128
+
129
+ | Prop | Type | Default |
130
+ |---|---|---|
131
+ | `value` | `string \| number` | `''` |
132
+ | `status` | `'default' \| 'warning' \| 'error'` | `'default'` |
133
+ | `suffix` | `string` | `'đ'` |
134
+ | `separator` / `decimalSeparator` | `string` | `'.'` / `','` |
135
+ | `maxDigits` / `decimalsLimit` | `number` | `12` / `0` |
136
+ | `allowNegativeValue` | `boolean` | `false` |
137
+ | `onChange` | `ChangeEventHandler<HTMLInputElement>` (`e.target.value` is unformatted numeric string) | — |
138
+ | `onFormatChange` | `(value: string \| undefined) => void` | — |
139
+
140
+ ---
141
+
142
+ ## 4. InputGroup
143
+
144
+ Composes adjacent `Input`, `Dropdown`, or `CurrencyInput` elements into a single bordered group with shared `status` and `helptext`.
145
+
146
+ ```tsx
147
+ import { InputGroup, Dropdown, Input } from '@chotot/clad-ui';
148
+
149
+ <InputGroup status="default" helptext="Số điện thoại liên hệ">
150
+ <Dropdown label="Mã vùng" value="+84" options={[{ value: '+84', label: '+84' }]} width="xxxl" />
151
+ <Input label="Số điện thoại" value={phone} onChange={(e) => setPhone(e.target.value)} />
152
+ </InputGroup>
153
+ ```
154
+
155
+ | Prop | Type | Default |
156
+ |---|---|---|
157
+ | `children` | `ReactNode` | required |
158
+ | `status` | `'default' \| 'error'` | `'default'` |
159
+ | `helptext` | `string` | `''` |
160
+ | `helptextClassName` / `className` | `string` | `''` |
161
+
162
+ ---
163
+
164
+ ## 5. RangeInput
165
+
166
+ Groups two or more inputs horizontally with a separator (`-` by default or custom `separatorComponent`) and shared `helptext`.
167
+
168
+ ```tsx
169
+ import { RangeInput, Input } from '@chotot/clad-ui';
170
+
171
+ <RangeInput helptext="Nhập khoảng giá">
172
+ <Input label="Từ" value={min} onChange={(e) => setMin(e.target.value)} />
173
+ <Input label="Đến" value={max} onChange={(e) => setMax(e.target.value)} />
174
+ </RangeInput>
175
+ ```
176
+
177
+ | Prop | Type | Default |
178
+ |---|---|---|
179
+ | `children` | `ReactNode` | required |
180
+ | `status` | `'default' \| 'error'` | `'default'` |
181
+ | `helptext` | `string` | `''` |
182
+ | `separatorComponent` | `ReactNode` | `<p className="range-input-separator">-</p>` |
183
+
184
+ ---
185
+
186
+ ## 6. Searchbar
187
+
188
+ Pill-shaped search input (`40px` height) with leading search icon and optional clear button.
189
+
190
+ ```tsx
191
+ import { Searchbar } from '@chotot/clad-ui';
192
+
193
+ <Searchbar value={q} onChange={(e) => setQ(e.target.value)} placeholder="Tìm sản phẩm..." allowClear />
194
+ ```
195
+
196
+ | Prop | Type | Default |
197
+ |---|---|---|
198
+ | `value` / `defaultValue` | `string` | `''` |
199
+ | `placeholder` | `string` | `'Tìm sản phẩm...'` |
200
+ | `allowClear` | `boolean` | `true` |
201
+ | `disabled` | `boolean` | `false` |
202
+ | `classNames` | `{ container?, input?, actionBtn? }` | — |
203
+
204
+ ---
205
+
206
+ ## 7. SearchInput
207
+
208
+ Autocomplete / combobox input wrapping `Input` with a floating portal listbox (`@floating-ui/react-dom`).
209
+
210
+ ```tsx
211
+ import { SearchInput } from '@chotot/clad-ui';
212
+
213
+ <SearchInput
214
+ label="Địa điểm"
215
+ variant="dropdown"
216
+ value={val}
217
+ options={[{ text: 'TP. Hồ Chí Minh', html: '<b>TP.</b> Hồ Chí Minh', data: { id: 1 } }]}
218
+ onChange={(e) => setVal(e.value)}
219
+ showSearchIcon
220
+ />
221
+ ```
222
+
223
+ | Prop | Type | Default |
224
+ |---|---|---|
225
+ | `value` | `SearchInputValue \| null` (`{ text: string, selected?: SearchInputOption }`) | — |
226
+ | `variant` | `'input' \| 'dropdown'` | `'input'` |
227
+ | `options` | `SearchInputOption[]` (`{ text, html?, data? }`) | `[]` |
228
+ | `onInput` / `onSelect` / `onChange` | `((event: SearchInputEvent) => void) \| null` (`event.value`) | — |
229
+ | `label` / `helptext` / `tooltip` | `string` | — |
230
+ | `status` | `'default' \| 'error'` | `'default'` |
231
+ | `allowClear` | `boolean` | `true` |
232
+ | `showSearchIcon` | `boolean` | `false` |
233
+ | `disabled` / `required` | `boolean` | `false` |
234
+ | `width` / `menuMaxHeight` | `CladSize` | — / `'$sm'` |
235
+
236
+ ---
237
+
238
+ ## 8. Dropdown
239
+
240
+ Select menu built on `@floating-ui/react-dom` with floating label, option icons, and keyboard navigation.
241
+
242
+ ```tsx
243
+ import { Dropdown } from '@chotot/clad-ui';
244
+
245
+ <Dropdown
246
+ label="Tỉnh / Thành phố"
247
+ options={[{ value: 'hcm', label: 'TP.HCM' }, { value: 'hn', label: 'Hà Nội' }]}
248
+ value={city}
249
+ onChange={(e) => setCity(e.target.value)}
250
+ />
251
+ ```
252
+
253
+ | Prop | Type | Default |
254
+ |---|---|---|
255
+ | `options` | `DropdownOption[]` (`{ value, label, icon? }`) | `[]` |
256
+ | `value` | `string \| number` | — |
257
+ | `label` / `placeholder` / `helptext` | `string` | — / `''` / `''` |
258
+ | `status` | `'default' \| 'error'` | `'default'` |
259
+ | `disabled` / `required` | `boolean` | `false` |
260
+ | `icon` | `ReactNode` — left icon | — |
261
+ | `onChange` | `ChangeEventHandler<HTMLSelectElement>` (`e.target.value`) | — |
262
+
263
+ ---
264
+
265
+ ## 9. MultiSearchDropdown
266
+
267
+ Multi-select searchable dropdown with Vietnamese diacritic-insensitive filtering and `Chip` tags.
268
+
269
+ ```tsx
270
+ import { MultiSearchDropdown } from '@chotot/clad-ui';
271
+
272
+ <MultiSearchDropdown
273
+ label="Ngành nghề"
274
+ options={opts}
275
+ value={selected}
276
+ onSelect={(opt) => setSelected([...selected, opt])}
277
+ onRemoveOption={(opt) => setSelected(selected.filter((x) => x.text !== opt.text))}
278
+ onClearData={() => setSelected([])}
279
+ />
280
+ ```
281
+
282
+ | Prop | Type | Default |
283
+ |---|---|---|
284
+ | `options` / `value` | `MultiSearchDropdownOption[]` (`{ text, html, data }`) | `[]` |
285
+ | `label` / `helptext` | `string` | `''` |
286
+ | `status` | `'default' \| 'error'` | `'default'` |
287
+ | `disabled` / `required` | `boolean` | `false` |
288
+ | `width` / `menuMaxHeight` | `CladSize` | `'full'` / `'$sm'` |
289
+ | `onSelect` / `onRemoveOption` / `onChange` | `(option, e) => void` | — |
290
+ | `onClearData` | `(e) => void` | — |
291
+
292
+ ---
293
+
294
+ ## 10. DatePicker
295
+
296
+ Controlled date picker (`Input` + floating Vietnamese calendar) supporting typed input, 3 date formats, year/month panels, and min/max/disabled dates.
297
+
298
+ ```tsx
299
+ import { DatePicker, DateFormat } from '@chotot/clad-ui';
300
+
301
+ const [date, setDate] = useState<Date | null>(null);
302
+ <DatePicker
303
+ label="Ngày sinh"
304
+ value={date}
305
+ onChange={(v) => setDate(v.dateObj)}
306
+ format={DateFormat.DdMmYyyy}
307
+ />
308
+ ```
309
+
310
+ | Prop | Type | Default |
311
+ |---|---|---|
312
+ | `value` | `Date \| null` (controlled) | required |
313
+ | `onChange` | `(value: DatePickerValue, event?) => void` (`{ dateObj, year, month, date }`) | required |
314
+ | `defaultValue` | `Date` — seeds displayed month when `value` is null | `new Date(2025, 1, 1)` |
315
+ | `label` / `helptext` | `string` | — / `''` |
316
+ | `format` | `DateFormat` (`'dd/mm/yyyy' \| 'dd/mm' \| 'mm/yyyy'`) | `DateFormat.DdMmYyyy` |
317
+ | `minDate` / `maxDate` | `Date \| null` | `null` |
318
+ | `minYear` / `maxYear` | `number` | `1900` / `2100` |
319
+ | `disabledDates` / `disabledDatesFn` | `Date[]` / `(date: Date) => boolean` | `[]` / — |
320
+ | `allowClear` / `allowInput` / `hightlightCurrentDate` | `boolean` | `true` |
321
+ | `disabled` / `required` / `defaultOpen` | `boolean` | `false` |
322
+
323
+ ---
324
+
325
+ ## 11. DateTimePicker
326
+
327
+ Extends `DatePicker` with a trailing time-selection column (`timeRange`). Picking both date and time closes the calendar.
328
+
329
+ ```tsx
330
+ import { DateTimePicker } from '@chotot/clad-ui';
331
+
332
+ <DateTimePicker
333
+ label="Thời gian hẹn"
334
+ value={date}
335
+ onChange={(v) => setDate(v.dateObj)}
336
+ timeRange={Array.from({ length: 19 }, (_, i) => 9 + i / 2)} // 09:00 -> 18:00 (30m steps)
337
+ />
338
+ ```
339
+
340
+ | Prop | Type | Default |
341
+ |---|---|---|
342
+ | `value` | `Date \| null` (controlled) | required |
343
+ | `onChange` | `(value: DateTimePickerValue, event?) => void` (`{ dateObj, year, month, date, hour, minute }`) | required |
344
+ | `timeRange` | `number[]` — hours; `.5` = `:30` (e.g. `13.5` = `13:30`) | `[0, 1, ..., 23]` |
345
+ | *(All `DatePicker` props)* | Same as `DatePicker` | — |
346
+
347
+ ---
348
+
349
+ ## 12. Slider
350
+
351
+ Single or dual-thumb (`type="range"`) slider with optional companion `Input` field(s).
352
+
353
+ ```tsx
354
+ import { Slider } from '@chotot/clad-ui';
355
+
356
+ <Slider
357
+ type="range"
358
+ value={[20, 80]}
359
+ min={0}
360
+ max={100}
361
+ unit=" triệu"
362
+ inputField
363
+ onChange={(e) => setRange(e.value)}
364
+ />
365
+ ```
366
+
367
+ | Prop | Type | Default |
368
+ |---|---|---|
369
+ | `type` | `'single' \| 'range'` | `'single'` |
370
+ | `value` | `number \| number[]` | `0` |
371
+ | `min` / `max` / `step` | `number` | `0` / `100` / `1` |
372
+ | `unit` | `string` | `''` |
373
+ | `inputField` | `boolean` — renders companion text input(s) | `false` |
374
+ | `width` / `inputWidth` | `CladSize` | `'buttonMaxWidth'` / `'xxxl'` |
375
+ | `disabled` | `boolean` | `false` |
376
+ | `onChange` | `(e: SliderOnChangeEvent) => void` (`e.value`) | — |
377
+
378
+ ---
379
+
380
+ ## 13. Checkbox
381
+
382
+ Controlled checkbox with optional text label on the right.
383
+
384
+ ```tsx
385
+ import { Checkbox } from '@chotot/clad-ui';
386
+
387
+ <Checkbox
388
+ name="agree"
389
+ checked={agreed}
390
+ onChange={(e) => setAgreed(e.target.checked)}
391
+ label="Tôi đồng ý với điều khoản"
392
+ />
393
+ ```
394
+
395
+ | Prop | Type | Default |
396
+ |---|---|---|
397
+ | `color` | `'primary' \| 'info' \| 'success' \| 'error' \| 'neutral'` | `'primary'` |
398
+ | `checked` | `boolean` | `false` |
399
+ | `indeterminate` | `boolean` — bulk partially-selected minus state | `false` |
400
+ | `onChange` | `ChangeEventHandler<HTMLInputElement>` | — |
401
+ | `label` | `string` | — |
402
+ | `disabled` | `boolean` | `false` |
403
+ | `id` / `name` / `value` | `string` | — |
404
+
405
+ ---
406
+
407
+ ## 14. RadioButton
408
+
409
+ Controlled radio input with indicator placed on the right when `label` is set.
410
+
411
+ ```tsx
412
+ import { RadioButton } from '@chotot/clad-ui';
413
+
414
+ <RadioButton
415
+ name="plan"
416
+ value="basic"
417
+ label="Gói cơ bản"
418
+ width="buttonMaxWidth"
419
+ checked={plan === 'basic'}
420
+ onChange={(e) => setPlan(e.target.value)}
421
+ />
422
+ ```
423
+
424
+ | Prop | Type | Default |
425
+ |---|---|---|
426
+ | `color` | `'primary' \| 'info' \| 'success' \| 'error' \| 'neutral'` | `'primary'` |
427
+ | `checked` | `boolean` | `false` |
428
+ | `label` | `string` | `''` |
429
+ | `width` | `RadioButtonWidth` (`'xs'`, `'xxl'`, `'buttonMaxWidth'`, `'full'`, ...) | `'xs'` |
430
+ | `disabled` | `boolean` | `false` |
431
+ | `onChange` | `ChangeEventHandler<HTMLInputElement>` | — |
432
+
433
+ ---
434
+
435
+ ## 15. ToggleSwitch
436
+
437
+ Controlled binary toggle switch (`md` 52×32 or `sm` 36×20).
438
+
439
+ ```tsx
440
+ import { ToggleSwitch } from '@chotot/clad-ui';
441
+
442
+ <ToggleSwitch id="notif" size="md" color="primary" checked={on} onChange={(e) => setOn(e.target.checked)} />
443
+ ```
444
+
445
+ | Prop | Type | Default |
446
+ |---|---|---|
447
+ | `size` | `'md' \| 'sm'` | `'md'` |
448
+ | `color` | `'primary' \| 'info' \| 'success' \| 'error' \| 'neutral'` | `'primary'` |
449
+ | `checked` | `boolean` | `false` |
450
+ | `disabled` | `boolean` | `false` |
451
+ | `onChange` | `(event: ChangeEvent<HTMLInputElement>) => void` | — |