@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.
Files changed (96) hide show
  1. package/.storybook/tema-demo.css +188 -0
  2. package/dialog-flotante/README.md +21 -1
  3. package/fesm2022/jvsoft-components-alerta.mjs +19 -20
  4. package/fesm2022/jvsoft-components-alerta.mjs.map +1 -1
  5. package/fesm2022/jvsoft-components-dialog-flotante.mjs +31 -25
  6. package/fesm2022/jvsoft-components-dialog-flotante.mjs.map +1 -1
  7. package/fesm2022/jvsoft-components-filtro-busqueda.mjs +19 -19
  8. package/fesm2022/jvsoft-components-filtro-busqueda.mjs.map +1 -1
  9. package/fesm2022/jvsoft-components-foto-persona.mjs +481 -0
  10. package/fesm2022/jvsoft-components-foto-persona.mjs.map +1 -0
  11. package/fesm2022/jvsoft-components-lista-arbol.mjs +33 -34
  12. package/fesm2022/jvsoft-components-lista-arbol.mjs.map +1 -1
  13. package/fesm2022/jvsoft-components-luces-navidad.mjs +4 -8
  14. package/fesm2022/jvsoft-components-luces-navidad.mjs.map +1 -1
  15. package/fesm2022/jvsoft-components-mat-suffix-search-button.mjs +3 -3
  16. package/fesm2022/jvsoft-components-mat-suffix-search-button.mjs.map +1 -1
  17. package/fesm2022/jvsoft-components-menu.mjs +13 -13
  18. package/fesm2022/jvsoft-components-menu.mjs.map +1 -1
  19. package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs +4 -4
  20. package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs.map +1 -1
  21. package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs +542 -345
  22. package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs.map +1 -1
  23. package/fesm2022/jvsoft-components.mjs +9 -3015
  24. package/fesm2022/jvsoft-components.mjs.map +1 -1
  25. package/foto-persona/README.md +341 -0
  26. package/lista-arbol/README.md +1 -1
  27. package/package.json +22 -17
  28. package/src/styles/base-jvsoft-components.css +1541 -5
  29. package/tabla-mantenimiento/README.md +204 -0
  30. package/types/jvsoft-components-alerta.d.ts +33 -0
  31. package/types/jvsoft-components-dialog-flotante.d.ts +36 -0
  32. package/types/jvsoft-components-filtro-busqueda.d.ts +217 -0
  33. package/types/jvsoft-components-foto-persona.d.ts +300 -0
  34. package/types/jvsoft-components-lista-arbol.d.ts +61 -0
  35. package/{luces-navidad/luces-navidad.component.d.ts → types/jvsoft-components-luces-navidad.d.ts} +5 -2
  36. package/{mat-suffix-search-button/mat-suffix-search-button.component.d.ts → types/jvsoft-components-mat-suffix-search-button.d.ts} +5 -2
  37. package/{menu/menu.component.d.ts → types/jvsoft-components-menu.d.ts} +25 -4
  38. package/{tabla-mantenimiento/components/progress-bar/progress-bar.component.d.ts → types/jvsoft-components-tabla-mantenimiento-components-progress-bar.d.ts} +7 -3
  39. package/types/jvsoft-components-tabla-mantenimiento.d.ts +611 -0
  40. package/types/jvsoft-components.d.ts +9 -0
  41. package/alerta/alerta.component.d.ts +0 -29
  42. package/alerta/index.d.ts +0 -5
  43. package/alerta/public-api.d.ts +0 -1
  44. package/dialog-flotante/dialog-flotante.component.d.ts +0 -23
  45. package/dialog-flotante/dialog-flotante.interface.d.ts +0 -11
  46. package/dialog-flotante/index.d.ts +0 -5
  47. package/dialog-flotante/public-api.d.ts +0 -1
  48. package/filtro-busqueda/filtro-busqueda.component.d.ts +0 -89
  49. package/filtro-busqueda/filtro-busqueda.service.d.ts +0 -40
  50. package/filtro-busqueda/index.d.ts +0 -5
  51. package/filtro-busqueda/interfaces/filtro-busqueda.interface.d.ts +0 -86
  52. package/filtro-busqueda/public-api.d.ts +0 -3
  53. package/index.d.ts +0 -9
  54. package/lista-arbol/index.d.ts +0 -5
  55. package/lista-arbol/lista-arbol.component.d.ts +0 -57
  56. package/lista-arbol/lista-arbol.functions.d.ts +0 -8
  57. package/lista-arbol/public-api.d.ts +0 -1
  58. package/luces-navidad/index.d.ts +0 -5
  59. package/luces-navidad/public-api.d.ts +0 -1
  60. package/mat-suffix-search-button/index.d.ts +0 -5
  61. package/mat-suffix-search-button/public-api.d.ts +0 -1
  62. package/menu/index.d.ts +0 -5
  63. package/menu/menu.interface.d.ts +0 -16
  64. package/menu/public-api.d.ts +0 -2
  65. package/tabla-mantenimiento/classes/data-model.d.ts +0 -25
  66. package/tabla-mantenimiento/components/progress-bar/index.d.ts +0 -5
  67. package/tabla-mantenimiento/components/progress-bar/public-api.d.ts +0 -1
  68. package/tabla-mantenimiento/index.d.ts +0 -5
  69. package/tabla-mantenimiento/interfaces/Implements/incluye-tabla-mantenimiento.d.ts +0 -12
  70. package/tabla-mantenimiento/interfaces/Implements/index.d.ts +0 -1
  71. package/tabla-mantenimiento/interfaces/archivo.d.ts +0 -26
  72. package/tabla-mantenimiento/interfaces/global/boton-mantenimiento.d.ts +0 -41
  73. package/tabla-mantenimiento/interfaces/global/columnas-tabla.d.ts +0 -142
  74. package/tabla-mantenimiento/interfaces/global/index.d.ts +0 -3
  75. package/tabla-mantenimiento/interfaces/global/no-export.d.ts +0 -2
  76. package/tabla-mantenimiento/interfaces/global/otros.d.ts +0 -28
  77. package/tabla-mantenimiento/interfaces/index.d.ts +0 -3
  78. package/tabla-mantenimiento/mat-row-keyboard-selection.directive.d.ts +0 -19
  79. package/tabla-mantenimiento/pipes/no-sanitize.pipe.d.ts +0 -10
  80. package/tabla-mantenimiento/pipes/zero-fill.pipe.d.ts +0 -8
  81. package/tabla-mantenimiento/public-api.d.ts +0 -4
  82. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-date/column-type-date.component.d.ts +0 -8
  83. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-icons/column-type-icons.component.d.ts +0 -9
  84. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-money/column-type-money.component.d.ts +0 -9
  85. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-number/column-type-number.component.d.ts +0 -8
  86. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-progressbar/column-type-progressbar.component.d.ts +0 -8
  87. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-sino/column-type-sino.component.d.ts +0 -9
  88. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type-text/column-type-text.component.d.ts +0 -8
  89. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type.component.d.ts +0 -18
  90. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/column-type/column-type.module.d.ts +0 -24
  91. package/tabla-mantenimiento/tabla-mantenimiento-column-defs/tabla-mantenimiento-column-defs.component.d.ts +0 -21
  92. package/tabla-mantenimiento/tabla-mantenimiento-menu/tabla-mantenimiento-menu.component.d.ts +0 -18
  93. package/tabla-mantenimiento/tabla-mantenimiento.component.d.ts +0 -159
  94. package/tabla-mantenimiento/tabla-mantenimiento.functions.d.ts +0 -5
  95. package/tabla-mantenimiento/tabla-mantenimiento.service.d.ts +0 -8
  96. 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 };