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,196 @@
|
|
|
1
|
+
{
|
|
2
|
+
"package": "orbital-ds",
|
|
3
|
+
"version": "0.48.0",
|
|
4
|
+
"group": "motion",
|
|
5
|
+
"about": "Animación y cargadores de página.",
|
|
6
|
+
"components": {
|
|
7
|
+
"motion-provider": {
|
|
8
|
+
"import": "orbital-ds/ui/motion-provider",
|
|
9
|
+
"group": "motion",
|
|
10
|
+
"summary": "Proveedor raíz que da a toda animación de Motion la duración y la curva del tema activo y respeta el movimiento reducido; solo si la app usa Motion.",
|
|
11
|
+
"see": [
|
|
12
|
+
{
|
|
13
|
+
"component": "reveal",
|
|
14
|
+
"when": "mostrar contenido al entrar en pantalla con CSS, sin Motion"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"component": "page-loader",
|
|
18
|
+
"when": "indicador de carga con el ritmo del tema"
|
|
19
|
+
}
|
|
20
|
+
],
|
|
21
|
+
"exports": [
|
|
22
|
+
"DsMotionProvider"
|
|
23
|
+
],
|
|
24
|
+
"slots": [],
|
|
25
|
+
"optionalPeers": [
|
|
26
|
+
"motion"
|
|
27
|
+
],
|
|
28
|
+
"props": {
|
|
29
|
+
"DsMotionProvider": {
|
|
30
|
+
"children": {
|
|
31
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
32
|
+
"required": true
|
|
33
|
+
},
|
|
34
|
+
"duration": {
|
|
35
|
+
"type": "\"base\" | \"fast\" | \"slow\" | \"snap\" | \"layout\" | \"swipe\" | \"slower\"",
|
|
36
|
+
"values": [
|
|
37
|
+
"base",
|
|
38
|
+
"fast",
|
|
39
|
+
"slow",
|
|
40
|
+
"snap",
|
|
41
|
+
"layout",
|
|
42
|
+
"swipe",
|
|
43
|
+
"slower"
|
|
44
|
+
]
|
|
45
|
+
},
|
|
46
|
+
"ease": {
|
|
47
|
+
"type": "\"enter\" | \"standard\" | \"emphasized\" | \"exit\" | \"overshoot\" | \"panel\" | \"collapse\"",
|
|
48
|
+
"values": [
|
|
49
|
+
"enter",
|
|
50
|
+
"standard",
|
|
51
|
+
"emphasized",
|
|
52
|
+
"exit",
|
|
53
|
+
"overshoot",
|
|
54
|
+
"panel",
|
|
55
|
+
"collapse"
|
|
56
|
+
]
|
|
57
|
+
},
|
|
58
|
+
"reducedMotion": {
|
|
59
|
+
"type": "\"always\" | \"user\" | \"never\"",
|
|
60
|
+
"values": [
|
|
61
|
+
"always",
|
|
62
|
+
"user",
|
|
63
|
+
"never"
|
|
64
|
+
]
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
},
|
|
68
|
+
"notes": [
|
|
69
|
+
"Una sola vez en la raíz; los presets del tema se piden con useDsMotion() y se aplican con `render={<motion.div {...m.fadeUp} />}`.",
|
|
70
|
+
"Motion es opcional: los componentes del paquete animan con CSS y no necesitan este proveedor."
|
|
71
|
+
],
|
|
72
|
+
"examples": [
|
|
73
|
+
{
|
|
74
|
+
"title": "En la raíz de la app",
|
|
75
|
+
"code": "<DsMotionProvider>\n <App />\n</DsMotionProvider>"
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"title": "Ritmo más lento por defecto",
|
|
79
|
+
"code": "<DsMotionProvider duration=\"slow\" ease=\"emphasized\">\n <App />\n</DsMotionProvider>"
|
|
80
|
+
}
|
|
81
|
+
]
|
|
82
|
+
},
|
|
83
|
+
"page-loader": {
|
|
84
|
+
"import": "orbital-ds/ui/page-loader",
|
|
85
|
+
"group": "motion",
|
|
86
|
+
"summary": "Indicador de carga con intención: arranque de la app (`splash`), cambio de ruta (`route`), una región (`section`) o proceso sobre contenido (`overlay`); no imita el contenido.",
|
|
87
|
+
"see": [
|
|
88
|
+
{
|
|
89
|
+
"component": "loading-state",
|
|
90
|
+
"when": "esqueleto con la forma del contenido que carga"
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
"component": "spinner",
|
|
94
|
+
"when": "carga pequeña dentro de un botón o una línea"
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"component": "task-loader",
|
|
98
|
+
"when": "tarea larga con ilustración"
|
|
99
|
+
}
|
|
100
|
+
],
|
|
101
|
+
"exports": [
|
|
102
|
+
"PageLoader",
|
|
103
|
+
"type PageLoaderIndicator",
|
|
104
|
+
"type PageLoaderPreset"
|
|
105
|
+
],
|
|
106
|
+
"slots": [
|
|
107
|
+
"page-loader",
|
|
108
|
+
"page-loader-mark",
|
|
109
|
+
"page-loader-message",
|
|
110
|
+
"page-loader-progress"
|
|
111
|
+
],
|
|
112
|
+
"optionalPeers": [],
|
|
113
|
+
"props": {
|
|
114
|
+
"PageLoader": {
|
|
115
|
+
"preset": {
|
|
116
|
+
"type": "PageLoaderPreset",
|
|
117
|
+
"values": [
|
|
118
|
+
"section",
|
|
119
|
+
"splash",
|
|
120
|
+
"route",
|
|
121
|
+
"overlay"
|
|
122
|
+
]
|
|
123
|
+
},
|
|
124
|
+
"indicator": {
|
|
125
|
+
"type": "PageLoaderIndicator",
|
|
126
|
+
"values": [
|
|
127
|
+
"orbit",
|
|
128
|
+
"pulse",
|
|
129
|
+
"bars"
|
|
130
|
+
]
|
|
131
|
+
},
|
|
132
|
+
"message": {
|
|
133
|
+
"type": "string",
|
|
134
|
+
"doc": "Texto fijo bajo el indicador."
|
|
135
|
+
},
|
|
136
|
+
"messages": {
|
|
137
|
+
"type": "string[]",
|
|
138
|
+
"doc": "Varios textos que rotan (cargas largas: «Conectando…», «Preparando tu espacio…»)."
|
|
139
|
+
},
|
|
140
|
+
"interval": {
|
|
141
|
+
"type": "number",
|
|
142
|
+
"doc": "Milisegundos entre mensajes."
|
|
143
|
+
},
|
|
144
|
+
"value": {
|
|
145
|
+
"type": "number",
|
|
146
|
+
"doc": "Avance 0–100. Sin valor, indeterminado."
|
|
147
|
+
},
|
|
148
|
+
"mark": {
|
|
149
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
150
|
+
"doc": "Marca o logo (preset splash)."
|
|
151
|
+
},
|
|
152
|
+
"delay": {
|
|
153
|
+
"type": "number",
|
|
154
|
+
"doc": "Milisegundos antes de mostrarse; evita el parpadeo en cargas cortas."
|
|
155
|
+
},
|
|
156
|
+
"className": {
|
|
157
|
+
"type": "string"
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
},
|
|
161
|
+
"presets": {
|
|
162
|
+
"values": [
|
|
163
|
+
"splash",
|
|
164
|
+
"route",
|
|
165
|
+
"section",
|
|
166
|
+
"overlay"
|
|
167
|
+
],
|
|
168
|
+
"default": "section",
|
|
169
|
+
"intent": {
|
|
170
|
+
"splash": "arranque de la app: pantalla completa, marca, indicador, mensajes y avance",
|
|
171
|
+
"route": "navegación entre rutas: barra fina fija arriba, no bloquea ni tapa nada",
|
|
172
|
+
"section": "una región que carga: centrado en su hueco, con altura mínima",
|
|
173
|
+
"overlay": "procesando sobre contenido existente: velo con desenfoque que bloquea el área"
|
|
174
|
+
}
|
|
175
|
+
},
|
|
176
|
+
"notes": [
|
|
177
|
+
"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.",
|
|
178
|
+
"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."
|
|
179
|
+
],
|
|
180
|
+
"examples": [
|
|
181
|
+
{
|
|
182
|
+
"title": "Una región que carga",
|
|
183
|
+
"code": "<PageLoader preset=\"section\" message={t(\"loadingData\")} />"
|
|
184
|
+
},
|
|
185
|
+
{
|
|
186
|
+
"title": "Arranque de la app con marca y mensajes",
|
|
187
|
+
"code": "<PageLoader preset=\"splash\" mark={<Logo />} messages={[t(\"connecting\"), t(\"preparing\")]} />"
|
|
188
|
+
},
|
|
189
|
+
{
|
|
190
|
+
"title": "Procesando sobre contenido",
|
|
191
|
+
"code": "<div className=\"relative\">\n <InvoiceList />\n <PageLoader preset=\"overlay\" />\n</div>"
|
|
192
|
+
}
|
|
193
|
+
]
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
}
|