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,27 @@
1
+ "use client";
2
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
3
+ import { useDsLocale, useDsMessages } from "../hooks/use-ds-messages.js";
4
+ import { formatQuantity } from "../lib/format.js";
5
+ import { cn } from "../lib/utils.js";
6
+ function Quantity({ value, unit, system, unitDisplay, maximumFractionDigits, compact, className, ...props }) {
7
+ const locale = useDsLocale();
8
+ const t = useDsMessages();
9
+ const text = formatQuantity(value, unit, { locale, system, unitDisplay, maximumFractionDigits, compact });
10
+ return /* @__PURE__ */ jsx(
11
+ "span",
12
+ {
13
+ "data-slot": "quantity",
14
+ "data-state": text == null ? "empty" : "value",
15
+ "data-unit": unit,
16
+ className: cn("tabular-nums", className),
17
+ ...props,
18
+ children: text ?? /* @__PURE__ */ jsxs(Fragment, { children: [
19
+ /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\u2014" }),
20
+ /* @__PURE__ */ jsx("span", { className: "sr-only", children: t.statNoData })
21
+ ] })
22
+ }
23
+ );
24
+ }
25
+ export {
26
+ Quantity
27
+ };
@@ -5,6 +5,44 @@ import 'class-variance-authority/types';
5
5
  import '@base-ui/react/use-render';
6
6
  import 'class-variance-authority';
7
7
 
8
+ /**
9
+ * @group forms
10
+ * @summary Cuestionario de varias preguntas con elección única, múltiple o respuesta libre, navegando con Anterior/Siguiente (encuestas, perfil inicial).
11
+ * @see step-flow — un alta o asistente por pasos con campos de formulario
12
+ * @see choice-card — una sola pregunta visual dentro de un formulario
13
+ * @see form-layout — un formulario corriente que se ve entero
14
+ * @example Una pregunta de opción única
15
+ * <Questionnaire onSubmit={enviar}>
16
+ * <QuestionnaireItem name="rol" required>
17
+ * <QuestionnaireTitle>¿Cuál es tu función en el equipo?</QuestionnaireTitle>
18
+ * <QuestionnaireChoices>
19
+ * <QuestionnaireChoice value="ventas">Ventas</QuestionnaireChoice>
20
+ * <QuestionnaireChoice value="soporte">Soporte</QuestionnaireChoice>
21
+ * </QuestionnaireChoices>
22
+ * <QuestionnaireError>Elige una opción para continuar.</QuestionnaireError>
23
+ * </QuestionnaireItem>
24
+ * <QuestionnaireActions>
25
+ * <QuestionnairePrevious>Anterior</QuestionnairePrevious>
26
+ * <QuestionnaireNext>Siguiente</QuestionnaireNext>
27
+ * <QuestionnaireSubmit>Enviar</QuestionnaireSubmit>
28
+ * </QuestionnaireActions>
29
+ * </Questionnaire>
30
+ * @example Varias respuestas y texto libre
31
+ * <QuestionnaireItem name="objetivos" multiple>
32
+ * <QuestionnaireTitle>¿Qué quieres conseguir?</QuestionnaireTitle>
33
+ * <QuestionnaireChoices>
34
+ * <QuestionnaireChoice value="captacion">Captar clientes</QuestionnaireChoice>
35
+ * <QuestionnaireChoice value="retencion">Reducir bajas</QuestionnaireChoice>
36
+ * </QuestionnaireChoices>
37
+ * </QuestionnaireItem>
38
+ * <QuestionnaireItem name="empresa">
39
+ * <QuestionnaireTitle>¿Cómo se llama tu empresa?</QuestionnaireTitle>
40
+ * <QuestionnaireInput placeholder="Acme S.L." />
41
+ * </QuestionnaireItem>
42
+ * @note Cada QuestionnaireItem lleva `name`: las respuestas llegan en el FormData de `onSubmit`.
43
+ * @note `multiple` convierte la pregunta en elección múltiple; QuestionnaireInput, en respuesta libre.
44
+ */
45
+
8
46
  declare function Questionnaire({ className, ...props }: React.ComponentProps<typeof Questionnaire$1.Root>): React.JSX.Element;
9
47
  declare function QuestionnaireProgress({ className, ...props }: React.ComponentProps<typeof Questionnaire$1.Progress>): React.JSX.Element;
10
48
  declare function QuestionnaireItem({ className, ...props }: React.ComponentProps<typeof Questionnaire$1.Item>): React.JSX.Element;
@@ -1,5 +1,19 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group agents
5
+ * @summary El razonamiento en texto libre del modelo, plegable: «Pensando…» mientras llega y «Razonado» al terminar; no muestra pasos ni herramientas.
6
+ * @see chain-of-thought — los pasos que dio el agente, uno por línea con resultados
7
+ * @see tool-call — una llamada concreta a una herramienta con su entrada y salida
8
+ * @see agent-events — la traza completa con tiempos (pensar, herramientas, traspasos)
9
+ * @example Mientras el modelo piensa
10
+ * <Reasoning streaming={isThinking}>{thoughts}</Reasoning>
11
+ * @example Con Markdown y título propio
12
+ * <Reasoning streaming={isThinking} title="Cómo lo he calculado">
13
+ * <Markdown streaming={isThinking}>{thoughts}</Markdown>
14
+ * </Reasoning>
15
+ */
16
+
3
17
  declare function Reasoning({ streaming, title, defaultOpen, onOpenChange, className, children, ...props }: Omit<React.ComponentProps<"div">, "title"> & {
4
18
  streaming?: boolean;
5
19
  title?: React.ReactNode;
@@ -1,5 +1,22 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group content
5
+ * @summary Hace aparecer un bloque al entrar en pantalla con el scroll (fade, up, pop, slide) con CSS y el ritmo del tema; sin JS o con movimiento reducido, queda visible.
6
+ * @see motion-provider — animaciones con Motion (salidas, gestos, layout)
7
+ * @see animated-number — una cifra que cuenta hasta su valor
8
+ * @example Tarjeta que sube al aparecer
9
+ * <Reveal effect="up">
10
+ * <ContentCard title="Integraciones" description="Conecta tus herramientas" />
11
+ * </Reveal>
12
+ * @example Cascada en una lista
13
+ * {features.map((f, i) => (
14
+ * <Reveal key={f.id} index={i}>
15
+ * <ContentCard title={f.title} />
16
+ * </Reveal>
17
+ * ))}
18
+ */
19
+
3
20
  type RevealEffect = "fade" | "up" | "pop" | "slide";
4
21
  declare function Reveal({ effect, index, once, className, style, ...props }: React.ComponentProps<"div"> & {
5
22
  effect?: RevealEffect;
@@ -1,11 +1,48 @@
1
1
  import * as React from 'react';
2
2
  import { Dialog } from '@base-ui/react/dialog';
3
+ import { DsInlineSide } from '../lib/i18n.js';
4
+
5
+ /**
6
+ * @group overlays
7
+ * @summary Panel modal que entra desde un borde (derecha por defecto) para editar o consultar algo largo sin perder la página de fondo; pieza base de DetailPanel.
8
+ * @see detail-panel — ficha de una entidad desde su lista, ya montada (título, cuerpo, pie, presets)
9
+ * @see drawer — hoja que se cierra arrastrando (móvil)
10
+ * @see dialog — tarea corta centrada
11
+ * @example Editar en un panel lateral
12
+ * <Sheet>
13
+ * <SheetTrigger render={<Button />}>Editar cliente</SheetTrigger>
14
+ * <SheetContent>
15
+ * <SheetHeader>
16
+ * <SheetTitle>Editar cliente</SheetTitle>
17
+ * <SheetDescription>Los cambios se aplican a las facturas pendientes.</SheetDescription>
18
+ * </SheetHeader>
19
+ * <ClientForm />
20
+ * <SheetFooter>
21
+ * <Button onClick={save}>Guardar cambios</Button>
22
+ * <SheetClose render={<Button variant="outline" />}>Cancelar</SheetClose>
23
+ * </SheetFooter>
24
+ * </SheetContent>
25
+ * </Sheet>
26
+ * @example Desde abajo, sin botón de cerrar
27
+ * <SheetContent side="bottom" showCloseButton={false}>
28
+ * <SheetHeader>
29
+ * <SheetTitle>Confirmar exportación</SheetTitle>
30
+ * </SheetHeader>
31
+ * <SheetFooter>
32
+ * <SheetClose render={<Button />}>Exportar</SheetClose>
33
+ * </SheetFooter>
34
+ * </SheetContent>
35
+ * @note Para la ficha de una entidad usa DetailPanel; Sheet a mano solo para lo que no encaja en él.
36
+ * @note Lleva siempre SheetTitle (nombre accesible); las acciones van en SheetFooter.
37
+ * @note En una app multidioma usa `side="end"`/`"start"` (siguen la lectura y se invierten en RTL); `left`/`right` son físicos.
38
+ */
3
39
 
4
40
  declare function Sheet({ ...props }: Dialog.Root.Props): React.JSX.Element;
5
41
  declare function SheetTrigger({ ...props }: Dialog.Trigger.Props): React.JSX.Element;
6
42
  declare function SheetClose({ ...props }: Dialog.Close.Props): React.JSX.Element;
7
- declare function SheetContent({ className, children, side, showCloseButton, ...props }: Dialog.Popup.Props & {
8
- side?: "top" | "right" | "bottom" | "left";
43
+ declare function SheetContent({ className, children, side: sideProp, showCloseButton, ...props }: Dialog.Popup.Props & {
44
+ /** Borde desde el que entra: `start`/`end` siguen la dirección de lectura (RTL); `left`/`right` son físicos. */
45
+ side?: "top" | "bottom" | DsInlineSide;
9
46
  showCloseButton?: boolean;
10
47
  }): React.JSX.Element;
11
48
  declare function SheetHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
package/dist/ui/sheet.js CHANGED
@@ -5,6 +5,8 @@ import { cn } from "../lib/utils.js";
5
5
  import { Button } from "./button.js";
6
6
  import { XIcon } from "lucide-react";
7
7
  import { useDsMessages } from "../hooks/use-ds-messages.js";
8
+ import { useDirection } from "@base-ui/react/direction-provider";
9
+ import { dsPhysicalSide } from "../lib/i18n.js";
8
10
  function Sheet({ ...props }) {
9
11
  return /* @__PURE__ */ jsx(SheetPrimitive.Root, { "data-slot": "sheet", ...props });
10
12
  }
@@ -33,11 +35,13 @@ function SheetOverlay({ className, ...props }) {
33
35
  function SheetContent({
34
36
  className,
35
37
  children,
36
- side = "right",
38
+ side: sideProp = "right",
37
39
  showCloseButton = true,
38
40
  ...props
39
41
  }) {
40
42
  const t = useDsMessages();
43
+ const direction = useDirection();
44
+ const side = sideProp === "top" || sideProp === "bottom" ? sideProp : dsPhysicalSide(sideProp, direction);
41
45
  return /* @__PURE__ */ jsxs(SheetPortal, { children: [
42
46
  /* @__PURE__ */ jsx(SheetOverlay, {}),
43
47
  /* @__PURE__ */ jsxs(
@@ -46,7 +50,7 @@ function SheetContent({
46
50
  "data-slot": "sheet-content",
47
51
  "data-side": side,
48
52
  className: cn(
49
- "fixed z-(--ds-z-overlay) flex flex-col bg-popover bg-clip-padding text-sm text-popover-foreground shadow-overlay transition duration-(--ds-motion-base) ease-(--ds-ease-panel) data-[side=bottom]:inset-x-0 data-[side=bottom]:bottom-0 data-[side=bottom]:h-auto data-[side=bottom]:border-t-(length:--ds-rule-w) data-[side=left]:inset-y-0 data-[side=left]:left-0 data-[side=left]:h-full data-[side=left]:w-3/4 data-[side=left]:border-e-(length:--ds-rule-w) data-[side=right]:inset-y-0 data-[side=right]:right-0 data-[side=right]:h-full data-[side=right]:w-3/4 data-[side=right]:border-s-(length:--ds-rule-w) data-[side=top]:inset-x-0 data-[side=top]:top-0 data-[side=top]:h-auto data-[side=top]:border-b-(length:--ds-rule-w) data-[side=left]:sm:max-w-(--ds-sheet-w) data-[side=right]:sm:max-w-(--ds-sheet-w) data-open:animate-in data-open:fade-in-0 data-[side=bottom]:data-open:slide-in-from-bottom-10 data-[side=left]:data-open:slide-in-from-left-10 data-[side=right]:data-open:slide-in-from-right-10 data-[side=top]:data-open:slide-in-from-top-10 data-closed:animate-out data-closed:fade-out-0 data-[side=bottom]:data-closed:slide-out-to-bottom-10 data-[side=left]:data-closed:slide-out-to-left-10 data-[side=right]:data-closed:slide-out-to-right-10 data-[side=top]:data-closed:slide-out-to-top-10",
53
+ "fixed z-(--ds-z-overlay) flex flex-col bg-popover bg-clip-padding text-sm text-popover-foreground shadow-overlay transition duration-(--ds-motion-base) ease-(--ds-ease-panel) data-[side=bottom]:inset-x-0 data-[side=bottom]:bottom-0 data-[side=bottom]:h-auto data-[side=bottom]:border-t-(length:--ds-rule-w) data-[side=left]:inset-y-0 data-[side=left]:left-0 data-[side=left]:h-full data-[side=left]:w-3/4 data-[side=left]:ltr:border-e-(length:--ds-rule-w) data-[side=left]:rtl:border-s-(length:--ds-rule-w) data-[side=right]:inset-y-0 data-[side=right]:right-0 data-[side=right]:h-full data-[side=right]:w-3/4 data-[side=right]:ltr:border-s-(length:--ds-rule-w) data-[side=right]:rtl:border-e-(length:--ds-rule-w) data-[side=top]:inset-x-0 data-[side=top]:top-0 data-[side=top]:h-auto data-[side=top]:border-b-(length:--ds-rule-w) data-[side=left]:sm:max-w-(--ds-sheet-w) data-[side=right]:sm:max-w-(--ds-sheet-w) data-open:animate-in data-open:fade-in-0 data-[side=bottom]:data-open:slide-in-from-bottom-10 data-[side=left]:data-open:slide-in-from-left-10 data-[side=right]:data-open:slide-in-from-right-10 data-[side=top]:data-open:slide-in-from-top-10 data-closed:animate-out data-closed:fade-out-0 data-[side=bottom]:data-closed:slide-out-to-bottom-10 data-[side=left]:data-closed:slide-out-to-left-10 data-[side=right]:data-closed:slide-out-to-right-10 data-[side=top]:data-closed:slide-out-to-top-10",
50
54
  className
51
55
  ),
52
56
  ...props,
@@ -1,6 +1,20 @@
1
1
  import * as React from 'react';
2
2
  import { DsDataTone } from './legend.js';
3
3
 
4
+ /**
5
+ * @group data
6
+ * @summary Escudo que se rellena según el nivel de protección (0–1); ShieldRadar lo rodea de anillos que laten en protegido o alerta. Para un estado con texto, StatusBadge.
7
+ * @see status-badge — el estado con su texto (protegido, en riesgo), en listas y tablas
8
+ * @see gauge — una puntuación con cifra y escala
9
+ * @see status-hero — disco grande con el icono de la entidad y su estado, en la cabecera de una ficha
10
+ * @example Nivel de protección
11
+ * <Shield value={0.8} label="Cuenta protegida al 80 %" />
12
+ * @example Con radar de alerta
13
+ * <ShieldRadar tone="danger">
14
+ * <Shield value={0.2} />
15
+ * </ShieldRadar>
16
+ */
17
+
4
18
  type ShieldSize = "sm" | "md";
5
19
  declare function Shield({ value, size, label, decorative, className, children, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
6
20
  /** Protección de 0 a 1 (se recorta a ese rango). Sin valor, el escudo vacío. */
@@ -1,5 +1,19 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group content
5
+ * @summary Recorta un texto largo a N líneas con «Ver más / Ver menos» y lo expande en el sitio; el botón solo aparece si de verdad hay recorte.
6
+ * @see collapsible — un bloque con más contenido (formulario, filtros) que se pliega con su disparador
7
+ * @see accordion — varias secciones plegables con título
8
+ * @see detail-panel — ver el detalle completo en un panel aparte
9
+ * @example Descripción en una tarjeta
10
+ * <ShowMore lines={3}>{product.description}</ShowMore>
11
+ * @example Textos propios del botón
12
+ * <ShowMore lines={2} moreLabel="Leer la reseña" lessLabel="Ocultar">
13
+ * {review.body}
14
+ * </ShowMore>
15
+ */
16
+
3
17
  declare function ShowMore({ lines, defaultExpanded, onExpandedChange, moreLabel, lessLabel, className, children, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
4
18
  lines?: number;
5
19
  defaultExpanded?: boolean;
@@ -7,6 +7,7 @@ import { Input } from './input.js';
7
7
  import { Separator } from './separator.js';
8
8
  import { TooltipContent } from './tooltip.js';
9
9
  import { DsDensity } from '../lib/presets.js';
10
+ import { DsInlineSide } from '../lib/i18n.js';
10
11
  import '@base-ui/react/separator';
11
12
  import '@base-ui/react/tooltip';
12
13
 
@@ -30,8 +31,9 @@ declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: se
30
31
  open?: boolean;
31
32
  onOpenChange?: (open: boolean) => void;
32
33
  }): React.JSX.Element;
33
- declare function Sidebar({ side, preset, variant: variantProp, collapsible: collapsibleProp, density: densityProp, tone, indicator, className, children, dir, ...props }: React.ComponentProps<"div"> & {
34
- side?: "left" | "right";
34
+ declare function Sidebar({ side: sideProp, preset, variant: variantProp, collapsible: collapsibleProp, density: densityProp, tone, indicator, className, children, dir, ...props }: React.ComponentProps<"div"> & {
35
+ /** Lado: por defecto `start`, que sigue la dirección de lectura (izquierda en LTR, derecha en RTL); `end` al otro lado; `left`/`right` son físicos y no se invierten. */
36
+ side?: DsInlineSide;
35
37
  /** Intención: fija variant, collapsible y density por defecto (las props explícitas mandan). */
36
38
  preset?: SidebarPreset;
37
39
  variant?: SidebarVariant;
@@ -66,7 +68,7 @@ declare function SidebarGroupContent({ className, ...props }: React.ComponentPro
66
68
  declare function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">): React.JSX.Element;
67
69
  declare function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">): React.JSX.Element;
68
70
  declare const sidebarMenuButtonVariants: (props?: ({
69
- variant?: "outline" | "default" | null | undefined;
71
+ variant?: "default" | "outline" | null | undefined;
70
72
  size?: "default" | "sm" | "lg" | null | undefined;
71
73
  } & class_variance_authority_types.ClassProp) | undefined) => string;
72
74
  declare function SidebarMenuButton({ isActive, variant, size, tooltip, className, render, ...props }: useRender.ComponentProps<"button"> & {
@@ -25,6 +25,8 @@ import {
25
25
  import { PanelLeftIcon } from "lucide-react";
26
26
  import { useDsMessages } from "../hooks/use-ds-messages.js";
27
27
  import { dsWarn } from "../lib/presets.js";
28
+ import { useDirection } from "@base-ui/react/direction-provider";
29
+ import { dsPhysicalSide } from "../lib/i18n.js";
28
30
  const SIDEBAR_COOKIE_NAME = "sidebar_state";
29
31
  const SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;
30
32
  const SIDEBAR_WIDTH = "var(--ds-sidebar-w)";
@@ -126,7 +128,7 @@ function SidebarProvider({
126
128
  ) });
127
129
  }
128
130
  function Sidebar({
129
- side = "left",
131
+ side: sideProp = "start",
130
132
  preset,
131
133
  variant: variantProp,
132
134
  collapsible: collapsibleProp,
@@ -140,6 +142,8 @@ function Sidebar({
140
142
  }) {
141
143
  const { isMobile, state, openMobile, setOpenMobile } = useSidebar();
142
144
  const t = useDsMessages();
145
+ const direction = useDirection();
146
+ const side = dsPhysicalSide(sideProp, dir === "rtl" || dir === "ltr" ? dir : direction);
143
147
  const base = preset ? SIDEBAR_PRESETS[preset] : SIDEBAR_BASE;
144
148
  const variant = variantProp ?? base.variant;
145
149
  const collapsible = collapsibleProp ?? base.collapsible;
@@ -224,7 +228,7 @@ function Sidebar({
224
228
  className: cn(
225
229
  "fixed inset-y-0 z-(--ds-z-sidebar) hidden h-svh w-(--sidebar-width) transition-[left,right,width] duration-(--ds-motion-base) ease-(--ds-ease-collapse) data-[side=left]:left-0 data-[side=left]:group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)] data-[side=right]:right-0 data-[side=right]:group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)] md:flex",
226
230
  // Adjust the padding for floating and inset variants.
227
- variant === "floating" || variant === "inset" ? "p-(--ds-sidebar-pad) group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(var(--ds-sidebar-pad)*2)+(var(--ds-sidebar-ring)*2))]" : "group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[side=left]:border-e-(length:--ds-rule-w) group-data-[side=right]:border-s-(length:--ds-rule-w)",
231
+ variant === "floating" || variant === "inset" ? "p-(--ds-sidebar-pad) group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(var(--ds-sidebar-pad)*2)+(var(--ds-sidebar-ring)*2))]" : "group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[side=left]:ltr:border-e-(length:--ds-rule-w) group-data-[side=left]:rtl:border-s-(length:--ds-rule-w) group-data-[side=right]:ltr:border-s-(length:--ds-rule-w) group-data-[side=right]:rtl:border-e-(length:--ds-rule-w)",
228
232
  className
229
233
  ),
230
234
  ...props,
@@ -532,7 +536,7 @@ function SidebarMenuButton({
532
536
  /* @__PURE__ */ jsx(
533
537
  TooltipContent,
534
538
  {
535
- side: "right",
539
+ side: "inline-end",
536
540
  align: "center",
537
541
  hidden: state !== "collapsed" || isMobile,
538
542
  ...tooltip
@@ -4,7 +4,7 @@ import * as React from 'react';
4
4
  type SparklineSeries = 1 | 2 | 3 | 4 | 5;
5
5
  type SparklineTone = "info" | "success" | "warning" | "danger" | "neutral";
6
6
  declare const sparklineVariants: (props?: ({
7
- color?: "info" | "warning" | "success" | "danger" | "neutral" | "current" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | null | undefined;
7
+ color?: "current" | "neutral" | "info" | "success" | "warning" | "danger" | "series-1" | "series-2" | "series-3" | "series-4" | "series-5" | null | undefined;
8
8
  } & class_variance_authority_types.ClassProp) | undefined) => string;
9
9
  type SparklineProps = Omit<React.ComponentProps<"svg">, "children" | "color"> & {
10
10
  /** Serie de valores; `null` = sin dato (hueco), nunca cero. */
@@ -1,5 +1,37 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group data
5
+ * @summary Maqueta de varias cifras clave (Stat) en fila que sigue el ancho del contenedor: overview en tarjetas, compact, comparison o strip (una sola superficie). Una cifra sola es un Stat.
6
+ * @see stat — una sola cifra clave (KPI)
7
+ * @see description-list — muchos datos término–valor sin destacar (límites, atributos)
8
+ * @see mosaic — mezclar KPI, gráficos y tarjetas en una rejilla (bento)
9
+ * @example Preset overview (tarjetas)
10
+ * <StatGroup preset="overview">
11
+ * <Stat>
12
+ * <StatLabel>Ingresos</StatLabel>
13
+ * <StatValue value={48200} format={{ style: "currency", currency: "EUR", maximumFractionDigits: 0 }} />
14
+ * </Stat>
15
+ * <Stat>
16
+ * <StatLabel>Pedidos</StatLabel>
17
+ * <StatValue value={1284} />
18
+ * </Stat>
19
+ * </StatGroup>
20
+ * @example Preset strip con Stat variant="plain"
21
+ * <StatGroup preset="strip">
22
+ * <Stat variant="plain">
23
+ * <StatLabel>Pedidos</StatLabel>
24
+ * <StatValue value={1284} />
25
+ * <StatDelta value={-2.4} />
26
+ * </Stat>
27
+ * <Stat variant="plain" tone="bad">
28
+ * <StatLabel>Devoluciones</StatLabel>
29
+ * <StatValue value={87} />
30
+ * <StatDelta value={12} polarity="lower-is-better" />
31
+ * </Stat>
32
+ * </StatGroup>
33
+ */
34
+
3
35
  type StatGroupPreset = "overview" | "compact" | "comparison" | "strip";
4
36
  declare function StatGroup({ preset, className, ...props }: React.ComponentProps<"div"> & {
5
37
  preset?: StatGroupPreset;
@@ -4,7 +4,7 @@ import * as React from 'react';
4
4
  type StatusLevel = "critical" | "warning" | "ok" | "info" | "neutral" | "none";
5
5
  type StatusBadgeVariant = "soft" | "dot" | "outline";
6
6
  declare const statusDotVariants: (props?: ({
7
- level?: "info" | "warning" | "none" | "neutral" | "critical" | "ok" | null | undefined;
7
+ level?: "none" | "neutral" | "info" | "warning" | "critical" | "ok" | null | undefined;
8
8
  } & class_variance_authority_types.ClassProp) | undefined) => string;
9
9
  type StatusDotProps = Omit<React.ComponentProps<"span">, "children"> & {
10
10
  level?: StatusLevel;
@@ -17,7 +17,7 @@ type StatusDotProps = Omit<React.ComponentProps<"span">, "children"> & {
17
17
  declare function StatusDot({ level, pulse, size, label, className, ...props }: StatusDotProps): React.JSX.Element;
18
18
  declare const statusBadgeVariants: (props?: ({
19
19
  variant?: "outline" | "dot" | "soft" | null | undefined;
20
- level?: "info" | "warning" | "none" | "neutral" | "critical" | "ok" | null | undefined;
20
+ level?: "none" | "neutral" | "info" | "warning" | "critical" | "ok" | null | undefined;
21
21
  } & class_variance_authority_types.ClassProp) | undefined) => string;
22
22
  type StatusBadgeProps = Omit<React.ComponentProps<"span">, "children"> & {
23
23
  level?: StatusLevel;
@@ -1,5 +1,23 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group data
5
+ * @summary Disco grande con el icono o la imagen de una entidad, halo del color de su estado e insignia: el estado en la cabecera de su ficha (dispositivo protegido, cuenta en riesgo).
6
+ * @see status-badge — el estado con texto en listas, tablas y filas
7
+ * @see shield — nivel de protección 0–1 en forma de escudo
8
+ * @see avatar — la imagen o iniciales de una persona, sin estado
9
+ * @example Estado de un dispositivo
10
+ * <StatusHero tone="success" label="Portátil de Ana: protegido">
11
+ * <LaptopIcon />
12
+ * </StatusHero>
13
+ * @example Sin insignia
14
+ * <StatusHero tone="info" badge={null} label="Cuenta de Luis">
15
+ * <UserIcon />
16
+ * </StatusHero>
17
+ * @note label con la entidad y su estado en texto (es role=img): sin él se lee solo el nombre del estado. El halo nunca es el único portador.
18
+ * @note Uno por vista, en la cabecera de un detalle; en listas y tablas usa StatusBadge o StatusDot.
19
+ */
20
+
3
21
  type StatusHeroTone = "success" | "warning" | "danger" | "info" | "neutral";
4
22
  declare function StatusHero({ tone, label, badge, className, style, children, ...props }: React.ComponentProps<"div"> & {
5
23
  tone?: StatusHeroTone;
@@ -1,5 +1,17 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group navigation
5
+ * @summary Indicador no interactivo del paso actual como puntos (onboarding, carrusel, asistente corto), sin títulos.
6
+ * @see stepper — pasos con título y estado (completo, actual, error)
7
+ * @see step-ring — avance compacto en un círculo, para una fila de tabla
8
+ * @see carousel — pasar diapositivas con controles
9
+ * @example Paso 2 de 5
10
+ * <StepDots count={5} current={2} />
11
+ * @note `current` empieza en 1; el texto accesible («Paso 2 de 5») lo pone la pieza.
12
+ * @note No navega: si la persona debe saltar entre pasos, usa Stepper o los controles de Carousel.
13
+ */
14
+
3
15
  declare function StepDots({ count, current, className, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
4
16
  /** Número de pasos. */
5
17
  count: number;
@@ -1,5 +1,19 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group navigation
5
+ * @summary Avance compacto de un proceso por pasos en un círculo de sectores (completados, actual, pendientes); cabe en una fila de tabla o junto a un título.
6
+ * @see stepper — pasos visibles con su título y estado
7
+ * @see step-dots — paso actual de un onboarding o carrusel
8
+ * @see task-progress — barra de avance de una tarea con etiqueta y contador
9
+ * @example 2 de 4 completados y el 3.º en curso
10
+ * <StepRing total={4} completed={2} current />
11
+ * @example Proceso terminado
12
+ * <StepRing total={5} completed={5} />
13
+ * @note El texto accesible («2 de 4 pasos completados») lo pone la pieza; no añadas otro.
14
+ * @note `current` pinta en curso el paso siguiente a los completados; úsalo con pocos pasos (≤ 8) para que los sectores se distingan.
15
+ */
16
+
3
17
  declare function StepRing({ total, completed, current, className, style, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
4
18
  /** Número de sectores (pasos). */
5
19
  total?: number;
@@ -1,5 +1,14 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group chat
5
+ * @summary Chips con preguntas o acciones sugeridas para empezar o continuar una conversación; al elegir una, la app la envía o la pone en el campo.
6
+ * @see toggle-group — elegir una opción que se queda marcada
7
+ * @see chat-composer — el campo donde se escribe el mensaje
8
+ * @example En el estado vacío del chat
9
+ * <Suggestions items={["Resume esta incidencia", "Tradúcelo al inglés"]} onSelect={(s) => send(s)} />
10
+ */
11
+
3
12
  declare function Suggestions({ items, onSelect, className, ...props }: Omit<React.ComponentProps<"div">, "children" | "onSelect"> & {
4
13
  items: string[];
5
14
  onSelect?: (item: string) => void;
@@ -1,5 +1,31 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group data
5
+ * @summary Tabla HTML con el estilo del sistema (cabecera, filas, pie y leyenda) para datos estáticos y pocas filas. Si hay que ordenar, buscar, filtrar, paginar o seleccionar, DataTable.
6
+ * @see data-table — datos de trabajo: orden, búsqueda, filtros, paginación y selección
7
+ * @see description-list — pares término–valor de una sola cosa
8
+ * @see entity-list — lista de entidades como filas Item o tarjetas
9
+ * @example Montaje mínimo
10
+ * <Table>
11
+ * <TableCaption>Facturas emitidas en octubre.</TableCaption>
12
+ * <TableHeader>
13
+ * <TableRow>
14
+ * <TableHead>Factura</TableHead>
15
+ * <TableHead>Cliente</TableHead>
16
+ * </TableRow>
17
+ * </TableHeader>
18
+ * <TableBody>
19
+ * <TableRow>
20
+ * <TableCell>F-2024-118</TableCell>
21
+ * <TableCell>Acme S.L.</TableCell>
22
+ * </TableRow>
23
+ * </TableBody>
24
+ * </Table>
25
+ * @note Solo para datos estáticos; si la persona necesita ordenar, filtrar, paginar o seleccionar, usa DataTable. Pares clave–valor → DescriptionList.
26
+ * @note Cifras con Quantity o con el formato del idioma (Intl), nunca a mano; fila seleccionada con data-state="selected".
27
+ */
28
+
3
29
  declare function Table({ className, ...props }: React.ComponentProps<"table">): React.JSX.Element;
4
30
  declare function TableHeader({ className, ...props }: React.ComponentProps<"thead">): React.JSX.Element;
5
31
  declare function TableBody({ className, ...props }: React.ComponentProps<"tbody">): React.JSX.Element;
package/dist/ui/tabs.d.ts CHANGED
@@ -5,7 +5,7 @@ import { VariantProps } from 'class-variance-authority';
5
5
 
6
6
  declare function Tabs({ className, orientation, ...props }: Tabs$1.Root.Props): React.JSX.Element;
7
7
  declare const tabsListVariants: (props?: ({
8
- variant?: "default" | "line" | null | undefined;
8
+ variant?: "line" | "default" | null | undefined;
9
9
  } & class_variance_authority_types.ClassProp) | undefined) => string;
10
10
  declare function TabsList({ className, variant, ...props }: Tabs$1.List.Props & VariantProps<typeof tabsListVariants>): React.JSX.Element;
11
11
  declare function TabsTrigger({ className, ...props }: Tabs$1.Tab.Props): React.JSX.Element;
@@ -0,0 +1,21 @@
1
+ import * as React from 'react';
2
+
3
+ type TagInputProps = Omit<React.ComponentProps<"input">, "value" | "defaultValue" | "onChange" | "size" | "max"> & {
4
+ value?: string[];
5
+ defaultValue?: string[];
6
+ onValueChange?: (value: string[]) => void;
7
+ /** Teclas que, además de Intro, cierran una etiqueta. Por defecto, la coma. */
8
+ separators?: string[];
9
+ /** Máximo de etiquetas; al llegar, el campo deja de admitir más. */
10
+ max?: number;
11
+ /** Devuelve false para rechazar una etiqueta (queda escrita para corregirla). */
12
+ validate?: (tag: string) => boolean;
13
+ allowDuplicates?: boolean;
14
+ /** Añadir lo escrito al salir del campo. */
15
+ addOnBlur?: boolean;
16
+ /** Clases del contenedor (el `className` también va al contenedor). */
17
+ inputClassName?: string;
18
+ };
19
+ declare function TagInput({ value: valueProp, defaultValue, onValueChange, separators, max, validate, allowDuplicates, addOnBlur, name, disabled, className, inputClassName, placeholder, onKeyDown, onBlur, onPaste, "aria-invalid": ariaInvalid, ...props }: TagInputProps): React.JSX.Element;
20
+
21
+ export { TagInput, type TagInputProps };