@kaufmann-lab/ui 0.1.16 → 0.1.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.
@@ -0,0 +1,3288 @@
1
+ import * as _angular_core from '@angular/core';
2
+ import { AfterContentInit, TemplateRef, Signal, ElementRef, AfterViewInit } from '@angular/core';
3
+ import { ControlValueAccessor } from '@angular/forms';
4
+ import { SafeResourceUrl } from '@angular/platform-browser';
5
+
6
+ /**
7
+ * Nombre de cada ícono del design system. Página 5 del PDF fija un set de
8
+ * 59; `eye-off` es una extensión propia por fuera de ese set, agregada para
9
+ * el toggle de mostrar/ocultar contraseña de `Input` — no hay un ícono de
10
+ * "ojo tachado" en la spec original porque esa interacción no estaba
11
+ * contemplada ahí.
12
+ *
13
+ * Separado de `Icon.ts` a propósito: este type es el contrato público que
14
+ * comparten `Icon`, `icons/index.ts` (registro) y cualquier componente que
15
+ * reciba un `IconName` (`Button`, `MetricCard`, etc.) — no debería requerir
16
+ * importar el componente `Icon` completo solo para tipar una prop.
17
+ *
18
+ * `minus`, `maximize`, `minimize`, `crosshair` y `navigation` son una
19
+ * extensión propia (mismo criterio que `eye-off`): página 5 del PDF no las
20
+ * incluye, pero los controles flotantes de `kf-map` (zoom, fullscreen,
21
+ * recenter, follow) los necesitan y ninguno tiene un glyph equivalente ya
22
+ * en el set — antes de agregarlos se confirmó que no había forma de resolver
23
+ * esas 5 acciones con un ícono ya existente.
24
+ *
25
+ * `message-circle`, `monitor`, `zap` y `pin` son otra extensión propia, mismo
26
+ * criterio: el selector de canal de entrada de ticket (Llamada/WhatsApp/
27
+ * Portal/API·agente) de `apps/operations` necesita "burbuja de chat",
28
+ * "pantalla" y "rayo" y ninguno tiene glyph equivalente en el set (`phone`
29
+ * ya cubre "Llamada", no hizo falta agregarlo). `pin` es la acción de
30
+ * fijar/soltar un subheader — se confirmó que no alcanza con reusar
31
+ * `map-pin`, que en este mismo dominio representa ubicación geográfica real
32
+ * de vehículos; reusarlo para "fijar" generaría ambigüedad con los markers
33
+ * de mapa.
34
+ */
35
+ type IconName = 'activity' | 'alert-circle' | 'alert-octagon' | 'alert-triangle' | 'award' | 'bar-chart' | 'bell' | 'bus' | 'calculator' | 'calendar' | 'car' | 'cart' | 'check' | 'check-circle' | 'check-square' | 'chevron-down' | 'chevron-left' | 'chevron-left-bar' | 'chevron-right' | 'clipboard' | 'clock' | 'credit-card' | 'crosshair' | 'download' | 'edit' | 'external-link' | 'eye' | 'eye-off' | 'file' | 'filter' | 'gauge' | 'gift' | 'grid' | 'history' | 'home' | 'inbox' | 'layers' | 'list' | 'log-out' | 'mail' | 'map' | 'map-pin' | 'maximize' | 'menu' | 'message-circle' | 'mic' | 'mic-off' | 'minimize' | 'minus' | 'monitor' | 'more-vertical' | 'navigation' | 'pause' | 'phone' | 'pin' | 'play' | 'plus' | 'search' | 'settings' | 'shield-check' | 'sort' | 'star' | 'ticket' | 'tool' | 'trash' | 'truck' | 'upload-cloud' | 'user' | 'user-search' | 'video' | 'x' | 'zap';
36
+
37
+ type IconSize = 'sm' | 'md' | 'lg';
38
+ /** Ángulos de rotación soportados por `rotate` — cubre los casos reales del
39
+ * design system (un chevron que apunta en 4 direcciones posibles según
40
+ * estado, ej. orden ascendente/descendente o un panel abierto/cerrado);
41
+ * no un `number` libre, para no habilitar ángulos arbitrarios sin caso de
42
+ * uso ni animación pensada. */
43
+ type IconRotation = 0 | 90 | 180 | 270;
44
+ /**
45
+ * Ícono de trazo del design system — 71 glyphs (59 de la página 5 + extensiones
46
+ * propias documentadas en `icon-name.ts`), grilla 24×24,
47
+ * grosor de trazo 1.9px. Referencia un sprite SVG embebido (ver
48
+ * `icon-sprite.ts`) vía `<use>`, así que no hay peso de red adicional por
49
+ * cada instancia: el sprite se inyecta al DOM una única vez, la primera
50
+ * vez que se renderiza cualquier `<kf-icon>` de toda la aplicación.
51
+ *
52
+ * El tamaño se controla con `size` (página 6: "el tamaño se controla con la
53
+ * prop size"): `sm` (16px), `md` (20px, default) o `lg` (24px). El color
54
+ * sigue siempre `currentColor` — se hereda del texto del elemento
55
+ * contenedor, nunca se fija en el propio ícono.
56
+ *
57
+ * `rotate` gira el mismo glyph en vez de requerir un ícono aparte por
58
+ * dirección — útil para un chevron que representa un estado con más de una
59
+ * orientación (ej. orden ascendente/descendente de una columna, un panel
60
+ * abierto/cerrado). La rotación transiciona con la misma duración que el
61
+ * resto de las transiciones cortas del design system.
62
+ *
63
+ * <kf-icon name="alert-triangle" size="sm" />
64
+ * <kf-icon name="chevron-down" [rotate]="isOpen() ? 180 : 0" />
65
+ * <kf-button icon="calendar">Reservar hora</kf-button> <!-- ver Button -->
66
+ */
67
+ declare class Icon {
68
+ readonly name: _angular_core.InputSignal<IconName>;
69
+ readonly size: _angular_core.InputSignal<IconSize>;
70
+ readonly rotate: _angular_core.InputSignal<IconRotation>;
71
+ /**
72
+ * Rellena el glyph (`fill: currentColor`) en vez de dejarlo solo de trazo.
73
+ * Pensado para un estado activo/marcado de un ícono usado como toggle (ej.
74
+ * "fijar" un panel) — un cambio de COLOR únicamente puede no distinguirse
75
+ * lo suficiente en marcas cuyo `--kf-color-secondary` queda cerca del color
76
+ * de texto por default; rellenar el área cambia más píxeles y se percibe
77
+ * con más contraste aunque el tono sea similar. No es el default del
78
+ * design system (sigue siendo de trazo, página 6 del PDF) — es opt-in por
79
+ * componente para ese caso puntual.
80
+ */
81
+ readonly filled: _angular_core.InputSignalWithTransform<boolean, unknown>;
82
+ private readonly document;
83
+ protected readonly pixelSize: _angular_core.Signal<string>;
84
+ constructor();
85
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Icon, never>;
86
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Icon, "kf-icon", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "rotate": { "alias": "rotate"; "required": false; "isSignal": true; }; "filled": { "alias": "filled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
87
+ }
88
+
89
+ /**
90
+ * Dos variantes del mismo concepto — acceso rápido a una sección (página
91
+ * 35): "Tile de acceso destacado" (`variant="tile"`, default) es un bloque
92
+ * centrado con ícono grande arriba y título abajo, pensado para una
93
+ * cuadrícula de accesos (ej. "Todos los certificados"). "Fila de documento"
94
+ * (`variant="row"`) es horizontal, con ícono a la izquierda y
95
+ * título+descripción a la derecha, pensada para listas verticales dentro de
96
+ * un `kf-panel` (ej. "Pagos" / "Revisa tu estado de cuenta y realiza pagos.").
97
+ *
98
+ * <kf-action-tile icon="shield-check" title="Todos los certificados" />
99
+ * <kf-action-tile variant="row" icon="download" title="Pagos"
100
+ * description="Revisa tu estado de cuenta y realiza pagos." />
101
+ */
102
+ declare class ActionTile {
103
+ readonly variant: _angular_core.InputSignal<"tile" | "row">;
104
+ readonly icon: _angular_core.InputSignal<IconName>;
105
+ readonly title: _angular_core.InputSignal<string>;
106
+ readonly description: _angular_core.InputSignal<string | undefined>;
107
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ActionTile, never>;
108
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ActionTile, "kf-action-tile", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
109
+ }
110
+
111
+ /**
112
+ * Marca la barra superior como chrome exclusivo de administradores (página
113
+ * 18) — acento ámbar para diferenciar contexto privilegiado del resto del
114
+ * portal. Dos variantes: etiqueta aislada (pill), o `inline` para usarse
115
+ * dentro de la franja de `kf-portal-header` (fondo oscuro, texto ámbar).
116
+ *
117
+ * <kf-admin-badge />
118
+ * <kf-admin-badge inline />
119
+ */
120
+ declare class AdminBadge {
121
+ /** Para usarse dentro de una superficie oscura (ej. la franja de `kf-portal-header`). */
122
+ readonly inline: _angular_core.InputSignalWithTransform<boolean, unknown>;
123
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdminBadge, never>;
124
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AdminBadge, "kf-admin-badge", never, { "inline": { "alias": "inline"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
125
+ }
126
+
127
+ /**
128
+ * Envuelve un `<button>` nativo: mantiene teclado, foco y submit de formulario.
129
+ * Como es un elemento personalizado, ningún atributo ARIA puesto en el host
130
+ * llega al `<button>` interno — por eso `disabled`, `type`, `ariaLabel`,
131
+ * `ariaExpanded` y `ariaPressed` se reenvían a mano.
132
+ *
133
+ * Seis variantes: `primary`, `secondary`, `ghost`, `outline`, `danger`,
134
+ * `surface`. Tres tamaños (`sm`/`md`/`lg`). `icon` agrega un glifo antes del
135
+ * label proyectado; `block` estira el botón a todo el ancho de su contenedor.
136
+ *
137
+ * `surface` es la variante neutra pensada para flotar SOBRE contenido
138
+ * variable (ej. los controles de `kf-map` sobre un mapa que cambia de tema:
139
+ * calles, satélite, oscuro) — fondo sólido de `--kf-color-surface` con
140
+ * sombra, en vez de depender de contraste contra lo que haya debajo (que
141
+ * `ghost`/`outline`, transparentes, no pueden garantizar ahí).
142
+ *
143
+ * `shape="circle"` vuelve el botón cuadrado con esquina `pill` (mismo ancho
144
+ * y alto, sin padding horizontal extra) — pensado para uso solo-ícono
145
+ * (`icon` sin contenido proyectado): combinarlo con un label visible
146
+ * descentra el ícono, no es el caso de uso.
147
+ *
148
+ * `(click)` no se reenvía: burbujea del botón interno al host solo.
149
+ *
150
+ * `loading` reemplaza el contenido proyectado por `kf-spinner` y fuerza
151
+ * `disabled`.
152
+ *
153
+ * Botón solo-ícono (sin label visible): pasar `ariaLabel` en vez de dejar el
154
+ * botón sin nombre accesible.
155
+ *
156
+ * <kf-button (click)="save()">Guardar</kf-button>
157
+ * <kf-button variant="danger" (click)="remove()">Eliminar</kf-button>
158
+ * <kf-button size="sm" icon="external-link" ariaLabel="Expandir" (click)="expand()" />
159
+ * <kf-button type="submit" [loading]="submitting()">Ingresar</kf-button>
160
+ * <kf-button variant="surface" shape="circle" icon="plus" ariaLabel="Acercar" [ariaPressed]="false" />
161
+ */
162
+ declare class Button {
163
+ readonly variant: _angular_core.InputSignal<"primary" | "secondary" | "ghost" | "outline" | "danger" | "surface">;
164
+ readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
165
+ readonly shape: _angular_core.InputSignal<"rect" | "circle">;
166
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
167
+ /** Igual al default nativo: hace submit dentro de un `<form>`. */
168
+ readonly type: _angular_core.InputSignal<"button" | "submit" | "reset">;
169
+ /** Ícono líder, renderizado con `kf-icon` antes del label proyectado. */
170
+ readonly icon: _angular_core.InputSignal<IconName | undefined>;
171
+ /** Estira el botón a todo el ancho de su contenedor. */
172
+ readonly block: _angular_core.InputSignalWithTransform<boolean, unknown>;
173
+ /** Reemplaza el contenido proyectado por `kf-spinner` y fuerza `disabled`. */
174
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
175
+ /** Nombre accesible del botón interno — obligatorio quien no proyecta
176
+ * ningún texto visible (botón solo-ícono), porque el host no lo reenvía. */
177
+ readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
178
+ /** Estado expandido/colapsado para un botón toggle — mismo motivo que
179
+ * `ariaLabel`, el host no reenvía atributos ARIA al `<button>` interno. */
180
+ readonly ariaExpanded: _angular_core.InputSignal<boolean | undefined>;
181
+ /** Estado presionado/no presionado para un botón toggle real (ej. "seguir
182
+ * vehículo" activo/inactivo) — distinto semánticamente de `ariaExpanded`
183
+ * (que es para mostrar/ocultar un panel), mismo motivo de reenvío manual.
184
+ * Con `icon`, presionado (`true`) rellena el glyph (`kf-icon[filled]`) en
185
+ * vez de solo cambiar de color — un toggle solo-ícono necesita esa señal
186
+ * más fuerte para leerse activo, y así ningún consumidor tiene que
187
+ * acordarse de pedirlo aparte. */
188
+ readonly ariaPressed: _angular_core.InputSignal<boolean | undefined>;
189
+ /** `ghost`/`outline`/`surface` no tienen fondo oscuro sólido — el anillo
190
+ * del spinner por defecto ya se lee bien ahí sin variante propia
191
+ * (`surface` es fondo claro con texto oscuro, mismo motivo que `outline`). */
192
+ protected readonly hasSolidFill: _angular_core.Signal<boolean>;
193
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Button, never>;
194
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Button, "kf-button", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "block": { "alias": "block"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaPressed": { "alias": "ariaPressed"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
195
+ }
196
+
197
+ type AlertTone = 'info' | 'ok' | 'warn' | 'error';
198
+ /**
199
+ * Banner contextual que vive dentro del flujo: validaciones, avisos de
200
+ * vencimiento, confirmaciones. Persiste hasta que se descarta o hasta que la
201
+ * condición que lo causó desaparece — para feedback efímero está el toast.
202
+ *
203
+ * `open` es two-way: el botón de cerrar lo pone en `false` y el componente
204
+ * deja de renderizar. El consumidor puede volver a abrirlo poniéndolo en
205
+ * `true` (ej. cuando la validación falla otra vez).
206
+ *
207
+ * <kf-alert tone="warn" title="SOAT por vencer">Vence el 15/08.</kf-alert>
208
+ * <kf-alert tone="ok" [(open)]="saved" dismissible>Pago registrado.</kf-alert>
209
+ */
210
+ declare class Alert {
211
+ readonly tone: _angular_core.InputSignal<AlertTone>;
212
+ /** Línea en negrita arriba del mensaje. Vacío deja solo el contenido proyectado. */
213
+ readonly title: _angular_core.InputSignal<string>;
214
+ readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
215
+ /** Visibilidad, two-way: `[(open)]="hasError"`. */
216
+ readonly open: _angular_core.ModelSignal<boolean>;
217
+ /**
218
+ * `alert` interrumpe al lector de pantalla; se reserva para error/warn.
219
+ * Los avisos informativos se anuncian sin cortar lo que se esté leyendo.
220
+ */
221
+ protected readonly ariaRole: _angular_core.Signal<"alert" | "status">;
222
+ protected readonly toneIcon: _angular_core.Signal<IconName>;
223
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Alert, never>;
224
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Alert, "kf-alert", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
225
+ }
226
+
227
+ type AlertRowTone = 'warn' | 'error';
228
+ /**
229
+ * Fila clickeable de una lista de pendientes/alertas: ícono circular con
230
+ * tono semántico, texto de una línea, chevron al final. Pensada para
231
+ * agrupar varias dentro de un `kf-card` (ej. "Tus pendientes" del
232
+ * dashboard) — no incluye el contenedor en sí.
233
+ *
234
+ * <kf-alert-row icon="file" tone="warn" text="2 cotizaciones esperan tu aprobación" (rowClick)="onNavigate('cotizaciones')" />
235
+ */
236
+ declare class AlertRow {
237
+ readonly icon: _angular_core.InputSignal<IconName>;
238
+ readonly tone: _angular_core.InputSignal<AlertRowTone>;
239
+ readonly text: _angular_core.InputSignal<string>;
240
+ readonly rowClick: _angular_core.OutputEmitterRef<void>;
241
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertRow, never>;
242
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertRow, "kf-alert-row", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "text": { "alias": "text"; "required": true; "isSignal": true; }; }, { "rowClick": "rowClick"; }, never, never, true, never>;
243
+ }
244
+
245
+ /**
246
+ * Avatar de usuario: muestra una foto (`src`) o, si no hay foto, las
247
+ * iniciales (`initials`) sobre un fondo con gradiente de marca. `round`
248
+ * controla la forma: circular (por defecto) o cuadrada con radio.
249
+ *
250
+ * Con `pill`, el avatar se envuelve en una pastilla azul con un chevron a la
251
+ * derecha — la "pill de usuario (header)" de la página 18 del design system,
252
+ * usada en la barra de sesión del Portal Header.
253
+ *
254
+ * <kf-avatar initials="JD" />
255
+ * <kf-avatar src="https://…/foto.jpg" [round]="false" />
256
+ * <kf-avatar initials="TS" pill />
257
+ */
258
+ declare class Avatar {
259
+ readonly initials: _angular_core.InputSignal<string | undefined>;
260
+ readonly src: _angular_core.InputSignal<string | undefined>;
261
+ readonly round: _angular_core.InputSignal<boolean>;
262
+ /** Envuelve el avatar en la pastilla de sesión del header, con chevron. */
263
+ readonly pill: _angular_core.InputSignalWithTransform<boolean, unknown>;
264
+ /** Limita a 2 caracteres para que quepan cómodos dentro del círculo. */
265
+ readonly displayInitials: _angular_core.Signal<string>;
266
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Avatar, never>;
267
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Avatar, "kf-avatar", never, { "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; "round": { "alias": "round"; "required": false; "isSignal": true; }; "pill": { "alias": "pill"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
268
+ }
269
+
270
+ /**
271
+ * Pill chica de fondo suave para un conteo, tag o estado liviano puntual —
272
+ * no un proceso en vivo (para eso, `kf-status-pill`, con borde en vez de
273
+ * relleno). Fondo soft y texto del tono fuerte según `tone`; `service` usa
274
+ * el color base porque `secondary` todavía no tiene variante `-strong`.
275
+ * `variant` es un eje ortogonal a `tone` (mismo patrón que `kf-button`):
276
+ * `soft` (default) es el fondo de color sólido de siempre; `glass` es
277
+ * translúcido con desenfoque, pensado para un badge sobre una superficie
278
+ * de marca (ej. un header navy), no para un banner suelto. En `glass` el
279
+ * punto (`dot`) usa el color BASE de cada tono, no `-strong` — ese último
280
+ * está pensado para texto legible sobre el fondo pastel de `soft` y se ve
281
+ * apagado sobre una superficie translúcida/oscura.
282
+ */
283
+ declare class Badge {
284
+ readonly tone: _angular_core.InputSignal<"neutral" | "ok" | "warn" | "error" | "info" | "service">;
285
+ readonly variant: _angular_core.InputSignal<"soft" | "glass">;
286
+ readonly dot: _angular_core.InputSignalWithTransform<boolean, unknown>;
287
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Badge, never>;
288
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Badge, "kf-badge", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "dot": { "alias": "dot"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
289
+ }
290
+
291
+ interface BreadcrumbItem {
292
+ label: string;
293
+ /** Destino del link. Sin `href` el nivel se rinde como texto plano. */
294
+ href?: string;
295
+ }
296
+ /**
297
+ * Ruta de navegación de las vistas internas. El último nivel es la página
298
+ * actual: nunca es link y lleva `aria-current="page"`, aunque traiga `href`.
299
+ *
300
+ * Se rinde como `<nav><ol>` — es una lista ordenada de ancestros, y eso es lo
301
+ * que los lectores de pantalla anuncian ("navegación, lista de 3 elementos").
302
+ *
303
+ * Para apps con router: escuchar `itemClick` y llamar
304
+ * `event.preventDefault()` antes de `router.navigate(...)`. El `href` se
305
+ * mantiene igual para que click-medio, "abrir en pestaña nueva" y el hover
306
+ * de la barra de estado sigan funcionando.
307
+ *
308
+ * <kf-breadcrumb [items]="[{ label: 'Inicio', href: '/' }, { label: 'Mis vehículos' }]" />
309
+ */
310
+ declare class Breadcrumb {
311
+ readonly items: _angular_core.InputSignal<BreadcrumbItem[]>;
312
+ /**
313
+ * Click en un nivel con `href`. Incluye el `MouseEvent` para que un
314
+ * consumidor con router pueda cortar la navegación nativa. No se depende
315
+ * de `@angular/router` acá — sería un peer dep nuevo en la librería para
316
+ * lo que el consumidor resuelve en una línea.
317
+ */
318
+ readonly itemClick: _angular_core.OutputEmitterRef<{
319
+ item: BreadcrumbItem;
320
+ index: number;
321
+ event: MouseEvent;
322
+ }>;
323
+ protected readonly lastIndex: _angular_core.Signal<number>;
324
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Breadcrumb, never>;
325
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Breadcrumb, "kf-breadcrumb", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
326
+ }
327
+
328
+ /**
329
+ * Una categoría de la barra — el componente no sabe qué significa "pagada"
330
+ * o "vencida", solo dibuja proporciones: `count` decide el ancho relativo
331
+ * del segmento (`flex-grow`) y de la fila de leyenda que lo acompaña.
332
+ * `color` es cualquier valor CSS válido (pensado para tokens `var(--kf-*)`,
333
+ * nunca hex suelto desde el consumidor).
334
+ */
335
+ interface BucketProgressItem {
336
+ key: string;
337
+ label: string;
338
+ count: number;
339
+ color: string;
340
+ }
341
+ /**
342
+ * Barra de progreso segmentada en categorías proporcionales — generaliza
343
+ * el resumen de "Progreso del plan de pagos" de Pagos y Facturas de OTD
344
+ * (cuotas pagadas/vencidas/próximas/pendientes) sin acoplarse a esas 4
345
+ * categorías puntuales: el consumidor pasa sus propios `items` con
346
+ * `{key, label, count, color}`.
347
+ *
348
+ * Los segmentos son proporcionales por CANTIDAD (`flex-grow: count`), no
349
+ * uno por unidad — con 36 cuotas y 6 pagadas, la barra dibuja 2 anchos
350
+ * distintos (pagado ~17% / resto ~83%), nunca 36 rectángulos idénticos
351
+ * (hallazgo real de UX: con volumen alto, un segmento por unidad se vuelve
352
+ * ilegible). Los `items` con `count: 0` no se dibujan (ni segmento ni
353
+ * fila de leyenda) — no tiene sentido mostrar una categoría vacía.
354
+ *
355
+ * La leyenda debajo reproduce el mismo orden y color que la barra, para
356
+ * que una categoría se pueda mapear a su cantidad de un vistazo (pedido
357
+ * explícito de UX: "posicionar correctamente los labels").
358
+ *
359
+ * <kf-bucket-progress
360
+ * title="Progreso del plan de pagos"
361
+ * [summary]="'6 de 30 cuotas pagadas'"
362
+ * [items]="[
363
+ * { key: 'paid', label: 'pagadas', count: 6, color: 'var(--kf-color-success)' },
364
+ * { key: 'overdue', label: 'vencidas', count: 2, color: 'var(--kf-color-error)' },
365
+ * { key: 'upcoming', label: 'próxima', count: 1, color: 'var(--kf-color-warning)' },
366
+ * { key: 'pending', label: 'pendientes', count: 21, color: 'var(--kf-color-gray-200)' },
367
+ * ]"
368
+ * />
369
+ */
370
+ declare class BucketProgress {
371
+ readonly title: _angular_core.InputSignal<string>;
372
+ /** Texto libre a la derecha del título (ej. "6 de 30 cuotas pagadas") —
373
+ * el componente no sabe calcular ese resumen, lo recibe hecho. */
374
+ readonly summary: _angular_core.InputSignal<string>;
375
+ readonly items: _angular_core.InputSignal<BucketProgressItem[]>;
376
+ protected readonly visibleItems: _angular_core.Signal<BucketProgressItem[]>;
377
+ protected readonly total: _angular_core.Signal<number>;
378
+ /** Descripción accesible de la barra completa — un solo `role="img"`
379
+ * con el desglose en texto, en vez de que cada segmento individual
380
+ * compita por foco/lectura de screen reader. */
381
+ protected readonly ariaLabel: _angular_core.Signal<string>;
382
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<BucketProgress, never>;
383
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<BucketProgress, "kf-bucket-progress", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
384
+ }
385
+
386
+ /**
387
+ * Contenedor base con esquinas redondeadas y sombra sutil — la base visual
388
+ * de paneles, tarjetas de métrica, tablas y bloques de contenido de todo el
389
+ * portal (ver página 14 del design system).
390
+ *
391
+ * Piensa este componente como el "cimiento": no impone estructura interna
392
+ * más allá de dos slots opcionales alrededor del contenido libre —
393
+ * `[media]` para una imagen/ícono destacado arriba, y `[actions]` para una
394
+ * fila de botones al pie, separada por una línea. El contenido por defecto
395
+ * (sin selector) queda en el medio, sin ningún layout forzado, para que
396
+ * cualquier composición (una métrica, una lista, un formulario) pueda vivir
397
+ * dentro sin pelear con estilos propios del `Card`.
398
+ *
399
+ * `gap` controla el espacio entre los hijos directos del cuerpo — `md`
400
+ * (default) separa bloques con peso propio (un `kf-section-header`
401
+ * seguido de datos, por ejemplo); `xs`/`sm` para texto corrido o bloques
402
+ * más compactos, `lg`/`xl` para composiciones con más aire entre secciones.
403
+ *
404
+ * <kf-card>
405
+ * <kf-section-header title="Cliente" />
406
+ * <dl>…</dl>
407
+ * </kf-card>
408
+ * <kf-card gap="xs">Texto corrido, sin bloques que separar</kf-card>
409
+ * <kf-card flush>Sin sombra — para superficies ya delimitadas por otra card</kf-card>
410
+ * <kf-card>
411
+ * <img kf-card-media src="..." alt="" />
412
+ * <h3>Título</h3>
413
+ * <p>Descripción</p>
414
+ * <div kf-card-actions>
415
+ * <kf-button variant="ghost">Cancelar</kf-button>
416
+ * <kf-button>Guardar</kf-button>
417
+ * </div>
418
+ * </kf-card>
419
+ */
420
+ declare class Card {
421
+ /** Quita la sombra — para cards anidadas dentro de otra superficie ya elevada. */
422
+ readonly flush: _angular_core.InputSignalWithTransform<boolean, unknown>;
423
+ /** Espacio entre los hijos directos del cuerpo. `md` es el default. */
424
+ readonly gap: _angular_core.InputSignal<"sm" | "md" | "lg" | "xs" | "xl">;
425
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Card, never>;
426
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Card, "kf-card", never, { "flush": { "alias": "flush"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; }, {}, never, ["[kf-card-media]", "*", "[kf-card-actions]"], true, never>;
427
+ }
428
+
429
+ /**
430
+ * Slide individual de un `kf-carousel`. Es un contenedor mínimo: solo existe
431
+ * para que el carrusel pueda detectar, vía `contentChildren`, cuántos slides
432
+ * se proyectaron y en qué orden — el contenido real es responsabilidad total
433
+ * de quien lo consume.
434
+ *
435
+ * <kf-carousel-slide>...</kf-carousel-slide>
436
+ */
437
+ declare class CarouselSlide {
438
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<CarouselSlide, never>;
439
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<CarouselSlide, "kf-carousel-slide", never, {}, {}, never, ["*"], true, never>;
440
+ }
441
+
442
+ /**
443
+ * Carrusel de slides con flechas, dots y autoplay opcional.
444
+ *
445
+ * La spec original de React recibe `slides` como un array de nodos React.
446
+ * En Angular eso no tiene equivalente directo: en vez de forzar un array de
447
+ * datos crudos, cada slide se proyecta como contenido declarativo mediante
448
+ * un `kf-carousel-slide` hijo, y el carrusel los detecta con
449
+ * `contentChildren(CarouselSlide)`. Esto evita depender de un renderer de
450
+ * nodos y deja que cada slide use plantillas Angular normales (bindings,
451
+ * `@if`, `@for`, etc.) tal como se espera en este ecosistema.
452
+ *
453
+ * <kf-carousel [autoplay]="true" [interval]="4000" (indexChange)="onIndex($event)">
454
+ * <kf-carousel-slide>...</kf-carousel-slide>
455
+ * <kf-carousel-slide>...</kf-carousel-slide>
456
+ * </kf-carousel>
457
+ */
458
+ declare class Carousel implements AfterContentInit {
459
+ readonly autoplay: _angular_core.InputSignal<boolean>;
460
+ readonly interval: _angular_core.InputSignalWithTransform<number, unknown>;
461
+ readonly indexChange: _angular_core.OutputEmitterRef<number>;
462
+ readonly slides: _angular_core.Signal<readonly CarouselSlide[]>;
463
+ private readonly activeIndexSignal;
464
+ readonly activeIndex: _angular_core.Signal<number>;
465
+ private readonly destroyRef;
466
+ private timer;
467
+ private autoplayPaused;
468
+ ngAfterContentInit(): void;
469
+ next(): void;
470
+ previous(): void;
471
+ goTo(index: number): void;
472
+ pauseAutoplay(): void;
473
+ resumeAutoplay(): void;
474
+ private startAutoplay;
475
+ private stopAutoplay;
476
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Carousel, never>;
477
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Carousel, "kf-carousel", never, { "autoplay": { "alias": "autoplay"; "required": false; "isSignal": true; }; "interval": { "alias": "interval"; "required": false; "isSignal": true; }; }, { "indexChange": "indexChange"; }, ["slides"], ["*"], true, never>;
478
+ }
479
+
480
+ /**
481
+ * Checkbox accesible con soporte de estado "indeterminate".
482
+ *
483
+ * `indeterminate` no existe como atributo HTML: el navegador solo lo expone
484
+ * como propiedad del elemento nativo, así que se aplica a mano sobre el
485
+ * `<input>` interno vía `viewChild` + `effect` cada vez que cambia el input.
486
+ *
487
+ * Implementa `ControlValueAccessor` para poder usarse con `formControlName` /
488
+ * `ngModel` igual que un checkbox nativo. En ese modo, `writeValue` controla
489
+ * el DOM directamente y el input `checked` (pensado para binding manual sin
490
+ * forms) queda en su valor por defecto — igual que `disabled` combina el
491
+ * input signal con `setDisabledState` en el resto de la librería.
492
+ *
493
+ * `invalid` pinta el recuadro en rojo y setea `aria-invalid` en el `<input>`
494
+ * nativo — mismo mecanismo que `Input.invalid`, para el caso típico de un
495
+ * checkbox obligatorio (ej. "Acepto términos y condiciones") sin marcar.
496
+ *
497
+ * <kf-checkbox label="Aceptar términos" [(checked)]="accepted" />
498
+ * <kf-checkbox label="Seleccionar todo" [indeterminate]="isPartial()" />
499
+ * <kf-checkbox label="Notificaciones" formControlName="notifications" />
500
+ * <kf-checkbox label="Acepto los términos y condiciones" [invalid]="submitted() && !accepted()" />
501
+ */
502
+ declare class Checkbox implements ControlValueAccessor {
503
+ readonly label: _angular_core.InputSignal<string | undefined>;
504
+ readonly checked: _angular_core.InputSignalWithTransform<boolean, unknown>;
505
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
506
+ readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, unknown>;
507
+ /** Recuadro en rojo + aria-invalid — ej. checkbox obligatorio sin marcar. */
508
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
509
+ readonly checkedChange: _angular_core.OutputEmitterRef<boolean>;
510
+ private readonly inputRef;
511
+ /** Callbacks registrados por Forms; no-op hasta que registerOnChange/Touched las reemplacen. */
512
+ private onChangeFn;
513
+ private onTouchedFn;
514
+ constructor();
515
+ onChange(event: Event): void;
516
+ onTouched(): void;
517
+ writeValue(value: boolean): void;
518
+ registerOnChange(fn: (value: boolean) => void): void;
519
+ registerOnTouched(fn: () => void): void;
520
+ setDisabledState?(isDisabled: boolean): void;
521
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Checkbox, never>;
522
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Checkbox, "kf-checkbox", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; }, { "checkedChange": "checkedChange"; }, never, never, true, never>;
523
+ }
524
+
525
+ /**
526
+ * Chip de fondo suave con un punto líder que indica estado. Pensado
527
+ * principalmente para celdas de tabla (estado de fila), pero utilizable
528
+ * en cualquier lugar donde se necesite una etiqueta de estado compacta.
529
+ *
530
+ * <kf-chip tone="warn">Pendiente</kf-chip>
531
+ * <kf-chip tone="ok">Aprobado</kf-chip>
532
+ * <kf-chip [dot]="false">4 Unidades</kf-chip>
533
+ *
534
+ * `dot` (default `true`) oculta el punto cuando el chip muestra un DATO
535
+ * (ej. una cantidad — "4 Unidades") y no un ESTADO — antes forzaba a cada
536
+ * portal a reimplementar el mismo patrón "pill con ícono + texto sin punto
537
+ * de estado" a mano (visto 2-3 veces idéntico en `web-otd-frontend`:
538
+ * `quotes-grid.html`/`quote-detail.html` para el conteo de unidades).
539
+ *
540
+ * Nota: la spec original define la unión de tonos como "ok" | "warn" |
541
+ * "error" | "neutral". Internamente se mapean a los tokens semánticos de
542
+ * projects/ui/src/tokens/base.css: ok -> success, warn -> warning,
543
+ * error -> error, neutral -> surface/border/text-muted (no existe un
544
+ * token "neutral" dedicado en base.css, así que se arma con los tokens
545
+ * de superficie/borde/texto-muted más cercanos).
546
+ */
547
+ declare class Chip {
548
+ readonly tone: _angular_core.InputSignal<"neutral" | "ok" | "warn" | "error">;
549
+ readonly dot: _angular_core.InputSignalWithTransform<boolean, unknown>;
550
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Chip, never>;
551
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Chip, "kf-chip", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "dot": { "alias": "dot"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
552
+ }
553
+
554
+ /**
555
+ * Bloque colapsable genérico: un header clickeable (título + chevron) que
556
+ * expande/colapsa contenido proyectado libre, sin saber nada de lo que hay
557
+ * adentro. Building block para layouts responsive donde un bloque se
558
+ * muestra inline en desktop pero se colapsa en mobile/tablet para ahorrar
559
+ * espacio vertical — el primer caso de uso real es un panel de filtros de
560
+ * tabla que en desktop queda siempre abierto y en mobile arranca cerrado.
561
+ *
562
+ * `expanded` es two-way, mismo patrón que `Drawer.open`: el consumidor
563
+ * decide el estado inicial y puede reaccionar a los cambios, pero el propio
564
+ * click en el header ya alterna el estado sin que el consumidor tenga que
565
+ * cablear un `(click)` manual.
566
+ *
567
+ * <kf-collapsible title="Filtros" [(expanded)]="filtersOpen">
568
+ * ...
569
+ * </kf-collapsible>
570
+ *
571
+ * El ícono chevron es un SVG inline fijo (no una prop `icon` configurable)
572
+ * porque esta librería todavía no tiene un componente `Icon`/sprite
573
+ * compartido — un solo ícono fijo no amerita esperar esa abstracción.
574
+ */
575
+ declare class Collapsible {
576
+ readonly title: _angular_core.InputSignal<string>;
577
+ readonly expanded: _angular_core.ModelSignal<boolean>;
578
+ private readonly instanceId;
579
+ readonly triggerId: string;
580
+ readonly panelId: string;
581
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Collapsible, never>;
582
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Collapsible, "kf-collapsible", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, ["*"], true, never>;
583
+ }
584
+
585
+ /**
586
+ * Popover de "Datos de contacto" de una persona (asesor, ejecutivo — nombre
587
+ * genérico a propósito, sin lógica de negocio de ninguna pantalla concreta
588
+ * adentro). Cada canal (`whatsapp`/`phone`/`email`) se muestra SOLO si
589
+ * viene con dato — nunca los 3 fijos — y si ninguno viene, un estado vacío
590
+ * explícito en vez de un panel a medio llenar. Mismo criterio que ya
591
+ * resolvía `sitio-privado-one-way-frontend` (repo hermano de Chile) para
592
+ * el asesor de taller, ahora como pieza compartida del design system.
593
+ *
594
+ * <kf-contact-popover
595
+ * [name]="advisor.name"
596
+ * [whatsapp]="advisor.whatsapp"
597
+ * [phone]="advisor.phone"
598
+ * [email]="advisor.email"
599
+ * />
600
+ */
601
+ declare class ContactPopover {
602
+ readonly name: _angular_core.InputSignal<string>;
603
+ readonly title: _angular_core.InputSignal<string>;
604
+ readonly whatsapp: _angular_core.InputSignal<string | null>;
605
+ readonly phone: _angular_core.InputSignal<string | null>;
606
+ readonly email: _angular_core.InputSignal<string | null>;
607
+ protected readonly open: _angular_core.WritableSignal<boolean>;
608
+ protected readonly whatsappHref: _angular_core.Signal<string | null>;
609
+ protected readonly phoneHref: _angular_core.Signal<string | null>;
610
+ protected readonly emailHref: _angular_core.Signal<string | null>;
611
+ protected readonly hasContactMethods: _angular_core.Signal<boolean>;
612
+ protected onToggle(): void;
613
+ protected onClose(): void;
614
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContactPopover, never>;
615
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContactPopover, "kf-contact-popover", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "whatsapp": { "alias": "whatsapp"; "required": false; "isSignal": true; }; "phone": { "alias": "phone"; "required": false; "isSignal": true; }; "email": { "alias": "email"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
616
+ }
617
+
618
+ /**
619
+ * Marcador genérico para contenido aún por definir (página 38) — comunica
620
+ * "contenido disponible para uso" sin parecer un error, a diferencia de
621
+ * `kf-empty-state` (que comunica ausencia real de datos del usuario).
622
+ * Pensado para secciones del portal que un negocio todavía no completó.
623
+ *
624
+ * `compact` reduce el tamaño de la imagen placeholder y omite el badge de
625
+ * pie (segunda variante de la página 38, sin la etiqueta "Contenido
626
+ * disponible para uso" al final).
627
+ *
628
+ * <kf-content-slot title="Contenido disponible"
629
+ * description="Espacio reservado para contenido de Divemotor Perú. Disponible para uso." />
630
+ * <kf-content-slot compact icon="star" title="Contenido disponible"
631
+ * description="Espacio reservado para contenido de Divemotor Perú." />
632
+ */
633
+ declare class ContentSlot {
634
+ readonly title: _angular_core.InputSignal<string>;
635
+ readonly description: _angular_core.InputSignal<string | undefined>;
636
+ readonly icon: _angular_core.InputSignal<IconName>;
637
+ readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
638
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContentSlot, never>;
639
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContentSlot, "kf-content-slot", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
640
+ }
641
+
642
+ /** En qué estado está la sección. */
643
+ type ContentStateKind = 'ready' | 'loading' | 'empty' | 'error';
644
+ /** Cómo se dibuja `loading`. Default `'skeleton'`. */
645
+ type ContentStateLoad = 'skeleton' | 'spinner';
646
+ /**
647
+ * Wrapper de los cuatro estados que toda sección tiene: cargando, con datos,
648
+ * vacía y con error. Un componente en vez de tres `@if` sueltos, porque es
649
+ * siempre el mismo slot el que va rotando entre los cuatro.
650
+ *
651
+ * Con `state="ready"` proyecta el contenido real y desaparece; en los otros
652
+ * tres dibuja el placeholder correspondiente y el contenido no se instancia.
653
+ * No inventa visuales propios: `loading` usa `kf-skeleton` (o `kf-spinner` con
654
+ * `load="spinner"`), y `empty`/`error` usan `kf-empty-state`.
655
+ *
656
+ * Las acciones (reintentar, crear) van en el slot `actions` — se ignoran
657
+ * mientras carga, porque no hay nada que reintentar todavía.
658
+ *
659
+ * <kf-content-state [state]="state()" title="No pudimos cargar tus vehículos"
660
+ * subtitle="Revisá tu conexión e intentá de nuevo.">
661
+ * <kf-button actions (click)="retry()">Reintentar</kf-button>
662
+ * <kf-data-table [columns]="cols" [rows]="rows()" />
663
+ * </kf-content-state>
664
+ */
665
+ declare class ContentState {
666
+ readonly state: _angular_core.InputSignal<ContentStateKind>;
667
+ /** Forma del estado de carga: silueta (default) o spinner. */
668
+ readonly load: _angular_core.InputSignal<ContentStateLoad>;
669
+ /** Título de `empty`/`error`. Ignorado mientras carga. */
670
+ readonly title: _angular_core.InputSignal<string>;
671
+ readonly subtitle: _angular_core.InputSignal<string>;
672
+ /** Texto al lado del spinner cuando `load="spinner"`. */
673
+ readonly loadingLabel: _angular_core.InputSignal<string>;
674
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContentState, never>;
675
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContentState, "kf-content-state", never, { "state": { "alias": "state"; "required": true; "isSignal": true; }; "load": { "alias": "load"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "loadingLabel": { "alias": "loadingLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*", "[actions]"], true, never>;
676
+ }
677
+
678
+ type ContentViewerType = 'image' | 'video' | 'pdf';
679
+ /**
680
+ * Visor a pantalla completa para ampliar una pieza de contenido: imagen,
681
+ * video o PDF (`type="pdf"`, renderizado por el visor nativo del navegador).
682
+ * Mismo mecanismo que `kf-modal` (el `<dialog>` nativo resuelve backdrop,
683
+ * atrapado de foco, top-layer y `Escape`), pero sin panel/título/footer:
684
+ * el contenido ocupa toda la pantalla sobre un backdrop oscuro.
685
+ *
686
+ * `src` acepta lo que venga del backend sin que el consumidor tenga que
687
+ * normalizarlo primero: una URL (`http(s)://`), un data URI ya armado
688
+ * (`data:...`), o base64 crudo (se le antepone el prefijo `data:` según
689
+ * `type`, asumiendo JPEG para imagen, MP4 para video y PDF para pdf). Un PDF
690
+ * solo acepta contenido local (`blob:`, data URI o base64), nunca una URL remota.
691
+ *
692
+ * Lo proyectado con el atributo `actions` (p. ej. un botón de descarga) va en
693
+ * la barra superior, junto al título.
694
+ *
695
+ * <kf-content-viewer [(open)]="viewerOpen" [src]="viewerSrc()" alt="Foto del vehículo" />
696
+ * <kf-content-viewer [(open)]="viewerOpen" type="video" [src]="viewerSrc()" title="Inspección" />
697
+ * <kf-content-viewer [(open)]="viewerOpen" type="pdf" [src]="blobUrl()" title="Contrato">
698
+ * <kf-button actions variant="surface" icon="download" (click)="save()">Descargar</kf-button>
699
+ * </kf-content-viewer>
700
+ */
701
+ declare class ContentViewer {
702
+ readonly type: _angular_core.InputSignal<ContentViewerType>;
703
+ /** URL, data URI, o base64 crudo — ver JSDoc de la clase. */
704
+ readonly src: _angular_core.InputSignal<string | null>;
705
+ /** Texto alternativo cuando `type="image"`. */
706
+ readonly alt: _angular_core.InputSignal<string>;
707
+ readonly title: _angular_core.InputSignal<string>;
708
+ /** Visibilidad, two-way: `[(open)]="viewerOpen"`. */
709
+ readonly open: _angular_core.ModelSignal<boolean>;
710
+ /** Permite cerrar con el botón, `Escape` o clic en el backdrop. */
711
+ readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
712
+ protected readonly titleId: string;
713
+ /** Detecta si `src` ya es una URL o un data URI armado; si no, asume
714
+ * base64 crudo y le antepone el prefijo `data:` correspondiente a `type`
715
+ * — el backend a veces manda una cosa, a veces la otra. */
716
+ protected readonly resolvedSrc: _angular_core.Signal<string | null>;
717
+ protected readonly pdfSrc: _angular_core.Signal<SafeResourceUrl | null>;
718
+ protected readonly fallbackLabel: _angular_core.Signal<string>;
719
+ private readonly dialog;
720
+ private readonly document;
721
+ private readonly sanitizer;
722
+ constructor();
723
+ /** `Escape` dispara `cancel`; cancelarlo lo deja abierto. */
724
+ protected onCancel(event: Event): void;
725
+ /**
726
+ * Clic en el backdrop. Un clic en la zona del backdrop tiene como `target` al
727
+ * propio `<dialog>` (el contenido vive en el panel de adentro), así que basta
728
+ * comparar contra él — no hace falta cortar la propagación en el panel.
729
+ */
730
+ protected onHostClick(event: MouseEvent): void;
731
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContentViewer, never>;
732
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContentViewer, "kf-content-viewer", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[actions]"], true, never>;
733
+ }
734
+
735
+ /**
736
+ * Zona que ocupa la columna en la vista de cards. La vista de tabla ignora
737
+ * esto (salvo `media`, que igual se rinde como thumbnail en vez de imprimir
738
+ * la URL):
739
+ * - `media`: thumbnail a la izquierda del encabezado; el valor de la celda se
740
+ * usa como `src` salvo que la columna traiga su `cellTemplates`.
741
+ * - `title`: título del encabezado (ej. la patente/unidad).
742
+ * - `status`: chip/estado al lado del título.
743
+ * - `field` (default): par label/valor en el cuerpo.
744
+ * - `action`: va al pie, separado del cuerpo por una línea.
745
+ */
746
+ type DataTableCardRole = 'media' | 'title' | 'status' | 'field' | 'action';
747
+ interface DataTableColumn {
748
+ key: string;
749
+ label: string;
750
+ right?: boolean;
751
+ className?: string;
752
+ cardRole?: DataTableCardRole;
753
+ /** Habilita ordenar por esta columna clickeando su header (solo vista
754
+ * tabla — en cards no hay header clickeable). Ciclo asc → desc → sin
755
+ * orden, un click a la vez. */
756
+ sortable?: boolean;
757
+ /** Fija la columna a un borde del scroll horizontal — típicamente la
758
+ * primera (identificador) y/o la última (acciones). Columnas `sticky`
759
+ * del mismo lado deben ser consecutivas y estar en ese extremo del
760
+ * array `columns`; el offset de cada una se calcula sumando el ancho
761
+ * real de las que ya quedaron fijas antes, medido en runtime (no hay
762
+ * forma de conocer el ancho de antemano, las columnas son de ancho
763
+ * variable según su contenido). */
764
+ sticky?: 'left' | 'right';
765
+ /** Ancho mínimo forzado — evita que una columna angosta (ej. un chip
766
+ * corto) se comprima más de la cuenta cuando hay poco espacio y otras
767
+ * columnas compiten por él. */
768
+ minWidth?: string;
769
+ }
770
+ /** Vistas disponibles cuando `cardable` está activo. */
771
+ type DataTableView = 'table' | 'cards';
772
+ /** Opciones de "filas por página" estándar del portal — 10 como default
773
+ * cubre bien tanto un dataset chico (ej. Beneficios) como uno con volumen
774
+ * real (ej. 30+ cuotas en Billing), sin sentirse vacío ni insuficiente; 25
775
+ * y 50 escalan ~2.5x cada paso, evitando un salto brusco donde la opción
776
+ * del medio no aporta nada. Cualquier consumidor puede pisar este default
777
+ * con su propio `pageSizeOptions` si su caso lo justifica — pasar `[]`
778
+ * explícitamente desactiva el selector aunque `pageSize` esté activo. */
779
+ declare const DEFAULT_PAGE_SIZE_OPTIONS: number[];
780
+ /** Densidad de fila: `comfortable` (default, el padding actual) o
781
+ * `compact` (menos padding vertical, para tablas con muchas filas donde
782
+ * priorizar cantidad visible sobre aire entre filas). */
783
+ type DataTableDensity = 'comfortable' | 'compact';
784
+ /** `key:direction` — mismo formato que `sort` de `kf-quote-picker`, para
785
+ * que un consumidor que ya conoce ese patrón no aprenda uno nuevo acá. */
786
+ type DataTableSort = `${string}:${'asc' | 'desc'}`;
787
+ /**
788
+ * Tabla estandarizada con soporte opcional de toggle tabla/cards.
789
+ *
790
+ * El "render" custom por columna de la spec original (una función que
791
+ * devuelve JSX) se resuelve acá de dos formas, de la más simple a la más
792
+ * flexible:
793
+ * - `render`: función `(row) => string` para el caso típico de mostrar un
794
+ * valor derivado/formateado de la fila como texto plano.
795
+ * - `cellTemplates`: mapa `key -> TemplateRef` para cuando un consumidor
796
+ * necesita marcado real dentro de una celda (badges, links, botones). Se
797
+ * proyecta con `ngTemplateOutlet` y recibe `{ $implicit: row, index }`.
798
+ * Se eligió esta combinación en vez de content-projection por columna
799
+ * (ng-content con selector) porque las columnas son dinámicas (vienen de
800
+ * `columns()`), y `ngTemplateOutlet` es el mecanismo estándar de Angular
801
+ * para "insertar esta plantilla por cada fila de este array".
802
+ *
803
+ * En la vista de cards, `cardRole` por columna reparte el contenido en zonas
804
+ * — encabezado (thumbnail + título + estado), cuerpo (pares label/valor) y
805
+ * pie separado por una línea para las acciones. Sin `cardRole`, todas las
806
+ * columnas caen en el cuerpo, igual que antes.
807
+ *
808
+ * El toggle tabla/cards es `kf-view-toggle`, componente standalone propio.
809
+ *
810
+ * <kf-data-table [columns]="columns" [rows]="rows" (rowClick)="onRowClick($event)">
811
+ * <kf-empty-state empty>No hay resultados para mostrar.</kf-empty-state>
812
+ * </kf-data-table>
813
+ *
814
+ * <kf-data-table [columns]="columns" [rows]="rows" [cardable]="true" defaultView="cards" />
815
+ *
816
+ * Loading nativo: con `loading` en `true`, la tabla se reemplaza por un
817
+ * placeholder (`kf-skeleton` por celda/card) — mismo número de filas que
818
+ * `pageSize`, o 5 si no hay paginación activa. Ignora `rows()`/el slot
819
+ * `[empty]` mientras dura (no sabemos aún si el resultado real estará
820
+ * vacío), y respeta la vista activa (tabla o cards) para no cambiar el
821
+ * layout de golpe cuando los datos reales lleguen. El toggle tabla/cards y
822
+ * el header de columnas siguen visibles — solo el cuerpo se reemplaza:
823
+ *
824
+ * <kf-data-table [columns]="columns" [rows]="rows()" [loading]="isLoading()">
825
+ * <kf-empty-state empty>No hay resultados para mostrar.</kf-empty-state>
826
+ * </kf-data-table>
827
+ *
828
+ * El slot `[footer]` (página 15: "slot de pie para paginación") va siempre
829
+ * al final, en ambas vistas, separado por una línea — pensado para proyectar
830
+ * `<kf-pagination>`, que sigue siendo un componente independiente.
831
+ *
832
+ * <kf-data-table [columns]="columns" [rows]="rows">
833
+ * <kf-pagination footer [page]="page()" [total]="total()" (pageChange)="page.set($event)" />
834
+ * </kf-data-table>
835
+ *
836
+ * Paginación interna opcional: con `pageSize`, la tabla pagina sola y
837
+ * agrega su propio `kf-pagination` en el footer nativo (el slot
838
+ * `[footer]` proyectado sigue disponible en paralelo). El selector de "N
839
+ * por página" viene activo por defecto con `DEFAULT_PAGE_SIZE_OPTIONS`
840
+ * ([10, 25, 50], estándar del portal) — pasar `pageSizeOptions` propio lo
841
+ * pisa, y pasar `[]` lo desactiva (paginación sin selector). `itemLabel`
842
+ * completa el texto informativo ("1–10 de 42 beneficios").
843
+ *
844
+ * <kf-data-table [columns]="columns" [rows]="rows" [pageSize]="25" itemLabel="beneficios" />
845
+ * <kf-data-table [columns]="columns" [rows]="rows" [pageSize]="25" [pageSizeOptions]="[]" />
846
+ *
847
+ * Ordenamiento por columna: cada `DataTableColumn` con `sortable: true`
848
+ * vuelve su header clickeable, con el mismo formato `key:direction` que
849
+ * usa `sort` de `kf-quote-picker` (two-way manual, no `model()` — el
850
+ * consumidor decide si persiste el valor o lo descarta al desmontar):
851
+ *
852
+ * <kf-data-table [columns]="columns" [rows]="rows" [sort]="sort()" (sortChange)="sort.set($event)" />
853
+ *
854
+ * Columnas fijas: `sticky: 'left' | 'right'` en la columna ancla esa
855
+ * columna a un borde del scroll horizontal — típicamente el identificador
856
+ * (izquierda) y/o las acciones (derecha) en una tabla con muchas columnas.
857
+ *
858
+ * Densidad: `density="compact"` reduce el padding vertical de cada fila,
859
+ * para priorizar cantidad de filas visibles sobre aire entre ellas.
860
+ */
861
+ declare class DataTable<T = unknown> {
862
+ readonly columns: _angular_core.InputSignal<DataTableColumn[]>;
863
+ readonly rows: _angular_core.InputSignal<T[]>;
864
+ /** Placeholder nativo (`kf-skeleton`) mientras los datos reales cargan —
865
+ * ver el doc-comment de la clase para el detalle. */
866
+ readonly loading: _angular_core.InputSignal<boolean>;
867
+ private readonly scrollEl;
868
+ private readonly destroyRef;
869
+ /**
870
+ * `.kf-data-table__scroll` tiene `overflow-x: auto` sin ningún indicador
871
+ * visual — con varias columnas y poco ancho disponible, la tabla se corta
872
+ * en el borde y nada le avisa al usuario que hay más contenido
873
+ * scrolleando. `canScrollLeft`/`canScrollRight` alimentan un fade en cada
874
+ * borde — visible solo cuando de verdad hay algo que revelar de ese lado,
875
+ * así una tabla que entra completa no muestra fades falsos.
876
+ */
877
+ protected readonly canScrollLeft: _angular_core.WritableSignal<boolean>;
878
+ protected readonly canScrollRight: _angular_core.WritableSignal<boolean>;
879
+ constructor();
880
+ private updateScrollState;
881
+ /** Default: índice de la fila dentro de `rows`. */
882
+ readonly rowKey: _angular_core.InputSignal<((row: T, index: number) => string | number) | undefined>;
883
+ /** Sin borde/sombra de card — para tablas anidadas dentro de otra card. */
884
+ readonly flush: _angular_core.InputSignal<boolean>;
885
+ /** Habilita el toggle de vista tabla/cards. */
886
+ readonly cardable: _angular_core.InputSignal<boolean>;
887
+ readonly defaultView: _angular_core.InputSignal<DataTableView>;
888
+ /**
889
+ * Formateo simple de celda como texto: `(row) => string`. Para marcado
890
+ * real (badges, links, botones) usar `cellTemplates`.
891
+ */
892
+ readonly render: _angular_core.InputSignal<((row: T) => string) | undefined>;
893
+ /** Mapa `columnKey -> TemplateRef` para celdas con contenido custom. */
894
+ readonly cellTemplates: _angular_core.InputSignal<Record<string, TemplateRef<{
895
+ $implicit: T;
896
+ index: number;
897
+ }>> | undefined>;
898
+ /** Densidad de fila — ver `DataTableDensity`. */
899
+ readonly density: _angular_core.InputSignal<DataTableDensity>;
900
+ /** Fuerza si la fila entera dispara `rowClick` en la vista de tabla —
901
+ * ver `rowInteractive` para el cálculo automático cuando no se define. */
902
+ readonly rowClickable: _angular_core.InputSignal<boolean | null>;
903
+ readonly rowClick: _angular_core.OutputEmitterRef<{
904
+ row: T;
905
+ index: number;
906
+ }>;
907
+ /**
908
+ * Paginación interna opcional — sin `pageSize`, cero cambio de
909
+ * comportamiento (el consumidor sigue paginando afuera si quiere, vía el
910
+ * slot `[footer]` con su propio `kf-pagination`, como ya hace Billing).
911
+ * Con `pageSize`, la tabla pagina `rows()` sola y agrega su propio
912
+ * `kf-pagination` en el footer nativo — el slot `[footer]` proyectado
913
+ * sigue disponible para cualquier otra cosa que el consumidor quiera
914
+ * agregar ahí (no son mutuamente excluyentes).
915
+ */
916
+ readonly pageSize: _angular_core.InputSignal<number | null>;
917
+ /** Default `DEFAULT_PAGE_SIZE_OPTIONS` ([10, 25, 50], estándar del
918
+ * portal) — pasar `[]` explícitamente desactiva el selector de tamaño
919
+ * aunque `pageSize` esté activo (paginación sin selector). */
920
+ readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
921
+ readonly pageChange: _angular_core.OutputEmitterRef<number>;
922
+ readonly pageSizeChange: _angular_core.OutputEmitterRef<number>;
923
+ /** Nombre de la entidad listada (ej. "beneficios", "facturas"), en
924
+ * plural — se agrega al final del texto informativo de la paginación
925
+ * interna ("1–5 de 7 beneficios"). Sin esto, el texto queda solo con
926
+ * números ("1–5 de 7"): la librería no impone un idioma ni un nombre
927
+ * fijo, cada consumidor decide el suyo. */
928
+ readonly itemLabel: _angular_core.InputSignal<string>;
929
+ protected readonly page: _angular_core.WritableSignal<number>;
930
+ private readonly internalPageSize;
931
+ /** Tamaño de página efectivo: el que el usuario elija en el selector
932
+ * (si `pageSizeOptions` está activo), o el `pageSize` del consumidor. */
933
+ protected readonly effectivePageSize: _angular_core.Signal<number | null>;
934
+ /** Cantidad de filas/cards placeholder mientras `loading` es true — el
935
+ * `pageSize` efectivo si hay paginación activa (así el placeholder ya
936
+ * "adivina" cuántas filas reales van a aparecer, sin salto de layout),
937
+ * o 5 si no hay paginación. */
938
+ protected readonly skeletonRowIndexes: _angular_core.Signal<number[]>;
939
+ protected readonly totalPages: _angular_core.Signal<number>;
940
+ /** Texto informativo del footer de paginación interna ("1–5 de 7
941
+ * beneficios") — se recalcula con cada cambio de página/tamaño/dataset,
942
+ * nunca queda desactualizado tras filtrar o pasar de página. */
943
+ protected readonly paginationSummary: _angular_core.Signal<string>;
944
+ /**
945
+ * Ordenamiento por columna — mismo formato `key:direction` que `sort` de
946
+ * `kf-quote-picker`, para que un consumidor que ya conoce ese patrón no
947
+ * aprenda uno nuevo. Un click en un header `sortable` avanza el ciclo
948
+ * asc → desc → sin orden; clickear otra columna reinicia el ciclo en esa
949
+ * columna nueva.
950
+ */
951
+ readonly sort: _angular_core.InputSignal<`${string}:desc` | `${string}:asc` | null>;
952
+ readonly sortChange: _angular_core.OutputEmitterRef<`${string}:desc` | `${string}:asc` | null>;
953
+ protected readonly sortedRows: _angular_core.Signal<T[]>;
954
+ /** Filas realmente renderizadas: ordenadas y, si `pageSize` está activo,
955
+ * recortadas a la página actual. */
956
+ protected readonly displayedRows: _angular_core.Signal<T[]>;
957
+ protected sortDirectionFor(column: DataTableColumn): 'asc' | 'desc' | null;
958
+ /** Ciclo asc → desc → sin orden, disparado al clickear un header `sortable`. */
959
+ protected toggleSort(column: DataTableColumn): void;
960
+ protected goToPage(target: number): void;
961
+ protected setPageSize(size: number | null): void;
962
+ /** Columnas fijas del lado izquierdo/derecho, con el offset acumulado
963
+ * (medido en runtime, ver `measureStickyOffsets`) para `position: sticky`. */
964
+ protected readonly stickyLeftColumns: _angular_core.Signal<DataTableColumn[]>;
965
+ protected readonly stickyRightColumns: _angular_core.Signal<DataTableColumn[]>;
966
+ protected readonly stickyOffsets: _angular_core.WritableSignal<Map<string, number>>;
967
+ protected stickyStyle(column: DataTableColumn): Record<string, string> | null;
968
+ private readonly internalView;
969
+ /** Vista activa: la elegida por el usuario, o `defaultView` si no tocó el toggle. */
970
+ readonly view: _angular_core.Signal<DataTableView>;
971
+ /** Primera columna de cada rol único; el resto se ignora en el encabezado. */
972
+ readonly cardMediaColumn: _angular_core.Signal<DataTableColumn | undefined>;
973
+ readonly cardTitleColumn: _angular_core.Signal<DataTableColumn | undefined>;
974
+ readonly cardStatusColumns: _angular_core.Signal<DataTableColumn[]>;
975
+ readonly cardActionColumns: _angular_core.Signal<DataTableColumn[]>;
976
+ readonly cardFieldColumns: _angular_core.Signal<DataTableColumn[]>;
977
+ /**
978
+ * La card entera es clickeable solo si no tiene acciones propias: un
979
+ * `role="button"` con botones adentro es inválido y deja el foco ambiguo.
980
+ * Con columnas `action`, la interacción la manejan esos botones.
981
+ */
982
+ readonly cardInteractive: _angular_core.Signal<boolean>;
983
+ /**
984
+ * Mismo criterio que `cardInteractive`, para la vista de tabla: la fila
985
+ * entera dispara `rowClick` solo si no hay una columna `action` que ya
986
+ * resuelva la interacción con su propio botón — sin esto, un click en
987
+ * "Ver detalle" dispararía TAMBIÉN el click de la fila por burbujeo.
988
+ * `rowClickable` fuerza el comportamiento en cualquier sentido si el
989
+ * consumidor lo necesita.
990
+ */
991
+ readonly rowInteractive: _angular_core.Signal<boolean>;
992
+ setView(next: DataTableView): void;
993
+ trackRow(row: T, index: number): string | number;
994
+ cellValue(row: T, column: DataTableColumn): string;
995
+ onRowClick(row: T, index: number): void;
996
+ /**
997
+ * Ancho real de cada columna `sticky` — se mide después de cada render
998
+ * porque el ancho de una columna depende de su contenido, no hay forma
999
+ * de conocerlo de antemano. Cada columna fija toma como offset la suma
1000
+ * de anchos de las columnas fijas del MISMO lado que ya quedaron antes
1001
+ * que ella (así "left" apila de izquierda a derecha, "right" de derecha
1002
+ * a izquierda).
1003
+ */
1004
+ protected measureStickyOffsets(): void;
1005
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DataTable<any>, never>;
1006
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DataTable<any>, "kf-data-table", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "rows": { "alias": "rows"; "required": true; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "rowKey": { "alias": "rowKey"; "required": false; "isSignal": true; }; "flush": { "alias": "flush"; "required": false; "isSignal": true; }; "cardable": { "alias": "cardable"; "required": false; "isSignal": true; }; "defaultView": { "alias": "defaultView"; "required": false; "isSignal": true; }; "render": { "alias": "render"; "required": false; "isSignal": true; }; "cellTemplates": { "alias": "cellTemplates"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "rowClickable": { "alias": "rowClickable"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "itemLabel": { "alias": "itemLabel"; "required": false; "isSignal": true; }; "sort": { "alias": "sort"; "required": false; "isSignal": true; }; }, { "rowClick": "rowClick"; "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; "sortChange": "sortChange"; }, never, ["[empty]", "[footer]"], true, never>;
1007
+ }
1008
+
1009
+ /**
1010
+ * Signal con la vista de `kf-data-table` ('table' | 'cards') derivada de un
1011
+ * breakpoint — mismo criterio que cualquier tabla con muchas columnas: bajo
1012
+ * el ancho dado, la vista de tabla no entra sin scroll horizontal, así que
1013
+ * se fuerza `cards`. Centraliza el patrón `matchMediaSignal` +
1014
+ * `computed<DataTableView>` que cada tabla del portal repetía igual.
1015
+ *
1016
+ * protected readonly tableView = dataTableViewSignal();
1017
+ * // con un breakpoint distinto al default de 900px:
1018
+ * protected readonly tableView = dataTableViewSignal('(max-width: 768px)');
1019
+ */
1020
+ declare function dataTableViewSignal(query?: string): Signal<DataTableView>;
1021
+
1022
+ type DividerOrientation = 'horizontal' | 'vertical';
1023
+ /**
1024
+ * Separador visual simple entre bloques de contenido. `orientation`
1025
+ * controla si es una línea horizontal (para separar secciones apiladas) o
1026
+ * vertical (para separar elementos en una fila, ej. acciones en una toolbar,
1027
+ * o las columnas de metadata en `kf-company-selector`).
1028
+ *
1029
+ * En `vertical`, el divisor necesita una altura del contexto donde vive —
1030
+ * `:host { align-self: stretch }` lo hace ocupar la altura del contenedor
1031
+ * flex/grid padre sin que el consumidor tenga que fijarla a mano. `flex:
1032
+ * none` evita que el propio divisor se achique a 0 dentro de ese contenedor
1033
+ * flex cuando hay contenido hermano compitiendo por espacio.
1034
+ *
1035
+ * <kf-divider />
1036
+ * <kf-divider orientation="vertical" />
1037
+ */
1038
+ declare class Divider {
1039
+ readonly orientation: _angular_core.InputSignal<DividerOrientation>;
1040
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Divider, never>;
1041
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Divider, "kf-divider", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1042
+ }
1043
+
1044
+ /** Color del chip de ícono. Identifica la CLASE de documento de un vistazo
1045
+ * en una lista de nombres de archivo parecidos entre sí. */
1046
+ type DocumentRowTone = 'neutral' | 'ok' | 'warn' | 'error' | 'info';
1047
+ /**
1048
+ * Fila de un documento descargable: chip de ícono coloreado por tipo,
1049
+ * título, metadata y la acción de descarga al final. Sin `href` rinde
1050
+ * `pendingLabel` en vez de un link roto. El contenido proyectado cae entre
1051
+ * la metadata y la acción, como slot para un `kf-badge` de estado.
1052
+ */
1053
+ declare class DocumentRow {
1054
+ readonly icon: _angular_core.InputSignal<IconName>;
1055
+ readonly tone: _angular_core.InputSignal<DocumentRowTone>;
1056
+ /** Qué documento es. El nombre humano del tipo, no el del archivo. */
1057
+ readonly title: _angular_core.InputSignal<string>;
1058
+ /** Línea secundaria — archivo, fecha, tamaño. El consumidor la arma ya
1059
+ * formateada: la librería no decide en qué unidad se lee un tamaño ni en
1060
+ * qué formato una fecha. */
1061
+ readonly meta: _angular_core.InputSignal<string | undefined>;
1062
+ /** Ausente rinde `pendingLabel` en vez del link de descarga. */
1063
+ readonly href: _angular_core.InputSignal<string | undefined>;
1064
+ readonly downloadLabel: _angular_core.InputSignal<string>;
1065
+ /** Qué se dice cuando no hay `href`. */
1066
+ readonly pendingLabel: _angular_core.InputSignal<string>;
1067
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DocumentRow, never>;
1068
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DocumentRow, "kf-document-row", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "meta": { "alias": "meta"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "downloadLabel": { "alias": "downloadLabel"; "required": false; "isSignal": true; }; "pendingLabel": { "alias": "pendingLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1069
+ }
1070
+
1071
+ type DrawerSide = 'left' | 'right';
1072
+ /**
1073
+ * Panel lateral genérico, agnóstico de contenido — no sabe qué es navegación
1074
+ * ni qué es sesión, solo da tres lugares para proyectar contenido
1075
+ * (`[kf-drawer-header]`, default, `[kf-drawer-footer]`) y resuelve lo que
1076
+ * cualquier drawer necesita resolver igual sin importar qué haya adentro:
1077
+ * overlay con blur que cierra al click, `Escape`, atrapado de foco real y
1078
+ * devolución de foco al cerrar.
1079
+ *
1080
+ * `open` es two-way, mismo patrón que `Dropdown`/`Modal`: el consumidor
1081
+ * decide qué dispara la apertura (un botón de hamburguesa, por ejemplo) y
1082
+ * qué hace con el cierre.
1083
+ *
1084
+ * Foco: al abrir, se crea un `FocusTrap` del CDK sobre el panel (la misma
1085
+ * pieza que usa Angular Material para `mat-sidenav`/`mat-dialog`) — Tab y
1086
+ * Shift+Tab ciclan solo entre los elementos focuseables del drawer, sin
1087
+ * escapar al contenido de fondo. Al cerrar, el foco vuelve al elemento que
1088
+ * tenía el foco antes de abrir (guardado en `document.activeElement`), no
1089
+ * se pierde en el `<body>`.
1090
+ *
1091
+ * `[kf-drawer-header]` tiene fondo oscuro propio (`--kf-color-tertiary-deep`),
1092
+ * distinto del body (`--kf-color-white`) — pensado para contener
1093
+ * `kf-drawer-session`, que asume ese fondo y no lo trae él mismo (ver
1094
+ * `DrawerSession.ts`). Si el slot queda vacío, el contenedor colapsa
1095
+ * (`display: none`) y no deja una franja oscura sin contenido.
1096
+ *
1097
+ * <kf-drawer [(open)]="menuOpen" ariaLabel="Menú de navegación">
1098
+ * <div kf-drawer-header>
1099
+ * <kf-drawer-session name="Tomás Soto" email="tomas@kaufmann.com" (logoutClick)="onLogout()" />
1100
+ * </div>
1101
+ * <a href="/">Home</a>
1102
+ * <a href="/vehiculos">Vehículos</a>
1103
+ * </kf-drawer>
1104
+ */
1105
+ declare class Drawer {
1106
+ /** Visibilidad del panel, two-way: `[(open)]="menuOpen"`. */
1107
+ readonly open: _angular_core.ModelSignal<boolean>;
1108
+ /** Borde de anclaje del panel. `left` (default) es la convención dominante
1109
+ * (Material/iOS/Android): el botón que abre el drawer y el propio panel
1110
+ * quedan del mismo lado. */
1111
+ readonly side: _angular_core.InputSignal<DrawerSide>;
1112
+ /** `aria-label` del `<nav>` interno — describe el propósito del panel para
1113
+ * lectores de pantalla (ej. "Menú de navegación"). */
1114
+ readonly ariaLabel: _angular_core.InputSignal<string>;
1115
+ private readonly panelRef;
1116
+ private readonly focusTrapFactory;
1117
+ private readonly document;
1118
+ private focusTrap;
1119
+ private lastFocusedElement;
1120
+ constructor();
1121
+ /** Cierra el drawer con Escape — mismo patrón que `Dropdown`/`Modal`. */
1122
+ protected onEscape(): void;
1123
+ private getOrCreateFocusTrap;
1124
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Drawer, never>;
1125
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Drawer, "kf-drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "side": { "alias": "side"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[kf-drawer-header]", "*", "[kf-drawer-footer]"], true, never>;
1126
+ }
1127
+
1128
+ /**
1129
+ * Menú de acciones flotante, conectado a un elemento disparador vía
1130
+ * `@angular/cdk/overlay` — la misma pieza que usa Angular Material para
1131
+ * `mat-menu`/`mat-select`. El disparador real puede vivir en OTRO
1132
+ * componente por completo (ej. el avatar dentro de `kf-portal-header`), y
1133
+ * el panel aparece pegado a ESE elemento sin importar dónde el consumidor
1134
+ * ubique al `Dropdown` en su HTML.
1135
+ *
1136
+ * `open` es two-way: el consumidor decide qué dispara la apertura —
1137
+ * `Dropdown` en sí no renderiza ningún trigger, su propio host es el punto
1138
+ * de anclaje visual del panel.
1139
+ *
1140
+ * <kf-dropdown [(open)]="menuOpen"><kf-dropdown-panel>...</kf-dropdown-panel></kf-dropdown>
1141
+ */
1142
+ declare class Dropdown {
1143
+ /** Visibilidad del panel, two-way: `[(open)]="menuOpen"`. */
1144
+ readonly open: _angular_core.ModelSignal<boolean>;
1145
+ /**
1146
+ * Elemento al que se conecta el overlay, si es distinto del propio host
1147
+ * de `Dropdown`. Sin esto, `Dropdown` asume que ÉL MISMO es el
1148
+ * disparador. Útil cuando el disparador real vive dentro de OTRO
1149
+ * componente que no se puede envolver sin ensanchar el área de click
1150
+ * (ej. el avatar de sesión dentro de `PortalHeader`).
1151
+ */
1152
+ readonly anchor: _angular_core.InputSignal<ElementRef<HTMLElement> | undefined>;
1153
+ private readonly panel;
1154
+ private readonly overlayService;
1155
+ private readonly host;
1156
+ private readonly viewContainerRef;
1157
+ private readonly destroyRef;
1158
+ private overlayRef;
1159
+ /**
1160
+ * Suscripciones a `outsidePointerEvents()`/`keydownEvents()` del overlay
1161
+ * ACTUALMENTE adjunto. `getOrCreateOverlayRef()` reutiliza el mismo
1162
+ * `overlayRef` entre aperturas (no lo recrea cada vez), así que se
1163
+ * cancelan explícitamente en `detach()` antes de la siguiente `attach()`
1164
+ * — de lo contrario se acumularían N suscripciones activas sobre el
1165
+ * mismo overlay persistente.
1166
+ */
1167
+ private overlaySubscription;
1168
+ constructor();
1169
+ /**
1170
+ * Respaldo de `overlayRef.keydownEvents()`: ese observable del CDK solo
1171
+ * ve teclas con el foco DENTRO del panel. Si el foco queda en el botón
1172
+ * disparador (caso común), `keydownEvents()` nunca dispara — este
1173
+ * listener a nivel de documento cubre ese caso.
1174
+ */
1175
+ onDocumentEscape(): void;
1176
+ private attach;
1177
+ /**
1178
+ * El trigger real (el `anchor`, o el propio host si no se pasó ninguno —
1179
+ * ver comentario de la clase) vive FUERA del overlay a propósito: el
1180
+ * overlay recién se crea/adjunta cuando `open` pasa a `true`, así que el
1181
+ * CDK no tiene forma de saber que ese elemento externo "es parte" de su
1182
+ * disparador. Sin este filtro, el mismo `pointerdown` que abre el menú
1183
+ * también llega a `outsidePointerEvents()`, cerrando el panel en el
1184
+ * mismo gesto que lo abrió.
1185
+ */
1186
+ private isEventOnTrigger;
1187
+ private detach;
1188
+ private getOrCreateOverlayRef;
1189
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Dropdown, never>;
1190
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Dropdown, "kf-dropdown", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "anchor": { "alias": "anchor"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, ["panel"], ["*"], true, never>;
1191
+ }
1192
+
1193
+ type DropdownItemTone = 'neutral' | 'error';
1194
+ /**
1195
+ * Ítem de acción dentro de un `kf-dropdown-panel`. Es un `<button>` nativo
1196
+ * (no un `<a>`): dispara comportamiento en la pantalla actual, no navega.
1197
+ *
1198
+ * `icon` es opcional — sin él, el ítem es solo texto.
1199
+ *
1200
+ * <kf-dropdown-item icon="log-out" (click)="onLogout()" tone="error">Cerrar sesión</kf-dropdown-item>
1201
+ */
1202
+ declare class DropdownItem {
1203
+ readonly tone: _angular_core.InputSignal<DropdownItemTone>;
1204
+ /** Ícono opcional al inicio de la fila. */
1205
+ readonly icon: _angular_core.InputSignal<IconName | undefined>;
1206
+ /**
1207
+ * Deshabilita el ítem (ej. una acción cuyo endpoint todavía no existe,
1208
+ * caso real de "Factura" en `kf-row-actions` de Taller). Default `false`
1209
+ * a propósito — ningún consumidor existente (ej. el menú de sesión del
1210
+ * Shell) pasa esta prop hoy, así que no cambia su comportamiento.
1211
+ */
1212
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1213
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DropdownItem, never>;
1214
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DropdownItem, "kf-dropdown-item", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1215
+ }
1216
+
1217
+ type DropdownPanelVariant = 'solid' | 'dark';
1218
+ /**
1219
+ * Contenido del panel flotante de un `kf-dropdown`. Es solo una plantilla
1220
+ * (`<ng-template>`, capturada vía `TemplateRef`) — `Dropdown` la conecta al
1221
+ * overlay real cuando `open` pasa a `true`, no la renderiza en su propio
1222
+ * lugar del DOM. Esto permite que el panel aparezca pegado al host de
1223
+ * `Dropdown` sin importar dónde esté ese host en la página.
1224
+ *
1225
+ * `variant`: `'solid'` (default, fondo blanco) o `'dark'` (fondo sólido
1226
+ * oscuro, mismo tono que `[kf-drawer-header]`) para cuando el trigger vive
1227
+ * sobre una superficie oscura de marca.
1228
+ *
1229
+ * `dark` es sólida a propósito, no semitransparente: el CDK Overlay
1230
+ * reposiciona el panel según dónde entra en el viewport y puede terminar
1231
+ * cayendo sobre fondo blanco en vez de sobre el rail oscuro — un color
1232
+ * sólido se ve intencional sin importar dónde lo posicione el CDK.
1233
+ */
1234
+ declare class DropdownPanel {
1235
+ readonly variant: _angular_core.InputSignal<DropdownPanelVariant>;
1236
+ readonly templateRef: _angular_core.Signal<TemplateRef<any>>;
1237
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DropdownPanel, never>;
1238
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DropdownPanel, "kf-dropdown-panel", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1239
+ }
1240
+
1241
+ /**
1242
+ * Placeholder para una sección sin contenido. Dos tonos, con anatomía
1243
+ * distinta (páginas 27-28 del design system, que los trata como piezas
1244
+ * separadas — "Error State" no es una variante de color de "Empty State",
1245
+ * es un estado semánticamente distinto):
1246
+ *
1247
+ * - `neutral` (default): "cero resultados" — cuadro con borde punteado
1248
+ * discreto, para listas vacías o búsquedas sin coincidencias. No es un
1249
+ * error, es la ausencia normal de datos.
1250
+ * - `error`: fallo real de carga — sin borde punteado, con un ícono de
1251
+ * alerta más prominente y texto en el tono de error. Pensado para usarse
1252
+ * junto a un botón "Reintentar" en el slot por defecto.
1253
+ *
1254
+ * <kf-empty-state>No se encontraron resultados.</kf-empty-state>
1255
+ * <kf-empty-state icon="search">Sin coincidencias para tu búsqueda.</kf-empty-state>
1256
+ * <kf-empty-state tone="error" icon="alert-triangle">
1257
+ * No pudimos cargar tus vehículos
1258
+ * <kf-button (click)="retry()">Reintentar</kf-button>
1259
+ * </kf-empty-state>
1260
+ */
1261
+ declare class EmptyState {
1262
+ readonly icon: _angular_core.InputSignal<IconName | undefined>;
1263
+ /** `neutral` (default): cero resultados. `error`: fallo real de carga. */
1264
+ readonly tone: _angular_core.InputSignal<"neutral" | "error">;
1265
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<EmptyState, never>;
1266
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<EmptyState, "kf-empty-state", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1267
+ }
1268
+
1269
+ /** Color del marcador. Distingue la CLASE de evento de un vistazo en un log
1270
+ * largo — no es un estado de progreso. */
1271
+ type EventTimelineTone = 'neutral' | 'primary' | 'ok' | 'warn' | 'error' | 'info';
1272
+ /** Un evento ya ocurrido. Los tres campos de texto son los tres niveles de
1273
+ * lectura: qué pasó, por qué, y cuándo/quién. */
1274
+ interface EventTimelineItem {
1275
+ /** Clave de `track`. */
1276
+ readonly id: string;
1277
+ readonly title: string;
1278
+ readonly detail?: string | null;
1279
+ /** Hora y autor, ya formateados por el consumidor. */
1280
+ readonly meta?: string | null;
1281
+ readonly icon?: IconName;
1282
+ readonly tone?: EventTimelineTone;
1283
+ }
1284
+ /**
1285
+ * Línea de tiempo de AUDITORÍA: eventos ya ocurridos, en orden, cada uno con
1286
+ * marcador coloreado por CLASE y tres niveles de texto (titular, detalle,
1287
+ * hora + autor). Distinto de `kf-journey-stepper` (de PROGRESO, con pasos
1288
+ * futuros conocidos de antemano): acá todo ya pasó.
1289
+ */
1290
+ declare class EventTimeline {
1291
+ readonly items: _angular_core.InputSignal<readonly EventTimelineItem[]>;
1292
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<EventTimeline, never>;
1293
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<EventTimeline, "kf-event-timeline", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
1294
+ }
1295
+
1296
+ /**
1297
+ * Bloque promocional sobre fondo oscuro de marca (página 37) — campañas,
1298
+ * accesos directos o el portal de autoatención. Usa `--kf-color-tertiary-deep`
1299
+ * como base del degradado, el mismo azul profundo que el slide destacado de
1300
+ * `kf-carousel` y la barra de `kf-portal-header`.
1301
+ *
1302
+ * <kf-feature-card badge="Autoatención" badgeIcon="tool" title="Portal de Autoatención"
1303
+ * description="Con tu patente o VIN accede a soluciones para tu vehículo: mantenciones, repuestos y conectividad en un solo lugar."
1304
+ * actionLabel="Ir al portal" actionHref="/autoatencion" />
1305
+ */
1306
+ declare class FeatureCard {
1307
+ readonly badge: _angular_core.InputSignal<string | undefined>;
1308
+ readonly badgeIcon: _angular_core.InputSignal<IconName | undefined>;
1309
+ readonly title: _angular_core.InputSignal<string>;
1310
+ readonly description: _angular_core.InputSignal<string | undefined>;
1311
+ readonly actionLabel: _angular_core.InputSignal<string | undefined>;
1312
+ readonly actionHref: _angular_core.InputSignal<string | undefined>;
1313
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FeatureCard, never>;
1314
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FeatureCard, "kf-feature-card", never, { "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "badgeIcon": { "alias": "badgeIcon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "actionLabel": { "alias": "actionLabel"; "required": false; "isSignal": true; }; "actionHref": { "alias": "actionHref"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1315
+ }
1316
+
1317
+ /**
1318
+ * Chip de solo-lectura inline (label/valor) dentro de una caja bordeada.
1319
+ * Se usa en barras de filtro y filas de resumen para mostrar información,
1320
+ * NO para entrada de datos — para eso existe `Input`.
1321
+ *
1322
+ * El valor admite dos formas, igual que en el design system de referencia:
1323
+ * - `value` (string): caso simple, ej. `[value]="'Jul 2026'"`.
1324
+ * - contenido proyectado (`<ng-content>`): cuando se necesita algo más rico
1325
+ * que un string (un badge, texto con formato, etc.).
1326
+ * `value` tiene prioridad cuando está definido; si no se pasa `value`, se
1327
+ * renderiza el contenido proyectado y, si tampoco hay contenido, `placeholder`.
1328
+ *
1329
+ * <kf-field icon="calendar" label="Periodo" value="Jul 2026" [select]="true" />
1330
+ * <kf-field label="Sucursal"><strong>Casa Central</strong></kf-field>
1331
+ */
1332
+ declare class Field {
1333
+ readonly label: _angular_core.InputSignal<string | undefined>;
1334
+ readonly value: _angular_core.InputSignal<string | undefined>;
1335
+ readonly icon: _angular_core.InputSignal<IconName | undefined>;
1336
+ readonly placeholder: _angular_core.InputSignal<string | undefined>;
1337
+ readonly select: _angular_core.InputSignalWithTransform<boolean, unknown>;
1338
+ /** Estilos inline opcionales aplicados directamente al host. */
1339
+ readonly style: _angular_core.InputSignal<string | undefined>;
1340
+ /**
1341
+ * El placeholder solo tiene sentido cuando no hay `value` ni contenido
1342
+ * proyectado. Angular no expone de forma simple si `<ng-content>` recibió
1343
+ * hijos reales, así que la regla adoptada es puramente declarativa: se
1344
+ * muestra el placeholder cuando hay texto de placeholder y no hay `value`
1345
+ * (ver comentario de clase sobre la prioridad value > proyectado > placeholder).
1346
+ */
1347
+ protected isPlaceholderVisible(): boolean;
1348
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Field, never>;
1349
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Field, "kf-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "select": { "alias": "select"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1350
+ }
1351
+
1352
+ /**
1353
+ * Label superior compartido por todos los campos de formulario del design
1354
+ * system (páginas 11-12: Text Field, Select, Multiselect) — uppercase,
1355
+ * chico, gris, con letter-spacing amplio. El PDF fija un único tratamiento
1356
+ * ("PATENTE O VIN", "SUCURSAL", "SUCURSALES" usan exactamente el mismo
1357
+ * estilo), así que este componente es la única fuente de verdad: antes vivía
1358
+ * copiado por separado en `Input`, `Select`, `SelectMenu` y `MultiSelect`,
1359
+ * y dos de esas copias ya habían divergido del estilo real del PDF.
1360
+ *
1361
+ * No reemplaza al `<label>` nativo — lo envuelve, para no perder la
1362
+ * asociación de accesibilidad `for`/`id` con el control real.
1363
+ *
1364
+ * `required` agrega un asterisco visual en el tono de error, separado del
1365
+ * texto por un espacio y marcado `aria-hidden` — el estado obligatorio real
1366
+ * para lectores de pantalla lo comunica el propio control (`aria-required`
1367
+ * / `required` en el `<input>`/`<select>` asociado), no este label.
1368
+ *
1369
+ * <kf-field-label [for]="inputId">Patente o VIN</kf-field-label>
1370
+ * <kf-field-label [for]="inputId" required>Correo electrónico</kf-field-label>
1371
+ */
1372
+ declare class FieldLabel {
1373
+ /** `id` del control asociado — se refleja como `for` en el `<label>` interno. */
1374
+ readonly for: _angular_core.InputSignal<string | undefined>;
1375
+ /** Muestra un asterisco visual indicando que el campo es obligatorio. */
1376
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1377
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldLabel, never>;
1378
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldLabel, "kf-field-label", never, { "for": { "alias": "for"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1379
+ }
1380
+
1381
+ interface MultiSelectOption {
1382
+ value: string;
1383
+ label: string;
1384
+ }
1385
+ /**
1386
+ * Dropdown de selección múltiple con checkboxes internos. El panel flotante
1387
+ * se conecta al trigger vía `@angular/cdk/overlay` — el mismo mecanismo que
1388
+ * `Select` (ver `../select/Select.ts`) y `Dropdown` (`../dropdown/Dropdown.ts`).
1389
+ *
1390
+ * A diferencia de `Select`, el disparador no muestra un único valor sino los
1391
+ * nombres seleccionados junto a un badge circular con el conteo, y cada
1392
+ * opción del panel se marca/desmarca con un checkbox sin cerrar el panel.
1393
+ * Incluye una opción "Todas" al inicio de la lista, con estado
1394
+ * `indeterminate` cuando hay selección parcial — el mismo patrón de
1395
+ * "seleccionar todos" de `Checkbox`. "Todas" nunca se filtra por el buscador:
1396
+ * queda siempre visible y sigue actuando sobre el universo COMPLETO de
1397
+ * `options()`, no sobre el subconjunto filtrado (ver JSDoc de `toggleAll()`).
1398
+ *
1399
+ * <kf-multi-select
1400
+ * label="Sucursales"
1401
+ * [options]="branches"
1402
+ * [values]="selectedBranches()"
1403
+ * (valuesChange)="selectedBranches.set($event)"
1404
+ * />
1405
+ *
1406
+ * `width="full"` ocupa el 100% del contenedor — para multi-selects dentro
1407
+ * de layouts flex/grid donde el ancho fijo de `md` no encaja.
1408
+ *
1409
+ * <kf-multi-select width="full" [options]="branches" [values]="selectedBranches()" (valuesChange)="..." />
1410
+ */
1411
+ declare class MultiSelect {
1412
+ readonly label: _angular_core.InputSignal<string | undefined>;
1413
+ readonly options: _angular_core.InputSignal<MultiSelectOption[]>;
1414
+ readonly values: _angular_core.InputSignal<string[]>;
1415
+ readonly placeholder: _angular_core.InputSignal<string>;
1416
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1417
+ /**
1418
+ * Ancho del control. 'md' (240px) es el default histórico y preserva el
1419
+ * comportamiento actual sin cambios para consumidores existentes.
1420
+ * 'full' ocupa el 100% del contenedor — para multi-selects dentro de
1421
+ * layouts flex/grid donde el ancho fijo no encaja (ej. un footer de
1422
+ * sidebar).
1423
+ */
1424
+ readonly width: _angular_core.InputSignal<"sm" | "md" | "lg" | "full">;
1425
+ /**
1426
+ * Tri-state: si el consumidor no lo especifica (`undefined`), el buscador
1427
+ * se activa solo cuando `options().length` supera `searchThreshold()`. Si
1428
+ * el consumidor define `true`/`false` explícitamente, ese valor manda por
1429
+ * sobre el umbral automático. Mismo criterio que `Select`.
1430
+ */
1431
+ readonly searchable: _angular_core.InputSignal<boolean | undefined>;
1432
+ readonly searchThreshold: _angular_core.InputSignal<number>;
1433
+ readonly valuesChange: _angular_core.OutputEmitterRef<string[]>;
1434
+ private readonly instanceId;
1435
+ readonly triggerId: string;
1436
+ readonly listboxId: string;
1437
+ readonly isOpen: _angular_core.WritableSignal<boolean>;
1438
+ readonly searchQuery: _angular_core.WritableSignal<string>;
1439
+ readonly activeIndex: _angular_core.WritableSignal<number>;
1440
+ readonly selectedCount: _angular_core.Signal<number>;
1441
+ readonly allSelected: _angular_core.Signal<boolean>;
1442
+ readonly isPartiallySelected: _angular_core.Signal<boolean>;
1443
+ readonly showSearch: _angular_core.Signal<boolean>;
1444
+ /** Opciones visibles tras aplicar el filtro de búsqueda ("Todas" nunca se filtra). */
1445
+ readonly filteredOptions: _angular_core.Signal<MultiSelectOption[]>;
1446
+ /**
1447
+ * Texto del disparador: placeholder si no hay selección, o los nombres
1448
+ * seleccionados unidos por coma (el conteo va aparte, en el badge). Con
1449
+ * muchas opciones el `text-overflow: ellipsis` del `.kf-multi-select__value`
1450
+ * corta el texto — el badge de conteo siempre queda visible al lado.
1451
+ */
1452
+ readonly summaryText: _angular_core.Signal<string>;
1453
+ private readonly triggerRef;
1454
+ private readonly panelTemplate;
1455
+ private readonly searchInputRef;
1456
+ private readonly overlay;
1457
+ constructor();
1458
+ isSelected(value: string): boolean;
1459
+ toggle(): void;
1460
+ toggleOption(value: string): void;
1461
+ /**
1462
+ * Alterna entre "todas seleccionadas" y "ninguna seleccionada". Actúa
1463
+ * siempre sobre el universo COMPLETO de `options()`, no sobre
1464
+ * `filteredOptions()` — con un buscador activo, "Todas" no se filtra ni
1465
+ * cambia de significado: seguir marcando/desmarcando únicamente lo visible
1466
+ * sería sorprendente para quien ya tenía otras opciones (no visibles en el
1467
+ * filtro actual) seleccionadas de antes.
1468
+ */
1469
+ toggleAll(): void;
1470
+ onSearchInput(event: Event): void;
1471
+ /** Mueve `activeIndex` sobre las opciones YA FILTRADAS visibles. Clamp simple, sin wraparound. */
1472
+ moveActive(delta: number): void;
1473
+ toggleActive(): void;
1474
+ onEscape(): void;
1475
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelect, never>;
1476
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelect, "kf-multi-select", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "searchThreshold": { "alias": "searchThreshold"; "required": false; "isSignal": true; }; }, { "valuesChange": "valuesChange"; }, never, never, true, never>;
1477
+ }
1478
+
1479
+ type FilterFieldType = 'select' | 'multi-select' | 'search';
1480
+ interface FilterFieldConfig {
1481
+ key: string;
1482
+ type: FilterFieldType;
1483
+ label?: string;
1484
+ placeholder?: string;
1485
+ width?: string;
1486
+ icon?: IconName;
1487
+ showDivider?: boolean;
1488
+ }
1489
+ type FilterValue = string | string[];
1490
+ interface FilterFieldChange {
1491
+ key: string;
1492
+ value: FilterValue;
1493
+ }
1494
+ /**
1495
+ * Fila de filtros config-driven (select / multi-select / búsqueda) para el
1496
+ * header de una tabla, compuesta con piezas YA existentes de la librería
1497
+ * (`kf-select`, `kf-multi-select`, `kf-input`, `kf-divider`, `kf-collapsible`).
1498
+ *
1499
+ * No tiene lógica de filtrado propia: solo renderiza los controles descritos
1500
+ * por `fields()` y emite `fieldChange` cuando alguno cambia — filtrar filas
1501
+ * sigue siendo responsabilidad de quien lo consume.
1502
+ *
1503
+ * En escritorio los campos se muestran en una fila; en mobile/tablet
1504
+ * (≤768px, mismo breakpoint que `kf-portal-header`) se colapsan dentro de un
1505
+ * `kf-collapsible`.
1506
+ *
1507
+ * <kf-filter
1508
+ * [fields]="[
1509
+ * { key: 'model', type: 'multi-select', label: 'Modelo', placeholder: 'Todos los modelos', showDivider: true },
1510
+ * { key: 'search', type: 'search', label: 'Buscar vehículo', placeholder: 'Ingresa N° de orden o placa', width: '280px' },
1511
+ * ]"
1512
+ * [values]="{ model: selectedModels(), search: searchTerm() }"
1513
+ * [options]="{ model: modelOptions() }"
1514
+ * (fieldChange)="onFieldChange($event)"
1515
+ * />
1516
+ */
1517
+ declare class Filter {
1518
+ readonly fields: _angular_core.InputSignal<FilterFieldConfig[]>;
1519
+ readonly values: _angular_core.InputSignal<Record<string, FilterValue>>;
1520
+ readonly options: _angular_core.InputSignal<Record<string, string[]>>;
1521
+ readonly mobileTitle: _angular_core.InputSignal<string>;
1522
+ readonly fieldChange: _angular_core.OutputEmitterRef<FilterFieldChange>;
1523
+ protected readonly multiOptionsByKey: _angular_core.Signal<Record<string, MultiSelectOption[]>>;
1524
+ protected singleValueFor(key: string): string;
1525
+ protected multiValueFor(key: string): string[];
1526
+ protected fieldWidth(field: FilterFieldConfig): string;
1527
+ protected optionsFor(key: string): string[];
1528
+ protected multiOptionsFor(key: string): MultiSelectOption[];
1529
+ protected onFieldChange(key: string, value: FilterValue): void;
1530
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Filter, never>;
1531
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Filter, "kf-filter", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "mobileTitle": { "alias": "mobileTitle"; "required": false; "isSignal": true; }; }, { "fieldChange": "fieldChange"; }, never, never, true, never>;
1532
+ }
1533
+
1534
+ /** Forma normalizada interna de cada opción, ya resuelta a value/label. */
1535
+ interface FilterChipOption {
1536
+ value: string;
1537
+ label: string;
1538
+ }
1539
+ /**
1540
+ * Fila de chips tipo "pill" para filtros de una sola selección.
1541
+ *
1542
+ * Cada opción puede pasarse como string simple (se usa como value y label
1543
+ * a la vez) o como objeto { value, label } cuando el texto mostrado difiere
1544
+ * del valor interno.
1545
+ *
1546
+ * El chip activo se resalta con `--kf-color-primary` — mismo color de marca
1547
+ * que `kf-tabs`/`kf-select` para su propio estado activo, así el filtro
1548
+ * seleccionado se lee con el color del tema activo, no un negro fijo que
1549
+ * no cambia entre marcas.
1550
+ *
1551
+ * <kf-filter-chips [options]="['Todos', 'Activos', 'Archivados']"
1552
+ * [value]="filtro"
1553
+ * (valueChange)="filtro = $event" />
1554
+ *
1555
+ * <kf-filter-chips [options]="[{ value: 'all', label: 'Todos' }]"
1556
+ * [value]="filtro"
1557
+ * (valueChange)="filtro = $event" />
1558
+ */
1559
+ declare class FilterChips {
1560
+ readonly options: _angular_core.InputSignal<(string | {
1561
+ value: string;
1562
+ label: string;
1563
+ })[]>;
1564
+ readonly value: _angular_core.InputSignal<string>;
1565
+ readonly valueChange: _angular_core.OutputEmitterRef<string>;
1566
+ /** Normaliza cada opción string/objeto a la forma { value, label }. */
1567
+ readonly normalizedOptions: _angular_core.Signal<FilterChipOption[]>;
1568
+ select(value: string): void;
1569
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterChips, never>;
1570
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterChips, "kf-filter-chips", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
1571
+ }
1572
+
1573
+ /** Un link del pie — legales, contacto, soporte. */
1574
+ interface FooterLink {
1575
+ label: string;
1576
+ href?: string;
1577
+ }
1578
+ /**
1579
+ * Pie de página general del portal (página 38): logo + copyright a la
1580
+ * izquierda, links legales/soporte empujados a la derecha. Logo y copyright
1581
+ * son inputs (cada portal del ecosistema — LATAM, OTD, Star — trae su
1582
+ * propia marca y texto legal); `links` es la lista de accesos, típicamente
1583
+ * placeholders hasta que existan destinos reales.
1584
+ *
1585
+ * <kf-footer
1586
+ * logoSrc="images/logo-kaufmann-dark.png"
1587
+ * logoAlt="Grupo Kaufmann"
1588
+ * copyright="© 2026 Kaufmann LATAM · Todos los derechos reservados"
1589
+ * [links]="[
1590
+ * { label: 'Políticas de privacidad' },
1591
+ * { label: 'Contacto' },
1592
+ * { label: 'Sugerencias y reclamos' },
1593
+ * ]"
1594
+ * />
1595
+ */
1596
+ declare class Footer {
1597
+ readonly logoSrc: _angular_core.InputSignal<string | undefined>;
1598
+ readonly logoAlt: _angular_core.InputSignal<string>;
1599
+ readonly copyright: _angular_core.InputSignal<string>;
1600
+ readonly links: _angular_core.InputSignal<FooterLink[]>;
1601
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Footer, never>;
1602
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Footer, "kf-footer", never, { "logoSrc": { "alias": "logoSrc"; "required": false; "isSignal": true; }; "logoAlt": { "alias": "logoAlt"; "required": false; "isSignal": true; }; "copyright": { "alias": "copyright"; "required": true; "isSignal": true; }; "links": { "alias": "links"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1603
+ }
1604
+
1605
+ /**
1606
+ * Input de formulario apilado: label arriba (en mayúsculas vía CSS), campo con
1607
+ * fondo gris que pasa a blanco con anillo de foco azul al enfocar.
1608
+ *
1609
+ * Implementa ControlValueAccessor, así que funciona con [(ngModel)] y con
1610
+ * Reactive Forms (formControl / formControlName), no es solo un wrapper visual.
1611
+ *
1612
+ * <kf-input label="Placa" icon="car" placeholder="ABC-123" hint="Formato: 3 letras + 3 números" />
1613
+ * <input kf-input formControlName="email" type="email" />
1614
+ *
1615
+ * `invalid` + `errorMessage` cubren el estado de error: con `invalid` el
1616
+ * borde pasa a rojo (`--kf-color-error`) y se setea `aria-invalid="true"` en
1617
+ * el `<input>` nativo; `errorMessage` reemplaza el `hint` neutro por un
1618
+ * mensaje en rojo con `role="alert"`, para que un lector de pantalla lo
1619
+ * anuncie apenas aparece (a diferencia de `hint`, que es solo informativo y
1620
+ * nunca interrumpe). Si se pasan ambos, `errorMessage` tiene prioridad
1621
+ * visual sobre `hint` — no tiene sentido mostrar los dos a la vez.
1622
+ *
1623
+ * <kf-input label="Correo" formControlName="email"
1624
+ * [invalid]="email.invalid && email.touched"
1625
+ * [errorMessage]="email.touched && email.hasError('required') ? 'Ingresa tu correo.' : undefined" />
1626
+ *
1627
+ * `toggleable` solo tiene efecto cuando `type="password"`: agrega un botón
1628
+ * de ojo al final del campo que alterna la visibilidad del valor tipeado
1629
+ * (cambia el `type` real del `<input>` nativo entre `password` y `text`,
1630
+ * nunca expone el valor en el DOM de otra forma). El botón es `type="button"`
1631
+ * — nunca dispara submit del form contenedor — y anuncia su acción con
1632
+ * `aria-label` dinámico y `aria-pressed`, ya que es un toggle, no un botón
1633
+ * de una sola acción.
1634
+ *
1635
+ * <kf-input type="password" label="Contraseña" toggleable formControlName="password" />
1636
+ *
1637
+ * `readonly` es distinto de `disabled`: un campo `disabled` no recibe foco
1638
+ * por teclado ni se puede seleccionar/copiar su texto (y se lee como
1639
+ * "deshabilitado" en un lector de pantalla); un campo `readonly` sí — el
1640
+ * valor se puede ver, enfocar y copiar, solo no se puede editar. Usar
1641
+ * `readonly` para mostrar un dato existente que el usuario puede querer
1642
+ * copiar (ej. un documento de identidad en un formulario de perfil), y
1643
+ * `disabled` para un campo genuinamente inactivo (ej. mientras un guardado
1644
+ * está en vuelo).
1645
+ *
1646
+ * <kf-input label="DNI" readonly formControlName="documentId" />
1647
+ */
1648
+ declare class Input implements ControlValueAccessor, AfterViewInit {
1649
+ private static nextId;
1650
+ private readonly nativeInput;
1651
+ readonly label: _angular_core.InputSignal<string | undefined>;
1652
+ /** Marca el label con un asterisco visual y aplica `required` al `<input>`
1653
+ * nativo — el atributo HTML ya expone el estado obligatorio a lectores de
1654
+ * pantalla (mapeo implícito a `aria-required`), sin necesidad de un
1655
+ * `aria-required` explícito redundante. */
1656
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1657
+ /** Ícono líder, renderizado vía `kf-icon`. */
1658
+ readonly icon: _angular_core.InputSignal<IconName | undefined>;
1659
+ readonly suffix: _angular_core.InputSignal<string | undefined>;
1660
+ readonly hint: _angular_core.InputSignal<string | undefined>;
1661
+ /** Borde y aria-invalid en rojo. Ver `errorMessage` para el mensaje asociado. */
1662
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1663
+ /** Mensaje de error con `role="alert"` — reemplaza a `hint` mientras esté presente. */
1664
+ readonly errorMessage: _angular_core.InputSignal<string | undefined>;
1665
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1666
+ /** Ver JSDoc de la clase para la diferencia con `disabled`. No pasa por
1667
+ * Reactive Forms (a diferencia de `disabled`, que también puede llegar
1668
+ * vía `FormControl.disable()`) — es siempre una decisión explícita del
1669
+ * consumidor del componente. */
1670
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1671
+ readonly type: _angular_core.InputSignal<string>;
1672
+ readonly placeholder: _angular_core.InputSignal<string>;
1673
+ /** Agrega el botón de mostrar/ocultar — sin efecto si `type` no es `"password"`. */
1674
+ readonly toggleable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1675
+ protected readonly inputId: string;
1676
+ protected readonly hintId: string;
1677
+ protected readonly errorId: string;
1678
+ protected readonly value: _angular_core.WritableSignal<string>;
1679
+ protected readonly focused: _angular_core.WritableSignal<boolean>;
1680
+ /** Deshabilitado por Reactive Forms (formControl.disable()). */
1681
+ private readonly disabledByForm;
1682
+ /** Disabled real: por input() directo o por el FormControl asociado. */
1683
+ protected readonly isDisabled: _angular_core.Signal<boolean>;
1684
+ /** Estado interno del toggle — irrelevante si `showPasswordToggle()` es false. */
1685
+ protected readonly passwordVisible: _angular_core.WritableSignal<boolean>;
1686
+ /** El botón solo tiene sentido si el campo realmente es de contraseña. */
1687
+ protected readonly showPasswordToggle: _angular_core.Signal<boolean>;
1688
+ /**
1689
+ * `type` real que recibe el `<input>` nativo: igual a `type()` salvo
1690
+ * cuando el toggle está activo y visible, donde pasa a `text` para
1691
+ * mostrar el valor en claro sin cambiar `type()` en sí (evita que un
1692
+ * consumidor que lee `type()` desde afuera vea un valor inconsistente).
1693
+ */
1694
+ protected readonly effectiveType: _angular_core.Signal<string>;
1695
+ private onChange;
1696
+ private onTouched;
1697
+ ngAfterViewInit(): void;
1698
+ writeValue(value: string): void;
1699
+ registerOnChange(fn: (value: string) => void): void;
1700
+ registerOnTouched(fn: () => void): void;
1701
+ setDisabledState(isDisabled: boolean): void;
1702
+ protected onInput(rawValue: string): void;
1703
+ protected onBlur(): void;
1704
+ /**
1705
+ * Alterna la visibilidad del valor. No dispara `onBlur`/pierde el foco:
1706
+ * el botón vive dentro del mismo `.kf-input__field`, así que un click acá
1707
+ * no debe tratarse como si el usuario hubiese abandonado el campo.
1708
+ */
1709
+ protected onTogglePasswordVisibility(): void;
1710
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Input, never>;
1711
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Input, "kf-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1712
+ }
1713
+
1714
+ type JourneyStepStatus = 'done' | 'current' | 'delayed' | 'pending';
1715
+ type JourneyStepperSurface = 'dark' | 'card';
1716
+ /**
1717
+ * Paleta de color de los estados, independiente de `orientation`:
1718
+ *
1719
+ * - `'brand'` (default): azul de marca para completado/actual, sin
1720
+ * semántica de semáforo. Para cuando horizontal y vertical representan
1721
+ * el mismo journey en distintos tamaños de pantalla.
1722
+ * - `'semantic'`: verde/amarillo/rojo real por paso (solo con
1723
+ * `orientation="vertical"`, la única con 4 estados incluido `delayed`).
1724
+ * Para cuando cada paso comunica su propio estado puntual.
1725
+ */
1726
+ type JourneyStepperColorScheme = 'brand' | 'semantic';
1727
+ interface JourneyStep {
1728
+ key: string;
1729
+ label: string;
1730
+ icon: IconName;
1731
+ /** Solo con `orientation="vertical"` — en horizontal el status se calcula desde `currentStep`. */
1732
+ status?: JourneyStepStatus;
1733
+ /** Texto bajo el label — solo con `orientation="vertical"`. */
1734
+ date?: string;
1735
+ }
1736
+ /**
1737
+ * Progreso de un flujo de N pasos.
1738
+ *
1739
+ * - `orientation` (`'horizontal'` default | `'vertical'`): horizontal
1740
+ * deriva done/current/pending de `currentStep`; vertical usa
1741
+ * `steps[].status` explícito, con `delayed` como cuarto estado.
1742
+ * - `surface` (`'dark'` default | `'card'`): fondo sólido oscuro de marca,
1743
+ * o superficie clara con borde+sombra.
1744
+ * - `colorScheme` (`'brand'` default | `'semantic'`): ver `JourneyStepperColorScheme`.
1745
+ *
1746
+ * <kf-journey-stepper surface="card" [steps]="steps" [currentStep]="4" (stepClick)="onNavigate($event)" />
1747
+ * <kf-journey-stepper orientation="vertical" [steps]="unitSteps" />
1748
+ * <kf-journey-stepper orientation="vertical" colorScheme="semantic" [steps]="unitStepsWithDelays" />
1749
+ */
1750
+ declare class JourneyStepper {
1751
+ readonly steps: _angular_core.InputSignal<JourneyStep[]>;
1752
+ readonly orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
1753
+ readonly surface: _angular_core.InputSignal<JourneyStepperSurface>;
1754
+ readonly colorScheme: _angular_core.InputSignal<JourneyStepperColorScheme>;
1755
+ /** Índice del paso actual — solo con `orientation="horizontal"`. */
1756
+ readonly currentStep: _angular_core.InputSignal<number>;
1757
+ /** Se emite con `step.key` al clickear un paso — solo activo con `orientation="horizontal"`. */
1758
+ readonly stepClick: _angular_core.OutputEmitterRef<string>;
1759
+ private readonly track;
1760
+ private readonly destroyRef;
1761
+ /** `true` cuando el contenido desborda el ancho visible — controla el fade de los bordes. */
1762
+ protected readonly hasOverflow: _angular_core.WritableSignal<boolean>;
1763
+ protected readonly clickable: _angular_core.Signal<boolean>;
1764
+ constructor();
1765
+ private measureOverflow;
1766
+ protected readonly resolvedSteps: _angular_core.Signal<(JourneyStep & {
1767
+ status: JourneyStepStatus;
1768
+ })[]>;
1769
+ protected dotIcon(status: JourneyStepStatus, stepIcon: IconName): IconName;
1770
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<JourneyStepper, never>;
1771
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<JourneyStepper, "kf-journey-stepper", never, { "steps": { "alias": "steps"; "required": true; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "surface": { "alias": "surface"; "required": false; "isSignal": true; }; "colorScheme": { "alias": "colorScheme"; "required": false; "isSignal": true; }; "currentStep": { "alias": "currentStep"; "required": false; "isSignal": true; }; }, { "stepClick": "stepClick"; }, never, never, true, never>;
1772
+ }
1773
+
1774
+ type LinkVariant = 'default' | 'muted';
1775
+ /**
1776
+ * Acción de bajo énfasis con apariencia de texto — "¿Olvidaste tu
1777
+ * contraseña?", "Volver a iniciar sesión", o un link real de navegación
1778
+ * como "Ir a pagos →".
1779
+ *
1780
+ * Sin `href` (default) es un `<button type="button">`: dispara una acción
1781
+ * en la misma pantalla, vía `(click)`. Con `href`, es un `<a>` real: navega
1782
+ * a otra URL. `showArrow` agrega un ícono `chevron-right` al final — para
1783
+ * el patrón "texto + flecha" de un link que lleva a otro lado.
1784
+ *
1785
+ * `variant="default"` (color primario, subrayado en hover) es para la
1786
+ * acción de mayor jerarquía relativa de la pantalla; `variant="muted"`
1787
+ * (gris que pasa a primario en hover) es para acciones de retroceso/salida.
1788
+ *
1789
+ * <kf-link (click)="onForgotPassword()">¿Olvidaste tu contraseña?</kf-link>
1790
+ * <kf-link variant="muted" (click)="onBack()">← Volver a iniciar sesión</kf-link>
1791
+ * <kf-link href="/pagos" showArrow>Ir a pagos</kf-link>
1792
+ */
1793
+ declare class Link {
1794
+ readonly variant: _angular_core.InputSignal<LinkVariant>;
1795
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1796
+ /** Si se pasa, renderiza un `<a>` real en vez de `<button>` — navega en vez de disparar `(click)`. */
1797
+ readonly href: _angular_core.InputSignal<string | undefined>;
1798
+ /** Ícono `chevron-right` al final — para el patrón "texto + flecha" de un link que lleva a otro lado. */
1799
+ readonly showArrow: _angular_core.InputSignalWithTransform<boolean, unknown>;
1800
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Link, never>;
1801
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Link, "kf-link", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "showArrow": { "alias": "showArrow"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1802
+ }
1803
+
1804
+ /**
1805
+ * Card de estadística/KPI: label, valor grande, ícono opcional en la esquina
1806
+ * superior derecha, badge de esquina opcional (pegado al valor) y una nota
1807
+ * al pie. Pensada para tableros de resumen (ej. "11 Tickets abiertos").
1808
+ *
1809
+ * Compone sobre `kf-card` en vez de duplicar su estilo de contenedor — así
1810
+ * el look de "card" (radio, sombra, borde) tiene una única fuente de verdad
1811
+ * en toda la librería, tal como pide el design system (página 14: "Card...
1812
+ * es la base de paneles, tarjetas de métrica, tablas...").
1813
+ *
1814
+ * Slot `[actions]` opcional (proyectado al pie, después de `foot`) para un
1815
+ * CTA dentro de la card — ej. "Saldo Pendiente" con botón "Pagar Ahora" en
1816
+ * Fase 6 de OTD. Mismo mecanismo de proyección por selector que `[footer]`
1817
+ * en `kf-modal`, no un `<ng-content>` default: así una card sin acciones no
1818
+ * paga ningún espacio extra.
1819
+ *
1820
+ * <kf-metric-card label="Tickets abiertos" value="11" icon="ticket" foot="+2 hoy" />
1821
+ * <kf-metric-card label="Tasa de resolución" value="94%" badge="+2%" value-color="var(--kf-color-success)" />
1822
+ * <kf-metric-card label="Saldo Pendiente" value="$45,000">
1823
+ * <kf-button actions variant="primary" size="sm">Pagar Ahora</kf-button>
1824
+ * </kf-metric-card>
1825
+ */
1826
+ declare class MetricCard {
1827
+ readonly label: _angular_core.InputSignal<string>;
1828
+ readonly value: _angular_core.InputSignal<string | number>;
1829
+ readonly unit: _angular_core.InputSignal<string | undefined>;
1830
+ /** Ícono en la esquina superior derecha, renderizado vía `kf-icon`. */
1831
+ readonly icon: _angular_core.InputSignal<IconName | undefined>;
1832
+ readonly foot: _angular_core.InputSignal<string | undefined>;
1833
+ /** Tinte opcional para el valor grande (ej. un color semántico de estado). */
1834
+ readonly valueColor: _angular_core.InputSignal<string | undefined>;
1835
+ /** Badge de esquina opcional, pegado al valor (ej. "+2%"). */
1836
+ readonly badge: _angular_core.InputSignal<string | undefined>;
1837
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<MetricCard, never>;
1838
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MetricCard, "kf-metric-card", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "foot": { "alias": "foot"; "required": false; "isSignal": true; }; "valueColor": { "alias": "valueColor"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; }, {}, never, ["[actions]"], true, never>;
1839
+ }
1840
+
1841
+ /**
1842
+ * Diálogo centrado sobre un backdrop: confirmaciones destructivas, formularios
1843
+ * cortos, decisiones que bloquean el flujo.
1844
+ *
1845
+ * Se apoya en el `<dialog>` nativo (`showModal()`), así que el atrapado de
1846
+ * foco, el backdrop, el orden en el top-layer y el cierre con `Escape` los
1847
+ * resuelve el navegador — no hay trampa de foco escrita a mano acá. Lo único
1848
+ * que se agrega es el lock de scroll del body, que `<dialog>` no hace.
1849
+ *
1850
+ * `open` es two-way. Con `dismissible` en `false` (ej. mientras una acción
1851
+ * destructiva está en vuelo) se cancelan `Escape` y el clic en el backdrop:
1852
+ * solo cierra el consumidor poniendo `open` en `false`.
1853
+ *
1854
+ * Las acciones van en el slot `footer` — el atributo `footer` se pone
1855
+ * DIRECTO en cada `kf-button`, sin envolverlos en un `<div footer>`:
1856
+ * `.kf-modal__footer` ya es `display:flex` con `gap` propio entre sus
1857
+ * hijos DIRECTOS. Envolver los botones en un `<div>` intermedio dejaría
1858
+ * ese `<div>` como único hijo del footer — el gap nunca llegaría a
1859
+ * separar los botones entre sí (bug real encontrado en `web-otd-frontend`:
1860
+ * los 2 botones quedaban pegados, con 0px de separación medida, pese a que
1861
+ * el CSS del footer declaraba `gap: var(--kf-space-md)`).
1862
+ *
1863
+ * <kf-modal [(open)]="confirmOpen" title="Eliminar unidad">
1864
+ * <p>Esta acción no se puede deshacer.</p>
1865
+ * <kf-button footer variant="ghost" (click)="confirmOpen.set(false)">Cancelar</kf-button>
1866
+ * <kf-button footer (click)="remove()">Eliminar</kf-button>
1867
+ * </kf-modal>
1868
+ *
1869
+ * El footer agrupa todo a la derecha por defecto (`justify-content:
1870
+ * flex-end`) — para una acción secundaria/informativa que debe quedar
1871
+ * separada a la izquierda (ej. un link "Ver documento" junto a un botón
1872
+ * "Cerrar"), agregar la clase `kf-modal__footer-start` AL MISMO elemento
1873
+ * que ya lleva `footer`, no a un wrapper (mismo motivo que el `footer`
1874
+ * directo: un `<div>` intermedio rompe el `gap`):
1875
+ *
1876
+ * <kf-link footer class="kf-modal__footer-start" disabled>Ver documento</kf-link>
1877
+ * <kf-button footer (click)="open.set(false)">Cerrar</kf-button>
1878
+ */
1879
+ declare class Modal {
1880
+ readonly title: _angular_core.InputSignal<string>;
1881
+ /** Visibilidad, two-way: `[(open)]="confirmOpen"`. */
1882
+ readonly open: _angular_core.ModelSignal<boolean>;
1883
+ /** Permite cerrar con el botón, `Escape` o clic en el backdrop. */
1884
+ readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
1885
+ /** Ancho por defecto: `480px` (sin pasar nada). Un modal con contenido
1886
+ * tabular/ancho (ej. una lista de varios campos por fila) puede pedir
1887
+ * más, ej. `width="720px"` — sigue topeado por `100vw` en pantallas
1888
+ * angostas, mismo `min()` de siempre. */
1889
+ readonly width: _angular_core.InputSignal<string | null>;
1890
+ protected readonly titleId: string;
1891
+ private readonly dialog;
1892
+ private readonly document;
1893
+ private readonly overlayContainer;
1894
+ constructor();
1895
+ /** `Escape` dispara `cancel`; cancelarlo lo deja abierto. */
1896
+ protected onCancel(event: Event): void;
1897
+ /**
1898
+ * Clic en el backdrop. Un clic en la zona del backdrop tiene como `target` al
1899
+ * propio `<dialog>` (el contenido vive en el panel de adentro), así que basta
1900
+ * comparar contra él — no hace falta cortar la propagación en el panel.
1901
+ *
1902
+ * Va como HostListener y no como binding en el template porque un `(click)`
1903
+ * sobre el `<dialog>` dispara las reglas a11y de click-sin-teclado; acá el
1904
+ * equivalente de teclado es `Escape`, que el `<dialog>` nativo ya maneja.
1905
+ */
1906
+ protected onHostClick(event: MouseEvent): void;
1907
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Modal, never>;
1908
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Modal, "kf-modal", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*", "[footer]"], true, never>;
1909
+ }
1910
+
1911
+ /** Color de la franja izquierda y del fondo. */
1912
+ type NoteBlockTone = 'neutral' | 'ok' | 'warn' | 'error' | 'info';
1913
+ /**
1914
+ * Bloque de texto atribuido a una PERSONA: encabezado, prosa y firma al pie,
1915
+ * con fondo suave y franja de color — la anatomía de una cita, distinta de
1916
+ * `kf-alert` (que interrumpe el flujo con `role="alert"`). El texto va como
1917
+ * contenido proyectado y respeta los saltos de línea del autor.
1918
+ */
1919
+ declare class NoteBlock {
1920
+ readonly title: _angular_core.InputSignal<string | undefined>;
1921
+ /** Segunda pieza del encabezado, en la misma línea del `title`. */
1922
+ readonly subtitle: _angular_core.InputSignal<string | undefined>;
1923
+ /** Pie de atribución — quién escribió y cuándo, ya formateado. */
1924
+ readonly signature: _angular_core.InputSignal<string | undefined>;
1925
+ readonly tone: _angular_core.InputSignal<NoteBlockTone>;
1926
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<NoteBlock, never>;
1927
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<NoteBlock, "kf-note-block", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "signature": { "alias": "signature"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1928
+ }
1929
+
1930
+ type TextAs = 'h1' | 'h2' | 'h3' | 'p' | 'span';
1931
+ type TextVariant = 'title-xxl' | 'title-xl' | 'title-lg' | 'title-md' | 'title-sm' | 'body' | 'body-muted' | 'caption' | 'overline' | 'overline-strong';
1932
+ type TextTone = 'neutral' | 'ok' | 'warn' | 'error' | 'info';
1933
+ /**
1934
+ * Tipografía unificada — separa la etiqueta semántica (`as`, qué es el
1935
+ * texto para el DOM/accesibilidad) del estilo visual (`variant`, cómo se
1936
+ * ve). Antes de este componente, cada pantalla que consume la librería
1937
+ * definía su propio `h1`/`p` con `font-size` suelto para el mismo rol
1938
+ * (título de página, subtítulo, texto secundario) — auditoría sobre
1939
+ * `web-portal-latam-frontend` encontró 9 tamaños distintos entre login y
1940
+ * home sin ningún paso de escala en común. `variant` resuelve eso contra
1941
+ * la escala de `tokens/base.css` (`--kf-font-size-*`).
1942
+ *
1943
+ * `tone` sigue la misma convención cerrada que `Alert`/`Badge`/`Chip`: sin
1944
+ * escape hatch de color libre. Si un caso necesita un color que `tone` no
1945
+ * cubre, es una discusión de design system, no una prop nueva acá.
1946
+ *
1947
+ * `title-xl`/`title-xxl` son un tier aparte de `title-lg|md|sm`: no vienen
1948
+ * de la auditoría de contenido de página (esa cerró en 2.125rem), son para
1949
+ * títulos protagonistas de pantalla completa (ej. bienvenida del home vía
1950
+ * `kf-page-header[size=xl|xxl]`) — ver tokens/base.css.
1951
+ *
1952
+ * `overline`/`overline-strong` son para el patrón "texto chico en mayúsculas
1953
+ * junto a un dato" (ej. el label "RUC" de `kf-company-selector`, el badge de
1954
+ * `kf-admin-badge`) — antes de estas variantes, ese patrón se reimplementaba
1955
+ * suelto en al menos 7 componentes con tamaños/pesos ligeramente distintos
1956
+ * entre sí. `overline` (peso 600) es para labels sin chrome propio;
1957
+ * `overline-strong` (peso 700) es para el texto de un badge/pill que ya trae
1958
+ * su propio fondo. Ninguna de las dos fija color — como el resto de los
1959
+ * variants, el color se resuelve con `tone`.
1960
+ *
1961
+ * <kf-text as="h1" variant="title-lg">Bienvenido de nuevo</kf-text>
1962
+ * <kf-text as="p" variant="body-muted">Ingresá con tu cuenta corporativa.</kf-text>
1963
+ * <kf-text as="span" variant="caption" tone="error">Campo obligatorio</kf-text>
1964
+ * <kf-text as="span" variant="overline">RUC</kf-text>
1965
+ * <kf-text as="span" variant="overline-strong" tone="warn">Vista administrador</kf-text>
1966
+ */
1967
+ declare class Text {
1968
+ /** Etiqueta semántica real que se renderiza — nunca es solo un `div`. */
1969
+ readonly as: _angular_core.InputSignal<TextAs>;
1970
+ readonly variant: _angular_core.InputSignal<TextVariant>;
1971
+ readonly tone: _angular_core.InputSignal<TextTone>;
1972
+ /**
1973
+ * Copia de `as` para uso dentro del template: `as` es palabra reservada
1974
+ * en las expresiones de Angular (`@if (x; as y)`), así que `@switch (as())`
1975
+ * no parsea — NG5002. La prop pública sigue llamándose `as` (es solo un
1976
+ * atributo HTML ahí, `<kf-text as="h1">`, no una expresión).
1977
+ */
1978
+ protected readonly tag: _angular_core.Signal<TextAs>;
1979
+ protected hostClass(): string;
1980
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Text, never>;
1981
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Text, "kf-text", never, { "as": { "alias": "as"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1982
+ }
1983
+
1984
+ /**
1985
+ * Tamaño del título. Cada valor mapea 1:1 a una variante `title-*` de
1986
+ * `kf-text`; `xl`/`xxl` son para títulos protagonistas (ej. bienvenida del
1987
+ * home). Bajo los 900px, el tamaño efectivo baja un escalón (ver
1988
+ * `MOBILE_STEP_DOWN`).
1989
+ */
1990
+ type PageHeaderTitleSize = 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
1991
+ /**
1992
+ * Bloque de título al tope de una página: chip de ícono opcional, título (h1),
1993
+ * subtítulo opcional y un área de acciones opcional proyectada vía
1994
+ * `<ng-content select="[actions]">`.
1995
+ *
1996
+ * <kf-page-header title="Vehículos" subtitle="Gestión de la flota activa">
1997
+ * <button actions>Nuevo vehículo</button>
1998
+ * </kf-page-header>
1999
+ *
2000
+ * <kf-page-header icon="settings" title="Configuración" />
2001
+ *
2002
+ * <kf-page-header size="xl" title="Bienvenido de nuevo" />
2003
+ */
2004
+ declare class PageHeader {
2005
+ readonly icon: _angular_core.InputSignal<IconName | undefined>;
2006
+ readonly title: _angular_core.InputSignal<string>;
2007
+ readonly subtitle: _angular_core.InputSignal<string | undefined>;
2008
+ readonly size: _angular_core.InputSignal<PageHeaderTitleSize>;
2009
+ private readonly isMobile;
2010
+ protected readonly resolvedTitleVariant: _angular_core.Signal<TextVariant>;
2011
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageHeader, never>;
2012
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageHeader, "kf-page-header", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["[actions]"], true, never>;
2013
+ }
2014
+
2015
+ /** Un número de página clickeable o un separador "…" no interactivo. */
2016
+ type PaginationItem = {
2017
+ type: 'page';
2018
+ page: number;
2019
+ } | {
2020
+ type: 'ellipsis';
2021
+ };
2022
+ /**
2023
+ * Paginador numerado con elipsis + prev/next.
2024
+ *
2025
+ * Algoritmo de elipsis estándar: siempre se muestran la primera página, la
2026
+ * última, la página actual y un par de vecinas alrededor de la actual; el
2027
+ * resto de los huecos se colapsa en un separador "…". Cuando el hueco entre
2028
+ * dos números visibles es de exactamente una página, se muestra ese número
2029
+ * en vez de un "…" (no tiene sentido colapsar un solo elemento).
2030
+ *
2031
+ * El contenido proyectado (`<ng-content>`) es para el texto informativo
2032
+ * opcional (ej. "21–40 de 273"), a la izquierda de los controles.
2033
+ *
2034
+ * <kf-pagination [page]="page" [pages]="totalPages" (pageChange)="page = $event">
2035
+ * 21–40 de 273
2036
+ * </kf-pagination>
2037
+ *
2038
+ * Con `pageSizeOptions`, agrega un select de "N por página" entre el texto
2039
+ * informativo y los controles de navegación — el consumidor decide el
2040
+ * tamaño real vía `pageSize`/`pageSizeChange` (two-way opcional, ninguno de
2041
+ * los dos es requerido si no se usa el selector):
2042
+ *
2043
+ * <kf-pagination [page]="page" [pages]="totalPages" (pageChange)="page = $event"
2044
+ * [pageSizeOptions]="[10, 25, 50]" [(pageSize)]="pageSize">
2045
+ * 21–40 de 273
2046
+ * </kf-pagination>
2047
+ */
2048
+ declare class Pagination {
2049
+ readonly page: _angular_core.InputSignal<number>;
2050
+ readonly pages: _angular_core.InputSignal<number>;
2051
+ readonly pageChange: _angular_core.OutputEmitterRef<number>;
2052
+ /** Opciones del selector "N por página" — sin esto, el selector no se
2053
+ * renderiza (mismo criterio que `[footer]`/`[actions]` de otros
2054
+ * componentes: ausente por default, nunca forzado). `kf-select` en
2055
+ * `variant="compact"` no impone un máximo de opciones, a diferencia de
2056
+ * `kf-segmented` (pensado solo para 2-3). */
2057
+ readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
2058
+ readonly pageSize: _angular_core.ModelSignal<number | null>;
2059
+ /** Lista de números de página y separadores a renderizar, ya resuelta por el algoritmo de elipsis. */
2060
+ readonly items: _angular_core.Signal<PaginationItem[]>;
2061
+ /** Con una sola página (o ninguna), el `<nav>` de prev/next+números no
2062
+ * aporta nada navegable — antes se dejaba en el DOM igual (oculto solo
2063
+ * por un hack `::ng-deep` del consumidor, ver `route-assistance-monorepo`)
2064
+ * y el footer quedaba con el selector "Filas" descoordinado, como si le
2065
+ * faltara una pieza. Sacar el `<nav>` del DOM (no `display:none`) resuelve
2066
+ * esto para cualquier consumidor de `kf-pagination`, no solo para quien ya
2067
+ * tenía el hack. El `divider` reusa el mismo criterio: sin `nav` no hay
2068
+ * nada del otro lado que separar, así que tampoco corresponde dejarlo. */
2069
+ protected readonly hasNav: _angular_core.Signal<boolean>;
2070
+ /** `kf-select` trabaja con `value: string` — cada tamaño numérico se
2071
+ * mapea a su representación en texto, ida y vuelta. */
2072
+ protected readonly pageSizeSelectOptions: _angular_core.Signal<string[]>;
2073
+ protected readonly pageSizeValue: _angular_core.Signal<string>;
2074
+ protected setPageSize(value: string): void;
2075
+ goTo(target: number): void;
2076
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Pagination, never>;
2077
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Pagination, "kf-pagination", never, { "page": { "alias": "page"; "required": false; "isSignal": true; }; "pages": { "alias": "pages"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; "pageSize": "pageSizeChange"; }, never, ["*"], true, never>;
2078
+ }
2079
+
2080
+ /**
2081
+ * Tarjeta contenedora con título, enlace de acción opcional a la derecha, y
2082
+ * cuerpo con contenido libre — página 33: "Base de la mayoría de bloques del
2083
+ * portal". Compone sobre `kf-card` para compartir la misma superficie
2084
+ * (radio, sombra, borde) que el resto de la librería.
2085
+ *
2086
+ * <kf-panel title="Mis documentos por pagar" actionLabel="Ir a pagos" actionHref="/pagos">
2087
+ * <kf-action-tile-row icon="download" title="Pagos" description="Revisa tu estado de cuenta y realiza pagos." />
2088
+ * </kf-panel>
2089
+ *
2090
+ * El host y el `kf-card` interno son flex column con `flex:1` de punta a
2091
+ * punta — si un grid/flex externo estira `kf-panel` a la altura de un
2092
+ * hermano más alto, el contenido proyectado hereda esa altura en vez de
2093
+ * dejar un hueco vacío bajo el `kf-card`. Sin esa presión externa (altura
2094
+ * "auto" del contenedor), `flex:1` no tiene espacio extra que repartir y el
2095
+ * panel se comporta igual que antes.
2096
+ */
2097
+ declare class Panel {
2098
+ readonly title: _angular_core.InputSignal<string>;
2099
+ readonly actionLabel: _angular_core.InputSignal<string | undefined>;
2100
+ readonly actionHref: _angular_core.InputSignal<string | undefined>;
2101
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Panel, never>;
2102
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Panel, "kf-panel", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "actionLabel": { "alias": "actionLabel"; "required": false; "isSignal": true; }; "actionHref": { "alias": "actionHref"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
2103
+ }
2104
+
2105
+ /** Un ítem de navegación de la barra de marca. `icon` es opcional y solo se
2106
+ * usa en el drawer mobile (columna, ver template) — el `<nav>` horizontal de
2107
+ * escritorio se mantiene solo texto, sin ícono ni chevron. */
2108
+ interface PortalHeaderNavItem {
2109
+ label: string;
2110
+ href: string;
2111
+ active?: boolean;
2112
+ icon?: IconName;
2113
+ }
2114
+ /** Una acción de la franja de administrador (ej. "Consultar deuda clientes"). */
2115
+ interface PortalHeaderAdminAction {
2116
+ label: string;
2117
+ href: string;
2118
+ }
2119
+ /**
2120
+ * Cabecera completa del portal (página 31) — franja de administrador
2121
+ * (acento ámbar, solo admins), barra de marca con logo, navegación y
2122
+ * pastilla de sesión. Compone `kf-admin-badge` para la franja y `kf-avatar
2123
+ * pill` para la sesión, en vez de reimplementar ambos.
2124
+ *
2125
+ * Es distinto de `kf-page-header`/`kf-page-head` (título de una vista
2126
+ * interna) — este es el chrome global del portal, se monta una sola vez.
2127
+ *
2128
+ * `:host` es `position: sticky; top: 0` — el header queda pegado arriba al
2129
+ * hacer scroll. No es `fixed`: como no se superpone al contenido en el
2130
+ * primer render, no hace falta que el consumidor compense con
2131
+ * `padding-top`.
2132
+ *
2133
+ * Bajo los 768px, el `<nav>` deja de mostrarse en línea junto al logo y
2134
+ * colapsa detrás de un botón de menú (ícono `menu`/`x`) que despliega un
2135
+ * `kf-drawer` (panel lateral genérico, ver `Drawer.ts`) anclado al borde
2136
+ * IZQUIERDO — mismo lado que el botón que lo abre, convención dominante
2137
+ * Material/iOS/Android — con los mismos `navItems` en columna dentro del
2138
+ * body (fondo claro) de ese drawer.
2139
+ *
2140
+ * `PortalHeader` expone dos slots propios pensados para que el consumidor
2141
+ * proyecte contenido que en escritorio vive en otro lugar:
2142
+ * - `<ng-content select="[kf-portal-header-extra]">`: identidad de sesión
2143
+ * (ej. `kf-drawer-session`). Cae en `[kf-drawer-header]` de `kf-drawer` —
2144
+ * el único contenedor con fondo oscuro (`--kf-color-tertiary-deep`, ver
2145
+ * `Drawer.ts`) que `kf-drawer-session` espera como fondo (no trae uno
2146
+ * propio, ver `DrawerSession.ts`).
2147
+ * - `<ng-content select="[kf-portal-header-footer]">`: acciones separadas del
2148
+ * resto (ej. `kf-drawer-logout`). Cae en `[kf-drawer-footer]` de `kf-drawer`.
2149
+ *
2150
+ * `PortalHeader` no sabe qué es ninguno de los dos contenidos, solo les da
2151
+ * el lugar correcto dentro del drawer ya desplegado (ver `Drawer.ts`).
2152
+ *
2153
+ * <kf-portal-header
2154
+ * [isAdmin]="true"
2155
+ * [adminActions]="[{ label: 'Consultar deuda clientes', href: '/deuda' }, { label: 'Cambiar DNI', href: '/dni' }]"
2156
+ * [navItems]="[{ label: 'Home', href: '/', active: true, icon: 'grid' }, { label: 'Vehículos', href: '/vehiculos', icon: 'truck' }]"
2157
+ * tagline="Portal privado"
2158
+ * userInitials="TS"
2159
+ * userName="Tomás Soto"
2160
+ * [showCart]="true"
2161
+ * (cartClick)="onCartClick()"
2162
+ * >
2163
+ * <kf-drawer-session
2164
+ * kf-portal-header-extra
2165
+ * brand="Portal Kaufmann LATAM"
2166
+ * name="Tomás Soto"
2167
+ * email="tomas.soto@kaufmann.com"
2168
+ * />
2169
+ * <kf-drawer-logout kf-portal-header-footer (logoutClick)="onLogout()" />
2170
+ * </kf-portal-header>
2171
+ */
2172
+ declare class PortalHeader {
2173
+ readonly brand: _angular_core.InputSignal<string>;
2174
+ /** URL del logo como imagen. Sin ella (default), se mantiene el texto de `brand`. */
2175
+ readonly logoSrc: _angular_core.InputSignal<string | undefined>;
2176
+ /** `alt` del logo cuando se usa `logoSrc`. Sin ella, cae en `brand()`. */
2177
+ readonly logoAlt: _angular_core.InputSignal<string | undefined>;
2178
+ readonly isAdmin: _angular_core.InputSignalWithTransform<boolean, unknown>;
2179
+ readonly adminActions: _angular_core.InputSignal<PortalHeaderAdminAction[]>;
2180
+ readonly navItems: _angular_core.InputSignal<PortalHeaderNavItem[]>;
2181
+ readonly userInitials: _angular_core.InputSignal<string>;
2182
+ /** Texto junto al logo (ej. "Portal privado"), con separador vertical. Sin
2183
+ * separador ni texto si queda vacío. */
2184
+ readonly tagline: _angular_core.InputSignal<string>;
2185
+ /** Nombre completo para el bloque "HOLA / {nombre}" dentro de la pastilla
2186
+ * de sesión. Vacío (default) mantiene la pastilla como hoy: solo avatar,
2187
+ * sin bloque de texto ni chevron — retrocompatible con cualquier
2188
+ * consumidor que no pase este input. */
2189
+ readonly userName: _angular_core.InputSignal<string>;
2190
+ readonly showCart: _angular_core.InputSignalWithTransform<boolean, unknown>;
2191
+ readonly sessionClick: _angular_core.OutputEmitterRef<void>;
2192
+ readonly cartClick: _angular_core.OutputEmitterRef<void>;
2193
+ /** Visibilidad del drawer de navegación mobile (bajo los 768px). Se pasa a
2194
+ * `kf-drawer` como `[(open)]` — `PortalHeader` ya no implementa overlay,
2195
+ * `Escape` ni atrapado de foco por su cuenta, eso vive en `Drawer`. */
2196
+ protected readonly mobileMenuOpen: _angular_core.WritableSignal<boolean>;
2197
+ /**
2198
+ * `ElementRef` real del botón de sesión (el avatar en la esquina
2199
+ * derecha), no de todo el header. Pensado para anclar un `kf-dropdown`
2200
+ * externo — sin esto, el único `ElementRef` disponible desde afuera es el
2201
+ * del host de `PortalHeader`, que ocupa el ancho completo de la pantalla
2202
+ * (logo + nav + sesión), y el overlay del CDK termina "pegado" a la
2203
+ * esquina del header entero en vez de al botón que el usuario clickeó.
2204
+ *
2205
+ * <kf-dropdown [(open)]="menuOpen" [anchor]="header().sessionButtonRef()">
2206
+ */
2207
+ readonly sessionButtonRef: _angular_core.Signal<ElementRef<any>>;
2208
+ /**
2209
+ * Ancla real de cada `<a>` del `<nav>` horizontal (una por `navItems()`,
2210
+ * mismo orden — `@for` trackea por `item.label`, así que la lista no se
2211
+ * recrea en cada cambio de ruta, solo cambia qué índice trae
2212
+ * `active: true`). Sirve para medir dónde poner la cápsula deslizante
2213
+ * (`thumbStyle`, ver abajo) sin duplicar el layout del nav en JS.
2214
+ */
2215
+ private readonly navItemAnchors;
2216
+ /** Fuerza recalcular `thumbStyle` en un resize — un resize de ventana no
2217
+ * cambia ningún signal de los que `thumbStyle` ya lee (`navItems`,
2218
+ * `navItemAnchors`), pero sí puede correr el layout de los `<a>` bajo un
2219
+ * ancho de columna distinto (texto largo pasando a otra línea, etc.). */
2220
+ private readonly resizeTick;
2221
+ protected onWindowResize(): void;
2222
+ /**
2223
+ * Posición/ancho de la cápsula blanca del ítem activo del `<nav>`, como
2224
+ * un elemento propio (`.kf-portal-header__nav-thumb`) que se desliza con
2225
+ * `transition` en vez de que cada `<a>` traiga su propio fondo blanco
2226
+ * (eso hacía que el fondo "saltara" de un ítem a otro sin animación,
2227
+ * porque son elementos DOM distintos — no hay nada que Angular pueda
2228
+ * animar entre ellos).
2229
+ */
2230
+ protected readonly thumbStyle: _angular_core.Signal<Record<string, string>>;
2231
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<PortalHeader, never>;
2232
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<PortalHeader, "kf-portal-header", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoSrc": { "alias": "logoSrc"; "required": false; "isSignal": true; }; "logoAlt": { "alias": "logoAlt"; "required": false; "isSignal": true; }; "isAdmin": { "alias": "isAdmin"; "required": false; "isSignal": true; }; "adminActions": { "alias": "adminActions"; "required": false; "isSignal": true; }; "navItems": { "alias": "navItems"; "required": false; "isSignal": true; }; "userInitials": { "alias": "userInitials"; "required": true; "isSignal": true; }; "tagline": { "alias": "tagline"; "required": false; "isSignal": true; }; "userName": { "alias": "userName"; "required": false; "isSignal": true; }; "showCart": { "alias": "showCart"; "required": false; "isSignal": true; }; }, { "sessionClick": "sessionClick"; "cartClick": "cartClick"; }, never, ["[kf-portal-header-extra]", "[kf-portal-header-footer]"], true, never>;
2233
+ }
2234
+
2235
+ /** Mismo vocabulario que `Badge.tone`/`TextTone` (menos `info`/`service`,
2236
+ * que no aplican a un valor de progreso): `neutral` es el color de marca
2237
+ * por defecto (sin implicar buen/mal estado), `ok`/`warn`/`error` sí
2238
+ * comunican severidad. La librería no conoce el dominio que produce ese
2239
+ * valor (SLA, storage, lo que sea) — el consumidor decide qué tone usar. */
2240
+ type ProgressTone = 'neutral' | 'ok' | 'warn' | 'error';
2241
+ /**
2242
+ * Barra de progreso de un solo valor (0-100%) con color por severidad —
2243
+ * para un porcentaje simple, a diferencia de `kf-bucket-progress`, que
2244
+ * dibuja varias categorías proporcionales en la misma barra.
2245
+ *
2246
+ * <kf-progress [value]="80" tone="ok" label="80%" />
2247
+ * <kf-progress [value]="ratio()" [tone]="severityTone()" />
2248
+ *
2249
+ * `value` se clampea a [0, 100] — un consumidor que calcule un ratio fuera
2250
+ * de rango (ej. tiempo transcurrido sobre un SLA ya vencido) no rompe el
2251
+ * ancho de la barra. `label` es texto libre opcional sobre la barra (ej.
2252
+ * "80%"); sin él, no se renderiza ningún texto, solo la barra.
2253
+ */
2254
+ declare class Progress {
2255
+ readonly value: _angular_core.InputSignal<number>;
2256
+ readonly tone: _angular_core.InputSignal<ProgressTone>;
2257
+ readonly label: _angular_core.InputSignal<string | undefined>;
2258
+ protected readonly clampedValue: _angular_core.Signal<number>;
2259
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Progress, never>;
2260
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Progress, "kf-progress", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2261
+ }
2262
+
2263
+ /**
2264
+ * Punto que emite ondas concéntricas en bucle, para marcar un dato que
2265
+ * necesita atención inmediata sin depender de que el operador lo vea por
2266
+ * casualidad — el mismo rol que un punto rojo estático ya cumple en varios
2267
+ * lugares del producto (ver `.now__d`/`.board-alerts__dot` en
2268
+ * `operations-final.html`), llevado a movimiento porque el color solo
2269
+ * compite por atención con todo lo demás en pantalla; el movimiento no.
2270
+ *
2271
+ * Es una primitiva de énfasis, no un indicador de estado — para eso está
2272
+ * `kf-status-pill` (punto estático + texto). Este componente no tiene
2273
+ * texto ni tono semántico de "ok/warn/error": una sola apariencia (rojo,
2274
+ * el color reservado para lo urgente en el design system), porque emitir
2275
+ * ondas por algo que no es urgente banalizaría la señal la próxima vez que
2276
+ * sí lo sea.
2277
+ *
2278
+ * <kf-pulse-dot />
2279
+ * <kf-pulse-dot size="lg" />
2280
+ *
2281
+ * Respeta `prefers-reduced-motion` (ver PulseDot.css): la onda deja de
2282
+ * animarse y el punto queda como un punto estático, sin perder la
2283
+ * información de "esto es urgente" que da el color.
2284
+ */
2285
+ declare class PulseDot {
2286
+ readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
2287
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<PulseDot, never>;
2288
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<PulseDot, "kf-pulse-dot", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2289
+ }
2290
+
2291
+ type RowActionKind = 'link' | 'button';
2292
+ /**
2293
+ * Una acción de fila — mismo shape que ya usaba `WorkshopRowAction` en
2294
+ * `web-portal-latam-frontend` antes de este componente (Taller, tab
2295
+ * "Trabajos terminados"), ahora compartido: `kind: 'link'` navega (necesita
2296
+ * `href`, `onClick` se ignora), `kind: 'button'` dispara `onClick` en la
2297
+ * pantalla actual. `disabled` aplica a ambos — un link sin `href` (o
2298
+ * explícitamente `disabled`) se renderiza inerte en vez de clickeable, en
2299
+ * vez de omitirse del todo: el consumidor decide que la acción EXISTE pero
2300
+ * no está disponible todavía (ej. "Factura" mientras no exista el endpoint
2301
+ * de descarga).
2302
+ */
2303
+ interface RowAction {
2304
+ readonly kind: RowActionKind;
2305
+ readonly icon: IconName;
2306
+ readonly label: string;
2307
+ readonly href?: string | null;
2308
+ readonly disabled?: boolean;
2309
+ readonly onClick?: () => void;
2310
+ }
2311
+ type RowActionsMode = 'auto' | 'inline' | 'menu';
2312
+ /**
2313
+ * Columna "Acciones" de cualquier tabla del ecosistema. Decide su propia
2314
+ * forma según cuántas acciones recibe — no hace falta que cada tabla elija
2315
+ * a mano entre "botones sueltos" y "menú":
2316
+ *
2317
+ * - `inline` (`actions().length <= inlineLimit()`, default 2): un
2318
+ * ícono-botón de 32px por acción, sin texto — el `label` vive en un
2319
+ * `kfTooltip`. Todas las acciones quedan visibles sin clic extra.
2320
+ * - `menu` (más de `inlineLimit()`): un único botón "kebab" que abre un
2321
+ * `kf-dropdown-panel` con una fila por acción.
2322
+ *
2323
+ * `mode` fuerza uno de los dos modos sin importar cuántas acciones haya
2324
+ * (ej. una tabla que prefiere el kebab siempre, aunque tenga una sola
2325
+ * acción, por consistencia visual con otra columna).
2326
+ *
2327
+ * <kf-row-actions [actions]="rowActions(row)" />
2328
+ * <kf-row-actions [actions]="rowActions(row)" mode="menu" />
2329
+ */
2330
+ declare class RowActions {
2331
+ readonly actions: _angular_core.InputSignal<readonly RowAction[]>;
2332
+ readonly mode: _angular_core.InputSignal<RowActionsMode>;
2333
+ /** Desde cuántas acciones el modo `auto` pasa de `inline` a `menu`. */
2334
+ readonly inlineLimit: _angular_core.InputSignal<number>;
2335
+ protected readonly menuOpen: _angular_core.WritableSignal<boolean>;
2336
+ protected readonly effectiveMode: _angular_core.Signal<"menu" | "inline">;
2337
+ protected onToggleMenu(): void;
2338
+ protected onButtonAction(action: RowAction): void;
2339
+ protected onMenuLinkClick(): void;
2340
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<RowActions, never>;
2341
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RowActions, "kf-row-actions", never, { "actions": { "alias": "actions"; "required": true; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "inlineLimit": { "alias": "inlineLimit"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2342
+ }
2343
+
2344
+ /**
2345
+ * Título de sub-sección con chip de ícono, pensado para anidarse dentro de
2346
+ * cards o paneles (a diferencia de `PageHeader`, que encabeza una página
2347
+ * completa). Un área de acciones opcional se proyecta vía
2348
+ * `<ng-content select="[actions]">` para no acoplar el componente a un set
2349
+ * fijo de botones.
2350
+ *
2351
+ * `size` sigue la misma escala `'sm'|'md'|'lg'` que `Button`/`Icon`/`Spinner`
2352
+ * (`md` es el default): `sm` reduce tipografía y espaciado para usarse
2353
+ * dentro de cards ya compactas, `lg` los agranda para encabezar un bloque
2354
+ * más prominente. `solid` rellena el chip de ícono con el color primario
2355
+ * sólido en vez del tratamiento "soft" (fondo tenue) — pensado para
2356
+ * superficies que ya tienen un tinte de color propio, donde el chip "soft"
2357
+ * perdería contraste.
2358
+ *
2359
+ * <kf-section-header icon="settings" title="Preferencias"
2360
+ * subtitle="Configuración general de la cuenta">
2361
+ * <button actions>Editar</button>
2362
+ * </kf-section-header>
2363
+ *
2364
+ * <kf-section-header title="Detalle" size="sm" [solid]="true" />
2365
+ * <kf-section-header title="Resumen de flota" size="lg" />
2366
+ */
2367
+ declare class SectionHeader {
2368
+ readonly icon: _angular_core.InputSignal<IconName | undefined>;
2369
+ readonly title: _angular_core.InputSignal<string>;
2370
+ readonly subtitle: _angular_core.InputSignal<string | undefined>;
2371
+ readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
2372
+ readonly solid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2373
+ protected readonly iconSize: _angular_core.Signal<"sm" | "md" | "lg">;
2374
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SectionHeader, never>;
2375
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SectionHeader, "kf-section-header", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "solid": { "alias": "solid"; "required": false; "isSignal": true; }; }, {}, never, ["[actions]"], true, never>;
2376
+ }
2377
+
2378
+ /**
2379
+ * Contenedor de navegación por secciones dentro de una misma pantalla —
2380
+ * agrupa `kf-section-nav-item` y resuelve su layout fusionado según
2381
+ * viewport, con un breakpoint PROPIO de 1024px (no el $mobile:900px
2382
+ * compartido del resto de la librería — ver el comentario en
2383
+ * `SectionNav.scss`):
2384
+ *
2385
+ * - Desktop (≥1024px): columna de botones a la izquierda + panel de
2386
+ * contenido separado a la derecha, mostrando el contenido del ítem (o
2387
+ * sub-ítem) activo.
2388
+ * - Mobile y tablet (<1024px): acordeón — el contenido del ítem activo se
2389
+ * despliega inline, justo debajo de su propio botón.
2390
+ *
2391
+ * El cambio entre ambos layouts es solo CSS (`SectionNav.scss` +
2392
+ * `SectionNavItem.scss`, ver comentarios ahí): cada `kf-section-nav-item`
2393
+ * proyecta su contenido una única vez y es la grilla la que lo reposiciona
2394
+ * visualmente, sin recrearlo ni duplicarlo en el DOM.
2395
+ *
2396
+ * A diferencia de `kf-tabs` (selector de vista plano, sin contenido propio)
2397
+ * y de `kf-sidebar-shell` (rail persistente ENTRE rutas, colapsable, fondo
2398
+ * oscuro): esto es navegación DENTRO de una sola pantalla, con paneles de
2399
+ * contenido rico por sección.
2400
+ *
2401
+ * La exclusividad entre ítems (y entre sub-ítems, dentro de cada uno) la
2402
+ * decide quien consume el componente, igual que cada `kf-section-nav-item`
2403
+ * por separado — `kf-section-nav` no guarda ningún estado de selección.
2404
+ *
2405
+ * <kf-section-nav>
2406
+ * <kf-section-nav-item label="Mis datos personales" icon="user"
2407
+ * [active]="openSection() === 'datos'" (toggled)="openSection.set('datos')">
2408
+ * <app-personal-data />
2409
+ * </kf-section-nav-item>
2410
+ * <kf-section-nav-item label="Mis empresas" icon="layers"
2411
+ * [active]="openSection() === 'empresas'" (toggled)="openSection.set('empresas')">
2412
+ * <app-my-companies />
2413
+ * </kf-section-nav-item>
2414
+ * </kf-section-nav>
2415
+ */
2416
+ declare class SectionNav {
2417
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SectionNav, never>;
2418
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SectionNav, "kf-section-nav", never, {}, {}, never, ["*"], true, never>;
2419
+ }
2420
+
2421
+ interface SectionNavSubsectionData {
2422
+ key: string;
2423
+ label: string;
2424
+ icon: IconName;
2425
+ disabled?: boolean;
2426
+ }
2427
+ /**
2428
+ * Ítem de nivel superior de `kf-section-nav`: header clickeable (ícono
2429
+ * identificador opcional + label + chevron) que expande/colapsa contenido
2430
+ * proyectado. La exclusividad entre ítems la decide quien consume el
2431
+ * componente — cada click solo emite `toggled` y el padre resuelve qué
2432
+ * ítem queda `active`, igual que `kf-folder-tabs` con `value`.
2433
+ *
2434
+ * `subsections` agrega un segundo nivel de navegación DENTRO del ítem
2435
+ * (solo visible cuando el ítem está `active`), cada uno con su propio
2436
+ * estado activo (`activeSubsection`) independiente del padre. El contenido
2437
+ * de cada sub-ítem se proyecta envolviéndolo en `<kf-section-nav-subsection
2438
+ * key="...">` dentro del mismo slot por defecto — ver esa clase.
2439
+ *
2440
+ * El contenido proyectado usa `[hidden]`, no `@if`: un ítem puede envolver
2441
+ * un formulario con estado que el usuario ya completó, y colapsar/expandir
2442
+ * (o cruzar el breakpoint propio de 1024px, ver `SectionNav.scss`) no debe
2443
+ * destruir ese subárbol.
2444
+ *
2445
+ * <kf-section-nav-item
2446
+ * label="Mis datos personales"
2447
+ * icon="user"
2448
+ * [active]="openSection() === 'datos'"
2449
+ * (toggled)="openSection.set('datos')"
2450
+ * >
2451
+ * ...
2452
+ * </kf-section-nav-item>
2453
+ */
2454
+ declare class SectionNavItem {
2455
+ readonly label: _angular_core.InputSignal<string>;
2456
+ readonly icon: _angular_core.InputSignal<IconName | undefined>;
2457
+ readonly active: _angular_core.InputSignalWithTransform<boolean, unknown>;
2458
+ readonly toggled: _angular_core.OutputEmitterRef<void>;
2459
+ /** Sub-ítems navegables de este ítem, visibles solo mientras `active()`. */
2460
+ readonly subsections: _angular_core.InputSignal<SectionNavSubsectionData[]>;
2461
+ /** `key` del sub-ítem actualmente activo — ver `SectionNavSubsectionData`. */
2462
+ readonly activeSubsection: _angular_core.InputSignal<string | undefined>;
2463
+ readonly subsectionSelected: _angular_core.OutputEmitterRef<string>;
2464
+ protected readonly showSubsections: _angular_core.Signal<boolean>;
2465
+ protected onSubsectionClick(key: string, disabled: boolean | undefined, event: MouseEvent): void;
2466
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SectionNavItem, never>;
2467
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SectionNavItem, "kf-section-nav-item", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "subsections": { "alias": "subsections"; "required": false; "isSignal": true; }; "activeSubsection": { "alias": "activeSubsection"; "required": false; "isSignal": true; }; }, { "toggled": "toggled"; "subsectionSelected": "subsectionSelected"; }, never, ["*"], true, never>;
2468
+ }
2469
+
2470
+ /**
2471
+ * Envoltorio de contenido para UN sub-ítem de `kf-section-nav-item`. Varios
2472
+ * pueden proyectarse juntos, uno por `key` de `subsections()` del padre —
2473
+ * cada uno queda montado siempre (mismo criterio `[hidden]` que el propio
2474
+ * `kf-section-nav-item`), y solo se muestra el que coincide con
2475
+ * `activeSubsection()` del padre.
2476
+ *
2477
+ * <kf-section-nav-item [subsections]="subs" [activeSubsection]="active()" ...>
2478
+ * <kf-section-nav-subsection key="general"><app-general /></kf-section-nav-subsection>
2479
+ * <kf-section-nav-subsection key="seguridad"><app-seguridad /></kf-section-nav-subsection>
2480
+ * </kf-section-nav-item>
2481
+ */
2482
+ declare class SectionNavSubsection {
2483
+ readonly key: _angular_core.InputSignal<string>;
2484
+ private readonly parent;
2485
+ protected readonly isActive: _angular_core.Signal<boolean>;
2486
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SectionNavSubsection, never>;
2487
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SectionNavSubsection, "kf-section-nav-subsection", never, { "key": { "alias": "key"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
2488
+ }
2489
+
2490
+ interface SegmentedOption {
2491
+ value: string;
2492
+ label: string;
2493
+ }
2494
+ /**
2495
+ * Control de segmentos relleno, tipo "iOS segmented control": 2-3 opciones
2496
+ * con un thumb que se desliza detrás de la opción activa.
2497
+ *
2498
+ * La posición del thumb se resuelve con una variable CSS (--kf-segmented-index)
2499
+ * y `transform: translateX()`, así la transición queda a cargo de CSS puro
2500
+ * (mismo criterio que Tabs), sin medir el DOM desde TypeScript.
2501
+ *
2502
+ * <kf-segmented [options]="options" [value]="value" (valueChange)="onChange($event)" />
2503
+ */
2504
+ declare class Segmented {
2505
+ readonly options: _angular_core.InputSignal<SegmentedOption[]>;
2506
+ readonly value: _angular_core.InputSignal<string>;
2507
+ readonly valueChange: _angular_core.OutputEmitterRef<string>;
2508
+ /** Índice de la opción activa; -1 si `value` no matchea ninguna opción. */
2509
+ readonly selectedIndex: _angular_core.Signal<number>;
2510
+ select(nextValue: string): void;
2511
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Segmented, never>;
2512
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Segmented, "kf-segmented", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
2513
+ }
2514
+
2515
+ /** Normalized shape used internally once `options` (string[] or object[]) is resolved. */
2516
+ interface SelectOption {
2517
+ value: string;
2518
+ label: string;
2519
+ }
2520
+ /**
2521
+ * Dropdown de selección simple con panel propio — NUNCA usa el `<select>`
2522
+ * nativo del navegador. Un `<select>` real siempre delega el popup de
2523
+ * opciones al sistema operativo, y ningún CSS puede controlar cómo se ve
2524
+ * ese popup.
2525
+ *
2526
+ * El panel flotante se conecta al trigger vía `@angular/cdk/overlay` — el
2527
+ * mismo mecanismo que `Dropdown` (ver `../dropdown/Dropdown.ts`).
2528
+ *
2529
+ * <kf-select label="Sede" [options]="['Lima', 'Arequipa', 'Trujillo']" placeholder="Selecciona…" />
2530
+ * <kf-select [options]="[{ value: 'pe', label: 'Perú' }]" (valueChange)="onCountry($event)" />
2531
+ *
2532
+ * `variant="compact"` cambia el ancho de `240px` fijo a intrínseco con un
2533
+ * techo de `160px` (se ajusta al contenido de la opción seleccionada hasta
2534
+ * ese máximo, truncando con ellipsis si no entra) y reduce padding/tamaño de
2535
+ * fuente — pensado para selectores cortos embebidos en una barra (ej. "Filas
2536
+ * por página" en el footer de `kf-data-table`), nunca para un campo de
2537
+ * formulario largo, que sigue usando el `variant="field"` por defecto. El
2538
+ * panel flotante siempre mide el ancho real del trigger en cada apertura
2539
+ * (`SelectOverlay.attach`), así que se angosta solo sin cambios adicionales.
2540
+ *
2541
+ * <kf-select variant="compact" [options]="['5', '10', '25']" [value]="pageSize()" (valueChange)="..." />
2542
+ *
2543
+ * `width="full"` ocupa el 100% del contenedor — para selects dentro de
2544
+ * layouts flex/grid donde el ancho fijo de `md` no encaja.
2545
+ *
2546
+ * <kf-select width="full" [options]="branches" [value]="branch()" (valueChange)="..." />
2547
+ */
2548
+ declare class Select {
2549
+ readonly label: _angular_core.InputSignal<string | undefined>;
2550
+ readonly options: _angular_core.InputSignal<string[] | SelectOption[]>;
2551
+ readonly value: _angular_core.InputSignal<string | undefined>;
2552
+ readonly placeholder: _angular_core.InputSignal<string>;
2553
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2554
+ /** Borde en rojo y `aria-invalid` en el trigger. Ver `errorMessage` para el mensaje asociado — mismo contrato que `kf-input`. */
2555
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2556
+ /** Mensaje de error con `role="alert"`, debajo del trigger. */
2557
+ readonly errorMessage: _angular_core.InputSignal<string | undefined>;
2558
+ readonly variant: _angular_core.InputSignal<"field" | "compact">;
2559
+ /**
2560
+ * Ancho del control. 'md' (240px) es el default histórico y preserva el
2561
+ * comportamiento actual sin cambios para consumidores existentes.
2562
+ * 'full' ocupa el 100% del contenedor — para selects dentro de layouts
2563
+ * flex/grid donde el ancho fijo no encaja (ej. un footer de sidebar).
2564
+ */
2565
+ readonly width: _angular_core.InputSignal<"sm" | "md" | "lg" | "full">;
2566
+ /**
2567
+ * Tri-state: si el consumidor no lo especifica (`undefined`), el buscador
2568
+ * se activa solo cuando `options().length` supera `searchThreshold()`. Si
2569
+ * el consumidor define `true`/`false` explícitamente, ese valor manda por
2570
+ * sobre el umbral automático.
2571
+ */
2572
+ readonly searchable: _angular_core.InputSignal<boolean | undefined>;
2573
+ readonly searchThreshold: _angular_core.InputSignal<number>;
2574
+ readonly valueChange: _angular_core.OutputEmitterRef<string>;
2575
+ private readonly instanceId;
2576
+ readonly triggerId: string;
2577
+ readonly listboxId: string;
2578
+ readonly errorId: string;
2579
+ readonly isOpen: _angular_core.WritableSignal<boolean>;
2580
+ readonly searchQuery: _angular_core.WritableSignal<string>;
2581
+ readonly activeIndex: _angular_core.WritableSignal<number>;
2582
+ /** Resolves the union (`string[] | { value; label }[]`) into a single shape for the template. */
2583
+ readonly normalizedOptions: _angular_core.Signal<SelectOption[]>;
2584
+ readonly selectedOption: _angular_core.Signal<SelectOption | undefined>;
2585
+ readonly showSearch: _angular_core.Signal<boolean>;
2586
+ /** Opciones visibles tras aplicar el filtro de búsqueda (case/acento-insensitive). */
2587
+ readonly filteredOptions: _angular_core.Signal<SelectOption[]>;
2588
+ private readonly triggerRef;
2589
+ private readonly panelTemplate;
2590
+ private readonly searchInputRef;
2591
+ private readonly overlay;
2592
+ constructor();
2593
+ /**
2594
+ * Respaldo de `overlayRef.keydownEvents()`: ese observable del CDK solo ve
2595
+ * teclas presionadas con el foco DENTRO del pane del overlay. Si el foco
2596
+ * sigue en el trigger (o en cualquier otro lado de la página) mientras el
2597
+ * panel está abierto, `keydownEvents()` nunca dispara.
2598
+ */
2599
+ onDocumentEscape(): void;
2600
+ toggle(): void;
2601
+ select(option: SelectOption): void;
2602
+ onSearchInput(event: Event): void;
2603
+ /**
2604
+ * Mueve `activeIndex` sobre las opciones YA FILTRADAS visibles. Clamp
2605
+ * simple (sin wraparound): llegar al final o al principio de la lista se
2606
+ * queda ahí en vez de dar la vuelta — es el comportamiento más predecible
2607
+ * cuando se combina con un buscador que puede reducir la lista a 1 opción.
2608
+ */
2609
+ moveActive(delta: number): void;
2610
+ selectActive(): void;
2611
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Select, never>;
2612
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Select, "kf-select", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "searchThreshold": { "alias": "searchThreshold"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
2613
+ }
2614
+
2615
+ interface SelectableCardOption {
2616
+ value: string;
2617
+ label: string;
2618
+ icon?: IconName;
2619
+ }
2620
+ /**
2621
+ * Radio group real (`role="radiogroup"` + `role="radio"` + `aria-checked`),
2622
+ * con apariencia de cards apiladas verticalmente — para una decisión ÚNICA Y
2623
+ * EXCLUYENTE dentro de un flujo (ej. método de pago, tipo de documento a
2624
+ * subir), no para filtrar una lista.
2625
+ *
2626
+ * Distinto de `kf-filter-chips` a propósito: `FilterChips` es semántica y
2627
+ * visualmente un FILTRO (chips horizontales, se resaltan con `--kf-color-ink`
2628
+ * — pensado para "Todos/Activos/Archivados" sobre una lista, donde elegir
2629
+ * una opción cambia qué se MUESTRA). Acá la elección es la respuesta misma
2630
+ * a una pregunta del flujo ("¿con qué método pagás?"), no un filtro — por
2631
+ * eso necesita affordance de radio (círculo con punto, más peso visual por
2632
+ * opción) en vez de un pill de filtro reciclado.
2633
+ *
2634
+ * Réplica fiel del patrón ya resuelto en el Design System de referencia
2635
+ * (`otd-pagos.jsx` / `otd.css`: `.otd-pay-method` + `.radio`) — apilado
2636
+ * vertical con gap 10px, radio de 18px con punto interno vía `::after`,
2637
+ * borde+fondo+ícono cambian de color al seleccionar. Se agrega manejo de
2638
+ * teclado (flechas arriba/abajo, Home/End) y `:focus-visible` real, ninguno
2639
+ * de los dos presentes en el mockup original — mínimos de accesibilidad que
2640
+ * no dependen de fidelidad visual al mockup.
2641
+ *
2642
+ * <kf-selectable-card-group
2643
+ * [options]="[{ value: 'card', label: 'Tarjeta', icon: 'credit-card' }]"
2644
+ * [value]="method()"
2645
+ * (valueChange)="method.set($event)"
2646
+ * />
2647
+ */
2648
+ declare class SelectableCardGroup {
2649
+ readonly options: _angular_core.InputSignal<SelectableCardOption[]>;
2650
+ readonly value: _angular_core.InputSignal<string>;
2651
+ /** Accesible: describe qué está eligiendo el usuario (ej. "Método de pago"). */
2652
+ readonly ariaLabel: _angular_core.InputSignal<string>;
2653
+ readonly valueChange: _angular_core.OutputEmitterRef<string>;
2654
+ select(value: string): void;
2655
+ protected onKeydown(event: KeyboardEvent, currentValue: string): void;
2656
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectableCardGroup, never>;
2657
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectableCardGroup, "kf-selectable-card-group", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
2658
+ }
2659
+
2660
+ /** Contrato de datos de `kf-sidebar-shell.navItems`. `icon` es requerido:
2661
+ * en el sidebar persistente el ícono es parte permanente del diseño.
2662
+ * `groupLabel` opcional agrupa ítems consecutivos bajo un separador con
2663
+ * título (ej. "Beneficios", "Documentos") — ver `SidebarShell` para cómo
2664
+ * decide cuándo pintar el separador. Ausente en items sin agrupar (el
2665
+ * caso de siempre, retrocompatible con cualquier consumidor existente). */
2666
+ interface SidebarNavItemData {
2667
+ icon: IconName;
2668
+ label: string;
2669
+ href: string;
2670
+ active?: boolean;
2671
+ groupLabel?: string;
2672
+ }
2673
+
2674
+ /**
2675
+ * Shell de layout con navegación lateral persistente — el complemento
2676
+ * vertical de `kf-portal-header` (navbar horizontal). Pensado para
2677
+ * portales tipo "aplicación interna" (Portal OTD, Servicio Star).
2678
+ *
2679
+ * `navItems` se recibe como array de datos (no como contenido proyectado):
2680
+ * el componente no sabe nada de routing, emite `navItemClick` con el ítem
2681
+ * clickeado y deja que el consumidor decida cómo navegar.
2682
+ *
2683
+ * Slots: `[kf-sidebar-brand]` (logo del rail expandido, visible en desktop
2684
+ * y en el panel mobile — es el MISMO rail), `[kf-sidebar-brand-collapsed]`
2685
+ * (reemplazo opcional cuando el rail está colapsado en desktop),
2686
+ * `[kf-sidebar-brand-mobile]` (logo de la topbar angosta de mobile, fondo
2687
+ * claro) y `[kf-sidebar-footer]` (tarjeta de usuario / acciones al pie).
2688
+ *
2689
+ * Botón de colapso: vive como último ítem de la propia lista de
2690
+ * navegación, no flotando en el borde del rail — mismo criterio de
2691
+ * tap-target grande y predecible que el resto de los ítems.
2692
+ *
2693
+ * Responsive: bajo los 900px el sidebar NO se reemplaza por un panel
2694
+ * distinto — es el MISMO rail el que pasa a `position: fixed` fuera de la
2695
+ * pantalla (`translateX(-100%)`) y se desliza a la vista (`translateX(0)`)
2696
+ * sobre un backdrop cuando `mobileOpen` es `true`. Una topbar angosta con
2697
+ * botón de hamburguesa reemplaza al rail en el flujo del documento
2698
+ * mientras el panel está cerrado.
2699
+ *
2700
+ * A propósito NO reutiliza `kf-drawer` (el panel lateral genérico de la
2701
+ * librería): `kf-drawer` tiene su propio fondo claro fijo, incompatible
2702
+ * con el texto claro de `kf-sidebar-nav-item` (pensado para el gradiente
2703
+ * oscuro), y duplicaría el árbol de navegación en un segundo lugar del
2704
+ * DOM. Acá hay un solo rail, un solo árbol de nav, que cambia de posición
2705
+ * según el viewport.
2706
+ */
2707
+ declare class SidebarShell {
2708
+ /** Ítems del menú del rail. */
2709
+ readonly navItems: _angular_core.InputSignal<SidebarNavItemData[]>;
2710
+ /**
2711
+ * `navItems()` con el separador de grupo resuelto: solo el PRIMER ítem
2712
+ * de cada tramo consecutivo con el mismo `groupLabel` lo pinta — así el
2713
+ * consumidor no tiene que calcular a mano "es el primero de su grupo"
2714
+ * ni repetir el label en cada ítem. Un ítem sin `groupLabel` nunca pinta
2715
+ * separador (retrocompatible: un `navItems` sin la propiedad se
2716
+ * comporta exactamente igual que antes).
2717
+ */
2718
+ protected readonly itemsWithGroupHeader: _angular_core.Signal<{
2719
+ item: SidebarNavItemData;
2720
+ showGroupLabel: boolean;
2721
+ }[]>;
2722
+ /** Estado de colapso del rail en desktop, two-way. Sin efecto bajo los 900px (ver estilos). */
2723
+ readonly collapsed: _angular_core.ModelSignal<boolean>;
2724
+ /** Visibilidad del rail deslizado como panel en mobile, two-way. */
2725
+ readonly mobileOpen: _angular_core.ModelSignal<boolean>;
2726
+ /** Se emite al clickear un ítem — el consumidor decide cómo navegar (ej. `router.navigateByUrl`). */
2727
+ readonly navItemClick: _angular_core.OutputEmitterRef<SidebarNavItemData>;
2728
+ /** `true` bajo los 900px. */
2729
+ private readonly isMobileViewport;
2730
+ /**
2731
+ * Estado de colapso EFECTIVO — el que ya considera el viewport, no el
2732
+ * `collapsed` crudo. Es lo que usa el propio rail para sus nav-items y
2733
+ * el botón de colapso; se expone público para que el consumidor le
2734
+ * pase el mismo valor a lo que proyecte en `[kf-sidebar-footer]` (ej.
2735
+ * `kf-drawer-session`) — así un footer proyectado no queda colapsado
2736
+ * dentro del panel deslizado de mobile mientras el resto del rail ya
2737
+ * muestra todo expandido.
2738
+ */
2739
+ readonly itemsCollapsed: _angular_core.Signal<boolean>;
2740
+ /** Cierra el panel mobile con Escape — mismo criterio que `Dropdown`/`Modal`/`Drawer`. */
2741
+ protected onEscape(): void;
2742
+ protected onNavItemClick(event: Event, item: SidebarNavItemData): void;
2743
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarShell, never>;
2744
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidebarShell, "kf-sidebar-shell", never, { "navItems": { "alias": "navItems"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "mobileOpen": { "alias": "mobileOpen"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; "mobileOpen": "mobileOpenChange"; "navItemClick": "navItemClick"; }, never, ["[kf-sidebar-brand]", "[kf-sidebar-brand-collapsed]", "[kf-sidebar-footer]", "[kf-sidebar-brand-mobile]"], true, never>;
2745
+ }
2746
+
2747
+ /** Forma del placeholder. */
2748
+ type SkeletonVariant = 'text' | 'circle' | 'rect';
2749
+ /**
2750
+ * Bloque placeholder con shimmer para contenido que todavía carga: una línea
2751
+ * de texto, un avatar o un área de card/imagen, según `variant`.
2752
+ *
2753
+ * Es decorativo (`aria-hidden`): quien lo usa debería marcar el contenedor con
2754
+ * `aria-busy="true"` mientras carga, así el lector de pantalla anuncia el
2755
+ * estado una vez en vez de leer N placeholders vacíos.
2756
+ *
2757
+ * `circle` usa `aspect-ratio`, así que alcanza con darle `width`.
2758
+ *
2759
+ * <kf-skeleton />
2760
+ * <kf-skeleton variant="circle" width="40px" />
2761
+ * <kf-skeleton variant="rect" width="100%" height="120px" />
2762
+ */
2763
+ declare class Skeleton {
2764
+ readonly variant: _angular_core.InputSignal<SkeletonVariant>;
2765
+ /** Ancho CSS. Default `'100%'`. */
2766
+ readonly width: _angular_core.InputSignal<string>;
2767
+ /** Alto CSS. Vacío deja el alto/aspect-ratio propio de la variante. */
2768
+ readonly height: _angular_core.InputSignal<string>;
2769
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Skeleton, never>;
2770
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Skeleton, "kf-skeleton", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2771
+ }
2772
+
2773
+ type SpinnerSize = 'sm' | 'md' | 'lg';
2774
+ /**
2775
+ * Indicador de carga indeterminado: inline, dentro de un botón, o como único
2776
+ * contenido de una sección mientras llega la data.
2777
+ *
2778
+ * Cuando se conoce la forma del contenido que viene, preferir `kf-skeleton`
2779
+ * (dibuja la silueta). El spinner es para "algo está pasando" sin forma
2780
+ * conocida — guardar, enviar, reintentar.
2781
+ *
2782
+ * Lleva `role="status"`, así que el lector de pantalla anuncia el `label`
2783
+ * cuando aparece. Sin `label` cae en un texto accesible por defecto.
2784
+ *
2785
+ * <kf-spinner />
2786
+ * <kf-spinner size="sm" label="Cargando…" />
2787
+ * <kf-spinner onDark />
2788
+ */
2789
+ declare class Spinner {
2790
+ readonly size: _angular_core.InputSignal<SpinnerSize>;
2791
+ /** Texto al lado del anillo. Vacío deja solo el anillo (y el texto para lectores). */
2792
+ readonly label: _angular_core.InputSignal<string>;
2793
+ /** Invierte los colores para fondos oscuros. */
2794
+ readonly onDark: _angular_core.InputSignalWithTransform<boolean, unknown>;
2795
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Spinner, never>;
2796
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Spinner, "kf-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "onDark": { "alias": "onDark"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2797
+ }
2798
+
2799
+ type StatCardTone = 'primary' | 'success' | 'error' | 'purple';
2800
+ /**
2801
+ * Card de estadística horizontal: ícono circular grande a la izquierda,
2802
+ * valor + label + nota apilados al centro, chevron opcional al final si es
2803
+ * clickeable. Distinta de `kf-metric-card` (layout vertical, label arriba +
2804
+ * ícono a la derecha) — este es el patrón real del dashboard de OTD ("Bonos
2805
+ * otorgados", "Cortesías otorgadas"), no una variante de la misma card.
2806
+ *
2807
+ * <kf-stat-card icon="gift" tone="purple" value="4" label="Bonos otorgados" note="$15,000.00 en beneficios" (cardClick)="onNavigate('beneficios')" />
2808
+ */
2809
+ declare class StatCard {
2810
+ readonly icon: _angular_core.InputSignal<IconName>;
2811
+ readonly tone: _angular_core.InputSignal<StatCardTone>;
2812
+ readonly value: _angular_core.InputSignal<string | number>;
2813
+ readonly label: _angular_core.InputSignal<string>;
2814
+ readonly note: _angular_core.InputSignal<string | undefined>;
2815
+ /** Si se escucha `cardClick`, la card se renderiza como botón clickeable con chevron. */
2816
+ readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
2817
+ readonly cardClick: _angular_core.OutputEmitterRef<void>;
2818
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<StatCard, never>;
2819
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatCard, "kf-stat-card", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "note": { "alias": "note"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; }, { "cardClick": "cardClick"; }, never, never, true, never>;
2820
+ }
2821
+
2822
+ /** Vocabulario semántico único de tono, compartido con `TextTone`. */
2823
+ type StatTileTone = 'neutral' | 'ok' | 'warn' | 'error' | 'info';
2824
+ type StatTileVariant = 'inline' | 'card';
2825
+ /**
2826
+ * Indicador numérico compacto: label + valor grande con ícono, para grillas
2827
+ * densas de KPIs. Con `cta` en vez de `value` se convierte en un bloque de
2828
+ * llamada a la acción (título, descripción y link, sin tono ni número).
2829
+ * `variant="inline"` quita fondo/borde para una fila horizontal donde el
2830
+ * consumidor pone sus propios separadores.
2831
+ *
2832
+ * `hasProjectedValue` reemplaza el valor de texto por contenido proyectado
2833
+ * (`[valueContent]`) cuando el dato no es un número/string medido — el
2834
+ * caso típico es un estado con su propio `kf-badge`, que necesita su
2835
+ * tono/dot propios en vez del tono del tile:
2836
+ *
2837
+ * <kf-stat-tile label="Estado" hasProjectedValue>
2838
+ * <kf-badge valueContent [tone]="stateTone()">{{ stateLabel() }}</kf-badge>
2839
+ * </kf-stat-tile>
2840
+ */
2841
+ declare class StatTile {
2842
+ readonly cta: _angular_core.InputSignalWithTransform<boolean, unknown>;
2843
+ readonly label: _angular_core.InputSignal<string | undefined>;
2844
+ readonly value: _angular_core.InputSignal<string | number | undefined>;
2845
+ readonly icon: _angular_core.InputSignal<IconName | undefined>;
2846
+ readonly variant: _angular_core.InputSignal<StatTileVariant>;
2847
+ readonly tone: _angular_core.InputSignal<StatTileTone>;
2848
+ /** Tercera línea bajo el valor. Vacía cae en `notePlaceholder`. */
2849
+ readonly note: _angular_core.InputSignal<string | null | undefined>;
2850
+ /** Qué dice la tercera línea cuando no hay nota. Cada consumidor debería
2851
+ * pasar el motivo real de SU dato ausente, no un texto genérico. */
2852
+ readonly notePlaceholder: _angular_core.InputSignal<string | undefined>;
2853
+ /** Rinde el valor como ausencia, no como dato medido. */
2854
+ readonly valueMissing: _angular_core.InputSignalWithTransform<boolean, unknown>;
2855
+ /** El valor es contenido proyectado (`<ng-content select="[valueContent]">`,
2856
+ * ej. un `kf-badge` de estado) en vez del texto de `value()` — para un
2857
+ * dato cuya representación natural no es un número/string medido. */
2858
+ readonly hasProjectedValue: _angular_core.InputSignalWithTransform<boolean, unknown>;
2859
+ readonly title: _angular_core.InputSignal<string | undefined>;
2860
+ readonly description: _angular_core.InputSignal<string | undefined>;
2861
+ readonly actionLabel: _angular_core.InputSignal<string | undefined>;
2862
+ readonly actionHref: _angular_core.InputSignal<string | undefined>;
2863
+ /** Texto real de la nota. `null` significa "no reservar la línea": pasa
2864
+ * solo cuando el consumidor no declaró ni nota ni placeholder. */
2865
+ protected readonly noteText: _angular_core.Signal<string | null>;
2866
+ protected readonly noteIsPlaceholder: _angular_core.Signal<boolean>;
2867
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<StatTile, never>;
2868
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatTile, "kf-stat-tile", never, { "cta": { "alias": "cta"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "note": { "alias": "note"; "required": false; "isSignal": true; }; "notePlaceholder": { "alias": "notePlaceholder"; "required": false; "isSignal": true; }; "valueMissing": { "alias": "valueMissing"; "required": false; "isSignal": true; }; "hasProjectedValue": { "alias": "hasProjectedValue"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "actionLabel": { "alias": "actionLabel"; "required": false; "isSignal": true; }; "actionHref": { "alias": "actionHref"; "required": false; "isSignal": true; }; }, {}, never, ["[valueContent]"], true, never>;
2869
+ }
2870
+
2871
+ /**
2872
+ * Pill con borde, en mayúsculas y con letter-spacing, pensada para indicadores
2873
+ * de estado únicos y prominentes (ej. "ESTADO TÉCNICO"). El fondo es siempre
2874
+ * transparente; el color de borde/texto/punto depende de `tone`.
2875
+ *
2876
+ * <kf-status-pill tone="ok">Operativo</kf-status-pill>
2877
+ * <kf-status-pill tone="error" dot>Fuera de servicio</kf-status-pill>
2878
+ */
2879
+ declare class StatusPill {
2880
+ readonly tone: _angular_core.InputSignal<"ok" | "warn" | "error" | "blue">;
2881
+ readonly dot: _angular_core.InputSignalWithTransform<boolean, unknown>;
2882
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<StatusPill, never>;
2883
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatusPill, "kf-status-pill", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "dot": { "alias": "dot"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
2884
+ }
2885
+
2886
+ interface TabOption {
2887
+ value: string;
2888
+ label: string;
2889
+ icon?: IconName;
2890
+ }
2891
+ /**
2892
+ * Barra de tabs subrayada: un indicador se desliza hasta la pestaña activa.
2893
+ * La posición se mide (`offsetLeft`/`offsetWidth`) después de cada render,
2894
+ * ya que las pestañas tienen ancho de contenido variable.
2895
+ *
2896
+ * <kf-tabs [options]="tabs" [value]="active" (valueChange)="active = $event" />
2897
+ */
2898
+ declare class Tabs {
2899
+ readonly options: _angular_core.InputSignal<TabOption[]>;
2900
+ readonly value: _angular_core.InputSignal<string>;
2901
+ readonly valueChange: _angular_core.OutputEmitterRef<string>;
2902
+ private readonly track;
2903
+ private readonly destroyRef;
2904
+ private readonly activeRect;
2905
+ protected readonly indicatorTransform: _angular_core.Signal<string>;
2906
+ protected readonly indicatorWidth: _angular_core.Signal<number>;
2907
+ constructor();
2908
+ private measure;
2909
+ select(value: string): void;
2910
+ protected onKeydown(event: KeyboardEvent, currentValue: string): void;
2911
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Tabs, never>;
2912
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Tabs, "kf-tabs", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
2913
+ }
2914
+
2915
+ interface FolderTabOption {
2916
+ value: string;
2917
+ label: string;
2918
+ icon?: IconName;
2919
+ }
2920
+ /**
2921
+ * Marca el contenido que `kf-folder-tabs` debe proyectar dentro de su panel.
2922
+ *
2923
+ * <div kfFolderTabsPanel>...</div>
2924
+ */
2925
+ declare class FolderTabsPanel {
2926
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FolderTabsPanel, never>;
2927
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FolderTabsPanel, "[kfFolderTabsPanel]", never, {}, {}, never, never, true, never>;
2928
+ }
2929
+ /**
2930
+ * Tabs con forma de "carpeta": borde superior redondeado, la pestaña activa
2931
+ * se funde visualmente con el panel de contenido de abajo. El panel
2932
+ * (`kfFolderTabsPanel`) es opcional — sin él, se renderiza solo la fila de
2933
+ * pestañas.
2934
+ *
2935
+ * <kf-folder-tabs [options]="tabs" [value]="active" (valueChange)="active = $event">
2936
+ * <div kfFolderTabsPanel>contenido de la pestaña activa</div>
2937
+ * </kf-folder-tabs>
2938
+ *
2939
+ * <!-- o, sin contenido: -->
2940
+ * <kf-folder-tabs [options]="tabs" [value]="active" (valueChange)="active = $event" />
2941
+ */
2942
+ declare class FolderTabs {
2943
+ readonly options: _angular_core.InputSignal<FolderTabOption[]>;
2944
+ readonly value: _angular_core.InputSignal<string>;
2945
+ readonly valueChange: _angular_core.OutputEmitterRef<string>;
2946
+ /** Id del panel único — todos los tabs lo referencian vía `aria-controls`. */
2947
+ protected readonly panelId: string;
2948
+ private readonly projectedPanel;
2949
+ protected readonly hasPanel: _angular_core.Signal<boolean>;
2950
+ select(value: string): void;
2951
+ protected onKeydown(event: KeyboardEvent, currentValue: string): void;
2952
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FolderTabs, never>;
2953
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FolderTabs, "kf-folder-tabs", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; }, { "valueChange": "valueChange"; }, ["projectedPanel"], ["[kfFolderTabsPanel]"], true, never>;
2954
+ }
2955
+
2956
+ /**
2957
+ * Textarea de formulario apilado: mismo patrón visual y de integración que
2958
+ * `kf-input` (label arriba, `ControlValueAccessor`, funciona con
2959
+ * `[(ngModel)]` y con Reactive Forms) para el caso de texto libre
2960
+ * multilínea (notas, comentarios, descripciones).
2961
+ *
2962
+ * <kf-textarea label="Notas" formControlName="notes" />
2963
+ * <kf-textarea label="Comentario" [(ngModel)]="comment" [minRows]="2" [maxRows]="10" />
2964
+ *
2965
+ * `minRows`/`maxRows` (3 y 6 por defecto) acotan el crecimiento: el campo
2966
+ * crece con el contenido pero nunca pasa de `maxRows` — superado ese tope el
2967
+ * contenido hace scroll interno (`overflow-y: auto`) en vez de seguir
2968
+ * empujando el layout. Reemplaza el `resize: vertical` nativo (deshabilitado
2969
+ * a propósito) porque un resize manual sin tope es exactamente el problema
2970
+ * que motivó este componente: un `<textarea>` a mano podía crecer hasta
2971
+ * tapar los botones del footer de un modal.
2972
+ *
2973
+ * <kf-textarea label="Detalle" formControlName="detail" [maxRows]="12" />
2974
+ *
2975
+ * `invalid` + `errorMessage` y `readonly`/`disabled` siguen el mismo
2976
+ * contrato que `kf-input` — ver su JSDoc para la diferencia entre ambos
2977
+ * estados.
2978
+ */
2979
+ declare class Textarea implements ControlValueAccessor, AfterViewInit {
2980
+ private static nextId;
2981
+ private readonly nativeTextarea;
2982
+ readonly label: _angular_core.InputSignal<string | undefined>;
2983
+ /** Marca el label con un asterisco visual y aplica `required` al
2984
+ * `<textarea>` nativo — el atributo HTML ya expone el estado obligatorio a
2985
+ * lectores de pantalla (mapeo implícito a `aria-required`), sin necesidad
2986
+ * de un `aria-required` explícito redundante. */
2987
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2988
+ readonly hint: _angular_core.InputSignal<string | undefined>;
2989
+ /** Borde y aria-invalid en rojo. Ver `errorMessage` para el mensaje asociado. */
2990
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2991
+ /** Mensaje de error con `role="alert"` — reemplaza a `hint` mientras esté presente. */
2992
+ readonly errorMessage: _angular_core.InputSignal<string | undefined>;
2993
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2994
+ /** Ver JSDoc de `kf-input` para la diferencia con `disabled`. */
2995
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
2996
+ readonly placeholder: _angular_core.InputSignal<string>;
2997
+ /** Filas mínimas visibles en reposo — define la altura de arranque del campo. */
2998
+ readonly minRows: _angular_core.InputSignal<number>;
2999
+ /** Filas máximas antes de que el contenido pase a scroll interno en vez de seguir creciendo. */
3000
+ readonly maxRows: _angular_core.InputSignal<number>;
3001
+ protected readonly textareaId: string;
3002
+ protected readonly hintId: string;
3003
+ protected readonly errorId: string;
3004
+ protected readonly value: _angular_core.WritableSignal<string>;
3005
+ protected readonly focused: _angular_core.WritableSignal<boolean>;
3006
+ /** Deshabilitado por Reactive Forms (formControl.disable()). */
3007
+ private readonly disabledByForm;
3008
+ /** Disabled real: por input() directo o por el FormControl asociado. */
3009
+ protected readonly isDisabled: _angular_core.Signal<boolean>;
3010
+ private onChange;
3011
+ private onTouched;
3012
+ ngAfterViewInit(): void;
3013
+ writeValue(value: string): void;
3014
+ registerOnChange(fn: (value: string) => void): void;
3015
+ registerOnTouched(fn: () => void): void;
3016
+ setDisabledState(isDisabled: boolean): void;
3017
+ protected onInput(rawValue: string): void;
3018
+ protected onBlur(): void;
3019
+ /**
3020
+ * Recalcula la altura según el contenido real (`scrollHeight`), acotada
3021
+ * entre `minRows` y `maxRows` medidos con el line-height ya calculado del
3022
+ * propio elemento — así el tope se mantiene correcto sin importar qué
3023
+ * font-size/line-height termine aplicando cada tema. Superado `maxRows`
3024
+ * el resto del contenido hace scroll interno en vez de seguir creciendo.
3025
+ */
3026
+ private adjustHeight;
3027
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<Textarea, never>;
3028
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Textarea, "kf-textarea", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
3029
+ }
3030
+
3031
+ /**
3032
+ * Da forma al valor de un campo MIENTRAS el usuario escribe — ej.
3033
+ * inserta el guion de un RUT chileno automáticamente, sin que el
3034
+ * usuario tenga que tipearlo — reposicionando el cursor para que
3035
+ * seguir escribiendo se sienta natural (sin esto, cualquier inserción
3036
+ * de caracteres empuja el cursor al final del campo en cada tecla).
3037
+ *
3038
+ * Se aplica junto a `formControlName`/`[formControl]`/`[(ngModel)]`
3039
+ * sobre cualquier input que implemente `ControlValueAccessor` (incluye
3040
+ * `kf-input`, pero no depende de él — funciona igual sobre un
3041
+ * `<input>` nativo):
3042
+ *
3043
+ * <kf-input formControlName="documentId" [kfFormatInput]="formatChileanRut" />
3044
+ *
3045
+ * La función de formateo recibe el valor crudo tecleado y devuelve el
3046
+ * valor con forma — debe ser determinística e idempotente (aplicarla
3047
+ * dos veces seguidas da el mismo resultado), como `formatChileanRut`
3048
+ * en este mismo archivo (`./format.ts`).
3049
+ */
3050
+ declare class FormatInputDirective {
3051
+ private readonly ngControl;
3052
+ /** La función de formateo a aplicar — sin valor, el directive no
3053
+ * hace nada (permite pasar `undefined` condicionalmente sin tener
3054
+ * que quitar el directive del template entero). */
3055
+ readonly kfFormatInput: _angular_core.InputSignal<((value: string) => string) | undefined>;
3056
+ protected onInput(event: Event): void;
3057
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FormatInputDirective, never>;
3058
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FormatInputDirective, "[kfFormatInput]", never, { "kfFormatInput": { "alias": "kfFormatInput"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
3059
+ }
3060
+
3061
+ /**
3062
+ * Grilla de tiles que escalona columnas solo entre DIVISORES de `columns`
3063
+ * (4 → 2 → 1, nunca 3), para que ninguna fila quede huérfana. Mide el
3064
+ * contenedor (`container-type: inline-size`), no el viewport, porque el
3065
+ * mismo bloque se rinde tanto en un drawer angosto como en una página
3066
+ * completa bajo el mismo viewport.
3067
+ */
3068
+ declare class TileGrid {
3069
+ /** Columnas en el ancho máximo. Se acota a 1-6: por encima de 6 un tile
3070
+ * deja de tener ancho para su propio label. */
3071
+ readonly columns: _angular_core.InputSignalWithTransform<number, unknown>;
3072
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<TileGrid, never>;
3073
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TileGrid, "kf-tile-grid", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
3074
+ }
3075
+
3076
+ /**
3077
+ * Visual tone of a toast. Maps to the state tokens in
3078
+ * projects/ui/src/tokens/base.css. `loading` has no auto-dismiss and shows an
3079
+ * indeterminate bar instead of a countdown — pair it with
3080
+ * {@link ToastService.promise}. It reuses the `info` tokens, the closest
3081
+ * semantic role to "work in progress".
3082
+ */
3083
+ type ToastTone = 'success' | 'error' | 'warning' | 'info' | 'loading';
3084
+ /** Acción opcional (call-to-action) renderizada dentro del toast, junto al botón de cerrar. */
3085
+ interface ToastAction {
3086
+ /** Label corto, ej. "Ver ticket" — 1-3 palabras, el toast mide solo 360px de ancho. */
3087
+ label: string;
3088
+ /** Se invoca al hacer click; el toast se cierra solo después, sin que el llamador tenga que llamar `dismiss()`. */
3089
+ onClick: () => void;
3090
+ }
3091
+ /** Options for {@link ToastService.show}. */
3092
+ interface ToastOptions {
3093
+ /** Color tone. Defaults to `'info'`. */
3094
+ tone?: ToastTone;
3095
+ /** Milliseconds before auto-dismiss. Ignored when `tone` is `'loading'`. Defaults to `2800`. */
3096
+ duration?: number;
3097
+ /** Botón de acción opcional, ej. ir al registro sobre el que avisa el toast. */
3098
+ action?: ToastAction;
3099
+ }
3100
+ /** Messages for each leg of {@link ToastService.promise}. */
3101
+ interface ToastPromiseMessages<T = unknown> {
3102
+ loading?: string;
3103
+ success?: string | ((value: T) => string);
3104
+ error?: string | ((error: unknown) => string);
3105
+ }
3106
+ /** The single active toast, as rendered by `kf-toast-host`. */
3107
+ interface ToastState {
3108
+ id: number;
3109
+ message: string;
3110
+ tone: ToastTone;
3111
+ duration: number;
3112
+ leaving: boolean;
3113
+ action?: ToastAction;
3114
+ }
3115
+ /** What's currently holding the auto-dismiss timer paused. Tracked as a set so hover and
3116
+ * focus can overlap (e.g. mouse leaves while focus is still on the action button) without
3117
+ * resuming the timer early. */
3118
+ type ToastPauseSource = 'hover' | 'focus';
3119
+ /**
3120
+ * Shows one toast at a time — a new `show()` call replaces whatever is
3121
+ * currently up (this mirrors a global status line, not a notification stack).
3122
+ *
3123
+ * Angular has no global function that can mount UI on its own, so the
3124
+ * imperative `showToast(...)` of the reference design system becomes a
3125
+ * root-provided service holding signal state: `ToastService.show(...)` sets
3126
+ * the active toast and `ToastHost` (standalone, mounted once in the app
3127
+ * shell) renders it.
3128
+ *
3129
+ * @example
3130
+ * ```ts
3131
+ * // app.ts
3132
+ * imports: [ToastHost]
3133
+ * template: `<kf-toast-host />`
3134
+ *
3135
+ * // anywhere else
3136
+ * private readonly toast = inject(ToastService);
3137
+ * this.toast.show('Vehículo guardado', { tone: 'success' });
3138
+ *
3139
+ * // chains a `loading` toast into the promise's outcome:
3140
+ * this.toast.promise(this.api.save(vehicle), {
3141
+ * loading: 'Guardando…',
3142
+ * success: 'Vehículo guardado',
3143
+ * error: 'No se pudo guardar',
3144
+ * });
3145
+ * ```
3146
+ */
3147
+ declare class ToastService {
3148
+ private readonly _current;
3149
+ private nextId;
3150
+ private dismissTimer?;
3151
+ private removeTimer?;
3152
+ /** Wall-clock time the running `dismissTimer` is due to fire; used to compute how much
3153
+ * time is left when {@link pause} interrupts it. */
3154
+ private dismissDueAt?;
3155
+ /** Time left on the auto-dismiss countdown while paused. `undefined` when no countdown
3156
+ * is currently paused. */
3157
+ private remainingMs?;
3158
+ private readonly pauseSources;
3159
+ /** The single active toast, or `null`. */
3160
+ readonly current: _angular_core.Signal<ToastState | null>;
3161
+ /** Shows a toast, replacing whatever is currently shown. Returns its id. */
3162
+ show(message: string, options?: ToastOptions): number;
3163
+ private scheduleDismiss;
3164
+ /**
3165
+ * Pauses the auto-dismiss countdown for `id` while `source` (pointer hover or focus) is
3166
+ * active on it, so a user reaching for the action/dismiss button never loses the toast
3167
+ * mid-interaction (WCAG 2.2.1). No-op when `id` isn't the active toast, it's leaving, or
3168
+ * it has no running countdown (persistent or `loading` toasts, or already paused by
3169
+ * another source).
3170
+ */
3171
+ pause(id: number, source: ToastPauseSource): void;
3172
+ /**
3173
+ * Resumes a countdown paused by {@link pause}, honoring the time already elapsed before
3174
+ * the pause. No-op while another pause `source` is still active, or nothing is paused.
3175
+ */
3176
+ resume(id: number, source: ToastPauseSource): void;
3177
+ /**
3178
+ * Starts the exit animation, then removes the toast. No-op when `id` is no
3179
+ * longer the active toast, so a stale timer never kills a newer toast.
3180
+ */
3181
+ dismiss(id?: number): void;
3182
+ /**
3183
+ * Shows a `loading` toast, then swaps it for a `success`/`error` toast once
3184
+ * `work` settles. Re-throws `work`'s rejection so callers can still react to
3185
+ * the failure.
3186
+ */
3187
+ promise<T>(work: Promise<T>, messages?: ToastPromiseMessages<T>): Promise<T>;
3188
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastService, never>;
3189
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<ToastService>;
3190
+ }
3191
+ /**
3192
+ * Renders whatever `ToastService` currently holds, fixed bottom-right. Mount
3193
+ * one instance in the app shell (e.g. next to the router outlet); it takes no
3194
+ * inputs and re-renders itself from the service state.
3195
+ *
3196
+ * <kf-toast-host />
3197
+ */
3198
+ declare class ToastHost {
3199
+ private readonly toastService;
3200
+ /** 0-or-1 wrapper so `@for track t.id` remounts the node on every new toast, restarting its animations. */
3201
+ protected readonly toastList: _angular_core.Signal<ToastState[]>;
3202
+ protected toastIcon(tone: ToastTone): IconName;
3203
+ protected dismiss(id: number): void;
3204
+ /** Pauses the toast's auto-dismiss timer while the pointer or keyboard focus is on it. */
3205
+ protected pause(t: ToastState, source: ToastPauseSource): void;
3206
+ /** Resumes the toast's auto-dismiss timer once neither the pointer nor focus is on it. */
3207
+ protected resume(t: ToastState, source: ToastPauseSource): void;
3208
+ /** Ejecuta la acción del toast (ej. "Ver ticket") y lo cierra — el
3209
+ * llamador no tiene que acordarse de descartarlo desde su propio handler. */
3210
+ protected runAction(t: ToastState): void;
3211
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastHost, never>;
3212
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastHost, "kf-toast-host", never, {}, {}, never, never, true, never>;
3213
+ }
3214
+
3215
+ type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
3216
+ /**
3217
+ * Tooltip de hover/focus — reemplaza el atributo `title` nativo del
3218
+ * navegador (lento en aparecer, sin estilo, inconsistente entre
3219
+ * navegadores/SO) por un panel propio, mismo mecanismo de
3220
+ * `@angular/cdk/overlay` que ya usa `Dropdown`.
3221
+ *
3222
+ * Pensado para el caso "ícono sin label visible necesita comunicar qué
3223
+ * es" (ej. `kf-sidebar-nav-item` colapsado). No es two-way: a diferencia
3224
+ * de `Dropdown`, esto se abre/cierra solo con hover/focus, nunca por click.
3225
+ *
3226
+ * <a [kfTooltip]="label()" kfTooltipPosition="right">…</a>
3227
+ */
3228
+ declare class TooltipDirective {
3229
+ text: string;
3230
+ kfTooltipPosition: TooltipPosition;
3231
+ private readonly host;
3232
+ private readonly overlayService;
3233
+ private readonly viewContainerRef;
3234
+ private readonly injector;
3235
+ private readonly contentId;
3236
+ private overlayRef;
3237
+ /**
3238
+ * `focusin` (no `focus`) a propósito: `focus` no burbujea, así que un
3239
+ * disparador que ENVUELVE al elemento realmente enfocable (ej.
3240
+ * `<kf-button>`, cuyo `<button>` nativo vive en el template del hijo, fuera
3241
+ * de alcance de este host) nunca vería el evento — el tooltip quedaría
3242
+ * mudo por teclado justo en el caso de uso que más lo necesita (un botón
3243
+ * solo-ícono). `focusin` SÍ burbujea y sigue disparando igual para el caso
3244
+ * ya cubierto (un `<a>`/`<button>` nativo que es él mismo el host, ver
3245
+ * `Tooltip.spec.ts`) — sin regresión ahí.
3246
+ */
3247
+ protected show(): void;
3248
+ protected hide(): void;
3249
+ /**
3250
+ * `focusout` (no `blur`, mismo motivo que `show()` usa `focusin`): además,
3251
+ * a diferencia de `mouseleave`/Escape, acá SÍ hace falta revisar
3252
+ * `relatedTarget` — si el host envuelve más de un elemento enfocable, un
3253
+ * foco que se mueve de uno a otro DENTRO del mismo host no debería cerrar
3254
+ * el tooltip (no "salió" del disparador). `Node` en vez de `EventTarget`:
3255
+ * `Node.contains()` es lo que existe para chequear pertenencia al árbol.
3256
+ */
3257
+ protected onFocusOut(event: FocusEvent): void;
3258
+ private positionsFor;
3259
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<TooltipDirective, never>;
3260
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TooltipDirective, "[kfTooltip]", never, { "text": { "alias": "kfTooltip"; "required": false; }; "kfTooltipPosition": { "alias": "kfTooltipPosition"; "required": false; }; }, {}, never, never, true, never>;
3261
+ }
3262
+
3263
+ type ViewToggleOption = 'table' | 'cards';
3264
+ /**
3265
+ * Switch de dos posiciones para alternar entre vista de tabla y vista de
3266
+ * tarjetas. Pensado para usarse dentro de DataTable, pero es standalone e
3267
+ * independiente: no asume nada sobre el componente que lo contiene.
3268
+ *
3269
+ * Se implementa como un grupo de radio (role="radiogroup") en vez de dos
3270
+ * botones sueltos: semánticamente es una única selección excluyente entre
3271
+ * dos estados, no dos acciones independientes. Esto también habilita
3272
+ * navegación con flechas izquierda/derecha, igual que un <input type="radio">
3273
+ * nativo agrupado.
3274
+ *
3275
+ * <kf-view-toggle [view]="view" (viewChange)="view = $event" />
3276
+ */
3277
+ declare class ViewToggle {
3278
+ readonly view: _angular_core.InputSignal<ViewToggleOption>;
3279
+ readonly viewChange: _angular_core.OutputEmitterRef<ViewToggleOption>;
3280
+ select(next: ViewToggleOption): void;
3281
+ /** Navegación estándar de ARIA radiogroup: flechas mueven foco y seleccionan. */
3282
+ onKeydown(event: KeyboardEvent): void;
3283
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ViewToggle, never>;
3284
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ViewToggle, "kf-view-toggle", never, { "view": { "alias": "view"; "required": true; "isSignal": true; }; }, { "viewChange": "viewChange"; }, never, never, true, never>;
3285
+ }
3286
+
3287
+ export { ActionTile, AdminBadge, Alert, AlertRow, Avatar, Badge, Breadcrumb, BucketProgress, Button, Card, Carousel, CarouselSlide, Checkbox, Chip, Collapsible, ContactPopover, ContentSlot, ContentState, ContentViewer, DEFAULT_PAGE_SIZE_OPTIONS, DataTable, Divider, DocumentRow, Drawer, Dropdown, DropdownItem, DropdownPanel, EmptyState, EventTimeline, FeatureCard, Field, FieldLabel, Filter, FilterChips, FolderTabs, FolderTabsPanel, Footer, FormatInputDirective, Icon, Input, JourneyStepper, Link, MetricCard, Modal, MultiSelect, NoteBlock, PageHeader, Pagination, Panel, PortalHeader, Progress, PulseDot, RowActions, SectionHeader, SectionNav, SectionNavItem, SectionNavSubsection, Segmented, Select, SelectableCardGroup, SidebarShell, Skeleton, Spinner, StatCard, StatTile, StatusPill, Tabs, Text, Textarea, TileGrid, ToastHost, ToastService, TooltipDirective, ViewToggle, dataTableViewSignal };
3288
+ export type { AlertRowTone, AlertTone, BreadcrumbItem, BucketProgressItem, ContentStateKind, ContentStateLoad, ContentViewerType, DataTableCardRole, DataTableColumn, DataTableDensity, DataTableSort, DataTableView, DividerOrientation, DocumentRowTone, DrawerSide, DropdownItemTone, DropdownPanelVariant, EventTimelineItem, EventTimelineTone, FilterFieldChange, FilterFieldConfig, FilterFieldType, FilterValue, FolderTabOption, FooterLink, IconName, IconRotation, IconSize, JourneyStep, JourneyStepStatus, JourneyStepperColorScheme, JourneyStepperSurface, LinkVariant, MultiSelectOption, NoteBlockTone, PageHeaderTitleSize, PaginationItem, PortalHeaderAdminAction, PortalHeaderNavItem, ProgressTone, RowAction, RowActionKind, RowActionsMode, SectionNavSubsectionData, SegmentedOption, SelectableCardOption, SidebarNavItemData, SkeletonVariant, SpinnerSize, StatCardTone, StatTileTone, StatTileVariant, TabOption, TextAs, TextTone, TextVariant, ToastAction, ToastOptions, ToastPromiseMessages, ToastState, ToastTone, TooltipPosition, ViewToggleOption };