@esfaenza/es-table 20.3.29 → 20.3.31

package/index.d.ts

@@ -2417,6 +2417,12 @@ interface Est2Column {
     rendererName?: string | null;
     /** true se la colonna è "pinnata" (sticky a sinistra durante lo scroll orizzontale) */
     pinned?: boolean;
+    /**
+     * true se la colonna è FIXED (`*th Fixed:true` o `*th Group:true`): non può essere
+     * nascosta né riposizionata e resta ancorata in testa alla tabella. Solo le colonne
+     * pinnate possono precederla. Stesso contratto dell'es-table originale.
+     */
+    fixed?: boolean;
     /** larghezza in px di DEFAULT della colonna pinnata (dal `PinnedWidth` della direttiva) */
     pinnedWidth?: number | null;
     /** larghezza in px IMPOSTATA dall'utente via resize (qualsiasi colonna); sovrascrive l'auto/pinnedWidth */
@@ -2427,6 +2433,29 @@ interface Est2Column {
     multiIndex?: number | null;
 }
 
+/**
+ * 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
+ * dell'`*th` ed è valorizzato SOLO quando la colonna non è renderizzata — è l'unico
+ * modo di etichettare una colonna `Visible:false` o nascosta, che nel DOM non esiste.
+ */
+interface Est2DialogColumn {
+    id: string;
+    /** etichetta testuale completa (prefisso gruppi incluso) */
+    label: string;
+    /** prefisso col percorso dei gruppi, es. `( Energia - Attiva )` — vuoto se nessun gruppo */
+    prefix: string;
+    /** template dell'header, usato quando la colonna non è renderizzata */
+    tmpl: TemplateRef<any> | null;
+    /** contesto del template (colonne Multi: `{ $implicit: header }`) */
+    tmplCtx: any;
+    visible: boolean;
+    pinned: boolean;
+    /** appartiene a un header-group (o è Multi): non pinnabile */
+    grouped: boolean;
+    /** colonna `Fixed`: sempre visibile e non riposizionabile */
+    fixed: boolean;
+}
 /**
  * Riga della tabella. Oltre ai dati aperti del consumer (index signature) porta
  * un insieme FISSO di flag interni iniettati da grouping/hierarchy/selezione. Tiparli
@@ -2502,10 +2531,18 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     private ctxMenuSub?;
     /** Altezza dell'header (misurata): la barra di selezione la usa per coprirlo esattamente */
     selbarHeight: _angular_core.WritableSignal<number>;
+    /**
+     * Larghezza (misurata) della colonna "chrome" sticky a destra. La barra di selezione
+     * si ferma prima di essa: altrimenti "Azzera selezione" finirebbe SOTTO la colonna
+     * sticky (che sta più in alto nello stacking per restare cliccabile durante la selezione).
+     */
+    chromeWidth: _angular_core.WritableSignal<number>;
     private headerEl?;
     private headerRO?;
-    /** ViewChild-setter: (ri)osserva l'header appena compare/cambia, mantenendo `selbarHeight` allineata */
+    /** ViewChild-setter: (ri)osserva l'header appena compare/cambia, mantenendo le misure allineate */
     set theadRef(ref: ElementRef<HTMLElement> | undefined);
+    /** Misura header (altezza) e colonna chrome (larghezza) per il posizionamento della select-bar */
+    private measureHeader;
     readonly _Selection: _angular_core.InputSignal<boolean>;
     Selection: _angular_core.WritableSignal<boolean>;
     SingleSelection: _angular_core.InputSignal<boolean>;
@@ -2670,6 +2707,13 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     get denseClass(): boolean;
     /** Colonne visibili, con le colonne pinnate spostate in testa (stabile) */
     visibleColumns: _angular_core.Signal<Est2Column[]>;
+    /**
+     * Ordinamento STRUTTURALE delle colonne, parità con l'es-table originale
+     * (`ColumnMetadataHandler`): prima le colonne pinnate, poi le `Fixed` non pinnate,
+     * poi tutte le altre — mantenendo stabile l'ordine relativo dentro ogni blocco.
+     * Una colonna `Fixed` resta quindi sempre in testa e solo una pinnata può precederla.
+     */
+    private sortStructural;
     /** Numero di colonne pinnate visibili */
     pinnedCount: _angular_core.Signal<number>;
     /** true se c'è almeno una colonna pinnata */
@@ -2954,6 +2998,8 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     private columnPrefs;
     /** Applica ordine + visibilità + pin + larghezze delle preferenze a una lista di colonne appena costruita */
     private setColumns;
+    /** Mappa `{id: px}` delle larghezze impostate dall'utente (resize), da conservare nelle prefs in memoria */
+    private currentWidths;
     /** true una volta caricate le preferenze dal server (evita retrieve multipli) */
     private prefsLoaded;
     /**
@@ -2973,17 +3019,33 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
      * `{ columns (visibili), column_ordering (ordine), orders (ordinamenti) }`.
      */
     private saveColumnPrefs;
+    /**
+     * 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
+     * dichiarano come `Parent`. Parità di firma con l'es-table originale.
+     *
+     * Le colonne `Fixed` sono ignorate (per contratto sempre visibili). La modifica
+     * aggiorna anche le preferenze IN MEMORIA, così sopravvive ai rebuild delle colonne
+     * (paginazione, refresh, nuovi dati); non viene persistita sul server.
+     *
+     * @param {string} groupOrHeader Id dell'header (o del gruppo) di cui settare la visibilità
+     * @param {boolean} visibility Visibilità da impostare
+     * @param {boolean} refresh Se `true` (default) aggiorna la tabella dopo la modifica
+     * @param {boolean} relaunchSearch Se `true` (default) in viewmode rilancia la ricerca
+     */
+    setHeaderVisibility(groupOrHeader: string, visibility: boolean, refresh?: boolean, relaunchSearch?: boolean): void;
+    /**
+     * Applica la visibilità a una colonna e, se `id` è un header di gruppo, ricorsivamente
+     * a tutti i suoi figli.
+     *
+     * @returns {boolean} `true` se almeno una colonna è stata modificata
+     */
+    private applyHeaderVisibility;
     /** Attiva/disattiva il pin di una colonna e persiste (dall'indicatore in testata) */
     togglePin(col: Est2Column, ev?: Event): void;
     columnsDialogOpen: _angular_core.WritableSignal<boolean>;
     /** Lista di lavoro della dialog (copia, per poter annullare) */
-    dialogCols: _angular_core.WritableSignal<{
-        id: string;
-        label: string;
-        visible: boolean;
-        pinned: boolean;
-        grouped: boolean;
-    }[]>;
+    dialogCols: _angular_core.WritableSignal<Est2DialogColumn[]>;
     /** Etichetta leggibile di una colonna (header statico o id) */
     columnLabel(col: Est2Column): string;
     /** true se la colonna appartiene a un gruppo (multi o `Parent`): non è pinnabile */
@@ -2993,6 +3055,8 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
      * rispetta casing/contenuto) preceduto dal percorso dei gruppi, es.
      * `( Energia - Attiva ) Fascia F1`.
      */
+    private dialogGroupPrefix;
+    /** Etichetta testuale completa di una colonna nella dialog (prefisso gruppi + foglia) */
     private dialogLabelFor;
     openColumnsDialog(): void;
     closeColumnsDialog(): void;
@@ -3006,6 +3070,11 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
      * gruppo → si sposta l'INTERO blocco del gruppo (al livello di divergenza).
      */
     dialogMove(i: number, dir: -1 | 1): void;
+    /** true se la riga della dialog è riposizionabile: pinnate e `Fixed` sono ancorate in testa */
+    canReorder(c: {
+        pinned: boolean;
+        fixed: boolean;
+    }): boolean;
     /** Indice della riga trascinata (o null) */
     dragIndex: _angular_core.WritableSignal<number>;
     /** Indice della riga sotto il cursore durante il drag (per l'indicatore) */
@@ -3403,4 +3472,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, Est2Row, InputType };
+export type { Est2Column, Est2DialogColumn, Est2HeaderGroupCell, Est2Row, InputType };

package/package.json

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