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
@@ -0,0 +1,46 @@
1
+ import * as React from 'react';
2
+ import * as echarts from 'echarts/core';
3
+ import { EChartsCoreOption } from 'echarts/core';
4
+ export { EChartsCoreOption as DsEChartOption } from 'echarts/core';
5
+
6
+ /**
7
+ * @group data
8
+ * @summary Lienzo de Apache ECharts que toma colores, fuentes y ritmo del tema activo y se repinta al cambiarlo. Para un gráfico dentro de tu propia maqueta; en un panel, mejor ChartCard.
9
+ * @see chart-card — gráfico en tarjeta con título, cargando, error, vacío y descarga
10
+ * @see sparkline — tendencia mínima en línea, sin ejes, junto a una cifra
11
+ * @see heatmap-grid — mapa de calor día × hora accesible como tabla navegable
12
+ * @example Línea con un constructor de echarts-presets (sin colores)
13
+ * <EChart
14
+ * option={lineOption({ categories: ["08:00", "09:00", "10:00"], series: [{ name: "Entrantes", data: [120, 310, 420] }] })}
15
+ * height={280}
16
+ * />
17
+ * @example Descargable en SVG/PNG
18
+ * <EChart option={option} height={280} exportable fileName="volumen-llamadas" />
19
+ */
20
+
21
+ interface EChartHandle {
22
+ /** Instancia de ECharts (para eventos o acciones avanzadas). */
23
+ getInstance(): ReturnType<typeof echarts.init> | null;
24
+ /** SVG del gráfico tal como se ve (solo con renderer SVG). */
25
+ toSvg(): string | null;
26
+ /** Descarga el gráfico como SVG o PNG. */
27
+ download(type?: "svg" | "png", fileName?: string): void;
28
+ }
29
+ interface EChartProps extends Omit<React.ComponentProps<"div">, "ref"> {
30
+ option: EChartsCoreOption;
31
+ /** Alto del gráfico (cualquier medida CSS). El ancho es el del contenedor. */
32
+ height?: string | number;
33
+ renderer?: "svg" | "canvas";
34
+ /** Reemplaza las series en vez de fusionarlas al cambiar `option`. */
35
+ notMerge?: boolean;
36
+ /** Muestra los botones de descargar SVG y PNG. */
37
+ exportable?: boolean;
38
+ fileName?: string;
39
+ /** Sin datos: muestra el texto «Sin datos» en lugar del gráfico. */
40
+ empty?: boolean;
41
+ /** Eventos de ECharts: { click: (p) => …, legendselectchanged: … } */
42
+ onEvents?: Record<string, (params: unknown) => void>;
43
+ }
44
+ declare const EChart: React.ForwardRefExoticComponent<EChartProps & React.RefAttributes<EChartHandle>>;
45
+
46
+ export { EChart, type EChartHandle, type EChartProps };
@@ -0,0 +1,26 @@
1
+ import * as React from 'react';
2
+ import { AuthBackdropVariant } from './auth-backdrop.js';
3
+ import { Empty } from './empty.js';
4
+ import 'class-variance-authority/types';
5
+ import 'class-variance-authority';
6
+
7
+ type EmptyStatePreset = "first-use" | "no-results" | "error" | "forbidden";
8
+ declare function EmptyState({ preset, title, description, icon, action, backdrop, backdropMedia, backdropGlass, animated, className, children, ...props }: Omit<React.ComponentProps<typeof Empty>, "title"> & {
9
+ preset?: EmptyStatePreset;
10
+ title?: React.ReactNode;
11
+ description?: React.ReactNode;
12
+ /** Sustituye el icono del preset. */
13
+ icon?: React.ReactNode;
14
+ /** Acción principal (botón o enlace); la pone la app. */
15
+ action?: React.ReactNode;
16
+ /** Fondo decorativo detrás (ver AuthBackdrop): mesh, aurora, dots, image… Por defecto, ninguno. */
17
+ backdrop?: AuthBackdropVariant;
18
+ /** backdrop="image": la foto o el vídeo (un <img>/<video> con alt=""), teñido de marca. */
19
+ backdropMedia?: React.ReactNode;
20
+ /** Cristal esmerilado sobre el fondo («mesh + glass»). */
21
+ backdropGlass?: boolean;
22
+ /** Entrada en cascada y el icono flotando con el ritmo del tema (quieto con movimiento reducido). */
23
+ animated?: boolean;
24
+ }): React.JSX.Element;
25
+
26
+ export { EmptyState, type EmptyStatePreset };
@@ -0,0 +1,15 @@
1
+ import * as class_variance_authority_types from 'class-variance-authority/types';
2
+ import * as React$1 from 'react';
3
+ import { VariantProps } from 'class-variance-authority';
4
+
5
+ declare function Empty({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
6
+ declare function EmptyHeader({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
7
+ declare const emptyMediaVariants: (props?: ({
8
+ variant?: "icon" | "default" | null | undefined;
9
+ } & class_variance_authority_types.ClassProp) | undefined) => string;
10
+ declare function EmptyMedia({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof emptyMediaVariants>): React$1.JSX.Element;
11
+ declare function EmptyTitle({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
12
+ declare function EmptyDescription({ className, ...props }: React.ComponentProps<"p">): React$1.JSX.Element;
13
+ declare function EmptyContent({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
14
+
15
+ export { Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle };
@@ -0,0 +1,57 @@
1
+ import * as React from 'react';
2
+
3
+ /**
4
+ * @group data
5
+ * @summary Lista de entidades (agentes, herramientas, dispositivos) con cargando, error y vacío resueltos; cada fila es un Item variant="card". Para comparar muchas filas por columnas, DataTable.
6
+ * @see data-table — muchas filas que se ordenan, filtran y comparan por columnas
7
+ * @see item — una sola fila o tarjeta de entidad, sin estados de lista
8
+ * @see load-more — pedir más elementos al final de una lista larga
9
+ * @example Preset list (por defecto)
10
+ * <EntityList
11
+ * items={agents}
12
+ * getKey={(a) => a.id}
13
+ * renderItem={(a) => (
14
+ * <Item variant="card">
15
+ * <ItemContent>
16
+ * <ItemTitle>{a.name}</ItemTitle>
17
+ * <ItemDescription>{a.description}</ItemDescription>
18
+ * </ItemContent>
19
+ * </Item>
20
+ * )}
21
+ * />
22
+ * @example Preset grid con estados y filtros
23
+ * <EntityList
24
+ * preset="grid"
25
+ * items={agents}
26
+ * getKey={(a) => a.id}
27
+ * renderItem={renderAgent}
28
+ * loading={isLoading}
29
+ * error={error}
30
+ * onRetry={refetch}
31
+ * filtered={hasFilters}
32
+ * />
33
+ */
34
+
35
+ type EntityListPreset = "list" | "grid" | "compact";
36
+ declare function EntityList<T>({ items, getKey, renderItem, preset, toolbar, bulk, loading, error, onRetry, filtered, emptyAction, skeletonCount, className, }: {
37
+ items: readonly T[];
38
+ getKey: (item: T) => string | number;
39
+ renderItem: (item: T) => React.ReactNode;
40
+ preset?: EntityListPreset;
41
+ /** Barra superior (FilterBar, buscador…). */
42
+ toolbar?: React.ReactNode;
43
+ /** Barra de acciones en lote (aparece cuando la app tiene filas seleccionadas); la app decide cuándo pasarla. */
44
+ bulk?: React.ReactNode;
45
+ loading?: boolean;
46
+ /** Si hay error, se muestra en lugar de la lista. */
47
+ error?: unknown;
48
+ onRetry?: () => void;
49
+ /** Hay filtros o búsqueda activos (distingue «sin resultados» de «primer uso»). */
50
+ filtered?: boolean;
51
+ /** Acción del estado vacío (crear la primera, quitar filtros…). */
52
+ emptyAction?: React.ReactNode;
53
+ skeletonCount?: number;
54
+ className?: string;
55
+ }): React.JSX.Element;
56
+
57
+ export { EntityList, type EntityListPreset };
@@ -0,0 +1,28 @@
1
+ import * as React from 'react';
2
+ import { AuthBackdropVariant } from './auth-backdrop.js';
3
+
4
+ type ErrorPagePreset = "not-found" | "forbidden" | "server-error" | "offline" | "maintenance";
5
+ type ErrorPageTone = "neutral" | "playful";
6
+ declare function ErrorPage({ preset, tone, code, title, description, illustration, actions, backdrop, backdropMedia, backdropGlass, animated, className, style, ...props }: Omit<React.ComponentProps<"main">, "title"> & {
7
+ preset?: ErrorPagePreset;
8
+ /** Tono de los textos por defecto. */
9
+ tone?: ErrorPageTone;
10
+ /** Número grande (404, 500…); `null` lo oculta. */
11
+ code?: string | null;
12
+ title?: React.ReactNode;
13
+ description?: React.ReactNode;
14
+ /** Sustituye el icono del preset. */
15
+ illustration?: React.ReactNode;
16
+ /** Botones o enlaces de la app; el primero es el principal. */
17
+ actions?: React.ReactNode;
18
+ /** Fondo decorativo detrás (ver AuthBackdrop): mesh, aurora, dots, image… Por defecto, ninguno. */
19
+ backdrop?: AuthBackdropVariant;
20
+ /** backdrop="image": la foto o el vídeo (un <img>/<video> con alt=""), teñido de marca. */
21
+ backdropMedia?: React.ReactNode;
22
+ /** Cristal esmerilado sobre el fondo («mesh + glass»). */
23
+ backdropGlass?: boolean;
24
+ /** Entrada en cascada y el icono flotando con el ritmo del tema (quieto con movimiento reducido). */
25
+ animated?: boolean;
26
+ }): React.JSX.Element;
27
+
28
+ export { ErrorPage, type ErrorPagePreset, type ErrorPageTone };
@@ -0,0 +1,16 @@
1
+ import * as React from 'react';
2
+ import { EmptyState } from './empty-state.js';
3
+ import './auth-backdrop.js';
4
+ import './empty.js';
5
+ import 'class-variance-authority/types';
6
+ import 'class-variance-authority';
7
+
8
+ declare function ErrorState({ onRetry, retrying, retryLabel, action, ...props }: Omit<React.ComponentProps<typeof EmptyState>, "preset"> & {
9
+ /** Reintenta la carga. Sin ella no se pinta el botón. */
10
+ onRetry?: () => void | Promise<void>;
11
+ /** Está reintentando: bloquea el botón. */
12
+ retrying?: boolean;
13
+ retryLabel?: React.ReactNode;
14
+ }): React.JSX.Element;
15
+
16
+ export { ErrorState };
@@ -0,0 +1,7 @@
1
+ import * as React from 'react';
2
+ import { useRender } from '@base-ui/react/use-render';
3
+
4
+ declare const eyebrowClassName = "text-xs leading-tight font-(--ds-label-weight) tracking-(--ds-label-tracking) text-muted-foreground uppercase";
5
+ declare function Eyebrow({ className, render, ...props }: useRender.ComponentProps<"p">): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
6
+
7
+ export { Eyebrow, eyebrowClassName };
@@ -0,0 +1,34 @@
1
+ import * as React from 'react';
2
+ import { Accordion } from './accordion.js';
3
+ import '@base-ui/react/accordion';
4
+
5
+ /**
6
+ * @group content
7
+ * @summary Preguntas frecuentes de una web pública o de una ayuda: lista desplegable de pregunta y respuesta, con datos estructurados opcionales para buscadores.
8
+ * @see accordion — paneles desplegables de cualquier contenido (ajustes, detalles)
9
+ * @see landing-section — la sección con título que la envuelve en una portada
10
+ * @example Preguntas de una portada
11
+ * <Faq
12
+ * items={[
13
+ * { question: "¿Puedo cancelar cuando quiera?", answer: "Sí, desde Ajustes y sin permanencia." },
14
+ * { question: "¿Hay periodo de prueba?", answer: "14 días con todas las funciones." },
15
+ * ]}
16
+ * />
17
+ * @example Varias abiertas y con datos estructurados
18
+ * <Faq multiple structuredData defaultValue={["prueba"]} items={[{ value: "prueba", question: "¿Hay periodo de prueba?", answer: "14 días." }]} />
19
+ */
20
+
21
+ type FaqItem = {
22
+ question: React.ReactNode;
23
+ answer: React.ReactNode;
24
+ /** Identificador para abrirla con `defaultValue`/`value`; por defecto, su índice. */
25
+ value?: string;
26
+ };
27
+ type FaqProps = Omit<React.ComponentProps<typeof Accordion>, "children"> & {
28
+ items: FaqItem[];
29
+ /** JSON-LD FAQPage (schema.org) para que los buscadores muestren las preguntas. */
30
+ structuredData?: boolean;
31
+ };
32
+ declare function Faq({ items, structuredData, className, ...props }: FaqProps): React.JSX.Element;
33
+
34
+ export { Faq, type FaqItem, type FaqProps };
@@ -0,0 +1,40 @@
1
+ import * as React from 'react';
2
+ import { IconTile } from './icon-tile.js';
3
+ import 'class-variance-authority/types';
4
+ import 'class-variance-authority';
5
+
6
+ /**
7
+ * @group content
8
+ * @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.
9
+ * @see content-card — tarjetas con imagen o enlace a otra página
10
+ * @see mosaic — rejilla bento de bloques de distinto tamaño
11
+ * @example Tres ventajas
12
+ * <FeatureGrid>
13
+ * <Feature icon={<ZapIcon />} title="Rápido" description="Respuestas en milisegundos." />
14
+ * <Feature icon={<ShieldIcon />} title="Seguro" description="Cifrado de extremo a extremo." />
15
+ * <Feature icon={<PlugIcon />} title="Conectado" description="Más de 50 integraciones." />
16
+ * </FeatureGrid>
17
+ * @example En tarjetas, a cuatro columnas
18
+ * <FeatureGrid columns={4} variant="card">
19
+ * <Feature icon={<ZapIcon />} title="Rápido" description="Respuestas en milisegundos." />
20
+ * </FeatureGrid>
21
+ */
22
+
23
+ type FeatureGridProps = React.ComponentProps<"ul"> & {
24
+ /** Columnas en un contenedor ancho. */
25
+ columns?: 2 | 3 | 4;
26
+ variant?: "plain" | "card";
27
+ align?: "start" | "center";
28
+ };
29
+ declare function FeatureGrid({ columns, variant, align, className, ...props }: FeatureGridProps): React.JSX.Element;
30
+ type FeatureProps = Omit<React.ComponentProps<"li">, "title"> & {
31
+ /** Icono (svg) en una baldosa. */
32
+ icon?: React.ReactNode;
33
+ iconTone?: React.ComponentProps<typeof IconTile>["tone"];
34
+ /** Nombre de la característica. No es el atributo HTML `title`. */
35
+ title: React.ReactNode;
36
+ description?: React.ReactNode;
37
+ };
38
+ declare function Feature({ icon, iconTone, title, description, className, children, ...props }: FeatureProps): React.JSX.Element;
39
+
40
+ export { Feature, FeatureGrid, type FeatureGridProps, type FeatureProps };
@@ -0,0 +1,28 @@
1
+ import * as class_variance_authority_types from 'class-variance-authority/types';
2
+ import * as React$1 from 'react';
3
+ import { VariantProps } from 'class-variance-authority';
4
+ import { Label } from './label.js';
5
+
6
+ declare function FieldSet({ className, ...props }: React.ComponentProps<"fieldset">): React$1.JSX.Element;
7
+ declare function FieldLegend({ className, variant, ...props }: React.ComponentProps<"legend"> & {
8
+ variant?: "legend" | "label";
9
+ }): React$1.JSX.Element;
10
+ declare function FieldGroup({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
11
+ declare const fieldVariants: (props?: ({
12
+ orientation?: "vertical" | "horizontal" | "responsive" | null | undefined;
13
+ } & class_variance_authority_types.ClassProp) | undefined) => string;
14
+ declare function Field({ className, orientation, ...props }: React.ComponentProps<"div"> & VariantProps<typeof fieldVariants>): React$1.JSX.Element;
15
+ declare function FieldContent({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
16
+ declare function FieldLabel({ className, ...props }: React.ComponentProps<typeof Label>): React$1.JSX.Element;
17
+ declare function FieldTitle({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
18
+ declare function FieldDescription({ className, ...props }: React.ComponentProps<"p">): React$1.JSX.Element;
19
+ declare function FieldSeparator({ children, className, ...props }: React.ComponentProps<"div"> & {
20
+ children?: React.ReactNode;
21
+ }): React$1.JSX.Element;
22
+ declare function FieldError({ className, children, errors, ...props }: React.ComponentProps<"div"> & {
23
+ errors?: Array<{
24
+ message?: string;
25
+ } | undefined>;
26
+ }): React$1.JSX.Element | null;
27
+
28
+ export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle };
@@ -0,0 +1,42 @@
1
+ import * as React from 'react';
2
+
3
+ type FileUploadPreset = "drop" | "button";
4
+ type FileUploadStatus = "ready" | "uploading" | "done" | "error";
5
+ type FileUploadItem = {
6
+ id: string;
7
+ file: File;
8
+ status: FileUploadStatus;
9
+ /** 0–100 */
10
+ progress: number;
11
+ /** Mensaje si `status` es `error`. */
12
+ error?: string;
13
+ };
14
+ type FileUploadFn = (file: File, onProgress: (percent: number) => void, signal: AbortSignal) => Promise<unknown>;
15
+ declare function FileUpload({ preset, files, onFilesChange, upload, accept, maxSize, maxFiles, multiple, disabled, title, hint, description, icon, label, name, id, className, }: {
16
+ preset?: FileUploadPreset;
17
+ /** Lista controlada. Sin ella, el componente la guarda. */
18
+ files?: FileUploadItem[];
19
+ onFilesChange?: (files: FileUploadItem[]) => void;
20
+ /** Sube un fichero; la pone la app. Sin ella, solo recoge. */
21
+ upload?: FileUploadFn;
22
+ /** Tipos admitidos, con la sintaxis de `<input accept>`. */
23
+ accept?: string;
24
+ /** Tamaño máximo por fichero, en bytes. */
25
+ maxSize?: number;
26
+ /** Máximo de ficheros en la lista. */
27
+ maxFiles?: number;
28
+ multiple?: boolean;
29
+ disabled?: boolean;
30
+ title?: React.ReactNode;
31
+ hint?: React.ReactNode;
32
+ /** Texto de la app (p. ej. «PDF o imagen, hasta 10 MB»). */
33
+ description?: React.ReactNode;
34
+ icon?: React.ReactNode;
35
+ /** Texto del botón (preset `button`). */
36
+ label?: React.ReactNode;
37
+ name?: string;
38
+ id?: string;
39
+ className?: string;
40
+ }): React.JSX.Element;
41
+
42
+ export { FileUpload, type FileUploadFn, type FileUploadItem, type FileUploadPreset, type FileUploadStatus };
@@ -0,0 +1,38 @@
1
+ import * as React from 'react';
2
+
3
+ type FilterBarPreset = "inline" | "compact" | "stacked";
4
+ declare function FilterBar({ preset, className, children, actions, onClear, canClear, ...props }: React.ComponentProps<"div"> & {
5
+ preset?: FilterBarPreset;
6
+ /** Acciones de la vista (exportar, guardar vista…), al final de la fila. */
7
+ actions?: React.ReactNode;
8
+ /** Si se pasa, muestra «Quitar filtros». */
9
+ onClear?: () => void;
10
+ /** Hay algo que quitar: si es false, «Quitar filtros» se oculta. */
11
+ canClear?: boolean;
12
+ }): React.JSX.Element;
13
+ type FilterOption = {
14
+ value: string;
15
+ label: React.ReactNode;
16
+ icon?: React.ReactNode;
17
+ disabled?: boolean;
18
+ };
19
+ declare function FilterMenu({ className, label, icon, value, onValueChange, options, allOption, disabled, disabledReason, size, align, id, }: {
20
+ className?: string;
21
+ /** Nombre del filtro («Campaña»): va siempre en el disparador. */
22
+ label: React.ReactNode;
23
+ icon?: React.ReactNode;
24
+ /** Valor elegido; `null`/`undefined` = sin filtro («Todos»). */
25
+ value?: string | null;
26
+ onValueChange?: (value: string | null) => void;
27
+ options: FilterOption[];
28
+ /** Añade la opción «Todos» (o con este texto) que quita el filtro. */
29
+ allOption?: boolean | string;
30
+ disabled?: boolean;
31
+ /** Desactiva el filtro y explica el motivo (Tooltip + texto accesible). */
32
+ disabledReason?: React.ReactNode;
33
+ size?: "sm" | "default";
34
+ align?: "start" | "center" | "end";
35
+ id?: string;
36
+ }): React.JSX.Element;
37
+
38
+ export { FilterBar, type FilterBarPreset, FilterMenu, type FilterOption };
@@ -0,0 +1,43 @@
1
+ import * as React from 'react';
2
+
3
+ /**
4
+ * @group forms
5
+ * @summary Maqueta de un formulario o pantalla de ajustes: secciones y barra Guardar/Descartar resueltas, en una columna o con títulos al lado.
6
+ * @see field — cada campo dentro de las secciones
7
+ * @see step-flow — un formulario largo repartido en pasos
8
+ * @see filter-bar — filtros de una lista, no un formulario que se guarda
9
+ * @example Preset inline (alta corta)
10
+ * <FormLayout preset="inline" onSave={crear}>
11
+ * <Field>
12
+ * <FieldLabel htmlFor="name">Nombre</FieldLabel>
13
+ * <Input id="name" />
14
+ * </Field>
15
+ * </FormLayout>
16
+ * @example Preset settings (barra solo con cambios)
17
+ * <FormLayout preset="settings" dirty={dirty} onSave={guardar} onDiscard={descartar}>
18
+ * <FormSection title="General" description="Datos básicos de la organización.">
19
+ * <Field>
20
+ * <FieldLabel htmlFor="org">Nombre</FieldLabel>
21
+ * <Input id="org" value={nombre} onChange={(e) => setNombre(e.target.value)} />
22
+ * </Field>
23
+ * </FormSection>
24
+ * </FormLayout>
25
+ */
26
+
27
+ type FormLayoutPreset = "inline" | "sectioned" | "settings";
28
+ declare function FormLayout({ preset, dirty, saving, onSave, onDiscard, saveLabel, discardLabel, className, children, ...props }: Omit<React.ComponentProps<"form">, "onSubmit"> & {
29
+ preset?: FormLayoutPreset;
30
+ /** Hay cambios sin guardar (obligatorio para que `settings` muestre su barra). */
31
+ dirty?: boolean;
32
+ saving?: boolean;
33
+ onSave?: () => void | Promise<void>;
34
+ onDiscard?: () => void;
35
+ saveLabel?: React.ReactNode;
36
+ discardLabel?: React.ReactNode;
37
+ }): React.JSX.Element;
38
+ declare function FormSection({ title, description, className, children, ...props }: Omit<React.ComponentProps<"section">, "title"> & {
39
+ title: React.ReactNode;
40
+ description?: React.ReactNode;
41
+ }): React.JSX.Element;
42
+
43
+ export { FormLayout, type FormLayoutPreset, FormSection };
@@ -0,0 +1,66 @@
1
+ import * as React from 'react';
2
+ import { DsDataTone } from './legend.js';
3
+
4
+ /**
5
+ * @group data
6
+ * @summary Un valor sobre un máximo en anillo o arco, con la cifra en el centro y etiqueta de estado (riesgo, puntuación, reparto en tramos). Para uso frente a lo contratado, UsageMeter.
7
+ * @see usage-meter — uso frente a un límite contratado (almacenamiento, puestos), con aviso al 80 %
8
+ * @see level-meter — un nivel en porcentaje con su categoría y rango, sin anillo
9
+ * @see proportion-bar — parte frente al total o reparto en una barra horizontal
10
+ * @example Anillo con cifra y etiqueta de estado
11
+ * <Gauge value={540} max={1000} tone="warning" label="Riesgo">
12
+ * <GaugeValue>
13
+ * 540<GaugeSuffix>/1.000</GaugeSuffix>
14
+ * </GaugeValue>
15
+ * <GaugeTag>Riesgo medio</GaugeTag>
16
+ * </Gauge>
17
+ * @example Arco con escala
18
+ * <Gauge shape="semi" value={82} tone="success" label="Puntuación">
19
+ * <GaugeValue>82</GaugeValue>
20
+ * <GaugeTag>Bajo</GaugeTag>
21
+ * </Gauge>
22
+ * <GaugeScale min="Alto" max="Bajo" />
23
+ * @example Tramos con leyenda
24
+ * <Gauge label="Dispositivos" max={10} segments={[{ value: 6, tone: "success", label: "Protegidos" }, { value: 4, tone: "danger", label: "En peligro" }]}>
25
+ * <GaugeValue>10</GaugeValue>
26
+ * <GaugeCaption>dispositivos</GaugeCaption>
27
+ * </Gauge>
28
+ */
29
+
30
+ type GaugeShape = "ring" | "semi";
31
+ interface GaugeSegment {
32
+ value: number;
33
+ tone?: DsDataTone;
34
+ label?: string;
35
+ }
36
+ declare function Gauge({ value, max, shape, tone, segments, label, valueText, className, children, ...props }: React.ComponentProps<"div"> & {
37
+ /** Valor (0–max). Con `segments` se ignora. `null` = sin dato. */
38
+ value?: number | null;
39
+ max?: number;
40
+ shape?: GaugeShape;
41
+ tone?: DsDataTone;
42
+ segments?: GaugeSegment[];
43
+ /** Nombre accesible del indicador («Riesgo», «Puntuación»…). */
44
+ label?: string;
45
+ /** Texto accesible del valor (por defecto, el porcentaje). */
46
+ valueText?: string;
47
+ }): React.JSX.Element;
48
+ /** Cifra central. */
49
+ declare function GaugeValue({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
50
+ /** Sufijo de la cifra («/1.000», «pts»). */
51
+ declare function GaugeSuffix({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
52
+ /** Etiqueta del estado, sobre el fondo suave del tono del indicador. */
53
+ declare function GaugeTag({ className, style, tone, ...props }: React.ComponentProps<"span"> & {
54
+ tone?: DsDataTone;
55
+ }): React.JSX.Element;
56
+ /** Texto pequeño bajo la cifra. */
57
+ declare function GaugeCaption({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
58
+ /** Escala bajo un arco: mínimo y máximo, cada uno con su tono. */
59
+ declare function GaugeScale({ min, max, minTone, maxTone, className, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
60
+ min: React.ReactNode;
61
+ max: React.ReactNode;
62
+ minTone?: DsDataTone;
63
+ maxTone?: DsDataTone;
64
+ }): React.JSX.Element;
65
+
66
+ export { Gauge, GaugeCaption, GaugeScale, type GaugeSegment, type GaugeShape, GaugeSuffix, GaugeTag, GaugeValue };
@@ -0,0 +1,33 @@
1
+ import * as React from 'react';
2
+
3
+ /**
4
+ * @group ai
5
+ * @summary Imagen creada por IA dentro de un mensaje, con sus estados (generando, lista con descargar y regenerar, error) y la proporción fija para que la página no salte.
6
+ * @see media-card — imagen de contenido de la app, no generada
7
+ * @see aspect-ratio — cualquier imagen con proporción fija
8
+ * @example Imagen lista
9
+ * <GeneratedImage
10
+ * status="done"
11
+ * src={url}
12
+ * alt="Un faro al amanecer sobre el mar"
13
+ * prompt={prompt}
14
+ * ratio="16/9"
15
+ * downloadName="faro.png"
16
+ * onRetry={regenerate}
17
+ * />
18
+ * @example Generando
19
+ * <GeneratedImage status="loading" alt="Un faro al amanecer" ratio="1/1" />
20
+ */
21
+
22
+ declare function GeneratedImage({ status, src, alt, prompt, ratio, downloadName, onRetry, className, style, ...props }: Omit<React.ComponentProps<"figure">, "children"> & {
23
+ status?: "loading" | "done" | "error";
24
+ src?: string;
25
+ alt: string;
26
+ prompt?: string;
27
+ /** Proporción del hueco, p. ej. `"1/1"`, `"16/9"`. */
28
+ ratio?: string;
29
+ downloadName?: string;
30
+ onRetry?: () => void;
31
+ }): React.JSX.Element;
32
+
33
+ export { GeneratedImage };
@@ -0,0 +1,29 @@
1
+ import * as React from 'react';
2
+
3
+ /**
4
+ * @group ai
5
+ * @summary Tabla de solo lectura que produce una herramienta del agente dentro de un mensaje, con descarga CSV opcional; para ordenar, filtrar o paginar, DataTable.
6
+ * @see data-table — tabla de la app con orden, filtros y paginación
7
+ * @see table — tabla estática que la app compone a mano
8
+ * @example Resultado descargable
9
+ * <GeneratedTable
10
+ * caption="Planes disponibles"
11
+ * columns={["Plan", "Precio"]}
12
+ * rows={[
13
+ * { Plan: "Básico", Precio: "0 €" },
14
+ * { Plan: "Pro", Precio: "9 €" },
15
+ * ]}
16
+ * downloadable
17
+ * downloadName="planes.csv"
18
+ * />
19
+ */
20
+
21
+ declare function GeneratedTable({ columns, rows, caption, downloadable, downloadName, className, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
22
+ columns: string[];
23
+ rows: Record<string, React.ReactNode>[];
24
+ caption?: React.ReactNode;
25
+ downloadable?: boolean;
26
+ downloadName?: string;
27
+ }): React.JSX.Element;
28
+
29
+ export { GeneratedTable };
@@ -0,0 +1,59 @@
1
+ import * as React from 'react';
2
+ import { DsDataTone } from './legend.js';
3
+
4
+ /**
5
+ * @group data
6
+ * @summary Mapa de calor accesible como tabla (día × hora, fila × columna): celdas navegables con flechas, sin dato rayado y tarjeta flotante. Para un mapa de calor dentro de un gráfico, EChart.
7
+ * @see echart — mapa de calor como gráfico (heatmapOption de echarts-presets), sin navegación por celdas
8
+ * @see data-table — valores exactos por filas y columnas que se ordenan o filtran
9
+ * @see legend — explicar tonos o series fuera del gráfico
10
+ * @example Día × hora con unidad en el valor
11
+ * <HeatmapGrid
12
+ * caption="Llamadas por día y hora"
13
+ * rows={["Lunes", "Martes"]}
14
+ * columns={["09", "10", "11"]}
15
+ * values={[[12, 30, null], [8, 22, 41]]}
16
+ * formatValue={(v) => `${v} llamadas`}
17
+ * />
18
+ * @example Celda pulsable para filtrar, con otro tono
19
+ * <HeatmapGrid aria-label="Backlog por día y hora" rows={days} columns={hours} values={backlog} tone="warning" onCellClick={(c) => setCell(c)} />
20
+ * @note Un hueco es null (celda rayada, «sin dato»), nunca 0. Da siempre caption o aria-label y formatValue con la unidad: es lo que se lee en cada celda.
21
+ * @note tone es del vocabulario común (DsDataTone): un solo tono por mapa, de bajo a alto. Para elegir celdas, onCellClick (también con Intro).
22
+ */
23
+
24
+ interface HeatmapCell {
25
+ row: number;
26
+ column: number;
27
+ rowLabel: string;
28
+ columnLabel: string;
29
+ value: number | null;
30
+ /** Valor ya formateado (o «Sin dato»). */
31
+ formatted: string;
32
+ }
33
+ declare function HeatmapGrid({ className, rows, columns, values, min: minProp, max: maxProp, tone, caption, formatValue, cellLabel, renderColumnHeader, renderCard, onCellClick, onCellFocus, showScale, style, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
34
+ /** Etiquetas de las filas (p. ej. días). */
35
+ rows: string[];
36
+ /** Etiquetas de las columnas (p. ej. horas). */
37
+ columns: string[];
38
+ /** Matriz [fila][columna]; `null` o ausente = sin dato. */
39
+ values: Array<Array<number | null | undefined>>;
40
+ min?: number;
41
+ max?: number;
42
+ /** Tono del extremo alto en lugar de --ds-heatmap-high. */
43
+ tone?: DsDataTone;
44
+ /** Título de la tabla (visible). Si no, pasa `aria-label`. */
45
+ caption?: React.ReactNode;
46
+ formatValue?: (value: number) => string;
47
+ /** Texto accesible propio de cada celda. */
48
+ cellLabel?: (cell: HeatmapCell) => string;
49
+ /** Contenido de la cabecera de columna (p. ej. mostrar solo cada 3 horas). */
50
+ renderColumnHeader?: (label: string, index: number) => React.ReactNode;
51
+ /** Tarjeta flotante de una celda (con ratón y foco). */
52
+ renderCard?: (cell: HeatmapCell) => React.ReactNode;
53
+ onCellClick?: (cell: HeatmapCell) => void;
54
+ onCellFocus?: (cell: HeatmapCell) => void;
55
+ /** Escala bajo/alto bajo la tabla. */
56
+ showScale?: boolean;
57
+ }): React.JSX.Element;
58
+
59
+ export { type HeatmapCell, HeatmapGrid };