@esfaenza/es-table 20.3.28 → 20.3.30

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 */
@@ -2502,10 +2508,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 +2684,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 */
@@ -2724,6 +2745,8 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     /** Controller di esportazione (E4) — logica in `controllers/export.controller.ts` */
     private exportCtrl;
     ngOnInit(): void;
+    /** @ignore Handler di scroll in cattura (chiude i menu del chrome) */
+    private onAnyScroll;
     ngOnDestroy(): void;
     /** Risoluzione input: valore esplicito || default di progetto || hard default */
     private io;
@@ -2952,6 +2975,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;
     /**
@@ -2971,6 +2996,28 @@ 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>;
@@ -2981,6 +3028,7 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
         visible: boolean;
         pinned: boolean;
         grouped: boolean;
+        fixed: boolean;
     }[]>;
     /** Etichetta leggibile di una colonna (header statico o id) */
     columnLabel(col: Est2Column): string;
@@ -3004,6 +3052,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) */
@@ -3036,10 +3089,29 @@ declare class EsTable2Component implements ControlValueAccessor, AfterContentIni
     resetColumnsDialog(): void;
     exportMenuOpen: _angular_core.WritableSignal<boolean>;
     cornerMenuOpen: _angular_core.WritableSignal<boolean>;
-    toggleExportMenu(): void;
-    toggleCornerMenu(): void;
+    /**
+     * Coordinate VIEWPORT del pannello di menu aperto. I menu sono renderizzati fuori
+     * da `.est2-scroll` e posizionati `fixed`: dentro lo scroller l'`overflow:auto` li
+     * troncava (su una tabella di poche righe il menu usciva dal box e spariva).
+     */
+    menuAnchor: _angular_core.WritableSignal<{
+        top: number;
+        right: number;
+    }>;
+    toggleExportMenu(ev?: Event): void;
+    toggleCornerMenu(ev?: Event): void;
+    /** Chiude entrambi i menu del chrome */
+    closeChromeMenus(): void;
+    /**
+     * Ancora il menu al bottone che l'ha aperto: allineo il bordo DESTRO del pannello a
+     * quello del bottone e lo apro sotto. Se sotto non c'è spazio nel viewport, lo ribalto
+     * sopra (misurando il pannello dopo il render).
+     */
+    private anchorMenuTo;
     /** Chiude i menu a tendina del chrome quando si clicca fuori */
     onDocClick(): void;
+    /** Un menu `fixed` non segue più l'ancora: su resize lo chiudo. */
+    onViewportResize(): void;
     /** Export delegato al controller `ExportController` (E4); chiude prima il menu chrome. */
     export(format?: 'CSV' | 'XLSX'): void;
     /**

package/package.json

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