@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
package/README.md
CHANGED
|
@@ -1,189 +1,189 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
[<img src="https://github.com/carousell/clad-ui/actions/workflows/publish.yml/badge.svg" alt="Pipeline Status" />](https://github.com/carousell/clad-ui/actions/workflows/publish.yml)
|
|
9
|
-
[<img src="https://sonar.chotot.org/api/project_badges/measure?project=web-clad-ui&metric=coverage" alt="Coverage" />](https://sonar.chotot.org/dashboard?id=web-clad-ui)
|
|
10
|
-
|
|
11
|
-
<!-- /badges -->
|
|
12
|
-
|
|
13
|
-
# Intro
|
|
14
|
-
|
|
15
|
-
Clad UI Design System is a system of design tokens, guidelines, theming solution and components library that helps Chotot front end and mobile engineers build consistent UIs faster and more satisfyingly.
|
|
16
|
-
|
|
17
|
-
## Why the name Clad UI?
|
|
18
|
-
|
|
19
|
-
Clad is the short form of classified ads, which is the main product of our group, besides, clad also mean “to be dressed or to be coated”
|
|
20
|
-
|
|
21
|
-
## What Clad UI Design System is
|
|
22
|
-
|
|
23
|
-
- A unified solution for styling components for Chotot Web user-facing platforms
|
|
24
|
-
- A theme specifications that define primitive Clad UI design tokens
|
|
25
|
-
- A collection of reusable components from atomic inputs to composite components
|
|
26
|
-
- A workbench (a.k.a kitchen sink) to preview all available components and their usage guide
|
|
27
|
-
- A set of CLI tools to assist generate new components...
|
|
28
|
-
|
|
29
|
-
## What Clad UI Design System is NOT
|
|
30
|
-
|
|
31
|
-
- A base framework for doing Chotot web apps (refer to Next.js framework)
|
|
32
|
-
- An end user-facing web app
|
|
33
|
-
- Any full web page
|
|
34
|
-
|
|
35
|
-
## Colophon (A.K.A prerequisites to this design system)
|
|
36
|
-
|
|
37
|
-
### Building components:
|
|
38
|
-
|
|
39
|
-
- 📚 [Storybook](https://storybook.js.org) for UI component development and [auto-generated docs](https://medium.com/storybookjs/storybook-docs-sneak-peak-5be78445094a)
|
|
40
|
-
- ⚛️ [React](https://reactjs.org/) declarative component-centric UI. React is also our core UI library of Front End development
|
|
41
|
-
- 💅 [Linaria](https://linaria.now.sh//) which enable CSS-in-JS styling and extract all CSS to external CSS file.
|
|
42
|
-
- 📄 [System UI Theme Specification](https://system-ui.com/theme/) as a standard design token format with theme-aware [`css` props helper](https://styled-system.com/css)
|
|
43
|
-
- ⬇️ [MDX](https://mdxjs.com) (part of Storybook) for seamless React / JSX documentation
|
|
44
|
-
|
|
45
|
-
Maintaining the system:
|
|
46
|
-
|
|
47
|
-
- 🐟 [Babel](https://babeljs.io/) and [module resolver plugin](https://github.com/tleunen/babel-plugin-module-resolver) for transpiling modern JS and static theming
|
|
48
|
-
- 📦 [NPM](https://www.npmjs.com/) for packaging and distribution
|
|
49
|
-
- 🟧 [pnpm](https://pnpm.io/) as package manager's CLI
|
|
50
|
-
- 🧪 [Jest](https://jestjs.io/) as test runner for unit testing
|
|
51
|
-
- 🐐 [react-testing-library](https://github.com/testing-library/react-testing-library) to assist unit testing React components
|
|
52
|
-
- 🚥 [Github Actions](https://docs.github.com/en/actions) for Continuous integration (test and publish)
|
|
53
|
-
- ✅ [Chromatic](https://www.chromatic.com/) to prevent UI bugs in components (by Storybook maintainers)
|
|
54
|
-
|
|
55
|
-
## Components Status
|
|
56
|
-
|
|
57
|
-
**Date update:**
|
|
58
|
-
2025-07-31
|
|
59
|
-
|
|
60
|
-
| No | Component | Web | iOS | Android |
|
|
61
|
-
| --- | ------------------------ | ------- | --- | ------- |
|
|
62
|
-
| 1 | Announcer | ✅ 1.0+ | ✅ | |
|
|
63
|
-
| 2 | Box | ✅ 1.0+ | | |
|
|
64
|
-
| 3 | Breadcrumbs | ✅ 1.0+ | | |
|
|
65
|
-
| 4 | Badge | ✅ 1.0+ | ✅ | ✅ |
|
|
66
|
-
| 5 | Button | ✅ 1.2+ | ✅ | ✅ |
|
|
67
|
-
| 6 | Checkbox | ✅ 1.0+ | | ✅ |
|
|
68
|
-
| 7 | Chip | ✅ 1.2+ | ✅ | ✅ |
|
|
69
|
-
| 8 | CurrencyInput | ✅ 1.0+ | | ✅ |
|
|
70
|
-
| 9 | DatePicker | ✅ 1.5+ | | |
|
|
71
|
-
| 10 | DateTimePicker | ✅ 1.5+ | | |
|
|
72
|
-
| 11 | Dialog | ✅ 1.0+ | ✅ | |
|
|
73
|
-
| 12 | Drawer\* | ✅ 1.0+ | ✅ | ✅ |
|
|
74
|
-
| 13 | Dropdown | ✅ 1.0+ | ✅ | |
|
|
75
|
-
| 14 | EmptyState | ✅ 1.0+ | ✅ | ✅ |
|
|
76
|
-
| 15 | GhostButton (ButtonLink) | ✅ 1.0+ | | |
|
|
77
|
-
| 16 | Grid | ✅ 1.0+ | | |
|
|
78
|
-
| 17 | LegacyDialog | ✅ 1.0+ | | |
|
|
79
|
-
| 18 | LegacyPopup | ✅ 1.0+ | | |
|
|
80
|
-
| 19 | MultiSearchDropdown\* | ✅ 1.0+ | | ✅ |
|
|
81
|
-
| 20 | Notification | N/A | | ✅ |
|
|
82
|
-
| 21 | Input/ Input Text | ✅ 1.2+ | ✅ | ✅ |
|
|
83
|
-
| 22 | InputGroup | ✅ 1.0+ | ✅ | |
|
|
84
|
-
| 23 | Popup | ✅ 1.2+ | | ✅ |
|
|
85
|
-
| 24 | RadioButton | ✅ 1.0+ | ✅ | ✅ |
|
|
86
|
-
| 25 | RowItem | ✅ 1.0+ | ✅ | |
|
|
87
|
-
| 26 | SearchInput | ✅ 1.2+ | | |
|
|
88
|
-
| 27 | ShapeIcon | ✅ 1.0+ | | |
|
|
89
|
-
| 28 | Slider | ✅ 1.0+ | | |
|
|
90
|
-
| 29 | Snack | ✅ 1.0+ | ✅ | ✅ |
|
|
91
|
-
| 30 | Stepper | | | ✅ |
|
|
92
|
-
| 31 | Tabs | ✅ 1.2+ | ✅ | ✅ |
|
|
93
|
-
| 32 | TagCloud | ✅ 1.0+ | ✅ | |
|
|
94
|
-
| 33 | TextArea | ✅ 1.0+ | | ✅ |
|
|
95
|
-
| 34 | TextLabel | ✅ 1.5+ | ✅ | ✅ |
|
|
96
|
-
| 35 | ToggleSwitch | ✅ 1.0+ | | ✅ |
|
|
97
|
-
| 36 | Tooltip | ✅ 1.0+ | ✅ | ✅ |
|
|
98
|
-
| 37 | Pagination | 🧪 1.6+ | | |
|
|
99
|
-
| 38 | InputRange | 🧪 2.1+ | | |
|
|
100
|
-
| 39 | Searchbar | 🧪 2.1+ | | |
|
|
101
|
-
|
|
102
|
-
**Legend:**
|
|
103
|
-
✅: stable; 🧪: beta; ⚠️: deprecated; [1.0+]: since this version
|
|
104
|
-
|
|
105
|
-
**\* Other Naming:**
|
|
106
|
-
|
|
107
|
-
- `MultiSearchDropdown` name in Android is `Input multi selected chip`
|
|
108
|
-
- `Drawer` in iOS / Android is `*BottomSheet`
|
|
109
|
-
|
|
110
|
-
## Getting started
|
|
111
|
-
|
|
112
|
-
Refer to [Overview > Getting-started document](https://clad-ui.chotot.org/?path=/docs/overview-getting-started--page).
|
|
113
|
-
|
|
114
|
-
## Claude Code / AI skill
|
|
115
|
-
|
|
116
|
-
`clad-ui` ships with a Claude Code skill that gives Claude direct access to components, icons, tokens, and implementation guidelines — no MCP server required.
|
|
117
|
-
|
|
118
|
-
### Automatic install (npm)
|
|
119
|
-
|
|
120
|
-
The skill is linked automatically when you install the package:
|
|
1
|
+
# @chotot/clad-ui
|
|
2
|
+
|
|
3
|
+
Clad UI v3 React component library and design system built on **Tailwind CSS v4**. Provides multi-vertical design tokens (`chotot`, `pty`, `job`, `veh`), 60+ React components and patterns, 24 Typography components, Brand logos, a token-aware `cn` class merger, and built-in AI coding skills.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
Install `@chotot/clad-ui` (`@chotot/icons` is included automatically as a dependency and exposed at `@chotot/clad-ui/icons`):
|
|
121
8
|
|
|
122
9
|
```bash
|
|
123
|
-
pnpm
|
|
10
|
+
pnpm add @chotot/clad-ui
|
|
124
11
|
```
|
|
125
12
|
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
pnpm caches lifecycle scripts per package version. Add this to your project's `package.json` so the skill re-links on every install:
|
|
13
|
+
If your project uses `pnpm` v10+, add `@chotot/clad-ui` to `pnpm.onlyBuiltDependencies` in your `package.json` so its `postinstall` script can automatically sync AI coding skills into `.claude/skills/`, `.cursor/skills/`, and `.agents/skills/`:
|
|
129
14
|
|
|
130
15
|
```json
|
|
131
16
|
{
|
|
132
|
-
"
|
|
133
|
-
"
|
|
17
|
+
"pnpm": {
|
|
18
|
+
"onlyBuiltDependencies": ["@chotot/clad-ui"]
|
|
134
19
|
}
|
|
135
20
|
}
|
|
136
21
|
```
|
|
137
22
|
|
|
138
|
-
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Setup
|
|
139
26
|
|
|
140
|
-
|
|
27
|
+
This package ships its own baseline styles (`baseline.css`), so **Tailwind's default preflight must be disabled** when using the Tailwind v4 CSS preset.
|
|
141
28
|
|
|
142
|
-
|
|
29
|
+
### Option 1: Pre-compiled CSS (Zero Tailwind Build Config)
|
|
143
30
|
|
|
144
|
-
|
|
145
|
-
|---|---|
|
|
146
|
-
| `/clad-ui search <query>` | Find components by name or description |
|
|
147
|
-
| `/clad-ui info <Name>` | Full component detail: props, examples, import path |
|
|
148
|
-
| `/clad-ui icons [query]` | Search or list icons |
|
|
149
|
-
| `/clad-ui tokens [category]` | Browse design tokens |
|
|
150
|
-
| `/clad-ui validate <Name> [props]` | Validate component usage |
|
|
151
|
-
| `/clad-ui stats` | Design system overview |
|
|
152
|
-
| `/clad-ui guidelines` | Load the full system prompt |
|
|
31
|
+
Import the pre-compiled stylesheet once in your root layout or `_app.tsx`:
|
|
153
32
|
|
|
154
|
-
|
|
33
|
+
```tsx
|
|
34
|
+
import '@chotot/clad-ui/styles.css';
|
|
35
|
+
```
|
|
155
36
|
|
|
156
|
-
|
|
37
|
+
### Option 2: Tailwind CSS v4 Preset (JIT Build)
|
|
157
38
|
|
|
158
|
-
|
|
39
|
+
If your project compiles CSS with Tailwind CSS v4 (`@tailwindcss/postcss`, `@tailwindcss/vite`, or `@tailwindcss/cli`), import `theme.css`, `utilities.css`, and `@chotot/clad-ui/preset.css` in your global stylesheet:
|
|
159
40
|
|
|
160
41
|
```css
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
42
|
+
/* app/globals.css */
|
|
43
|
+
@layer theme, base, components, utilities;
|
|
44
|
+
@import 'tailwindcss/theme.css' layer(theme);
|
|
45
|
+
@import 'tailwindcss/utilities.css' layer(utilities);
|
|
46
|
+
|
|
47
|
+
/* Import Clad UI preset (includes @source directive for library components): */
|
|
48
|
+
@import '@chotot/clad-ui/preset.css';
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Option 3: Tailwind Browser CDN / SSR Inline Bundle
|
|
52
|
+
|
|
53
|
+
For projects that load Tailwind via the browser CDN script (e.g. SEO content hubs or standalone SSR pages), use `getBundledCss` (Node.js runtime/build-time utility) to inline the design system CSS:
|
|
54
|
+
|
|
55
|
+
```tsx
|
|
56
|
+
import Script from 'next/script';
|
|
57
|
+
import { getBundledCss } from '@chotot/clad-ui/utils/bundleCss';
|
|
58
|
+
|
|
59
|
+
export default function Document() {
|
|
60
|
+
return (
|
|
61
|
+
<html>
|
|
62
|
+
<head>
|
|
63
|
+
<Script
|
|
64
|
+
src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"
|
|
65
|
+
strategy="beforeInteractive"
|
|
66
|
+
/>
|
|
67
|
+
<style
|
|
68
|
+
type="text/tailwindcss"
|
|
69
|
+
dangerouslySetInnerHTML={{
|
|
70
|
+
__html: getBundledCss(),
|
|
71
|
+
}}
|
|
72
|
+
/>
|
|
73
|
+
</head>
|
|
74
|
+
<body>{/* your app */}</body>
|
|
75
|
+
</html>
|
|
76
|
+
);
|
|
166
77
|
}
|
|
167
78
|
```
|
|
168
79
|
|
|
169
|
-
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## Usage
|
|
83
|
+
|
|
84
|
+
### React Components, Typography, Brand & Icons
|
|
85
|
+
|
|
86
|
+
All components, 24 Typography components, Brand logos (`ChototLogoText`, `CtC2C`, `CtProperty`, `CtVehicle`, `Tot`), and `cn` are exported directly from `@chotot/clad-ui`:
|
|
87
|
+
|
|
88
|
+
```tsx
|
|
89
|
+
import {
|
|
90
|
+
Button,
|
|
91
|
+
HeaderSection,
|
|
92
|
+
BodySection,
|
|
93
|
+
ShapeIcon,
|
|
94
|
+
ChototLogoText,
|
|
95
|
+
cn,
|
|
96
|
+
} from '@chotot/clad-ui';
|
|
97
|
+
import { Call, ChevronRight } from '@chotot/clad-ui/icons';
|
|
98
|
+
|
|
99
|
+
export function ContactCard({ highlighted = false }: { highlighted?: boolean }) {
|
|
100
|
+
return (
|
|
101
|
+
<div
|
|
102
|
+
className={cn(
|
|
103
|
+
'flex items-center justify-between p-4 rounded-card bg-background-primary border border-border-thin',
|
|
104
|
+
highlighted && 'bg-background-brand-light border-border-brand'
|
|
105
|
+
)}
|
|
106
|
+
>
|
|
107
|
+
<div className="flex items-center gap-4">
|
|
108
|
+
<ChototLogoText />
|
|
109
|
+
<div>
|
|
110
|
+
<HeaderSection as="h3">Liên hệ người bán</HeaderSection>
|
|
111
|
+
<BodySection className="text-text-secondary">Hỗ trợ nhanh qua điện thoại</BodySection>
|
|
112
|
+
</div>
|
|
113
|
+
</div>
|
|
114
|
+
<Button
|
|
115
|
+
color="primary"
|
|
116
|
+
variant="solid"
|
|
117
|
+
size="md"
|
|
118
|
+
leftIcon={<ShapeIcon Icon={Call} size="sm" />}
|
|
119
|
+
rightIcon={<ShapeIcon Icon={ChevronRight} size="sm" />}
|
|
120
|
+
>
|
|
121
|
+
Gọi ngay
|
|
122
|
+
</Button>
|
|
123
|
+
</div>
|
|
124
|
+
);
|
|
125
|
+
}
|
|
126
|
+
```
|
|
170
127
|
|
|
171
|
-
|
|
128
|
+
### Token-Aware `cn` Class Merger
|
|
172
129
|
|
|
173
|
-
|
|
130
|
+
`@chotot/clad-ui` exports `cn` (powered by `shadcn-ui/cn` and pre-configured with Clad UI's custom `@theme` tokens). Use `cn` instead of installing `clsx` or `tailwind-merge` separately—it automatically resolves conflicts between Clad UI typography classes (`text-body-section`, `text-header-page`) and semantic text colors (`text-text-primary`, `text-text-error`), as well as semantic border radius (`rounded-card-small`, `rounded-card`) and shadows (`shadow-below`, `shadow-floating`).
|
|
174
131
|
|
|
175
|
-
|
|
132
|
+
```tsx
|
|
133
|
+
import { cn } from '@chotot/clad-ui';
|
|
176
134
|
|
|
177
|
-
|
|
135
|
+
// Keeps both 'text-body-caption' (font-size) and 'text-text-error' (text-color),
|
|
136
|
+
// while overriding 'text-body-section' with 'text-body-caption':
|
|
137
|
+
const classes = cn('text-body-section text-text-primary', 'text-body-caption text-text-error');
|
|
138
|
+
// => resolves to "text-body-caption text-text-error"
|
|
139
|
+
```
|
|
178
140
|
|
|
179
|
-
|
|
141
|
+
---
|
|
180
142
|
|
|
181
|
-
|
|
143
|
+
## Multi-Vertical Theming (`data-theme`)
|
|
182
144
|
|
|
183
|
-
|
|
145
|
+
Apply a vertical theme via the `data-theme` attribute on `<html>`, `<body>`, or any subtree container:
|
|
184
146
|
|
|
185
|
-
|
|
147
|
+
```html
|
|
148
|
+
<!-- Chợ Tốt (Default): Yellow brand -->
|
|
149
|
+
<body data-theme="chotot">...</body>
|
|
150
|
+
|
|
151
|
+
<!-- Nhà Tốt (Property): Orange brand -->
|
|
152
|
+
<body data-theme="pty">...</body>
|
|
153
|
+
|
|
154
|
+
<!-- Việc Làm Tốt (Jobs): Blue brand -->
|
|
155
|
+
<body data-theme="job">...</body>
|
|
156
|
+
|
|
157
|
+
<!-- Chợ Tốt Xe (Vehicles): Yellow brand + Dark header -->
|
|
158
|
+
<body data-theme="veh">...</body>
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
All semantic tokens (`bg-background-brand`, `text-text-brand`, `border-border-brand`, etc.) adapt automatically with zero runtime JS overhead.
|
|
186
162
|
|
|
187
163
|
---
|
|
188
164
|
|
|
189
|
-
|
|
165
|
+
## AI Coding Skills
|
|
166
|
+
|
|
167
|
+
`@chotot/clad-ui` ships three official AI agent skills under `skills/`:
|
|
168
|
+
|
|
169
|
+
- **`clad-ui`** — Complete component catalog, semantic token cheat-sheet, layout recipes, and best practices for building UIs with Clad UI v3.
|
|
170
|
+
- **`migrate-clad-ui-v3`** — Automated step-by-step migration playbook for upgrading consumer repositories from `@chotot/clad-ui` v2 (Linaria) to `@chotot/clad-ui` v3 (Tailwind CSS v4).
|
|
171
|
+
- **`clad-ui-feedback`** — Deduplicated GitHub issue reporter (`bug`, `enhancement`, `feature`) for consumer developers to submit feedback or request new props/icons directly on `carousell/clad-ui`.
|
|
172
|
+
|
|
173
|
+
Skills are installed automatically on `pnpm install`, or can be synced manually at any time:
|
|
174
|
+
|
|
175
|
+
```bash
|
|
176
|
+
pnpm exec clad-ui-helper
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
## Package Exports
|
|
182
|
+
|
|
183
|
+
| Export path | Description |
|
|
184
|
+
| ------------------------------------------ | ----------------------------------------------------------------------------------- |
|
|
185
|
+
| `@chotot/clad-ui` | React components, 24 Typography components, Brand logos, `cn`, and TypeScript types |
|
|
186
|
+
| `@chotot/clad-ui/icons` | 255 React SVG system icons (re-exported from `@chotot/icons`) |
|
|
187
|
+
| `@chotot/clad-ui/styles.css` | Pre-compiled CSS (design tokens + baseline + component styles) |
|
|
188
|
+
| `@chotot/clad-ui/preset.css` | Source CSS with `@source` directive for Tailwind CSS v4 JIT builds |
|
|
189
|
+
| `@chotot/clad-ui/utils/bundleCss` | `getBundledCss()` helper for Tailwind CDN / SSR inline styles |
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return s}});
|