orbital-ds 0.44.1 → 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 (310) hide show
  1. package/AGENTS.md +29 -6
  2. package/CHANGELOG.md +458 -0
  3. package/README.md +2 -2
  4. package/components.manifest.json +209 -48
  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/i18n.js +3 -0
  12. package/dist/lib/locales/de.js +1 -0
  13. package/dist/lib/locales/fr.js +1 -0
  14. package/dist/lib/locales/he.js +1 -0
  15. package/dist/lib/locales/it.js +1 -0
  16. package/dist/ui/context-menu.js +2 -2
  17. package/dist/ui/cta-banner.js +63 -0
  18. package/dist/ui/detail-panel.js +2 -2
  19. package/dist/ui/faq.js +25 -0
  20. package/dist/ui/feature-grid.js +40 -0
  21. package/dist/ui/landing-section.js +59 -0
  22. package/dist/ui/pricing-table.js +86 -0
  23. package/dist/ui/sheet.js +1 -1
  24. package/dist/ui/testimonial.js +61 -0
  25. package/docs/designer/patrones.md +7 -2
  26. package/manifest/actions.json +1 -1
  27. package/manifest/agents.json +1 -1
  28. package/manifest/ai.json +1 -1
  29. package/manifest/auth.json +1 -1
  30. package/manifest/chat.json +1 -1
  31. package/manifest/content.json +496 -1
  32. package/manifest/data.json +1 -103
  33. package/manifest/feedback.json +6 -6
  34. package/manifest/forms.json +1 -1
  35. package/manifest/motion.json +3 -3
  36. package/manifest/navigation.json +3 -3
  37. package/manifest/overlays.json +14 -11
  38. package/package.json +6 -8
  39. package/scripts/cli.mjs +19 -0
  40. package/scripts/doctor.mjs +28 -2
  41. package/scripts/eslint-plugin.mjs +32 -0
  42. package/scripts/manifest.mjs +20 -0
  43. package/scripts/upgrade.mjs +126 -0
  44. package/dist/auth-form-B1hgbXkI.d.ts +0 -144
  45. package/dist/hooks/use-ds-messages.d.ts +0 -544
  46. package/dist/hooks/use-ds-motion.d.ts +0 -17
  47. package/dist/hooks/use-in-view.d.ts +0 -9
  48. package/dist/hooks/use-mobile.d.ts +0 -3
  49. package/dist/lib/a2ui-catalog.d.ts +0 -42
  50. package/dist/lib/a2ui.d.ts +0 -289
  51. package/dist/lib/ai-events.d.ts +0 -15
  52. package/dist/lib/auth-better-auth.d.ts +0 -29
  53. package/dist/lib/auth-flow.d.ts +0 -85
  54. package/dist/lib/auth-providers.d.ts +0 -194
  55. package/dist/lib/auth.d.ts +0 -68
  56. package/dist/lib/echarts-presets.d.ts +0 -227
  57. package/dist/lib/echarts-server.d.ts +0 -15
  58. package/dist/lib/echarts-setup.d.ts +0 -8
  59. package/dist/lib/echarts-theme.d.ts +0 -36
  60. package/dist/lib/format.d.ts +0 -57
  61. package/dist/lib/header-control.d.ts +0 -4
  62. package/dist/lib/i18n.d.ts +0 -557
  63. package/dist/lib/image-upload.d.ts +0 -41
  64. package/dist/lib/locales/de.d.ts +0 -7
  65. package/dist/lib/locales/fr.d.ts +0 -7
  66. package/dist/lib/locales/he.d.ts +0 -7
  67. package/dist/lib/locales/it.d.ts +0 -7
  68. package/dist/lib/motion.d.ts +0 -74
  69. package/dist/lib/presets.d.ts +0 -8
  70. package/dist/lib/template-syntax.d.ts +0 -22
  71. package/dist/lib/utils.d.ts +0 -5
  72. package/dist/motion.css +0 -146
  73. package/dist/styles.css +0 -1775
  74. package/dist/themes/chocolate.css +0 -259
  75. package/dist/themes/chocolate.fonts.css +0 -2
  76. package/dist/themes/chocolate.guide.md +0 -30
  77. package/dist/themes/chocolate.meta.json +0 -61
  78. package/dist/themes/chocolate.scoped.css +0 -259
  79. package/dist/themes/chocolate.tokens.json +0 -49
  80. package/dist/themes/fractalia.css +0 -556
  81. package/dist/themes/fractalia.fonts.css +0 -3
  82. package/dist/themes/fractalia.guide.md +0 -86
  83. package/dist/themes/fractalia.meta.json +0 -112
  84. package/dist/themes/fractalia.scoped.css +0 -556
  85. package/dist/themes/fractalia.tokens.json +0 -39
  86. package/dist/themes/friendly.css +0 -375
  87. package/dist/themes/friendly.fonts.css +0 -2
  88. package/dist/themes/friendly.guide.md +0 -38
  89. package/dist/themes/friendly.meta.json +0 -82
  90. package/dist/themes/friendly.scoped.css +0 -375
  91. package/dist/themes/friendly.tokens.json +0 -45
  92. package/dist/themes/lagoon.css +0 -362
  93. package/dist/themes/lagoon.fonts.css +0 -2
  94. package/dist/themes/lagoon.guide.md +0 -47
  95. package/dist/themes/lagoon.meta.json +0 -85
  96. package/dist/themes/lagoon.scoped.css +0 -362
  97. package/dist/themes/lagoon.tokens.json +0 -49
  98. package/dist/themes/liquid.css +0 -510
  99. package/dist/themes/liquid.fonts.css +0 -7
  100. package/dist/themes/liquid.guide.md +0 -82
  101. package/dist/themes/liquid.meta.json +0 -134
  102. package/dist/themes/liquid.scoped.css +0 -510
  103. package/dist/themes/liquid.tokens.json +0 -47
  104. package/dist/themes/matcha.css +0 -259
  105. package/dist/themes/matcha.fonts.css +0 -2
  106. package/dist/themes/matcha.guide.md +0 -30
  107. package/dist/themes/matcha.meta.json +0 -61
  108. package/dist/themes/matcha.scoped.css +0 -259
  109. package/dist/themes/matcha.tokens.json +0 -49
  110. package/dist/themes/qratia.css +0 -264
  111. package/dist/themes/qratia.fonts.css +0 -2
  112. package/dist/themes/qratia.guide.md +0 -34
  113. package/dist/themes/qratia.meta.json +0 -49
  114. package/dist/themes/qratia.scoped.css +0 -264
  115. package/dist/themes/qratia.tokens.json +0 -49
  116. package/dist/themes/stone.css +0 -263
  117. package/dist/themes/stone.fonts.css +0 -2
  118. package/dist/themes/stone.guide.md +0 -30
  119. package/dist/themes/stone.meta.json +0 -47
  120. package/dist/themes/stone.scoped.css +0 -263
  121. package/dist/themes/stone.tokens.json +0 -49
  122. package/dist/themes/tactile.css +0 -596
  123. package/dist/themes/tactile.fonts.css +0 -3
  124. package/dist/themes/tactile.guide.md +0 -82
  125. package/dist/themes/tactile.meta.json +0 -182
  126. package/dist/themes/tactile.scoped.css +0 -596
  127. package/dist/themes/tactile.tokens.json +0 -42
  128. package/dist/themes/twitter.css +0 -364
  129. package/dist/themes/twitter.fonts.css +0 -6
  130. package/dist/themes/twitter.guide.md +0 -35
  131. package/dist/themes/twitter.meta.json +0 -90
  132. package/dist/themes/twitter.scoped.css +0 -364
  133. package/dist/themes/twitter.tokens.json +0 -45
  134. package/dist/themes/y2k.css +0 -259
  135. package/dist/themes/y2k.fonts.css +0 -2
  136. package/dist/themes/y2k.guide.md +0 -30
  137. package/dist/themes/y2k.meta.json +0 -59
  138. package/dist/themes/y2k.scoped.css +0 -259
  139. package/dist/themes/y2k.tokens.json +0 -49
  140. package/dist/themes/zyro.css +0 -442
  141. package/dist/themes/zyro.fonts.css +0 -2
  142. package/dist/themes/zyro.guide.md +0 -33
  143. package/dist/themes/zyro.meta.json +0 -74
  144. package/dist/themes/zyro.scoped.css +0 -442
  145. package/dist/themes/zyro.tokens.json +0 -46
  146. package/dist/ui/a2ui-renderer.d.ts +0 -44
  147. package/dist/ui/accordion.d.ts +0 -9
  148. package/dist/ui/agent-events.d.ts +0 -49
  149. package/dist/ui/ai-tag.d.ts +0 -24
  150. package/dist/ui/alert-dialog.d.ts +0 -60
  151. package/dist/ui/alert.d.ts +0 -13
  152. package/dist/ui/animated-number.d.ts +0 -20
  153. package/dist/ui/app-bar.d.ts +0 -32
  154. package/dist/ui/aspect-ratio.d.ts +0 -7
  155. package/dist/ui/attachment.d.ts +0 -26
  156. package/dist/ui/auth-backdrop.d.ts +0 -37
  157. package/dist/ui/auth-form.d.ts +0 -4
  158. package/dist/ui/auth-layout.d.ts +0 -110
  159. package/dist/ui/auth-parts.d.ts +0 -43
  160. package/dist/ui/auth-status.d.ts +0 -23
  161. package/dist/ui/avatar.d.ts +0 -43
  162. package/dist/ui/ayuda.d.ts +0 -22
  163. package/dist/ui/badge.d.ts +0 -15
  164. package/dist/ui/banner.d.ts +0 -14
  165. package/dist/ui/bottom-nav.d.ts +0 -37
  166. package/dist/ui/breadcrumb.d.ts +0 -34
  167. package/dist/ui/bubble.d.ts +0 -19
  168. package/dist/ui/button-group.d.ts +0 -15
  169. package/dist/ui/button.d.ts +0 -14
  170. package/dist/ui/calendar.d.ts +0 -28
  171. package/dist/ui/card-stack.d.ts +0 -36
  172. package/dist/ui/card.d.ts +0 -61
  173. package/dist/ui/carousel.d.ts +0 -68
  174. package/dist/ui/chain-of-thought.d.ts +0 -34
  175. package/dist/ui/chart-card.d.ts +0 -47
  176. package/dist/ui/chart.d.ts +0 -65
  177. package/dist/ui/chart.js +0 -254
  178. package/dist/ui/chat-composer.d.ts +0 -58
  179. package/dist/ui/checkbox.d.ts +0 -6
  180. package/dist/ui/choice-card.d.ts +0 -49
  181. package/dist/ui/code-block.d.ts +0 -29
  182. package/dist/ui/collapsible.d.ts +0 -8
  183. package/dist/ui/combobox.d.ts +0 -74
  184. package/dist/ui/command-palette.d.ts +0 -54
  185. package/dist/ui/command.d.ts +0 -56
  186. package/dist/ui/confirm-action.d.ts +0 -48
  187. package/dist/ui/confirm-dialog.d.ts +0 -44
  188. package/dist/ui/connected-accounts.d.ts +0 -25
  189. package/dist/ui/content-card.d.ts +0 -66
  190. package/dist/ui/context-menu.d.ts +0 -66
  191. package/dist/ui/conversation-list.d.ts +0 -44
  192. package/dist/ui/copy-button.d.ts +0 -25
  193. package/dist/ui/data-table.d.ts +0 -198
  194. package/dist/ui/date-picker.d.ts +0 -65
  195. package/dist/ui/date-time.d.ts +0 -40
  196. package/dist/ui/description-list.d.ts +0 -49
  197. package/dist/ui/detail-panel.d.ts +0 -38
  198. package/dist/ui/dialog.d.ts +0 -54
  199. package/dist/ui/direction.d.ts +0 -1
  200. package/dist/ui/dock.d.ts +0 -30
  201. package/dist/ui/drawer.d.ts +0 -59
  202. package/dist/ui/dropdown-menu.d.ts +0 -63
  203. package/dist/ui/dropzone.d.ts +0 -44
  204. package/dist/ui/echart.d.ts +0 -46
  205. package/dist/ui/empty-state.d.ts +0 -26
  206. package/dist/ui/empty.d.ts +0 -15
  207. package/dist/ui/entity-list.d.ts +0 -57
  208. package/dist/ui/error-page.d.ts +0 -28
  209. package/dist/ui/error-state.d.ts +0 -16
  210. package/dist/ui/eyebrow.d.ts +0 -7
  211. package/dist/ui/field.d.ts +0 -28
  212. package/dist/ui/file-upload.d.ts +0 -42
  213. package/dist/ui/filter-bar.d.ts +0 -38
  214. package/dist/ui/form-layout.d.ts +0 -43
  215. package/dist/ui/gauge.d.ts +0 -66
  216. package/dist/ui/generated-image.d.ts +0 -33
  217. package/dist/ui/generated-table.d.ts +0 -29
  218. package/dist/ui/heatmap-grid.d.ts +0 -59
  219. package/dist/ui/hero.d.ts +0 -58
  220. package/dist/ui/hover-card.d.ts +0 -8
  221. package/dist/ui/i18n-provider.d.ts +0 -27
  222. package/dist/ui/icon-tile.d.ts +0 -11
  223. package/dist/ui/input-group.d.ts +0 -22
  224. package/dist/ui/input-otp.d.ts +0 -36
  225. package/dist/ui/input.d.ts +0 -21
  226. package/dist/ui/instruction-editor.d.ts +0 -81
  227. package/dist/ui/item.d.ts +0 -26
  228. package/dist/ui/kbd.d.ts +0 -6
  229. package/dist/ui/label.d.ts +0 -22
  230. package/dist/ui/legend.d.ts +0 -57
  231. package/dist/ui/level-meter.d.ts +0 -28
  232. package/dist/ui/load-more.d.ts +0 -36
  233. package/dist/ui/loading-state.d.ts +0 -26
  234. package/dist/ui/locale-switcher.d.ts +0 -19
  235. package/dist/ui/markdown.d.ts +0 -29
  236. package/dist/ui/marker.d.ts +0 -13
  237. package/dist/ui/media-card.d.ts +0 -29
  238. package/dist/ui/menubar.d.ts +0 -70
  239. package/dist/ui/message-actions.d.ts +0 -21
  240. package/dist/ui/message-scroller.d.ts +0 -46
  241. package/dist/ui/message.d.ts +0 -45
  242. package/dist/ui/mfa-challenge.d.ts +0 -4
  243. package/dist/ui/mfa-setup.d.ts +0 -29
  244. package/dist/ui/mosaic.d.ts +0 -38
  245. package/dist/ui/motion-provider.d.ts +0 -28
  246. package/dist/ui/native-select.d.ts +0 -32
  247. package/dist/ui/navigation-menu.d.ts +0 -15
  248. package/dist/ui/next-step-card.d.ts +0 -55
  249. package/dist/ui/notice-review.d.ts +0 -64
  250. package/dist/ui/notifications.d.ts +0 -81
  251. package/dist/ui/oauth-consent.d.ts +0 -54
  252. package/dist/ui/page-header.d.ts +0 -64
  253. package/dist/ui/page-loader.d.ts +0 -40
  254. package/dist/ui/page-shell.d.ts +0 -25
  255. package/dist/ui/pagination.d.ts +0 -42
  256. package/dist/ui/panel.d.ts +0 -12
  257. package/dist/ui/passkey-list.d.ts +0 -17
  258. package/dist/ui/password-input.d.ts +0 -5
  259. package/dist/ui/password-strength.d.ts +0 -28
  260. package/dist/ui/popover.d.ts +0 -44
  261. package/dist/ui/progress.d.ts +0 -9
  262. package/dist/ui/proportion-bar.d.ts +0 -52
  263. package/dist/ui/quantity.d.ts +0 -25
  264. package/dist/ui/questionnaire.d.ts +0 -62
  265. package/dist/ui/radio-group.d.ts +0 -8
  266. package/dist/ui/reasoning.d.ts +0 -24
  267. package/dist/ui/resizable.d.ts +0 -10
  268. package/dist/ui/reveal.d.ts +0 -28
  269. package/dist/ui/scroll-area.d.ts +0 -7
  270. package/dist/ui/search-box.d.ts +0 -32
  271. package/dist/ui/select.d.ts +0 -19
  272. package/dist/ui/separator.d.ts +0 -6
  273. package/dist/ui/session-list.d.ts +0 -19
  274. package/dist/ui/session-timeout.d.ts +0 -13
  275. package/dist/ui/sheet.d.ts +0 -53
  276. package/dist/ui/shield.d.ts +0 -35
  277. package/dist/ui/show-more.d.ts +0 -26
  278. package/dist/ui/sidebar.d.ts +0 -92
  279. package/dist/ui/sign-out-dialog.d.ts +0 -17
  280. package/dist/ui/skeleton.d.ts +0 -10
  281. package/dist/ui/slider.d.ts +0 -23
  282. package/dist/ui/sonner.d.ts +0 -6
  283. package/dist/ui/sparkline.d.ts +0 -26
  284. package/dist/ui/spinner.d.ts +0 -5
  285. package/dist/ui/stat-group.d.ts +0 -40
  286. package/dist/ui/stat.d.ts +0 -90
  287. package/dist/ui/status-badge.d.ts +0 -39
  288. package/dist/ui/status-hero.d.ts +0 -30
  289. package/dist/ui/step-dots.d.ts +0 -22
  290. package/dist/ui/step-flow.d.ts +0 -48
  291. package/dist/ui/step-ring.d.ts +0 -26
  292. package/dist/ui/stepper.d.ts +0 -20
  293. package/dist/ui/suggestions.d.ts +0 -17
  294. package/dist/ui/switch.d.ts +0 -8
  295. package/dist/ui/table.d.ts +0 -38
  296. package/dist/ui/tabs.d.ts +0 -14
  297. package/dist/ui/tag-input.d.ts +0 -21
  298. package/dist/ui/task-loader.d.ts +0 -29
  299. package/dist/ui/task-progress.d.ts +0 -32
  300. package/dist/ui/textarea.d.ts +0 -32
  301. package/dist/ui/theme-toggle.d.ts +0 -14
  302. package/dist/ui/timeline.d.ts +0 -55
  303. package/dist/ui/toast.d.ts +0 -19
  304. package/dist/ui/toggle-group.d.ts +0 -38
  305. package/dist/ui/toggle.d.ts +0 -12
  306. package/dist/ui/tool-call.d.ts +0 -27
  307. package/dist/ui/tooltip.d.ts +0 -9
  308. package/dist/ui/usage-meter.d.ts +0 -42
  309. package/dist/ui/week-strip.d.ts +0 -23
  310. package/dist/ui/workflow-run.d.ts +0 -51
@@ -0,0 +1,61 @@
1
+ import { jsx, jsxs } from "react/jsx-runtime";
2
+ import { cn } from "../lib/utils.js";
3
+ function Testimonial({ quote, author, role, avatar, logo, size = "default", variant, className, ...props }) {
4
+ const v = variant ?? (size === "lg" ? "plain" : "card");
5
+ const lg = size === "lg";
6
+ return /* @__PURE__ */ jsxs(
7
+ "figure",
8
+ {
9
+ "data-slot": "testimonial",
10
+ "data-size": size,
11
+ "data-variant": v,
12
+ className: cn(
13
+ "flex min-w-0 flex-col gap-(--ds-card-spacing) text-sm",
14
+ v === "card" && "rounded-card border bg-card p-(--ds-card-spacing) text-card-foreground shadow-card",
15
+ lg && "mx-auto max-w-(--ds-landing-measure) items-center text-center",
16
+ className
17
+ ),
18
+ ...props,
19
+ children: [
20
+ logo != null ? /* @__PURE__ */ jsx("div", { "data-slot": "testimonial-logo", className: "flex h-8 items-center [&>img]:h-full [&>img]:w-auto", children: logo }) : null,
21
+ /* @__PURE__ */ jsx(
22
+ "blockquote",
23
+ {
24
+ "data-slot": "testimonial-quote",
25
+ className: cn(
26
+ "text-pretty",
27
+ lg ? "text-(length:--ds-testimonial-quote-size-lg) leading-snug font-(--ds-heading-weight) tracking-(--ds-heading-tracking)" : "text-(length:--ds-testimonial-quote-size)",
28
+ "before:content-[open-quote] after:content-[close-quote]"
29
+ ),
30
+ children: quote
31
+ }
32
+ ),
33
+ /* @__PURE__ */ jsxs("figcaption", { "data-slot": "testimonial-author", className: cn("mt-auto flex items-center gap-3", lg && "justify-center"), children: [
34
+ avatar,
35
+ /* @__PURE__ */ jsxs("div", { className: cn("flex min-w-0 flex-col", lg ? "items-center" : "items-start"), children: [
36
+ /* @__PURE__ */ jsx("span", { "data-slot": "testimonial-name", className: "font-(--ds-medium-weight)", children: author }),
37
+ role != null ? /* @__PURE__ */ jsx("span", { "data-slot": "testimonial-role", className: "text-muted-foreground", children: role }) : null
38
+ ] })
39
+ ] })
40
+ ]
41
+ }
42
+ );
43
+ }
44
+ function TestimonialGrid({ columns = 3, className, ...props }) {
45
+ return /* @__PURE__ */ jsx("div", { className: "@container/testimonials w-full", children: /* @__PURE__ */ jsx(
46
+ "div",
47
+ {
48
+ "data-slot": "testimonial-grid",
49
+ className: cn(
50
+ "grid grid-cols-1 gap-(--ds-landing-grid-gap) @2xl/testimonials:grid-cols-2",
51
+ columns === 3 && "@5xl/testimonials:grid-cols-3",
52
+ className
53
+ ),
54
+ ...props
55
+ }
56
+ ) });
57
+ }
58
+ export {
59
+ Testimonial,
60
+ TestimonialGrid
61
+ };
@@ -163,8 +163,13 @@ Formato: **cuándo** · **piezas** · **reglas** · **evita**.
163
163
  módulo, alineada al inicio y con menos aire). `eyebrow` para una `Badge` de novedad; `footer` para la tira de
164
164
  cifras (`StatGroup preset="strip"`) o de logos; `animated` para la entrada en cascada con el ritmo del tema.
165
165
  - **Contenido:** un título que dice el beneficio en una frase (no el nombre del producto), una o dos frases de apoyo y,
166
- como mucho, **dos acciones** (principal + secundaria `outline`). Debajo, el resto de la página en `Mosaic` o
167
- `ContentCard` con `Reveal`.
166
+ como mucho, **dos acciones** (principal + secundaria `outline`).
167
+ - **El resto de una web pública** (debajo del hero), cada bloque dentro de un `LandingSection` (antetítulo, título,
168
+ texto; mismo ancho y ritmo): `FeatureGrid` + `Feature` (qué hace, 3–6 ventajas) → `Testimonial`/`TestimonialGrid`
169
+ (prueba social real, con nombre y cargo) → `PricingTable` + `PricingPlan` + `PricingFeature` (2–4 planes, uno
170
+ `featured` con su `badge` en texto; mensual/anual con `ToggleGroup`) → `Faq` (4–8 preguntas; `structuredData` para
171
+ buscadores) → `CtaBanner` (la acción principal otra vez, al pie). Contenido libre: `Mosaic` o `ContentCard` con
172
+ `Reveal`. Quita lo que no aporte; no hace falta usarlos todos.
168
173
  - **Reglas:** un hero por página y arriba del todo; `titleAs="h2"` si la vista ya tiene su h1. El diseño sigue el
169
174
  ancho del contenedor, no la pantalla. Medidas y escala en `--ds-hero-*` (la marca las ajusta en `brand.css`).
170
175
  - **Evita:** carruseles en la portada, más de dos botones, texto directamente sobre una foto sin placa, títulos con
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.44.1",
3
+ "version": "0.48.0",
4
4
  "group": "actions",
5
5
  "about": "Botones y acciones sueltas.",
6
6
  "components": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.44.1",
3
+ "version": "0.48.0",
4
4
  "group": "agents",
5
5
  "about": "Lo que hace un agente: razonamiento, herramientas, eventos, flujos y A2UI.",
6
6
  "components": {
package/manifest/ai.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.44.1",
3
+ "version": "0.48.0",
4
4
  "group": "ai",
5
5
  "about": "Piezas de contenido generado.",
6
6
  "components": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.44.1",
3
+ "version": "0.48.0",
4
4
  "group": "auth",
5
5
  "about": "Inicio de sesión, MFA, passkeys, sesiones y consentimiento.",
6
6
  "components": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.44.1",
3
+ "version": "0.48.0",
4
4
  "group": "chat",
5
5
  "about": "Conversación: mensajes, compositor, adjuntos y sugerencias.",
6
6
  "components": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.44.1",
3
+ "version": "0.48.0",
4
4
  "group": "content",
5
5
  "about": "Tarjetas, texto, media y piezas de maquetación.",
6
6
  "components": {
@@ -1000,6 +1000,100 @@
1000
1000
  }
1001
1001
  ]
1002
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
+ },
1003
1097
  "direction": {
1004
1098
  "import": "orbital-ds/ui/direction",
1005
1099
  "group": "content",
@@ -1367,6 +1461,149 @@
1367
1461
  }
1368
1462
  ]
1369
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
+ },
1370
1607
  "hero": {
1371
1608
  "import": "orbital-ds/ui/hero",
1372
1609
  "group": "content",
@@ -1765,6 +2002,84 @@
1765
2002
  }
1766
2003
  ]
1767
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
+ },
1768
2083
  "marker": {
1769
2084
  "import": "orbital-ds/ui/marker",
1770
2085
  "group": "content",
@@ -2046,6 +2361,95 @@
2046
2361
  }
2047
2362
  ]
2048
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
+ },
2049
2453
  "resizable": {
2050
2454
  "import": "orbital-ds/ui/resizable",
2051
2455
  "group": "content",
@@ -2293,6 +2697,97 @@
2293
2697
  "code": "<ShowMore lines={2} moreLabel=\"Leer la reseña\" lessLabel=\"Ocultar\">\n {review.body}\n</ShowMore>"
2294
2698
  }
2295
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
+ ]
2296
2791
  }
2297
2792
  }
2298
2793
  }