orbital-ds 0.27.0 → 0.29.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.
- package/AGENTS.md +289 -273
- package/components.manifest.json +550 -8
- package/dist/hooks/use-ds-messages.d.ts +225 -0
- package/dist/lib/auth-better-auth.d.ts +29 -0
- package/dist/lib/auth-better-auth.js +60 -0
- package/dist/lib/auth-flow.d.ts +59 -0
- package/dist/lib/auth-flow.js +135 -0
- package/dist/lib/auth-providers.d.ts +194 -0
- package/dist/lib/auth-providers.js +64 -0
- package/dist/lib/auth.d.ts +68 -0
- package/dist/lib/auth.js +110 -0
- package/dist/lib/i18n.d.ts +225 -0
- package/dist/lib/i18n.js +684 -3
- package/dist/styles.css +467 -3
- package/dist/themes/lagoon.css +8 -8
- package/dist/themes/lagoon.meta.json +3 -2
- package/dist/themes/lagoon.scoped.css +8 -8
- package/dist/ui/auth-backdrop.d.ts +20 -0
- package/dist/ui/auth-backdrop.js +137 -0
- package/dist/ui/auth-form.d.ts +107 -0
- package/dist/ui/auth-form.js +526 -0
- package/dist/ui/auth-layout.d.ts +70 -0
- package/dist/ui/auth-layout.js +283 -0
- package/dist/ui/auth-parts.d.ts +43 -0
- package/dist/ui/auth-parts.js +159 -0
- package/dist/ui/auth-status.d.ts +23 -0
- package/dist/ui/auth-status.js +99 -0
- package/dist/ui/command-palette.d.ts +36 -0
- package/dist/ui/command-palette.js +111 -0
- package/dist/ui/connected-accounts.d.ts +25 -0
- package/dist/ui/connected-accounts.js +89 -0
- package/dist/ui/dropzone.d.ts +3 -1
- package/dist/ui/dropzone.js +3 -1
- package/dist/ui/empty-state.d.ts +10 -1
- package/dist/ui/empty-state.js +28 -7
- package/dist/ui/error-page.d.ts +28 -0
- package/dist/ui/error-page.js +138 -0
- package/dist/ui/file-upload.d.ts +42 -0
- package/dist/ui/file-upload.js +175 -0
- package/dist/ui/filter-bar.js +8 -0
- package/dist/ui/icon-tile.d.ts +1 -1
- package/dist/ui/input-otp.js +2 -1
- package/dist/ui/mfa-challenge.d.ts +33 -0
- package/dist/ui/mfa-challenge.js +214 -0
- package/dist/ui/mfa-setup.d.ts +29 -0
- package/dist/ui/mfa-setup.js +196 -0
- package/dist/ui/oauth-consent.d.ts +54 -0
- package/dist/ui/oauth-consent.js +208 -0
- package/dist/ui/page-header.js +13 -2
- package/dist/ui/page-loader.d.ts +23 -0
- package/dist/ui/page-loader.js +163 -0
- package/dist/ui/passkey-list.d.ts +17 -0
- package/dist/ui/passkey-list.js +112 -0
- package/dist/ui/password-input.d.ts +5 -0
- package/dist/ui/password-input.js +77 -0
- package/dist/ui/session-list.d.ts +19 -0
- package/dist/ui/session-list.js +70 -0
- package/dist/ui/session-timeout.d.ts +13 -0
- package/dist/ui/session-timeout.js +87 -0
- package/dist/ui/sidebar.d.ts +12 -4
- package/dist/ui/sidebar.js +35 -5
- package/dist/ui/sign-out-dialog.d.ts +17 -0
- package/dist/ui/sign-out-dialog.js +82 -0
- package/dist/ui/stat-group.d.ts +1 -1
- package/dist/ui/stat-group.js +6 -2
- package/dist/ui/stat.d.ts +24 -5
- package/dist/ui/stat.js +124 -19
- package/dist/ui/status-badge.d.ts +1 -1
- package/docs/CONTRACT.md +1 -1
- package/docs/designer/patrones.md +21 -0
- package/docs/designer/revision.md +8 -0
- package/package.json +187 -187
- package/scripts/brand-core.d.mts +2 -0
- package/scripts/brand-core.mjs +21 -1
- package/scripts/doctor.mjs +3 -0
- package/scripts/init.mjs +7 -3
package/components.manifest.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"package": "orbital-ds",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.29.0",
|
|
4
4
|
"engine": "@base-ui/react",
|
|
5
5
|
"docs": [
|
|
6
6
|
"README.md",
|
|
@@ -144,6 +144,183 @@
|
|
|
144
144
|
],
|
|
145
145
|
"optionalPeers": []
|
|
146
146
|
},
|
|
147
|
+
"auth-backdrop": {
|
|
148
|
+
"import": "orbital-ds/ui/auth-backdrop",
|
|
149
|
+
"exports": [
|
|
150
|
+
"AuthBackdrop",
|
|
151
|
+
"type AuthBackdropVariant"
|
|
152
|
+
],
|
|
153
|
+
"slots": [
|
|
154
|
+
"auth-backdrop",
|
|
155
|
+
"auth-backdrop-depth",
|
|
156
|
+
"auth-backdrop-glass",
|
|
157
|
+
"auth-backdrop-media"
|
|
158
|
+
],
|
|
159
|
+
"optionalPeers": [],
|
|
160
|
+
"notes": [
|
|
161
|
+
"Fondo de las pantallas de acceso: `dots` o `grid` para algo sobrio y técnico; `rings` para una identidad orbital o de plataforma; `beams` para un lanzamiento o producto de consumo; `aurora` o `mesh` para una portada con más presencia; `glow` detrás de una tarjeta centrada. Úsalo una vez por pantalla.",
|
|
162
|
+
"`image` con `media` para una foto de marca (se tiñe con el primario); añade `glass` si el texto va encima sin tarjeta. «mesh + glass» da un fondo de cristal con color vivo debajo.",
|
|
163
|
+
"`interactive` da un paralaje sutil con inercia, no un foco que sigue al puntero: úsalo solo en la portada, nunca detrás de un formulario largo.",
|
|
164
|
+
"Los colores salen de la paleta del tema (--ds-auth-fx-1/2/3/4): para la marca de una app, ajústalos en su brand.css, nunca en el componente."
|
|
165
|
+
]
|
|
166
|
+
},
|
|
167
|
+
"auth-form": {
|
|
168
|
+
"import": "orbital-ds/ui/auth-form",
|
|
169
|
+
"exports": [
|
|
170
|
+
"AuthForm",
|
|
171
|
+
"type AuthFormPreset",
|
|
172
|
+
"type AuthFormValues",
|
|
173
|
+
"type AuthOrganization",
|
|
174
|
+
"type AuthResult",
|
|
175
|
+
"type AuthRoute"
|
|
176
|
+
],
|
|
177
|
+
"slots": [
|
|
178
|
+
"auth-form",
|
|
179
|
+
"auth-form-code",
|
|
180
|
+
"auth-form-field",
|
|
181
|
+
"auth-form-field-error",
|
|
182
|
+
"auth-form-footer",
|
|
183
|
+
"auth-form-identity",
|
|
184
|
+
"auth-form-organizations",
|
|
185
|
+
"auth-form-redirecting",
|
|
186
|
+
"auth-form-rules"
|
|
187
|
+
],
|
|
188
|
+
"optionalPeers": [],
|
|
189
|
+
"presets": {
|
|
190
|
+
"values": [
|
|
191
|
+
"sign-in",
|
|
192
|
+
"social",
|
|
193
|
+
"sign-up",
|
|
194
|
+
"magic-link",
|
|
195
|
+
"email-code",
|
|
196
|
+
"sso",
|
|
197
|
+
"forgot-password",
|
|
198
|
+
"reset-password"
|
|
199
|
+
],
|
|
200
|
+
"default": "sign-in",
|
|
201
|
+
"intent": {
|
|
202
|
+
"sign-in": "— correo y contraseña; proveedores, passkey, «recordarme» y «¿olvidaste…?».",
|
|
203
|
+
"social": "— solo botones: proveedores (Google, Microsoft…) y passkey, sin formulario. Lo más",
|
|
204
|
+
"sign-up": "— nombre, correo, contraseña con reglas y fuerza, términos (`fields` configurable).",
|
|
205
|
+
"magic-link": "— solo el correo; vista «revisa tu correo» con reenvío y cuenta atrás.",
|
|
206
|
+
"email-code": "— el correo y luego un código de un solo uso (OTP) que se envía solo al completarse.",
|
|
207
|
+
"sso": "— correo de trabajo (o slug de organización) → proveedor de identidad de la empresa.",
|
|
208
|
+
"forgot-password": "— el correo; respuesta que no revela si la cuenta existe.",
|
|
209
|
+
"reset-password": "— contraseña nueva y confirmación, con reglas y fuerza."
|
|
210
|
+
}
|
|
211
|
+
},
|
|
212
|
+
"notes": [
|
|
213
|
+
"Presets: `sign-in` (por defecto), `social` (solo botones: lo más sencillo para el público general), `sign-up`, `magic-link` y `email-code` (sin contraseña), `sso` (empresa), `forgot-password` y `reset-password`. Combínalos con AuthLayout para la maqueta y con AuthFlow para el recorrido completo.",
|
|
214
|
+
"Empresa con SSO: `identifierFirst` + `onIdentify` (dominio del correo → { method: \"sso\" }) lleva a cada persona a su proveedor sin que elija; `onSso` añade además el enlace «usar SSO» y el preset `sso`.",
|
|
215
|
+
"Nunca reveles si una cuenta existe: devuelve \"invalid-credentials\" para usuario o contraseña, y `forgot-password` responde igual exista o no.",
|
|
216
|
+
"Passkeys: con `onPasskey`, el campo del identificador ofrece las passkeys guardadas (autocomplete «webauthn») y aparece el botón. Guarda `lastUsed` en la app para destacar el método de la última vez."
|
|
217
|
+
]
|
|
218
|
+
},
|
|
219
|
+
"auth-layout": {
|
|
220
|
+
"import": "orbital-ds/ui/auth-layout",
|
|
221
|
+
"exports": [
|
|
222
|
+
"AuthAside",
|
|
223
|
+
"AuthAsideEyebrow",
|
|
224
|
+
"AuthAsideFooter",
|
|
225
|
+
"AuthAsidePoint",
|
|
226
|
+
"AuthAsidePoints",
|
|
227
|
+
"AuthAsideQuote",
|
|
228
|
+
"AuthAsideText",
|
|
229
|
+
"AuthAsideTitle",
|
|
230
|
+
"AuthLayout",
|
|
231
|
+
"type AuthLayoutPreset",
|
|
232
|
+
"type AuthMediaTint",
|
|
233
|
+
"type AuthMotion",
|
|
234
|
+
"type AuthShape",
|
|
235
|
+
"type AuthSurface",
|
|
236
|
+
"useAuthMotion"
|
|
237
|
+
],
|
|
238
|
+
"slots": [
|
|
239
|
+
"auth-aside",
|
|
240
|
+
"auth-aside-eyebrow",
|
|
241
|
+
"auth-aside-footer",
|
|
242
|
+
"auth-aside-logo",
|
|
243
|
+
"auth-aside-point",
|
|
244
|
+
"auth-aside-points",
|
|
245
|
+
"auth-aside-quote",
|
|
246
|
+
"auth-aside-text",
|
|
247
|
+
"auth-aside-title",
|
|
248
|
+
"auth-layout",
|
|
249
|
+
"auth-layout-footer",
|
|
250
|
+
"auth-layout-logo",
|
|
251
|
+
"auth-layout-panel",
|
|
252
|
+
"auth-layout-toolbar",
|
|
253
|
+
"auth-media"
|
|
254
|
+
],
|
|
255
|
+
"optionalPeers": [],
|
|
256
|
+
"presets": {
|
|
257
|
+
"values": [
|
|
258
|
+
"centered",
|
|
259
|
+
"split",
|
|
260
|
+
"cover",
|
|
261
|
+
"banner",
|
|
262
|
+
"minimal"
|
|
263
|
+
],
|
|
264
|
+
"default": "centered",
|
|
265
|
+
"intent": {
|
|
266
|
+
"split": "— panel de marca a un lado y formulario al otro; en estrecho, solo el formulario.",
|
|
267
|
+
"cover": "— imagen o vídeo a pantalla completa (`media`) y tarjeta de cristal encima.",
|
|
268
|
+
"banner": "— franja de marca arriba y tarjeta que la monta.",
|
|
269
|
+
"minimal": "— sin tarjeta: el formulario sobre el lienzo (apps internas, incrustado)."
|
|
270
|
+
}
|
|
271
|
+
},
|
|
272
|
+
"notes": [
|
|
273
|
+
"Presets: `centered` por defecto (cualquier app); `split` para producto con historia de marca (SaaS, portales: panel con propuesta de valor o testimonio); `cover` cuando hay una imagen potente (consumo, eventos); `banner` para portales corporativos con logo protagonista; `minimal` para herramientas internas o incrustado en otra página.",
|
|
274
|
+
"La marca va en brand.css: --ds-auth-aside-bg/-fg/-image (panel), --ds-auth-fx-1/2/3 (fondos), --ds-auth-radius, --ds-auth-glass. El doctor mide el contraste del texto del panel (AA).",
|
|
275
|
+
"`motion=\"full\"` aplica siempre los fondos animados; `entrance` deja solo la entrada; `off` lo para todo. Con movimiento reducido del sistema, todo queda quieto (WCAG 2.3.3).",
|
|
276
|
+
"`toolbar` es para idioma y tema, siempre visibles; `footer` para enlaces legales y soporte."
|
|
277
|
+
]
|
|
278
|
+
},
|
|
279
|
+
"auth-parts": {
|
|
280
|
+
"import": "orbital-ds/ui/auth-parts",
|
|
281
|
+
"exports": [
|
|
282
|
+
"AuthAnchor",
|
|
283
|
+
"AuthDivider",
|
|
284
|
+
"AuthError",
|
|
285
|
+
"AuthHeader",
|
|
286
|
+
"AuthPasskeyButton",
|
|
287
|
+
"AuthProviders",
|
|
288
|
+
"AuthStagger"
|
|
289
|
+
],
|
|
290
|
+
"slots": [
|
|
291
|
+
"auth-anchor",
|
|
292
|
+
"auth-divider",
|
|
293
|
+
"auth-error",
|
|
294
|
+
"auth-header",
|
|
295
|
+
"auth-last-used",
|
|
296
|
+
"auth-passkey",
|
|
297
|
+
"auth-provider",
|
|
298
|
+
"auth-providers",
|
|
299
|
+
"auth-stagger"
|
|
300
|
+
],
|
|
301
|
+
"optionalPeers": [],
|
|
302
|
+
"notes": [
|
|
303
|
+
"Úsalas para componer una pantalla de acceso a medida dentro de AuthLayout; para los casos comunes, AuthForm, MfaChallenge y AuthStatus ya las combinan.",
|
|
304
|
+
"Proveedores: como mucho tres a la vista (SSO primero). El icono y el nombre de cada uno los pone la app: el paquete no lleva logotipos de marcas. `lastUsed` lo guarda la app (p. ej. en localStorage) para señalar el método de la última vez."
|
|
305
|
+
]
|
|
306
|
+
},
|
|
307
|
+
"auth-status": {
|
|
308
|
+
"import": "orbital-ds/ui/auth-status",
|
|
309
|
+
"exports": [
|
|
310
|
+
"AuthStatus",
|
|
311
|
+
"type AuthStatusPreset"
|
|
312
|
+
],
|
|
313
|
+
"slots": [
|
|
314
|
+
"auth-status",
|
|
315
|
+
"auth-status-actions",
|
|
316
|
+
"auth-status-icon"
|
|
317
|
+
],
|
|
318
|
+
"optionalPeers": [],
|
|
319
|
+
"notes": [
|
|
320
|
+
"Úsalo para cada pantalla de resultado del acceso dentro de AuthLayout: tras cerrar sesión, al caducar la sesión, tras enviar un enlace, al verificar el correo, al cambiar la contraseña, con la cuenta bloqueada, con un enlace caducado o sin permiso.",
|
|
321
|
+
"Para errores de navegación (404, 500, sin conexión) usa ErrorPage; AuthStatus es solo para el acceso."
|
|
322
|
+
]
|
|
323
|
+
},
|
|
147
324
|
"avatar": {
|
|
148
325
|
"import": "orbital-ds/ui/avatar",
|
|
149
326
|
"exports": [
|
|
@@ -523,6 +700,37 @@
|
|
|
523
700
|
],
|
|
524
701
|
"optionalPeers": []
|
|
525
702
|
},
|
|
703
|
+
"command-palette": {
|
|
704
|
+
"import": "orbital-ds/ui/command-palette",
|
|
705
|
+
"exports": [
|
|
706
|
+
"CommandPalette",
|
|
707
|
+
"type CommandPaletteGroup",
|
|
708
|
+
"type CommandPaletteItem",
|
|
709
|
+
"type CommandPalettePreset"
|
|
710
|
+
],
|
|
711
|
+
"slots": [
|
|
712
|
+
"command-palette",
|
|
713
|
+
"command-palette-loading"
|
|
714
|
+
],
|
|
715
|
+
"optionalPeers": [],
|
|
716
|
+
"presets": {
|
|
717
|
+
"values": [
|
|
718
|
+
"go",
|
|
719
|
+
"actions",
|
|
720
|
+
"search"
|
|
721
|
+
],
|
|
722
|
+
"default": "go",
|
|
723
|
+
"intent": {
|
|
724
|
+
"go": "navegar («Ir a…»): filtra en el cliente por etiqueta y `keywords`",
|
|
725
|
+
"actions": "ejecutar acciones («Escribe un comando…»): igual, con otro texto de ayuda",
|
|
726
|
+
"search": "buscar entidades: NO filtra en el cliente; la app responde a `onQueryChange` con `groups`"
|
|
727
|
+
}
|
|
728
|
+
},
|
|
729
|
+
"notes": [
|
|
730
|
+
"Paleta ⌘K: `go` para navegar, `actions` para ejecutar, `search` para buscar entidades en el servidor (no filtra en el cliente: responde a onQueryChange). Móvil: ábrela desde un botón con el icono de búsqueda (`open`/`onOpenChange`). Los textos de grupos y elementos los pone la app con su i18n.",
|
|
731
|
+
"Un solo CommandPalette por app, montado en la raíz. Para una lista filtrable dentro de una página usa Command, no la paleta."
|
|
732
|
+
]
|
|
733
|
+
},
|
|
526
734
|
"command": {
|
|
527
735
|
"import": "orbital-ds/ui/command",
|
|
528
736
|
"exports": [
|
|
@@ -577,6 +785,34 @@
|
|
|
577
785
|
"El título nombra la acción y el objeto; el botón repite el verbo, no «Aceptar»."
|
|
578
786
|
]
|
|
579
787
|
},
|
|
788
|
+
"connected-accounts": {
|
|
789
|
+
"import": "orbital-ds/ui/connected-accounts",
|
|
790
|
+
"exports": [
|
|
791
|
+
"ConnectedAccounts",
|
|
792
|
+
"type ConnectedAccountsPreset",
|
|
793
|
+
"type ConnectionItem",
|
|
794
|
+
"type ConnectionStatus"
|
|
795
|
+
],
|
|
796
|
+
"slots": [
|
|
797
|
+
"connected-account",
|
|
798
|
+
"connected-accounts"
|
|
799
|
+
],
|
|
800
|
+
"optionalPeers": [],
|
|
801
|
+
"presets": {
|
|
802
|
+
"values": [
|
|
803
|
+
"social",
|
|
804
|
+
"integrations"
|
|
805
|
+
],
|
|
806
|
+
"default": "social",
|
|
807
|
+
"intent": {
|
|
808
|
+
"social": "— métodos de acceso vinculados (Better Auth `linkSocial` / `unlinkAccount`). Impide"
|
|
809
|
+
}
|
|
810
|
+
},
|
|
811
|
+
"notes": [
|
|
812
|
+
"social en los ajustes de seguridad de la cuenta (métodos de acceso vinculados); integrations para los servicios externos que la app usa con OAuth (servidores MCP, almacenamiento, mensajería), con «Reconectar» cuando el token caduca.",
|
|
813
|
+
"Si la persona tiene contraseña o passkey además de los proveedores, pasa keepOne={false}: no se queda fuera al quitar el último."
|
|
814
|
+
]
|
|
815
|
+
},
|
|
580
816
|
"content-card": {
|
|
581
817
|
"import": "orbital-ds/ui/content-card",
|
|
582
818
|
"exports": [
|
|
@@ -712,7 +948,12 @@
|
|
|
712
948
|
"manage",
|
|
713
949
|
"compact"
|
|
714
950
|
],
|
|
715
|
-
"default": "browse"
|
|
951
|
+
"default": "browse",
|
|
952
|
+
"intent": {
|
|
953
|
+
"browse": "consultar datos: búsqueda y columnas visibles, filas cómodas, sin selección",
|
|
954
|
+
"manage": "gestionar registros: añade selección de filas para acciones en lote",
|
|
955
|
+
"compact": "tabla dentro de un panel o una tarjeta: filas densas, sin selector de columnas"
|
|
956
|
+
}
|
|
716
957
|
},
|
|
717
958
|
"notes": [
|
|
718
959
|
"Presets: `browse` consulta, `manage` añade selección para actuar, `compact` es denso y sin menú de columnas; cualquier prop explícita los sobrescribe.",
|
|
@@ -938,7 +1179,8 @@
|
|
|
938
1179
|
"type EmptyStatePreset"
|
|
939
1180
|
],
|
|
940
1181
|
"slots": [
|
|
941
|
-
"empty-state"
|
|
1182
|
+
"empty-state",
|
|
1183
|
+
"empty-state-content"
|
|
942
1184
|
],
|
|
943
1185
|
"optionalPeers": [],
|
|
944
1186
|
"presets": {
|
|
@@ -958,6 +1200,7 @@
|
|
|
958
1200
|
},
|
|
959
1201
|
"notes": [
|
|
960
1202
|
"Un preset por intención: first-use (nada aún), no-results (el filtro no encuentra), error (reintentar), forbidden (sin permiso). Cambia título, descripción o icono solo si el dominio lo pide.",
|
|
1203
|
+
"`backdrop=\"dots\"` + `animated` para un primer uso con personalidad (portada de un módulo); en tablas y listas, sin fondo.",
|
|
961
1204
|
"Para un vacío con composición propia usa Empty y sus partes."
|
|
962
1205
|
]
|
|
963
1206
|
},
|
|
@@ -1013,6 +1256,46 @@
|
|
|
1013
1256
|
"No compone Card + Item a mano: la fila es siempre un Item."
|
|
1014
1257
|
]
|
|
1015
1258
|
},
|
|
1259
|
+
"error-page": {
|
|
1260
|
+
"import": "orbital-ds/ui/error-page",
|
|
1261
|
+
"exports": [
|
|
1262
|
+
"ErrorPage",
|
|
1263
|
+
"type ErrorPagePreset",
|
|
1264
|
+
"type ErrorPageTone"
|
|
1265
|
+
],
|
|
1266
|
+
"slots": [
|
|
1267
|
+
"error-page",
|
|
1268
|
+
"error-page-actions",
|
|
1269
|
+
"error-page-code",
|
|
1270
|
+
"error-page-content",
|
|
1271
|
+
"error-page-description",
|
|
1272
|
+
"error-page-title"
|
|
1273
|
+
],
|
|
1274
|
+
"optionalPeers": [],
|
|
1275
|
+
"presets": {
|
|
1276
|
+
"values": [
|
|
1277
|
+
"not-found",
|
|
1278
|
+
"forbidden",
|
|
1279
|
+
"server-error",
|
|
1280
|
+
"offline",
|
|
1281
|
+
"maintenance"
|
|
1282
|
+
],
|
|
1283
|
+
"default": "not-found",
|
|
1284
|
+
"intent": {
|
|
1285
|
+
"not-found": "la ruta o el recurso no existe (404): lleva de vuelta a un sitio seguro",
|
|
1286
|
+
"forbidden": "sin permiso (403): explica a quién pedir acceso",
|
|
1287
|
+
"server-error": "falló el servidor (500): invita a reintentar",
|
|
1288
|
+
"offline": "sin conexión: la app decide cuándo se recupera",
|
|
1289
|
+
"maintenance": "parada programada: di cuándo vuelve en `description`"
|
|
1290
|
+
}
|
|
1291
|
+
},
|
|
1292
|
+
"notes": [
|
|
1293
|
+
"Página completa de error por intención: not-found (404, lleva a un sitio seguro), forbidden (403), server-error (500, reintentar), offline y maintenance (di cuándo vuelve en `description`). Dentro de una vista usa EmptyState; aquí es la vista entera.",
|
|
1294
|
+
"`tone=\"playful\"` da mensajes con personalidad (en, es y pt-BR); úsalo en productos cercanos y nunca en un fallo grave. Los textos propios de la app se pasan con `title`/`description`.",
|
|
1295
|
+
"`backdrop` (+ `backdropGlass`, `backdropMedia`) y `animated` para una página de error con personalidad (producto, portada); en un backoffice, sin fondo.",
|
|
1296
|
+
"Siempre con una salida: `actions` con un botón principal (inicio, reintentar, volver). Para la ruta desconocida de un router, monta ErrorPage en su componente de «no encontrado»."
|
|
1297
|
+
]
|
|
1298
|
+
},
|
|
1016
1299
|
"eyebrow": {
|
|
1017
1300
|
"import": "orbital-ds/ui/eyebrow",
|
|
1018
1301
|
"exports": [
|
|
@@ -1054,6 +1337,37 @@
|
|
|
1054
1337
|
"Una columna; agrupa con FieldSet/FieldLegend; lo opcional, marcado o plegado."
|
|
1055
1338
|
]
|
|
1056
1339
|
},
|
|
1340
|
+
"file-upload": {
|
|
1341
|
+
"import": "orbital-ds/ui/file-upload",
|
|
1342
|
+
"exports": [
|
|
1343
|
+
"FileUpload",
|
|
1344
|
+
"type FileUploadFn",
|
|
1345
|
+
"type FileUploadItem",
|
|
1346
|
+
"type FileUploadPreset",
|
|
1347
|
+
"type FileUploadStatus"
|
|
1348
|
+
],
|
|
1349
|
+
"slots": [
|
|
1350
|
+
"file-upload",
|
|
1351
|
+
"file-upload-item",
|
|
1352
|
+
"file-upload-list"
|
|
1353
|
+
],
|
|
1354
|
+
"optionalPeers": [],
|
|
1355
|
+
"presets": {
|
|
1356
|
+
"values": [
|
|
1357
|
+
"drop",
|
|
1358
|
+
"button"
|
|
1359
|
+
],
|
|
1360
|
+
"default": "drop",
|
|
1361
|
+
"intent": {
|
|
1362
|
+
"drop": "zona grande para soltar con la lista debajo (importar, adjuntar documentos)",
|
|
1363
|
+
"button": "botón «Adjuntar» con la lista debajo, ocupa poco (formularios, comentarios, diálogos)"
|
|
1364
|
+
}
|
|
1365
|
+
},
|
|
1366
|
+
"notes": [
|
|
1367
|
+
"Subida completa: `drop` para importar o adjuntar documentos, `button` para formularios y diálogos con poco sitio. La app pone `upload(file, onProgress, signal)` (cualquier backend, p. ej. URL prefirmada); sin él solo recoge ficheros y los envías con el formulario.",
|
|
1368
|
+
"Un fichero con error muestra su mensaje y «reintentar»; quitar un fichero en curso cancela la subida (`signal`). Sin subida por trozos ni reanudación: eso lo resuelve la app. Solo la zona, sin lista: Dropzone; solo la fila de un fichero: Attachment."
|
|
1369
|
+
]
|
|
1370
|
+
},
|
|
1057
1371
|
"filter-bar": {
|
|
1058
1372
|
"import": "orbital-ds/ui/filter-bar",
|
|
1059
1373
|
"exports": [
|
|
@@ -1232,6 +1546,7 @@
|
|
|
1232
1546
|
],
|
|
1233
1547
|
"slots": [
|
|
1234
1548
|
"input-otp",
|
|
1549
|
+
"input-otp-char",
|
|
1235
1550
|
"input-otp-group",
|
|
1236
1551
|
"input-otp-separator",
|
|
1237
1552
|
"input-otp-slot"
|
|
@@ -1485,6 +1800,59 @@
|
|
|
1485
1800
|
],
|
|
1486
1801
|
"optionalPeers": []
|
|
1487
1802
|
},
|
|
1803
|
+
"mfa-challenge": {
|
|
1804
|
+
"import": "orbital-ds/ui/mfa-challenge",
|
|
1805
|
+
"exports": [
|
|
1806
|
+
"MfaChallenge",
|
|
1807
|
+
"type MfaChallengePreset"
|
|
1808
|
+
],
|
|
1809
|
+
"slots": [
|
|
1810
|
+
"mfa-challenge",
|
|
1811
|
+
"mfa-challenge-code",
|
|
1812
|
+
"mfa-challenge-methods"
|
|
1813
|
+
],
|
|
1814
|
+
"optionalPeers": [],
|
|
1815
|
+
"presets": {
|
|
1816
|
+
"values": [
|
|
1817
|
+
"totp",
|
|
1818
|
+
"sms",
|
|
1819
|
+
"email",
|
|
1820
|
+
"backup-code",
|
|
1821
|
+
"passkey"
|
|
1822
|
+
],
|
|
1823
|
+
"default": "totp"
|
|
1824
|
+
},
|
|
1825
|
+
"notes": [
|
|
1826
|
+
"Preset = método por defecto de la persona; pasa en `methods` todos los que tiene activos para ofrecer «probar otro método» (siempre conviene el código de respaldo como salida).",
|
|
1827
|
+
"`destination` llega enmascarado desde la app: el componente nunca ve el número o el correo completo.",
|
|
1828
|
+
"Tras varios fallos, devuelve `{ error: \"too-many-attempts\" }`; no bloquees el campo en el cliente."
|
|
1829
|
+
]
|
|
1830
|
+
},
|
|
1831
|
+
"mfa-setup": {
|
|
1832
|
+
"import": "orbital-ds/ui/mfa-setup",
|
|
1833
|
+
"exports": [
|
|
1834
|
+
"MfaSetup",
|
|
1835
|
+
"type MfaSetupPreset"
|
|
1836
|
+
],
|
|
1837
|
+
"slots": [
|
|
1838
|
+
"mfa-setup",
|
|
1839
|
+
"mfa-setup-codes",
|
|
1840
|
+
"mfa-setup-qr"
|
|
1841
|
+
],
|
|
1842
|
+
"optionalPeers": [],
|
|
1843
|
+
"presets": {
|
|
1844
|
+
"values": [
|
|
1845
|
+
"totp",
|
|
1846
|
+
"sms",
|
|
1847
|
+
"backup-codes"
|
|
1848
|
+
],
|
|
1849
|
+
"default": "totp"
|
|
1850
|
+
},
|
|
1851
|
+
"notes": [
|
|
1852
|
+
"`totp` es el método recomendado; `sms` solo como alternativa (menos seguro). Pasa siempre `backupCodes` al activar el primer método: es la salida si se pierde el dispositivo.",
|
|
1853
|
+
"El QR lo genera la app con su librería (p. ej. `qrcode.react`) a partir de la URI otpauth:// del proveedor; muestra también `secret` para teclearlo a mano."
|
|
1854
|
+
]
|
|
1855
|
+
},
|
|
1488
1856
|
"mosaic": {
|
|
1489
1857
|
"import": "orbital-ds/ui/mosaic",
|
|
1490
1858
|
"exports": [
|
|
@@ -1645,6 +2013,38 @@
|
|
|
1645
2013
|
],
|
|
1646
2014
|
"optionalPeers": []
|
|
1647
2015
|
},
|
|
2016
|
+
"oauth-consent": {
|
|
2017
|
+
"import": "orbital-ds/ui/oauth-consent",
|
|
2018
|
+
"exports": [
|
|
2019
|
+
"OAuthConsent",
|
|
2020
|
+
"type OAuthConsentPreset",
|
|
2021
|
+
"type OAuthParty",
|
|
2022
|
+
"type OAuthScope"
|
|
2023
|
+
],
|
|
2024
|
+
"slots": [
|
|
2025
|
+
"oauth-consent",
|
|
2026
|
+
"oauth-consent-link",
|
|
2027
|
+
"oauth-consent-scope",
|
|
2028
|
+
"oauth-consent-scopes"
|
|
2029
|
+
],
|
|
2030
|
+
"optionalPeers": [],
|
|
2031
|
+
"presets": {
|
|
2032
|
+
"values": [
|
|
2033
|
+
"authorize",
|
|
2034
|
+
"mcp",
|
|
2035
|
+
"device"
|
|
2036
|
+
],
|
|
2037
|
+
"default": "authorize",
|
|
2038
|
+
"intent": {
|
|
2039
|
+
"mcp": "— un asistente de IA o cliente MCP quiere actuar en nombre de la persona: lo dice claro,",
|
|
2040
|
+
"device": "— flujo de dispositivo (RFC 8628): primero el código que muestra la tele, la CLI o el"
|
|
2041
|
+
}
|
|
2042
|
+
},
|
|
2043
|
+
"notes": [
|
|
2044
|
+
"authorize para apps de terceros (OAuth/OIDC); mcp cuando quien pide acceso es un asistente de IA o cliente MCP (dilo claro y marca `sensitive` en escritura o borrado); device para CLI, tele o agentes sin navegador (RFC 8628).",
|
|
2045
|
+
"Pasa siempre `redirectUri` y `client.verified`: la persona debe saber adónde vuelve y si el cliente es de confianza. Los textos de cada permiso los traduce la app."
|
|
2046
|
+
]
|
|
2047
|
+
},
|
|
1648
2048
|
"page-header": {
|
|
1649
2049
|
"import": "orbital-ds/ui/page-header",
|
|
1650
2050
|
"exports": [
|
|
@@ -1693,6 +2093,40 @@
|
|
|
1693
2093
|
"Presets: `page` (vista normal), `compact` (vista densa o dentro de un panel), `canvas` (lienzo a todo el ancho, sin máximo). Dentro de PageShell, usa el preset de la maqueta y deja `page` aquí."
|
|
1694
2094
|
]
|
|
1695
2095
|
},
|
|
2096
|
+
"page-loader": {
|
|
2097
|
+
"import": "orbital-ds/ui/page-loader",
|
|
2098
|
+
"exports": [
|
|
2099
|
+
"PageLoader",
|
|
2100
|
+
"type PageLoaderIndicator",
|
|
2101
|
+
"type PageLoaderPreset"
|
|
2102
|
+
],
|
|
2103
|
+
"slots": [
|
|
2104
|
+
"page-loader",
|
|
2105
|
+
"page-loader-mark",
|
|
2106
|
+
"page-loader-message",
|
|
2107
|
+
"page-loader-progress"
|
|
2108
|
+
],
|
|
2109
|
+
"optionalPeers": [],
|
|
2110
|
+
"presets": {
|
|
2111
|
+
"values": [
|
|
2112
|
+
"splash",
|
|
2113
|
+
"route",
|
|
2114
|
+
"section",
|
|
2115
|
+
"overlay"
|
|
2116
|
+
],
|
|
2117
|
+
"default": "section",
|
|
2118
|
+
"intent": {
|
|
2119
|
+
"splash": "arranque de la app: pantalla completa, marca, indicador, mensajes y avance",
|
|
2120
|
+
"route": "navegación entre rutas: barra fina fija arriba, no bloquea ni tapa nada",
|
|
2121
|
+
"section": "una región que carga: centrado en su hueco, con altura mínima",
|
|
2122
|
+
"overlay": "procesando sobre contenido existente: velo con desenfoque que bloquea el área"
|
|
2123
|
+
}
|
|
2124
|
+
},
|
|
2125
|
+
"notes": [
|
|
2126
|
+
"Carga de página con intención: `splash` al arrancar la app (con marca y mensajes que rotan), `route` para navegar (barra fina, no bloquea), `section` para una región, `overlay` para procesar sobre contenido (bloquea el área; el contenedor debe ser `relative`). Esqueleto de la forma del contenido: LoadingState.",
|
|
2127
|
+
"Mensajes rotativos solo en cargas largas (> 3 s); con `value` real, muestra avance. Para una acción dentro de un botón usa Spinner; para una tarea larga con ilustración, TaskLoader. El texto lo pone la app con su i18n."
|
|
2128
|
+
]
|
|
2129
|
+
},
|
|
1696
2130
|
"page-shell": {
|
|
1697
2131
|
"import": "orbital-ds/ui/page-shell",
|
|
1698
2132
|
"exports": [
|
|
@@ -1749,6 +2183,39 @@
|
|
|
1749
2183
|
"slots": [],
|
|
1750
2184
|
"optionalPeers": []
|
|
1751
2185
|
},
|
|
2186
|
+
"passkey-list": {
|
|
2187
|
+
"import": "orbital-ds/ui/passkey-list",
|
|
2188
|
+
"exports": [
|
|
2189
|
+
"PasskeyList",
|
|
2190
|
+
"type PasskeyInfo"
|
|
2191
|
+
],
|
|
2192
|
+
"slots": [
|
|
2193
|
+
"passkey-list",
|
|
2194
|
+
"passkey-list-empty",
|
|
2195
|
+
"passkey-list-item"
|
|
2196
|
+
],
|
|
2197
|
+
"optionalPeers": [],
|
|
2198
|
+
"notes": [
|
|
2199
|
+
"En los ajustes de seguridad. Sin llaves, el estado vacío explica qué son: es el mejor momento para que la persona cree la primera. Ofrece también crearla justo después de entrar con contraseña.",
|
|
2200
|
+
"Quitar una llave es reversible (se puede crear otra), así que no pide confirmación; si es el único método de acceso, la app debe impedirlo devolviendo un error."
|
|
2201
|
+
]
|
|
2202
|
+
},
|
|
2203
|
+
"password-input": {
|
|
2204
|
+
"import": "orbital-ds/ui/password-input",
|
|
2205
|
+
"exports": [
|
|
2206
|
+
"PasswordInput"
|
|
2207
|
+
],
|
|
2208
|
+
"slots": [
|
|
2209
|
+
"password-input",
|
|
2210
|
+
"password-input-caps",
|
|
2211
|
+
"password-input-toggle"
|
|
2212
|
+
],
|
|
2213
|
+
"optionalPeers": [],
|
|
2214
|
+
"notes": [
|
|
2215
|
+
"Úsalo en lugar de `<Input type=\"password\">`. `autoComplete=\"current-password\"` al entrar y `\"new-password\"` al crear o cambiar: así funcionan los gestores de contraseñas y las passkeys.",
|
|
2216
|
+
"No bloquees pegar ni la autocompletación: es una mala práctica de seguridad (NIST 800-63B)."
|
|
2217
|
+
]
|
|
2218
|
+
},
|
|
1752
2219
|
"password-strength": {
|
|
1753
2220
|
"import": "orbital-ds/ui/password-strength",
|
|
1754
2221
|
"exports": [
|
|
@@ -1950,6 +2417,36 @@
|
|
|
1950
2417
|
],
|
|
1951
2418
|
"optionalPeers": []
|
|
1952
2419
|
},
|
|
2420
|
+
"session-list": {
|
|
2421
|
+
"import": "orbital-ds/ui/session-list",
|
|
2422
|
+
"exports": [
|
|
2423
|
+
"SessionList",
|
|
2424
|
+
"type SessionDeviceKind",
|
|
2425
|
+
"type SessionInfo"
|
|
2426
|
+
],
|
|
2427
|
+
"slots": [
|
|
2428
|
+
"session-list",
|
|
2429
|
+
"session-list-item"
|
|
2430
|
+
],
|
|
2431
|
+
"optionalPeers": [],
|
|
2432
|
+
"notes": [
|
|
2433
|
+
"En los ajustes de seguridad, junto a PasskeyList y ConnectedAccounts. La sesión actual va primero y no se puede cerrar desde aquí (para eso, SignOutDialog)."
|
|
2434
|
+
]
|
|
2435
|
+
},
|
|
2436
|
+
"session-timeout": {
|
|
2437
|
+
"import": "orbital-ds/ui/session-timeout",
|
|
2438
|
+
"exports": [
|
|
2439
|
+
"SessionTimeout"
|
|
2440
|
+
],
|
|
2441
|
+
"slots": [
|
|
2442
|
+
"session-timeout",
|
|
2443
|
+
"session-timeout-time"
|
|
2444
|
+
],
|
|
2445
|
+
"optionalPeers": [],
|
|
2446
|
+
"notes": [
|
|
2447
|
+
"Ábrelo un minuto antes de que caduque la sesión (WCAG 2.2.1 pide al menos 20 s para reaccionar). Si la persona amplía, cierra el diálogo y renueva el token; si no, `onExpire` la lleva a AuthStatus preset=\"session-expired\"."
|
|
2448
|
+
]
|
|
2449
|
+
},
|
|
1953
2450
|
"sheet": {
|
|
1954
2451
|
"import": "orbital-ds/ui/sheet",
|
|
1955
2452
|
"exports": [
|
|
@@ -2026,6 +2523,7 @@
|
|
|
2026
2523
|
"SidebarRail",
|
|
2027
2524
|
"SidebarSeparator",
|
|
2028
2525
|
"SidebarTrigger",
|
|
2526
|
+
"type SidebarPreset",
|
|
2029
2527
|
"useSidebar"
|
|
2030
2528
|
],
|
|
2031
2529
|
"slots": [
|
|
@@ -2051,7 +2549,39 @@
|
|
|
2051
2549
|
"sidebar-trigger",
|
|
2052
2550
|
"sidebar-wrapper"
|
|
2053
2551
|
],
|
|
2054
|
-
"optionalPeers": []
|
|
2552
|
+
"optionalPeers": [],
|
|
2553
|
+
"presets": {
|
|
2554
|
+
"values": [
|
|
2555
|
+
"app",
|
|
2556
|
+
"workspace",
|
|
2557
|
+
"admin",
|
|
2558
|
+
"focus"
|
|
2559
|
+
],
|
|
2560
|
+
"default": null,
|
|
2561
|
+
"intent": {
|
|
2562
|
+
"app": "producto o app de cliente: dock flotante que se pliega a raíl de iconos",
|
|
2563
|
+
"workspace": "herramienta de trabajo diario: el contenido como hoja sobre el lateral (inset), plegable a iconos",
|
|
2564
|
+
"admin": "backoffice con muchos destinos: lateral fijo, filas más densas, plegable a iconos",
|
|
2565
|
+
"focus": "editor, mapa o lienzo: se oculta del todo para dejar sitio al trabajo"
|
|
2566
|
+
}
|
|
2567
|
+
},
|
|
2568
|
+
"notes": [
|
|
2569
|
+
"Elige el lateral por intención con `preset`: `app` (dock flotante, raíl de iconos) para un producto; `workspace` (contenido como hoja) para una herramienta de uso diario; `admin` (fijo y denso) para un backoffice con muchos destinos; `focus` (se oculta) para editores, mapas y lienzos. Las props sueltas (variant, collapsible, density) lo ajustan.",
|
|
2570
|
+
"Con `collapsible=\"icon\"` cada SidebarMenuButton necesita su icono y su `tooltip`: plegado solo se ve el icono."
|
|
2571
|
+
]
|
|
2572
|
+
},
|
|
2573
|
+
"sign-out-dialog": {
|
|
2574
|
+
"import": "orbital-ds/ui/sign-out-dialog",
|
|
2575
|
+
"exports": [
|
|
2576
|
+
"SignOutDialog"
|
|
2577
|
+
],
|
|
2578
|
+
"slots": [
|
|
2579
|
+
"sign-out-dialog"
|
|
2580
|
+
],
|
|
2581
|
+
"optionalPeers": [],
|
|
2582
|
+
"notes": [
|
|
2583
|
+
"Confirma solo cuando salir tiene coste (trabajo sin guardar, sesión de equipo compartido); en el menú de usuario de una app normal, «Salir» puede cerrar sin preguntar y llevar a AuthStatus preset=\"signed-out\"."
|
|
2584
|
+
]
|
|
2055
2585
|
},
|
|
2056
2586
|
"skeleton": {
|
|
2057
2587
|
"import": "orbital-ds/ui/skeleton",
|
|
@@ -2128,17 +2658,20 @@
|
|
|
2128
2658
|
"values": [
|
|
2129
2659
|
"overview",
|
|
2130
2660
|
"compact",
|
|
2131
|
-
"comparison"
|
|
2661
|
+
"comparison",
|
|
2662
|
+
"strip"
|
|
2132
2663
|
],
|
|
2133
2664
|
"default": "overview",
|
|
2134
2665
|
"intent": {
|
|
2135
2666
|
"overview": "hasta 4 columnas: cabecera de un panel de datos",
|
|
2136
2667
|
"compact": "2 columnas en estrecho y hasta 4 en ancho, con menos aire: paneles densos",
|
|
2137
|
-
"comparison": "hasta 2 columnas: cifras para comparar de dos en dos"
|
|
2668
|
+
"comparison": "hasta 2 columnas: cifras para comparar de dos en dos",
|
|
2669
|
+
"strip": "una sola superficie con las cifras separadas por filetes (Stat variant=\"plain\"):"
|
|
2138
2670
|
}
|
|
2139
2671
|
},
|
|
2140
2672
|
"notes": [
|
|
2141
|
-
"Agrupa varios Stat en la cabecera de un panel; no pongas más de 4 por fila. Para series o tendencias usa Sparkline dentro de cada Stat."
|
|
2673
|
+
"Agrupa varios Stat en la cabecera de un panel; no pongas más de 4 por fila. Para series o tendencias usa Sparkline dentro de cada Stat.",
|
|
2674
|
+
"`strip` con Stat variant=\"plain\": un resumen en una sola tarjeta (hasta 5 cifras); para KPI que se pulsan o con tono propio, mejor `overview` con tarjetas."
|
|
2142
2675
|
]
|
|
2143
2676
|
},
|
|
2144
2677
|
"stat": {
|
|
@@ -2148,7 +2681,10 @@
|
|
|
2148
2681
|
"StatChart",
|
|
2149
2682
|
"StatDelta",
|
|
2150
2683
|
"StatDescription",
|
|
2684
|
+
"StatHeader",
|
|
2685
|
+
"StatIcon",
|
|
2151
2686
|
"StatLabel",
|
|
2687
|
+
"StatProgress",
|
|
2152
2688
|
"StatSwatch",
|
|
2153
2689
|
"StatValue",
|
|
2154
2690
|
"statVariants"
|
|
@@ -2157,7 +2693,10 @@
|
|
|
2157
2693
|
"stat-chart",
|
|
2158
2694
|
"stat-delta",
|
|
2159
2695
|
"stat-description",
|
|
2696
|
+
"stat-header",
|
|
2697
|
+
"stat-icon",
|
|
2160
2698
|
"stat-label",
|
|
2699
|
+
"stat-progress",
|
|
2161
2700
|
"stat-swatch",
|
|
2162
2701
|
"stat-value",
|
|
2163
2702
|
"stat-value-number",
|
|
@@ -2168,7 +2707,10 @@
|
|
|
2168
2707
|
"optionalPeers": [],
|
|
2169
2708
|
"notes": [
|
|
2170
2709
|
"KPI que filtra: render={<button type=\"button\" />}, pressed cuando el filtro está aplicado y onClick para alternarlo; el texto de la tarjeta dice qué pasa al pulsar.",
|
|
2171
|
-
"Un dato nulo no es cero: value={null} pinta «—» con «Sin dato» (y reason en un tooltip)."
|
|
2710
|
+
"Un dato nulo no es cero: value={null} pinta «—» con «Sin dato» (y reason en un tooltip).",
|
|
2711
|
+
"StatHeader + StatIcon para un KPI con identidad (icono con el color del tono); StatProgress cuando hay un objetivo (cuota, presupuesto, SLA): enseña el porcentaje en texto, no solo la barra.",
|
|
2712
|
+
"`animate` en StatValue solo para la cifra principal de un panel al cargar; nunca en tablas ni en valores que cambian cada segundo.",
|
|
2713
|
+
"variant=\"plain\" dentro de StatGroup preset=\"strip\": una franja de cifras en una sola superficie, separadas por filetes."
|
|
2172
2714
|
]
|
|
2173
2715
|
},
|
|
2174
2716
|
"status-badge": {
|