@kaufmann-lab/ui 0.1.17 → 0.1.19

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