@jvsoft/components 1.0.0-alpha.16 → 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.
@@ -77,7 +77,7 @@ export class ExampleComponent {
77
77
  |--------|------|-------------|
78
78
  | `seleccionado` | `EventEmitter<any>` | Emite cuando se selecciona un item |
79
79
  | `selectionModelChange` | `EventEmitter<any>` | Emite cambios en el modelo de selección |
80
- | `listaCheck` | `EventEmitter<T[]>` | Emite array de items seleccionados (modo checkbox) |
80
+ | `listaCheck` | `OutputEmitterRef<string>` | Emite los ids seleccionados separados por comas, p. ej. `"6,8"` (modo checkbox) |
81
81
  | `listaCheckObj` | `EventEmitter<Record<string, any>>` | Emite objeto con items seleccionados (modo checkbox) |
82
82
 
83
83
  ## Ejemplos
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.17",
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.17",
15
15
  "tailwindcss": "3",
16
16
  "xlsx": "^0.18.5"
17
17
  },
@@ -554,6 +554,10 @@ video {
554
554
  display: none;
555
555
  }
556
556
 
557
+ .\!visible {
558
+ visibility: visible !important;
559
+ }
560
+
557
561
  .visible {
558
562
  visibility: visible;
559
563
  }
@@ -1284,11 +1288,6 @@ video {
1284
1288
  color: rgb(74 222 128 / var(--tw-text-opacity, 1));
1285
1289
  }
1286
1290
 
1287
- .text-green-600 {
1288
- --tw-text-opacity: 1;
1289
- color: rgb(22 163 74 / var(--tw-text-opacity, 1));
1290
- }
1291
-
1292
1291
  .text-green-700 {
1293
1292
  --tw-text-opacity: 1;
1294
1293
  color: rgb(21 128 61 / var(--tw-text-opacity, 1));
@@ -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
@@ -26,6 +26,8 @@ declare class DialogFlotanteComponent {
26
26
  btnCerrar: _angular_core.Signal<BotonDialog | undefined>;
27
27
  btnGuardar: _angular_core.Signal<BotonDialog | undefined>;
28
28
  guardarDialogo(): void;
29
+ /** El diálogo que contiene a este componente, para cerrarlo cuando no se pasa `matDialogRefActual`. */
30
+ private readonly dialogRefContenedor;
29
31
  cerrarDialogo(): void;
30
32
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DialogFlotanteComponent, never>;
31
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>;
@@ -29,7 +29,8 @@ declare class ListaArbolComponent<T = any> {
29
29
  selectionModel: _angular_core.InputSignal<any>;
30
30
  selectionModelChange: _angular_core.OutputEmitterRef<any>;
31
31
  seleccionado: _angular_core.OutputEmitterRef<any>;
32
- listaCheck: _angular_core.OutputEmitterRef<T[]>;
32
+ /** Ids marcados, separados por comas (p. ej. "6,8"): es lo que arma `DataModel.generarLista()`. */
33
+ listaCheck: _angular_core.OutputEmitterRef<string>;
33
34
  listaCheckObj: _angular_core.OutputEmitterRef<Record<string, any>>;
34
35
  private _idTabla;
35
36
  private _seleccionado;
@@ -27,6 +27,7 @@ declare class MenuComponent implements OnInit, AfterViewInit {
27
27
  menu: BotonMenu[];
28
28
  action: EventEmitter<string>;
29
29
  matmenus: QueryList<MatMenu>;
30
+ private readonly cdr;
30
31
  menuItems: string[];
31
32
  yet: boolean;
32
33
  _submenus: BotonMenu[][];
@@ -2,13 +2,12 @@ import * as _jvsoft_components_tabla_mantenimiento from '@jvsoft/components/tabl
2
2
  import * as _angular_core from '@angular/core';
3
3
  import { OnInit, TemplateRef, AfterContentInit, OnChanges, ViewContainerRef, EventEmitter, QueryList, ElementRef, ChangeDetectorRef, SimpleChanges } from '@angular/core';
4
4
  import { Overlay, OverlayRef } from '@angular/cdk/overlay';
5
- import { FormGroup, FormControl, FormBuilder } from '@angular/forms';
5
+ import { FormGroup, FormControl } from '@angular/forms';
6
6
  import { MatMenuTrigger } from '@angular/material/menu';
7
7
  import { MatPaginator } from '@angular/material/paginator';
8
8
  import { MatSort } from '@angular/material/sort';
9
9
  import { MatTableDataSource, MatTable, MatColumnDef } from '@angular/material/table';
10
10
  import { BehaviorSubject, Observable, Subscription } from 'rxjs';
11
- import { SelectionModel } from '@angular/cdk/collections';
12
11
  import { Router, ActivatedRoute } from '@angular/router';
13
12
 
14
13
  declare class DataModel {
@@ -18,6 +17,22 @@ declare class DataModel {
18
17
  checkbox: ForCheckboxModel;
19
18
  constructor();
20
19
  generarId(row: any, campoValor: string[] | string, separador?: string): string;
20
+ /**
21
+ * Prepara una casilla por fila usando como clave el mismo identificador con el que la celda
22
+ * lee y escribe (`generarId`). `agregarControles` compone la clave de otra manera cuando el
23
+ * campo es un texto o un array sin separador, así que el modelo y la casilla acababan
24
+ * hablando de claves distintas: la casilla salía vacía y la lista de seleccionados
25
+ * devolvía filas que nadie había marcado.
26
+ *
27
+ * Con `limpiar` en false conserva lo ya marcado, que es lo que espera `chkFieldPersistente`
28
+ * cuando la selección tiene que sobrevivir al cambio de página.
29
+ */
30
+ prepararCasillas(lista: any[], campoValor: string[] | string, separador?: string, limpiar?: boolean): void;
31
+ /**
32
+ * @deprecated Para las casillas de `tabla-mantenimiento` usar `prepararCasillas`, que
33
+ * compone la clave igual que la celda. Este método compone claves distintas según el tipo
34
+ * de `campoValor`, que es de donde venía el desajuste entre lo marcado y lo informado.
35
+ */
21
36
  agregarControles(lista: any[], idLista: string, limpiar?: boolean, campoValor?: string[] | string | null, campoValorSeparador?: string): void;
22
37
  setState(idx: string, state: boolean): void;
23
38
  getState(idx: string): boolean | any;
@@ -28,6 +43,12 @@ declare class DataModel {
28
43
  declare class ForCheckboxModel {
29
44
  private modeloCheck;
30
45
  constructor(modeloCheck: DataModel);
46
+ /**
47
+ * Cuenta casillas y marcadas en un solo recorrido. La cabecera consulta el estado en cada
48
+ * ciclo de detección de cambios, y antes cada consulta recorría el modelo dos veces
49
+ * creando dos arrays intermedios; con mil filas marcadas eso era trabajo y basura de sobra.
50
+ */
51
+ private contar;
31
52
  get cantidadActivos(): number;
32
53
  get existenActivados(): boolean;
33
54
  get todosActivos(): boolean;
@@ -328,7 +349,6 @@ interface MantenimientoFilaExtraData {
328
349
  }
329
350
  type TiposControlBusqueda = 'query' | 'simple' | '';
330
351
  declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit, OnChanges {
331
- private fb;
332
352
  overlay: Overlay;
333
353
  viewContainerRef: ViewContainerRef;
334
354
  protected tablaMantenimientoService: TablaMantenimientoService;
@@ -352,6 +372,7 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
352
372
  filaExtraHeader: MantenimientoFilaExtraData | any;
353
373
  filaFooter: boolean;
354
374
  botonesCRUD: string;
375
+ /** @deprecated El doble clic ya llega por `opcionSelecionada` con tipo `seleccionar`. */
355
376
  dblclickItem: EventEmitter<any>;
356
377
  objBotonesCRUD: BotonMantenimiento[];
357
378
  classSeleccionado: string[];
@@ -361,8 +382,13 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
361
382
  opcionSelecionada: EventEmitter<any>;
362
383
  opcBusqueda: EventEmitter<any>;
363
384
  accionRecargar: EventEmitter<any>;
364
- set selectionModel(val: SelectionModel<any>);
365
- selectionModelChange: EventEmitter<SelectionModel<any>>;
385
+ /**
386
+ * Registro seleccionado. El nombre viene de cuando se pensó guardarlo en un
387
+ * `SelectionModel` del CDK; lo que viaja es la fila, y así lo usan las apps con el enlace
388
+ * de dos sentidos `[(selectionModel)]`.
389
+ */
390
+ set selectionModel(val: T | null | undefined);
391
+ selectionModelChange: EventEmitter<T | null>;
366
392
  isRecargarUsed: boolean;
367
393
  filaExtraTemplate: TemplateRef<any> | undefined;
368
394
  paginator: MatPaginator;
@@ -372,6 +398,10 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
372
398
  alturaFull: _angular_core.InputSignal<boolean>;
373
399
  pageSize: number;
374
400
  pageSizeOptions: number[];
401
+ /**
402
+ * @deprecated Entrega la instancia interna del `MatTableDataSource`, que ahora se reutiliza
403
+ * entre cargas: quien la guarde estará tocando el estado de la tabla por la espalda.
404
+ */
375
405
  dataSourceChange: EventEmitter<any>;
376
406
  resultados: EventEmitter<any>;
377
407
  dataSource: MatTableDataSource<T, MatPaginator>;
@@ -386,9 +416,16 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
386
416
  pageLength: null;
387
417
  };
388
418
  ignorarDerechos: boolean;
389
- derechosActuales: any;
419
+ private derechosDelPadre;
420
+ private _derechosActuales;
421
+ get derechosActuales(): any;
422
+ /**
423
+ * Permisos con los que se habilitan los botones. Normalmente se leen solos del `data` de la
424
+ * ruta, pero si la pantalla los pasa a mano, mandan los suyos: antes cada navegación
425
+ * sobrescribía lo que el padre acababa de poner.
426
+ */
427
+ set derechosActuales(val: any);
390
428
  rows: QueryList<ElementRef<HTMLTableRowElement>>;
391
- rowFooter: ElementRef<HTMLTableRowElement>;
392
429
  mouseEvent$: Subscription | undefined;
393
430
  overlayRef: OverlayRef | undefined;
394
431
  userMenu: TemplateRef<any>;
@@ -400,7 +437,7 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
400
437
  chkLista: DataModel;
401
438
  bDireccionOrden: _angular_core.WritableSignal<number>;
402
439
  mostrarBotonOrden: _angular_core.InputSignal<boolean>;
403
- constructor(fb: FormBuilder, overlay: Overlay, viewContainerRef: ViewContainerRef, tablaMantenimientoService: TablaMantenimientoService, cdRef: ChangeDetectorRef);
440
+ constructor(overlay: Overlay, viewContainerRef: ViewContainerRef, tablaMantenimientoService: TablaMantenimientoService, cdRef: ChangeDetectorRef);
404
441
  busquedaTipo: _angular_core.InputSignalWithTransform<TiposControlBusqueda, string>;
405
442
  private _leyenda;
406
443
  get leyenda(): {
@@ -416,15 +453,59 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
416
453
  set idTabla(val: string[] | string);
417
454
  private _columnasTabla;
418
455
  get columnasTabla(): ColumnaTabla<any>[];
456
+ /**
457
+ * Columnas a pintar, mezcladas con el catálogo del servicio.
458
+ *
459
+ * Devuelve una lista nueva con copias: antes transformaba el array del consumidor en su
460
+ * sitio, así que su definición quedaba con el tipo cambiado (`estado` pasa a `icons`) y las
461
+ * columnas `custom` marcadas como no visibles. Reutilizar esa misma definición en otra
462
+ * tabla dejaba la columna `custom` oculta para siempre, porque la segunda pasada guardaba
463
+ * como visibilidad original el `false` que había dejado la primera.
464
+ */
419
465
  set columnasTabla(val: ColumnaTabla<any>[]);
420
466
  private _botonesMenu;
421
467
  get botonesMenu(): SeccionesBotonesMantenimiento;
468
+ /**
469
+ * Los botones que tocan pintar. En solo lectura quedan los marcados con `ignorarReadOnly`,
470
+ * y de los que tienen submenú quedan sus opciones permitidas.
471
+ *
472
+ * Devuelve estructuras nuevas y no toca `botonesMenu`. Antes filtraba sobre el propio
473
+ * estado, y como la plantilla lo consulta seis veces por ciclo, cada lectura se comía lo
474
+ * que quedaba: en solo lectura la tabla acababa sin ningún botón, ni siquiera los CRUD.
475
+ * La condición de los submenús estaba además al revés, así que descartaba justo los
476
+ * botones cuyas opciones sí estaban permitidas.
477
+ */
422
478
  get botonesMenuFinal(): SeccionesBotonesMantenimiento;
423
479
  set botonesMenu(val: SeccionesBotonesMantenimiento);
424
480
  get listaMenuCompleto(): BotonMantenimiento[];
481
+ /** Si la columna se ofrece en el menú de columnas. `noMostrar` es el alias antiguo. */
482
+ esColumnaEnLista(column: any): boolean;
483
+ /** Si la columna se pinta ahora mismo, sin escribir la respuesta dentro de la columna. */
484
+ esColumnaVisible(column: any): boolean;
485
+ /**
486
+ * Columnas que toca pintar. Consultarlo no escribe en las columnas del consumidor: antes
487
+ * copiaba `noMostrar` a `noMostrarEnLista` y fijaba `visible`, de modo que una columna
488
+ * declarada con una función dejaba de ser dinámica en cuanto se pintaba la tabla una vez.
489
+ *
490
+ * Sigue escribiendo `sort` cuando hay fila extra, porque es el único canal por el que la
491
+ * definición de columnas se entera de que no debe ofrecer el ordenamiento.
492
+ */
425
493
  get objVisibleColumns(): ColumnaTabla<any>[];
494
+ /**
495
+ * Columnas que recibe la definición de columnas. Con fila extra desplegable el
496
+ * ordenamiento se bloquea, y eso se resuelve aquí entregando copias: antes se lograba
497
+ * escribiendo `sort: false` dentro de la columna del consumidor, que quedaba marcada para
498
+ * siempre aunque la tabla dejara de usar la fila extra.
499
+ */
500
+ get columnasParaDefinir(): ColumnaTabla<any>[];
426
501
  get visibleColumns(): string[];
427
502
  get tieneCheckbox(): false | _jvsoft_components_tabla_mantenimiento.ColumnaCheckbox<any>;
503
+ /**
504
+ * Última búsqueda del registro seleccionado, guardada para no repetirla. Vale mientras no
505
+ * cambien ni la selección ni los datos: `classFila` consulta esto una vez por fila y por
506
+ * ciclo, así que sin memoria una tabla de N filas hacía N búsquedas sobre N registros.
507
+ */
508
+ private cacheSeleccionado;
428
509
  get buscarItemSeleccionado(): any;
429
510
  get objSeleccionado(): any;
430
511
  set objSeleccionado(val: any);
@@ -435,6 +516,27 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
435
516
  rowTooltip: (item: any) => string;
436
517
  soloIconos?: TipoValorFuncion<boolean>;
437
518
  ngOnInit(): void;
519
+ /** Filas desplegadas, por su identificador. El estado es de la tabla, no del registro. */
520
+ private filasExpandidas;
521
+ /** Se pasa a la definición de columnas, que pregunta por fila al pintar el icono. */
522
+ readonly estaExpandidaFn: (item: any) => boolean;
523
+ /**
524
+ * Si la fila está desplegada. Además del estado propio se mira `isExpanded` dentro del
525
+ * registro, porque varias pantallas lo traen puesto para abrir una fila de entrada
526
+ * (archivo digital hace `firstRow.isExpanded = true` antes de entregar los datos).
527
+ */
528
+ estaExpandida(item: any): boolean;
529
+ /**
530
+ * Despliega o pliega la fila. El estado vive aquí.
531
+ *
532
+ * @deprecated El espejo `isExpanded` dentro del registro se mantiene solo por
533
+ * compatibilidad y se retirará: las pantallas que lo leen (`*ngIf="row.isExpanded"`) o lo
534
+ * escriben para abrir una fila de entrada deben pasar a `estaExpandida()` y
535
+ * `alternarExpansion()`.
536
+ */
537
+ alternarExpansion(item: any): void;
538
+ /** Toma del `data` de la ruta lo que la pantalla no haya pasado por entrada. */
539
+ aplicarDerechosDeRuta(data: any): void;
438
540
  ngAfterContentInit(): void;
439
541
  ngOnChanges(changes: SimpleChanges): void;
440
542
  trackByFn: (index: number, item: any) => string;
@@ -442,9 +544,19 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
442
544
  agregarBotonesExportacion(): void;
443
545
  actualizarCrud(): void;
444
546
  classFila(item: any): any[];
547
+ /**
548
+ * Memoria del tooltip por registro. La plantilla lo pide tres veces por fila (texto,
549
+ * `matTooltipDisabled` y la clase `regTooltip`), y cada llamada ejecuta el `rowTooltip` del
550
+ * consumidor. Se recalcula cuando cambian los datos.
551
+ */
552
+ private cacheTooltip;
445
553
  procesarRowTooltip(item: any): string;
554
+ private calcularRowTooltip;
446
555
  subItemsActivos(btn: any, item: any): boolean;
447
- get noData(): any;
556
+ /** Se arma una sola vez: la plantilla lo consume con `async`, y devolver un observable nuevo
557
+ * en cada ciclo hacía que la tubería se desuscribiera y volviera a suscribirse sin parar. */
558
+ private noData$;
559
+ get noData(): Observable<boolean>;
448
560
  onFilterChange(value: string): void;
449
561
  toggleColumnVisibility(column: any, event: any): void;
450
562
  cargarData(retorno?: boolean): any;
@@ -453,6 +565,36 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
453
565
  botonDisabled(btn: BotonMantenimiento, item: any): boolean | undefined;
454
566
  propiedadSeleccion(item: any): string;
455
567
  esSeleccionActual(item: any): boolean;
568
+ /**
569
+ * `Supr` sobre la fila pide eliminar. Se ignora cuando la tecla viene de un campo de la
570
+ * celda: ahí el usuario está borrando texto, no el registro.
571
+ */
572
+ teclaEliminarEnFila(item: any, evento: Event): void;
573
+ /**
574
+ * Espacio sobre la fila enfocada. Con columna de casillas marca o desmarca la suya, que es
575
+ * lo que se espera de esa tecla en una lista con selección múltiple; sin casillas se
576
+ * comporta como Enter y abre el registro.
577
+ */
578
+ teclaEspacioEnFila(item: any): void;
579
+ /**
580
+ * El teclado movió el foco a otra fila: se selecciona, pero sin avisar `ver`. Recorrer la
581
+ * tabla con las flechas dispararía un aviso por fila, y los padres suelen cargar datos con él.
582
+ */
583
+ seleccionarFilaPorId(id: string): void;
584
+ /**
585
+ * Clic sobre una fila. `evento.detail` es el contador de clics del navegador: en un clic
586
+ * suelto vale 1 y la selección alterna, así que volver a pulsar la fila la deselecciona.
587
+ * El segundo clic de un doble clic llega con 2: ahí la selección se fuerza —alternar dejaba
588
+ * la fila apagada justo al abrir el registro— y no se vuelve a avisar `ver`, porque los
589
+ * consumidores que alternan su propia selección con ese evento acababan en desacuerdo con
590
+ * la tabla.
591
+ */
592
+ /**
593
+ * Doble clic sobre la fila. En solo lectura no dispara la acción: `permitirSeleccion` deja
594
+ * elegir la fila, pero ni ese modo ni el solo lectura completo ejecutan nada.
595
+ */
596
+ dobleClicFila(item: any): void;
597
+ clicFila(item: any, tableDataIndex: number, evento: MouseEvent): void;
456
598
  seleccionarItem(item?: any, forzado?: boolean): void;
457
599
  opcMenu(item: any, objMenu: OpcionSeleccionada, modal?: null, retorno?: boolean): 1 | OpcionSeleccionada;
458
600
  emitirResultados(evento?: {}): void;