@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.
Files changed (59) hide show
  1. package/README.md +42 -0
  2. package/ai/clad-ui-helper.js +267 -0
  3. package/ai/knowledge-base/README.md +154 -0
  4. package/ai/knowledge-base/clad-ui-database.json +9378 -0
  5. package/ai/knowledge-base/component-categories.json +616 -0
  6. package/ai/knowledge-base/components/metadata/charts-axis.json +31 -0
  7. package/ai/knowledge-base/components/metadata/charts-barchart.json +57 -0
  8. package/ai/knowledge-base/components/metadata/charts-basechart.tsx.json +31 -0
  9. package/ai/knowledge-base/components/metadata/charts-chartshared.json +31 -0
  10. package/ai/knowledge-base/components/metadata/charts-linechart.json +189 -0
  11. package/ai/knowledge-base/components/metadata/charts-piechart.json +57 -0
  12. package/ai/knowledge-base/components/metadata/components-announcer.json +215 -0
  13. package/ai/knowledge-base/components/metadata/components-badge.json +168 -0
  14. package/ai/knowledge-base/components/metadata/components-box.json +348 -0
  15. package/ai/knowledge-base/components/metadata/components-breadcrumbs.json +75 -0
  16. package/ai/knowledge-base/components/metadata/components-button.json +187 -0
  17. package/ai/knowledge-base/components/metadata/components-checkbox.json +161 -0
  18. package/ai/knowledge-base/components/metadata/components-chip.json +266 -0
  19. package/ai/knowledge-base/components/metadata/components-currencyinput.json +136 -0
  20. package/ai/knowledge-base/components/metadata/components-datepicker.json +87 -0
  21. package/ai/knowledge-base/components/metadata/components-dropdown.json +282 -0
  22. package/ai/knowledge-base/components/metadata/components-grid.json +92 -0
  23. package/ai/knowledge-base/components/metadata/components-input.json +432 -0
  24. package/ai/knowledge-base/components/metadata/components-pagination.json +111 -0
  25. package/ai/knowledge-base/components/metadata/components-popover.json +63 -0
  26. package/ai/knowledge-base/components/metadata/components-radiobutton.json +170 -0
  27. package/ai/knowledge-base/components/metadata/components-rowitem.json +281 -0
  28. package/ai/knowledge-base/components/metadata/components-shapeicon.json +139 -0
  29. package/ai/knowledge-base/components/metadata/components-slider.json +177 -0
  30. package/ai/knowledge-base/components/metadata/components-snack.json +181 -0
  31. package/ai/knowledge-base/components/metadata/components-tabs.json +169 -0
  32. package/ai/knowledge-base/components/metadata/components-textarea.json +285 -0
  33. package/ai/knowledge-base/components/metadata/components-textlabel.json +129 -0
  34. package/ai/knowledge-base/components/metadata/components-toggleswitch.json +134 -0
  35. package/ai/knowledge-base/components/metadata/components-tooltip.json +291 -0
  36. package/ai/knowledge-base/components/metadata/patterns-drawer.json +310 -0
  37. package/ai/knowledge-base/components/metadata/patterns-emptystate.json +106 -0
  38. package/ai/knowledge-base/components/metadata/patterns-inputgroup.json +105 -0
  39. package/ai/knowledge-base/components/metadata/patterns-legacydialog.json +177 -0
  40. package/ai/knowledge-base/components/metadata/patterns-legacypopup.json +236 -0
  41. package/ai/knowledge-base/components/metadata/patterns-multisearchdropdown.json +249 -0
  42. package/ai/knowledge-base/components/metadata/patterns-popup.json +268 -0
  43. package/ai/knowledge-base/components/metadata/patterns-rangeinput.json +105 -0
  44. package/ai/knowledge-base/components/metadata/patterns-searchbar.json +150 -0
  45. package/ai/knowledge-base/components/metadata/patterns-searchinput.json +312 -0
  46. package/ai/knowledge-base/components/metadata/patterns-tagcloud.json +244 -0
  47. package/ai/knowledge-base/components/metadata/summaries.json +610 -0
  48. package/ai/knowledge-base/design-tokens/tokens.json +483 -0
  49. package/ai/knowledge-base/patterns/documentation.json +131 -0
  50. package/ai/knowledge-base/prompts/common-system-prompt.md +592 -0
  51. package/ai/knowledge-base/prompts/figma-system-prompt.md +396 -0
  52. package/ai/knowledge-base/search-index/icons/asset-icons.json +1 -0
  53. package/ai/knowledge-base/search-index/icons/collection.json +5 -0
  54. package/ai/knowledge-base/search-index/icons/system-icons.json +1 -0
  55. package/ai/knowledge-base/search-index/search-index.json +899 -0
  56. package/ai/knowledge-base/validation-rules/component-rules.json +658 -0
  57. package/ai/skill/SKILL.md +103 -0
  58. package/dist/clad-ui.es.js +25 -25
  59. 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.
@@ -550,35 +550,35 @@ var ue = {
550
550
  zIndices: we,
551
551
  typo: De
552
552
  }), { colors: ke } = Oe, Ae = {
553
- vertical50: "#F2F6FC",
554
- vertical75: "#E4ECFB",
555
- vertical100: "#CADBF7",
556
- vertical200: "#A3C0F5",
557
- vertical300: "#7FA7F0",
558
- vertical400: "#548AF0",
559
- vertical500: "#306BD9",
560
- vertical600: "#1952BA",
561
- vertical700: "#113B8A",
562
- vertical800: "#0B2F70",
563
- vertical900: "#0B234F"
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: je.vertical500,
569
- backgroundBrandLight: je.vertical50,
570
- textBrand: je.vertical500,
571
- textOnBackground: je.gray0,
572
- buttonPrimary: je.vertical500,
573
- buttonSecondary: je.vertical50,
574
- borderBrand: je.vertical500,
575
- borderActive: je.vertical500,
576
- iconBrand: je.vertical500,
577
- iconOnBackground: je.gray0,
578
- interactionBrandHover: je.vertical400,
579
- interactionBrandPressed: je.vertical600,
580
- interactionBrandLightHover: je.vertical75,
581
- interactionBrandLightPressed: je.vertical100
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.2",
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",