@esfaenza/es-table 20.3.21 → 20.3.23

package/index.d.ts

@@ -2352,6 +2352,15 @@ declare class EsTableModuleConfig {
     globalExportAclExpression?: string;
 }
 
+/** Cella di una riga di header-group multi-livello (span su N colonne-dato). */
+interface Est2HeaderGroupCell {
+    id: string;
+    span: number;
+    isGroup: boolean;
+    label: string;
+    template: TemplateRef<any> | null;
+}
+
 /** Specifica di una singola aggregazione estratta da un template `{func:format}` */
 interface Est2AggSpec {
     /** Colonna su cui calcolare l'aggregazione */
@@ -2378,13 +2387,16 @@ interface Est2Column {
     orderable: boolean;
     alignment: 'left' | 'right' | 'center';
     property: string | null;
-    type: string | null;
+    type: InputType | null;
     source: {
         id: any;
         description: string;
     }[] | null;
     format: string | null;
+    /** classe CSS della CELLA (`*td Class`) — applicata solo ai `<td>` */
     cssClass: string;
+    /** classe CSS dell'HEADER (`*th Class`) — applicata solo ai `<th>` */
+    headerClass: string;
     wrap: boolean;
     /** true se questa colonna è una chiave di raggruppamento (`thGroup`) */
     isGroup: boolean;
@@ -2412,18 +2424,44 @@ interface Est2Column {
     /** colonna Multi: indice dell'entry dentro l'array della proprietà */
     multiIndex?: number | null;
 }
-/** Cella di una riga di header-group multi-livello (span su N colonne-dato). */
-interface Est2HeaderGroupCell {
-    /** id del gruppo, o chiave sintetica per gli spacer */
-    id: string;
-    /** numero di colonne-dato coperte */
-    span: number;
-    /** true se è un vero header di gruppo (ha contenuto), false se spacer vuoto */
-    isGroup: boolean;
-    /** etichetta di fallback (quando non c'è un template proiettato) */
-    label: string;
-    /** template proiettato dell'header di gruppo (contenuto del `*th`) */
-    template: TemplateRef<any> | null;
+
+/**
+ * Riga della tabella. Oltre ai dati aperti del consumer (index signature) porta
+ * un insieme FISSO di flag interni iniettati da grouping/hierarchy/selezione. Tiparli
+ * qui documenta il contratto in un unico posto e riduce la superficie di refuso.
+ */
+interface Est2Row {
+    [k: string]: any;
+    /** selezione di riga */
+    _selected?: boolean;
+    /** riga-gruppo (intestazione di un raggruppamento) */
+    _group?: boolean;
+    /** riga-dato (foglia) */
+    _item?: boolean;
+    /** visibile (collasso gruppo / gerarchia) */
+    _visible?: boolean;
+    /** gruppo/nodo espanso */
+    _expanded?: boolean;
+    /** livello gerarchico (1-based) */
+    _level?: number;
+    /** profondità di annidamento gruppo (0-based) */
+    _grouplevel?: number;
+    /** aggregazioni per colonna → funzione → valore formattato */
+    _agg?: Map<string, Map<string, string>>;
+    /** chiave path del gruppo/item */
+    _thisKey?: string;
+    /** chiave del gruppo padre */
+    _parent?: string | null;
+    /** numero di sotto-gruppi */
+    _groupscount?: number;
+    /** riga separatore (consumer) */
+    _sep?: boolean;
+    /** gerarchia: il nodo ha figli */
+    parent?: boolean;
+    /** id per trackBy (consumer) */
+    _hash?: any;
+    /** oggetti "generic": bag delle proprietà */
+    properties?: Record<string, any>;
 }
 /**
  * es-table2 — riscrittura 2026 dell'es-table.
@@ -2472,6 +2510,7 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     SelectionDisabled: _angular_core.InputSignal<boolean>;
     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 */
     readonly _UseSelectionCache: _angular_core.InputSignal<boolean>;
     UseSelectionCache: _angular_core.WritableSignal<boolean>;
     readonly _ShiftClick: _angular_core.InputSignal<boolean>;
@@ -2512,6 +2551,7 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     ContainerClass: _angular_core.WritableSignal<string>;
     EsTableHandledSearch: _angular_core.InputSignal<boolean>;
     SearchThrottle: _angular_core.InputSignal<number>;
+    /** @deprecated NO-OP di parità v1 (ridimensionamento colonne): dichiarato per il drop-in, non implementato */
     readonly _ColumnsResizable: _angular_core.InputSignal<boolean>;
     ColumnsResizable: _angular_core.WritableSignal<boolean>;
     readonly _ColumnsPinnable: _angular_core.InputSignal<boolean>;
@@ -2545,13 +2585,17 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     SavePreferences: _angular_core.WritableSignal<boolean>;
     /** Nome della tabella: chiave per la persistenza delle preferenze colonne (localStorage) */
     Name: _angular_core.InputSignal<string>;
+    /** @deprecated NO-OP di parità v1 (stile paginazione gruppi): dichiarato per il drop-in, non risolto/usato */
     readonly _RowGroupingPagingStyle: _angular_core.InputSignal<"left" | "right">;
     readonly _ShowItemGroupsColumns: _angular_core.InputSignal<boolean>;
     Editable: _angular_core.InputSignal<boolean>;
     RangeSelection: _angular_core.InputSignal<boolean>;
     ItemSourceProperty: _angular_core.InputSignal<string>;
+    /** @deprecated NO-OP di parità v1 (header-group manuali, superati da `Parent:`/`Multi`) */
     HasHeaderGroup: _angular_core.InputSignal<boolean>;
+    /** @deprecated NO-OP di parità v1 (seconda riga header-group manuale) */
     HasSecondaryHeaderGroup: _angular_core.InputSignal<boolean>;
+    /** @deprecated NO-OP di parità v1 (drill-down gruppi server-side, non portato) */
     SearchView: _angular_core.InputSignal<AppSearch<any>>;
     /** Abilita il "patacchino" di auto-aggiornamento (toggle + intervallo) in alto a destra */
     readonly _AutoUpdate: _angular_core.InputSignal<boolean>;
@@ -2559,7 +2603,7 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     /** Provider esterno di `*th`/`*td` (pattern `td_th_provider`), passato per riferimento */
     EsThTdProvider?: ThTdProvider;
     onOrderChanged: EventEmitter<AppOrdering>;
-    onSearchRequest: EventEmitter<any>;
+    onSearchRequest: EventEmitter<boolean>;
     onSelectionChanged: EventEmitter<ItemsSelection<any>>;
     onRemoval: EventEmitter<any>;
     onAbortRemoval: EventEmitter<any>;
@@ -2585,7 +2629,7 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     arrayMode: _angular_core.WritableSignal<boolean>;
     firstBind: _angular_core.WritableSignal<boolean>;
     /** Righe attualmente visualizzate (già paginate/ordinate) */
-    boundSource: _angular_core.WritableSignal<any[]>;
+    boundSource: _angular_core.WritableSignal<Est2Row[]>;
     /** Colonne derivate dalle direttive `*th`/`*td` */
     columns: _angular_core.WritableSignal<Est2Column[]>;
     /** true se la tabella è pilotata dalle direttive (`*th`), false se template semplice */
@@ -2628,25 +2672,26 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     hasPinned: _angular_core.Signal<boolean>;
     /** Larghezza (px) della colonna di selezione quando sticky */
     private readonly SEL_STICKY_W;
+    /**
+     * Offset `left` (px) cumulativi delle colonne sticky, memoizzati: ricalcolati solo
+     * quando cambiano `visibleColumns`/`Selection`. Prima `pinnedLeftPx` era O(n) per
+     * chiamata e veniva invocato per OGNI cella pinnata del corpo → O(P²·R) per CD.
+     */
+    pinnedOffsets: _angular_core.Signal<number[]>;
     /** Offset `left` (px) di una colonna sticky all'indice `ci` in visibleColumns */
     pinnedLeftPx(ci: number): number;
     /** true se la tabella renderizza colonne strutturate (direttive/dinamica/report), non template semplici */
     usesColumns: _angular_core.Signal<boolean>;
     /**
-     * Righe di header-group multi-livello, dall'alto (root) verso il basso (padre
-     * immediato). Ricalcolate automaticamente su riordino/visibilità colonne.
-     *
-     * Ogni gruppo si allinea in BASSO: il padre immediato di una colonna sta sempre
-     * nella riga direttamente sopra la colonna; gli antenati più alti salgono. Le
-     * colonne senza gruppo (o con catena più corta) hanno celle-spacer vuote in alto.
+     * Righe di header-group multi-livello (bottom-aligned). Delega al motore puro
+     * `core/header-groups.ts`; ricalcolate automaticamente su riordino/visibilità.
      */
     headerGroupRows: _angular_core.Signal<Est2HeaderGroupCell[][]>;
     /** true se ci sono header-group da renderizzare */
     hasHeaderGroups: _angular_core.Signal<boolean>;
     /**
-     * Indici (in visibleColumns) delle colonne che aprono un nuovo gruppo-colonna,
-     * cioè dove il gruppo padre immediato cambia rispetto alla colonna precedente.
-     * Serve a disegnare i confini dei gruppi anche nel corpo della tabella.
+     * Indici (in visibleColumns) delle colonne che aprono un nuovo gruppo-colonna.
+     * Delega al motore puro; disegna i confini dei gruppi anche nel corpo tabella.
      */
     columnGroupBoundaries: _angular_core.Signal<Set<number>>;
     /** Numero di elementi totali (per il pager) */
@@ -2656,10 +2701,11 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     /** Numero totale di pagine per il pager */
     totalPages: _angular_core.Signal<any>;
     private readonly effectiveAllValue;
-    private inited;
     private onChange;
     private onTouched;
     constructor(ngControl: NgControl, cdr: ChangeDetectorRef, hostEl: ElementRef<HTMLElement>, prefService: PreferencesService, injector: Injector, defaults: EsTableDefaultable, debugMode: boolean, exportGlobalAcl: string);
+    /** Controller di esportazione (E4) — logica in `controllers/export.controller.ts` */
+    private exportCtrl;
     ngOnInit(): void;
     ngOnDestroy(): void;
     /** Risoluzione input: valore esplicito || default di progetto || hard default */
@@ -2691,14 +2737,13 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     private detectMode;
     private buildColumns;
     /**
-     * Srotola le colonne `*th Multi:true` sui dati: ogni entry unica
-     * `(header_group, header)` della proprietà-array diventa una colonna sintetica,
-     * e i livelli di `header_group` (separati da ">") alimentano gli header-group.
+     * Srotola le colonne `*th Multi:true` sui dati. Delega al motore puro
+     * `core/columns.ts`; qui applico allo stato le mappe th/parent aggiornate.
      */
     private buildMultiColumns;
-    /** Costruisce le colonne da una `EsTableColumnsDefinition[]` (modalità dinamica) */
+    /** Colonne dinamiche — delega al motore puro `core/columns.ts` */
     private buildDynamicColumns;
-    /** Costruisce le colonne da `report_columns` (modalità report): il valore è preso per indice */
+    /** Colonne report — delega al motore puro `core/columns.ts` */
     private buildReportColumns;
     /** Sceglie la sorgente delle colonne in base al modello: report → dinamica → direttive */
     private resolveColumns;
@@ -2826,21 +2871,16 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     onCellDblClick(item: any, col: Est2Column, r: number, c: number): void;
     commitEdit(item: any, col: Est2Column): void;
     cancelEdit(): void;
+    /** Lettura bag-aware di una proprietà (gestisce gli oggetti "generic" con `properties`) */
+    private readProp;
+    /** Scrittura bag-aware di una proprietà */
+    private writeProp;
     /** Valore grezzo su cui operano editing/paste (gestisce gli oggetti `properties`) */
     private rawCellValue;
     /** Scrive un valore GIÀ convertito e restituisce l'eventuale EsTableModelChange */
     private applyCoerced;
-    /**
-     * Converte una stringa (digitata/incollata) nel tipo della colonna, segnalando
-     * se è compatibile. `ok:false` = valore incompatibile col tipo (es. testo in una
-     * colonna numerica) → chi chiama avvisa e non scrive. Una stringa vuota è sempre
-     * valida e azzera il valore (null).
-     */
+    /** Coercizione valore → delega al motore puro `core/coercion.ts` */
     private coerceValue;
-    /** Parsing numerico tollerante (separatori di migliaia + virgola/punto decimale). `NaN` = non numerico */
-    private toNumber;
-    /** Parsing date tollerante: `dd/MM/yyyy [HH:mm[:ss]]` o formati nativi. `null` = non valida */
-    private parseDateLoose;
     /** Testo visualizzato di una cella (usato dalla copia) */
     cellDisplayText(item: any, col: Est2Column): string;
     /** true se `childKey` è `ancestorKey` stesso o un suo discendente (senza collisioni di prefisso) */
@@ -2955,7 +2995,10 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
      * colonne esterne.
      */
     /** Catena degli antenati-gruppo (root→padre immediato) di una colonna; `[]` se non raggruppata */
+    /** Catena antenati di una colonna — delega al motore `core/header-groups.ts` */
+    private ancestorChain;
     private columnChain;
+    /** Riordino group-contiguo — delega al motore `core/header-groups.ts` */
     private enforceGroupContiguity;
     resetColumnsDialog(): void;
     exportMenuOpen: _angular_core.WritableSignal<boolean>;
@@ -2964,45 +3007,14 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     toggleCornerMenu(): void;
     /** Chiude i menu a tendina del chrome quando si clicca fuori */
     onDocClick(): void;
-    /** Colonne da esportare (tutte o solo visibili) e con dato testuale */
-    private exportColumns;
-    /** Righe-dato correnti (esclude righe-gruppo) */
-    private exportRows;
-    /** Matrice [header, ...righe] con i valori visualizzati */
-    private buildExportMatrix;
-    /**
-     * Etichetta di intestazione per l'export self-contained: usa il testo header
-     * RENDERIZZATO letto dal DOM (rispetta il casing del template `*th`, es. "ID"),
-     * con fallback su `columnLabel` (headerText statico / id) se il DOM non è leggibile.
-     */
-    private headerLabel;
-    /** @ignore Evita esportazioni concorrenti (parità con l'`ExportHandler` originale) */
-    private exportInProgress;
-    /**
-     * `ExportService` risolto PIGRAMENTE e in modo difensivo: `undefined` = non ancora
-     * risolto, `null` = non disponibile. È `providedIn:'root'` ma la sua costruzione
-     * dipende da `LocalizationService`/`DateService`/`UtilityService`; se quella catena
-     * non è presente (test isolati, o consumer che non importa `@esfaenza/extensions`),
-     * `injector.get` lancia → catturo e faccio fallback al percorso self-contained.
-     */
-    private exportService;
-    private resolveExportService;
+    /** Export delegato al controller `ExportController` (E4); chiude prima il menu chrome. */
     export(format?: 'CSV' | 'XLSX'): void;
     /**
-     * Delego all'`ExportService` originale replicando esattamente `ExportHandler.tryExport`:
-     * `export(data, format, fileName, type, columnsFilter, genericHeaders)`. Così l'export
-     * è guidato dai decoratori `@Export` della classe `type`, byte-compatibile con es-table1.
-     * Se il servizio non è disponibile (raro: è `providedIn:'root'` nel package), fallback
-     * al percorso self-contained mappando le colonne `*th`.
-     */
-    private exportViaService;
-    /** @deprecated Percorso di fallback self-contained (usato solo senza ExportService) */
-    private exportData;
-    private exportCsv;
-    private exportXlsx;
-    /** Nome file rispettando l'estensione richiesta */
-    private exportFileName;
-    private downloadBlob;
+     * Mappa id-colonna → testo header RENDERIZZATO letto dal DOM (rispetta il casing
+     * del template `*th`, es. "ID"). Costruita in un'unica passata; usata dall'export
+     * self-contained e dalla dialog colonne (prima due letture DOM separate).
+     */
+    private renderedHeaderTexts;
     cornerAction(id: string): void;
     rowClass(item: any): string;
     hasChrome(): boolean;
@@ -3019,7 +3031,6 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     cellValue(item: any, col: Est2Column): any;
     /** Entry Multi corrispondente a una cella (`item[multiProp][multiIndex]`) */
     multiCell(item: any, col: Est2Column): any;
-    trackByIndex: (i: number) => number;
     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; }]>;
@@ -3317,4 +3328,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, Est2HeaderGroupCell, InputType };
+export type { Est2Column, Est2HeaderGroupCell, Est2Row, InputType };

package/package.json

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