@chotot/clad-ui 3.0.0-next.2 → 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 (485) hide show
  1. package/CHANGELOG.md +675 -0
  2. package/README.md +173 -131
  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 +99 -99
  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/dist/components/Announcer/Announcer.d.ts.map +0 -1
  272. package/dist/components/Announcer/Announcer.styles.d.ts +0 -30
  273. package/dist/components/Announcer/Announcer.styles.d.ts.map +0 -1
  274. package/dist/components/Badge/Badge.d.ts.map +0 -1
  275. package/dist/components/Badge/Badge.styles.d.ts +0 -26
  276. package/dist/components/Badge/Badge.styles.d.ts.map +0 -1
  277. package/dist/components/Box/Box.d.ts.map +0 -1
  278. package/dist/components/Box/Box.styles.d.ts +0 -21
  279. package/dist/components/Box/Box.styles.d.ts.map +0 -1
  280. package/dist/components/Breadcrumbs/BreadcrumbItem.d.ts.map +0 -1
  281. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts.map +0 -1
  282. package/dist/components/Breadcrumbs/Breadcrumbs.styles.d.ts +0 -10
  283. package/dist/components/Breadcrumbs/Breadcrumbs.styles.d.ts.map +0 -1
  284. package/dist/components/Button/Button.d.ts.map +0 -1
  285. package/dist/components/Button/Button.styles.d.ts +0 -3
  286. package/dist/components/Button/Button.styles.d.ts.map +0 -1
  287. package/dist/components/Button/ButtonLink.d.ts.map +0 -1
  288. package/dist/components/Button/GhostButton.d.ts.map +0 -1
  289. package/dist/components/Button/GhostButton.styles.d.ts +0 -3
  290. package/dist/components/Button/GhostButton.styles.d.ts.map +0 -1
  291. package/dist/components/Button/IconButton.d.ts.map +0 -1
  292. package/dist/components/Button/constant.d.ts.map +0 -1
  293. package/dist/components/Checkbox/Checkbox.d.ts.map +0 -1
  294. package/dist/components/Checkbox/Checkbox.styles.d.ts +0 -5
  295. package/dist/components/Checkbox/Checkbox.styles.d.ts.map +0 -1
  296. package/dist/components/Chip/Chip.d.ts.map +0 -1
  297. package/dist/components/Chip/Chip.styles.d.ts +0 -13
  298. package/dist/components/Chip/Chip.styles.d.ts.map +0 -1
  299. package/dist/components/CurrencyInput/CurrencyInput.d.ts.map +0 -1
  300. package/dist/components/CurrencyInput/CurrencyInput.styles.d.ts +0 -27
  301. package/dist/components/CurrencyInput/CurrencyInput.styles.d.ts.map +0 -1
  302. package/dist/components/CurrencyInput/utils/_cleanValue.d.ts +0 -12
  303. package/dist/components/CurrencyInput/utils/_cleanValue.d.ts.map +0 -1
  304. package/dist/components/CurrencyInput/utils/_formatValue.d.ts +0 -6
  305. package/dist/components/CurrencyInput/utils/_formatValue.d.ts.map +0 -1
  306. package/dist/components/DatePicker/DatePicker.d.ts.map +0 -1
  307. package/dist/components/DatePicker/DateTimePicker.d.ts.map +0 -1
  308. package/dist/components/DatePicker/DateTimePicker.styles.d.ts +0 -61
  309. package/dist/components/DatePicker/DateTimePicker.styles.d.ts.map +0 -1
  310. package/dist/components/Dropdown/Dropdown.d.ts.map +0 -1
  311. package/dist/components/Dropdown/Dropdown.styles.d.ts +0 -11
  312. package/dist/components/Dropdown/Dropdown.styles.d.ts.map +0 -1
  313. package/dist/components/Grid/Col.d.ts.map +0 -1
  314. package/dist/components/Grid/Grid.d.ts.map +0 -1
  315. package/dist/components/Grid/Grid.styles.d.ts +0 -33
  316. package/dist/components/Grid/Grid.styles.d.ts.map +0 -1
  317. package/dist/components/Input/Input.d.ts.map +0 -1
  318. package/dist/components/Input/Input.styles.d.ts +0 -36
  319. package/dist/components/Input/Input.styles.d.ts.map +0 -1
  320. package/dist/components/Pagination/PageItem.d.ts.map +0 -1
  321. package/dist/components/Pagination/Pagination.d.ts.map +0 -1
  322. package/dist/components/Pagination/Pagination.style.d.ts +0 -7
  323. package/dist/components/Pagination/Pagination.style.d.ts.map +0 -1
  324. package/dist/components/Popover/Popover.d.ts.map +0 -1
  325. package/dist/components/Popover/Popover.styles.d.ts +0 -4
  326. package/dist/components/Popover/Popover.styles.d.ts.map +0 -1
  327. package/dist/components/RadioButton/RadioButton.d.ts.map +0 -1
  328. package/dist/components/RadioButton/RadioButton.styles.d.ts +0 -12
  329. package/dist/components/RadioButton/RadioButton.styles.d.ts.map +0 -1
  330. package/dist/components/RowItem/RowItem.d.ts.map +0 -1
  331. package/dist/components/RowItem/RowItem.styles.d.ts +0 -33
  332. package/dist/components/RowItem/RowItem.styles.d.ts.map +0 -1
  333. package/dist/components/ShapeIcon/ShapeIcon.d.ts.map +0 -1
  334. package/dist/components/ShapeIcon/ShapeIcon.styles.d.ts +0 -15
  335. package/dist/components/ShapeIcon/ShapeIcon.styles.d.ts.map +0 -1
  336. package/dist/components/Slider/Slider.d.ts.map +0 -1
  337. package/dist/components/Slider/Slider.styles.d.ts +0 -24
  338. package/dist/components/Slider/Slider.styles.d.ts.map +0 -1
  339. package/dist/components/Snack/Snack.d.ts.map +0 -1
  340. package/dist/components/Snack/Snack.styles.d.ts +0 -20
  341. package/dist/components/Snack/Snack.styles.d.ts.map +0 -1
  342. package/dist/components/Tabs/Tab.d.ts.map +0 -1
  343. package/dist/components/Tabs/Tabs.d.ts.map +0 -1
  344. package/dist/components/Tabs/Tabs.styles.d.ts +0 -43
  345. package/dist/components/Tabs/Tabs.styles.d.ts.map +0 -1
  346. package/dist/components/TextArea/TextArea.d.ts.map +0 -1
  347. package/dist/components/TextArea/TextArea.styles.d.ts +0 -19
  348. package/dist/components/TextArea/TextArea.styles.d.ts.map +0 -1
  349. package/dist/components/TextLabel/TextLabel.d.ts.map +0 -1
  350. package/dist/components/TextLabel/TextLabel.styles.d.ts +0 -10
  351. package/dist/components/TextLabel/TextLabel.styles.d.ts.map +0 -1
  352. package/dist/components/ToggleSwitch/ToggleSwitch.d.ts.map +0 -1
  353. package/dist/components/ToggleSwitch/ToggleSwitch.styles.d.ts +0 -22
  354. package/dist/components/ToggleSwitch/ToggleSwitch.styles.d.ts.map +0 -1
  355. package/dist/components/Tooltip/Tooltip.d.ts.map +0 -1
  356. package/dist/components/Tooltip/Tooltip.styles.d.ts +0 -33
  357. package/dist/components/Tooltip/Tooltip.styles.d.ts.map +0 -1
  358. package/dist/components/index.d.ts +0 -62
  359. package/dist/components/index.d.ts.map +0 -1
  360. package/dist/css/baseline.d.ts +0 -15
  361. package/dist/css/baseline.d.ts.map +0 -1
  362. package/dist/index.d.ts.map +0 -1
  363. package/dist/patterns/Drawer/Drawer.d.ts +0 -110
  364. package/dist/patterns/Drawer/Drawer.d.ts.map +0 -1
  365. package/dist/patterns/Drawer/Drawer.styles.d.ts +0 -39
  366. package/dist/patterns/Drawer/Drawer.styles.d.ts.map +0 -1
  367. package/dist/patterns/EmptyState/EmptyState.d.ts +0 -36
  368. package/dist/patterns/EmptyState/EmptyState.d.ts.map +0 -1
  369. package/dist/patterns/EmptyState/EmptyState.styles.d.ts +0 -4
  370. package/dist/patterns/EmptyState/EmptyState.styles.d.ts.map +0 -1
  371. package/dist/patterns/InputGroup/InputGroup.d.ts +0 -26
  372. package/dist/patterns/InputGroup/InputGroup.d.ts.map +0 -1
  373. package/dist/patterns/InputGroup/InputGroup.styles.d.ts +0 -8
  374. package/dist/patterns/InputGroup/InputGroup.styles.d.ts.map +0 -1
  375. package/dist/patterns/LegacyDialog/DialogMainIcon.d.ts +0 -2
  376. package/dist/patterns/LegacyDialog/DialogMainIcon.d.ts.map +0 -1
  377. package/dist/patterns/LegacyDialog/LegacyDialog.d.ts.map +0 -1
  378. package/dist/patterns/LegacyDialog/LegacyDialog.styles.d.ts +0 -13
  379. package/dist/patterns/LegacyDialog/LegacyDialog.styles.d.ts.map +0 -1
  380. package/dist/patterns/LegacyPopup/LegacyPopup.d.ts.map +0 -1
  381. package/dist/patterns/LegacyPopup/LegacyPopup.styles.d.ts +0 -27
  382. package/dist/patterns/LegacyPopup/LegacyPopup.styles.d.ts.map +0 -1
  383. package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.d.ts.map +0 -1
  384. package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.styles.d.ts +0 -26
  385. package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.styles.d.ts.map +0 -1
  386. package/dist/patterns/Popup/Popup.d.ts +0 -92
  387. package/dist/patterns/Popup/Popup.d.ts.map +0 -1
  388. package/dist/patterns/Popup/Popup.styles.d.ts +0 -41
  389. package/dist/patterns/Popup/Popup.styles.d.ts.map +0 -1
  390. package/dist/patterns/RangeInput/RangeInput.d.ts.map +0 -1
  391. package/dist/patterns/RangeInput/RangeInput.styles.d.ts +0 -5
  392. package/dist/patterns/RangeInput/RangeInput.styles.d.ts.map +0 -1
  393. package/dist/patterns/SearchInput/SearchInput.d.ts.map +0 -1
  394. package/dist/patterns/SearchInput/SearchInput.styles.d.ts +0 -10
  395. package/dist/patterns/SearchInput/SearchInput.styles.d.ts.map +0 -1
  396. package/dist/patterns/Searchbar/Searchbar.d.ts.map +0 -1
  397. package/dist/patterns/Searchbar/Searchbar.styles.d.ts +0 -3
  398. package/dist/patterns/Searchbar/Searchbar.styles.d.ts.map +0 -1
  399. package/dist/patterns/TagCloud/TagCloud.d.ts +0 -76
  400. package/dist/patterns/TagCloud/TagCloud.d.ts.map +0 -1
  401. package/dist/patterns/TagCloud/TagCloud.styles.d.ts +0 -15
  402. package/dist/patterns/TagCloud/TagCloud.styles.d.ts.map +0 -1
  403. package/dist/patterns/TagCloud/TagCloudMultiActive.d.ts +0 -25
  404. package/dist/patterns/TagCloud/TagCloudMultiActive.d.ts.map +0 -1
  405. package/dist/patterns/TagCloud/TagCloudSingleActive.d.ts +0 -22
  406. package/dist/patterns/TagCloud/TagCloudSingleActive.d.ts.map +0 -1
  407. package/dist/patterns/index.d.ts +0 -23
  408. package/dist/patterns/index.d.ts.map +0 -1
  409. package/dist/theme/chotot.d.ts +0 -1371
  410. package/dist/theme/chotot.d.ts.map +0 -1
  411. package/dist/theme/ct-job.d.ts +0 -826
  412. package/dist/theme/ct-job.d.ts.map +0 -1
  413. package/dist/theme/ct-pty.d.ts +0 -826
  414. package/dist/theme/ct-pty.d.ts.map +0 -1
  415. package/dist/theme/ct-veh.d.ts +0 -591
  416. package/dist/theme/ct-veh.d.ts.map +0 -1
  417. package/dist/theme/index.d.ts +0 -5
  418. package/dist/theme/index.d.ts.map +0 -1
  419. package/dist/theme/mudah.d.ts +0 -248
  420. package/dist/theme/mudah.d.ts.map +0 -1
  421. package/dist/theme/types.d.ts +0 -58
  422. package/dist/theme/types.d.ts.map +0 -1
  423. package/dist/theme-chotot.css +0 -2
  424. package/dist/theme-job.css +0 -2
  425. package/dist/theme-pty.css +0 -2
  426. package/dist/theme-veh.css +0 -2
  427. package/dist/typography/BodyAnnotation.d.ts.map +0 -1
  428. package/dist/typography/BodyCaption.d.ts.map +0 -1
  429. package/dist/typography/BodyPage.d.ts.map +0 -1
  430. package/dist/typography/BodySection.d.ts.map +0 -1
  431. package/dist/typography/DisplayAnnotation.d.ts.map +0 -1
  432. package/dist/typography/DisplayCaption.d.ts.map +0 -1
  433. package/dist/typography/DisplayPage.d.ts.map +0 -1
  434. package/dist/typography/DisplaySection.d.ts.map +0 -1
  435. package/dist/typography/HeaderAnnotation.d.ts.map +0 -1
  436. package/dist/typography/HeaderCaption.d.ts.map +0 -1
  437. package/dist/typography/HeaderPage.d.ts.map +0 -1
  438. package/dist/typography/HeaderSection.d.ts.map +0 -1
  439. package/dist/typography/LabelAnnotation.d.ts.map +0 -1
  440. package/dist/typography/LabelCaption.d.ts.map +0 -1
  441. package/dist/typography/LabelPage.d.ts.map +0 -1
  442. package/dist/typography/LabelSection.d.ts.map +0 -1
  443. package/dist/typography/NoteCaption.d.ts.map +0 -1
  444. package/dist/typography/NotePage.d.ts.map +0 -1
  445. package/dist/typography/NoteSection.d.ts.map +0 -1
  446. package/dist/typography/TaglineAnnotation.d.ts.map +0 -1
  447. package/dist/typography/TaglineCaption.d.ts.map +0 -1
  448. package/dist/typography/TaglineFootext.d.ts.map +0 -1
  449. package/dist/typography/TaglineSection.d.ts.map +0 -1
  450. package/dist/typography/index.d.ts.map +0 -1
  451. package/dist/utils/_inlineCreatePortal.d.ts.map +0 -1
  452. package/dist/utils/_normalizeArrowKey.d.ts +0 -10
  453. package/dist/utils/_normalizeArrowKey.d.ts.map +0 -1
  454. package/dist/utils/_simulateChangeEvent.d.ts +0 -25
  455. package/dist/utils/_simulateChangeEvent.d.ts.map +0 -1
  456. package/dist/utils/cleanHtml.d.ts.map +0 -1
  457. package/dist/utils/createUniversalPortal.d.ts.map +0 -1
  458. package/dist/utils/cx.d.ts +0 -22
  459. package/dist/utils/cx.d.ts.map +0 -1
  460. package/dist/utils/getBreakpointsValues.d.ts.map +0 -1
  461. package/dist/utils/index.d.ts +0 -7
  462. package/dist/utils/index.d.ts.map +0 -1
  463. package/dist/utils/noop.d.ts +0 -9
  464. package/dist/utils/noop.d.ts.map +0 -1
  465. package/dist/utils/scrollLock/index.d.ts +0 -7
  466. package/dist/utils/scrollLock/index.d.ts.map +0 -1
  467. package/dist/utils/scrollLock/scrollLock.styles.d.ts +0 -6
  468. package/dist/utils/scrollLock/scrollLock.styles.d.ts.map +0 -1
  469. package/dist/utils/scrollLock/useBodyScrollLock.d.ts.map +0 -1
  470. package/dist/utils/scrollTop.d.ts +0 -8
  471. package/dist/utils/scrollTop.d.ts.map +0 -1
  472. package/dist/utils/sx.d.ts +0 -174
  473. package/dist/utils/sx.d.ts.map +0 -1
  474. package/dist/utils/types.d.ts.map +0 -1
  475. package/theme/__snapshots__/chotot.spec.js.snap +0 -519
  476. package/theme/__snapshots__/mudah.spec.js.snap +0 -161
  477. package/theme/chotot.js +0 -1336
  478. package/theme/chotot.spec.js +0 -72
  479. package/theme/ct-job.js +0 -92
  480. package/theme/ct-pty.js +0 -92
  481. package/theme/ct-veh.js +0 -92
  482. package/theme/index.ts +0 -10
  483. package/theme/mudah.js +0 -333
  484. package/theme/mudah.spec.js +0 -9
  485. package/theme/types.ts +0 -61
package/README.md CHANGED
@@ -1,147 +1,189 @@
1
- <!-- badges -->
2
-
3
- [<img src="https://img.shields.io/badge/@chotot/clad--ui-3.0.0--next.2-FFBA00" alt="@chotot/clad-ui npm version" />](https://www.npmjs.com/package/@chotot/clad-ui)
4
- [<img src="https://img.shields.io/badge/@chotot/charts-1.0.2-FFBA00" alt="@chotot/charts npm version" />](https://www.npmjs.com/package/@chotot/charts)
5
- [<img src="https://img.shields.io/badge/react-%3E=18-0088CC" alt="React dependency version" />](https://github.com/facebook/react/)
6
- [<img src="https://img.shields.io/badge/linaria-4.2.10-DE2D68" alt="Linaria dependency version" />](https://github.com/callstack/linaria)
7
- [<img src="https://img.shields.io/badge/storybook-7.6.20-FF4785" alt="Storybook dependency version" />](https://storybook.js.org/)
8
- [<img src="https://github.com/carousell/clad-ui/actions/workflows/publish.yml/badge.svg" alt="Pipeline Status" />](https://github.com/carousell/clad-ui/actions/workflows/publish.yml)
9
- [<img src="https://sonar.chotot.org/api/project_badges/measure?project=web-clad-ui&metric=coverage" alt="Coverage" />](https://sonar.chotot.org/dashboard?id=web-clad-ui)
10
-
11
- <!-- /badges -->
12
-
13
- # Intro
14
-
15
- Clad UI Design System is a system of design tokens, guidelines, theming solution and components library that helps Chotot front end and mobile engineers build consistent UIs faster and more satisfyingly.
16
-
17
- ## Why the name Clad UI?
18
-
19
- Clad is the short form of classified ads, which is the main product of our group, besides, clad also mean “to be dressed or to be coated”
20
-
21
- ## What Clad UI Design System is
22
-
23
- - A unified solution for styling components for Chotot Web user-facing platforms
24
- - A theme specifications that define primitive Clad UI design tokens
25
- - A collection of reusable components from atomic inputs to composite components
26
- - A workbench (a.k.a kitchen sink) to preview all available components and their usage guide
27
- - A set of CLI tools to assist generate new components...
28
-
29
- ## What Clad UI Design System is NOT
30
-
31
- - A base framework for doing Chotot web apps (refer to Next.js framework)
32
- - An end user-facing web app
33
- - Any full web page
34
-
35
- ## Colophon (A.K.A prerequisites to this design system)
36
-
37
- ### Building components:
38
-
39
- - 📚 [Storybook](https://storybook.js.org) for UI component development and [auto-generated docs](https://medium.com/storybookjs/storybook-docs-sneak-peak-5be78445094a)
40
- - ⚛️ [React](https://reactjs.org/) declarative component-centric UI. React is also our core UI library of Front End development
41
- - 💅 [Linaria](https://linaria.now.sh//) which enable CSS-in-JS styling and extract all CSS to external CSS file.
42
- - 📄 [System UI Theme Specification](https://system-ui.com/theme/) as a standard design token format with theme-aware [`css` props helper](https://styled-system.com/css)
43
- - ⬇️ [MDX](https://mdxjs.com) (part of Storybook) for seamless React / JSX documentation
44
-
45
- Maintaining the system:
46
-
47
- - 🐟 [Babel](https://babeljs.io/) and [module resolver plugin](https://github.com/tleunen/babel-plugin-module-resolver) for transpiling modern JS and static theming
48
- - 📦 [NPM](https://www.npmjs.com/) for packaging and distribution
49
- - 🟧 [pnpm](https://pnpm.io/) as package manager's CLI
50
- - 🧪 [Jest](https://jestjs.io/) as test runner for unit testing
51
- - 🐐 [react-testing-library](https://github.com/testing-library/react-testing-library) to assist unit testing React components
52
- - 🚥 [Github Actions](https://docs.github.com/en/actions) for Continuous integration (test and publish)
53
- - ✅ [Chromatic](https://www.chromatic.com/) to prevent UI bugs in components (by Storybook maintainers)
54
-
55
- ## Components Status
56
-
57
- **Date update:**
58
- 2025-07-31
59
-
60
- | No | Component | Web | iOS | Android |
61
- | --- | ------------------------ | ------- | --- | ------- |
62
- | 1 | Announcer | ✅ 1.0+ | ✅ | |
63
- | 2 | Box | ✅ 1.0+ | | |
64
- | 3 | Breadcrumbs | ✅ 1.0+ | | |
65
- | 4 | Badge | ✅ 1.0+ | ✅ | ✅ |
66
- | 5 | Button | ✅ 1.2+ | ✅ | ✅ |
67
- | 6 | Checkbox | ✅ 1.0+ | | ✅ |
68
- | 7 | Chip | ✅ 1.2+ | ✅ | ✅ |
69
- | 8 | CurrencyInput | ✅ 1.0+ | | ✅ |
70
- | 9 | DatePicker | ✅ 1.5+ | | |
71
- | 10 | DateTimePicker | ✅ 1.5+ | | |
72
- | 11 | Dialog | ✅ 1.0+ | ✅ | |
73
- | 12 | Drawer\* | ✅ 1.0+ | ✅ | ✅ |
74
- | 13 | Dropdown | ✅ 1.0+ | ✅ | |
75
- | 14 | EmptyState | ✅ 1.0+ | ✅ | ✅ |
76
- | 15 | GhostButton (ButtonLink) | ✅ 1.0+ | | |
77
- | 16 | Grid | ✅ 1.0+ | | |
78
- | 17 | LegacyDialog | ✅ 1.0+ | | |
79
- | 18 | LegacyPopup | ✅ 1.0+ | | |
80
- | 19 | MultiSearchDropdown\* | ✅ 1.0+ | | ✅ |
81
- | 20 | Notification | N/A | | ✅ |
82
- | 21 | Input/ Input Text | ✅ 1.2+ | ✅ | ✅ |
83
- | 22 | InputGroup | ✅ 1.0+ | ✅ | |
84
- | 23 | Popup | ✅ 1.2+ | | ✅ |
85
- | 24 | RadioButton | ✅ 1.0+ | ✅ | ✅ |
86
- | 25 | RowItem | ✅ 1.0+ | ✅ | |
87
- | 26 | SearchInput | ✅ 1.2+ | | |
88
- | 27 | ShapeIcon | ✅ 1.0+ | | |
89
- | 28 | Slider | ✅ 1.0+ | | |
90
- | 29 | Snack | ✅ 1.0+ | ✅ | ✅ |
91
- | 30 | Stepper | | | ✅ |
92
- | 31 | Tabs | ✅ 1.2+ | ✅ | ✅ |
93
- | 32 | TagCloud | ✅ 1.0+ | ✅ | |
94
- | 33 | TextArea | ✅ 1.0+ | | ✅ |
95
- | 34 | TextLabel | ✅ 1.5+ | ✅ | ✅ |
96
- | 35 | ToggleSwitch | ✅ 1.0+ | | ✅ |
97
- | 36 | Tooltip | ✅ 1.0+ | ✅ | ✅ |
98
- | 37 | Pagination | 🧪 1.6+ | | |
99
- | 38 | InputRange | 🧪 2.1+ | | |
100
- | 39 | Searchbar | 🧪 2.1+ | | |
101
-
102
- **Legend:**
103
- ✅: stable; 🧪: beta; ⚠️: deprecated; [1.0+]: since this version
104
-
105
- **\* Other Naming:**
106
-
107
- - `MultiSearchDropdown` name in Android is `Input multi selected chip`
108
- - `Drawer` in iOS / Android is `*BottomSheet`
109
-
110
- ## Getting started
111
-
112
- Refer to [Overview > Getting-started document](https://clad-ui.chotot.org/?path=/docs/overview-getting-started--page).
113
-
114
- ## Verifying clad-ui components in production
115
-
116
- Open browser Devtool (F12) and add following CSS to the `:root` element:
1
+ # @chotot/clad-ui
2
+
3
+ Clad UI v3 React component library and design system built on **Tailwind CSS v4**. Provides multi-vertical design tokens (`chotot`, `pty`, `job`, `veh`), 60+ React components and patterns, 24 Typography components, Brand logos, a token-aware `cn` class merger, and built-in AI coding skills.
4
+
5
+ ## Installation
6
+
7
+ Install `@chotot/clad-ui` (`@chotot/icons` is included automatically as a dependency and exposed at `@chotot/clad-ui/icons`):
8
+
9
+ ```bash
10
+ pnpm add @chotot/clad-ui
11
+ ```
12
+
13
+ If your project uses `pnpm` v10+, add `@chotot/clad-ui` to `pnpm.onlyBuiltDependencies` in your `package.json` so its `postinstall` script can automatically sync AI coding skills into `.claude/skills/`, `.cursor/skills/`, and `.agents/skills/`:
14
+
15
+ ```json
16
+ {
17
+ "pnpm": {
18
+ "onlyBuiltDependencies": ["@chotot/clad-ui"]
19
+ }
20
+ }
21
+ ```
22
+
23
+ ---
24
+
25
+ ## Setup
26
+
27
+ This package ships its own baseline styles (`baseline.css`), so **Tailwind's default preflight must be disabled** when using the Tailwind v4 CSS preset.
28
+
29
+ ### Option 1: Pre-compiled CSS (Zero Tailwind Build Config)
30
+
31
+ Import the pre-compiled stylesheet once in your root layout or `_app.tsx`:
32
+
33
+ ```tsx
34
+ import '@chotot/clad-ui/styles.css';
35
+ ```
36
+
37
+ ### Option 2: Tailwind CSS v4 Preset (JIT Build)
38
+
39
+ If your project compiles CSS with Tailwind CSS v4 (`@tailwindcss/postcss`, `@tailwindcss/vite`, or `@tailwindcss/cli`), import `theme.css`, `utilities.css`, and `@chotot/clad-ui/preset.css` in your global stylesheet:
117
40
 
118
41
  ```css
119
- :root {
120
- /* Highlight clad-ui components: setting the color of element `outline` */
121
- --cladebug: magenta;
122
- /* [Optional] Display component label: setting the label's pseudo-element `display` property */
123
- --cladebug-label: block;
42
+ /* app/globals.css */
43
+ @layer theme, base, components, utilities;
44
+ @import 'tailwindcss/theme.css' layer(theme);
45
+ @import 'tailwindcss/utilities.css' layer(utilities);
46
+
47
+ /* Import Clad UI preset (includes @source directive for library components): */
48
+ @import '@chotot/clad-ui/preset.css';
49
+ ```
50
+
51
+ ### Option 3: Tailwind Browser CDN / SSR Inline Bundle
52
+
53
+ For projects that load Tailwind via the browser CDN script (e.g. SEO content hubs or standalone SSR pages), use `getBundledCss` (Node.js runtime/build-time utility) to inline the design system CSS:
54
+
55
+ ```tsx
56
+ import Script from 'next/script';
57
+ import { getBundledCss } from '@chotot/clad-ui/utils/bundleCss';
58
+
59
+ export default function Document() {
60
+ return (
61
+ <html>
62
+ <head>
63
+ <Script
64
+ src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"
65
+ strategy="beforeInteractive"
66
+ />
67
+ <style
68
+ type="text/tailwindcss"
69
+ dangerouslySetInnerHTML={{
70
+ __html: getBundledCss(),
71
+ }}
72
+ />
73
+ </head>
74
+ <body>{/* your app */}</body>
75
+ </html>
76
+ );
124
77
  }
125
78
  ```
126
79
 
127
- ## Frequently Asked Questions
80
+ ---
128
81
 
129
- #### 1. Does this design system work with `Next.js` apps?
82
+ ## Usage
83
+
84
+ ### React Components, Typography, Brand & Icons
85
+
86
+ All components, 24 Typography components, Brand logos (`ChototLogoText`, `CtC2C`, `CtProperty`, `CtVehicle`, `Tot`), and `cn` are exported directly from `@chotot/clad-ui`:
87
+
88
+ ```tsx
89
+ import {
90
+ Button,
91
+ HeaderSection,
92
+ BodySection,
93
+ ShapeIcon,
94
+ ChototLogoText,
95
+ cn,
96
+ } from '@chotot/clad-ui';
97
+ import { Call, ChevronRight } from '@chotot/clad-ui/icons';
98
+
99
+ export function ContactCard({ highlighted = false }: { highlighted?: boolean }) {
100
+ return (
101
+ <div
102
+ className={cn(
103
+ 'flex items-center justify-between p-4 rounded-card bg-background-primary border border-border-thin',
104
+ highlighted && 'bg-background-brand-light border-border-brand'
105
+ )}
106
+ >
107
+ <div className="flex items-center gap-4">
108
+ <ChototLogoText />
109
+ <div>
110
+ <HeaderSection as="h3">Liên hệ người bán</HeaderSection>
111
+ <BodySection className="text-text-secondary">Hỗ trợ nhanh qua điện thoại</BodySection>
112
+ </div>
113
+ </div>
114
+ <Button
115
+ color="primary"
116
+ variant="solid"
117
+ size="md"
118
+ leftIcon={<ShapeIcon Icon={Call} size="sm" />}
119
+ rightIcon={<ShapeIcon Icon={ChevronRight} size="sm" />}
120
+ >
121
+ Gọi ngay
122
+ </Button>
123
+ </div>
124
+ );
125
+ }
126
+ ```
130
127
 
131
- Yes. But it requires custom next.js config. Refer to [Chotot Next.js Framework](https://github.com/carousell/ct-next-starterkit/) to see how it's configured.
128
+ ### Token-Aware `cn` Class Merger
132
129
 
133
- ## Technical Debts
130
+ `@chotot/clad-ui` exports `cn` (powered by `shadcn-ui/cn` and pre-configured with Clad UI's custom `@theme` tokens). Use `cn` instead of installing `clsx` or `tailwind-merge` separately—it automatically resolves conflicts between Clad UI typography classes (`text-body-section`, `text-header-page`) and semantic text colors (`text-text-primary`, `text-text-error`), as well as semantic border radius (`rounded-card-small`, `rounded-card`) and shadows (`shadow-below`, `shadow-floating`).
134
131
 
135
- #### 1. Linaria lack an object serializer that assist snapshot testing.
132
+ ```tsx
133
+ import { cn } from '@chotot/clad-ui';
136
134
 
137
- Currently, snapshots contains only rendered HTML and hashed class names. Ideally, snapshots should contain rendered HTML and associated CSS combined as component's signature.
135
+ // Keeps both 'text-body-caption' (font-size) and 'text-text-error' (text-color),
136
+ // while overriding 'text-body-section' with 'text-body-caption':
137
+ const classes = cn('text-body-section text-text-primary', 'text-body-caption text-text-error');
138
+ // => resolves to "text-body-caption text-text-error"
139
+ ```
138
140
 
139
- [Github issue to keep track](https://github.com/callstack/linaria/issues/633)
141
+ ---
140
142
 
141
- #### 2. Dynamic theming using CSS Variables
143
+ ## Multi-Vertical Theming (`data-theme`)
142
144
 
143
- We need to explore into implementing dynamic theme switching using CSS variables. Maybe we can look into making use of theme token as CSS variable token.
145
+ Apply a vertical theme via the `data-theme` attribute on `<html>`, `<body>`, or any subtree container:
146
+
147
+ ```html
148
+ <!-- Chợ Tốt (Default): Yellow brand -->
149
+ <body data-theme="chotot">...</body>
150
+
151
+ <!-- Nhà Tốt (Property): Orange brand -->
152
+ <body data-theme="pty">...</body>
153
+
154
+ <!-- Việc Làm Tốt (Jobs): Blue brand -->
155
+ <body data-theme="job">...</body>
156
+
157
+ <!-- Chợ Tốt Xe (Vehicles): Yellow brand + Dark header -->
158
+ <body data-theme="veh">...</body>
159
+ ```
160
+
161
+ All semantic tokens (`bg-background-brand`, `text-text-brand`, `border-border-brand`, etc.) adapt automatically with zero runtime JS overhead.
162
+
163
+ ---
164
+
165
+ ## AI Coding Skills
166
+
167
+ `@chotot/clad-ui` ships three official AI agent skills under `skills/`:
168
+
169
+ - **`clad-ui`** — Complete component catalog, semantic token cheat-sheet, layout recipes, and best practices for building UIs with Clad UI v3.
170
+ - **`migrate-clad-ui-v3`** — Automated step-by-step migration playbook for upgrading consumer repositories from `@chotot/clad-ui` v2 (Linaria) to `@chotot/clad-ui` v3 (Tailwind CSS v4).
171
+ - **`clad-ui-feedback`** — Deduplicated GitHub issue reporter (`bug`, `enhancement`, `feature`) for consumer developers to submit feedback or request new props/icons directly on `carousell/clad-ui`.
172
+
173
+ Skills are installed automatically on `pnpm install`, or can be synced manually at any time:
174
+
175
+ ```bash
176
+ pnpm exec clad-ui-helper
177
+ ```
144
178
 
145
179
  ---
146
180
 
147
- **© 2020-2025 Chotot.com.** Apache-2.0 license.
181
+ ## Package Exports
182
+
183
+ | Export path | Description |
184
+ | ------------------------------------------ | ----------------------------------------------------------------------------------- |
185
+ | `@chotot/clad-ui` | React components, 24 Typography components, Brand logos, `cn`, and TypeScript types |
186
+ | `@chotot/clad-ui/icons` | 255 React SVG system icons (re-exported from `@chotot/icons`) |
187
+ | `@chotot/clad-ui/styles.css` | Pre-compiled CSS (design tokens + baseline + component styles) |
188
+ | `@chotot/clad-ui/preset.css` | Source CSS with `@source` directive for Tailwind CSS v4 JIT builds |
189
+ | `@chotot/clad-ui/utils/bundleCss` | `getBundledCss()` helper for Tailwind CDN / SSR inline styles |
@@ -0,0 +1,5 @@
1
+ import * as React from 'react';
2
+ declare const SvgChototLogoText: React.FC<React.SVGProps<SVGSVGElement>> & {
3
+ type?: string;
4
+ };
5
+ export default SvgChototLogoText;
@@ -0,0 +1,5 @@
1
+ import * as React from 'react';
2
+ declare const SvgCtC2C: React.FC<React.SVGProps<SVGSVGElement>> & {
3
+ type?: string;
4
+ };
5
+ export default SvgCtC2C;
@@ -0,0 +1,5 @@
1
+ import * as React from 'react';
2
+ declare const SvgCtProperty: React.FC<React.SVGProps<SVGSVGElement>> & {
3
+ type?: string;
4
+ };
5
+ export default SvgCtProperty;
@@ -0,0 +1,5 @@
1
+ import * as React from 'react';
2
+ declare const SvgCtVehicle: React.FC<React.SVGProps<SVGSVGElement>> & {
3
+ type?: string;
4
+ };
5
+ export default SvgCtVehicle;
@@ -0,0 +1,5 @@
1
+ import * as React from 'react';
2
+ declare const SvgTot: React.FC<React.SVGProps<SVGSVGElement>> & {
3
+ type?: string;
4
+ };
5
+ export default SvgTot;
@@ -0,0 +1,5 @@
1
+ export { default as ChototLogoText } from './ChototLogoText';
2
+ export { default as CtC2C } from './CtC2C';
3
+ export { default as CtProperty } from './CtProperty';
4
+ export { default as CtVehicle } from './CtVehicle';
5
+ export { default as Tot } from './Tot';
@@ -0,0 +1 @@
1
+ var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return s}});