@jvsoft/components 1.0.0-alpha.16 → 1.0.0-alpha.18

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.
Files changed (34) hide show
  1. package/.storybook/tema-demo.css +194 -0
  2. package/dialog-flotante/README.md +21 -1
  3. package/fesm2022/jvsoft-components-dialog-flotante.mjs +18 -12
  4. package/fesm2022/jvsoft-components-dialog-flotante.mjs.map +1 -1
  5. package/fesm2022/jvsoft-components-filtro-busqueda.mjs +11 -2
  6. package/fesm2022/jvsoft-components-filtro-busqueda.mjs.map +1 -1
  7. package/fesm2022/jvsoft-components-lista-arbol.mjs +58 -17
  8. package/fesm2022/jvsoft-components-lista-arbol.mjs.map +1 -1
  9. package/fesm2022/jvsoft-components-lista-detalle.mjs +70 -0
  10. package/fesm2022/jvsoft-components-lista-detalle.mjs.map +1 -0
  11. package/fesm2022/jvsoft-components-luces-navidad.mjs +2 -2
  12. package/fesm2022/jvsoft-components-luces-navidad.mjs.map +1 -1
  13. package/fesm2022/jvsoft-components-menu.mjs +4 -1
  14. package/fesm2022/jvsoft-components-menu.mjs.map +1 -1
  15. package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs +2 -5
  16. package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs.map +1 -1
  17. package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs +2605 -394
  18. package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs.map +1 -1
  19. package/fesm2022/jvsoft-components.mjs +1 -0
  20. package/fesm2022/jvsoft-components.mjs.map +1 -1
  21. package/lista-arbol/README.md +17 -1
  22. package/lista-detalle/README.md +85 -0
  23. package/package.json +6 -2
  24. package/src/styles/base-jvsoft-components.css +714 -15
  25. package/tabla-mantenimiento/README.md +628 -0
  26. package/tabla-mantenimiento/tabla-mantenimiento.component.scss +31 -0
  27. package/types/jvsoft-components-dialog-flotante.d.ts +2 -0
  28. package/types/jvsoft-components-filtro-busqueda.d.ts +6 -0
  29. package/types/jvsoft-components-lista-arbol.d.ts +19 -2
  30. package/types/jvsoft-components-lista-detalle.d.ts +44 -0
  31. package/types/jvsoft-components-menu.d.ts +1 -0
  32. package/types/jvsoft-components-tabla-mantenimiento-components-progress-bar.d.ts +1 -2
  33. package/types/jvsoft-components-tabla-mantenimiento.d.ts +1070 -21
  34. package/types/jvsoft-components.d.ts +1 -0
@@ -7,6 +7,7 @@ export * from '@jvsoft/components/lista-arbol';
7
7
  export * from '@jvsoft/components/filtro-busqueda';
8
8
  export * from '@jvsoft/components/alerta';
9
9
  export * from '@jvsoft/components/foto-persona';
10
+ export * from '@jvsoft/components/lista-detalle';
10
11
 
11
12
  // export {};
12
13
  // import './src/styles.scss';
@@ -1 +1 @@
1
- {"version":3,"file":"jvsoft-components.mjs","sources":["../../../projects/components/index.ts","../../../projects/components/jvsoft-components.ts"],"sourcesContent":["// export {};\n// import './src/styles.scss';\n\nexport * from '@jvsoft/components/dialog-flotante';\n// export * from './progress-spinner';\nexport * from '@jvsoft/components/tabla-mantenimiento';\nexport * from '@jvsoft/components/luces-navidad';\nexport * from '@jvsoft/components/mat-suffix-search-button';\nexport * from '@jvsoft/components/menu';\nexport * from '@jvsoft/components/lista-arbol';\nexport * from '@jvsoft/components/filtro-busqueda';\nexport * from '@jvsoft/components/alerta';\nexport * from '@jvsoft/components/foto-persona';\n\n\n\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;;;;AAAA;AACA;;ACDA;;AAEG"}
1
+ {"version":3,"file":"jvsoft-components.mjs","sources":["../../../projects/components/index.ts","../../../projects/components/jvsoft-components.ts"],"sourcesContent":["// export {};\n// import './src/styles.scss';\n\nexport * from '@jvsoft/components/dialog-flotante';\n// export * from './progress-spinner';\nexport * from '@jvsoft/components/tabla-mantenimiento';\nexport * from '@jvsoft/components/luces-navidad';\nexport * from '@jvsoft/components/mat-suffix-search-button';\nexport * from '@jvsoft/components/menu';\nexport * from '@jvsoft/components/lista-arbol';\nexport * from '@jvsoft/components/filtro-busqueda';\nexport * from '@jvsoft/components/alerta';\nexport * from '@jvsoft/components/foto-persona';\nexport * from '@jvsoft/components/lista-detalle';\n\n\n\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;;;;;AAAA;AACA;;ACDA;;AAEG"}
@@ -70,6 +70,8 @@ export class ExampleComponent {
70
70
  | `condicionMostrar` | `(item: T) => boolean` | - | Función para filtrar items a mostrar |
71
71
  | `condicionesClaseFila` | `(item: T) => string[]` | `() => []` | Función que retorna clases CSS adicionales |
72
72
  | `selectionModel` | `any` | - | Modelo de selección (backward compatibility) |
73
+ | `abrirAlSeleccionar` | `boolean` | `true` | Pulsar el texto de un nodo con hijos además lo abre o cierra (lo de siempre). Con `false` solo selecciona |
74
+ | `mensajeVacio` | `string` | - | Mensaje cuando la lista llega vacía. Sin definir no se muestra nada (hay pantallas con su propio mensaje) |
73
75
 
74
76
  ### Outputs
75
77
 
@@ -77,7 +79,7 @@ export class ExampleComponent {
77
79
  |--------|------|-------------|
78
80
  | `seleccionado` | `EventEmitter<any>` | Emite cuando se selecciona un item |
79
81
  | `selectionModelChange` | `EventEmitter<any>` | Emite cambios en el modelo de selección |
80
- | `listaCheck` | `EventEmitter<T[]>` | Emite array de items seleccionados (modo checkbox) |
82
+ | `listaCheck` | `OutputEmitterRef<string>` | Emite los ids seleccionados separados por comas, p. ej. `"6,8"` (modo checkbox) |
81
83
  | `listaCheckObj` | `EventEmitter<Record<string, any>>` | Emite objeto con items seleccionados (modo checkbox) |
82
84
 
83
85
  ## Ejemplos
@@ -266,3 +268,17 @@ Si estás migrando desde una versión anterior con `@Input()` decorators:
266
268
  ## Licencia
267
269
 
268
270
  MIT
271
+
272
+
273
+ ## Comportamiento de los nodos
274
+
275
+ - **Huérfanos como raíz.** Un nodo cuyo padre no está en la lista sale en la raíz. Antes solo
276
+ salían los de padre `null`, y una lista filtrada (p. ej. solo trabajadores, que cuelgan de
277
+ oficinas) pintaba un árbol en blanco. Un nodo que es su propio padre o que forma un ciclo
278
+ también sale como raíz, sin repetirse.
279
+ - **El chevron solo abre o cierra.** Es un botón propio (`aria-expanded`) y no selecciona el nodo.
280
+ El texto sigue seleccionando y, con `abrirAlSeleccionar` (por defecto), abriendo.
281
+ - **Mensaje de vacío propio** con `mensajeVacio`.
282
+
283
+ `generarArbol` usa `indexarArbol` de `@jvsoft/utils`; para listas grandes que necesiten búsqueda,
284
+ orden, Excel o paginación conviene `jvs-tabla-mantenimiento` con `[arbol]`.
@@ -0,0 +1,85 @@
1
+ # ListaDetalleComponent
2
+
3
+ `<jvs-lista-detalle>` arma una pantalla de lista con panel de detalle: dos tarjetas con título.
4
+ El panel va **al lado** de la lista cuando el componente mide 980 px o más y **debajo** cuando es
5
+ más angosto. Lo decide el ancho del propio componente (consulta de contenedor), no el de la
6
+ ventana: funciona igual dentro de otro panel o con el menú lateral abierto.
7
+
8
+ **Entry point:** `@jvsoft/components/lista-detalle`
9
+
10
+ ## Uso
11
+
12
+ ```typescript
13
+ import { ListaDetalleComponent } from '@jvsoft/components/lista-detalle';
14
+
15
+ @Component({
16
+ imports: [ListaDetalleComponent, TablaMantenimientoComponent],
17
+ template: `
18
+ <jvs-lista-detalle tituloLista="Tipos de documento" [conteo]="total()" anchoDetalle="compacto">
19
+ <ng-container lista>
20
+ <jvs-tabla-mantenimiento ...></jvs-tabla-mantenimiento>
21
+ <div role="note">...</div>
22
+ </ng-container>
23
+
24
+ <ng-container detalle>
25
+ @if (seleccionado(); as sel) {
26
+ <mi-ficha [dato]="sel" />
27
+ } @else {
28
+ <p>Selecciona un registro.</p>
29
+ }
30
+ </ng-container>
31
+ </jvs-lista-detalle>
32
+ `,
33
+ })
34
+ ```
35
+
36
+ Para proyectar varios elementos (o un bloque `@if`) en una misma zona, envuélvelos en un
37
+ `<ng-container lista>` / `<ng-container detalle>`: así no se pierde nada en el camino.
38
+
39
+ ## Entradas
40
+
41
+ | Entrada | Tipo | Por defecto | Qué hace |
42
+ |-----------------|---------------------------------------|-------------|----------|
43
+ | `tituloLista` | `string` | `""` | Título de la tarjeta de la lista. |
44
+ | `conteo` | `string \| number \| null` | `null` | Se muestra entre paréntesis junto al título: `12`, `"3 de 40 despachos"`. Con `null`, `undefined` o `""` no sale (útil mientras carga). `0` sí sale. |
45
+ | `tituloDetalle` | `string` | `"Detalle"` | Título de la tarjeta del detalle. |
46
+ | `anchoDetalle` | `"compacto" \| "normal" \| "amplio"` | `"normal"` | Ancho del panel cuando va al lado. |
47
+
48
+ ### Anchos del panel
49
+
50
+ | `anchoDetalle` | Desde 980 px | Desde 1280 px |
51
+ |----------------|--------------|---------------|
52
+ | `compacto` | 300 px | 340 px |
53
+ | `normal` | 360 px | 420 px |
54
+ | `amplio` | 420 px | 480 px |
55
+
56
+ Por debajo de 980 px el panel ocupa todo el ancho, debajo de la lista.
57
+
58
+ ## Zonas de contenido
59
+
60
+ | Selector | Dónde va |
61
+ |---------------------|----------|
62
+ | `[lista]` | Cuerpo de la tarjeta de la lista. |
63
+ | `[detalle]` | Cuerpo de la tarjeta del detalle. |
64
+ | `[listaTitulo]` | Dentro del título de la lista, después del texto y del conteo. |
65
+ | `[detalleTitulo]` | Dentro del título del detalle, después del texto. |
66
+ | `[listaAcciones]` | A la derecha del título de la lista. |
67
+ | `[detalleAcciones]` | A la derecha del título del detalle. |
68
+
69
+ ## Comportamiento
70
+
71
+ - Cuando el panel va al lado, es `sticky` (8 px del borde superior) y su alto máximo es el de la
72
+ ventana menos 16 px; si su contenido no cabe, se desplaza por dentro. Debajo de la lista no es
73
+ `sticky` ni tiene alto máximo.
74
+ - Cada tarjeta es una región (`<section>`) etiquetada por su título con `aria-labelledby`. Los `id`
75
+ se generan por instancia, así que puede haber varias en la misma página.
76
+ - El host define `--jvs-primario-texto`: el primario del tema oscurecido, legible como texto sobre
77
+ fondos claros. Úsalo en el contenido con `text-[color:var(--jvs-primario-texto)]`.
78
+ - Las tarjetas usan `mat-elevation-z4` y `bg-app-bar`, que vienen del tema de la aplicación.
79
+
80
+ ## Tailwind
81
+
82
+ Las clases (incluidas las consultas de contenedor, escritas como variantes arbitrarias) van
83
+ completas en el código de la librería. Las aplicaciones que escanean `node_modules/@jvsoft/**` en
84
+ su `content` las generan sin configurar nada; no hace falta el plugin
85
+ `@tailwindcss/container-queries`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jvsoft/components",
3
- "version": "1.0.0-alpha.16",
3
+ "version": "1.0.0-alpha.18",
4
4
  "description": "JVSOFT Angular Components",
5
5
  "publishConfig": {
6
6
  "tag": "alpha",
@@ -11,7 +11,7 @@
11
11
  "@angular/core": ">=17.1.0",
12
12
  "@angular/forms": ">=17.1.0",
13
13
  "@angular/material": ">=17.1.0",
14
- "@jvsoft/utils": "1.0.0-alpha.16",
14
+ "@jvsoft/utils": "1.0.0-alpha.18",
15
15
  "tailwindcss": "3",
16
16
  "xlsx": "^0.18.5"
17
17
  },
@@ -50,6 +50,10 @@
50
50
  "types": "./types/jvsoft-components-lista-arbol.d.ts",
51
51
  "default": "./fesm2022/jvsoft-components-lista-arbol.mjs"
52
52
  },
53
+ "./lista-detalle": {
54
+ "types": "./types/jvsoft-components-lista-detalle.d.ts",
55
+ "default": "./fesm2022/jvsoft-components-lista-detalle.mjs"
56
+ },
53
57
  "./luces-navidad": {
54
58
  "types": "./types/jvsoft-components-luces-navidad.d.ts",
55
59
  "default": "./fesm2022/jvsoft-components-luces-navidad.mjs"