orbital-ds 0.41.0 → 0.44.1

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 (176) hide show
  1. package/AGENTS.md +28 -9
  2. package/components.manifest.json +6469 -3569
  3. package/dist/auth-form-B1hgbXkI.d.ts +144 -0
  4. package/dist/hooks/use-ds-messages.d.ts +7 -0
  5. package/dist/lib/format.d.ts +57 -0
  6. package/dist/lib/format.js +177 -0
  7. package/dist/lib/i18n.d.ts +14 -2
  8. package/dist/lib/i18n.js +32 -2
  9. package/dist/lib/locales/de.d.ts +7 -0
  10. package/dist/lib/locales/de.js +535 -0
  11. package/dist/lib/locales/fr.d.ts +7 -0
  12. package/dist/lib/locales/fr.js +535 -0
  13. package/dist/lib/locales/he.d.ts +7 -0
  14. package/dist/lib/locales/he.js +535 -0
  15. package/dist/lib/locales/it.d.ts +7 -0
  16. package/dist/lib/locales/it.js +535 -0
  17. package/dist/styles.css +39 -1
  18. package/dist/ui/a2ui-renderer.d.ts +11 -0
  19. package/dist/ui/agent-events.d.ts +17 -0
  20. package/dist/ui/ai-tag.d.ts +16 -0
  21. package/dist/ui/alert-dialog.d.ts +37 -0
  22. package/dist/ui/alert.d.ts +1 -1
  23. package/dist/ui/animated-number.d.ts +11 -0
  24. package/dist/ui/app-bar.d.ts +22 -0
  25. package/dist/ui/attachment.d.ts +3 -3
  26. package/dist/ui/auth-backdrop.d.ts +17 -0
  27. package/dist/ui/auth-form.d.ts +3 -112
  28. package/dist/ui/auth-form.js +13 -6
  29. package/dist/ui/auth-layout.d.ts +38 -0
  30. package/dist/ui/avatar.d.ts +27 -0
  31. package/dist/ui/ayuda.d.ts +1 -1
  32. package/dist/ui/ayuda.js +4 -1
  33. package/dist/ui/banner.d.ts +1 -1
  34. package/dist/ui/bottom-nav.d.ts +22 -0
  35. package/dist/ui/breadcrumb.d.ts +22 -0
  36. package/dist/ui/breadcrumb.js +1 -1
  37. package/dist/ui/bubble.d.ts +1 -1
  38. package/dist/ui/button-group.d.ts +1 -1
  39. package/dist/ui/button.d.ts +2 -2
  40. package/dist/ui/calendar.d.ts +13 -0
  41. package/dist/ui/calendar.js +3 -0
  42. package/dist/ui/card-stack.d.ts +27 -0
  43. package/dist/ui/card.d.ts +33 -0
  44. package/dist/ui/carousel.d.ts +35 -0
  45. package/dist/ui/carousel.js +10 -5
  46. package/dist/ui/chain-of-thought.d.ts +15 -0
  47. package/dist/ui/chart-card.d.ts +19 -0
  48. package/dist/ui/chart.d.ts +19 -0
  49. package/dist/ui/chat-composer.d.ts +19 -0
  50. package/dist/ui/choice-card.d.ts +33 -0
  51. package/dist/ui/code-block.d.ts +15 -0
  52. package/dist/ui/combobox.d.ts +48 -0
  53. package/dist/ui/command-palette.d.ts +18 -0
  54. package/dist/ui/command.d.ts +34 -0
  55. package/dist/ui/confirm-action.d.ts +30 -0
  56. package/dist/ui/confirm-dialog.d.ts +23 -0
  57. package/dist/ui/content-card.d.ts +14 -0
  58. package/dist/ui/context-menu.d.ts +35 -0
  59. package/dist/ui/context-menu.js +1 -1
  60. package/dist/ui/conversation-list.d.ts +20 -0
  61. package/dist/ui/copy-button.d.ts +11 -0
  62. package/dist/ui/date-time.d.ts +40 -0
  63. package/dist/ui/date-time.js +55 -0
  64. package/dist/ui/description-list.d.ts +49 -0
  65. package/dist/ui/description-list.js +86 -0
  66. package/dist/ui/detail-panel.d.ts +22 -0
  67. package/dist/ui/dialog.d.ts +35 -0
  68. package/dist/ui/dock.d.ts +17 -0
  69. package/dist/ui/drawer.d.ts +41 -0
  70. package/dist/ui/dropdown-menu.d.ts +32 -0
  71. package/dist/ui/dropdown-menu.js +1 -1
  72. package/dist/ui/echart.d.ts +15 -0
  73. package/dist/ui/entity-list.d.ts +32 -0
  74. package/dist/ui/field.d.ts +1 -1
  75. package/dist/ui/form-layout.d.ts +24 -0
  76. package/dist/ui/gauge.d.ts +26 -0
  77. package/dist/ui/generated-image.d.ts +19 -0
  78. package/dist/ui/generated-table.d.ts +18 -0
  79. package/dist/ui/heatmap-grid.d.ts +20 -0
  80. package/dist/ui/hero.d.ts +58 -0
  81. package/dist/ui/hero.js +145 -0
  82. package/dist/ui/i18n-provider.d.ts +16 -0
  83. package/dist/ui/input-group.d.ts +1 -1
  84. package/dist/ui/input-otp.d.ts +23 -0
  85. package/dist/ui/input.d.ts +16 -0
  86. package/dist/ui/instruction-editor.d.ts +17 -0
  87. package/dist/ui/item.d.ts +3 -3
  88. package/dist/ui/label.d.ts +17 -0
  89. package/dist/ui/legend.d.ts +25 -0
  90. package/dist/ui/level-meter.d.ts +12 -0
  91. package/dist/ui/load-more.d.ts +17 -0
  92. package/dist/ui/loading-state.d.ts +12 -0
  93. package/dist/ui/markdown.d.ts +15 -0
  94. package/dist/ui/marker.d.ts +1 -1
  95. package/dist/ui/media-card.d.ts +16 -0
  96. package/dist/ui/menubar.d.ts +39 -0
  97. package/dist/ui/message-actions.d.ts +9 -0
  98. package/dist/ui/message-scroller.d.ts +30 -0
  99. package/dist/ui/message.d.ts +33 -0
  100. package/dist/ui/mfa-challenge.d.ts +3 -32
  101. package/dist/ui/mfa-challenge.js +1 -1
  102. package/dist/ui/mfa-setup.d.ts +1 -1
  103. package/dist/ui/mosaic.d.ts +23 -0
  104. package/dist/ui/motion-provider.d.ts +17 -0
  105. package/dist/ui/native-select.d.ts +22 -0
  106. package/dist/ui/next-step-card.d.ts +55 -0
  107. package/dist/ui/next-step-card.js +92 -0
  108. package/dist/ui/notice-review.d.ts +32 -0
  109. package/dist/ui/oauth-consent.d.ts +1 -1
  110. package/dist/ui/page-header.d.ts +46 -4
  111. package/dist/ui/page-header.js +20 -11
  112. package/dist/ui/page-loader.d.ts +17 -0
  113. package/dist/ui/page-shell.d.ts +17 -0
  114. package/dist/ui/pagination.d.ts +20 -0
  115. package/dist/ui/pagination.js +2 -2
  116. package/dist/ui/panel.d.ts +2 -2
  117. package/dist/ui/password-strength.d.ts +14 -0
  118. package/dist/ui/popover.d.ts +32 -0
  119. package/dist/ui/proportion-bar.d.ts +25 -0
  120. package/dist/ui/quantity.d.ts +25 -0
  121. package/dist/ui/quantity.js +27 -0
  122. package/dist/ui/questionnaire.d.ts +38 -0
  123. package/dist/ui/reasoning.d.ts +14 -0
  124. package/dist/ui/reveal.d.ts +17 -0
  125. package/dist/ui/sheet.d.ts +39 -2
  126. package/dist/ui/sheet.js +6 -2
  127. package/dist/ui/shield.d.ts +14 -0
  128. package/dist/ui/show-more.d.ts +14 -0
  129. package/dist/ui/sidebar.d.ts +5 -3
  130. package/dist/ui/sidebar.js +7 -3
  131. package/dist/ui/sparkline.d.ts +1 -1
  132. package/dist/ui/stat-group.d.ts +32 -0
  133. package/dist/ui/status-badge.d.ts +2 -2
  134. package/dist/ui/status-hero.d.ts +18 -0
  135. package/dist/ui/step-dots.d.ts +12 -0
  136. package/dist/ui/step-ring.d.ts +14 -0
  137. package/dist/ui/suggestions.d.ts +9 -0
  138. package/dist/ui/table.d.ts +26 -0
  139. package/dist/ui/tabs.d.ts +1 -1
  140. package/dist/ui/tag-input.d.ts +21 -0
  141. package/dist/ui/tag-input.js +169 -0
  142. package/dist/ui/task-loader.d.ts +15 -0
  143. package/dist/ui/task-progress.d.ts +14 -0
  144. package/dist/ui/textarea.d.ts +22 -1
  145. package/dist/ui/textarea.js +7 -1
  146. package/dist/ui/timeline.d.ts +26 -0
  147. package/dist/ui/toggle-group.d.ts +24 -0
  148. package/dist/ui/toggle.d.ts +1 -1
  149. package/dist/ui/tool-call.d.ts +12 -0
  150. package/dist/ui/usage-meter.d.ts +42 -0
  151. package/dist/ui/usage-meter.js +116 -0
  152. package/dist/ui/week-strip.d.ts +11 -0
  153. package/dist/ui/week-strip.js +2 -2
  154. package/dist/ui/workflow-run.d.ts +28 -0
  155. package/docs/adr/0001-rtl-clases-logicas.md +14 -1
  156. package/docs/designer/flujo.md +1 -1
  157. package/docs/designer/patrones.md +40 -1
  158. package/manifest/actions.json +364 -0
  159. package/manifest/agents.json +399 -0
  160. package/manifest/ai.json +128 -0
  161. package/manifest/auth.json +1547 -0
  162. package/manifest/chat.json +612 -0
  163. package/manifest/content.json +2298 -0
  164. package/manifest/data.json +2904 -0
  165. package/manifest/feedback.json +1005 -0
  166. package/manifest/forms.json +1954 -0
  167. package/manifest/motion.json +196 -0
  168. package/manifest/navigation.json +1792 -0
  169. package/manifest/overlays.json +931 -0
  170. package/package.json +242 -238
  171. package/scripts/cli.mjs +105 -8
  172. package/scripts/doctor.mjs +126 -1
  173. package/scripts/eslint-plugin.mjs +93 -0
  174. package/scripts/i18n.mjs +1 -1
  175. package/scripts/manifest.mjs +159 -7
  176. package/skill/SKILL.md +8 -3
@@ -0,0 +1,145 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { dsWarn } from "../lib/presets.js";
4
+ import { cn } from "../lib/utils.js";
5
+ import { AuthBackdrop } from "./auth-backdrop.js";
6
+ const PRESET_ALIGN = {
7
+ landing: "center",
8
+ split: "start",
9
+ media: "center",
10
+ section: "start"
11
+ };
12
+ const PRESET_SCALE = {
13
+ landing: "",
14
+ split: "",
15
+ media: "",
16
+ section: "[--ds-hero-title-size:var(--ds-hero-title-size-section)] [--ds-hero-title-size-wide:var(--ds-hero-title-size-section-wide)] [--ds-hero-py:var(--ds-hero-py-section)] [--ds-hero-py-wide:var(--ds-hero-py-section-wide)]"
17
+ };
18
+ function Hero({
19
+ preset = "landing",
20
+ title,
21
+ description,
22
+ eyebrow,
23
+ actions,
24
+ media,
25
+ footer,
26
+ align,
27
+ backdrop,
28
+ backdropMedia,
29
+ backdropGlass = false,
30
+ plate,
31
+ animated = false,
32
+ titleAs: Title = "h1",
33
+ className,
34
+ children,
35
+ ...props
36
+ }) {
37
+ const side = align ?? PRESET_ALIGN[preset];
38
+ const fx = backdrop ?? (preset === "media" ? "image" : "none");
39
+ const withFx = fx !== "none" || backdropGlass;
40
+ const withPlate = plate ?? fx === "image";
41
+ const isSplit = preset === "split" && media != null;
42
+ if (preset === "split" && media == null) dsWarn("Hero", 'preset="split" needs `media` (image, video or demo); it renders as a single column.');
43
+ if (fx === "image" && backdropMedia == null) dsWarn("Hero", 'backdrop="image" needs `backdropMedia` (an <img>/<video> with alt="").');
44
+ if (preset !== "split" && media != null) dsWarn("Hero", '`media` is only laid out by preset="split"; use `backdropMedia` for a background photo.');
45
+ const enter = (i) => animated ? { className: "animate-ds-stagger motion-reduce:animate-none", style: { "--ds-stagger-i": i } } : { className: void 0, style: void 0 };
46
+ return /* @__PURE__ */ jsxs(
47
+ "section",
48
+ {
49
+ "data-slot": "hero",
50
+ "data-preset": preset,
51
+ "data-align": side,
52
+ "data-backdrop": withFx ? fx : void 0,
53
+ className: cn(
54
+ "@container/hero relative isolate w-full overflow-hidden rounded-(--ds-hero-radius) bg-(--ds-hero-bg) px-(--ds-hero-px) py-(--ds-hero-py) text-(--ds-hero-fg) @3xl/hero:py-(--ds-hero-py-wide)",
55
+ PRESET_SCALE[preset],
56
+ className
57
+ ),
58
+ ...props,
59
+ children: [
60
+ withFx ? /* @__PURE__ */ jsx(AuthBackdrop, { variant: fx, media: backdropMedia, glass: backdropGlass, animated }) : null,
61
+ /* @__PURE__ */ jsxs(
62
+ "div",
63
+ {
64
+ "data-slot": "hero-inner",
65
+ className: cn(
66
+ "relative mx-auto grid w-full max-w-(--ds-page-max-w) grid-cols-1 gap-(--ds-hero-gap)",
67
+ isSplit && "@3xl/hero:grid-cols-2 @3xl/hero:items-center"
68
+ ),
69
+ children: [
70
+ /* @__PURE__ */ jsxs(
71
+ "div",
72
+ {
73
+ "data-slot": "hero-content",
74
+ className: cn(
75
+ "flex min-w-0 flex-col gap-(--ds-hero-content-gap)",
76
+ side === "center" ? "mx-auto max-w-(--ds-hero-measure) items-center text-center" : "max-w-(--ds-hero-measure) items-start text-start",
77
+ withPlate && "rounded-(--ds-auth-radius) border border-(--ds-auth-border) bg-(--ds-backdrop-plate-bg) p-(--ds-auth-p-sm) text-foreground shadow-(--ds-auth-shadow-elevated) [backdrop-filter:var(--ds-auth-glass-filter)] @3xl/hero:p-(--ds-auth-p)"
78
+ ),
79
+ children: [
80
+ eyebrow ? /* @__PURE__ */ jsx("div", { "data-slot": "hero-eyebrow", className: cn("flex flex-wrap items-center gap-2 text-sm", enter(0).className), style: enter(0).style, children: eyebrow }) : null,
81
+ /* @__PURE__ */ jsx(
82
+ Title,
83
+ {
84
+ "data-slot": "hero-title",
85
+ className: cn(
86
+ "text-(length:--ds-hero-title-size) leading-(--ds-hero-title-leading) font-(--ds-hero-title-weight) tracking-(--ds-hero-title-tracking) text-balance @3xl/hero:text-(length:--ds-hero-title-size-wide)",
87
+ enter(1).className
88
+ ),
89
+ style: enter(1).style,
90
+ children: title
91
+ }
92
+ ),
93
+ description ? /* @__PURE__ */ jsx(
94
+ "p",
95
+ {
96
+ "data-slot": "hero-description",
97
+ className: cn("text-(length:--ds-hero-description-size) text-pretty text-muted-foreground", enter(2).className),
98
+ style: enter(2).style,
99
+ children: description
100
+ }
101
+ ) : null,
102
+ actions ? /* @__PURE__ */ jsx(
103
+ "div",
104
+ {
105
+ "data-slot": "hero-actions",
106
+ className: cn("flex flex-wrap items-center gap-3", side === "center" && "justify-center", enter(3).className),
107
+ style: enter(3).style,
108
+ children: actions
109
+ }
110
+ ) : null
111
+ ]
112
+ }
113
+ ),
114
+ isSplit ? /* @__PURE__ */ jsx(
115
+ "div",
116
+ {
117
+ "data-slot": "hero-media",
118
+ className: cn(
119
+ "min-w-0 overflow-hidden rounded-(--ds-hero-media-radius) shadow-(--ds-hero-media-shadow) [&>img]:size-full [&>img]:object-cover [&>video]:size-full [&>video]:object-cover",
120
+ enter(2).className
121
+ ),
122
+ style: enter(2).style,
123
+ children: media
124
+ }
125
+ ) : null,
126
+ footer ? /* @__PURE__ */ jsx(
127
+ "div",
128
+ {
129
+ "data-slot": "hero-footer",
130
+ className: cn("min-w-0 @3xl/hero:col-span-full", side === "center" && "text-center", enter(4).className),
131
+ style: enter(4).style,
132
+ children: footer
133
+ }
134
+ ) : null
135
+ ]
136
+ }
137
+ ),
138
+ children
139
+ ]
140
+ }
141
+ );
142
+ }
143
+ export {
144
+ Hero
145
+ };
@@ -1,6 +1,22 @@
1
1
  import * as React from 'react';
2
2
  import { DsMessages } from '../lib/i18n.js';
3
3
 
4
+ /**
5
+ * @group content
6
+ * @summary Proveedor raíz que fija idioma, textos propios y dirección (ltr / rtl) de los componentes de orbital-ds; se monta una vez con el idioma activo de la app.
7
+ * @see direction — solo la dirección de Base UI (ya incluida aquí)
8
+ * @see motion-provider — proveedor raíz de Motion para animar con los presets del tema
9
+ * @example Con i18next (espacio «orbital»)
10
+ * <DsI18nProvider locale={i18n.language} messages={i18n.getResourceBundle(i18n.language, "orbital")}>
11
+ * <App />
12
+ * </DsI18nProvider>
13
+ * @example Con los catálogos incluidos (en, es, pt-BR)
14
+ * <DsI18nProvider locale="es">
15
+ * <App />
16
+ * </DsI18nProvider>
17
+ * @note Sin provider, los textos de los componentes salen en inglés. Pon además `dir={dsDirection(idioma)}` en `<html>`; la prop `dir` de aquí solo fuerza la dirección.
18
+ */
19
+
4
20
  declare function DsI18nProvider({ locale, messages, dir, children, }: {
5
21
  locale?: string | null;
6
22
  messages?: Partial<DsMessages>;
@@ -10,7 +10,7 @@ declare const inputGroupAddonVariants: (props?: ({
10
10
  } & class_variance_authority_types.ClassProp) | undefined) => string;
11
11
  declare function InputGroupAddon({ className, align, ...props }: React.ComponentProps<"div"> & VariantProps<typeof inputGroupAddonVariants>): React.JSX.Element;
12
12
  declare const inputGroupButtonVariants: (props?: ({
13
- size?: "xs" | "sm" | "icon-xs" | "icon-sm" | null | undefined;
13
+ size?: "sm" | "xs" | "icon-xs" | "icon-sm" | null | undefined;
14
14
  } & class_variance_authority_types.ClassProp) | undefined) => string;
15
15
  declare function InputGroupButton({ className, type, variant, size, ...props }: Omit<React.ComponentProps<typeof Button>, "size" | "type"> & VariantProps<typeof inputGroupButtonVariants> & {
16
16
  type?: "button" | "submit" | "reset";
@@ -1,6 +1,29 @@
1
1
  import * as React from 'react';
2
2
  import { OTPInput } from 'input-otp';
3
3
 
4
+ /**
5
+ * @group forms
6
+ * @summary Código de un solo uso en casillas (verificación por SMS o correo, MFA): pega y avanza solo entre dígitos.
7
+ * @see mfa-challenge — la pantalla completa del segundo factor
8
+ * @see input — un código o dato de longitud libre
9
+ * @example Código de 6 dígitos en dos grupos
10
+ * <InputOTP maxLength={6} value={codigo} onChange={setCodigo}>
11
+ * <InputOTPGroup>
12
+ * <InputOTPSlot index={0} />
13
+ * <InputOTPSlot index={1} />
14
+ * <InputOTPSlot index={2} />
15
+ * </InputOTPGroup>
16
+ * <InputOTPSeparator />
17
+ * <InputOTPGroup>
18
+ * <InputOTPSlot index={3} />
19
+ * <InputOTPSlot index={4} />
20
+ * <InputOTPSlot index={5} />
21
+ * </InputOTPGroup>
22
+ * </InputOTP>
23
+ * @note Un InputOTPSlot por posición, con `index` de 0 a `maxLength - 1`; el error se marca con `aria-invalid` en cada casilla.
24
+ * @note input-otp es dependencia opcional de la app.
25
+ */
26
+
4
27
  declare function InputOTP({ className, containerClassName, ...props }: React.ComponentProps<typeof OTPInput> & {
5
28
  containerClassName?: string;
6
29
  }): React.JSX.Element;
@@ -1,5 +1,21 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group forms
5
+ * @summary Campo de texto de una línea (nombre, correo, importe); va dentro de Field con su etiqueta.
6
+ * @see input-group — el campo necesita icono, prefijo, sufijo o botón dentro
7
+ * @see textarea — texto de varias líneas
8
+ * @see password-input — contraseñas, con mostrar/ocultar y autocompletado correcto
9
+ * @example Con etiqueta
10
+ * <Field>
11
+ * <FieldLabel htmlFor="email">Correo</FieldLabel>
12
+ * <Input id="email" type="email" autoComplete="email" />
13
+ * </Field>
14
+ * @example Con error
15
+ * <Input id="vat" aria-invalid="true" defaultValue="B1234" />
16
+ * @note El placeholder no es etiqueta: pon siempre FieldLabel (o `aria-label` si no hay sitio).
17
+ */
18
+
3
19
  declare function Input({ className, type, ...props }: React.ComponentProps<"input">): React.JSX.Element;
4
20
 
5
21
  export { Input };
@@ -1,6 +1,23 @@
1
1
  import * as React from 'react';
2
2
  import { ImageUploader } from '../lib/image-upload.js';
3
3
 
4
+ /**
5
+ * @group forms
6
+ * @summary Editor de instrucciones, prompts o documentos que siempre entrega Markdown, con vistas visual, Markdown, HTML y previa, y variables.
7
+ * @see textarea — texto libre corto sin formato
8
+ * @see chat-composer — escribir un mensaje en un chat
9
+ * @example Preset prompt con variables
10
+ * <InstructionEditor
11
+ * preset="prompt"
12
+ * value={md}
13
+ * onChange={setMd}
14
+ * variables={["company", "user_name"]}
15
+ * aria-label="Instrucciones del agente"
16
+ * />
17
+ * @example Preset compact (nota corta)
18
+ * <InstructionEditor preset="compact" defaultValue="" placeholder="Añade una nota…" aria-label="Nota" />
19
+ */
20
+
4
21
  type InstructionEditorPreset = "prompt" | "document" | "compact";
5
22
  /** Lo que devuelve `renderPreview`: el texto final y, si la app los calcula, datos de tamaño (p. ej. tokens TOON frente a JSON). */
6
23
  interface InstructionPreview {
package/dist/ui/item.d.ts CHANGED
@@ -8,12 +8,12 @@ import '@base-ui/react/separator';
8
8
  declare function ItemGroup({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
9
9
  declare function ItemSeparator({ className, ...props }: React.ComponentProps<typeof Separator>): React.JSX.Element;
10
10
  declare const itemVariants: (props?: ({
11
- variant?: "outline" | "default" | "muted" | "card" | null | undefined;
12
- size?: "default" | "xs" | "sm" | null | undefined;
11
+ variant?: "default" | "outline" | "card" | "muted" | null | undefined;
12
+ size?: "default" | "sm" | "xs" | null | undefined;
13
13
  } & class_variance_authority_types.ClassProp) | undefined) => string;
14
14
  declare function Item({ className, variant, size, render, ...props }: useRender.ComponentProps<"div"> & VariantProps<typeof itemVariants>): React.JSX.Element;
15
15
  declare const itemMediaVariants: (props?: ({
16
- variant?: "icon" | "default" | "image" | null | undefined;
16
+ variant?: "image" | "icon" | "default" | null | undefined;
17
17
  } & class_variance_authority_types.ClassProp) | undefined) => string;
18
18
  declare function ItemMedia({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof itemMediaVariants>): React.JSX.Element;
19
19
  declare function ItemContent({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
@@ -1,5 +1,22 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group forms
5
+ * @summary Etiqueta accesible (label nativa) para un control suelto fuera de la estructura de formulario.
6
+ * @see field — en formularios: FieldLabel junto con ayuda y error
7
+ * @example Etiqueta asociada
8
+ * <Label htmlFor="ie-preset">Preset</Label>
9
+ * <NativeSelect id="ie-preset">
10
+ * <NativeSelectOption value="prompt">Prompt</NativeSelectOption>
11
+ * </NativeSelect>
12
+ * @example Envolviendo el control
13
+ * <Label>
14
+ * <Switch />
15
+ * Avisos por correo
16
+ * </Label>
17
+ * @note Asocia con `htmlFor` o envolviendo el control; en un formulario usa FieldLabel dentro de Field.
18
+ */
19
+
3
20
  declare function Label({ className, ...props }: React.ComponentProps<"label">): React.JSX.Element;
4
21
 
5
22
  export { Label };
@@ -1,5 +1,30 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group data
5
+ * @summary Leyenda de series o de tonos (muestra + etiqueta + valor opcional), horizontal o vertical; con onToggle sirve para mostrar u ocultar series de un gráfico.
6
+ * @see proportion-bar — barra con segmentos (se acompaña de Legend con los mismos tonos)
7
+ * @see status-badge — el estado de una cosa con su texto, no la clave de un gráfico
8
+ * @see echart — los gráficos ECharts ya traen su leyenda dentro del option
9
+ * @example Tonos de estado
10
+ * <Legend>
11
+ * <LegendItem tone="success">Dentro de SLA</LegendItem>
12
+ * <LegendItem tone="danger">Fuera de SLA</LegendItem>
13
+ * <LegendItem tone="neutral" shape="line">Objetivo</LegendItem>
14
+ * </Legend>
15
+ * @example Vertical con valores
16
+ * <Legend orientation="vertical">
17
+ * <LegendItem tone="chart-1" value={<Quantity value={3840} />}>Entrantes</LegendItem>
18
+ * <LegendItem tone="chart-2" value={<Quantity value={3512} />}>Atendidas</LegendItem>
19
+ * </Legend>
20
+ * @example Interactiva: muestra u oculta series
21
+ * <Legend aria-label="Series del gráfico">
22
+ * <LegendItem tone="chart-1" active={visible.calls} onToggle={(on) => setVisible({ ...visible, calls: on })}>Llamadas</LegendItem>
23
+ * </Legend>
24
+ * @note Usa tone (series chart-1…5 o tonos de estado del vocabulario común), no color: un color escrito se sale del tema.
25
+ * @note onToggle solo si de verdad muestra u oculta la serie; la etiqueta va siempre en texto (el color no basta).
26
+ */
27
+
3
28
  /** Tonos de color comunes a las piezas de datos (series del gráfico y estados). */
4
29
  type DsDataTone = "primary" | "info" | "success" | "warning" | "danger" | "neutral" | "chart-1" | "chart-2" | "chart-3" | "chart-4" | "chart-5";
5
30
  /** Relleno de fondo de cada tono (clases estáticas para que Tailwind las genere). */
@@ -1,6 +1,18 @@
1
1
  import * as React from 'react';
2
2
  import { DsDataTone } from './legend.js';
3
3
 
4
+ /**
5
+ * @group data
6
+ * @summary Medición de un nivel en porcentaje con su categoría (bajo, medio, alto) y su rango; la app decide el tono. Para una puntuación en anillo, Gauge; para uso frente a límite, UsageMeter.
7
+ * @see gauge — valor en anillo o arco con la cifra en el centro
8
+ * @see usage-meter — uso frente a lo contratado, con aviso al 80 % y crítico al 100 %
9
+ * @see proportion-bar — parte frente al total o reparto en segmentos
10
+ * @example Nivel con su categoría y rango
11
+ * <LevelMeter label="Exposición" value={47.5} tone="warning" level="Medio" range="25–60 %" />
12
+ * @note value es un porcentaje 0–100 (se recorta); el tono lo traduce la app desde su dominio (bajo → success, medio → warning, alto → danger).
13
+ * @note Pasa siempre level con la categoría en texto: el tono refuerza, no es el único portador.
14
+ */
15
+
4
16
  declare function LevelMeter({ value, tone, level, range, label, className, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
5
17
  /** Porcentaje 0–100. */
6
18
  value: number;
@@ -1,5 +1,22 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group data
5
+ * @summary Botón «Cargar más» al final de una lista que se pide por tramos, con restantes, anuncio para lectores y reintento; `auto` añade carga al llegar al final. Para saltar a una página, Pagination.
6
+ * @see pagination — saltar a una página concreta o datos de trabajo (tablas)
7
+ * @see show-more — desplegar contenido que ya está cargado, sin pedir más
8
+ * @see entity-list — la lista de entidades con sus estados, a la que suele acompañar
9
+ * @example Al final de una lista
10
+ * <LoadMore
11
+ * hasMore={items.length < total}
12
+ * loading={isFetching}
13
+ * error={isError}
14
+ * onLoadMore={fetchNextPage}
15
+ * remaining={total - items.length}
16
+ * loadedCount={lastPageSize}
17
+ * />
18
+ */
19
+
3
20
  declare function LoadMore({ hasMore, loading, error, onLoadMore, remaining, loadedCount, auto, autoLimit, rootMargin, label, endLabel, className, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
4
21
  hasMore: boolean;
5
22
  loading?: boolean;
@@ -1,5 +1,17 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group data
5
+ * @summary Esqueleto con la forma de lo que se carga (lista, tarjeta, tabla o ficha) para una sección mientras llegan los datos. Para una página o ruta entera, PageLoader.
6
+ * @see page-loader — carga de toda la app, una ruta o una sección con superposición
7
+ * @see skeleton — una pieza suelta de esqueleto para componer tu propia forma
8
+ * @see spinner — espera breve dentro de un botón o un control
9
+ * @example Preset list
10
+ * <LoadingState preset="list" rows={3} />
11
+ * @example Tarjeta con texto visible y brillo
12
+ * <LoadingState preset="card" rows={3} shimmer label="Cargando vista de proceso…" />
13
+ */
14
+
3
15
  type LoadingStatePreset = "list" | "card" | "table" | "detail";
4
16
  declare function LoadingState({ preset, rows, label, shimmer, className, }: {
5
17
  preset?: LoadingStatePreset;
@@ -1,5 +1,20 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group chat
5
+ * @summary Pinta texto Markdown (GFM) con el aspecto del tema: la respuesta del asistente, sin HTML crudo y cerrando lo que quede abierto mientras llega en streaming.
6
+ * @see code-block — solo un bloque de código
7
+ * @see bubble — burbuja de chat con texto corto sin formato
8
+ * @example Respuesta en streaming
9
+ * <Markdown streaming={isStreaming}>{message.text}</Markdown>
10
+ * @example Dentro de un mensaje del asistente
11
+ * <Message>
12
+ * <MessageContent>
13
+ * <Markdown>{answer}</Markdown>
14
+ * </MessageContent>
15
+ * </Message>
16
+ */
17
+
3
18
  /**
4
19
  * Cierra lo que un texto en streaming deja abierto (vallas de código, negrita, cursiva, tachado) para que se pinte
5
20
  * bien mientras llega. Solo toca el final; el texto original no se modifica.
@@ -4,7 +4,7 @@ import { useRender } from '@base-ui/react/use-render';
4
4
  import { VariantProps } from 'class-variance-authority';
5
5
 
6
6
  declare const markerVariants: (props?: ({
7
- variant?: "default" | "separator" | "border" | null | undefined;
7
+ variant?: "separator" | "default" | "border" | null | undefined;
8
8
  } & class_variance_authority_types.ClassProp) | undefined) => string;
9
9
  declare function Marker({ className, variant, render, ...props }: useRender.ComponentProps<"div"> & VariantProps<typeof markerVariants>): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
10
10
  declare function MarkerIcon({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
@@ -1,5 +1,21 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group content
5
+ * @summary Tarjeta de rejilla con imagen protagonista (vídeo, curso, producto), título, metadato, insignia sobre la imagen y una acción central (reproducir).
6
+ * @see content-card — tarjeta por intención con portada (media, horizontal, cover) y más estructura
7
+ * @see item — fila de una lista de entidades
8
+ * @see card — tarjeta con anatomía libre
9
+ * @example Vídeo con duración y reproducir
10
+ * <MediaCard
11
+ * src={video.thumbnail}
12
+ * title="Primeros pasos"
13
+ * meta="Curso · 12 lecciones"
14
+ * badge="04:32"
15
+ * action={<Button size="icon" aria-label="Reproducir"><PlayIcon /></Button>}
16
+ * />
17
+ */
18
+
3
19
  declare function MediaCard({ src, alt, title, meta, badge, action, className, children, ...props }: Omit<React.ComponentProps<"article">, "title"> & {
4
20
  src?: string;
5
21
  /** Texto alternativo de la imagen; vacío si es decorativa (por defecto). */
@@ -3,6 +3,45 @@ import { Menu } from '@base-ui/react/menu';
3
3
  import { Menubar as Menubar$1 } from '@base-ui/react/menubar';
4
4
  import { DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenu, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from './dropdown-menu.js';
5
5
 
6
+ /**
7
+ * @group navigation
8
+ * @summary Barra de menús de escritorio al estilo de una aplicación (Archivo, Editar, Ver) con comandos y submenús, para editores y herramientas densas; no navega entre páginas.
9
+ * @see navigation-menu — navegación de un sitio con desplegables de enlaces (Producto, Recursos)
10
+ * @see dropdown-menu — un solo menú de acciones tras un botón
11
+ * @see sidebar — navegación principal de la app
12
+ * @example Menú con atajo y acción destructiva
13
+ * <Menubar>
14
+ * <MenubarMenu>
15
+ * <MenubarTrigger>Archivo</MenubarTrigger>
16
+ * <MenubarContent>
17
+ * <MenubarItem>
18
+ * Nuevo
19
+ * <MenubarShortcut>⌘N</MenubarShortcut>
20
+ * </MenubarItem>
21
+ * <MenubarSeparator />
22
+ * <MenubarItem variant="destructive">Eliminar</MenubarItem>
23
+ * </MenubarContent>
24
+ * </MenubarMenu>
25
+ * </Menubar>
26
+ * @example Opción marcada y submenú
27
+ * <Menubar>
28
+ * <MenubarMenu>
29
+ * <MenubarTrigger>Ver</MenubarTrigger>
30
+ * <MenubarContent>
31
+ * <MenubarCheckboxItem checked={showGrid} onCheckedChange={setShowGrid}>Cuadrícula</MenubarCheckboxItem>
32
+ * <MenubarSub>
33
+ * <MenubarSubTrigger>Exportar</MenubarSubTrigger>
34
+ * <MenubarSubContent>
35
+ * <MenubarItem>PDF</MenubarItem>
36
+ * </MenubarSubContent>
37
+ * </MenubarSub>
38
+ * </MenubarContent>
39
+ * </MenubarMenu>
40
+ * </Menubar>
41
+ * @note Solo en escritorio y para comandos de la herramienta; en móvil, agrupa las acciones en un DropdownMenu.
42
+ * @note MenubarShortcut solo muestra el atajo: la app enlaza la tecla.
43
+ */
44
+
6
45
  declare function Menubar({ className, ...props }: Menubar$1.Props): React.JSX.Element;
7
46
  declare function MenubarMenu({ ...props }: React.ComponentProps<typeof DropdownMenu>): React.JSX.Element;
8
47
  declare function MenubarGroup({ ...props }: React.ComponentProps<typeof DropdownMenuGroup>): React.JSX.Element;
@@ -1,5 +1,14 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group chat
5
+ * @summary Acciones bajo una respuesta del asistente: copiar, regenerar y valorar (bien o mal); cada acción aparece solo si pasas su callback.
6
+ * @see copy-button — copiar un valor suelto fuera del chat
7
+ * @see button-group — otras acciones agrupadas
8
+ * @example Copiar, regenerar y valorar
9
+ * <MessageActions text={answer} onRetry={regenerate} feedback={feedback} onFeedback={setFeedback} />
10
+ */
11
+
3
12
  type MessageFeedback = "good" | "bad" | null;
4
13
  declare function MessageActions({ text, onCopy, onRetry, feedback, onFeedback, className, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
5
14
  text?: string;
@@ -6,6 +6,36 @@ import 'class-variance-authority/types';
6
6
  import '@base-ui/react/use-render';
7
7
  import 'class-variance-authority';
8
8
 
9
+ /**
10
+ * @group chat
11
+ * @summary Contenedor desplazable de un chat que arranca al final, se pega abajo al llegar mensajes nuevos y ofrece botones para saltar al inicio o al final.
12
+ * @see scroll-area — desplazamiento de cualquier otro contenido
13
+ * @see message — cada mensaje que va dentro
14
+ * @note Envuélvelo en MessageScrollerProvider (autoScroll, defaultScrollPosition="end"), dale una altura y pon un messageId en cada MessageScrollerItem.
15
+ * @note El Viewport lleva aria-label con el nombre de la conversación (lo pone la app).
16
+ * @example Hilo con botón de ir al final
17
+ * <MessageScrollerProvider autoScroll defaultScrollPosition="end">
18
+ * <MessageScroller>
19
+ * <MessageScrollerViewport aria-label="Conversación con soporte">
20
+ * <MessageScrollerContent>
21
+ * {messages.map((m) => (
22
+ * <MessageScrollerItem key={m.id} messageId={m.id}>
23
+ * <Message align={m.mine ? "end" : "start"}>
24
+ * <MessageContent>
25
+ * <Bubble>
26
+ * <BubbleContent>{m.text}</BubbleContent>
27
+ * </Bubble>
28
+ * </MessageContent>
29
+ * </Message>
30
+ * </MessageScrollerItem>
31
+ * ))}
32
+ * </MessageScrollerContent>
33
+ * </MessageScrollerViewport>
34
+ * <MessageScrollerButton direction="end" />
35
+ * </MessageScroller>
36
+ * </MessageScrollerProvider>
37
+ */
38
+
9
39
  declare function MessageScrollerProvider(props: React.ComponentProps<typeof MessageScroller$1.Provider>): React.JSX.Element;
10
40
  declare function MessageScroller({ className, ...props }: React.ComponentProps<typeof MessageScroller$1.Root>): React.JSX.Element;
11
41
  declare function MessageScrollerViewport({ className, ...props }: React.ComponentProps<typeof MessageScroller$1.Viewport>): React.JSX.Element;
@@ -1,5 +1,38 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group chat
5
+ * @summary Estructura de un mensaje de chat (avatar, cabecera, contenido y pie), alineado al inicio (recibido) o al final (enviado); el texto va en Bubble o en Markdown.
6
+ * @see bubble — la burbuja con el texto del mensaje
7
+ * @see message-scroller — la lista desplazable que contiene los mensajes
8
+ * @see timeline — eventos con fecha, no una conversación
9
+ * @note `align="end"` para los mensajes de la persona; varias burbujas seguidas del mismo autor van en MessageGroup.
10
+ * @note En una respuesta del asistente, Reasoning y ToolCall van dentro de MessageContent antes del texto (Markdown).
11
+ * @example Mensaje recibido con avatar
12
+ * <Message>
13
+ * <MessageAvatar>
14
+ * <Avatar size="sm">
15
+ * <AvatarFallback>MG</AvatarFallback>
16
+ * </Avatar>
17
+ * </MessageAvatar>
18
+ * <MessageContent>
19
+ * <MessageHeader>Marta Gómez · Soporte</MessageHeader>
20
+ * <Bubble variant="muted">
21
+ * <BubbleContent>He revisado la incidencia #4821.</BubbleContent>
22
+ * </Bubble>
23
+ * <MessageFooter>10:42</MessageFooter>
24
+ * </MessageContent>
25
+ * </Message>
26
+ * @example Mensaje enviado
27
+ * <Message align="end">
28
+ * <MessageContent>
29
+ * <Bubble>
30
+ * <BubbleContent>Lo pruebo ahora mismo.</BubbleContent>
31
+ * </Bubble>
32
+ * </MessageContent>
33
+ * </Message>
34
+ */
35
+
3
36
  declare function MessageGroup({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
4
37
  declare function Message({ className, align, ...props }: React.ComponentProps<"div"> & {
5
38
  align?: "start" | "end";
@@ -1,33 +1,4 @@
1
- import * as React from 'react';
2
- import { MfaMethod } from '../lib/auth.js';
3
- import { AuthResult } from './auth-form.js';
1
+ import 'react';
2
+ import '../lib/auth.js';
3
+ export { M as MfaChallenge, a as MfaChallengePreset } from '../auth-form-B1hgbXkI.js';
4
4
  import '../lib/i18n.js';
5
-
6
- type MfaChallengePreset = "totp" | "sms" | "email" | "backup-code" | "passkey";
7
- declare function MfaChallenge({ preset, methods, destination, codeLength, trustDevice, onVerify, onPasskey, onResend, onMethodChange, resendAfter, onCancel, error: errorProp, title, description, className, ...props }: Omit<React.ComponentProps<"div">, "title"> & {
8
- preset?: MfaChallengePreset;
9
- /** Métodos activos de la persona (el primero no hace falta repetirlo). */
10
- methods?: MfaMethod[];
11
- /** Número o correo ya enmascarado («•••• 4821», «f•••@empresa.com»). */
12
- destination?: string;
13
- codeLength?: number;
14
- /** Casilla «no volver a preguntar en este dispositivo». */
15
- trustDevice?: boolean;
16
- onVerify?: (code: string, options: {
17
- method: MfaMethod;
18
- trustDevice: boolean;
19
- }) => AuthResult | Promise<AuthResult>;
20
- onPasskey?: () => AuthResult | Promise<AuthResult>;
21
- /** sms y email: reenviar el código. */
22
- onResend?: (method: MfaMethod) => void | Promise<void>;
23
- /** Se ha cambiado de método (p. ej. para pedir al servidor que envíe el SMS). */
24
- onMethodChange?: (method: MfaMethod) => void;
25
- resendAfter?: number;
26
- /** Volver (cerrar sesión parcial, volver al inicio). */
27
- onCancel?: () => void;
28
- error?: React.ReactNode;
29
- title?: React.ReactNode;
30
- description?: React.ReactNode;
31
- }): React.JSX.Element;
32
-
33
- export { MfaChallenge, type MfaChallengePreset };
@@ -109,7 +109,7 @@ function MfaChallenge({
109
109
  }
110
110
  ) }, m)) }) }),
111
111
  /* @__PURE__ */ jsxs(Button, { type: "button", variant: "ghost", size: "sm", className: "self-start", onClick: () => setChoosing(false), children: [
112
- /* @__PURE__ */ jsx(ArrowLeftIcon, {}),
112
+ /* @__PURE__ */ jsx(ArrowLeftIcon, { className: "rtl:rotate-180" }),
113
113
  t.authBack
114
114
  ] })
115
115
  ] });
@@ -1,5 +1,5 @@
1
1
  import * as React from 'react';
2
- import { AuthResult } from './auth-form.js';
2
+ import { A as AuthResult } from '../auth-form-B1hgbXkI.js';
3
3
  import '../lib/auth.js';
4
4
  import '../lib/i18n.js';
5
5