orbital-ds 0.41.0 → 0.44.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +28 -9
- package/components.manifest.json +6469 -3569
- package/dist/auth-form-B1hgbXkI.d.ts +144 -0
- package/dist/hooks/use-ds-messages.d.ts +7 -0
- package/dist/lib/format.d.ts +57 -0
- package/dist/lib/format.js +177 -0
- package/dist/lib/i18n.d.ts +14 -2
- package/dist/lib/i18n.js +32 -2
- package/dist/lib/locales/de.d.ts +7 -0
- package/dist/lib/locales/de.js +535 -0
- package/dist/lib/locales/fr.d.ts +7 -0
- package/dist/lib/locales/fr.js +535 -0
- package/dist/lib/locales/he.d.ts +7 -0
- package/dist/lib/locales/he.js +535 -0
- package/dist/lib/locales/it.d.ts +7 -0
- package/dist/lib/locales/it.js +535 -0
- package/dist/styles.css +39 -1
- package/dist/ui/a2ui-renderer.d.ts +11 -0
- package/dist/ui/agent-events.d.ts +17 -0
- package/dist/ui/ai-tag.d.ts +16 -0
- package/dist/ui/alert-dialog.d.ts +37 -0
- package/dist/ui/alert.d.ts +1 -1
- package/dist/ui/animated-number.d.ts +11 -0
- package/dist/ui/app-bar.d.ts +22 -0
- package/dist/ui/attachment.d.ts +3 -3
- package/dist/ui/auth-backdrop.d.ts +17 -0
- package/dist/ui/auth-form.d.ts +3 -112
- package/dist/ui/auth-form.js +13 -6
- package/dist/ui/auth-layout.d.ts +38 -0
- package/dist/ui/avatar.d.ts +27 -0
- package/dist/ui/ayuda.d.ts +1 -1
- package/dist/ui/ayuda.js +4 -1
- package/dist/ui/banner.d.ts +1 -1
- package/dist/ui/bottom-nav.d.ts +22 -0
- package/dist/ui/breadcrumb.d.ts +22 -0
- package/dist/ui/breadcrumb.js +1 -1
- package/dist/ui/bubble.d.ts +1 -1
- package/dist/ui/button-group.d.ts +1 -1
- package/dist/ui/button.d.ts +2 -2
- package/dist/ui/calendar.d.ts +13 -0
- package/dist/ui/calendar.js +3 -0
- package/dist/ui/card-stack.d.ts +27 -0
- package/dist/ui/card.d.ts +33 -0
- package/dist/ui/carousel.d.ts +35 -0
- package/dist/ui/carousel.js +10 -5
- package/dist/ui/chain-of-thought.d.ts +15 -0
- package/dist/ui/chart-card.d.ts +19 -0
- package/dist/ui/chart.d.ts +19 -0
- package/dist/ui/chat-composer.d.ts +19 -0
- package/dist/ui/choice-card.d.ts +33 -0
- package/dist/ui/code-block.d.ts +15 -0
- package/dist/ui/combobox.d.ts +48 -0
- package/dist/ui/command-palette.d.ts +18 -0
- package/dist/ui/command.d.ts +34 -0
- package/dist/ui/confirm-action.d.ts +30 -0
- package/dist/ui/confirm-dialog.d.ts +23 -0
- package/dist/ui/content-card.d.ts +14 -0
- package/dist/ui/context-menu.d.ts +35 -0
- package/dist/ui/context-menu.js +1 -1
- package/dist/ui/conversation-list.d.ts +20 -0
- package/dist/ui/copy-button.d.ts +11 -0
- package/dist/ui/date-time.d.ts +40 -0
- package/dist/ui/date-time.js +55 -0
- package/dist/ui/description-list.d.ts +49 -0
- package/dist/ui/description-list.js +86 -0
- package/dist/ui/detail-panel.d.ts +22 -0
- package/dist/ui/dialog.d.ts +35 -0
- package/dist/ui/dock.d.ts +17 -0
- package/dist/ui/drawer.d.ts +41 -0
- package/dist/ui/dropdown-menu.d.ts +32 -0
- package/dist/ui/dropdown-menu.js +1 -1
- package/dist/ui/echart.d.ts +15 -0
- package/dist/ui/entity-list.d.ts +32 -0
- package/dist/ui/field.d.ts +1 -1
- package/dist/ui/form-layout.d.ts +24 -0
- package/dist/ui/gauge.d.ts +26 -0
- package/dist/ui/generated-image.d.ts +19 -0
- package/dist/ui/generated-table.d.ts +18 -0
- package/dist/ui/heatmap-grid.d.ts +20 -0
- package/dist/ui/hero.d.ts +58 -0
- package/dist/ui/hero.js +145 -0
- package/dist/ui/i18n-provider.d.ts +16 -0
- package/dist/ui/input-group.d.ts +1 -1
- package/dist/ui/input-otp.d.ts +23 -0
- package/dist/ui/input.d.ts +16 -0
- package/dist/ui/instruction-editor.d.ts +17 -0
- package/dist/ui/item.d.ts +3 -3
- package/dist/ui/label.d.ts +17 -0
- package/dist/ui/legend.d.ts +25 -0
- package/dist/ui/level-meter.d.ts +12 -0
- package/dist/ui/load-more.d.ts +17 -0
- package/dist/ui/loading-state.d.ts +12 -0
- package/dist/ui/markdown.d.ts +15 -0
- package/dist/ui/marker.d.ts +1 -1
- package/dist/ui/media-card.d.ts +16 -0
- package/dist/ui/menubar.d.ts +39 -0
- package/dist/ui/message-actions.d.ts +9 -0
- package/dist/ui/message-scroller.d.ts +30 -0
- package/dist/ui/message.d.ts +33 -0
- package/dist/ui/mfa-challenge.d.ts +3 -32
- package/dist/ui/mfa-challenge.js +1 -1
- package/dist/ui/mfa-setup.d.ts +1 -1
- package/dist/ui/mosaic.d.ts +23 -0
- package/dist/ui/motion-provider.d.ts +17 -0
- package/dist/ui/native-select.d.ts +22 -0
- package/dist/ui/next-step-card.d.ts +55 -0
- package/dist/ui/next-step-card.js +92 -0
- package/dist/ui/notice-review.d.ts +32 -0
- package/dist/ui/oauth-consent.d.ts +1 -1
- package/dist/ui/page-header.d.ts +46 -4
- package/dist/ui/page-header.js +20 -11
- package/dist/ui/page-loader.d.ts +17 -0
- package/dist/ui/page-shell.d.ts +17 -0
- package/dist/ui/pagination.d.ts +20 -0
- package/dist/ui/pagination.js +2 -2
- package/dist/ui/panel.d.ts +2 -2
- package/dist/ui/password-strength.d.ts +14 -0
- package/dist/ui/popover.d.ts +32 -0
- package/dist/ui/proportion-bar.d.ts +25 -0
- package/dist/ui/quantity.d.ts +25 -0
- package/dist/ui/quantity.js +27 -0
- package/dist/ui/questionnaire.d.ts +38 -0
- package/dist/ui/reasoning.d.ts +14 -0
- package/dist/ui/reveal.d.ts +17 -0
- package/dist/ui/sheet.d.ts +39 -2
- package/dist/ui/sheet.js +6 -2
- package/dist/ui/shield.d.ts +14 -0
- package/dist/ui/show-more.d.ts +14 -0
- package/dist/ui/sidebar.d.ts +5 -3
- package/dist/ui/sidebar.js +7 -3
- package/dist/ui/sparkline.d.ts +1 -1
- package/dist/ui/stat-group.d.ts +32 -0
- package/dist/ui/status-badge.d.ts +2 -2
- package/dist/ui/status-hero.d.ts +18 -0
- package/dist/ui/step-dots.d.ts +12 -0
- package/dist/ui/step-ring.d.ts +14 -0
- package/dist/ui/suggestions.d.ts +9 -0
- package/dist/ui/table.d.ts +26 -0
- package/dist/ui/tabs.d.ts +1 -1
- package/dist/ui/tag-input.d.ts +21 -0
- package/dist/ui/tag-input.js +169 -0
- package/dist/ui/task-loader.d.ts +15 -0
- package/dist/ui/task-progress.d.ts +14 -0
- package/dist/ui/textarea.d.ts +22 -1
- package/dist/ui/textarea.js +7 -1
- package/dist/ui/timeline.d.ts +26 -0
- package/dist/ui/toggle-group.d.ts +24 -0
- package/dist/ui/toggle.d.ts +1 -1
- package/dist/ui/tool-call.d.ts +12 -0
- package/dist/ui/usage-meter.d.ts +42 -0
- package/dist/ui/usage-meter.js +116 -0
- package/dist/ui/week-strip.d.ts +11 -0
- package/dist/ui/week-strip.js +2 -2
- package/dist/ui/workflow-run.d.ts +28 -0
- package/docs/adr/0001-rtl-clases-logicas.md +14 -1
- package/docs/designer/flujo.md +1 -1
- package/docs/designer/patrones.md +40 -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 +2298 -0
- package/manifest/data.json +2904 -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 +931 -0
- package/package.json +242 -238
- package/scripts/cli.mjs +105 -8
- package/scripts/doctor.mjs +126 -1
- package/scripts/eslint-plugin.mjs +93 -0
- package/scripts/i18n.mjs +1 -1
- package/scripts/manifest.mjs +159 -7
- package/skill/SKILL.md +8 -3
|
@@ -0,0 +1,1792 @@
|
|
|
1
|
+
{
|
|
2
|
+
"package": "orbital-ds",
|
|
3
|
+
"version": "0.44.1",
|
|
4
|
+
"group": "navigation",
|
|
5
|
+
"about": "Cabecera, lateral, pestañas, pasos, paginación y búsqueda de destinos.",
|
|
6
|
+
"components": {
|
|
7
|
+
"app-bar": {
|
|
8
|
+
"import": "orbital-ds/ui/app-bar",
|
|
9
|
+
"group": "navigation",
|
|
10
|
+
"summary": "Barra superior de la app dentro del lienzo: botón de menú, título corto y controles fijos (avisos, idioma, tema). El título de la vista va en PageHeader.",
|
|
11
|
+
"see": [
|
|
12
|
+
{
|
|
13
|
+
"component": "page-header",
|
|
14
|
+
"when": "título (h1), subtítulo y acciones de la vista, al inicio del contenido"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"component": "sidebar",
|
|
18
|
+
"when": "navegación principal lateral; su SidebarTrigger va dentro de la AppBar"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"component": "bottom-nav",
|
|
22
|
+
"when": "navegación principal inferior en móvil"
|
|
23
|
+
}
|
|
24
|
+
],
|
|
25
|
+
"exports": [
|
|
26
|
+
"AppBar",
|
|
27
|
+
"AppBarActions",
|
|
28
|
+
"AppBarTitle"
|
|
29
|
+
],
|
|
30
|
+
"slots": [
|
|
31
|
+
"app-bar",
|
|
32
|
+
"app-bar-actions",
|
|
33
|
+
"app-bar-title"
|
|
34
|
+
],
|
|
35
|
+
"optionalPeers": [],
|
|
36
|
+
"props": {
|
|
37
|
+
"AppBar": {
|
|
38
|
+
"preset": {
|
|
39
|
+
"type": "AppBarPreset",
|
|
40
|
+
"values": [
|
|
41
|
+
"compact",
|
|
42
|
+
"app",
|
|
43
|
+
"transparent"
|
|
44
|
+
]
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
},
|
|
48
|
+
"presets": {
|
|
49
|
+
"values": [
|
|
50
|
+
"app",
|
|
51
|
+
"compact",
|
|
52
|
+
"transparent"
|
|
53
|
+
],
|
|
54
|
+
"default": "app",
|
|
55
|
+
"intent": {
|
|
56
|
+
"app": "barra normal: fondo propio y filete inferior",
|
|
57
|
+
"compact": "barra baja, para vistas densas o paneles",
|
|
58
|
+
"transparent": "hereda el fondo del lienzo, sin filete: el panel se lee como una sola pieza"
|
|
59
|
+
}
|
|
60
|
+
},
|
|
61
|
+
"notes": [
|
|
62
|
+
"Una por pantalla, arriba del lienzo; `transparent` con lienzo flotante para no partir el panel en dos fondos."
|
|
63
|
+
],
|
|
64
|
+
"examples": [
|
|
65
|
+
{
|
|
66
|
+
"title": "Menú, título, idioma y tema",
|
|
67
|
+
"code": "<AppBar>\n <SidebarTrigger />\n <AppBarTitle>Clientes</AppBarTitle>\n <AppBarActions>\n <LocaleSwitcher locales={locales} value={locale} onValueChange={setLocale} />\n <ThemeToggle value={theme} onValueChange={setTheme} />\n </AppBarActions>\n</AppBar>"
|
|
68
|
+
},
|
|
69
|
+
{
|
|
70
|
+
"title": "Preset transparent sobre un lienzo flotante",
|
|
71
|
+
"code": "<AppBar preset=\"transparent\">\n <SidebarTrigger />\n <AppBarTitle>Mapa</AppBarTitle>\n</AppBar>"
|
|
72
|
+
}
|
|
73
|
+
]
|
|
74
|
+
},
|
|
75
|
+
"bottom-nav": {
|
|
76
|
+
"import": "orbital-ds/ui/bottom-nav",
|
|
77
|
+
"group": "navigation",
|
|
78
|
+
"summary": "Navegación principal inferior de móvil con 3–5 destinos de primer nivel (icono y texto). En escritorio, la navegación principal es Sidebar.",
|
|
79
|
+
"see": [
|
|
80
|
+
{
|
|
81
|
+
"component": "sidebar",
|
|
82
|
+
"when": "navegación principal en escritorio, con grupos y muchos destinos"
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
"component": "dock",
|
|
86
|
+
"when": "raíl de solo iconos con efecto lupa, sin textos"
|
|
87
|
+
},
|
|
88
|
+
{
|
|
89
|
+
"component": "tabs",
|
|
90
|
+
"when": "cambiar entre vistas de una misma página, no entre destinos de la app"
|
|
91
|
+
}
|
|
92
|
+
],
|
|
93
|
+
"exports": [
|
|
94
|
+
"BottomNav",
|
|
95
|
+
"BottomNavBadge",
|
|
96
|
+
"BottomNavIcon",
|
|
97
|
+
"BottomNavItem",
|
|
98
|
+
"BottomNavLabel"
|
|
99
|
+
],
|
|
100
|
+
"slots": [
|
|
101
|
+
"bottom-nav",
|
|
102
|
+
"bottom-nav-badge",
|
|
103
|
+
"bottom-nav-icon",
|
|
104
|
+
"bottom-nav-item",
|
|
105
|
+
"bottom-nav-label"
|
|
106
|
+
],
|
|
107
|
+
"optionalPeers": [],
|
|
108
|
+
"props": {
|
|
109
|
+
"BottomNav": {
|
|
110
|
+
"position": {
|
|
111
|
+
"type": "\"fixed\" | \"static\"",
|
|
112
|
+
"values": [
|
|
113
|
+
"fixed",
|
|
114
|
+
"static"
|
|
115
|
+
]
|
|
116
|
+
}
|
|
117
|
+
},
|
|
118
|
+
"BottomNavItem": {
|
|
119
|
+
"active": {
|
|
120
|
+
"type": "boolean"
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
},
|
|
124
|
+
"notes": [
|
|
125
|
+
"Solo en móvil y para 3–5 destinos de primer nivel; en escritorio, el lateral (Sidebar).",
|
|
126
|
+
"Sin BottomNavLabel, pon aria-label en cada BottomNavItem: el icono solo no se anuncia."
|
|
127
|
+
],
|
|
128
|
+
"examples": [
|
|
129
|
+
{
|
|
130
|
+
"title": "Destinos con enlace del router y contador",
|
|
131
|
+
"code": "<BottomNav>\n <BottomNavItem active render={<Link to=\"/\" />}>\n <BottomNavIcon><HouseIcon /></BottomNavIcon>\n <BottomNavLabel>Inicio</BottomNavLabel>\n </BottomNavItem>\n <BottomNavItem render={<Link to=\"/inbox\" />}>\n <BottomNavIcon>\n <InboxIcon />\n <BottomNavBadge>3</BottomNavBadge>\n </BottomNavIcon>\n <BottomNavLabel>Avisos</BottomNavLabel>\n </BottomNavItem>\n</BottomNav>"
|
|
132
|
+
}
|
|
133
|
+
]
|
|
134
|
+
},
|
|
135
|
+
"breadcrumb": {
|
|
136
|
+
"import": "orbital-ds/ui/breadcrumb",
|
|
137
|
+
"group": "navigation",
|
|
138
|
+
"summary": "Migas de pan: dónde está la persona dentro de una jerarquía (sección › entidad) y cómo subir a un nivel superior.",
|
|
139
|
+
"see": [
|
|
140
|
+
{
|
|
141
|
+
"component": "page-header",
|
|
142
|
+
"when": "su hueco PageHeaderBreadcrumb coloca las migas sobre el título de la vista"
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
"component": "tabs",
|
|
146
|
+
"when": "cambiar entre vistas hermanas, no subir de nivel"
|
|
147
|
+
},
|
|
148
|
+
{
|
|
149
|
+
"component": "stepper",
|
|
150
|
+
"when": "pasos de un proceso, no niveles de una jerarquía"
|
|
151
|
+
}
|
|
152
|
+
],
|
|
153
|
+
"exports": [
|
|
154
|
+
"Breadcrumb",
|
|
155
|
+
"BreadcrumbEllipsis",
|
|
156
|
+
"BreadcrumbItem",
|
|
157
|
+
"BreadcrumbLink",
|
|
158
|
+
"BreadcrumbList",
|
|
159
|
+
"BreadcrumbPage",
|
|
160
|
+
"BreadcrumbSeparator"
|
|
161
|
+
],
|
|
162
|
+
"slots": [
|
|
163
|
+
"breadcrumb",
|
|
164
|
+
"breadcrumb-ellipsis",
|
|
165
|
+
"breadcrumb-item",
|
|
166
|
+
"breadcrumb-link",
|
|
167
|
+
"breadcrumb-list",
|
|
168
|
+
"breadcrumb-page",
|
|
169
|
+
"breadcrumb-separator"
|
|
170
|
+
],
|
|
171
|
+
"optionalPeers": [],
|
|
172
|
+
"notes": [
|
|
173
|
+
"El último nivel es BreadcrumbPage (no es enlace); con un router, BreadcrumbLink usa `render={<Link … />}`, nunca asChild.",
|
|
174
|
+
"Con más de 4 niveles, recorta los intermedios con BreadcrumbEllipsis."
|
|
175
|
+
],
|
|
176
|
+
"examples": [
|
|
177
|
+
{
|
|
178
|
+
"title": "Sección y entidad actual",
|
|
179
|
+
"code": "<Breadcrumb>\n <BreadcrumbList>\n <BreadcrumbItem>\n <BreadcrumbLink render={<Link to=\"/clients\" />}>Clientes</BreadcrumbLink>\n </BreadcrumbItem>\n <BreadcrumbSeparator />\n <BreadcrumbItem>\n <BreadcrumbPage>Construcciones Levante</BreadcrumbPage>\n </BreadcrumbItem>\n </BreadcrumbList>\n</Breadcrumb>"
|
|
180
|
+
}
|
|
181
|
+
]
|
|
182
|
+
},
|
|
183
|
+
"command-palette": {
|
|
184
|
+
"import": "orbital-ds/ui/command-palette",
|
|
185
|
+
"group": "navigation",
|
|
186
|
+
"summary": "Paleta de comandos ⌘K lista para usar (diálogo, atajo, filtro, vacío y textos): la app solo pasa los grupos de elementos. Una por app, en la raíz.",
|
|
187
|
+
"see": [
|
|
188
|
+
{
|
|
189
|
+
"component": "command",
|
|
190
|
+
"when": "piezas sueltas para una lista filtrable dentro de una página o un popover"
|
|
191
|
+
},
|
|
192
|
+
{
|
|
193
|
+
"component": "search-box",
|
|
194
|
+
"when": "campo que filtra una lista de la propia vista"
|
|
195
|
+
}
|
|
196
|
+
],
|
|
197
|
+
"exports": [
|
|
198
|
+
"CommandPalette",
|
|
199
|
+
"type CommandPaletteGroup",
|
|
200
|
+
"type CommandPaletteItem",
|
|
201
|
+
"type CommandPalettePreset"
|
|
202
|
+
],
|
|
203
|
+
"slots": [
|
|
204
|
+
"command-palette",
|
|
205
|
+
"command-palette-loading"
|
|
206
|
+
],
|
|
207
|
+
"optionalPeers": [],
|
|
208
|
+
"props": {
|
|
209
|
+
"CommandPalette": {
|
|
210
|
+
"preset": {
|
|
211
|
+
"type": "CommandPalettePreset",
|
|
212
|
+
"values": [
|
|
213
|
+
"search",
|
|
214
|
+
"go",
|
|
215
|
+
"actions"
|
|
216
|
+
]
|
|
217
|
+
},
|
|
218
|
+
"groups": {
|
|
219
|
+
"type": "CommandPaletteGroup[]",
|
|
220
|
+
"required": true
|
|
221
|
+
},
|
|
222
|
+
"open": {
|
|
223
|
+
"type": "boolean"
|
|
224
|
+
},
|
|
225
|
+
"onOpenChange": {
|
|
226
|
+
"type": "(open: boolean) => void"
|
|
227
|
+
},
|
|
228
|
+
"hotkey": {
|
|
229
|
+
"type": "string",
|
|
230
|
+
"doc": "Tecla del atajo (con ⌘/Ctrl); `null` lo desactiva."
|
|
231
|
+
},
|
|
232
|
+
"placeholder": {
|
|
233
|
+
"type": "string"
|
|
234
|
+
},
|
|
235
|
+
"emptyMessage": {
|
|
236
|
+
"type": "string"
|
|
237
|
+
},
|
|
238
|
+
"query": {
|
|
239
|
+
"type": "string",
|
|
240
|
+
"doc": "Texto del campo (controlado); necesario en `search` para consultar al servidor."
|
|
241
|
+
},
|
|
242
|
+
"onQueryChange": {
|
|
243
|
+
"type": "(query: string) => void"
|
|
244
|
+
},
|
|
245
|
+
"loading": {
|
|
246
|
+
"type": "boolean"
|
|
247
|
+
},
|
|
248
|
+
"closeOnSelect": {
|
|
249
|
+
"type": "boolean"
|
|
250
|
+
},
|
|
251
|
+
"className": {
|
|
252
|
+
"type": "string"
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
},
|
|
256
|
+
"presets": {
|
|
257
|
+
"values": [
|
|
258
|
+
"go",
|
|
259
|
+
"actions",
|
|
260
|
+
"search"
|
|
261
|
+
],
|
|
262
|
+
"default": "go",
|
|
263
|
+
"intent": {
|
|
264
|
+
"go": "navegar («Ir a…»): filtra en el cliente por etiqueta y `keywords`",
|
|
265
|
+
"actions": "ejecutar acciones («Escribe un comando…»): igual, con otro texto de ayuda",
|
|
266
|
+
"search": "buscar entidades: NO filtra en el cliente; la app responde a `onQueryChange` con `groups`"
|
|
267
|
+
}
|
|
268
|
+
},
|
|
269
|
+
"notes": [
|
|
270
|
+
"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.",
|
|
271
|
+
"Un solo CommandPalette por app, montado en la raíz. Para una lista filtrable dentro de una página usa Command, no la paleta."
|
|
272
|
+
],
|
|
273
|
+
"examples": [
|
|
274
|
+
{
|
|
275
|
+
"title": "Preset go (navegar)",
|
|
276
|
+
"code": "<CommandPalette\n groups={[{ heading: \"Ir a\", items: [{ id: \"home\", label: \"Inicio\", icon: <HomeIcon />, onSelect: () => navigate(\"/\") }] }]}\n/>"
|
|
277
|
+
},
|
|
278
|
+
{
|
|
279
|
+
"title": "Preset search contra el servidor",
|
|
280
|
+
"code": "<CommandPalette preset=\"search\" groups={results} query={query} onQueryChange={setQuery} loading={isFetching} />"
|
|
281
|
+
},
|
|
282
|
+
{
|
|
283
|
+
"title": "Abrirla desde un botón de la cabecera",
|
|
284
|
+
"code": "<Button size=\"icon\" variant=\"ghost\" aria-label={t(\"search\")} onClick={() => setOpen(true)}>\n <SearchIcon />\n</Button>\n<CommandPalette open={open} onOpenChange={setOpen} groups={groups} />"
|
|
285
|
+
}
|
|
286
|
+
]
|
|
287
|
+
},
|
|
288
|
+
"command": {
|
|
289
|
+
"import": "orbital-ds/ui/command",
|
|
290
|
+
"group": "navigation",
|
|
291
|
+
"summary": "Piezas de una lista filtrable con teclado (campo, grupos, elementos, atajos) para montar una búsqueda en línea o en un popover. La paleta ⌘K ya hecha es CommandPalette.",
|
|
292
|
+
"see": [
|
|
293
|
+
{
|
|
294
|
+
"component": "command-palette",
|
|
295
|
+
"when": "paleta ⌘K completa (diálogo, atajo y textos) sin montar piezas"
|
|
296
|
+
},
|
|
297
|
+
{
|
|
298
|
+
"component": "combobox",
|
|
299
|
+
"when": "elegir el valor de un campo de formulario en una lista filtrable"
|
|
300
|
+
},
|
|
301
|
+
{
|
|
302
|
+
"component": "dropdown-menu",
|
|
303
|
+
"when": "menú corto de acciones sin campo de búsqueda"
|
|
304
|
+
}
|
|
305
|
+
],
|
|
306
|
+
"exports": [
|
|
307
|
+
"Command",
|
|
308
|
+
"CommandDialog",
|
|
309
|
+
"CommandEmpty",
|
|
310
|
+
"CommandGroup",
|
|
311
|
+
"CommandInput",
|
|
312
|
+
"CommandItem",
|
|
313
|
+
"CommandList",
|
|
314
|
+
"CommandSeparator",
|
|
315
|
+
"CommandShortcut"
|
|
316
|
+
],
|
|
317
|
+
"slots": [
|
|
318
|
+
"command",
|
|
319
|
+
"command-empty",
|
|
320
|
+
"command-group",
|
|
321
|
+
"command-input",
|
|
322
|
+
"command-input-wrapper",
|
|
323
|
+
"command-item",
|
|
324
|
+
"command-list",
|
|
325
|
+
"command-separator",
|
|
326
|
+
"command-shortcut"
|
|
327
|
+
],
|
|
328
|
+
"optionalPeers": [
|
|
329
|
+
"cmdk"
|
|
330
|
+
],
|
|
331
|
+
"props": {
|
|
332
|
+
"CommandDialog": {
|
|
333
|
+
"title": {
|
|
334
|
+
"type": "string"
|
|
335
|
+
},
|
|
336
|
+
"description": {
|
|
337
|
+
"type": "string"
|
|
338
|
+
},
|
|
339
|
+
"className": {
|
|
340
|
+
"type": "string"
|
|
341
|
+
},
|
|
342
|
+
"showCloseButton": {
|
|
343
|
+
"type": "boolean"
|
|
344
|
+
},
|
|
345
|
+
"children": {
|
|
346
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
347
|
+
"required": true
|
|
348
|
+
}
|
|
349
|
+
}
|
|
350
|
+
},
|
|
351
|
+
"notes": [
|
|
352
|
+
"Command no trae textos propios: el placeholder de CommandInput y el contenido de CommandEmpty los pone la app con su i18n.",
|
|
353
|
+
"Para la paleta global ⌘K usa CommandPalette; CommandDialog solo si necesitas montar el contenido a mano."
|
|
354
|
+
],
|
|
355
|
+
"examples": [
|
|
356
|
+
{
|
|
357
|
+
"title": "Lista filtrable en línea",
|
|
358
|
+
"code": "<Command>\n <CommandInput placeholder={t(\"searchCommand\")} />\n <CommandList>\n <CommandEmpty>Sin resultados.</CommandEmpty>\n <CommandGroup heading=\"Ajustes\">\n <CommandItem onSelect={openProfile}>\n <UserIcon />\n Perfil\n <CommandShortcut>⌘P</CommandShortcut>\n </CommandItem>\n </CommandGroup>\n </CommandList>\n</Command>"
|
|
359
|
+
},
|
|
360
|
+
{
|
|
361
|
+
"title": "En un diálogo montado a mano",
|
|
362
|
+
"code": "<CommandDialog open={open} onOpenChange={setOpen}>\n <Command>\n <CommandInput placeholder={t(\"search\")} />\n <CommandList>\n <CommandEmpty>Sin resultados.</CommandEmpty>\n <CommandItem onSelect={openReports}>Informes</CommandItem>\n </CommandList>\n </Command>\n</CommandDialog>"
|
|
363
|
+
}
|
|
364
|
+
]
|
|
365
|
+
},
|
|
366
|
+
"dock": {
|
|
367
|
+
"import": "orbital-ds/ui/dock",
|
|
368
|
+
"group": "navigation",
|
|
369
|
+
"summary": "Raíl compacto de accesos de solo icono con efecto lupa, para pocas secciones (≤ 8) de una app visual; sin textos ni grupos.",
|
|
370
|
+
"see": [
|
|
371
|
+
{
|
|
372
|
+
"component": "sidebar",
|
|
373
|
+
"when": "navegación principal con textos, grupos y muchos destinos"
|
|
374
|
+
},
|
|
375
|
+
{
|
|
376
|
+
"component": "bottom-nav",
|
|
377
|
+
"when": "barra inferior de móvil con icono y texto"
|
|
378
|
+
}
|
|
379
|
+
],
|
|
380
|
+
"exports": [
|
|
381
|
+
"Dock",
|
|
382
|
+
"DockItem"
|
|
383
|
+
],
|
|
384
|
+
"slots": [
|
|
385
|
+
"dock",
|
|
386
|
+
"dock-item"
|
|
387
|
+
],
|
|
388
|
+
"optionalPeers": [],
|
|
389
|
+
"props": {
|
|
390
|
+
"Dock": {
|
|
391
|
+
"orientation": {
|
|
392
|
+
"type": "\"horizontal\" | \"vertical\"",
|
|
393
|
+
"values": [
|
|
394
|
+
"horizontal",
|
|
395
|
+
"vertical"
|
|
396
|
+
]
|
|
397
|
+
}
|
|
398
|
+
},
|
|
399
|
+
"DockItem": {
|
|
400
|
+
"label": {
|
|
401
|
+
"type": "string",
|
|
402
|
+
"required": true,
|
|
403
|
+
"doc": "Nombre del acceso (accesible y tooltip nativo). Obligatorio: el botón solo lleva icono."
|
|
404
|
+
},
|
|
405
|
+
"active": {
|
|
406
|
+
"type": "boolean"
|
|
407
|
+
}
|
|
408
|
+
}
|
|
409
|
+
},
|
|
410
|
+
"notes": [
|
|
411
|
+
"Acceso principal compacto (raíl de iconos): cada DockItem lleva `label` (nombre accesible); el activo, `active`.",
|
|
412
|
+
"Para navegación con textos y grupos, usa Sidebar; Dock es el atajo visual de pocas secciones (≤ 8)."
|
|
413
|
+
],
|
|
414
|
+
"examples": [
|
|
415
|
+
{
|
|
416
|
+
"title": "Raíl vertical con el destino activo",
|
|
417
|
+
"code": "<Dock orientation=\"vertical\">\n <DockItem label=\"Inicio\" active><HomeIcon /></DockItem>\n <DockItem label=\"Mensajes\" render={<a href=\"/inbox\" />}><InboxIcon /></DockItem>\n</Dock>"
|
|
418
|
+
},
|
|
419
|
+
{
|
|
420
|
+
"title": "Horizontal con acciones",
|
|
421
|
+
"code": "<Dock orientation=\"horizontal\">\n <DockItem label=\"Buscar\" onClick={openSearch}><SearchIcon /></DockItem>\n <DockItem label=\"Ajustes\" onClick={openSettings}><SettingsIcon /></DockItem>\n</Dock>"
|
|
422
|
+
}
|
|
423
|
+
]
|
|
424
|
+
},
|
|
425
|
+
"locale-switcher": {
|
|
426
|
+
"import": "orbital-ds/ui/locale-switcher",
|
|
427
|
+
"group": "navigation",
|
|
428
|
+
"summary": "Selector del idioma de la app para la barra superior, junto a ThemeToggle. Solo pinta y avisa: la app cambia su idioma.",
|
|
429
|
+
"see": [
|
|
430
|
+
{
|
|
431
|
+
"component": "theme-toggle",
|
|
432
|
+
"when": "elegir claro, oscuro o sistema, a su lado en la barra"
|
|
433
|
+
},
|
|
434
|
+
{
|
|
435
|
+
"component": "select",
|
|
436
|
+
"when": "elegir un idioma como dato de un formulario (el de un cliente, por ejemplo)"
|
|
437
|
+
}
|
|
438
|
+
],
|
|
439
|
+
"exports": [
|
|
440
|
+
"LocaleSwitcher"
|
|
441
|
+
],
|
|
442
|
+
"slots": [
|
|
443
|
+
"locale-switcher"
|
|
444
|
+
],
|
|
445
|
+
"optionalPeers": [],
|
|
446
|
+
"props": {
|
|
447
|
+
"LocaleSwitcher": {
|
|
448
|
+
"locales": {
|
|
449
|
+
"type": "LocaleOption[]",
|
|
450
|
+
"required": true
|
|
451
|
+
},
|
|
452
|
+
"value": {
|
|
453
|
+
"type": "string",
|
|
454
|
+
"required": true
|
|
455
|
+
},
|
|
456
|
+
"onValueChange": {
|
|
457
|
+
"type": "(value: string) => void"
|
|
458
|
+
},
|
|
459
|
+
"preset": {
|
|
460
|
+
"type": "LocaleSwitcherPreset",
|
|
461
|
+
"values": [
|
|
462
|
+
"menu",
|
|
463
|
+
"compact"
|
|
464
|
+
]
|
|
465
|
+
},
|
|
466
|
+
"tone": {
|
|
467
|
+
"type": "HeaderControlTone",
|
|
468
|
+
"values": [
|
|
469
|
+
"brand",
|
|
470
|
+
"soft",
|
|
471
|
+
"neutral"
|
|
472
|
+
]
|
|
473
|
+
},
|
|
474
|
+
"className": {
|
|
475
|
+
"type": "string"
|
|
476
|
+
}
|
|
477
|
+
}
|
|
478
|
+
},
|
|
479
|
+
"presets": {
|
|
480
|
+
"values": [
|
|
481
|
+
"compact",
|
|
482
|
+
"menu"
|
|
483
|
+
],
|
|
484
|
+
"default": "compact",
|
|
485
|
+
"intent": {
|
|
486
|
+
"compact": "icono y código corto («ES») en la barra superior; abre un menú con los nombres",
|
|
487
|
+
"menu": "icono y nombre completo del idioma activo, para zonas con más sitio"
|
|
488
|
+
}
|
|
489
|
+
},
|
|
490
|
+
"notes": [
|
|
491
|
+
"Siempre visible en la barra superior, junto a ThemeToggle; el nombre de cada idioma se escribe en ese idioma, no traducido."
|
|
492
|
+
],
|
|
493
|
+
"examples": [
|
|
494
|
+
{
|
|
495
|
+
"title": "Con i18next",
|
|
496
|
+
"code": "<LocaleSwitcher\n locales={[{ value: \"es\", label: \"Español\" }, { value: \"en\", label: \"English\" }]}\n value={i18n.language}\n onValueChange={(l) => i18n.changeLanguage(l)}\n/>"
|
|
497
|
+
},
|
|
498
|
+
{
|
|
499
|
+
"title": "Preset menu con el tono de la marca",
|
|
500
|
+
"code": "<LocaleSwitcher preset=\"menu\" tone=\"brand\" locales={locales} value={locale} onValueChange={setLocale} />"
|
|
501
|
+
}
|
|
502
|
+
]
|
|
503
|
+
},
|
|
504
|
+
"menubar": {
|
|
505
|
+
"import": "orbital-ds/ui/menubar",
|
|
506
|
+
"group": "navigation",
|
|
507
|
+
"summary": "Barra de menús de escritorio al estilo de una aplicación (Archivo, Editar, Ver) con comandos y submenús, para editores y herramientas densas; no navega entre páginas.",
|
|
508
|
+
"see": [
|
|
509
|
+
{
|
|
510
|
+
"component": "navigation-menu",
|
|
511
|
+
"when": "navegación de un sitio con desplegables de enlaces (Producto, Recursos)"
|
|
512
|
+
},
|
|
513
|
+
{
|
|
514
|
+
"component": "dropdown-menu",
|
|
515
|
+
"when": "un solo menú de acciones tras un botón"
|
|
516
|
+
},
|
|
517
|
+
{
|
|
518
|
+
"component": "sidebar",
|
|
519
|
+
"when": "navegación principal de la app"
|
|
520
|
+
}
|
|
521
|
+
],
|
|
522
|
+
"exports": [
|
|
523
|
+
"Menubar",
|
|
524
|
+
"MenubarCheckboxItem",
|
|
525
|
+
"MenubarContent",
|
|
526
|
+
"MenubarGroup",
|
|
527
|
+
"MenubarItem",
|
|
528
|
+
"MenubarLabel",
|
|
529
|
+
"MenubarMenu",
|
|
530
|
+
"MenubarPortal",
|
|
531
|
+
"MenubarRadioGroup",
|
|
532
|
+
"MenubarRadioItem",
|
|
533
|
+
"MenubarSeparator",
|
|
534
|
+
"MenubarShortcut",
|
|
535
|
+
"MenubarSub",
|
|
536
|
+
"MenubarSubContent",
|
|
537
|
+
"MenubarSubTrigger",
|
|
538
|
+
"MenubarTrigger"
|
|
539
|
+
],
|
|
540
|
+
"slots": [
|
|
541
|
+
"menubar",
|
|
542
|
+
"menubar-checkbox-item",
|
|
543
|
+
"menubar-content",
|
|
544
|
+
"menubar-group",
|
|
545
|
+
"menubar-item",
|
|
546
|
+
"menubar-label",
|
|
547
|
+
"menubar-menu",
|
|
548
|
+
"menubar-portal",
|
|
549
|
+
"menubar-radio-group",
|
|
550
|
+
"menubar-radio-item",
|
|
551
|
+
"menubar-separator",
|
|
552
|
+
"menubar-shortcut",
|
|
553
|
+
"menubar-sub",
|
|
554
|
+
"menubar-sub-content",
|
|
555
|
+
"menubar-sub-trigger",
|
|
556
|
+
"menubar-trigger"
|
|
557
|
+
],
|
|
558
|
+
"optionalPeers": [],
|
|
559
|
+
"props": {
|
|
560
|
+
"MenubarLabel": {
|
|
561
|
+
"inset": {
|
|
562
|
+
"type": "boolean"
|
|
563
|
+
}
|
|
564
|
+
},
|
|
565
|
+
"MenubarItem": {
|
|
566
|
+
"inset": {
|
|
567
|
+
"type": "boolean"
|
|
568
|
+
},
|
|
569
|
+
"variant": {
|
|
570
|
+
"type": "\"default\" | \"destructive\"",
|
|
571
|
+
"values": [
|
|
572
|
+
"default",
|
|
573
|
+
"destructive"
|
|
574
|
+
]
|
|
575
|
+
}
|
|
576
|
+
},
|
|
577
|
+
"MenubarCheckboxItem": {
|
|
578
|
+
"inset": {
|
|
579
|
+
"type": "boolean"
|
|
580
|
+
}
|
|
581
|
+
},
|
|
582
|
+
"MenubarRadioItem": {
|
|
583
|
+
"inset": {
|
|
584
|
+
"type": "boolean"
|
|
585
|
+
}
|
|
586
|
+
},
|
|
587
|
+
"MenubarSubTrigger": {
|
|
588
|
+
"inset": {
|
|
589
|
+
"type": "boolean"
|
|
590
|
+
}
|
|
591
|
+
}
|
|
592
|
+
},
|
|
593
|
+
"notes": [
|
|
594
|
+
"Solo en escritorio y para comandos de la herramienta; en móvil, agrupa las acciones en un DropdownMenu.",
|
|
595
|
+
"MenubarShortcut solo muestra el atajo: la app enlaza la tecla."
|
|
596
|
+
],
|
|
597
|
+
"examples": [
|
|
598
|
+
{
|
|
599
|
+
"title": "Menú con atajo y acción destructiva",
|
|
600
|
+
"code": "<Menubar>\n <MenubarMenu>\n <MenubarTrigger>Archivo</MenubarTrigger>\n <MenubarContent>\n <MenubarItem>\n Nuevo\n <MenubarShortcut>⌘N</MenubarShortcut>\n </MenubarItem>\n <MenubarSeparator />\n <MenubarItem variant=\"destructive\">Eliminar</MenubarItem>\n </MenubarContent>\n </MenubarMenu>\n</Menubar>"
|
|
601
|
+
},
|
|
602
|
+
{
|
|
603
|
+
"title": "Opción marcada y submenú",
|
|
604
|
+
"code": "<Menubar>\n <MenubarMenu>\n <MenubarTrigger>Ver</MenubarTrigger>\n <MenubarContent>\n <MenubarCheckboxItem checked={showGrid} onCheckedChange={setShowGrid}>Cuadrícula</MenubarCheckboxItem>\n <MenubarSub>\n <MenubarSubTrigger>Exportar</MenubarSubTrigger>\n <MenubarSubContent>\n <MenubarItem>PDF</MenubarItem>\n </MenubarSubContent>\n </MenubarSub>\n </MenubarContent>\n </MenubarMenu>\n</Menubar>"
|
|
605
|
+
}
|
|
606
|
+
]
|
|
607
|
+
},
|
|
608
|
+
"navigation-menu": {
|
|
609
|
+
"import": "orbital-ds/ui/navigation-menu",
|
|
610
|
+
"group": "navigation",
|
|
611
|
+
"summary": "Navegación horizontal de un sitio o portal con desplegables de enlaces (Producto, Recursos); para la cabecera de una web pública, no para el menú de una app.",
|
|
612
|
+
"see": [
|
|
613
|
+
{
|
|
614
|
+
"component": "sidebar",
|
|
615
|
+
"when": "navegación principal de una app con muchas secciones"
|
|
616
|
+
},
|
|
617
|
+
{
|
|
618
|
+
"component": "menubar",
|
|
619
|
+
"when": "comandos de una herramienta (Archivo, Editar), no enlaces"
|
|
620
|
+
},
|
|
621
|
+
{
|
|
622
|
+
"component": "tabs",
|
|
623
|
+
"when": "cambiar entre vistas de una misma página"
|
|
624
|
+
}
|
|
625
|
+
],
|
|
626
|
+
"exports": [
|
|
627
|
+
"NavigationMenu",
|
|
628
|
+
"NavigationMenuContent",
|
|
629
|
+
"NavigationMenuIndicator",
|
|
630
|
+
"NavigationMenuItem",
|
|
631
|
+
"NavigationMenuLink",
|
|
632
|
+
"NavigationMenuList",
|
|
633
|
+
"NavigationMenuPositioner",
|
|
634
|
+
"NavigationMenuTrigger",
|
|
635
|
+
"navigationMenuTriggerStyle"
|
|
636
|
+
],
|
|
637
|
+
"slots": [
|
|
638
|
+
"navigation-menu",
|
|
639
|
+
"navigation-menu-arrow",
|
|
640
|
+
"navigation-menu-content",
|
|
641
|
+
"navigation-menu-indicator",
|
|
642
|
+
"navigation-menu-item",
|
|
643
|
+
"navigation-menu-link",
|
|
644
|
+
"navigation-menu-list",
|
|
645
|
+
"navigation-menu-popup",
|
|
646
|
+
"navigation-menu-positioner",
|
|
647
|
+
"navigation-menu-trigger",
|
|
648
|
+
"navigation-menu-viewport"
|
|
649
|
+
],
|
|
650
|
+
"optionalPeers": [],
|
|
651
|
+
"notes": [
|
|
652
|
+
"Un enlace directo de primer nivel lleva `className={navigationMenuTriggerStyle()}` para tener el aspecto de los disparadores.",
|
|
653
|
+
"Marca la página actual con `active` en NavigationMenuLink."
|
|
654
|
+
],
|
|
655
|
+
"examples": [
|
|
656
|
+
{
|
|
657
|
+
"title": "Desplegable de enlaces y enlace directo",
|
|
658
|
+
"code": "<NavigationMenu>\n <NavigationMenuList>\n <NavigationMenuItem>\n <NavigationMenuTrigger>Producto</NavigationMenuTrigger>\n <NavigationMenuContent>\n <NavigationMenuLink href=\"/billing\">Facturación</NavigationMenuLink>\n <NavigationMenuLink href=\"/reports\">Informes</NavigationMenuLink>\n </NavigationMenuContent>\n </NavigationMenuItem>\n <NavigationMenuItem>\n <NavigationMenuLink href=\"/pricing\" active className={navigationMenuTriggerStyle()}>\n Precios\n </NavigationMenuLink>\n </NavigationMenuItem>\n </NavigationMenuList>\n</NavigationMenu>"
|
|
659
|
+
}
|
|
660
|
+
]
|
|
661
|
+
},
|
|
662
|
+
"page-header": {
|
|
663
|
+
"import": "orbital-ds/ui/page-header",
|
|
664
|
+
"group": "navigation",
|
|
665
|
+
"summary": "Cabecera del contenido de una vista: migas, título (h1), subtítulo, acciones y avisos. SectionHeader, en el mismo fichero, titula un bloque (h2) dentro de la vista.",
|
|
666
|
+
"see": [
|
|
667
|
+
{
|
|
668
|
+
"component": "app-bar",
|
|
669
|
+
"when": "barra superior de la app (menú, título corto, idioma y tema), fuera del contenido"
|
|
670
|
+
},
|
|
671
|
+
{
|
|
672
|
+
"component": "page-shell",
|
|
673
|
+
"when": "contenedor de la vista que envuelve la cabecera y las secciones"
|
|
674
|
+
}
|
|
675
|
+
],
|
|
676
|
+
"exports": [
|
|
677
|
+
"PageHeader",
|
|
678
|
+
"PageHeaderActions",
|
|
679
|
+
"PageHeaderBreadcrumb",
|
|
680
|
+
"PageHeaderDescription",
|
|
681
|
+
"PageHeaderNotice",
|
|
682
|
+
"PageHeaderTitle",
|
|
683
|
+
"SectionHeader",
|
|
684
|
+
"SectionHeaderActions",
|
|
685
|
+
"SectionHeaderDescription",
|
|
686
|
+
"SectionHeaderIcon",
|
|
687
|
+
"SectionHeaderTitle",
|
|
688
|
+
"type PageHeaderPreset",
|
|
689
|
+
"type PageHeaderProps",
|
|
690
|
+
"type SectionHeaderProps"
|
|
691
|
+
],
|
|
692
|
+
"slots": [
|
|
693
|
+
"page-header",
|
|
694
|
+
"page-header-actions",
|
|
695
|
+
"page-header-breadcrumb",
|
|
696
|
+
"page-header-description",
|
|
697
|
+
"page-header-notice",
|
|
698
|
+
"page-header-title",
|
|
699
|
+
"section-header",
|
|
700
|
+
"section-header-actions",
|
|
701
|
+
"section-header-description",
|
|
702
|
+
"section-header-icon",
|
|
703
|
+
"section-header-title"
|
|
704
|
+
],
|
|
705
|
+
"optionalPeers": [],
|
|
706
|
+
"props": {
|
|
707
|
+
"PageHeader": {
|
|
708
|
+
"preset": {
|
|
709
|
+
"type": "PageHeaderPreset",
|
|
710
|
+
"values": [
|
|
711
|
+
"canvas",
|
|
712
|
+
"compact",
|
|
713
|
+
"page"
|
|
714
|
+
]
|
|
715
|
+
},
|
|
716
|
+
"title": {
|
|
717
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
718
|
+
"doc": "Atajo: título de la vista (h1). Equivale a <PageHeaderTitle>. No es el atributo HTML `title`."
|
|
719
|
+
},
|
|
720
|
+
"description": {
|
|
721
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
722
|
+
"doc": "Atajo: subtítulo. Equivale a <PageHeaderDescription>."
|
|
723
|
+
},
|
|
724
|
+
"actions": {
|
|
725
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
726
|
+
"doc": "Atajo: acciones de la vista. Equivale a <PageHeaderActions>."
|
|
727
|
+
}
|
|
728
|
+
},
|
|
729
|
+
"SectionHeader": {
|
|
730
|
+
"title": {
|
|
731
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
732
|
+
"doc": "Atajo: título del bloque (h2). Equivale a <SectionHeaderTitle>. No es el atributo HTML `title`."
|
|
733
|
+
},
|
|
734
|
+
"description": {
|
|
735
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
736
|
+
"doc": "Atajo: descripción. Equivale a <SectionHeaderDescription>."
|
|
737
|
+
},
|
|
738
|
+
"actions": {
|
|
739
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
740
|
+
"doc": "Atajo: acciones del bloque. Equivale a <SectionHeaderActions>."
|
|
741
|
+
},
|
|
742
|
+
"icon": {
|
|
743
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
744
|
+
"doc": "Atajo: icono (svg) en una baldosa. Equivale a <SectionHeaderIcon>."
|
|
745
|
+
},
|
|
746
|
+
"iconTone": {
|
|
747
|
+
"type": "\"info\" | \"success\" | \"warning\" | \"danger\" | \"primary\" | \"neutral\" | \"accent\"",
|
|
748
|
+
"values": [
|
|
749
|
+
"info",
|
|
750
|
+
"success",
|
|
751
|
+
"warning",
|
|
752
|
+
"danger",
|
|
753
|
+
"primary",
|
|
754
|
+
"neutral",
|
|
755
|
+
"accent"
|
|
756
|
+
],
|
|
757
|
+
"doc": "Tono de la baldosa del icono."
|
|
758
|
+
}
|
|
759
|
+
},
|
|
760
|
+
"SectionHeaderIcon": {
|
|
761
|
+
"size": {
|
|
762
|
+
"type": "\"sm\" | \"lg\" | \"md\"",
|
|
763
|
+
"values": [
|
|
764
|
+
"sm",
|
|
765
|
+
"lg",
|
|
766
|
+
"md"
|
|
767
|
+
]
|
|
768
|
+
},
|
|
769
|
+
"tone": {
|
|
770
|
+
"type": "\"info\" | \"success\" | \"warning\" | \"danger\" | \"primary\" | \"neutral\" | \"accent\"",
|
|
771
|
+
"values": [
|
|
772
|
+
"info",
|
|
773
|
+
"success",
|
|
774
|
+
"warning",
|
|
775
|
+
"danger",
|
|
776
|
+
"primary",
|
|
777
|
+
"neutral",
|
|
778
|
+
"accent"
|
|
779
|
+
]
|
|
780
|
+
}
|
|
781
|
+
}
|
|
782
|
+
},
|
|
783
|
+
"presets": {
|
|
784
|
+
"values": [
|
|
785
|
+
"page",
|
|
786
|
+
"compact",
|
|
787
|
+
"canvas"
|
|
788
|
+
],
|
|
789
|
+
"default": null,
|
|
790
|
+
"intent": {
|
|
791
|
+
"page": "vista normal: centrada en --ds-page-max-w, título grande",
|
|
792
|
+
"compact": "vista densa o dentro de un panel: título menor y menos aire",
|
|
793
|
+
"canvas": "lienzo a todo el ancho (mapa, kanban, editor): sin ancho máximo"
|
|
794
|
+
}
|
|
795
|
+
},
|
|
796
|
+
"notes": [
|
|
797
|
+
"Atajo: <PageHeader title description actions /> y <SectionHeader title description actions icon />; `title` es el texto visible, no el atributo HTML.",
|
|
798
|
+
"Cabecera de vista: PageHeaderTitle + PageHeaderDescription y la acción principal en PageHeaderActions; centrada en --ds-page-max-w.",
|
|
799
|
+
"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í."
|
|
800
|
+
],
|
|
801
|
+
"examples": [
|
|
802
|
+
{
|
|
803
|
+
"title": "Atajo con props",
|
|
804
|
+
"code": "<PageHeader\n title={t(\"clients.title\")}\n description={t(\"clients.description\")}\n actions={<Button>Nuevo cliente</Button>}\n/>"
|
|
805
|
+
},
|
|
806
|
+
{
|
|
807
|
+
"title": "Con piezas y aviso de página",
|
|
808
|
+
"code": "<PageHeader preset=\"compact\">\n <PageHeaderTitle>Operaciones</PageHeaderTitle>\n <PageHeaderDescription>Estado del servicio en tiempo real.</PageHeaderDescription>\n <PageHeaderNotice>\n <Banner variant=\"warning\">Mantenimiento esta noche.</Banner>\n </PageHeaderNotice>\n</PageHeader>"
|
|
809
|
+
},
|
|
810
|
+
{
|
|
811
|
+
"title": "Cabecera de un bloque (SectionHeader)",
|
|
812
|
+
"code": "<SectionHeader title={t(\"queues\")} description={t(\"last15\")} icon={<PhoneIcon />} iconTone=\"info\" actions={<Button size=\"sm\">Ver todas</Button>} />"
|
|
813
|
+
}
|
|
814
|
+
]
|
|
815
|
+
},
|
|
816
|
+
"page-shell": {
|
|
817
|
+
"import": "orbital-ds/ui/page-shell",
|
|
818
|
+
"group": "navigation",
|
|
819
|
+
"summary": "Contenedor del contenido de cada vista que fija ancho y separación: `content` para listas y paneles, `detail` para una entidad, `canvas` para lienzos a todo el ancho.",
|
|
820
|
+
"see": [
|
|
821
|
+
{
|
|
822
|
+
"component": "page-header",
|
|
823
|
+
"when": "cabecera de la vista, primer hijo del PageShell"
|
|
824
|
+
},
|
|
825
|
+
{
|
|
826
|
+
"component": "app-bar",
|
|
827
|
+
"when": "barra superior de la app, fuera del PageShell"
|
|
828
|
+
}
|
|
829
|
+
],
|
|
830
|
+
"exports": [
|
|
831
|
+
"PageShell",
|
|
832
|
+
"type PageShellPreset"
|
|
833
|
+
],
|
|
834
|
+
"slots": [
|
|
835
|
+
"page-shell"
|
|
836
|
+
],
|
|
837
|
+
"optionalPeers": [],
|
|
838
|
+
"props": {
|
|
839
|
+
"PageShell": {
|
|
840
|
+
"preset": {
|
|
841
|
+
"type": "PageShellPreset",
|
|
842
|
+
"values": [
|
|
843
|
+
"canvas",
|
|
844
|
+
"content",
|
|
845
|
+
"detail"
|
|
846
|
+
]
|
|
847
|
+
}
|
|
848
|
+
}
|
|
849
|
+
},
|
|
850
|
+
"presets": {
|
|
851
|
+
"values": [
|
|
852
|
+
"content",
|
|
853
|
+
"detail",
|
|
854
|
+
"canvas"
|
|
855
|
+
],
|
|
856
|
+
"default": "content",
|
|
857
|
+
"intent": {
|
|
858
|
+
"content": "centrado en --ds-page-max-w, secciones separadas por --ds-section-gap",
|
|
859
|
+
"detail": "columna estrecha (--ds-page-narrow-w) para leer o editar una sola entidad",
|
|
860
|
+
"canvas": "a todo el ancho, sin máximo (mapa, kanban, editor)"
|
|
861
|
+
}
|
|
862
|
+
},
|
|
863
|
+
"notes": [
|
|
864
|
+
"Envuelve cada vista: `content` para listas y paneles, `detail` para una entidad, `canvas` solo para lienzos (mapa, kanban, editor). La cabecera va dentro con PageHeader."
|
|
865
|
+
],
|
|
866
|
+
"examples": [
|
|
867
|
+
{
|
|
868
|
+
"title": "Vista de lista (preset content)",
|
|
869
|
+
"code": "<PageShell preset=\"content\">\n <PageHeader title={t(\"invoices.title\")} actions={<Button>Nueva factura</Button>} />\n <InvoiceTable />\n</PageShell>"
|
|
870
|
+
},
|
|
871
|
+
{
|
|
872
|
+
"title": "Detalle de una entidad",
|
|
873
|
+
"code": "<PageShell preset=\"detail\">\n <PageHeader title={client.name} />\n <ClientForm />\n</PageShell>"
|
|
874
|
+
}
|
|
875
|
+
]
|
|
876
|
+
},
|
|
877
|
+
"pagination": {
|
|
878
|
+
"import": "orbital-ds/ui/pagination",
|
|
879
|
+
"group": "navigation",
|
|
880
|
+
"summary": "Paginación por números para recorrer una lista o tabla larga página a página, con enlaces reales (href) para que cada página tenga su URL.",
|
|
881
|
+
"see": [
|
|
882
|
+
{
|
|
883
|
+
"component": "load-more",
|
|
884
|
+
"when": "cargar más resultados al final de la lista, sin páginas numeradas"
|
|
885
|
+
},
|
|
886
|
+
{
|
|
887
|
+
"component": "data-table",
|
|
888
|
+
"when": "tabla con su propia paginación, orden y filtros"
|
|
889
|
+
},
|
|
890
|
+
{
|
|
891
|
+
"component": "step-dots",
|
|
892
|
+
"when": "indicador de paso, no navegación entre páginas"
|
|
893
|
+
}
|
|
894
|
+
],
|
|
895
|
+
"exports": [
|
|
896
|
+
"Pagination",
|
|
897
|
+
"PaginationContent",
|
|
898
|
+
"PaginationEllipsis",
|
|
899
|
+
"PaginationItem",
|
|
900
|
+
"PaginationLink",
|
|
901
|
+
"PaginationNext",
|
|
902
|
+
"PaginationPrevious"
|
|
903
|
+
],
|
|
904
|
+
"slots": [
|
|
905
|
+
"pagination",
|
|
906
|
+
"pagination-content",
|
|
907
|
+
"pagination-ellipsis",
|
|
908
|
+
"pagination-item",
|
|
909
|
+
"pagination-link"
|
|
910
|
+
],
|
|
911
|
+
"optionalPeers": [],
|
|
912
|
+
"props": {
|
|
913
|
+
"PaginationLink": {
|
|
914
|
+
"isActive": {
|
|
915
|
+
"type": "boolean"
|
|
916
|
+
},
|
|
917
|
+
"size": {
|
|
918
|
+
"type": "\"default\" | \"xs\" | \"sm\" | \"lg\" | \"icon\" | \"icon-xs\" | \"icon-sm\" | \"icon-lg\"",
|
|
919
|
+
"values": [
|
|
920
|
+
"default",
|
|
921
|
+
"xs",
|
|
922
|
+
"sm",
|
|
923
|
+
"lg",
|
|
924
|
+
"icon",
|
|
925
|
+
"icon-xs",
|
|
926
|
+
"icon-sm",
|
|
927
|
+
"icon-lg"
|
|
928
|
+
]
|
|
929
|
+
}
|
|
930
|
+
},
|
|
931
|
+
"PaginationNext": {
|
|
932
|
+
"isActive": {
|
|
933
|
+
"type": "boolean"
|
|
934
|
+
},
|
|
935
|
+
"size": {
|
|
936
|
+
"type": "\"default\" | \"xs\" | \"sm\" | \"lg\" | \"icon\" | \"icon-xs\" | \"icon-sm\" | \"icon-lg\"",
|
|
937
|
+
"values": [
|
|
938
|
+
"default",
|
|
939
|
+
"xs",
|
|
940
|
+
"sm",
|
|
941
|
+
"lg",
|
|
942
|
+
"icon",
|
|
943
|
+
"icon-xs",
|
|
944
|
+
"icon-sm",
|
|
945
|
+
"icon-lg"
|
|
946
|
+
]
|
|
947
|
+
},
|
|
948
|
+
"text": {
|
|
949
|
+
"type": "string"
|
|
950
|
+
}
|
|
951
|
+
},
|
|
952
|
+
"PaginationPrevious": {
|
|
953
|
+
"isActive": {
|
|
954
|
+
"type": "boolean"
|
|
955
|
+
},
|
|
956
|
+
"size": {
|
|
957
|
+
"type": "\"default\" | \"xs\" | \"sm\" | \"lg\" | \"icon\" | \"icon-xs\" | \"icon-sm\" | \"icon-lg\"",
|
|
958
|
+
"values": [
|
|
959
|
+
"default",
|
|
960
|
+
"xs",
|
|
961
|
+
"sm",
|
|
962
|
+
"lg",
|
|
963
|
+
"icon",
|
|
964
|
+
"icon-xs",
|
|
965
|
+
"icon-sm",
|
|
966
|
+
"icon-lg"
|
|
967
|
+
]
|
|
968
|
+
},
|
|
969
|
+
"text": {
|
|
970
|
+
"type": "string"
|
|
971
|
+
}
|
|
972
|
+
}
|
|
973
|
+
},
|
|
974
|
+
"notes": [
|
|
975
|
+
"Marca la página actual con `isActive` (pone aria-current); «Anterior» y «Siguiente» salen del idioma activo y `text` los sobrescribe.",
|
|
976
|
+
"Para un listado que crece al final (feed), usa LoadMore en vez de páginas."
|
|
977
|
+
],
|
|
978
|
+
"examples": [
|
|
979
|
+
{
|
|
980
|
+
"title": "Páginas con anterior y siguiente",
|
|
981
|
+
"code": "<Pagination>\n <PaginationContent>\n <PaginationItem><PaginationPrevious href=\"?page=1\" /></PaginationItem>\n <PaginationItem><PaginationLink href=\"?page=1\">1</PaginationLink></PaginationItem>\n <PaginationItem><PaginationLink href=\"?page=2\" isActive>2</PaginationLink></PaginationItem>\n <PaginationItem><PaginationEllipsis /></PaginationItem>\n <PaginationItem><PaginationNext href=\"?page=3\" /></PaginationItem>\n </PaginationContent>\n</Pagination>"
|
|
982
|
+
}
|
|
983
|
+
]
|
|
984
|
+
},
|
|
985
|
+
"sidebar": {
|
|
986
|
+
"import": "orbital-ds/ui/sidebar",
|
|
987
|
+
"group": "navigation",
|
|
988
|
+
"summary": "Navegación principal lateral de una app (grupos, destinos, submenús), plegable a raíl de iconos; el `preset` elige el lateral por intención (app, workspace, admin, focus).",
|
|
989
|
+
"see": [
|
|
990
|
+
{
|
|
991
|
+
"component": "bottom-nav",
|
|
992
|
+
"when": "navegación principal en móvil con 3–5 destinos"
|
|
993
|
+
},
|
|
994
|
+
{
|
|
995
|
+
"component": "dock",
|
|
996
|
+
"when": "raíl visual de pocos iconos con efecto lupa"
|
|
997
|
+
},
|
|
998
|
+
{
|
|
999
|
+
"component": "navigation-menu",
|
|
1000
|
+
"when": "navegación horizontal de un sitio público"
|
|
1001
|
+
}
|
|
1002
|
+
],
|
|
1003
|
+
"exports": [
|
|
1004
|
+
"Sidebar",
|
|
1005
|
+
"SidebarContent",
|
|
1006
|
+
"SidebarFooter",
|
|
1007
|
+
"SidebarGroup",
|
|
1008
|
+
"SidebarGroupAction",
|
|
1009
|
+
"SidebarGroupContent",
|
|
1010
|
+
"SidebarGroupLabel",
|
|
1011
|
+
"SidebarHeader",
|
|
1012
|
+
"SidebarInput",
|
|
1013
|
+
"SidebarInset",
|
|
1014
|
+
"SidebarMenu",
|
|
1015
|
+
"SidebarMenuAction",
|
|
1016
|
+
"SidebarMenuBadge",
|
|
1017
|
+
"SidebarMenuButton",
|
|
1018
|
+
"SidebarMenuItem",
|
|
1019
|
+
"SidebarMenuSkeleton",
|
|
1020
|
+
"SidebarMenuSub",
|
|
1021
|
+
"SidebarMenuSubButton",
|
|
1022
|
+
"SidebarMenuSubItem",
|
|
1023
|
+
"SidebarProvider",
|
|
1024
|
+
"SidebarRail",
|
|
1025
|
+
"SidebarSeparator",
|
|
1026
|
+
"SidebarTrigger",
|
|
1027
|
+
"type SidebarIndicator",
|
|
1028
|
+
"type SidebarPreset",
|
|
1029
|
+
"type SidebarSurface",
|
|
1030
|
+
"type SidebarTone",
|
|
1031
|
+
"useSidebar"
|
|
1032
|
+
],
|
|
1033
|
+
"slots": [
|
|
1034
|
+
"sidebar",
|
|
1035
|
+
"sidebar-container",
|
|
1036
|
+
"sidebar-content",
|
|
1037
|
+
"sidebar-footer",
|
|
1038
|
+
"sidebar-gap",
|
|
1039
|
+
"sidebar-group",
|
|
1040
|
+
"sidebar-group-action",
|
|
1041
|
+
"sidebar-group-content",
|
|
1042
|
+
"sidebar-group-label",
|
|
1043
|
+
"sidebar-header",
|
|
1044
|
+
"sidebar-inner",
|
|
1045
|
+
"sidebar-input",
|
|
1046
|
+
"sidebar-inset",
|
|
1047
|
+
"sidebar-menu",
|
|
1048
|
+
"sidebar-menu-action",
|
|
1049
|
+
"sidebar-menu-badge",
|
|
1050
|
+
"sidebar-menu-button",
|
|
1051
|
+
"sidebar-menu-item",
|
|
1052
|
+
"sidebar-menu-skeleton",
|
|
1053
|
+
"sidebar-menu-sub",
|
|
1054
|
+
"sidebar-menu-sub-button",
|
|
1055
|
+
"sidebar-menu-sub-item",
|
|
1056
|
+
"sidebar-rail",
|
|
1057
|
+
"sidebar-separator",
|
|
1058
|
+
"sidebar-trigger",
|
|
1059
|
+
"sidebar-wrapper"
|
|
1060
|
+
],
|
|
1061
|
+
"optionalPeers": [],
|
|
1062
|
+
"props": {
|
|
1063
|
+
"Sidebar": {
|
|
1064
|
+
"side": {
|
|
1065
|
+
"type": "DsInlineSide",
|
|
1066
|
+
"values": [
|
|
1067
|
+
"start",
|
|
1068
|
+
"end",
|
|
1069
|
+
"right",
|
|
1070
|
+
"left"
|
|
1071
|
+
],
|
|
1072
|
+
"doc": "Lado: por defecto `start`, que sigue la dirección de lectura (izquierda en LTR, derecha en RTL); `end` al otro lado; `left`/`right` son físicos y no se invierten."
|
|
1073
|
+
},
|
|
1074
|
+
"preset": {
|
|
1075
|
+
"type": "SidebarPreset",
|
|
1076
|
+
"values": [
|
|
1077
|
+
"app",
|
|
1078
|
+
"focus",
|
|
1079
|
+
"workspace",
|
|
1080
|
+
"admin"
|
|
1081
|
+
],
|
|
1082
|
+
"doc": "Intención: fija variant, collapsible y density por defecto (las props explícitas mandan)."
|
|
1083
|
+
},
|
|
1084
|
+
"variant": {
|
|
1085
|
+
"type": "SidebarVariant",
|
|
1086
|
+
"values": [
|
|
1087
|
+
"sidebar",
|
|
1088
|
+
"floating",
|
|
1089
|
+
"inset"
|
|
1090
|
+
]
|
|
1091
|
+
},
|
|
1092
|
+
"collapsible": {
|
|
1093
|
+
"type": "SidebarCollapsible",
|
|
1094
|
+
"values": [
|
|
1095
|
+
"icon",
|
|
1096
|
+
"none",
|
|
1097
|
+
"offcanvas"
|
|
1098
|
+
]
|
|
1099
|
+
},
|
|
1100
|
+
"density": {
|
|
1101
|
+
"type": "DsDensity",
|
|
1102
|
+
"values": [
|
|
1103
|
+
"default",
|
|
1104
|
+
"compact",
|
|
1105
|
+
"comfortable"
|
|
1106
|
+
],
|
|
1107
|
+
"doc": "Altura de las filas: compact (backoffice), default o comfortable."
|
|
1108
|
+
},
|
|
1109
|
+
"tone": {
|
|
1110
|
+
"type": "SidebarTone",
|
|
1111
|
+
"values": [
|
|
1112
|
+
"default",
|
|
1113
|
+
"brand",
|
|
1114
|
+
"contrast"
|
|
1115
|
+
],
|
|
1116
|
+
"doc": "Color del lateral: el del tema, el de la marca o invertido."
|
|
1117
|
+
},
|
|
1118
|
+
"indicator": {
|
|
1119
|
+
"type": "SidebarIndicator",
|
|
1120
|
+
"values": [
|
|
1121
|
+
"fill",
|
|
1122
|
+
"bar"
|
|
1123
|
+
],
|
|
1124
|
+
"doc": "Cómo se marca el destino activo: fondo o fondo y barra al inicio."
|
|
1125
|
+
}
|
|
1126
|
+
},
|
|
1127
|
+
"SidebarInset": {
|
|
1128
|
+
"surface": {
|
|
1129
|
+
"type": "SidebarSurface",
|
|
1130
|
+
"values": [
|
|
1131
|
+
"flat",
|
|
1132
|
+
"glass",
|
|
1133
|
+
"floating"
|
|
1134
|
+
]
|
|
1135
|
+
}
|
|
1136
|
+
},
|
|
1137
|
+
"SidebarMenuAction": {
|
|
1138
|
+
"showOnHover": {
|
|
1139
|
+
"type": "boolean"
|
|
1140
|
+
}
|
|
1141
|
+
},
|
|
1142
|
+
"SidebarMenuButton": {
|
|
1143
|
+
"isActive": {
|
|
1144
|
+
"type": "boolean"
|
|
1145
|
+
},
|
|
1146
|
+
"tooltip": {
|
|
1147
|
+
"type": "string | (TooltipPopupProps & Pick<TooltipPositionerProps, \"align\" | \"side\" | \"sideOffset\" | \"alignOffset\">)"
|
|
1148
|
+
},
|
|
1149
|
+
"variant": {
|
|
1150
|
+
"type": "\"default\" | \"outline\"",
|
|
1151
|
+
"values": [
|
|
1152
|
+
"default",
|
|
1153
|
+
"outline"
|
|
1154
|
+
]
|
|
1155
|
+
},
|
|
1156
|
+
"size": {
|
|
1157
|
+
"type": "\"default\" | \"sm\" | \"lg\"",
|
|
1158
|
+
"values": [
|
|
1159
|
+
"default",
|
|
1160
|
+
"sm",
|
|
1161
|
+
"lg"
|
|
1162
|
+
]
|
|
1163
|
+
}
|
|
1164
|
+
},
|
|
1165
|
+
"SidebarMenuSkeleton": {
|
|
1166
|
+
"showIcon": {
|
|
1167
|
+
"type": "boolean"
|
|
1168
|
+
}
|
|
1169
|
+
},
|
|
1170
|
+
"SidebarMenuSubButton": {
|
|
1171
|
+
"size": {
|
|
1172
|
+
"type": "\"sm\" | \"md\"",
|
|
1173
|
+
"values": [
|
|
1174
|
+
"sm",
|
|
1175
|
+
"md"
|
|
1176
|
+
]
|
|
1177
|
+
},
|
|
1178
|
+
"isActive": {
|
|
1179
|
+
"type": "boolean"
|
|
1180
|
+
}
|
|
1181
|
+
},
|
|
1182
|
+
"SidebarProvider": {
|
|
1183
|
+
"defaultOpen": {
|
|
1184
|
+
"type": "boolean"
|
|
1185
|
+
},
|
|
1186
|
+
"open": {
|
|
1187
|
+
"type": "boolean"
|
|
1188
|
+
},
|
|
1189
|
+
"onOpenChange": {
|
|
1190
|
+
"type": "(open: boolean) => void"
|
|
1191
|
+
}
|
|
1192
|
+
},
|
|
1193
|
+
"SidebarTrigger": {
|
|
1194
|
+
"variant": {
|
|
1195
|
+
"type": "\"link\" | \"default\" | \"outline\" | \"secondary\" | \"ghost\" | \"destructive\" | \"cta\"",
|
|
1196
|
+
"values": [
|
|
1197
|
+
"link",
|
|
1198
|
+
"default",
|
|
1199
|
+
"outline",
|
|
1200
|
+
"secondary",
|
|
1201
|
+
"ghost",
|
|
1202
|
+
"destructive",
|
|
1203
|
+
"cta"
|
|
1204
|
+
]
|
|
1205
|
+
},
|
|
1206
|
+
"size": {
|
|
1207
|
+
"type": "\"default\" | \"xs\" | \"sm\" | \"lg\" | \"icon\" | \"icon-xs\" | \"icon-sm\" | \"icon-lg\"",
|
|
1208
|
+
"values": [
|
|
1209
|
+
"default",
|
|
1210
|
+
"xs",
|
|
1211
|
+
"sm",
|
|
1212
|
+
"lg",
|
|
1213
|
+
"icon",
|
|
1214
|
+
"icon-xs",
|
|
1215
|
+
"icon-sm",
|
|
1216
|
+
"icon-lg"
|
|
1217
|
+
]
|
|
1218
|
+
},
|
|
1219
|
+
"nativeButton": {
|
|
1220
|
+
"type": "boolean"
|
|
1221
|
+
}
|
|
1222
|
+
}
|
|
1223
|
+
},
|
|
1224
|
+
"presets": {
|
|
1225
|
+
"values": [
|
|
1226
|
+
"app",
|
|
1227
|
+
"workspace",
|
|
1228
|
+
"admin",
|
|
1229
|
+
"focus"
|
|
1230
|
+
],
|
|
1231
|
+
"default": null,
|
|
1232
|
+
"intent": {
|
|
1233
|
+
"app": "producto o app de cliente: dock flotante que se pliega a raíl de iconos",
|
|
1234
|
+
"workspace": "herramienta de trabajo diario: el contenido como hoja sobre el lateral (inset), plegable a iconos",
|
|
1235
|
+
"admin": "backoffice con muchos destinos: lateral fijo, filas más densas, plegable a iconos",
|
|
1236
|
+
"focus": "editor, mapa o lienzo: se oculta del todo para dejar sitio al trabajo"
|
|
1237
|
+
}
|
|
1238
|
+
},
|
|
1239
|
+
"notes": [
|
|
1240
|
+
"`glass` solo luce si hay algo detrás (fondo de la app o imagen); en el resto, `floating` o `flat`.",
|
|
1241
|
+
"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.",
|
|
1242
|
+
"Con `collapsible=\"icon\"` cada SidebarMenuButton necesita su icono y su `tooltip`: plegado solo se ve el icono.",
|
|
1243
|
+
"El lateral sigue la dirección de lectura por defecto (`side=\"start\"`): en RTL pasa solo a la derecha si la app monta DsI18nProvider (o DirectionProvider) y pone `dir` en el HTML. `left`/`right` lo fijan a un lado físico."
|
|
1244
|
+
],
|
|
1245
|
+
"examples": [
|
|
1246
|
+
{
|
|
1247
|
+
"title": "Montaje mínimo (preset workspace)",
|
|
1248
|
+
"code": "<SidebarProvider>\n <Sidebar preset=\"workspace\">\n <SidebarContent>\n <SidebarGroup>\n <SidebarGroupLabel>Gestión</SidebarGroupLabel>\n <SidebarGroupContent>\n <SidebarMenu>\n <SidebarMenuItem>\n <SidebarMenuButton isActive tooltip=\"Clientes\" render={<Link to=\"/clients\" />}>\n <UsersIcon />\n <span>Clientes</span>\n </SidebarMenuButton>\n </SidebarMenuItem>\n </SidebarMenu>\n </SidebarGroupContent>\n </SidebarGroup>\n </SidebarContent>\n </Sidebar>\n <SidebarInset>\n <AppBar>\n <SidebarTrigger />\n </AppBar>\n </SidebarInset>\n</SidebarProvider>"
|
|
1249
|
+
},
|
|
1250
|
+
{
|
|
1251
|
+
"title": "Backoffice con el color de la marca y barra de activo",
|
|
1252
|
+
"code": "<Sidebar preset=\"admin\" tone=\"brand\" indicator=\"bar\">\n <SidebarContent>\n <SidebarMenu>\n <SidebarMenuItem>\n <SidebarMenuButton isActive tooltip=\"Usuarios\">\n <UsersIcon />\n <span>Usuarios</span>\n </SidebarMenuButton>\n </SidebarMenuItem>\n </SidebarMenu>\n </SidebarContent>\n</Sidebar>"
|
|
1253
|
+
}
|
|
1254
|
+
]
|
|
1255
|
+
},
|
|
1256
|
+
"step-dots": {
|
|
1257
|
+
"import": "orbital-ds/ui/step-dots",
|
|
1258
|
+
"group": "navigation",
|
|
1259
|
+
"summary": "Indicador no interactivo del paso actual como puntos (onboarding, carrusel, asistente corto), sin títulos.",
|
|
1260
|
+
"see": [
|
|
1261
|
+
{
|
|
1262
|
+
"component": "stepper",
|
|
1263
|
+
"when": "pasos con título y estado (completo, actual, error)"
|
|
1264
|
+
},
|
|
1265
|
+
{
|
|
1266
|
+
"component": "step-ring",
|
|
1267
|
+
"when": "avance compacto en un círculo, para una fila de tabla"
|
|
1268
|
+
},
|
|
1269
|
+
{
|
|
1270
|
+
"component": "carousel",
|
|
1271
|
+
"when": "pasar diapositivas con controles"
|
|
1272
|
+
}
|
|
1273
|
+
],
|
|
1274
|
+
"exports": [
|
|
1275
|
+
"StepDots"
|
|
1276
|
+
],
|
|
1277
|
+
"slots": [
|
|
1278
|
+
"step-dot",
|
|
1279
|
+
"step-dots"
|
|
1280
|
+
],
|
|
1281
|
+
"optionalPeers": [],
|
|
1282
|
+
"props": {
|
|
1283
|
+
"StepDots": {
|
|
1284
|
+
"count": {
|
|
1285
|
+
"type": "number",
|
|
1286
|
+
"required": true,
|
|
1287
|
+
"doc": "Número de pasos."
|
|
1288
|
+
},
|
|
1289
|
+
"current": {
|
|
1290
|
+
"type": "number",
|
|
1291
|
+
"required": true,
|
|
1292
|
+
"doc": "Paso actual, empezando en 1."
|
|
1293
|
+
}
|
|
1294
|
+
}
|
|
1295
|
+
},
|
|
1296
|
+
"notes": [
|
|
1297
|
+
"`current` empieza en 1; el texto accesible («Paso 2 de 5») lo pone la pieza.",
|
|
1298
|
+
"No navega: si la persona debe saltar entre pasos, usa Stepper o los controles de Carousel."
|
|
1299
|
+
],
|
|
1300
|
+
"examples": [
|
|
1301
|
+
{
|
|
1302
|
+
"title": "Paso 2 de 5",
|
|
1303
|
+
"code": "<StepDots count={5} current={2} />"
|
|
1304
|
+
}
|
|
1305
|
+
]
|
|
1306
|
+
},
|
|
1307
|
+
"step-flow": {
|
|
1308
|
+
"import": "orbital-ds/ui/step-flow",
|
|
1309
|
+
"group": "navigation",
|
|
1310
|
+
"summary": "Asistente completo por pasos (alta, activación, configuración) en modal o página, con progreso, navegación, revisión y resultado; la app solo aporta los pasos.",
|
|
1311
|
+
"see": [
|
|
1312
|
+
{
|
|
1313
|
+
"component": "stepper",
|
|
1314
|
+
"when": "solo el indicador de pasos, para un flujo propio"
|
|
1315
|
+
},
|
|
1316
|
+
{
|
|
1317
|
+
"component": "form-layout",
|
|
1318
|
+
"when": "formulario de una sola pantalla, sin pasos"
|
|
1319
|
+
},
|
|
1320
|
+
{
|
|
1321
|
+
"component": "dialog",
|
|
1322
|
+
"when": "una tarea corta sin pasos"
|
|
1323
|
+
}
|
|
1324
|
+
],
|
|
1325
|
+
"exports": [
|
|
1326
|
+
"StepFlow",
|
|
1327
|
+
"type StepFlowPresentation",
|
|
1328
|
+
"type StepFlowPreset",
|
|
1329
|
+
"type StepFlowProgress",
|
|
1330
|
+
"type StepFlowProps",
|
|
1331
|
+
"type StepFlowStep"
|
|
1332
|
+
],
|
|
1333
|
+
"slots": [
|
|
1334
|
+
"step-flow",
|
|
1335
|
+
"step-flow-aside",
|
|
1336
|
+
"step-flow-body",
|
|
1337
|
+
"step-flow-footer",
|
|
1338
|
+
"step-flow-header",
|
|
1339
|
+
"step-flow-page",
|
|
1340
|
+
"step-flow-progress",
|
|
1341
|
+
"step-flow-result"
|
|
1342
|
+
],
|
|
1343
|
+
"optionalPeers": [],
|
|
1344
|
+
"props": {
|
|
1345
|
+
"StepFlow": {
|
|
1346
|
+
"steps": {
|
|
1347
|
+
"type": "StepFlowStep[]",
|
|
1348
|
+
"required": true
|
|
1349
|
+
},
|
|
1350
|
+
"preset": {
|
|
1351
|
+
"type": "StepFlowPreset",
|
|
1352
|
+
"values": [
|
|
1353
|
+
"long",
|
|
1354
|
+
"quick",
|
|
1355
|
+
"activation"
|
|
1356
|
+
]
|
|
1357
|
+
},
|
|
1358
|
+
"presentation": {
|
|
1359
|
+
"type": "StepFlowPresentation",
|
|
1360
|
+
"values": [
|
|
1361
|
+
"dialog",
|
|
1362
|
+
"page"
|
|
1363
|
+
]
|
|
1364
|
+
},
|
|
1365
|
+
"progress": {
|
|
1366
|
+
"type": "StepFlowProgress",
|
|
1367
|
+
"values": [
|
|
1368
|
+
"compact",
|
|
1369
|
+
"horizontal",
|
|
1370
|
+
"vertical"
|
|
1371
|
+
]
|
|
1372
|
+
},
|
|
1373
|
+
"title": {
|
|
1374
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
1375
|
+
"required": true
|
|
1376
|
+
},
|
|
1377
|
+
"description": {
|
|
1378
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…"
|
|
1379
|
+
},
|
|
1380
|
+
"aside": {
|
|
1381
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
1382
|
+
"doc": "Vista previa o ayuda: columna al final en contenedor ancho; se oculta en estrecho."
|
|
1383
|
+
},
|
|
1384
|
+
"review": {
|
|
1385
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
1386
|
+
"doc": "Resumen final: añade un último paso con este contenido."
|
|
1387
|
+
},
|
|
1388
|
+
"result": {
|
|
1389
|
+
"type": "string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |…",
|
|
1390
|
+
"doc": "Si existe, sustituye al asistente (paso hecho): éxito, error o siguiente acción."
|
|
1391
|
+
},
|
|
1392
|
+
"value": {
|
|
1393
|
+
"type": "string",
|
|
1394
|
+
"doc": "Paso actual (id) controlado."
|
|
1395
|
+
},
|
|
1396
|
+
"defaultValue": {
|
|
1397
|
+
"type": "string"
|
|
1398
|
+
},
|
|
1399
|
+
"onValueChange": {
|
|
1400
|
+
"type": "(id: string) => void"
|
|
1401
|
+
},
|
|
1402
|
+
"onComplete": {
|
|
1403
|
+
"type": "() => void | Promise<void>",
|
|
1404
|
+
"doc": "Se llama al terminar el último paso; si devuelve una promesa, bloquea los botones hasta resolverla."
|
|
1405
|
+
},
|
|
1406
|
+
"onCancel": {
|
|
1407
|
+
"type": "() => void",
|
|
1408
|
+
"doc": "Se llama al cancelar o cerrar (tras confirmar si `dirty`)."
|
|
1409
|
+
},
|
|
1410
|
+
"dirty": {
|
|
1411
|
+
"type": "boolean",
|
|
1412
|
+
"doc": "Hay cambios sin guardar: pide confirmación antes de cerrar."
|
|
1413
|
+
},
|
|
1414
|
+
"open": {
|
|
1415
|
+
"type": "boolean",
|
|
1416
|
+
"doc": "Solo `dialog`."
|
|
1417
|
+
},
|
|
1418
|
+
"onOpenChange": {
|
|
1419
|
+
"type": "(open: boolean) => void"
|
|
1420
|
+
},
|
|
1421
|
+
"className": {
|
|
1422
|
+
"type": "string"
|
|
1423
|
+
}
|
|
1424
|
+
}
|
|
1425
|
+
},
|
|
1426
|
+
"presets": {
|
|
1427
|
+
"values": [
|
|
1428
|
+
"quick",
|
|
1429
|
+
"activation",
|
|
1430
|
+
"long"
|
|
1431
|
+
],
|
|
1432
|
+
"default": "activation",
|
|
1433
|
+
"intent": {
|
|
1434
|
+
"quick": "2–3 pasos, formulario simple → dialog · compact · sin lateral",
|
|
1435
|
+
"activation": "3–6 pasos, vista previa/resultado → dialog · horizontal · lateral al final",
|
|
1436
|
+
"long": "6 pasos o más, secciones libres → page · vertical · lateral opcional"
|
|
1437
|
+
}
|
|
1438
|
+
},
|
|
1439
|
+
"notes": [
|
|
1440
|
+
"Para altas y configuraciones por pasos. Elige un `preset` (quick, activation, long) y sobrescribe lo que haga falta; presentación y densidad son independientes.",
|
|
1441
|
+
"El estado de los campos vive en la app: solo se monta el paso actual. `invalid` bloquea «Siguiente»; `dirty` pide confirmar al cerrar.",
|
|
1442
|
+
"Una sola tarea corta sin pasos no necesita StepFlow: usa Dialog. El lateral (`aside`) se oculta en contenedor estrecho; no pongas ahí nada imprescindible."
|
|
1443
|
+
],
|
|
1444
|
+
"examples": [
|
|
1445
|
+
{
|
|
1446
|
+
"title": "Preset activation en modal",
|
|
1447
|
+
"code": "<StepFlow\n preset=\"activation\"\n open={open}\n onOpenChange={setOpen}\n title={t(\"widget.create\")}\n steps={[\n { id: \"data\", title: \"Datos\", content: <DataForm />, invalid: !valid },\n { id: \"style\", title: \"Aspecto\", content: <StyleForm /> },\n ]}\n onComplete={save}\n/>"
|
|
1448
|
+
},
|
|
1449
|
+
{
|
|
1450
|
+
"title": "Preset long en página",
|
|
1451
|
+
"code": "<StepFlow preset=\"long\" title={t(\"settings\")} steps={steps} aside={<Help />} onComplete={save} />"
|
|
1452
|
+
}
|
|
1453
|
+
]
|
|
1454
|
+
},
|
|
1455
|
+
"step-ring": {
|
|
1456
|
+
"import": "orbital-ds/ui/step-ring",
|
|
1457
|
+
"group": "navigation",
|
|
1458
|
+
"summary": "Avance compacto de un proceso por pasos en un círculo de sectores (completados, actual, pendientes); cabe en una fila de tabla o junto a un título.",
|
|
1459
|
+
"see": [
|
|
1460
|
+
{
|
|
1461
|
+
"component": "stepper",
|
|
1462
|
+
"when": "pasos visibles con su título y estado"
|
|
1463
|
+
},
|
|
1464
|
+
{
|
|
1465
|
+
"component": "step-dots",
|
|
1466
|
+
"when": "paso actual de un onboarding o carrusel"
|
|
1467
|
+
},
|
|
1468
|
+
{
|
|
1469
|
+
"component": "task-progress",
|
|
1470
|
+
"when": "barra de avance de una tarea con etiqueta y contador"
|
|
1471
|
+
}
|
|
1472
|
+
],
|
|
1473
|
+
"exports": [
|
|
1474
|
+
"StepRing"
|
|
1475
|
+
],
|
|
1476
|
+
"slots": [
|
|
1477
|
+
"step-ring"
|
|
1478
|
+
],
|
|
1479
|
+
"optionalPeers": [],
|
|
1480
|
+
"props": {
|
|
1481
|
+
"StepRing": {
|
|
1482
|
+
"total": {
|
|
1483
|
+
"type": "number",
|
|
1484
|
+
"doc": "Número de sectores (pasos)."
|
|
1485
|
+
},
|
|
1486
|
+
"completed": {
|
|
1487
|
+
"type": "number",
|
|
1488
|
+
"required": true,
|
|
1489
|
+
"doc": "Pasos completados."
|
|
1490
|
+
},
|
|
1491
|
+
"current": {
|
|
1492
|
+
"type": "boolean",
|
|
1493
|
+
"doc": "El paso siguiente a los completados está en curso."
|
|
1494
|
+
}
|
|
1495
|
+
}
|
|
1496
|
+
},
|
|
1497
|
+
"notes": [
|
|
1498
|
+
"El texto accesible («2 de 4 pasos completados») lo pone la pieza; no añadas otro.",
|
|
1499
|
+
"`current` pinta en curso el paso siguiente a los completados; úsalo con pocos pasos (≤ 8) para que los sectores se distingan."
|
|
1500
|
+
],
|
|
1501
|
+
"examples": [
|
|
1502
|
+
{
|
|
1503
|
+
"title": "2 de 4 completados y el 3.º en curso",
|
|
1504
|
+
"code": "<StepRing total={4} completed={2} current />"
|
|
1505
|
+
},
|
|
1506
|
+
{
|
|
1507
|
+
"title": "Proceso terminado",
|
|
1508
|
+
"code": "<StepRing total={5} completed={5} />"
|
|
1509
|
+
}
|
|
1510
|
+
]
|
|
1511
|
+
},
|
|
1512
|
+
"stepper": {
|
|
1513
|
+
"import": "orbital-ds/ui/stepper",
|
|
1514
|
+
"group": "navigation",
|
|
1515
|
+
"summary": "Indicador de los pasos de un proceso con título y estado (completo, actual, pendiente, error); solo pinta, el flujo lo lleva la app.",
|
|
1516
|
+
"see": [
|
|
1517
|
+
{
|
|
1518
|
+
"component": "step-flow",
|
|
1519
|
+
"when": "asistente completo con navegación, en modal o página"
|
|
1520
|
+
},
|
|
1521
|
+
{
|
|
1522
|
+
"component": "step-dots",
|
|
1523
|
+
"when": "puntos sin títulos para onboarding o carrusel"
|
|
1524
|
+
},
|
|
1525
|
+
{
|
|
1526
|
+
"component": "step-ring",
|
|
1527
|
+
"when": "avance compacto en un círculo, en una fila"
|
|
1528
|
+
}
|
|
1529
|
+
],
|
|
1530
|
+
"exports": [
|
|
1531
|
+
"Stepper",
|
|
1532
|
+
"StepperContent",
|
|
1533
|
+
"StepperDescription",
|
|
1534
|
+
"StepperIndicator",
|
|
1535
|
+
"StepperItem",
|
|
1536
|
+
"StepperSeparator",
|
|
1537
|
+
"StepperTitle",
|
|
1538
|
+
"type StepStatus",
|
|
1539
|
+
"type StepperOrientation"
|
|
1540
|
+
],
|
|
1541
|
+
"slots": [
|
|
1542
|
+
"stepper",
|
|
1543
|
+
"stepper-content",
|
|
1544
|
+
"stepper-description",
|
|
1545
|
+
"stepper-indicator",
|
|
1546
|
+
"stepper-item",
|
|
1547
|
+
"stepper-separator",
|
|
1548
|
+
"stepper-title"
|
|
1549
|
+
],
|
|
1550
|
+
"optionalPeers": [],
|
|
1551
|
+
"props": {
|
|
1552
|
+
"Stepper": {
|
|
1553
|
+
"orientation": {
|
|
1554
|
+
"type": "StepperOrientation",
|
|
1555
|
+
"values": [
|
|
1556
|
+
"horizontal",
|
|
1557
|
+
"vertical"
|
|
1558
|
+
]
|
|
1559
|
+
}
|
|
1560
|
+
},
|
|
1561
|
+
"StepperItem": {
|
|
1562
|
+
"status": {
|
|
1563
|
+
"type": "StepStatus",
|
|
1564
|
+
"values": [
|
|
1565
|
+
"error",
|
|
1566
|
+
"complete",
|
|
1567
|
+
"current",
|
|
1568
|
+
"upcoming"
|
|
1569
|
+
],
|
|
1570
|
+
"doc": "Estado del paso: completo, actual, pendiente o con error."
|
|
1571
|
+
},
|
|
1572
|
+
"step": {
|
|
1573
|
+
"type": "number",
|
|
1574
|
+
"doc": "Número del paso (desde 1): se pinta en el indicador y se anuncia."
|
|
1575
|
+
}
|
|
1576
|
+
}
|
|
1577
|
+
},
|
|
1578
|
+
"notes": [
|
|
1579
|
+
"Pon StepperSeparator en todos los pasos salvo el último.",
|
|
1580
|
+
"Para un asistente con navegación entre pasos usa StepFlow, que ya monta Stepper."
|
|
1581
|
+
],
|
|
1582
|
+
"examples": [
|
|
1583
|
+
{
|
|
1584
|
+
"title": "Paso completado y paso actual",
|
|
1585
|
+
"code": "<Stepper>\n <StepperItem step={1} status=\"complete\">\n <StepperIndicator />\n <StepperContent>\n <StepperTitle>Datos</StepperTitle>\n </StepperContent>\n <StepperSeparator />\n </StepperItem>\n <StepperItem step={2} status=\"current\">\n <StepperIndicator />\n <StepperContent>\n <StepperTitle>Pago</StepperTitle>\n <StepperDescription>Tarjeta o transferencia</StepperDescription>\n </StepperContent>\n </StepperItem>\n</Stepper>"
|
|
1586
|
+
},
|
|
1587
|
+
{
|
|
1588
|
+
"title": "Vertical con un paso con error",
|
|
1589
|
+
"code": "<Stepper orientation=\"vertical\">\n <StepperItem step={1} status=\"error\">\n <StepperIndicator />\n <StepperContent>\n <StepperTitle>Importar fichero</StepperTitle>\n </StepperContent>\n </StepperItem>\n</Stepper>"
|
|
1590
|
+
}
|
|
1591
|
+
]
|
|
1592
|
+
},
|
|
1593
|
+
"tabs": {
|
|
1594
|
+
"import": "orbital-ds/ui/tabs",
|
|
1595
|
+
"group": "navigation",
|
|
1596
|
+
"summary": "Pestañas para cambiar entre vistas hermanas del mismo contenido sin salir de la página (Resumen, Facturas, Pagos).",
|
|
1597
|
+
"see": [
|
|
1598
|
+
{
|
|
1599
|
+
"component": "navigation-menu",
|
|
1600
|
+
"when": "enlaces entre páginas de un sitio"
|
|
1601
|
+
},
|
|
1602
|
+
{
|
|
1603
|
+
"component": "toggle-group",
|
|
1604
|
+
"when": "elegir una opción o un filtro, no cambiar de panel"
|
|
1605
|
+
},
|
|
1606
|
+
{
|
|
1607
|
+
"component": "accordion",
|
|
1608
|
+
"when": "secciones que se despliegan una debajo de otra"
|
|
1609
|
+
}
|
|
1610
|
+
],
|
|
1611
|
+
"exports": [
|
|
1612
|
+
"Tabs",
|
|
1613
|
+
"TabsContent",
|
|
1614
|
+
"TabsList",
|
|
1615
|
+
"TabsTrigger",
|
|
1616
|
+
"tabsListVariants"
|
|
1617
|
+
],
|
|
1618
|
+
"slots": [
|
|
1619
|
+
"tabs",
|
|
1620
|
+
"tabs-content",
|
|
1621
|
+
"tabs-list",
|
|
1622
|
+
"tabs-trigger"
|
|
1623
|
+
],
|
|
1624
|
+
"optionalPeers": [],
|
|
1625
|
+
"props": {
|
|
1626
|
+
"TabsList": {
|
|
1627
|
+
"variant": {
|
|
1628
|
+
"type": "\"line\" | \"default\"",
|
|
1629
|
+
"values": [
|
|
1630
|
+
"line",
|
|
1631
|
+
"default"
|
|
1632
|
+
]
|
|
1633
|
+
}
|
|
1634
|
+
}
|
|
1635
|
+
},
|
|
1636
|
+
"notes": [
|
|
1637
|
+
"Cada TabsTrigger necesita su TabsContent con el mismo `value`.",
|
|
1638
|
+
"Con más de 5–6 pestañas, o si son destinos de la app, usa Sidebar o NavigationMenu."
|
|
1639
|
+
],
|
|
1640
|
+
"examples": [
|
|
1641
|
+
{
|
|
1642
|
+
"title": "Pestañas con su panel",
|
|
1643
|
+
"code": "<Tabs defaultValue=\"summary\">\n <TabsList>\n <TabsTrigger value=\"summary\">Resumen</TabsTrigger>\n <TabsTrigger value=\"invoices\">Facturas</TabsTrigger>\n </TabsList>\n <TabsContent value=\"summary\"><SummaryPanel /></TabsContent>\n <TabsContent value=\"invoices\"><InvoiceTable /></TabsContent>\n</Tabs>"
|
|
1644
|
+
},
|
|
1645
|
+
{
|
|
1646
|
+
"title": "Variante line, controlada",
|
|
1647
|
+
"code": "<Tabs value={tab} onValueChange={setTab}>\n <TabsList variant=\"line\">\n <TabsTrigger value=\"general\">General</TabsTrigger>\n <TabsTrigger value=\"security\">Seguridad</TabsTrigger>\n </TabsList>\n</Tabs>"
|
|
1648
|
+
}
|
|
1649
|
+
]
|
|
1650
|
+
},
|
|
1651
|
+
"theme-toggle": {
|
|
1652
|
+
"import": "orbital-ds/ui/theme-toggle",
|
|
1653
|
+
"group": "navigation",
|
|
1654
|
+
"summary": "Selector de claro, oscuro o sistema: `icon` en la barra superior, `segmented` en Configuración. Solo avisa: la app guarda el valor y pone `.dark`.",
|
|
1655
|
+
"see": [
|
|
1656
|
+
{
|
|
1657
|
+
"component": "locale-switcher",
|
|
1658
|
+
"when": "elegir el idioma, a su lado en la barra"
|
|
1659
|
+
},
|
|
1660
|
+
{
|
|
1661
|
+
"component": "toggle-group",
|
|
1662
|
+
"when": "elegir entre opciones propias de la vista"
|
|
1663
|
+
}
|
|
1664
|
+
],
|
|
1665
|
+
"exports": [
|
|
1666
|
+
"ThemeToggle"
|
|
1667
|
+
],
|
|
1668
|
+
"slots": [
|
|
1669
|
+
"theme-toggle"
|
|
1670
|
+
],
|
|
1671
|
+
"optionalPeers": [],
|
|
1672
|
+
"props": {
|
|
1673
|
+
"ThemeToggle": {
|
|
1674
|
+
"value": {
|
|
1675
|
+
"type": "ThemeMode",
|
|
1676
|
+
"values": [
|
|
1677
|
+
"system",
|
|
1678
|
+
"light",
|
|
1679
|
+
"dark"
|
|
1680
|
+
]
|
|
1681
|
+
},
|
|
1682
|
+
"onValueChange": {
|
|
1683
|
+
"type": "(value: ThemeMode) => void"
|
|
1684
|
+
},
|
|
1685
|
+
"preset": {
|
|
1686
|
+
"type": "ThemeTogglePreset",
|
|
1687
|
+
"values": [
|
|
1688
|
+
"icon",
|
|
1689
|
+
"cycle",
|
|
1690
|
+
"segmented"
|
|
1691
|
+
]
|
|
1692
|
+
},
|
|
1693
|
+
"tone": {
|
|
1694
|
+
"type": "HeaderControlTone",
|
|
1695
|
+
"values": [
|
|
1696
|
+
"brand",
|
|
1697
|
+
"soft",
|
|
1698
|
+
"neutral"
|
|
1699
|
+
]
|
|
1700
|
+
},
|
|
1701
|
+
"className": {
|
|
1702
|
+
"type": "string"
|
|
1703
|
+
}
|
|
1704
|
+
}
|
|
1705
|
+
},
|
|
1706
|
+
"presets": {
|
|
1707
|
+
"values": [
|
|
1708
|
+
"icon",
|
|
1709
|
+
"cycle",
|
|
1710
|
+
"segmented"
|
|
1711
|
+
],
|
|
1712
|
+
"default": "icon",
|
|
1713
|
+
"intent": {
|
|
1714
|
+
"icon": "botón de icono en la barra superior: abre un menú con las tres opciones",
|
|
1715
|
+
"cycle": "botón de icono que pasa de uno a otro al pulsarlo (sin menú)",
|
|
1716
|
+
"segmented": "tres opciones a la vista, para Configuración"
|
|
1717
|
+
}
|
|
1718
|
+
},
|
|
1719
|
+
"notes": [
|
|
1720
|
+
"En la barra superior, `icon` junto a LocaleSwitcher; `segmented` solo donde la persona elige su preferencia con calma (Configuración)."
|
|
1721
|
+
],
|
|
1722
|
+
"examples": [
|
|
1723
|
+
{
|
|
1724
|
+
"title": "En la barra superior (con next-themes)",
|
|
1725
|
+
"code": "<ThemeToggle value={theme} onValueChange={setTheme} />"
|
|
1726
|
+
},
|
|
1727
|
+
{
|
|
1728
|
+
"title": "En Configuración",
|
|
1729
|
+
"code": "<ThemeToggle preset=\"segmented\" value={theme} onValueChange={setTheme} />"
|
|
1730
|
+
}
|
|
1731
|
+
]
|
|
1732
|
+
},
|
|
1733
|
+
"week-strip": {
|
|
1734
|
+
"import": "orbital-ds/ui/week-strip",
|
|
1735
|
+
"group": "navigation",
|
|
1736
|
+
"summary": "Una semana en una fila para elegir un día cercano (agenda, reservas, llamadas), con flechas para cambiar de semana y un punto en los días con algo.",
|
|
1737
|
+
"see": [
|
|
1738
|
+
{
|
|
1739
|
+
"component": "calendar",
|
|
1740
|
+
"when": "mes completo, fechas lejanas o rangos"
|
|
1741
|
+
},
|
|
1742
|
+
{
|
|
1743
|
+
"component": "date-picker",
|
|
1744
|
+
"when": "campo de formulario para una fecha"
|
|
1745
|
+
}
|
|
1746
|
+
],
|
|
1747
|
+
"exports": [
|
|
1748
|
+
"WeekStrip"
|
|
1749
|
+
],
|
|
1750
|
+
"slots": [
|
|
1751
|
+
"week-strip",
|
|
1752
|
+
"week-strip-day",
|
|
1753
|
+
"week-strip-mark"
|
|
1754
|
+
],
|
|
1755
|
+
"optionalPeers": [],
|
|
1756
|
+
"props": {
|
|
1757
|
+
"WeekStrip": {
|
|
1758
|
+
"value": {
|
|
1759
|
+
"type": "Date"
|
|
1760
|
+
},
|
|
1761
|
+
"defaultValue": {
|
|
1762
|
+
"type": "Date"
|
|
1763
|
+
},
|
|
1764
|
+
"onValueChange": {
|
|
1765
|
+
"type": "(date: Date) => void"
|
|
1766
|
+
},
|
|
1767
|
+
"weekStartsOn": {
|
|
1768
|
+
"type": "0 | 1 | 2 | 4 | 3 | 5 | 6"
|
|
1769
|
+
},
|
|
1770
|
+
"marked": {
|
|
1771
|
+
"type": "(date: Date) => boolean",
|
|
1772
|
+
"doc": "Devuelve true para los días que llevan un punto (con eventos, por ejemplo)."
|
|
1773
|
+
}
|
|
1774
|
+
}
|
|
1775
|
+
},
|
|
1776
|
+
"notes": [
|
|
1777
|
+
"Para elegir UN día cercano; para fechas lejanas o rangos usa Calendar o DatePicker.",
|
|
1778
|
+
"`marked` solo señala que hay algo ese día; el detalle va debajo, en una lista."
|
|
1779
|
+
],
|
|
1780
|
+
"examples": [
|
|
1781
|
+
{
|
|
1782
|
+
"title": "Controlado, con días marcados",
|
|
1783
|
+
"code": "<WeekStrip value={day} onValueChange={setDay} marked={(d) => hasEvents(d)} />"
|
|
1784
|
+
},
|
|
1785
|
+
{
|
|
1786
|
+
"title": "Libre, semana desde el domingo",
|
|
1787
|
+
"code": "<WeekStrip defaultValue={new Date()} weekStartsOn={0} />"
|
|
1788
|
+
}
|
|
1789
|
+
]
|
|
1790
|
+
}
|
|
1791
|
+
}
|
|
1792
|
+
}
|