@esfaenza/es-table 20.3.36 → 20.3.38

package/index.d.ts

@@ -2564,6 +2564,13 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     readonly _SelectAll: _angular_core.InputSignal<boolean>;
     SelectAll: _angular_core.WritableSignal<boolean>;
     /** @deprecated NO-OP di parità v1 (cache selezione cross-pagina): dichiarato per il drop-in, non usato */
+    /**
+     * Identità di una riga per la cache di selezione: nome di una proprietà (es. id)
+     * oppure una funzione. Senza, si ricade su un hash del CONTENUTO (parità con
+     * l'originale): funziona, ma basta che il server cambi un campo perché la riga non
+     * venga più riconosciuta. Con una chiave stabile il problema non si pone.
+     */
+    SelectionKey: _angular_core.InputSignal<string | ((item: any) => any)>;
     readonly _UseSelectionCache: _angular_core.InputSignal<boolean>;
     UseSelectionCache: _angular_core.WritableSignal<boolean>;
     readonly _ShiftClick: _angular_core.InputSignal<boolean>;
@@ -2604,6 +2611,19 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     CountLabel: _angular_core.InputSignal<string>;
     Height: _angular_core.InputSignal<string>;
     MaxHeight: _angular_core.InputSignal<number>;
+    /**
+     * Rende solo le righe VISIBILI nel viewport (più un margine), con due righe
+     * distanziatrici a compensare l'altezza mancante. Serve a tabelle molto lunghe
+     * rese in un colpo solo (paginazione disattivata o pagina enorme).
+     *
+     * È OPT-IN: da spento il corpo della tabella è renderizzato esattamente come prima.
+     * Richiede uno scroller ad altezza limitata (`[MaxHeight]`/`[Height]`) e righe di
+     * altezza UNIFORME. Su raggruppamento e gerarchia si autodisattiva: lì il ciclo
+     * salta le righe non visibili, quindi indice di riga e posizione non coincidono.
+     */
+    VirtualScroll: _angular_core.InputSignal<boolean>;
+    /** Altezza di riga in px per il calcolo della finestra; se assente viene MISURATA dal DOM */
+    VirtualRowHeight: _angular_core.InputSignal<number>;
     EmptySpaceBackgroundColor: _angular_core.InputSignal<string>;
     HighCellDensity: _angular_core.InputSignal<boolean>;
     HeaderHidden: _angular_core.InputSignal<boolean>;
@@ -2754,6 +2774,41 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
         left: number | null;
         groupStart: boolean;
     }[]>;
+    /** Righe extra rese sopra e sotto il viewport, per non vedere il vuoto durante lo scroll */
+    private readonly VIRTUAL_OVERSCAN;
+    /** Indice della prima riga della finestra */
+    private vFirst;
+    /** Altezza del viewport dello scroller (misurata) */
+    private vViewportH;
+    /** Altezza di riga misurata dal DOM (0 = non ancora nota) */
+    private vMeasuredRowH;
+    /** Altezza di riga effettiva: input esplicito, altrimenti misura */
+    private virtualRowH;
+    /**
+     * Virtualizzazione attiva. Esclusi raggruppamento e gerarchia: in quelle modalità
+     * il template salta le righe non espanse, quindi la finestra calcolata sugli indici
+     * non corrisponderebbe alle righe effettivamente rese.
+     */
+    virtualActive: _angular_core.Signal<boolean>;
+    /** Finestra corrente, o `null` per rendere tutto (fallback sicuro) */
+    virtualWindow: _angular_core.Signal<{
+        start: number;
+        end: number;
+        padTop: number;
+        padBottom: number;
+    }>;
+    /** Indice ASSOLUTO della prima riga resa: 0 quando non si virtualizza */
+    vStart: _angular_core.Signal<number>;
+    /** Righe effettivamente rese: l'intero `boundSource()` se non si virtualizza */
+    renderedRows: _angular_core.Signal<Est2Row[]>;
+    /** Scroll dello scroller: sposta la finestra solo quando cambia davvero riga */
+    onScrollerScroll(ev: Event): void;
+    /** Misura viewport e altezza di riga dal DOM (una riga NON distanziatrice) */
+    private measureVirtualMetrics;
+    private scrollEl?;
+    private scrollRO?;
+    /** ViewChild-setter sullo scroller: da qui partono le misure della virtualizzazione */
+    set scrollRefEl(ref: ElementRef<HTMLElement> | undefined);
     /** Numero di colonne pinnate visibili */
     pinnedCount: _angular_core.Signal<number>;
     /** true se c'è almeno una colonna pinnata */
@@ -2831,6 +2886,14 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     /** Timeout di debounce del writeValue in modalità EsTableHandledSearch */
     private searchCallTimeout;
     writeValue(obj: any, throttle?: boolean): void;
+    /**
+     * Decide se la selezione sopravvive al modello appena arrivato. Parità con
+     * l'originale: sopravvive solo alle ricerche INTERNE (cambio pagina, ordinamento,
+     * elementi per pagina), che la tabella marca con `internalsearchrequest`. Una
+     * ricerca dell'utente — filtri cambiati — riparte da selezione vuota, altrimenti
+     * resterebbero selezionate righe che non fanno più parte del risultato.
+     */
+    private applySelectionCachePolicy;
     registerOnChange(fn: (v: any) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState?(): void;
@@ -2893,6 +2956,45 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
      * In modalità **all** una riga è selezionata se NON è tra le esclusioni (vale anche
      * per le pagine non ancora visitate, dove tutte le righe risultano selezionate).
      */
+    /** Attiva solo in viewmode: in array mode gli oggetti non cambiano identità */
+    private selectionCacheOn;
+    /**
+     * Identità di una riga ai fini della selezione. A cache SPENTA restituisce
+     * l'oggetto stesso, quindi ogni confronto resta per riferimento e il comportamento
+     * è identico a prima.
+     */
+    private selKey;
+    /**
+     * Proprietà-identità RILEVATA dai dati, così la cache funziona senza configurare
+     * nulla. Vale per tutta la vita della ricerca: viene ricalcolata solo quando la
+     * selezione riparte, altrimenti una pagina "sfortunata" potrebbe cambiare criterio
+     * a metà strada e far sballare i confronti.
+     */
+    private autoKeyProp;
+    /** true quando la rilevazione è già stata fatta per la ricerca corrente */
+    private autoKeyResolved;
+    /**
+     * Cerca una proprietà utilizzabile come identità: prima `[OwnKey]` (che il consumer
+     * ha già dichiarato per la gerarchia), poi una proprietà chiamata `id`. La candidata
+     * viene ACCETTATA solo se sulla pagina è valorizzata ovunque, primitiva e univoca;
+     * altrimenti si ricade sull'hash del contenuto. Meglio nessuna chiave che una
+     * sbagliata: una chiave duplicata selezionerebbe righe diverse insieme.
+     */
+    private resolveAutoKey;
+    /** Rileva l'identità una volta per ricerca, prima di applicare i flag di selezione */
+    private ensureAutoKey;
+    /**
+     * Hash stabile del contenuto della riga, ignorando i campi interni (`_selected`,
+     * `_hash`, …). Le chiavi sono ordinate per non dipendere dall'ordine di
+     * serializzazione. È il fallback di parità con l'originale: se il server cambia
+     * anche un solo campo la riga non viene più riconosciuta, per questo conviene
+     * fornire `[SelectionKey]`.
+     */
+    private contentHash;
+    /** Aggiunge una riga a una lista di selezione, deduplicando per chiave */
+    private selAdd;
+    /** Rimuove una riga da una lista di selezione confrontando per chiave */
+    private selRemove;
     private applySelectionFlags;
     /** Ricalcola il conteggio: in modalità **all** è (totale - esclusioni) */
     private refreshSelectionCount;
@@ -3323,7 +3425,7 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     trackRow: (i: number, item: any) => any;
     trackCol: (_: number, col: Est2Column) => string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EsTable2Component, [{ optional: true; self: true; }, null, null, { optional: true; }, null, null, { optional: true; }, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EsTable2Component, "es-table2", never, { "ContextMenu": { "alias": "ContextMenu"; "required": false; }; "_Selection": { "alias": "Selection"; "required": false; "isSignal": true; }; "SingleSelection": { "alias": "SingleSelection"; "required": false; "isSignal": true; }; "SelectionDisabled": { "alias": "SelectionDisabled"; "required": false; "isSignal": true; }; "_SelectAll": { "alias": "SelectAll"; "required": false; "isSignal": true; }; "_UseSelectionCache": { "alias": "UseSelectionCache"; "required": false; "isSignal": true; }; "_ShiftClick": { "alias": "ShiftClick"; "required": false; "isSignal": true; }; "_OrderByColumn": { "alias": "OrderByColumn"; "required": false; "isSignal": true; }; "MultipleOrderingDirectives": { "alias": "MultipleOrderingDirectives"; "required": false; "isSignal": true; }; "Removal": { "alias": "Removal"; "required": false; "isSignal": true; }; "RemovalCondition": { "alias": "RemovalCondition"; "required": false; "isSignal": true; }; "RowClassAssigner": { "alias": "RowClassAssigner"; "required": false; }; "_HidePaging": { "alias": "HidePaging"; "required": false; "isSignal": true; }; "_HidePagingCount": { "alias": "HidePagingCount"; "required": false; "isSignal": true; }; "_HidePagingButtons": { "alias": "HidePagingButtons"; "required": false; "isSignal": true; }; "_AllSearch": { "alias": "AllSearch"; "required": false; "isSignal": true; }; "_PagingStyle": { "alias": "PagingStyle"; "required": false; "isSignal": true; }; "_ArraymodeItemsPerPage": { "alias": "ArraymodeItemsPerPage"; "required": false; "isSignal": true; }; "_UseArrayModePaging": { "alias": "UseArrayModePaging"; "required": false; "isSignal": true; }; "CountLabel": { "alias": "CountLabel"; "required": false; "isSignal": true; }; "Height": { "alias": "Height"; "required": false; "isSignal": true; }; "MaxHeight": { "alias": "MaxHeight"; "required": false; "isSignal": true; }; "EmptySpaceBackgroundColor": { "alias": "EmptySpaceBackgroundColor"; "required": false; "isSignal": true; }; "HighCellDensity": { "alias": "HighCellDensity"; "required": false; "isSignal": true; }; "HeaderHidden": { "alias": "HeaderHidden"; "required": false; "isSignal": true; }; "BodyHidden": { "alias": "BodyHidden"; "required": false; "isSignal": true; }; "ShowLoadingOnBootstrap": { "alias": "ShowLoadingOnBootstrap"; "required": false; "isSignal": true; }; "_DefaultAlignment": { "alias": "DefaultAlignment"; "required": false; "isSignal": true; }; "_TableClass": { "alias": "TableClass"; "required": false; "isSignal": true; }; "_ContainerClass": { "alias": "ContainerClass"; "required": false; "isSignal": true; }; "EsTableHandledSearch": { "alias": "EsTableHandledSearch"; "required": false; "isSignal": true; }; "SearchThrottle": { "alias": "SearchThrottle"; "required": false; "isSignal": true; }; "_ColumnsResizable": { "alias": "ColumnsResizable"; "required": false; "isSignal": true; }; "_ColumnsPinnable": { "alias": "ColumnsPinnable"; "required": false; "isSignal": true; }; "_HiddenColumns": { "alias": "HiddenColumns"; "required": false; "isSignal": true; }; "_ColumnsOrdering": { "alias": "ColumnsOrdering"; "required": false; "isSignal": true; }; "_Export": { "alias": "Export"; "required": false; "isSignal": true; }; "XLSXExport": { "alias": "XLSXExport"; "required": false; "isSignal": true; }; "CSVExport": { "alias": "CSVExport"; "required": false; "isSignal": true; }; "ExportFileName": { "alias": "ExportFileName"; "required": false; "isSignal": true; }; "ExportOnlyVisibleColumns": { "alias": "ExportOnlyVisibleColumns"; "required": false; "isSignal": true; }; "ExportFunction": { "alias": "ExportFunction"; "required": false; }; "CornerMenuOptions": { "alias": "CornerMenuOptions"; "required": false; "isSignal": true; }; "DynamicOperations": { "alias": "DynamicOperations"; "required": false; "isSignal": true; }; "_DynamicRowColumnsDefinition": { "alias": "DynamicRowColumnsDefinition"; "required": false; "isSignal": true; }; "Hierarchy": { "alias": "Hierarchy"; "required": false; "isSignal": true; }; "_ParentKey": { "alias": "ParentKey"; "required": false; "isSignal": true; }; "_OwnKey": { "alias": "OwnKey"; "required": false; "isSignal": true; }; "_AutoSortHierarchy": { "alias": "AutoSortHierarchy"; "required": false; "isSignal": true; }; "StartsExpanded": { "alias": "StartsExpanded"; "required": false; "isSignal": true; }; "CascadeSelection": { "alias": "CascadeSelection"; "required": false; "isSignal": true; }; "_SavePreferences": { "alias": "SavePreferences"; "required": false; "isSignal": true; }; "Name": { "alias": "Name"; "required": false; "isSignal": true; }; "_RowGroupingPagingStyle": { "alias": "RowGroupingPagingStyle"; "required": false; "isSignal": true; }; "_ShowItemGroupsColumns": { "alias": "ShowItemGroupsColumns"; "required": false; "isSignal": true; }; "Editable": { "alias": "Editable"; "required": false; "isSignal": true; }; "RangeSelection": { "alias": "RangeSelection"; "required": false; "isSignal": true; }; "ItemSourceProperty": { "alias": "ItemSourceProperty"; "required": false; "isSignal": true; }; "HasHeaderGroup": { "alias": "HasHeaderGroup"; "required": false; "isSignal": true; }; "HasSecondaryHeaderGroup": { "alias": "HasSecondaryHeaderGroup"; "required": false; "isSignal": true; }; "SearchView": { "alias": "SearchView"; "required": false; "isSignal": true; }; "_AutoUpdate": { "alias": "AutoUpdate"; "required": false; "isSignal": true; }; "EsThTdProvider": { "alias": "EsThTdProvider"; "required": false; }; "globalCheck": { "alias": "globalCheck"; "required": false; "isSignal": true; }; "autoUpdate": { "alias": "autoUpdate"; "required": false; "isSignal": true; }; "seconds": { "alias": "seconds"; "required": false; "isSignal": true; }; "researchInProgress": { "alias": "researchInProgress"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; }; }, { "onOrderChanged": "onOrderChanged"; "onSearchRequest": "onSearchRequest"; "onSelectionChanged": "onSelectionChanged"; "onRemoval": "onRemoval"; "onAbortRemoval": "onAbortRemoval"; "onModelChange": "onModelChange"; "onOpenContextMenu": "onOpenContextMenu"; "onCornerAction": "onCornerAction"; "onDynamicOperation": "onDynamicOperation"; "globalCheck": "globalCheckChange"; "autoUpdate": "autoUpdateChange"; "seconds": "secondsChange"; "researchInProgress": "researchInProgressChange"; }, ["headerRef", "bodyRef", "thDirectives", "tdDirectives", "editorDirectives", "thTdProviders"], never, false, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EsTable2Component, "es-table2", never, { "ContextMenu": { "alias": "ContextMenu"; "required": false; }; "_Selection": { "alias": "Selection"; "required": false; "isSignal": true; }; "SingleSelection": { "alias": "SingleSelection"; "required": false; "isSignal": true; }; "SelectionDisabled": { "alias": "SelectionDisabled"; "required": false; "isSignal": true; }; "_SelectAll": { "alias": "SelectAll"; "required": false; "isSignal": true; }; "SelectionKey": { "alias": "SelectionKey"; "required": false; "isSignal": true; }; "_UseSelectionCache": { "alias": "UseSelectionCache"; "required": false; "isSignal": true; }; "_ShiftClick": { "alias": "ShiftClick"; "required": false; "isSignal": true; }; "_OrderByColumn": { "alias": "OrderByColumn"; "required": false; "isSignal": true; }; "MultipleOrderingDirectives": { "alias": "MultipleOrderingDirectives"; "required": false; "isSignal": true; }; "Removal": { "alias": "Removal"; "required": false; "isSignal": true; }; "RemovalCondition": { "alias": "RemovalCondition"; "required": false; "isSignal": true; }; "RowClassAssigner": { "alias": "RowClassAssigner"; "required": false; }; "_HidePaging": { "alias": "HidePaging"; "required": false; "isSignal": true; }; "_HidePagingCount": { "alias": "HidePagingCount"; "required": false; "isSignal": true; }; "_HidePagingButtons": { "alias": "HidePagingButtons"; "required": false; "isSignal": true; }; "_AllSearch": { "alias": "AllSearch"; "required": false; "isSignal": true; }; "_PagingStyle": { "alias": "PagingStyle"; "required": false; "isSignal": true; }; "_ArraymodeItemsPerPage": { "alias": "ArraymodeItemsPerPage"; "required": false; "isSignal": true; }; "_UseArrayModePaging": { "alias": "UseArrayModePaging"; "required": false; "isSignal": true; }; "CountLabel": { "alias": "CountLabel"; "required": false; "isSignal": true; }; "Height": { "alias": "Height"; "required": false; "isSignal": true; }; "MaxHeight": { "alias": "MaxHeight"; "required": false; "isSignal": true; }; "VirtualScroll": { "alias": "VirtualScroll"; "required": false; "isSignal": true; }; "VirtualRowHeight": { "alias": "VirtualRowHeight"; "required": false; "isSignal": true; }; "EmptySpaceBackgroundColor": { "alias": "EmptySpaceBackgroundColor"; "required": false; "isSignal": true; }; "HighCellDensity": { "alias": "HighCellDensity"; "required": false; "isSignal": true; }; "HeaderHidden": { "alias": "HeaderHidden"; "required": false; "isSignal": true; }; "BodyHidden": { "alias": "BodyHidden"; "required": false; "isSignal": true; }; "ShowLoadingOnBootstrap": { "alias": "ShowLoadingOnBootstrap"; "required": false; "isSignal": true; }; "_DefaultAlignment": { "alias": "DefaultAlignment"; "required": false; "isSignal": true; }; "_TableClass": { "alias": "TableClass"; "required": false; "isSignal": true; }; "_ContainerClass": { "alias": "ContainerClass"; "required": false; "isSignal": true; }; "EsTableHandledSearch": { "alias": "EsTableHandledSearch"; "required": false; "isSignal": true; }; "SearchThrottle": { "alias": "SearchThrottle"; "required": false; "isSignal": true; }; "_ColumnsResizable": { "alias": "ColumnsResizable"; "required": false; "isSignal": true; }; "_ColumnsPinnable": { "alias": "ColumnsPinnable"; "required": false; "isSignal": true; }; "_HiddenColumns": { "alias": "HiddenColumns"; "required": false; "isSignal": true; }; "_ColumnsOrdering": { "alias": "ColumnsOrdering"; "required": false; "isSignal": true; }; "_Export": { "alias": "Export"; "required": false; "isSignal": true; }; "XLSXExport": { "alias": "XLSXExport"; "required": false; "isSignal": true; }; "CSVExport": { "alias": "CSVExport"; "required": false; "isSignal": true; }; "ExportFileName": { "alias": "ExportFileName"; "required": false; "isSignal": true; }; "ExportOnlyVisibleColumns": { "alias": "ExportOnlyVisibleColumns"; "required": false; "isSignal": true; }; "ExportFunction": { "alias": "ExportFunction"; "required": false; }; "CornerMenuOptions": { "alias": "CornerMenuOptions"; "required": false; "isSignal": true; }; "DynamicOperations": { "alias": "DynamicOperations"; "required": false; "isSignal": true; }; "_DynamicRowColumnsDefinition": { "alias": "DynamicRowColumnsDefinition"; "required": false; "isSignal": true; }; "Hierarchy": { "alias": "Hierarchy"; "required": false; "isSignal": true; }; "_ParentKey": { "alias": "ParentKey"; "required": false; "isSignal": true; }; "_OwnKey": { "alias": "OwnKey"; "required": false; "isSignal": true; }; "_AutoSortHierarchy": { "alias": "AutoSortHierarchy"; "required": false; "isSignal": true; }; "StartsExpanded": { "alias": "StartsExpanded"; "required": false; "isSignal": true; }; "CascadeSelection": { "alias": "CascadeSelection"; "required": false; "isSignal": true; }; "_SavePreferences": { "alias": "SavePreferences"; "required": false; "isSignal": true; }; "Name": { "alias": "Name"; "required": false; "isSignal": true; }; "_RowGroupingPagingStyle": { "alias": "RowGroupingPagingStyle"; "required": false; "isSignal": true; }; "_ShowItemGroupsColumns": { "alias": "ShowItemGroupsColumns"; "required": false; "isSignal": true; }; "Editable": { "alias": "Editable"; "required": false; "isSignal": true; }; "RangeSelection": { "alias": "RangeSelection"; "required": false; "isSignal": true; }; "ItemSourceProperty": { "alias": "ItemSourceProperty"; "required": false; "isSignal": true; }; "HasHeaderGroup": { "alias": "HasHeaderGroup"; "required": false; "isSignal": true; }; "HasSecondaryHeaderGroup": { "alias": "HasSecondaryHeaderGroup"; "required": false; "isSignal": true; }; "SearchView": { "alias": "SearchView"; "required": false; "isSignal": true; }; "_AutoUpdate": { "alias": "AutoUpdate"; "required": false; "isSignal": true; }; "EsThTdProvider": { "alias": "EsThTdProvider"; "required": false; }; "globalCheck": { "alias": "globalCheck"; "required": false; "isSignal": true; }; "autoUpdate": { "alias": "autoUpdate"; "required": false; "isSignal": true; }; "seconds": { "alias": "seconds"; "required": false; "isSignal": true; }; "researchInProgress": { "alias": "researchInProgress"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; }; }, { "onOrderChanged": "onOrderChanged"; "onSearchRequest": "onSearchRequest"; "onSelectionChanged": "onSelectionChanged"; "onRemoval": "onRemoval"; "onAbortRemoval": "onAbortRemoval"; "onModelChange": "onModelChange"; "onOpenContextMenu": "onOpenContextMenu"; "onCornerAction": "onCornerAction"; "onDynamicOperation": "onDynamicOperation"; "globalCheck": "globalCheckChange"; "autoUpdate": "autoUpdateChange"; "seconds": "secondsChange"; "researchInProgress": "researchInProgressChange"; }, ["headerRef", "bodyRef", "thDirectives", "tdDirectives", "editorDirectives", "thTdProviders"], never, false, never>;
 }
 
 /** Componente rappresentante una Colonna della tabella */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/es-table",
-  "version": "20.3.36",
+  "version": "20.3.38",
   "dependencies": {
     "tslib": "^2.0.0"
   },