orbital-ds 0.48.0 → 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 (320) hide show
  1. package/AGENTS.md +13 -4
  2. package/CHANGELOG.md +31 -0
  3. package/README.md +1 -1
  4. package/components.manifest.json +383 -37
  5. package/dist/auth-form-B1hgbXkI.d.ts +144 -0
  6. package/dist/hooks/use-ds-messages.d.ts +598 -0
  7. package/dist/hooks/use-ds-motion.d.ts +17 -0
  8. package/dist/hooks/use-esc-close-stack.d.ts +3 -0
  9. package/dist/hooks/use-in-view.d.ts +9 -0
  10. package/dist/hooks/use-mobile.d.ts +3 -0
  11. package/dist/hooks/use-simulated-progress.d.ts +11 -0
  12. package/dist/lib/a2ui-catalog.d.ts +42 -0
  13. package/dist/lib/a2ui.d.ts +289 -0
  14. package/dist/lib/ai-events.d.ts +15 -0
  15. package/dist/lib/auth-better-auth.d.ts +29 -0
  16. package/dist/lib/auth-flow.d.ts +85 -0
  17. package/dist/lib/auth-providers.d.ts +194 -0
  18. package/dist/lib/auth.d.ts +68 -0
  19. package/dist/lib/brand-allowlist.d.ts +3 -0
  20. package/dist/lib/brand-allowlist.js +16 -0
  21. package/dist/lib/brand-runtime.d.ts +52 -0
  22. package/dist/lib/echarts-presets.d.ts +307 -0
  23. package/dist/lib/echarts-server.d.ts +15 -0
  24. package/dist/lib/echarts-setup.d.ts +8 -0
  25. package/dist/lib/echarts-theme.d.ts +36 -0
  26. package/dist/lib/format.d.ts +57 -0
  27. package/dist/lib/header-control.d.ts +4 -0
  28. package/dist/lib/i18n.d.ts +611 -0
  29. package/dist/lib/i18n.js +162 -3
  30. package/dist/lib/image-upload.d.ts +41 -0
  31. package/dist/lib/locales/de.d.ts +7 -0
  32. package/dist/lib/locales/de.js +54 -1
  33. package/dist/lib/locales/fr.d.ts +7 -0
  34. package/dist/lib/locales/fr.js +54 -1
  35. package/dist/lib/locales/he.d.ts +7 -0
  36. package/dist/lib/locales/he.js +54 -1
  37. package/dist/lib/locales/it.d.ts +7 -0
  38. package/dist/lib/locales/it.js +54 -1
  39. package/dist/lib/motion.d.ts +74 -0
  40. package/dist/lib/presets.d.ts +8 -0
  41. package/dist/lib/template-syntax.d.ts +22 -0
  42. package/dist/lib/utils.d.ts +5 -0
  43. package/dist/motion.css +146 -0
  44. package/dist/styles.css +1819 -0
  45. package/dist/themes/chocolate.css +259 -0
  46. package/dist/themes/chocolate.fonts.css +2 -0
  47. package/dist/themes/chocolate.guide.md +30 -0
  48. package/dist/themes/chocolate.meta.json +61 -0
  49. package/dist/themes/chocolate.scoped.css +259 -0
  50. package/dist/themes/chocolate.tokens.json +49 -0
  51. package/dist/themes/fractalia.css +556 -0
  52. package/dist/themes/fractalia.fonts.css +3 -0
  53. package/dist/themes/fractalia.guide.md +86 -0
  54. package/dist/themes/fractalia.meta.json +112 -0
  55. package/dist/themes/fractalia.scoped.css +556 -0
  56. package/dist/themes/fractalia.tokens.json +39 -0
  57. package/dist/themes/friendly.css +375 -0
  58. package/dist/themes/friendly.fonts.css +2 -0
  59. package/dist/themes/friendly.guide.md +38 -0
  60. package/dist/themes/friendly.meta.json +82 -0
  61. package/dist/themes/friendly.scoped.css +375 -0
  62. package/dist/themes/friendly.tokens.json +45 -0
  63. package/dist/themes/lagoon.css +362 -0
  64. package/dist/themes/lagoon.fonts.css +2 -0
  65. package/dist/themes/lagoon.guide.md +47 -0
  66. package/dist/themes/lagoon.meta.json +85 -0
  67. package/dist/themes/lagoon.scoped.css +362 -0
  68. package/dist/themes/lagoon.tokens.json +49 -0
  69. package/dist/themes/liquid.css +510 -0
  70. package/dist/themes/liquid.fonts.css +7 -0
  71. package/dist/themes/liquid.guide.md +82 -0
  72. package/dist/themes/liquid.meta.json +134 -0
  73. package/dist/themes/liquid.scoped.css +510 -0
  74. package/dist/themes/liquid.tokens.json +47 -0
  75. package/dist/themes/matcha.css +259 -0
  76. package/dist/themes/matcha.fonts.css +2 -0
  77. package/dist/themes/matcha.guide.md +30 -0
  78. package/dist/themes/matcha.meta.json +61 -0
  79. package/dist/themes/matcha.scoped.css +259 -0
  80. package/dist/themes/matcha.tokens.json +49 -0
  81. package/dist/themes/qratia.css +264 -0
  82. package/dist/themes/qratia.fonts.css +2 -0
  83. package/dist/themes/qratia.guide.md +34 -0
  84. package/dist/themes/qratia.meta.json +49 -0
  85. package/dist/themes/qratia.scoped.css +264 -0
  86. package/dist/themes/qratia.tokens.json +49 -0
  87. package/dist/themes/stone.css +263 -0
  88. package/dist/themes/stone.fonts.css +2 -0
  89. package/dist/themes/stone.guide.md +30 -0
  90. package/dist/themes/stone.meta.json +47 -0
  91. package/dist/themes/stone.scoped.css +263 -0
  92. package/dist/themes/stone.tokens.json +49 -0
  93. package/dist/themes/tactile.css +591 -0
  94. package/dist/themes/tactile.fonts.css +3 -0
  95. package/dist/themes/tactile.guide.md +82 -0
  96. package/dist/themes/tactile.meta.json +182 -0
  97. package/dist/themes/tactile.scoped.css +591 -0
  98. package/dist/themes/tactile.tokens.json +42 -0
  99. package/dist/themes/twitter.css +364 -0
  100. package/dist/themes/twitter.fonts.css +6 -0
  101. package/dist/themes/twitter.guide.md +35 -0
  102. package/dist/themes/twitter.meta.json +90 -0
  103. package/dist/themes/twitter.scoped.css +364 -0
  104. package/dist/themes/twitter.tokens.json +45 -0
  105. package/dist/themes/y2k.css +259 -0
  106. package/dist/themes/y2k.fonts.css +2 -0
  107. package/dist/themes/y2k.guide.md +30 -0
  108. package/dist/themes/y2k.meta.json +59 -0
  109. package/dist/themes/y2k.scoped.css +259 -0
  110. package/dist/themes/y2k.tokens.json +49 -0
  111. package/dist/themes/zyro.css +442 -0
  112. package/dist/themes/zyro.fonts.css +2 -0
  113. package/dist/themes/zyro.guide.md +33 -0
  114. package/dist/themes/zyro.meta.json +74 -0
  115. package/dist/themes/zyro.scoped.css +442 -0
  116. package/dist/themes/zyro.tokens.json +46 -0
  117. package/dist/ui/a2ui-renderer.d.ts +44 -0
  118. package/dist/ui/accordion.d.ts +9 -0
  119. package/dist/ui/agent-events.d.ts +49 -0
  120. package/dist/ui/ai-tag.d.ts +24 -0
  121. package/dist/ui/alert-dialog.d.ts +60 -0
  122. package/dist/ui/alert.d.ts +13 -0
  123. package/dist/ui/animated-number.d.ts +20 -0
  124. package/dist/ui/api-key-list.d.ts +40 -0
  125. package/dist/ui/api-key-list.js +89 -0
  126. package/dist/ui/app-bar.d.ts +32 -0
  127. package/dist/ui/aspect-ratio.d.ts +7 -0
  128. package/dist/ui/attachment.d.ts +26 -0
  129. package/dist/ui/audit-log.d.ts +53 -0
  130. package/dist/ui/audit-log.js +102 -0
  131. package/dist/ui/auth-backdrop.d.ts +37 -0
  132. package/dist/ui/auth-form.d.ts +4 -0
  133. package/dist/ui/auth-layout.d.ts +110 -0
  134. package/dist/ui/auth-parts.d.ts +43 -0
  135. package/dist/ui/auth-status.d.ts +23 -0
  136. package/dist/ui/avatar.d.ts +43 -0
  137. package/dist/ui/ayuda.d.ts +22 -0
  138. package/dist/ui/badge.d.ts +15 -0
  139. package/dist/ui/banner.d.ts +14 -0
  140. package/dist/ui/bottom-nav.d.ts +37 -0
  141. package/dist/ui/breadcrumb.d.ts +34 -0
  142. package/dist/ui/bubble.d.ts +19 -0
  143. package/dist/ui/button-group.d.ts +15 -0
  144. package/dist/ui/button.d.ts +14 -0
  145. package/dist/ui/calendar.d.ts +28 -0
  146. package/dist/ui/card-stack.d.ts +36 -0
  147. package/dist/ui/card.d.ts +61 -0
  148. package/dist/ui/carousel.d.ts +68 -0
  149. package/dist/ui/chain-of-thought.d.ts +34 -0
  150. package/dist/ui/chart-card.d.ts +46 -0
  151. package/dist/ui/chat-composer.d.ts +58 -0
  152. package/dist/ui/checkbox.d.ts +6 -0
  153. package/dist/ui/choice-card.d.ts +49 -0
  154. package/dist/ui/code-block.d.ts +29 -0
  155. package/dist/ui/collapsible.d.ts +8 -0
  156. package/dist/ui/combobox.d.ts +74 -0
  157. package/dist/ui/command-palette.d.ts +54 -0
  158. package/dist/ui/command.d.ts +56 -0
  159. package/dist/ui/confirm-action.d.ts +48 -0
  160. package/dist/ui/confirm-dialog.d.ts +44 -0
  161. package/dist/ui/connected-accounts.d.ts +25 -0
  162. package/dist/ui/content-card.d.ts +66 -0
  163. package/dist/ui/context-menu.d.ts +66 -0
  164. package/dist/ui/conversation-list.d.ts +44 -0
  165. package/dist/ui/copy-button.d.ts +25 -0
  166. package/dist/ui/cta-banner.d.ts +30 -0
  167. package/dist/ui/data-table.d.ts +198 -0
  168. package/dist/ui/date-picker.d.ts +65 -0
  169. package/dist/ui/date-time.d.ts +40 -0
  170. package/dist/ui/description-list.d.ts +49 -0
  171. package/dist/ui/detail-panel.d.ts +40 -0
  172. package/dist/ui/dialog.d.ts +54 -0
  173. package/dist/ui/direction.d.ts +1 -0
  174. package/dist/ui/dock.d.ts +30 -0
  175. package/dist/ui/drawer.d.ts +59 -0
  176. package/dist/ui/dropdown-menu.d.ts +63 -0
  177. package/dist/ui/dropzone.d.ts +44 -0
  178. package/dist/ui/echart.d.ts +46 -0
  179. package/dist/ui/empty-state.d.ts +26 -0
  180. package/dist/ui/empty.d.ts +15 -0
  181. package/dist/ui/entity-list.d.ts +57 -0
  182. package/dist/ui/error-page.d.ts +28 -0
  183. package/dist/ui/error-state.d.ts +16 -0
  184. package/dist/ui/eyebrow.d.ts +7 -0
  185. package/dist/ui/faq.d.ts +34 -0
  186. package/dist/ui/feature-grid.d.ts +40 -0
  187. package/dist/ui/field.d.ts +28 -0
  188. package/dist/ui/file-upload.d.ts +42 -0
  189. package/dist/ui/filter-bar.d.ts +38 -0
  190. package/dist/ui/form-layout.d.ts +43 -0
  191. package/dist/ui/gauge.d.ts +66 -0
  192. package/dist/ui/generated-image.d.ts +33 -0
  193. package/dist/ui/generated-table.d.ts +29 -0
  194. package/dist/ui/heatmap-grid.d.ts +59 -0
  195. package/dist/ui/hero.d.ts +58 -0
  196. package/dist/ui/hover-card.d.ts +8 -0
  197. package/dist/ui/i18n-provider.d.ts +27 -0
  198. package/dist/ui/icon-tile.d.ts +11 -0
  199. package/dist/ui/input-group.d.ts +22 -0
  200. package/dist/ui/input-otp.d.ts +36 -0
  201. package/dist/ui/input.d.ts +21 -0
  202. package/dist/ui/instruction-editor.d.ts +81 -0
  203. package/dist/ui/item.d.ts +26 -0
  204. package/dist/ui/kbd.d.ts +6 -0
  205. package/dist/ui/label.d.ts +22 -0
  206. package/dist/ui/landing-section.d.ts +34 -0
  207. package/dist/ui/legend.d.ts +57 -0
  208. package/dist/ui/level-meter.d.ts +28 -0
  209. package/dist/ui/load-more.d.ts +36 -0
  210. package/dist/ui/loading-state.d.ts +26 -0
  211. package/dist/ui/locale-switcher.d.ts +19 -0
  212. package/dist/ui/markdown.d.ts +29 -0
  213. package/dist/ui/marker.d.ts +13 -0
  214. package/dist/ui/media-card.d.ts +29 -0
  215. package/dist/ui/member-list.d.ts +43 -0
  216. package/dist/ui/member-list.js +107 -0
  217. package/dist/ui/menubar.d.ts +70 -0
  218. package/dist/ui/message-actions.d.ts +21 -0
  219. package/dist/ui/message-scroller.d.ts +46 -0
  220. package/dist/ui/message.d.ts +45 -0
  221. package/dist/ui/mfa-challenge.d.ts +4 -0
  222. package/dist/ui/mfa-setup.d.ts +29 -0
  223. package/dist/ui/mosaic.d.ts +38 -0
  224. package/dist/ui/motion-provider.d.ts +28 -0
  225. package/dist/ui/native-select.d.ts +32 -0
  226. package/dist/ui/navigation-menu.d.ts +15 -0
  227. package/dist/ui/next-step-card.d.ts +55 -0
  228. package/dist/ui/notice-review.d.ts +64 -0
  229. package/dist/ui/notifications.d.ts +81 -0
  230. package/dist/ui/oauth-consent.d.ts +54 -0
  231. package/dist/ui/onboarding-checklist.d.ts +38 -0
  232. package/dist/ui/onboarding-checklist.js +132 -0
  233. package/dist/ui/page-header.d.ts +64 -0
  234. package/dist/ui/page-loader.d.ts +40 -0
  235. package/dist/ui/page-shell.d.ts +25 -0
  236. package/dist/ui/pagination.d.ts +42 -0
  237. package/dist/ui/panel.d.ts +12 -0
  238. package/dist/ui/passkey-list.d.ts +17 -0
  239. package/dist/ui/password-input.d.ts +5 -0
  240. package/dist/ui/password-strength.d.ts +28 -0
  241. package/dist/ui/permission-matrix.d.ts +35 -0
  242. package/dist/ui/permission-matrix.js +89 -0
  243. package/dist/ui/plan-summary.d.ts +59 -0
  244. package/dist/ui/plan-summary.js +92 -0
  245. package/dist/ui/popover.d.ts +44 -0
  246. package/dist/ui/pricing-table.d.ts +29 -0
  247. package/dist/ui/progress.d.ts +9 -0
  248. package/dist/ui/proportion-bar.d.ts +52 -0
  249. package/dist/ui/quantity.d.ts +25 -0
  250. package/dist/ui/questionnaire.d.ts +62 -0
  251. package/dist/ui/radio-group.d.ts +8 -0
  252. package/dist/ui/reasoning.d.ts +24 -0
  253. package/dist/ui/resizable.d.ts +10 -0
  254. package/dist/ui/reveal.d.ts +28 -0
  255. package/dist/ui/scroll-area.d.ts +7 -0
  256. package/dist/ui/search-box.d.ts +32 -0
  257. package/dist/ui/select.d.ts +19 -0
  258. package/dist/ui/separator.d.ts +6 -0
  259. package/dist/ui/session-list.d.ts +19 -0
  260. package/dist/ui/session-timeout.d.ts +13 -0
  261. package/dist/ui/sheet.d.ts +53 -0
  262. package/dist/ui/shield.d.ts +35 -0
  263. package/dist/ui/show-more.d.ts +26 -0
  264. package/dist/ui/sidebar.d.ts +92 -0
  265. package/dist/ui/sign-out-dialog.d.ts +17 -0
  266. package/dist/ui/skeleton.d.ts +10 -0
  267. package/dist/ui/slider.d.ts +23 -0
  268. package/dist/ui/sparkline.d.ts +26 -0
  269. package/dist/ui/spinner.d.ts +5 -0
  270. package/dist/ui/stat-group.d.ts +40 -0
  271. package/dist/ui/stat.d.ts +90 -0
  272. package/dist/ui/status-badge.d.ts +39 -0
  273. package/dist/ui/status-hero.d.ts +30 -0
  274. package/dist/ui/step-dots.d.ts +22 -0
  275. package/dist/ui/step-flow.d.ts +48 -0
  276. package/dist/ui/step-ring.d.ts +26 -0
  277. package/dist/ui/stepper.d.ts +20 -0
  278. package/dist/ui/suggestions.d.ts +17 -0
  279. package/dist/ui/switch.d.ts +8 -0
  280. package/dist/ui/table.d.ts +38 -0
  281. package/dist/ui/tabs.d.ts +14 -0
  282. package/dist/ui/tag-input.d.ts +21 -0
  283. package/dist/ui/task-loader.d.ts +29 -0
  284. package/dist/ui/task-progress.d.ts +32 -0
  285. package/dist/ui/testimonial.d.ts +37 -0
  286. package/dist/ui/textarea.d.ts +32 -0
  287. package/dist/ui/theme-toggle.d.ts +14 -0
  288. package/dist/ui/timeline.d.ts +55 -0
  289. package/dist/ui/toast.d.ts +19 -0
  290. package/dist/ui/toggle-group.d.ts +38 -0
  291. package/dist/ui/toggle.d.ts +12 -0
  292. package/dist/ui/tool-call.d.ts +27 -0
  293. package/dist/ui/tooltip.d.ts +9 -0
  294. package/dist/ui/upgrade-prompt.d.ts +24 -0
  295. package/dist/ui/upgrade-prompt.js +85 -0
  296. package/dist/ui/usage-meter.d.ts +42 -0
  297. package/dist/ui/week-strip.d.ts +23 -0
  298. package/dist/ui/workflow-run.d.ts +51 -0
  299. package/dist/ui/workspace-switcher.d.ts +28 -0
  300. package/dist/ui/workspace-switcher.js +92 -0
  301. package/docs/GRAFICOS.md +1 -1
  302. package/docs/designer/patrones.md +29 -1
  303. package/manifest/actions.json +1 -1
  304. package/manifest/agents.json +1 -1
  305. package/manifest/ai.json +1 -1
  306. package/manifest/auth.json +1 -1
  307. package/manifest/chat.json +1 -1
  308. package/manifest/content.json +1 -1
  309. package/manifest/data.json +498 -1
  310. package/manifest/feedback.json +230 -43
  311. package/manifest/forms.json +1 -1
  312. package/manifest/motion.json +1 -1
  313. package/manifest/navigation.json +102 -1
  314. package/manifest/overlays.json +2 -2
  315. package/package.json +1 -11
  316. package/scripts/cli.mjs +63 -5
  317. package/scripts/doctor.mjs +5 -3
  318. package/scripts/skill.mjs +85 -0
  319. package/skill/SKILL.md +5 -2
  320. package/dist/ui/sonner.js +0 -60
package/AGENTS.md CHANGED
@@ -89,7 +89,7 @@ adivinar. Lee antes: `README.md`, `docs/CONTRACT.md`, `contract.json` y
89
89
  Nunca pongas colores en el `option`: los da el tema (si una serie necesita un tono, usa la paleta del tema).
90
90
  - **Tarjeta**: `<ChartCard preset="standard|glance|focus|dense" option={…} loading error empty />` (`orbital-ds/ui/chart-card`) pone título, estados, descarga y motor de pintado; el `option` sigue sin colores.
91
91
  - **Opciones listas**: `orbital-ds/lib/echarts-presets` (línea/área, barras, combo, mapa de calor, sankey,
92
- gauge, donut, dispersión, radar, embudo, treemap, sunburst, velas, boxplot, líneas y áreas de referencia). Sirven igual en pantalla y en informes.
92
+ gauge, donut, dispersión, radar, embudo, treemap, sunburst, velas, boxplot, cascada, cohortes, calendario, grafo, líneas y áreas de referencia). Sirven igual en pantalla y en informes.
93
93
  - **Informes automáticos (servidor / Workers, sin DOM)**: `renderEChartToSvg(option, { width, height, tokens })`
94
94
  (`orbital-ds/lib/echarts-server`) con `tokens` = `orbital-ds/themes/<tema>.tokens.json` → `.light` o
95
95
  `.dark` (colores ya resueltos; mezcla ahí los de la marca si la app tiene). Para PNG (plantillas de
@@ -153,14 +153,19 @@ la app (bloque de imports en orden), anota DESIGN.md, instala Motion y pasa el d
153
153
  ## Diseñar con orbital-ds (diseñador para agentes)
154
154
 
155
155
  Para crear o revisar pantallas y flujos, sigue `docs/designer/`: **flujo.md** (contexto real, modo, mapa del flujo y
156
- modelo mental de la persona, orden de autoridad), **patrones.md** (P1–P12: página, lista de entidades, detalle, tabla,
156
+ modelo mental de la persona, orden de autoridad), **patrones.md** (P1–P16: página, lista de entidades, detalle, tabla,
157
157
  formulario, asistente, panel de datos, destructiva, estados, avisos, búsqueda, ajustes), **criterio.md** (análisis visual en 8 pasos con puntuación, árbol «¿tarjeta, ítem, bento, imagen, efecto?», armonía, referentes Apple/Material/Nielsen/Polaris), **ux.md** (heurísticas,
158
158
  carga cognitiva, formularios, textos, WCAG 2.2 AA, responsivo) y **revision.md** (lista observable y anti-patrones).
159
159
  Regla de oro: **nunca te sales del sistema**; si algo no se puede hacer con componentes y variables, se anota como hueco.
160
160
 
161
161
  - `orbital-ds context` (o `--json`): el estado real de la app para un agente (tema, marca, extras, componentes con
162
162
  sus notas, patrones). Las notas de uso de cada componente se escriben en el propio fichero con `@note`.
163
- - `orbital-ds skill`: instala en la app el skill de Claude Code **orbital-ds-designer** (`.claude/skills/`). Es fino:
163
+ - `orbital-ds skill`: instala en la app tres piezas para Claude Code: el skill **orbital-ds-designer** (`.claude/skills/`,
164
+ se carga por su `description` + `when_to_use`), la regla «toda interfaz con orbital-ds» **siempre en contexto** (bloque
165
+ gestionado en `CLAUDE.md`; si la app solo tenía `AGENTS.md`, el `CLAUDE.md` nuevo lo importa con `@AGENTS.md`) y un
166
+ **hook PostToolUse** en `.claude/settings.json` que ejecuta `orbital-ds hook`: pasa el doctor por cada `.tsx`/`.jsx` o
167
+ `brand.css` editado y, si se sale del sistema, sale con 2 para que el modelo vea los errores y los corrija
168
+ (`--no-hook` lo omite). El skill es fino:
164
169
  lee esta documentación del paquete instalado, así que se actualiza con cada versión; `orbital-ds skill --check` en
165
170
  el verify avisa si quedó de otra versión. El asistente lo ofrece en sus extras.
166
171
 
@@ -185,6 +190,10 @@ en cualquier proyecto. Vocabulario común en `src/lib/presets.ts` (`DsDensity`,
185
190
  `MfaChallenge` (totp · sms · email · backup-code · passkey), `MfaSetup` (totp · sms · backup-codes), `OAuthConsent`
186
191
  (authorize · mcp · device), `ConnectedAccounts` (social · integrations) y el flujo entero con `defineAuthFlow`
187
192
  (standard · social · passwordless · partner · enterprise · hybrid · sso-staff · sso-only).
193
+ En **SaaS avanzado** (0.49): `OnboardingChecklist` (card · sidebar · page), `MemberList` (team · workspace · compact),
194
+ `ApiKeyList` (keys · tokens · webhooks), `AuditLog` (full · compact · entity), `PlanSummary` (overview · compact · trial),
195
+ `UpgradePrompt` (inline · card · banner · overlay), `WorkspaceSwitcher` (sidebar · menu · compact) y `PermissionMatrix`
196
+ (roles · review · scopes).
188
197
  `ErrorPage` y `EmptyState` aceptan además `backdrop` (+ `backdropMedia`, `backdropGlass`) y `animated`.
189
198
 
190
199
  **Densidad global.** `--ds-density` (1 por defecto; 0.8 más denso, 1.2 más aireado) escala el relleno de celdas y la separación de secciones y listas; la app lo ajusta en `brand.css`.
@@ -237,7 +246,7 @@ Se elige el canal por **urgencia** y **persistencia**; cada app no lo decide a m
237
246
 
238
247
  | Intención | Canal | Persiste | Interrumpe |
239
248
  |---|---|---|---|
240
- | Confirmar una acción de la persona | toast (`Toaster` + `toast.add`, de `orbital-ds/ui/toast`; `sonner` solo por compatibilidad) | no | no |
249
+ | Confirmar una acción de la persona | toast (`Toaster` + `toast.add`, de `orbital-ds/ui/toast`; `sonner` se retiró en 0.49.0) | no | no |
241
250
  | Aviso de una sección | `Alert` | sí | no |
242
251
  | Aviso que afecta a toda la página | `Banner` | hasta resolver | no |
243
252
  | Asunto con seguimiento o decisión | campana (`NotificationCenter`) + `NoticeReview` | sí, con estado | solo si es crítico |
package/CHANGELOG.md CHANGED
@@ -5,6 +5,37 @@ algo público (token, prop, componente, export), **menor** si se añade algo com
5
5
  token, opción) y **parche** si se corrige sin cambiar la API. En `0.x`, romper algo sube la menor.
6
6
  Las versiones anteriores a 0.14.0 están descritas en los mensajes de sus PR (#9, #11, #17, #19).
7
7
 
8
+ ## 0.50.0 — 2026-11-21
9
+
10
+ Menor (compatible). Que el agente use SIEMPRE orbital-ds para la interfaz, y que se compruebe solo.
11
+
12
+ - `orbital-ds skill` instala ahora tres piezas para Claude Code:
13
+ - el skill `orbital-ds-designer`, con `when_to_use` (frases de activación: pantalla, formulario, tabla, dashboard, tema, marca, artifact…) además de la `description`;
14
+ - la regla «toda interfaz con orbital-ds» siempre en contexto, en un bloque gestionado de `CLAUDE.md` (si la app solo tenía `AGENTS.md`, el `CLAUDE.md` nuevo lo importa con `@AGENTS.md` para que no deje de leerse);
15
+ - un hook `PostToolUse` (`Edit|Write|MultiEdit`) en `.claude/settings.json`, fusionado sin tocar el resto de ajustes. `--no-hook` lo omite.
16
+ - Nueva orden `orbital-ds hook`: Claude Code la llama tras cada edición. Pasa el doctor por el `.tsx`/`.jsx` (`--ui`) o `brand.css` (`--css`) editado. Si el fichero se sale del sistema, sale con 2 y el modelo ve los errores para corregirlos. Si solo hay avisos, los añade al contexto. Con cualquier otro fichero, no dice nada.
17
+ - `orbital-ds skill --check` falla también si falta la regla en `CLAUDE.md` o el hook.
18
+ - `orbital-ds doctor --ui` acepta un fichero suelto además de una carpeta.
19
+ - `docs/designer/patrones.md`: nuevo **P16 · Cuenta y organización (SaaS)**, que dice qué pieza usar en primeros pasos, equipo, permisos, plan, mejora de plan, API, actividad y espacio de trabajo. P12 (Ajustes) remite a P16.
20
+ - Para tenerlo en una app: `pnpm exec orbital-ds skill` (de nuevo, si ya estaba instalado).
21
+
22
+ ## 0.49.0 — 2026-11-21
23
+
24
+ Menor que rompe (en `0.x`, romper sube la menor). Un solo canal de toast y piezas de SaaS avanzado.
25
+
26
+ - Se quita `orbital-ds/ui/sonner` y `sonner` y `next-themes` dejan de ser dependencias opcionales. Usa `Toaster` y `toast.add` de `orbital-ds/ui/toast`. El doctor (`--ui`) marca como error cualquier import de `orbital-ds/ui/sonner`.
27
+ - **ECharts**: presets nuevos en `orbital-ds/lib/echarts-presets`: `waterfallOption` (cascada: puente de ingresos o MRR), `cohortOption` (retención por cohortes), `calendarOption` (actividad diaria en calendario) y `graphOption` (relaciones y dependencias). Sin colores en el `option`; `pnpm check:charts` los dibuja en servidor (18 constructores).
28
+ - **Componentes de SaaS avanzado**, todos con presets, textos en los siete catálogos y demo:
29
+ - `OnboardingChecklist` (card · sidebar · page): primeros pasos con progreso, paso actual con su acción y pasos opcionales.
30
+ - `MemberList` (team · workspace · compact): miembros con rol editable, estado e invitaciones pendientes.
31
+ - `ApiKeyList` (keys · tokens · webhooks): claves, tokens y webhooks con uso, caducidad, estado y el secreto recién creado visible una sola vez.
32
+ - `AuditLog` (full · compact · entity): quién hizo qué, sobre qué y cuándo, agrupado por día.
33
+ - `PlanSummary` (overview · compact · trial): plan, estado de la suscripción, renovación o fin de la prueba y uso frente a lo contratado.
34
+ - `UpgradePrompt` (inline · card · banner · overlay): función fuera del plan con el plan que la incluye; `overlay` bloquea lo que cubre.
35
+ - `WorkspaceSwitcher` (sidebar · menu · compact): cambio de espacio u organización con «Crear espacio».
36
+ - `PermissionMatrix` (roles · review · scopes): permisos por rol editables, de solo lectura o de un único rol o token.
37
+ - Tokens nuevos de medida: `--ds-onboarding-*`, `--ds-plan-*`, `--ds-upgrade-*`, `--ds-audit-*`, `--ds-permission-*` y `--ds-workspace-*`.
38
+
8
39
  ## 0.48.0 — 2026-11-21
9
40
 
10
41
  Menor que rompe (en `0.x`, romper sube la menor). Una sola librería de gráficos: ECharts.
package/README.md CHANGED
@@ -88,7 +88,7 @@ pnpm check:ds # solo el contrato de tema y los valores fijos
88
88
 
89
89
  Peers obligatorios: `react`, `react-dom`, `@base-ui/react`, `tailwindcss`, `tailwind-merge`,
90
90
  `class-variance-authority`, `clsx`, `lucide-react`, `tw-animate-css`.
91
- Opcionales (solo si usas ese componente): `echarts`, `sonner`, `next-themes`, `cmdk`,
91
+ Opcionales (solo si usas ese componente): `echarts`, `cmdk`,
92
92
  `date-fns` + `react-day-picker`, `embla-carousel-react`, `input-otp`,
93
93
  `react-resizable-panels`, `@shadcn/react`.
94
94
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.48.0",
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",
@@ -3695,6 +3788,52 @@
3695
3788
  "Un solo `action` por tarjeta (reproducir/abrir); lleva su aria-label, que la tarjeta no lo pone."
3696
3789
  ]
3697
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
+ },
3698
3837
  "menubar": {
3699
3838
  "import": "orbital-ds/ui/menubar",
3700
3839
  "group": "navigation",
@@ -4318,6 +4457,57 @@
4318
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."
4319
4458
  ]
4320
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
+ },
4321
4511
  "page-header": {
4322
4512
  "import": "orbital-ds/ui/page-header",
4323
4513
  "group": "navigation",
@@ -4640,6 +4830,101 @@
4640
4830
  "Solo al crear o cambiar la contraseña, nunca al iniciar sesión."
4641
4831
  ]
4642
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
+ },
4643
4928
  "popover": {
4644
4929
  "import": "orbital-ds/ui/popover",
4645
4930
  "group": "overlays",
@@ -5518,38 +5803,6 @@
5518
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."
5519
5804
  ]
5520
5805
  },
5521
- "sonner": {
5522
- "import": "orbital-ds/ui/sonner",
5523
- "group": "feedback",
5524
- "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).",
5525
- "see": [
5526
- {
5527
- "component": "toast",
5528
- "when": "el canal OFICIAL de avisos efímeros (Base UI, sin dependencias), con `toast.add(...)`"
5529
- },
5530
- {
5531
- "component": "alert",
5532
- "when": "aviso que debe quedarse visible en la sección"
5533
- },
5534
- {
5535
- "component": "notifications",
5536
- "when": "asunto con seguimiento (campana)"
5537
- }
5538
- ],
5539
- "exports": [
5540
- "Toaster"
5541
- ],
5542
- "slots": [],
5543
- "optionalPeers": [
5544
- "next-themes",
5545
- "sonner"
5546
- ],
5547
- "notes": [
5548
- "Un solo Toaster en la raíz; `toast` se importa de `sonner`. Necesita `sonner` y `next-themes` instalados.",
5549
- "Elige un canal de toasts para toda la app: este Toaster o el de `toast` (Base UI), no los dos.",
5550
- "OBSOLETO: se retirará en la próxima versión que rompa compatibilidad; migra a `toast` (Base UI). El doctor (`--ui`) avisa de cada import."
5551
- ]
5552
- },
5553
5806
  "sparkline": {
5554
5807
  "import": "orbital-ds/ui/sparkline",
5555
5808
  "group": "data",
@@ -6343,10 +6596,6 @@
6343
6596
  "group": "feedback",
6344
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.",
6345
6598
  "see": [
6346
- {
6347
- "component": "sonner",
6348
- "when": "solo si la app ya usa la librería sonner (compatibilidad)"
6349
- },
6350
6599
  {
6351
6600
  "component": "alert",
6352
6601
  "when": "aviso que debe quedarse visible en la sección"
@@ -6516,6 +6765,56 @@
6516
6765
  "No existe en táctil: nada imprescindible puede vivir solo en un tooltip."
6517
6766
  ]
6518
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
+ },
6519
6818
  "usage-meter": {
6520
6819
  "import": "orbital-ds/ui/usage-meter",
6521
6820
  "group": "data",
@@ -6611,6 +6910,53 @@
6611
6910
  "notes": [
6612
6911
  "Para ver cómo avanza un agente o una automatización; la app traduce su motor (Workflows, colas…) a `WorkflowNode`."
6613
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
+ ]
6614
6960
  }
6615
6961
  },
6616
6962
  "pages": {