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,169 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { XIcon } from "lucide-react";
4
+ import * as React from "react";
5
+ import { useDsMessages } from "../hooks/use-ds-messages.js";
6
+ import { cn } from "../lib/utils.js";
7
+ import { Button } from "./button.js";
8
+ function TagInput({
9
+ value: valueProp,
10
+ defaultValue = [],
11
+ onValueChange,
12
+ separators = [","],
13
+ max,
14
+ validate,
15
+ allowDuplicates = false,
16
+ addOnBlur = true,
17
+ name,
18
+ disabled,
19
+ className,
20
+ inputClassName,
21
+ placeholder,
22
+ onKeyDown,
23
+ onBlur,
24
+ onPaste,
25
+ "aria-invalid": ariaInvalid,
26
+ ...props
27
+ }) {
28
+ const t = useDsMessages();
29
+ const [inner, setInner] = React.useState(defaultValue);
30
+ const tags = valueProp ?? inner;
31
+ const [draft, setDraft] = React.useState("");
32
+ const [rejected, setRejected] = React.useState(false);
33
+ const inputRef = React.useRef(null);
34
+ const full = max != null && tags.length >= max;
35
+ const commit = (next) => {
36
+ if (valueProp === void 0) setInner(next);
37
+ onValueChange?.(next);
38
+ };
39
+ const add = (raw) => {
40
+ const next = [...tags];
41
+ const left = [];
42
+ for (const r of raw) {
43
+ const tag = r.trim();
44
+ if (!tag) continue;
45
+ const dup = !allowDuplicates && next.some((x) => x.toLowerCase() === tag.toLowerCase());
46
+ if (dup) continue;
47
+ if (max != null && next.length >= max || validate && !validate(tag)) {
48
+ left.push(tag);
49
+ continue;
50
+ }
51
+ next.push(tag);
52
+ }
53
+ if (next.length !== tags.length) commit(next);
54
+ return left;
55
+ };
56
+ const flush = () => {
57
+ if (!draft.trim()) return;
58
+ const left = add([draft]);
59
+ setRejected(left.length > 0);
60
+ setDraft(left.join(" "));
61
+ };
62
+ const remove = (i) => {
63
+ commit(tags.filter((_, j) => j !== i));
64
+ inputRef.current?.focus();
65
+ };
66
+ const splitter = new RegExp(`[${separators.map((s) => s.replace(/[\\\]^-]/g, "\\$&")).join("")}\\n]`);
67
+ return /* @__PURE__ */ jsxs(
68
+ "div",
69
+ {
70
+ "data-slot": "tag-input",
71
+ "data-disabled": disabled || void 0,
72
+ "data-full": full || void 0,
73
+ className: cn(
74
+ "flex min-h-(--ds-control-h-md) w-full min-w-0 cursor-text flex-wrap items-center gap-1.5 rounded-control border border-(--ds-field-border) bg-(--ds-field-bg) bg-clip-padding px-(--ds-field-px) py-1.5 text-sm transition-colors duration-(--ds-motion-snap) focus-within:border-ring focus-within:ring-(length:--ds-ring-width) focus-within:ring-(--ds-ring-color) has-aria-invalid:border-(--ds-invalid-border) has-aria-invalid:ring-(length:--ds-ring-width) has-aria-invalid:ring-(--ds-invalid-ring) has-data-[slot=tag-input-tag]:ps-1.5 data-disabled:pointer-events-none data-disabled:cursor-not-allowed data-disabled:opacity-(--ds-disabled-opacity)",
75
+ className
76
+ ),
77
+ onMouseDown: (e) => {
78
+ if (e.target === e.currentTarget) {
79
+ e.preventDefault();
80
+ inputRef.current?.focus();
81
+ }
82
+ },
83
+ children: [
84
+ tags.map((tag, i) => /* @__PURE__ */ jsxs(
85
+ "span",
86
+ {
87
+ "data-slot": "tag-input-tag",
88
+ className: "flex h-(--ds-chip-h) max-w-full min-w-0 items-center gap-1 rounded-control bg-muted-foreground/10 ps-2 text-xs font-(--ds-medium-weight) text-foreground",
89
+ children: [
90
+ /* @__PURE__ */ jsx("span", { className: "truncate", children: tag }),
91
+ /* @__PURE__ */ jsx(
92
+ Button,
93
+ {
94
+ type: "button",
95
+ variant: "ghost",
96
+ size: "icon-xs",
97
+ "data-slot": "tag-input-remove",
98
+ className: "-ms-1 opacity-50 hover:opacity-100",
99
+ disabled,
100
+ "aria-label": t.tagRemove.replace("{name}", tag),
101
+ onClick: () => remove(i),
102
+ children: /* @__PURE__ */ jsx(XIcon, { className: "pointer-events-none" })
103
+ }
104
+ ),
105
+ name ? /* @__PURE__ */ jsx("input", { type: "hidden", name, value: tag }) : null
106
+ ]
107
+ },
108
+ `${tag}-${i}`
109
+ )),
110
+ /* @__PURE__ */ jsx(
111
+ "input",
112
+ {
113
+ ref: inputRef,
114
+ "data-slot": "tag-input-field",
115
+ className: cn("min-w-16 flex-1 bg-transparent outline-none placeholder:text-muted-foreground disabled:cursor-not-allowed", inputClassName),
116
+ value: draft,
117
+ disabled,
118
+ readOnly: full,
119
+ placeholder: full ? void 0 : placeholder,
120
+ "aria-label": props["aria-label"] ?? (props.id || props["aria-labelledby"] ? void 0 : t.tagAdd),
121
+ "aria-invalid": ariaInvalid ?? (rejected || void 0),
122
+ onChange: (e) => {
123
+ setRejected(false);
124
+ const v = e.target.value;
125
+ if (splitter.test(v)) {
126
+ const parts = v.split(splitter);
127
+ const rest = parts.pop() ?? "";
128
+ const left = add(parts);
129
+ setRejected(left.length > 0);
130
+ setDraft([...left, rest].filter(Boolean).join(" "));
131
+ } else setDraft(v);
132
+ },
133
+ onKeyDown: (e) => {
134
+ onKeyDown?.(e);
135
+ if (e.defaultPrevented || e.nativeEvent.isComposing) return;
136
+ if (e.key === "Enter") {
137
+ if (draft.trim()) {
138
+ e.preventDefault();
139
+ flush();
140
+ }
141
+ } else if (e.key === "Backspace" && draft === "" && tags.length > 0) {
142
+ e.preventDefault();
143
+ commit(tags.slice(0, -1));
144
+ }
145
+ },
146
+ onPaste: (e) => {
147
+ onPaste?.(e);
148
+ if (e.defaultPrevented) return;
149
+ const text = e.clipboardData.getData("text");
150
+ if (!splitter.test(text)) return;
151
+ e.preventDefault();
152
+ const left = add(text.split(splitter));
153
+ setRejected(left.length > 0);
154
+ setDraft(left.join(" "));
155
+ },
156
+ onBlur: (e) => {
157
+ onBlur?.(e);
158
+ if (addOnBlur) flush();
159
+ },
160
+ ...props
161
+ }
162
+ )
163
+ ]
164
+ }
165
+ );
166
+ }
167
+ export {
168
+ TagInput
169
+ };
@@ -1,5 +1,20 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group feedback
5
+ * @summary Carga ilustrada de una tarea larga (analizar el correo, escanear dispositivos): ilustración, barra fina y brillo al terminar; con `value` muestra avance, sin él es indeterminada.
6
+ * @see task-progress — avance de un proceso con etiqueta, contador y estado, sin ilustración
7
+ * @see progress — barra de avance simple dentro de un formulario o lista
8
+ * @see page-loader — carga de una ruta o de toda la app
9
+ * @example Con avance conocido
10
+ * <TaskLoader icon={<MailIllustration />} value={40} label="Analizando el correo" />
11
+ * @example Indeterminado
12
+ * <TaskLoader icon={<MailIllustration />} label="Analizando…" />
13
+ * @example Terminado
14
+ * <TaskLoader icon={<CheckIllustration />} state="done" label="Análisis completado" />
15
+ * @note La ilustración la pone la app y es decorativa; `label` describe el estado para lectores de pantalla y cambia al terminar.
16
+ */
17
+
3
18
  type TaskLoaderState = "running" | "done";
4
19
  declare function TaskLoader({ icon, value, state, label, className, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
5
20
  /** Ilustración (decorativa). */
@@ -1,5 +1,19 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group data
5
+ * @summary Avance de una tarea o proceso con su estado (sin empezar, en curso, completado, con error y su motivo visible). Para uso frente a lo contratado, UsageMeter; para pasos de un asistente, StepDots.
6
+ * @see progress — barra de progreso básica, sin estado ni texto propio
7
+ * @see task-loader — espera de un proceso largo con sus pasos
8
+ * @see usage-meter — uso frente a un límite contratado (no es un avance)
9
+ * @example Por recuento
10
+ * <TaskProgress label="Análisis de dispositivos" current={3} total={5} />
11
+ * @example Con error y su motivo
12
+ * <TaskProgress label="Sincronización" value={70} state="error" error="Sin conexión con el servidor" />
13
+ * @note value es un porcentaje 0–100, o current/total para un recuento; sin state, el estado se deduce del valor (0 sin empezar, 100 completado).
14
+ * @note Un fallo va con state="error" y error con el motivo en texto (se anuncia por aria-describedby), no solo en color.
15
+ */
16
+
3
17
  type TaskState = "idle" | "running" | "done" | "error";
4
18
  declare function TaskProgress({ label, value, current, total, state, error, counter, className, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
5
19
  label?: React.ReactNode;
@@ -1,11 +1,32 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group forms
5
+ * @summary Campo de texto de varias líneas para comentarios, notas o descripciones sin formato.
6
+ * @see input — texto de una línea
7
+ * @see instruction-editor — texto con formato (Markdown), prompts o documentos
8
+ * @see chat-composer — escribir mensajes en un chat
9
+ * @example Con etiqueta y ayuda
10
+ * <Field>
11
+ * <FieldLabel htmlFor="notes">Notas al pie</FieldLabel>
12
+ * <Textarea id="notes" placeholder="Condiciones de pago, IBAN…" />
13
+ * <FieldDescription>Máximo 300 caracteres.</FieldDescription>
14
+ * </Field>
15
+ * @example Que crezca con el texto
16
+ * <Textarea autoGrow placeholder="Describe la incidencia" />
17
+ * @note `autoGrow`: crece con lo escrito hasta --ds-textarea-max-h y después desplaza (CSS `field-sizing`; en navegadores sin soporte se queda con su alto).
18
+ * @note Con límite de caracteres, dilo en FieldDescription antes de que la persona escriba.
19
+ */
20
+
3
21
  /**
4
22
  * Mismo lenguaje visual que `Input` —borde, fondo, foco, estados aria-invalid—
5
23
  * pero con `rounded-md` en vez de `rounded-control shadow-control`: la pildora de `Input` funciona
6
24
  * porque su altura fija la acerca a un circulo; en una caja multilinea, mas alta,
7
25
  * el mismo radio se ve desproporcionado en las esquinas superiores.
8
26
  */
9
- declare function Textarea({ className, ...props }: React.ComponentProps<"textarea">): React.JSX.Element;
27
+ declare function Textarea({ className, autoGrow, ...props }: React.ComponentProps<"textarea"> & {
28
+ /** Crece con el texto hasta --ds-textarea-max-h (después, desplazamiento). */
29
+ autoGrow?: boolean;
30
+ }): React.JSX.Element;
10
31
 
11
32
  export { Textarea };
@@ -1,12 +1,18 @@
1
1
  import { jsx } from "react/jsx-runtime";
2
2
  import { cn } from "../lib/utils.js";
3
- function Textarea({ className, ...props }) {
3
+ function Textarea({
4
+ className,
5
+ autoGrow = false,
6
+ ...props
7
+ }) {
4
8
  return /* @__PURE__ */ jsx(
5
9
  "textarea",
6
10
  {
7
11
  "data-slot": "textarea",
12
+ "data-auto-grow": autoGrow || void 0,
8
13
  className: cn(
9
14
  "min-h-16 w-full min-w-0 rounded-field-multiline border border-(--ds-field-border) bg-(--ds-field-bg) px-(--ds-field-px) py-2 text-base transition-colors duration-(--ds-motion-snap) outline-none placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-(length:--ds-ring-width) focus-visible:ring-(--ds-ring-color) disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-(--ds-disabled-opacity) aria-invalid:border-(--ds-invalid-border) aria-invalid:ring-(length:--ds-ring-width) aria-invalid:ring-(--ds-invalid-ring) md:text-sm",
15
+ autoGrow && "max-h-(--ds-textarea-max-h) resize-none overflow-y-auto [field-sizing:content]",
10
16
  className
11
17
  ),
12
18
  ...props
@@ -1,5 +1,31 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group data
5
+ * @summary Historial o actividad en una lista ordenada: eventos con punto o icono, título, hora (absoluta o relativa) y acciones. Para avisos con seguimiento, NotificationCenter (notifications).
6
+ * @see notifications — avisos con estado (nuevo, revisado, resuelto) en la campana
7
+ * @see step-flow — pasos de un proceso que la persona recorre, no eventos pasados
8
+ * @see entity-list — lista de entidades, no de sucesos en el tiempo
9
+ * @example Evento con icono, hora relativa y acciones
10
+ * <Timeline>
11
+ * <TimelineItem tone="danger">
12
+ * <TimelineIndicator>
13
+ * <BellRingIcon />
14
+ * </TimelineIndicator>
15
+ * <TimelineContent>
16
+ * <TimelineTitle>SLA por debajo del 80 %</TimelineTitle>
17
+ * <TimelineTime dateTime={event.createdAt} relative />
18
+ * <TimelineDescription>Cola de soporte técnico, turno de tarde.</TimelineDescription>
19
+ * <TimelineActions>
20
+ * <Button size="sm">Responder</Button>
21
+ * </TimelineActions>
22
+ * </TimelineContent>
23
+ * </TimelineItem>
24
+ * </Timeline>
25
+ * @note Del más reciente al más antiguo; la hora siempre con TimelineTime (relative para lo reciente), nunca escrita a mano.
26
+ * @note tone del vocabulario común (info, success, warning, danger, primary, neutral) para el punto; el significado lo dice el título, no el color.
27
+ */
28
+
3
29
  type TimelineTone = "neutral" | "primary" | "info" | "success" | "warning" | "danger";
4
30
  declare function Timeline({ className, ...props }: React.ComponentProps<"ol">): React.JSX.Element;
5
31
  declare function TimelineItem({ className, tone, ...props }: React.ComponentProps<"li"> & {
@@ -5,6 +5,30 @@ import { VariantProps } from 'class-variance-authority';
5
5
  import { toggleVariants } from './toggle.js';
6
6
  import 'class-variance-authority/types';
7
7
 
8
+ /**
9
+ * @group actions
10
+ * @summary Grupo de botones que quedan pulsados para elegir una opción (vista, periodo) o varias (formato); el estado se ve en el propio botón.
11
+ * @see toggle — un único botón que se activa o desactiva
12
+ * @see radio-group — elegir una opción dentro de un formulario, con etiquetas largas
13
+ * @see tabs — cambiar entre paneles de contenido
14
+ * @example Una opción (vista)
15
+ * <ToggleGroup variant="outline" spacing={0} defaultValue={["grid"]} aria-label="Vista">
16
+ * <ToggleGroupItem value="grid">Cuadrícula</ToggleGroupItem>
17
+ * <ToggleGroupItem value="list">Lista</ToggleGroupItem>
18
+ * </ToggleGroup>
19
+ * @example Varias a la vez, solo icono
20
+ * <ToggleGroup multiple defaultValue={["bold"]} aria-label="Formato">
21
+ * <ToggleGroupItem value="bold" aria-label="Negrita">
22
+ * <BoldIcon />
23
+ * </ToggleGroupItem>
24
+ * <ToggleGroupItem value="italic" aria-label="Cursiva">
25
+ * <ItalicIcon />
26
+ * </ToggleGroupItem>
27
+ * </ToggleGroup>
28
+ * @note `value`/`defaultValue` es siempre una lista, también con una sola opción; `multiple` permite varias.
29
+ * @note Pon `aria-label` al grupo y a cada elemento de solo icono. `spacing={0}` los une en un bloque.
30
+ */
31
+
8
32
  declare function ToggleGroup({ className, variant, size, spacing, orientation, children, ...props }: ToggleGroup$1.Props & VariantProps<typeof toggleVariants> & {
9
33
  spacing?: number;
10
34
  orientation?: "horizontal" | "vertical";
@@ -4,7 +4,7 @@ import { Toggle as Toggle$1 } from '@base-ui/react/toggle';
4
4
  import { VariantProps } from 'class-variance-authority';
5
5
 
6
6
  declare const toggleVariants: (props?: ({
7
- variant?: "outline" | "default" | null | undefined;
7
+ variant?: "default" | "outline" | null | undefined;
8
8
  size?: "default" | "sm" | "lg" | null | undefined;
9
9
  } & class_variance_authority_types.ClassProp) | undefined) => string;
10
10
  declare function Toggle({ className, variant, size, ...props }: Toggle$1.Props & VariantProps<typeof toggleVariants>): React.JSX.Element;
@@ -1,5 +1,17 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group agents
5
+ * @summary Una llamada a herramienta de un agente: nombre, estado y, plegables, su entrada y su salida; con status="approval" pide a la persona Aprobar o Denegar.
6
+ * @see agent-events — la secuencia completa de lo que hizo el agente
7
+ * @see chain-of-thought — resumen de pasos sin entrada ni salida
8
+ * @see confirm-action — confirmar una acción de la propia persona, no de un agente
9
+ * @example Llamada terminada
10
+ * <ToolCall name="search_docs" status="done" input={{ q: "tarifas 2026" }} output={result} />
11
+ * @example Espera aprobación (human-in-the-loop)
12
+ * <ToolCall name="delete_invoice" status="approval" input={{ id: "F-2026-118" }} onApprove={approve} onDeny={deny} />
13
+ */
14
+
3
15
  type ToolCallStatus = "running" | "done" | "error" | "approval";
4
16
  declare function ToolCall({ name, status, input, output, defaultOpen, onApprove, onDeny, className, ...props }: Omit<React.ComponentProps<"div">, "children"> & {
5
17
  name: string;
@@ -0,0 +1,42 @@
1
+ import * as React from 'react';
2
+ import { DsQuantityOptions } from '../lib/format.js';
3
+
4
+ /**
5
+ * @group data
6
+ * @summary Uso frente a lo contratado («12 GB de 50 GB»): avisa al 80 %, es crítico al 100 % e ilimitado va sin barra. Para un objetivo que se quiere alcanzar, StatProgress (en Stat).
7
+ * @see stat — KPI con StatProgress para objetivos (cuota, presupuesto, SLA)
8
+ * @see proportion-bar — parte frente al total o reparto en segmentos, sin semántica de límite
9
+ * @see gauge — un valor en anillo o arco con la cifra en el centro
10
+ * @example Con restante
11
+ * <UsageMeter label="Almacenamiento" value={12} limit={50} unit="GBy" showRemaining />
12
+ * @example Ilimitado y sin medir
13
+ * <UsageMeter label="Copias este mes" value={128} limit={null} />
14
+ * <UsageMeter label="Almacenamiento" value={null} limit={50} unit="GBy" />
15
+ * @example Compacto en una fila de lista
16
+ * <UsageMeter label="Ana" value={3.2} limit={10} unit="GBy" size="compact" />
17
+ */
18
+
19
+ type UsageState = "normal" | "warning" | "critical" | "unlimited" | "empty";
20
+ type UsageMeterProps = Omit<React.ComponentProps<"div">, "children"> & Pick<DsQuantityOptions, "system" | "maximumFractionDigits"> & {
21
+ /** Qué se mide («Almacenamiento»). Lo pone la app. */
22
+ label?: React.ReactNode;
23
+ /** Uso actual. null = aún sin medir (no es cero). */
24
+ value: number | null | undefined;
25
+ /** Límite contratado, en la misma unidad. null o undefined = ilimitado. */
26
+ limit?: number | null;
27
+ /** Unidad UCUM de value y limit (`GBy`, `By`, `{device}`, `h`…). */
28
+ unit?: string;
29
+ /** Proporción desde la que avisa (0..1). 0.8 por defecto. */
30
+ warnAt?: number;
31
+ /** Proporción desde la que es crítico (0..1). 1 por defecto. */
32
+ dangerAt?: number;
33
+ /** Añade «Quedan 38 GB» (o «8 GB por encima del límite»). */
34
+ showRemaining?: boolean;
35
+ /** default: etiqueta y cifra encima de la barra · compact: en una línea, para filas de lista. */
36
+ size?: "default" | "compact";
37
+ /** Texto propio en lugar de «12 GB de 50 GB». */
38
+ valueText?: React.ReactNode;
39
+ };
40
+ declare function UsageMeter({ label, value, limit, unit, warnAt, dangerAt, showRemaining, size, valueText, system, maximumFractionDigits, className, ...props }: UsageMeterProps): React.JSX.Element;
41
+
42
+ export { UsageMeter, type UsageMeterProps, type UsageState };
@@ -0,0 +1,116 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import * as React from "react";
4
+ import { Meter as MeterPrimitive } from "@base-ui/react/meter";
5
+ import { useDsLocale, useDsMessages } from "../hooks/use-ds-messages.js";
6
+ import { dsFormat } from "../lib/i18n.js";
7
+ import { formatQuantity, formatRatio } from "../lib/format.js";
8
+ import { cn } from "../lib/utils.js";
9
+ function UsageMeter({
10
+ label,
11
+ value,
12
+ limit,
13
+ unit,
14
+ warnAt = 0.8,
15
+ dangerAt = 1,
16
+ showRemaining = false,
17
+ size = "default",
18
+ valueText,
19
+ system,
20
+ maximumFractionDigits,
21
+ className,
22
+ ...props
23
+ }) {
24
+ const t = useDsMessages();
25
+ const locale = useDsLocale();
26
+ const labelId = React.useId();
27
+ const fmt = (n) => formatQuantity(n, unit, { locale, system, maximumFractionDigits });
28
+ const measured = typeof value === "number" && Number.isFinite(value);
29
+ const bounded = typeof limit === "number" && Number.isFinite(limit) && limit > 0;
30
+ const ratio = measured && bounded ? value / limit : null;
31
+ const state = !measured ? "empty" : !bounded ? "unlimited" : ratio >= dangerAt ? "critical" : ratio >= warnAt ? "warning" : "normal";
32
+ const used = fmt(value);
33
+ const total = bounded ? fmt(limit) : null;
34
+ const main = state === "empty" ? t.statNoData : state === "unlimited" ? dsFormat(t.usageUnlimited, { value: used ?? "" }) : dsFormat(t.usageOf, { value: used ?? "", limit: total ?? "" });
35
+ let extra = null;
36
+ if (showRemaining && measured && bounded) {
37
+ const diff = limit - value;
38
+ extra = diff >= 0 ? dsFormat(t.usageRemaining, { amount: fmt(diff) ?? "" }) : dsFormat(t.usageOver, { amount: fmt(-diff) ?? "" });
39
+ }
40
+ const pct = ratio == null ? null : formatRatio(ratio, { locale });
41
+ const ariaText = [main, pct, extra].filter(Boolean).join(" \xB7 ");
42
+ const fill = state === "critical" ? "bg-(--ds-usage-fill-critical)" : state === "warning" ? "bg-(--ds-usage-fill-warning)" : "bg-(--ds-usage-fill)";
43
+ return /* @__PURE__ */ jsxs(
44
+ "div",
45
+ {
46
+ "data-slot": "usage-meter",
47
+ "data-state": state,
48
+ "data-size": size,
49
+ className: cn(
50
+ "group/usage-meter flex min-w-0 flex-col gap-1.5",
51
+ size === "compact" && "gap-1",
52
+ className
53
+ ),
54
+ ...props,
55
+ children: [
56
+ /* @__PURE__ */ jsxs("div", { "data-slot": "usage-meter-header", className: "flex min-w-0 flex-wrap items-baseline justify-between gap-x-3 gap-y-0.5", children: [
57
+ label != null && /* @__PURE__ */ jsx("span", { id: labelId, "data-slot": "usage-meter-label", className: "min-w-0 text-sm font-(--ds-label-weight) text-foreground", children: label }),
58
+ /* @__PURE__ */ jsx(
59
+ "span",
60
+ {
61
+ "data-slot": "usage-meter-value",
62
+ "aria-hidden": "true",
63
+ className: cn(
64
+ "text-sm text-muted-foreground tabular-nums",
65
+ state === "critical" && "text-danger",
66
+ size === "compact" && "text-xs"
67
+ ),
68
+ children: valueText ?? main
69
+ }
70
+ )
71
+ ] }),
72
+ state !== "unlimited" && /* @__PURE__ */ jsx(
73
+ MeterPrimitive.Root,
74
+ {
75
+ value: ratio == null ? 0 : Math.min(1, Math.max(0, ratio)) * 100,
76
+ min: 0,
77
+ max: 100,
78
+ "aria-labelledby": label != null ? labelId : void 0,
79
+ getAriaValueText: () => ariaText,
80
+ "data-slot": "usage-meter-bar",
81
+ children: /* @__PURE__ */ jsx(
82
+ MeterPrimitive.Track,
83
+ {
84
+ "data-slot": "usage-meter-track",
85
+ className: "relative block h-(--ds-usage-h) w-full overflow-hidden rounded-track bg-(--ds-track-bg)",
86
+ children: /* @__PURE__ */ jsx(
87
+ MeterPrimitive.Indicator,
88
+ {
89
+ "data-slot": "usage-meter-indicator",
90
+ className: cn(
91
+ "block h-full rounded-track transition-[width,background-color] duration-(--ds-motion-slow) ease-(--ds-ease-standard) motion-reduce:transition-none",
92
+ fill
93
+ )
94
+ }
95
+ )
96
+ }
97
+ )
98
+ }
99
+ ),
100
+ state === "unlimited" && /* @__PURE__ */ jsx("span", { className: "sr-only", children: ariaText }),
101
+ extra && /* @__PURE__ */ jsx(
102
+ "span",
103
+ {
104
+ "data-slot": "usage-meter-remaining",
105
+ "aria-hidden": "true",
106
+ className: cn("text-xs text-muted-foreground tabular-nums", state === "critical" && "text-danger"),
107
+ children: extra
108
+ }
109
+ )
110
+ ]
111
+ }
112
+ );
113
+ }
114
+ export {
115
+ UsageMeter
116
+ };
@@ -1,5 +1,16 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group navigation
5
+ * @summary Una semana en una fila para elegir un día cercano (agenda, reservas, llamadas), con flechas para cambiar de semana y un punto en los días con algo.
6
+ * @see calendar — mes completo, fechas lejanas o rangos
7
+ * @see date-picker — campo de formulario para una fecha
8
+ * @example Controlado, con días marcados
9
+ * <WeekStrip value={day} onValueChange={setDay} marked={(d) => hasEvents(d)} />
10
+ * @example Libre, semana desde el domingo
11
+ * <WeekStrip defaultValue={new Date()} weekStartsOn={0} />
12
+ */
13
+
3
14
  declare function WeekStrip({ value, defaultValue, onValueChange, weekStartsOn, marked, className, ...props }: Omit<React.ComponentProps<"div">, "defaultValue" | "onChange"> & {
4
15
  value?: Date;
5
16
  defaultValue?: Date;
@@ -49,7 +49,7 @@ function WeekStrip({
49
49
  className: cn("flex items-center gap-(--ds-week-gap)", className),
50
50
  ...props,
51
51
  children: [
52
- /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": t.weekPrevious, onClick: () => setShift((s) => s - 1), children: /* @__PURE__ */ jsx(ChevronLeftIcon, {}) }),
52
+ /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": t.weekPrevious, onClick: () => setShift((s) => s - 1), children: /* @__PURE__ */ jsx(ChevronLeftIcon, { className: "rtl:rotate-180" }) }),
53
53
  /* @__PURE__ */ jsx("div", { className: "grid flex-1 grid-cols-7 gap-(--ds-week-gap)", children: days.map((d) => {
54
54
  const active = sameDay(d, selected);
55
55
  return /* @__PURE__ */ jsxs(
@@ -72,7 +72,7 @@ function WeekStrip({
72
72
  d.toISOString()
73
73
  );
74
74
  }) }),
75
- /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": t.weekNext, onClick: () => setShift((s) => s + 1), children: /* @__PURE__ */ jsx(ChevronRightIcon, {}) })
75
+ /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": t.weekNext, onClick: () => setShift((s) => s + 1), children: /* @__PURE__ */ jsx(ChevronRightIcon, { className: "rtl:rotate-180" }) })
76
76
  ]
77
77
  }
78
78
  );
@@ -1,5 +1,33 @@
1
1
  import * as React from 'react';
2
2
 
3
+ /**
4
+ * @group agents
5
+ * @summary Ejecución de un workflow o automatización ya definida: nodos en orden con estado y duración, ramas en paralelo, progreso y Cancelar o Reintentar.
6
+ * @see chain-of-thought — pasos que decide el agente sobre la marcha, dentro de un mensaje
7
+ * @see agent-events — traza con tiempos de un agente
8
+ * @see stepper — pasos de un proceso que recorre la persona
9
+ * @example Ejecución con una rama en paralelo
10
+ * <WorkflowRun
11
+ * name="Resumir incidencias"
12
+ * status="running"
13
+ * nodes={[
14
+ * { id: "fetch", title: "Leer incidencias", status: "done", duration: "1,2 s" },
15
+ * {
16
+ * id: "classify",
17
+ * title: "Clasificar",
18
+ * status: "running",
19
+ * branches: [
20
+ * { id: "client", title: "Por cliente", status: "done" },
21
+ * { id: "severity", title: "Por gravedad", status: "running" },
22
+ * ],
23
+ * },
24
+ * { id: "send", title: "Enviar resumen", status: "pending" },
25
+ * ]}
26
+ * onCancel={cancel}
27
+ * onRetry={retry}
28
+ * />
29
+ */
30
+
3
31
  type WorkflowNodeStatus = "pending" | "running" | "done" | "error" | "skipped";
4
32
  type WorkflowRunStatus = "running" | "succeeded" | "failed" | "cancelled";
5
33
  interface WorkflowNode {
@@ -1,6 +1,6 @@
1
1
  # ADR 0001 · Soporte de derecha a izquierda (RTL) con clases lógicas
2
2
 
3
- - **Estado:** aceptado. Implementación **pendiente**: no es prioritaria y se hará en una versión menor.
3
+ - **Estado:** aceptado e **implementado** (0.43.0). Ver «Estado de la implementación» al final.
4
4
  - **Fecha:** 2026-10-12
5
5
  - **Origen:** revisión de i18n de orbital-ds 0.9.0 y petición de la plantilla de referencia (`CAS-IA/TANSTACK-WORKER-UI`, issue #4).
6
6
 
@@ -76,3 +76,16 @@ En RTL esas clases no se invierten: márgenes, rellenos, alineaciones, flechas y
76
76
  3. Iconos de dirección con `rtl:rotate-180`.
77
77
  4. Escaparate con `ar` y `dir="rtl"`.
78
78
  5. Doctor en modo error, guía en `AGENTS.md` y versión menor.
79
+
80
+ ## Estado de la implementación (0.43.0)
81
+
82
+ - **Clases lógicas:** hechas. El doctor ya **rechaza** (error) `ml`/`mr`/`pl`/`pr`, `text-left/right`, `border-l/r` y
83
+ `rounded-l/r` en los componentes. Quedan físicos a propósito los centrados `left-1/2 -translate-x-1/2` (simétricos).
84
+ - **Iconos de dirección:** `rtl:rotate-180` en miga de pan, submenús, paginación, carrusel, tira de semana, «volver» del
85
+ acceso, pasos y tabla; el calendario lo hace con su propio selector y recibe `dir`.
86
+ - **Paneles:** `Sheet` y `Sidebar` aceptan `side="start" | "end"` (traducido con `dsPhysicalSide`); `left`/`right`
87
+ siguen siendo físicos y su filete interior cae en el lado correcto también en RTL. La pista del lateral recogido
88
+ sale en `inline-end`.
89
+ - **Carrusel:** Embla recibe `direction` y las flechas del teclado se invierten en RTL.
90
+ - **Punto 4 revisado:** a petición de la suite, el paquete trae ya **hebreo** (`he`), además de fr, it y de.
91
+ - **Pendiente:** revisión visual en el escaparate con `he` y `dir="rtl"` (punto 6).
@@ -55,7 +55,7 @@ hueco (ver §6).
55
55
  Ni `!important`, ni selectores propios contra la librería.
56
56
  - La marca es de `brand.css`; la personalidad, del tema. El diseñador **no elige** fuentes, colores ni radios:
57
57
  los pone el tema. Si la app necesita otro aspecto, se ajusta en `brand.css` (o se elige otro tema).
58
- - Textos de la app con su i18n; los de orbital-ds ya vienen en en/es/pt-BR.
58
+ - Textos de la app con su i18n; los de orbital-ds ya vienen en en/es/pt-BR/fr/it/de/he.
59
59
  - Movimiento: el del tema (`orbital-ds/motion.css` si está activo; Motion con `useDsMotion()` para lo demás).
60
60
 
61
61
  ## 5. Verificar (antes de dar nada por bueno)