orbital-ds 0.25.0 → 0.27.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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.25.0",
3
+ "version": "0.27.0",
4
4
  "engine": "@base-ui/react",
5
5
  "docs": [
6
6
  "README.md",
@@ -375,6 +375,21 @@
375
375
  "chart-card"
376
376
  ],
377
377
  "optionalPeers": [],
378
+ "presets": {
379
+ "values": [
380
+ "glance",
381
+ "standard",
382
+ "focus",
383
+ "dense"
384
+ ],
385
+ "default": "standard",
386
+ "intent": {
387
+ "glance": "vistazo: pequeño, sin descarga (un KPI con tendencia)",
388
+ "standard": "gráfico normal de un panel",
389
+ "focus": "protagonista de la vista: grande y con descarga SVG/PNG",
390
+ "dense": "muchos puntos: pinta en canvas y deja el alto medio"
391
+ }
392
+ },
378
393
  "notes": [
379
394
  "Gráfico en una tarjeta con cargando/error/vacío resueltos: `glance` para un vistazo, `standard` en un panel, `focus` para el gráfico principal (descargable), `dense` para muchos puntos (canvas). El option sale de orbital-ds/lib/echarts-presets y nunca lleva colores.",
380
395
  "Varios gráficos juntos: dentro de Mosaic (bento: el principal primero y en `focus`). Para informes en servidor usa renderEChartToSvg con el mismo option."
@@ -546,6 +561,17 @@
546
561
  "confirm-action"
547
562
  ],
548
563
  "optionalPeers": [],
564
+ "presets": {
565
+ "values": [
566
+ "simple",
567
+ "typed"
568
+ ],
569
+ "default": "simple",
570
+ "intent": {
571
+ "simple": "un clic en «Confirmar»",
572
+ "typed": "hay que escribir `expected` (el nombre del recurso) para habilitar el botón"
573
+ }
574
+ },
549
575
  "notes": [
550
576
  "Para borrar, revocar o archivar. `simple` si es reversible o de bajo impacto; `typed` (escribir el nombre) si no se puede deshacer. Si se puede deshacer, mejor un toast con «Deshacer» sin confirmar.",
551
577
  "El título nombra la acción y el objeto; el botón repite el verbo, no «Aceptar»."
@@ -563,6 +589,21 @@
563
589
  "content-card-media"
564
590
  ],
565
591
  "optionalPeers": [],
592
+ "presets": {
593
+ "values": [
594
+ "basic",
595
+ "feature",
596
+ "media",
597
+ "horizontal"
598
+ ],
599
+ "default": "basic",
600
+ "intent": {
601
+ "basic": "título, descripción, contenido y pie",
602
+ "feature": "icono arriba, título y descripción (una capacidad, un atajo, un paso)",
603
+ "media": "portada arriba (imagen o vídeo) y texto debajo",
604
+ "horizontal": "portada a un lado; apila en un contenedor estrecho (container query)"
605
+ }
606
+ },
566
607
  "notes": [
567
608
  "Tarjeta de contenido para rejillas: `basic` (texto), `feature` (icono + capacidad), `media` (portada arriba), `horizontal` (portada al lado). El énfasis (`elevated`, `outlined`, `filled`, `ghost`) cambia la prominencia, no la estructura.",
568
609
  "Interactiva con `href` (navega) o `onSelect` (acción): toda la tarjeta es el objetivo y el título el enlace; no metas botones dentro de un enlace ni tarjetas dentro de tarjetas. Para filas de entidades usa Item variant=\"card\"; para cifras, Stat.",
@@ -665,6 +706,14 @@
665
706
  "optionalPeers": [
666
707
  "@tanstack/react-table"
667
708
  ],
709
+ "presets": {
710
+ "values": [
711
+ "browse",
712
+ "manage",
713
+ "compact"
714
+ ],
715
+ "default": "browse"
716
+ },
668
717
  "notes": [
669
718
  "Presets: `browse` consulta, `manage` añade selección para actuar, `compact` es denso y sin menú de columnas; cualquier prop explícita los sobrescribe.",
670
719
  "Para muchas filas, comparar y ordenar; para 3–5 elementos usa Item variant=\"card\". Estado en la URL con dataTableStateToSearch.",
@@ -705,6 +754,19 @@
705
754
  "detail-panel-footer"
706
755
  ],
707
756
  "optionalPeers": [],
757
+ "presets": {
758
+ "values": [
759
+ "side",
760
+ "bottom",
761
+ "full"
762
+ ],
763
+ "default": "side",
764
+ "intent": {
765
+ "side": "panel lateral de ancho --ds-sheet-w (escritorio, ficha junto a la lista)",
766
+ "bottom": "hoja inferior (móvil o acciones rápidas)",
767
+ "full": "cubre toda la pantalla (contenido largo o edición)"
768
+ }
769
+ },
708
770
  "notes": [
709
771
  "Ficha de una entidad junto a su lista (`onSelect`/`onRowClick` abre el panel): `side` en escritorio, `bottom` en móvil, `full` para contenido largo. Para decidir algo bloqueante usa ConfirmAction, no esto."
710
772
  ]
@@ -879,6 +941,21 @@
879
941
  "empty-state"
880
942
  ],
881
943
  "optionalPeers": [],
944
+ "presets": {
945
+ "values": [
946
+ "first-use",
947
+ "no-results",
948
+ "error",
949
+ "forbidden"
950
+ ],
951
+ "default": "first-use",
952
+ "intent": {
953
+ "first-use": "todavía no hay nada: invita a crear lo primero",
954
+ "no-results": "hay datos pero el filtro no encuentra: invita a cambiar o limpiar filtros",
955
+ "error": "no se pudo cargar: invita a reintentar",
956
+ "forbidden": "sin permiso: explica por qué no se ve"
957
+ }
958
+ },
882
959
  "notes": [
883
960
  "Un preset por intención: first-use (nada aún), no-results (el filtro no encuentra), error (reintentar), forbidden (sin permiso). Cambia título, descripción o icono solo si el dominio lo pide.",
884
961
  "Para un vacío con composición propia usa Empty y sus partes."
@@ -918,6 +995,19 @@
918
995
  "entity-list-bulk"
919
996
  ],
920
997
  "optionalPeers": [],
998
+ "presets": {
999
+ "values": [
1000
+ "list",
1001
+ "grid",
1002
+ "compact"
1003
+ ],
1004
+ "default": "list",
1005
+ "intent": {
1006
+ "list": "una columna de filas-tarjeta",
1007
+ "grid": "rejilla; las columnas siguen el ANCHO DEL CONTENEDOR (container query)",
1008
+ "compact": "filas densas, para muchas entidades"
1009
+ }
1010
+ },
921
1011
  "notes": [
922
1012
  "Lista de entidades con cargando/error/vacío resueltos: pasa `items`, `renderItem` (un `Item variant=\"card\"`) y, si hay filtros, `toolbar` y `filtered`. `list` por defecto, `grid` para tarjetas, `compact` para muchas filas.",
923
1013
  "No compone Card + Item a mano: la fila es siempre un Item."
@@ -969,6 +1059,7 @@
969
1059
  "exports": [
970
1060
  "FilterBar",
971
1061
  "FilterMenu",
1062
+ "type FilterBarPreset",
972
1063
  "type FilterOption"
973
1064
  ],
974
1065
  "slots": [
@@ -981,7 +1072,23 @@
981
1072
  "filter-menu-trigger",
982
1073
  "filter-menu-value"
983
1074
  ],
984
- "optionalPeers": []
1075
+ "optionalPeers": [],
1076
+ "presets": {
1077
+ "values": [
1078
+ "inline",
1079
+ "compact",
1080
+ "stacked"
1081
+ ],
1082
+ "default": "inline",
1083
+ "intent": {
1084
+ "inline": "una fila que envuelve; las acciones al final (encima de una tabla o un panel)",
1085
+ "compact": "igual, con separación menor (barra dentro de una tarjeta o de un panel estrecho)",
1086
+ "stacked": "filtros arriba y acciones debajo, en columna (lateral o contenedor estrecho)"
1087
+ }
1088
+ },
1089
+ "notes": [
1090
+ "Filtros sobre una vista de datos: `inline` por defecto, `compact` dentro de una tarjeta o panel, `stacked` en un lateral o contenedor estrecho. Un filtro que no se puede usar lleva `disabledReason`, no desaparece."
1091
+ ]
985
1092
  },
986
1093
  "form-layout": {
987
1094
  "import": "orbital-ds/ui/form-layout",
@@ -996,6 +1103,19 @@
996
1103
  "form-section"
997
1104
  ],
998
1105
  "optionalPeers": [],
1106
+ "presets": {
1107
+ "values": [
1108
+ "inline",
1109
+ "sectioned",
1110
+ "settings"
1111
+ ],
1112
+ "default": "inline",
1113
+ "intent": {
1114
+ "inline": "una columna, acciones al final (altas y formularios cortos)",
1115
+ "sectioned": "título de sección a la izquierda y campos a la derecha en ancho; acciones al final",
1116
+ "settings": "como `sectioned`, pero la barra «Guardar / Descartar» solo aparece con `dirty`"
1117
+ }
1118
+ },
999
1119
  "notes": [
1000
1120
  "Formularios y ajustes: `inline` (corto), `sectioned` (varias secciones) o `settings` (barra de guardado solo con cambios). Combina con Field para los campos.",
1001
1121
  "Un formulario de varios pasos no va aquí: usa StepFlow."
@@ -1228,6 +1348,21 @@
1228
1348
  "loading-state"
1229
1349
  ],
1230
1350
  "optionalPeers": [],
1351
+ "presets": {
1352
+ "values": [
1353
+ "list",
1354
+ "card",
1355
+ "table",
1356
+ "detail"
1357
+ ],
1358
+ "default": "list",
1359
+ "intent": {
1360
+ "list": "filas con icono y dos líneas",
1361
+ "card": "una tarjeta con título y cuerpo",
1362
+ "table": "cabecera y filas",
1363
+ "detail": "título, subtítulo y bloques de texto"
1364
+ }
1365
+ },
1231
1366
  "notes": [
1232
1367
  "Mientras carga, pinta la forma de lo que vendrá: `list` para filas, `card` para una tarjeta, `table` para una tabla, `detail` para una ficha."
1233
1368
  ]
@@ -1363,6 +1498,19 @@
1363
1498
  "mosaic-root"
1364
1499
  ],
1365
1500
  "optionalPeers": [],
1501
+ "presets": {
1502
+ "values": [
1503
+ "even",
1504
+ "bento",
1505
+ "trio"
1506
+ ],
1507
+ "default": "even",
1508
+ "intent": {
1509
+ "even": "columnas iguales (1 → 2 → 3), sin jerarquía",
1510
+ "bento": "4 columnas anchas; el primer hijo ocupa 2×2 (lo más importante, más grande)",
1511
+ "trio": "exactamente 3 en fila ancha, 1 en estrecho (tres capacidades, tres pasos)"
1512
+ }
1513
+ },
1366
1514
  "notes": [
1367
1515
  "Rejilla de tarjetas con jerarquía: `bento` para destacar lo primero, `trio` para tres iguales, `even` sin jerarquía. Si todo pesa lo mismo, usa `even` (o EntityList grid), no bento. Para spans manuales envuelve en MosaicItem.",
1368
1516
  "El destacado va el primero del DOM (orden de lectura); no reordenes con CSS."
@@ -1438,6 +1586,21 @@
1438
1586
  "notice-review-state"
1439
1587
  ],
1440
1588
  "optionalPeers": [],
1589
+ "presets": {
1590
+ "values": [
1591
+ "read",
1592
+ "acknowledge",
1593
+ "resolve",
1594
+ "respond"
1595
+ ],
1596
+ "default": "read",
1597
+ "intent": {
1598
+ "read": "solo lectura: Cerrar",
1599
+ "acknowledge": "«Reconocer» (new → acknowledged) → onAcknowledge()",
1600
+ "resolve": "nota opcional + «Marcar como resuelto» → onResolve(note)",
1601
+ "respond": "«Rechazar» / «Aceptar» (+ «Más tarde» si hay onSnooze) → onRespond(\"accept\" | \"decline\")"
1602
+ }
1603
+ },
1441
1604
  "notes": [
1442
1605
  "Detalle de un aviso de la campana: pásale `onSelect` a NotificationItem y abre aquí el contexto completo. `acknowledge` para reconocer, `resolve` para cerrar con nota, `respond` para aceptar o rechazar una comunicación, `read` si solo se lee.",
1443
1606
  "Canal según intención: toast confirma una acción; Alert avisa en una sección; Banner avisa en toda la página; campana + NoticeReview para lo que exige seguimiento; ConfirmAction/AlertDialog para lo que bloquea."
@@ -1495,7 +1658,8 @@
1495
1658
  "SectionHeaderActions",
1496
1659
  "SectionHeaderDescription",
1497
1660
  "SectionHeaderIcon",
1498
- "SectionHeaderTitle"
1661
+ "SectionHeaderTitle",
1662
+ "type PageHeaderPreset"
1499
1663
  ],
1500
1664
  "slots": [
1501
1665
  "page-header",
@@ -1511,8 +1675,22 @@
1511
1675
  "section-header-title"
1512
1676
  ],
1513
1677
  "optionalPeers": [],
1678
+ "presets": {
1679
+ "values": [
1680
+ "page",
1681
+ "compact",
1682
+ "canvas"
1683
+ ],
1684
+ "default": "page",
1685
+ "intent": {
1686
+ "page": "vista normal: centrada en --ds-page-max-w, título grande",
1687
+ "compact": "vista densa o dentro de un panel: título menor y menos aire",
1688
+ "canvas": "lienzo a todo el ancho (mapa, kanban, editor): sin ancho máximo"
1689
+ }
1690
+ },
1514
1691
  "notes": [
1515
- "Cabecera de vista: PageHeaderTitle + PageHeaderDescription y la acción principal en PageHeaderActions; centrada en --ds-page-max-w."
1692
+ "Cabecera de vista: PageHeaderTitle + PageHeaderDescription y la acción principal en PageHeaderActions; centrada en --ds-page-max-w.",
1693
+ "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í."
1516
1694
  ]
1517
1695
  },
1518
1696
  "page-shell": {
@@ -1525,6 +1703,19 @@
1525
1703
  "page-shell"
1526
1704
  ],
1527
1705
  "optionalPeers": [],
1706
+ "presets": {
1707
+ "values": [
1708
+ "content",
1709
+ "detail",
1710
+ "canvas"
1711
+ ],
1712
+ "default": "content",
1713
+ "intent": {
1714
+ "content": "centrado en --ds-page-max-w, secciones separadas por --ds-section-gap",
1715
+ "detail": "columna estrecha (--ds-page-narrow-w) para leer o editar una sola entidad",
1716
+ "canvas": "a todo el ancho, sin máximo (mapa, kanban, editor)"
1717
+ }
1718
+ },
1528
1719
  "notes": [
1529
1720
  "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."
1530
1721
  ]
@@ -1933,6 +2124,19 @@
1933
2124
  "stat-group"
1934
2125
  ],
1935
2126
  "optionalPeers": [],
2127
+ "presets": {
2128
+ "values": [
2129
+ "overview",
2130
+ "compact",
2131
+ "comparison"
2132
+ ],
2133
+ "default": "overview",
2134
+ "intent": {
2135
+ "overview": "hasta 4 columnas: cabecera de un panel de datos",
2136
+ "compact": "2 columnas en estrecho y hasta 4 en ancho, con menos aire: paneles densos",
2137
+ "comparison": "hasta 2 columnas: cifras para comparar de dos en dos"
2138
+ }
2139
+ },
1936
2140
  "notes": [
1937
2141
  "Agrupa varios Stat en la cabecera de un panel; no pongas más de 4 por fila. Para series o tendencias usa Sparkline dentro de cada Stat."
1938
2142
  ]
@@ -2037,6 +2241,19 @@
2037
2241
  "step-flow-result"
2038
2242
  ],
2039
2243
  "optionalPeers": [],
2244
+ "presets": {
2245
+ "values": [
2246
+ "quick",
2247
+ "activation",
2248
+ "long"
2249
+ ],
2250
+ "default": "activation",
2251
+ "intent": {
2252
+ "quick": "2–3 pasos, formulario simple → dialog · compact · sin lateral",
2253
+ "activation": "3–6 pasos, vista previa/resultado → dialog · horizontal · lateral al final",
2254
+ "long": "6 pasos o más, secciones libres → page · vertical · lateral opcional"
2255
+ }
2256
+ },
2040
2257
  "notes": [
2041
2258
  "Para altas y configuraciones por pasos. Elige un `preset` (quick, activation, long) y sobrescribe lo que haga falta; presentación y densidad son independientes.",
2042
2259
  "El estado de los campos vive en la app: solo se monta el paso actual. `invalid` bloquea «Siguiente»; `dirty` pide confirmar al cerrar.",
package/dist/styles.css CHANGED
@@ -517,6 +517,10 @@
517
517
  /* Piezas de datos y estructura (0.10.0) */
518
518
  --ds-page-max-w: 72rem; /* ancho máximo del contenido de una vista (PageHeader) */
519
519
  --ds-page-gap: 1.5rem;
520
+ --ds-page-title-size: 1.5rem; /* título de vista (PageHeader), contenedor estrecho */
521
+ --ds-page-title-size-wide: 1.875rem; /* ... y a partir de 42rem */
522
+ --ds-page-title-size-compact: 1.25rem; /* preset compact */
523
+ --ds-page-title-size-compact-wide: 1.5rem;
520
524
  --ds-section-gap: calc(1rem * var(--ds-density));
521
525
  --ds-page-narrow-w: 42rem; /* ancho máximo de una vista de detalle (PageShell detail) */
522
526
  --ds-mosaic-row: 8rem; /* alto mínimo de una fila del Mosaic */
@@ -540,6 +544,7 @@
540
544
  --ds-notifications-max-h: 24rem; /* alto máximo de la lista antes de desplazarse */
541
545
  --ds-dropzone-p: 2rem;
542
546
  --ds-filter-gap: 0.5rem;
547
+ --ds-filter-gap-compact: 0.25rem; /* FilterBar preset compact */
543
548
  --ds-banner-px: 1rem; /* aviso de página (Banner) */
544
549
  --ds-banner-py: 0.625rem;
545
550
  --ds-tabs-gap: 0.25rem; /* separación entre pestañas cuando el tema las separa */
@@ -1,6 +1,8 @@
1
1
  import * as React from 'react';
2
2
 
3
- declare function FilterBar({ className, children, actions, onClear, canClear, ...props }: React.ComponentProps<"div"> & {
3
+ type FilterBarPreset = "inline" | "compact" | "stacked";
4
+ declare function FilterBar({ preset, className, children, actions, onClear, canClear, ...props }: React.ComponentProps<"div"> & {
5
+ preset?: FilterBarPreset;
4
6
  /** Acciones de la vista (exportar, guardar vista…), al final de la fila. */
5
7
  actions?: React.ReactNode;
6
8
  /** Si se pasa, muestra «Quitar filtros». */
@@ -33,4 +35,4 @@ declare function FilterMenu({ className, label, icon, value, onValueChange, opti
33
35
  id?: string;
34
36
  }): React.JSX.Element;
35
37
 
36
- export { FilterBar, FilterMenu, type FilterOption };
38
+ export { FilterBar, type FilterBarPreset, FilterMenu, type FilterOption };
@@ -3,7 +3,10 @@ import { IconTile } from './icon-tile.js';
3
3
  import 'class-variance-authority/types';
4
4
  import 'class-variance-authority';
5
5
 
6
- declare function PageHeader({ className, ...props }: React.ComponentProps<"header">): React.JSX.Element;
6
+ type PageHeaderPreset = "page" | "compact" | "canvas";
7
+ declare function PageHeader({ preset, className, ...props }: React.ComponentProps<"header"> & {
8
+ preset?: PageHeaderPreset;
9
+ }): React.JSX.Element;
7
10
  declare function PageHeaderBreadcrumb({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
8
11
  declare function PageHeaderTitle({ className, ...props }: React.ComponentProps<"h1">): React.JSX.Element;
9
12
  declare function PageHeaderDescription({ className, ...props }: React.ComponentProps<"p">): React.JSX.Element;
@@ -16,4 +19,4 @@ declare function SectionHeaderTitle({ className, ...props }: React.ComponentProp
16
19
  declare function SectionHeaderDescription({ className, ...props }: React.ComponentProps<"p">): React.JSX.Element;
17
20
  declare function SectionHeaderActions({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
18
21
 
19
- export { PageHeader, PageHeaderActions, PageHeaderBreadcrumb, PageHeaderDescription, PageHeaderNotice, PageHeaderTitle, SectionHeader, SectionHeaderActions, SectionHeaderDescription, SectionHeaderIcon, SectionHeaderTitle };
22
+ export { PageHeader, PageHeaderActions, PageHeaderBreadcrumb, PageHeaderDescription, PageHeaderNotice, type PageHeaderPreset, PageHeaderTitle, SectionHeader, SectionHeaderActions, SectionHeaderDescription, SectionHeaderIcon, SectionHeaderTitle };