@chotot/clad-ui 3.0.0-next.2 → 3.0.0-next.3
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/README.md +42 -0
- package/ai/clad-ui-helper.js +267 -0
- package/ai/knowledge-base/README.md +154 -0
- package/ai/knowledge-base/clad-ui-database.json +9378 -0
- package/ai/knowledge-base/component-categories.json +616 -0
- package/ai/knowledge-base/components/metadata/charts-axis.json +31 -0
- package/ai/knowledge-base/components/metadata/charts-barchart.json +57 -0
- package/ai/knowledge-base/components/metadata/charts-basechart.tsx.json +31 -0
- package/ai/knowledge-base/components/metadata/charts-chartshared.json +31 -0
- package/ai/knowledge-base/components/metadata/charts-linechart.json +189 -0
- package/ai/knowledge-base/components/metadata/charts-piechart.json +57 -0
- package/ai/knowledge-base/components/metadata/components-announcer.json +215 -0
- package/ai/knowledge-base/components/metadata/components-badge.json +168 -0
- package/ai/knowledge-base/components/metadata/components-box.json +348 -0
- package/ai/knowledge-base/components/metadata/components-breadcrumbs.json +75 -0
- package/ai/knowledge-base/components/metadata/components-button.json +187 -0
- package/ai/knowledge-base/components/metadata/components-checkbox.json +161 -0
- package/ai/knowledge-base/components/metadata/components-chip.json +266 -0
- package/ai/knowledge-base/components/metadata/components-currencyinput.json +136 -0
- package/ai/knowledge-base/components/metadata/components-datepicker.json +87 -0
- package/ai/knowledge-base/components/metadata/components-dropdown.json +282 -0
- package/ai/knowledge-base/components/metadata/components-grid.json +92 -0
- package/ai/knowledge-base/components/metadata/components-input.json +432 -0
- package/ai/knowledge-base/components/metadata/components-pagination.json +111 -0
- package/ai/knowledge-base/components/metadata/components-popover.json +63 -0
- package/ai/knowledge-base/components/metadata/components-radiobutton.json +170 -0
- package/ai/knowledge-base/components/metadata/components-rowitem.json +281 -0
- package/ai/knowledge-base/components/metadata/components-shapeicon.json +139 -0
- package/ai/knowledge-base/components/metadata/components-slider.json +177 -0
- package/ai/knowledge-base/components/metadata/components-snack.json +181 -0
- package/ai/knowledge-base/components/metadata/components-tabs.json +169 -0
- package/ai/knowledge-base/components/metadata/components-textarea.json +285 -0
- package/ai/knowledge-base/components/metadata/components-textlabel.json +129 -0
- package/ai/knowledge-base/components/metadata/components-toggleswitch.json +134 -0
- package/ai/knowledge-base/components/metadata/components-tooltip.json +291 -0
- package/ai/knowledge-base/components/metadata/patterns-drawer.json +310 -0
- package/ai/knowledge-base/components/metadata/patterns-emptystate.json +106 -0
- package/ai/knowledge-base/components/metadata/patterns-inputgroup.json +105 -0
- package/ai/knowledge-base/components/metadata/patterns-legacydialog.json +177 -0
- package/ai/knowledge-base/components/metadata/patterns-legacypopup.json +236 -0
- package/ai/knowledge-base/components/metadata/patterns-multisearchdropdown.json +249 -0
- package/ai/knowledge-base/components/metadata/patterns-popup.json +268 -0
- package/ai/knowledge-base/components/metadata/patterns-rangeinput.json +105 -0
- package/ai/knowledge-base/components/metadata/patterns-searchbar.json +150 -0
- package/ai/knowledge-base/components/metadata/patterns-searchinput.json +312 -0
- package/ai/knowledge-base/components/metadata/patterns-tagcloud.json +244 -0
- package/ai/knowledge-base/components/metadata/summaries.json +610 -0
- package/ai/knowledge-base/design-tokens/tokens.json +483 -0
- package/ai/knowledge-base/patterns/documentation.json +131 -0
- package/ai/knowledge-base/prompts/common-system-prompt.md +592 -0
- package/ai/knowledge-base/prompts/figma-system-prompt.md +396 -0
- package/ai/knowledge-base/search-index/icons/asset-icons.json +1 -0
- package/ai/knowledge-base/search-index/icons/collection.json +5 -0
- package/ai/knowledge-base/search-index/icons/system-icons.json +1 -0
- package/ai/knowledge-base/search-index/search-index.json +899 -0
- package/ai/knowledge-base/validation-rules/component-rules.json +658 -0
- package/ai/skill/SKILL.md +103 -0
- package/dist/clad-ui.es.js +25 -25
- package/package.json +8 -2
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: clad-ui
|
|
3
|
+
description: >-
|
|
4
|
+
Clad UI Design System expert. Provides direct access to all components,
|
|
5
|
+
icons, design tokens, and implementation guidelines by running a single
|
|
6
|
+
helper tool against a pre-generated knowledge base—no MCP server required.
|
|
7
|
+
Use /clad-ui to search components, get props/examples, find icons, explore
|
|
8
|
+
design tokens, or load the full system prompt for building UI with Clad UI.
|
|
9
|
+
version: 1.0.0
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Clad UI Design System Skill
|
|
13
|
+
|
|
14
|
+
You are a Clad UI Design System expert. For every query you run `npx clad-ui-helper` which handles all lookups and returns compact JSON — you never read large files manually.
|
|
15
|
+
|
|
16
|
+
If `clad-ui-helper` is not found, tell the user to run `npm install @chotot/clad-ui`.
|
|
17
|
+
|
|
18
|
+
## Commands
|
|
19
|
+
|
|
20
|
+
All commands: `npx clad-ui-helper <command> [args] [--flag=value]`
|
|
21
|
+
|
|
22
|
+
### `search` — find components
|
|
23
|
+
**Trigger**: `/clad-ui [search] <query>`, or "what component should I use for X?"
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npx clad-ui-helper search "query" [--category=components|patterns|charts] [--status=stable|beta|deprecated]
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Present results as a table. Offer to run `info` on any match.
|
|
30
|
+
|
|
31
|
+
### `list` — list all components
|
|
32
|
+
**Trigger**: `/clad-ui list [components|patterns|charts]`
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
npx clad-ui-helper search [--category=components|patterns|charts]
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Group by category.
|
|
39
|
+
|
|
40
|
+
### `info <ComponentName>` — full component detail
|
|
41
|
+
**Trigger**: `/clad-ui info <Name>` or "how do I use `<Name>`?"
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
npx clad-ui-helper info "ComponentName"
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Output has keys: `metadata` (name, description, status), `usage` (importPath, basicExample, commonPatterns), `props` (name / type / required / default), `variants`, `accessibility`, `relatedComponents`, `designTokens`.
|
|
48
|
+
|
|
49
|
+
### `icons [query]` — search or list icons
|
|
50
|
+
**Trigger**: `/clad-ui icons [<query>]`
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
npx clad-ui-helper icons ["query"] [--category=system|asset] [--limit=<n>|all]
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Show name, category, type, keywords, usage.
|
|
57
|
+
|
|
58
|
+
### `tokens [category]` — design tokens
|
|
59
|
+
**Trigger**: `/clad-ui tokens [colors|typography|spacing|breakpoints|borderRadius|shadows|zIndices|all]`
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
npx clad-ui-helper tokens [category]
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Display as a readable table. Note: `primitive` tokens have resolved hex values. `semantic` and `alias` tokens show `<reference>` because they resolve to different primitive values per brand theme (chotot, mudah, etc.) — use the token **name** not the value when writing code.
|
|
66
|
+
|
|
67
|
+
### `validate <Name> [props]` — validate component usage
|
|
68
|
+
**Trigger**: `/clad-ui validate <Name>` or "am I using `<Name>` correctly?"
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
npx clad-ui-helper validate "ComponentName" ['{"prop":"value"}']
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Report errors, warnings, best practices.
|
|
75
|
+
|
|
76
|
+
### `stats` — design system overview
|
|
77
|
+
**Trigger**: `/clad-ui stats`
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
npx clad-ui-helper stats
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### `guidelines [figma]` — load system prompt
|
|
84
|
+
**Trigger**: `/clad-ui guidelines` or `/clad-ui figma`
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
npx clad-ui-helper guidelines [figma]
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Output the full content as your operating context for the session.
|
|
91
|
+
|
|
92
|
+
### `help` — show available commands
|
|
93
|
+
**Trigger**: `/clad-ui` with no args. Print a concise command table.
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## Rules
|
|
98
|
+
|
|
99
|
+
- **Always run the helper** — never read large JSON files manually.
|
|
100
|
+
- **Never fabricate** component names, props, or token values not returned by the helper.
|
|
101
|
+
- **Import paths**: use exact paths from `info` output (e.g. `import { Button } from '@chotot/clad-ui'`).
|
|
102
|
+
- **Design tokens**: always prefer semantic names (`backgroundPrimary`, `textSecondary`) over hardcoded values.
|
|
103
|
+
- **UI task (no subcommand)**: automatically run `search` to discover relevant components, then `info` for details, then provide implementation guidance.
|
package/dist/clad-ui.es.js
CHANGED
|
@@ -550,35 +550,35 @@ var ue = {
|
|
|
550
550
|
zIndices: we,
|
|
551
551
|
typo: De
|
|
552
552
|
}), { colors: ke } = Oe, Ae = {
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
553
|
+
chototxe50: "#FFF8D6",
|
|
554
|
+
chototxe75: "#FFE884",
|
|
555
|
+
chototxe100: "#FFD400",
|
|
556
|
+
chototxe200: "#FFC800",
|
|
557
|
+
chototxe300: "#FFBA00",
|
|
558
|
+
chototxe400: "#CC8F00",
|
|
559
|
+
chototxe500: "#9E6C00",
|
|
560
|
+
chototxe600: "#7F5500",
|
|
561
|
+
chototxe700: "#603F00",
|
|
562
|
+
chototxe800: "#4F3200",
|
|
563
|
+
chototxe900: "#432900"
|
|
564
564
|
}, je = {
|
|
565
565
|
...ke,
|
|
566
566
|
...Ae
|
|
567
567
|
}, Me = {
|
|
568
|
-
backgroundBrand:
|
|
569
|
-
backgroundBrandLight:
|
|
570
|
-
textBrand:
|
|
571
|
-
textOnBackground:
|
|
572
|
-
buttonPrimary:
|
|
573
|
-
buttonSecondary:
|
|
574
|
-
borderBrand:
|
|
575
|
-
borderActive:
|
|
576
|
-
iconBrand:
|
|
577
|
-
iconOnBackground:
|
|
578
|
-
interactionBrandHover:
|
|
579
|
-
interactionBrandPressed:
|
|
580
|
-
interactionBrandLightHover:
|
|
581
|
-
interactionBrandLightPressed:
|
|
568
|
+
backgroundBrand: ke.vertical100,
|
|
569
|
+
backgroundBrandLight: ke.vertical50,
|
|
570
|
+
textBrand: ke.vertical400,
|
|
571
|
+
textOnBackground: ke.gray900,
|
|
572
|
+
buttonPrimary: ke.vertical100,
|
|
573
|
+
buttonSecondary: ke.vertical50,
|
|
574
|
+
borderBrand: ke.vertical100,
|
|
575
|
+
borderActive: ke.vertical100,
|
|
576
|
+
iconBrand: ke.vertical300,
|
|
577
|
+
iconOnBackground: ke.gray900,
|
|
578
|
+
interactionBrandHover: ke.vertical75,
|
|
579
|
+
interactionBrandPressed: ke.vertical200,
|
|
580
|
+
interactionBrandLightHover: ke.vertical50,
|
|
581
|
+
interactionBrandLightPressed: ke.vertical75
|
|
582
582
|
}, Y = {
|
|
583
583
|
...Oe,
|
|
584
584
|
colors: {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@chotot/clad-ui",
|
|
3
|
-
"version": "3.0.0-next.
|
|
3
|
+
"version": "3.0.0-next.3",
|
|
4
4
|
"description": "Classified Ads group (Carousell, Chotot, Mudah, Onekyat) design system.",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -34,9 +34,13 @@
|
|
|
34
34
|
"main": "./dist/clad-ui.cjs.js",
|
|
35
35
|
"module": "./dist/clad-ui.es.js",
|
|
36
36
|
"types": "./dist/index.d.ts",
|
|
37
|
+
"bin": {
|
|
38
|
+
"clad-ui-helper": "./ai/clad-ui-helper.js"
|
|
39
|
+
},
|
|
37
40
|
"files": [
|
|
38
41
|
"dist",
|
|
39
|
-
"theme"
|
|
42
|
+
"theme",
|
|
43
|
+
"ai/**/*"
|
|
40
44
|
],
|
|
41
45
|
"devDependencies": {
|
|
42
46
|
"@babel/core": "^7.23.2",
|
|
@@ -116,7 +120,9 @@
|
|
|
116
120
|
"lint-staged:package": "sort-package-json",
|
|
117
121
|
"lint:css": "stylelint '{css,components,patterns,storybook}/**/*.{js,ts,tsx}'",
|
|
118
122
|
"lint:js": "eslint .",
|
|
123
|
+
"copy-kb": "bash scripts/copy-kb.sh",
|
|
119
124
|
"lint:fix": "eslint . --fix",
|
|
125
|
+
"postinstall": "node ai/clad-ui-helper.js link-skill",
|
|
120
126
|
"start": "echo 'start script not available; try website workspace'",
|
|
121
127
|
"test": "run-p type-check ci:js ci:jest lint:css",
|
|
122
128
|
"type-check": "tsc --noEmit",
|