orbital-ds 0.41.0 → 0.48.0
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 +54 -12
- package/CHANGELOG.md +458 -0
- package/README.md +2 -2
- package/components.manifest.json +6630 -3569
- package/dist/hooks/use-esc-close-stack.js +38 -0
- package/dist/hooks/use-simulated-progress.js +30 -0
- package/dist/lib/brand-allowlist.js +703 -0
- package/dist/lib/brand-runtime.js +85 -0
- package/dist/lib/echarts-presets.js +152 -1
- package/dist/lib/echarts-setup.js +2 -0
- package/dist/lib/format.js +177 -0
- package/dist/lib/i18n.js +35 -2
- package/dist/lib/locales/de.js +536 -0
- package/dist/lib/locales/fr.js +536 -0
- package/dist/lib/locales/he.js +536 -0
- package/dist/lib/locales/it.js +536 -0
- package/dist/ui/auth-form.js +13 -6
- package/dist/ui/ayuda.js +4 -1
- package/dist/ui/breadcrumb.js +1 -1
- package/dist/ui/calendar.js +3 -0
- package/dist/ui/carousel.js +10 -5
- package/dist/ui/context-menu.js +3 -3
- package/dist/ui/cta-banner.js +63 -0
- package/dist/ui/date-time.js +55 -0
- package/dist/ui/description-list.js +86 -0
- package/dist/ui/detail-panel.js +2 -2
- package/dist/ui/dropdown-menu.js +1 -1
- package/dist/ui/faq.js +25 -0
- package/dist/ui/feature-grid.js +40 -0
- package/dist/ui/hero.js +145 -0
- package/dist/ui/landing-section.js +59 -0
- package/dist/ui/mfa-challenge.js +1 -1
- package/dist/ui/next-step-card.js +92 -0
- package/dist/ui/page-header.js +20 -11
- package/dist/ui/pagination.js +2 -2
- package/dist/ui/pricing-table.js +86 -0
- package/dist/ui/quantity.js +27 -0
- package/dist/ui/sheet.js +6 -2
- package/dist/ui/sidebar.js +7 -3
- package/dist/ui/tag-input.js +169 -0
- package/dist/ui/testimonial.js +61 -0
- package/dist/ui/textarea.js +7 -1
- package/dist/ui/usage-meter.js +116 -0
- package/dist/ui/week-strip.js +2 -2
- package/docs/adr/0001-rtl-clases-logicas.md +14 -1
- package/docs/designer/flujo.md +1 -1
- package/docs/designer/patrones.md +45 -1
- package/manifest/actions.json +364 -0
- package/manifest/agents.json +399 -0
- package/manifest/ai.json +128 -0
- package/manifest/auth.json +1547 -0
- package/manifest/chat.json +612 -0
- package/manifest/content.json +2793 -0
- package/manifest/data.json +2802 -0
- package/manifest/feedback.json +1005 -0
- package/manifest/forms.json +1954 -0
- package/manifest/motion.json +196 -0
- package/manifest/navigation.json +1792 -0
- package/manifest/overlays.json +934 -0
- package/package.json +240 -238
- package/scripts/cli.mjs +124 -8
- package/scripts/doctor.mjs +153 -2
- package/scripts/eslint-plugin.mjs +125 -0
- package/scripts/i18n.mjs +1 -1
- package/scripts/manifest.mjs +179 -7
- package/scripts/upgrade.mjs +126 -0
- package/skill/SKILL.md +8 -3
- package/dist/hooks/use-ds-messages.d.ts +0 -537
- package/dist/hooks/use-ds-motion.d.ts +0 -17
- package/dist/hooks/use-in-view.d.ts +0 -9
- package/dist/hooks/use-mobile.d.ts +0 -3
- package/dist/lib/a2ui-catalog.d.ts +0 -42
- package/dist/lib/a2ui.d.ts +0 -289
- package/dist/lib/ai-events.d.ts +0 -15
- package/dist/lib/auth-better-auth.d.ts +0 -29
- package/dist/lib/auth-flow.d.ts +0 -85
- package/dist/lib/auth-providers.d.ts +0 -194
- package/dist/lib/auth.d.ts +0 -68
- package/dist/lib/echarts-presets.d.ts +0 -227
- package/dist/lib/echarts-server.d.ts +0 -15
- package/dist/lib/echarts-setup.d.ts +0 -8
- package/dist/lib/echarts-theme.d.ts +0 -36
- package/dist/lib/header-control.d.ts +0 -4
- package/dist/lib/i18n.d.ts +0 -545
- package/dist/lib/image-upload.d.ts +0 -41
- package/dist/lib/motion.d.ts +0 -74
- package/dist/lib/presets.d.ts +0 -8
- package/dist/lib/template-syntax.d.ts +0 -22
- package/dist/lib/utils.d.ts +0 -5
- package/dist/motion.css +0 -146
- package/dist/styles.css +0 -1737
- package/dist/themes/chocolate.css +0 -259
- package/dist/themes/chocolate.fonts.css +0 -2
- package/dist/themes/chocolate.guide.md +0 -30
- package/dist/themes/chocolate.meta.json +0 -61
- package/dist/themes/chocolate.scoped.css +0 -259
- package/dist/themes/chocolate.tokens.json +0 -49
- package/dist/themes/fractalia.css +0 -556
- package/dist/themes/fractalia.fonts.css +0 -3
- package/dist/themes/fractalia.guide.md +0 -86
- package/dist/themes/fractalia.meta.json +0 -112
- package/dist/themes/fractalia.scoped.css +0 -556
- package/dist/themes/fractalia.tokens.json +0 -39
- package/dist/themes/friendly.css +0 -375
- package/dist/themes/friendly.fonts.css +0 -2
- package/dist/themes/friendly.guide.md +0 -38
- package/dist/themes/friendly.meta.json +0 -82
- package/dist/themes/friendly.scoped.css +0 -375
- package/dist/themes/friendly.tokens.json +0 -45
- package/dist/themes/lagoon.css +0 -362
- package/dist/themes/lagoon.fonts.css +0 -2
- package/dist/themes/lagoon.guide.md +0 -47
- package/dist/themes/lagoon.meta.json +0 -85
- package/dist/themes/lagoon.scoped.css +0 -362
- package/dist/themes/lagoon.tokens.json +0 -49
- package/dist/themes/liquid.css +0 -510
- package/dist/themes/liquid.fonts.css +0 -7
- package/dist/themes/liquid.guide.md +0 -82
- package/dist/themes/liquid.meta.json +0 -134
- package/dist/themes/liquid.scoped.css +0 -510
- package/dist/themes/liquid.tokens.json +0 -47
- package/dist/themes/matcha.css +0 -259
- package/dist/themes/matcha.fonts.css +0 -2
- package/dist/themes/matcha.guide.md +0 -30
- package/dist/themes/matcha.meta.json +0 -61
- package/dist/themes/matcha.scoped.css +0 -259
- package/dist/themes/matcha.tokens.json +0 -49
- package/dist/themes/qratia.css +0 -264
- package/dist/themes/qratia.fonts.css +0 -2
- package/dist/themes/qratia.guide.md +0 -34
- package/dist/themes/qratia.meta.json +0 -49
- package/dist/themes/qratia.scoped.css +0 -264
- package/dist/themes/qratia.tokens.json +0 -49
- package/dist/themes/stone.css +0 -263
- package/dist/themes/stone.fonts.css +0 -2
- package/dist/themes/stone.guide.md +0 -30
- package/dist/themes/stone.meta.json +0 -47
- package/dist/themes/stone.scoped.css +0 -263
- package/dist/themes/stone.tokens.json +0 -49
- package/dist/themes/tactile.css +0 -596
- package/dist/themes/tactile.fonts.css +0 -3
- package/dist/themes/tactile.guide.md +0 -82
- package/dist/themes/tactile.meta.json +0 -182
- package/dist/themes/tactile.scoped.css +0 -596
- package/dist/themes/tactile.tokens.json +0 -42
- package/dist/themes/twitter.css +0 -364
- package/dist/themes/twitter.fonts.css +0 -6
- package/dist/themes/twitter.guide.md +0 -35
- package/dist/themes/twitter.meta.json +0 -90
- package/dist/themes/twitter.scoped.css +0 -364
- package/dist/themes/twitter.tokens.json +0 -45
- package/dist/themes/y2k.css +0 -259
- package/dist/themes/y2k.fonts.css +0 -2
- package/dist/themes/y2k.guide.md +0 -30
- package/dist/themes/y2k.meta.json +0 -59
- package/dist/themes/y2k.scoped.css +0 -259
- package/dist/themes/y2k.tokens.json +0 -49
- package/dist/themes/zyro.css +0 -442
- package/dist/themes/zyro.fonts.css +0 -2
- package/dist/themes/zyro.guide.md +0 -33
- package/dist/themes/zyro.meta.json +0 -74
- package/dist/themes/zyro.scoped.css +0 -442
- package/dist/themes/zyro.tokens.json +0 -46
- package/dist/ui/a2ui-renderer.d.ts +0 -33
- package/dist/ui/accordion.d.ts +0 -9
- package/dist/ui/agent-events.d.ts +0 -32
- package/dist/ui/ai-tag.d.ts +0 -8
- package/dist/ui/alert-dialog.d.ts +0 -23
- package/dist/ui/alert.d.ts +0 -13
- package/dist/ui/animated-number.d.ts +0 -9
- package/dist/ui/app-bar.d.ts +0 -10
- package/dist/ui/aspect-ratio.d.ts +0 -7
- package/dist/ui/attachment.d.ts +0 -26
- package/dist/ui/auth-backdrop.d.ts +0 -20
- package/dist/ui/auth-form.d.ts +0 -113
- package/dist/ui/auth-layout.d.ts +0 -72
- package/dist/ui/auth-parts.d.ts +0 -43
- package/dist/ui/auth-status.d.ts +0 -23
- package/dist/ui/avatar.d.ts +0 -16
- package/dist/ui/ayuda.d.ts +0 -22
- package/dist/ui/badge.d.ts +0 -15
- package/dist/ui/banner.d.ts +0 -14
- package/dist/ui/bottom-nav.d.ts +0 -15
- package/dist/ui/breadcrumb.d.ts +0 -12
- package/dist/ui/bubble.d.ts +0 -19
- package/dist/ui/button-group.d.ts +0 -15
- package/dist/ui/button.d.ts +0 -14
- package/dist/ui/calendar.d.ts +0 -15
- package/dist/ui/card-stack.d.ts +0 -9
- package/dist/ui/card.d.ts +0 -28
- package/dist/ui/carousel.d.ts +0 -33
- package/dist/ui/chain-of-thought.d.ts +0 -19
- package/dist/ui/chart-card.d.ts +0 -28
- package/dist/ui/chart.d.ts +0 -46
- package/dist/ui/chart.js +0 -254
- package/dist/ui/chat-composer.d.ts +0 -39
- package/dist/ui/checkbox.d.ts +0 -6
- package/dist/ui/choice-card.d.ts +0 -16
- package/dist/ui/code-block.d.ts +0 -14
- package/dist/ui/collapsible.d.ts +0 -8
- package/dist/ui/combobox.d.ts +0 -26
- package/dist/ui/command-palette.d.ts +0 -36
- package/dist/ui/command.d.ts +0 -22
- package/dist/ui/confirm-action.d.ts +0 -18
- package/dist/ui/confirm-dialog.d.ts +0 -21
- package/dist/ui/connected-accounts.d.ts +0 -25
- package/dist/ui/content-card.d.ts +0 -52
- package/dist/ui/context-menu.d.ts +0 -31
- package/dist/ui/conversation-list.d.ts +0 -24
- package/dist/ui/copy-button.d.ts +0 -14
- package/dist/ui/data-table.d.ts +0 -198
- package/dist/ui/date-picker.d.ts +0 -65
- package/dist/ui/detail-panel.d.ts +0 -16
- package/dist/ui/dialog.d.ts +0 -19
- package/dist/ui/direction.d.ts +0 -1
- package/dist/ui/dock.d.ts +0 -13
- package/dist/ui/drawer.d.ts +0 -18
- package/dist/ui/dropdown-menu.d.ts +0 -31
- package/dist/ui/dropzone.d.ts +0 -44
- package/dist/ui/echart.d.ts +0 -31
- package/dist/ui/empty-state.d.ts +0 -26
- package/dist/ui/empty.d.ts +0 -15
- package/dist/ui/entity-list.d.ts +0 -25
- package/dist/ui/error-page.d.ts +0 -28
- package/dist/ui/error-state.d.ts +0 -16
- package/dist/ui/eyebrow.d.ts +0 -7
- package/dist/ui/field.d.ts +0 -28
- package/dist/ui/file-upload.d.ts +0 -42
- package/dist/ui/filter-bar.d.ts +0 -38
- package/dist/ui/form-layout.d.ts +0 -19
- package/dist/ui/gauge.d.ts +0 -40
- package/dist/ui/generated-image.d.ts +0 -14
- package/dist/ui/generated-table.d.ts +0 -11
- package/dist/ui/heatmap-grid.d.ts +0 -39
- package/dist/ui/hover-card.d.ts +0 -8
- package/dist/ui/i18n-provider.d.ts +0 -11
- package/dist/ui/icon-tile.d.ts +0 -11
- package/dist/ui/input-group.d.ts +0 -22
- package/dist/ui/input-otp.d.ts +0 -13
- package/dist/ui/input.d.ts +0 -5
- package/dist/ui/instruction-editor.d.ts +0 -64
- package/dist/ui/item.d.ts +0 -26
- package/dist/ui/kbd.d.ts +0 -6
- package/dist/ui/label.d.ts +0 -5
- package/dist/ui/legend.d.ts +0 -32
- package/dist/ui/level-meter.d.ts +0 -16
- package/dist/ui/load-more.d.ts +0 -19
- package/dist/ui/loading-state.d.ts +0 -14
- package/dist/ui/locale-switcher.d.ts +0 -19
- package/dist/ui/markdown.d.ts +0 -14
- package/dist/ui/marker.d.ts +0 -13
- package/dist/ui/media-card.d.ts +0 -13
- package/dist/ui/menubar.d.ts +0 -31
- package/dist/ui/message-actions.d.ts +0 -12
- package/dist/ui/message-scroller.d.ts +0 -16
- package/dist/ui/message.d.ts +0 -12
- package/dist/ui/mfa-challenge.d.ts +0 -33
- package/dist/ui/mfa-setup.d.ts +0 -29
- package/dist/ui/mosaic.d.ts +0 -15
- package/dist/ui/motion-provider.d.ts +0 -11
- package/dist/ui/native-select.d.ts +0 -10
- package/dist/ui/navigation-menu.d.ts +0 -15
- package/dist/ui/notice-review.d.ts +0 -32
- package/dist/ui/notifications.d.ts +0 -81
- package/dist/ui/oauth-consent.d.ts +0 -54
- package/dist/ui/page-header.d.ts +0 -22
- package/dist/ui/page-loader.d.ts +0 -23
- package/dist/ui/page-shell.d.ts +0 -8
- package/dist/ui/pagination.d.ts +0 -22
- package/dist/ui/panel.d.ts +0 -12
- package/dist/ui/passkey-list.d.ts +0 -17
- package/dist/ui/password-input.d.ts +0 -5
- package/dist/ui/password-strength.d.ts +0 -14
- package/dist/ui/popover.d.ts +0 -12
- package/dist/ui/progress.d.ts +0 -9
- package/dist/ui/proportion-bar.d.ts +0 -27
- package/dist/ui/questionnaire.d.ts +0 -24
- package/dist/ui/radio-group.d.ts +0 -8
- package/dist/ui/reasoning.d.ts +0 -10
- package/dist/ui/resizable.d.ts +0 -10
- package/dist/ui/reveal.d.ts +0 -11
- package/dist/ui/scroll-area.d.ts +0 -7
- package/dist/ui/search-box.d.ts +0 -32
- package/dist/ui/select.d.ts +0 -19
- package/dist/ui/separator.d.ts +0 -6
- package/dist/ui/session-list.d.ts +0 -19
- package/dist/ui/session-timeout.d.ts +0 -13
- package/dist/ui/sheet.d.ts +0 -16
- package/dist/ui/shield.d.ts +0 -21
- package/dist/ui/show-more.d.ts +0 -12
- package/dist/ui/sidebar.d.ts +0 -90
- package/dist/ui/sign-out-dialog.d.ts +0 -17
- package/dist/ui/skeleton.d.ts +0 -10
- package/dist/ui/slider.d.ts +0 -23
- package/dist/ui/sonner.d.ts +0 -6
- package/dist/ui/sparkline.d.ts +0 -26
- package/dist/ui/spinner.d.ts +0 -5
- package/dist/ui/stat-group.d.ts +0 -8
- package/dist/ui/stat.d.ts +0 -90
- package/dist/ui/status-badge.d.ts +0 -39
- package/dist/ui/status-hero.d.ts +0 -12
- package/dist/ui/step-dots.d.ts +0 -10
- package/dist/ui/step-flow.d.ts +0 -48
- package/dist/ui/step-ring.d.ts +0 -12
- package/dist/ui/stepper.d.ts +0 -20
- package/dist/ui/suggestions.d.ts +0 -8
- package/dist/ui/switch.d.ts +0 -8
- package/dist/ui/table.d.ts +0 -12
- package/dist/ui/tabs.d.ts +0 -14
- package/dist/ui/task-loader.d.ts +0 -14
- package/dist/ui/task-progress.d.ts +0 -18
- package/dist/ui/textarea.d.ts +0 -11
- package/dist/ui/theme-toggle.d.ts +0 -14
- package/dist/ui/timeline.d.ts +0 -29
- package/dist/ui/toast.d.ts +0 -19
- package/dist/ui/toggle-group.d.ts +0 -14
- package/dist/ui/toggle.d.ts +0 -12
- package/dist/ui/tool-call.d.ts +0 -15
- package/dist/ui/tooltip.d.ts +0 -9
- package/dist/ui/week-strip.d.ts +0 -12
- package/dist/ui/workflow-run.d.ts +0 -23
|
@@ -0,0 +1,1005 @@
|
|
|
1
|
+
{
|
|
2
|
+
"package": "orbital-ds",
|
|
3
|
+
"version": "0.48.0",
|
|
4
|
+
"group": "feedback",
|
|
5
|
+
"about": "Alertas, toasts, progreso y esperas.",
|
|
6
|
+
"components": {
|
|
7
|
+
"alert": {
|
|
8
|
+
"import": "orbital-ds/ui/alert",
|
|
9
|
+
"group": "feedback",
|
|
10
|
+
"summary": "Aviso persistente dentro de una sección o formulario (error al guardar, requisito pendiente, contexto); se queda hasta que cambia la causa. Tonos info · success · warning · danger.",
|
|
11
|
+
"see": [
|
|
12
|
+
{
|
|
13
|
+
"component": "banner",
|
|
14
|
+
"when": "aviso que afecta a toda la página, a lo ancho y encima del contenido"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"component": "toast",
|
|
18
|
+
"when": "confirmación breve de una acción, que desaparece sola"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"component": "empty-state",
|
|
22
|
+
"when": "la sección no tiene contenido (sin datos, sin resultados)"
|
|
23
|
+
}
|
|
24
|
+
],
|
|
25
|
+
"exports": [
|
|
26
|
+
"Alert",
|
|
27
|
+
"AlertAction",
|
|
28
|
+
"AlertDescription",
|
|
29
|
+
"AlertTitle"
|
|
30
|
+
],
|
|
31
|
+
"slots": [
|
|
32
|
+
"alert",
|
|
33
|
+
"alert-action",
|
|
34
|
+
"alert-description",
|
|
35
|
+
"alert-title"
|
|
36
|
+
],
|
|
37
|
+
"optionalPeers": [],
|
|
38
|
+
"props": {
|
|
39
|
+
"Alert": {
|
|
40
|
+
"variant": {
|
|
41
|
+
"type": "\"default\" | \"destructive\" | \"info\" | \"success\" | \"warning\" | \"danger\"",
|
|
42
|
+
"values": [
|
|
43
|
+
"default",
|
|
44
|
+
"destructive",
|
|
45
|
+
"info",
|
|
46
|
+
"success",
|
|
47
|
+
"warning",
|
|
48
|
+
"danger"
|
|
49
|
+
]
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
},
|
|
53
|
+
"notes": [
|
|
54
|
+
"El icono va como primer hijo y toma el tono de la variante: no le pongas color.",
|
|
55
|
+
"El error de un campo concreto va en su FieldError, no en un Alert; el aviso de toda la página, en Banner."
|
|
56
|
+
],
|
|
57
|
+
"examples": [
|
|
58
|
+
{
|
|
59
|
+
"title": "Aviso de estado con icono",
|
|
60
|
+
"code": "<Alert variant=\"warning\">\n <TriangleAlertIcon />\n <AlertTitle>Faltan los datos de facturación</AlertTitle>\n <AlertDescription>Complétalos antes del día 30 para emitir la factura.</AlertDescription>\n</Alert>"
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
"title": "Con una acción",
|
|
64
|
+
"code": "<Alert variant=\"info\">\n <InfoIcon />\n <AlertTitle>Hay una versión nueva del informe</AlertTitle>\n <AlertAction>\n <Button size=\"sm\" variant=\"outline\" onClick={reload}>Ver</Button>\n </AlertAction>\n</Alert>"
|
|
65
|
+
}
|
|
66
|
+
]
|
|
67
|
+
},
|
|
68
|
+
"banner": {
|
|
69
|
+
"import": "orbital-ds/ui/banner",
|
|
70
|
+
"group": "feedback",
|
|
71
|
+
"summary": "Aviso de página a lo ancho de la vista y encima del contenido (mantenimiento, prueba que caduca, pago pendiente); persiste hasta que se resuelve o se descarta.",
|
|
72
|
+
"see": [
|
|
73
|
+
{
|
|
74
|
+
"component": "alert",
|
|
75
|
+
"when": "aviso de una sola sección o formulario"
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"component": "toast",
|
|
79
|
+
"when": "confirmación efímera de una acción"
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"component": "notifications",
|
|
83
|
+
"when": "asunto con seguimiento o decisión (campana)"
|
|
84
|
+
}
|
|
85
|
+
],
|
|
86
|
+
"exports": [
|
|
87
|
+
"Banner",
|
|
88
|
+
"BannerActions",
|
|
89
|
+
"BannerContent",
|
|
90
|
+
"BannerDescription",
|
|
91
|
+
"BannerTitle",
|
|
92
|
+
"bannerVariants"
|
|
93
|
+
],
|
|
94
|
+
"slots": [
|
|
95
|
+
"banner",
|
|
96
|
+
"banner-actions",
|
|
97
|
+
"banner-content",
|
|
98
|
+
"banner-description",
|
|
99
|
+
"banner-title"
|
|
100
|
+
],
|
|
101
|
+
"optionalPeers": [],
|
|
102
|
+
"props": {
|
|
103
|
+
"Banner": {
|
|
104
|
+
"variant": {
|
|
105
|
+
"type": "\"default\" | \"info\" | \"success\" | \"warning\" | \"danger\" | \"brand\"",
|
|
106
|
+
"values": [
|
|
107
|
+
"default",
|
|
108
|
+
"info",
|
|
109
|
+
"success",
|
|
110
|
+
"warning",
|
|
111
|
+
"danger",
|
|
112
|
+
"brand"
|
|
113
|
+
]
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
},
|
|
117
|
+
"notes": [
|
|
118
|
+
"Uno a la vez, arriba del contenido de la página (bajo la AppBar), nunca dentro de una tarjeta.",
|
|
119
|
+
"Si se puede descartar, el botón de cerrar es de solo icono con `aria-label` y la app recuerda el descarte."
|
|
120
|
+
],
|
|
121
|
+
"examples": [
|
|
122
|
+
{
|
|
123
|
+
"title": "Aviso con acción y descarte",
|
|
124
|
+
"code": "<Banner variant=\"warning\">\n <TriangleAlertIcon />\n <BannerContent>\n <BannerTitle>Tu prueba caduca en 3 días</BannerTitle>\n <BannerDescription>Elige un plan para no perder los datos.</BannerDescription>\n </BannerContent>\n <BannerActions>\n <Button size=\"sm\" variant=\"outline\">Ver planes</Button>\n <Button size=\"icon-sm\" variant=\"ghost\" aria-label={t(\"actions.dismiss\")} onClick={dismiss}>\n <XIcon />\n </Button>\n </BannerActions>\n</Banner>"
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"title": "Anuncio con el color de la marca",
|
|
128
|
+
"code": "<Banner variant=\"brand\">\n <BannerContent>\n <BannerTitle>Nuevo panel de facturación</BannerTitle>\n <BannerDescription>\n Ya puedes descargar todas tus facturas. <a href=\"/billing\">Ir al panel</a>\n </BannerDescription>\n </BannerContent>\n</Banner>"
|
|
129
|
+
}
|
|
130
|
+
]
|
|
131
|
+
},
|
|
132
|
+
"next-step-card": {
|
|
133
|
+
"import": "orbital-ds/ui/next-step-card",
|
|
134
|
+
"group": "feedback",
|
|
135
|
+
"summary": "Tarjeta con el estado de algo (un servicio, una cuenta, un trámite) y la ÚNICA acción que toca ahora; el preset sigue al estado: activate · open · resolve · inactive.",
|
|
136
|
+
"see": [
|
|
137
|
+
{
|
|
138
|
+
"component": "stat",
|
|
139
|
+
"when": "una cifra suelta (KPI), sin acción"
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
"component": "content-card",
|
|
143
|
+
"when": "tarjeta de contenido o de navegación, sin estado"
|
|
144
|
+
},
|
|
145
|
+
{
|
|
146
|
+
"component": "alert",
|
|
147
|
+
"when": "aviso dentro de una sección, sin tarjeta de estado"
|
|
148
|
+
}
|
|
149
|
+
],
|
|
150
|
+
"exports": [
|
|
151
|
+
"NextStepCard"
|
|
152
|
+
],
|
|
153
|
+
"slots": [
|
|
154
|
+
"next-step-card",
|
|
155
|
+
"next-step-card-actions",
|
|
156
|
+
"next-step-card-body",
|
|
157
|
+
"next-step-card-content",
|
|
158
|
+
"next-step-card-description",
|
|
159
|
+
"next-step-card-icon",
|
|
160
|
+
"next-step-card-layout",
|
|
161
|
+
"next-step-card-meta",
|
|
162
|
+
"next-step-card-title"
|
|
163
|
+
],
|
|
164
|
+
"optionalPeers": [],
|
|
165
|
+
"props": {
|
|
166
|
+
"NextStepCard": {
|
|
167
|
+
"size": {
|
|
168
|
+
"type": "\"default\" | \"sm\"",
|
|
169
|
+
"values": [
|
|
170
|
+
"default",
|
|
171
|
+
"sm"
|
|
172
|
+
]
|
|
173
|
+
},
|
|
174
|
+
"glow": {
|
|
175
|
+
"type": "boolean",
|
|
176
|
+
"doc": "Resplandor de marca alrededor de la tarjeta al señalarla (--ds-card-glow)."
|
|
177
|
+
},
|
|
178
|
+
"backdrop": {
|
|
179
|
+
"type": "AuthBackdropVariant",
|
|
180
|
+
"values": [
|
|
181
|
+
"image",
|
|
182
|
+
"none",
|
|
183
|
+
"grid",
|
|
184
|
+
"dots",
|
|
185
|
+
"aurora",
|
|
186
|
+
"mesh",
|
|
187
|
+
"glow",
|
|
188
|
+
"rings",
|
|
189
|
+
"beams"
|
|
190
|
+
],
|
|
191
|
+
"doc": "Fondo de AuthBackdrop detrás del contenido (mesh, aurora, image, dots…). Con texto largo, prefiere `dots` o `grid`."
|
|
192
|
+
},
|
|
193
|
+
"backdropMedia": {
|
|
194
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
195
|
+
"doc": "backdrop=\"image\": la foto o el vídeo (un <img>/<video> con alt=\"\")."
|
|
196
|
+
},
|
|
197
|
+
"backdropGlass": {
|
|
198
|
+
"type": "boolean",
|
|
199
|
+
"doc": "Cristal esmerilado encima del fondo."
|
|
200
|
+
},
|
|
201
|
+
"animated": {
|
|
202
|
+
"type": "boolean",
|
|
203
|
+
"doc": "false = fondo quieto."
|
|
204
|
+
},
|
|
205
|
+
"hoverable": {
|
|
206
|
+
"type": "boolean",
|
|
207
|
+
"doc": "Al pasar el ratón la tarjeta se eleva y marca el borde (--ds-card-hover-lift / -border)."
|
|
208
|
+
},
|
|
209
|
+
"spotlight": {
|
|
210
|
+
"type": "boolean",
|
|
211
|
+
"doc": "Un foco de luz sigue al puntero por dentro de la tarjeta (solo con ratón; quieto con movimiento reducido)."
|
|
212
|
+
},
|
|
213
|
+
"preset": {
|
|
214
|
+
"type": "NextStepPreset",
|
|
215
|
+
"values": [
|
|
216
|
+
"open",
|
|
217
|
+
"activate",
|
|
218
|
+
"resolve",
|
|
219
|
+
"inactive"
|
|
220
|
+
]
|
|
221
|
+
},
|
|
222
|
+
"tone": {
|
|
223
|
+
"type": "NextStepTone",
|
|
224
|
+
"values": [
|
|
225
|
+
"info",
|
|
226
|
+
"success",
|
|
227
|
+
"warning",
|
|
228
|
+
"danger",
|
|
229
|
+
"neutral"
|
|
230
|
+
]
|
|
231
|
+
},
|
|
232
|
+
"emphasis": {
|
|
233
|
+
"type": "boolean",
|
|
234
|
+
"doc": "Filete de color en el borde de inicio para lo que pide acción."
|
|
235
|
+
},
|
|
236
|
+
"icon": {
|
|
237
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
238
|
+
"doc": "Icono (svg) en una baldosa del color del tono."
|
|
239
|
+
},
|
|
240
|
+
"title": {
|
|
241
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
242
|
+
"required": true
|
|
243
|
+
},
|
|
244
|
+
"status": {
|
|
245
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
246
|
+
"doc": "Estado, normalmente un StatusBadge."
|
|
247
|
+
},
|
|
248
|
+
"description": {
|
|
249
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
|
|
250
|
+
},
|
|
251
|
+
"meta": {
|
|
252
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
253
|
+
"doc": "Línea de datos secundarios (plan, fechas, última actividad)."
|
|
254
|
+
},
|
|
255
|
+
"action": {
|
|
256
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
257
|
+
"doc": "La acción principal: un solo botón."
|
|
258
|
+
},
|
|
259
|
+
"secondaryActions": {
|
|
260
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
261
|
+
"doc": "Acciones de menor peso (ghost/outline), detrás de la principal."
|
|
262
|
+
},
|
|
263
|
+
"headingLevel": {
|
|
264
|
+
"type": "2 | 4 | 3",
|
|
265
|
+
"doc": "Nivel del título (h2 por defecto)."
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
},
|
|
269
|
+
"presets": {
|
|
270
|
+
"values": [
|
|
271
|
+
"activate",
|
|
272
|
+
"open",
|
|
273
|
+
"resolve",
|
|
274
|
+
"inactive"
|
|
275
|
+
],
|
|
276
|
+
"default": "open",
|
|
277
|
+
"intent": {
|
|
278
|
+
"activate": "pendiente de activar o de completar: tono info, con acento",
|
|
279
|
+
"open": "activo y listo para usar: tono success, sin acento",
|
|
280
|
+
"resolve": "necesita atención (pago, error, límite): tono warning, con acento",
|
|
281
|
+
"inactive": "de baja, cerrado o en pausa: tono neutral, sin acento"
|
|
282
|
+
}
|
|
283
|
+
},
|
|
284
|
+
"notes": [
|
|
285
|
+
"Estado + siguiente paso de un servicio o cuenta: preset según el estado (activate → «Activar», open → «Abrir», resolve → «Revisar el pago», inactive → «Reactivar»). Una sola acción principal.",
|
|
286
|
+
"El uso del servicio (UsageMeter) o sus datos (DescriptionList) van como hijos, debajo."
|
|
287
|
+
],
|
|
288
|
+
"examples": [
|
|
289
|
+
{
|
|
290
|
+
"title": "Pendiente de activar (preset activate)",
|
|
291
|
+
"code": "<NextStepCard\n preset=\"activate\"\n icon={<ShieldIcon />}\n title={service.name}\n status={<StatusBadge level=\"info\">Pendiente de activar</StatusBadge>}\n description={t(\"backup.activateHint\")}\n action={<Button onClick={activate}>Activar</Button>}\n/>"
|
|
292
|
+
},
|
|
293
|
+
{
|
|
294
|
+
"title": "Activo, con su uso debajo (preset open)",
|
|
295
|
+
"code": "<NextStepCard\n preset=\"open\"\n title={service.name}\n status={<StatusBadge level=\"ok\">Activo</StatusBadge>}\n action={<Button render={<a href={service.url} />}>Abrir el servicio</Button>}\n>\n <UsageMeter label=\"Almacenamiento\" value={12} limit={50} unit=\"GBy\" />\n</NextStepCard>"
|
|
296
|
+
}
|
|
297
|
+
]
|
|
298
|
+
},
|
|
299
|
+
"notice-review": {
|
|
300
|
+
"import": "orbital-ds/ui/notice-review",
|
|
301
|
+
"group": "feedback",
|
|
302
|
+
"summary": "Revisión de un aviso o comunicación con su contexto completo y la acción que pide (leer, reconocer, resolver con nota, aceptar o rechazar); se abre desde la campana.",
|
|
303
|
+
"see": [
|
|
304
|
+
{
|
|
305
|
+
"component": "notifications",
|
|
306
|
+
"when": "la campana y la lista de avisos desde la que se abre"
|
|
307
|
+
},
|
|
308
|
+
{
|
|
309
|
+
"component": "confirm-action",
|
|
310
|
+
"when": "confirmar una acción delicada de la propia persona, no un aviso"
|
|
311
|
+
},
|
|
312
|
+
{
|
|
313
|
+
"component": "alert-dialog",
|
|
314
|
+
"when": "bloquear hasta decidir algo que no es un aviso"
|
|
315
|
+
}
|
|
316
|
+
],
|
|
317
|
+
"exports": [
|
|
318
|
+
"NoticeReview",
|
|
319
|
+
"type NoticeReviewPreset"
|
|
320
|
+
],
|
|
321
|
+
"slots": [
|
|
322
|
+
"notice-review",
|
|
323
|
+
"notice-review-actions",
|
|
324
|
+
"notice-review-body",
|
|
325
|
+
"notice-review-state"
|
|
326
|
+
],
|
|
327
|
+
"optionalPeers": [],
|
|
328
|
+
"props": {
|
|
329
|
+
"NoticeReview": {
|
|
330
|
+
"open": {
|
|
331
|
+
"type": "boolean"
|
|
332
|
+
},
|
|
333
|
+
"onOpenChange": {
|
|
334
|
+
"type": "(open: boolean) => void"
|
|
335
|
+
},
|
|
336
|
+
"preset": {
|
|
337
|
+
"type": "NoticeReviewPreset",
|
|
338
|
+
"values": [
|
|
339
|
+
"resolve",
|
|
340
|
+
"read",
|
|
341
|
+
"acknowledge",
|
|
342
|
+
"respond"
|
|
343
|
+
]
|
|
344
|
+
},
|
|
345
|
+
"presentation": {
|
|
346
|
+
"type": "\"dialog\" | \"sheet\"",
|
|
347
|
+
"values": [
|
|
348
|
+
"dialog",
|
|
349
|
+
"sheet"
|
|
350
|
+
],
|
|
351
|
+
"doc": "`dialog` o `sheet`; `page` e `inline` no aplican."
|
|
352
|
+
},
|
|
353
|
+
"tone": {
|
|
354
|
+
"type": "NotificationTone",
|
|
355
|
+
"values": [
|
|
356
|
+
"info",
|
|
357
|
+
"success",
|
|
358
|
+
"warning",
|
|
359
|
+
"danger",
|
|
360
|
+
"neutral"
|
|
361
|
+
]
|
|
362
|
+
},
|
|
363
|
+
"icon": {
|
|
364
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
|
|
365
|
+
},
|
|
366
|
+
"title": {
|
|
367
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
368
|
+
"required": true
|
|
369
|
+
},
|
|
370
|
+
"description": {
|
|
371
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
|
|
372
|
+
},
|
|
373
|
+
"time": {
|
|
374
|
+
"type": "string | number | Date"
|
|
375
|
+
},
|
|
376
|
+
"state": {
|
|
377
|
+
"type": "NotificationState"
|
|
378
|
+
},
|
|
379
|
+
"children": {
|
|
380
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
381
|
+
"doc": "Contexto completo del aviso."
|
|
382
|
+
},
|
|
383
|
+
"onAcknowledge": {
|
|
384
|
+
"type": "() => void | Promise<void>"
|
|
385
|
+
},
|
|
386
|
+
"onResolve": {
|
|
387
|
+
"type": "(note: string) => void | Promise<void>"
|
|
388
|
+
},
|
|
389
|
+
"onRespond": {
|
|
390
|
+
"type": "(answer: \"accept\" | \"decline\") => void | Promise<void>"
|
|
391
|
+
},
|
|
392
|
+
"onSnooze": {
|
|
393
|
+
"type": "() => void | Promise<void>"
|
|
394
|
+
},
|
|
395
|
+
"className": {
|
|
396
|
+
"type": "string"
|
|
397
|
+
}
|
|
398
|
+
}
|
|
399
|
+
},
|
|
400
|
+
"presets": {
|
|
401
|
+
"values": [
|
|
402
|
+
"read",
|
|
403
|
+
"acknowledge",
|
|
404
|
+
"resolve",
|
|
405
|
+
"respond"
|
|
406
|
+
],
|
|
407
|
+
"default": "read",
|
|
408
|
+
"intent": {
|
|
409
|
+
"read": "solo lectura: Cerrar",
|
|
410
|
+
"acknowledge": "«Reconocer» (new → acknowledged) → onAcknowledge()",
|
|
411
|
+
"resolve": "nota opcional + «Marcar como resuelto» → onResolve(note)",
|
|
412
|
+
"respond": "«Rechazar» / «Aceptar» (+ «Más tarde» si hay onSnooze) → onRespond(\"accept\" | \"decline\")"
|
|
413
|
+
}
|
|
414
|
+
},
|
|
415
|
+
"notes": [
|
|
416
|
+
"Detalle de un aviso de la campana: pásale `onSelect` a NotificationItem y abre aquí el contexto completo. `acknowledge` para reconocer, `resolve` para cerrar con nota, `respond` para aceptar o rechazar una comunicación, `read` si solo se lee.",
|
|
417
|
+
"Canal según intención: toast confirma una acción; Alert avisa en una sección; Banner avisa en toda la página; campana + NoticeReview para lo que exige seguimiento; ConfirmAction/AlertDialog para lo que bloquea."
|
|
418
|
+
],
|
|
419
|
+
"examples": [
|
|
420
|
+
{
|
|
421
|
+
"title": "Reconocer un aviso (preset acknowledge)",
|
|
422
|
+
"code": "<NoticeReview\n open={open}\n onOpenChange={setOpen}\n preset=\"acknowledge\"\n tone=\"warning\"\n icon={<ServerCrashIcon />}\n title={notice.title}\n time={notice.createdAt}\n state=\"new\"\n onAcknowledge={() => acknowledge(notice.id)}\n>\n <p>{notice.body}</p>\n</NoticeReview>"
|
|
423
|
+
},
|
|
424
|
+
{
|
|
425
|
+
"title": "Resolver con nota, en panel lateral (preset resolve)",
|
|
426
|
+
"code": "<NoticeReview\n open={open}\n onOpenChange={setOpen}\n preset=\"resolve\"\n presentation=\"sheet\"\n title={notice.title}\n state=\"acknowledged\"\n onResolve={(note) => resolve(notice.id, note)}\n/>"
|
|
427
|
+
}
|
|
428
|
+
]
|
|
429
|
+
},
|
|
430
|
+
"notifications": {
|
|
431
|
+
"import": "orbital-ds/ui/notifications",
|
|
432
|
+
"group": "feedback",
|
|
433
|
+
"summary": "Centro de avisos: campana en la AppBar con un panel por pestañas (para ti, general, histórico); para asuntos con seguimiento o estado, no para confirmar acciones.",
|
|
434
|
+
"see": [
|
|
435
|
+
{
|
|
436
|
+
"component": "toast",
|
|
437
|
+
"when": "confirmar una acción recién hecha, sin seguimiento"
|
|
438
|
+
},
|
|
439
|
+
{
|
|
440
|
+
"component": "notice-review",
|
|
441
|
+
"when": "abrir el detalle de un aviso para reconocerlo, resolverlo o responder"
|
|
442
|
+
},
|
|
443
|
+
{
|
|
444
|
+
"component": "banner",
|
|
445
|
+
"when": "aviso de página visible sin abrir nada"
|
|
446
|
+
}
|
|
447
|
+
],
|
|
448
|
+
"exports": [
|
|
449
|
+
"NotificationCenter",
|
|
450
|
+
"NotificationEmpty",
|
|
451
|
+
"NotificationItem",
|
|
452
|
+
"NotificationList",
|
|
453
|
+
"NotificationTabs",
|
|
454
|
+
"NotificationTabsContent",
|
|
455
|
+
"formatRelativeTime",
|
|
456
|
+
"type NotificationCenterPreset",
|
|
457
|
+
"type NotificationIndicator",
|
|
458
|
+
"type NotificationState",
|
|
459
|
+
"type NotificationTab",
|
|
460
|
+
"type NotificationTone"
|
|
461
|
+
],
|
|
462
|
+
"slots": [
|
|
463
|
+
"notification-actions",
|
|
464
|
+
"notification-center",
|
|
465
|
+
"notification-count",
|
|
466
|
+
"notification-count-dot",
|
|
467
|
+
"notification-dot",
|
|
468
|
+
"notification-empty",
|
|
469
|
+
"notification-header",
|
|
470
|
+
"notification-icon",
|
|
471
|
+
"notification-item",
|
|
472
|
+
"notification-item-description",
|
|
473
|
+
"notification-item-title",
|
|
474
|
+
"notification-list",
|
|
475
|
+
"notification-mark-all",
|
|
476
|
+
"notification-meta",
|
|
477
|
+
"notification-select",
|
|
478
|
+
"notification-tab",
|
|
479
|
+
"notification-tab-count",
|
|
480
|
+
"notification-tabs",
|
|
481
|
+
"notification-tabs-content",
|
|
482
|
+
"notification-title",
|
|
483
|
+
"notification-trigger",
|
|
484
|
+
"notification-unread"
|
|
485
|
+
],
|
|
486
|
+
"optionalPeers": [],
|
|
487
|
+
"props": {
|
|
488
|
+
"NotificationCenter": {
|
|
489
|
+
"preset": {
|
|
490
|
+
"type": "NotificationCenterPreset",
|
|
491
|
+
"values": [
|
|
492
|
+
"compact",
|
|
493
|
+
"count",
|
|
494
|
+
"dot"
|
|
495
|
+
]
|
|
496
|
+
},
|
|
497
|
+
"indicator": {
|
|
498
|
+
"type": "NotificationIndicator",
|
|
499
|
+
"values": [
|
|
500
|
+
"none",
|
|
501
|
+
"count",
|
|
502
|
+
"dot"
|
|
503
|
+
],
|
|
504
|
+
"doc": "Cómo se anuncian los avisos sin leer sobre la campana."
|
|
505
|
+
},
|
|
506
|
+
"density": {
|
|
507
|
+
"type": "\"default\" | \"compact\"",
|
|
508
|
+
"values": [
|
|
509
|
+
"default",
|
|
510
|
+
"compact"
|
|
511
|
+
],
|
|
512
|
+
"doc": "Ancho del panel: default (--ds-notifications-w) o compact."
|
|
513
|
+
},
|
|
514
|
+
"tone": {
|
|
515
|
+
"type": "HeaderControlTone",
|
|
516
|
+
"values": [
|
|
517
|
+
"brand",
|
|
518
|
+
"soft",
|
|
519
|
+
"neutral"
|
|
520
|
+
],
|
|
521
|
+
"doc": "Color de la campana: neutral, con la marca o con fondo suave."
|
|
522
|
+
},
|
|
523
|
+
"unreadCount": {
|
|
524
|
+
"type": "number",
|
|
525
|
+
"doc": "Avisos sin leer: contador de la campana y nombre accesible."
|
|
526
|
+
},
|
|
527
|
+
"onMarkAllRead": {
|
|
528
|
+
"type": "() => void",
|
|
529
|
+
"doc": "Si se pasa, la cabecera muestra «Marcar todo como leído»."
|
|
530
|
+
},
|
|
531
|
+
"title": {
|
|
532
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
533
|
+
"doc": "Título del panel; por defecto, «Notificaciones»."
|
|
534
|
+
},
|
|
535
|
+
"open": {
|
|
536
|
+
"type": "boolean"
|
|
537
|
+
},
|
|
538
|
+
"defaultOpen": {
|
|
539
|
+
"type": "boolean"
|
|
540
|
+
},
|
|
541
|
+
"onOpenChange": {
|
|
542
|
+
"type": "(open: boolean) => void"
|
|
543
|
+
},
|
|
544
|
+
"align": {
|
|
545
|
+
"type": "\"center\" | \"start\" | \"end\"",
|
|
546
|
+
"values": [
|
|
547
|
+
"center",
|
|
548
|
+
"start",
|
|
549
|
+
"end"
|
|
550
|
+
]
|
|
551
|
+
},
|
|
552
|
+
"className": {
|
|
553
|
+
"type": "string",
|
|
554
|
+
"doc": "Clases del panel."
|
|
555
|
+
},
|
|
556
|
+
"triggerClassName": {
|
|
557
|
+
"type": "string",
|
|
558
|
+
"doc": "Clases del botón campana."
|
|
559
|
+
},
|
|
560
|
+
"children": {
|
|
561
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
|
|
562
|
+
}
|
|
563
|
+
},
|
|
564
|
+
"NotificationEmpty": {
|
|
565
|
+
"icon": {
|
|
566
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
|
|
567
|
+
}
|
|
568
|
+
},
|
|
569
|
+
"NotificationItem": {
|
|
570
|
+
"onSelect": {
|
|
571
|
+
"type": "() => void",
|
|
572
|
+
"doc": "Si existe, el aviso se puede abrir (p. ej. en NoticeReview): el título pasa a ser un botón que cubre la fila."
|
|
573
|
+
},
|
|
574
|
+
"unread": {
|
|
575
|
+
"type": "boolean",
|
|
576
|
+
"doc": "Sin leer: punto de marca y fondo resaltado."
|
|
577
|
+
},
|
|
578
|
+
"tone": {
|
|
579
|
+
"type": "NotificationTone",
|
|
580
|
+
"values": [
|
|
581
|
+
"info",
|
|
582
|
+
"success",
|
|
583
|
+
"warning",
|
|
584
|
+
"danger",
|
|
585
|
+
"neutral"
|
|
586
|
+
],
|
|
587
|
+
"doc": "Tono de estado: colorea la baldosa del icono."
|
|
588
|
+
},
|
|
589
|
+
"icon": {
|
|
590
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
591
|
+
"doc": "Icono (Lucide) dentro de una baldosa del tono; o un nodo propio."
|
|
592
|
+
},
|
|
593
|
+
"title": {
|
|
594
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
595
|
+
"required": true
|
|
596
|
+
},
|
|
597
|
+
"description": {
|
|
598
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
|
|
599
|
+
},
|
|
600
|
+
"time": {
|
|
601
|
+
"type": "string | number | Date",
|
|
602
|
+
"doc": "Momento del aviso: se muestra en tiempo relativo."
|
|
603
|
+
},
|
|
604
|
+
"now": {
|
|
605
|
+
"type": "number",
|
|
606
|
+
"doc": "«Ahora» para el tiempo relativo (pruebas, SSR)."
|
|
607
|
+
},
|
|
608
|
+
"state": {
|
|
609
|
+
"type": "NotificationState",
|
|
610
|
+
"doc": "Estado del aviso (new | acknowledged | resolved…): va a `data-state`."
|
|
611
|
+
},
|
|
612
|
+
"meta": {
|
|
613
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
614
|
+
"doc": "Etiquetas junto a la hora (p. ej. un Badge con el estado)."
|
|
615
|
+
},
|
|
616
|
+
"actions": {
|
|
617
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
618
|
+
"doc": "Acciones del aviso (botones «Útil», «Ruido», «Investigar»…)."
|
|
619
|
+
}
|
|
620
|
+
},
|
|
621
|
+
"NotificationList": {
|
|
622
|
+
"empty": {
|
|
623
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
624
|
+
"doc": "Qué pintar sin avisos; por defecto, `<NotificationEmpty />`."
|
|
625
|
+
}
|
|
626
|
+
},
|
|
627
|
+
"NotificationTabs": {
|
|
628
|
+
"counts": {
|
|
629
|
+
"type": "{ forYou?: number; general?: number; history?: number; }",
|
|
630
|
+
"doc": "Contadores de cada pestaña (se omiten los que no se pasan o valen 0)."
|
|
631
|
+
},
|
|
632
|
+
"defaultValue": {
|
|
633
|
+
"type": "NotificationTab",
|
|
634
|
+
"values": [
|
|
635
|
+
"history",
|
|
636
|
+
"for-you",
|
|
637
|
+
"general"
|
|
638
|
+
]
|
|
639
|
+
}
|
|
640
|
+
},
|
|
641
|
+
"NotificationTabsContent": {
|
|
642
|
+
"value": {
|
|
643
|
+
"type": "NotificationTab",
|
|
644
|
+
"required": true,
|
|
645
|
+
"values": [
|
|
646
|
+
"history",
|
|
647
|
+
"for-you",
|
|
648
|
+
"general"
|
|
649
|
+
]
|
|
650
|
+
}
|
|
651
|
+
}
|
|
652
|
+
},
|
|
653
|
+
"presets": {
|
|
654
|
+
"values": [
|
|
655
|
+
"count",
|
|
656
|
+
"dot",
|
|
657
|
+
"compact"
|
|
658
|
+
],
|
|
659
|
+
"default": "count",
|
|
660
|
+
"intent": {
|
|
661
|
+
"count": "contador numérico sobre la campana, panel normal (por defecto)",
|
|
662
|
+
"dot": "solo un punto: avisos poco frecuentes, barra discreta",
|
|
663
|
+
"compact": "contador y panel estrecho (--ds-notifications-w-compact): barras bajas, móvil"
|
|
664
|
+
}
|
|
665
|
+
},
|
|
666
|
+
"notes": [
|
|
667
|
+
"Un solo centro por app, en AppBarActions junto a LocaleSwitcher y ThemeToggle; `dot` si los avisos son raros, `compact` en móvil."
|
|
668
|
+
],
|
|
669
|
+
"examples": [
|
|
670
|
+
{
|
|
671
|
+
"title": "Campana con lista (preset count)",
|
|
672
|
+
"code": "<NotificationCenter unreadCount={unread} onMarkAllRead={markAllRead}>\n <NotificationList>\n {notices.map((n) => (\n <NotificationItem\n key={n.id}\n unread={n.unread}\n tone={n.tone}\n title={n.title}\n time={n.createdAt}\n state={n.state}\n onSelect={() => openReview(n)}\n />\n ))}\n </NotificationList>\n</NotificationCenter>"
|
|
673
|
+
},
|
|
674
|
+
{
|
|
675
|
+
"title": "Con pestañas y solo un punto (preset dot)",
|
|
676
|
+
"code": "<NotificationCenter preset=\"dot\" unreadCount={unread}>\n <NotificationTabs counts={{ forYou: 3, general: 1 }}>\n <NotificationTabsContent value=\"for-you\">\n <NotificationList>{forYou}</NotificationList>\n </NotificationTabsContent>\n <NotificationTabsContent value=\"general\">\n <NotificationList>{general}</NotificationList>\n </NotificationTabsContent>\n </NotificationTabs>\n</NotificationCenter>"
|
|
677
|
+
}
|
|
678
|
+
]
|
|
679
|
+
},
|
|
680
|
+
"progress": {
|
|
681
|
+
"import": "orbital-ds/ui/progress",
|
|
682
|
+
"group": "feedback",
|
|
683
|
+
"summary": "Barra de avance de una tarea con porcentaje conocido (subida, importación, pasos hechos); `tone` del vocabulario común si el avance significa algo.",
|
|
684
|
+
"see": [
|
|
685
|
+
{
|
|
686
|
+
"component": "usage-meter",
|
|
687
|
+
"when": "consumo frente a un límite contratado (avisa al 80 % y al 100 %)"
|
|
688
|
+
},
|
|
689
|
+
{
|
|
690
|
+
"component": "task-progress",
|
|
691
|
+
"when": "avance de un proceso con estado (en curso, terminado, error) y etiqueta"
|
|
692
|
+
},
|
|
693
|
+
{
|
|
694
|
+
"component": "spinner",
|
|
695
|
+
"when": "espera breve sin porcentaje"
|
|
696
|
+
}
|
|
697
|
+
],
|
|
698
|
+
"exports": [
|
|
699
|
+
"Progress"
|
|
700
|
+
],
|
|
701
|
+
"slots": [
|
|
702
|
+
"progress",
|
|
703
|
+
"progress-indicator",
|
|
704
|
+
"progress-track"
|
|
705
|
+
],
|
|
706
|
+
"optionalPeers": [],
|
|
707
|
+
"props": {
|
|
708
|
+
"Progress": {
|
|
709
|
+
"tone": {
|
|
710
|
+
"type": "DsDataTone",
|
|
711
|
+
"values": [
|
|
712
|
+
"info",
|
|
713
|
+
"success",
|
|
714
|
+
"warning",
|
|
715
|
+
"danger",
|
|
716
|
+
"primary",
|
|
717
|
+
"neutral",
|
|
718
|
+
"chart-1",
|
|
719
|
+
"chart-2",
|
|
720
|
+
"chart-3",
|
|
721
|
+
"chart-4",
|
|
722
|
+
"chart-5"
|
|
723
|
+
]
|
|
724
|
+
}
|
|
725
|
+
}
|
|
726
|
+
},
|
|
727
|
+
"notes": [
|
|
728
|
+
"Solo con porcentaje real; si no se conoce, Spinner (espera breve) o Skeleton (forma del contenido).",
|
|
729
|
+
"Uso frente a un límite (almacenamiento, licencias) es UsageMeter, nunca una Progress a mano."
|
|
730
|
+
],
|
|
731
|
+
"examples": [
|
|
732
|
+
{
|
|
733
|
+
"title": "Subida en curso",
|
|
734
|
+
"code": "<Progress value={uploaded} aria-label={t(\"upload.progress\")} />"
|
|
735
|
+
},
|
|
736
|
+
{
|
|
737
|
+
"title": "Con tono",
|
|
738
|
+
"code": "<Progress value={92} tone=\"warning\" aria-label={t(\"quota.progress\")} />"
|
|
739
|
+
}
|
|
740
|
+
]
|
|
741
|
+
},
|
|
742
|
+
"skeleton": {
|
|
743
|
+
"import": "orbital-ds/ui/skeleton",
|
|
744
|
+
"group": "feedback",
|
|
745
|
+
"summary": "Bloque de relleno con la forma del contenido mientras carga (líneas, avatar, tarjeta), para la carga inicial de una vista o sección.",
|
|
746
|
+
"see": [
|
|
747
|
+
{
|
|
748
|
+
"component": "loading-state",
|
|
749
|
+
"when": "esqueletos ya montados por preset (list · card · table · detail)"
|
|
750
|
+
},
|
|
751
|
+
{
|
|
752
|
+
"component": "spinner",
|
|
753
|
+
"when": "espera breve dentro de un botón o control"
|
|
754
|
+
},
|
|
755
|
+
{
|
|
756
|
+
"component": "page-loader",
|
|
757
|
+
"when": "carga de una ruta o de toda la app"
|
|
758
|
+
}
|
|
759
|
+
],
|
|
760
|
+
"exports": [
|
|
761
|
+
"Skeleton",
|
|
762
|
+
"skeletonVariants"
|
|
763
|
+
],
|
|
764
|
+
"slots": [
|
|
765
|
+
"skeleton"
|
|
766
|
+
],
|
|
767
|
+
"optionalPeers": [],
|
|
768
|
+
"props": {
|
|
769
|
+
"Skeleton": {
|
|
770
|
+
"variant": {
|
|
771
|
+
"type": "\"default\" | \"shimmer\"",
|
|
772
|
+
"values": [
|
|
773
|
+
"default",
|
|
774
|
+
"shimmer"
|
|
775
|
+
]
|
|
776
|
+
}
|
|
777
|
+
}
|
|
778
|
+
},
|
|
779
|
+
"notes": [
|
|
780
|
+
"Cargando: Skeleton con la forma del contenido, no un spinner a pantalla completa.",
|
|
781
|
+
"`variant=\"shimmer\"` pasa un brillo por el bloque (ritmo `--ds-motion-shimmer`, quieto con movimiento reducido); el `default` late. Úsalo en tarjetas y bloques grandes."
|
|
782
|
+
],
|
|
783
|
+
"examples": [
|
|
784
|
+
{
|
|
785
|
+
"title": "Fila de lista cargando",
|
|
786
|
+
"code": "<div className=\"flex items-center gap-3\">\n <Skeleton className=\"size-10 rounded-full\" />\n <Skeleton className=\"h-4 w-48\" />\n</div>"
|
|
787
|
+
},
|
|
788
|
+
{
|
|
789
|
+
"title": "Bloque grande con brillo",
|
|
790
|
+
"code": "<Skeleton variant=\"shimmer\" className=\"h-32 w-full\" />"
|
|
791
|
+
}
|
|
792
|
+
]
|
|
793
|
+
},
|
|
794
|
+
"sonner": {
|
|
795
|
+
"import": "orbital-ds/ui/sonner",
|
|
796
|
+
"group": "feedback",
|
|
797
|
+
"summary": "COMPATIBILIDAD: Toaster de la librería sonner (con next-themes) para apps que ya lo usan; lo nuevo va con Toaster de `toast` (Base UI, el oficial).",
|
|
798
|
+
"see": [
|
|
799
|
+
{
|
|
800
|
+
"component": "toast",
|
|
801
|
+
"when": "el canal OFICIAL de avisos efímeros (Base UI, sin dependencias), con `toast.add(...)`"
|
|
802
|
+
},
|
|
803
|
+
{
|
|
804
|
+
"component": "alert",
|
|
805
|
+
"when": "aviso que debe quedarse visible en la sección"
|
|
806
|
+
},
|
|
807
|
+
{
|
|
808
|
+
"component": "notifications",
|
|
809
|
+
"when": "asunto con seguimiento (campana)"
|
|
810
|
+
}
|
|
811
|
+
],
|
|
812
|
+
"exports": [
|
|
813
|
+
"Toaster"
|
|
814
|
+
],
|
|
815
|
+
"slots": [],
|
|
816
|
+
"optionalPeers": [
|
|
817
|
+
"next-themes",
|
|
818
|
+
"sonner"
|
|
819
|
+
],
|
|
820
|
+
"notes": [
|
|
821
|
+
"Un solo Toaster en la raíz; `toast` se importa de `sonner`. Necesita `sonner` y `next-themes` instalados.",
|
|
822
|
+
"Elige un canal de toasts para toda la app: este Toaster o el de `toast` (Base UI), no los dos.",
|
|
823
|
+
"OBSOLETO: se retirará en la próxima versión que rompa compatibilidad; migra a `toast` (Base UI). El doctor (`--ui`) avisa de cada import."
|
|
824
|
+
],
|
|
825
|
+
"examples": [
|
|
826
|
+
{
|
|
827
|
+
"title": "Montaje en la raíz y confirmación con «Deshacer» (toast se importa de sonner)",
|
|
828
|
+
"code": "<Toaster richColors closeButton />\n<Button\n onClick={() => toast(\"Contacto archivado\", { action: { label: \"Deshacer\", onClick: restore } })}\n>\n Archivar\n</Button>"
|
|
829
|
+
}
|
|
830
|
+
]
|
|
831
|
+
},
|
|
832
|
+
"spinner": {
|
|
833
|
+
"import": "orbital-ds/ui/spinner",
|
|
834
|
+
"group": "feedback",
|
|
835
|
+
"summary": "Indicador giratorio de espera breve sin porcentaje, dentro de un botón o control (guardando, enviando); anuncia «Cargando» a los lectores de pantalla.",
|
|
836
|
+
"see": [
|
|
837
|
+
{
|
|
838
|
+
"component": "skeleton",
|
|
839
|
+
"when": "carga de contenido con su forma (listas, tarjetas)"
|
|
840
|
+
},
|
|
841
|
+
{
|
|
842
|
+
"component": "progress",
|
|
843
|
+
"when": "avance con porcentaje conocido"
|
|
844
|
+
},
|
|
845
|
+
{
|
|
846
|
+
"component": "page-loader",
|
|
847
|
+
"when": "carga de una ruta o de toda la app"
|
|
848
|
+
}
|
|
849
|
+
],
|
|
850
|
+
"exports": [
|
|
851
|
+
"Spinner"
|
|
852
|
+
],
|
|
853
|
+
"slots": [
|
|
854
|
+
"spinner"
|
|
855
|
+
],
|
|
856
|
+
"optionalPeers": [],
|
|
857
|
+
"notes": [
|
|
858
|
+
"Nunca a pantalla completa para cargar contenido: Skeleton o LoadingState; para rutas, PageLoader.",
|
|
859
|
+
"Dentro de un botón, desactívalo mientras dura la espera para no repetir la acción."
|
|
860
|
+
],
|
|
861
|
+
"examples": [
|
|
862
|
+
{
|
|
863
|
+
"title": "En un botón mientras guarda",
|
|
864
|
+
"code": "<Button disabled={saving} onClick={save}>\n {saving ? <Spinner /> : null}\n Guardar\n</Button>"
|
|
865
|
+
},
|
|
866
|
+
{
|
|
867
|
+
"title": "Suelto, más grande",
|
|
868
|
+
"code": "<Spinner className=\"size-6\" />"
|
|
869
|
+
}
|
|
870
|
+
]
|
|
871
|
+
},
|
|
872
|
+
"task-loader": {
|
|
873
|
+
"import": "orbital-ds/ui/task-loader",
|
|
874
|
+
"group": "feedback",
|
|
875
|
+
"summary": "Carga ilustrada de una tarea larga (analizar el correo, escanear dispositivos): ilustración, barra fina y brillo al terminar; con `value` muestra avance, sin él es indeterminada.",
|
|
876
|
+
"see": [
|
|
877
|
+
{
|
|
878
|
+
"component": "task-progress",
|
|
879
|
+
"when": "avance de un proceso con etiqueta, contador y estado, sin ilustración"
|
|
880
|
+
},
|
|
881
|
+
{
|
|
882
|
+
"component": "progress",
|
|
883
|
+
"when": "barra de avance simple dentro de un formulario o lista"
|
|
884
|
+
},
|
|
885
|
+
{
|
|
886
|
+
"component": "page-loader",
|
|
887
|
+
"when": "carga de una ruta o de toda la app"
|
|
888
|
+
}
|
|
889
|
+
],
|
|
890
|
+
"exports": [
|
|
891
|
+
"TaskLoader"
|
|
892
|
+
],
|
|
893
|
+
"slots": [
|
|
894
|
+
"task-loader",
|
|
895
|
+
"task-loader-fill",
|
|
896
|
+
"task-loader-icon",
|
|
897
|
+
"task-loader-track"
|
|
898
|
+
],
|
|
899
|
+
"optionalPeers": [],
|
|
900
|
+
"props": {
|
|
901
|
+
"TaskLoader": {
|
|
902
|
+
"icon": {
|
|
903
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
904
|
+
"required": true,
|
|
905
|
+
"doc": "Ilustración (decorativa)."
|
|
906
|
+
},
|
|
907
|
+
"value": {
|
|
908
|
+
"type": "number",
|
|
909
|
+
"doc": "Avance 0–100. Sin valor, indeterminado."
|
|
910
|
+
},
|
|
911
|
+
"state": {
|
|
912
|
+
"type": "TaskLoaderState",
|
|
913
|
+
"values": [
|
|
914
|
+
"done",
|
|
915
|
+
"running"
|
|
916
|
+
]
|
|
917
|
+
},
|
|
918
|
+
"label": {
|
|
919
|
+
"type": "string",
|
|
920
|
+
"doc": "Texto del estado para lectores de pantalla."
|
|
921
|
+
}
|
|
922
|
+
}
|
|
923
|
+
},
|
|
924
|
+
"notes": [
|
|
925
|
+
"La ilustración la pone la app y es decorativa; `label` describe el estado para lectores de pantalla y cambia al terminar."
|
|
926
|
+
],
|
|
927
|
+
"examples": [
|
|
928
|
+
{
|
|
929
|
+
"title": "Con avance conocido",
|
|
930
|
+
"code": "<TaskLoader icon={<MailIllustration />} value={40} label=\"Analizando el correo\" />"
|
|
931
|
+
},
|
|
932
|
+
{
|
|
933
|
+
"title": "Indeterminado",
|
|
934
|
+
"code": "<TaskLoader icon={<MailIllustration />} label=\"Analizando…\" />"
|
|
935
|
+
},
|
|
936
|
+
{
|
|
937
|
+
"title": "Terminado",
|
|
938
|
+
"code": "<TaskLoader icon={<CheckIllustration />} state=\"done\" label=\"Análisis completado\" />"
|
|
939
|
+
}
|
|
940
|
+
]
|
|
941
|
+
},
|
|
942
|
+
"toast": {
|
|
943
|
+
"import": "orbital-ds/ui/toast",
|
|
944
|
+
"group": "feedback",
|
|
945
|
+
"summary": "Aviso efímero que confirma una acción recién hecha («Cliente creado»), con «Deshacer» si aplica; Base UI sin dependencias, lanzado con `toast.add({...})` desde cualquier sitio.",
|
|
946
|
+
"see": [
|
|
947
|
+
{
|
|
948
|
+
"component": "sonner",
|
|
949
|
+
"when": "solo si la app ya usa la librería sonner (compatibilidad)"
|
|
950
|
+
},
|
|
951
|
+
{
|
|
952
|
+
"component": "alert",
|
|
953
|
+
"when": "aviso que debe quedarse visible en la sección"
|
|
954
|
+
},
|
|
955
|
+
{
|
|
956
|
+
"component": "notifications",
|
|
957
|
+
"when": "asunto con seguimiento o decisión (campana)"
|
|
958
|
+
}
|
|
959
|
+
],
|
|
960
|
+
"exports": [
|
|
961
|
+
"Toast",
|
|
962
|
+
"ToastAction",
|
|
963
|
+
"ToastClose",
|
|
964
|
+
"ToastContent",
|
|
965
|
+
"ToastDescription",
|
|
966
|
+
"ToastPortal",
|
|
967
|
+
"ToastProvider",
|
|
968
|
+
"ToastTitle",
|
|
969
|
+
"ToastViewport",
|
|
970
|
+
"Toaster",
|
|
971
|
+
"createToastManager",
|
|
972
|
+
"toast",
|
|
973
|
+
"useToastManager"
|
|
974
|
+
],
|
|
975
|
+
"slots": [
|
|
976
|
+
"toast",
|
|
977
|
+
"toast-action",
|
|
978
|
+
"toast-close",
|
|
979
|
+
"toast-content",
|
|
980
|
+
"toast-description",
|
|
981
|
+
"toast-icon",
|
|
982
|
+
"toast-portal",
|
|
983
|
+
"toast-text",
|
|
984
|
+
"toast-title",
|
|
985
|
+
"toast-viewport"
|
|
986
|
+
],
|
|
987
|
+
"optionalPeers": [],
|
|
988
|
+
"notes": [
|
|
989
|
+
"Es el canal OFICIAL de toasts de orbital-ds: mismo motor que el resto (Base UI), textos por useDsMessages y sin dependencias.",
|
|
990
|
+
"Un solo Toaster en la raíz de la app; `toast` es el gestor por defecto y sirve también fuera de React.",
|
|
991
|
+
"Un error que la persona debe leer y corregir no va en un toast: Alert en la sección o FieldError junto al campo."
|
|
992
|
+
],
|
|
993
|
+
"examples": [
|
|
994
|
+
{
|
|
995
|
+
"title": "Montaje en la raíz y confirmación",
|
|
996
|
+
"code": "<Toaster>\n <Button onClick={() => toast.add({ type: \"success\", title: \"Cliente creado\" })}>Crear cliente</Button>\n</Toaster>"
|
|
997
|
+
},
|
|
998
|
+
{
|
|
999
|
+
"title": "Con «Deshacer»",
|
|
1000
|
+
"code": "<Toaster>\n <Button\n onClick={() =>\n toast.add({ title: \"Contacto archivado\", actionProps: { children: \"Deshacer\", onClick: restore } })\n }\n >\n Archivar\n </Button>\n</Toaster>"
|
|
1001
|
+
}
|
|
1002
|
+
]
|
|
1003
|
+
}
|
|
1004
|
+
}
|
|
1005
|
+
}
|