@esfaenza/es-table 20.3.31 → 20.3.33

package/index.d.ts

@@ -2687,6 +2687,8 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     ShowItemGroupsColumns: _angular_core.WritableSignal<boolean>;
     /** Mappa ownKey(string) -> figli diretti, per la modalità gerarchica */
     private hierChildren;
+    /** Indice `chiave-propria → riga`: evita la scansione lineare per risalire ai padri */
+    private hierByKey;
     /** Paginazione arrayMode */
     private arrayPage;
     /** Ordinamenti attivi (id -> 'ASC'|'DESC') */
@@ -2714,6 +2716,17 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
      * Una colonna `Fixed` resta quindi sempre in testa e solo una pinnata può precederla.
      */
     private sortStructural;
+    /**
+     * Stile PER-COLONNA precalcolato (larghezza, offset sticky, inizio gruppo).
+     * Il ciclo delle celle è annidato in quello delle righe, quindi senza questo ogni
+     * valore si ricalcolerebbe righe×colonne volte a ogni render: qui si calcola una
+     * volta per colonna e la cella fa un solo accesso per indice.
+     */
+    colStyles: _angular_core.Signal<{
+        width: number | null;
+        left: number | null;
+        groupStart: boolean;
+    }[]>;
     /** Numero di colonne pinnate visibili */
     pinnedCount: _angular_core.Signal<number>;
     /** true se c'è almeno una colonna pinnata */
@@ -2864,7 +2877,16 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     private emitSelection;
     /** Click su una riga: espande/collassa un gruppo, oppure gestisce la selezione. */
     handleRowClick(item: any, event?: MouseEvent): void;
-    /** Selezione a click stile Esplora risorse: plain=solo questo, Ctrl=toggle, Shift=range dall'ancora */
+    /**
+     * Shift/Ctrl+click stile Esplora risorse, attivo solo con `[ShiftClick]`.
+     *
+     * Lo **Shift+click** estende il range dall'ancora (l'ultima riga cliccata); senza
+     * Ctrl il range SOSTITUISCE la selezione, con Ctrl la somma a quella esistente.
+     * Ogni altro caso (Ctrl+click, o Shift senza un'ancora valida) è un toggle della
+     * singola riga: passa da `toggleRow`, che è il percorso canonico usato anche dalle
+     * checkbox e che gestisce correttamente la modalità "tutto selezionato"
+     * (`sel.all` → toggle dell'esclusione invece di azzerare la selezione).
+     */
     private windowsSelect;
     /** Pipe riusate per il testo di copia (dependency-free) */
     private fmt;
@@ -2951,6 +2973,17 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     /** Espande/collassa un gruppo agendo solo sui flag `_visible` (nessuna ricostruzione) */
     toggleGroup(group: any): void;
     /** Item (foglia) appartenenti a un gruppo, a qualsiasi profondità */
+    /**
+     * Indice `chiave-gruppo → item[]`, ricalcolato una sola volta per ogni nuova
+     * `boundSource()`. Le chiavi di gruppo sono composite (`IT¦Roma¦Shop`), quindi ogni
+     * PREFISSO della chiave di un item è un suo gruppo antenato: l'indice si costruisce
+     * in O(righe × profondità) con una sola passata.
+     *
+     * Serve perché la checkbox di gruppo chiama `groupSelectionState` DUE volte per
+     * riga-gruppo a ogni ciclo di change-detection: con la vecchia `filter` su tutte le
+     * righe erano 2·gruppi·righe confronti per render (quadratico nel numero di righe).
+     */
+    private groupItemsIndex;
     private groupItems;
     /** Stato di selezione aggregato di un gruppo, per la sua checkbox */
     groupSelectionState(group: any): 'all' | 'some' | 'none';
@@ -2967,13 +3000,19 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     /** Costruisce l'albero e applica la selezione; se mancano le chiavi torna la lista invariata */
     private applyHierarchy;
     private directChildren;
-    private hierDescendants;
     /** Selezione in cascata: propaga lo stato al sottoalbero e ricalcola gli antenati */
     private cascadeSelection;
     /** Ricostruisce ItemsSelection dai flag `_selected` correnti (usato dalla cascade) */
     private rebuildSelectionFromFlags;
     /** Stato indeterminato di una riga-padre in cascade (alcuni discendenti selezionati) */
     hierarchyIndeterminate(item: any): boolean;
+    /**
+     * Visita in profondità con USCITA ANTICIPATA al primo discendente selezionato.
+     * È legata alla checkbox di OGNI riga, quindi girava a ogni ciclo di
+     * change-detection: la versione precedente materializzava invece l'intero
+     * sottoalbero in un array nuovo per ogni riga e per ogni render.
+     */
+    private hierAnyDescendantSelected;
     /** Espande/collassa un nodo dell'albero */
     toggleHierarchyNode(item: any): void;
     /** Indentazione (px) di una riga dell'albero in base al livello */
@@ -3160,7 +3199,16 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
      * anziché `cellDisplayText`, che conosce solo `property`/`id` e non il contenuto di
      * un template custom (era il bug del tooltip che mostrava sempre l'id colonna).
      */
+    /**
+     * Tooltip "intelligente" sulle celle a larghezza fissa: mostra il testo REALE
+     * solo quando è troncato. In DELEGA sulla `<table>` (non un `(mouseenter)` per
+     * cella): un listener per cella significava installarne uno per ogni `<td>` a
+     * ogni creazione di riga — su una pagina da 50×43 sono 2.150 listener per
+     * cambio pagina.
+     */
     onCellHover(ev: MouseEvent): void;
+    /** Ultima cella già valutata per il tooltip (evita di rimisurare a ogni mousemove) */
+    private hoveredCell;
     /** Larghezza minima (px) di una colonna durante il resize */
     private readonly COL_MIN_W;
     /** Stato del resize in corso (colonna + coordinate iniziali) */

package/package.json

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