@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
@@ -0,0 +1,180 @@
1
+ #!/usr/bin/env node
2
+ 'use strict';
3
+
4
+ const fs = require('fs');
5
+ const path = require('path');
6
+
7
+ const PKG_NAME = '@chotot/clad-ui';
8
+ const MONOREPO_NAME = 'clad-ui-monorepo';
9
+ const START_MARKER = '<!-- clad-ui-skills:start -->';
10
+ const END_MARKER = '<!-- clad-ui-skills:end -->';
11
+
12
+ const AGENTS_SKILL_BLOCK = [
13
+ START_MARKER,
14
+ '## Clad UI v3 (`@chotot/clad-ui`)',
15
+ '- **Building / Styling UI:** Read [`.claude/skills/clad-ui/SKILL.md`](./.claude/skills/clad-ui/SKILL.md) before creating or editing UI components, forms, overlays, or Tailwind classes.',
16
+ '- **Migrating from v2 (`@chotot/clad-ui` v2 Linaria):** Read [`.claude/skills/migrate-clad-ui-v3/SKILL.md`](./.claude/skills/migrate-clad-ui-v3/SKILL.md).',
17
+ '- **Reporting Bugs / Enhancements / Icon Requests:** Read [`.claude/skills/clad-ui-feedback/SKILL.md`](./.claude/skills/clad-ui-feedback/SKILL.md) to file structured issues on `carousell/clad-ui`.',
18
+ END_MARKER,
19
+ ].join('\n');
20
+
21
+ function upsertDocFile(filePath) {
22
+ if (!fs.existsSync(filePath)) {
23
+ fs.writeFileSync(filePath, `${AGENTS_SKILL_BLOCK}\n`, 'utf8');
24
+ return true;
25
+ }
26
+
27
+ const content = fs.readFileSync(filePath, 'utf8');
28
+ const startIdx = content.indexOf(START_MARKER);
29
+ const endIdx = content.indexOf(END_MARKER);
30
+
31
+ let nextContent;
32
+ if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
33
+ nextContent =
34
+ content.slice(0, startIdx) +
35
+ AGENTS_SKILL_BLOCK +
36
+ content.slice(endIdx + END_MARKER.length);
37
+ } else {
38
+ const trimmed = content.replace(/\s+$/, '');
39
+ nextContent = trimmed
40
+ ? `${trimmed}\n\n${AGENTS_SKILL_BLOCK}\n`
41
+ : `${AGENTS_SKILL_BLOCK}\n`;
42
+ }
43
+
44
+ if (nextContent === content) {
45
+ return false;
46
+ }
47
+
48
+ fs.writeFileSync(filePath, nextContent, 'utf8');
49
+ return true;
50
+ }
51
+
52
+ function updateAgentDocs(projectRoot) {
53
+ const agentsPath = path.join(projectRoot, 'AGENTS.md');
54
+ const claudePath = path.join(projectRoot, 'CLAUDE.md');
55
+ const targets = [];
56
+
57
+ if (fs.existsSync(agentsPath)) targets.push(agentsPath);
58
+ if (fs.existsSync(claudePath)) targets.push(claudePath);
59
+ if (targets.length === 0) targets.push(agentsPath);
60
+
61
+ const updated = [];
62
+ for (const target of targets) {
63
+ if (upsertDocFile(target)) {
64
+ updated.push(path.basename(target));
65
+ }
66
+ }
67
+
68
+ if (updated.length > 0) {
69
+ console.log(
70
+ `[clad-ui] Updated AI skill instructions in ${updated.join(', ')}`
71
+ );
72
+ } else {
73
+ console.log(
74
+ `[clad-ui] AI skill instructions already up to date in ${targets
75
+ .map(t => path.basename(t))
76
+ .join(', ')}`
77
+ );
78
+ }
79
+ }
80
+
81
+ function main() {
82
+ try {
83
+ const packageRoot = path.resolve(__dirname, '..');
84
+ const monorepoRoot = path.resolve(packageRoot, '../..');
85
+ const projectRoot = path.resolve(process.env.INIT_CWD || process.cwd());
86
+
87
+ // Guard 1: Skip silently when installing inside clad-ui monorepo itself
88
+ if (projectRoot === packageRoot || projectRoot === monorepoRoot) {
89
+ return;
90
+ }
91
+
92
+ const consumerPkgPath = path.join(projectRoot, 'package.json');
93
+ if (fs.existsSync(consumerPkgPath)) {
94
+ try {
95
+ const consumerPkg = JSON.parse(
96
+ fs.readFileSync(consumerPkgPath, 'utf8')
97
+ );
98
+ if (
99
+ consumerPkg.name === MONOREPO_NAME ||
100
+ consumerPkg.name === PKG_NAME
101
+ ) {
102
+ return;
103
+ }
104
+
105
+ const onlyBuilt =
106
+ (consumerPkg.pnpm && consumerPkg.pnpm.onlyBuiltDependencies) || [];
107
+ if (Array.isArray(onlyBuilt) && !onlyBuilt.includes(PKG_NAME)) {
108
+ console.warn(
109
+ `[clad-ui] Tip: Add "${PKG_NAME}" to "pnpm.onlyBuiltDependencies" in package.json so pnpm always runs postinstall skill linking.`
110
+ );
111
+ }
112
+ } catch (pkgErr) {
113
+ console.warn(
114
+ `[clad-ui] Could not inspect consumer package.json (non-blocking): ${pkgErr.message}`
115
+ );
116
+ }
117
+ }
118
+
119
+ const skillsRoot = path.join(packageRoot, 'skills');
120
+ if (!fs.existsSync(skillsRoot)) {
121
+ console.warn(
122
+ `[clad-ui] Skills directory not found at ${skillsRoot} (non-blocking).`
123
+ );
124
+ return;
125
+ }
126
+
127
+ const entries = fs.readdirSync(skillsRoot, { withFileTypes: true });
128
+ const skillDirs = entries.filter(
129
+ entry =>
130
+ entry.isDirectory() &&
131
+ fs.existsSync(path.join(skillsRoot, entry.name, 'SKILL.md'))
132
+ );
133
+
134
+ if (skillDirs.length === 0) {
135
+ console.warn(
136
+ '[clad-ui] No skill directories found to link (non-blocking).'
137
+ );
138
+ return;
139
+ }
140
+
141
+ const targetSkillsDir = path.join(projectRoot, '.claude', 'skills');
142
+ fs.mkdirSync(targetSkillsDir, { recursive: true });
143
+
144
+ for (const dir of skillDirs) {
145
+ const sourcePath = path.join(skillsRoot, dir.name);
146
+ const targetLink = path.join(targetSkillsDir, dir.name);
147
+
148
+ try {
149
+ const stat = fs.lstatSync(targetLink);
150
+ if (stat.isSymbolicLink() || stat.isFile() || stat.isDirectory()) {
151
+ fs.rmSync(targetLink, { recursive: true, force: true });
152
+ }
153
+ } catch {
154
+ // targetLink does not exist yet
155
+ }
156
+
157
+ fs.symlinkSync(sourcePath, targetLink, 'dir');
158
+ }
159
+
160
+ console.log(
161
+ `[clad-ui] Linked AI skills (${skillDirs
162
+ .map(d => d.name)
163
+ .join(', ')}) -> .claude/skills/`
164
+ );
165
+
166
+ const isPostinstall = process.env.npm_lifecycle_event === 'postinstall';
167
+ if (!isPostinstall) {
168
+ updateAgentDocs(projectRoot);
169
+ }
170
+ } catch (err) {
171
+ console.warn(
172
+ `[clad-ui] Failed to link AI skills (non-blocking): ${
173
+ err && err.message ? err.message : err
174
+ }`
175
+ );
176
+ }
177
+ }
178
+
179
+ main();
180
+ process.exit(0);
@@ -0,0 +1,109 @@
1
+ ---
2
+ name: clad-ui
3
+ description: Build and style React UI using @chotot/clad-ui (Clad UI v3, Tailwind CSS v4) and @chotot/icons. Use when creating or updating UI components, selecting semantic color/typography tokens, wiring forms, modals, drawers, or tabs. Not for migrating legacy @chotot/clad-ui v2 Linaria code, use migrate-clad-ui-v3 instead.
4
+ metadata:
5
+ purpose: Build and style React UI using @chotot/clad-ui (Clad UI v3, Tailwind CSS v4) and @chotot/icons. Use when creating or updating UI components, selecting semantic color/typography tokens, wiring forms, modals, drawers, or tabs. Not for migrating legacy @chotot/clad-ui v2 Linaria code, use migrate-clad-ui-v3 instead.
6
+ type: core
7
+ library: '@chotot/clad-ui'
8
+ library_version: '3.0.0-next.4'
9
+ sources:
10
+ - 'carousell/clad-ui:packages/clad-ui/src/**'
11
+ ---
12
+
13
+ # Clad UI Design System (`@chotot/clad-ui`)
14
+
15
+ ## Read Path
16
+
17
+ Required reads:
18
+ - None beyond this `SKILL.md` for quick token and component selection.
19
+
20
+ Conditional reads (load only the file matching the UI area you are building):
21
+ - [references/tokens.md](references/tokens.md) — when choosing semantic colors (`bg-background-*`, `text-text-*`, `border-border-*`, `text-icon-*`), interaction states, typography classes, spacing/radii, or `data-theme` (`chotot`, `pty`, `job`, `veh`).
22
+ - [references/components-inputs.md](references/components-inputs.md) — when using `Input`, `TextArea`, `CurrencyInput`, `InputGroup`, `RangeInput`, `Searchbar`, `SearchInput`, `Dropdown`, `MultiSearchDropdown`, `DatePicker`, `DateTimePicker`, `Slider`, `Checkbox`, `RadioButton`, or `ToggleSwitch`.
23
+ - [references/components-overlays-nav.md](references/components-overlays-nav.md) — when using `Drawer`, `Popup`, `Popover`, `Tooltip`, `Snack`, `Announcer`, `Tabs`/`Tab`, `Breadcrumbs`/`BreadcrumbItem`, `Pagination`/`PageItem`, `LegacyDialog`, or `LegacyPopup`.
24
+ - [references/components-display-layout.md](references/components-display-layout.md) — when using `Button` (`IconButton`, `GhostButton`, `ButtonLink`), `Chip`, `TagCloud`, `Badge`, `TextLabel`, `ShapeIcon`, `RowItem`, `EmptyState`, `Box`, `Grid`/`Col`, the 24 Typography components, or `@chotot/clad-ui/icons`.
25
+ - [../clad-ui-feedback/SKILL.md](../clad-ui-feedback/SKILL.md) — when the user wants to report a Clad UI bug, request a component/token enhancement, or propose a new icon/component on `carousell/clad-ui`.
26
+
27
+ Discovery reads (fallback when an edge-case prop or icon name is not in `references/`):
28
+ - Component TypeScript definitions: `node_modules/@chotot/clad-ui/dist/components/<Name>/types.d.ts` (or `packages/clad-ui/src/components/<Name>/types.ts` inside the monorepo).
29
+ - Icon definitions: `node_modules/@chotot/icons/dist/index.d.ts` (re-exported via `@chotot/clad-ui/icons`).
30
+
31
+ ---
32
+
33
+ ## Component Selection Rules ("Use Clad UI Instead of Custom HTML")
34
+
35
+ | If you are about to build... | Use this Clad UI component |
36
+ |---|---|
37
+ | `<div onClick>` row with icon, title, subtitle, chevron/checkbox/radio/accordion | `RowItem` (`type="chevron" \| "checkbox" \| "radio" \| "accordion"`) |
38
+ | `<div>` circle/box wrapping an SVG icon with background color | `ShapeIcon` |
39
+ | Custom bottom sheet on mobile / modal dialog on desktop | `Drawer.Container` (`Drawer.Header`, `Drawer.Body`, `Drawer.Button`) |
40
+ | Centered confirmation modal (`max-width: 480px`) | `Popup.Container` (`Popup.Header`, `Popup.Body`, `Popup.Button`) |
41
+ | `<input>` with floating label, clear button, validation, or password toggle | `Input` (or `CurrencyInput` for formatted money, `SearchInput` for autocomplete) |
42
+ | Pill search bar with search icon (`40px` height) | `Searchbar` |
43
+ | Custom select / multi-select dropdown | `Dropdown` / `MultiSearchDropdown` |
44
+ | Selectable filter pills (single or multi-select) | `TagCloud` or `Chip` |
45
+ | Notification counter or dot on an icon | `Badge` |
46
+ | Inline status pill ("Đã xác thực", "Chờ duyệt") | `TextLabel` (`type="status" \| "text"`) |
47
+ | Fixed bottom toast notification | `Snack` |
48
+ | Inline banner alert with icon and action | `Announcer` |
49
+ | Raw `<h1>`–`<p>` with manual font sizes/weights | Typography components (`HeaderPage`, `LabelSection`, `BodySection`...) or `text-{header,label,body}-*` |
50
+
51
+ ---
52
+
53
+ ## Critical API & Event Gotchas
54
+
55
+ 1. **Non-standard `onChange` payloads** (see [references/components-inputs.md](references/components-inputs.md)):
56
+ - `Input`, `TextArea`, `Searchbar`: `e.target.value`
57
+ - `Checkbox`, `RadioButton`, `ToggleSwitch`: `e.target.checked` (or `e.target.value`)
58
+ - `TagCloud`: `e.target.value` (`string | string[]`)
59
+ - `CurrencyInput`: `e.target.value` (unformatted numeric string) & `onFormatChange={(formatted) => ...}`
60
+ - `Dropdown`: `e.target.value`
61
+ - `Slider`: `e.value`
62
+ - `SearchInput`: `e.value` (`{ text, selected }`)
63
+ - `DatePicker`, `DateTimePicker`: `(v) => v.dateObj` (`Date | null`)
64
+ - `RowItem`: `(e) => e.checked` & `e.value`
65
+ - `Tabs`: `(e, value) => value`
66
+ - `Pagination`: `(page: number) => page`
67
+ 2. **`Drawer` double-header trap** (see [references/components-overlays-nav.md](references/components-overlays-nav.md)):
68
+ - Prefer compound `<Drawer.Container>` + `<Drawer.Header>` + `<Drawer.Body>` + `<Drawer.Button>`.
69
+ - When using legacy `<Drawer>`, passing `title="..."` always renders a header bar. If the child screen renders its own header, omit `title` and pass `isEmptyDrawer`.
70
+ 3. **Icons, `cn` Class Merging & Imports**:
71
+ - Import components and `cn` (pre-configured `shadcn-ui/cn` class merger aware of Clad UI typography/border/radii/shadow tokens) from `@chotot/clad-ui`, and icons from `@chotot/clad-ui/icons` (`{Name}` and `{Name}Filled`, backed by `@chotot/icons`).
72
+
73
+ ---
74
+
75
+ ## Quick Reference (All 38 Components + Typography + Tokens)
76
+
77
+ | Category | Signatures & Core Props |
78
+ |---|---|
79
+ | **Tokens** | Bg: `bg-background-{primary,secondary,tertiary,app,brand,brand-light,brand-light-secondary,chotot,info,success,error,warning}` · Text: `text-text-{primary,secondary,tertiary,disabled,blank,brand,on-background,info,success,error,warning}` · Border: `border-border-{divider,thin,regular,bold,active,brand,error,warning}` · Icon: `text-icon-{primary,secondary,tertiary,brand,error,success,warning}` · Typo: `text-{display,header,label,body}-{page,section,caption,annotation}`, `text-tagline-{section,caption,annotation,footext}` · Radius: `rounded-{ad-small,ad,card-small,card,decoration,modal,pill}` · Shadow: `shadow-{below,floating}` |
80
+ | **Buttons** | `<Button color="primary\|info\|success\|error\|neutral\|tertiary" variant="solid\|outline\|tonal" size="sm\|md\|lg\|xl" icon isLoading as="a">` (also accepts `'small\|medium\|large\|xlarge'`) · Aliases: `IconButton`, `GhostButton`, `ButtonLink` |
81
+ | **Chips & Tags** | `<Chip variant="fill\|outline\|ghost" size="sm\|md\|lg" active dropdownIcon icon={…} onClose={(val, e) => …} />` · `<TagCloud options={[{value,label}]} value={v} variant="fill\|outline" multiple maxSelection={n} onChange={e => setV(e.target.value)} />` |
82
+ | **Badges & Labels** | `<Badge size="sm\|md\|lg\|dot" label="9+" backgroundColor="error\|warning\|info\|success\|neutral" variant="solid\|tonal" borderRadius="pill">{child}</Badge>` · `<TextLabel color="info\|success\|error\|warning\|neutral" type="text\|status" size="md\|sm" label="…" />` · `<ShapeIcon size="xxxs..xxl" radius="circle\|md" bg="brand-light" color="brand"><Icon /></ShapeIcon>` |
83
+ | **Text Inputs** | `<Input label="…" value={v} onChange={e => setV(e.target.value)} status="default\|warning\|error\|success" helptext="…" allowClear showPassword icon={…} />` · `<TextArea label="…" lines={4} value={v} status="default\|warning\|error" onChange={…} characterLimit={300} />` · `<CurrencyInput label="…" value={v} suffix=" đ" status="default\|warning\|error" onChange={e => setV(e.target.value)} onFormatChange={setFormatted} />` |
84
+ | **Input Groups** | `<InputGroup status="default\|error" helptext="…"><Dropdown … /><Input … /></InputGroup>` · `<RangeInput helptext="…"><Input label="Từ" … /><Input label="Đến" … /></RangeInput>` |
85
+ | **Search & Select** | `<Searchbar value={q} onChange={e => setQ(e.target.value)} allowClear />` · `<SearchInput variant="input\|dropdown" label="…" value={v} options={[{text,html,data}]} onChange={e => setV(e.value)} />` · `<Dropdown label="…" options={[{value,label,icon}]} value={v} onChange={e => setV(e.target.value)} />` · `<MultiSearchDropdown label="…" options={opts} value={vals} onSelect={opt => …} onRemoveOption={opt => …} />` |
86
+ | **Date & Range** | `<DatePicker label="…" value={date} onChange={v => setDate(v.dateObj)} format={DateFormat.DdMmYyyy} />` · `<DateTimePicker label="…" value={date} timeRange={[9, 9.5, 10]} onChange={v => setDate(v.dateObj)} />` · `<Slider type="single\|range" value={v} min={0} max={100} inputField onChange={e => setV(e.value)} />` |
87
+ | **Toggles** | `<Checkbox name="…" checked={on} indeterminate={mixed} onChange={e => setOn(e.target.checked)} label="…" color="primary" />` · `<RadioButton name="…" value="1" checked={v==='1'} onChange={e => setV(e.target.value)} label="…" width="buttonMaxWidth" />` · `<ToggleSwitch id="…" size="md\|sm" checked={on} onChange={e => setOn(e.target.checked)} />` |
88
+ | **Overlays** | `<Drawer.Container open={open} onClose={fn} size="S\|M\|L" halfHeight dragHandle><Drawer.Header title="…" /><Drawer.Body>…</Drawer.Body><Drawer.Button>…</Drawer.Button></Drawer.Container>` · `<Popup.Container open={open} onClose={fn}><Popup.Header title="…" /><Popup.Body>…</Popup.Body><Popup.Button>…</Popup.Button></Popup.Container>` · `<Popover anchorEl={ref} open={open} placement="bottom-start" onOutsideClick={fn}>…</Popover>` · `<Tooltip variant="dark\|light" text="…" hoverable>{trigger}</Tooltip>` |
89
+ | **Feedback & Nav** | `<Snack desktopSize="md\|lg\|xl" autoHideDuration="xl" actionLabel="…" onActionClick={fn} onClose={fn}>…</Snack>` · `<Announcer type="info\|warning\|success\|error\|neutral" title="…" btnLabel="…" open={open} compact>…</Announcer>` · `<Tabs value={tab} onChange={(e, v) => setTab(v)} variant="standard\|fullWidth" showDivider><Tab value="1" label="…" /></Tabs>` · `<Breadcrumbs><BreadcrumbItem href="/">…</BreadcrumbItem></Breadcrumbs>` · `<Pagination currentPage={p} totalPages={10} onChange={setP} />` |
90
+ | **Rows, Empty, Layout** | `<RowItem type="list\|chevron\|checkbox\|radio\|accordion" icon={…} description="…" checked={on} onChange={e => setOn(e.checked)} onClick={fn}>Title</RowItem>` · `<EmptyState type="notFound\|notFoundWhite\|maintenance\|keywordNoResult\|filterNoResult\|noAvailable\|grantAccess\|disconnection\|working\|waitingCv\|noReward\|other" onButtonClick={fn} />` · `<Box … />` · `<Grid gutter="md"><Col span={[12, 6]}>…</Col></Grid>` · 24 Typography (`DisplayPage`..`TaglineFootext`) · Brand (`ChototLogoText`, `CtC2C`, `CtProperty`, `CtVehicle`, `Tot`) |
91
+
92
+ ---
93
+
94
+ ## Guardrails
95
+
96
+ - Do not use base Tailwind palette classes (`bg-gray-100`, `text-red-500`) or hardcoded hex colors (`bg-[#ffd400]`); always use Clad semantic tokens (`bg-background-*`, `text-text-*`, `border-border-*`, `text-icon-*`).
97
+ - Do not use arbitrary font sizes or weights (`text-sm font-bold`); always use Clad semantic typography utilities (`text-label-section`, `text-body-section`) or Typography React components (`<LabelSection>`, `<BodySection>`).
98
+ - Do not guess component props or `onChange` event shapes; check the matching file in `references/` or `dist/components/<Name>/types.d.ts` first.
99
+ - Do not use `extraClasses` (v2 legacy prop); pass `className` to override styles.
100
+ - Do not use arbitrary descendant selectors (`[&_*]`, `[&>div]`, `*:size-*`) in `className` to reach into or override internal component DOM structure (Hyrum's Law); only pass external layout utilities (margin, width, flex/grid positioning) and use official component props/variants for internal styling.
101
+ - Do not put `disabled` on `<a href>` / `<Button as="a">`; use `aria-disabled="true"` and prevent default in `onClick`.
102
+
103
+ ## Feedback Protocol (Consumer Persona)
104
+
105
+ Only when you encounter clear library friction while building UI in a consumer repo (a component bug, a missing prop/variant forcing a workaround, or a missing icon in `@chotot/icons`):
106
+ - Finish the current task first (never interrupt ongoing work; stay silent if `@chotot/clad-ui` worked fine; max 1 callout per turn).
107
+ - Append a 1-line callout at the very end of your response:
108
+ > 💡 **clad-ui**: <1-sentence description of the bug, missing prop, or missing icon>. Bạn có muốn tạo GitHub issue lên `carousell/clad-ui` (qua skill `clad-ui-feedback`) không?
109
+ - If the user agrees, follow [../clad-ui-feedback/SKILL.md](../clad-ui-feedback/SKILL.md).
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "Clad UI Design System"
3
+ short_description: "Build and style React UI with @chotot/clad-ui (v3) components, semantic tokens, and @chotot/icons."
4
+ default_prompt: "Use $clad-ui to select the right Clad UI v3 components, verify exact prop/event contracts from references, and apply semantic color and typography tokens."
@@ -0,0 +1,295 @@
1
+ # Clad UI Tailwind — Actions, Display, Layout, Typography & Icons
2
+
3
+ ## Contents
4
+
5
+ - [1. Button & Aliases (`IconButton`, `GhostButton`, `ButtonLink`)](#1-button--aliases-iconbutton-ghostbutton-buttonlink)
6
+ - [2. Chip](#2-chip)
7
+ - [3. TagCloud](#3-tagcloud)
8
+ - [4. Badge](#4-badge)
9
+ - [5. TextLabel](#5-textlabel)
10
+ - [6. ShapeIcon](#6-shapeicon)
11
+ - [7. RowItem](#7-rowitem)
12
+ - [8. EmptyState](#8-emptystate)
13
+ - [9. Typography React Components (24 Components)](#9-typography-react-components-24-components)
14
+ - [10. Layout (`Box`, `Grid`, `Col`)](#10-layout-box-grid-col)
15
+ - [11. Icons (`@chotot/clad-ui/icons`)](#11-icons-chototclad-uiicons)
16
+
17
+ ---
18
+
19
+ ## 1. Button & Aliases (`IconButton`, `GhostButton`, `ButtonLink`)
20
+
21
+ ```tsx
22
+ import { Button, IconButton, GhostButton, ButtonLink } from '@chotot/clad-ui';
23
+ import { Bell } from '@chotot/clad-ui/icons';
24
+
25
+ <>
26
+ <Button color="primary" variant="solid" size="medium">Đăng tin</Button>
27
+ <Button color="neutral" variant="tonal" size="small">Hủy</Button>
28
+ <Button color="error" variant="outline" isLoading>Đang xóa...</Button>
29
+ <Button icon aria-label="Thông báo"><Bell /></Button>
30
+ <Button as="a" href="/dang-tin">Bắt đầu</Button>
31
+ </>
32
+ ```
33
+
34
+ | Prop | Type | Default |
35
+ |---|---|---|
36
+ | `color` | `'primary' \| 'info' \| 'success' \| 'error' \| 'neutral' \| 'tertiary'` | `'primary'` |
37
+ | `variant` | `'solid' \| 'outline' \| 'tonal'` | `'solid'` |
38
+ | `size` | `'sm' \| 'md' \| 'lg' \| 'xl'` (also accepts `'small' \| 'medium' \| 'large' \| 'xlarge'`; heights: 24 / 32 / 40 / 48px) | `'medium'` |
39
+ | `icon` | `boolean` — square icon-only button | `false` |
40
+ | `isLoading` | `boolean` — shows spinner and disables interaction | `false` |
41
+ | `disabled` | `boolean` | `false` |
42
+ | `as` | `ElementType` (`'button'`, `'a'`, Next.js `Link`) | `'button'` |
43
+
44
+ - **Aliases:** `IconButton` (preset `icon`), `GhostButton` (transparent button with icon/text), `ButtonLink` (`as="a"`).
45
+ - **Raw HTML CSS classes:** `button button--{color} button--{variant} button--{sm|md|lg|xl}` (`+ button--icon`, `button--loading`).
46
+
47
+ ---
48
+
49
+ ## 2. Chip
50
+
51
+ Interactive filter/selection pill or removable tag.
52
+
53
+ ```tsx
54
+ import { Chip } from '@chotot/clad-ui';
55
+ import { Location } from '@chotot/clad-ui/icons';
56
+
57
+ <>
58
+ <Chip variant="outline" active>Đang chọn</Chip>
59
+ <Chip dropdownIcon>Khu vực</Chip>
60
+ <Chip icon={<Location />}>TP.HCM</Chip>
61
+ <Chip value="hcm" onClose={(val, e) => removeFilter(val)}>TP.HCM</Chip>
62
+ <Chip as="button" onClick={handleClick}>Bộ lọc</Chip>
63
+ </>
64
+ ```
65
+
66
+ | Prop | Type | Default |
67
+ |---|---|---|
68
+ | `variant` | `'fill' \| 'outline' \| 'ghost'` (legacy alias `'normal'` maps to `'fill'`) | `'fill'` |
69
+ | `size` | `'sm' \| 'md' \| 'lg'` (heights: 24 / 32 / 40px; legacy alias `'xl'` maps to `'lg'`) | `'md'` |
70
+ | `active` / `disabled` / `dropdownIcon` | `boolean` | `false` |
71
+ | `icon` | `ReactNode` — left icon | — |
72
+ | `onClose` | `(value: any, event: MouseEvent) => void` — renders `×` close button | — |
73
+ | `value` | `any` — passed as first argument to `onClose` | — |
74
+ | `as` | `ElementType` | `'a'` |
75
+
76
+ - **Raw HTML CSS classes:** `chip chip--{normal|outline|ghost} chip--{sm|md|lg|xl}` (`+ chip--active`, `chip--disabled`).
77
+
78
+ ---
79
+
80
+ ## 3. TagCloud
81
+
82
+ Selectable group of chips supporting single or multi-select (`multiple` + `maxSelection`).
83
+
84
+ ```tsx
85
+ import { TagCloud } from '@chotot/clad-ui';
86
+
87
+ <TagCloud
88
+ label="Tình trạng"
89
+ options={[{ value: 'new', label: 'Mới 100%' }, { value: 'used', label: 'Đã sử dụng' }]}
90
+ value={selected}
91
+ multiple
92
+ maxSelection={2}
93
+ onChange={(e) => setSelected(e.target.value)}
94
+ />
95
+ ```
96
+
97
+ | Prop | Type | Default |
98
+ |---|---|---|
99
+ | `options` | `TagCloudOption[]` (`{ value: string, label: string }`) | `[]` |
100
+ | `value` | `string \| string[]` | — |
101
+ | `onChange` | `(event: TagCloudChangeEvent) => void` (`event.target.value`) | — |
102
+ | `multiple` / `required` | `boolean` | `false` |
103
+ | `maxSelection` | `number` | — |
104
+ | `label` / `helptext` | `string` | — |
105
+ | `variant` | `'fill' \| 'outline'` (also accepts `'normal'`) | `'fill'` |
106
+ | `selectedTextStyle` | `'bold' \| 'normal'` | `'bold'` |
107
+
108
+ ---
109
+
110
+ ## 4. Badge
111
+
112
+ Notification counter or status dot anchored relative to `children`.
113
+
114
+ ```tsx
115
+ import { Badge } from '@chotot/clad-ui';
116
+ import { Bell } from '@chotot/clad-ui/icons';
117
+
118
+ <Badge size="md" label="9+" backgroundColor="error" variant="solid" borderRadius="pill">
119
+ <Bell />
120
+ </Badge>
121
+ ```
122
+
123
+ | Prop | Type | Default |
124
+ |---|---|---|
125
+ | `size` | `'sm' \| 'md' \| 'lg' \| 'dot'` | `'sm'` |
126
+ | `label` | `string` (ignored when `size="dot"`) | `''` |
127
+ | `backgroundColor` | `'error' \| 'warning' \| 'info' \| 'success' \| 'neutral'` | `'warning'` |
128
+ | `variant` | `'solid' \| 'tonal'` | `'solid'` |
129
+ | `position` | `'topRight' \| 'topLeft' \| 'right'` | `'topRight'` |
130
+ | `borderRadius` | `'none' \| 'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'pill' \| 'circle'` | `'none'` |
131
+ | `zIndex` | `number` | `1` |
132
+
133
+ ---
134
+
135
+ ## 5. TextLabel
136
+
137
+ Inline status badge/tag with colored background and optional status icon.
138
+
139
+ ```tsx
140
+ import { TextLabel } from '@chotot/clad-ui';
141
+
142
+ <>
143
+ <TextLabel color="success" type="status" size="md" label="Đã xác thực" />
144
+ <TextLabel color="warning" type="text" size="sm" label="Chờ duyệt" />
145
+ </>
146
+ ```
147
+
148
+ | Prop | Type | Default |
149
+ |---|---|---|
150
+ | `color` | `'info' \| 'success' \| 'error' \| 'warning' \| 'neutral'` | `'info'` |
151
+ | `size` | `'md' \| 'sm'` | `'md'` |
152
+ | `type` | `'text' \| 'status'` (`status` renders a leading icon + `text-text-primary`) | `'text'` |
153
+ | `label` | `string` | — |
154
+ | `icon` | `ReactNode` — custom icon when `type="status"` | default status icon |
155
+
156
+ ---
157
+
158
+ ## 6. ShapeIcon
159
+
160
+ Wraps an SVG icon in a fixed-size container with optional background, border-radius, and semantic color (inner icon scaled to 60%).
161
+
162
+ ```tsx
163
+ import { ShapeIcon } from '@chotot/clad-ui';
164
+ import { Heart } from '@chotot/clad-ui/icons';
165
+
166
+ <ShapeIcon size="lg" radius="circle" bg="error-light" color="error">
167
+ <Heart />
168
+ </ShapeIcon>
169
+ ```
170
+
171
+ | Prop | Type | Default |
172
+ |---|---|---|
173
+ | `size` | `'xxxs'` (12px) · `'xxs'` (16) · `'xs'` (20) · `'sm'` (24) · `'md'` (28) · `'lg'` (32) · `'lxl'` (40) · `'xl'` (48) · `'xxl'` (64) | `'sm'` |
174
+ | `radius` | `'none' \| 'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'pill' \| 'circle'` | `'circle'` |
175
+ | `bg` | `'none'` \| `brand`/`info`/`success`/`error`/`warning` (+ `-light`) \| `primary` \| `secondary` \| `tertiary` \| `inverted` | `'none'` |
176
+ | `color` | `'primary' \| 'secondary' \| 'tertiary' \| 'blank' \| 'brand' \| 'info' \| 'success' \| 'error' \| 'warning' \| 'on-background'` | `'primary'` |
177
+ | `as` | `ElementType` | `'span'` |
178
+
179
+ ---
180
+
181
+ ## 7. RowItem
182
+
183
+ Interactive list row supporting menu chevrons, checkboxes, radios, or collapsible accordions.
184
+
185
+ ```tsx
186
+ import { RowItem } from '@chotot/clad-ui';
187
+ import { Shield } from '@chotot/clad-ui/icons';
188
+
189
+ <>
190
+ <RowItem type="chevron" icon={<Shield />} description="Cập nhật mật khẩu" onClick={openSecurity}>
191
+ Bảo mật tài khoản
192
+ </RowItem>
193
+
194
+ <RowItem
195
+ type="checkbox"
196
+ name="opt"
197
+ value="sms"
198
+ checked={smsOn}
199
+ onChange={(e) => setSmsOn(e.checked)}
200
+ >
201
+ Nhận thông báo qua SMS
202
+ </RowItem>
203
+ </>
204
+ ```
205
+
206
+ | Prop | Type | Default |
207
+ |---|---|---|
208
+ | `type` | `'list' \| 'radio' \| 'checkbox' \| 'chevron' \| 'accordion'` | `'list'` |
209
+ | `children` | `ReactNode` — main row title/content | — |
210
+ | `description` | `string` — secondary text below title | — |
211
+ | `icon` | `ReactNode` — leading icon or `ShapeIcon` | — |
212
+ | `checked` | `boolean` (when `type="checkbox" \| "radio"`) | `false` |
213
+ | `value` / `name` | `string` | — |
214
+ | `inverted` | `boolean` — swaps left/right placement of icon and control | `false` |
215
+ | `onClick` | `MouseEventHandler<HTMLElement>` | — |
216
+ | `onChange` | `(e: RowItemOnChangeEvent) => void` (`{ value: string, checked: boolean }`) | — |
217
+ | `isCollapsed` / `onCollapseChange` / `collapsibleContent` | `boolean` / `(collapsed: boolean) => void` / `ReactNode` (`type="accordion"`) | — |
218
+
219
+ ---
220
+
221
+ ## 8. EmptyState
222
+
223
+ Illustrated placeholder with 7 built-in Vietnamese presets plus customizable `other`.
224
+
225
+ ```tsx
226
+ import { EmptyState } from '@chotot/clad-ui';
227
+
228
+ <>
229
+ <EmptyState type="keywordNoResult" onButtonClick={resetSearch} />
230
+ <EmptyState
231
+ type="other"
232
+ coverImage="/empty.png"
233
+ title="Chưa có tin đăng"
234
+ description="Hãy đăng tin đầu tiên của bạn ngay hôm nay"
235
+ buttonLabel="Đăng tin ngay"
236
+ onButtonClick={goPostAd}
237
+ />
238
+ </>
239
+ ```
240
+
241
+ | Prop | Type | Default |
242
+ |---|---|---|
243
+ | `type` | `'notFound' \| 'notFoundWhite' \| 'maintenance' \| 'keywordNoResult' \| 'filterNoResult' \| 'noAvailable' \| 'grantAccess' \| 'disconnection' \| 'working' \| 'waitingCv' \| 'noReward' \| 'other'` | required |
244
+ | `title` / `coverImage` / `buttonLabel` | `string` — overrides preset | preset |
245
+ | `description` | `ReactNode` | preset |
246
+ | `showTitle` / `showDescription` / `showButton` | `boolean` | `true` |
247
+ | `onButtonClick` | `MouseEventHandler` | — |
248
+
249
+ ---
250
+
251
+ ## 9. Typography React Components (24 Components)
252
+
253
+ Import directly from `@chotot/clad-ui`. Every component accepts `as` (HTML tag override), `className`, and standard element attributes.
254
+
255
+ ```tsx
256
+ import { HeaderPage, LabelSection, BodySection, NoteCaption } from '@chotot/clad-ui';
257
+
258
+ <>
259
+ <HeaderPage as="h1">Tiêu đề trang</HeaderPage>
260
+ <LabelSection as="h3">Tiêu đề thẻ</LabelSection>
261
+ <BodySection as="p" className="text-text-secondary">Nội dung mô tả</BodySection>
262
+ <NoteCaption as="span">Ghi chú nhỏ</NoteCaption>
263
+ </>
264
+ ```
265
+
266
+ | Group | Exported Components |
267
+ |---|---|
268
+ | Display (Bold) | `DisplayPage`, `DisplaySection`, `DisplayCaption`, `DisplayAnnotation`, `DisplayPrice` |
269
+ | Header (SemiBold) | `HeaderPage`, `HeaderSection`, `HeaderCaption`, `HeaderAnnotation` |
270
+ | Label (Bold) | `LabelPage`, `LabelSection`, `LabelCaption`, `LabelAnnotation` |
271
+ | Body (Regular) | `BodyPage`, `BodySection`, `BodyCaption`, `BodyAnnotation` |
272
+ | Note (Italic) | `NotePage`, `NoteSection`, `NoteCaption` |
273
+ | Tagline (Medium) | `TaglineSection`, `TaglineCaption`, `TaglineAnnotation`, `TaglineFootext` |
274
+
275
+ ---
276
+
277
+ ## 10. Layout (`Box`, `Grid`, `Col`)
278
+
279
+ - **`Box`:** Polymorphic container (`as`) supporting responsive token props (`padding`, `paddingx`, `paddingy`, `width`, `maxWidth`, `height`, `backgroundColor`, `color`, `borderColor`, `borderWidth`, `borderRadius`, `boxShadow`, `alignItems`, `justifyContent`, `textAlign`). In Tailwind v4 projects, prefer standard Tailwind layout classes (`flex`, `p-4`, `rounded-lg`, `bg-background-primary`) for new code.
280
+ - **`Grid` & `Col`:** 12-column responsive flexbox grid:
281
+ - `Grid` props: `width`, `align`, `justify`, `rowCols`, `gutter`, `gutterx`, `guttery`.
282
+ - `Col` props: `span` (`1..12` or responsive array `[12, 6, 4]`), `offset`, `align`, `order`.
283
+
284
+ ---
285
+
286
+ ## 11. Icons (`@chotot/clad-ui/icons`)
287
+
288
+ Import individual icons from `@chotot/clad-ui/icons` (re-exported from `@chotot/icons`):
289
+
290
+ ```tsx
291
+ import { ArrowLeft, Close, ChevronRight, Heart, HeartFilled } from '@chotot/clad-ui/icons';
292
+ ```
293
+
294
+ - Every icon ships outline (`{Name}`) and filled (`{Name}Filled`) variants, inherits `currentColor` (style via `text-icon-*` classes), and accepts standard SVG props (`width`, `height`, `className`, `aria-hidden`).
295
+ - To check if an icon name exists, inspect `node_modules/@chotot/icons/dist/index.d.ts`.