@jvsoft/components 1.0.0-alpha.15 → 1.0.0-alpha.17
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/.storybook/tema-demo.css +188 -0
- package/dialog-flotante/README.md +21 -1
- package/fesm2022/jvsoft-components-alerta.mjs +19 -20
- package/fesm2022/jvsoft-components-alerta.mjs.map +1 -1
- package/fesm2022/jvsoft-components-dialog-flotante.mjs +31 -25
- package/fesm2022/jvsoft-components-dialog-flotante.mjs.map +1 -1
- package/fesm2022/jvsoft-components-filtro-busqueda.mjs +19 -19
- package/fesm2022/jvsoft-components-filtro-busqueda.mjs.map +1 -1
- package/fesm2022/jvsoft-components-foto-persona.mjs +481 -0
- package/fesm2022/jvsoft-components-foto-persona.mjs.map +1 -0
- package/fesm2022/jvsoft-components-lista-arbol.mjs +33 -34
- package/fesm2022/jvsoft-components-lista-arbol.mjs.map +1 -1
- package/fesm2022/jvsoft-components-luces-navidad.mjs +4 -8
- package/fesm2022/jvsoft-components-luces-navidad.mjs.map +1 -1
- package/fesm2022/jvsoft-components-mat-suffix-search-button.mjs +3 -3
- package/fesm2022/jvsoft-components-mat-suffix-search-button.mjs.map +1 -1
- package/fesm2022/jvsoft-components-menu.mjs +13 -13
- package/fesm2022/jvsoft-components-menu.mjs.map +1 -1
- package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs +4 -4
- package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs.map +1 -1
- package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs +542 -345
- package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs.map +1 -1
- package/fesm2022/jvsoft-components.mjs +9 -3015
- package/fesm2022/jvsoft-components.mjs.map +1 -1
- package/foto-persona/README.md +341 -0
- package/lista-arbol/README.md +1 -1
- package/package.json +22 -17
- package/src/styles/base-jvsoft-components.css +1541 -5
- package/tabla-mantenimiento/README.md +204 -0
- package/types/jvsoft-components-alerta.d.ts +33 -0
- package/types/jvsoft-components-dialog-flotante.d.ts +36 -0
- package/types/jvsoft-components-filtro-busqueda.d.ts +217 -0
- package/types/jvsoft-components-foto-persona.d.ts +300 -0
- package/types/jvsoft-components-lista-arbol.d.ts +61 -0
- package/{luces-navidad/luces-navidad.component.d.ts → types/jvsoft-components-luces-navidad.d.ts} +5 -2
- package/{mat-suffix-search-button/mat-suffix-search-button.component.d.ts → types/jvsoft-components-mat-suffix-search-button.d.ts} +5 -2
- package/{menu/menu.component.d.ts → types/jvsoft-components-menu.d.ts} +25 -4
- package/{tabla-mantenimiento/components/progress-bar/progress-bar.component.d.ts → types/jvsoft-components-tabla-mantenimiento-components-progress-bar.d.ts} +7 -3
- package/types/jvsoft-components-tabla-mantenimiento.d.ts +611 -0
- package/types/jvsoft-components.d.ts +9 -0
- package/alerta/alerta.component.d.ts +0 -29
- package/alerta/index.d.ts +0 -5
- package/alerta/public-api.d.ts +0 -1
- package/dialog-flotante/dialog-flotante.component.d.ts +0 -23
- package/dialog-flotante/dialog-flotante.interface.d.ts +0 -11
- package/dialog-flotante/index.d.ts +0 -5
- package/dialog-flotante/public-api.d.ts +0 -1
- package/filtro-busqueda/filtro-busqueda.component.d.ts +0 -89
- package/filtro-busqueda/filtro-busqueda.service.d.ts +0 -40
- package/filtro-busqueda/index.d.ts +0 -5
- package/filtro-busqueda/interfaces/filtro-busqueda.interface.d.ts +0 -86
- package/filtro-busqueda/public-api.d.ts +0 -3
- package/index.d.ts +0 -9
- package/lista-arbol/index.d.ts +0 -5
- package/lista-arbol/lista-arbol.component.d.ts +0 -57
- package/lista-arbol/lista-arbol.functions.d.ts +0 -8
- package/lista-arbol/public-api.d.ts +0 -1
- package/luces-navidad/index.d.ts +0 -5
- package/luces-navidad/public-api.d.ts +0 -1
- package/mat-suffix-search-button/index.d.ts +0 -5
- package/mat-suffix-search-button/public-api.d.ts +0 -1
- package/menu/index.d.ts +0 -5
- package/menu/menu.interface.d.ts +0 -16
- package/menu/public-api.d.ts +0 -2
- package/tabla-mantenimiento/classes/data-model.d.ts +0 -25
- package/tabla-mantenimiento/components/progress-bar/index.d.ts +0 -5
- package/tabla-mantenimiento/components/progress-bar/public-api.d.ts +0 -1
- package/tabla-mantenimiento/index.d.ts +0 -5
- package/tabla-mantenimiento/interfaces/Implements/incluye-tabla-mantenimiento.d.ts +0 -12
- package/tabla-mantenimiento/interfaces/Implements/index.d.ts +0 -1
- package/tabla-mantenimiento/interfaces/archivo.d.ts +0 -26
- package/tabla-mantenimiento/interfaces/global/boton-mantenimiento.d.ts +0 -41
- package/tabla-mantenimiento/interfaces/global/columnas-tabla.d.ts +0 -142
- package/tabla-mantenimiento/interfaces/global/index.d.ts +0 -3
- package/tabla-mantenimiento/interfaces/global/no-export.d.ts +0 -2
- package/tabla-mantenimiento/interfaces/global/otros.d.ts +0 -28
- package/tabla-mantenimiento/interfaces/index.d.ts +0 -3
- package/tabla-mantenimiento/mat-row-keyboard-selection.directive.d.ts +0 -19
- package/tabla-mantenimiento/pipes/no-sanitize.pipe.d.ts +0 -10
- package/tabla-mantenimiento/pipes/zero-fill.pipe.d.ts +0 -8
- package/tabla-mantenimiento/public-api.d.ts +0 -4
- package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-date/column-type-date.component.d.ts +0 -8
- package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-icons/column-type-icons.component.d.ts +0 -9
- package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-money/column-type-money.component.d.ts +0 -9
- package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-number/column-type-number.component.d.ts +0 -8
- package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-progressbar/column-type-progressbar.component.d.ts +0 -8
- package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-sino/column-type-sino.component.d.ts +0 -9
- package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-text/column-type-text.component.d.ts +0 -8
- package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type.component.d.ts +0 -18
- package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type.module.d.ts +0 -24
- package/tabla-mantenimiento/tabla-mantenimiento-column-defs/tabla-mantenimiento-column-defs.component.d.ts +0 -21
- package/tabla-mantenimiento/tabla-mantenimiento-menu/tabla-mantenimiento-menu.component.d.ts +0 -18
- package/tabla-mantenimiento/tabla-mantenimiento.component.d.ts +0 -159
- package/tabla-mantenimiento/tabla-mantenimiento.functions.d.ts +0 -5
- package/tabla-mantenimiento/tabla-mantenimiento.service.d.ts +0 -8
- package/tabla-mantenimiento/table-util.d.ts +0 -11
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
# tabla-mantenimiento
|
|
2
|
+
|
|
3
|
+
`@jvsoft/components/tabla-mantenimiento` es la tabla de mantenimiento genérica: una envoltura
|
|
4
|
+
sobre `MatTable` que resuelve de una vez lo que toda pantalla de listado necesita —columnas por
|
|
5
|
+
tipo, botones con permisos, selección, búsqueda, paginación y exportación—, de modo que el
|
|
6
|
+
componente que la usa solo declare qué datos trae y qué hacer con ellos.
|
|
7
|
+
|
|
8
|
+
## Lo mínimo
|
|
9
|
+
|
|
10
|
+
```typescript
|
|
11
|
+
import { ColumnaTabla, TablaMantenimientoComponent } from '@jvsoft/components/tabla-mantenimiento';
|
|
12
|
+
|
|
13
|
+
@Component({ imports: [TablaMantenimientoComponent] })
|
|
14
|
+
export class PersonasComponent {
|
|
15
|
+
seleccionados: Record<string, any> = {};
|
|
16
|
+
datos$ = new BehaviorSubject<Persona[]>([]);
|
|
17
|
+
|
|
18
|
+
columnas: ColumnaTabla<Persona>[] = [
|
|
19
|
+
{ label: '#', property: 'numeracion_automatica', type: 'numeracion_automatica' },
|
|
20
|
+
{ label: 'Nombre', property: 'cPersNombre', type: 'text' },
|
|
21
|
+
{ label: 'Ingreso', property: 'dFechaIngreso', type: 'date' },
|
|
22
|
+
{ label: 'Sueldo', property: 'nSueldo', type: 'money' },
|
|
23
|
+
];
|
|
24
|
+
}
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
```html
|
|
28
|
+
<jvs-tabla-mantenimiento
|
|
29
|
+
[objThis]="this"
|
|
30
|
+
nombreColeccion="personas"
|
|
31
|
+
[idTabla]="['iPersId']"
|
|
32
|
+
[columnasTabla]="columnas"
|
|
33
|
+
[dataSuscription]="datos$"
|
|
34
|
+
[(selectionModel)]="seleccionados.personas"
|
|
35
|
+
(opcionSelecionada)="alElegirOpcion($event)"
|
|
36
|
+
/>
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
`objThis` es el componente padre: la tabla lo necesita para resolver funciones en su contexto.
|
|
40
|
+
`nombreColeccion` identifica la tabla dentro de esa pantalla y es la clave con la que se guarda
|
|
41
|
+
la selección. `idTabla` dice qué campos identifican una fila; **conviene pasarlo siempre**: sin
|
|
42
|
+
él la fila se identifica por su contenido, lo que es más frágil y más caro.
|
|
43
|
+
|
|
44
|
+
## Datos y paginación
|
|
45
|
+
|
|
46
|
+
Los datos entran por `dataSuscription`, un `Observable`. La tabla pagina de dos maneras y elige
|
|
47
|
+
sola según lo que llegue:
|
|
48
|
+
|
|
49
|
+
- **En el cliente**: si los registros no traen `iTotalRegistros`, la tabla ordena, filtra y
|
|
50
|
+
pagina en memoria.
|
|
51
|
+
- **En el servidor**: si el primer registro trae `iTotalRegistros`, la tabla deja de paginar y
|
|
52
|
+
emite por `resultados` lo que el backend necesita —`iPaginacion`, `iPageSize`, `iPageNumber`,
|
|
53
|
+
`bDireccionOrden` y, en modo `query`, `cCampoBusqueda`—. El padre recarga con esos parámetros.
|
|
54
|
+
|
|
55
|
+
El ordenamiento usa el tipo de la columna (`sortType ?? type`) para comparar fechas y números
|
|
56
|
+
como tales, no como texto.
|
|
57
|
+
|
|
58
|
+
## Columnas
|
|
59
|
+
|
|
60
|
+
`ColumnaTabla<T>` es una unión discriminada por `type`:
|
|
61
|
+
|
|
62
|
+
| `type` | Para qué |
|
|
63
|
+
|---|---|
|
|
64
|
+
| `text` | Texto, con `transformar()`, HTML o plantilla propia |
|
|
65
|
+
| `number`, `money` | Números y montos, con `zeroFill` y `simboloMoneda` |
|
|
66
|
+
| `date` | Fechas con formato local |
|
|
67
|
+
| `checkbox` | Selección múltiple (ver abajo) |
|
|
68
|
+
| `icons` | Iconos según el valor, con `iconsDef` |
|
|
69
|
+
| `progress` | Barra de progreso |
|
|
70
|
+
| `yes_no`, `estado` | Sí/no y estados |
|
|
71
|
+
| `image` | Imagen |
|
|
72
|
+
| `expandir` | Botón que despliega la fila extra |
|
|
73
|
+
| `numeracion_automatica` | Numeración continua, respetando la página |
|
|
74
|
+
| `custom` | Lo pinta el consumidor con su propia plantilla |
|
|
75
|
+
| `estiloEstablecido` | Celda con estilo calculado |
|
|
76
|
+
|
|
77
|
+
Propiedades útiles en cualquier columna: `labelLista` (nombre alterno al exportar), `visible` y
|
|
78
|
+
`esVisible()` (que pueden ser funciones), `noMostrarEnLista` para ocultarla del menú de columnas,
|
|
79
|
+
`sticky`/`stickyEnd`, `sort: false`, `cssClasses`, `transformar(row)` y `transformarFooter()`.
|
|
80
|
+
|
|
81
|
+
Con `filtroCampos` (activo por defecto) el usuario elige qué columnas ve, y la elección se
|
|
82
|
+
recuerda por columna.
|
|
83
|
+
|
|
84
|
+
## Botones
|
|
85
|
+
|
|
86
|
+
`TablaMantenimientoService` trae un catálogo ya estilado: `nuevo`, `editar`, `eliminar`,
|
|
87
|
+
`eliminar_fila`, `imprimir`, `descargar`, `ver_archivos`, `exportar_pdf`, `exportar_excel`,
|
|
88
|
+
`exportacion_avanzada`, `guardar`, `cancelar`, `seleccionar`, `detalle`, `ver_mapa`, `activar`,
|
|
89
|
+
`desactivar`, `cerrar` y `abrir`. Basta nombrar el `tipo` y se hereda icono y color.
|
|
90
|
+
|
|
91
|
+
```typescript
|
|
92
|
+
botonesMenu: SeccionesBotonesMantenimiento = {
|
|
93
|
+
principal: [
|
|
94
|
+
{ tipo: 'nuevo' },
|
|
95
|
+
{ tipo: 'reportes', icono: 'roundPrint', subItems: [
|
|
96
|
+
{ tipo: 'imprimir', label: 'Listado' },
|
|
97
|
+
{ tipo: 'exportar_pdf' },
|
|
98
|
+
]},
|
|
99
|
+
],
|
|
100
|
+
};
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Secciones disponibles: `crud`, `principal`, `izquierda`, `derecha`, `secundario`, `inferior`, y
|
|
104
|
+
cualquier clave propia. `botonesCRUD` es una máscara de texto: `'CUD'` muestra crear, actualizar
|
|
105
|
+
y eliminar; `'-'` no muestra ninguno.
|
|
106
|
+
|
|
107
|
+
**Permisos.** Cada botón se deshabilita solo según `derechosActuales[cDerechoCodigo ?? tipo]`,
|
|
108
|
+
que la tabla lee del `data.derechos` de la ruta en cada navegación. `ignorarDerechos` lo salta y
|
|
109
|
+
`ignorarDerecho` por botón, también.
|
|
110
|
+
|
|
111
|
+
**Solo lectura.** Con `readOnly` solo quedan los botones marcados con `ignorarReadOnly`, y no se
|
|
112
|
+
puede eliminar con `Supr` ni disparar la acción del doble clic. `readOnly="permitirSeleccion"`
|
|
113
|
+
deja elegir la fila sin ejecutar nada.
|
|
114
|
+
|
|
115
|
+
## Selección
|
|
116
|
+
|
|
117
|
+
**De una fila**: clic para elegir, clic otra vez sobre la misma para soltarla, flechas para
|
|
118
|
+
moverse, Enter para abrir. La selección sobrevive a las recargas: la tabla vuelve a
|
|
119
|
+
encontrar el registro por `idTabla` y entrega el objeto nuevo, no el anterior.
|
|
120
|
+
|
|
121
|
+
La forma recomendada de leerla es el enlace de dos sentidos:
|
|
122
|
+
|
|
123
|
+
```html
|
|
124
|
+
[(selectionModel)]="seleccionados.personas"
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
**De varias filas**: basta una columna `type: 'checkbox'`. La clave de cada casilla sale de
|
|
128
|
+
`chkField` (o del `property` de la columna), y con `chkFieldSeparador` se pueden combinar varios
|
|
129
|
+
campos. Con `chkFieldPersistente` lo marcado sobrevive al cambio de página. El evento
|
|
130
|
+
`opcionSelecionada` lleva entonces `idsSeleccionados` (texto separado por comas) e
|
|
131
|
+
`itemsSeleccionados` (los registros).
|
|
132
|
+
|
|
133
|
+
### Teclado
|
|
134
|
+
|
|
135
|
+
| Tecla | Qué hace |
|
|
136
|
+
|---|---|
|
|
137
|
+
| Flechas | Mueve el foco y la selección de fila en fila |
|
|
138
|
+
| Enter | Abre el registro enfocado (avisa `ver`) |
|
|
139
|
+
| Espacio | Marca o desmarca su casilla si la tabla tiene columna `checkbox`; si no, abre como Enter |
|
|
140
|
+
| Supr | Pide eliminar (no hace nada en solo lectura ni dentro de un campo de la celda) |
|
|
141
|
+
|
|
142
|
+
Las teclas pulsadas dentro de un campo de una celda se quedan en el campo.
|
|
143
|
+
|
|
144
|
+
## Eventos
|
|
145
|
+
|
|
146
|
+
| Salida | Cuándo |
|
|
147
|
+
|---|---|
|
|
148
|
+
| `opcionSelecionada` | Botón pulsado, fila elegida, doble clic, menú contextual o `Supr`. Lleva el botón, la fila, su índice y la selección |
|
|
149
|
+
| `resultados` | El servidor debe traer otra página, otro orden u otra búsqueda |
|
|
150
|
+
| `accionRecargar` | El usuario pidió actualizar |
|
|
151
|
+
| `selectionModelChange` | Cambió la fila seleccionada |
|
|
152
|
+
| `opcBusqueda` | Cambió el criterio de búsqueda |
|
|
153
|
+
|
|
154
|
+
## Búsqueda
|
|
155
|
+
|
|
156
|
+
`ctrlBusqueda="simple"` filtra en memoria; `ctrlBusqueda="query"` manda el término al servidor
|
|
157
|
+
dentro de `resultados`. `busquedaCompacta` reduce el buscador a un icono. El texto buscado se
|
|
158
|
+
mantiene al recargar.
|
|
159
|
+
|
|
160
|
+
El panel de filtros avanzados **no** es parte de esta tabla: es el componente hermano
|
|
161
|
+
`jvs-filtro-busqueda`, que se coloca aparte y devuelve sus resultados por `dataFiltro`.
|
|
162
|
+
|
|
163
|
+
## Fila extra y pie
|
|
164
|
+
|
|
165
|
+
`filaExtraTemplate` despliega contenido bajo cada fila, normalmente junto a una columna
|
|
166
|
+
`type: 'expandir'`. Con fila extra el ordenamiento se bloquea, porque reordenar rompería la
|
|
167
|
+
correspondencia con lo desplegado. `filaFooter` activa el pie, que cada columna calcula con
|
|
168
|
+
`transformarFooter()`.
|
|
169
|
+
|
|
170
|
+
## Exportación
|
|
171
|
+
|
|
172
|
+
`exportarExcel` (activo por defecto) añade el botón y exporta **lo que se ve**: respeta el
|
|
173
|
+
filtro, el orden y las columnas visibles, y usa `labelLista` como encabezado. Fechas, números y
|
|
174
|
+
montos salen con su tipo, no como texto.
|
|
175
|
+
|
|
176
|
+
## Notas de comportamiento
|
|
177
|
+
|
|
178
|
+
- La tabla **no escribe dentro de los datos ni de las columnas** que recibe. Si ves propiedades
|
|
179
|
+
que no declaraste, no vienen de aquí.
|
|
180
|
+
- Consultar los botones no los modifica; leer las columnas visibles, tampoco.
|
|
181
|
+
- `objThis.seleccionados[nombreColeccion]` se sigue consultando como respaldo cuando la fila
|
|
182
|
+
elegida no está entre los datos cargados, pero el canal recomendado es `[(selectionModel)]`.
|
|
183
|
+
|
|
184
|
+
## En retirada
|
|
185
|
+
|
|
186
|
+
Estas piezas siguen funcionando pero están marcadas como obsoletas y se quitarán en una
|
|
187
|
+
versión mayor. Si las usas, conviene ir migrando:
|
|
188
|
+
|
|
189
|
+
| En retirada | En su lugar |
|
|
190
|
+
|---|---|
|
|
191
|
+
| `row.isExpanded` dentro del registro | `estaExpandida(row)` y `alternarExpansion(row)` |
|
|
192
|
+
| `objThis.seleccionados[nombreColeccion]` como canal de selección | `[(selectionModel)]` |
|
|
193
|
+
| `dblclickItem` | `opcionSelecionada` con tipo `seleccionar` |
|
|
194
|
+
| `dataSourceChange` | — (entregaba la instancia interna del dataSource) |
|
|
195
|
+
| `DataModel.agregarControles` para casillas | `DataModel.prepararCasillas` |
|
|
196
|
+
|
|
197
|
+
## Para mirar el código
|
|
198
|
+
|
|
199
|
+
- `tabla-mantenimiento.component.ts` — componente principal
|
|
200
|
+
- `tabla-mantenimiento.service.ts` — catálogo de botones y columnas
|
|
201
|
+
- `tabla-mantenimiento-column-defs/` — un componente por tipo de columna
|
|
202
|
+
- `classes/data-model.ts` — estado de las casillas de selección múltiple
|
|
203
|
+
- `mat-row-keyboard-selection.directive.ts` — navegación con el teclado
|
|
204
|
+
- `tabla-mantenimiento.component.spec.ts` — el comportamiento descrito aquí, fijado en pruebas
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import * as _angular_core from '@angular/core';
|
|
2
|
+
|
|
3
|
+
interface AlertaClases {
|
|
4
|
+
contenedor?: string;
|
|
5
|
+
icono?: string;
|
|
6
|
+
titulo?: string;
|
|
7
|
+
mensaje?: string;
|
|
8
|
+
acciones?: string;
|
|
9
|
+
}
|
|
10
|
+
type AlertaTipo = 'info' | 'error' | 'success' | 'warning' | 'custom';
|
|
11
|
+
declare class AlertaComponent {
|
|
12
|
+
tipo: _angular_core.InputSignal<AlertaTipo>;
|
|
13
|
+
titulo: _angular_core.InputSignal<string | undefined>;
|
|
14
|
+
mensaje: _angular_core.InputSignal<string | undefined>;
|
|
15
|
+
iconoManual: _angular_core.InputSignal<string | undefined>;
|
|
16
|
+
clasesManual: _angular_core.InputSignal<AlertaClases>;
|
|
17
|
+
botonCerrar: _angular_core.InputSignal<boolean>;
|
|
18
|
+
botonAcepto: _angular_core.InputSignal<boolean>;
|
|
19
|
+
textoAcepto: _angular_core.InputSignal<string>;
|
|
20
|
+
alCerrar: _angular_core.OutputEmitterRef<void>;
|
|
21
|
+
alAceptar: _angular_core.OutputEmitterRef<void>;
|
|
22
|
+
private defaults;
|
|
23
|
+
clasesContenedor: _angular_core.Signal<string>;
|
|
24
|
+
iconoFinal: _angular_core.Signal<string>;
|
|
25
|
+
clasesIcono: _angular_core.Signal<string>;
|
|
26
|
+
clasesTitulo: _angular_core.Signal<string>;
|
|
27
|
+
clasesMensaje: _angular_core.Signal<string>;
|
|
28
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertaComponent, never>;
|
|
29
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertaComponent, "jvs-alerta", never, { "tipo": { "alias": "tipo"; "required": false; "isSignal": true; }; "titulo": { "alias": "titulo"; "required": false; "isSignal": true; }; "mensaje": { "alias": "mensaje"; "required": false; "isSignal": true; }; "iconoManual": { "alias": "icono"; "required": false; "isSignal": true; }; "clasesManual": { "alias": "clases"; "required": false; "isSignal": true; }; "botonCerrar": { "alias": "botonCerrar"; "required": false; "isSignal": true; }; "botonAcepto": { "alias": "botonAcepto"; "required": false; "isSignal": true; }; "textoAcepto": { "alias": "textoAcepto"; "required": false; "isSignal": true; }; }, { "alCerrar": "alCerrar"; "alAceptar": "alAceptar"; }, never, ["*"], true, never>;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export { AlertaComponent };
|
|
33
|
+
export type { AlertaClases, AlertaTipo };
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import * as _angular_core from '@angular/core';
|
|
2
|
+
import { MatDialogRef } from '@angular/material/dialog';
|
|
3
|
+
|
|
4
|
+
type TiposOpciones = 'ver' | 'nuevo' | 'editar' | 'guardar' | 'eliminar' | 'seleccionar' | 'editar_item' | 'detalle' | 'ver_archivos' | 'eliminar_fila' | 'imprimir' | 'descargar' | 'exportar_pdf' | 'exportar_excel' | string;
|
|
5
|
+
interface BotonDialog {
|
|
6
|
+
tipo?: TiposOpciones;
|
|
7
|
+
class?: string;
|
|
8
|
+
icono?: string;
|
|
9
|
+
label?: string;
|
|
10
|
+
sinCondicion?: boolean;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
declare class DialogFlotanteComponent {
|
|
14
|
+
cssClases: _angular_core.InputSignal<Record<string, string>>;
|
|
15
|
+
sinTitulo: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
16
|
+
sinBarraDeAccion: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
17
|
+
btnCerrarBarra: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
18
|
+
iconoTitulo: _angular_core.InputSignal<string | undefined>;
|
|
19
|
+
matDialogRefActual: _angular_core.InputSignal<MatDialogRef<any, any> | undefined>;
|
|
20
|
+
btnGuardarInput: _angular_core.InputSignal<string | boolean | BotonDialog | undefined>;
|
|
21
|
+
btnCerrarInput: _angular_core.InputSignal<string | boolean | BotonDialog | undefined>;
|
|
22
|
+
btnGuardarClick: _angular_core.OutputEmitterRef<any>;
|
|
23
|
+
btnCerrarClick: _angular_core.OutputEmitterRef<any>;
|
|
24
|
+
private readonly defaultBtnCerrar;
|
|
25
|
+
private readonly defaultBtnGuardar;
|
|
26
|
+
btnCerrar: _angular_core.Signal<BotonDialog | undefined>;
|
|
27
|
+
btnGuardar: _angular_core.Signal<BotonDialog | undefined>;
|
|
28
|
+
guardarDialogo(): void;
|
|
29
|
+
/** El diálogo que contiene a este componente, para cerrarlo cuando no se pasa `matDialogRefActual`. */
|
|
30
|
+
private readonly dialogRefContenedor;
|
|
31
|
+
cerrarDialogo(): void;
|
|
32
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DialogFlotanteComponent, never>;
|
|
33
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<DialogFlotanteComponent, "[jvsDialogFlotante]", never, { "cssClases": { "alias": "cssClases"; "required": false; "isSignal": true; }; "sinTitulo": { "alias": "sinTitulo"; "required": false; "isSignal": true; }; "sinBarraDeAccion": { "alias": "sinBarraDeAccion"; "required": false; "isSignal": true; }; "btnCerrarBarra": { "alias": "btnCerrarBarra"; "required": false; "isSignal": true; }; "iconoTitulo": { "alias": "iconoTitulo"; "required": false; "isSignal": true; }; "matDialogRefActual": { "alias": "matDialogRefActual"; "required": false; "isSignal": true; }; "btnGuardarInput": { "alias": "btnGuardar"; "required": false; "isSignal": true; }; "btnCerrarInput": { "alias": "btnCerrar"; "required": false; "isSignal": true; }; }, { "btnGuardarClick": "btnGuardarClick"; "btnCerrarClick": "btnCerrarClick"; }, never, ["[tituloImagen]", "[titulo]", "[selectTitulo]", "[cuerpo]", "[pieIzquierda]", "[pieCentro]", "[pieDerecha]"], true, never>;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export { DialogFlotanteComponent };
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
import * as _angular_core from '@angular/core';
|
|
2
|
+
import { TemplateRef, OnInit, OnDestroy, InjectionToken } from '@angular/core';
|
|
3
|
+
import { Observable, BehaviorSubject, Subject } from 'rxjs';
|
|
4
|
+
import { FormGroup, FormArray, FormControl } from '@angular/forms';
|
|
5
|
+
import { TipoValorFuncion, DataServidor, tipoValorFuncion, mostrarValorEnBusqueda } from '@jvsoft/utils';
|
|
6
|
+
|
|
7
|
+
type TiposControl = 'select' | 'autocomplete' | 'date' | 'text' | 'number' | 'date_range' | 'controlAgrupado' | 'checkbox';
|
|
8
|
+
type TiposValores = '*primero*' | '*deUsuario*' | '*fechaActual*' | any;
|
|
9
|
+
interface TabSeccion {
|
|
10
|
+
id?: string;
|
|
11
|
+
label?: string;
|
|
12
|
+
campos?: CampoFiltro[];
|
|
13
|
+
esVisible?: TipoValorFuncion<boolean>;
|
|
14
|
+
}
|
|
15
|
+
interface CampoFiltroChange {
|
|
16
|
+
filter?: boolean;
|
|
17
|
+
filterFields?: string[];
|
|
18
|
+
}
|
|
19
|
+
interface CampoFiltroSelectAutocompleteComun {
|
|
20
|
+
ordenPeticion?: number;
|
|
21
|
+
data?: string;
|
|
22
|
+
customData?: any[];
|
|
23
|
+
dataCuandoVacio?: any[];
|
|
24
|
+
campoValor?: string | '*objeto*';
|
|
25
|
+
camposText?: string[];
|
|
26
|
+
textoCuandoNulo?: string;
|
|
27
|
+
optionText?(row: any): string;
|
|
28
|
+
cssClass?: {
|
|
29
|
+
class?: string;
|
|
30
|
+
option?: string;
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
interface CampoFiltroDateRange {
|
|
34
|
+
campo?: [string, string];
|
|
35
|
+
value?: [TiposValores, TiposValores];
|
|
36
|
+
}
|
|
37
|
+
interface CampoFiltroSelect extends CampoFiltroSelectAutocompleteComun {
|
|
38
|
+
}
|
|
39
|
+
interface CampoFiltroAutocomplete extends CampoFiltroSelectAutocompleteComun {
|
|
40
|
+
controlType?: 'textarea' | 'text';
|
|
41
|
+
class?: string;
|
|
42
|
+
searchFields?: string[];
|
|
43
|
+
campotxtBuscar?: string;
|
|
44
|
+
campotxtBuscarLength?: number;
|
|
45
|
+
optionTemplate?: TemplateRef<any>;
|
|
46
|
+
optionInnerHtml?(row: any): string;
|
|
47
|
+
}
|
|
48
|
+
interface CampoFiltro {
|
|
49
|
+
control: TiposControl;
|
|
50
|
+
templateName?: string;
|
|
51
|
+
campo: string;
|
|
52
|
+
aliasCampoEnviar?: string;
|
|
53
|
+
label?: string;
|
|
54
|
+
cssClass?: string;
|
|
55
|
+
value?: TiposValores;
|
|
56
|
+
reqParams?: {
|
|
57
|
+
params?: object;
|
|
58
|
+
fields?: string[];
|
|
59
|
+
};
|
|
60
|
+
disabled?: boolean;
|
|
61
|
+
required?: boolean;
|
|
62
|
+
keyUpEnter?: boolean;
|
|
63
|
+
change?: CampoFiltroChange;
|
|
64
|
+
checkbox?: {
|
|
65
|
+
text: TipoValorFuncion<string>;
|
|
66
|
+
};
|
|
67
|
+
dateRange?: CampoFiltroDateRange;
|
|
68
|
+
select?: CampoFiltroSelect;
|
|
69
|
+
autocomplete?: CampoFiltroAutocomplete;
|
|
70
|
+
controlAgrupado?: CampoFiltro[];
|
|
71
|
+
modificadorDatos?(control: CampoFiltro): any;
|
|
72
|
+
}
|
|
73
|
+
interface TabFiltroSeccion extends Omit<TabSeccion, 'id'> {
|
|
74
|
+
campos: CampoFiltro[];
|
|
75
|
+
}
|
|
76
|
+
interface DataFiltroAplicado {
|
|
77
|
+
campo: string;
|
|
78
|
+
label: string;
|
|
79
|
+
value: any;
|
|
80
|
+
list?: any[];
|
|
81
|
+
valueString?: string;
|
|
82
|
+
valueObject?: any;
|
|
83
|
+
}
|
|
84
|
+
interface FiltroResultante {
|
|
85
|
+
datosFiltro: {
|
|
86
|
+
[key: string]: any;
|
|
87
|
+
};
|
|
88
|
+
datosFiltroConLabel: DataFiltroAplicado[];
|
|
89
|
+
labelResumen: string;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
interface IQueryService {
|
|
93
|
+
cargar(objThis: any, reqArray: string[], data: any, anonimo: boolean, prefix: string): Promise<any>;
|
|
94
|
+
}
|
|
95
|
+
declare const QUERY_SERVICE_TOKEN: InjectionToken<IQueryService>;
|
|
96
|
+
declare class FiltroBusquedaComponent implements OnInit, OnDestroy {
|
|
97
|
+
private fb;
|
|
98
|
+
private toastr;
|
|
99
|
+
private filtroBusquedaService;
|
|
100
|
+
private queryService;
|
|
101
|
+
opciones: _angular_core.InputSignal<TabSeccion[]>;
|
|
102
|
+
nombreColeccionInput: _angular_core.InputSignal<string>;
|
|
103
|
+
prefijoConsulta: _angular_core.InputSignal<string>;
|
|
104
|
+
busquedaAutomatica: _angular_core.InputSignal<boolean>;
|
|
105
|
+
opciones$: _angular_core.InputSignal<Observable<TabSeccion[]> | undefined>;
|
|
106
|
+
modificarOpciones$: _angular_core.InputSignal<Observable<{
|
|
107
|
+
[key: string]: any;
|
|
108
|
+
}> | undefined>;
|
|
109
|
+
defaultTab: _angular_core.InputSignal<number>;
|
|
110
|
+
/**
|
|
111
|
+
* @deprecated Paradigma Zero-Output: Inyecta FiltroBusquedaService y usa `getFiltroSignal('nombreColeccion')` para estado en tiempo real, esto evita renderizados innecesarios del padre.
|
|
112
|
+
*/
|
|
113
|
+
dataFiltro: _angular_core.OutputEmitterRef<any>;
|
|
114
|
+
/**
|
|
115
|
+
* @deprecated Su payload de diccionario crudo desaparecerá pronto (Mejora 2). Migra al nuevo evento `(buscar)` que emite la interfaz `FiltroResultante`.
|
|
116
|
+
* Se mantiene temporalmente para componentes legacy.
|
|
117
|
+
*/
|
|
118
|
+
resultados: _angular_core.OutputEmitterRef<any>;
|
|
119
|
+
/**
|
|
120
|
+
* Evento principal explícito de búsqueda (Click en Filtrar). Emite el objeto con metadata y labels.
|
|
121
|
+
*/
|
|
122
|
+
buscar: _angular_core.OutputEmitterRef<FiltroResultante>;
|
|
123
|
+
/**
|
|
124
|
+
* @deprecated Paradigma Zero-Output: Maneja la finalización de carga a través de los Signals internos del servicio o asume inmediatez de la arquitectura nueva.
|
|
125
|
+
*/
|
|
126
|
+
cargaCompleta: _angular_core.OutputEmitterRef<boolean>;
|
|
127
|
+
tabActual: _angular_core.WritableSignal<number>;
|
|
128
|
+
dataOpcionesNuevo: _angular_core.WritableSignal<TabFiltroSeccion[]>;
|
|
129
|
+
isCargaCompleta: _angular_core.WritableSignal<boolean>;
|
|
130
|
+
frmFiltroBusqueda: FormGroup;
|
|
131
|
+
get opcionesTabs(): FormArray;
|
|
132
|
+
get frmGroupSeleccionado(): FormGroup;
|
|
133
|
+
getControl(nombre: string): FormControl;
|
|
134
|
+
getControlRaiz(nombre: string): FormControl;
|
|
135
|
+
getAutocompleteLabel(controlData: CampoFiltro, value: any): string;
|
|
136
|
+
dataServidor: DataServidor;
|
|
137
|
+
dataServidorSuscripcion: {
|
|
138
|
+
[key: string]: BehaviorSubject<any>;
|
|
139
|
+
};
|
|
140
|
+
filtrados: {
|
|
141
|
+
[key: string]: any[];
|
|
142
|
+
};
|
|
143
|
+
inputParaEnviarAutocomplete: Subject<any>;
|
|
144
|
+
private destroy$;
|
|
145
|
+
protected sufixTemporal: string;
|
|
146
|
+
protected tipoValorFuncion: typeof tipoValorFuncion;
|
|
147
|
+
private fechaActual;
|
|
148
|
+
constructor();
|
|
149
|
+
ngOnInit(): void;
|
|
150
|
+
private initOpciones;
|
|
151
|
+
private reorganizarOpcionesNuevas;
|
|
152
|
+
cargarDatosFiltroNuevo(idTab?: number): Promise<void>;
|
|
153
|
+
private actualizarEstadoService;
|
|
154
|
+
private setCustomData;
|
|
155
|
+
private procesarRetornoDatos;
|
|
156
|
+
getFiltroResultante(): FiltroResultante;
|
|
157
|
+
mostrarValorEnBusqueda: typeof mostrarValorEnBusqueda;
|
|
158
|
+
campoValorEval(campoFiltro: CampoFiltro, itemSelect: any): any;
|
|
159
|
+
campoTextEval(campoFiltro: CampoFiltro, itemSelect: any): string;
|
|
160
|
+
concatenarCadenasArray(array: string | string[], objData: any): any;
|
|
161
|
+
filtrarData(): void;
|
|
162
|
+
actualizarEnFormArray(name: string, value: any, extra?: {
|
|
163
|
+
disabled?: boolean;
|
|
164
|
+
}): void;
|
|
165
|
+
accionPosteriorCambioAutocomplete(controlData: CampoFiltro, valControl: any): void;
|
|
166
|
+
cambiarNuevo(campo: CampoFiltro, val: any): void;
|
|
167
|
+
cambiarSeleccionNuevo(campo: CampoFiltro, event?: any): void;
|
|
168
|
+
buscarControl(campo: string): CampoFiltro | undefined;
|
|
169
|
+
generarParams(meta: CampoFiltro, trigger: CampoFiltro): any;
|
|
170
|
+
limpiarAutocomplete(campo: CampoFiltro, event: Event): void;
|
|
171
|
+
ngOnDestroy(): void;
|
|
172
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<FiltroBusquedaComponent, never>;
|
|
173
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<FiltroBusquedaComponent, "jvs-filtro-busqueda", never, { "opciones": { "alias": "opciones"; "required": false; "isSignal": true; }; "nombreColeccionInput": { "alias": "nombreColeccion"; "required": false; "isSignal": true; }; "prefijoConsulta": { "alias": "prefijoConsulta"; "required": false; "isSignal": true; }; "busquedaAutomatica": { "alias": "busquedaAutomatica"; "required": false; "isSignal": true; }; "opciones$": { "alias": "opciones$"; "required": false; "isSignal": true; }; "modificarOpciones$": { "alias": "modificarOpciones$"; "required": false; "isSignal": true; }; "defaultTab": { "alias": "defaultTab"; "required": false; "isSignal": true; }; }, { "dataFiltro": "dataFiltro"; "resultados": "resultados"; "buscar": "buscar"; "cargaCompleta": "cargaCompleta"; }, never, never, true, never>;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
declare class FiltroBusquedaService {
|
|
177
|
+
private _filtrosActivos;
|
|
178
|
+
private _dataServidorActivos;
|
|
179
|
+
filtrosActivos: _angular_core.Signal<Map<string, any>>;
|
|
180
|
+
dataServidorActivos: _angular_core.Signal<Map<string, Map<string, any>>>;
|
|
181
|
+
/**
|
|
182
|
+
* Establece un valor para un filtro reactivo
|
|
183
|
+
*/
|
|
184
|
+
setValue(nombreFiltro: string, val: any): void;
|
|
185
|
+
/**
|
|
186
|
+
* @deprecated Usa `getFiltroSignal(nombreFiltro)` en componentes modernos.
|
|
187
|
+
* Retorna el snapshot sincrónico actual (para componentes legacy).
|
|
188
|
+
*/
|
|
189
|
+
getValue(nombreFiltro: string): any;
|
|
190
|
+
/**
|
|
191
|
+
* Actualiza la metadata del servidor (Signals).
|
|
192
|
+
*/
|
|
193
|
+
setDataServidorSuscripcion(nombreFiltro: string, campo: string, data: any): void;
|
|
194
|
+
/**
|
|
195
|
+
* @deprecated Usa `getDataServidorSignal(nombreFiltro, campo)` en componentes modernos.
|
|
196
|
+
* Retorna el snapshot sincrónico actual de metadata (para componentes legacy).
|
|
197
|
+
*/
|
|
198
|
+
getDataServidorSuscripcion(nombreFiltro: string, campo: string): any;
|
|
199
|
+
/**
|
|
200
|
+
* Crea y devuelve un Signal reactivo continuo para observar los valores aplicados de un filtro particular.
|
|
201
|
+
* @param nombreFiltro Nombre del filtro que se desea escuchar
|
|
202
|
+
* @param defaultValue Valor de respaldo seguro si aún no se ha inicializado el filtro.
|
|
203
|
+
*/
|
|
204
|
+
getFiltroSignal<T = any>(nombreFiltro: string, defaultValue?: T): _angular_core.Signal<T>;
|
|
205
|
+
/**
|
|
206
|
+
* Crea y devuelve un Signal reactivo continuo para escuchar la metadata/catálogo recibida del backend para un campo.
|
|
207
|
+
* @param nombreFiltro Nombre de la colección del filtro principal
|
|
208
|
+
* @param campo Campo específico (ej: id_usuario, categoria) del que se espera escuchar la lista u objeto servidor
|
|
209
|
+
* @param defaultValue Valor de respaldo seguro si aún no hay data del servidor.
|
|
210
|
+
*/
|
|
211
|
+
getDataServidorSignal<T = any>(nombreFiltro: string, campo: string, defaultValue?: T): _angular_core.Signal<T>;
|
|
212
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<FiltroBusquedaService, never>;
|
|
213
|
+
static ɵprov: _angular_core.ɵɵInjectableDeclaration<FiltroBusquedaService>;
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
export { FiltroBusquedaComponent, FiltroBusquedaService, QUERY_SERVICE_TOKEN };
|
|
217
|
+
export type { CampoFiltro, CampoFiltroAutocomplete, CampoFiltroChange, CampoFiltroDateRange, CampoFiltroSelect, CampoFiltroSelectAutocompleteComun, DataFiltroAplicado, FiltroResultante, IQueryService, TabFiltroSeccion, TabSeccion, TiposControl, TiposValores };
|