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,2793 @@
1
+ {
2
+ "package": "orbital-ds",
3
+ "version": "0.48.0",
4
+ "group": "content",
5
+ "about": "Tarjetas, texto, media y piezas de maquetación.",
6
+ "components": {
7
+ "accordion": {
8
+ "import": "orbital-ds/ui/accordion",
9
+ "group": "content",
10
+ "summary": "Lista de secciones plegables con título en la que la persona abre una (o varias con `multiple`) para leer el detalle: preguntas frecuentes, ajustes agrupados.",
11
+ "see": [
12
+ {
13
+ "component": "collapsible",
14
+ "when": "un único bloque que se muestra u oculta con su propio disparador"
15
+ },
16
+ {
17
+ "component": "show-more",
18
+ "when": "recortar un texto largo a N líneas y expandirlo en el sitio"
19
+ },
20
+ {
21
+ "component": "tabs",
22
+ "when": "secciones alternativas que se ven de una en una, sin plegar"
23
+ }
24
+ ],
25
+ "exports": [
26
+ "Accordion",
27
+ "AccordionContent",
28
+ "AccordionItem",
29
+ "AccordionTrigger"
30
+ ],
31
+ "slots": [
32
+ "accordion",
33
+ "accordion-content",
34
+ "accordion-header",
35
+ "accordion-item",
36
+ "accordion-trigger",
37
+ "accordion-trigger-icon"
38
+ ],
39
+ "optionalPeers": [],
40
+ "notes": [
41
+ "El título de cada AccordionTrigger dice qué hay dentro; no escondas en un acordeón lo que la persona necesita para decidir (precio, errores, avisos).",
42
+ "Cada AccordionItem lleva un `value` estable y único; `defaultValue` es siempre una lista, también con una sola abierta."
43
+ ],
44
+ "examples": [
45
+ {
46
+ "title": "Preguntas frecuentes (una abierta a la vez)",
47
+ "code": "<Accordion defaultValue={[\"billing\"]}>\n <AccordionItem value=\"billing\">\n <AccordionTrigger>¿Cómo se factura?</AccordionTrigger>\n <AccordionContent>\n <p>Cada mes, por persona activa.</p>\n </AccordionContent>\n </AccordionItem>\n <AccordionItem value=\"cancel\">\n <AccordionTrigger>¿Puedo cancelar?</AccordionTrigger>\n <AccordionContent>\n <p>Sí, en cualquier momento desde Ajustes.</p>\n </AccordionContent>\n </AccordionItem>\n</Accordion>"
48
+ },
49
+ {
50
+ "title": "Varias abiertas y una desactivada",
51
+ "code": "<Accordion multiple defaultValue={[\"security\"]}>\n <AccordionItem value=\"security\">\n <AccordionTrigger>Seguridad</AccordionTrigger>\n <AccordionContent>\n <p>Inicio de sesión único y doble factor.</p>\n </AccordionContent>\n </AccordionItem>\n <AccordionItem value=\"audit\" disabled>\n <AccordionTrigger>Auditoría (plan Empresa)</AccordionTrigger>\n <AccordionContent>\n <p>Disponible en el plan Empresa.</p>\n </AccordionContent>\n </AccordionItem>\n</Accordion>"
52
+ }
53
+ ]
54
+ },
55
+ "aspect-ratio": {
56
+ "import": "orbital-ds/ui/aspect-ratio",
57
+ "group": "content",
58
+ "summary": "Caja que fija la proporción (ancho / alto) de su contenido —imagen, vídeo, mapa— para que el diseño no salte mientras carga.",
59
+ "see": [
60
+ {
61
+ "component": "media-card",
62
+ "when": "tarjeta de rejilla con imagen, título y metadato ya resueltos"
63
+ },
64
+ {
65
+ "component": "content-card",
66
+ "when": "tarjeta con portada (preset media, horizontal o cover)"
67
+ }
68
+ ],
69
+ "exports": [
70
+ "AspectRatio"
71
+ ],
72
+ "slots": [
73
+ "aspect-ratio"
74
+ ],
75
+ "optionalPeers": [],
76
+ "props": {
77
+ "AspectRatio": {
78
+ "ratio": {
79
+ "type": "number",
80
+ "required": true
81
+ }
82
+ }
83
+ },
84
+ "notes": [
85
+ "`ratio` es ancho / alto (16 / 9, 4 / 3, 1); el hijo debe ocupar toda la caja (`size-full`)."
86
+ ],
87
+ "examples": [
88
+ {
89
+ "title": "Imagen 16:9",
90
+ "code": "<AspectRatio ratio={16 / 9}>\n <img src=\"/portada.jpg\" alt=\"\" className=\"size-full object-cover\" />\n</AspectRatio>"
91
+ }
92
+ ]
93
+ },
94
+ "avatar": {
95
+ "import": "orbital-ds/ui/avatar",
96
+ "group": "content",
97
+ "summary": "Foto o iniciales que identifican a una persona (o cuenta), con insignia de estado opcional y grupos solapados con contador.",
98
+ "see": [
99
+ {
100
+ "component": "icon-tile",
101
+ "when": "icono en baldosa tintada para objetos que no son personas"
102
+ },
103
+ {
104
+ "component": "badge",
105
+ "when": "etiqueta de texto o de estado, no una identidad"
106
+ }
107
+ ],
108
+ "exports": [
109
+ "Avatar",
110
+ "AvatarBadge",
111
+ "AvatarFallback",
112
+ "AvatarGroup",
113
+ "AvatarGroupCount",
114
+ "AvatarImage"
115
+ ],
116
+ "slots": [
117
+ "avatar",
118
+ "avatar-badge",
119
+ "avatar-fallback",
120
+ "avatar-group",
121
+ "avatar-group-count",
122
+ "avatar-image"
123
+ ],
124
+ "optionalPeers": [],
125
+ "props": {
126
+ "Avatar": {
127
+ "size": {
128
+ "type": "\"default\" | \"sm\" | \"lg\"",
129
+ "values": [
130
+ "default",
131
+ "sm",
132
+ "lg"
133
+ ]
134
+ }
135
+ },
136
+ "AvatarFallback": {
137
+ "tone": {
138
+ "type": "DsDataTone",
139
+ "values": [
140
+ "info",
141
+ "success",
142
+ "warning",
143
+ "danger",
144
+ "primary",
145
+ "neutral",
146
+ "chart-1",
147
+ "chart-2",
148
+ "chart-3",
149
+ "chart-4",
150
+ "chart-5"
151
+ ]
152
+ }
153
+ }
154
+ },
155
+ "notes": [
156
+ "Pon siempre AvatarFallback (iniciales) aunque haya foto: se ve mientras carga o si falla. Si el nombre ya está escrito al lado, la imagen lleva `alt=\"\"`."
157
+ ],
158
+ "examples": [
159
+ {
160
+ "title": "Foto con iniciales de respaldo",
161
+ "code": "<Avatar>\n <AvatarImage src={user.avatarUrl} alt=\"\" />\n <AvatarFallback>LM</AvatarFallback>\n</Avatar>"
162
+ },
163
+ {
164
+ "title": "Iniciales con tono y tamaño",
165
+ "code": "<Avatar size=\"lg\">\n <AvatarFallback tone=\"info\">AR</AvatarFallback>\n</Avatar>"
166
+ },
167
+ {
168
+ "title": "Grupo con contador",
169
+ "code": "<AvatarGroup>\n <Avatar size=\"sm\">\n <AvatarFallback>AR</AvatarFallback>\n </Avatar>\n <Avatar size=\"sm\">\n <AvatarFallback>JO</AvatarFallback>\n </Avatar>\n <AvatarGroupCount>+5</AvatarGroupCount>\n</AvatarGroup>"
170
+ }
171
+ ]
172
+ },
173
+ "ayuda": {
174
+ "import": "orbital-ds/ui/ayuda",
175
+ "group": "content",
176
+ "summary": "Icono «?» junto a un término de dominio poco obvio que abre, al pulsar, una explicación de una o dos frases (va igual con ratón, tacto y teclado).",
177
+ "see": [
178
+ {
179
+ "component": "tooltip",
180
+ "when": "nombre corto de un control de solo icono al señalarlo"
181
+ },
182
+ {
183
+ "component": "popover",
184
+ "when": "contenido flotante propio (opciones, un formulario corto), no solo una explicación"
185
+ },
186
+ {
187
+ "component": "hover-card",
188
+ "when": "vista previa rica al señalar un enlace"
189
+ }
190
+ ],
191
+ "exports": [
192
+ "Ayuda"
193
+ ],
194
+ "slots": [
195
+ "help-content",
196
+ "help-trigger"
197
+ ],
198
+ "optionalPeers": [],
199
+ "props": {
200
+ "Ayuda": {
201
+ "children": {
202
+ "type": "string | number | bigint | boolean | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | Promise<AwaitedReactNode>",
203
+ "required": true,
204
+ "doc": "Texto de ayuda. Una o dos frases: si necesita más, el sitio es la propia pantalla, no esto."
205
+ },
206
+ "etiqueta": {
207
+ "type": "string",
208
+ "required": true,
209
+ "doc": "Para lectores de pantalla: qué término se está explicando (p. ej. «banda»; se anuncia como «Qué es: banda»)."
210
+ }
211
+ }
212
+ },
213
+ "notes": [
214
+ "Solo para el término suelto que no se explica en la propia pantalla; lo que la persona necesita para completar una tarea va escrito en la pantalla (descripción del campo), no aquí.",
215
+ "`etiqueta` es el término explicado (lo anuncia el lector de pantalla); el texto de ayuda, una o dos frases."
216
+ ],
217
+ "examples": [
218
+ {
219
+ "title": "Junto a una etiqueta",
220
+ "code": "<span className=\"inline-flex items-center gap-1\">\n Banda\n <Ayuda etiqueta=\"banda\">Rango de severidad en el que cae una alerta.</Ayuda>\n</span>"
221
+ }
222
+ ]
223
+ },
224
+ "badge": {
225
+ "import": "orbital-ds/ui/badge",
226
+ "group": "content",
227
+ "summary": "Etiqueta corta, no interactiva, para clasificar o marcar un estado (categoría, «Nuevo», «Activo»); con `render` puede ser un enlace.",
228
+ "see": [
229
+ {
230
+ "component": "status-badge",
231
+ "when": "estado de un proceso o sistema con punto que late y nivel semántico"
232
+ },
233
+ {
234
+ "component": "ai-tag",
235
+ "when": "marcar contenido generado o asistido por IA"
236
+ },
237
+ {
238
+ "component": "toggle-group",
239
+ "when": "etiquetas o filtros que la persona activa y desactiva"
240
+ }
241
+ ],
242
+ "exports": [
243
+ "Badge",
244
+ "badgeVariants"
245
+ ],
246
+ "slots": [
247
+ "badge",
248
+ "badge-dot"
249
+ ],
250
+ "optionalPeers": [],
251
+ "props": {
252
+ "Badge": {
253
+ "variant": {
254
+ "type": "\"link\" | \"default\" | \"outline\" | \"secondary\" | \"ghost\" | \"destructive\" | \"info\" | \"success\" | \"warning\" | \"danger\" | \"neutral\"",
255
+ "values": [
256
+ "link",
257
+ "default",
258
+ "outline",
259
+ "secondary",
260
+ "ghost",
261
+ "destructive",
262
+ "info",
263
+ "success",
264
+ "warning",
265
+ "danger",
266
+ "neutral"
267
+ ]
268
+ },
269
+ "size": {
270
+ "type": "\"default\" | \"sm\"",
271
+ "values": [
272
+ "default",
273
+ "sm"
274
+ ]
275
+ },
276
+ "dot": {
277
+ "type": "boolean",
278
+ "doc": "Punto de estado a la izquierda, con el color del texto de la variante."
279
+ }
280
+ }
281
+ },
282
+ "notes": [
283
+ "`dot` pone el punto de estado delante de la etiqueta y `size=\"sm\"` la compacta (listas densas, celdas de tabla). Para un estado con pulso o nivel semántico, mejor StatusBadge."
284
+ ],
285
+ "examples": [
286
+ {
287
+ "title": "Estado con punto",
288
+ "code": "<Badge variant=\"success\" dot>Activo</Badge>"
289
+ },
290
+ {
291
+ "title": "Categoría compacta en una tabla",
292
+ "code": "<Badge variant=\"outline\" size=\"sm\">Facturación</Badge>"
293
+ },
294
+ {
295
+ "title": "Como enlace (render, nunca asChild)",
296
+ "code": "<Badge variant=\"secondary\" render={<a href=\"/tags/beta\" />}>Beta</Badge>"
297
+ }
298
+ ]
299
+ },
300
+ "bubble": {
301
+ "import": "orbital-ds/ui/bubble",
302
+ "group": "content",
303
+ "summary": "Burbuja de un mensaje de conversación (texto, enlace o botón) alineada al inicio (los demás) o al final (la propia persona), con reacciones opcionales.",
304
+ "see": [
305
+ {
306
+ "component": "message",
307
+ "when": "la fila del mensaje de chat con avatar, autor y acciones; la burbuja va dentro"
308
+ },
309
+ {
310
+ "component": "alert",
311
+ "when": "aviso de la app, no un mensaje de conversación"
312
+ }
313
+ ],
314
+ "exports": [
315
+ "Bubble",
316
+ "BubbleContent",
317
+ "BubbleGroup",
318
+ "BubbleReactions"
319
+ ],
320
+ "slots": [
321
+ "bubble",
322
+ "bubble-content",
323
+ "bubble-group",
324
+ "bubble-reactions"
325
+ ],
326
+ "optionalPeers": [],
327
+ "props": {
328
+ "Bubble": {
329
+ "variant": {
330
+ "type": "\"default\" | \"outline\" | \"secondary\" | \"ghost\" | \"destructive\" | \"muted\" | \"tinted\"",
331
+ "values": [
332
+ "default",
333
+ "outline",
334
+ "secondary",
335
+ "ghost",
336
+ "destructive",
337
+ "muted",
338
+ "tinted"
339
+ ]
340
+ },
341
+ "align": {
342
+ "type": "\"start\" | \"end\"",
343
+ "values": [
344
+ "start",
345
+ "end"
346
+ ]
347
+ }
348
+ },
349
+ "BubbleReactions": {
350
+ "align": {
351
+ "type": "\"start\" | \"end\"",
352
+ "values": [
353
+ "start",
354
+ "end"
355
+ ]
356
+ },
357
+ "side": {
358
+ "type": "\"top\" | \"bottom\"",
359
+ "values": [
360
+ "top",
361
+ "bottom"
362
+ ]
363
+ }
364
+ }
365
+ },
366
+ "notes": [
367
+ "`align=\"end\"` para los mensajes de la propia persona y `start` (por defecto) para los demás; dentro de Message hereda su alineación.",
368
+ "Si la burbuja es pulsable, BubbleContent con `render` (`<button type=\"button\" />` o `<a href=… />`), nunca un onClick sobre un div."
369
+ ],
370
+ "examples": [
371
+ {
372
+ "title": "Conversación",
373
+ "code": "<BubbleGroup>\n <Bubble variant=\"muted\">\n <BubbleContent>¿Movemos la demo al jueves?</BubbleContent>\n </Bubble>\n <Bubble align=\"end\">\n <BubbleContent>Claro, a las 10:00.</BubbleContent>\n </Bubble>\n</BubbleGroup>"
374
+ },
375
+ {
376
+ "title": "Con reacciones",
377
+ "code": "<Bubble variant=\"muted\">\n <BubbleContent>Os envío la invitación.</BubbleContent>\n <BubbleReactions>👍 2</BubbleReactions>\n</Bubble>"
378
+ },
379
+ {
380
+ "title": "Burbuja pulsable",
381
+ "code": "<Bubble align=\"end\" variant=\"outline\">\n <BubbleContent render={<a href=\"/meetings/42\" />}>Abrir el acta</BubbleContent>\n</Bubble>"
382
+ }
383
+ ]
384
+ },
385
+ "card-stack": {
386
+ "import": "orbital-ds/ui/card-stack",
387
+ "group": "content",
388
+ "summary": "Baraja controlada de pocas tarjetas que se atienden de una en una: la de delante es la activa y las siguientes asoman detrás; la app avanza `index`.",
389
+ "see": [
390
+ {
391
+ "component": "carousel",
392
+ "when": "recorrer varias piezas del mismo nivel con flechas o deslizando"
393
+ },
394
+ {
395
+ "component": "item",
396
+ "when": "lista normal de entidades, todas visibles a la vez"
397
+ }
398
+ ],
399
+ "exports": [
400
+ "CardStack"
401
+ ],
402
+ "slots": [
403
+ "card-stack",
404
+ "card-stack-item"
405
+ ],
406
+ "optionalPeers": [],
407
+ "props": {
408
+ "CardStack": {
409
+ "index": {
410
+ "type": "number",
411
+ "required": true,
412
+ "doc": "Posición de la tarjeta de delante (se envuelve: pasado el final vuelve a la primera)."
413
+ },
414
+ "children": {
415
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
416
+ "required": true
417
+ }
418
+ }
419
+ },
420
+ "notes": [
421
+ "Pocas piezas que se atienden una a una (recordatorios, avisos, tareas); no para listas largas.",
422
+ "Dale a cada tarjeta su botón de descartar/siguiente: la baraja no pone controles propios."
423
+ ],
424
+ "examples": [
425
+ {
426
+ "title": "Recordatorios que se descartan",
427
+ "code": "const [i, setI] = React.useState(0)\n<CardStack index={i}>\n <Item variant=\"card\">\n <ItemContent>\n <ItemTitle>Revisa la factura de mayo</ItemTitle>\n </ItemContent>\n <ItemActions>\n <Button size=\"sm\" onClick={() => setI(i + 1)}>Hecho</Button>\n </ItemActions>\n </Item>\n <Item variant=\"card\">\n <ItemContent>\n <ItemTitle>Confirma tu correo</ItemTitle>\n </ItemContent>\n <ItemActions>\n <Button size=\"sm\" onClick={() => setI(i + 1)}>Hecho</Button>\n </ItemActions>\n </Item>\n</CardStack>"
428
+ }
429
+ ]
430
+ },
431
+ "card": {
432
+ "import": "orbital-ds/ui/card",
433
+ "group": "content",
434
+ "summary": "Superficie de tarjeta con anatomía libre (cabecera, título, descripción, acción, contenido y pie) para componer un bloque propio de una vista.",
435
+ "see": [
436
+ {
437
+ "component": "content-card",
438
+ "when": "tarjeta lista por intención (feature, media, metric, status, cover) sin montar piezas"
439
+ },
440
+ {
441
+ "component": "item",
442
+ "when": "fila de una lista de entidades (variant=\"card\"), no una tarjeta de bloque"
443
+ },
444
+ {
445
+ "component": "panel",
446
+ "when": "superficie simple con relleno, sin cabecera ni pie"
447
+ }
448
+ ],
449
+ "exports": [
450
+ "Card",
451
+ "CardAction",
452
+ "CardContent",
453
+ "CardDescription",
454
+ "CardFooter",
455
+ "CardHeader",
456
+ "CardTitle"
457
+ ],
458
+ "slots": [
459
+ "card",
460
+ "card-action",
461
+ "card-content",
462
+ "card-description",
463
+ "card-footer",
464
+ "card-header",
465
+ "card-title"
466
+ ],
467
+ "optionalPeers": [],
468
+ "props": {
469
+ "Card": {
470
+ "size": {
471
+ "type": "\"default\" | \"sm\"",
472
+ "values": [
473
+ "default",
474
+ "sm"
475
+ ]
476
+ },
477
+ "hoverable": {
478
+ "type": "boolean",
479
+ "doc": "Al pasar el ratón la tarjeta se eleva y marca el borde (--ds-card-hover-lift / -border)."
480
+ },
481
+ "spotlight": {
482
+ "type": "boolean",
483
+ "doc": "Un foco de luz sigue al puntero por dentro de la tarjeta (solo con ratón; quieto con movimiento reducido)."
484
+ },
485
+ "glow": {
486
+ "type": "boolean",
487
+ "doc": "Resplandor de marca alrededor de la tarjeta al señalarla (--ds-card-glow)."
488
+ },
489
+ "backdrop": {
490
+ "type": "AuthBackdropVariant",
491
+ "values": [
492
+ "image",
493
+ "none",
494
+ "grid",
495
+ "dots",
496
+ "aurora",
497
+ "mesh",
498
+ "glow",
499
+ "rings",
500
+ "beams"
501
+ ],
502
+ "doc": "Fondo de AuthBackdrop detrás del contenido (mesh, aurora, image, dots…). Con texto largo, prefiere `dots` o `grid`."
503
+ },
504
+ "backdropMedia": {
505
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
506
+ "doc": "backdrop=\"image\": la foto o el vídeo (un <img>/<video> con alt=\"\")."
507
+ },
508
+ "backdropGlass": {
509
+ "type": "boolean",
510
+ "doc": "Cristal esmerilado encima del fondo."
511
+ },
512
+ "animated": {
513
+ "type": "boolean",
514
+ "doc": "false = fondo quieto."
515
+ }
516
+ }
517
+ },
518
+ "notes": [
519
+ "`hoverable` eleva la tarjeta al señalarla; `spotlight` añade un foco de luz que sigue al ratón (solo puntero fino, quieto con movimiento reducido); `glow` un resplandor de marca. Valores en `--ds-card-hover-*`, `--ds-card-spotlight*` y `--ds-card-glow`.",
520
+ "`backdrop` (mesh · aurora · image · dots · grid…) pone un fondo de AuthBackdrop detrás del contenido; con `backdropGlass` suma cristal. Con texto sobre imagen o mesh, usa ContentCard preset=\"cover\" (lleva velo para el contraste) o pon el texto sobre una placa; no confíes en el color del fondo."
521
+ ],
522
+ "examples": [
523
+ {
524
+ "title": "Montaje mínimo",
525
+ "code": "<Card>\n <CardHeader>\n <CardTitle>Plan actual</CardTitle>\n <CardDescription>Se renueva el 1 de junio</CardDescription>\n <CardAction>\n <Button variant=\"outline\" size=\"sm\">Cambiar</Button>\n </CardAction>\n </CardHeader>\n <CardContent>\n <p>5 de 10 licencias en uso.</p>\n </CardContent>\n <CardFooter>\n <Button>Gestionar plan</Button>\n </CardFooter>\n</Card>"
526
+ },
527
+ {
528
+ "title": "Compacta y que se eleva al señalar",
529
+ "code": "<Card size=\"sm\" hoverable>\n <CardHeader>\n <CardTitle>Integraciones</CardTitle>\n </CardHeader>\n <CardContent>\n <p>3 conectadas</p>\n </CardContent>\n</Card>"
530
+ }
531
+ ]
532
+ },
533
+ "carousel": {
534
+ "import": "orbital-ds/ui/carousel",
535
+ "group": "content",
536
+ "summary": "Carrusel deslizable (Embla) para recorrer piezas del mismo nivel de una en una o varias por vista, con flechas, teclado y gesto.",
537
+ "see": [
538
+ {
539
+ "component": "card-stack",
540
+ "when": "baraja de pocas tarjetas que se atienden una a una"
541
+ },
542
+ {
543
+ "component": "scroll-area",
544
+ "when": "fila con scroll horizontal libre, sin paginar"
545
+ },
546
+ {
547
+ "component": "mosaic",
548
+ "when": "mostrar todas las tarjetas a la vez en una rejilla"
549
+ }
550
+ ],
551
+ "exports": [
552
+ "Carousel",
553
+ "CarouselContent",
554
+ "CarouselItem",
555
+ "CarouselNext",
556
+ "CarouselPrevious",
557
+ "type CarouselApi",
558
+ "useCarousel"
559
+ ],
560
+ "slots": [
561
+ "carousel",
562
+ "carousel-content",
563
+ "carousel-item",
564
+ "carousel-next",
565
+ "carousel-previous"
566
+ ],
567
+ "optionalPeers": [
568
+ "embla-carousel-react"
569
+ ],
570
+ "props": {
571
+ "Carousel": {
572
+ "opts": {
573
+ "type": "Partial<OptionsType>"
574
+ },
575
+ "plugins": {
576
+ "type": "CreatePluginType<LoosePluginType, {}>[]"
577
+ },
578
+ "orientation": {
579
+ "type": "\"horizontal\" | \"vertical\"",
580
+ "values": [
581
+ "horizontal",
582
+ "vertical"
583
+ ]
584
+ },
585
+ "setApi": {
586
+ "type": "(api: CarouselApi) => void"
587
+ }
588
+ },
589
+ "CarouselPrevious": {
590
+ "variant": {
591
+ "type": "\"link\" | \"default\" | \"outline\" | \"secondary\" | \"ghost\" | \"destructive\" | \"cta\"",
592
+ "values": [
593
+ "link",
594
+ "default",
595
+ "outline",
596
+ "secondary",
597
+ "ghost",
598
+ "destructive",
599
+ "cta"
600
+ ]
601
+ },
602
+ "size": {
603
+ "type": "\"default\" | \"xs\" | \"sm\" | \"lg\" | \"icon\" | \"icon-xs\" | \"icon-sm\" | \"icon-lg\"",
604
+ "values": [
605
+ "default",
606
+ "xs",
607
+ "sm",
608
+ "lg",
609
+ "icon",
610
+ "icon-xs",
611
+ "icon-sm",
612
+ "icon-lg"
613
+ ]
614
+ },
615
+ "nativeButton": {
616
+ "type": "boolean"
617
+ }
618
+ },
619
+ "CarouselNext": {
620
+ "variant": {
621
+ "type": "\"link\" | \"default\" | \"outline\" | \"secondary\" | \"ghost\" | \"destructive\" | \"cta\"",
622
+ "values": [
623
+ "link",
624
+ "default",
625
+ "outline",
626
+ "secondary",
627
+ "ghost",
628
+ "destructive",
629
+ "cta"
630
+ ]
631
+ },
632
+ "size": {
633
+ "type": "\"default\" | \"xs\" | \"sm\" | \"lg\" | \"icon\" | \"icon-xs\" | \"icon-sm\" | \"icon-lg\"",
634
+ "values": [
635
+ "default",
636
+ "xs",
637
+ "sm",
638
+ "lg",
639
+ "icon",
640
+ "icon-xs",
641
+ "icon-sm",
642
+ "icon-lg"
643
+ ]
644
+ },
645
+ "nativeButton": {
646
+ "type": "boolean"
647
+ }
648
+ }
649
+ },
650
+ "notes": [
651
+ "CarouselPrevious y CarouselNext se colocan fuera de los bordes: deja margen lateral al contenedor. Lo imprescindible no va en un carrusel: muchas personas solo ven la primera pieza.",
652
+ "Para saber la pieza activa, `setApi` y escucha `select` en el api de Embla."
653
+ ],
654
+ "examples": [
655
+ {
656
+ "title": "Una por vista con flechas",
657
+ "code": "<Carousel>\n <CarouselContent>\n <CarouselItem>\n <ContentCard title=\"Novedad 1\" />\n </CarouselItem>\n <CarouselItem>\n <ContentCard title=\"Novedad 2\" />\n </CarouselItem>\n </CarouselContent>\n <CarouselPrevious />\n <CarouselNext />\n</Carousel>"
658
+ },
659
+ {
660
+ "title": "Varias por vista y en bucle",
661
+ "code": "<Carousel opts={{ align: \"start\", loop: true }}>\n <CarouselContent>\n {courses.map((c) => (\n <CarouselItem key={c.id} className=\"basis-1/2 lg:basis-1/3\">\n <MediaCard src={c.image} title={c.title} />\n </CarouselItem>\n ))}\n </CarouselContent>\n <CarouselPrevious />\n <CarouselNext />\n</Carousel>"
662
+ }
663
+ ]
664
+ },
665
+ "code-block": {
666
+ "import": "orbital-ds/ui/code-block",
667
+ "group": "content",
668
+ "summary": "Bloque de código de varias líneas con cabecera (fichero o lenguaje), botón de copiar y números de línea opcionales; Code para código dentro de una frase.",
669
+ "see": [
670
+ {
671
+ "component": "copy-button",
672
+ "when": "copiar un valor corto (clave, enlace) sin mostrar un bloque"
673
+ },
674
+ {
675
+ "component": "markdown",
676
+ "when": "pintar texto Markdown que ya trae sus bloques de código"
677
+ },
678
+ {
679
+ "component": "kbd",
680
+ "when": "teclas o atajos de teclado, no código"
681
+ }
682
+ ],
683
+ "exports": [
684
+ "Code",
685
+ "CodeBlock"
686
+ ],
687
+ "slots": [
688
+ "code",
689
+ "code-block",
690
+ "code-block-code",
691
+ "code-block-copy",
692
+ "code-block-header",
693
+ "code-block-line",
694
+ "code-block-pre"
695
+ ],
696
+ "optionalPeers": [],
697
+ "props": {
698
+ "CodeBlock": {
699
+ "code": {
700
+ "type": "string",
701
+ "required": true
702
+ },
703
+ "html": {
704
+ "type": "string"
705
+ },
706
+ "language": {
707
+ "type": "string"
708
+ },
709
+ "title": {
710
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
711
+ },
712
+ "showLineNumbers": {
713
+ "type": "boolean"
714
+ },
715
+ "copyable": {
716
+ "type": "boolean"
717
+ }
718
+ }
719
+ },
720
+ "notes": [
721
+ "`html` se inserta tal cual: solo HTML de tu propio resaltador (Shiki en el build o en el servidor), nunca texto del usuario o de una API sin sanear. `code` lleva siempre el texto plano: es lo que se copia."
722
+ ],
723
+ "examples": [
724
+ {
725
+ "title": "Con fichero y números de línea",
726
+ "code": "<CodeBlock code={source} language=\"tsx\" title=\"button.tsx\" showLineNumbers />"
727
+ },
728
+ {
729
+ "title": "Código en línea",
730
+ "code": "<p>Ejecuta <Code>pnpm install</Code> antes de empezar.</p>"
731
+ },
732
+ {
733
+ "title": "HTML ya resaltado (Shiki, de confianza)",
734
+ "code": "<CodeBlock code={source} html={highlightedHtml} language=\"ts\" />"
735
+ }
736
+ ]
737
+ },
738
+ "collapsible": {
739
+ "import": "orbital-ds/ui/collapsible",
740
+ "group": "content",
741
+ "summary": "Un único bloque que se muestra u oculta con su propio disparador (detalles, opciones avanzadas); sin estilo propio: la app pone disparador y contenido.",
742
+ "see": [
743
+ {
744
+ "component": "accordion",
745
+ "when": "varias secciones plegables con título, en lista"
746
+ },
747
+ {
748
+ "component": "show-more",
749
+ "when": "recortar un texto largo a N líneas con «Ver más»"
750
+ },
751
+ {
752
+ "component": "detail-panel",
753
+ "when": "ver el detalle de un elemento en un panel aparte"
754
+ }
755
+ ],
756
+ "exports": [
757
+ "Collapsible",
758
+ "CollapsibleContent",
759
+ "CollapsibleTrigger"
760
+ ],
761
+ "slots": [
762
+ "collapsible",
763
+ "collapsible-content",
764
+ "collapsible-trigger"
765
+ ],
766
+ "optionalPeers": [],
767
+ "notes": [
768
+ "El disparador se compone con `render` (normalmente un Button); si es de solo icono, lleva `aria-label`. Para un texto largo que se recorta, ShowMore; para varias secciones, Accordion."
769
+ ],
770
+ "examples": [
771
+ {
772
+ "title": "Opciones avanzadas",
773
+ "code": "<Collapsible>\n <CollapsibleTrigger render={<Button variant=\"outline\" size=\"sm\" />}>Opciones avanzadas</CollapsibleTrigger>\n <CollapsibleContent>\n <p>Reintentos y tiempo de espera.</p>\n </CollapsibleContent>\n</Collapsible>"
774
+ },
775
+ {
776
+ "title": "Controlado, con disparador de icono",
777
+ "code": "const [open, setOpen] = React.useState(false)\n<Collapsible open={open} onOpenChange={setOpen}>\n <CollapsibleTrigger render={<Button variant=\"ghost\" size=\"icon-sm\" aria-label=\"Mostrar repositorios\" />}>\n <ChevronsUpDownIcon />\n </CollapsibleTrigger>\n <CollapsibleContent>\n <p>api · web · docs</p>\n </CollapsibleContent>\n</Collapsible>"
778
+ }
779
+ ]
780
+ },
781
+ "content-card": {
782
+ "import": "orbital-ds/ui/content-card",
783
+ "group": "content",
784
+ "summary": "Tarjeta lista por intención para rejillas (basic, feature, media, horizontal, metric, status, cover) sin montar piezas; con `href` u `onSelect` toda ella es pulsable.",
785
+ "see": [
786
+ {
787
+ "component": "card",
788
+ "when": "tarjeta con anatomía libre cuando ningún preset encaja"
789
+ },
790
+ {
791
+ "component": "item",
792
+ "when": "fila de una lista de entidades (variant=\"card\"), no una celda de rejilla"
793
+ },
794
+ {
795
+ "component": "media-card",
796
+ "when": "tarjeta sencilla de vídeo, curso o producto con insignia y reproducir"
797
+ }
798
+ ],
799
+ "exports": [
800
+ "ContentCard",
801
+ "type ContentCardEmphasis",
802
+ "type ContentCardPreset"
803
+ ],
804
+ "slots": [
805
+ "content-card",
806
+ "content-card-body",
807
+ "content-card-cover",
808
+ "content-card-dot",
809
+ "content-card-layout",
810
+ "content-card-media",
811
+ "content-card-scrim",
812
+ "content-card-value"
813
+ ],
814
+ "optionalPeers": [],
815
+ "props": {
816
+ "ContentCard": {
817
+ "preset": {
818
+ "type": "ContentCardPreset",
819
+ "values": [
820
+ "status",
821
+ "horizontal",
822
+ "cover",
823
+ "media",
824
+ "basic",
825
+ "feature",
826
+ "metric"
827
+ ]
828
+ },
829
+ "spotlight": {
830
+ "type": "boolean",
831
+ "doc": "Foco de luz que sigue al ratón (ver Card)."
832
+ },
833
+ "glow": {
834
+ "type": "boolean",
835
+ "doc": "Resplandor de marca al señalar (ver Card)."
836
+ },
837
+ "backdrop": {
838
+ "type": "AuthBackdropVariant",
839
+ "values": [
840
+ "image",
841
+ "none",
842
+ "grid",
843
+ "dots",
844
+ "aurora",
845
+ "mesh",
846
+ "glow",
847
+ "rings",
848
+ "beams"
849
+ ],
850
+ "doc": "Fondo detrás del contenido (ver Card). Con `cover` la portada es `media`."
851
+ },
852
+ "backdropMedia": {
853
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
854
+ },
855
+ "backdropGlass": {
856
+ "type": "boolean"
857
+ },
858
+ "animated": {
859
+ "type": "boolean"
860
+ },
861
+ "titleSize": {
862
+ "type": "\"default\" | \"lg\" | \"xl\"",
863
+ "values": [
864
+ "default",
865
+ "lg",
866
+ "xl"
867
+ ],
868
+ "doc": "Tamaño del título: `lg` y `xl` para portadas y celdas destacadas."
869
+ },
870
+ "plate": {
871
+ "type": "\"none\" | \"blur\"",
872
+ "values": [
873
+ "none",
874
+ "blur"
875
+ ],
876
+ "doc": "Solo `cover`: `blur` pone el texto sobre una placa con la imagen desenfocada (vidrio)."
877
+ },
878
+ "padding": {
879
+ "type": "\"default\" | \"none\"",
880
+ "values": [
881
+ "default",
882
+ "none"
883
+ ],
884
+ "doc": "`none`: contenido a sangre (gráfico, tabla o imagen); cabecera y pie conservan su margen."
885
+ },
886
+ "emphasis": {
887
+ "type": "ContentCardEmphasis",
888
+ "values": [
889
+ "ghost",
890
+ "elevated",
891
+ "outlined",
892
+ "filled"
893
+ ]
894
+ },
895
+ "tone": {
896
+ "type": "\"info\" | \"success\" | \"warning\" | \"danger\" | \"primary\" | \"neutral\" | \"accent\"",
897
+ "values": [
898
+ "info",
899
+ "success",
900
+ "warning",
901
+ "danger",
902
+ "primary",
903
+ "neutral",
904
+ "accent"
905
+ ]
906
+ },
907
+ "density": {
908
+ "type": "DsDensity",
909
+ "values": [
910
+ "default",
911
+ "compact",
912
+ "comfortable"
913
+ ]
914
+ },
915
+ "icon": {
916
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
917
+ "doc": "Icono (preset feature o cualquiera con `icon`)."
918
+ },
919
+ "media": {
920
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
921
+ "doc": "Portada (preset media, horizontal y cover): imagen, vídeo o cualquier nodo."
922
+ },
923
+ "value": {
924
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
925
+ "doc": "Dato grande (preset metric)."
926
+ },
927
+ "delta": {
928
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
929
+ "doc": "Variación junto al dato (preset metric): «+4,2 %»."
930
+ },
931
+ "title": {
932
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
933
+ "required": true
934
+ },
935
+ "description": {
936
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
937
+ },
938
+ "action": {
939
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
940
+ "doc": "Acción de la cabecera (menú, botón de icono); sigue pulsable en una tarjeta interactiva."
941
+ },
942
+ "footer": {
943
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
944
+ },
945
+ "href": {
946
+ "type": "string",
947
+ "doc": "Toda la tarjeta navega a esta ruta."
948
+ },
949
+ "onSelect": {
950
+ "type": "() => void",
951
+ "doc": "Toda la tarjeta es un botón."
952
+ },
953
+ "children": {
954
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
955
+ },
956
+ "className": {
957
+ "type": "string"
958
+ }
959
+ }
960
+ },
961
+ "presets": {
962
+ "values": [
963
+ "basic",
964
+ "feature",
965
+ "media",
966
+ "horizontal",
967
+ "metric",
968
+ "status",
969
+ "cover"
970
+ ],
971
+ "default": "basic",
972
+ "intent": {
973
+ "basic": "título, descripción, contenido y pie",
974
+ "feature": "icono arriba, título y descripción (una capacidad, un atajo, un paso)",
975
+ "media": "portada arriba (imagen o vídeo) y texto debajo",
976
+ "horizontal": "portada a un lado; apila en un contenedor estrecho (container query)",
977
+ "metric": "un dato grande (`value`, con `delta` opcional) bajo el título: un KPI suelto",
978
+ "status": "una línea con punto de estado (`tone`) y texto: el estado de un sistema o un proceso"
979
+ }
980
+ },
981
+ "notes": [
982
+ "Tipografía y relleno: `titleSize` `lg`/`xl` (`--ds-card-title-lg/-xl`, en rem) para titulares que mandan; `plate=\"blur\"` (solo `cover`) pone el texto sobre una placa de imagen desenfocada (`--ds-card-cover-blur`, `--ds-card-cover-plate`) y mantiene el contraste; `padding=\"none\"` deja el contenido (`children`) a sangre, para gráficos o tablas; cabecera y pie conservan su margen. Un titular grande por vista.",
983
+ "Fondos y efectos: `backdrop` (mesh · aurora · image…), `backdropGlass`, `spotlight` y `glow` pasan a Card. `cover` es la forma segura de poner texto sobre una foto: el velo es obligatorio y sale de `--ds-card-scrim` (ajústalo en brand.css, mide su contraste).",
984
+ "Tarjeta de contenido para rejillas: `basic` (texto), `feature` (icono + capacidad), `media` (portada arriba), `horizontal` (portada al lado), `metric` (un dato grande: `value` y `delta`), `status` (punto de estado con `tone` + texto), `cover` (la portada `media` a sangre con velo `--ds-card-scrim` para que el texto se lea: la celda destacada de un bento). El énfasis (`elevated`, `outlined`, `filled`, `ghost`) cambia la prominencia, no la estructura.",
985
+ "Interactiva con `href` (navega) o `onSelect` (acción): toda la tarjeta es el objetivo y el título el enlace; no metas botones dentro de un enlace ni tarjetas dentro de tarjetas. Para filas de entidades usa Item variant=\"card\"; para cifras, Stat.",
986
+ "Para disponer varias, Mosaic (even · bento · trio)."
987
+ ],
988
+ "examples": [
989
+ {
990
+ "title": "Capacidad que navega (preset feature)",
991
+ "code": "<ContentCard preset=\"feature\" icon={<ZapIcon />} title=\"Automatizaciones\" description=\"Reglas que actúan por ti\" href=\"/automations\" />"
992
+ },
993
+ {
994
+ "title": "Portada con acción en el pie",
995
+ "code": "<ContentCard preset=\"media\" media={<img src=\"/curso.jpg\" alt=\"\" />} title=\"Curso de inicio\" emphasis=\"outlined\" footer={<Button size=\"sm\">Empezar</Button>} />"
996
+ },
997
+ {
998
+ "title": "Un dato suelto (preset metric)",
999
+ "code": "<ContentCard preset=\"metric\" title=\"Clientes activos\" value=\"1.284\" delta=\"+4,2 %\" />"
1000
+ }
1001
+ ]
1002
+ },
1003
+ "cta-banner": {
1004
+ "import": "orbital-ds/ui/cta-banner",
1005
+ "group": "content",
1006
+ "summary": "Llamada final a la acción de una web pública: bloque con superficie propia, título, una frase y uno o dos botones, al pie de la portada.",
1007
+ "see": [
1008
+ {
1009
+ "component": "hero",
1010
+ "when": "la portada de arriba del todo"
1011
+ },
1012
+ {
1013
+ "component": "banner",
1014
+ "when": "aviso de sistema que afecta a toda la página, no una invitación"
1015
+ },
1016
+ {
1017
+ "component": "next-step-card",
1018
+ "when": "siguiente paso de un servicio DENTRO de la app"
1019
+ }
1020
+ ],
1021
+ "exports": [
1022
+ "CtaBanner",
1023
+ "type CtaBannerProps"
1024
+ ],
1025
+ "slots": [
1026
+ "cta-banner",
1027
+ "cta-banner-actions",
1028
+ "cta-banner-description",
1029
+ "cta-banner-title"
1030
+ ],
1031
+ "optionalPeers": [],
1032
+ "props": {
1033
+ "CtaBanner": {
1034
+ "title": {
1035
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1036
+ "required": true
1037
+ },
1038
+ "description": {
1039
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
1040
+ },
1041
+ "actions": {
1042
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1043
+ "doc": "Una acción principal y, como mucho, una secundaria."
1044
+ },
1045
+ "layout": {
1046
+ "type": "\"inline\" | \"centered\"",
1047
+ "values": [
1048
+ "inline",
1049
+ "centered"
1050
+ ]
1051
+ },
1052
+ "backdrop": {
1053
+ "type": "AuthBackdropVariant",
1054
+ "values": [
1055
+ "image",
1056
+ "none",
1057
+ "grid",
1058
+ "dots",
1059
+ "aurora",
1060
+ "mesh",
1061
+ "glow",
1062
+ "rings",
1063
+ "beams"
1064
+ ]
1065
+ },
1066
+ "backdropMedia": {
1067
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1068
+ "doc": "backdrop=\"image\": la foto o el vídeo de fondo (con alt=\"\")."
1069
+ },
1070
+ "backdropGlass": {
1071
+ "type": "boolean"
1072
+ },
1073
+ "titleAs": {
1074
+ "type": "\"h2\" | \"h3\"",
1075
+ "values": [
1076
+ "h2",
1077
+ "h3"
1078
+ ]
1079
+ }
1080
+ }
1081
+ },
1082
+ "notes": [
1083
+ "Una por página, al final, repitiendo la acción principal del Hero con otras palabras; nada de enlaces sueltos alrededor.",
1084
+ "Para darle color de marca, la app ajusta `--ds-cta-bg`, `--ds-cta-fg` y `--ds-cta-description-fg` en su brand.css (y vuelve a pasar el doctor por el contraste); con `backdrop` de imagen, usa `backdropGlass` para que el texto se lea."
1085
+ ],
1086
+ "examples": [
1087
+ {
1088
+ "title": "Al pie de la portada",
1089
+ "code": "<CtaBanner title=\"Empieza hoy, gratis\" description=\"Sin tarjeta y en cinco minutos.\" actions={<Button size=\"lg\">Crear cuenta</Button>} />"
1090
+ },
1091
+ {
1092
+ "title": "En línea, con fondo",
1093
+ "code": "<CtaBanner layout=\"inline\" backdrop=\"mesh\" title=\"¿Hablamos?\" description=\"Te enseñamos una demo con tus datos.\" actions={<Button>Pedir demo</Button>} />"
1094
+ }
1095
+ ]
1096
+ },
1097
+ "direction": {
1098
+ "import": "orbital-ds/ui/direction",
1099
+ "group": "content",
1100
+ "summary": "Proveedor de dirección de lectura (ltr / rtl) de Base UI y su hook useDirection; casi nunca se monta a mano, porque DsI18nProvider ya lo incluye.",
1101
+ "see": [
1102
+ {
1103
+ "component": "i18n-provider",
1104
+ "when": "idioma, textos y dirección de orbital-ds en la raíz (ya monta este proveedor)"
1105
+ }
1106
+ ],
1107
+ "exports": [
1108
+ "DirectionProvider",
1109
+ "useDirection"
1110
+ ],
1111
+ "slots": [],
1112
+ "optionalPeers": [],
1113
+ "notes": [
1114
+ "El proveedor informa a Base UI (teclado, posición de menús), no cambia el CSS: pon también `dir` en el HTML (`<html dir={dsDirection(idioma)}>` o en la zona). `useDirection()` devuelve la dirección activa."
1115
+ ],
1116
+ "examples": [
1117
+ {
1118
+ "title": "Forzar RTL en una zona",
1119
+ "code": "<DirectionProvider direction=\"rtl\">\n <div dir=\"rtl\">{children}</div>\n</DirectionProvider>"
1120
+ }
1121
+ ]
1122
+ },
1123
+ "empty-state": {
1124
+ "import": "orbital-ds/ui/empty-state",
1125
+ "group": "content",
1126
+ "summary": "Estado vacío listo por intención dentro de una vista o lista (nada aún, el filtro no encuentra, error al cargar, sin permiso), con textos ya traducidos.",
1127
+ "see": [
1128
+ {
1129
+ "component": "empty",
1130
+ "when": "componer un vacío propio con las piezas"
1131
+ },
1132
+ {
1133
+ "component": "error-page",
1134
+ "when": "la vista entera es un error (404, 403, 500, sin conexión, mantenimiento)"
1135
+ },
1136
+ {
1137
+ "component": "error-state",
1138
+ "when": "fallo al cargar un bloque de datos, con reintentar y detalle del error"
1139
+ }
1140
+ ],
1141
+ "exports": [
1142
+ "EmptyState",
1143
+ "type EmptyStatePreset"
1144
+ ],
1145
+ "slots": [
1146
+ "empty-state",
1147
+ "empty-state-content"
1148
+ ],
1149
+ "optionalPeers": [],
1150
+ "props": {
1151
+ "EmptyState": {
1152
+ "preset": {
1153
+ "type": "EmptyStatePreset",
1154
+ "values": [
1155
+ "error",
1156
+ "first-use",
1157
+ "no-results",
1158
+ "forbidden"
1159
+ ]
1160
+ },
1161
+ "title": {
1162
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
1163
+ },
1164
+ "description": {
1165
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
1166
+ },
1167
+ "icon": {
1168
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1169
+ "doc": "Sustituye el icono del preset."
1170
+ },
1171
+ "action": {
1172
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1173
+ "doc": "Acción principal (botón o enlace); la pone la app."
1174
+ },
1175
+ "backdrop": {
1176
+ "type": "AuthBackdropVariant",
1177
+ "values": [
1178
+ "image",
1179
+ "none",
1180
+ "grid",
1181
+ "dots",
1182
+ "aurora",
1183
+ "mesh",
1184
+ "glow",
1185
+ "rings",
1186
+ "beams"
1187
+ ],
1188
+ "doc": "Fondo decorativo detrás (ver AuthBackdrop): mesh, aurora, dots, image… Por defecto, ninguno."
1189
+ },
1190
+ "backdropMedia": {
1191
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1192
+ "doc": "backdrop=\"image\": la foto o el vídeo (un <img>/<video> con alt=\"\"), teñido de marca."
1193
+ },
1194
+ "backdropGlass": {
1195
+ "type": "boolean",
1196
+ "doc": "Cristal esmerilado sobre el fondo («mesh + glass»)."
1197
+ },
1198
+ "animated": {
1199
+ "type": "boolean",
1200
+ "doc": "Entrada en cascada y el icono flotando con el ritmo del tema (quieto con movimiento reducido)."
1201
+ }
1202
+ }
1203
+ },
1204
+ "presets": {
1205
+ "values": [
1206
+ "first-use",
1207
+ "no-results",
1208
+ "error",
1209
+ "forbidden"
1210
+ ],
1211
+ "default": "first-use",
1212
+ "intent": {
1213
+ "first-use": "todavía no hay nada: invita a crear lo primero",
1214
+ "no-results": "hay datos pero el filtro no encuentra: invita a cambiar o limpiar filtros",
1215
+ "error": "no se pudo cargar: invita a reintentar",
1216
+ "forbidden": "sin permiso: explica por qué no se ve"
1217
+ }
1218
+ },
1219
+ "notes": [
1220
+ "Un preset por intención: first-use (nada aún), no-results (el filtro no encuentra), error (reintentar), forbidden (sin permiso). Cambia título, descripción o icono solo si el dominio lo pide.",
1221
+ "`backdrop=\"dots\"` + `animated` para un primer uso con personalidad (portada de un módulo); en tablas y listas, sin fondo.",
1222
+ "Para un vacío con composición propia usa Empty y sus partes."
1223
+ ],
1224
+ "examples": [
1225
+ {
1226
+ "title": "Primer uso con acción",
1227
+ "code": "<EmptyState preset=\"first-use\" title=\"Aún no hay clientes\" action={<Button>Nuevo cliente</Button>} />"
1228
+ },
1229
+ {
1230
+ "title": "Sin resultados de un filtro",
1231
+ "code": "<EmptyState preset=\"no-results\" action={<Button variant=\"outline\" onClick={clearFilters}>Limpiar filtros</Button>} />"
1232
+ }
1233
+ ]
1234
+ },
1235
+ "empty": {
1236
+ "import": "orbital-ds/ui/empty",
1237
+ "group": "content",
1238
+ "summary": "Piezas para componer un estado vacío propio (icono, título, descripción y acción) cuando ningún preset de EmptyState encaja.",
1239
+ "see": [
1240
+ {
1241
+ "component": "empty-state",
1242
+ "when": "vacío listo por intención (first-use, no-results, error, forbidden) con textos traducidos"
1243
+ },
1244
+ {
1245
+ "component": "error-page",
1246
+ "when": "la vista entera es un error (404, 403, 500, sin conexión)"
1247
+ },
1248
+ {
1249
+ "component": "error-state",
1250
+ "when": "fallo al cargar datos dentro de una vista, con reintentar"
1251
+ }
1252
+ ],
1253
+ "exports": [
1254
+ "Empty",
1255
+ "EmptyContent",
1256
+ "EmptyDescription",
1257
+ "EmptyHeader",
1258
+ "EmptyMedia",
1259
+ "EmptyTitle"
1260
+ ],
1261
+ "slots": [
1262
+ "empty",
1263
+ "empty-content",
1264
+ "empty-description",
1265
+ "empty-header",
1266
+ "empty-icon",
1267
+ "empty-title"
1268
+ ],
1269
+ "optionalPeers": [],
1270
+ "props": {
1271
+ "EmptyMedia": {
1272
+ "variant": {
1273
+ "type": "\"default\" | \"icon\"",
1274
+ "values": [
1275
+ "default",
1276
+ "icon"
1277
+ ]
1278
+ }
1279
+ }
1280
+ },
1281
+ "notes": [
1282
+ "Estado vacío: qué es esto, por qué está vacío y la acción para empezar; sin resultados: los filtros aplicados y «Limpiar filtros»."
1283
+ ],
1284
+ "examples": [
1285
+ {
1286
+ "title": "Montaje mínimo",
1287
+ "code": "<Empty>\n <EmptyHeader>\n <EmptyMedia variant=\"icon\">\n <FolderIcon />\n </EmptyMedia>\n <EmptyTitle>Sin proyectos</EmptyTitle>\n <EmptyDescription>Crea tu primer proyecto para empezar.</EmptyDescription>\n </EmptyHeader>\n <EmptyContent>\n <Button>Nuevo proyecto</Button>\n </EmptyContent>\n</Empty>"
1288
+ }
1289
+ ]
1290
+ },
1291
+ "error-page": {
1292
+ "import": "orbital-ds/ui/error-page",
1293
+ "group": "content",
1294
+ "summary": "Página completa de error o de estado del servicio (404, 403, 500, sin conexión, mantenimiento) cuando la vista entera no se puede mostrar.",
1295
+ "see": [
1296
+ {
1297
+ "component": "empty-state",
1298
+ "when": "vacío o error dentro de una vista que sí se muestra"
1299
+ },
1300
+ {
1301
+ "component": "error-state",
1302
+ "when": "fallo al cargar un bloque de datos, con reintentar"
1303
+ }
1304
+ ],
1305
+ "exports": [
1306
+ "ErrorPage",
1307
+ "type ErrorPagePreset",
1308
+ "type ErrorPageTone"
1309
+ ],
1310
+ "slots": [
1311
+ "error-page",
1312
+ "error-page-actions",
1313
+ "error-page-code",
1314
+ "error-page-content",
1315
+ "error-page-description",
1316
+ "error-page-title"
1317
+ ],
1318
+ "optionalPeers": [],
1319
+ "props": {
1320
+ "ErrorPage": {
1321
+ "preset": {
1322
+ "type": "ErrorPagePreset",
1323
+ "values": [
1324
+ "forbidden",
1325
+ "not-found",
1326
+ "server-error",
1327
+ "offline",
1328
+ "maintenance"
1329
+ ]
1330
+ },
1331
+ "tone": {
1332
+ "type": "ErrorPageTone",
1333
+ "values": [
1334
+ "neutral",
1335
+ "playful"
1336
+ ],
1337
+ "doc": "Tono de los textos por defecto."
1338
+ },
1339
+ "code": {
1340
+ "type": "string",
1341
+ "doc": "Número grande (404, 500…); `null` lo oculta."
1342
+ },
1343
+ "title": {
1344
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
1345
+ },
1346
+ "description": {
1347
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
1348
+ },
1349
+ "illustration": {
1350
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1351
+ "doc": "Sustituye el icono del preset."
1352
+ },
1353
+ "actions": {
1354
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1355
+ "doc": "Botones o enlaces de la app; el primero es el principal."
1356
+ },
1357
+ "backdrop": {
1358
+ "type": "AuthBackdropVariant",
1359
+ "values": [
1360
+ "image",
1361
+ "none",
1362
+ "grid",
1363
+ "dots",
1364
+ "aurora",
1365
+ "mesh",
1366
+ "glow",
1367
+ "rings",
1368
+ "beams"
1369
+ ],
1370
+ "doc": "Fondo decorativo detrás (ver AuthBackdrop): mesh, aurora, dots, image… Por defecto, ninguno."
1371
+ },
1372
+ "backdropMedia": {
1373
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1374
+ "doc": "backdrop=\"image\": la foto o el vídeo (un <img>/<video> con alt=\"\"), teñido de marca."
1375
+ },
1376
+ "backdropGlass": {
1377
+ "type": "boolean",
1378
+ "doc": "Cristal esmerilado sobre el fondo («mesh + glass»)."
1379
+ },
1380
+ "animated": {
1381
+ "type": "boolean",
1382
+ "doc": "Entrada en cascada y el icono flotando con el ritmo del tema (quieto con movimiento reducido)."
1383
+ }
1384
+ }
1385
+ },
1386
+ "presets": {
1387
+ "values": [
1388
+ "not-found",
1389
+ "forbidden",
1390
+ "server-error",
1391
+ "offline",
1392
+ "maintenance"
1393
+ ],
1394
+ "default": "not-found",
1395
+ "intent": {
1396
+ "not-found": "la ruta o el recurso no existe (404): lleva de vuelta a un sitio seguro",
1397
+ "forbidden": "sin permiso (403): explica a quién pedir acceso",
1398
+ "server-error": "falló el servidor (500): invita a reintentar",
1399
+ "offline": "sin conexión: la app decide cuándo se recupera",
1400
+ "maintenance": "parada programada: di cuándo vuelve en `description`"
1401
+ }
1402
+ },
1403
+ "notes": [
1404
+ "Página completa de error por intención: not-found (404, lleva a un sitio seguro), forbidden (403), server-error (500, reintentar), offline y maintenance (di cuándo vuelve en `description`). Dentro de una vista usa EmptyState; aquí es la vista entera.",
1405
+ "`tone=\"playful\"` da mensajes con personalidad (en, es y pt-BR); úsalo en productos cercanos y nunca en un fallo grave. Los textos propios de la app se pasan con `title`/`description`.",
1406
+ "`backdrop` (+ `backdropGlass`, `backdropMedia`) y `animated` para una página de error con personalidad (producto, portada); en un backoffice, sin fondo.",
1407
+ "Siempre con una salida: `actions` con un botón principal (inicio, reintentar, volver). Para la ruta desconocida de un router, monta ErrorPage en su componente de «no encontrado»."
1408
+ ],
1409
+ "examples": [
1410
+ {
1411
+ "title": "Ruta no encontrada",
1412
+ "code": "<ErrorPage preset=\"not-found\" actions={<Button render={<a href=\"/\" />}>Ir al inicio</Button>} />"
1413
+ },
1414
+ {
1415
+ "title": "Fallo del servidor con reintentar",
1416
+ "code": "<ErrorPage preset=\"server-error\" actions={<Button onClick={retry}>Reintentar</Button>} />"
1417
+ },
1418
+ {
1419
+ "title": "Mantenimiento con tono cercano",
1420
+ "code": "<ErrorPage preset=\"maintenance\" tone=\"playful\" description=\"Volvemos hoy a las 18:00.\" />"
1421
+ }
1422
+ ]
1423
+ },
1424
+ "eyebrow": {
1425
+ "import": "orbital-ds/ui/eyebrow",
1426
+ "group": "content",
1427
+ "summary": "Etiqueta pequeña en versalitas encima de un título o una cifra para darle contexto (sección, categoría, nombre de un KPI); no es un encabezado.",
1428
+ "see": [
1429
+ {
1430
+ "component": "page-header",
1431
+ "when": "título, descripción y acciones de la página"
1432
+ },
1433
+ {
1434
+ "component": "marker",
1435
+ "when": "rótulo que anota o separa contenido (fecha, «Hoy»)"
1436
+ },
1437
+ {
1438
+ "component": "badge",
1439
+ "when": "etiqueta de estado o categoría junto a un elemento"
1440
+ }
1441
+ ],
1442
+ "exports": [
1443
+ "Eyebrow",
1444
+ "eyebrowClassName"
1445
+ ],
1446
+ "slots": [
1447
+ "eyebrow"
1448
+ ],
1449
+ "optionalPeers": [],
1450
+ "notes": [
1451
+ "No sustituye a un encabezado: es contexto y el título sigue siendo un h1–h3. Con `render` adopta la etiqueta semántica (dt, span)."
1452
+ ],
1453
+ "examples": [
1454
+ {
1455
+ "title": "Encima de un título",
1456
+ "code": "<Eyebrow>Operaciones</Eyebrow>\n<h2>Llamadas de hoy</h2>"
1457
+ },
1458
+ {
1459
+ "title": "Como término de una lista de descripción",
1460
+ "code": "<Eyebrow render={<dt />}>Llamadas atendidas</Eyebrow>"
1461
+ }
1462
+ ]
1463
+ },
1464
+ "faq": {
1465
+ "import": "orbital-ds/ui/faq",
1466
+ "group": "content",
1467
+ "summary": "Preguntas frecuentes de una web pública o de una ayuda: lista desplegable de pregunta y respuesta, con datos estructurados opcionales para buscadores.",
1468
+ "see": [
1469
+ {
1470
+ "component": "accordion",
1471
+ "when": "paneles desplegables de cualquier contenido (ajustes, detalles)"
1472
+ },
1473
+ {
1474
+ "component": "landing-section",
1475
+ "when": "la sección con título que la envuelve en una portada"
1476
+ }
1477
+ ],
1478
+ "exports": [
1479
+ "Faq",
1480
+ "type FaqItem",
1481
+ "type FaqProps"
1482
+ ],
1483
+ "slots": [
1484
+ "faq"
1485
+ ],
1486
+ "optionalPeers": [],
1487
+ "props": {
1488
+ "Faq": {
1489
+ "items": {
1490
+ "type": "FaqItem[]",
1491
+ "required": true
1492
+ },
1493
+ "structuredData": {
1494
+ "type": "boolean",
1495
+ "doc": "JSON-LD FAQPage (schema.org) para que los buscadores muestren las preguntas."
1496
+ }
1497
+ }
1498
+ },
1499
+ "notes": [
1500
+ "Preguntas reales que hace la gente (soporte, ventas), redactadas como las haría; respuestas de una o dos frases con enlace al detalle si hace falta.",
1501
+ "Entre 4 y 8 preguntas; si hay más, agrúpalas por tema con un título (LandingSection o SectionHeader) por grupo.",
1502
+ "`structuredData` solo en la página pública donde se leen esas preguntas, una vez por página."
1503
+ ],
1504
+ "examples": [
1505
+ {
1506
+ "title": "Preguntas de una portada",
1507
+ "code": "<Faq\n items={[\n { question: \"¿Puedo cancelar cuando quiera?\", answer: \"Sí, desde Ajustes y sin permanencia.\" },\n { question: \"¿Hay periodo de prueba?\", answer: \"14 días con todas las funciones.\" },\n ]}\n/>"
1508
+ },
1509
+ {
1510
+ "title": "Varias abiertas y con datos estructurados",
1511
+ "code": "<Faq multiple structuredData defaultValue={[\"prueba\"]} items={[{ value: \"prueba\", question: \"¿Hay periodo de prueba?\", answer: \"14 días.\" }]} />"
1512
+ }
1513
+ ]
1514
+ },
1515
+ "feature-grid": {
1516
+ "import": "orbital-ds/ui/feature-grid",
1517
+ "group": "content",
1518
+ "summary": "Rejilla de características o ventajas de un producto (icono, título y una frase), para la sección «qué hace» de una web pública.",
1519
+ "see": [
1520
+ {
1521
+ "component": "content-card",
1522
+ "when": "tarjetas con imagen o enlace a otra página"
1523
+ },
1524
+ {
1525
+ "component": "mosaic",
1526
+ "when": "rejilla bento de bloques de distinto tamaño"
1527
+ }
1528
+ ],
1529
+ "exports": [
1530
+ "Feature",
1531
+ "FeatureGrid",
1532
+ "type FeatureGridProps",
1533
+ "type FeatureProps"
1534
+ ],
1535
+ "slots": [
1536
+ "feature",
1537
+ "feature-description",
1538
+ "feature-grid",
1539
+ "feature-icon",
1540
+ "feature-title"
1541
+ ],
1542
+ "optionalPeers": [],
1543
+ "props": {
1544
+ "Feature": {
1545
+ "icon": {
1546
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1547
+ "doc": "Icono (svg) en una baldosa."
1548
+ },
1549
+ "iconTone": {
1550
+ "type": "\"info\" | \"success\" | \"warning\" | \"danger\" | \"primary\" | \"neutral\" | \"accent\"",
1551
+ "values": [
1552
+ "info",
1553
+ "success",
1554
+ "warning",
1555
+ "danger",
1556
+ "primary",
1557
+ "neutral",
1558
+ "accent"
1559
+ ]
1560
+ },
1561
+ "title": {
1562
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1563
+ "required": true,
1564
+ "doc": "Nombre de la característica. No es el atributo HTML `title`."
1565
+ },
1566
+ "description": {
1567
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
1568
+ }
1569
+ },
1570
+ "FeatureGrid": {
1571
+ "columns": {
1572
+ "type": "2 | 4 | 3",
1573
+ "doc": "Columnas en un contenedor ancho."
1574
+ },
1575
+ "variant": {
1576
+ "type": "\"plain\" | \"card\"",
1577
+ "values": [
1578
+ "plain",
1579
+ "card"
1580
+ ]
1581
+ },
1582
+ "align": {
1583
+ "type": "\"center\" | \"start\"",
1584
+ "values": [
1585
+ "center",
1586
+ "start"
1587
+ ]
1588
+ }
1589
+ }
1590
+ },
1591
+ "notes": [
1592
+ "Entre 3 y 6 características, cada una con un beneficio concreto en el título y una sola frase. Más de 6 cansa: agrupa o enlaza a una página de detalle.",
1593
+ "Iconos del mismo trazo y tamaño (lucide); no repitas el mismo icono.",
1594
+ "`variant=\"card\"` cuando la sección va sobre un fondo con dibujo o para separar bloques densos; `plain` en el resto."
1595
+ ],
1596
+ "examples": [
1597
+ {
1598
+ "title": "Tres ventajas",
1599
+ "code": "<FeatureGrid>\n <Feature icon={<ZapIcon />} title=\"Rápido\" description=\"Respuestas en milisegundos.\" />\n <Feature icon={<ShieldIcon />} title=\"Seguro\" description=\"Cifrado de extremo a extremo.\" />\n <Feature icon={<PlugIcon />} title=\"Conectado\" description=\"Más de 50 integraciones.\" />\n</FeatureGrid>"
1600
+ },
1601
+ {
1602
+ "title": "En tarjetas, a cuatro columnas",
1603
+ "code": "<FeatureGrid columns={4} variant=\"card\">\n <Feature icon={<ZapIcon />} title=\"Rápido\" description=\"Respuestas en milisegundos.\" />\n</FeatureGrid>"
1604
+ }
1605
+ ]
1606
+ },
1607
+ "hero": {
1608
+ "import": "orbital-ds/ui/hero",
1609
+ "group": "content",
1610
+ "summary": "Portada de una web, un producto o un módulo: antetítulo, título grande, texto, acciones y, según el preset, imagen al lado, foto de fondo o tira de logos o cifras.",
1611
+ "see": [
1612
+ {
1613
+ "component": "page-header",
1614
+ "when": "cabecera de una vista de trabajo (título, migas, acciones), no una portada"
1615
+ },
1616
+ {
1617
+ "component": "empty-state",
1618
+ "when": "un módulo que aún no tiene contenido e invita a crear lo primero"
1619
+ },
1620
+ {
1621
+ "component": "content-card",
1622
+ "when": "tarjeta de presentación dentro de una rejilla, no la portada de la página"
1623
+ }
1624
+ ],
1625
+ "exports": [
1626
+ "Hero",
1627
+ "type HeroAlign",
1628
+ "type HeroPreset",
1629
+ "type HeroProps"
1630
+ ],
1631
+ "slots": [
1632
+ "hero",
1633
+ "hero-actions",
1634
+ "hero-content",
1635
+ "hero-description",
1636
+ "hero-eyebrow",
1637
+ "hero-footer",
1638
+ "hero-inner",
1639
+ "hero-media",
1640
+ "hero-title"
1641
+ ],
1642
+ "optionalPeers": [],
1643
+ "props": {
1644
+ "Hero": {
1645
+ "preset": {
1646
+ "type": "HeroPreset",
1647
+ "values": [
1648
+ "section",
1649
+ "split",
1650
+ "media",
1651
+ "landing"
1652
+ ]
1653
+ },
1654
+ "title": {
1655
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1656
+ "required": true,
1657
+ "doc": "Título de la portada. No es el atributo HTML `title`."
1658
+ },
1659
+ "description": {
1660
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1661
+ "doc": "Texto de apoyo bajo el título (una o dos frases)."
1662
+ },
1663
+ "eyebrow": {
1664
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1665
+ "doc": "Sobre el título: una Badge de novedad, un enlace «Nuevo: …» o la categoría."
1666
+ },
1667
+ "actions": {
1668
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1669
+ "doc": "Llamadas a la acción (una principal y, como mucho, una secundaria)."
1670
+ },
1671
+ "media": {
1672
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1673
+ "doc": "split: la imagen, el vídeo o la demo junto al texto (con su `alt`)."
1674
+ },
1675
+ "footer": {
1676
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1677
+ "doc": "Bajo todo: tira de logos de clientes, cifras (StatGroup preset=\"strip\") o una nota."
1678
+ },
1679
+ "align": {
1680
+ "type": "HeroAlign",
1681
+ "values": [
1682
+ "center",
1683
+ "start"
1684
+ ],
1685
+ "doc": "Alineación del texto; por defecto, la del preset."
1686
+ },
1687
+ "backdrop": {
1688
+ "type": "AuthBackdropVariant",
1689
+ "values": [
1690
+ "image",
1691
+ "none",
1692
+ "grid",
1693
+ "dots",
1694
+ "aurora",
1695
+ "mesh",
1696
+ "glow",
1697
+ "rings",
1698
+ "beams"
1699
+ ],
1700
+ "doc": "Fondo decorativo (ver AuthBackdrop). Por defecto ninguno; `media` usa `image`."
1701
+ },
1702
+ "backdropMedia": {
1703
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1704
+ "doc": "backdrop=\"image\": la foto o el vídeo de fondo (un <img>/<video> con alt=\"\")."
1705
+ },
1706
+ "backdropGlass": {
1707
+ "type": "boolean",
1708
+ "doc": "Cristal esmerilado sobre el fondo."
1709
+ },
1710
+ "plate": {
1711
+ "type": "boolean",
1712
+ "doc": "Placa bajo el texto para garantizar el contraste sobre un fondo cargado; por defecto, solo con foto."
1713
+ },
1714
+ "animated": {
1715
+ "type": "boolean",
1716
+ "doc": "Entrada en cascada con el ritmo del tema (quieta con movimiento reducido)."
1717
+ },
1718
+ "titleAs": {
1719
+ "type": "\"h1\" | \"h2\"",
1720
+ "values": [
1721
+ "h1",
1722
+ "h2"
1723
+ ],
1724
+ "doc": "Nivel del título: h1 si es la portada de la página; h2 si va dentro de otra vista."
1725
+ }
1726
+ }
1727
+ },
1728
+ "presets": {
1729
+ "values": [
1730
+ "landing",
1731
+ "split",
1732
+ "media",
1733
+ "section"
1734
+ ],
1735
+ "default": "landing",
1736
+ "intent": {
1737
+ "landing": "portada de una web o producto: centrado, título a escala de portada",
1738
+ "split": "texto a un lado e imagen, vídeo o demo al otro (`media`); se apila en un contenedor estrecho",
1739
+ "media": "foto o vídeo de fondo (`backdropMedia`) teñido de marca, con el texto sobre una placa",
1740
+ "section": "portada de un módulo DENTRO de la app: alineado al inicio, título y aire menores"
1741
+ }
1742
+ },
1743
+ "notes": [
1744
+ "Un hero por página, arriba del todo, y solo en portadas: web pública, presentación de un producto o la entrada a un módulo (`section`). En una vista de trabajo usa PageHeader.",
1745
+ "Un título que diga el beneficio en una frase, una o dos frases de apoyo y, como mucho, dos acciones (principal + secundaria). Nada de carruseles en la portada.",
1746
+ "`landing` + `backdrop=\"mesh\"`/`\"dots\"` para una portada con personalidad; `media` para una foto de fondo (la placa garantiza el contraste); `split` cuando hay una captura o demo que enseñar.",
1747
+ "Si va dentro de otra vista que ya tiene su h1, `titleAs=\"h2\"`."
1748
+ ],
1749
+ "examples": [
1750
+ {
1751
+ "title": "Portada de producto",
1752
+ "code": "<Hero\n preset=\"landing\"\n eyebrow={<Badge variant=\"secondary\">Nuevo · Informes automáticos</Badge>}\n title=\"Tus operaciones, en una sola vista\"\n description=\"Conecta tus fuentes y recibe cada lunes el informe que antes hacías a mano.\"\n actions={<><Button size=\"lg\">Empezar gratis</Button><Button size=\"lg\" variant=\"outline\">Ver demo</Button></>}\n backdrop=\"mesh\"\n/>"
1753
+ },
1754
+ {
1755
+ "title": "Texto junto a una captura",
1756
+ "code": "<Hero preset=\"split\" title=\"Todo tu equipo, al día\" description=\"Avisos, tareas y métricas en un panel.\" actions={<Button>Probar</Button>} media={<img src=\"/panel.png\" alt=\"Panel de control con métricas\" />} />"
1757
+ },
1758
+ {
1759
+ "title": "Portada de un módulo dentro de la app",
1760
+ "code": "<Hero preset=\"section\" title=\"Integraciones\" description=\"Conecta tus herramientas en dos clics.\" actions={<Button>Añadir integración</Button>} footer={<StatGroup preset=\"strip\">…</StatGroup>} />"
1761
+ }
1762
+ ]
1763
+ },
1764
+ "i18n-provider": {
1765
+ "import": "orbital-ds/ui/i18n-provider",
1766
+ "group": "content",
1767
+ "summary": "Proveedor raíz que fija idioma, textos propios y dirección (ltr / rtl) de los componentes de orbital-ds; se monta una vez con el idioma activo de la app.",
1768
+ "see": [
1769
+ {
1770
+ "component": "direction",
1771
+ "when": "solo la dirección de Base UI (ya incluida aquí)"
1772
+ },
1773
+ {
1774
+ "component": "motion-provider",
1775
+ "when": "proveedor raíz de Motion para animar con los presets del tema"
1776
+ }
1777
+ ],
1778
+ "exports": [
1779
+ "DsI18nProvider"
1780
+ ],
1781
+ "slots": [],
1782
+ "optionalPeers": [],
1783
+ "props": {
1784
+ "DsI18nProvider": {
1785
+ "locale": {
1786
+ "type": "string"
1787
+ },
1788
+ "messages": {
1789
+ "type": "Partial<{ close: string; closeNotification: string; loading: string; breadcrumb: string; breadcrumbMore: string; pagination: string; paginationPrevious: stri…"
1790
+ },
1791
+ "dir": {
1792
+ "type": "\"ltr\" | \"rtl\"",
1793
+ "values": [
1794
+ "ltr",
1795
+ "rtl"
1796
+ ]
1797
+ },
1798
+ "children": {
1799
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
1800
+ "required": true
1801
+ }
1802
+ }
1803
+ },
1804
+ "notes": [
1805
+ "Sin provider, los textos de los componentes salen en inglés. Pon además `dir={dsDirection(idioma)}` en `<html>`; la prop `dir` de aquí solo fuerza la dirección."
1806
+ ],
1807
+ "examples": [
1808
+ {
1809
+ "title": "Con i18next (espacio «orbital»)",
1810
+ "code": "<DsI18nProvider locale={i18n.language} messages={i18n.getResourceBundle(i18n.language, \"orbital\")}>\n <App />\n</DsI18nProvider>"
1811
+ },
1812
+ {
1813
+ "title": "Con los catálogos incluidos (en, es, pt-BR)",
1814
+ "code": "<DsI18nProvider locale=\"es\">\n <App />\n</DsI18nProvider>"
1815
+ }
1816
+ ]
1817
+ },
1818
+ "icon-tile": {
1819
+ "import": "orbital-ds/ui/icon-tile",
1820
+ "group": "content",
1821
+ "summary": "Icono grande en una baldosa tintada por tono, decorativo, que da identidad visual a una tarjeta, un KPI, una fila de entidad o una bienvenida.",
1822
+ "see": [
1823
+ {
1824
+ "component": "avatar",
1825
+ "when": "foto o iniciales de una persona"
1826
+ },
1827
+ {
1828
+ "component": "empty",
1829
+ "when": "estado vacío completo (ya lleva su icono)"
1830
+ }
1831
+ ],
1832
+ "exports": [
1833
+ "IconTile",
1834
+ "iconTileVariants"
1835
+ ],
1836
+ "slots": [
1837
+ "icon-tile"
1838
+ ],
1839
+ "optionalPeers": [],
1840
+ "props": {
1841
+ "IconTile": {
1842
+ "size": {
1843
+ "type": "\"sm\" | \"lg\" | \"md\"",
1844
+ "values": [
1845
+ "sm",
1846
+ "lg",
1847
+ "md"
1848
+ ]
1849
+ },
1850
+ "tone": {
1851
+ "type": "\"info\" | \"success\" | \"warning\" | \"danger\" | \"primary\" | \"neutral\" | \"accent\"",
1852
+ "values": [
1853
+ "info",
1854
+ "success",
1855
+ "warning",
1856
+ "danger",
1857
+ "primary",
1858
+ "neutral",
1859
+ "accent"
1860
+ ]
1861
+ }
1862
+ }
1863
+ },
1864
+ "notes": [
1865
+ "Es decorativa (aria-hidden): el significado lo da el texto de al lado, nunca solo el color del tono."
1866
+ ],
1867
+ "examples": [
1868
+ {
1869
+ "title": "En una fila de entidad",
1870
+ "code": "<Item variant=\"card\">\n <ItemMedia>\n <IconTile tone=\"primary\" size=\"sm\">\n <BotIcon />\n </IconTile>\n </ItemMedia>\n <ItemContent>\n <ItemTitle>Agente de soporte</ItemTitle>\n </ItemContent>\n</Item>"
1871
+ },
1872
+ {
1873
+ "title": "Suelta, con tono de estado",
1874
+ "code": "<IconTile tone=\"success\" size=\"lg\">\n <CheckIcon />\n</IconTile>"
1875
+ }
1876
+ ]
1877
+ },
1878
+ "item": {
1879
+ "import": "orbital-ds/ui/item",
1880
+ "group": "content",
1881
+ "summary": "Fila de una lista de entidades (agentes, dispositivos, ajustes) con medio, título, descripción y acciones; `variant=\"card\"` la convierte en fila-tarjeta.",
1882
+ "see": [
1883
+ {
1884
+ "component": "entity-list",
1885
+ "when": "lista completa de entidades por preset (list, grid, compact)"
1886
+ },
1887
+ {
1888
+ "component": "content-card",
1889
+ "when": "tarjeta de una rejilla (capacidad, portada, métrica), no una fila"
1890
+ },
1891
+ {
1892
+ "component": "card",
1893
+ "when": "tarjeta con anatomía libre para un bloque propio"
1894
+ }
1895
+ ],
1896
+ "exports": [
1897
+ "Item",
1898
+ "ItemActions",
1899
+ "ItemContent",
1900
+ "ItemDescription",
1901
+ "ItemFooter",
1902
+ "ItemGroup",
1903
+ "ItemHeader",
1904
+ "ItemMedia",
1905
+ "ItemSeparator",
1906
+ "ItemTitle"
1907
+ ],
1908
+ "slots": [
1909
+ "item",
1910
+ "item-actions",
1911
+ "item-content",
1912
+ "item-description",
1913
+ "item-footer",
1914
+ "item-group",
1915
+ "item-header",
1916
+ "item-listitem",
1917
+ "item-media",
1918
+ "item-separator",
1919
+ "item-title"
1920
+ ],
1921
+ "optionalPeers": [],
1922
+ "props": {
1923
+ "Item": {
1924
+ "variant": {
1925
+ "type": "\"default\" | \"outline\" | \"muted\" | \"card\"",
1926
+ "values": [
1927
+ "default",
1928
+ "outline",
1929
+ "muted",
1930
+ "card"
1931
+ ]
1932
+ },
1933
+ "size": {
1934
+ "type": "\"default\" | \"xs\" | \"sm\"",
1935
+ "values": [
1936
+ "default",
1937
+ "xs",
1938
+ "sm"
1939
+ ]
1940
+ }
1941
+ },
1942
+ "ItemMedia": {
1943
+ "variant": {
1944
+ "type": "\"image\" | \"default\" | \"icon\"",
1945
+ "values": [
1946
+ "image",
1947
+ "default",
1948
+ "icon"
1949
+ ]
1950
+ }
1951
+ }
1952
+ },
1953
+ "notes": [
1954
+ "Listas de entidades: variant=\"card\" (fila-tarjeta). Sin acciones: render={<a href=… />} y la fila entera navega. Con acciones: el Item queda como div, el enlace va en ItemTitle estirado (after:absolute after:inset-0, Item relative) e ItemActions con relative z-(--ds-z-raised): nunca un botón dentro de un enlace. Dentro de ItemGroup cada Item ya va en su role=\"listitem\" (no lo envuelvas a mano).",
1955
+ "No compongas Card + Item a mano ni metas tarjetas dentro de tarjetas."
1956
+ ],
1957
+ "examples": [
1958
+ {
1959
+ "title": "Lista de entidades con acciones",
1960
+ "code": "<ItemGroup>\n <Item variant=\"card\">\n <ItemMedia>\n <IconTile tone=\"primary\" size=\"sm\">\n <BotIcon />\n </IconTile>\n </ItemMedia>\n <ItemContent>\n <ItemTitle>Agente de soporte</ItemTitle>\n <ItemDescription>Responde tickets de nivel 1</ItemDescription>\n </ItemContent>\n <ItemActions>\n <Button variant=\"outline\" size=\"sm\">Configurar</Button>\n </ItemActions>\n </Item>\n</ItemGroup>"
1961
+ },
1962
+ {
1963
+ "title": "Fila entera navegable (sin acciones)",
1964
+ "code": "<Item variant=\"card\" render={<a href=\"/agents/support\" />}>\n <ItemContent>\n <ItemTitle>Agente de soporte</ItemTitle>\n </ItemContent>\n</Item>"
1965
+ }
1966
+ ]
1967
+ },
1968
+ "kbd": {
1969
+ "import": "orbital-ds/ui/kbd",
1970
+ "group": "content",
1971
+ "summary": "Tecla o combinación de teclas para mostrar un atajo de teclado (⌘K, Ctrl + S) en un texto, un menú o un tooltip.",
1972
+ "see": [
1973
+ {
1974
+ "component": "code-block",
1975
+ "when": "código o comandos, no teclas (Code para código en línea)"
1976
+ },
1977
+ {
1978
+ "component": "command-palette",
1979
+ "when": "la paleta «Ir a…» que suele abrir el atajo ⌘K"
1980
+ }
1981
+ ],
1982
+ "exports": [
1983
+ "Kbd",
1984
+ "KbdGroup"
1985
+ ],
1986
+ "slots": [
1987
+ "kbd",
1988
+ "kbd-group"
1989
+ ],
1990
+ "optionalPeers": [],
1991
+ "notes": [
1992
+ "Un atajo nunca es la única forma de llegar a una acción: muéstralo junto a la acción visible (menú, botón, tooltip)."
1993
+ ],
1994
+ "examples": [
1995
+ {
1996
+ "title": "Atajo de dos teclas",
1997
+ "code": "<KbdGroup>\n <Kbd>⌘</Kbd>\n <Kbd>K</Kbd>\n</KbdGroup>"
1998
+ },
1999
+ {
2000
+ "title": "En un texto",
2001
+ "code": "<p>Pulsa <Kbd>Esc</Kbd> para cerrar.</p>"
2002
+ }
2003
+ ]
2004
+ },
2005
+ "landing-section": {
2006
+ "import": "orbital-ds/ui/landing-section",
2007
+ "group": "content",
2008
+ "summary": "Sección de una web pública bajo el Hero: antetítulo, título, texto y el bloque que la ocupa (características, precios, testimonios, preguntas frecuentes).",
2009
+ "see": [
2010
+ {
2011
+ "component": "hero",
2012
+ "when": "la portada de arriba del todo, una por página"
2013
+ },
2014
+ {
2015
+ "component": "page-header",
2016
+ "when": "cabecera de una vista de trabajo dentro de la app"
2017
+ }
2018
+ ],
2019
+ "exports": [
2020
+ "LandingSection",
2021
+ "type LandingSectionProps"
2022
+ ],
2023
+ "slots": [
2024
+ "landing-section",
2025
+ "landing-section-actions",
2026
+ "landing-section-body",
2027
+ "landing-section-description",
2028
+ "landing-section-eyebrow",
2029
+ "landing-section-header",
2030
+ "landing-section-title"
2031
+ ],
2032
+ "optionalPeers": [],
2033
+ "props": {
2034
+ "LandingSection": {
2035
+ "title": {
2036
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2037
+ "doc": "Título de la sección. No es el atributo HTML `title`."
2038
+ },
2039
+ "description": {
2040
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
2041
+ },
2042
+ "eyebrow": {
2043
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2044
+ "doc": "Sobre el título: la categoría o una Badge."
2045
+ },
2046
+ "actions": {
2047
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2048
+ "doc": "Una acción de la sección (ver todo, contactar)."
2049
+ },
2050
+ "align": {
2051
+ "type": "\"center\" | \"start\"",
2052
+ "values": [
2053
+ "center",
2054
+ "start"
2055
+ ]
2056
+ },
2057
+ "titleAs": {
2058
+ "type": "\"h2\" | \"h3\"",
2059
+ "values": [
2060
+ "h2",
2061
+ "h3"
2062
+ ],
2063
+ "doc": "h2 por defecto; h3 si la sección va dentro de otra."
2064
+ }
2065
+ }
2066
+ },
2067
+ "notes": [
2068
+ "Orden habitual de una portada: Hero → características (FeatureGrid) → prueba social (Testimonial) → precios (PricingTable) → preguntas frecuentes (Faq) → llamada final (CtaBanner). Quita lo que no aporte.",
2069
+ "Una idea por sección y un título que la diga; el antetítulo es la categoría («Precios»), no una frase.",
2070
+ "Centrada para presentar; `align=\"start\"` para bloques de lectura (preguntas frecuentes, texto largo)."
2071
+ ],
2072
+ "examples": [
2073
+ {
2074
+ "title": "Sección de características",
2075
+ "code": "<LandingSection eyebrow=\"Cómo funciona\" title=\"Todo lo que necesitas para empezar\" description=\"Sin instalar nada y en cinco minutos.\">\n <FeatureGrid>\n <Feature icon={<ZapIcon />} title=\"Rápido\" description=\"Respuestas en milisegundos.\" />\n </FeatureGrid>\n</LandingSection>"
2076
+ },
2077
+ {
2078
+ "title": "Alineada al inicio, con una acción",
2079
+ "code": "<LandingSection align=\"start\" title=\"Preguntas frecuentes\" actions={<Button variant=\"outline\">Contactar</Button>}>\n <Faq items={faqs} />\n</LandingSection>"
2080
+ }
2081
+ ]
2082
+ },
2083
+ "marker": {
2084
+ "import": "orbital-ds/ui/marker",
2085
+ "group": "content",
2086
+ "summary": "Rótulo discreto con icono opcional para anotar o separar contenido: nota breve en línea, fecha en un historial, «Hoy» entre mensajes, cabecera de grupo.",
2087
+ "see": [
2088
+ {
2089
+ "component": "separator",
2090
+ "when": "línea divisoria sin texto"
2091
+ },
2092
+ {
2093
+ "component": "eyebrow",
2094
+ "when": "etiqueta en versalitas encima de un título o una cifra"
2095
+ },
2096
+ {
2097
+ "component": "alert",
2098
+ "when": "aviso con tono que pide atención"
2099
+ }
2100
+ ],
2101
+ "exports": [
2102
+ "Marker",
2103
+ "MarkerContent",
2104
+ "MarkerIcon",
2105
+ "markerVariants"
2106
+ ],
2107
+ "slots": [
2108
+ "marker",
2109
+ "marker-content",
2110
+ "marker-icon"
2111
+ ],
2112
+ "optionalPeers": [],
2113
+ "props": {
2114
+ "Marker": {
2115
+ "variant": {
2116
+ "type": "\"default\" | \"separator\" | \"border\"",
2117
+ "values": [
2118
+ "default",
2119
+ "separator",
2120
+ "border"
2121
+ ]
2122
+ }
2123
+ }
2124
+ },
2125
+ "notes": [
2126
+ "`variant`: default (nota), separator (líneas a los lados, para fechas o «Hoy») y border (filete inferior, cabecera de grupo). Con `render` toma la etiqueta semántica (h3, li)."
2127
+ ],
2128
+ "examples": [
2129
+ {
2130
+ "title": "Separador con fecha",
2131
+ "code": "<Marker variant=\"separator\">\n <MarkerContent>Hoy</MarkerContent>\n</Marker>"
2132
+ },
2133
+ {
2134
+ "title": "Nota con icono",
2135
+ "code": "<Marker>\n <MarkerIcon>\n <LockIcon />\n </MarkerIcon>\n <MarkerContent>Solo los administradores ven esta sección.</MarkerContent>\n</Marker>"
2136
+ },
2137
+ {
2138
+ "title": "Como encabezado de grupo",
2139
+ "code": "<Marker variant=\"border\" render={<h3 />}>\n <MarkerContent>Tareas completadas</MarkerContent>\n</Marker>"
2140
+ }
2141
+ ]
2142
+ },
2143
+ "media-card": {
2144
+ "import": "orbital-ds/ui/media-card",
2145
+ "group": "content",
2146
+ "summary": "Tarjeta de rejilla con imagen protagonista (vídeo, curso, producto), título, metadato, insignia sobre la imagen y una acción central (reproducir).",
2147
+ "see": [
2148
+ {
2149
+ "component": "content-card",
2150
+ "when": "tarjeta por intención con portada (media, horizontal, cover) y más estructura"
2151
+ },
2152
+ {
2153
+ "component": "item",
2154
+ "when": "fila de una lista de entidades"
2155
+ },
2156
+ {
2157
+ "component": "card",
2158
+ "when": "tarjeta con anatomía libre"
2159
+ }
2160
+ ],
2161
+ "exports": [
2162
+ "MediaCard"
2163
+ ],
2164
+ "slots": [
2165
+ "media-card",
2166
+ "media-card-action",
2167
+ "media-card-badge",
2168
+ "media-card-body",
2169
+ "media-card-media",
2170
+ "media-card-meta",
2171
+ "media-card-title"
2172
+ ],
2173
+ "optionalPeers": [],
2174
+ "props": {
2175
+ "MediaCard": {
2176
+ "src": {
2177
+ "type": "string"
2178
+ },
2179
+ "alt": {
2180
+ "type": "string",
2181
+ "doc": "Texto alternativo de la imagen; vacío si es decorativa (por defecto)."
2182
+ },
2183
+ "title": {
2184
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2185
+ "required": true
2186
+ },
2187
+ "meta": {
2188
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
2189
+ },
2190
+ "badge": {
2191
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
2192
+ },
2193
+ "action": {
2194
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
2195
+ }
2196
+ }
2197
+ },
2198
+ "notes": [
2199
+ "Rejilla de contenidos (vídeos, cursos, productos); para filas de entidades usa Item variant=\"card\".",
2200
+ "Un solo `action` por tarjeta (reproducir/abrir); lleva su aria-label, que la tarjeta no lo pone."
2201
+ ],
2202
+ "examples": [
2203
+ {
2204
+ "title": "Vídeo con duración y reproducir",
2205
+ "code": "<MediaCard\n src={video.thumbnail}\n title=\"Primeros pasos\"\n meta=\"Curso · 12 lecciones\"\n badge=\"04:32\"\n action={<Button size=\"icon\" aria-label=\"Reproducir\"><PlayIcon /></Button>}\n/>"
2206
+ }
2207
+ ]
2208
+ },
2209
+ "mosaic": {
2210
+ "import": "orbital-ds/ui/mosaic",
2211
+ "group": "content",
2212
+ "summary": "Rejilla de tarjetas que sigue el ancho del contenedor, con presets de jerarquía (even, bento, trio, hero, showcase) para disponer ContentCard y similares.",
2213
+ "see": [
2214
+ {
2215
+ "component": "entity-list",
2216
+ "when": "lista o rejilla de entidades homogéneas del mismo tipo"
2217
+ },
2218
+ {
2219
+ "component": "content-card",
2220
+ "when": "la tarjeta que va en cada celda"
2221
+ },
2222
+ {
2223
+ "component": "carousel",
2224
+ "when": "recorrer tarjetas de una en una sin mostrarlas todas"
2225
+ }
2226
+ ],
2227
+ "exports": [
2228
+ "Mosaic",
2229
+ "MosaicItem",
2230
+ "type MosaicPreset"
2231
+ ],
2232
+ "slots": [
2233
+ "mosaic",
2234
+ "mosaic-item",
2235
+ "mosaic-root"
2236
+ ],
2237
+ "optionalPeers": [],
2238
+ "props": {
2239
+ "Mosaic": {
2240
+ "preset": {
2241
+ "type": "MosaicPreset",
2242
+ "values": [
2243
+ "even",
2244
+ "bento",
2245
+ "trio",
2246
+ "hero",
2247
+ "showcase"
2248
+ ]
2249
+ }
2250
+ },
2251
+ "MosaicItem": {
2252
+ "span": {
2253
+ "type": "1 | 2 | 4 | 3"
2254
+ },
2255
+ "rows": {
2256
+ "type": "1 | 2 | 3"
2257
+ },
2258
+ "tone": {
2259
+ "type": "\"default\" | \"brand\" | \"muted\"",
2260
+ "values": [
2261
+ "default",
2262
+ "brand",
2263
+ "muted"
2264
+ ],
2265
+ "doc": "Tono de la celda para alternar ritmo: `default` · `muted` (hundida) · `brand` (color de marca)."
2266
+ }
2267
+ }
2268
+ },
2269
+ "presets": {
2270
+ "values": [
2271
+ "even",
2272
+ "bento",
2273
+ "trio",
2274
+ "hero",
2275
+ "showcase"
2276
+ ],
2277
+ "default": "even",
2278
+ "intent": {
2279
+ "even": "columnas iguales (1 → 2 → 3), sin jerarquía",
2280
+ "bento": "4 columnas anchas; el primer hijo ocupa 2×2 (lo más importante, más grande)",
2281
+ "trio": "exactamente 3 en fila ancha, 1 en estrecho (tres capacidades, tres pasos)",
2282
+ "hero": "3 columnas; el primero ocupa 2×2 y a su lado una columna de pequeños (portada + resumen)",
2283
+ "showcase": "6 columnas; un grande 4×2, dos a su lado y el resto de a 2 (escaparate de producto)"
2284
+ }
2285
+ },
2286
+ "notes": [
2287
+ "Rejilla de tarjetas con jerarquía: `bento` para destacar lo primero, `trio` para tres iguales, `even` sin jerarquía. Si todo pesa lo mismo, usa `even` (o EntityList grid), no bento. Para spans manuales envuelve en MosaicItem.",
2288
+ "`hero` y `showcase` para portadas y escaparates; `MosaicItem tone` (`muted`, `brand`) alterna el ritmo: una celda de marca por rejilla, no más. Un solo destacado; celdas con gráficos (Sparkline, ChartCard glance) en 1×1 o 2×1, un mensaje por celda.",
2289
+ "El destacado va el primero del DOM (orden de lectura); no reordenes con CSS."
2290
+ ],
2291
+ "examples": [
2292
+ {
2293
+ "title": "Bento con destacado (el primero)",
2294
+ "code": "<Mosaic preset=\"bento\">\n <ContentCard preset=\"cover\" media={<img src=\"/otono.jpg\" alt=\"\" />} title=\"Novedades de otoño\" />\n <ContentCard preset=\"metric\" title=\"Clientes activos\" value=\"1.284\" />\n <ContentCard preset=\"feature\" icon={<ZapIcon />} title=\"Automatizaciones\" />\n</Mosaic>"
2295
+ },
2296
+ {
2297
+ "title": "Spans y tono a mano",
2298
+ "code": "<Mosaic preset=\"even\">\n <MosaicItem span={2}>\n <ContentCard title=\"Resumen\" />\n </MosaicItem>\n <MosaicItem tone=\"muted\">\n <ContentCard title=\"Ayuda\" />\n </MosaicItem>\n</Mosaic>"
2299
+ }
2300
+ ]
2301
+ },
2302
+ "panel": {
2303
+ "import": "orbital-ds/ui/panel",
2304
+ "group": "content",
2305
+ "summary": "Superficie simple con relleno uniforme para envolver contenido sin anatomía de tarjeta y sin ser clicable; `variant=\"glass\"` agrupa tarjetas o KPI.",
2306
+ "see": [
2307
+ {
2308
+ "component": "card",
2309
+ "when": "bloque con cabecera, contenido y pie"
2310
+ },
2311
+ {
2312
+ "component": "content-card",
2313
+ "when": "tarjeta lista por intención (feature, media, metric…)"
2314
+ },
2315
+ {
2316
+ "component": "scroll-area",
2317
+ "when": "zona con scroll propio para contenido largo"
2318
+ }
2319
+ ],
2320
+ "exports": [
2321
+ "Panel",
2322
+ "panelVariants"
2323
+ ],
2324
+ "slots": [
2325
+ "panel"
2326
+ ],
2327
+ "optionalPeers": [],
2328
+ "props": {
2329
+ "Panel": {
2330
+ "variant": {
2331
+ "type": "\"default\" | \"outline\" | \"ghost\" | \"glass\" | \"muted\"",
2332
+ "values": [
2333
+ "default",
2334
+ "outline",
2335
+ "ghost",
2336
+ "glass",
2337
+ "muted"
2338
+ ]
2339
+ },
2340
+ "size": {
2341
+ "type": "\"sm\" | \"lg\" | \"md\"",
2342
+ "values": [
2343
+ "sm",
2344
+ "lg",
2345
+ "md"
2346
+ ]
2347
+ }
2348
+ }
2349
+ },
2350
+ "notes": [
2351
+ "`variant=\"glass\"` es el envoltorio de cristal esmerilado y flotante para agrupar tarjetas o KPI (con `size` mayor y las tarjetas dentro, sin repetir el efecto). Se ajusta con --ds-panel-glass-bg/-border/-blur/-saturate/-shadow. Úsalo sobre un fondo con color o imagen: sobre blanco liso no se nota el cristal."
2352
+ ],
2353
+ "examples": [
2354
+ {
2355
+ "title": "Sección atenuada",
2356
+ "code": "<Panel variant=\"muted\" size=\"sm\" render={<section />}>\n <p>Los cambios se guardan automáticamente.</p>\n</Panel>"
2357
+ },
2358
+ {
2359
+ "title": "Cristal que agrupa KPI",
2360
+ "code": "<Panel variant=\"glass\" size=\"lg\">\n <ContentCard preset=\"metric\" title=\"Ingresos\" value=\"42.300 €\" />\n</Panel>"
2361
+ }
2362
+ ]
2363
+ },
2364
+ "pricing-table": {
2365
+ "import": "orbital-ds/ui/pricing-table",
2366
+ "group": "content",
2367
+ "summary": "Tabla de planes y precios de una web pública: cada plan con nombre, precio, periodo, lo que incluye y su botón; uno puede ir destacado.",
2368
+ "see": [
2369
+ {
2370
+ "component": "toggle-group",
2371
+ "when": "conmutar mensual/anual encima de la tabla"
2372
+ },
2373
+ {
2374
+ "component": "usage-meter",
2375
+ "when": "consumo frente a lo contratado DENTRO de la app, no la oferta"
2376
+ }
2377
+ ],
2378
+ "exports": [
2379
+ "PricingFeature",
2380
+ "PricingPlan",
2381
+ "PricingTable",
2382
+ "type PricingFeatureProps",
2383
+ "type PricingPlanProps"
2384
+ ],
2385
+ "slots": [
2386
+ "pricing-feature",
2387
+ "pricing-plan",
2388
+ "pricing-plan-action",
2389
+ "pricing-plan-features",
2390
+ "pricing-plan-header",
2391
+ "pricing-plan-name",
2392
+ "pricing-plan-period",
2393
+ "pricing-plan-price",
2394
+ "pricing-table"
2395
+ ],
2396
+ "optionalPeers": [],
2397
+ "props": {
2398
+ "PricingFeature": {
2399
+ "included": {
2400
+ "type": "boolean",
2401
+ "doc": "false: el plan NO lo incluye (se tacha en gris y se anuncia «No incluido»)."
2402
+ }
2403
+ },
2404
+ "PricingPlan": {
2405
+ "name": {
2406
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2407
+ "required": true,
2408
+ "doc": "Nombre del plan."
2409
+ },
2410
+ "price": {
2411
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2412
+ "required": true,
2413
+ "doc": "Precio ya formateado por la app («29 €», «A medida»)."
2414
+ },
2415
+ "period": {
2416
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2417
+ "doc": "Periodo junto al precio («/mes», «por usuario y mes»)."
2418
+ },
2419
+ "description": {
2420
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2421
+ "doc": "Para quién es, en una frase."
2422
+ },
2423
+ "badge": {
2424
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2425
+ "doc": "Distintivo junto al nombre («Más elegido»)."
2426
+ },
2427
+ "featured": {
2428
+ "type": "boolean",
2429
+ "doc": "Plan recomendado: filete de marca. Solo uno."
2430
+ },
2431
+ "action": {
2432
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2433
+ "doc": "Botón del plan (ancho completo)."
2434
+ },
2435
+ "footnote": {
2436
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2437
+ "doc": "Nota bajo el botón («Sin tarjeta», «IVA no incluido»)."
2438
+ }
2439
+ }
2440
+ },
2441
+ "notes": [
2442
+ "Entre 2 y 4 planes; destaca solo uno (`featured`) y dilo también con texto en `badge` («Más elegido»), no solo con color.",
2443
+ "Mismas filas en todos los planes y en el mismo orden, para comparar de un vistazo; lo que un plan no trae, con `included={false}`.",
2444
+ "Precio formateado por la app (moneda e impuestos de su mercado; `formatQuantity` de orbital-ds/lib/format si es una cifra). Mensual/anual con un ToggleGroup encima de la tabla."
2445
+ ],
2446
+ "examples": [
2447
+ {
2448
+ "title": "Tres planes con el del medio destacado",
2449
+ "code": "<PricingTable>\n <PricingPlan name=\"Básico\" price=\"0 €\" period=\"/mes\" description=\"Para probar.\" action={<Button variant=\"outline\" className=\"w-full\">Empezar</Button>}>\n <PricingFeature>1 proyecto</PricingFeature>\n <PricingFeature included={false}>Informes</PricingFeature>\n </PricingPlan>\n <PricingPlan featured badge={<Badge>Más elegido</Badge>} name=\"Pro\" price=\"29 €\" period=\"/mes\" action={<Button className=\"w-full\">Elegir Pro</Button>}>\n <PricingFeature>Proyectos ilimitados</PricingFeature>\n <PricingFeature>Informes</PricingFeature>\n </PricingPlan>\n</PricingTable>"
2450
+ }
2451
+ ]
2452
+ },
2453
+ "resizable": {
2454
+ "import": "orbital-ds/ui/resizable",
2455
+ "group": "content",
2456
+ "summary": "Paneles con separador arrastrable para que la persona reparta el espacio entre zonas de trabajo (bandeja y lectura, editor y resultados).",
2457
+ "see": [
2458
+ {
2459
+ "component": "sidebar",
2460
+ "when": "navegación lateral de la app (plegable, no redimensionable)"
2461
+ },
2462
+ {
2463
+ "component": "detail-panel",
2464
+ "when": "detalle de un elemento en un panel lateral, inferior o completo"
2465
+ },
2466
+ {
2467
+ "component": "sheet",
2468
+ "when": "panel lateral superpuesto que se abre y se cierra"
2469
+ }
2470
+ ],
2471
+ "exports": [
2472
+ "ResizableHandle",
2473
+ "ResizablePanel",
2474
+ "ResizablePanelGroup"
2475
+ ],
2476
+ "slots": [
2477
+ "resizable-handle",
2478
+ "resizable-handle-grip",
2479
+ "resizable-panel",
2480
+ "resizable-panel-group"
2481
+ ],
2482
+ "optionalPeers": [
2483
+ "react-resizable-panels"
2484
+ ],
2485
+ "props": {
2486
+ "ResizableHandle": {
2487
+ "withHandle": {
2488
+ "type": "boolean"
2489
+ }
2490
+ }
2491
+ },
2492
+ "notes": [
2493
+ "El grupo ocupa el alto de su contenedor: dale altura al padre. En móvil, apila las zonas o usa Sheet: arrastrar un separador en tacto es incómodo."
2494
+ ],
2495
+ "examples": [
2496
+ {
2497
+ "title": "Dos columnas con asa",
2498
+ "code": "<ResizablePanelGroup orientation=\"horizontal\">\n <ResizablePanel defaultSize=\"35%\" minSize=\"20%\">\n <InboxList />\n </ResizablePanel>\n <ResizableHandle withHandle />\n <ResizablePanel defaultSize=\"65%\" minSize=\"30%\">\n <Conversation />\n </ResizablePanel>\n</ResizablePanelGroup>"
2499
+ }
2500
+ ]
2501
+ },
2502
+ "reveal": {
2503
+ "import": "orbital-ds/ui/reveal",
2504
+ "group": "content",
2505
+ "summary": "Hace aparecer un bloque al entrar en pantalla con el scroll (fade, up, pop, slide) con CSS y el ritmo del tema; sin JS o con movimiento reducido, queda visible.",
2506
+ "see": [
2507
+ {
2508
+ "component": "motion-provider",
2509
+ "when": "animaciones con Motion (salidas, gestos, layout)"
2510
+ },
2511
+ {
2512
+ "component": "animated-number",
2513
+ "when": "una cifra que cuenta hasta su valor"
2514
+ }
2515
+ ],
2516
+ "exports": [
2517
+ "Reveal",
2518
+ "type RevealEffect"
2519
+ ],
2520
+ "slots": [
2521
+ "reveal"
2522
+ ],
2523
+ "optionalPeers": [],
2524
+ "props": {
2525
+ "Reveal": {
2526
+ "effect": {
2527
+ "type": "RevealEffect",
2528
+ "values": [
2529
+ "pop",
2530
+ "slide",
2531
+ "fade",
2532
+ "up"
2533
+ ]
2534
+ },
2535
+ "index": {
2536
+ "type": "number",
2537
+ "doc": "Posición en una lista: retrasa la entrada `index × --ds-motion-stagger`."
2538
+ },
2539
+ "once": {
2540
+ "type": "boolean"
2541
+ }
2542
+ }
2543
+ },
2544
+ "notes": [
2545
+ "Para tarjetas y bloques que quedan fuera de la primera pantalla; lo que ya se ve al cargar no necesita Reveal. En listas, `index` da la cascada; no lo uses en listas que se filtran o reordenan (reanimarían).",
2546
+ "Es CSS con IntersectionObserver: no necesita Motion. Para salidas, gestos o animar el layout, `useDsMotion()` con Motion."
2547
+ ],
2548
+ "examples": [
2549
+ {
2550
+ "title": "Tarjeta que sube al aparecer",
2551
+ "code": "<Reveal effect=\"up\">\n <ContentCard title=\"Integraciones\" description=\"Conecta tus herramientas\" />\n</Reveal>"
2552
+ },
2553
+ {
2554
+ "title": "Cascada en una lista",
2555
+ "code": "{features.map((f, i) => (\n <Reveal key={f.id} index={i}>\n <ContentCard title={f.title} />\n </Reveal>\n))}"
2556
+ }
2557
+ ]
2558
+ },
2559
+ "scroll-area": {
2560
+ "import": "orbital-ds/ui/scroll-area",
2561
+ "group": "content",
2562
+ "summary": "Zona con scroll propio y barras del tema para contenido que no cabe en un alto o ancho fijo (historial, lista larga dentro de un panel, fila horizontal).",
2563
+ "see": [
2564
+ {
2565
+ "component": "carousel",
2566
+ "when": "recorrer piezas paginadas con flechas"
2567
+ },
2568
+ {
2569
+ "component": "show-more",
2570
+ "when": "recortar un texto largo en lugar de darle scroll"
2571
+ },
2572
+ {
2573
+ "component": "resizable",
2574
+ "when": "repartir el espacio entre zonas arrastrando"
2575
+ }
2576
+ ],
2577
+ "exports": [
2578
+ "ScrollArea",
2579
+ "ScrollBar"
2580
+ ],
2581
+ "slots": [
2582
+ "scroll-area",
2583
+ "scroll-area-corner",
2584
+ "scroll-area-scrollbar",
2585
+ "scroll-area-thumb",
2586
+ "scroll-area-viewport"
2587
+ ],
2588
+ "optionalPeers": [],
2589
+ "notes": [
2590
+ "Dale altura (o ancho) al ScrollArea: sin límite no hay scroll. La barra horizontal se añade a mano con `<ScrollBar orientation=\"horizontal\" />`."
2591
+ ],
2592
+ "examples": [
2593
+ {
2594
+ "title": "Lista con alto fijo",
2595
+ "code": "<ScrollArea className=\"h-72\">\n <ItemGroup>\n {versions.map((v) => (\n <Item key={v.id} size=\"sm\">\n <ItemContent>\n <ItemTitle>{v.name}</ItemTitle>\n </ItemContent>\n </Item>\n ))}\n </ItemGroup>\n</ScrollArea>"
2596
+ },
2597
+ {
2598
+ "title": "Fila horizontal",
2599
+ "code": "<ScrollArea className=\"w-full whitespace-nowrap\">\n <div className=\"flex w-max gap-3\">\n {projects.map((p) => <ContentCard key={p.id} title={p.name} />)}\n </div>\n <ScrollBar orientation=\"horizontal\" />\n</ScrollArea>"
2600
+ }
2601
+ ]
2602
+ },
2603
+ "separator": {
2604
+ "import": "orbital-ds/ui/separator",
2605
+ "group": "content",
2606
+ "summary": "Línea divisoria fina, horizontal o vertical, para separar grupos de contenido o de acciones; decorativa para los lectores de pantalla.",
2607
+ "see": [
2608
+ {
2609
+ "component": "marker",
2610
+ "when": "separador con texto (fecha, «Hoy»)"
2611
+ },
2612
+ {
2613
+ "component": "item",
2614
+ "when": "ItemSeparator entre las filas de una lista"
2615
+ }
2616
+ ],
2617
+ "exports": [
2618
+ "Separator"
2619
+ ],
2620
+ "slots": [
2621
+ "separator"
2622
+ ],
2623
+ "optionalPeers": [],
2624
+ "notes": [
2625
+ "Antes de añadir un separador, prueba con espacio (gap): demasiadas líneas fragmentan la vista."
2626
+ ],
2627
+ "examples": [
2628
+ {
2629
+ "title": "Entre secciones",
2630
+ "code": "<Separator />"
2631
+ },
2632
+ {
2633
+ "title": "Vertical entre acciones",
2634
+ "code": "<div className=\"flex items-center gap-3\">\n <Button variant=\"link\" size=\"sm\">Editar</Button>\n <Separator orientation=\"vertical\" />\n <Button variant=\"link\" size=\"sm\">Duplicar</Button>\n</div>"
2635
+ }
2636
+ ]
2637
+ },
2638
+ "show-more": {
2639
+ "import": "orbital-ds/ui/show-more",
2640
+ "group": "content",
2641
+ "summary": "Recorta un texto largo a N líneas con «Ver más / Ver menos» y lo expande en el sitio; el botón solo aparece si de verdad hay recorte.",
2642
+ "see": [
2643
+ {
2644
+ "component": "collapsible",
2645
+ "when": "un bloque con más contenido (formulario, filtros) que se pliega con su disparador"
2646
+ },
2647
+ {
2648
+ "component": "accordion",
2649
+ "when": "varias secciones plegables con título"
2650
+ },
2651
+ {
2652
+ "component": "detail-panel",
2653
+ "when": "ver el detalle completo en un panel aparte"
2654
+ }
2655
+ ],
2656
+ "exports": [
2657
+ "ShowMore"
2658
+ ],
2659
+ "slots": [
2660
+ "show-more",
2661
+ "show-more-content",
2662
+ "show-more-toggle"
2663
+ ],
2664
+ "optionalPeers": [],
2665
+ "props": {
2666
+ "ShowMore": {
2667
+ "lines": {
2668
+ "type": "number"
2669
+ },
2670
+ "defaultExpanded": {
2671
+ "type": "boolean"
2672
+ },
2673
+ "onExpandedChange": {
2674
+ "type": "(expanded: boolean) => void"
2675
+ },
2676
+ "moreLabel": {
2677
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
2678
+ },
2679
+ "lessLabel": {
2680
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
2681
+ },
2682
+ "children": {
2683
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
2684
+ }
2685
+ }
2686
+ },
2687
+ "notes": [
2688
+ "Para descripciones, reseñas o notas largas dentro de una tarjeta: se recorta y se expande en el sitio. Si el texto cabe, no hay botón. Para un bloque que se pliega con más contenido (formularios, filtros) usa Collapsible."
2689
+ ],
2690
+ "examples": [
2691
+ {
2692
+ "title": "Descripción en una tarjeta",
2693
+ "code": "<ShowMore lines={3}>{product.description}</ShowMore>"
2694
+ },
2695
+ {
2696
+ "title": "Textos propios del botón",
2697
+ "code": "<ShowMore lines={2} moreLabel=\"Leer la reseña\" lessLabel=\"Ocultar\">\n {review.body}\n</ShowMore>"
2698
+ }
2699
+ ]
2700
+ },
2701
+ "testimonial": {
2702
+ "import": "orbital-ds/ui/testimonial",
2703
+ "group": "content",
2704
+ "summary": "Testimonio de un cliente (cita, autor, cargo y foto) para la prueba social de una web pública; suelto, destacado o en rejilla.",
2705
+ "see": [
2706
+ {
2707
+ "component": "feature-grid",
2708
+ "when": "ventajas del producto, no opiniones"
2709
+ },
2710
+ {
2711
+ "component": "avatar",
2712
+ "when": "solo la foto o las iniciales de una persona"
2713
+ }
2714
+ ],
2715
+ "exports": [
2716
+ "Testimonial",
2717
+ "TestimonialGrid",
2718
+ "type TestimonialGridProps",
2719
+ "type TestimonialProps"
2720
+ ],
2721
+ "slots": [
2722
+ "testimonial",
2723
+ "testimonial-author",
2724
+ "testimonial-grid",
2725
+ "testimonial-logo",
2726
+ "testimonial-name",
2727
+ "testimonial-quote",
2728
+ "testimonial-role"
2729
+ ],
2730
+ "optionalPeers": [],
2731
+ "props": {
2732
+ "Testimonial": {
2733
+ "quote": {
2734
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2735
+ "required": true,
2736
+ "doc": "La cita, sin comillas: las añade el CSS con las del idioma de la página (`open-quote`/`close-quote`)."
2737
+ },
2738
+ "author": {
2739
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2740
+ "required": true
2741
+ },
2742
+ "role": {
2743
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2744
+ "doc": "Cargo y empresa. No es el atributo ARIA `role`."
2745
+ },
2746
+ "avatar": {
2747
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2748
+ "doc": "Foto o iniciales (Avatar)."
2749
+ },
2750
+ "logo": {
2751
+ "type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
2752
+ "doc": "Logo de la empresa (un <img> con su alt)."
2753
+ },
2754
+ "size": {
2755
+ "type": "\"default\" | \"lg\"",
2756
+ "values": [
2757
+ "default",
2758
+ "lg"
2759
+ ]
2760
+ },
2761
+ "variant": {
2762
+ "type": "\"plain\" | \"card\"",
2763
+ "values": [
2764
+ "plain",
2765
+ "card"
2766
+ ],
2767
+ "doc": "Por defecto, `card` en tamaño normal y `plain` en el destacado."
2768
+ }
2769
+ },
2770
+ "TestimonialGrid": {
2771
+ "columns": {
2772
+ "type": "2 | 3"
2773
+ }
2774
+ }
2775
+ },
2776
+ "notes": [
2777
+ "Testimonios reales, con nombre, cargo y empresa (y foto o logo si hay permiso). Una cita anónima no prueba nada.",
2778
+ "Citas cortas (una o dos frases) que digan un resultado concreto; recorta, no inventes.",
2779
+ "Tres en rejilla o uno destacado (`size=\"lg\"`); nada de carruseles que giran solos."
2780
+ ],
2781
+ "examples": [
2782
+ {
2783
+ "title": "Rejilla de testimonios",
2784
+ "code": "<TestimonialGrid>\n <Testimonial quote=\"Cerramos el mes en la mitad de tiempo.\" author=\"Ana Ruiz\" role=\"Directora financiera, Norte\" avatar={<Avatar><AvatarFallback>AR</AvatarFallback></Avatar>} />\n <Testimonial quote=\"La implantación fue de una tarde.\" author=\"Luis Gil\" role=\"CTO, Ola\" />\n</TestimonialGrid>"
2785
+ },
2786
+ {
2787
+ "title": "Uno destacado",
2788
+ "code": "<Testimonial size=\"lg\" quote=\"Es la herramienta que usamos todos los días.\" author=\"Marta Sol\" role=\"Operaciones, Brisa\" />"
2789
+ }
2790
+ ]
2791
+ }
2792
+ }
2793
+ }