orbital-ds 0.44.1 → 0.50.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 (102) hide show
  1. package/AGENTS.md +42 -10
  2. package/CHANGELOG.md +489 -0
  3. package/README.md +2 -2
  4. package/components.manifest.json +590 -83
  5. package/dist/hooks/use-ds-messages.d.ts +54 -0
  6. package/dist/hooks/use-esc-close-stack.d.ts +3 -0
  7. package/dist/hooks/use-esc-close-stack.js +38 -0
  8. package/dist/hooks/use-simulated-progress.d.ts +11 -0
  9. package/dist/hooks/use-simulated-progress.js +30 -0
  10. package/dist/lib/brand-allowlist.d.ts +3 -0
  11. package/dist/lib/brand-allowlist.js +719 -0
  12. package/dist/lib/brand-runtime.d.ts +52 -0
  13. package/dist/lib/brand-runtime.js +85 -0
  14. package/dist/lib/echarts-presets.d.ts +81 -1
  15. package/dist/lib/echarts-presets.js +152 -1
  16. package/dist/lib/echarts-setup.js +2 -0
  17. package/dist/lib/i18n.d.ts +54 -0
  18. package/dist/lib/i18n.js +165 -3
  19. package/dist/lib/locales/de.js +55 -1
  20. package/dist/lib/locales/fr.js +55 -1
  21. package/dist/lib/locales/he.js +55 -1
  22. package/dist/lib/locales/it.js +55 -1
  23. package/dist/styles.css +44 -0
  24. package/dist/themes/tactile.css +1 -6
  25. package/dist/themes/tactile.scoped.css +1 -6
  26. package/dist/ui/alert.d.ts +1 -1
  27. package/dist/ui/api-key-list.d.ts +40 -0
  28. package/dist/ui/api-key-list.js +89 -0
  29. package/dist/ui/attachment.d.ts +3 -3
  30. package/dist/ui/audit-log.d.ts +53 -0
  31. package/dist/ui/audit-log.js +102 -0
  32. package/dist/ui/banner.d.ts +1 -1
  33. package/dist/ui/bubble.d.ts +1 -1
  34. package/dist/ui/button-group.d.ts +1 -1
  35. package/dist/ui/button.d.ts +2 -2
  36. package/dist/ui/chart-card.d.ts +0 -1
  37. package/dist/ui/context-menu.js +2 -2
  38. package/dist/ui/cta-banner.d.ts +30 -0
  39. package/dist/ui/cta-banner.js +63 -0
  40. package/dist/ui/detail-panel.d.ts +3 -1
  41. package/dist/ui/detail-panel.js +2 -2
  42. package/dist/ui/faq.d.ts +34 -0
  43. package/dist/ui/faq.js +25 -0
  44. package/dist/ui/feature-grid.d.ts +40 -0
  45. package/dist/ui/feature-grid.js +40 -0
  46. package/dist/ui/field.d.ts +1 -1
  47. package/dist/ui/input-group.d.ts +1 -1
  48. package/dist/ui/item.d.ts +3 -3
  49. package/dist/ui/landing-section.d.ts +34 -0
  50. package/dist/ui/landing-section.js +59 -0
  51. package/dist/ui/marker.d.ts +1 -1
  52. package/dist/ui/member-list.d.ts +43 -0
  53. package/dist/ui/member-list.js +107 -0
  54. package/dist/ui/onboarding-checklist.d.ts +38 -0
  55. package/dist/ui/onboarding-checklist.js +132 -0
  56. package/dist/ui/panel.d.ts +2 -2
  57. package/dist/ui/permission-matrix.d.ts +35 -0
  58. package/dist/ui/permission-matrix.js +89 -0
  59. package/dist/ui/plan-summary.d.ts +59 -0
  60. package/dist/ui/plan-summary.js +92 -0
  61. package/dist/ui/popover.d.ts +1 -1
  62. package/dist/ui/pricing-table.d.ts +29 -0
  63. package/dist/ui/pricing-table.js +86 -0
  64. package/dist/ui/sheet.d.ts +2 -2
  65. package/dist/ui/sheet.js +1 -1
  66. package/dist/ui/sidebar.d.ts +1 -1
  67. package/dist/ui/sparkline.d.ts +1 -1
  68. package/dist/ui/status-badge.d.ts +2 -2
  69. package/dist/ui/tabs.d.ts +1 -1
  70. package/dist/ui/testimonial.d.ts +37 -0
  71. package/dist/ui/testimonial.js +61 -0
  72. package/dist/ui/toggle.d.ts +1 -1
  73. package/dist/ui/upgrade-prompt.d.ts +24 -0
  74. package/dist/ui/upgrade-prompt.js +85 -0
  75. package/dist/ui/workspace-switcher.d.ts +28 -0
  76. package/dist/ui/workspace-switcher.js +92 -0
  77. package/docs/GRAFICOS.md +1 -1
  78. package/docs/designer/patrones.md +36 -3
  79. package/manifest/actions.json +1 -1
  80. package/manifest/agents.json +1 -1
  81. package/manifest/ai.json +1 -1
  82. package/manifest/auth.json +1 -1
  83. package/manifest/chat.json +1 -1
  84. package/manifest/content.json +496 -1
  85. package/manifest/data.json +498 -103
  86. package/manifest/feedback.json +234 -47
  87. package/manifest/forms.json +1 -1
  88. package/manifest/motion.json +3 -3
  89. package/manifest/navigation.json +104 -3
  90. package/manifest/overlays.json +15 -12
  91. package/package.json +6 -18
  92. package/scripts/cli.mjs +82 -5
  93. package/scripts/doctor.mjs +32 -4
  94. package/scripts/eslint-plugin.mjs +32 -0
  95. package/scripts/manifest.mjs +20 -0
  96. package/scripts/skill.mjs +85 -0
  97. package/scripts/upgrade.mjs +126 -0
  98. package/skill/SKILL.md +5 -2
  99. package/dist/ui/chart.d.ts +0 -65
  100. package/dist/ui/chart.js +0 -254
  101. package/dist/ui/sonner.d.ts +0 -6
  102. package/dist/ui/sonner.js +0 -60
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.44.1",
3
+ "version": "0.50.0",
4
4
  "engine": "@base-ui/react",
5
5
  "groups": {
6
6
  "actions": "Botones y acciones sueltas.",
@@ -290,6 +290,54 @@
290
290
  "Pasa siempre `format` si el número lleva unidad (horas, %, moneda): la unidad no rueda."
291
291
  ]
292
292
  },
293
+ "api-key-list": {
294
+ "import": "orbital-ds/ui/api-key-list",
295
+ "group": "data",
296
+ "summary": "Claves de API, tokens personales o webhooks con su valor enmascarado, uso, caducidad y estado; enseña UNA vez el secreto recién creado para copiarlo; presets keys · tokens · webhooks.",
297
+ "see": [
298
+ {
299
+ "component": "copy-button",
300
+ "when": "copiar un valor suelto, sin lista"
301
+ },
302
+ {
303
+ "component": "session-list",
304
+ "when": "sesiones abiertas de la persona, no credenciales de máquina"
305
+ },
306
+ {
307
+ "component": "connected-accounts",
308
+ "when": "servicios de terceros vinculados por OAuth"
309
+ }
310
+ ],
311
+ "exports": [
312
+ "ApiKeyList"
313
+ ],
314
+ "slots": [
315
+ "api-key-list",
316
+ "api-key-list-item",
317
+ "api-key-list-meta",
318
+ "api-key-list-reveal",
319
+ "api-key-list-scopes",
320
+ "api-key-list-value"
321
+ ],
322
+ "optionalPeers": [],
323
+ "presets": {
324
+ "values": [
325
+ "keys",
326
+ "tokens",
327
+ "webhooks"
328
+ ],
329
+ "default": null,
330
+ "intent": {
331
+ "keys": "claves de API: valor enmascarado, se creó y último uso",
332
+ "tokens": "tokens personales: permisos (scopes) y caducidad delante",
333
+ "webhooks": "puntos de entrega: URL, eventos y estado de la última entrega (`health`)"
334
+ }
335
+ },
336
+ "notes": [
337
+ "keys para claves de API de un proyecto; tokens para tokens personales (con permisos y caducidad); webhooks para puntos de entrega con su estado.",
338
+ "El secreto completo va en `revealed` SOLO justo después de crearlo o regenerarlo; nunca lo guardes para volver a enseñarlo. Revocar y regenerar pasan por ConfirmAction en la app."
339
+ ]
340
+ },
293
341
  "app-bar": {
294
342
  "import": "orbital-ds/ui/app-bar",
295
343
  "group": "navigation",
@@ -407,6 +455,51 @@
407
455
  "Varios adjuntos en fila van en AttachmentGroup (desplazamiento horizontal); cada AttachmentAction de solo icono lleva aria-label."
408
456
  ]
409
457
  },
458
+ "audit-log": {
459
+ "import": "orbital-ds/ui/audit-log",
460
+ "group": "data",
461
+ "summary": "Registro de actividad (quién hizo qué, sobre qué y cuándo), agrupado por día, para auditoría y seguridad de una cuenta o de una entidad; presets full · compact · entity.",
462
+ "see": [
463
+ {
464
+ "component": "timeline",
465
+ "when": "hitos de un proceso, no eventos de auditoría con autor"
466
+ },
467
+ {
468
+ "component": "data-table",
469
+ "when": "miles de eventos con filtros, orden y exportación"
470
+ },
471
+ {
472
+ "component": "session-list",
473
+ "when": "sesiones abiertas, no acciones hechas"
474
+ }
475
+ ],
476
+ "exports": [
477
+ "AuditLog"
478
+ ],
479
+ "slots": [
480
+ "audit-log",
481
+ "audit-log-day",
482
+ "audit-log-event"
483
+ ],
484
+ "optionalPeers": [],
485
+ "presets": {
486
+ "values": [
487
+ "full",
488
+ "compact",
489
+ "entity"
490
+ ],
491
+ "default": null,
492
+ "intent": {
493
+ "full": "página de auditoría o seguridad: autor con avatar, acción, objetivo, hora exacta",
494
+ "compact": "bloque de «Actividad reciente»: una línea por evento y hora relativa, sin grupos",
495
+ "entity": "historial dentro del detalle de una entidad: línea de tiempo con puntos, sin el"
496
+ }
497
+ },
498
+ "notes": [
499
+ "full en la página de auditoría o seguridad de la cuenta; compact en un bloque de «Actividad reciente» del panel; entity dentro del detalle de un recurso (su historial).",
500
+ "La acción la escribe la app en su idioma y se compone «autor acción objetivo»; para miles de eventos con filtros y exportación, usa DataTable. Sin autor = el sistema."
501
+ ]
502
+ },
410
503
  "auth-backdrop": {
411
504
  "import": "orbital-ds/ui/auth-backdrop",
412
505
  "group": "auth",
@@ -1162,10 +1255,6 @@
1162
1255
  "component": "echart",
1163
1256
  "when": "solo el lienzo del gráfico, sin tarjeta ni estados, dentro de tu propia maqueta"
1164
1257
  },
1165
- {
1166
- "component": "chart",
1167
- "when": "gráficos Recharts heredados: solo compatibilidad, nunca para pantallas nuevas"
1168
- },
1169
1258
  {
1170
1259
  "component": "stat",
1171
1260
  "when": "una cifra clave con su tendencia mínima (Sparkline), no un gráfico completo"
@@ -1199,47 +1288,6 @@
1199
1288
  "Varios gráficos juntos: dentro de Mosaic (bento: el principal primero y en `focus`). Para informes en servidor usa renderEChartToSvg con el mismo option."
1200
1289
  ]
1201
1290
  },
1202
- "chart": {
1203
- "import": "orbital-ds/ui/chart",
1204
- "group": "data",
1205
- "summary": "Contenedor de Recharts con la paleta del tema, tooltip y leyenda. SOLO por compatibilidad (sin funciones nuevas): para cualquier gráfico nuevo usa ChartCard o EChart.",
1206
- "see": [
1207
- {
1208
- "component": "chart-card",
1209
- "when": "gráfico nuevo en un panel: tarjeta con estados y descarga (ECharts)"
1210
- },
1211
- {
1212
- "component": "echart",
1213
- "when": "gráfico nuevo dentro de tu propia maqueta (ECharts, colores del tema)"
1214
- },
1215
- {
1216
- "component": "sparkline",
1217
- "when": "tendencia mínima junto a una cifra, sin librería de gráficos"
1218
- }
1219
- ],
1220
- "exports": [
1221
- "ChartContainer",
1222
- "ChartLegend",
1223
- "ChartLegendContent",
1224
- "ChartStyle",
1225
- "ChartTooltip",
1226
- "ChartTooltipContent"
1227
- ],
1228
- "slots": [
1229
- "chart",
1230
- "chart-legend",
1231
- "chart-legend-item",
1232
- "chart-tooltip",
1233
- "chart-tooltip-item"
1234
- ],
1235
- "optionalPeers": [
1236
- "recharts"
1237
- ],
1238
- "notes": [
1239
- "Solo compatibilidad con Recharts: no recibe funciones nuevas. En pantallas nuevas usa ChartCard (o EChart) con un option de orbital-ds/lib/echarts-presets.",
1240
- "Los colores de cada serie salen de las variables del tema (var(--chart-1) … var(--chart-5)) en el config; nunca un color escrito."
1241
- ]
1242
- },
1243
1291
  "chat-composer": {
1244
1292
  "import": "orbital-ds/ui/chat-composer",
1245
1293
  "group": "chat",
@@ -1847,6 +1895,40 @@
1847
1895
  "El dato va limpio, sin instrucciones dentro del texto («Copia esta IP…»): el botón ya lo dice."
1848
1896
  ]
1849
1897
  },
1898
+ "cta-banner": {
1899
+ "import": "orbital-ds/ui/cta-banner",
1900
+ "group": "content",
1901
+ "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.",
1902
+ "see": [
1903
+ {
1904
+ "component": "hero",
1905
+ "when": "la portada de arriba del todo"
1906
+ },
1907
+ {
1908
+ "component": "banner",
1909
+ "when": "aviso de sistema que afecta a toda la página, no una invitación"
1910
+ },
1911
+ {
1912
+ "component": "next-step-card",
1913
+ "when": "siguiente paso de un servicio DENTRO de la app"
1914
+ }
1915
+ ],
1916
+ "exports": [
1917
+ "CtaBanner",
1918
+ "type CtaBannerProps"
1919
+ ],
1920
+ "slots": [
1921
+ "cta-banner",
1922
+ "cta-banner-actions",
1923
+ "cta-banner-description",
1924
+ "cta-banner-title"
1925
+ ],
1926
+ "optionalPeers": [],
1927
+ "notes": [
1928
+ "Una por página, al final, repitiendo la acción principal del Hero con otras palabras; nada de enlaces sueltos alrededor.",
1929
+ "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."
1930
+ ]
1931
+ },
1850
1932
  "data-table": {
1851
1933
  "import": "orbital-ds/ui/data-table",
1852
1934
  "group": "data",
@@ -2599,6 +2681,69 @@
2599
2681
  "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)."
2600
2682
  ]
2601
2683
  },
2684
+ "faq": {
2685
+ "import": "orbital-ds/ui/faq",
2686
+ "group": "content",
2687
+ "summary": "Preguntas frecuentes de una web pública o de una ayuda: lista desplegable de pregunta y respuesta, con datos estructurados opcionales para buscadores.",
2688
+ "see": [
2689
+ {
2690
+ "component": "accordion",
2691
+ "when": "paneles desplegables de cualquier contenido (ajustes, detalles)"
2692
+ },
2693
+ {
2694
+ "component": "landing-section",
2695
+ "when": "la sección con título que la envuelve en una portada"
2696
+ }
2697
+ ],
2698
+ "exports": [
2699
+ "Faq",
2700
+ "type FaqItem",
2701
+ "type FaqProps"
2702
+ ],
2703
+ "slots": [
2704
+ "faq"
2705
+ ],
2706
+ "optionalPeers": [],
2707
+ "notes": [
2708
+ "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.",
2709
+ "Entre 4 y 8 preguntas; si hay más, agrúpalas por tema con un título (LandingSection o SectionHeader) por grupo.",
2710
+ "`structuredData` solo en la página pública donde se leen esas preguntas, una vez por página."
2711
+ ]
2712
+ },
2713
+ "feature-grid": {
2714
+ "import": "orbital-ds/ui/feature-grid",
2715
+ "group": "content",
2716
+ "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.",
2717
+ "see": [
2718
+ {
2719
+ "component": "content-card",
2720
+ "when": "tarjetas con imagen o enlace a otra página"
2721
+ },
2722
+ {
2723
+ "component": "mosaic",
2724
+ "when": "rejilla bento de bloques de distinto tamaño"
2725
+ }
2726
+ ],
2727
+ "exports": [
2728
+ "Feature",
2729
+ "FeatureGrid",
2730
+ "type FeatureGridProps",
2731
+ "type FeatureProps"
2732
+ ],
2733
+ "slots": [
2734
+ "feature",
2735
+ "feature-description",
2736
+ "feature-grid",
2737
+ "feature-icon",
2738
+ "feature-title"
2739
+ ],
2740
+ "optionalPeers": [],
2741
+ "notes": [
2742
+ "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.",
2743
+ "Iconos del mismo trazo y tamaño (lucide); no repitas el mismo icono.",
2744
+ "`variant=\"card\"` cuando la sección va sobre un fondo con dibujo o para separar bloques densos; `plain` en el resto."
2745
+ ]
2746
+ },
2602
2747
  "field": {
2603
2748
  "import": "orbital-ds/ui/field",
2604
2749
  "group": "forms",
@@ -3321,6 +3466,40 @@
3321
3466
  "Asocia con `htmlFor` o envolviendo el control; en un formulario usa FieldLabel dentro de Field."
3322
3467
  ]
3323
3468
  },
3469
+ "landing-section": {
3470
+ "import": "orbital-ds/ui/landing-section",
3471
+ "group": "content",
3472
+ "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).",
3473
+ "see": [
3474
+ {
3475
+ "component": "hero",
3476
+ "when": "la portada de arriba del todo, una por página"
3477
+ },
3478
+ {
3479
+ "component": "page-header",
3480
+ "when": "cabecera de una vista de trabajo dentro de la app"
3481
+ }
3482
+ ],
3483
+ "exports": [
3484
+ "LandingSection",
3485
+ "type LandingSectionProps"
3486
+ ],
3487
+ "slots": [
3488
+ "landing-section",
3489
+ "landing-section-actions",
3490
+ "landing-section-body",
3491
+ "landing-section-description",
3492
+ "landing-section-eyebrow",
3493
+ "landing-section-header",
3494
+ "landing-section-title"
3495
+ ],
3496
+ "optionalPeers": [],
3497
+ "notes": [
3498
+ "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.",
3499
+ "Una idea por sección y un título que la diga; el antetítulo es la categoría («Precios»), no una frase.",
3500
+ "Centrada para presentar; `align=\"start\"` para bloques de lectura (preguntas frecuentes, texto largo)."
3501
+ ]
3502
+ },
3324
3503
  "legend": {
3325
3504
  "import": "orbital-ds/ui/legend",
3326
3505
  "group": "data",
@@ -3609,6 +3788,52 @@
3609
3788
  "Un solo `action` por tarjeta (reproducir/abrir); lleva su aria-label, que la tarjeta no lo pone."
3610
3789
  ]
3611
3790
  },
3791
+ "member-list": {
3792
+ "import": "orbital-ds/ui/member-list",
3793
+ "group": "data",
3794
+ "summary": "Miembros de un equipo o espacio de trabajo con su rol (editable), su estado y las invitaciones pendientes; presets team · workspace · compact.",
3795
+ "see": [
3796
+ {
3797
+ "component": "entity-list",
3798
+ "when": "lista genérica de entidades (agentes, dispositivos), no de personas con rol"
3799
+ },
3800
+ {
3801
+ "component": "permission-matrix",
3802
+ "when": "qué puede hacer cada rol, no quién lo tiene"
3803
+ },
3804
+ {
3805
+ "component": "data-table",
3806
+ "when": "cientos de miembros con orden, filtros y selección múltiple"
3807
+ }
3808
+ ],
3809
+ "exports": [
3810
+ "MemberList"
3811
+ ],
3812
+ "slots": [
3813
+ "member-list",
3814
+ "member-list-invites",
3815
+ "member-list-item",
3816
+ "member-list-role"
3817
+ ],
3818
+ "optionalPeers": [],
3819
+ "presets": {
3820
+ "values": [
3821
+ "team",
3822
+ "workspace",
3823
+ "compact"
3824
+ ],
3825
+ "default": "team",
3826
+ "intent": {
3827
+ "team": "ajustes del equipo: rol editable (Select) y acciones por persona",
3828
+ "workspace": "administración de un espacio: además, última actividad y las invitaciones",
3829
+ "compact": "solo lectura y denso (un panel lateral, un resumen): rol como etiqueta"
3830
+ }
3831
+ },
3832
+ "notes": [
3833
+ "team en los ajustes del equipo; workspace en la administración de un espacio (con actividad e invitaciones aparte); compact en un panel o resumen, solo lectura.",
3834
+ "El botón «Invitar» y su diálogo los pone la app encima de la lista (PageHeader o SectionHeader con `actions`). Quitar a alguien debe pasar por ConfirmAction."
3835
+ ]
3836
+ },
3612
3837
  "menubar": {
3613
3838
  "import": "orbital-ds/ui/menubar",
3614
3839
  "group": "navigation",
@@ -4232,6 +4457,57 @@
4232
4457
  "Pasa siempre `redirectUri` y `client.verified`: la persona debe saber adónde vuelve y si el cliente es de confianza. Los textos de cada permiso los traduce la app."
4233
4458
  ]
4234
4459
  },
4460
+ "onboarding-checklist": {
4461
+ "import": "orbital-ds/ui/onboarding-checklist",
4462
+ "group": "feedback",
4463
+ "summary": "Lista de primeros pasos con su progreso y el paso que toca resaltado, para activar a una persona o a una cuenta nueva; presets card · sidebar · page.",
4464
+ "see": [
4465
+ {
4466
+ "component": "step-flow",
4467
+ "when": "un asistente que se recorre de principio a fin en una sola sesión"
4468
+ },
4469
+ {
4470
+ "component": "next-step-card",
4471
+ "when": "un único estado con su única acción, no una lista de pasos"
4472
+ },
4473
+ {
4474
+ "component": "task-progress",
4475
+ "when": "avance de una tarea que hace el sistema, no la persona"
4476
+ }
4477
+ ],
4478
+ "exports": [
4479
+ "OnboardingChecklist"
4480
+ ],
4481
+ "slots": [
4482
+ "onboarding-checklist",
4483
+ "onboarding-checklist-action",
4484
+ "onboarding-checklist-check",
4485
+ "onboarding-checklist-complete",
4486
+ "onboarding-checklist-count",
4487
+ "onboarding-checklist-header",
4488
+ "onboarding-checklist-step",
4489
+ "onboarding-checklist-steps",
4490
+ "onboarding-checklist-title"
4491
+ ],
4492
+ "optionalPeers": [],
4493
+ "presets": {
4494
+ "values": [
4495
+ "card",
4496
+ "sidebar",
4497
+ "page"
4498
+ ],
4499
+ "default": "card",
4500
+ "intent": {
4501
+ "card": "tarjeta del panel de inicio: todos los pasos, los hechos plegados, descartable",
4502
+ "sidebar": "bloque del lateral: progreso y SOLO el paso que toca (lo demás, al desplegar)",
4503
+ "page": "página de bienvenida: todos los pasos abiertos, con descripción y aire"
4504
+ }
4505
+ },
4506
+ "notes": [
4507
+ "card en el panel de inicio de una cuenta nueva; sidebar dentro del lateral (SidebarGroup) para recordar el paso que toca sin ocupar la vista; page como página de bienvenida.",
4508
+ "Pocos pasos (3–7), cada uno con UNA acción que lleva a hacerlo. Lo opcional no cuenta para el progreso. Al terminarlo todo, la app puede ocultar la lista o dejar el «Todo listo»."
4509
+ ]
4510
+ },
4235
4511
  "page-header": {
4236
4512
  "import": "orbital-ds/ui/page-header",
4237
4513
  "group": "navigation",
@@ -4554,6 +4830,101 @@
4554
4830
  "Solo al crear o cambiar la contraseña, nunca al iniciar sesión."
4555
4831
  ]
4556
4832
  },
4833
+ "permission-matrix": {
4834
+ "import": "orbital-ds/ui/permission-matrix",
4835
+ "group": "data",
4836
+ "summary": "Matriz de permisos por rol (qué puede hacer cada rol), editable o de solo lectura, o los permisos de un único rol o token con interruptores; presets roles · review · scopes.",
4837
+ "see": [
4838
+ {
4839
+ "component": "member-list",
4840
+ "when": "quién tiene cada rol"
4841
+ },
4842
+ {
4843
+ "component": "data-table",
4844
+ "when": "tabla de datos genérica con orden y filtros"
4845
+ },
4846
+ {
4847
+ "component": "api-key-list",
4848
+ "when": "los tokens a los que se dan esos permisos"
4849
+ }
4850
+ ],
4851
+ "exports": [
4852
+ "PermissionMatrix"
4853
+ ],
4854
+ "slots": [
4855
+ "permission-matrix",
4856
+ "permission-matrix-cell",
4857
+ "permission-matrix-group"
4858
+ ],
4859
+ "optionalPeers": [],
4860
+ "presets": {
4861
+ "values": [
4862
+ "roles",
4863
+ "review",
4864
+ "scopes"
4865
+ ],
4866
+ "default": null,
4867
+ "intent": {
4868
+ "roles": "permisos (filas, agrupados) × roles (columnas) con casillas editables",
4869
+ "review": "la misma tabla de solo lectura (✓ / –), para revisar o comparar roles",
4870
+ "scopes": "un único rol o token (`role`): cada permiso con su descripción y un interruptor"
4871
+ }
4872
+ },
4873
+ "notes": [
4874
+ "roles en los ajustes de roles (editar qué puede cada uno); review para revisar o comparar roles sin cambiarlos; scopes para los permisos de un único rol, token o integración.",
4875
+ "Pocos roles en columnas (2–6); con más, usa scopes por rol. Bloquea la propiedad (`lockedRoles`) para que nadie se quite el acceso a sí mismo. Si el cambio es delicado, guarda con un botón al pie, no en cada casilla."
4876
+ ]
4877
+ },
4878
+ "plan-summary": {
4879
+ "import": "orbital-ds/ui/plan-summary",
4880
+ "group": "data",
4881
+ "summary": "Resumen de la suscripción: plan, estado, precio, renovación o fin de la prueba y el uso frente a lo contratado; presets overview · compact · trial.",
4882
+ "see": [
4883
+ {
4884
+ "component": "usage-meter",
4885
+ "when": "un solo medidor de uso frente a su límite"
4886
+ },
4887
+ {
4888
+ "component": "pricing-table",
4889
+ "when": "elegir entre planes (portada o cambio de plan), no ver el contratado"
4890
+ },
4891
+ {
4892
+ "component": "next-step-card",
4893
+ "when": "un estado con su única acción, sin datos de facturación"
4894
+ }
4895
+ ],
4896
+ "exports": [
4897
+ "PlanSummary"
4898
+ ],
4899
+ "slots": [
4900
+ "plan-summary",
4901
+ "plan-summary-actions",
4902
+ "plan-summary-date",
4903
+ "plan-summary-header",
4904
+ "plan-summary-plan",
4905
+ "plan-summary-price",
4906
+ "plan-summary-status",
4907
+ "plan-summary-usage"
4908
+ ],
4909
+ "optionalPeers": [],
4910
+ "presets": {
4911
+ "values": [
4912
+ "overview",
4913
+ "compact",
4914
+ "trial"
4915
+ ],
4916
+ "default": "overview",
4917
+ "intent": {
4918
+ "overview": "cabecera de la página de facturación: plan, estado, precio, renovación y una",
4919
+ "compact": "una fila (ajustes generales, menú de cuenta): plan, estado y renovación",
4920
+ "trial": "durante la prueba: cuánto queda (relativo), filete de acento y la acción de elegir plan"
4921
+ }
4922
+ },
4923
+ "notes": [
4924
+ "overview en la cabecera de la página de facturación; compact en ajustes generales o en el menú de la cuenta; trial mientras dura la prueba, con la acción de elegir un plan.",
4925
+ "El precio lo formatea la app (moneda y periodo); el uso, siempre con unidades UCUM por UsageMeter. Con pago pendiente (past_due) acompáñalo de un Banner en la página."
4926
+ ]
4927
+ },
4557
4928
  "popover": {
4558
4929
  "import": "orbital-ds/ui/popover",
4559
4930
  "group": "overlays",
@@ -4595,6 +4966,45 @@
4595
4966
  "Contenido corto; si crece a varios campos o pide confirmar, pasa a Dialog o Sheet."
4596
4967
  ]
4597
4968
  },
4969
+ "pricing-table": {
4970
+ "import": "orbital-ds/ui/pricing-table",
4971
+ "group": "content",
4972
+ "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.",
4973
+ "see": [
4974
+ {
4975
+ "component": "toggle-group",
4976
+ "when": "conmutar mensual/anual encima de la tabla"
4977
+ },
4978
+ {
4979
+ "component": "usage-meter",
4980
+ "when": "consumo frente a lo contratado DENTRO de la app, no la oferta"
4981
+ }
4982
+ ],
4983
+ "exports": [
4984
+ "PricingFeature",
4985
+ "PricingPlan",
4986
+ "PricingTable",
4987
+ "type PricingFeatureProps",
4988
+ "type PricingPlanProps"
4989
+ ],
4990
+ "slots": [
4991
+ "pricing-feature",
4992
+ "pricing-plan",
4993
+ "pricing-plan-action",
4994
+ "pricing-plan-features",
4995
+ "pricing-plan-header",
4996
+ "pricing-plan-name",
4997
+ "pricing-plan-period",
4998
+ "pricing-plan-price",
4999
+ "pricing-table"
5000
+ ],
5001
+ "optionalPeers": [],
5002
+ "notes": [
5003
+ "Entre 2 y 4 planes; destaca solo uno (`featured`) y dilo también con texto en `badge` («Más elegido»), no solo con color.",
5004
+ "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}`.",
5005
+ "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."
5006
+ ]
5007
+ },
4598
5008
  "progress": {
4599
5009
  "import": "orbital-ds/ui/progress",
4600
5010
  "group": "feedback",
@@ -5093,7 +5503,7 @@
5093
5503
  "sheet": {
5094
5504
  "import": "orbital-ds/ui/sheet",
5095
5505
  "group": "overlays",
5096
- "summary": "Panel modal que entra desde un borde (derecha por defecto) para editar o consultar algo largo sin perder la página de fondo; pieza base de DetailPanel.",
5506
+ "summary": "Panel modal que entra desde un borde (por defecto el final de la lectura: derecha en LTR, izquierda en RTL) para editar o consultar algo largo sin perder la página de fondo; pieza base de DetailPanel.",
5097
5507
  "see": [
5098
5508
  {
5099
5509
  "component": "detail-panel",
@@ -5393,38 +5803,6 @@
5393
5803
  "Con un número en `value`/`defaultValue` hay UN tirador y `onValueChange` recibe un número; con una lista, un rango y recibe una lista. Sin normalizar a mano en cada uso."
5394
5804
  ]
5395
5805
  },
5396
- "sonner": {
5397
- "import": "orbital-ds/ui/sonner",
5398
- "group": "feedback",
5399
- "summary": "COMPATIBILIDAD: Toaster de la librería sonner (con next-themes) para apps que ya lo usan; lo nuevo va con Toaster de `toast` (Base UI, el oficial).",
5400
- "see": [
5401
- {
5402
- "component": "toast",
5403
- "when": "el canal OFICIAL de avisos efímeros (Base UI, sin dependencias), con `toast.add(...)`"
5404
- },
5405
- {
5406
- "component": "alert",
5407
- "when": "aviso que debe quedarse visible en la sección"
5408
- },
5409
- {
5410
- "component": "notifications",
5411
- "when": "asunto con seguimiento (campana)"
5412
- }
5413
- ],
5414
- "exports": [
5415
- "Toaster"
5416
- ],
5417
- "slots": [],
5418
- "optionalPeers": [
5419
- "next-themes",
5420
- "sonner"
5421
- ],
5422
- "notes": [
5423
- "Un solo Toaster en la raíz; `toast` se importa de `sonner`. Necesita `sonner` y `next-themes` instalados.",
5424
- "Elige un canal de toasts para toda la app: este Toaster o el de `toast` (Base UI), no los dos.",
5425
- "Se mantiene por compatibilidad, sin funciones nuevas (como `chart` frente a `echart`): en una app nueva usa `toast`."
5426
- ]
5427
- },
5428
5806
  "sparkline": {
5429
5807
  "import": "orbital-ds/ui/sparkline",
5430
5808
  "group": "data",
@@ -6062,6 +6440,42 @@
6062
6440
  "Un fallo va con state=\"error\" y error con el motivo en texto (se anuncia por aria-describedby), no solo en color."
6063
6441
  ]
6064
6442
  },
6443
+ "testimonial": {
6444
+ "import": "orbital-ds/ui/testimonial",
6445
+ "group": "content",
6446
+ "summary": "Testimonio de un cliente (cita, autor, cargo y foto) para la prueba social de una web pública; suelto, destacado o en rejilla.",
6447
+ "see": [
6448
+ {
6449
+ "component": "feature-grid",
6450
+ "when": "ventajas del producto, no opiniones"
6451
+ },
6452
+ {
6453
+ "component": "avatar",
6454
+ "when": "solo la foto o las iniciales de una persona"
6455
+ }
6456
+ ],
6457
+ "exports": [
6458
+ "Testimonial",
6459
+ "TestimonialGrid",
6460
+ "type TestimonialGridProps",
6461
+ "type TestimonialProps"
6462
+ ],
6463
+ "slots": [
6464
+ "testimonial",
6465
+ "testimonial-author",
6466
+ "testimonial-grid",
6467
+ "testimonial-logo",
6468
+ "testimonial-name",
6469
+ "testimonial-quote",
6470
+ "testimonial-role"
6471
+ ],
6472
+ "optionalPeers": [],
6473
+ "notes": [
6474
+ "Testimonios reales, con nombre, cargo y empresa (y foto o logo si hay permiso). Una cita anónima no prueba nada.",
6475
+ "Citas cortas (una o dos frases) que digan un resultado concreto; recorta, no inventes.",
6476
+ "Tres en rejilla o uno destacado (`size=\"lg\"`); nada de carruseles que giran solos."
6477
+ ]
6478
+ },
6065
6479
  "textarea": {
6066
6480
  "import": "orbital-ds/ui/textarea",
6067
6481
  "group": "forms",
@@ -6182,10 +6596,6 @@
6182
6596
  "group": "feedback",
6183
6597
  "summary": "Aviso efímero que confirma una acción recién hecha («Cliente creado»), con «Deshacer» si aplica; Base UI sin dependencias, lanzado con `toast.add({...})` desde cualquier sitio.",
6184
6598
  "see": [
6185
- {
6186
- "component": "sonner",
6187
- "when": "solo si la app ya usa la librería sonner (compatibilidad)"
6188
- },
6189
6599
  {
6190
6600
  "component": "alert",
6191
6601
  "when": "aviso que debe quedarse visible en la sección"
@@ -6355,6 +6765,56 @@
6355
6765
  "No existe en táctil: nada imprescindible puede vivir solo en un tooltip."
6356
6766
  ]
6357
6767
  },
6768
+ "upgrade-prompt": {
6769
+ "import": "orbital-ds/ui/upgrade-prompt",
6770
+ "group": "feedback",
6771
+ "summary": "Aviso de que una función no está en el plan actual, con el plan que la incluye y la acción de mejorar; presets inline · card · banner · overlay (encima de lo bloqueado).",
6772
+ "see": [
6773
+ {
6774
+ "component": "banner",
6775
+ "when": "aviso de página que no es una venta (mantenimiento, pago pendiente)"
6776
+ },
6777
+ {
6778
+ "component": "empty-state",
6779
+ "when": "sección vacía o sin permiso, sin plan que la desbloquee"
6780
+ },
6781
+ {
6782
+ "component": "plan-summary",
6783
+ "when": "el plan contratado con su uso"
6784
+ }
6785
+ ],
6786
+ "exports": [
6787
+ "UpgradePrompt"
6788
+ ],
6789
+ "slots": [
6790
+ "upgrade-prompt",
6791
+ "upgrade-prompt-card",
6792
+ "upgrade-prompt-features",
6793
+ "upgrade-prompt-icon",
6794
+ "upgrade-prompt-locked",
6795
+ "upgrade-prompt-plan"
6796
+ ],
6797
+ "optionalPeers": [],
6798
+ "presets": {
6799
+ "values": [
6800
+ "inline",
6801
+ "card",
6802
+ "banner",
6803
+ "overlay"
6804
+ ],
6805
+ "default": null,
6806
+ "intent": {
6807
+ "inline": "una línea junto al control o la opción bloqueada",
6808
+ "card": "tarjeta en el sitio de la función: qué es, qué incluye y la acción",
6809
+ "banner": "franja a lo ancho de la sección o la página, descartable (`onDismiss`)",
6810
+ "overlay": "encima de lo bloqueado (los `children`): lo deja ver desenfocado e inerte y pone"
6811
+ }
6812
+ },
6813
+ "notes": [
6814
+ "inline junto al control bloqueado; card en el sitio de la función; banner a lo ancho de una sección (descartable); overlay encima de una vista previa de lo que se desbloquea.",
6815
+ "Una sola acción clara (mejorar o ver planes). No lo repitas en cada fila: un overlay o un banner por sección. Si la persona no puede mejorar el plan (no administra), dile a quién pedírselo en `description`."
6816
+ ]
6817
+ },
6358
6818
  "usage-meter": {
6359
6819
  "import": "orbital-ds/ui/usage-meter",
6360
6820
  "group": "data",
@@ -6450,6 +6910,53 @@
6450
6910
  "notes": [
6451
6911
  "Para ver cómo avanza un agente o una automatización; la app traduce su motor (Workflows, colas…) a `WorkflowNode`."
6452
6912
  ]
6913
+ },
6914
+ "workspace-switcher": {
6915
+ "import": "orbital-ds/ui/workspace-switcher",
6916
+ "group": "navigation",
6917
+ "summary": "Selector del espacio de trabajo, organización o cuenta activa (multi-inquilino) con su logo y plan, y la opción de crear otro; presets sidebar · menu · compact.",
6918
+ "see": [
6919
+ {
6920
+ "component": "sidebar",
6921
+ "when": "el lateral donde suele ir, en SidebarHeader"
6922
+ },
6923
+ {
6924
+ "component": "dropdown-menu",
6925
+ "when": "un menú genérico de acciones, no el cambio de inquilino"
6926
+ },
6927
+ {
6928
+ "component": "command-palette",
6929
+ "when": "buscar entre muchos espacios con el teclado"
6930
+ }
6931
+ ],
6932
+ "exports": [
6933
+ "WorkspaceSwitcher"
6934
+ ],
6935
+ "slots": [
6936
+ "workspace-switcher",
6937
+ "workspace-switcher-create",
6938
+ "workspace-switcher-item",
6939
+ "workspace-switcher-logo",
6940
+ "workspace-switcher-trigger"
6941
+ ],
6942
+ "optionalPeers": [],
6943
+ "presets": {
6944
+ "values": [
6945
+ "sidebar",
6946
+ "menu",
6947
+ "compact"
6948
+ ],
6949
+ "default": null,
6950
+ "intent": {
6951
+ "sidebar": "a todo el ancho en SidebarHeader: logo, nombre y plan, con el indicador de abrir",
6952
+ "menu": "en la barra de la app (AppBar): nombre y el indicador",
6953
+ "compact": "solo el logo, para el raíl de iconos"
6954
+ }
6955
+ },
6956
+ "notes": [
6957
+ "sidebar en SidebarHeader (a todo el ancho); menu en la AppBar cuando no hay lateral; compact en el raíl de iconos (el menú sale hacia inline-end).",
6958
+ "Cambiar de espacio cambia TODO el contexto: la app navega a la portada del espacio nuevo. Con muchos espacios (más de 10), ofrece además buscar con CommandPalette."
6959
+ ]
6453
6960
  }
6454
6961
  },
6455
6962
  "pages": {