@esfaenza/es-table 20.3.32 → 20.3.35

package/index.d.ts

@@ -2433,6 +2433,18 @@ interface Est2Column {
     multiIndex?: number | null;
 }
 
+/**
+ * Riferimento a una cella restituito da `getCellReference`. Stessa forma d'uso
+ * dell'es-table originale (`ValidationError` si legge chiamandola, `validationError`
+ * la imposta), ma qui NON è un componente-cella: l'errore vive in un registro del
+ * componente ed è quindi impostabile anche su righe non renderizzate.
+ */
+interface Est2CellRef {
+    /** Messaggio di errore corrente ('' se la cella è valida) */
+    ValidationError: () => string;
+    /** Imposta (o azzera, passando `null`/`undefined`) l'errore di validazione */
+    validationError: (error?: string | null) => void;
+}
 /**
  * Riga della dialog "Visibilità e ordine colonne". `label` è il fallback testuale
  * (percorso dei gruppi + testo header letto dal DOM, o l'id); `tmpl` è il template
@@ -2559,6 +2571,19 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     MultipleOrderingDirectives: _angular_core.InputSignal<boolean>;
     Removal: _angular_core.InputSignal<boolean>;
     RemovalCondition: _angular_core.InputSignal<string>;
+    /**
+     * Classe CSS aggiuntiva per la riga, decisa dal consumer in base all'item.
+     *
+     * **Attenzione:** viene invocata per OGNI riga renderizzata a OGNI ciclo di
+     * change-detection (l'originale la calcolava una volta sola per bind, in
+     * `item._rowClass`). Deve quindi restare economica: niente lookup pesanti,
+     * calcoli su date o chiamate a servizi: in quel caso conviene precalcolare il
+     * valore sull'item e limitarsi a leggerlo qui.
+     *
+     * A differenza dell'originale NON viene aggiunta alcuna classe `est-row-lvl-N`
+     * in modalità gerarchica: l'indentazione dei livelli è resa con il padding
+     * calcolato (`hierarchyIndent`), non con una classe per livello.
+     */
     RowClassAssigner?: (item: any) => string;
     readonly _HidePaging: _angular_core.InputSignal<boolean>;
     HidePaging: _angular_core.WritableSignal<boolean>;
@@ -2687,6 +2712,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 +2741,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 */
@@ -2756,6 +2794,13 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
      */
     columnGroupBoundaries: _angular_core.Signal<Set<number>>;
     /** Numero di elementi totali (per il pager) */
+    /**
+     * Versione del MODELLO, incrementata da `forceRefresh()`. Serve ai computed che
+     * derivano dal modello (conteggio, pagine): se il consumer muta l'array SUL POSTO
+     * la reference non cambia, il signal `view` non notifica e quei computed
+     * resterebbero memoizzati sul valore vecchio.
+     */
+    private modelVersion;
     totalCount: _angular_core.Signal<any>;
     /** Pagina corrente per il pager */
     currentPage: _angular_core.Signal<any>;
@@ -2960,6 +3005,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';
@@ -2976,13 +3032,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 */
@@ -3028,6 +3090,43 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
      * `{ columns (visibili), column_ordering (ordine), orders (ordinamenti) }`.
      */
     private saveColumnPrefs;
+    /**
+     * Forza il ricalcolo di quello che la tabella mostra. Serve al consumer che
+     * MUTA l'array bindato sul posto (push/splice): senza riassegnarlo, `ngModel`
+     * non notifica nulla e la tabella non se ne accorge.
+     *
+     * @param {boolean} relaunchSearch In viewmode rilancia anche la ricerca (default `true`)
+     */
+    forceRefresh(relaunchSearch?: boolean): void;
+    /**
+     * Azzera la selezione corrente (voci, esclusioni e "tutto selezionato").
+     * Come nell'originale l'evento NON viene emesso salvo richiesta esplicita.
+     *
+     * @param {boolean} emit Se `true` emette `onSelectionChanged`
+     */
+    resetSelection(emit?: boolean): void;
+    /**
+     * Errori di validazione: item → (id colonna → messaggio). Chiave per identità
+     * dell'oggetto, così l'errore segue la riga anche dopo ordinamenti e ripaginazioni.
+     */
+    private cellErrors;
+    /** true se c'è almeno un errore: il template lo usa per non pagare nulla nel caso normale */
+    hasCellErrors: _angular_core.WritableSignal<boolean>;
+    /**
+     * Riferimento a una cella su cui impostare/leggere un errore di validazione.
+     * Stessa firma dell'originale; a differenza sua funziona anche se la riga non è
+     * attualmente renderizzata, perché l'errore è tenuto dal componente e non dalla cella.
+     *
+     * @param {any} item Oggetto della riga
+     * @param {string} column Id della colonna (il `th`)
+     */
+    getCellReference(item: any, column: string): Est2CellRef;
+    /** Imposta (o azzera con `null`) l'errore di validazione di una cella */
+    setCellError(item: any, column: string, error?: string | null): void;
+    /** Azzera tutti gli errori di validazione (di una riga, o dell'intera tabella) */
+    clearCellErrors(item?: any): void;
+    /** Messaggio d'errore di una cella ('' se valida). Usato dal template. */
+    cellError(item: any, col: Est2Column): string;
     /**
      * Imposta in maniera programmatica la visibilità di un header — o di un header di
      * GRUPPO, nel qual caso la modifica scende in cascata su tutti i `*th` che lo
@@ -3052,6 +3151,28 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     private applyHeaderVisibility;
     /** Attiva/disattiva il pin di una colonna e persiste (dall'indicatore in testata) */
     togglePin(col: Est2Column, ev?: Event): void;
+    /** `AppEmbeddingExtensions` risolto pigramente: `providedIn:'root'` ma le sue
+     *  dipendenze possono mancare in setup isolati, quindi `get` può lanciare. */
+    private embSvc;
+    private resolveEmbedding;
+    /** true quando la tabella è incorporata in un'applicazione ospite */
+    get embedded(): boolean;
+    /** La dialog è aperta ma il backdrop non è ancora nel DOM: misuro appena compare */
+    private embedNotifyPending;
+    /**
+     * ViewChild-setter sul backdrop: appena esiste ne misuro l'altezza e la mando
+     * alla finestra principale, esattamente come faceva l'originale leggendola dal
+     * backdrop di ngx-bootstrap.
+     */
+    set dialogBackdropRef(ref: ElementRef<HTMLElement> | undefined);
+    /** Invia un messaggio alla finestra principale dell'applicazione ospite */
+    private postEmbedMessage;
+    /**
+     * Unico punto di apertura/chiusura della dialog: tiene allineata la notifica
+     * all'ospite, qualunque sia il pulsante che l'ha chiusa (Applica, Annulla,
+     * Ripristina, la X o il click sul backdrop).
+     */
+    private setColumnsDialogOpen;
     columnsDialogOpen: _angular_core.WritableSignal<boolean>;
     /** Lista di lavoro della dialog (copia, per poter annullare) */
     dialogCols: _angular_core.WritableSignal<Est2DialogColumn[]>;
@@ -3169,7 +3290,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) */
@@ -3481,4 +3611,4 @@ declare const EST2_EXPORT_GLOBAL_ACL: InjectionToken<string>;
 declare const EST2_DEFAULTS: InjectionToken<EsTableDefaultable>;
 
 export { AppOrdering, AppSearch, CornerMenuOption, EST2_DEBUG, EST2_DEFAULTS, EST2_EXPORT_GLOBAL_ACL, EST_DEBUG, EST_DEFAULTS, EST_EXPORT_GLOBAL_ACL, EsTable2Component, EsTableColumnsDefinition, EsTableComponent, EsTableDefaultable, EsTableModelChange, EsTableModule, EsTableModuleConfig, EsTableMultiValue, EsTableOperationDefinition, EsTablePagerComponent, EsTdDirective, EsTdEditorDirective, EsThDirective, GenericItem, Group, GroupAggregation, GroupFilter, GroupOrAggregation, ItemPropEditableReference, ItemsSelection, ReportColumn, ReportParam, ReportRow, ThTdProvider };
-export type { Est2Column, Est2DialogColumn, Est2HeaderGroupCell, Est2Row, InputType };
+export type { Est2CellRef, Est2Column, Est2DialogColumn, Est2HeaderGroupCell, Est2Row, InputType };

package/package.json

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