@esfaenza/es-table 20.3.33 → 20.3.36

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
@@ -2512,6 +2524,8 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     private hostEl;
     private prefService;
     private injector;
+    /** Dizionario del componente (vedi `viewProviders`): usato dal template con `| localize : lc` */
+    lc: LocalizationService;
     private defaults;
     debugMode: boolean;
     exportGlobalAcl: string;
@@ -2559,6 +2573,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 +2796,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>;
@@ -2777,7 +2811,9 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     private readonly effectiveAllValue;
     private onChange;
     private onTouched;
-    constructor(ngControl: NgControl, cdr: ChangeDetectorRef, hostEl: ElementRef<HTMLElement>, prefService: PreferencesService, injector: Injector, defaults: EsTableDefaultable, debugMode: boolean, exportGlobalAcl: string);
+    constructor(ngControl: NgControl, cdr: ChangeDetectorRef, hostEl: ElementRef<HTMLElement>, prefService: PreferencesService, injector: Injector, 
+    /** Dizionario del componente (vedi `viewProviders`): usato dal template con `| localize : lc` */
+    lc: LocalizationService, defaults: EsTableDefaultable, debugMode: boolean, exportGlobalAcl: string);
     /** Controller di esportazione (E4) — logica in `controllers/export.controller.ts` */
     private exportCtrl;
     ngOnInit(): void;
@@ -2937,6 +2973,12 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     /** Avviso transitorio mostrato in un piccolo toast (es. incolla incompatibile) */
     notice: _angular_core.WritableSignal<string>;
     private noticeTimer;
+    /**
+     * Scorciatoia per il dizionario del componente. Il servizio di localizzazione NON
+     * gestisce segnaposto, quindi le frasi con parti variabili vanno spezzate in
+     * frammenti e ricomposte qui attorno ai valori (vedi `applyPaste`/`commitEdit`).
+     */
+    private t;
     private flashNotice;
     private clearTextSelection;
     onDocCopy(event: ClipboardEvent): void;
@@ -3058,6 +3100,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 +3161,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[]>;
@@ -3221,7 +3322,7 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     private persistColumnWidths;
     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, { optional: true; }, { optional: true; }, { optional: true; }]>;
+    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>;
 }
 
@@ -3389,6 +3490,12 @@ declare class EstPropInsensitivePipe implements PipeTransform {
  * viewMode/arrayMode — la logica di applicazione vive nel componente padre.
  */
 declare class EsTable2PagerComponent {
+    lc: LocalizationService;
+    /**
+     * Dizionario ereditato dai `viewProviders` dell'es-table2: il pager vive nella
+     * VISTA del componente padre, quindi ne condivide le traduzioni.
+     */
+    constructor(lc: LocalizationService);
     /** Valore convenzionale di items-per-page che rappresenta "Tutti" */
     readonly allValue = 999999;
     page: _angular_core.InputSignal<number>;
@@ -3520,4 +3627,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.36",
   "dependencies": {
     "tslib": "^2.0.0"
   },