orbital-ds 0.40.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 (197) hide show
  1. package/AGENTS.md +29 -10
  2. package/components.manifest.json +6469 -3349
  3. package/dist/auth-form-B1hgbXkI.d.ts +144 -0
  4. package/dist/hooks/use-ds-messages.d.ts +89 -0
  5. package/dist/lib/a2ui-catalog.d.ts +42 -0
  6. package/dist/lib/a2ui-catalog.js +558 -0
  7. package/dist/lib/a2ui.d.ts +289 -0
  8. package/dist/lib/a2ui.js +215 -0
  9. package/dist/lib/ai-events.d.ts +15 -0
  10. package/dist/lib/ai-events.js +202 -0
  11. package/dist/lib/auth-flow.d.ts +3 -1
  12. package/dist/lib/auth-flow.js +24 -3
  13. package/dist/lib/format.d.ts +57 -0
  14. package/dist/lib/format.js +177 -0
  15. package/dist/lib/i18n.d.ts +96 -2
  16. package/dist/lib/i18n.js +278 -2
  17. package/dist/lib/locales/de.d.ts +7 -0
  18. package/dist/lib/locales/de.js +535 -0
  19. package/dist/lib/locales/fr.d.ts +7 -0
  20. package/dist/lib/locales/fr.js +535 -0
  21. package/dist/lib/locales/he.d.ts +7 -0
  22. package/dist/lib/locales/he.js +535 -0
  23. package/dist/lib/locales/it.d.ts +7 -0
  24. package/dist/lib/locales/it.js +535 -0
  25. package/dist/styles.css +62 -2
  26. package/dist/ui/a2ui-renderer.d.ts +44 -0
  27. package/dist/ui/a2ui-renderer.js +793 -0
  28. package/dist/ui/agent-events.d.ts +49 -0
  29. package/dist/ui/agent-events.js +108 -0
  30. package/dist/ui/ai-tag.d.ts +16 -0
  31. package/dist/ui/alert-dialog.d.ts +37 -0
  32. package/dist/ui/alert.d.ts +1 -1
  33. package/dist/ui/animated-number.d.ts +11 -0
  34. package/dist/ui/app-bar.d.ts +22 -0
  35. package/dist/ui/attachment.d.ts +1 -1
  36. package/dist/ui/auth-backdrop.d.ts +17 -0
  37. package/dist/ui/auth-form.d.ts +3 -110
  38. package/dist/ui/auth-form.js +46 -11
  39. package/dist/ui/auth-layout.d.ts +38 -0
  40. package/dist/ui/avatar.d.ts +27 -0
  41. package/dist/ui/ayuda.d.ts +1 -1
  42. package/dist/ui/ayuda.js +4 -1
  43. package/dist/ui/badge.d.ts +1 -1
  44. package/dist/ui/banner.d.ts +1 -1
  45. package/dist/ui/bottom-nav.d.ts +22 -0
  46. package/dist/ui/breadcrumb.d.ts +22 -0
  47. package/dist/ui/breadcrumb.js +1 -1
  48. package/dist/ui/bubble.d.ts +1 -1
  49. package/dist/ui/button.d.ts +2 -2
  50. package/dist/ui/calendar.d.ts +13 -0
  51. package/dist/ui/calendar.js +3 -0
  52. package/dist/ui/card-stack.d.ts +27 -0
  53. package/dist/ui/card.d.ts +33 -0
  54. package/dist/ui/carousel.d.ts +35 -0
  55. package/dist/ui/carousel.js +10 -5
  56. package/dist/ui/chain-of-thought.d.ts +34 -0
  57. package/dist/ui/chain-of-thought.js +90 -0
  58. package/dist/ui/chart-card.d.ts +19 -0
  59. package/dist/ui/chart.d.ts +19 -0
  60. package/dist/ui/chat-composer.d.ts +58 -0
  61. package/dist/ui/chat-composer.js +192 -0
  62. package/dist/ui/choice-card.d.ts +33 -0
  63. package/dist/ui/code-block.d.ts +15 -0
  64. package/dist/ui/combobox.d.ts +48 -0
  65. package/dist/ui/command-palette.d.ts +18 -0
  66. package/dist/ui/command.d.ts +34 -0
  67. package/dist/ui/confirm-action.d.ts +30 -0
  68. package/dist/ui/confirm-dialog.d.ts +23 -0
  69. package/dist/ui/content-card.d.ts +14 -0
  70. package/dist/ui/context-menu.d.ts +35 -0
  71. package/dist/ui/context-menu.js +1 -1
  72. package/dist/ui/conversation-list.d.ts +44 -0
  73. package/dist/ui/conversation-list.js +141 -0
  74. package/dist/ui/copy-button.d.ts +11 -0
  75. package/dist/ui/date-time.d.ts +40 -0
  76. package/dist/ui/date-time.js +55 -0
  77. package/dist/ui/description-list.d.ts +49 -0
  78. package/dist/ui/description-list.js +86 -0
  79. package/dist/ui/detail-panel.d.ts +22 -0
  80. package/dist/ui/dialog.d.ts +35 -0
  81. package/dist/ui/dock.d.ts +17 -0
  82. package/dist/ui/drawer.d.ts +41 -0
  83. package/dist/ui/dropdown-menu.d.ts +32 -0
  84. package/dist/ui/dropdown-menu.js +1 -1
  85. package/dist/ui/echart.d.ts +15 -0
  86. package/dist/ui/empty.d.ts +1 -1
  87. package/dist/ui/entity-list.d.ts +32 -0
  88. package/dist/ui/form-layout.d.ts +24 -0
  89. package/dist/ui/gauge.d.ts +26 -0
  90. package/dist/ui/generated-image.d.ts +33 -0
  91. package/dist/ui/generated-image.js +65 -0
  92. package/dist/ui/generated-table.d.ts +29 -0
  93. package/dist/ui/generated-table.js +59 -0
  94. package/dist/ui/heatmap-grid.d.ts +20 -0
  95. package/dist/ui/hero.d.ts +58 -0
  96. package/dist/ui/hero.js +145 -0
  97. package/dist/ui/i18n-provider.d.ts +16 -0
  98. package/dist/ui/icon-tile.d.ts +2 -2
  99. package/dist/ui/input-group.d.ts +1 -1
  100. package/dist/ui/input-otp.d.ts +23 -0
  101. package/dist/ui/input.d.ts +16 -0
  102. package/dist/ui/instruction-editor.d.ts +17 -0
  103. package/dist/ui/item.d.ts +3 -3
  104. package/dist/ui/label.d.ts +17 -0
  105. package/dist/ui/legend.d.ts +25 -0
  106. package/dist/ui/level-meter.d.ts +12 -0
  107. package/dist/ui/load-more.d.ts +17 -0
  108. package/dist/ui/loading-state.d.ts +12 -0
  109. package/dist/ui/markdown.d.ts +29 -0
  110. package/dist/ui/markdown.js +123 -0
  111. package/dist/ui/media-card.d.ts +16 -0
  112. package/dist/ui/menubar.d.ts +39 -0
  113. package/dist/ui/message-actions.d.ts +21 -0
  114. package/dist/ui/message-actions.js +79 -0
  115. package/dist/ui/message-scroller.d.ts +30 -0
  116. package/dist/ui/message.d.ts +33 -0
  117. package/dist/ui/mfa-challenge.d.ts +3 -32
  118. package/dist/ui/mfa-challenge.js +1 -1
  119. package/dist/ui/mfa-setup.d.ts +1 -1
  120. package/dist/ui/mosaic.d.ts +23 -0
  121. package/dist/ui/motion-provider.d.ts +17 -0
  122. package/dist/ui/native-select.d.ts +22 -0
  123. package/dist/ui/next-step-card.d.ts +55 -0
  124. package/dist/ui/next-step-card.js +92 -0
  125. package/dist/ui/notice-review.d.ts +32 -0
  126. package/dist/ui/oauth-consent.d.ts +1 -1
  127. package/dist/ui/page-header.d.ts +46 -4
  128. package/dist/ui/page-header.js +20 -11
  129. package/dist/ui/page-loader.d.ts +17 -0
  130. package/dist/ui/page-shell.d.ts +17 -0
  131. package/dist/ui/pagination.d.ts +20 -0
  132. package/dist/ui/pagination.js +2 -2
  133. package/dist/ui/panel.d.ts +1 -1
  134. package/dist/ui/password-strength.d.ts +14 -0
  135. package/dist/ui/popover.d.ts +32 -0
  136. package/dist/ui/proportion-bar.d.ts +25 -0
  137. package/dist/ui/quantity.d.ts +25 -0
  138. package/dist/ui/quantity.js +27 -0
  139. package/dist/ui/questionnaire.d.ts +38 -0
  140. package/dist/ui/reasoning.d.ts +24 -0
  141. package/dist/ui/reasoning.js +62 -0
  142. package/dist/ui/reveal.d.ts +17 -0
  143. package/dist/ui/sheet.d.ts +39 -2
  144. package/dist/ui/sheet.js +6 -2
  145. package/dist/ui/shield.d.ts +14 -0
  146. package/dist/ui/show-more.d.ts +14 -0
  147. package/dist/ui/sidebar.d.ts +4 -2
  148. package/dist/ui/sidebar.js +7 -3
  149. package/dist/ui/sparkline.d.ts +1 -1
  150. package/dist/ui/stat-group.d.ts +32 -0
  151. package/dist/ui/stat.d.ts +1 -1
  152. package/dist/ui/status-badge.d.ts +3 -3
  153. package/dist/ui/status-hero.d.ts +18 -0
  154. package/dist/ui/step-dots.d.ts +12 -0
  155. package/dist/ui/step-ring.d.ts +14 -0
  156. package/dist/ui/suggestions.d.ts +17 -0
  157. package/dist/ui/suggestions.js +39 -0
  158. package/dist/ui/table.d.ts +26 -0
  159. package/dist/ui/tag-input.d.ts +21 -0
  160. package/dist/ui/tag-input.js +169 -0
  161. package/dist/ui/task-loader.d.ts +15 -0
  162. package/dist/ui/task-progress.d.ts +14 -0
  163. package/dist/ui/textarea.d.ts +22 -1
  164. package/dist/ui/textarea.js +7 -1
  165. package/dist/ui/timeline.d.ts +26 -0
  166. package/dist/ui/toggle-group.d.ts +24 -0
  167. package/dist/ui/tool-call.d.ts +27 -0
  168. package/dist/ui/tool-call.js +74 -0
  169. package/dist/ui/usage-meter.d.ts +42 -0
  170. package/dist/ui/usage-meter.js +116 -0
  171. package/dist/ui/week-strip.d.ts +11 -0
  172. package/dist/ui/week-strip.js +2 -2
  173. package/dist/ui/workflow-run.d.ts +51 -0
  174. package/dist/ui/workflow-run.js +185 -0
  175. package/docs/adr/0001-rtl-clases-logicas.md +14 -1
  176. package/docs/designer/criterio.md +87 -87
  177. package/docs/designer/flujo.md +1 -1
  178. package/docs/designer/patrones.md +43 -2
  179. package/manifest/actions.json +364 -0
  180. package/manifest/agents.json +399 -0
  181. package/manifest/ai.json +128 -0
  182. package/manifest/auth.json +1547 -0
  183. package/manifest/chat.json +612 -0
  184. package/manifest/content.json +2298 -0
  185. package/manifest/data.json +2904 -0
  186. package/manifest/feedback.json +1005 -0
  187. package/manifest/forms.json +1954 -0
  188. package/manifest/motion.json +196 -0
  189. package/manifest/navigation.json +1792 -0
  190. package/manifest/overlays.json +931 -0
  191. package/package.json +35 -21
  192. package/scripts/cli.mjs +105 -8
  193. package/scripts/doctor.mjs +126 -1
  194. package/scripts/eslint-plugin.mjs +93 -0
  195. package/scripts/i18n.mjs +1 -1
  196. package/scripts/manifest.mjs +159 -7
  197. package/skill/SKILL.md +8 -3
@@ -0,0 +1,51 @@
1
+ import * as React from 'react';
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
+
31
+ type WorkflowNodeStatus = "pending" | "running" | "done" | "error" | "skipped";
32
+ type WorkflowRunStatus = "running" | "succeeded" | "failed" | "cancelled";
33
+ interface WorkflowNode {
34
+ id: string;
35
+ title: React.ReactNode;
36
+ description?: React.ReactNode;
37
+ status?: WorkflowNodeStatus;
38
+ /** Duración ya formateada («1,2 s»); la pone la app. */
39
+ duration?: string;
40
+ /** Ramas que corren a la vez bajo este nodo. */
41
+ branches?: WorkflowNode[];
42
+ }
43
+ declare function WorkflowRun({ name, status, nodes, onCancel, onRetry, className, ...props }: Omit<React.ComponentProps<"section">, "children"> & {
44
+ name: React.ReactNode;
45
+ status?: WorkflowRunStatus;
46
+ nodes: WorkflowNode[];
47
+ onCancel?: () => void;
48
+ onRetry?: () => void;
49
+ }): React.JSX.Element;
50
+
51
+ export { type WorkflowNode, type WorkflowNodeStatus, WorkflowRun, type WorkflowRunStatus };
@@ -0,0 +1,185 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import {
4
+ AlertCircleIcon,
5
+ CheckCircle2Icon,
6
+ CircleDashedIcon,
7
+ MinusCircleIcon,
8
+ RotateCcwIcon,
9
+ SquareIcon
10
+ } from "lucide-react";
11
+ import { useDsMessages } from "../hooks/use-ds-messages.js";
12
+ import { dsFormat } from "../lib/i18n.js";
13
+ import { cn } from "../lib/utils.js";
14
+ import { Button } from "./button.js";
15
+ import { Spinner } from "./spinner.js";
16
+ function flat(nodes) {
17
+ return nodes.flatMap((n) => [n, ...n.branches ? flat(n.branches) : []]);
18
+ }
19
+ const TEXT = {
20
+ pending: "text-muted-foreground",
21
+ running: "text-info",
22
+ done: "text-success",
23
+ error: "text-danger",
24
+ skipped: "text-muted-foreground"
25
+ };
26
+ function StatusIcon({ status }) {
27
+ if (status === "running") return /* @__PURE__ */ jsx(Spinner, { "aria-hidden": true, role: "presentation", className: "size-3.5" });
28
+ if (status === "done") return /* @__PURE__ */ jsx(CheckCircle2Icon, {});
29
+ if (status === "error") return /* @__PURE__ */ jsx(AlertCircleIcon, {});
30
+ if (status === "skipped") return /* @__PURE__ */ jsx(MinusCircleIcon, {});
31
+ return /* @__PURE__ */ jsx(CircleDashedIcon, {});
32
+ }
33
+ function Node({ node, last }) {
34
+ const t = useDsMessages();
35
+ const status = node.status ?? "pending";
36
+ const statusText = {
37
+ pending: t.workflowWaiting,
38
+ running: t.workflowRunning,
39
+ done: t.workflowSucceeded,
40
+ error: t.workflowFailed,
41
+ skipped: t.workflowSkipped
42
+ };
43
+ return /* @__PURE__ */ jsxs(
44
+ "li",
45
+ {
46
+ "data-slot": "workflow-node",
47
+ "data-status": status,
48
+ "aria-current": status === "running" ? "step" : void 0,
49
+ className: "relative flex gap-3 pb-4 last:pb-0",
50
+ children: [
51
+ !last ? /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: "absolute start-2.5 top-6 bottom-0 w-px -translate-x-1/2 bg-(--ds-track-bg)" }) : null,
52
+ /* @__PURE__ */ jsx(
53
+ "span",
54
+ {
55
+ "aria-hidden": true,
56
+ className: cn(
57
+ "relative mt-0.5 flex size-5 shrink-0 items-center justify-center rounded-full bg-background [&_svg]:size-4",
58
+ TEXT[status]
59
+ ),
60
+ children: /* @__PURE__ */ jsx(StatusIcon, { status })
61
+ }
62
+ ),
63
+ /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1", children: [
64
+ /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-baseline gap-x-2", children: [
65
+ /* @__PURE__ */ jsx(
66
+ "span",
67
+ {
68
+ className: cn(
69
+ "text-sm",
70
+ status === "pending" || status === "skipped" ? "text-muted-foreground" : "text-foreground",
71
+ status === "running" && "text-shimmer"
72
+ ),
73
+ children: node.title
74
+ }
75
+ ),
76
+ /* @__PURE__ */ jsx("span", { className: cn("text-xs", TEXT[status]), children: statusText[status] }),
77
+ node.duration ? /* @__PURE__ */ jsx("span", { className: "ms-auto text-xs tabular-nums text-muted-foreground", children: node.duration }) : null
78
+ ] }),
79
+ node.description ? /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: node.description }) : null,
80
+ node.branches?.length ? /* @__PURE__ */ jsx(
81
+ "div",
82
+ {
83
+ role: "group",
84
+ "aria-label": t.workflowParallel,
85
+ className: "mt-1 grid gap-2 rounded-lg border border-border bg-muted/40 p-3 @[32rem]:grid-cols-2",
86
+ children: /* @__PURE__ */ jsx("ol", { className: "contents", children: node.branches.map((b) => /* @__PURE__ */ jsxs(
87
+ "li",
88
+ {
89
+ "data-slot": "workflow-branch",
90
+ "data-status": b.status ?? "pending",
91
+ className: "flex items-start gap-2 text-sm",
92
+ children: [
93
+ /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: cn("mt-0.5 [&_svg]:size-4", TEXT[b.status ?? "pending"]), children: /* @__PURE__ */ jsx(StatusIcon, { status: b.status ?? "pending" }) }),
94
+ /* @__PURE__ */ jsxs("span", { className: "min-w-0 flex-1", children: [
95
+ /* @__PURE__ */ jsx("span", { className: "block truncate", children: b.title }),
96
+ b.duration ? /* @__PURE__ */ jsx("span", { className: "text-xs tabular-nums text-muted-foreground", children: b.duration }) : null
97
+ ] })
98
+ ]
99
+ },
100
+ b.id
101
+ )) })
102
+ }
103
+ ) : null
104
+ ] })
105
+ ]
106
+ }
107
+ );
108
+ }
109
+ function WorkflowRun({
110
+ name,
111
+ status = "running",
112
+ nodes,
113
+ onCancel,
114
+ onRetry,
115
+ className,
116
+ ...props
117
+ }) {
118
+ const t = useDsMessages();
119
+ const all = flat(nodes);
120
+ const done = all.filter((n) => n.status === "done" || n.status === "skipped").length;
121
+ const label = {
122
+ running: t.workflowRunning,
123
+ succeeded: t.workflowSucceeded,
124
+ failed: t.workflowFailed,
125
+ cancelled: t.workflowCancelled
126
+ };
127
+ const tone = {
128
+ running: "text-info",
129
+ succeeded: "text-success",
130
+ failed: "text-danger",
131
+ cancelled: "text-muted-foreground"
132
+ };
133
+ const pct = all.length ? Math.round(done / all.length * 100) : 0;
134
+ return /* @__PURE__ */ jsxs(
135
+ "section",
136
+ {
137
+ "data-slot": "workflow-run",
138
+ "data-status": status,
139
+ className: cn("@container flex flex-col gap-4 rounded-xl border border-border bg-card p-4 text-card-foreground", className),
140
+ ...props,
141
+ children: [
142
+ /* @__PURE__ */ jsxs("header", { className: "flex flex-wrap items-center gap-x-3 gap-y-2", children: [
143
+ /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-1 flex-col", children: [
144
+ /* @__PURE__ */ jsx("h3", { className: "truncate text-sm font-(--ds-strong-weight)", children: name }),
145
+ /* @__PURE__ */ jsxs("p", { className: "text-xs text-muted-foreground", children: [
146
+ /* @__PURE__ */ jsx("span", { className: tone[status], children: label[status] }),
147
+ " \xB7 ",
148
+ dsFormat(t.workflowProgress, { done, total: all.length })
149
+ ] })
150
+ ] }),
151
+ status === "running" && onCancel ? /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", onClick: onCancel, children: [
152
+ /* @__PURE__ */ jsx(SquareIcon, { "data-icon": "inline-start" }),
153
+ t.workflowCancel
154
+ ] }) : null,
155
+ (status === "failed" || status === "cancelled") && onRetry ? /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", onClick: onRetry, children: [
156
+ /* @__PURE__ */ jsx(RotateCcwIcon, { "data-icon": "inline-start" }),
157
+ t.workflowRetry
158
+ ] }) : null
159
+ ] }),
160
+ /* @__PURE__ */ jsx(
161
+ "div",
162
+ {
163
+ role: "progressbar",
164
+ "aria-valuemin": 0,
165
+ "aria-valuemax": 100,
166
+ "aria-valuenow": pct,
167
+ "aria-label": dsFormat(t.workflowProgress, { done, total: all.length }),
168
+ className: "h-1 overflow-hidden rounded-full bg-(--ds-track-bg)",
169
+ children: /* @__PURE__ */ jsx(
170
+ "div",
171
+ {
172
+ className: cn("h-full rounded-full transition-[width]", status === "failed" ? "bg-danger" : status === "succeeded" ? "bg-success" : "bg-primary"),
173
+ style: { width: `${pct}%` }
174
+ }
175
+ )
176
+ }
177
+ ),
178
+ /* @__PURE__ */ jsx("ol", { children: nodes.map((n, i) => /* @__PURE__ */ jsx(Node, { node: n, last: i === nodes.length - 1 }, n.id)) })
179
+ ]
180
+ }
181
+ );
182
+ }
183
+ export {
184
+ WorkflowRun
185
+ };
@@ -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).
@@ -1,87 +1,87 @@
1
- # Diseñador orbital-ds · 5. Criterio visual (armonía y elección de elementos)
2
-
3
- Cómo **analizar el aspecto** de una pantalla y **elegir el elemento correcto** (¿tarjeta, ítem, bento, imagen,
4
- efecto?) antes de componerla. Va entre `patrones.md` (qué patrón) y `revision.md` (comprobación). Si choca con el
5
- contrato o el tema, gana el sistema; esto sirve para elegir **dentro** de él.
6
-
7
- Origen: síntesis de referentes de la industria. Las fuentes son guías públicas y artículos de práctica; los números
8
- concretos son orientativos, no normas. Contrasta lo que dependa de una cifra.
9
-
10
- ## 1. Qué enseñan los referentes (y cómo se traduce aquí)
11
-
12
- | Referente | Idea útil | En orbital-ds |
13
- |---|---|---|
14
- | **Apple HIG** (claridad, deferencia, profundidad; en iOS 26, jerarquía · armonía · consistencia) | El contenido manda; la interfaz se aparta. El vidrio/material va en la capa de **control y navegación**, no en la de contenido. | `glass` y fondos vivos solo en cabeceras, lateral, paneles flotantes o fondos de acceso; nunca detrás de texto largo ni de tablas. |
15
- | **Material 3 Expressive** (Google) | Dar **énfasis** (color, forma, tamaño) al elemento clave ayuda a encontrarlo antes; un grupo no pequeño prefiere versiones calmadas. La mejora medida de forma independiente es moderada, no mágica. | Un solo elemento enfatizado por vista (`variant` principal, tarjeta `feature`/`hero`); el resto, calmado. Respeta `--ds-density` y el tema. |
16
- | **Nielsen** (10 heurísticas) | Estado visible, consistencia, minimalismo, recuperarse de errores. | `ux.md`. Cada elemento extra compite con lo importante. |
17
- | **Polaris / GOV.UK** | Documentan **cuándo usar y cuándo NO usar** cada pieza. | Los `@note` del manifiesto; si dudas entre dos piezas, lee el `@note` de ambas. |
18
- | **Carbon / Primer / Atlassian** | Tokens y patrones antes que píxeles; un componente «experimental» no se usa de base. | Variables `--ds-*`; nada de medidas a mano. |
19
-
20
- ## 2. Cómo analizar una pantalla (en este orden, 8 pasos)
21
-
22
- Puntúa cada uno 0–2 (0 falla · 1 mejorable · 2 bien). Por debajo de 12/16, rehaz antes de entregar.
23
-
24
- 1. **Jerarquía.** Mirando entrecerrado: ¿se distingue **una** cosa principal, luego lo secundario, luego el resto?
25
- Tamaño y peso primero, color después. Si todo destaca, nada destaca.
26
- 2. **Ritmo y agrupación.** La proximidad agrupa: más espacio **entre** grupos que **dentro**. Misma separación para
27
- lo del mismo nivel (usa los espacios del sistema, `--ds-density`; no inventes).
28
- 3. **Alineación y rejilla.** Bordes comunes; columnas coherentes; la bento o el mosaico con `Mosaic`, no con
29
- anchos sueltos. Orden del DOM = orden de lectura (el orden visual no debe contradecirlo).
30
- 4. **Contraste y legibilidad.** Texto sobre imagen **siempre con velo** (`--ds-card-scrim`); estado nunca solo con color; AA mínimo.
31
- 5. **Consistencia.** Mismo patrón para el mismo problema; mismas esquinas, sombras y gestos que el tema.
32
- 6. **Densidad.** ¿Cuánto hay por pantalla? Una vista de trabajo admite densidad; una de decisión, aire. Más de ~9 celdas
33
- en un bloque bento diluye la jerarquía.
34
- 7. **Estados.** Vacío, carga (forma del contenido), error con reintento, éxito, desactivado, foco, hover/pulsado.
35
- 8. **Movimiento.** Explica origen o cambio de estado; ritmo del tema; quieto con movimiento reducido.
36
-
37
- ## 3. Elegir el elemento (árbol de decisión)
38
-
39
- **¿Qué tengo que mostrar?**
40
- - **Una entidad que se lista y se actúa** (agente, dispositivo, proyecto) → `Item variant="card"` (+ `ItemMedia`/`IconTile`,
41
- `ItemActions`). No `Card` + `Item` a mano.
42
- - **Contenido con título, texto y a veces imagen** (artículo, producto, recurso) → `ContentCard` con su `preset`
43
- (`basic` · `feature` · `media` · `horizontal` · `cover`).
44
- - **Una cifra o una tendencia** → `StatGroup` / KPI / `ChartCard preset="glance"`. No una tarjeta de texto con un número.
45
- - **Un grupo de bloques de distinto peso** (resumen, portada, panel) → `Mosaic preset="bento" | "hero" | "showcase"` con `MosaicItem span`.
46
- - **Un bloque único de sección con cabecera, contenido y pie** → `Card`.
47
- - **Una lista larga homogénea** → `EntityList` / `DataTable`; no un mosaico.
48
- - **Agrupar sin caja** → separador y espacio, no otra tarjeta (nada de tarjetas dentro de tarjetas).
49
-
50
- **Tarjeta con imagen o fondo (`ContentCard preset="cover"`, `Card backdrop`):**
51
- - Úsala cuando la imagen **es** el contenido (destino, producto, campaña). No para decorar un formulario.
52
- - Título corto sobre el velo; ninguna información crítica solo en la imagen; `alt` o `aria-hidden` según informe o decore.
53
- - Un fondo vivo (`backdrop` mesh/aurora/dots, `animated`) como mucho en 1–2 tarjetas por vista; son énfasis, no textura general.
54
-
55
- **Efectos de interacción (`hoverable`, `spotlight`, `glow`):**
56
- - Solo en tarjetas **pulsables** (llevan enlace o acción). Un efecto de «clicable» en algo que no lo es engaña.
57
- - Uno por tarjeta (elige `hoverable` **o** `spotlight`); el hover es refuerzo, nunca el único aviso (táctil no tiene hover).
58
-
59
- **Bento — reglas:**
60
- - Es una **jerarquía**, no una rejilla de cajas iguales: 1 celda protagonista, 2–3 medianas, el resto pequeñas.
61
- - Cada celda cuenta una cosa; la protagonista lleva el mensaje principal.
62
- - En móvil cae a una columna conservando el orden de importancia.
63
-
64
- **Revelar y cargar:**
65
- - Entrada al desplazar (`Reveal`): solo bloques fuera de la primera pantalla; no en listas que se filtran o reordenan.
66
- - Listas largas: `LoadMore` (botón, con el resto visible; `auto` solo como extra) antes que scroll infinito; para saltar a una
67
- página o trabajar con datos, `Pagination`.
68
- - Texto largo en una tarjeta: `ShowMore`.
69
- - Búsqueda mientras se escribe: `SearchBox` (recientes y populares al enfocar; estados vacío/error; la app pone la consulta).
70
-
71
- ## 4. Armonía: lo que hace que «se vea cuidado»
72
- - **Una voz.** Un énfasis por vista; el resto, calmado. Un tema = un gesto firma.
73
- - **Radios coherentes:** el radio de lo de dentro es menor que el de su contenedor (los tokens ya lo resuelven; no pongas `rounded-*` sueltos).
74
- - **Sombras y capas:** solo las del tema (`shadow-*`, `--ds-card-glow`); la elevación indica interactividad o capa, no decoración.
75
- - **Titulares y párrafos:** equilibrados (`text-wrap: balance` en títulos, `pretty` en párrafos), longitud de línea cómoda (≈ 45–75 caracteres).
76
- - **Color:** de la marca solo el primario como acento; neutros del tema; los estados con su tono semántico.
77
- - **Espacio:** el aire es parte del diseño; recortarlo para «meter más» baja la jerarquía.
78
- - **Detalle de estado:** foco visible, desactivado legible, carga con forma real, error con salida.
79
-
80
- ## 5. Si algo no se puede lograr con el sistema
81
- No lo fuerces con estilos propios: dilo, propón la combinación de patrones más cercana y anota el hueco (variable o
82
- variante que faltaría) para la librería. Es mejor un hueco anotado que una pantalla fuera del sistema.
83
-
84
- ## Fuentes
85
- Apple HIG y su revisión Liquid Glass (resúmenes: createwithswift.com, superdesign.dev); Google Design, «Expressive Design: research»
86
- y el estudio independiente (ACM, 2026); Nielsen Norman Group (10 heurísticas); guías «cuándo usar / cuándo no» de Polaris y
87
- GOV.UK; guías de bento y de carga progresiva (Smashing Magazine, uxpatterns.dev). Verifica en las fuentes oficiales si una decisión depende de una cifra.
1
+ # Diseñador orbital-ds · 5. Criterio visual (armonía y elección de elementos)
2
+
3
+ Cómo **analizar el aspecto** de una pantalla y **elegir el elemento correcto** (¿tarjeta, ítem, bento, imagen,
4
+ efecto?) antes de componerla. Va entre `patrones.md` (qué patrón) y `revision.md` (comprobación). Si choca con el
5
+ contrato o el tema, gana el sistema; esto sirve para elegir **dentro** de él.
6
+
7
+ Origen: síntesis de referentes de la industria. Las fuentes son guías públicas y artículos de práctica; los números
8
+ concretos son orientativos, no normas. Contrasta lo que dependa de una cifra.
9
+
10
+ ## 1. Qué enseñan los referentes (y cómo se traduce aquí)
11
+
12
+ | Referente | Idea útil | En orbital-ds |
13
+ |---|---|---|
14
+ | **Apple HIG** (claridad, deferencia, profundidad; en iOS 26, jerarquía · armonía · consistencia) | El contenido manda; la interfaz se aparta. El vidrio/material va en la capa de **control y navegación**, no en la de contenido. | `glass` y fondos vivos solo en cabeceras, lateral, paneles flotantes o fondos de acceso; nunca detrás de texto largo ni de tablas. |
15
+ | **Material 3 Expressive** (Google) | Dar **énfasis** (color, forma, tamaño) al elemento clave ayuda a encontrarlo antes; un grupo no pequeño prefiere versiones calmadas. La mejora medida de forma independiente es moderada, no mágica. | Un solo elemento enfatizado por vista (`variant` principal, tarjeta `feature`/`hero`); el resto, calmado. Respeta `--ds-density` y el tema. |
16
+ | **Nielsen** (10 heurísticas) | Estado visible, consistencia, minimalismo, recuperarse de errores. | `ux.md`. Cada elemento extra compite con lo importante. |
17
+ | **Polaris / GOV.UK** | Documentan **cuándo usar y cuándo NO usar** cada pieza. | Los `@note` del manifiesto; si dudas entre dos piezas, lee el `@note` de ambas. |
18
+ | **Carbon / Primer / Atlassian** | Tokens y patrones antes que píxeles; un componente «experimental» no se usa de base. | Variables `--ds-*`; nada de medidas a mano. |
19
+
20
+ ## 2. Cómo analizar una pantalla (en este orden, 8 pasos)
21
+
22
+ Puntúa cada uno 0–2 (0 falla · 1 mejorable · 2 bien). Por debajo de 12/16, rehaz antes de entregar.
23
+
24
+ 1. **Jerarquía.** Mirando entrecerrado: ¿se distingue **una** cosa principal, luego lo secundario, luego el resto?
25
+ Tamaño y peso primero, color después. Si todo destaca, nada destaca.
26
+ 2. **Ritmo y agrupación.** La proximidad agrupa: más espacio **entre** grupos que **dentro**. Misma separación para
27
+ lo del mismo nivel (usa los espacios del sistema, `--ds-density`; no inventes).
28
+ 3. **Alineación y rejilla.** Bordes comunes; columnas coherentes; la bento o el mosaico con `Mosaic`, no con
29
+ anchos sueltos. Orden del DOM = orden de lectura (el orden visual no debe contradecirlo).
30
+ 4. **Contraste y legibilidad.** Texto sobre imagen **siempre con velo** (`--ds-card-scrim`); estado nunca solo con color; AA mínimo.
31
+ 5. **Consistencia.** Mismo patrón para el mismo problema; mismas esquinas, sombras y gestos que el tema.
32
+ 6. **Densidad.** ¿Cuánto hay por pantalla? Una vista de trabajo admite densidad; una de decisión, aire. Más de ~9 celdas
33
+ en un bloque bento diluye la jerarquía.
34
+ 7. **Estados.** Vacío, carga (forma del contenido), error con reintento, éxito, desactivado, foco, hover/pulsado.
35
+ 8. **Movimiento.** Explica origen o cambio de estado; ritmo del tema; quieto con movimiento reducido.
36
+
37
+ ## 3. Elegir el elemento (árbol de decisión)
38
+
39
+ **¿Qué tengo que mostrar?**
40
+ - **Una entidad que se lista y se actúa** (agente, dispositivo, proyecto) → `Item variant="card"` (+ `ItemMedia`/`IconTile`,
41
+ `ItemActions`). No `Card` + `Item` a mano.
42
+ - **Contenido con título, texto y a veces imagen** (artículo, producto, recurso) → `ContentCard` con su `preset`
43
+ (`basic` · `feature` · `media` · `horizontal` · `cover`).
44
+ - **Una cifra o una tendencia** → `StatGroup` / KPI / `ChartCard preset="glance"`. No una tarjeta de texto con un número.
45
+ - **Un grupo de bloques de distinto peso** (resumen, portada, panel) → `Mosaic preset="bento" | "hero" | "showcase"` con `MosaicItem span`.
46
+ - **Un bloque único de sección con cabecera, contenido y pie** → `Card`.
47
+ - **Una lista larga homogénea** → `EntityList` / `DataTable`; no un mosaico.
48
+ - **Agrupar sin caja** → separador y espacio, no otra tarjeta (nada de tarjetas dentro de tarjetas).
49
+
50
+ **Tarjeta con imagen o fondo (`ContentCard preset="cover"`, `Card backdrop`):**
51
+ - Úsala cuando la imagen **es** el contenido (destino, producto, campaña). No para decorar un formulario.
52
+ - Título corto sobre el velo; ninguna información crítica solo en la imagen; `alt` o `aria-hidden` según informe o decore.
53
+ - Un fondo vivo (`backdrop` mesh/aurora/dots, `animated`) como mucho en 1–2 tarjetas por vista; son énfasis, no textura general.
54
+
55
+ **Efectos de interacción (`hoverable`, `spotlight`, `glow`):**
56
+ - Solo en tarjetas **pulsables** (llevan enlace o acción). Un efecto de «clicable» en algo que no lo es engaña.
57
+ - Uno por tarjeta (elige `hoverable` **o** `spotlight`); el hover es refuerzo, nunca el único aviso (táctil no tiene hover).
58
+
59
+ **Bento — reglas:**
60
+ - Es una **jerarquía**, no una rejilla de cajas iguales: 1 celda protagonista, 2–3 medianas, el resto pequeñas.
61
+ - Cada celda cuenta una cosa; la protagonista lleva el mensaje principal.
62
+ - En móvil cae a una columna conservando el orden de importancia.
63
+
64
+ **Revelar y cargar:**
65
+ - Entrada al desplazar (`Reveal`): solo bloques fuera de la primera pantalla; no en listas que se filtran o reordenan.
66
+ - Listas largas: `LoadMore` (botón, con el resto visible; `auto` solo como extra) antes que scroll infinito; para saltar a una
67
+ página o trabajar con datos, `Pagination`.
68
+ - Texto largo en una tarjeta: `ShowMore`.
69
+ - Búsqueda mientras se escribe: `SearchBox` (recientes y populares al enfocar; estados vacío/error; la app pone la consulta).
70
+
71
+ ## 4. Armonía: lo que hace que «se vea cuidado»
72
+ - **Una voz.** Un énfasis por vista; el resto, calmado. Un tema = un gesto firma.
73
+ - **Radios coherentes:** el radio de lo de dentro es menor que el de su contenedor (los tokens ya lo resuelven; no pongas `rounded-*` sueltos).
74
+ - **Sombras y capas:** solo las del tema (`shadow-*`, `--ds-card-glow`); la elevación indica interactividad o capa, no decoración.
75
+ - **Titulares y párrafos:** equilibrados (`text-wrap: balance` en títulos, `pretty` en párrafos), longitud de línea cómoda (≈ 45–75 caracteres).
76
+ - **Color:** de la marca solo el primario como acento; neutros del tema; los estados con su tono semántico.
77
+ - **Espacio:** el aire es parte del diseño; recortarlo para «meter más» baja la jerarquía.
78
+ - **Detalle de estado:** foco visible, desactivado legible, carga con forma real, error con salida.
79
+
80
+ ## 5. Si algo no se puede lograr con el sistema
81
+ No lo fuerces con estilos propios: dilo, propón la combinación de patrones más cercana y anota el hueco (variable o
82
+ variante que faltaría) para la librería. Es mejor un hueco anotado que una pantalla fuera del sistema.
83
+
84
+ ## Fuentes
85
+ Apple HIG y su revisión Liquid Glass (resúmenes: createwithswift.com, superdesign.dev); Google Design, «Expressive Design: research»
86
+ y el estudio independiente (ACM, 2026); Nielsen Norman Group (10 heurísticas); guías «cuándo usar / cuándo no» de Polaris y
87
+ GOV.UK; guías de bento y de carga progresiva (Smashing Magazine, uxpatterns.dev). Verifica en las fuentes oficiales si una decisión depende de una cifra.
@@ -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)
@@ -88,7 +88,7 @@ Formato: **cuándo** · **piezas** · **reglas** · **evita**.
88
88
  - **Tarea larga:** `TaskProgress` o `TaskLoader`; para estados de protección/seguridad, `Shield`/`StatusHero`.
89
89
 
90
90
  ## P10 · Avisos y respuesta del sistema
91
- - **Piezas:** `toast` (sonner) para confirmar algo hecho («Cliente creado») con «Deshacer» si aplica; `Alert` en
91
+ - **Piezas:** `toast` (`Toaster` + `toast.add`, Base UI) para confirmar algo hecho («Cliente creado») con «Deshacer» si aplica; `Alert` en
92
92
  el contexto del problema; `Banner` para algo de toda la página (mantenimiento, prueba gratuita);
93
93
  `NotificationCenter` para lo que llega sin que la persona lo pida.
94
94
  - **Reglas:** el aviso dice qué pasó en voz activa; los errores dicen cómo arreglarlo; nada de avisos para lo
@@ -108,7 +108,9 @@ Formato: **cuándo** · **piezas** · **reglas** · **evita**.
108
108
  - **Primero el flujo:** `defineAuthFlow(preset)` (`orbital-ds/lib/auth-flow`) decide audiencia (`internal` ·
109
109
  `external`), métodos, registro, segundo factor y aspecto. Presets: `standard` · `social` · `passwordless` ·
110
110
  `partner` · `enterprise` · `hybrid` (plantilla por SSO y externos con cuenta propia, enrutados por dominio con
111
- `routeAuthIdentifier`) · `sso-only`. `validateAuthFlow` avisa de combinaciones sin sentido.
111
+ `routeAuthIdentifier`) · `sso-staff` (SSO interno + acceso externo: dos puertas sin escribir —«Continuar con SSO», directo al proveedor, y
112
+ «Acceso para personas externas», con correo y contraseña, passkey y 2FA obligatorio, por invitación— con
113
+ `AuthForm entry={flow.entry}`; no necesita `internalDomains`) · `sso-only`. `validateAuthFlow` avisa de combinaciones sin sentido.
112
114
  - **Interno o externo:** en `hybrid` (y `enterprise`) el correo decide la puerta. `internalDomains` → SSO de la
113
115
  plantilla (sin registro, sin 2FA propio: lo pone el directorio); el resto, cuenta propia con el 2FA y el registro
114
116
  del flujo. `access: { internal, external }` ajusta métodos, `mfaRequired` y `signUp` de cada puerta;
@@ -126,9 +128,48 @@ Formato: **cuándo** · **piezas** · **reglas** · **evita**.
126
128
  (`AuthErrorCode`), no de la respuesta del proveedor. Idioma y tema siempre visibles en la esquina (`toolbar`).
127
129
  Una sola acción principal por pantalla; los proveedores van antes o después del formulario, no mezclados.
128
130
  Contraseña con `PasswordInput` (mostrar/ocultar) y, al crearla, `PasswordStrength`.
131
+ Segundo factor **dentro** del mismo formulario: `onSubmit` devuelve `{ next: "mfa" }` y se pasa `mfa={{ preset, onVerify }}`
132
+ (monta `MfaChallenge`). «Volver» regresa a las puertas si las hay; la redirección a SSO lleva «Cancelar».
129
133
  - **Evita:** fondos animados en un backoffice interno (usa `minimal` o `centered` sin fondo); proveedores que la
130
134
  app no tiene configurados; CAPTCHA o pasos extra antes de saber si hacen falta.
131
135
 
136
+
137
+ ## P14 · Panel de un servicio contratado
138
+ - **Cuándo:** la vista de un servicio que la persona tiene (o puede activar): estado, siguiente paso, uso frente a lo
139
+ contratado, límites del plan y datos del servicio. Vale para individual, familia o pyme: cambia el contenido, no la
140
+ estructura.
141
+ - **Piezas:** `PageShell` + `PageHeader` (atajo `title` / `description` / `actions`). Arriba, **una** `NextStepCard`
142
+ con el preset del estado (`activate` sin activar · `open` activo · `resolve` con algo que arreglar · `inactive` de
143
+ baja) y su única acción principal. Debajo, el uso con `UsageMeter` (uno por medida con límite; `limit={null}` es
144
+ ilimitado, `value={null}` es «sin dato», nunca 0). Límites y atributos con `DescriptionList` (`inline divided`; `grid`
145
+ si son muchos y cortos). Cada valor con unidad con `Quantity` (UCUM: `By`, `GBy`, `%`, `d`, `{device}`), fechas con
146
+ `DateTime` y «hace 5 minutos» con `RelativeTime`. Bloques con `SectionHeader title description`.
147
+ - **De un esquema de widgets a componentes** (la traducción la hace la app, no orbital-ds):
148
+ `value` → `Quantity` · `progress` → `UsageMeter` (o `StatProgress` en una tarjeta KPI) · `badge` → `StatusBadge` ·
149
+ `date` → `DateTime` · `relative-time` → `RelativeTime` · `list-link` → `Item` con enlace (o `DescriptionList` con el
150
+ enlace como valor).
151
+ - **Reglas:** el estado decide el preset y el preset la acción; no pongas dos acciones principales. Bytes en SI por
152
+ defecto (lo que muestra el sistema operativo de la mayoría); `system="binary"` solo si el plan se vende en GiB. Nada
153
+ de unidades ni fechas formateadas a mano: siempre por el idioma activo.
154
+ - **Evita:** barras de progreso a mano (`h-2 bg-primary` con `width`), «GB» calculado dividiendo entre 1024, estados
155
+ con colores propios y «Límites» como texto suelto en lugar de una lista de definición.
156
+
157
+ ## P15 · Portada (hero)
158
+ - **Cuándo:** la primera pantalla de una web pública, la presentación de un producto o la entrada a un módulo de la
159
+ app que hay que «vender» (integraciones, informes, novedades). Nunca en una vista de trabajo: ahí va `PageHeader`.
160
+ - **Piezas:** `Hero` con el preset de la intención: `landing` (portada centrada; con `backdrop="mesh"`/`"dots"`
161
+ para darle personalidad), `split` (texto junto a una captura o demo en `media`, con su `alt`), `media` (foto o
162
+ vídeo de fondo en `backdropMedia`; el texto va sobre una placa que garantiza el contraste) y `section` (entrada a un
163
+ módulo, alineada al inicio y con menos aire). `eyebrow` para una `Badge` de novedad; `footer` para la tira de
164
+ cifras (`StatGroup preset="strip"`) o de logos; `animated` para la entrada en cascada con el ritmo del tema.
165
+ - **Contenido:** un título que dice el beneficio en una frase (no el nombre del producto), una o dos frases de apoyo y,
166
+ como mucho, **dos acciones** (principal + secundaria `outline`). Debajo, el resto de la página en `Mosaic` o
167
+ `ContentCard` con `Reveal`.
168
+ - **Reglas:** un hero por página y arriba del todo; `titleAs="h2"` si la vista ya tiene su h1. El diseño sigue el
169
+ ancho del contenedor, no la pantalla. Medidas y escala en `--ds-hero-*` (la marca las ajusta en `brand.css`).
170
+ - **Evita:** carruseles en la portada, más de dos botones, texto directamente sobre una foto sin placa, títulos con
171
+ degradado y alturas a pantalla completa que esconden el contenido.
172
+
132
173
  ---
133
174
 
134
175
  ## Patrones de movimiento