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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (541) hide show
  1. package/CHANGELOG.md +675 -0
  2. package/README.md +156 -156
  3. package/dist/brand/ChototLogoText.d.ts +5 -0
  4. package/dist/brand/CtC2C.d.ts +5 -0
  5. package/dist/brand/CtProperty.d.ts +5 -0
  6. package/dist/brand/CtVehicle.d.ts +5 -0
  7. package/dist/brand/Tot.d.ts +5 -0
  8. package/dist/brand/index.d.ts +5 -0
  9. package/dist/chunk-Bmb41Sf3.cjs +1 -0
  10. package/dist/clad-ui.cjs +2 -0
  11. package/dist/clad-ui.d.ts +2 -0
  12. package/dist/clad-ui.es.js +9000 -4224
  13. package/dist/components/Announcer/Announcer.d.ts +3 -54
  14. package/dist/components/Announcer/announcer.styles.d.ts +39 -0
  15. package/dist/components/Announcer/index.d.ts +2 -0
  16. package/dist/components/Announcer/types.d.ts +41 -0
  17. package/dist/components/Badge/Badge.d.ts +2 -44
  18. package/dist/components/Badge/badge.styles.d.ts +57 -0
  19. package/dist/components/Badge/index.d.ts +4 -0
  20. package/dist/components/Badge/types.d.ts +33 -0
  21. package/dist/components/Box/Box.d.ts +7 -99
  22. package/dist/components/Box/index.d.ts +2 -0
  23. package/dist/components/Box/types.d.ts +89 -0
  24. package/dist/components/Breadcrumbs/BreadcrumbItem.d.ts +3 -5
  25. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +3 -17
  26. package/dist/components/Breadcrumbs/breadcrumbs.styles.d.ts +2 -0
  27. package/dist/components/Breadcrumbs/index.d.ts +3 -0
  28. package/dist/components/Breadcrumbs/types.d.ts +18 -0
  29. package/dist/components/Button/Button.d.ts +3 -76
  30. package/dist/components/Button/ButtonLink.d.ts +2 -3
  31. package/dist/components/Button/GhostButton.d.ts +3 -47
  32. package/dist/components/Button/IconButton.d.ts +2 -10
  33. package/dist/components/Button/button.styles.d.ts +242 -0
  34. package/dist/components/Button/constant.d.ts +1 -2
  35. package/dist/components/Button/index.d.ts +5 -0
  36. package/dist/components/Button/types.d.ts +72 -0
  37. package/dist/components/Checkbox/Checkbox.d.ts +3 -46
  38. package/dist/components/Checkbox/checkbox.styles.d.ts +27 -0
  39. package/dist/components/Checkbox/index.d.ts +2 -0
  40. package/dist/components/Checkbox/types.d.ts +40 -0
  41. package/dist/components/Chip/Chip.d.ts +3 -70
  42. package/dist/components/Chip/chip.styles.d.ts +66 -0
  43. package/dist/components/Chip/index.d.ts +2 -0
  44. package/dist/components/Chip/types.d.ts +22 -0
  45. package/dist/components/CurrencyInput/CurrencyInput.d.ts +3 -39
  46. package/dist/components/CurrencyInput/currency-input.styles.d.ts +21 -0
  47. package/dist/components/CurrencyInput/index.d.ts +5 -0
  48. package/dist/components/CurrencyInput/types.d.ts +96 -0
  49. package/dist/components/CurrencyInput/utils.d.ts +18 -0
  50. package/dist/components/DatePicker/DatePicker.d.ts +2 -138
  51. package/dist/components/DatePicker/DateTimePicker.d.ts +2 -137
  52. package/dist/components/DatePicker/date-picker.styles.d.ts +9 -0
  53. package/dist/components/DatePicker/date-time-picker.styles.d.ts +10 -0
  54. package/dist/components/DatePicker/index.d.ts +4 -0
  55. package/dist/components/DatePicker/types.d.ts +286 -0
  56. package/dist/components/Drawer/Drawer.d.ts +36 -0
  57. package/dist/components/Drawer/Drawer.pw.fixtures.d.ts +9 -0
  58. package/dist/components/Drawer/index.d.ts +3 -0
  59. package/dist/components/Drawer/types.d.ts +191 -0
  60. package/dist/components/Dropdown/Dropdown.d.ts +3 -94
  61. package/dist/components/Dropdown/dropdown.styles.d.ts +18 -0
  62. package/dist/components/Dropdown/index.d.ts +4 -0
  63. package/dist/components/Dropdown/types.d.ts +89 -0
  64. package/dist/components/EmptyState/EmptyState.d.ts +4 -0
  65. package/dist/components/EmptyState/empty-state.styles.d.ts +3 -0
  66. package/dist/components/EmptyState/index.d.ts +2 -0
  67. package/dist/components/EmptyState/types.d.ts +55 -0
  68. package/dist/components/Grid/Col.d.ts +4 -35
  69. package/dist/components/Grid/Grid.d.ts +8 -55
  70. package/dist/components/Grid/Grid.pw.fixtures.d.ts +3 -0
  71. package/dist/components/Grid/index.d.ts +3 -0
  72. package/dist/components/Grid/types.d.ts +66 -0
  73. package/dist/components/Input/Input.d.ts +3 -116
  74. package/dist/components/Input/index.d.ts +2 -0
  75. package/dist/components/Input/input.styles.d.ts +24 -0
  76. package/dist/components/Input/types.d.ts +55 -0
  77. package/dist/components/InputGroup/InputGroup.d.ts +4 -0
  78. package/dist/components/InputGroup/index.d.ts +4 -0
  79. package/dist/components/InputGroup/input-group.styles.d.ts +18 -0
  80. package/dist/components/InputGroup/types.d.ts +20 -0
  81. package/dist/components/LegacyDialog/DialogMainIcon.d.ts +3 -0
  82. package/dist/components/LegacyDialog/LegacyDialog.d.ts +5 -0
  83. package/dist/components/LegacyDialog/index.d.ts +3 -0
  84. package/dist/{patterns/LegacyDialog/LegacyDialog.d.ts → components/LegacyDialog/types.d.ts} +2 -10
  85. package/dist/components/LegacyPopup/LegacyPopup.d.ts +6 -0
  86. package/dist/components/LegacyPopup/index.d.ts +2 -0
  87. package/dist/{patterns/LegacyPopup/LegacyPopup.d.ts → components/LegacyPopup/types.d.ts} +4 -15
  88. package/dist/components/MultiSearchDropdown/MultiSearchDropdown.d.ts +10 -0
  89. package/dist/components/MultiSearchDropdown/index.d.ts +4 -0
  90. package/dist/components/MultiSearchDropdown/multi-search-dropdown.styles.d.ts +18 -0
  91. package/dist/{patterns/MultiSearchDropdown/MultiSearchDropdown.d.ts → components/MultiSearchDropdown/types.d.ts} +6 -19
  92. package/dist/components/Pagination/PageItem.d.ts +3 -21
  93. package/dist/components/Pagination/Pagination.d.ts +2 -46
  94. package/dist/components/Pagination/index.d.ts +5 -0
  95. package/dist/components/Pagination/pagination.styles.d.ts +37 -0
  96. package/dist/components/Pagination/types.d.ts +66 -0
  97. package/dist/components/Popover/Popover.d.ts +4 -44
  98. package/dist/components/Popover/Popover.pw.fixtures.d.ts +6 -0
  99. package/dist/components/Popover/index.d.ts +2 -0
  100. package/dist/components/Popover/popover.styles.d.ts +1 -0
  101. package/dist/components/Popover/types.d.ts +44 -0
  102. package/dist/components/Popup/Popup.d.ts +31 -0
  103. package/dist/components/Popup/Popup.pw.fixtures.d.ts +5 -0
  104. package/dist/components/Popup/index.d.ts +3 -0
  105. package/dist/components/Popup/types.d.ts +145 -0
  106. package/dist/components/RadioButton/RadioButton.d.ts +3 -51
  107. package/dist/components/RadioButton/index.d.ts +4 -0
  108. package/dist/components/RadioButton/radio-button.styles.d.ts +27 -0
  109. package/dist/components/RadioButton/types.d.ts +46 -0
  110. package/dist/components/RangeInput/RangeInput.d.ts +4 -0
  111. package/dist/components/RangeInput/index.d.ts +3 -0
  112. package/dist/components/RangeInput/range-input.styles.d.ts +1 -0
  113. package/dist/{patterns/RangeInput/RangeInput.d.ts → components/RangeInput/types.d.ts} +1 -4
  114. package/dist/components/RowItem/RowItem.d.ts +8 -76
  115. package/dist/components/RowItem/index.d.ts +2 -0
  116. package/dist/components/RowItem/rowitem.styles.d.ts +36 -0
  117. package/dist/components/RowItem/types.d.ts +66 -0
  118. package/dist/components/SearchInput/SearchInput.d.ts +5 -0
  119. package/dist/components/SearchInput/index.d.ts +3 -0
  120. package/dist/components/SearchInput/search-input.styles.d.ts +18 -0
  121. package/dist/{patterns/SearchInput/SearchInput.d.ts → components/SearchInput/types.d.ts} +19 -25
  122. package/dist/components/Searchbar/Searchbar.d.ts +3 -0
  123. package/dist/components/Searchbar/index.d.ts +3 -0
  124. package/dist/components/Searchbar/searchbar.styles.d.ts +1 -0
  125. package/dist/{patterns/Searchbar/Searchbar.d.ts → components/Searchbar/types.d.ts} +6 -9
  126. package/dist/components/ShapeIcon/ShapeIcon.d.ts +3 -53
  127. package/dist/components/ShapeIcon/index.d.ts +2 -0
  128. package/dist/components/ShapeIcon/shape-icon.styles.d.ts +156 -0
  129. package/dist/components/ShapeIcon/types.d.ts +5 -0
  130. package/dist/components/Slider/Slider.d.ts +3 -57
  131. package/dist/components/Slider/index.d.ts +3 -0
  132. package/dist/components/Slider/slider.styles.d.ts +1 -0
  133. package/dist/components/Slider/types.d.ts +59 -0
  134. package/dist/components/Snack/Snack.d.ts +4 -48
  135. package/dist/components/Snack/index.d.ts +3 -0
  136. package/dist/components/Snack/snack.styles.d.ts +21 -0
  137. package/dist/components/Snack/types.d.ts +48 -0
  138. package/dist/components/Tabs/Tab.d.ts +3 -67
  139. package/dist/components/Tabs/Tabs.d.ts +14 -61
  140. package/dist/components/Tabs/index.d.ts +4 -0
  141. package/dist/components/Tabs/tabs.styles.d.ts +59 -0
  142. package/dist/components/Tabs/types.d.ts +97 -0
  143. package/dist/components/TagCloud/TagCloud.d.ts +11 -0
  144. package/dist/components/TagCloud/index.d.ts +2 -0
  145. package/dist/components/TagCloud/tagcloud.styles.d.ts +18 -0
  146. package/dist/components/TagCloud/types.d.ts +26 -0
  147. package/dist/components/TextArea/TextArea.d.ts +3 -100
  148. package/dist/components/TextArea/index.d.ts +4 -0
  149. package/dist/components/TextArea/text-area.styles.d.ts +21 -0
  150. package/dist/components/TextArea/types.d.ts +98 -0
  151. package/dist/components/TextLabel/TextLabel.d.ts +3 -35
  152. package/dist/components/TextLabel/index.d.ts +2 -0
  153. package/dist/components/TextLabel/textlabel.styles.d.ts +51 -0
  154. package/dist/components/TextLabel/types.d.ts +32 -0
  155. package/dist/components/ToggleSwitch/ToggleSwitch.d.ts +3 -41
  156. package/dist/components/ToggleSwitch/index.d.ts +4 -0
  157. package/dist/components/ToggleSwitch/toggle-switch.styles.d.ts +39 -0
  158. package/dist/components/ToggleSwitch/types.d.ts +33 -0
  159. package/dist/components/Tooltip/Tooltip.d.ts +4 -98
  160. package/dist/components/Tooltip/Tooltip.pw.fixtures.d.ts +1 -0
  161. package/dist/components/Tooltip/index.d.ts +2 -0
  162. package/dist/components/Tooltip/tooltip.styles.d.ts +18 -0
  163. package/dist/components/Tooltip/types.d.ts +24 -0
  164. package/dist/forge/index.cjs +0 -0
  165. package/dist/forge/index.d.ts +8 -0
  166. package/dist/forge/index.es.js +0 -0
  167. package/dist/icons.cjs +1 -0
  168. package/dist/icons.d.ts +1 -0
  169. package/dist/icons.es.js +1 -0
  170. package/dist/index.d.ts +82 -71
  171. package/dist/styles.css +2 -0
  172. package/dist/{utils/types.d.ts → types/index.d.ts} +0 -1
  173. package/dist/typography/BodyAnnotation.d.ts +8 -6
  174. package/dist/typography/BodyCaption.d.ts +8 -6
  175. package/dist/typography/BodyPage.d.ts +8 -6
  176. package/dist/typography/BodySection.d.ts +8 -6
  177. package/dist/typography/DisplayAnnotation.d.ts +8 -6
  178. package/dist/typography/DisplayCaption.d.ts +8 -6
  179. package/dist/typography/DisplayPage.d.ts +8 -6
  180. package/dist/typography/DisplayPrice.d.ts +21 -0
  181. package/dist/typography/DisplaySection.d.ts +8 -6
  182. package/dist/typography/HeaderAnnotation.d.ts +8 -6
  183. package/dist/typography/HeaderCaption.d.ts +8 -6
  184. package/dist/typography/HeaderPage.d.ts +8 -6
  185. package/dist/typography/HeaderSection.d.ts +8 -6
  186. package/dist/typography/LabelAnnotation.d.ts +8 -6
  187. package/dist/typography/LabelCaption.d.ts +8 -6
  188. package/dist/typography/LabelPage.d.ts +8 -6
  189. package/dist/typography/LabelSection.d.ts +8 -6
  190. package/dist/typography/NoteCaption.d.ts +8 -6
  191. package/dist/typography/NotePage.d.ts +8 -6
  192. package/dist/typography/NoteSection.d.ts +8 -6
  193. package/dist/typography/TaglineAnnotation.d.ts +8 -6
  194. package/dist/typography/TaglineCaption.d.ts +8 -6
  195. package/dist/typography/TaglineFootext.d.ts +8 -6
  196. package/dist/typography/TaglineSection.d.ts +8 -6
  197. package/dist/typography/index.d.ts +25 -24
  198. package/dist/utils/_inlineCreatePortal.d.ts +0 -1
  199. package/dist/utils/bundleCss.cjs +1 -0
  200. package/dist/utils/bundleCss.d.ts +6 -0
  201. package/dist/utils/bundleCss.es.js +18 -0
  202. package/dist/utils/cleanHtml.d.ts +4 -7
  203. package/dist/utils/cn.d.ts +5 -0
  204. package/dist/utils/createUniversalPortal.d.ts +4 -14
  205. package/dist/utils/floating.d.ts +52 -0
  206. package/dist/utils/getBreakpointsValues.d.ts +4 -9
  207. package/dist/utils/sizes.d.ts +28 -0
  208. package/dist/utils/storyStyles.d.ts +21 -0
  209. package/dist/utils/themeTokens.d.ts +327 -0
  210. package/dist/utils/{scrollLock/useBodyScrollLock.d.ts → useBodyScrollLock.d.ts} +0 -1
  211. package/dist/utils/useScrollTop.d.ts +8 -0
  212. package/package.json +98 -104
  213. package/scripts/postinstall.cjs +180 -0
  214. package/skills/clad-ui/SKILL.md +109 -0
  215. package/skills/clad-ui/agents/openai.yaml +4 -0
  216. package/skills/clad-ui/references/components-display-layout.md +295 -0
  217. package/skills/clad-ui/references/components-inputs.md +449 -0
  218. package/skills/clad-ui/references/components-overlays-nav.md +314 -0
  219. package/skills/clad-ui/references/tokens.md +134 -0
  220. package/skills/clad-ui-feedback/SKILL.md +128 -0
  221. package/skills/migrate-clad-ui-v3/SKILL.md +123 -0
  222. package/skills/migrate-clad-ui-v3/agents/openai.yaml +4 -0
  223. package/skills/migrate-clad-ui-v3/references/component-api-changes.md +139 -0
  224. package/skills/migrate-clad-ui-v3/references/token-and-linaria-mapping.md +186 -0
  225. package/src/styles/base/base.css +440 -0
  226. package/src/styles/components/announcer.css +182 -0
  227. package/src/styles/components/badge.css +102 -0
  228. package/src/styles/components/box.css +61 -0
  229. package/src/styles/components/breadcrumbs.css +75 -0
  230. package/src/styles/components/button.css +527 -0
  231. package/src/styles/components/checkbox.css +115 -0
  232. package/src/styles/components/chip.css +155 -0
  233. package/src/styles/components/currency-input.css +146 -0
  234. package/src/styles/components/date-picker.css +305 -0
  235. package/src/styles/components/date-time-picker.css +64 -0
  236. package/src/styles/components/drawer.css +496 -0
  237. package/src/styles/components/dropdown.css +186 -0
  238. package/src/styles/components/empty-state.css +30 -0
  239. package/src/styles/components/grid.css +212 -0
  240. package/src/styles/components/index.css +36 -0
  241. package/src/styles/components/input-group.css +85 -0
  242. package/src/styles/components/input.css +255 -0
  243. package/src/styles/components/legacy-dialog.css +129 -0
  244. package/src/styles/components/legacy-popup.css +209 -0
  245. package/src/styles/components/multi-search-dropdown.css +240 -0
  246. package/src/styles/components/pagination.css +68 -0
  247. package/src/styles/components/popover.css +8 -0
  248. package/src/styles/components/popup.css +331 -0
  249. package/src/styles/components/radio-button.css +130 -0
  250. package/src/styles/components/range-input.css +40 -0
  251. package/src/styles/components/rowitem.css +75 -0
  252. package/src/styles/components/search-input.css +89 -0
  253. package/src/styles/components/searchbar.css +46 -0
  254. package/src/styles/components/shape-icon.css +199 -0
  255. package/src/styles/components/slider.css +232 -0
  256. package/src/styles/components/snack.css +144 -0
  257. package/src/styles/components/tabs.css +128 -0
  258. package/src/styles/components/tagcloud.css +50 -0
  259. package/src/styles/components/text-area.css +176 -0
  260. package/src/styles/components/textlabel.css +75 -0
  261. package/src/styles/components/toggle-switch.css +147 -0
  262. package/src/styles/components/tooltip.css +93 -0
  263. package/src/styles/index.css +10 -0
  264. package/src/styles/preset.css +6 -0
  265. package/src/styles/theme/colors/base.css +108 -0
  266. package/src/styles/theme/colors/semantic.css +135 -0
  267. package/src/styles/theme/index.css +57 -0
  268. package/src/styles/theme/typography/base.css +53 -0
  269. package/src/styles/theme/typography/semantic.css +176 -0
  270. package/src/styles/theme/variables.css +83 -0
  271. package/ai/clad-ui-helper.js +0 -267
  272. package/ai/knowledge-base/README.md +0 -154
  273. package/ai/knowledge-base/clad-ui-database.json +0 -9378
  274. package/ai/knowledge-base/component-categories.json +0 -616
  275. package/ai/knowledge-base/components/metadata/charts-axis.json +0 -31
  276. package/ai/knowledge-base/components/metadata/charts-barchart.json +0 -57
  277. package/ai/knowledge-base/components/metadata/charts-basechart.tsx.json +0 -31
  278. package/ai/knowledge-base/components/metadata/charts-chartshared.json +0 -31
  279. package/ai/knowledge-base/components/metadata/charts-linechart.json +0 -189
  280. package/ai/knowledge-base/components/metadata/charts-piechart.json +0 -57
  281. package/ai/knowledge-base/components/metadata/components-announcer.json +0 -215
  282. package/ai/knowledge-base/components/metadata/components-badge.json +0 -168
  283. package/ai/knowledge-base/components/metadata/components-box.json +0 -348
  284. package/ai/knowledge-base/components/metadata/components-breadcrumbs.json +0 -75
  285. package/ai/knowledge-base/components/metadata/components-button.json +0 -187
  286. package/ai/knowledge-base/components/metadata/components-checkbox.json +0 -161
  287. package/ai/knowledge-base/components/metadata/components-chip.json +0 -266
  288. package/ai/knowledge-base/components/metadata/components-currencyinput.json +0 -136
  289. package/ai/knowledge-base/components/metadata/components-datepicker.json +0 -87
  290. package/ai/knowledge-base/components/metadata/components-dropdown.json +0 -282
  291. package/ai/knowledge-base/components/metadata/components-grid.json +0 -92
  292. package/ai/knowledge-base/components/metadata/components-input.json +0 -432
  293. package/ai/knowledge-base/components/metadata/components-pagination.json +0 -111
  294. package/ai/knowledge-base/components/metadata/components-popover.json +0 -63
  295. package/ai/knowledge-base/components/metadata/components-radiobutton.json +0 -170
  296. package/ai/knowledge-base/components/metadata/components-rowitem.json +0 -281
  297. package/ai/knowledge-base/components/metadata/components-shapeicon.json +0 -139
  298. package/ai/knowledge-base/components/metadata/components-slider.json +0 -177
  299. package/ai/knowledge-base/components/metadata/components-snack.json +0 -181
  300. package/ai/knowledge-base/components/metadata/components-tabs.json +0 -169
  301. package/ai/knowledge-base/components/metadata/components-textarea.json +0 -285
  302. package/ai/knowledge-base/components/metadata/components-textlabel.json +0 -129
  303. package/ai/knowledge-base/components/metadata/components-toggleswitch.json +0 -134
  304. package/ai/knowledge-base/components/metadata/components-tooltip.json +0 -291
  305. package/ai/knowledge-base/components/metadata/patterns-drawer.json +0 -310
  306. package/ai/knowledge-base/components/metadata/patterns-emptystate.json +0 -106
  307. package/ai/knowledge-base/components/metadata/patterns-inputgroup.json +0 -105
  308. package/ai/knowledge-base/components/metadata/patterns-legacydialog.json +0 -177
  309. package/ai/knowledge-base/components/metadata/patterns-legacypopup.json +0 -236
  310. package/ai/knowledge-base/components/metadata/patterns-multisearchdropdown.json +0 -249
  311. package/ai/knowledge-base/components/metadata/patterns-popup.json +0 -268
  312. package/ai/knowledge-base/components/metadata/patterns-rangeinput.json +0 -105
  313. package/ai/knowledge-base/components/metadata/patterns-searchbar.json +0 -150
  314. package/ai/knowledge-base/components/metadata/patterns-searchinput.json +0 -312
  315. package/ai/knowledge-base/components/metadata/patterns-tagcloud.json +0 -244
  316. package/ai/knowledge-base/components/metadata/summaries.json +0 -610
  317. package/ai/knowledge-base/design-tokens/tokens.json +0 -483
  318. package/ai/knowledge-base/patterns/documentation.json +0 -131
  319. package/ai/knowledge-base/prompts/common-system-prompt.md +0 -592
  320. package/ai/knowledge-base/prompts/figma-system-prompt.md +0 -396
  321. package/ai/knowledge-base/search-index/icons/asset-icons.json +0 -1
  322. package/ai/knowledge-base/search-index/icons/collection.json +0 -5
  323. package/ai/knowledge-base/search-index/icons/system-icons.json +0 -1
  324. package/ai/knowledge-base/search-index/search-index.json +0 -899
  325. package/ai/knowledge-base/validation-rules/component-rules.json +0 -658
  326. package/ai/skill/SKILL.md +0 -103
  327. package/dist/components/Announcer/Announcer.d.ts.map +0 -1
  328. package/dist/components/Announcer/Announcer.styles.d.ts +0 -30
  329. package/dist/components/Announcer/Announcer.styles.d.ts.map +0 -1
  330. package/dist/components/Badge/Badge.d.ts.map +0 -1
  331. package/dist/components/Badge/Badge.styles.d.ts +0 -26
  332. package/dist/components/Badge/Badge.styles.d.ts.map +0 -1
  333. package/dist/components/Box/Box.d.ts.map +0 -1
  334. package/dist/components/Box/Box.styles.d.ts +0 -21
  335. package/dist/components/Box/Box.styles.d.ts.map +0 -1
  336. package/dist/components/Breadcrumbs/BreadcrumbItem.d.ts.map +0 -1
  337. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts.map +0 -1
  338. package/dist/components/Breadcrumbs/Breadcrumbs.styles.d.ts +0 -10
  339. package/dist/components/Breadcrumbs/Breadcrumbs.styles.d.ts.map +0 -1
  340. package/dist/components/Button/Button.d.ts.map +0 -1
  341. package/dist/components/Button/Button.styles.d.ts +0 -3
  342. package/dist/components/Button/Button.styles.d.ts.map +0 -1
  343. package/dist/components/Button/ButtonLink.d.ts.map +0 -1
  344. package/dist/components/Button/GhostButton.d.ts.map +0 -1
  345. package/dist/components/Button/GhostButton.styles.d.ts +0 -3
  346. package/dist/components/Button/GhostButton.styles.d.ts.map +0 -1
  347. package/dist/components/Button/IconButton.d.ts.map +0 -1
  348. package/dist/components/Button/constant.d.ts.map +0 -1
  349. package/dist/components/Checkbox/Checkbox.d.ts.map +0 -1
  350. package/dist/components/Checkbox/Checkbox.styles.d.ts +0 -5
  351. package/dist/components/Checkbox/Checkbox.styles.d.ts.map +0 -1
  352. package/dist/components/Chip/Chip.d.ts.map +0 -1
  353. package/dist/components/Chip/Chip.styles.d.ts +0 -13
  354. package/dist/components/Chip/Chip.styles.d.ts.map +0 -1
  355. package/dist/components/CurrencyInput/CurrencyInput.d.ts.map +0 -1
  356. package/dist/components/CurrencyInput/CurrencyInput.styles.d.ts +0 -27
  357. package/dist/components/CurrencyInput/CurrencyInput.styles.d.ts.map +0 -1
  358. package/dist/components/CurrencyInput/utils/_cleanValue.d.ts +0 -12
  359. package/dist/components/CurrencyInput/utils/_cleanValue.d.ts.map +0 -1
  360. package/dist/components/CurrencyInput/utils/_formatValue.d.ts +0 -6
  361. package/dist/components/CurrencyInput/utils/_formatValue.d.ts.map +0 -1
  362. package/dist/components/DatePicker/DatePicker.d.ts.map +0 -1
  363. package/dist/components/DatePicker/DateTimePicker.d.ts.map +0 -1
  364. package/dist/components/DatePicker/DateTimePicker.styles.d.ts +0 -61
  365. package/dist/components/DatePicker/DateTimePicker.styles.d.ts.map +0 -1
  366. package/dist/components/Dropdown/Dropdown.d.ts.map +0 -1
  367. package/dist/components/Dropdown/Dropdown.styles.d.ts +0 -11
  368. package/dist/components/Dropdown/Dropdown.styles.d.ts.map +0 -1
  369. package/dist/components/Grid/Col.d.ts.map +0 -1
  370. package/dist/components/Grid/Grid.d.ts.map +0 -1
  371. package/dist/components/Grid/Grid.styles.d.ts +0 -33
  372. package/dist/components/Grid/Grid.styles.d.ts.map +0 -1
  373. package/dist/components/Input/Input.d.ts.map +0 -1
  374. package/dist/components/Input/Input.styles.d.ts +0 -36
  375. package/dist/components/Input/Input.styles.d.ts.map +0 -1
  376. package/dist/components/Pagination/PageItem.d.ts.map +0 -1
  377. package/dist/components/Pagination/Pagination.d.ts.map +0 -1
  378. package/dist/components/Pagination/Pagination.style.d.ts +0 -7
  379. package/dist/components/Pagination/Pagination.style.d.ts.map +0 -1
  380. package/dist/components/Popover/Popover.d.ts.map +0 -1
  381. package/dist/components/Popover/Popover.styles.d.ts +0 -4
  382. package/dist/components/Popover/Popover.styles.d.ts.map +0 -1
  383. package/dist/components/RadioButton/RadioButton.d.ts.map +0 -1
  384. package/dist/components/RadioButton/RadioButton.styles.d.ts +0 -12
  385. package/dist/components/RadioButton/RadioButton.styles.d.ts.map +0 -1
  386. package/dist/components/RowItem/RowItem.d.ts.map +0 -1
  387. package/dist/components/RowItem/RowItem.styles.d.ts +0 -33
  388. package/dist/components/RowItem/RowItem.styles.d.ts.map +0 -1
  389. package/dist/components/ShapeIcon/ShapeIcon.d.ts.map +0 -1
  390. package/dist/components/ShapeIcon/ShapeIcon.styles.d.ts +0 -15
  391. package/dist/components/ShapeIcon/ShapeIcon.styles.d.ts.map +0 -1
  392. package/dist/components/Slider/Slider.d.ts.map +0 -1
  393. package/dist/components/Slider/Slider.styles.d.ts +0 -24
  394. package/dist/components/Slider/Slider.styles.d.ts.map +0 -1
  395. package/dist/components/Snack/Snack.d.ts.map +0 -1
  396. package/dist/components/Snack/Snack.styles.d.ts +0 -20
  397. package/dist/components/Snack/Snack.styles.d.ts.map +0 -1
  398. package/dist/components/Tabs/Tab.d.ts.map +0 -1
  399. package/dist/components/Tabs/Tabs.d.ts.map +0 -1
  400. package/dist/components/Tabs/Tabs.styles.d.ts +0 -43
  401. package/dist/components/Tabs/Tabs.styles.d.ts.map +0 -1
  402. package/dist/components/TextArea/TextArea.d.ts.map +0 -1
  403. package/dist/components/TextArea/TextArea.styles.d.ts +0 -19
  404. package/dist/components/TextArea/TextArea.styles.d.ts.map +0 -1
  405. package/dist/components/TextLabel/TextLabel.d.ts.map +0 -1
  406. package/dist/components/TextLabel/TextLabel.styles.d.ts +0 -10
  407. package/dist/components/TextLabel/TextLabel.styles.d.ts.map +0 -1
  408. package/dist/components/ToggleSwitch/ToggleSwitch.d.ts.map +0 -1
  409. package/dist/components/ToggleSwitch/ToggleSwitch.styles.d.ts +0 -22
  410. package/dist/components/ToggleSwitch/ToggleSwitch.styles.d.ts.map +0 -1
  411. package/dist/components/Tooltip/Tooltip.d.ts.map +0 -1
  412. package/dist/components/Tooltip/Tooltip.styles.d.ts +0 -33
  413. package/dist/components/Tooltip/Tooltip.styles.d.ts.map +0 -1
  414. package/dist/components/index.d.ts +0 -62
  415. package/dist/components/index.d.ts.map +0 -1
  416. package/dist/css/baseline.d.ts +0 -15
  417. package/dist/css/baseline.d.ts.map +0 -1
  418. package/dist/index.d.ts.map +0 -1
  419. package/dist/patterns/Drawer/Drawer.d.ts +0 -110
  420. package/dist/patterns/Drawer/Drawer.d.ts.map +0 -1
  421. package/dist/patterns/Drawer/Drawer.styles.d.ts +0 -39
  422. package/dist/patterns/Drawer/Drawer.styles.d.ts.map +0 -1
  423. package/dist/patterns/EmptyState/EmptyState.d.ts +0 -36
  424. package/dist/patterns/EmptyState/EmptyState.d.ts.map +0 -1
  425. package/dist/patterns/EmptyState/EmptyState.styles.d.ts +0 -4
  426. package/dist/patterns/EmptyState/EmptyState.styles.d.ts.map +0 -1
  427. package/dist/patterns/InputGroup/InputGroup.d.ts +0 -26
  428. package/dist/patterns/InputGroup/InputGroup.d.ts.map +0 -1
  429. package/dist/patterns/InputGroup/InputGroup.styles.d.ts +0 -8
  430. package/dist/patterns/InputGroup/InputGroup.styles.d.ts.map +0 -1
  431. package/dist/patterns/LegacyDialog/DialogMainIcon.d.ts +0 -2
  432. package/dist/patterns/LegacyDialog/DialogMainIcon.d.ts.map +0 -1
  433. package/dist/patterns/LegacyDialog/LegacyDialog.d.ts.map +0 -1
  434. package/dist/patterns/LegacyDialog/LegacyDialog.styles.d.ts +0 -13
  435. package/dist/patterns/LegacyDialog/LegacyDialog.styles.d.ts.map +0 -1
  436. package/dist/patterns/LegacyPopup/LegacyPopup.d.ts.map +0 -1
  437. package/dist/patterns/LegacyPopup/LegacyPopup.styles.d.ts +0 -27
  438. package/dist/patterns/LegacyPopup/LegacyPopup.styles.d.ts.map +0 -1
  439. package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.d.ts.map +0 -1
  440. package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.styles.d.ts +0 -26
  441. package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.styles.d.ts.map +0 -1
  442. package/dist/patterns/Popup/Popup.d.ts +0 -92
  443. package/dist/patterns/Popup/Popup.d.ts.map +0 -1
  444. package/dist/patterns/Popup/Popup.styles.d.ts +0 -41
  445. package/dist/patterns/Popup/Popup.styles.d.ts.map +0 -1
  446. package/dist/patterns/RangeInput/RangeInput.d.ts.map +0 -1
  447. package/dist/patterns/RangeInput/RangeInput.styles.d.ts +0 -5
  448. package/dist/patterns/RangeInput/RangeInput.styles.d.ts.map +0 -1
  449. package/dist/patterns/SearchInput/SearchInput.d.ts.map +0 -1
  450. package/dist/patterns/SearchInput/SearchInput.styles.d.ts +0 -10
  451. package/dist/patterns/SearchInput/SearchInput.styles.d.ts.map +0 -1
  452. package/dist/patterns/Searchbar/Searchbar.d.ts.map +0 -1
  453. package/dist/patterns/Searchbar/Searchbar.styles.d.ts +0 -3
  454. package/dist/patterns/Searchbar/Searchbar.styles.d.ts.map +0 -1
  455. package/dist/patterns/TagCloud/TagCloud.d.ts +0 -76
  456. package/dist/patterns/TagCloud/TagCloud.d.ts.map +0 -1
  457. package/dist/patterns/TagCloud/TagCloud.styles.d.ts +0 -15
  458. package/dist/patterns/TagCloud/TagCloud.styles.d.ts.map +0 -1
  459. package/dist/patterns/TagCloud/TagCloudMultiActive.d.ts +0 -25
  460. package/dist/patterns/TagCloud/TagCloudMultiActive.d.ts.map +0 -1
  461. package/dist/patterns/TagCloud/TagCloudSingleActive.d.ts +0 -22
  462. package/dist/patterns/TagCloud/TagCloudSingleActive.d.ts.map +0 -1
  463. package/dist/patterns/index.d.ts +0 -23
  464. package/dist/patterns/index.d.ts.map +0 -1
  465. package/dist/theme/chotot.d.ts +0 -1371
  466. package/dist/theme/chotot.d.ts.map +0 -1
  467. package/dist/theme/ct-job.d.ts +0 -826
  468. package/dist/theme/ct-job.d.ts.map +0 -1
  469. package/dist/theme/ct-pty.d.ts +0 -826
  470. package/dist/theme/ct-pty.d.ts.map +0 -1
  471. package/dist/theme/ct-veh.d.ts +0 -591
  472. package/dist/theme/ct-veh.d.ts.map +0 -1
  473. package/dist/theme/index.d.ts +0 -5
  474. package/dist/theme/index.d.ts.map +0 -1
  475. package/dist/theme/mudah.d.ts +0 -248
  476. package/dist/theme/mudah.d.ts.map +0 -1
  477. package/dist/theme/types.d.ts +0 -58
  478. package/dist/theme/types.d.ts.map +0 -1
  479. package/dist/theme-chotot.css +0 -2
  480. package/dist/theme-job.css +0 -2
  481. package/dist/theme-pty.css +0 -2
  482. package/dist/theme-veh.css +0 -2
  483. package/dist/typography/BodyAnnotation.d.ts.map +0 -1
  484. package/dist/typography/BodyCaption.d.ts.map +0 -1
  485. package/dist/typography/BodyPage.d.ts.map +0 -1
  486. package/dist/typography/BodySection.d.ts.map +0 -1
  487. package/dist/typography/DisplayAnnotation.d.ts.map +0 -1
  488. package/dist/typography/DisplayCaption.d.ts.map +0 -1
  489. package/dist/typography/DisplayPage.d.ts.map +0 -1
  490. package/dist/typography/DisplaySection.d.ts.map +0 -1
  491. package/dist/typography/HeaderAnnotation.d.ts.map +0 -1
  492. package/dist/typography/HeaderCaption.d.ts.map +0 -1
  493. package/dist/typography/HeaderPage.d.ts.map +0 -1
  494. package/dist/typography/HeaderSection.d.ts.map +0 -1
  495. package/dist/typography/LabelAnnotation.d.ts.map +0 -1
  496. package/dist/typography/LabelCaption.d.ts.map +0 -1
  497. package/dist/typography/LabelPage.d.ts.map +0 -1
  498. package/dist/typography/LabelSection.d.ts.map +0 -1
  499. package/dist/typography/NoteCaption.d.ts.map +0 -1
  500. package/dist/typography/NotePage.d.ts.map +0 -1
  501. package/dist/typography/NoteSection.d.ts.map +0 -1
  502. package/dist/typography/TaglineAnnotation.d.ts.map +0 -1
  503. package/dist/typography/TaglineCaption.d.ts.map +0 -1
  504. package/dist/typography/TaglineFootext.d.ts.map +0 -1
  505. package/dist/typography/TaglineSection.d.ts.map +0 -1
  506. package/dist/typography/index.d.ts.map +0 -1
  507. package/dist/utils/_inlineCreatePortal.d.ts.map +0 -1
  508. package/dist/utils/_normalizeArrowKey.d.ts +0 -10
  509. package/dist/utils/_normalizeArrowKey.d.ts.map +0 -1
  510. package/dist/utils/_simulateChangeEvent.d.ts +0 -25
  511. package/dist/utils/_simulateChangeEvent.d.ts.map +0 -1
  512. package/dist/utils/cleanHtml.d.ts.map +0 -1
  513. package/dist/utils/createUniversalPortal.d.ts.map +0 -1
  514. package/dist/utils/cx.d.ts +0 -22
  515. package/dist/utils/cx.d.ts.map +0 -1
  516. package/dist/utils/getBreakpointsValues.d.ts.map +0 -1
  517. package/dist/utils/index.d.ts +0 -7
  518. package/dist/utils/index.d.ts.map +0 -1
  519. package/dist/utils/noop.d.ts +0 -9
  520. package/dist/utils/noop.d.ts.map +0 -1
  521. package/dist/utils/scrollLock/index.d.ts +0 -7
  522. package/dist/utils/scrollLock/index.d.ts.map +0 -1
  523. package/dist/utils/scrollLock/scrollLock.styles.d.ts +0 -6
  524. package/dist/utils/scrollLock/scrollLock.styles.d.ts.map +0 -1
  525. package/dist/utils/scrollLock/useBodyScrollLock.d.ts.map +0 -1
  526. package/dist/utils/scrollTop.d.ts +0 -8
  527. package/dist/utils/scrollTop.d.ts.map +0 -1
  528. package/dist/utils/sx.d.ts +0 -174
  529. package/dist/utils/sx.d.ts.map +0 -1
  530. package/dist/utils/types.d.ts.map +0 -1
  531. package/theme/__snapshots__/chotot.spec.js.snap +0 -519
  532. package/theme/__snapshots__/mudah.spec.js.snap +0 -161
  533. package/theme/chotot.js +0 -1336
  534. package/theme/chotot.spec.js +0 -72
  535. package/theme/ct-job.js +0 -92
  536. package/theme/ct-pty.js +0 -92
  537. package/theme/ct-veh.js +0 -92
  538. package/theme/index.ts +0 -10
  539. package/theme/mudah.js +0 -333
  540. package/theme/mudah.spec.js +0 -9
  541. package/theme/types.ts +0 -61
package/README.md CHANGED
@@ -1,189 +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
- ## Claude Code / AI skill
115
-
116
- `clad-ui` ships with a Claude Code skill that gives Claude direct access to components, icons, tokens, and implementation guidelines — no MCP server required.
117
-
118
- ### Automatic install (npm)
119
-
120
- The skill is linked automatically when you install the package:
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`):
121
8
 
122
9
  ```bash
123
- pnpm install @chotot/clad-ui
10
+ pnpm add @chotot/clad-ui
124
11
  ```
125
12
 
126
- ### Manual setup (pnpm)
127
-
128
- pnpm caches lifecycle scripts per package version. Add this to your project's `package.json` so the skill re-links on every install:
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/`:
129
14
 
130
15
  ```json
131
16
  {
132
- "scripts": {
133
- "postinstall": "npx clad-ui-helper link-skill"
17
+ "pnpm": {
18
+ "onlyBuiltDependencies": ["@chotot/clad-ui"]
134
19
  }
135
20
  }
136
21
  ```
137
22
 
138
- Then run `pnpm install`.
23
+ ---
24
+
25
+ ## Setup
139
26
 
140
- ### Usage in Claude Code
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.
141
28
 
142
- Once installed, use the `/clad-ui` skill in any Claude Code session:
29
+ ### Option 1: Pre-compiled CSS (Zero Tailwind Build Config)
143
30
 
144
- | Command | Description |
145
- |---|---|
146
- | `/clad-ui search <query>` | Find components by name or description |
147
- | `/clad-ui info <Name>` | Full component detail: props, examples, import path |
148
- | `/clad-ui icons [query]` | Search or list icons |
149
- | `/clad-ui tokens [category]` | Browse design tokens |
150
- | `/clad-ui validate <Name> [props]` | Validate component usage |
151
- | `/clad-ui stats` | Design system overview |
152
- | `/clad-ui guidelines` | Load the full system prompt |
31
+ Import the pre-compiled stylesheet once in your root layout or `_app.tsx`:
153
32
 
154
- You can also describe a UI task without a subcommand and the skill will find relevant components automatically.
33
+ ```tsx
34
+ import '@chotot/clad-ui/styles.css';
35
+ ```
155
36
 
156
- ## Verifying clad-ui components in production
37
+ ### Option 2: Tailwind CSS v4 Preset (JIT Build)
157
38
 
158
- Open browser Devtool (F12) and add following CSS to the `:root` element:
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:
159
40
 
160
41
  ```css
161
- :root {
162
- /* Highlight clad-ui components: setting the color of element `outline` */
163
- --cladebug: magenta;
164
- /* [Optional] Display component label: setting the label's pseudo-element `display` property */
165
- --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
+ );
166
77
  }
167
78
  ```
168
79
 
169
- ## Frequently Asked Questions
80
+ ---
81
+
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
+ ```
170
127
 
171
- #### 1. Does this design system work with `Next.js` apps?
128
+ ### Token-Aware `cn` Class Merger
172
129
 
173
- 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.
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`).
174
131
 
175
- ## Technical Debts
132
+ ```tsx
133
+ import { cn } from '@chotot/clad-ui';
176
134
 
177
- #### 1. Linaria lack an object serializer that assist snapshot testing.
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
+ ```
178
140
 
179
- Currently, snapshots contains only rendered HTML and hashed class names. Ideally, snapshots should contain rendered HTML and associated CSS combined as component's signature.
141
+ ---
180
142
 
181
- [Github issue to keep track](https://github.com/callstack/linaria/issues/633)
143
+ ## Multi-Vertical Theming (`data-theme`)
182
144
 
183
- #### 2. Dynamic theming using CSS Variables
145
+ Apply a vertical theme via the `data-theme` attribute on `<html>`, `<body>`, or any subtree container:
184
146
 
185
- 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.
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.
186
162
 
187
163
  ---
188
164
 
189
- **© 2020-2025 Chotot.com.** Apache-2.0 license.
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
+ ```
178
+
179
+ ---
180
+
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}});