@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,300 @@
1
+ import * as _angular_core from '@angular/core';
2
+ import { InjectionToken, Signal, EnvironmentProviders } from '@angular/core';
3
+
4
+ /**
5
+ * Tamaños de imagen que el backend sabe generar. Coincide 1:1 con el enum PHP
6
+ * `JvSoft\Utils\Fotos\Preset`; como son 5 valores fijos y ya versionados en el
7
+ * contrato del backend, un union type basta y evita mantener dos definiciones
8
+ * sincronizadas a mano.
9
+ */
10
+ type Preset = 'thumbnail' | 'avatar' | 'avatar-grande' | 'full' | 'medium';
11
+ /** Resultado resuelto (o en curso) para un `iPersId` + `preset`. */
12
+ interface UrlFoto {
13
+ /** URL absoluta de la foto real, o `null` si no hay una. */
14
+ url: string | null;
15
+ /** Nombre del estático de falta (`natural-f`, `entidad`, …) cuando no hay foto real. */
16
+ default: string | null;
17
+ /** `true` mientras el manifiesto que resuelve este id todavía no responde. */
18
+ cargando: boolean;
19
+ }
20
+ /** Configuración inyectable del servicio. Sigue el patrón de `ENCRYPTION_CONFIG`. */
21
+ interface FotoPersonaConfig {
22
+ /**
23
+ * Base del API del backend — el mismo valor que la app ya resuelve como `backendApi`
24
+ * (host + `/api`, o lo que sea que cada instalación configure; **incluye** el `/api`, este
25
+ * servicio no le agrega uno propio). Sin slash final. Por defecto relativo (mismo origen).
26
+ *
27
+ * Puede ser un `string` fijo o una función que se llama **en cada petición**: úsala cuando el
28
+ * valor real (p. ej. `ConfiguracionWebService.apiData`) se resuelve de forma asíncrona,
29
+ * después de que este servicio ya se haya inyectado — un `string` capturado en el momento del
30
+ * `provide*()` se congelaría con el valor que hubiera en ese instante (frecuentemente
31
+ * `undefined`, antes de que cargue el `apiData`).
32
+ */
33
+ apiUrl?: string | (() => string);
34
+ /** Tope de ids por petición de manifiesto. Debe ser <= `jvsoft.fotos.lote_max` del backend (200 por defecto). */
35
+ loteMax?: number;
36
+ /**
37
+ * Cuánto tiempo (ms) espera una clave que falló por red antes de volverse elegible para
38
+ * un reintento automático en una lectura posterior de `urlFoto()`. Evita que un componente
39
+ * que se re-renderiza seguido bombardee el backend. 5000 ms por defecto.
40
+ */
41
+ cooldownMs?: number;
42
+ /**
43
+ * Carpeta de assets donde la app consumidora empaquetó las seis imágenes de falta
44
+ * (`natural-m`, `natural-f`, `entidad`, `extranjero-m`, `extranjero-f`, `falta`), sin slash
45
+ * final — típicamente `assets/img/falta` si siguió la convención de `angular.json` de copiar
46
+ * `assets/` a la raíz servida. **Sin configurar (el default), el comportamiento no cambia**:
47
+ * el estático de falta se sigue pidiendo al backend (`urlDefecto()`), como hasta ahora — así
48
+ * una app que todavía no copió los seis archivos no se rompe. Configurarla evita esa petición
49
+ * de red: las imágenes son idénticas para todas las instalaciones y no valía la pena traerlas
50
+ * por HTTP en cada caché fría. Ver `rutaLocalDefecto()`.
51
+ */
52
+ assetsBasePath?: string;
53
+ /**
54
+ * Cuánto tiempo (ms) se reutiliza en memoria una URL de foto antes de volver a pedirla al
55
+ * manifiesto. Existe porque esas URL van **firmadas** y caducan: guardarlas para siempre
56
+ * acabaría pintando `<img>` con una firma vencida.
57
+ *
58
+ * Normalmente no hace falta tocarlo. El manifiesto anuncia el valor bueno en la cabecera
59
+ * `X-Fotos-Ttl` y el servicio lo adopta en cuanto lo ve, así que basta con cambiarlo en el
60
+ * backend. Esto es solo el valor inicial, para la primera petición y para cuando la
61
+ * cabecera no llega —por ejemplo si el backend sirve en otro origen y nadie la expuso en
62
+ * `exposed_headers` de CORS—. 8 h por defecto, un escalón por debajo de la caché del
63
+ * navegador, que a su vez está por debajo de la vida de la firma.
64
+ */
65
+ ttlUrlMs?: number;
66
+ }
67
+ declare const FOTO_PERSONA_CONFIG: InjectionToken<FotoPersonaConfig>;
68
+ /**
69
+ * Acumula las peticiones de foto de persona que llegan en el mismo ciclo de
70
+ * detección de cambios y las resuelve con **un** `POST /api/imagenes/persona/lote`
71
+ * (o varios si el lote excede `loteMax`), en vez de una petición HTTP por
72
+ * componente. Ver diseño en `docs/superpowers/specs/2026-09-06-fotos-s3-central-design.md` § 8.3.
73
+ *
74
+ * ## Contrato de reintentos
75
+ * Hay una diferencia entre «el servidor contestó que no hay foto» (una respuesta real, se
76
+ * cachea para siempre) y «no pudimos ni preguntar» (una falla de red, que no es una respuesta y
77
+ * no debe tratarse como una). Por eso:
78
+ * - Una respuesta del servidor (con foto, o sin foto pero con `default`) queda **confirmada**:
79
+ * nunca se vuelve a pedir.
80
+ * - Una falla de red deja el resultado inmediato en «sin foto» (no se cuelga en `cargando`, no
81
+ * lanza), pero **no** queda confirmada. La clave entra en un cooldown corto (`cooldownMs`, 5 s
82
+ * por defecto) durante el cual ni `urlFoto()` ni el paso del tiempo la reintentan solos.
83
+ * - Pasado el cooldown, la clave queda **elegible**, no se reintenta sola: hace falta que algo
84
+ * la vuelva a pedir — típicamente un `urlFoto()` nuevo (un componente que se crea) o una
85
+ * llamada a `precargar()`. El cooldown expirando **no despierta a nadie** por sí mismo (no
86
+ * toca `tick`, ver `programarCooldown()`): si lo hiciera, cada falla programaría su propio
87
+ * cooldown, que al vencer despertaría a los mismos consumidores fallidos, que volverían a
88
+ * pedir, fallarían de nuevo y programarían otro cooldown — un poll perpetuo contra un backend
89
+ * caído. Una lectura de verdad nueva (navegación, tabla que se recarga con componentes nuevos,
90
+ * `precargar()`) es lo único que reintenta.
91
+ * - `precargar()` reintenta claves no confirmadas de inmediato, sin esperar el cooldown — para
92
+ * un botón "reintentar" o para precargar una tabla a propósito.
93
+ *
94
+ * ## Caducidad
95
+ * Las URL de foto real van firmadas por el backend y vencen (12 h como máximo), así que
96
+ * "confirmada" no significa "para siempre": una entrada con foto real vive `ttlUrlMs` —o lo
97
+ * que anuncie la cabecera `X-Fotos-Ttl`, que manda— y después se vuelve a pedir. Una persona
98
+ * sin foto no caduca: su estático no lleva firma.
99
+ *
100
+ * Como el cooldown, la caducidad **no despierta a nadie**: no toca `tick`, solo cambia lo que
101
+ * encontrará la próxima lectura. Un `<img>` ya pintado no se ve afectado —el navegador no
102
+ * vuelve a pedir una imagen que ya cargó—; lo que importa es que la siguiente vez que alguien
103
+ * pregunte reciba una URL con firma vigente.
104
+ */
105
+ declare class FotoPersonaService {
106
+ private readonly http;
107
+ private readonly config;
108
+ private readonly loteMax;
109
+ private readonly cooldownMs;
110
+ /**
111
+ * Vida de una URL en memoria. No es `readonly`: la cabecera `X-Fotos-Ttl` del manifiesto
112
+ * la reemplaza, de modo que bajar el TTL en el backend basta para que todos los clientes
113
+ * se ajusten en su siguiente petición, sin desplegar el frontend.
114
+ */
115
+ private ttlUrlMs;
116
+ /** Último resultado conocido por clave (`preset:id`), incluidas las fallas transitorias. */
117
+ private readonly resultados;
118
+ /** Claves que el servidor ya resolvió con una respuesta válida: no se vuelven a pedir. */
119
+ private readonly confirmados;
120
+ /**
121
+ * Instante (ms) a partir del cual una clave confirmada deja de valer y hay que volver a
122
+ * pedirla. Solo entran aquí las que apuntan a una foto real: su URL va firmada y caduca.
123
+ * Una persona sin foto se resuelve con un estático —empaquetado en la app o servido por la
124
+ * ruta pública—, que no lleva firma y no tiene por qué volver a preguntarse.
125
+ */
126
+ private readonly caducan;
127
+ /** Claves encoladas o con la petición ya en vuelo: evita duplicar la petición. */
128
+ private readonly enCurso;
129
+ /** Claves que fallaron por red hace poco: en cooldown, `urlFoto()` todavía no las reintenta solo. */
130
+ private readonly enCooldown;
131
+ /** Ids pendientes de enviar en el próximo flush, agrupados por preset. */
132
+ private pendientes;
133
+ private flushProgramado;
134
+ /** Se incrementa cada vez que llega una respuesta (éxito o falla), para que los `computed()` abiertos se enteren. */
135
+ private readonly tick;
136
+ /**
137
+ * Signal reactiva con la foto de `iPersId` en el `preset` dado. Dispara la petición la
138
+ * primera vez que se lee, si en ese momento la clave no está confirmada, en curso ni en
139
+ * cooldown por una falla reciente (ver "Contrato de reintentos" arriba) — así que un
140
+ * `urlFoto()` nuevo creado después de que el cooldown de una falla anterior venció sí
141
+ * reintenta, aunque la signal de un componente que ya estaba montado cuando falló no se
142
+ * reintente sola con el simple paso del tiempo. `iPersId` en `null` no pide nada: devuelve el
143
+ * resultado vacío tal cual, y es responsabilidad del consumidor (p. ej. `FotoPersonaComponent`)
144
+ * decidir qué pintar en ese caso.
145
+ */
146
+ urlFoto(iPersId: Signal<number | null>, preset: Preset): Signal<UrlFoto>;
147
+ /**
148
+ * Anuncia de golpe lo que una tabla va a necesitar, para que el primer
149
+ * `urlFoto()` de cada fila ya encuentre la respuesta en memoria. También
150
+ * es el mecanismo de reintento **inmediato** tras una falla de red: a
151
+ * diferencia de la lectura pasiva de `urlFoto()`, no espera el cooldown —
152
+ * vuelve a pedir cualquier id que no esté `confirmado`, aunque todavía
153
+ * esté en cooldown por una falla reciente.
154
+ */
155
+ precargar(ids: number[], presets: Preset[]): void;
156
+ /**
157
+ * URL pública del estático de falta (`natural-f`, `entidad`, …) para el `preset` dado. Pega
158
+ * en `GET {apiUrl}/imagenes/default/{nombre}/{preset}.{ext}` (sin autenticar, cacheado un
159
+ * año), con la misma base de API que usa el manifiesto. La extensión sale del preset, no del
160
+ * archivo en disco (que en el backend está mezclado entre `.png` y `.jpg`): así los
161
+ * consumidores nunca tienen que saber ni copiar esas imágenes.
162
+ */
163
+ urlDefecto(nombre: string, preset: Preset): string;
164
+ /**
165
+ * Ruta del asset local para el estático de falta `nombre`, o `null` si la app no configuró
166
+ * `assetsBasePath` — en ese caso el consumidor debe caer a `urlDefecto()`. A diferencia de
167
+ * `urlDefecto()`, esta ruta **no varía por preset**: las seis imágenes bundleadas son un solo
168
+ * archivo chico por nombre, no variantes generadas por tamaño (por eso no recibe `preset`).
169
+ * Un `nombre` que no sea uno de los seis conocidos cae a `falta`, igual que hace el componente
170
+ * cuando el manifiesto no trae `default`.
171
+ */
172
+ rutaLocalDefecto(nombre: string): string | null;
173
+ /**
174
+ * Resuelve la base del API **en cada llamada**, nunca una sola vez: `apiUrl` puede ser una
175
+ * función que lee un valor que todavía no llegó cuando este servicio se inyectó (el servicio
176
+ * es `providedIn: 'root'`, así que su constructor corre una única vez, la primera vez que
177
+ * algo lo inyecta — capturar el valor ahí lo congelaría, típicamente en `undefined`/`''`, si
178
+ * la app resuelve su config de backend de forma asíncrona).
179
+ */
180
+ /**
181
+ * URL base del API, resuelta en CADA petición. Si falta, se lanza en vez de caer a cadena
182
+ * vacía: una base vacía produce peticiones relativas al servidor de desarrollo, que fallan
183
+ * con un 404 desconcertante en vez de señalar el cableado ausente. El caso real que motivó
184
+ * esto fue un `FOTO_PERSONA_CONFIG` duplicado por un entry point reexportado con ruta
185
+ * relativa: la app registraba un token y el servicio inyectaba otro, y el `optional: true`
186
+ * convertía ese error de empaquetado en un 404 silencioso.
187
+ */
188
+ private apiUrl;
189
+ private solicitar;
190
+ private programarFlush;
191
+ private flush;
192
+ private pedirManifiesto;
193
+ private procesarRespuesta;
194
+ private procesarFallo;
195
+ /**
196
+ * Pasado `cooldownMs`, libera la clave para que la próxima vez que algo la pida — un
197
+ * `urlFoto()` nuevo, típicamente un componente que se crea — la vuelva a intentar.
198
+ *
199
+ * A propósito **no** toca `tick`: si lo hiciera, despertaría a todos los `computed()`
200
+ * abiertos que dependen de `tick` (incluidos los que fallaron), cada uno volvería a leer,
201
+ * el gate vería la clave ya libre y pediría de nuevo — y esa nueva falla programaría otro
202
+ * cooldown que, al vencer, repetiría el ciclo: un poll perpetuo contra el backend mientras el
203
+ * endpoint esté caído, uno por cada clave fallida, cada `cooldownMs`. Sin tocar `tick`, nada
204
+ * se despierta solo: liberar la clave solo cambia lo que un `urlFoto()` **nuevo** (o
205
+ * `precargar()`) va a encontrar la próxima vez que alguien pregunte por su cuenta.
206
+ */
207
+ private programarCooldown;
208
+ private enTrozos;
209
+ /**
210
+ * Si la clave sigue sirviendo: confirmada por el servidor y, cuando apunta a una foto
211
+ * real, con la firma todavía dentro de su ventana. Una clave caducada se borra aquí mismo
212
+ * para que la siguiente lectura la pida de nuevo.
213
+ */
214
+ /**
215
+ * Adopta el TTL que anuncia el servidor. Se ignora lo que no sea un número positivo: una
216
+ * cabecera ausente (CORS sin exponerla, un backend anterior a este contrato) o corrupta no
217
+ * debe dejar el servicio con un TTL de cero, que pediría el manifiesto en cada lectura.
218
+ */
219
+ private adoptarTtl;
220
+ private vigente;
221
+ private clave;
222
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FotoPersonaService, never>;
223
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<FotoPersonaService>;
224
+ }
225
+
226
+ /**
227
+ * Cablea `FOTO_PERSONA_CONFIG` en una sola llamada, igual que `provideEncryption()` cablea
228
+ * `ENCRYPTION_CONFIG`. Acepta un objeto estático o una **fábrica** que corre en contexto de
229
+ * inyección (puede usar `inject()` para leer la URL de un servicio de configuración del
230
+ * consumidor, como ya hace cada app con `ConfiguracionWebService`).
231
+ *
232
+ * La fábrica captura el *servicio* (para eso corre en contexto de inyección), pero `apiUrl`
233
+ * debería ser casi siempre un **thunk** (`() => string`), no un valor ya leído: en las apps de
234
+ * JVSoft, `ConfiguracionWebService.apiData` se resuelve de forma asíncrona (un
235
+ * `BehaviorSubject` que arranca en `null`), así que leerlo una sola vez aquí —al armar la
236
+ * fábrica, no al hacer la petición— lo congelaría en `undefined`/`''` para toda la sesión.
237
+ *
238
+ * @example
239
+ * // Config estática (base fija, sin partes asíncronas):
240
+ * provideFotoPersona({ apiUrl: 'https://api.example.com/api' })
241
+ *
242
+ * @example
243
+ * // Fábrica con inyección + thunk (recomendado): `cfg.backendApi` se relee en cada petición,
244
+ * // así que aunque `apiData` llegue después, la primera petición real ya lo ve resuelto.
245
+ * provideFotoPersona(() => {
246
+ * const cfg = inject(ConfiguracionWebService);
247
+ * return { apiUrl: () => cfg.backendApi };
248
+ * })
249
+ */
250
+ declare function provideFotoPersona(config: FotoPersonaConfig | (() => FotoPersonaConfig)): EnvironmentProviders;
251
+
252
+ /** Tamaño semántico: la plantilla ya no pide un preset ni un número de píxeles. */
253
+ type TamanoFoto = 'tabla' | 'tarjeta' | 'ficha';
254
+ interface DimensionFoto {
255
+ ancho: number;
256
+ alto: number;
257
+ }
258
+ /**
259
+ * `<jvs-foto-persona>` — foto de una persona por `iPersId`, con un tamaño
260
+ * semántico (`tabla`, `tarjeta`, `ficha`) en vez de un preset o unos píxeles.
261
+ * Consume `FotoPersonaService` (que acumula y cachea las peticiones); este
262
+ * componente solo traduce tamaño → preset y decide qué pintar mientras carga
263
+ * o cuando no hay foto real.
264
+ */
265
+ declare class FotoPersonaComponent {
266
+ private readonly fotoPersonaService;
267
+ /**
268
+ * Id de la persona. En `null` (por ejemplo, un formulario donde todavía no se eligió a
269
+ * nadie) el componente **no pide nada al servicio**, pero sí pinta el estático genérico
270
+ * `falta` en el tamaño que le toca a `tamano` — reserva el mismo hueco y evita un salto de
271
+ * layout cuando se elige a alguien, en vez de dejar una caja vacía.
272
+ */
273
+ iPersId: _angular_core.InputSignal<number | null>;
274
+ tamano: _angular_core.InputSignal<TamanoFoto>;
275
+ alt: _angular_core.InputSignal<string>;
276
+ clases: _angular_core.InputSignal<string>;
277
+ protected readonly preset: _angular_core.Signal<Preset>;
278
+ protected readonly dimension: _angular_core.Signal<DimensionFoto>;
279
+ /** Envuelve la signal que devuelve el servicio (que puede cambiar de instancia si cambia el preset). */
280
+ private readonly foto;
281
+ /**
282
+ * URL a pintar, o `null` mientras carga (todavía sin foto real ni
283
+ * estático que mostrar). Prioridad: foto real → estático que indicó el
284
+ * servidor → estático genérico `falta` cuando ni eso hay (falla de red
285
+ * ya resuelta, o servidor que no devolvió nada).
286
+ *
287
+ * El estático de falta prefiere el asset local (`FotoPersonaService.rutaLocalDefecto()`) si
288
+ * la app configuró `assetsBasePath` — las seis imágenes son chicas e idénticas para todas
289
+ * las instalaciones, así que empaquetarlas evita una petición de red por instalación con
290
+ * caché fría. Si la app no configuró esa ruta, cae al backend (`urlDefecto()`,
291
+ * `GET /api/imagenes/default/{nombre}/{preset}.{ext}`), como siempre: ese es el comportamiento
292
+ * sin cambios para quien todavía no copió los seis archivos.
293
+ */
294
+ protected readonly src: _angular_core.Signal<string | null>;
295
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FotoPersonaComponent, never>;
296
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FotoPersonaComponent, "jvs-foto-persona", never, { "iPersId": { "alias": "iPersId"; "required": false; "isSignal": true; }; "tamano": { "alias": "tamano"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "clases": { "alias": "clases"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
297
+ }
298
+
299
+ export { FOTO_PERSONA_CONFIG, FotoPersonaComponent, FotoPersonaService, provideFotoPersona };
300
+ export type { FotoPersonaConfig, Preset, TamanoFoto, UrlFoto };
@@ -0,0 +1,61 @@
1
+ import * as _angular_core from '@angular/core';
2
+ import { TemplateRef } from '@angular/core';
3
+ import { Observable } from 'rxjs';
4
+ import { NestedTreeControl } from '@angular/cdk/tree';
5
+ import { DataModel } from '@jvsoft/utils';
6
+
7
+ declare class ListaArbolComponent<T = any> {
8
+ listaSuscription: _angular_core.InputSignal<Observable<T[]>>;
9
+ nombreColeccion: _angular_core.InputSignal<string>;
10
+ checkbox: _angular_core.InputSignal<boolean>;
11
+ expandirRecursivo: _angular_core.InputSignal<boolean>;
12
+ checkboxSeleccionados: _angular_core.InputSignal<T[]>;
13
+ campoId: _angular_core.InputSignal<string>;
14
+ campoIdPadre: _angular_core.InputSignal<string>;
15
+ campoStr: _angular_core.InputSignal<string>;
16
+ campoOrden: _angular_core.InputSignal<string | undefined>;
17
+ strHijoContainer: _angular_core.InputSignal<string>;
18
+ menuContextual: _angular_core.InputSignal<{
19
+ abrirMenuContextual: Function;
20
+ cerrarMenuContextual: Function;
21
+ } | undefined>;
22
+ classSeleccionado: _angular_core.InputSignal<string[]>;
23
+ classAnulado: _angular_core.InputSignal<string[]>;
24
+ campoAnulado: _angular_core.InputSignal<string | null | undefined>;
25
+ templateTxtData: _angular_core.InputSignal<TemplateRef<any> | undefined>;
26
+ condicionMostrar: _angular_core.InputSignal<((item: T) => boolean) | undefined>;
27
+ condicionesClaseFila: _angular_core.InputSignal<(item: T) => string[]>;
28
+ idTabla: _angular_core.InputSignalWithTransform<string | string[], string | string[]>;
29
+ selectionModel: _angular_core.InputSignal<any>;
30
+ selectionModelChange: _angular_core.OutputEmitterRef<any>;
31
+ seleccionado: _angular_core.OutputEmitterRef<any>;
32
+ /** Ids marcados, separados por comas (p. ej. "6,8"): es lo que arma `DataModel.generarLista()`. */
33
+ listaCheck: _angular_core.OutputEmitterRef<string>;
34
+ listaCheckObj: _angular_core.OutputEmitterRef<Record<string, any>>;
35
+ private _idTabla;
36
+ private _seleccionado;
37
+ listaMuestraArbol: _angular_core.WritableSignal<T[]>;
38
+ listaOriginal: _angular_core.WritableSignal<T[]>;
39
+ chkLista: DataModel;
40
+ idTablaValue: _angular_core.Signal<string[]>;
41
+ buscarItemSeleccionado: _angular_core.Signal<NonNullable<T> | null>;
42
+ objSeleccionado: _angular_core.Signal<NonNullable<T> | null>;
43
+ treeControl: NestedTreeControl<any, any>;
44
+ private listaSuscription$;
45
+ constructor();
46
+ idTablaValor(data: any): string;
47
+ propiedadSeleccion(item: any): string;
48
+ esSeleccionActual(item: any): boolean;
49
+ seleccionarItem(item?: any, forzado?: boolean): void;
50
+ hasChild: (_: number, node: any) => boolean;
51
+ opcMenu(v: any): void;
52
+ emitirModeloCheck(): void;
53
+ cambiarPadre(checkActual: T, estado: boolean): void;
54
+ cambiarCheck(checkActual: T, estado: boolean): void;
55
+ hijosActivos(tipo: 'checked' | 'indeterminate', checkActual: T): boolean;
56
+ classFila(item: any): string[];
57
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListaArbolComponent<any>, never>;
58
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListaArbolComponent<any>, "jvs-lista-arbol", never, { "listaSuscription": { "alias": "listaSuscription"; "required": true; "isSignal": true; }; "nombreColeccion": { "alias": "nombreColeccion"; "required": true; "isSignal": true; }; "checkbox": { "alias": "checkbox"; "required": false; "isSignal": true; }; "expandirRecursivo": { "alias": "expandirRecursivo"; "required": false; "isSignal": true; }; "checkboxSeleccionados": { "alias": "checkboxSeleccionados"; "required": false; "isSignal": true; }; "campoId": { "alias": "campoId"; "required": true; "isSignal": true; }; "campoIdPadre": { "alias": "campoIdPadre"; "required": true; "isSignal": true; }; "campoStr": { "alias": "campoStr"; "required": false; "isSignal": true; }; "campoOrden": { "alias": "campoOrden"; "required": false; "isSignal": true; }; "strHijoContainer": { "alias": "strHijoContainer"; "required": false; "isSignal": true; }; "menuContextual": { "alias": "menuContextual"; "required": false; "isSignal": true; }; "classSeleccionado": { "alias": "classSeleccionado"; "required": false; "isSignal": true; }; "classAnulado": { "alias": "classAnulado"; "required": false; "isSignal": true; }; "campoAnulado": { "alias": "campoAnulado"; "required": false; "isSignal": true; }; "templateTxtData": { "alias": "templateTxtData"; "required": false; "isSignal": true; }; "condicionMostrar": { "alias": "condicionMostrar"; "required": false; "isSignal": true; }; "condicionesClaseFila": { "alias": "condicionesClaseFila"; "required": false; "isSignal": true; }; "idTabla": { "alias": "idTabla"; "required": true; "isSignal": true; }; "selectionModel": { "alias": "selectionModel"; "required": false; "isSignal": true; }; }, { "selectionModelChange": "selectionModelChange"; "seleccionado": "seleccionado"; "listaCheck": "listaCheck"; "listaCheckObj": "listaCheckObj"; }, never, never, true, never>;
59
+ }
60
+
61
+ export { ListaArbolComponent };
@@ -1,6 +1,7 @@
1
+ import * as i0 from '@angular/core';
1
2
  import { OnInit } from '@angular/core';
2
- import * as i0 from "@angular/core";
3
- export declare class LucesNavidadComponent implements OnInit {
3
+
4
+ declare class LucesNavidadComponent implements OnInit {
4
5
  enProduccion: boolean;
5
6
  forzarMuestra: boolean;
6
7
  mesActual: number;
@@ -9,3 +10,5 @@ export declare class LucesNavidadComponent implements OnInit {
9
10
  static ɵfac: i0.ɵɵFactoryDeclaration<LucesNavidadComponent, never>;
10
11
  static ɵcmp: i0.ɵɵComponentDeclaration<LucesNavidadComponent, "jvs-luces-navidad, [jvsLucesNavidad]", never, { "enProduccion": { "alias": "enProduccion"; "required": false; }; "forzarMuestra": { "alias": "forzarMuestra"; "required": false; }; }, {}, never, never, true, never>;
11
12
  }
13
+
14
+ export { LucesNavidadComponent };
@@ -1,7 +1,8 @@
1
+ import * as i0 from '@angular/core';
1
2
  import { EventEmitter } from '@angular/core';
2
3
  import { FormControl } from '@angular/forms';
3
- import * as i0 from "@angular/core";
4
- export declare class MatSuffixSearchButtonComponent {
4
+
5
+ declare class MatSuffixSearchButtonComponent {
5
6
  fControl: any;
6
7
  eventLimpiar: EventEmitter<any>;
7
8
  eventBuscar: EventEmitter<any>;
@@ -10,3 +11,5 @@ export declare class MatSuffixSearchButtonComponent {
10
11
  static ɵfac: i0.ɵɵFactoryDeclaration<MatSuffixSearchButtonComponent, never>;
11
12
  static ɵcmp: i0.ɵɵComponentDeclaration<MatSuffixSearchButtonComponent, "div[matSuffix][matSuffixSearchButton]", never, { "fControl": { "alias": "fControl"; "required": true; }; }, { "eventLimpiar": "eventLimpiar"; "eventBuscar": "eventBuscar"; }, never, never, true, never>;
12
13
  }
14
+
15
+ export { MatSuffixSearchButtonComponent };
@@ -1,8 +1,25 @@
1
- import { AfterViewInit, EventEmitter, OnInit, QueryList } from '@angular/core';
1
+ import * as i0 from '@angular/core';
2
+ import { OnInit, AfterViewInit, EventEmitter, QueryList } from '@angular/core';
2
3
  import { MatMenu } from '@angular/material/menu';
3
- import { BotonMenu } from './menu.interface';
4
- import * as i0 from "@angular/core";
5
- export declare class MenuComponent implements OnInit, AfterViewInit {
4
+
5
+ interface BotonMenu {
6
+ idUnico?: string;
7
+ class?: string;
8
+ icono?: string;
9
+ label?: string;
10
+ soloIcono?: boolean;
11
+ sinCondicion?: boolean;
12
+ badge?: string;
13
+ tooltip?: string;
14
+ idxOpcionCalc?: any;
15
+ subItems?: BotonMenu[];
16
+ datosExtra?: any;
17
+ valorSeleccion?: any;
18
+ esVisible?(dataValid?: any): boolean;
19
+ estaDeshabilitado?(item?: any): boolean;
20
+ }
21
+
22
+ declare class MenuComponent implements OnInit, AfterViewInit {
6
23
  cssBoton?: string;
7
24
  title?: string;
8
25
  disabled: boolean;
@@ -10,6 +27,7 @@ export declare class MenuComponent implements OnInit, AfterViewInit {
10
27
  menu: BotonMenu[];
11
28
  action: EventEmitter<string>;
12
29
  matmenus: QueryList<MatMenu>;
30
+ private readonly cdr;
13
31
  menuItems: string[];
14
32
  yet: boolean;
15
33
  _submenus: BotonMenu[][];
@@ -23,3 +41,6 @@ export declare class MenuComponent implements OnInit, AfterViewInit {
23
41
  static ɵfac: i0.ɵɵFactoryDeclaration<MenuComponent, never>;
24
42
  static ɵcmp: i0.ɵɵComponentDeclaration<MenuComponent, "jvs-menu", never, { "cssBoton": { "alias": "cssBoton"; "required": false; }; "title": { "alias": "title"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "itemSeleccion": { "alias": "itemSeleccion"; "required": false; }; "menu": { "alias": "menu"; "required": false; }; }, { "action": "action"; }, never, ["*"], true, never>;
25
43
  }
44
+
45
+ export { MenuComponent };
46
+ export type { BotonMenu };
@@ -1,11 +1,12 @@
1
+ import * as i0 from '@angular/core';
1
2
  import { OnInit } from '@angular/core';
2
- import * as i0 from "@angular/core";
3
- export interface EstilosBarra {
3
+
4
+ interface EstilosBarra {
4
5
  valorMaximo: number;
5
6
  class?: string;
6
7
  style?: string;
7
8
  }
8
- export declare class ProgressBarComponent implements OnInit {
9
+ declare class ProgressBarComponent implements OnInit {
9
10
  objThis: any;
10
11
  porcentaje: number;
11
12
  textoCentrado: boolean;
@@ -28,3 +29,6 @@ export declare class ProgressBarComponent implements OnInit {
28
29
  static ɵfac: i0.ɵɵFactoryDeclaration<ProgressBarComponent, never>;
29
30
  static ɵcmp: i0.ɵɵComponentDeclaration<ProgressBarComponent, "jvs-progress-bar", never, { "objThis": { "alias": "objThis"; "required": false; }; "porcentaje": { "alias": "porcentaje"; "required": false; }; "textoCentrado": { "alias": "textoCentrado"; "required": false; }; "textoMostrar": { "alias": "textoMostrar"; "required": false; }; "formatoNumero": { "alias": "formatoNumero"; "required": false; }; "coloresValor": { "alias": "coloresValor"; "required": false; }; }, {}, never, never, true, never>;
30
31
  }
32
+
33
+ export { ProgressBarComponent };
34
+ export type { EstilosBarra };