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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/.storybook/tema-demo.css +194 -0
  2. package/dialog-flotante/README.md +21 -1
  3. package/fesm2022/jvsoft-components-dialog-flotante.mjs +18 -12
  4. package/fesm2022/jvsoft-components-dialog-flotante.mjs.map +1 -1
  5. package/fesm2022/jvsoft-components-filtro-busqueda.mjs +11 -2
  6. package/fesm2022/jvsoft-components-filtro-busqueda.mjs.map +1 -1
  7. package/fesm2022/jvsoft-components-lista-arbol.mjs +58 -17
  8. package/fesm2022/jvsoft-components-lista-arbol.mjs.map +1 -1
  9. package/fesm2022/jvsoft-components-lista-detalle.mjs +70 -0
  10. package/fesm2022/jvsoft-components-lista-detalle.mjs.map +1 -0
  11. package/fesm2022/jvsoft-components-luces-navidad.mjs +2 -2
  12. package/fesm2022/jvsoft-components-luces-navidad.mjs.map +1 -1
  13. package/fesm2022/jvsoft-components-menu.mjs +4 -1
  14. package/fesm2022/jvsoft-components-menu.mjs.map +1 -1
  15. package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs +2 -5
  16. package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs.map +1 -1
  17. package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs +2605 -394
  18. package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs.map +1 -1
  19. package/fesm2022/jvsoft-components.mjs +1 -0
  20. package/fesm2022/jvsoft-components.mjs.map +1 -1
  21. package/lista-arbol/README.md +17 -1
  22. package/lista-detalle/README.md +85 -0
  23. package/package.json +6 -2
  24. package/src/styles/base-jvsoft-components.css +714 -15
  25. package/tabla-mantenimiento/README.md +628 -0
  26. package/tabla-mantenimiento/tabla-mantenimiento.component.scss +31 -0
  27. package/types/jvsoft-components-dialog-flotante.d.ts +2 -0
  28. package/types/jvsoft-components-filtro-busqueda.d.ts +6 -0
  29. package/types/jvsoft-components-lista-arbol.d.ts +19 -2
  30. package/types/jvsoft-components-lista-detalle.d.ts +44 -0
  31. package/types/jvsoft-components-menu.d.ts +1 -0
  32. package/types/jvsoft-components-tabla-mantenimiento-components-progress-bar.d.ts +1 -2
  33. package/types/jvsoft-components-tabla-mantenimiento.d.ts +1070 -21
  34. package/types/jvsoft-components.d.ts +1 -0
@@ -0,0 +1,628 @@
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()`, piezas declarativas (`celda`, ver abajo) o HTML (`innerHTML`) |
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` | En desuso: no se pinta (la celda sale vacía). Usa `text` con `celda` e `imagen()` |
72
+ | `expandir` | Botón que despliega la fila extra |
73
+ | `numeracion_automatica` | Numeración continua, respetando la página |
74
+ | `arbol` | Sangría y plegar/desplegar del modo árbol + el texto o `celda` (ver **Árbol**) |
75
+ | `custom` | Lo pinta el consumidor con su propia plantilla |
76
+ | `estiloEstablecido` | Celda con estilo calculado |
77
+
78
+ Propiedades útiles en cualquier columna: `labelLista` (nombre alterno al exportar), `labelTooltip`
79
+ (tooltip de la cabecera, p. ej. qué significa una columna de marcas), `visible` y
80
+ `esVisible()` (que pueden ser funciones), `noMostrarEnLista` para ocultarla del menú de columnas,
81
+ `sort: false`, `cssClasses`, `transformar(row)` y `transformarFooter()`. (Las columnas fijas
82
+ `sticky`/`stickyEnd` no existen todavía: están comentadas en la interfaz.)
83
+
84
+ ### Celdas declarativas (`celda`)
85
+
86
+ Para una celda con más que texto (nota gris, badge de estado, marcas o íconos con tooltip, avatar)
87
+ no hace falta una `custom` con su `matColumnDef`: en una columna `text` (o `arbol`) se declara
88
+ `celda: (row) => piezas` y la tabla las pinta con sus tamaños y tonos (`<jvs-tabla-celda>`), igual en
89
+ todas las pantallas. Los ayudantes se importan de `@jvsoft/components/tabla-mantenimiento`:
90
+
91
+ | Ayudante | Qué pinta |
92
+ |---|---|
93
+ | `'texto'` o `texto(t, {negrita, tono})` | Texto principal |
94
+ | `nota(t, {bloque})` | Texto gris; después de otra pieza va con "·" ("ACTA · AC"). Sin texto devuelve `false` |
95
+ | `badge(t, {tono, tooltip, icono})` | Badge de 12 px ("Inactivo", "Oculto"); neutro si no se dice el tono. Con `icono`, uno de 10 px delante del texto |
96
+ | `marca(t, tooltip, {tono})` / `marcaIcono(icono, tooltip, {tono})` | Marca de 12 × 12 px con su significado en el tooltip; primaria si no se dice el tono |
97
+ | `icono(nombre, {tono, tooltip, ariaLabel, tamano, click})` | Ícono de 12 px (`tamano: 'grande'`, 14 px); con `click` es un botón que no selecciona la fila |
98
+ | `imagen(src, alt, {redonda})` | Avatar de 20 px |
99
+ | `salto` | Lo que sigue va en la línea de abajo |
100
+
101
+ **Tonos.** Todas las piezas con tono (`texto`, `badge`, `icono`, `marca`, `marcaIcono`) lo reciben igual,
102
+ en las opciones, y tienen además un atajo por tono: `badge.error('Inactivo', {tooltip})` es
103
+ `badge('Inactivo', {tono: 'error', tooltip})`. Al escribir `badge.` el editor lista los tonos con su
104
+ significado. El atajo es para el tono fijo; cuando el tono sale de un dato, la forma con `{tono}`.
105
+
106
+ | Tono | Para qué | Ejemplo |
107
+ |---|---|---|
108
+ | `neutro` | Clasificación sin juicio | `badge('Otros módulos')`, `badge.neutro('Múlt.')` |
109
+ | `exito` | Estado correcto o completo | `texto.exito('Activo')` |
110
+ | `aviso` | Requiere atención, no bloquea | `icono.aviso('roundWarning', {tooltip: 'Sigla repetida'})`, `texto.aviso('Sin firmante')` |
111
+ | `error` | Estado negativo o bloqueante | `badge.error('Inactivo')`, `badge.error('Sin padre')` |
112
+ | `info` | Dato informativo destacado | `badge.info('Planilla')` |
113
+ | `primario` | Marca de la entidad o categoría principal | `marca('E', 'Entrada')`, `icono.primario('roundFolder')` |
114
+
115
+ La lista está exportada (`TONOS`, con el uso de cada uno) y la historia `CeldasDeclarativas` de Storybook
116
+ la muestra en claro y en oscuro. Los colores son del Tailwind de la casa (`gray`, `green`, `amber`, `red`,
117
+ `cyan` y `primary`): fondo `-light` y texto en el tono oscuro de la misma familia (`text-red-700`…), porque
118
+ el `DEFAULT` sobre su `-light` no llega al contraste mínimo en texto pequeño; con el tema oscuro de Vex
119
+ (`.vex-style-dark`) el texto pasa al tono claro. `primario` depende del color de la entidad: el texto es
120
+ ese color oscurecido (aclarado en el tema oscuro), para que se lea aunque la entidad tenga un primario
121
+ claro. Un ícono con tono va del mismo color que el texto del tono.
122
+
123
+ Para pintar algo con el mismo tono fuera de la tabla (la ficha de un panel, una leyenda), importa las
124
+ clases en vez de copiarlas: `claseTono('exito')` (fondo y texto) o `CLASES_TONO.exito.texto`. Son clases
125
+ completas, así que el Tailwind de cada app las encuentra en `node_modules/@jvsoft/**` sin configurar nada.
126
+
127
+ Para una ficha o un contador fuera de la tabla con la forma de un badge, `claseBadge(tono, 'ficha')`
128
+ (18 px, el de los paneles) o `claseBadge(tono)` (12 px, el de la fila) da forma y tono juntos:
129
+ `fichaExito: claseBadge('exito', 'ficha')`. No hace falta copiar `inline-flex h-[18px]…` en la pantalla.
130
+
131
+ **`clase`**: todas las piezas aceptan `clase` con clases Tailwind adicionales, que van al final
132
+ (`badge.neutro(r.cSigla, {clase: 'uppercase tracking-wide'})`). Es un escape para lo que no es color:
133
+ un color en `clase` **no gana** al del tono, porque en CSS manda el orden de la hoja (Tailwind la ordena
134
+ a su modo) y no el del atributo; `bg-blue-100` pierde contra el `bg-gray-light` del neutro.
135
+
136
+ **Colores propios: `tono: false`.** La pieza conserva su forma y medidas pero la librería no pone ningún
137
+ color (ni fondo ni texto); la pantalla los pone en `clase`. Vale en `badge`, `marca`, `marcaIcono`,
138
+ `icono` y `texto`:
139
+
140
+ ```ts
141
+ badge('Externo', {tono: false, clase: 'bg-purple-light text-purple-800 [.vex-style-dark_&]:text-purple-300'})
142
+ marca('C', 'Caja', {tono: false, clase: 'bg-excel-light text-excel-900'})
143
+ icono('roundToggleOn', {tamano: 'grande', tono: false, clase: 'text-green-600', tooltip: 'Habilitado'})
144
+ ```
145
+
146
+ Con `tono: false` el contraste y el tema oscuro quedan a cargo de la pantalla. La regla que cumplen los
147
+ tonos: fondo `X-light` del Tailwind de la casa (`gray`, `red`, `orange`, `deep-orange`, `amber`, `green`,
148
+ `teal`, `cyan`, `purple`, `deep-purple`, `pink`, `pdf`, `excel`) y texto en el 700/800 de la misma familia,
149
+ con `[.vex-style-dark_&]:text-X-300` para el oscuro. Las clases van completas en el `.ts` de la pantalla
150
+ (sin concatenar), para que el Tailwind del MF las encuentre. Si varias pantallas repiten el mismo color
151
+ propio, conviene pedirlo como tono a la librería.
152
+
153
+ **Íconos.** El nombre lo da la pieza (`icono('roundStar')`, `marcaIcono(…)`, `badge(t, {icono})`); el
154
+ color, el tono (o `tono: false` + `clase`); el tamaño es fijo: 12 px en `icono`, 10 px dentro de badge y
155
+ marca, y 14 px con `icono(n, {tamano: 'grande'})`: lo más grande que cabe en la fila densa (15 px) sin
156
+ hacerla más alta; uno de 16 px, como los de las columnas `estado`, la haría crecer.
157
+ En el badge el ícono va siempre delante del texto y es decorativo: lo que dice el badge está en su texto.
158
+ Un badge con ícono y sin texto no existe: para eso está `marcaIcono`.
159
+
160
+ Los `false`, `null` y `undefined` se ignoran, así que las condiciones van en línea; ojo con los números:
161
+ `row.iActivo && badge(…)` pinta "0" cuando vale 0 (usa `!!row.iActivo && …`).
162
+
163
+ ```ts
164
+ {label: 'Nombre', property: 'cTipoDocNombre', type: 'text',
165
+ celda: r => [r.cTipoDocNombre, nota(r.cTipoDocSigla), !esActivo(r) && badge.error('Inactivo')]},
166
+ {label: 'Estado', property: 'iCredEstado', type: 'text',
167
+ celda: r => r.iCredEstado == 1 ? texto.exito('Activo') : badge.error('Inactivo')},
168
+ {label: 'Despacho', property: 'colDespacho', type: 'arbol', lineas: 2, ordenarPor: r => r.cNombre,
169
+ celda: r => [icono.primario('roundFolder', {tooltip: r.cTipo}), r.cNombre, nota(r.cSigla)]},
170
+ // Tono desde un dato: la forma con {tono}.
171
+ const TONO_ESTADO: Record<number, TonoCelda> = {1: 'exito', 2: 'aviso', 3: 'error'};
172
+ {label: 'Estado', property: 'iEstadoId', type: 'text',
173
+ celda: r => badge(r.cEstadoNombre, {tono: TONO_ESTADO[r.iEstadoId] ?? 'neutro'})},
174
+ ```
175
+
176
+ - **Tooltips**: de Material, con un retardo de 400 ms (`RETARDO_TOOLTIP_CELDA`, también en el recorte de
177
+ `lineas`) para que no se abran y cierren al pasar el cursor por la fila; su texto (o `ariaLabel`) se
178
+ repite oculto para los lectores de pantalla. No se enfocan con el teclado: lo que diga un tooltip
179
+ debe poder deducirse también de otra columna o del Excel.
180
+ - **`lineas: n`**: recorta a n líneas y pone el texto completo de la celda en el tooltip.
181
+ - **Excel**: sin `excel.valor`, la columna exporta el texto de sus piezas (`textoCelda`): textos,
182
+ notas, badges y marcas con texto; íconos e imágenes no. Una pieza con `soloPantalla: true` no
183
+ sale. `excel.valor` sigue mandando.
184
+ - **Orden**: por `property` u `ordenarPor`, como cualquier `text` (ordenan por defecto; `sort: false`
185
+ para no ofrecerlo). **Búsqueda simple**: busca en el registro, no en las piezas.
186
+ - **Columnas que no caben**: la medición cuenta el relleno de badges y marcas, sus íconos y las imágenes.
187
+ - `celda` se evalúa en cada ciclo, como `transformar`. En tablas muy grandes, si se nota, memoriza
188
+ por fila en la pantalla (`WeakMap<row, Celda>`).
189
+ - Si una columna trae `celda` e `innerHTML`, se pinta `celda` (con aviso en consola en desarrollo).
190
+ - Dentro de una `custom` (controles, botones) también sirve `<jvs-tabla-celda [piezas]="…" [fila]="row">`.
191
+
192
+ **Badge o texto**
193
+
194
+ 1. **Un badge vale por ser pocos.** Si más de la mitad de las filas lo llevarían, no destaca nada y la
195
+ columna se llena de cajas. Para el valor normal, texto (con tono si aporta: `texto.exito('Activo')`) o
196
+ nota gris (`nota('No')`); badge solo para la excepción o lo que pide acción (`badge.error('Inactivo')`,
197
+ `badge.aviso('Vence hoy')`).
198
+ 2. **Estados de varios valores con peso parecido** (Pendiente / En proceso / Atendido / Derivado): todos
199
+ badge, cada uno con su tono. La forma igual ayuda a recorrer la columna; el color dice cuál es cuál.
200
+ 3. **Binario con un valor normal** (activo/inactivo, vigente/vencido, firmado/sin firmar): el normal como
201
+ texto, la excepción como badge. Si el normal no necesita decirse, también vale la celda vacía o la nota.
202
+ Ejemplo: Despachos, Estado (313 activos de 318), `texto.exito('Activo')` / `badge.error('Inactivo')`.
203
+ 4. **Banderas sí/no**: `yes_no` o `marca`, no badges.
204
+ 5. **Una pieza fuerte por celda.** Si el nombre ya lleva un badge ("Inactivo"), lo demás va en nota o marca.
205
+ 6. **El badge no reemplaza al texto**: su texto sale en el Excel y lo lee el lector de pantalla; el color
206
+ solo refuerza.
207
+
208
+ Es el criterio de GOV.UK Design System (*Task list*: lo completado como texto, solo lo pendiente con
209
+ *tag*), Shopify Polaris (*Badge*: usar con moderación) y Atlassian (*Lozenge*). Aquí "badge" es la pieza
210
+ de la celda; el número sobre un botón es su **contador** (ver **Botones**). El badge de estado de los MF
211
+ (`span-dialog-flotante-X-light`, plugin de cada `tailwind.config.js`) es otra cosa y no se toca: en
212
+ pantallas nuevas, `badge()` en la tabla y `claseBadge()` fuera.
213
+
214
+ **Cuál usar**
215
+
216
+ - Solo texto o una concatenación: `text` con `property` o `transformar`. Nunca `innerHTML` para esto.
217
+ - Texto con nota, badges, marcas, íconos con tooltip o avatar: `text` (o `arbol`) con `celda`.
218
+ - Íconos de acción (descargar, abrir): `icons` con `iconsDef`. Sí/No con ícono: `yes_no`.
219
+ - HTML que ya llega armado (notificaciones, reporteadores): `innerHTML`. **Se pinta tal cual, sin
220
+ sanear**: escapa lo que venga de la base con `html` o `escaparHtml` de `@jvsoft/utils`
221
+ (`` innerHTML: r => html`<b>${r.cNombre}</b><br><small>${r.cCargo}</small>` ``; `sinEscapar(x)` para
222
+ un trozo de HTML de confianza).
223
+ - Controles, botones, popovers, pipes propios: `custom` con `excel.valor` y `ordenarPor`.
224
+
225
+ **Columnas que no caben.** Por defecto (`columnasSiNoCaben="ajustar"`) se pintan todas y, si falta
226
+ espacio, el texto se parte en líneas, como siempre. Con `columnasSiNoCaben="ocultar"` la tabla mide el
227
+ ancho que necesita cada columna (título y contenido de las primeras filas de la página, con mínimos y
228
+ topes por tipo que pone la librería) y oculta las de menor prioridad hasta que el resto quepa en su
229
+ contenedor. Lo decide el ancho de la tabla, no el de la ventana, y no se configura ningún px.
230
+
231
+ - La prioridad sale del orden: la primera columna de datos es la principal y nunca se oculta; las
232
+ utilitarias (casilla, expandir, numeración, íconos, sí/no) tampoco; el resto se oculta de derecha a
233
+ izquierda. El corte es acumulativo: en cuanto una no cabe, las de menor prioridad tampoco se pintan.
234
+ - `prioridad: n` cambia ese orden: 1 es la más importante y nunca se oculta, y una columna con
235
+ `prioridad` va antes que todas las que no la tienen.
236
+ - El botón de columnas muestra `+N` y su tooltip las nombra; en el menú salen desmarcadas con
237
+ "(sin espacio)". Si el usuario la marca, se muestra (y se acomodan las demás).
238
+ - Siguen saliendo en el Excel. Una `custom` oculta no está en el HTML de la tabla, así que conviene
239
+ darle `excel.valor`.
240
+ - `visible` (también como función) se evalúa antes: una columna apagada no ocupa espacio.
241
+ - Si se ordena por una columna que luego se oculta, los datos siguen ordenados aunque no se vea la
242
+ flecha.
243
+ - `columnasOcultasPorEspacio()` (señal de solo lectura) dice cuáles están ocultas ahora, por si la
244
+ pantalla quiere avisar.
245
+
246
+ ```ts
247
+ // Sin configurar nada: se oculta Estado, luego Teléfono, luego Correo; Nombre nunca.
248
+ // Con `prioridad: 2` en Estado, se conserva antes que Correo y Teléfono.
249
+ columnas: ColumnaTabla<Persona>[] = [
250
+ {label: 'Nombre', property: 'cNombre', type: 'text'},
251
+ {label: 'Correo', property: 'cCorreo', type: 'text'},
252
+ {label: 'Teléfono', property: 'cTelefono', type: 'text'},
253
+ {label: 'Estado', property: 'cEstado', type: 'estado', prioridad: 2},
254
+ ];
255
+ ```
256
+
257
+ ```html
258
+ <jvs-tabla-mantenimiento columnasSiNoCaben="ocultar" [columnasTabla]="columnas" …>
259
+ ```
260
+
261
+ **Cabeceras.** Van centradas, como siempre. Si se quiere que sigan la alineación de su celda
262
+ (`text-center`/`text-right` en `cssClasses`, o la del tipo: iconos, casillas y sí/no centrados;
263
+ texto, números y fechas a la izquierda), se activa en la tabla con
264
+ `[alinearCabecerasConContenido]="true"` —y entonces una columna `custom` respeta `text-left` /
265
+ `text-right` en su `th`— o por columna con `alineacionCabecera: 'izquierda' | 'centro' | 'derecha'`.
266
+
267
+ **Columnas `custom` con orden.** Un `mat-sort-header` en el `th` de una columna `custom` usa el
268
+ `MatSort` de la tabla (la tabla lo provee a su contenido). El valor con el que se ordena lo da
269
+ `ordenarPor: (row) => …` en la columna; sin él se usa `row[property]`. En modo árbol se ordena
270
+ entre hermanos. El consumidor importa `MatSortModule`.
271
+
272
+ **Columnas agregadas después.** Una `custom` que se agrega a `columnasTabla` con la tabla ya
273
+ iniciada se muestra en cuanto existe su `matColumnDef` (antes quedaba oculta para siempre).
274
+
275
+ **Sí/no.** Los íconos de `yes_no` miden 12 px para no hacer la fila más alta que las de texto
276
+ (`compacto: false` vuelve a los de 20 px).
277
+
278
+ **Excel por columna.** `excel: { valor(row, i), titulo, ancho, ocultar, incluirOculta }`.
279
+ `valor` es lo que conviene dar en las columnas `custom`, que si no exportan el texto de su
280
+ celda; `incluirOculta` sirve para columnas que solo existen en el Excel (con `visible: false` y
281
+ `noMostrarEnLista: true`).
282
+
283
+ Con `filtroCampos` (activo por defecto) el usuario elige qué columnas ve, y la elección se
284
+ recuerda por columna.
285
+
286
+ ## Botones
287
+
288
+ `TablaMantenimientoService` trae un catálogo ya estilado: `nuevo`, `editar`, `eliminar`,
289
+ `eliminar_fila`, `imprimir`, `descargar`, `ver_archivos`, `exportar_pdf`, `exportar_excel`,
290
+ `exportacion_avanzada`, `guardar`, `cancelar`, `seleccionar`, `detalle`, `ver_mapa`, `activar`,
291
+ `desactivar`, `cerrar` y `abrir`. Basta nombrar el `tipo` y se hereda icono y color.
292
+
293
+ ```typescript
294
+ botonesMenu: SeccionesBotonesMantenimiento = {
295
+ principal: [
296
+ { tipo: 'nuevo' },
297
+ { tipo: 'reportes', icono: 'roundPrint', subItems: [
298
+ { tipo: 'imprimir', label: 'Listado' },
299
+ { tipo: 'exportar_pdf' },
300
+ ]},
301
+ ],
302
+ };
303
+ ```
304
+
305
+ Secciones disponibles: `crud`, `principal`, `izquierda`, `derecha`, `secundario`, `inferior`, y
306
+ cualquier clave propia. `botonesCRUD` es una máscara de texto: `'CUD'` muestra crear, actualizar
307
+ y eliminar; `'-'` no muestra ninguno.
308
+
309
+ **Permisos.** Cada botón se deshabilita solo según `derechosActuales[cDerechoCodigo ?? tipo]`,
310
+ que la tabla lee del `data.derechos` de la ruta en cada navegación. `ignorarDerechos` lo salta y
311
+ `ignorarDerecho` por botón, también.
312
+
313
+ **Motivo del deshabilitado.** Un botón deshabilitado muestra al pasar el cursor el
314
+ `tooltipDeshabilitado` del botón (texto o `(item, tablaRef) => string`); sin él, la tabla dice
315
+ "Selecciona un registro" o "No tienes permiso para esta acción" cuando esa es la causa, y si no
316
+ queda el `tooltip` normal. Vale para la barra y para el menú contextual.
317
+
318
+ **Botón elegido.** `activo` (booleano o `(item, tablaRef) => boolean`) marca el elegido de un
319
+ grupo, típicamente los filtros de la fila `secundario`: va relleno con el acento de la tabla, y
320
+ los que declaran `activo` sin estarlo van en tono claro del mismo acento con borde (ver
321
+ **Colores**). Ese aspecto manda sobre la `class` del botón y lleva `aria-pressed`. Sin `activo`,
322
+ nada cambia.
323
+
324
+ **Colores.** Por defecto la tabla usa colores estándar fijos, iguales en todas las pantallas: la
325
+ fila elegida (`--tabla-mantenimiento-seleccion-fondo/texto`) y el acento de los botones `activo`,
326
+ segmentados y su badge (`--tabla-mantenimiento-acento`, tripleta "r, g, b", el mismo azul). Para
327
+ usar el color del tema de la entidad (`--color-primary` y `--color-primary-contrast`):
328
+
329
+ ```typescript
330
+ // app.config.ts: todas las tablas de la app
331
+ provideTablaMantenimiento({coloresTema: true})
332
+ ```
333
+
334
+ o por tabla `[coloresTema]="true"`, que manda sobre el global (también `false` para forzar el
335
+ estándar). Con la opción, el host lleva la clase `jvs-colores-tema`, que solo reasigna esas
336
+ variables.
337
+
338
+ **Configuración global.** `provideTablaMantenimiento` también fija, para toda la app, dos
339
+ comportamientos que vienen activos por defecto: `exportacionArriba` (las exportaciones suben junto a
340
+ Recargar) y `seguirSeleccion` (la tabla lleva a la vista la fila elegida desde fuera). Un MF que
341
+ prefiera el comportamiento anterior en todas sus tablas:
342
+
343
+ ```typescript
344
+ provideTablaMantenimiento({exportacionArriba: false, seguirSeleccion: false})
345
+ ```
346
+
347
+ El input de cada tabla manda sobre el global (`[seguirSeleccion]="true"` lo activa en una tabla
348
+ aunque el global lo apague).
349
+
350
+ **Contador.** `badge` en un botón es su contador (el número sobre el botón; dentro, como texto, en
351
+ el control segmentado). Material lo oculta a los lectores de pantalla, así que la tabla le pone una
352
+ descripción: "3 registros" ("1 registro"), o lo que diga `badgeDescripcion` ("3 pendientes" con
353
+ `badgeDescripcion: 'pendientes'`). No se ve.
354
+
355
+ **Control segmentado.** `grupo` en un botón: los consecutivos de una misma sección con el
356
+ mismo `grupo` se dibujan juntos, como un `mat-button-toggle-group` (borde común, divisores
357
+ finos, el `activo` relleno y los demás en tono claro, el `badge` como texto dentro del botón).
358
+ Tooltip, `tooltipDeshabilitado`, `estaDeshabilitado`, derechos, `esIndependiente`, `esVisible` y
359
+ el evento funcionan igual que en un botón suelto; del grupo quedan los visibles. En los menús ≡ y
360
+ contextual se listan como ítems normales. Sin `grupo`, nada cambia.
361
+
362
+ **Filtros dinámicos.** `generarBotonesDinamicos(data, config)` arma un botón por registro:
363
+ `tipo`, `labelField`, `tooltipField`, `badgeField`, `extraDataField`, `class` (opcional), el
364
+ elegido con `campoValor` + `valorActivo` (valor o función; van juntos, y con uno solo la función
365
+ avisa por consola y no marca ninguno), y
366
+ `includeAll: {label, posicion: 'inicio' | 'fin', badge (valor o true = suma), valor}` y
367
+ `estilo: 'chips' | 'segmentado'` (por defecto `'chips'`, separados con `ml-1`; `'segmentado'`
368
+ pone a todos, "Todos" incluido, en un mismo `grupo`) y `ocultarCero` (sin contador cuando vale 0,
369
+ también en "Todos"; por defecto el "0" se ve). No pone colores: el aspecto lo da la tabla.
370
+
371
+ Para un elegido que no sea "un campo igual a un valor" (varios campos, varios elegidos…), aplica
372
+ `.map()` a lo que devuelve y pon `activo` a cada botón:
373
+
374
+ ```ts
375
+ const botones = generarBotonesDinamicos(estados, {tipo: 'estado', labelField: 'cNombre'})
376
+ .map(btn => ({...btn, activo: () => this.elegidos().includes(btn.datosExtra.item?.iEstadoId)}));
377
+ ```
378
+
379
+ **Herramientas.** La sección `herramientas` se dibuja junto a Recargar con botones de solo ícono
380
+ y tooltip; con más de tres se agrupan en un menú "Exportar ▾". Las exportaciones conocidas
381
+ (`exportar_pdf`, `ver_pdf`, `exportar_excel`, `descargar_excel`, `ver_resumen_pdf`,
382
+ `ver_resumen_excel`, `exportar_jasper`, `exportacion_avanzada`) se mudan ahí aunque vengan en
383
+ `inferior`, igual que el Excel automático; `[exportacionArriba]="false"` las deja donde estaban (en toda la app: `provideTablaMantenimiento({exportacionArriba: false})`, ver **Configuración global**).
384
+ PDF y Excel usan íconos propios de la tabla (Material Round `picture-as-pdf` y MDI `file-excel-outline`), en
385
+ línea, sin depender del CDN, y sin color propio: se ven como Recargar y Columnas.
386
+
387
+ **Menú de columnas.** Una casilla por línea. Lo que el usuario marca o desmarca se guarda aparte
388
+ de la definición, así una columna con `visible` como función sigue su condición hasta que el
389
+ usuario la toque.
390
+
391
+ **Tablas angostas.** Cuando la banda de la tabla es angosta (menos de 36 rem, 576 px; lo mide la
392
+ tabla, no la ventana, así un panel angosto en una pantalla ancha también cuenta), los grupos de la
393
+ barra pasan al menú ≡, pero la fila `secundario` y lo proyectado en `objetosMenuPegado` siguen a la
394
+ vista (con salto de línea). Los botones de `secundario` no se repiten dentro del menú ≡. El pie
395
+ (botones inferiores y paginador) se apila con el mismo criterio. El host lleva la clase
396
+ `jvs-banda-angosta` (o `jvs-banda-media`, hasta 48 rem) por si la pantalla necesita acomodar algo.
397
+
398
+ **Solo lectura.** Con `readOnly` solo quedan los botones marcados con `ignorarReadOnly`, y no se
399
+ puede eliminar con `Supr` ni disparar la acción del doble clic. `readOnly="permitirSeleccion"`
400
+ deja elegir la fila sin ejecutar nada.
401
+
402
+ ## Tooltips
403
+
404
+ Todos son de Material (`matTooltip`). Qué muestra cada parte de la tabla y cómo se configura:
405
+
406
+ | Dónde | Cómo |
407
+ |---|---|
408
+ | Botones de la barra y del menú ≡ | `tooltip` del botón; sin él, su etiqueta. Inmediatos (sin retardo) |
409
+ | Botón deshabilitado | `tooltipDeshabilitado` (texto o función); sin él, "Selecciona un registro" o "No tienes permiso para esta acción" (ver **Motivo del deshabilitado**) |
410
+ | Menú contextual | Solo el motivo del deshabilitado |
411
+ | Herramientas (solo ícono) | El nombre de la herramienta, también como `aria-label` |
412
+ | Fila | `rowTooltip(item)` y, si está anulada, el mensaje de anulado, unidos con " \| ". Va en rojo con "⚠️": úsalo para avisos de la fila |
413
+ | Cabecera | `labelTooltip` de la columna |
414
+ | Columna `icons` | `tooltip` o `tooltipField` (campo del registro) por ícono. `toolTip` / `toolTipField` siguen funcionando, en retirada |
415
+ | Columna `yes_no` | `yesTooltip` / `noTooltip` |
416
+ | `popover` de una columna | `{content \| template, trigger: 'hover' \| 'click' \| 'focus', position, customClass}` |
417
+ | Piezas de `celda` | `tooltip` (y `ariaLabel`) en badge, marca e ícono; `lineas` pone el texto completo. Retardo de 400 ms (`RETARDO_TOOLTIP_CELDA`) |
418
+
419
+ - La columna `estado` se pinta como un ícono verde o gris de 16 px **sin tooltip ni texto**. Para que se
420
+ entienda (y lo lea un lector de pantalla), en pantallas nuevas usa `celda` (`texto.exito('Activo')` /
421
+ `badge.error('Inactivo')`, criterio de **Badge o texto**) o `yes_no` con `yesTooltip`/`noTooltip`.
422
+ - Si la fila tiene `rowTooltip` y una pieza de la celda también tiene tooltip, se pueden ver los dos a la vez.
423
+ - La tabla no configura `MAT_TOOLTIP_DEFAULT_OPTIONS`: los retardos del resto de la app son los de cada MF.
424
+
425
+ ## Selección
426
+
427
+ **De una fila**: clic para elegir, clic otra vez sobre la misma para soltarla, flechas para
428
+ moverse, Enter para abrir. La selección sobrevive a las recargas: la tabla vuelve a
429
+ encontrar el registro por `idTabla` y entrega el objeto nuevo, no el anterior.
430
+
431
+ La forma recomendada de leerla es el enlace de dos sentidos:
432
+
433
+ ```html
434
+ [(selectionModel)]="seleccionados.personas"
435
+ ```
436
+
437
+ **Ir a la fila seleccionada (`seguirSeleccion`, activo por defecto).** Cuando la selección cambia
438
+ desde fuera —la pantalla fija `[selectionModel]` con el registro recién guardado, o llama a
439
+ `seleccionarPorId()`— la tabla lleva esa fila a la vista: con paginación en cliente va a la página
440
+ que la contiene (respetando el orden y el filtro activos), limpia el buscador simple si la ocultaba,
441
+ la desplaza a la vista si hace falta y la resalta un instante (`animate-pulse`). No se mueve por un
442
+ clic ni por el teclado (la fila ya se ve), ni en una recarga que mantiene la misma fila: así una
443
+ tabla que se refresca sola no salta de página mientras se lee. Con paginación en el servidor no hay
444
+ página que calcular: solo desplaza si la fila vino en la página cargada; traer la página correcta
445
+ sigue siendo de la pantalla. `[seguirSeleccion]="false"` lo apaga en una tabla; `provideTablaMantenimiento({seguirSeleccion: false})`, en toda la app (ver **Configuración global**).
446
+
447
+ Después de guardar, lo que queda en la pantalla es saber qué registro elegir (el id que devuelve el
448
+ procedimiento) y sus filtros propios:
449
+
450
+ ```ts
451
+ // Registro nuevo: el id cambia y la tabla lo sigue sola.
452
+ this.seleccionado.set(lista.find(r => r.iTipoDocId === idGuardado) ?? null);
453
+ // o, sin buscar el registro (si la recarga aún no llegó, se aplica y avisa cuando llegue):
454
+ this.tabla().seleccionarPorId(idGuardado);
455
+ // Registro editado: la selección no cambia, y si el campo editado lo movió de página hay que pedirlo.
456
+ this.tabla().irASeleccion();
457
+ ```
458
+
459
+ Si la fila fijada no está en los datos (la recarga viene en camino), la selección queda fijada y
460
+ se aplica —avisando por `selectionModelChange`— cuando llega.
461
+
462
+ **De varias filas**: basta una columna `type: 'checkbox'`. La clave de cada casilla sale de
463
+ `chkField` (o del `property` de la columna), y con `chkFieldSeparador` se pueden combinar varios
464
+ campos. Con `chkFieldPersistente` lo marcado sobrevive al cambio de página. El evento
465
+ `opcionSelecionada` lleva entonces `idsSeleccionados` (texto separado por comas) e
466
+ `itemsSeleccionados` (los registros).
467
+
468
+ ### Teclado
469
+
470
+ | Tecla | Qué hace |
471
+ |---|---|
472
+ | Flechas | Mueve el foco y la selección de fila en fila |
473
+ | Enter | Abre el registro enfocado (avisa `ver`) |
474
+ | Espacio | Marca o desmarca su casilla si la tabla tiene columna `checkbox`; si no, abre como Enter |
475
+ | Supr | Pide eliminar (no hace nada en solo lectura ni dentro de un campo de la celda) |
476
+
477
+ Las teclas pulsadas dentro de un campo de una celda se quedan en el campo.
478
+
479
+ ## Eventos
480
+
481
+ | Salida | Cuándo |
482
+ |---|---|
483
+ | `opcionSelecionada` | Botón pulsado, fila elegida, doble clic, menú contextual o `Supr`. Lleva el botón, la fila, su índice y la selección |
484
+ | `resultados` | El servidor debe traer otra página, otro orden u otra búsqueda |
485
+ | `accionRecargar` | El usuario pidió actualizar |
486
+ | `selectionModelChange` | Cambió la fila seleccionada |
487
+ | `opcBusqueda` | Cambió el criterio de búsqueda |
488
+
489
+ ## Búsqueda
490
+
491
+ `ctrlBusqueda="simple"` filtra en memoria; `ctrlBusqueda="query"` manda el término al servidor
492
+ dentro de `resultados`. `busquedaCompacta` reduce el buscador a un icono que abre un menú con el campo: `true` siempre, `false` nunca y `'auto'` (por defecto) cuando la banda de la tabla es angosta (el mismo umbral de los botones, ver **Tablas angostas**). Decide el ancho de la tabla, no el de la ventana, así un panel angosto también lo compacta; con texto buscado el icono lleva un punto. La búsqueda simple no
493
+ distingue tildes ni mayúsculas ("memorandum" encuentra "MEMORÁNDUM"; la ñ se respeta).
494
+ `ctrlBusquedaAncho` fija el ancho máximo del buscador (por defecto `150px`). `[ctrlBusquedaCampos]="['cNombre', 'cSigla']"` limita la búsqueda simple a
495
+ esos campos (por defecto busca en todos los del registro, también en los que no se ven, como el nombre
496
+ del padre). El texto buscado se
497
+ mantiene al recargar.
498
+
499
+ **La búsqueda suelta la selección que oculta.** Si el texto deja fuera la fila elegida, la tabla
500
+ la suelta y avisa `selectionModelChange(null)`, para que los botones no actúen sobre una fila que no
501
+ se ve (en árbol, una fila que queda como camino atenuado sigue elegida). Precedencia con
502
+ `seguirSeleccion`: manda lo último que pasó. Si la pantalla fija una selección que la búsqueda
503
+ oculta, la tabla limpia la búsqueda; si el usuario escribe un texto que oculta la selección, la
504
+ selección se suelta. Una selección fijada que aún no llegó en los datos no se suelta.
505
+
506
+ El panel de filtros avanzados **no** es parte de esta tabla: es el componente hermano
507
+ `jvs-filtro-busqueda`, que se coloca aparte y devuelve sus resultados por `dataFiltro`.
508
+
509
+ ## Árbol (`[arbol]`)
510
+
511
+ Para listas jerárquicas (despachos, dependencias, plan de cuentas…): la tabla recibe la lista
512
+ **plana y completa** —cada registro con su id y el de su padre— y la pinta como árbol, sin perder
513
+ búsqueda, orden, Excel, `[cargando]`, selección ni teclado.
514
+
515
+ ```typescript
516
+ readonly arbol = computed<ConfigArbolTabla<Despacho>>(() => ({
517
+ campoId: 'iDespachoId',
518
+ campoIdPadre: 'iDespachoDependeId',
519
+ nivelesAbiertos: 2, // raíz y primer nivel desplegados (por defecto 1)
520
+ plano: this.plano(), // "Lista plana": sin jerarquía
521
+ filtro: d => d.iTipoDespachoId === 4, // filtro propio (tipo, estado…), se suma al buscador
522
+ filtroActivo: this.hayFiltro(), // ¿el filtro cuenta como búsqueda? (ver abajo)
523
+ }));
524
+ ```
525
+
526
+ ```html
527
+ <jvs-tabla-mantenimiento [arbol]="arbol()" [columnasTabla]="columnas" …>
528
+ ```
529
+
530
+ La sangría y el botón de plegar van en una columna `type: 'arbol'` (pinta el texto de `property`
531
+ o de `transformar`) o, para un contenido propio, dentro de una `custom`:
532
+
533
+ ```html
534
+ <td *matCellDef="let row" mat-cell>
535
+ <jvs-tabla-arbol-celda [fila]="row">{{ row.cNombre }} <small>{{ row.cSigla }}</small></jvs-tabla-arbol-celda>
536
+ </td>
537
+ ```
538
+
539
+ Cómo se comporta:
540
+
541
+ - **Sin búsqueda ni filtro**: árbol con `nivelesAbiertos` niveles desplegados.
542
+ - **Con búsqueda o filtro**: se ven las coincidencias **y sus antepasados**, todo desplegado; los
543
+ antepasados que no coinciden van atenuados (clase `jvs-arbol-contexto`). El árbol nunca queda en
544
+ blanco porque el padre de una coincidencia no pase el filtro. Por defecto el filtro propio
545
+ "cuenta" cuando deja fuera alguna fila; `filtroActivo: false` lo evita para un filtro que está
546
+ siempre puesto (p. ej. ocultar inactivos), que así no despliega todo.
547
+ - Un registro cuyo padre **no está en la lista** sale como raíz; uno que forma un **ciclo** (o es
548
+ su propio padre) también, y el ciclo se corta. Nada desaparece.
549
+ - El botón de plegar no selecciona la fila. `expandirTodoArbol(true | false)` abre o cierra todo.
550
+ - `seleccionarPorId()`, `[selectionModel]` e `irASeleccion()` abren el camino de una fila plegada.
551
+ - Ordenar por una columna reordena **entre hermanos**, sin romper la jerarquía; `comparar` da el
552
+ orden por defecto entre hermanos.
553
+ - El paginador cuenta las filas a la vista. El **Excel** exporta las coincidencias y sus
554
+ antepasados en orden de árbol, aunque estén plegados.
555
+ - **Modo plano** (`plano: true`): sin sangría ni plegado; la búsqueda y el filtro dejan solo las
556
+ coincidencias y el orden por columnas es el de siempre.
557
+ - `infoArbol(fila)` devuelve `{nivel, tieneHijos, abierto, contexto}` (o `null` sin árbol).
558
+
559
+ La lógica vive en `TablaMantenimientoDataSource` (exportado) y en funciones puras de
560
+ `@jvsoft/utils` que sirven sueltas: `indexarArbol`, `filtrarArbolConAntepasados`, `aplanarArbol`,
561
+ `antepasadosArbol`, `descendientesArbol`, `puedeSerPadreArbol` (p. ej. para que un "depende de"
562
+ no ofrezca al propio registro ni a sus descendientes).
563
+
564
+ ## Fila extra y pie
565
+
566
+ `filaExtraTemplate` despliega contenido bajo cada fila, normalmente junto a una columna
567
+ `type: 'expandir'`. Con fila extra el ordenamiento se bloquea, porque reordenar rompería la
568
+ correspondencia con lo desplegado. `filaFooter` activa el pie, que cada columna calcula con
569
+ `transformarFooter()`.
570
+
571
+ ## Exportación
572
+
573
+ `exportarExcel` (activo por defecto) añade el botón y exporta **lo que se ve**: respeta el
574
+ filtro, el orden y las columnas visibles, y usa `labelLista` como encabezado. Fechas, números y
575
+ montos salen con su tipo, no como texto. `nombreExcel` da nombre a la hoja y al archivo (por
576
+ defecto, `nombreColeccion`).
577
+
578
+ `datosExcel()` devuelve las filas tal como saldrían en el Excel (un objeto por fila, con el
579
+ encabezado de cada columna como clave), sin descargar nada: sirve para revisarlo desde la consola o
580
+ en pruebas.
581
+
582
+ ## Animación
583
+
584
+ `[animarFilas]="false"` quita la entrada animada fila por fila (por defecto sigue activa).
585
+
586
+ `[cargando]="cargando()"` muestra una barra de carga indeterminada entre la banda y la cabecera
587
+ mientras es `true`. Sin el input no se dibuja nada; con él, el hueco de 4 px queda reservado para que
588
+ la tabla no salte al cargar.
589
+
590
+ Si el buscador no deja filas, la tabla muestra "Ningún registro coincide con "…"" con un botón
591
+ "Limpiar búsqueda" (en la búsqueda `query` vuelve a pedir los datos). Mientras `cargando` es `true`
592
+ no muestra ningún mensaje de "sin datos".
593
+
594
+ ## Notas de comportamiento
595
+
596
+ - La tabla **no escribe dentro de los datos ni de las columnas** que recibe. Si ves propiedades
597
+ que no declaraste, no vienen de aquí.
598
+ - Consultar los botones no los modifica; leer las columnas visibles, tampoco.
599
+ - Si los datos llegan antes de que exista la vista (un `BehaviorSubject` con valor, `toObservable`
600
+ de una señal), el paginador y el orden se enganchan igual: antes la tabla pintaba todas las filas.
601
+ - `objThis.seleccionados[nombreColeccion]` se sigue consultando como respaldo cuando la fila
602
+ elegida no está entre los datos cargados, pero el canal recomendado es `[(selectionModel)]`.
603
+
604
+ ## En retirada
605
+
606
+ Estas piezas siguen funcionando pero están marcadas como obsoletas y se quitarán en una
607
+ versión mayor. Si las usas, conviene ir migrando:
608
+
609
+ | En retirada | En su lugar |
610
+ |---|---|
611
+ | `row.isExpanded` dentro del registro | `estaExpandida(row)` y `alternarExpansion(row)` |
612
+ | `objThis.seleccionados[nombreColeccion]` como canal de selección | `[(selectionModel)]` |
613
+ | `dblclickItem` | `opcionSelecionada` con tipo `seleccionar` |
614
+ | `dataSourceChange` | — (entregaba la instancia interna del dataSource) |
615
+ | `DataModel.agregarControles` para casillas | `DataModel.prepararCasillas` |
616
+ | `type: 'image'` y `type: 'badge'` (no se pintan) | `type: 'text'` con `celda` (`imagen()`, `badge()`) |
617
+ | `toolTip` / `toolTipField` en los íconos de `icons` | `tooltip` / `tooltipField` (mismo efecto) |
618
+ | `innerHTMLInvisible` (la librería no lo lee; tampoco el Excel) | `excel.valor` |
619
+
620
+ ## Para mirar el código
621
+
622
+ - `tabla-mantenimiento.component.ts` — componente principal
623
+ - `tabla-mantenimiento.service.ts` — catálogo de botones y columnas
624
+ - `tabla-mantenimiento-column-defs/` — un componente por tipo de columna
625
+ - `tabla-celda/` — celdas declarativas: `<jvs-tabla-celda>` y los ayudantes (`piezas.ts`)
626
+ - `classes/data-model.ts` — estado de las casillas de selección múltiple
627
+ - `mat-row-keyboard-selection.directive.ts` — navegación con el teclado
628
+ - `tabla-mantenimiento.component.spec.ts` — el comportamiento descrito aquí, fijado en pruebas