@utopia-studio-design/design-system-cli 0.1.0 → 0.2.0

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 (52) hide show
  1. package/README.md +12 -41
  2. package/bin/utopia-ds-mcp.mjs +55 -0
  3. package/bin/utopia-ds.mjs +233 -318
  4. package/data/docs/ai-platform-plan.md +53 -0
  5. package/data/docs/arabic-friendly.md +72 -0
  6. package/data/docs/foundations.md +154 -0
  7. package/data/docs/guide.md +37 -0
  8. package/data/docs/quick-start-ai.md +122 -0
  9. package/data/docs/shadcn-conversion.md +35 -0
  10. package/data/docs/theme-authoring.md +46 -0
  11. package/data/manifests/catalog.json +546 -0
  12. package/data/manifests/components.json +4780 -0
  13. package/data/manifests/patterns.json +12 -0
  14. package/data/manifests/templates.json +96 -0
  15. package/data/manifests/theme-barrier-intelligence.json +123 -0
  16. package/data/manifests/theme-dextrum.json +255 -0
  17. package/data/manifests/theme-utopia-default.json +163 -0
  18. package/data/manifests/themes.json +417 -0
  19. package/data/templates/saas-solution-homepage/README.md +52 -0
  20. package/data/templates/saas-solution-homepage/agents/index.html +1 -0
  21. package/data/templates/saas-solution-homepage/changelog/index.html +1 -0
  22. package/data/templates/saas-solution-homepage/contact-sales/index.html +1 -0
  23. package/data/templates/saas-solution-homepage/customers/aster-labs/index.html +1 -0
  24. package/data/templates/saas-solution-homepage/customers/index.html +1 -0
  25. package/data/templates/saas-solution-homepage/index.html +17 -0
  26. package/data/templates/saas-solution-homepage/integrations/index.html +1 -0
  27. package/data/templates/saas-solution-homepage/integrations/slack/index.html +1 -0
  28. package/data/templates/saas-solution-homepage/main.tsx +642 -0
  29. package/data/templates/saas-solution-homepage/pricing/index.html +1 -0
  30. package/data/templates/saas-solution-homepage/product/index.html +1 -0
  31. package/data/templates/saas-solution-homepage/styles.css +863 -0
  32. package/data/templates/saas-solution-homepage/template.manifest.json +36 -0
  33. package/lib/api.mjs +146 -0
  34. package/package.json +13 -20
  35. package/LICENSE +0 -21
  36. package/templates/agent-docs/examples.md +0 -33
  37. package/templates/agent-docs/index.md +0 -78
  38. package/templates/agent-docs/llms.txt +0 -33
  39. package/templates/components/badge.tsx +0 -12
  40. package/templates/components/brand-action.tsx +0 -32
  41. package/templates/components/button-group.tsx +0 -30
  42. package/templates/components/button.tsx +0 -44
  43. package/templates/components/card.tsx +0 -23
  44. package/templates/components/cta-section.tsx +0 -34
  45. package/templates/components/icon-button.tsx +0 -44
  46. package/templates/components/page-hero.tsx +0 -47
  47. package/templates/components/tooltip.tsx +0 -48
  48. package/templates/components/topbar.tsx +0 -59
  49. package/templates/lib/utils.ts +0 -6
  50. package/templates/styles/styles.css +0 -271
  51. package/templates/styles/tokens.css +0 -21
  52. package/templates/tokens.json +0 -41
@@ -0,0 +1,546 @@
1
+ {
2
+ "$schema": "https://utopia-studio.co/design-system/catalog.schema.json",
3
+ "name": "Utopia Design System Catalog",
4
+ "version": "0.1.0",
5
+ "purpose": "Standalone source of truth for the Utopia Design System home, docs, component catalog, templates, themes, and AI agent workflow.",
6
+ "topLevelAreas": [
7
+ {
8
+ "id": "docs",
9
+ "label": "Docs",
10
+ "description": "Guides, foundations, libraries, AI setup, and Arabic-friendly rules.",
11
+ "groups": [
12
+ {
13
+ "id": "guide",
14
+ "label": "Guide",
15
+ "items": [
16
+ "Getting Started",
17
+ "Quick Start with AI",
18
+ "Working with AI",
19
+ "Principles",
20
+ "Theme System",
21
+ "Arabic Friendly",
22
+ "Styling Components",
23
+ "Styling Library Interop",
24
+ "Migration Guide"
25
+ ]
26
+ },
27
+ {
28
+ "id": "foundations",
29
+ "label": "Foundations",
30
+ "items": [
31
+ "Token Architecture",
32
+ "All Tokens",
33
+ "Semantic Tokens",
34
+ "Component Tokens",
35
+ "Icons",
36
+ "Illustrations"
37
+ ]
38
+ },
39
+ {
40
+ "id": "libraries",
41
+ "label": "Libraries",
42
+ "items": [
43
+ "@utopia-studio-design/design-system",
44
+ "@utopia-studio-design/design-system-cli",
45
+ "shadcn/ui foundation"
46
+ ]
47
+ }
48
+ ]
49
+ },
50
+ {
51
+ "id": "components",
52
+ "label": "Components",
53
+ "description": "shadcn/ui-founded primitives, Utopia wrappers, planned catalog coverage, and AI component contracts.",
54
+ "groups": [
55
+ {
56
+ "id": "actions",
57
+ "label": "Action",
58
+ "items": [
59
+ "Button",
60
+ "Button Group",
61
+ "Icon Button",
62
+ "Toggle Button",
63
+ "Toggle Button Group"
64
+ ]
65
+ },
66
+ {
67
+ "id": "surfaces",
68
+ "label": "Surfaces",
69
+ "items": [
70
+ "Card",
71
+ "Hover Card",
72
+ "Popover",
73
+ "Tooltip"
74
+ ]
75
+ },
76
+ {
77
+ "id": "forms",
78
+ "label": "Forms",
79
+ "items": [
80
+ "Checkbox",
81
+ "Combobox",
82
+ "Date Picker",
83
+ "Field",
84
+ "Input",
85
+ "Input Group",
86
+ "Input OTP",
87
+ "Label",
88
+ "Native Select",
89
+ "Radio Group",
90
+ "Select",
91
+ "Slider",
92
+ "Switch",
93
+ "Textarea"
94
+ ]
95
+ },
96
+ {
97
+ "id": "chat",
98
+ "label": "Chat",
99
+ "items": [
100
+ "Chat Composer",
101
+ "Chat Composer Drawer",
102
+ "Chat Composer Input",
103
+ "Chat Composer Token Element",
104
+ "Chat Dictation Button",
105
+ "Chat Layout",
106
+ "Chat Layout Scroll Button",
107
+ "Chat Message",
108
+ "Chat Message Bubble",
109
+ "Chat Message List",
110
+ "Chat Message Metadata",
111
+ "Chat Send Button",
112
+ "Chat System Message",
113
+ "Chat Tokenized Text",
114
+ "Chat Tool Calls"
115
+ ]
116
+ },
117
+ {
118
+ "id": "navigation",
119
+ "label": "Navigation",
120
+ "items": [
121
+ "Breadcrumb",
122
+ "Breadcrumb Item",
123
+ "Breadcrumbs",
124
+ "Command",
125
+ "Context Menu",
126
+ "Dropdown Menu",
127
+ "Menubar",
128
+ "Mobile Nav",
129
+ "Mobile Nav Toggle",
130
+ "Nav Heading Menu",
131
+ "Nav Icon",
132
+ "Navigation Menu",
133
+ "Pagination",
134
+ "Sidebar",
135
+ "Side Nav",
136
+ "Side Nav Collapse Button",
137
+ "Side Nav Heading",
138
+ "Side Nav Item",
139
+ "Side Nav Section",
140
+ "Tabs",
141
+ "Top Nav",
142
+ "Top Nav Heading",
143
+ "Top Nav Item",
144
+ "Top Nav Mega Menu",
145
+ "Top Nav Mega Menu Featured Card",
146
+ "Top Nav Mega Menu Item",
147
+ "Top Nav Menu"
148
+ ]
149
+ },
150
+ {
151
+ "id": "feedback",
152
+ "label": "Feedback",
153
+ "items": [
154
+ "Alert",
155
+ "Alert Dialog",
156
+ "Dialog",
157
+ "Drawer",
158
+ "Sheet",
159
+ "Sonner",
160
+ "Toast"
161
+ ]
162
+ },
163
+ {
164
+ "id": "layout",
165
+ "label": "Layout",
166
+ "items": [
167
+ "Accordion",
168
+ "Aspect Ratio",
169
+ "Collapsible",
170
+ "Direction",
171
+ "Resizable",
172
+ "Scroll Area",
173
+ "Separator"
174
+ ]
175
+ },
176
+ {
177
+ "id": "data",
178
+ "label": "Data Display",
179
+ "items": [
180
+ "Attachment",
181
+ "Account Status",
182
+ "Avatar",
183
+ "Badge",
184
+ "Bubble",
185
+ "Calendar",
186
+ "Carousel",
187
+ "Chart",
188
+ "Data Table",
189
+ "Empty",
190
+ "Item",
191
+ "Kbd",
192
+ "Progress",
193
+ "Skeleton",
194
+ "Spinner",
195
+ "Table",
196
+ "Typography"
197
+ ]
198
+ }
199
+ ]
200
+ },
201
+ {
202
+ "id": "templates",
203
+ "label": "Templates",
204
+ "description": "Website pages, product/SaaS surfaces, and production-reference templates for AI page generation.",
205
+ "groups": [
206
+ {
207
+ "id": "website-pages",
208
+ "label": "Website Pages",
209
+ "items": [
210
+ "SaaS Solution Website"
211
+ ]
212
+ }
213
+ ]
214
+ },
215
+ {
216
+ "id": "themes",
217
+ "label": "Themes",
218
+ "description": "Token-contract implementations. Utopia Default is the first locked theme, not the whole system.",
219
+ "groups": [
220
+ {
221
+ "id": "active",
222
+ "label": "Active",
223
+ "items": [
224
+ "The Utopia Studio Default",
225
+ "Dextrum",
226
+ "Barrier Intelligence"
227
+ ]
228
+ }
229
+ ]
230
+ }
231
+ ],
232
+ "componentStatus": {
233
+ "available": [
234
+ "Accordion",
235
+ "Account Status",
236
+ "Alert",
237
+ "Alert Dialog",
238
+ "Aspect Ratio",
239
+ "Attachment",
240
+ "Avatar",
241
+ "Badge",
242
+ "Breadcrumb",
243
+ "Bubble",
244
+ "Button",
245
+ "Button Group",
246
+ "Calendar",
247
+ "Card",
248
+ "Carousel",
249
+ "Chart",
250
+ "Chat Composer",
251
+ "Chat Composer Drawer",
252
+ "Chat Composer Input",
253
+ "Chat Composer Token Element",
254
+ "Chat Dictation Button",
255
+ "Chat Layout",
256
+ "Chat Layout Scroll Button",
257
+ "Chat Message",
258
+ "Chat Message Bubble",
259
+ "Chat Message List",
260
+ "Chat Message Metadata",
261
+ "Chat Send Button",
262
+ "Chat System Message",
263
+ "Chat Tokenized Text",
264
+ "Chat Tool Calls",
265
+ "Checkbox",
266
+ "Collapsible",
267
+ "Combobox",
268
+ "Command",
269
+ "Context Menu",
270
+ "Data Table",
271
+ "Date Picker",
272
+ "Dialog",
273
+ "Direction",
274
+ "Drawer",
275
+ "Dropdown Menu",
276
+ "Empty",
277
+ "Field",
278
+ "Hover Card",
279
+ "Icon Button",
280
+ "Input",
281
+ "Input Group",
282
+ "Input OTP",
283
+ "Item",
284
+ "Kbd",
285
+ "Label",
286
+ "Menubar",
287
+ "Native Select",
288
+ "Navigation Menu",
289
+ "Pagination",
290
+ "Popover",
291
+ "Progress",
292
+ "Radio Group",
293
+ "Resizable",
294
+ "Scroll Area",
295
+ "Select",
296
+ "Separator",
297
+ "Sheet",
298
+ "Skeleton",
299
+ "Slider",
300
+ "Sonner",
301
+ "Spinner",
302
+ "Switch",
303
+ "Table",
304
+ "Tabs",
305
+ "Textarea",
306
+ "Toggle Button",
307
+ "Toggle Button Group",
308
+ "Tooltip",
309
+ "Typography"
310
+ ],
311
+ "utopiaWrapped": [
312
+ "Accordion",
313
+ "Alert",
314
+ "Alert Dialog",
315
+ "Aspect Ratio",
316
+ "Attachment",
317
+ "Avatar",
318
+ "Badge",
319
+ "Breadcrumb",
320
+ "Bubble",
321
+ "Button",
322
+ "Button Group",
323
+ "Calendar",
324
+ "Card",
325
+ "Carousel",
326
+ "Chart",
327
+ "Chat Composer",
328
+ "Chat Composer Drawer",
329
+ "Chat Composer Input",
330
+ "Chat Composer Token Element",
331
+ "Chat Dictation Button",
332
+ "Chat Layout",
333
+ "Chat Layout Scroll Button",
334
+ "Chat Message",
335
+ "Chat Message Bubble",
336
+ "Chat Message List",
337
+ "Chat Message Metadata",
338
+ "Chat Send Button",
339
+ "Chat System Message",
340
+ "Chat Tokenized Text",
341
+ "Chat Tool Calls",
342
+ "Checkbox",
343
+ "Collapsible",
344
+ "Combobox",
345
+ "Command",
346
+ "Context Menu",
347
+ "Data Table",
348
+ "Date Picker",
349
+ "Dialog",
350
+ "Direction",
351
+ "Drawer",
352
+ "Dropdown Menu",
353
+ "Empty",
354
+ "Field",
355
+ "Hover Card",
356
+ "Icon Button",
357
+ "Input",
358
+ "Input Group",
359
+ "Input OTP",
360
+ "Item",
361
+ "Kbd",
362
+ "Label",
363
+ "Menubar",
364
+ "Native Select",
365
+ "Navigation Menu",
366
+ "Pagination",
367
+ "Popover",
368
+ "Progress",
369
+ "Radio Group",
370
+ "Resizable",
371
+ "Scroll Area",
372
+ "Select",
373
+ "Separator",
374
+ "Sheet",
375
+ "Skeleton",
376
+ "Slider",
377
+ "Sonner",
378
+ "Spinner",
379
+ "Switch",
380
+ "Table",
381
+ "Tabs",
382
+ "Textarea",
383
+ "Toggle Button",
384
+ "Toggle Button Group",
385
+ "Tooltip",
386
+ "Typography"
387
+ ],
388
+ "legacy": [
389
+ "Toast"
390
+ ],
391
+ "shadcnFallback": [
392
+ "attachment",
393
+ "bubble",
394
+ "message",
395
+ "message-scroller",
396
+ "accordion",
397
+ "alert",
398
+ "alert-dialog",
399
+ "aspect-ratio",
400
+ "avatar",
401
+ "badge",
402
+ "breadcrumb",
403
+ "button",
404
+ "button-group",
405
+ "calendar",
406
+ "card",
407
+ "carousel",
408
+ "chart",
409
+ "checkbox",
410
+ "collapsible",
411
+ "combobox",
412
+ "command",
413
+ "context-menu",
414
+ "data-table",
415
+ "date-picker",
416
+ "dialog",
417
+ "direction",
418
+ "drawer",
419
+ "dropdown-menu",
420
+ "empty",
421
+ "field",
422
+ "hover-card",
423
+ "input",
424
+ "input-group",
425
+ "input-otp",
426
+ "item",
427
+ "kbd",
428
+ "label",
429
+ "menubar",
430
+ "native-select",
431
+ "navigation-menu",
432
+ "pagination",
433
+ "popover",
434
+ "progress",
435
+ "radio-group",
436
+ "resizable",
437
+ "scroll-area",
438
+ "select",
439
+ "separator",
440
+ "sheet",
441
+ "sidebar",
442
+ "skeleton",
443
+ "slider",
444
+ "sonner",
445
+ "spinner",
446
+ "switch",
447
+ "table",
448
+ "tabs",
449
+ "textarea",
450
+ "toast",
451
+ "toggle",
452
+ "toggle-group",
453
+ "tooltip",
454
+ "typography"
455
+ ],
456
+ "planned": []
457
+ },
458
+ "docFamilies": [
459
+ {
460
+ "id": "semantic-tokens",
461
+ "label": "Semantic Tokens",
462
+ "parent": "Semantic Tokens",
463
+ "group": "foundations",
464
+ "items": [
465
+ "Color",
466
+ "Typography",
467
+ "Spacing",
468
+ "Shape",
469
+ "Motion",
470
+ "Elevation",
471
+ "Direction / RTL"
472
+ ],
473
+ "description": "Stable role contracts that every compatible theme implements."
474
+ }
475
+ ],
476
+ "themeFamilies": [
477
+ {
478
+ "id": "utopia-default-theme",
479
+ "label": "The Utopia Studio Default",
480
+ "parent": "The Utopia Studio Default",
481
+ "group": "active",
482
+ "items": [
483
+ "Overview",
484
+ "Primitives",
485
+ "Typography",
486
+ "Semantic Mapping"
487
+ ],
488
+ "description": "The first locked brand implementation of the shared semantic contract."
489
+ },
490
+ {
491
+ "id": "dextrum-theme",
492
+ "label": "Dextrum",
493
+ "parent": "Dextrum",
494
+ "group": "active",
495
+ "items": [
496
+ "Overview",
497
+ "Primitives",
498
+ "Typography",
499
+ "App & Website",
500
+ "Marketing & Sales",
501
+ "Semantic Mapping"
502
+ ],
503
+ "description": "A separate theme implementation with product and marketing typography profiles."
504
+ }
505
+ ],
506
+ "componentFamilies": [
507
+ {
508
+ "id": "side-nav",
509
+ "label": "Side Navigation",
510
+ "parent": "Side Nav",
511
+ "items": [
512
+ "Side Nav Section",
513
+ "Side Nav Heading",
514
+ "Side Nav Item",
515
+ "Side Nav Collapse Button"
516
+ ],
517
+ "description": "Composable side navigation family built from shadcn/sidebar architecture and Utopia semantic tokens."
518
+ },
519
+ {
520
+ "id": "top-nav",
521
+ "label": "Top Navigation",
522
+ "parent": "Top Nav",
523
+ "items": [
524
+ "Top Nav Heading",
525
+ "Top Nav Item",
526
+ "Top Nav Menu",
527
+ "Top Nav Mega Menu",
528
+ "Top Nav Mega Menu Featured Card",
529
+ "Top Nav Mega Menu Item",
530
+ "Nav Icon"
531
+ ],
532
+ "description": "Composable desktop top navigation family built from shadcn/Radix NavigationMenu and Utopia semantic tokens."
533
+ },
534
+ {
535
+ "id": "mobile-nav",
536
+ "label": "Mobile Navigation",
537
+ "parent": "Mobile Nav",
538
+ "items": [
539
+ "Mobile Nav Toggle",
540
+ "Nav Heading Menu",
541
+ "Nav Icon"
542
+ ],
543
+ "description": "Composable mobile navigation family built from shadcn Sheet/Dialog patterns and Utopia semantic tokens."
544
+ }
545
+ ]
546
+ }