orbital-ds 0.41.0 → 0.48.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 (321) hide show
  1. package/AGENTS.md +54 -12
  2. package/CHANGELOG.md +458 -0
  3. package/README.md +2 -2
  4. package/components.manifest.json +6630 -3569
  5. package/dist/hooks/use-esc-close-stack.js +38 -0
  6. package/dist/hooks/use-simulated-progress.js +30 -0
  7. package/dist/lib/brand-allowlist.js +703 -0
  8. package/dist/lib/brand-runtime.js +85 -0
  9. package/dist/lib/echarts-presets.js +152 -1
  10. package/dist/lib/echarts-setup.js +2 -0
  11. package/dist/lib/format.js +177 -0
  12. package/dist/lib/i18n.js +35 -2
  13. package/dist/lib/locales/de.js +536 -0
  14. package/dist/lib/locales/fr.js +536 -0
  15. package/dist/lib/locales/he.js +536 -0
  16. package/dist/lib/locales/it.js +536 -0
  17. package/dist/ui/auth-form.js +13 -6
  18. package/dist/ui/ayuda.js +4 -1
  19. package/dist/ui/breadcrumb.js +1 -1
  20. package/dist/ui/calendar.js +3 -0
  21. package/dist/ui/carousel.js +10 -5
  22. package/dist/ui/context-menu.js +3 -3
  23. package/dist/ui/cta-banner.js +63 -0
  24. package/dist/ui/date-time.js +55 -0
  25. package/dist/ui/description-list.js +86 -0
  26. package/dist/ui/detail-panel.js +2 -2
  27. package/dist/ui/dropdown-menu.js +1 -1
  28. package/dist/ui/faq.js +25 -0
  29. package/dist/ui/feature-grid.js +40 -0
  30. package/dist/ui/hero.js +145 -0
  31. package/dist/ui/landing-section.js +59 -0
  32. package/dist/ui/mfa-challenge.js +1 -1
  33. package/dist/ui/next-step-card.js +92 -0
  34. package/dist/ui/page-header.js +20 -11
  35. package/dist/ui/pagination.js +2 -2
  36. package/dist/ui/pricing-table.js +86 -0
  37. package/dist/ui/quantity.js +27 -0
  38. package/dist/ui/sheet.js +6 -2
  39. package/dist/ui/sidebar.js +7 -3
  40. package/dist/ui/tag-input.js +169 -0
  41. package/dist/ui/testimonial.js +61 -0
  42. package/dist/ui/textarea.js +7 -1
  43. package/dist/ui/usage-meter.js +116 -0
  44. package/dist/ui/week-strip.js +2 -2
  45. package/docs/adr/0001-rtl-clases-logicas.md +14 -1
  46. package/docs/designer/flujo.md +1 -1
  47. package/docs/designer/patrones.md +45 -1
  48. package/manifest/actions.json +364 -0
  49. package/manifest/agents.json +399 -0
  50. package/manifest/ai.json +128 -0
  51. package/manifest/auth.json +1547 -0
  52. package/manifest/chat.json +612 -0
  53. package/manifest/content.json +2793 -0
  54. package/manifest/data.json +2802 -0
  55. package/manifest/feedback.json +1005 -0
  56. package/manifest/forms.json +1954 -0
  57. package/manifest/motion.json +196 -0
  58. package/manifest/navigation.json +1792 -0
  59. package/manifest/overlays.json +934 -0
  60. package/package.json +240 -238
  61. package/scripts/cli.mjs +124 -8
  62. package/scripts/doctor.mjs +153 -2
  63. package/scripts/eslint-plugin.mjs +125 -0
  64. package/scripts/i18n.mjs +1 -1
  65. package/scripts/manifest.mjs +179 -7
  66. package/scripts/upgrade.mjs +126 -0
  67. package/skill/SKILL.md +8 -3
  68. package/dist/hooks/use-ds-messages.d.ts +0 -537
  69. package/dist/hooks/use-ds-motion.d.ts +0 -17
  70. package/dist/hooks/use-in-view.d.ts +0 -9
  71. package/dist/hooks/use-mobile.d.ts +0 -3
  72. package/dist/lib/a2ui-catalog.d.ts +0 -42
  73. package/dist/lib/a2ui.d.ts +0 -289
  74. package/dist/lib/ai-events.d.ts +0 -15
  75. package/dist/lib/auth-better-auth.d.ts +0 -29
  76. package/dist/lib/auth-flow.d.ts +0 -85
  77. package/dist/lib/auth-providers.d.ts +0 -194
  78. package/dist/lib/auth.d.ts +0 -68
  79. package/dist/lib/echarts-presets.d.ts +0 -227
  80. package/dist/lib/echarts-server.d.ts +0 -15
  81. package/dist/lib/echarts-setup.d.ts +0 -8
  82. package/dist/lib/echarts-theme.d.ts +0 -36
  83. package/dist/lib/header-control.d.ts +0 -4
  84. package/dist/lib/i18n.d.ts +0 -545
  85. package/dist/lib/image-upload.d.ts +0 -41
  86. package/dist/lib/motion.d.ts +0 -74
  87. package/dist/lib/presets.d.ts +0 -8
  88. package/dist/lib/template-syntax.d.ts +0 -22
  89. package/dist/lib/utils.d.ts +0 -5
  90. package/dist/motion.css +0 -146
  91. package/dist/styles.css +0 -1737
  92. package/dist/themes/chocolate.css +0 -259
  93. package/dist/themes/chocolate.fonts.css +0 -2
  94. package/dist/themes/chocolate.guide.md +0 -30
  95. package/dist/themes/chocolate.meta.json +0 -61
  96. package/dist/themes/chocolate.scoped.css +0 -259
  97. package/dist/themes/chocolate.tokens.json +0 -49
  98. package/dist/themes/fractalia.css +0 -556
  99. package/dist/themes/fractalia.fonts.css +0 -3
  100. package/dist/themes/fractalia.guide.md +0 -86
  101. package/dist/themes/fractalia.meta.json +0 -112
  102. package/dist/themes/fractalia.scoped.css +0 -556
  103. package/dist/themes/fractalia.tokens.json +0 -39
  104. package/dist/themes/friendly.css +0 -375
  105. package/dist/themes/friendly.fonts.css +0 -2
  106. package/dist/themes/friendly.guide.md +0 -38
  107. package/dist/themes/friendly.meta.json +0 -82
  108. package/dist/themes/friendly.scoped.css +0 -375
  109. package/dist/themes/friendly.tokens.json +0 -45
  110. package/dist/themes/lagoon.css +0 -362
  111. package/dist/themes/lagoon.fonts.css +0 -2
  112. package/dist/themes/lagoon.guide.md +0 -47
  113. package/dist/themes/lagoon.meta.json +0 -85
  114. package/dist/themes/lagoon.scoped.css +0 -362
  115. package/dist/themes/lagoon.tokens.json +0 -49
  116. package/dist/themes/liquid.css +0 -510
  117. package/dist/themes/liquid.fonts.css +0 -7
  118. package/dist/themes/liquid.guide.md +0 -82
  119. package/dist/themes/liquid.meta.json +0 -134
  120. package/dist/themes/liquid.scoped.css +0 -510
  121. package/dist/themes/liquid.tokens.json +0 -47
  122. package/dist/themes/matcha.css +0 -259
  123. package/dist/themes/matcha.fonts.css +0 -2
  124. package/dist/themes/matcha.guide.md +0 -30
  125. package/dist/themes/matcha.meta.json +0 -61
  126. package/dist/themes/matcha.scoped.css +0 -259
  127. package/dist/themes/matcha.tokens.json +0 -49
  128. package/dist/themes/qratia.css +0 -264
  129. package/dist/themes/qratia.fonts.css +0 -2
  130. package/dist/themes/qratia.guide.md +0 -34
  131. package/dist/themes/qratia.meta.json +0 -49
  132. package/dist/themes/qratia.scoped.css +0 -264
  133. package/dist/themes/qratia.tokens.json +0 -49
  134. package/dist/themes/stone.css +0 -263
  135. package/dist/themes/stone.fonts.css +0 -2
  136. package/dist/themes/stone.guide.md +0 -30
  137. package/dist/themes/stone.meta.json +0 -47
  138. package/dist/themes/stone.scoped.css +0 -263
  139. package/dist/themes/stone.tokens.json +0 -49
  140. package/dist/themes/tactile.css +0 -596
  141. package/dist/themes/tactile.fonts.css +0 -3
  142. package/dist/themes/tactile.guide.md +0 -82
  143. package/dist/themes/tactile.meta.json +0 -182
  144. package/dist/themes/tactile.scoped.css +0 -596
  145. package/dist/themes/tactile.tokens.json +0 -42
  146. package/dist/themes/twitter.css +0 -364
  147. package/dist/themes/twitter.fonts.css +0 -6
  148. package/dist/themes/twitter.guide.md +0 -35
  149. package/dist/themes/twitter.meta.json +0 -90
  150. package/dist/themes/twitter.scoped.css +0 -364
  151. package/dist/themes/twitter.tokens.json +0 -45
  152. package/dist/themes/y2k.css +0 -259
  153. package/dist/themes/y2k.fonts.css +0 -2
  154. package/dist/themes/y2k.guide.md +0 -30
  155. package/dist/themes/y2k.meta.json +0 -59
  156. package/dist/themes/y2k.scoped.css +0 -259
  157. package/dist/themes/y2k.tokens.json +0 -49
  158. package/dist/themes/zyro.css +0 -442
  159. package/dist/themes/zyro.fonts.css +0 -2
  160. package/dist/themes/zyro.guide.md +0 -33
  161. package/dist/themes/zyro.meta.json +0 -74
  162. package/dist/themes/zyro.scoped.css +0 -442
  163. package/dist/themes/zyro.tokens.json +0 -46
  164. package/dist/ui/a2ui-renderer.d.ts +0 -33
  165. package/dist/ui/accordion.d.ts +0 -9
  166. package/dist/ui/agent-events.d.ts +0 -32
  167. package/dist/ui/ai-tag.d.ts +0 -8
  168. package/dist/ui/alert-dialog.d.ts +0 -23
  169. package/dist/ui/alert.d.ts +0 -13
  170. package/dist/ui/animated-number.d.ts +0 -9
  171. package/dist/ui/app-bar.d.ts +0 -10
  172. package/dist/ui/aspect-ratio.d.ts +0 -7
  173. package/dist/ui/attachment.d.ts +0 -26
  174. package/dist/ui/auth-backdrop.d.ts +0 -20
  175. package/dist/ui/auth-form.d.ts +0 -113
  176. package/dist/ui/auth-layout.d.ts +0 -72
  177. package/dist/ui/auth-parts.d.ts +0 -43
  178. package/dist/ui/auth-status.d.ts +0 -23
  179. package/dist/ui/avatar.d.ts +0 -16
  180. package/dist/ui/ayuda.d.ts +0 -22
  181. package/dist/ui/badge.d.ts +0 -15
  182. package/dist/ui/banner.d.ts +0 -14
  183. package/dist/ui/bottom-nav.d.ts +0 -15
  184. package/dist/ui/breadcrumb.d.ts +0 -12
  185. package/dist/ui/bubble.d.ts +0 -19
  186. package/dist/ui/button-group.d.ts +0 -15
  187. package/dist/ui/button.d.ts +0 -14
  188. package/dist/ui/calendar.d.ts +0 -15
  189. package/dist/ui/card-stack.d.ts +0 -9
  190. package/dist/ui/card.d.ts +0 -28
  191. package/dist/ui/carousel.d.ts +0 -33
  192. package/dist/ui/chain-of-thought.d.ts +0 -19
  193. package/dist/ui/chart-card.d.ts +0 -28
  194. package/dist/ui/chart.d.ts +0 -46
  195. package/dist/ui/chart.js +0 -254
  196. package/dist/ui/chat-composer.d.ts +0 -39
  197. package/dist/ui/checkbox.d.ts +0 -6
  198. package/dist/ui/choice-card.d.ts +0 -16
  199. package/dist/ui/code-block.d.ts +0 -14
  200. package/dist/ui/collapsible.d.ts +0 -8
  201. package/dist/ui/combobox.d.ts +0 -26
  202. package/dist/ui/command-palette.d.ts +0 -36
  203. package/dist/ui/command.d.ts +0 -22
  204. package/dist/ui/confirm-action.d.ts +0 -18
  205. package/dist/ui/confirm-dialog.d.ts +0 -21
  206. package/dist/ui/connected-accounts.d.ts +0 -25
  207. package/dist/ui/content-card.d.ts +0 -52
  208. package/dist/ui/context-menu.d.ts +0 -31
  209. package/dist/ui/conversation-list.d.ts +0 -24
  210. package/dist/ui/copy-button.d.ts +0 -14
  211. package/dist/ui/data-table.d.ts +0 -198
  212. package/dist/ui/date-picker.d.ts +0 -65
  213. package/dist/ui/detail-panel.d.ts +0 -16
  214. package/dist/ui/dialog.d.ts +0 -19
  215. package/dist/ui/direction.d.ts +0 -1
  216. package/dist/ui/dock.d.ts +0 -13
  217. package/dist/ui/drawer.d.ts +0 -18
  218. package/dist/ui/dropdown-menu.d.ts +0 -31
  219. package/dist/ui/dropzone.d.ts +0 -44
  220. package/dist/ui/echart.d.ts +0 -31
  221. package/dist/ui/empty-state.d.ts +0 -26
  222. package/dist/ui/empty.d.ts +0 -15
  223. package/dist/ui/entity-list.d.ts +0 -25
  224. package/dist/ui/error-page.d.ts +0 -28
  225. package/dist/ui/error-state.d.ts +0 -16
  226. package/dist/ui/eyebrow.d.ts +0 -7
  227. package/dist/ui/field.d.ts +0 -28
  228. package/dist/ui/file-upload.d.ts +0 -42
  229. package/dist/ui/filter-bar.d.ts +0 -38
  230. package/dist/ui/form-layout.d.ts +0 -19
  231. package/dist/ui/gauge.d.ts +0 -40
  232. package/dist/ui/generated-image.d.ts +0 -14
  233. package/dist/ui/generated-table.d.ts +0 -11
  234. package/dist/ui/heatmap-grid.d.ts +0 -39
  235. package/dist/ui/hover-card.d.ts +0 -8
  236. package/dist/ui/i18n-provider.d.ts +0 -11
  237. package/dist/ui/icon-tile.d.ts +0 -11
  238. package/dist/ui/input-group.d.ts +0 -22
  239. package/dist/ui/input-otp.d.ts +0 -13
  240. package/dist/ui/input.d.ts +0 -5
  241. package/dist/ui/instruction-editor.d.ts +0 -64
  242. package/dist/ui/item.d.ts +0 -26
  243. package/dist/ui/kbd.d.ts +0 -6
  244. package/dist/ui/label.d.ts +0 -5
  245. package/dist/ui/legend.d.ts +0 -32
  246. package/dist/ui/level-meter.d.ts +0 -16
  247. package/dist/ui/load-more.d.ts +0 -19
  248. package/dist/ui/loading-state.d.ts +0 -14
  249. package/dist/ui/locale-switcher.d.ts +0 -19
  250. package/dist/ui/markdown.d.ts +0 -14
  251. package/dist/ui/marker.d.ts +0 -13
  252. package/dist/ui/media-card.d.ts +0 -13
  253. package/dist/ui/menubar.d.ts +0 -31
  254. package/dist/ui/message-actions.d.ts +0 -12
  255. package/dist/ui/message-scroller.d.ts +0 -16
  256. package/dist/ui/message.d.ts +0 -12
  257. package/dist/ui/mfa-challenge.d.ts +0 -33
  258. package/dist/ui/mfa-setup.d.ts +0 -29
  259. package/dist/ui/mosaic.d.ts +0 -15
  260. package/dist/ui/motion-provider.d.ts +0 -11
  261. package/dist/ui/native-select.d.ts +0 -10
  262. package/dist/ui/navigation-menu.d.ts +0 -15
  263. package/dist/ui/notice-review.d.ts +0 -32
  264. package/dist/ui/notifications.d.ts +0 -81
  265. package/dist/ui/oauth-consent.d.ts +0 -54
  266. package/dist/ui/page-header.d.ts +0 -22
  267. package/dist/ui/page-loader.d.ts +0 -23
  268. package/dist/ui/page-shell.d.ts +0 -8
  269. package/dist/ui/pagination.d.ts +0 -22
  270. package/dist/ui/panel.d.ts +0 -12
  271. package/dist/ui/passkey-list.d.ts +0 -17
  272. package/dist/ui/password-input.d.ts +0 -5
  273. package/dist/ui/password-strength.d.ts +0 -14
  274. package/dist/ui/popover.d.ts +0 -12
  275. package/dist/ui/progress.d.ts +0 -9
  276. package/dist/ui/proportion-bar.d.ts +0 -27
  277. package/dist/ui/questionnaire.d.ts +0 -24
  278. package/dist/ui/radio-group.d.ts +0 -8
  279. package/dist/ui/reasoning.d.ts +0 -10
  280. package/dist/ui/resizable.d.ts +0 -10
  281. package/dist/ui/reveal.d.ts +0 -11
  282. package/dist/ui/scroll-area.d.ts +0 -7
  283. package/dist/ui/search-box.d.ts +0 -32
  284. package/dist/ui/select.d.ts +0 -19
  285. package/dist/ui/separator.d.ts +0 -6
  286. package/dist/ui/session-list.d.ts +0 -19
  287. package/dist/ui/session-timeout.d.ts +0 -13
  288. package/dist/ui/sheet.d.ts +0 -16
  289. package/dist/ui/shield.d.ts +0 -21
  290. package/dist/ui/show-more.d.ts +0 -12
  291. package/dist/ui/sidebar.d.ts +0 -90
  292. package/dist/ui/sign-out-dialog.d.ts +0 -17
  293. package/dist/ui/skeleton.d.ts +0 -10
  294. package/dist/ui/slider.d.ts +0 -23
  295. package/dist/ui/sonner.d.ts +0 -6
  296. package/dist/ui/sparkline.d.ts +0 -26
  297. package/dist/ui/spinner.d.ts +0 -5
  298. package/dist/ui/stat-group.d.ts +0 -8
  299. package/dist/ui/stat.d.ts +0 -90
  300. package/dist/ui/status-badge.d.ts +0 -39
  301. package/dist/ui/status-hero.d.ts +0 -12
  302. package/dist/ui/step-dots.d.ts +0 -10
  303. package/dist/ui/step-flow.d.ts +0 -48
  304. package/dist/ui/step-ring.d.ts +0 -12
  305. package/dist/ui/stepper.d.ts +0 -20
  306. package/dist/ui/suggestions.d.ts +0 -8
  307. package/dist/ui/switch.d.ts +0 -8
  308. package/dist/ui/table.d.ts +0 -12
  309. package/dist/ui/tabs.d.ts +0 -14
  310. package/dist/ui/task-loader.d.ts +0 -14
  311. package/dist/ui/task-progress.d.ts +0 -18
  312. package/dist/ui/textarea.d.ts +0 -11
  313. package/dist/ui/theme-toggle.d.ts +0 -14
  314. package/dist/ui/timeline.d.ts +0 -29
  315. package/dist/ui/toast.d.ts +0 -19
  316. package/dist/ui/toggle-group.d.ts +0 -14
  317. package/dist/ui/toggle.d.ts +0 -12
  318. package/dist/ui/tool-call.d.ts +0 -15
  319. package/dist/ui/tooltip.d.ts +0 -9
  320. package/dist/ui/week-strip.d.ts +0 -12
  321. package/dist/ui/workflow-run.d.ts +0 -23
@@ -0,0 +1,612 @@
1
+ {
2
+ "package": "orbital-ds",
3
+ "version": "0.48.0",
4
+ "group": "chat",
5
+ "about": "Conversación: mensajes, compositor, adjuntos y sugerencias.",
6
+ "components": {
7
+ "ai-tag": {
8
+ "import": "orbital-ds/ui/ai-tag",
9
+ "group": "chat",
10
+ "summary": "Etiqueta informativa que marca un contenido como generado o asistido por IA («Generado con IA»), con un dato secundario opcional (hora, modelo).",
11
+ "see": [
12
+ {
13
+ "component": "badge",
14
+ "when": "etiqueta de estado o categoría que no es de IA"
15
+ },
16
+ {
17
+ "component": "status-badge",
18
+ "when": "estado de un proceso o de una entidad"
19
+ }
20
+ ],
21
+ "exports": [
22
+ "AiTag",
23
+ "AiTagMeta"
24
+ ],
25
+ "slots": [
26
+ "ai-tag",
27
+ "ai-tag-meta"
28
+ ],
29
+ "optionalPeers": [],
30
+ "props": {
31
+ "AiTag": {
32
+ "iconOnly": {
33
+ "type": "boolean"
34
+ }
35
+ }
36
+ },
37
+ "notes": [
38
+ "Informativa, no pulsable: para filtrar por contenido de IA, un Toggle o un filtro."
39
+ ],
40
+ "examples": [
41
+ {
42
+ "title": "Texto por defecto (en el idioma activo)",
43
+ "code": "<AiTag />"
44
+ },
45
+ {
46
+ "title": "Texto propio con dato secundario",
47
+ "code": "<AiTag>\n Resumen automático\n <AiTagMeta>10:24</AiTagMeta>\n</AiTag>"
48
+ },
49
+ {
50
+ "title": "Solo el icono",
51
+ "code": "<AiTag iconOnly />"
52
+ }
53
+ ]
54
+ },
55
+ "attachment": {
56
+ "import": "orbital-ds/ui/attachment",
57
+ "group": "chat",
58
+ "summary": "Fichero adjunto en un mensaje o en el compositor, con su estado (vacío, subiendo, procesando, error o listo); se monta con piezas (medio, contenido y acciones).",
59
+ "see": [
60
+ {
61
+ "component": "file-upload",
62
+ "when": "el campo para elegir o arrastrar ficheros, no el chip del adjunto"
63
+ },
64
+ {
65
+ "component": "dropzone",
66
+ "when": "zona amplia donde soltar ficheros"
67
+ },
68
+ {
69
+ "component": "chat-composer",
70
+ "when": "el campo del chat ya pinta sus adjuntos con `attachments`"
71
+ }
72
+ ],
73
+ "exports": [
74
+ "Attachment",
75
+ "AttachmentAction",
76
+ "AttachmentActions",
77
+ "AttachmentContent",
78
+ "AttachmentDescription",
79
+ "AttachmentGroup",
80
+ "AttachmentMedia",
81
+ "AttachmentTitle",
82
+ "AttachmentTrigger"
83
+ ],
84
+ "slots": [
85
+ "attachment",
86
+ "attachment-action",
87
+ "attachment-actions",
88
+ "attachment-content",
89
+ "attachment-description",
90
+ "attachment-group",
91
+ "attachment-media",
92
+ "attachment-title",
93
+ "attachment-trigger"
94
+ ],
95
+ "optionalPeers": [],
96
+ "props": {
97
+ "Attachment": {
98
+ "size": {
99
+ "type": "\"default\" | \"xs\" | \"sm\"",
100
+ "values": [
101
+ "default",
102
+ "xs",
103
+ "sm"
104
+ ]
105
+ },
106
+ "orientation": {
107
+ "type": "\"horizontal\" | \"vertical\"",
108
+ "values": [
109
+ "horizontal",
110
+ "vertical"
111
+ ]
112
+ },
113
+ "state": {
114
+ "type": "\"done\" | \"idle\" | \"uploading\" | \"processing\" | \"error\"",
115
+ "values": [
116
+ "done",
117
+ "idle",
118
+ "uploading",
119
+ "processing",
120
+ "error"
121
+ ]
122
+ }
123
+ },
124
+ "AttachmentMedia": {
125
+ "variant": {
126
+ "type": "\"image\" | \"icon\"",
127
+ "values": [
128
+ "image",
129
+ "icon"
130
+ ]
131
+ }
132
+ },
133
+ "AttachmentAction": {
134
+ "variant": {
135
+ "type": "\"link\" | \"default\" | \"outline\" | \"secondary\" | \"ghost\" | \"destructive\" | \"cta\"",
136
+ "values": [
137
+ "link",
138
+ "default",
139
+ "outline",
140
+ "secondary",
141
+ "ghost",
142
+ "destructive",
143
+ "cta"
144
+ ]
145
+ },
146
+ "size": {
147
+ "type": "\"default\" | \"xs\" | \"sm\" | \"lg\" | \"icon\" | \"icon-xs\" | \"icon-sm\" | \"icon-lg\"",
148
+ "values": [
149
+ "default",
150
+ "xs",
151
+ "sm",
152
+ "lg",
153
+ "icon",
154
+ "icon-xs",
155
+ "icon-sm",
156
+ "icon-lg"
157
+ ]
158
+ },
159
+ "nativeButton": {
160
+ "type": "boolean"
161
+ }
162
+ }
163
+ },
164
+ "notes": [
165
+ "`state` lo calcula la app: uploading y processing dan brillo al título y error, el tono de peligro; el progreso va en AttachmentDescription.",
166
+ "Varios adjuntos en fila van en AttachmentGroup (desplazamiento horizontal); cada AttachmentAction de solo icono lleva aria-label."
167
+ ],
168
+ "examples": [
169
+ {
170
+ "title": "Adjunto listo con descarga",
171
+ "code": "<Attachment state=\"done\">\n <AttachmentMedia>\n <FileTextIcon />\n </AttachmentMedia>\n <AttachmentContent>\n <AttachmentTitle>factura-2026-09.pdf</AttachmentTitle>\n <AttachmentDescription>184 KB</AttachmentDescription>\n </AttachmentContent>\n <AttachmentActions>\n <AttachmentAction aria-label=\"Descargar\">\n <DownloadIcon />\n </AttachmentAction>\n </AttachmentActions>\n</Attachment>"
172
+ },
173
+ {
174
+ "title": "Subiendo, dentro de un grupo",
175
+ "code": "<AttachmentGroup>\n <Attachment state=\"uploading\" size=\"sm\">\n <AttachmentMedia>\n <Spinner />\n </AttachmentMedia>\n <AttachmentContent>\n <AttachmentTitle>contrato-marco.pdf</AttachmentTitle>\n <AttachmentDescription>Subiendo… 64 %</AttachmentDescription>\n </AttachmentContent>\n </Attachment>\n</AttachmentGroup>"
176
+ }
177
+ ]
178
+ },
179
+ "chat-composer": {
180
+ "import": "orbital-ds/ui/chat-composer",
181
+ "group": "chat",
182
+ "summary": "Campo de mensaje de un chat: Enter envía, adjuntos, voz y «Detener» mientras responde el asistente; no sube ni graba, eso lo hace la app.",
183
+ "see": [
184
+ {
185
+ "component": "textarea",
186
+ "when": "texto multilínea en un formulario normal"
187
+ },
188
+ {
189
+ "component": "suggestions",
190
+ "when": "preguntas sugeridas para empezar la conversación"
191
+ },
192
+ {
193
+ "component": "attachment",
194
+ "when": "chip de un adjunto suelto dentro de un mensaje"
195
+ }
196
+ ],
197
+ "exports": [
198
+ "ChatComposer"
199
+ ],
200
+ "slots": [
201
+ "chat-composer",
202
+ "chat-composer-attachment",
203
+ "chat-composer-voice"
204
+ ],
205
+ "optionalPeers": [],
206
+ "props": {
207
+ "ChatComposer": {
208
+ "value": {
209
+ "type": "string"
210
+ },
211
+ "defaultValue": {
212
+ "type": "string"
213
+ },
214
+ "onValueChange": {
215
+ "type": "(value: string) => void"
216
+ },
217
+ "onSend": {
218
+ "type": "(value: string) => void"
219
+ },
220
+ "onStop": {
221
+ "type": "() => void"
222
+ },
223
+ "onAttach": {
224
+ "type": "() => void"
225
+ },
226
+ "onFilesDrop": {
227
+ "type": "(files: File[]) => void"
228
+ },
229
+ "attachments": {
230
+ "type": "ChatAttachment[]"
231
+ },
232
+ "onRemoveAttachment": {
233
+ "type": "(id: string) => void"
234
+ },
235
+ "voice": {
236
+ "type": "ChatVoice"
237
+ },
238
+ "maxLength": {
239
+ "type": "number"
240
+ },
241
+ "streaming": {
242
+ "type": "boolean"
243
+ },
244
+ "disabled": {
245
+ "type": "boolean"
246
+ },
247
+ "placeholder": {
248
+ "type": "string"
249
+ }
250
+ }
251
+ },
252
+ "notes": [
253
+ "Al pie de la conversación; combínalo con `Suggestions` en el estado vacío. No sube ni graba: eso lo hace la app."
254
+ ],
255
+ "examples": [
256
+ {
257
+ "title": "Enviar y detener",
258
+ "code": "<ChatComposer onSend={send} onStop={abort} streaming={isStreaming} placeholder=\"Pregunta lo que quieras…\" />"
259
+ },
260
+ {
261
+ "title": "Con adjuntos y límite",
262
+ "code": "<ChatComposer\n onSend={send}\n onAttach={pickFiles}\n onFilesDrop={addFiles}\n attachments={[{ id: \"1\", name: \"informe.pdf\", type: \"application/pdf\", status: \"uploading\" }]}\n onRemoveAttachment={removeFile}\n maxLength={4000}\n/>"
263
+ }
264
+ ]
265
+ },
266
+ "conversation-list": {
267
+ "import": "orbital-ds/ui/conversation-list",
268
+ "group": "chat",
269
+ "summary": "Historial de conversaciones de un asistente: buscar, agrupar por fecha, fijar, renombrar y borrar; va en el lateral del chat.",
270
+ "see": [
271
+ {
272
+ "component": "sidebar",
273
+ "when": "navegación general de la app"
274
+ },
275
+ {
276
+ "component": "entity-list",
277
+ "when": "lista de otras entidades (no conversaciones)"
278
+ }
279
+ ],
280
+ "exports": [
281
+ "ConversationList"
282
+ ],
283
+ "slots": [
284
+ "conversation-item",
285
+ "conversation-list"
286
+ ],
287
+ "optionalPeers": [],
288
+ "props": {
289
+ "ConversationList": {
290
+ "items": {
291
+ "type": "Conversation[]",
292
+ "required": true
293
+ },
294
+ "activeId": {
295
+ "type": "string"
296
+ },
297
+ "onSelect": {
298
+ "type": "(id: string) => void"
299
+ },
300
+ "onNew": {
301
+ "type": "() => void"
302
+ },
303
+ "onRename": {
304
+ "type": "(id: string) => void"
305
+ },
306
+ "onDelete": {
307
+ "type": "(id: string) => void"
308
+ },
309
+ "onPin": {
310
+ "type": "(id: string, pinned: boolean) => void"
311
+ },
312
+ "now": {
313
+ "type": "Date"
314
+ },
315
+ "searchable": {
316
+ "type": "boolean"
317
+ }
318
+ }
319
+ },
320
+ "notes": [
321
+ "Dentro del `Sidebar` o de un panel lateral del chat; el hilo y el campo son `Message` y `ChatComposer`."
322
+ ],
323
+ "examples": [
324
+ {
325
+ "title": "En el lateral del chat",
326
+ "code": "<ConversationList\n items={[\n { id: \"1\", title: \"Tarifas 2026\", updatedAt: \"2026-11-20\", pinned: true },\n { id: \"2\", title: \"Resumen de incidencias\", updatedAt: \"2026-11-21\", busy: true },\n ]}\n activeId={chatId}\n onSelect={openChat}\n onNew={newChat}\n onPin={pin}\n onRename={rename}\n onDelete={removeChat}\n/>"
327
+ }
328
+ ]
329
+ },
330
+ "markdown": {
331
+ "import": "orbital-ds/ui/markdown",
332
+ "group": "chat",
333
+ "summary": "Pinta texto Markdown (GFM) con el aspecto del tema: la respuesta del asistente, sin HTML crudo y cerrando lo que quede abierto mientras llega en streaming.",
334
+ "see": [
335
+ {
336
+ "component": "code-block",
337
+ "when": "solo un bloque de código"
338
+ },
339
+ {
340
+ "component": "bubble",
341
+ "when": "burbuja de chat con texto corto sin formato"
342
+ }
343
+ ],
344
+ "exports": [
345
+ "Markdown",
346
+ "closeOpenMarkdown"
347
+ ],
348
+ "slots": [
349
+ "markdown"
350
+ ],
351
+ "optionalPeers": [
352
+ "react-markdown",
353
+ "remark-gfm"
354
+ ],
355
+ "props": {
356
+ "Markdown": {
357
+ "children": {
358
+ "type": "string",
359
+ "required": true
360
+ },
361
+ "streaming": {
362
+ "type": "boolean",
363
+ "doc": "Texto que aún está llegando: cierra lo que haya quedado abierto."
364
+ }
365
+ }
366
+ },
367
+ "notes": [
368
+ "Necesita los peers opcionales `react-markdown` y `remark-gfm`. Para el cuerpo de un `Message` del asistente."
369
+ ],
370
+ "examples": [
371
+ {
372
+ "title": "Respuesta en streaming",
373
+ "code": "<Markdown streaming={isStreaming}>{message.text}</Markdown>"
374
+ },
375
+ {
376
+ "title": "Dentro de un mensaje del asistente",
377
+ "code": "<Message>\n <MessageContent>\n <Markdown>{answer}</Markdown>\n </MessageContent>\n</Message>"
378
+ }
379
+ ]
380
+ },
381
+ "message-actions": {
382
+ "import": "orbital-ds/ui/message-actions",
383
+ "group": "chat",
384
+ "summary": "Acciones bajo una respuesta del asistente: copiar, regenerar y valorar (bien o mal); cada acción aparece solo si pasas su callback.",
385
+ "see": [
386
+ {
387
+ "component": "copy-button",
388
+ "when": "copiar un valor suelto fuera del chat"
389
+ },
390
+ {
391
+ "component": "button-group",
392
+ "when": "otras acciones agrupadas"
393
+ }
394
+ ],
395
+ "exports": [
396
+ "MessageActions"
397
+ ],
398
+ "slots": [
399
+ "message-actions"
400
+ ],
401
+ "optionalPeers": [],
402
+ "props": {
403
+ "MessageActions": {
404
+ "text": {
405
+ "type": "string"
406
+ },
407
+ "onRetry": {
408
+ "type": "() => void"
409
+ },
410
+ "feedback": {
411
+ "type": "\"good\" | \"bad\"",
412
+ "values": [
413
+ "good",
414
+ "bad"
415
+ ]
416
+ },
417
+ "onFeedback": {
418
+ "type": "(value: MessageFeedback) => void"
419
+ }
420
+ }
421
+ },
422
+ "notes": [
423
+ "Bajo el último mensaje del asistente (o de todos, al pasar el cursor); el envío de la valoración lo hace la app."
424
+ ],
425
+ "examples": [
426
+ {
427
+ "title": "Copiar, regenerar y valorar",
428
+ "code": "<MessageActions text={answer} onRetry={regenerate} feedback={feedback} onFeedback={setFeedback} />"
429
+ }
430
+ ]
431
+ },
432
+ "message-scroller": {
433
+ "import": "orbital-ds/ui/message-scroller",
434
+ "group": "chat",
435
+ "summary": "Contenedor desplazable de un chat que arranca al final, se pega abajo al llegar mensajes nuevos y ofrece botones para saltar al inicio o al final.",
436
+ "see": [
437
+ {
438
+ "component": "scroll-area",
439
+ "when": "desplazamiento de cualquier otro contenido"
440
+ },
441
+ {
442
+ "component": "message",
443
+ "when": "cada mensaje que va dentro"
444
+ }
445
+ ],
446
+ "exports": [
447
+ "MessageScroller",
448
+ "MessageScrollerButton",
449
+ "MessageScrollerContent",
450
+ "MessageScrollerItem",
451
+ "MessageScrollerProvider",
452
+ "MessageScrollerViewport",
453
+ "useMessageScroller",
454
+ "useMessageScrollerScrollable",
455
+ "useMessageScrollerVisibility"
456
+ ],
457
+ "slots": [
458
+ "message-scroller",
459
+ "message-scroller-button",
460
+ "message-scroller-content",
461
+ "message-scroller-item",
462
+ "message-scroller-viewport"
463
+ ],
464
+ "optionalPeers": [
465
+ "@shadcn/react"
466
+ ],
467
+ "props": {
468
+ "MessageScrollerButton": {
469
+ "variant": {
470
+ "type": "\"link\" | \"default\" | \"outline\" | \"secondary\" | \"ghost\" | \"destructive\" | \"cta\"",
471
+ "values": [
472
+ "link",
473
+ "default",
474
+ "outline",
475
+ "secondary",
476
+ "ghost",
477
+ "destructive",
478
+ "cta"
479
+ ]
480
+ },
481
+ "size": {
482
+ "type": "\"default\" | \"xs\" | \"sm\" | \"lg\" | \"icon\" | \"icon-xs\" | \"icon-sm\" | \"icon-lg\"",
483
+ "values": [
484
+ "default",
485
+ "xs",
486
+ "sm",
487
+ "lg",
488
+ "icon",
489
+ "icon-xs",
490
+ "icon-sm",
491
+ "icon-lg"
492
+ ]
493
+ }
494
+ }
495
+ },
496
+ "notes": [
497
+ "Envuélvelo en MessageScrollerProvider (autoScroll, defaultScrollPosition=\"end\"), dale una altura y pon un messageId en cada MessageScrollerItem.",
498
+ "El Viewport lleva aria-label con el nombre de la conversación (lo pone la app)."
499
+ ],
500
+ "examples": [
501
+ {
502
+ "title": "Hilo con botón de ir al final",
503
+ "code": "<MessageScrollerProvider autoScroll defaultScrollPosition=\"end\">\n <MessageScroller>\n <MessageScrollerViewport aria-label=\"Conversación con soporte\">\n <MessageScrollerContent>\n {messages.map((m) => (\n <MessageScrollerItem key={m.id} messageId={m.id}>\n <Message align={m.mine ? \"end\" : \"start\"}>\n <MessageContent>\n <Bubble>\n <BubbleContent>{m.text}</BubbleContent>\n </Bubble>\n </MessageContent>\n </Message>\n </MessageScrollerItem>\n ))}\n </MessageScrollerContent>\n </MessageScrollerViewport>\n <MessageScrollerButton direction=\"end\" />\n </MessageScroller>\n</MessageScrollerProvider>"
504
+ }
505
+ ]
506
+ },
507
+ "message": {
508
+ "import": "orbital-ds/ui/message",
509
+ "group": "chat",
510
+ "summary": "Estructura de un mensaje de chat (avatar, cabecera, contenido y pie), alineado al inicio (recibido) o al final (enviado); el texto va en Bubble o en Markdown.",
511
+ "see": [
512
+ {
513
+ "component": "bubble",
514
+ "when": "la burbuja con el texto del mensaje"
515
+ },
516
+ {
517
+ "component": "message-scroller",
518
+ "when": "la lista desplazable que contiene los mensajes"
519
+ },
520
+ {
521
+ "component": "timeline",
522
+ "when": "eventos con fecha, no una conversación"
523
+ }
524
+ ],
525
+ "exports": [
526
+ "Message",
527
+ "MessageAvatar",
528
+ "MessageContent",
529
+ "MessageFooter",
530
+ "MessageGroup",
531
+ "MessageHeader"
532
+ ],
533
+ "slots": [
534
+ "message",
535
+ "message-avatar",
536
+ "message-content",
537
+ "message-footer",
538
+ "message-group",
539
+ "message-header"
540
+ ],
541
+ "optionalPeers": [],
542
+ "props": {
543
+ "Message": {
544
+ "align": {
545
+ "type": "\"start\" | \"end\"",
546
+ "values": [
547
+ "start",
548
+ "end"
549
+ ]
550
+ }
551
+ }
552
+ },
553
+ "notes": [
554
+ "`align=\"end\"` para los mensajes de la persona; varias burbujas seguidas del mismo autor van en MessageGroup.",
555
+ "En una respuesta del asistente, Reasoning y ToolCall van dentro de MessageContent antes del texto (Markdown)."
556
+ ],
557
+ "examples": [
558
+ {
559
+ "title": "Mensaje recibido con avatar",
560
+ "code": "<Message>\n <MessageAvatar>\n <Avatar size=\"sm\">\n <AvatarFallback>MG</AvatarFallback>\n </Avatar>\n </MessageAvatar>\n <MessageContent>\n <MessageHeader>Marta Gómez · Soporte</MessageHeader>\n <Bubble variant=\"muted\">\n <BubbleContent>He revisado la incidencia #4821.</BubbleContent>\n </Bubble>\n <MessageFooter>10:42</MessageFooter>\n </MessageContent>\n</Message>"
561
+ },
562
+ {
563
+ "title": "Mensaje enviado",
564
+ "code": "<Message align=\"end\">\n <MessageContent>\n <Bubble>\n <BubbleContent>Lo pruebo ahora mismo.</BubbleContent>\n </Bubble>\n </MessageContent>\n</Message>"
565
+ }
566
+ ]
567
+ },
568
+ "suggestions": {
569
+ "import": "orbital-ds/ui/suggestions",
570
+ "group": "chat",
571
+ "summary": "Chips con preguntas o acciones sugeridas para empezar o continuar una conversación; al elegir una, la app la envía o la pone en el campo.",
572
+ "see": [
573
+ {
574
+ "component": "toggle-group",
575
+ "when": "elegir una opción que se queda marcada"
576
+ },
577
+ {
578
+ "component": "chat-composer",
579
+ "when": "el campo donde se escribe el mensaje"
580
+ }
581
+ ],
582
+ "exports": [
583
+ "Suggestions"
584
+ ],
585
+ "slots": [
586
+ "suggestions",
587
+ "suggestions-item"
588
+ ],
589
+ "optionalPeers": [],
590
+ "props": {
591
+ "Suggestions": {
592
+ "items": {
593
+ "type": "string[]",
594
+ "required": true
595
+ },
596
+ "onSelect": {
597
+ "type": "(item: string) => void"
598
+ }
599
+ }
600
+ },
601
+ "notes": [
602
+ "Bajo el compositor o en el estado vacío del chat; al elegir una, la app la envía o la pone en el campo."
603
+ ],
604
+ "examples": [
605
+ {
606
+ "title": "En el estado vacío del chat",
607
+ "code": "<Suggestions items={[\"Resume esta incidencia\", \"Tradúcelo al inglés\"]} onSelect={(s) => send(s)} />"
608
+ }
609
+ ]
610
+ }
611
+ }
612
+ }