ngx-eiffage-material 0.4.0 → 0.6.0

package/index.d.ts

@@ -5,21 +5,29 @@ import { FormBuilder, FormGroup, FormArray, AbstractControl, ControlValueAccesso
 import { ErrorStateMatcher } from '@angular/material/core';
 import { MatFormFieldAppearance, SubscriptSizing } from '@angular/material/form-field';
 import { MatSelect, MatSelectChange } from '@angular/material/select';
+import { Observable, Subject } from 'rxjs';
 import { MatDialogRef, MatDialogConfig } from '@angular/material/dialog';
 import { DateRange } from '@angular/material/datepicker';
 import { MatMenuTrigger } from '@angular/material/menu';
 import { PageEvent, MatPaginator } from '@angular/material/paginator';
 import { SortDirection, Sort } from '@angular/material/sort';
-import { Observable, Subject } from 'rxjs';
 import jsPDF from 'jspdf';
 import moment from 'moment';
 import { MatTableDataSource } from '@angular/material/table';
 import { MatChipEvent } from '@angular/material/chips';
 
 interface BasicSelectConfig<T> {
+    /** Propiedad de la opción que se usa como valor del control. */
     valueKey: keyof T;
+    /** Texto de cada opción (en la lista y en el campo). */
     displayedLabel: (item: T) => string;
+    /** Opciones que se ven pero no se pueden elegir. */
     disabled?: (item: T) => boolean;
+    /**
+     * Buscador del desplegable: `true` (por defecto) siempre, `false` nunca, o un número para
+     * mostrarlo solo cuando haya más opciones que ese número (p. ej. `7`: no sale en listas cortas).
+     */
+    search?: boolean | number;
 }
 /**
  * Configuration for NgxPaginatedSelect.
@@ -53,6 +61,17 @@ interface PaginatedSelectConfig<T> {
     avatarText?: (item: T) => string;
     /** Material icon name shown as avatar when `avatarImage`/`avatarText` are not provided */
     avatarIcon?: string;
+    /**
+     * Busca los elementos completos a partir de sus claves. Si el valor llega del formulario solo con
+     * ids (sin `selectedItems`), el componente lo usa para mostrar sus nombres en vez de los ids.
+     * Las claves son valores de `valueKey`: se tipan como `any[]` para poder escribir
+     * `(ids: number[]) => …` sin conversiones (TypeScript no sabe el tipo concreto de `valueKey`).
+     */
+    loadByKeys?: (keys: any[]) => Observable<T[]>;
+    /** Milisegundos de espera tras la última tecla antes de buscar. Por defecto, 400. */
+    searchDebounce?: number;
+    /** Caracteres mínimos para buscar (con menos, se mantiene la lista y se avisa). Por defecto, 1. */
+    minSearchLength?: number;
 }
 
 interface PaginatedItems<T> {
@@ -482,6 +501,17 @@ interface NgxEiffageTexts {
         dateRangeEnd: string;
         totalPerPage: string;
         totalGeneral: string;
+        /** Exportar en ngx-basic-table: todos los registros filtrados, no solo la página. */
+        exportExcelAll: string;
+        exportPdfAll: string;
+        /** Casilla de selección de una fila (lectores de pantalla). */
+        selectRow: string;
+        /** Casilla de la cabecera: seleccionar las filas de la página. */
+        selectPage: string;
+        expandRow: string;
+        collapseRow: string;
+        /** Nombre del filtro de columna en la opción «Sin …» de los selects de filtro. */
+        columnFilter: string;
     };
     /** Diálogo de ordenar y mostrar columnas de las tablas. */
     columnsDialog: {
@@ -537,6 +567,8 @@ interface NgxEiffageTexts {
     select: {
         noResults: string;
         showMore: string;
+        /** Etiqueta accesible del botón X que quita la selección (clearable). */
+        clear: string;
         removeOption: (optionName: string) => string;
         resultsCount: (count: number) => string;
     };
@@ -554,6 +586,18 @@ interface NgxEiffageTexts {
         retry: string;
         selectedCount: (selected: number, total: number) => string;
         resultsCount: (total: number) => string;
+        /** Etiqueta accesible del botón que quita un elemento seleccionado (chips). */
+        removeItem: (label: string) => string;
+        /** Texto accesible del indicador «+N» de chips que no caben. */
+        moreSelected: (count: number) => string;
+        /** Resumen de la selección en modo texto: las primeras etiquetas y cuántas más hay. */
+        summary: (labels: string[], rest: number) => string;
+        /** Aviso al cerrar el panel múltiple con cambios sin confirmar. */
+        discardChanges: string;
+        discard: string;
+        keepEditing: string;
+        /** Búsqueda demasiado corta (minSearchLength). */
+        minSearch: (min: number) => string;
     };
     /** NgxDialogService y ngx-dialog (botones por defecto). */
     dialog: {
@@ -1010,7 +1054,7 @@ interface ResolvedOption<T> {
     disabled: boolean;
     visible: boolean;
 }
-declare class NgxBasicSelect<T> implements ControlValueAccessor {
+declare class NgxBasicSelect<T> implements ControlValueAccessor, AfterViewInit, DoCheck {
     readonly texts: _angular_core.Signal<ngx_eiffage_material.NgxEiffageTexts>;
     /**
      * Se auto-registra como ControlValueAccessor del control del formulario.
@@ -1025,19 +1069,21 @@ declare class NgxBasicSelect<T> implements ControlValueAccessor {
     readonly label: _angular_core.InputSignal<string>;
     readonly options: _angular_core.InputSignal<T[]>;
     readonly basicSelectConfig: _angular_core.InputSignal<BasicSelectConfig<T>>;
-    readonly isLoading: _angular_core.InputSignal<boolean>;
+    readonly isLoading: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly subscriptSizing: _angular_core.InputSignal<SubscriptSizing>;
     readonly appearance: _angular_core.InputSignal<"fill" | "outline">;
-    readonly multiple: _angular_core.InputSignal<boolean>;
-    readonly disabled: _angular_core.InputSignal<boolean>;
-    readonly clearable: _angular_core.InputSignal<boolean>;
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly error: _angular_core.InputSignal<string>;
     readonly class: _angular_core.InputSignal<string>;
     /** Emite el/los valor(es) de `valueKey` al cambiar la selección. */
     selectionChange: _angular_core.OutputEmitterRef<T[keyof T] | T[keyof T][] | null>;
     readonly matSelect: _angular_core.Signal<MatSelect>;
     readonly searchInput: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
+    /** Igual que matSelect, pero sin fallar antes de crear la vista (ngDoCheck se llama antes). */
+    private readonly _matSelectRef;
     /** FormControl interno que gobierna el mat-select (independiente del control del form). */
     protected readonly innerControl: FormControl<any>;
     /** Copia del valor como signal, para leerlo reactivamente en plantilla (OnPush). */
@@ -1046,6 +1092,8 @@ declare class NgxBasicSelect<T> implements ControlValueAccessor {
     private readonly cvaDisabled;
     /** Estado del buscador (signal, no el DOM, para funcionar en zoneless). */
     protected readonly searchQuery: _angular_core.WritableSignal<string>;
+    /** Anchos (en %) de las filas fantasma mientras se carga: distintos para que parezca texto. */
+    protected readonly skeletonWidths: number[];
     private onChange;
     private onTouched;
     /** Deshabilitado efectivo: input `disabled` o el que llega del formulario. */
@@ -1056,6 +1104,8 @@ declare class NgxBasicSelect<T> implements ControlValueAccessor {
      * pudiendo pintar la etiqueta del valor seleccionado aunque esté filtrado.
      */
     protected readonly resolvedOptions: _angular_core.Signal<ResolvedOption<T>[]>;
+    /** Buscador visible según `basicSelectConfig.search` (true, false o número mínimo de opciones). */
+    protected readonly showSearch: _angular_core.Signal<boolean>;
     /** Hay datos de entrada (con independencia del buscador). */
     protected readonly hasData: _angular_core.Signal<boolean>;
     /**
@@ -1080,14 +1130,17 @@ declare class NgxBasicSelect<T> implements ControlValueAccessor {
      */
     protected readonly errorStateMatcher: ErrorStateMatcher;
     /**
-     * Obligatorio si el control del formulario tiene el validador `required`.
-     * Se propaga al mat-select interno para que el mat-form-field pinte el
-     * asterisco, igual que hace Material con un `<input matInput>`.
+     * Obligatorio si el control del formulario tiene el validador `required`. Se propaga al
+     * mat-select interno para que el mat-form-field pinte el asterisco. Es un signal (no un
+     * método en plantilla): se actualiza con los eventos del control y en cada ngDoCheck.
      */
-    protected isRequired(): boolean;
+    protected readonly isRequired: _angular_core.WritableSignal<boolean>;
     /** true cuando el formulario contenedor ya ha intentado enviarse. */
     private _isParentFormSubmitted;
     constructor();
+    ngAfterViewInit(): void;
+    ngDoCheck(): void;
+    private _syncFormState;
     writeValue(value: any): void;
     registerOnChange(fn: (value: any) => void): void;
     registerOnTouched(fn: () => void): void;
@@ -1124,7 +1177,6 @@ declare class NgxDialog<T = any, R = unknown> implements NgxDialogContext<R> {
     readonly destructive: boolean;
     /** La X no tiene sentido en un diálogo con disableClose (está pensado para no poder cerrarse sin decidir). */
     readonly showClose: boolean;
-    readonly closeLabel: string;
     readonly cancelText: string;
     readonly confirmText: string;
     readonly result: _angular_core.WritableSignal<R | undefined>;
@@ -1138,6 +1190,44 @@ declare class NgxDialog<T = any, R = unknown> implements NgxDialogContext<R> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxDialog<any, any>, "ngx-dialog", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Encabezado de diálogo con botón X para cerrar: el mismo que usa ngx-dialog, para diálogos propios
+ * abiertos con MatDialog. Va en lugar de `<h2 mat-dialog-title>`:
+ *
+ * ```html
+ * <ngx-dialog-header [title]="'Editar proyecto'" icon="edit" />
+ * <!-- o con contenido propio -->
+ * <ngx-dialog-header>{{ (isNew ? 'PROJECTS.create' : 'PROJECTS.edit') | translate }}</ngx-dialog-header>
+ * ```
+ */
+declare class NgxDialogHeader implements DoCheck {
+    private readonly _dialogRef;
+    protected readonly texts: _angular_core.Signal<ngx_eiffage_material.NgxEiffageTexts>;
+    /** Título. También se puede poner como contenido (`<ngx-dialog-header>…</ngx-dialog-header>`). */
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    /** Línea secundaria bajo el título. */
+    readonly subtitle: _angular_core.InputSignal<string | undefined>;
+    /** Icono de Material Symbols delante del título. */
+    readonly icon: _angular_core.InputSignal<string | undefined>;
+    /** Color del icono (p. ej. `var(--mat-sys-error)`). */
+    readonly iconColor: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Muestra la X. Sin indicar, se ve mientras el diálogo se pueda cerrar: se oculta si el diálogo tiene
+     * `disableClose` (también si se activa después, p. ej. durante una subida) y vuelve al quitarlo.
+     */
+    readonly showClose: _angular_core.InputSignal<boolean | undefined>;
+    /** Valor con el que se cierra al pulsar la X. Por defecto `undefined`, igual que con Esc o al pulsar fuera. */
+    readonly closeResult: _angular_core.InputSignal<unknown>;
+    /** disableClose es una propiedad normal del MatDialogRef: se lee en cada comprobación. */
+    private readonly _closable;
+    protected readonly closeVisible: _angular_core.Signal<boolean>;
+    ngDoCheck(): void;
+    /** Cierra el diálogo con `closeResult`. */
+    close(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxDialogHeader, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxDialogHeader, "ngx-dialog-header", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconColor": { "alias": "iconColor"; "required": false; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "closeResult": { "alias": "closeResult"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
 /**
  * @deprecated Usar `NgxDialogService.confirm()` (o `template()` con contenido propio), que tiene el
  * encabezado, el botón X y la opción `destructive` de ngx-dialog. Las tablas ya no lo usan; se
@@ -1157,17 +1247,19 @@ declare class NgxPaginatedTable<T, U extends PaginatedFilter<T>> implements OnDe
     private readonly dialog;
     private readonly dialogService;
     private readonly datosPantallaService;
+    private readonly _host;
+    private readonly _destroyRef;
     readonly texts: Signal<ngx_eiffage_material.NgxEiffageTexts>;
     protected isDesktop: Signal<boolean>;
     endpoint: _angular_core.InputSignal<(filters: U) => Observable<PaginatedItems<T>>>;
     filters: _angular_core.InputSignal<WritableSignal<U>>;
     config: _angular_core.InputSignal<WritableSignal<PaginatedTableConfig<T>>>;
-    protected createClick: _angular_core.OutputEmitterRef<void>;
-    protected updateClick: _angular_core.OutputEmitterRef<T>;
-    protected deleteClick: _angular_core.OutputEmitterRef<T>;
-    protected rowActionClick: _angular_core.OutputEmitterRef<RowActionClickEvent<T>>;
-    protected expandedItemChange: _angular_core.OutputEmitterRef<T | null>;
-    protected selectionActionEvent: _angular_core.OutputEmitterRef<SelectionActionEvent<T>>;
+    readonly createClick: _angular_core.OutputEmitterRef<void>;
+    readonly updateClick: _angular_core.OutputEmitterRef<T>;
+    readonly deleteClick: _angular_core.OutputEmitterRef<T>;
+    readonly rowActionClick: _angular_core.OutputEmitterRef<RowActionClickEvent<T>>;
+    readonly expandedItemChange: _angular_core.OutputEmitterRef<T | null>;
+    readonly selectionActionEvent: _angular_core.OutputEmitterRef<SelectionActionEvent<T>>;
     protected readonly filterKeyPrefix = "filter";
     protected readonly nameOfActionsColumn = "actionsPerRow";
     protected readonly generalFooterKeyPrefix = "footer";
@@ -1185,21 +1277,30 @@ declare class NgxPaginatedTable<T, U extends PaginatedFilter<T>> implements OnDe
     protected showActionsColumn: Signal<boolean>;
     protected showTotalPerPageFooter: Signal<boolean>;
     protected showTotalGeneralFooter: Signal<boolean>;
+    /** Texto del buscador (para la X de borrar; antes se leía el DOM desde la plantilla). */
+    protected readonly queryText: WritableSignal<string>;
+    /** Texto de cada celda de la página (sin componente ni plantilla), calculado una vez. */
+    protected readonly cellTexts: Signal<Map<T, Record<keyof T, string>>>;
+    /** Total por página (de lo cargado) y general (lo da el consumidor con getTotalGeneral), ya formateados. */
+    protected readonly pageTotals: Signal<Record<string, string>>;
+    protected readonly generalTotals: Signal<Record<string, string>>;
+    /** Descripción del filtro avanzado aplicado (HTML). */
+    protected readonly advancedFilterLabel: Signal<string>;
     protected queryTimeout: number | undefined;
     protected timeoutsByKey: Partial<Record<keyof T, number>>;
     protected advancedFilters: Signal<AdvancedFilter<T>[]>;
     protected readonly expandableColumnDef = "expandedDetail";
     protected expandedItem: WritableSignal<T | null>;
     protected selection: WritableSignal<T[]>;
+    /** Claves de las filas seleccionadas: comprobar una fila es O(1). */
+    private readonly _selectedKeys;
+    protected readonly allPageSelected: Signal<boolean>;
     protected isFullScreen: WritableSignal<boolean>;
     private readonly overlay;
-    private readonly overlayContainer;
     private readonly viewContainerRef;
     tableContentTemplate: Signal<TemplateRef<any> | undefined>;
     private overlayRef?;
-    private portal?;
     protected defaultFiltersForPaginatedFilterOptions: WritableSignal<PaginatedFilter<FilterOption>>;
-    onEscape(): void;
     ngOnDestroy(): void;
     private includeInColumnConfig;
     protected getKeyAsString: (columnKey: keyof T | string) => string;
@@ -1224,34 +1325,32 @@ declare class NgxPaginatedTable<T, U extends PaginatedFilter<T>> implements OnDe
     protected getSearchableSelectValueOfColumnFilter(key: keyof T): string | string[] | undefined;
     protected getDateRangeValueOfColumnFilter(key: keyof T, type: 'start' | 'end'): moment.Moment | null;
     protected onEditColumns(): void;
-    protected applyColumnPipes(value: any, pipes?: ColumnPipe | ColumnPipe[]): any;
     protected onNewAdvancedFiltersClick(): void;
     protected onApplyTemplateClick(advancedFilter?: AdvancedFilter<T>): void;
     protected onSelectedAdvancedFilterUpdate(event: Event): void;
     protected onAdvancedFilterUpdate(event: Event, advancedFilter: AdvancedFilter<T>, advancedFiltersMenuTrigger?: MatMenuTrigger): void;
     protected onAdvancedFilterDelete(event: Event, advancedFiltersMenuTrigger: MatMenuTrigger, advancedFilter: AdvancedFilter<T>): void;
     protected onQuitAdvancedFilter(event: Event): void;
-    protected getAdvancedFilterLabel(): string;
+    /** Por clave y no por referencia: el detalle sigue abierto si la página se recarga. */
     protected rowIsExpanded(row: T): boolean;
     protected expandableToggle(row: T): void;
-    protected getTotalOfColum(columnKey: keyof T): number;
-    protected areEqualByKeys(record1: T, record2: T): boolean;
+    /** Lo que se pinta en una celda sin componente ni plantilla: valueGetter, o el valor con sus pipes, o «-». */
+    private displayText;
+    private totalsText;
     protected isRowSelected(row: T): boolean;
     protected toggleRowSelection(row: T): void;
-    protected isAllPageRowSelected(): boolean;
     protected toggleAllPageRowSelection(): void;
     private getSelectableRows;
     protected getRowSelectionAction(): RowSelectionAction<T>[];
     protected uncheckAllSelection(): void;
     protected onRowSelectionActionClick(actionId: string): void;
-    private getDocumentHeaders;
-    private getDocumentRows;
+    /** Exporta la página cargada, con las columnas visibles y en el orden elegido. */
     protected exportToCsvCurrentPage(): void;
     protected exportToPdfCurrentPage(): void;
+    private exportOptions;
     protected onToggleFullScreen(): void;
     private enterFullscreen;
     private exitFullscreen;
-    private isMyOverlayOnTop;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxPaginatedTable<any, any>, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxPaginatedTable<any, any>, "ngx-paginated-table", never, { "endpoint": { "alias": "endpoint"; "required": true; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "createClick": "createClick"; "updateClick": "updateClick"; "deleteClick": "deleteClick"; "rowActionClick": "rowActionClick"; "expandedItemChange": "expandedItemChange"; "selectionActionEvent": "selectionActionEvent"; }, never, ["[icon-buttons]", "[more-filters]", "[extra-header-content]", "[end-container]"], true, never>;
 }
@@ -1261,6 +1360,8 @@ declare class NgxBasicTable<T, U extends BasicFilter<T>> {
     private readonly dialog;
     private readonly dialogService;
     private readonly datosPantallaService;
+    private readonly _host;
+    private readonly _destroyRef;
     readonly texts: _angular_core.Signal<ngx_eiffage_material.NgxEiffageTexts>;
     protected isDesktop: _angular_core.Signal<boolean>;
     filters: _angular_core.InputSignal<WritableSignal<U>>;
@@ -1269,14 +1370,22 @@ declare class NgxBasicTable<T, U extends BasicFilter<T>> {
     loading: _angular_core.InputSignal<boolean>;
     queryFilter: _angular_core.InputSignal<((query: string, data: T[]) => T[]) | undefined>;
     moreFilters: _angular_core.InputSignal<(data: T[], filters: U) => T[]>;
-    protected createClick: _angular_core.OutputEmitterRef<void>;
-    protected updateClick: _angular_core.OutputEmitterRef<T>;
-    protected deleteClick: _angular_core.OutputEmitterRef<T>;
-    protected rowActionClick: _angular_core.OutputEmitterRef<RowActionClickEvent<T>>;
-    protected expandedItemChange: _angular_core.OutputEmitterRef<T | null>;
-    protected selectionActionEvent: _angular_core.OutputEmitterRef<SelectionActionEvent<T>>;
+    readonly createClick: _angular_core.OutputEmitterRef<void>;
+    readonly updateClick: _angular_core.OutputEmitterRef<T>;
+    readonly deleteClick: _angular_core.OutputEmitterRef<T>;
+    readonly rowActionClick: _angular_core.OutputEmitterRef<RowActionClickEvent<T>>;
+    readonly expandedItemChange: _angular_core.OutputEmitterRef<T | null>;
+    readonly selectionActionEvent: _angular_core.OutputEmitterRef<SelectionActionEvent<T>>;
+    protected paginator: _angular_core.Signal<MatPaginator | undefined>;
+    /** Búsqueda, orden, filtros de columna y moreFilters aplicados: lo que se pagina y se exporta. */
+    protected readonly filteredData: _angular_core.Signal<T[]>;
     dataSource: _angular_core.Signal<MatTableDataSource<T, MatPaginator>>;
-    filtersEffect: _angular_core.EffectRef;
+    private readonly _syncData;
+    /** Filas de la página visible (cambia con el paginador): totales por página y «seleccionar página». */
+    protected readonly pageRows: _angular_core.Signal<T[]>;
+    /** Al cambiar la búsqueda, el orden o un filtro se vuelve a la primera página. */
+    private _lastFilters?;
+    private readonly _resetPage;
     protected columnConfig: _angular_core.Signal<ColumnConfig<T>[]>;
     protected readonly filterKeyPrefix = "filter";
     protected readonly nameOfActionsColumn = "actionsPerRow";
@@ -1291,29 +1400,39 @@ declare class NgxBasicTable<T, U extends BasicFilter<T>> {
     protected showTotalPerPageFooter: _angular_core.Signal<boolean>;
     protected showTotalGeneralFooter: _angular_core.Signal<boolean>;
     protected showQueryFilter: _angular_core.Signal<boolean>;
+    /** Texto del buscador (para la X de borrar; antes se leía el DOM desde la plantilla). */
+    protected readonly queryText: WritableSignal<string>;
+    /** Texto de cada celda de la página (sin componente ni plantilla), calculado una vez. */
+    protected readonly cellTexts: _angular_core.Signal<Map<T, Record<keyof T, string>>>;
+    /** Totales por página y generales ya formateados, por clave de columna. */
+    protected readonly pageTotals: _angular_core.Signal<Record<string, string>>;
+    protected readonly generalTotals: _angular_core.Signal<Record<string, string>>;
     protected tableContentTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
     protected isFullScreen: WritableSignal<boolean>;
     private overlayRef?;
-    private portal?;
     private readonly overlay;
-    private readonly overlayContainer;
     private readonly viewContainerRef;
     protected selection: WritableSignal<T[]>;
+    /** Claves de las filas seleccionadas: comprobar una fila es O(1). */
+    private readonly _selectedKeys;
+    protected readonly allPageSelected: _angular_core.Signal<boolean>;
     protected readonly expandableColumnDef = "expandedDetail";
     protected expandedItem: WritableSignal<T | null>;
-    protected paginator: _angular_core.Signal<MatPaginator | undefined>;
     protected defaultFiltersForPaginatedFilterOptions: WritableSignal<PaginatedFilter<FilterOption>>;
+    constructor();
     protected getKeyAsString: (columnKey: keyof T | string) => string;
     private includeInColumnConfig;
-    protected onEscape(): void;
     private someColumnFilterable;
+    /** Busca en el texto que se ve de cada columna buscable (también números, fechas con pipe y valueGetter). */
     private applyInputFilter;
     private applySort;
     private applyColumnFilter;
+    /** Lo que se pinta en una celda sin componente ni plantilla: valueGetter, o el valor con sus pipes, o «-». */
+    private displayText;
+    private totalsText;
     protected onToggleFullScreen(): void;
     private enterFullscreen;
     private exitFullscreen;
-    private isMyOverlayOnTop;
     protected onNewClick(): void;
     protected onUpdateClick(row: T, event: Event): void;
     protected onRowClick(row: T): void;
@@ -1324,22 +1443,16 @@ declare class NgxBasicTable<T, U extends BasicFilter<T>> {
     protected getRowSelectionAction(): RowSelectionAction<T>[];
     protected uncheckAllSelection(): void;
     protected onRowSelectionActionClick(actionId: string): void;
-    private getDocumentHeaders;
-    private getDocumentRows;
+    /** Exporta todos los registros filtrados, con las columnas visibles y en el orden elegido. */
     protected exportToCsv(): void;
     protected exportToPdf(): void;
+    private exportOptions;
     protected onQueryChange(inputElement: HTMLInputElement): void;
     protected onQueryReset(inputElement: HTMLInputElement): void;
     protected onSortChange(sort: Sort): void;
     protected toggleAllPageRowSelection(): void;
-    protected isAllPageRowSelected(): boolean;
-    protected areEqualByKeys(record1: T, record2: T): boolean;
     protected isRowSelected(row: T): boolean;
     protected toggleRowSelection(row: T): void;
-    protected applyColumnPipes(value: any, pipes?: ColumnPipe | ColumnPipe[]): any;
-    protected getTotalPerPageOfColum(columnKey: keyof T): number;
-    protected getDataOfCurrentPage(): T[];
-    protected getTotalOfColum(columnKey: keyof T): number;
     protected getValueOfColumnFilter(key: keyof T): ColumnValue;
     protected getPaginatedSearchableSelectValueOfColumnFilter(key: keyof T): FilterOption | FilterOption[] | undefined;
     protected getSearchableSelectValueOfColumnFilter(key: keyof T): string | string[] | undefined;
@@ -1350,6 +1463,7 @@ declare class NgxBasicTable<T, U extends BasicFilter<T>> {
     protected onDateFilterChange(column: BasicTableColumn<T>, value: moment.Moment | null): void;
     protected onDateRangeFilterChange(column: BasicTableColumn<T>, value: DateRange<moment.Moment | null> | null): void;
     private onColumnFilterChange;
+    /** Por clave y no por referencia: el detalle sigue abierto si los datos se recargan. */
     protected rowIsExpanded(row: T): boolean;
     protected expandableToggle(row: T): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxBasicTable<any, any>, never>;
@@ -1490,7 +1604,7 @@ declare class NgxAlert {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxAlert, "ngx-alert", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "hideIcon": { "alias": "hideIcon"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "dismissLabel": { "alias": "dismissLabel"; "required": false; "isSignal": true; }; "politeness": { "alias": "politeness"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; }, never, ["*", "[alertActions]"], true, never>;
 }
 
-declare class NgxPaginatedSelect<T, U extends PaginatedFilter<T>> implements ControlValueAccessor {
+declare class NgxPaginatedSelect<T, U extends PaginatedFilter<T>> implements ControlValueAccessor, AfterViewInit, DoCheck {
     private readonly _bottomSheet;
     /** Se auto-registra como CVA (self/optional para leer validación y no fallar sin form). */
     private readonly _ngControl;
@@ -1498,6 +1612,8 @@ declare class NgxPaginatedSelect<T, U extends PaginatedFilter<T>> implements Con
     private readonly _parentFormGroup;
     private readonly _parentForm;
     private readonly _changeDetectorRef;
+    private readonly _destroyRef;
+    private readonly _host;
     readonly texts: _angular_core.Signal<ngx_eiffage_material.NgxEiffageTexts>;
     /** Label that floats on the form field */
     readonly label: _angular_core.InputSignal<string>;
@@ -1577,28 +1693,52 @@ declare class NgxPaginatedSelect<T, U extends PaginatedFilter<T>> implements Con
     private _suppressEmit;
     /** Huella de la última selección aplicada desde el input `selectedItems`. */
     private _lastSyncedSelection;
+    /** Primera página de la última apertura: la siguiente se pinta al instante mientras recarga. */
+    private readonly _pageCache;
+    /** Claves ya pedidas a config.loadByKeys (no se repiten aunque fallen). */
+    private readonly _requestedKeys;
+    /** Resolviendo etiquetas con config.loadByKeys. */
+    protected readonly isResolving: WritableSignal<boolean>;
     protected readonly isDisabled: _angular_core.Signal<boolean>;
+    /** Todas las etiquetas seleccionadas, separadas por comas (tooltip del modo texto). */
+    protected readonly fullLabel: _angular_core.Signal<string>;
+    /** Lo que se ve en el modo texto: en múltiple, las 3 primeras y «y N más». */
     protected readonly selectedLabel: _angular_core.Signal<string>;
     protected readonly hasSelection: _angular_core.Signal<boolean>;
     protected readonly showChips: _angular_core.Signal<boolean>;
     protected readonly displayedChips: _angular_core.Signal<Partial<T>[]>;
+    /**
+     * En fila (chipsDirection="row"), cuántos de los chips mostrados caben enteros en el ancho del
+     * campo; null = sin medir. Los que no caben se ocultan y pasan a contar en el «+N», en vez de
+     * quedar cortados a medias.
+     */
+    private readonly _fittingChips;
+    /** Chips visibles de verdad: los de maxChipsDisplayed que caben (en fila) o todos (en columna). */
+    protected readonly visibleChipCount: _angular_core.Signal<number>;
     protected readonly remainingChipsCount: _angular_core.Signal<number>;
     /** ErrorStateMatcher que refleja el estado del control del formulario. */
     protected readonly errorStateMatcher: ErrorStateMatcher;
     /** true cuando el formulario contenedor ya ha intentado enviarse. */
     private _isParentFormSubmitted;
     /**
-     * Obligatorio si el control del formulario tiene el validador `required`.
-     * Se propaga al input interno para que el mat-form-field pinte el asterisco,
-     * igual que hace Material con un `<input matInput>` normal.
+     * Obligatorio si el control del formulario tiene el validador `required`: el mat-form-field pinta
+     * el asterisco. Signal (no método en plantilla) que se actualiza en ngDoCheck.
      */
-    protected isRequired(): boolean;
+    protected readonly isRequired: WritableSignal<boolean>;
+    /** Control visible según el modo (chips o texto), para recalcular su error con OnPush. */
+    private readonly _chipGrid;
+    private readonly _textInput;
     protected readonly effectiveSearchPlaceholder: _angular_core.Signal<string>;
     protected readonly effectiveNoResults: _angular_core.Signal<string>;
     protected readonly effectiveConfirmLabel: _angular_core.Signal<string>;
     protected readonly effectiveResetLabel: _angular_core.Signal<string>;
     protected readonly effectiveSelectAllLabel: _angular_core.Signal<string>;
     constructor();
+    ngAfterViewInit(): void;
+    ngDoCheck(): void;
+    /** Cuenta los chips que acaban dentro del ancho visible del grid (al menos uno). */
+    private _measureChips;
+    private _syncFormState;
     writeValue(value: T[keyof T] | T[keyof T][] | null): void;
     registerOnChange(fn: (value: T[keyof T] | T[keyof T][] | null) => void): void;
     registerOnTouched(fn: () => void): void;
@@ -1612,6 +1752,8 @@ declare class NgxPaginatedSelect<T, U extends PaginatedFilter<T>> implements Con
      * `String(item[valueKey])` so partial objects never throw.
      */
     protected getLabel(item: Partial<T>): string;
+    /** Pide a config.loadByKeys los elementos de los que solo se conoce la clave. */
+    private _resolvePartials;
     openBottomSheet(event: Event): void;
     /** Abrir el bottom sheet desde el teclado (Enter / Espacio / flecha abajo). */
     onTriggerKeydown(event: KeyboardEvent): void;
@@ -1621,6 +1763,36 @@ declare class NgxPaginatedSelect<T, U extends PaginatedFilter<T>> implements Con
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxPaginatedSelect<any, any>, "ngx-paginated-select", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "endpoint": { "alias": "endpoint"; "required": true; "isSignal": true; }; "config": { "alias": "config"; "required": true; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "selectedItems": { "alias": "selectedItems"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "displayMode": { "alias": "displayMode"; "required": false; "isSignal": true; }; "showSearch": { "alias": "showSearch"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "noResultsMessage": { "alias": "noResultsMessage"; "required": false; "isSignal": true; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; "isSignal": true; }; "resetLabel": { "alias": "resetLabel"; "required": false; "isSignal": true; }; "subscriptSizing": { "alias": "subscriptSizing"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "optionTemplate": { "alias": "optionTemplate"; "required": false; "isSignal": true; }; "extraFiltersTemplate": { "alias": "extraFiltersTemplate"; "required": false; "isSignal": true; }; "maxChipsDisplayed": { "alias": "maxChipsDisplayed"; "required": false; "isSignal": true; }; "chipsDirection": { "alias": "chipsDirection"; "required": false; "isSignal": true; }; "showSelectAll": { "alias": "showSelectAll"; "required": false; "isSignal": true; }; "selectAllLabel": { "alias": "selectAllLabel"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "selectionChange": "selectionChange"; }, never, never, true, never>;
 }
 
+/** Trozo de una etiqueta: `match` = coincide con la búsqueda (se resalta). */
+interface LabelPart {
+    text: string;
+    match: boolean;
+}
+/** Estado ya resuelto de cada fila: se calcula una vez por cambio, no en cada pasada de la plantilla. */
+interface OptionView<T> {
+    item: T;
+    key: unknown;
+    index: number;
+    id: string;
+    label: string;
+    labelParts: LabelPart[];
+    subtitle: string | null;
+    disabled: boolean;
+    selected: boolean;
+    /** Seleccionada que no está en las páginas cargadas: se fija arriba para que se vea al abrir. */
+    pinned: boolean;
+    avatarImage: string | null;
+    avatarText: string;
+    /** Tono del avatar de texto (0-3), estable para cada elemento. */
+    avatarTone: number;
+}
+/** Primera página guardada entre aperturas: se muestra al instante mientras se recarga. */
+interface NgxPaginatedSelectPageCache<T> {
+    value: {
+        fingerprint: string;
+        page: PaginatedItems<T>;
+    } | null;
+}
 interface NgxPaginatedSelectBottomSheetData<T, U extends PaginatedFilter<T>> {
     title: string;
     config: PaginatedSelectConfig<T>;
@@ -1640,18 +1812,33 @@ interface NgxPaginatedSelectBottomSheetData<T, U extends PaginatedFilter<T>> {
     extraFiltersTemplate: TemplateRef<void> | null;
     showSelectAll: boolean;
     selectAllLabel: string;
+    /** Primera página de aperturas anteriores (opcional). */
+    cache?: NgxPaginatedSelectPageCache<T>;
 }
 declare class NgxPaginatedSelectBottomSheetComponent<T, U extends PaginatedFilter<T>> {
     private readonly _ref;
     private readonly _destroy;
+    private readonly _host;
+    private readonly _injector;
     readonly data: NgxPaginatedSelectBottomSheetData<T, U>;
     readonly texts: _angular_core.Signal<ngx_eiffage_material.NgxEiffageTexts>;
+    /** Prefijo de ids para aria-activedescendant. */
+    readonly listId: string;
+    private readonly _key;
+    /** Mínimo de caracteres para lanzar una búsqueda. */
+    readonly minSearch: number;
     /** Raw input value — updates on every keystroke, does NOT trigger the resource */
     readonly query: WritableSignal<string | undefined>;
+    /** Claves de items cuya imagen de avatar falló al cargar (para el fallback). */
+    private readonly failedImages;
     /** Holds Partial<T> initially; items get upgraded to full T when toggled from the list */
     readonly selectedItems: WritableSignal<Partial<T>[]>;
+    /** Claves seleccionadas al abrir: para saber si hay cambios sin confirmar. */
+    private readonly _initialKeys;
+    /** Aviso «¿Descartar los cambios?» visible (múltiple). */
+    readonly confirmDiscard: WritableSignal<boolean>;
     /**
-     * Subject used to bypass the 400 ms debounce (e.g. when the user clears
+     * Subject used to bypass the debounce (e.g. when the user clears
      * the search field — we want an immediate response).
      */
     private readonly _immediateQuery$;
@@ -1667,6 +1854,20 @@ declare class NgxPaginatedSelectBottomSheetComponent<T, U extends PaginatedFilte
     readonly options: _angular_core.Signal<T[]>;
     readonly hasError: _angular_core.Signal<boolean>;
     readonly selectedCount: _angular_core.Signal<number>;
+    /** Claves seleccionadas en un Set: comprobar si una opción está elegida es O(1). */
+    private readonly _selectedKeys;
+    /** Hay cambios respecto a la selección con la que se abrió el panel. */
+    readonly isDirty: _angular_core.Signal<boolean>;
+    /** Búsqueda escrita pero más corta que minSearchLength. */
+    readonly searchTooShort: _angular_core.Signal<boolean>;
+    /** Opción activa del teclado (índice en optionViews); -1 = ninguna. */
+    readonly activeIndex: WritableSignal<number>;
+    readonly activeId: _angular_core.Signal<string | null>;
+    /**
+     * Todo lo que pinta cada fila, resuelto de una vez. En simple, si lo seleccionado no está en
+     * las páginas cargadas y no se está buscando, se fija arriba para que se vea al abrir.
+     */
+    readonly optionViews: _angular_core.Signal<OptionView<T>[]>;
     /**
      * Total como signal, actualizado SOLO cuando el recurso no está cargando. Durante
      * la carga por scroll, resource.value() pasa transitoriamente al defaultValue
@@ -1677,9 +1878,9 @@ declare class NgxPaginatedSelectBottomSheetComponent<T, U extends PaginatedFilte
     private readonly _total;
     readonly total: _angular_core.Signal<number>;
     private readonly _totalEffect;
-    /** Cargando la PRIMERA página (lista vacía) → se muestran skeletons. */
+    /** Cargando la PRIMERA página sin nada que enseñar → skeletons. */
     readonly isInitialLoading: _angular_core.Signal<boolean>;
-    /** Cargando MÁS páginas (scroll) → fila inline "cargando más…", sin barra superior. */
+    /** Cargando MÁS páginas (scroll) → fila «cargando más…». Recargar la primera (caché) no la muestra. */
     readonly isLoadingMore: _angular_core.Signal<boolean>;
     /** Ya se han cargado todos los resultados disponibles. */
     readonly allLoaded: _angular_core.Signal<boolean>;
@@ -1690,19 +1891,12 @@ declare class NgxPaginatedSelectBottomSheetComponent<T, U extends PaginatedFilte
     /**
      * Reactively depends ONLY on `resource.value()`. The filter snapshot is read
      * via `untracked` so external filter changes (parent-driven, e.g. an extra
-     * filters panel) do NOT create a reactive dependency here — that would make
-     * the effect re-run on scroll page increments with stale resource data,
-     * duplicating items and breaking `onScroll` (see original limitation).
+     * filters panel) do NOT create a reactive dependency here.
      *
      * Reset logic:
      *  - Fingerprint the current filter identity (everything except `pageNumber`).
-     *  - If the fingerprint changed since the previous fetch, this fetch belongs
-     *    to a different filter set → replace the accumulated array.
+     *  - If the fingerprint changed since the previous fetch, or this is page 1 → replace.
      *  - If only `pageNumber` moved, this is a scroll-load-more → append.
-     *
-     * This is what allows callers to mutate `data.filters` from outside (extra
-     * filter selects, checkboxes, etc.) and have the list refresh cleanly
-     * without the previous page's items lingering.
      */
     private _lastFilterFingerprint;
     private readonly _accumEffect;
@@ -1714,14 +1908,24 @@ declare class NgxPaginatedSelectBottomSheetComponent<T, U extends PaginatedFilte
      */
     getLabel(item: Partial<T>): string;
     getAvatarText(item: Partial<T>): string;
-    /** Claves de items cuya imagen de avatar falló al cargar (para el fallback). */
-    private readonly failedImages;
     /** URL de imagen del avatar, o null si no hay o si falló al cargar. */
     getAvatarImage(item: Partial<T>): string | null | undefined;
     /** Marca la imagen como fallida para caer al texto/icono. */
     onAvatarError(item: Partial<T>): void;
     toggleItem(item: T): void;
     removeSelectedChip(item: Partial<T>): void;
+    /**
+     * Patrón combobox: el foco se queda en el buscador (se puede seguir escribiendo) y la opción
+     * activa se marca con aria-activedescendant. Flechas y RePág/AvPág la mueven; Intro elige.
+     */
+    onSearchKeydown(event: KeyboardEvent): void;
+    /** Sin buscador, la propia lista recibe el foco: además, Inicio/Fin y Espacio. */
+    onListKeydown(event: KeyboardEvent): void;
+    onOptionClick(view: OptionView<T>): void;
+    private _moveActive;
+    private _chooseActive;
+    /** Activa una opción y la trae a la vista (si es de las últimas, el scroll carga la siguiente página). */
+    private _setActive;
     onQueryInput(event: Event, container: HTMLElement): void;
     clearQuery(container?: HTMLElement): void;
     onScroll(container: HTMLElement): void;
@@ -1730,7 +1934,16 @@ declare class NgxPaginatedSelectBottomSheetComponent<T, U extends PaginatedFilte
     toggleSelectAll(): void;
     confirm(): void;
     reset(): void;
+    /** Cierra sin aplicar cambios (botón X). En múltiple con cambios, pregunta antes. */
     close(): void;
+    /** Cerrar desde la X, Escape o el fondo: si hay cambios sin confirmar, avisa primero. */
+    requestClose(): void;
+    discardChanges(): void;
+    keepEditing(): void;
+    /** Identidad de unos filtros sin la página: misma huella = misma lista. */
+    private _fingerprint;
+    /** Las funciones de config pueden fallar con objetos parciales (solo valueKey): se tratan como vacías. */
+    private _safe;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxPaginatedSelectBottomSheetComponent<any, any>, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxPaginatedSelectBottomSheetComponent<any, any>, "ngx-paginated-select-bottom-sheet", never, {}, {}, never, never, true, never>;
 }
@@ -2003,5 +2216,5 @@ declare class DynamicHostDirective<T> {
 declare const includeNoSensible: (cadena: string, query: string) => boolean;
 declare const base64ToUtf8: (str: string) => string;
 
-export { AdvancedFilterService, AdvancedFilterUtils, ColumnConfigService, DatosPantallaService, DialogBodyType, DynamicHostDirective, NGX_EIFFAGE_DEFAULT_TEXTS, NGX_EIFFAGE_TEXTS, NgxAlert, NgxBasicSelect, NgxBasicTable, NgxConfirmDialogComponent, NgxDialog, NgxDialogContext, NgxDialogService, NgxFileInput, NgxInputFile, NgxLoadingButton, NgxPaginatedSelect, NgxPaginatedSelectBottomSheetComponent, NgxPaginatedTable, NgxSkeleton, NgxTablesIntl, NgxTexts, OPERATOR_BY_FILTER_TYPE, PaginatedSearchableSelectComponent, SearchableSelectComponent, USER_ID_FACTORY, base64ToUtf8, includeNoSensible, isFilterOption, provideNgxEiffageTexts };
-export type { AdvancedFilter, AlertAppearance, AlertType, BasicFilter, BasicSelectConfig, BasicTableColumn, BasicTableConfig, ColumnConfig, ColumnPipe, ColumnValue, ConfigureTableColumnData, ConfirmDialogData, DeleteConfirm, DialogBodyConfig, DialogConfig, DynamicFilter, FilterConnector, FilterGroup, FilterOperator, FilterOption, FilterRule, FilterType, LoadingButtonAppearance, LoadingButtonColor, NgxDialogTemplateContext, NgxEiffageTexts, NgxEiffageTextsOverrides, NgxEiffageTextsSource, NgxFileError, NgxFileErrorCode, NgxFileInputVariant, NgxFileItem, NgxPaginatedSelectBottomSheetData, PaginatedFilter, PaginatedItems, PaginatedSelectConfig, PaginatedTableColumn, PaginatedTableConfig, Pantalla, RowActionClickEvent, RowActionIconColor, RowSelectionAction, SelectionActionEvent, SendType, SkeletonAnimation, SkeletonVariant, SortBy, SortType, TableBasicAction, TableRowAction, TipoPantalla };
+export { AdvancedFilterService, AdvancedFilterUtils, ColumnConfigService, DatosPantallaService, DialogBodyType, DynamicHostDirective, NGX_EIFFAGE_DEFAULT_TEXTS, NGX_EIFFAGE_TEXTS, NgxAlert, NgxBasicSelect, NgxBasicTable, NgxConfirmDialogComponent, NgxDialog, NgxDialogContext, NgxDialogHeader, NgxDialogService, NgxFileInput, NgxInputFile, NgxLoadingButton, NgxPaginatedSelect, NgxPaginatedSelectBottomSheetComponent, NgxPaginatedTable, NgxSkeleton, NgxTablesIntl, NgxTexts, OPERATOR_BY_FILTER_TYPE, PaginatedSearchableSelectComponent, SearchableSelectComponent, USER_ID_FACTORY, base64ToUtf8, includeNoSensible, isFilterOption, provideNgxEiffageTexts };
+export type { AdvancedFilter, AlertAppearance, AlertType, BasicFilter, BasicSelectConfig, BasicTableColumn, BasicTableConfig, ColumnConfig, ColumnPipe, ColumnValue, ConfigureTableColumnData, ConfirmDialogData, DeleteConfirm, DialogBodyConfig, DialogConfig, DynamicFilter, FilterConnector, FilterGroup, FilterOperator, FilterOption, FilterRule, FilterType, LoadingButtonAppearance, LoadingButtonColor, NgxDialogTemplateContext, NgxEiffageTexts, NgxEiffageTextsOverrides, NgxEiffageTextsSource, NgxFileError, NgxFileErrorCode, NgxFileInputVariant, NgxFileItem, NgxPaginatedSelectBottomSheetData, NgxPaginatedSelectPageCache, PaginatedFilter, PaginatedItems, PaginatedSelectConfig, PaginatedTableColumn, PaginatedTableConfig, Pantalla, RowActionClickEvent, RowActionIconColor, RowSelectionAction, SelectionActionEvent, SendType, SkeletonAnimation, SkeletonVariant, SortBy, SortType, TableBasicAction, TableRowAction, TipoPantalla };