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
package/AGENTS.md CHANGED
@@ -3,7 +3,7 @@
3
3
  Sistema de diseño: **estructura común + temas + componentes** sobre Base UI y Tailwind v4.
4
4
  Todo está pensado para que un agente pueda usarlo, ampliarlo y comprobar su trabajo sin
5
5
  adivinar. Lee antes: `README.md`, `docs/CONTRACT.md`, `contract.json` y
6
- `components.manifest.json` (qué componentes hay, cómo se importan y qué `data-slot` exponen).
6
+ `components.manifest.json` (índice para ELEGIR: qué componentes hay, su `group`, su `summary` —qué es y cuándo usarlo—, sus alternativas `see`, cómo se importan y qué `data-slot` exponen; `orbital-ds components --search <intención>` busca en él) y, **por dominio**, `manifest/<dominio>.json` o `orbital-ds components --group <dominio>` (sus **props propias con tipo, valores y si son obligatorias**, notas y **ejemplos mínimos para copiar**: úsalos, no inventes props; `orbital-ds doctor --ui src` avisa de `asChild`, valores fuera de la unión y nombres casi iguales).
7
7
 
8
8
  ## Reglas (obligatorias)
9
9
 
@@ -106,9 +106,9 @@ adivinar. Lee antes: `README.md`, `docs/CONTRACT.md`, `contract.json` y
106
106
 
107
107
  - Los textos PROPIOS de los componentes (cerrar, cargando, paginación, carrusel, lateral,
108
108
  cuestionario…) salen de `useDsMessages()` y sus catálogos (`orbital-ds/lib/i18n`: en, es,
109
- pt-BR). **Ningún componente escribe un texto visible o accesible a mano**: el doctor lo rechaza
109
+ pt-BR, fr, it, de y he; los cuatro últimos en `src/lib/locales/<idioma>.ts`). **Ningún componente escribe un texto visible o accesible a mano**: el doctor lo rechaza
110
110
  (`aria-label="…"`, `sr-only`, `?? "…"`, `title="…"`).
111
- - Un texto nuevo = una clave nueva en los TRES catálogos (el tipo obliga a tenerla en todos).
111
+ - Un texto nuevo = una clave nueva en TODOS los catálogos (el tipo obliga a tenerla en todos).
112
112
  - La app pasa su idioma una vez: `<DsI18nProvider locale={i18n.language}>` (con i18next,
113
113
  `useTranslation().i18n.language`). Un texto concreto se sobrescribe con `messages`. Sin
114
114
  provider, inglés. Otro idioma cae a su base (`es-CO` → `es`) o al inglés.
@@ -121,8 +121,10 @@ adivinar. Lee antes: `README.md`, `docs/CONTRACT.md`, `contract.json` y
121
121
  los idiomas de la app y ejecuta `pnpm exec orbital-ds-i18n`. Si orbital-ds no trae ese idioma, deja
122
122
  el inglés y LISTA las claves pendientes: tradúcelas en el JSON hasta que `--check` pase.
123
123
  - **RTL**: `dsDirection(idioma)` (`orbital-ds/lib/i18n`) da `ltr`/`rtl`; la app lo pone en `<html dir>` y
124
- `DsI18nProvider` lo pasa a Base UI. La conversión de los componentes a clases lógicas
125
- (`ms-`/`ps-`/`start-`/`text-start` en lugar de `ml-`/`pl-`/`left-`/`text-left`) es una fase pendiente: decisión y plan en `docs/adr/0001-rtl-clases-logicas.md`.
124
+ `DsI18nProvider` lo pasa a Base UI. Los componentes usan clases lógicas (`ms-`/`ps-`/`start-`/`text-start`; el doctor
125
+ rechaza las físicas), las flechas de dirección llevan `rtl:rotate-180` y `Sheet`/`Sidebar` aceptan `side="start"|"end"`
126
+ (siguen la lectura; `left`/`right` son físicos). Lo que dibuja el navegador (lista de `<select>`, calendario nativo) sigue
127
+ el modo claro/oscuro del tema por `color-scheme`. Decisión: `docs/adr/0001-rtl-clases-logicas.md`.
126
128
 
127
129
  ## Instalar en una app
128
130
 
@@ -175,8 +177,8 @@ en cualquier proyecto. Vocabulario común en `src/lib/presets.ts` (`DsDensity`,
175
177
  4. **El diseño sigue el ancho del contenedor** (container query), no el dispositivo ni la presentación.
176
178
  5. **Aviso en desarrollo** (`dsWarn`, mensaje en inglés) si la combinación no cuadra.
177
179
  6. **Ganchos del DOM**: `data-slot` y `data-preset` (más `data-presentation`/`data-density` si aplica).
178
- 7. **Un `@note`** que diga cuándo usar cada preset. Catálogo hoy: `Sidebar` (app · workspace · admin · focus, con `density`), `ChartCard` (glance · standard · focus · dense), `ContentCard` (basic · feature · media · horizontal, con `emphasis` elevated · outlined · filled · ghost), `Mosaic` (even · bento · trio), `PageShell` (content · detail · canvas), `PageHeader` (page · compact · canvas), `FilterBar` (inline · compact · stacked), `DataTable` (browse · manage · compact · grouped · tree), `LoadingState` (list · card · table · detail), `PageLoader` (splash · route · section · overlay), `CommandPalette` (go · actions · search), `FileUpload` (drop · button), `ErrorPage` (not-found · forbidden · server-error · offline · maintenance, con `tone` neutral · playful), `DetailPanel` (side · bottom · full), `EntityList` (list · grid · compact), `StepFlow` (quick · activation · long), `FormLayout`
179
- (inline · sectioned · settings), `NoticeReview` (read · acknowledge · resolve · respond), `EmptyState` (first-use · no-results · error · forbidden), `StatGroup` (overview ·
180
+ 7. **Un `@note`** que diga cuándo usar cada preset. Catálogo hoy: `Sidebar` (app · workspace · admin · focus, con `density`), `ChartCard` (glance · standard · focus · dense), `ContentCard` (basic · feature · media · horizontal, con `emphasis` elevated · outlined · filled · ghost), `Mosaic` (even · bento · trio), `Hero` (landing · split · media · section), `PageShell` (content · detail · canvas), `PageHeader` (page · compact · canvas), `FilterBar` (inline · compact · stacked), `DataTable` (browse · manage · compact · grouped · tree), `LoadingState` (list · card · table · detail), `PageLoader` (splash · route · section · overlay), `CommandPalette` (go · actions · search), `FileUpload` (drop · button), `ErrorPage` (not-found · forbidden · server-error · offline · maintenance, con `tone` neutral · playful), `DetailPanel` (side · bottom · full), `EntityList` (list · grid · compact), `StepFlow` (quick · activation · long), `FormLayout`
181
+ (inline · sectioned · settings), `NoticeReview` (read · acknowledge · resolve · respond), `EmptyState` (first-use · no-results · error · forbidden), `NextStepCard` (activate · open · resolve · inactive), `StatGroup` (overview ·
180
182
  compact · comparison · strip) `ConfirmAction` (simple · typed) y, en el acceso (P13), `AuthLayout` (centered · split · cover · banner · minimal),
181
183
  `AuthForm` (sign-in · social · sign-up · magic-link · email-code · sso · forgot-password · reset-password),
182
184
  `MfaChallenge` (totp · sms · email · backup-code · passkey), `MfaSetup` (totp · sms · backup-codes), `OAuthConsent`
@@ -186,6 +188,16 @@ en cualquier proyecto. Vocabulario común en `src/lib/presets.ts` (`DsDensity`,
186
188
 
187
189
  **Densidad global.** `--ds-density` (1 por defecto; 0.8 más denso, 1.2 más aireado) escala el relleno de celdas y la separación de secciones y listas; la app lo ajusta en `brand.css`.
188
190
 
191
+ ## Paneles de servicio y valores con unidad (0.42)
192
+
193
+ - **Nunca formatees a mano** un valor con unidad, una fecha o un «hace 5 minutos»: `Quantity` (unidades UCUM: `By`,
194
+ `GBy`, `%`, `d`, `{device}`; `system="binary"` para GiB), `DateTime` y `RelativeTime` (`orbital-ds/ui/date-time`),
195
+ o sus funciones en `orbital-ds/lib/format` fuera de React. Un nulo es «sin dato», nunca 0.
196
+ - **Uso frente a lo contratado**: `UsageMeter` (avisa al 80 %, crítico al 100 %, `limit={null}` = ilimitado). Nunca una
197
+ barra a mano. **Límites y atributos**: `DescriptionList`. **Estado y siguiente paso**: `NextStepCard`
198
+ (`activate` · `open` · `resolve` · `inactive`). Receta completa: P14 en `docs/designer/patrones.md`.
199
+ - `PageHeader` y `SectionHeader` aceptan `title`, `description` y `actions` como props (atajo de las piezas).
200
+
189
201
  ## Acceso y autenticación
190
202
 
191
203
  - **Agnóstico del proveedor; Better Auth como referencia.** orbital-ds pinta, valida y anuncia; la app conecta su
@@ -203,7 +215,7 @@ Se elige el canal por **urgencia** y **persistencia**; cada app no lo decide a m
203
215
 
204
216
  | Intención | Canal | Persiste | Interrumpe |
205
217
  |---|---|---|---|
206
- | Confirmar una acción de la persona | toast (`Toaster`/`Toast`) | no | no |
218
+ | Confirmar una acción de la persona | toast (`Toaster` + `toast.add`, de `orbital-ds/ui/toast`; `sonner` solo por compatibilidad) | no | no |
207
219
  | Aviso de una sección | `Alert` | sí | no |
208
220
  | Aviso que afecta a toda la página | `Banner` | hasta resolver | no |
209
221
  | Asunto con seguimiento o decisión | campana (`NotificationCenter`) + `NoticeReview` | sí, con estado | solo si es crítico |
@@ -213,6 +225,8 @@ Mismo vocabulario en todos: tono `info | success | warning | danger` y estado `n
213
225
  `NotificationItem onSelect` abre la revisión; `NoticeReview` tiene presets `read | acknowledge | resolve | respond`
214
226
  (modal o `presentation="sheet"`).
215
227
 
228
+ **En la app, en el editor:** `import orbital from "orbital-ds/eslint"; export default [orbital.configs.recommended];` (config plana de ESLint, sin dependencias): `no-as-child`, `system-styles` (nada de colores, z-index, duraciones ni paleta Tailwind en `className`/`cn()`) y `logical-direction` (RTL).
229
+
216
230
  ## Cómo comprobar tu trabajo
217
231
 
218
232
  ```bash
@@ -220,6 +234,7 @@ pnpm check:ds # contrato, repetidos, sombras, fugas, valores fijos, pe
220
234
  pnpm verify # doctor + typecheck + build + check:bundle
221
235
  pnpm check:charts # cada constructor de gráfico: sin colores y dibuja SVG en servidor
222
236
  pnpm check:bundle # empaqueta un consumidor de EChart (navegador y servidor) y comprueba que dibuja
237
+ pnpm domains # dominios tocados por tu rama y su lista de revisión para el PR (base: origin/main)
223
238
  pnpm manifest # regenera components.manifest.json tras añadir componentes
224
239
  pnpm showcase # escaparate: todos los componentes × todos los temas × claro/oscuro × marca
225
240
  pnpm showcase:typecheck # tipos de las demos
@@ -240,7 +255,11 @@ Si `pnpm check:ds` falla, **corrige la causa**; no lo desactives ni lo rodees.
240
255
  ## Añadir un componente
241
256
 
242
257
  1. Fichero en `src/ui/<nombre>.tsx` (un componente = un fichero; sin barril).
243
- 2. `data-slot="<nombre>"` en su raíz y en las partes relevantes.
258
+ 2. `data-slot="<nombre>"` en su raíz y en las partes relevantes. Y `/** @group <dominio> */` en la cabecera (obligatorio; uno de `actions`, `forms`, `feedback`, `overlays`, `navigation`, `data`, `content`, `motion`, `chat`, `agents`, `ai`, `auth`): va al manifiesto como `group`, y la sección de su demo en el escaparate debe ser la de ese dominio (el doctor lo comprueba).
259
+ En ese MISMO bloque, la **ficha para agentes** (obligatoria, el doctor la exige): `@summary` (una línea: qué es y cuándo
260
+ usarlo), `@see <otro> — <cuándo usar ese en su lugar>` (0–3, hacia componentes que existen) y `@example <título>` (1–3,
261
+ una idea cada uno, JSX mínimo con props reales, sin `asChild` ni comentarios JSX). Más `@note` con sus reglas de uso.
262
+ Referencia: `src/ui/button.tsx`.
244
263
  3. Solo tokens. Importa `cn` de `../lib/utils.js`; los demás componentes, de `./<otro>.js`. **Los imports relativos llevan
245
264
  siempre `.js`**: el paquete es `"type": "module"` y Node (tests, SSR sin bundler) no completa la ruta; `check:pack`
246
265
  importa cada export con Node puro.