@esfaenza/es-table 20.3.33 → 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>;
@@ -2769,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>;
@@ -3058,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
@@ -3082,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[]>;
@@ -3520,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.33",
+  "version": "20.3.35",
   "dependencies": {
     "tslib": "^2.0.0"
   },