@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.
- package/CHANGELOG.md +675 -0
- package/README.md +156 -156
- package/dist/brand/ChototLogoText.d.ts +5 -0
- package/dist/brand/CtC2C.d.ts +5 -0
- package/dist/brand/CtProperty.d.ts +5 -0
- package/dist/brand/CtVehicle.d.ts +5 -0
- package/dist/brand/Tot.d.ts +5 -0
- package/dist/brand/index.d.ts +5 -0
- package/dist/chunk-Bmb41Sf3.cjs +1 -0
- package/dist/clad-ui.cjs +2 -0
- package/dist/clad-ui.d.ts +2 -0
- package/dist/clad-ui.es.js +9000 -4224
- package/dist/components/Announcer/Announcer.d.ts +3 -54
- package/dist/components/Announcer/announcer.styles.d.ts +39 -0
- package/dist/components/Announcer/index.d.ts +2 -0
- package/dist/components/Announcer/types.d.ts +41 -0
- package/dist/components/Badge/Badge.d.ts +2 -44
- package/dist/components/Badge/badge.styles.d.ts +57 -0
- package/dist/components/Badge/index.d.ts +4 -0
- package/dist/components/Badge/types.d.ts +33 -0
- package/dist/components/Box/Box.d.ts +7 -99
- package/dist/components/Box/index.d.ts +2 -0
- package/dist/components/Box/types.d.ts +89 -0
- package/dist/components/Breadcrumbs/BreadcrumbItem.d.ts +3 -5
- package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +3 -17
- package/dist/components/Breadcrumbs/breadcrumbs.styles.d.ts +2 -0
- package/dist/components/Breadcrumbs/index.d.ts +3 -0
- package/dist/components/Breadcrumbs/types.d.ts +18 -0
- package/dist/components/Button/Button.d.ts +3 -76
- package/dist/components/Button/ButtonLink.d.ts +2 -3
- package/dist/components/Button/GhostButton.d.ts +3 -47
- package/dist/components/Button/IconButton.d.ts +2 -10
- package/dist/components/Button/button.styles.d.ts +242 -0
- package/dist/components/Button/constant.d.ts +1 -2
- package/dist/components/Button/index.d.ts +5 -0
- package/dist/components/Button/types.d.ts +72 -0
- package/dist/components/Checkbox/Checkbox.d.ts +3 -46
- package/dist/components/Checkbox/checkbox.styles.d.ts +27 -0
- package/dist/components/Checkbox/index.d.ts +2 -0
- package/dist/components/Checkbox/types.d.ts +40 -0
- package/dist/components/Chip/Chip.d.ts +3 -70
- package/dist/components/Chip/chip.styles.d.ts +66 -0
- package/dist/components/Chip/index.d.ts +2 -0
- package/dist/components/Chip/types.d.ts +22 -0
- package/dist/components/CurrencyInput/CurrencyInput.d.ts +3 -39
- package/dist/components/CurrencyInput/currency-input.styles.d.ts +21 -0
- package/dist/components/CurrencyInput/index.d.ts +5 -0
- package/dist/components/CurrencyInput/types.d.ts +96 -0
- package/dist/components/CurrencyInput/utils.d.ts +18 -0
- package/dist/components/DatePicker/DatePicker.d.ts +2 -138
- package/dist/components/DatePicker/DateTimePicker.d.ts +2 -137
- package/dist/components/DatePicker/date-picker.styles.d.ts +9 -0
- package/dist/components/DatePicker/date-time-picker.styles.d.ts +10 -0
- package/dist/components/DatePicker/index.d.ts +4 -0
- package/dist/components/DatePicker/types.d.ts +286 -0
- package/dist/components/Drawer/Drawer.d.ts +36 -0
- package/dist/components/Drawer/Drawer.pw.fixtures.d.ts +9 -0
- package/dist/components/Drawer/index.d.ts +3 -0
- package/dist/components/Drawer/types.d.ts +191 -0
- package/dist/components/Dropdown/Dropdown.d.ts +3 -94
- package/dist/components/Dropdown/dropdown.styles.d.ts +18 -0
- package/dist/components/Dropdown/index.d.ts +4 -0
- package/dist/components/Dropdown/types.d.ts +89 -0
- package/dist/components/EmptyState/EmptyState.d.ts +4 -0
- package/dist/components/EmptyState/empty-state.styles.d.ts +3 -0
- package/dist/components/EmptyState/index.d.ts +2 -0
- package/dist/components/EmptyState/types.d.ts +55 -0
- package/dist/components/Grid/Col.d.ts +4 -35
- package/dist/components/Grid/Grid.d.ts +8 -55
- package/dist/components/Grid/Grid.pw.fixtures.d.ts +3 -0
- package/dist/components/Grid/index.d.ts +3 -0
- package/dist/components/Grid/types.d.ts +66 -0
- package/dist/components/Input/Input.d.ts +3 -116
- package/dist/components/Input/index.d.ts +2 -0
- package/dist/components/Input/input.styles.d.ts +24 -0
- package/dist/components/Input/types.d.ts +55 -0
- package/dist/components/InputGroup/InputGroup.d.ts +4 -0
- package/dist/components/InputGroup/index.d.ts +4 -0
- package/dist/components/InputGroup/input-group.styles.d.ts +18 -0
- package/dist/components/InputGroup/types.d.ts +20 -0
- package/dist/components/LegacyDialog/DialogMainIcon.d.ts +3 -0
- package/dist/components/LegacyDialog/LegacyDialog.d.ts +5 -0
- package/dist/components/LegacyDialog/index.d.ts +3 -0
- package/dist/{patterns/LegacyDialog/LegacyDialog.d.ts → components/LegacyDialog/types.d.ts} +2 -10
- package/dist/components/LegacyPopup/LegacyPopup.d.ts +6 -0
- package/dist/components/LegacyPopup/index.d.ts +2 -0
- package/dist/{patterns/LegacyPopup/LegacyPopup.d.ts → components/LegacyPopup/types.d.ts} +4 -15
- package/dist/components/MultiSearchDropdown/MultiSearchDropdown.d.ts +10 -0
- package/dist/components/MultiSearchDropdown/index.d.ts +4 -0
- package/dist/components/MultiSearchDropdown/multi-search-dropdown.styles.d.ts +18 -0
- package/dist/{patterns/MultiSearchDropdown/MultiSearchDropdown.d.ts → components/MultiSearchDropdown/types.d.ts} +6 -19
- package/dist/components/Pagination/PageItem.d.ts +3 -21
- package/dist/components/Pagination/Pagination.d.ts +2 -46
- package/dist/components/Pagination/index.d.ts +5 -0
- package/dist/components/Pagination/pagination.styles.d.ts +37 -0
- package/dist/components/Pagination/types.d.ts +66 -0
- package/dist/components/Popover/Popover.d.ts +4 -44
- package/dist/components/Popover/Popover.pw.fixtures.d.ts +6 -0
- package/dist/components/Popover/index.d.ts +2 -0
- package/dist/components/Popover/popover.styles.d.ts +1 -0
- package/dist/components/Popover/types.d.ts +44 -0
- package/dist/components/Popup/Popup.d.ts +31 -0
- package/dist/components/Popup/Popup.pw.fixtures.d.ts +5 -0
- package/dist/components/Popup/index.d.ts +3 -0
- package/dist/components/Popup/types.d.ts +145 -0
- package/dist/components/RadioButton/RadioButton.d.ts +3 -51
- package/dist/components/RadioButton/index.d.ts +4 -0
- package/dist/components/RadioButton/radio-button.styles.d.ts +27 -0
- package/dist/components/RadioButton/types.d.ts +46 -0
- package/dist/components/RangeInput/RangeInput.d.ts +4 -0
- package/dist/components/RangeInput/index.d.ts +3 -0
- package/dist/components/RangeInput/range-input.styles.d.ts +1 -0
- package/dist/{patterns/RangeInput/RangeInput.d.ts → components/RangeInput/types.d.ts} +1 -4
- package/dist/components/RowItem/RowItem.d.ts +8 -76
- package/dist/components/RowItem/index.d.ts +2 -0
- package/dist/components/RowItem/rowitem.styles.d.ts +36 -0
- package/dist/components/RowItem/types.d.ts +66 -0
- package/dist/components/SearchInput/SearchInput.d.ts +5 -0
- package/dist/components/SearchInput/index.d.ts +3 -0
- package/dist/components/SearchInput/search-input.styles.d.ts +18 -0
- package/dist/{patterns/SearchInput/SearchInput.d.ts → components/SearchInput/types.d.ts} +19 -25
- package/dist/components/Searchbar/Searchbar.d.ts +3 -0
- package/dist/components/Searchbar/index.d.ts +3 -0
- package/dist/components/Searchbar/searchbar.styles.d.ts +1 -0
- package/dist/{patterns/Searchbar/Searchbar.d.ts → components/Searchbar/types.d.ts} +6 -9
- package/dist/components/ShapeIcon/ShapeIcon.d.ts +3 -53
- package/dist/components/ShapeIcon/index.d.ts +2 -0
- package/dist/components/ShapeIcon/shape-icon.styles.d.ts +156 -0
- package/dist/components/ShapeIcon/types.d.ts +5 -0
- package/dist/components/Slider/Slider.d.ts +3 -57
- package/dist/components/Slider/index.d.ts +3 -0
- package/dist/components/Slider/slider.styles.d.ts +1 -0
- package/dist/components/Slider/types.d.ts +59 -0
- package/dist/components/Snack/Snack.d.ts +4 -48
- package/dist/components/Snack/index.d.ts +3 -0
- package/dist/components/Snack/snack.styles.d.ts +21 -0
- package/dist/components/Snack/types.d.ts +48 -0
- package/dist/components/Tabs/Tab.d.ts +3 -67
- package/dist/components/Tabs/Tabs.d.ts +14 -61
- package/dist/components/Tabs/index.d.ts +4 -0
- package/dist/components/Tabs/tabs.styles.d.ts +59 -0
- package/dist/components/Tabs/types.d.ts +97 -0
- package/dist/components/TagCloud/TagCloud.d.ts +11 -0
- package/dist/components/TagCloud/index.d.ts +2 -0
- package/dist/components/TagCloud/tagcloud.styles.d.ts +18 -0
- package/dist/components/TagCloud/types.d.ts +26 -0
- package/dist/components/TextArea/TextArea.d.ts +3 -100
- package/dist/components/TextArea/index.d.ts +4 -0
- package/dist/components/TextArea/text-area.styles.d.ts +21 -0
- package/dist/components/TextArea/types.d.ts +98 -0
- package/dist/components/TextLabel/TextLabel.d.ts +3 -35
- package/dist/components/TextLabel/index.d.ts +2 -0
- package/dist/components/TextLabel/textlabel.styles.d.ts +51 -0
- package/dist/components/TextLabel/types.d.ts +32 -0
- package/dist/components/ToggleSwitch/ToggleSwitch.d.ts +3 -41
- package/dist/components/ToggleSwitch/index.d.ts +4 -0
- package/dist/components/ToggleSwitch/toggle-switch.styles.d.ts +39 -0
- package/dist/components/ToggleSwitch/types.d.ts +33 -0
- package/dist/components/Tooltip/Tooltip.d.ts +4 -98
- package/dist/components/Tooltip/Tooltip.pw.fixtures.d.ts +1 -0
- package/dist/components/Tooltip/index.d.ts +2 -0
- package/dist/components/Tooltip/tooltip.styles.d.ts +18 -0
- package/dist/components/Tooltip/types.d.ts +24 -0
- package/dist/forge/index.cjs +0 -0
- package/dist/forge/index.d.ts +8 -0
- package/dist/forge/index.es.js +0 -0
- package/dist/icons.cjs +1 -0
- package/dist/icons.d.ts +1 -0
- package/dist/icons.es.js +1 -0
- package/dist/index.d.ts +82 -71
- package/dist/styles.css +2 -0
- package/dist/{utils/types.d.ts → types/index.d.ts} +0 -1
- package/dist/typography/BodyAnnotation.d.ts +8 -6
- package/dist/typography/BodyCaption.d.ts +8 -6
- package/dist/typography/BodyPage.d.ts +8 -6
- package/dist/typography/BodySection.d.ts +8 -6
- package/dist/typography/DisplayAnnotation.d.ts +8 -6
- package/dist/typography/DisplayCaption.d.ts +8 -6
- package/dist/typography/DisplayPage.d.ts +8 -6
- package/dist/typography/DisplayPrice.d.ts +21 -0
- package/dist/typography/DisplaySection.d.ts +8 -6
- package/dist/typography/HeaderAnnotation.d.ts +8 -6
- package/dist/typography/HeaderCaption.d.ts +8 -6
- package/dist/typography/HeaderPage.d.ts +8 -6
- package/dist/typography/HeaderSection.d.ts +8 -6
- package/dist/typography/LabelAnnotation.d.ts +8 -6
- package/dist/typography/LabelCaption.d.ts +8 -6
- package/dist/typography/LabelPage.d.ts +8 -6
- package/dist/typography/LabelSection.d.ts +8 -6
- package/dist/typography/NoteCaption.d.ts +8 -6
- package/dist/typography/NotePage.d.ts +8 -6
- package/dist/typography/NoteSection.d.ts +8 -6
- package/dist/typography/TaglineAnnotation.d.ts +8 -6
- package/dist/typography/TaglineCaption.d.ts +8 -6
- package/dist/typography/TaglineFootext.d.ts +8 -6
- package/dist/typography/TaglineSection.d.ts +8 -6
- package/dist/typography/index.d.ts +25 -24
- package/dist/utils/_inlineCreatePortal.d.ts +0 -1
- package/dist/utils/bundleCss.cjs +1 -0
- package/dist/utils/bundleCss.d.ts +6 -0
- package/dist/utils/bundleCss.es.js +18 -0
- package/dist/utils/cleanHtml.d.ts +4 -7
- package/dist/utils/cn.d.ts +5 -0
- package/dist/utils/createUniversalPortal.d.ts +4 -14
- package/dist/utils/floating.d.ts +52 -0
- package/dist/utils/getBreakpointsValues.d.ts +4 -9
- package/dist/utils/sizes.d.ts +28 -0
- package/dist/utils/storyStyles.d.ts +21 -0
- package/dist/utils/themeTokens.d.ts +327 -0
- package/dist/utils/{scrollLock/useBodyScrollLock.d.ts → useBodyScrollLock.d.ts} +0 -1
- package/dist/utils/useScrollTop.d.ts +8 -0
- package/package.json +98 -104
- package/scripts/postinstall.cjs +180 -0
- package/skills/clad-ui/SKILL.md +109 -0
- package/skills/clad-ui/agents/openai.yaml +4 -0
- package/skills/clad-ui/references/components-display-layout.md +295 -0
- package/skills/clad-ui/references/components-inputs.md +449 -0
- package/skills/clad-ui/references/components-overlays-nav.md +314 -0
- package/skills/clad-ui/references/tokens.md +134 -0
- package/skills/clad-ui-feedback/SKILL.md +128 -0
- package/skills/migrate-clad-ui-v3/SKILL.md +123 -0
- package/skills/migrate-clad-ui-v3/agents/openai.yaml +4 -0
- package/skills/migrate-clad-ui-v3/references/component-api-changes.md +139 -0
- package/skills/migrate-clad-ui-v3/references/token-and-linaria-mapping.md +186 -0
- package/src/styles/base/base.css +440 -0
- package/src/styles/components/announcer.css +182 -0
- package/src/styles/components/badge.css +102 -0
- package/src/styles/components/box.css +61 -0
- package/src/styles/components/breadcrumbs.css +75 -0
- package/src/styles/components/button.css +527 -0
- package/src/styles/components/checkbox.css +115 -0
- package/src/styles/components/chip.css +155 -0
- package/src/styles/components/currency-input.css +146 -0
- package/src/styles/components/date-picker.css +305 -0
- package/src/styles/components/date-time-picker.css +64 -0
- package/src/styles/components/drawer.css +496 -0
- package/src/styles/components/dropdown.css +186 -0
- package/src/styles/components/empty-state.css +30 -0
- package/src/styles/components/grid.css +212 -0
- package/src/styles/components/index.css +36 -0
- package/src/styles/components/input-group.css +85 -0
- package/src/styles/components/input.css +255 -0
- package/src/styles/components/legacy-dialog.css +129 -0
- package/src/styles/components/legacy-popup.css +209 -0
- package/src/styles/components/multi-search-dropdown.css +240 -0
- package/src/styles/components/pagination.css +68 -0
- package/src/styles/components/popover.css +8 -0
- package/src/styles/components/popup.css +331 -0
- package/src/styles/components/radio-button.css +130 -0
- package/src/styles/components/range-input.css +40 -0
- package/src/styles/components/rowitem.css +75 -0
- package/src/styles/components/search-input.css +89 -0
- package/src/styles/components/searchbar.css +46 -0
- package/src/styles/components/shape-icon.css +199 -0
- package/src/styles/components/slider.css +232 -0
- package/src/styles/components/snack.css +144 -0
- package/src/styles/components/tabs.css +128 -0
- package/src/styles/components/tagcloud.css +50 -0
- package/src/styles/components/text-area.css +176 -0
- package/src/styles/components/textlabel.css +75 -0
- package/src/styles/components/toggle-switch.css +147 -0
- package/src/styles/components/tooltip.css +93 -0
- package/src/styles/index.css +10 -0
- package/src/styles/preset.css +6 -0
- package/src/styles/theme/colors/base.css +108 -0
- package/src/styles/theme/colors/semantic.css +135 -0
- package/src/styles/theme/index.css +57 -0
- package/src/styles/theme/typography/base.css +53 -0
- package/src/styles/theme/typography/semantic.css +176 -0
- package/src/styles/theme/variables.css +83 -0
- package/ai/clad-ui-helper.js +0 -267
- package/ai/knowledge-base/README.md +0 -154
- package/ai/knowledge-base/clad-ui-database.json +0 -9378
- package/ai/knowledge-base/component-categories.json +0 -616
- package/ai/knowledge-base/components/metadata/charts-axis.json +0 -31
- package/ai/knowledge-base/components/metadata/charts-barchart.json +0 -57
- package/ai/knowledge-base/components/metadata/charts-basechart.tsx.json +0 -31
- package/ai/knowledge-base/components/metadata/charts-chartshared.json +0 -31
- package/ai/knowledge-base/components/metadata/charts-linechart.json +0 -189
- package/ai/knowledge-base/components/metadata/charts-piechart.json +0 -57
- package/ai/knowledge-base/components/metadata/components-announcer.json +0 -215
- package/ai/knowledge-base/components/metadata/components-badge.json +0 -168
- package/ai/knowledge-base/components/metadata/components-box.json +0 -348
- package/ai/knowledge-base/components/metadata/components-breadcrumbs.json +0 -75
- package/ai/knowledge-base/components/metadata/components-button.json +0 -187
- package/ai/knowledge-base/components/metadata/components-checkbox.json +0 -161
- package/ai/knowledge-base/components/metadata/components-chip.json +0 -266
- package/ai/knowledge-base/components/metadata/components-currencyinput.json +0 -136
- package/ai/knowledge-base/components/metadata/components-datepicker.json +0 -87
- package/ai/knowledge-base/components/metadata/components-dropdown.json +0 -282
- package/ai/knowledge-base/components/metadata/components-grid.json +0 -92
- package/ai/knowledge-base/components/metadata/components-input.json +0 -432
- package/ai/knowledge-base/components/metadata/components-pagination.json +0 -111
- package/ai/knowledge-base/components/metadata/components-popover.json +0 -63
- package/ai/knowledge-base/components/metadata/components-radiobutton.json +0 -170
- package/ai/knowledge-base/components/metadata/components-rowitem.json +0 -281
- package/ai/knowledge-base/components/metadata/components-shapeicon.json +0 -139
- package/ai/knowledge-base/components/metadata/components-slider.json +0 -177
- package/ai/knowledge-base/components/metadata/components-snack.json +0 -181
- package/ai/knowledge-base/components/metadata/components-tabs.json +0 -169
- package/ai/knowledge-base/components/metadata/components-textarea.json +0 -285
- package/ai/knowledge-base/components/metadata/components-textlabel.json +0 -129
- package/ai/knowledge-base/components/metadata/components-toggleswitch.json +0 -134
- package/ai/knowledge-base/components/metadata/components-tooltip.json +0 -291
- package/ai/knowledge-base/components/metadata/patterns-drawer.json +0 -310
- package/ai/knowledge-base/components/metadata/patterns-emptystate.json +0 -106
- package/ai/knowledge-base/components/metadata/patterns-inputgroup.json +0 -105
- package/ai/knowledge-base/components/metadata/patterns-legacydialog.json +0 -177
- package/ai/knowledge-base/components/metadata/patterns-legacypopup.json +0 -236
- package/ai/knowledge-base/components/metadata/patterns-multisearchdropdown.json +0 -249
- package/ai/knowledge-base/components/metadata/patterns-popup.json +0 -268
- package/ai/knowledge-base/components/metadata/patterns-rangeinput.json +0 -105
- package/ai/knowledge-base/components/metadata/patterns-searchbar.json +0 -150
- package/ai/knowledge-base/components/metadata/patterns-searchinput.json +0 -312
- package/ai/knowledge-base/components/metadata/patterns-tagcloud.json +0 -244
- package/ai/knowledge-base/components/metadata/summaries.json +0 -610
- package/ai/knowledge-base/design-tokens/tokens.json +0 -483
- package/ai/knowledge-base/patterns/documentation.json +0 -131
- package/ai/knowledge-base/prompts/common-system-prompt.md +0 -592
- package/ai/knowledge-base/prompts/figma-system-prompt.md +0 -396
- package/ai/knowledge-base/search-index/icons/asset-icons.json +0 -1
- package/ai/knowledge-base/search-index/icons/collection.json +0 -5
- package/ai/knowledge-base/search-index/icons/system-icons.json +0 -1
- package/ai/knowledge-base/search-index/search-index.json +0 -899
- package/ai/knowledge-base/validation-rules/component-rules.json +0 -658
- package/ai/skill/SKILL.md +0 -103
- package/dist/components/Announcer/Announcer.d.ts.map +0 -1
- package/dist/components/Announcer/Announcer.styles.d.ts +0 -30
- package/dist/components/Announcer/Announcer.styles.d.ts.map +0 -1
- package/dist/components/Badge/Badge.d.ts.map +0 -1
- package/dist/components/Badge/Badge.styles.d.ts +0 -26
- package/dist/components/Badge/Badge.styles.d.ts.map +0 -1
- package/dist/components/Box/Box.d.ts.map +0 -1
- package/dist/components/Box/Box.styles.d.ts +0 -21
- package/dist/components/Box/Box.styles.d.ts.map +0 -1
- package/dist/components/Breadcrumbs/BreadcrumbItem.d.ts.map +0 -1
- package/dist/components/Breadcrumbs/Breadcrumbs.d.ts.map +0 -1
- package/dist/components/Breadcrumbs/Breadcrumbs.styles.d.ts +0 -10
- package/dist/components/Breadcrumbs/Breadcrumbs.styles.d.ts.map +0 -1
- package/dist/components/Button/Button.d.ts.map +0 -1
- package/dist/components/Button/Button.styles.d.ts +0 -3
- package/dist/components/Button/Button.styles.d.ts.map +0 -1
- package/dist/components/Button/ButtonLink.d.ts.map +0 -1
- package/dist/components/Button/GhostButton.d.ts.map +0 -1
- package/dist/components/Button/GhostButton.styles.d.ts +0 -3
- package/dist/components/Button/GhostButton.styles.d.ts.map +0 -1
- package/dist/components/Button/IconButton.d.ts.map +0 -1
- package/dist/components/Button/constant.d.ts.map +0 -1
- package/dist/components/Checkbox/Checkbox.d.ts.map +0 -1
- package/dist/components/Checkbox/Checkbox.styles.d.ts +0 -5
- package/dist/components/Checkbox/Checkbox.styles.d.ts.map +0 -1
- package/dist/components/Chip/Chip.d.ts.map +0 -1
- package/dist/components/Chip/Chip.styles.d.ts +0 -13
- package/dist/components/Chip/Chip.styles.d.ts.map +0 -1
- package/dist/components/CurrencyInput/CurrencyInput.d.ts.map +0 -1
- package/dist/components/CurrencyInput/CurrencyInput.styles.d.ts +0 -27
- package/dist/components/CurrencyInput/CurrencyInput.styles.d.ts.map +0 -1
- package/dist/components/CurrencyInput/utils/_cleanValue.d.ts +0 -12
- package/dist/components/CurrencyInput/utils/_cleanValue.d.ts.map +0 -1
- package/dist/components/CurrencyInput/utils/_formatValue.d.ts +0 -6
- package/dist/components/CurrencyInput/utils/_formatValue.d.ts.map +0 -1
- package/dist/components/DatePicker/DatePicker.d.ts.map +0 -1
- package/dist/components/DatePicker/DateTimePicker.d.ts.map +0 -1
- package/dist/components/DatePicker/DateTimePicker.styles.d.ts +0 -61
- package/dist/components/DatePicker/DateTimePicker.styles.d.ts.map +0 -1
- package/dist/components/Dropdown/Dropdown.d.ts.map +0 -1
- package/dist/components/Dropdown/Dropdown.styles.d.ts +0 -11
- package/dist/components/Dropdown/Dropdown.styles.d.ts.map +0 -1
- package/dist/components/Grid/Col.d.ts.map +0 -1
- package/dist/components/Grid/Grid.d.ts.map +0 -1
- package/dist/components/Grid/Grid.styles.d.ts +0 -33
- package/dist/components/Grid/Grid.styles.d.ts.map +0 -1
- package/dist/components/Input/Input.d.ts.map +0 -1
- package/dist/components/Input/Input.styles.d.ts +0 -36
- package/dist/components/Input/Input.styles.d.ts.map +0 -1
- package/dist/components/Pagination/PageItem.d.ts.map +0 -1
- package/dist/components/Pagination/Pagination.d.ts.map +0 -1
- package/dist/components/Pagination/Pagination.style.d.ts +0 -7
- package/dist/components/Pagination/Pagination.style.d.ts.map +0 -1
- package/dist/components/Popover/Popover.d.ts.map +0 -1
- package/dist/components/Popover/Popover.styles.d.ts +0 -4
- package/dist/components/Popover/Popover.styles.d.ts.map +0 -1
- package/dist/components/RadioButton/RadioButton.d.ts.map +0 -1
- package/dist/components/RadioButton/RadioButton.styles.d.ts +0 -12
- package/dist/components/RadioButton/RadioButton.styles.d.ts.map +0 -1
- package/dist/components/RowItem/RowItem.d.ts.map +0 -1
- package/dist/components/RowItem/RowItem.styles.d.ts +0 -33
- package/dist/components/RowItem/RowItem.styles.d.ts.map +0 -1
- package/dist/components/ShapeIcon/ShapeIcon.d.ts.map +0 -1
- package/dist/components/ShapeIcon/ShapeIcon.styles.d.ts +0 -15
- package/dist/components/ShapeIcon/ShapeIcon.styles.d.ts.map +0 -1
- package/dist/components/Slider/Slider.d.ts.map +0 -1
- package/dist/components/Slider/Slider.styles.d.ts +0 -24
- package/dist/components/Slider/Slider.styles.d.ts.map +0 -1
- package/dist/components/Snack/Snack.d.ts.map +0 -1
- package/dist/components/Snack/Snack.styles.d.ts +0 -20
- package/dist/components/Snack/Snack.styles.d.ts.map +0 -1
- package/dist/components/Tabs/Tab.d.ts.map +0 -1
- package/dist/components/Tabs/Tabs.d.ts.map +0 -1
- package/dist/components/Tabs/Tabs.styles.d.ts +0 -43
- package/dist/components/Tabs/Tabs.styles.d.ts.map +0 -1
- package/dist/components/TextArea/TextArea.d.ts.map +0 -1
- package/dist/components/TextArea/TextArea.styles.d.ts +0 -19
- package/dist/components/TextArea/TextArea.styles.d.ts.map +0 -1
- package/dist/components/TextLabel/TextLabel.d.ts.map +0 -1
- package/dist/components/TextLabel/TextLabel.styles.d.ts +0 -10
- package/dist/components/TextLabel/TextLabel.styles.d.ts.map +0 -1
- package/dist/components/ToggleSwitch/ToggleSwitch.d.ts.map +0 -1
- package/dist/components/ToggleSwitch/ToggleSwitch.styles.d.ts +0 -22
- package/dist/components/ToggleSwitch/ToggleSwitch.styles.d.ts.map +0 -1
- package/dist/components/Tooltip/Tooltip.d.ts.map +0 -1
- package/dist/components/Tooltip/Tooltip.styles.d.ts +0 -33
- package/dist/components/Tooltip/Tooltip.styles.d.ts.map +0 -1
- package/dist/components/index.d.ts +0 -62
- package/dist/components/index.d.ts.map +0 -1
- package/dist/css/baseline.d.ts +0 -15
- package/dist/css/baseline.d.ts.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/patterns/Drawer/Drawer.d.ts +0 -110
- package/dist/patterns/Drawer/Drawer.d.ts.map +0 -1
- package/dist/patterns/Drawer/Drawer.styles.d.ts +0 -39
- package/dist/patterns/Drawer/Drawer.styles.d.ts.map +0 -1
- package/dist/patterns/EmptyState/EmptyState.d.ts +0 -36
- package/dist/patterns/EmptyState/EmptyState.d.ts.map +0 -1
- package/dist/patterns/EmptyState/EmptyState.styles.d.ts +0 -4
- package/dist/patterns/EmptyState/EmptyState.styles.d.ts.map +0 -1
- package/dist/patterns/InputGroup/InputGroup.d.ts +0 -26
- package/dist/patterns/InputGroup/InputGroup.d.ts.map +0 -1
- package/dist/patterns/InputGroup/InputGroup.styles.d.ts +0 -8
- package/dist/patterns/InputGroup/InputGroup.styles.d.ts.map +0 -1
- package/dist/patterns/LegacyDialog/DialogMainIcon.d.ts +0 -2
- package/dist/patterns/LegacyDialog/DialogMainIcon.d.ts.map +0 -1
- package/dist/patterns/LegacyDialog/LegacyDialog.d.ts.map +0 -1
- package/dist/patterns/LegacyDialog/LegacyDialog.styles.d.ts +0 -13
- package/dist/patterns/LegacyDialog/LegacyDialog.styles.d.ts.map +0 -1
- package/dist/patterns/LegacyPopup/LegacyPopup.d.ts.map +0 -1
- package/dist/patterns/LegacyPopup/LegacyPopup.styles.d.ts +0 -27
- package/dist/patterns/LegacyPopup/LegacyPopup.styles.d.ts.map +0 -1
- package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.d.ts.map +0 -1
- package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.styles.d.ts +0 -26
- package/dist/patterns/MultiSearchDropdown/MultiSearchDropdown.styles.d.ts.map +0 -1
- package/dist/patterns/Popup/Popup.d.ts +0 -92
- package/dist/patterns/Popup/Popup.d.ts.map +0 -1
- package/dist/patterns/Popup/Popup.styles.d.ts +0 -41
- package/dist/patterns/Popup/Popup.styles.d.ts.map +0 -1
- package/dist/patterns/RangeInput/RangeInput.d.ts.map +0 -1
- package/dist/patterns/RangeInput/RangeInput.styles.d.ts +0 -5
- package/dist/patterns/RangeInput/RangeInput.styles.d.ts.map +0 -1
- package/dist/patterns/SearchInput/SearchInput.d.ts.map +0 -1
- package/dist/patterns/SearchInput/SearchInput.styles.d.ts +0 -10
- package/dist/patterns/SearchInput/SearchInput.styles.d.ts.map +0 -1
- package/dist/patterns/Searchbar/Searchbar.d.ts.map +0 -1
- package/dist/patterns/Searchbar/Searchbar.styles.d.ts +0 -3
- package/dist/patterns/Searchbar/Searchbar.styles.d.ts.map +0 -1
- package/dist/patterns/TagCloud/TagCloud.d.ts +0 -76
- package/dist/patterns/TagCloud/TagCloud.d.ts.map +0 -1
- package/dist/patterns/TagCloud/TagCloud.styles.d.ts +0 -15
- package/dist/patterns/TagCloud/TagCloud.styles.d.ts.map +0 -1
- package/dist/patterns/TagCloud/TagCloudMultiActive.d.ts +0 -25
- package/dist/patterns/TagCloud/TagCloudMultiActive.d.ts.map +0 -1
- package/dist/patterns/TagCloud/TagCloudSingleActive.d.ts +0 -22
- package/dist/patterns/TagCloud/TagCloudSingleActive.d.ts.map +0 -1
- package/dist/patterns/index.d.ts +0 -23
- package/dist/patterns/index.d.ts.map +0 -1
- package/dist/theme/chotot.d.ts +0 -1371
- package/dist/theme/chotot.d.ts.map +0 -1
- package/dist/theme/ct-job.d.ts +0 -826
- package/dist/theme/ct-job.d.ts.map +0 -1
- package/dist/theme/ct-pty.d.ts +0 -826
- package/dist/theme/ct-pty.d.ts.map +0 -1
- package/dist/theme/ct-veh.d.ts +0 -591
- package/dist/theme/ct-veh.d.ts.map +0 -1
- package/dist/theme/index.d.ts +0 -5
- package/dist/theme/index.d.ts.map +0 -1
- package/dist/theme/mudah.d.ts +0 -248
- package/dist/theme/mudah.d.ts.map +0 -1
- package/dist/theme/types.d.ts +0 -58
- package/dist/theme/types.d.ts.map +0 -1
- package/dist/theme-chotot.css +0 -2
- package/dist/theme-job.css +0 -2
- package/dist/theme-pty.css +0 -2
- package/dist/theme-veh.css +0 -2
- package/dist/typography/BodyAnnotation.d.ts.map +0 -1
- package/dist/typography/BodyCaption.d.ts.map +0 -1
- package/dist/typography/BodyPage.d.ts.map +0 -1
- package/dist/typography/BodySection.d.ts.map +0 -1
- package/dist/typography/DisplayAnnotation.d.ts.map +0 -1
- package/dist/typography/DisplayCaption.d.ts.map +0 -1
- package/dist/typography/DisplayPage.d.ts.map +0 -1
- package/dist/typography/DisplaySection.d.ts.map +0 -1
- package/dist/typography/HeaderAnnotation.d.ts.map +0 -1
- package/dist/typography/HeaderCaption.d.ts.map +0 -1
- package/dist/typography/HeaderPage.d.ts.map +0 -1
- package/dist/typography/HeaderSection.d.ts.map +0 -1
- package/dist/typography/LabelAnnotation.d.ts.map +0 -1
- package/dist/typography/LabelCaption.d.ts.map +0 -1
- package/dist/typography/LabelPage.d.ts.map +0 -1
- package/dist/typography/LabelSection.d.ts.map +0 -1
- package/dist/typography/NoteCaption.d.ts.map +0 -1
- package/dist/typography/NotePage.d.ts.map +0 -1
- package/dist/typography/NoteSection.d.ts.map +0 -1
- package/dist/typography/TaglineAnnotation.d.ts.map +0 -1
- package/dist/typography/TaglineCaption.d.ts.map +0 -1
- package/dist/typography/TaglineFootext.d.ts.map +0 -1
- package/dist/typography/TaglineSection.d.ts.map +0 -1
- package/dist/typography/index.d.ts.map +0 -1
- package/dist/utils/_inlineCreatePortal.d.ts.map +0 -1
- package/dist/utils/_normalizeArrowKey.d.ts +0 -10
- package/dist/utils/_normalizeArrowKey.d.ts.map +0 -1
- package/dist/utils/_simulateChangeEvent.d.ts +0 -25
- package/dist/utils/_simulateChangeEvent.d.ts.map +0 -1
- package/dist/utils/cleanHtml.d.ts.map +0 -1
- package/dist/utils/createUniversalPortal.d.ts.map +0 -1
- package/dist/utils/cx.d.ts +0 -22
- package/dist/utils/cx.d.ts.map +0 -1
- package/dist/utils/getBreakpointsValues.d.ts.map +0 -1
- package/dist/utils/index.d.ts +0 -7
- package/dist/utils/index.d.ts.map +0 -1
- package/dist/utils/noop.d.ts +0 -9
- package/dist/utils/noop.d.ts.map +0 -1
- package/dist/utils/scrollLock/index.d.ts +0 -7
- package/dist/utils/scrollLock/index.d.ts.map +0 -1
- package/dist/utils/scrollLock/scrollLock.styles.d.ts +0 -6
- package/dist/utils/scrollLock/scrollLock.styles.d.ts.map +0 -1
- package/dist/utils/scrollLock/useBodyScrollLock.d.ts.map +0 -1
- package/dist/utils/scrollTop.d.ts +0 -8
- package/dist/utils/scrollTop.d.ts.map +0 -1
- package/dist/utils/sx.d.ts +0 -174
- package/dist/utils/sx.d.ts.map +0 -1
- package/dist/utils/types.d.ts.map +0 -1
- package/theme/__snapshots__/chotot.spec.js.snap +0 -519
- package/theme/__snapshots__/mudah.spec.js.snap +0 -161
- package/theme/chotot.js +0 -1336
- package/theme/chotot.spec.js +0 -72
- package/theme/ct-job.js +0 -92
- package/theme/ct-pty.js +0 -92
- package/theme/ct-veh.js +0 -92
- package/theme/index.ts +0 -10
- package/theme/mudah.js +0 -333
- package/theme/mudah.spec.js +0 -9
- 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`.
|