@esfaenza/es-table 11.2.77 → 11.2.80

package/lib/components/es-table/es_table.component.d.ts

@@ -48,16 +48,16 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
     private msgExts;
     private copyPasteDetector;
     private clipboardService;
-    export_H: ExportHandler;
-    columnMetadata_H: ColumnMetadataHandler;
-    dynamicMode_H: DynamicModeHandler;
-    hierarchyMode_H: HierarchyModeHandler;
-    items_H: ItemsHandler;
-    reportMode_H: ReportModeHandler;
-    rowGrouping_H: RowGroupingHandler;
-    selection_H: SelectionHandler;
-    private copySubscription;
-    private pasteSubscription;
+    /** @ignore */ export_H: ExportHandler;
+    /** @ignore */ columnMetadata_H: ColumnMetadataHandler;
+    /** @ignore */ dynamicMode_H: DynamicModeHandler;
+    /** @ignore */ hierarchyMode_H: HierarchyModeHandler;
+    /** @ignore */ items_H: ItemsHandler;
+    /** @ignore */ reportMode_H: ReportModeHandler;
+    /** @ignore */ rowGrouping_H: RowGroupingHandler;
+    /** @ignore */ selection_H: SelectionHandler;
+    /** @ignore */ private copySubscription;
+    /** @ignore */ private pasteSubscription;
     /** @ignore */
     constructor(ngControl: NgControl, prefService: PreferencesService, deafults: EsTableDefaultable, locale: string, lc: LocalizationService, cdr: ChangeDetectorRef, utilities_H: UtilitiesHandler, utiExts: UtilityService, expExts: ExportService, dateExts: DateService, msgExts: MessageService, copyPasteDetector: CopyPasteDetector, clipboardService: ClipboardService);
     /** Subject utilizzato internamente lato EsTable per causare il Focus lato componente di Input */
@@ -179,7 +179,11 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
     ColumnsPinnable: boolean;
     /** Indica se dev'essere disponibile il sistema di aggiornamento automatico */
     AutoUpdate: boolean;
-    /** Indica se dev'essere l'estable a gestire la ricerca, anche la prima */
+    /**
+     * @experimental Indica se dev'essere l'estable a gestire la ricerca, anche la prima.
+     *
+     * **ATTENZIONE: RICHIEDE MODIFICHE NON TRIVIALI ALLA PAGINA DI RICERCA CHE UTILIZZA QUESTO TIPO DI ES-TABLE. NON UTILIZZARE SE NON SI SA CIO' CHE SI STA FACENDO**
+     **/
     EsTableHandledSearch: boolean;
     /**
      * Decide se utilizzare o meno le CustomCells. Impostandolo a **true** l'es-table diventa in grado di gestire nativamente:
@@ -674,4 +678,9 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
      * @param {number} columnIndex Indice della colonna su cui è avvenuta la modifica
      */
     finalizeUserEdit(rowItem: TdElement, item: any, columnIndex: number): void;
+    private mouseIsDown;
+    private firstCoordinates;
+    mousedown(event: MouseEvent): void;
+    mouseenter(event: MouseEvent): void;
+    mouseup(event: any): void;
 }

package/lib/core/CopyPasteDetector.d.ts

@@ -1,6 +1,10 @@
 import { Subject } from "rxjs";
+/** Classe che fornisce dei metodi di estensione in grado di riconoscere e dispatchare l'evento copia e incolla lanciato su una pagina web */
 export declare class CopyPasteDetector {
+    /** Dispatcher del Copia */
     OnCopy: Subject<void>;
+    /** Dispatcher dell' Incolla */
     OnPaste: Subject<void>;
+    /** @ignore */
     constructor();
 }

package/lib/core/handlers/ColumnMetadataHandler.d.ts

@@ -38,6 +38,7 @@ export declare class ColumnMetadataHandler {
      * @param {EsThDirective[]} ths Colonne della tabella
      */
     reviewColumnsList(ths: EsThDirective[]): void;
+    /** In caso siano configurati dei th "Multi" (vedere la descrizione del campo **thMulti** di **EsThDirective**) questo metodo li "srotola" in tutti i th/td che devono effettivamente diventare */
     expandMultiThsAndTds(ths: EsThDirective[], tds: EsTdDirective[], items: any[]): {
         expThs: EsThDirective[];
         expTds: EsTdDirective[];

package/lib/core/handlers/ReportModeHandler.d.ts

@@ -11,6 +11,15 @@ export declare class ReportModeHandler {
     constructor(est: EsTableComponent, utilities: UtilitiesHandler);
     /** Metodo che si occupa di gestire la grafica della tabella in base alle informazioni di ordinamento colonne e paginazione contenuti nel modello */
     reviewReportBindings(): void;
+    /**
+     * Data una AppSearch questo metodo genera la lista di th e td che si possono collegare al giro standard.
+     * Se non ci fosse questo passaggio intermedio la gestione della modalità report sarebbe 100% custom,
+     * come poi lo era prima che la facessi passare dal giro che fanno tutte le altre modalità
+     *
+     * @param {AppSearch<any>} view View in modalità report contenente le informazioni sulle colonne
+     *
+     * @returns {{ ths: EsThDirective[], tds: EsTdDirective[] }} Lista di direttive per gli header e per il body
+     */
     generateThsAndTdsFromView(view: AppSearch<any>): {
         ths: EsThDirective[];
         tds: EsTdDirective[];

package/lib/core/handlers/SelectionHandler.d.ts

@@ -45,6 +45,7 @@ export declare class SelectionHandler {
      * @param {EsThDirective[]} ths Colonne su cui gli oggetti sono bindati
      */
     evaluateSingleCellSelection(items: any[], ths: EsThDirective[], dyn: EsTableColumnsDefinition[]): void;
+    /** @ignore */
     private fillSelectionStatusByDynamicColumns;
     /** @ignore */
     private fillSelectionStatusByEsThs;
@@ -172,8 +173,12 @@ export declare class SelectionHandler {
      * @param {any} event Evento Javascript di Click
      * @param {number} row Indice della riga. Non è l'indice vero e proprio ma è l'ordinale (.ordinal) dell'oggetto bindato su quella riga
      * @param {number} column Indice della colonna preso banalmente dall'ngIf sui thElement
+     * @param {{ row: number, column: number }} firstSelectionOverride Permette di overridare il primo elemento selezionato
      */
-    singleCellSelection(event: any, row: number, column: number): void;
+    singleCellSelection(event: any, row: number, column: number, firstSelectionOverride?: {
+        row: number;
+        column: number;
+    }): void;
     /**
      * Helper per ripulire lo stato di selezione delle singole celle della tabella, ad esclusione di una singola coordinata
      *

package/lib/directives/es_td_editor.directive.d.ts

@@ -1,4 +1,5 @@
 import { TemplateRef } from '@angular/core';
+/** Direttiva che rappresenta il template dell'editor di una cella all'interno della tabella */
 export declare class EsTdEditorDirective {
     Template: TemplateRef<any>;
     /** Id dell'Editor */

package/lib/domain/externals/EsTableColumnsDefinition.d.ts

@@ -41,6 +41,7 @@ export declare class EsTableColumnsDefinition {
         id: string;
         description: string;
     }[], EditorName?: string, RendererName?: string);
+    static build(parsObj: any): EsTableColumnsDefinition;
     /** Routerlink che verrà generato a runtime basandosi sulle informazioni di **routePath** e **routeParameterProperties** */
     routerLink: any;
 }

package/lib/domain/externals/appsearch/AppSearch.d.ts

@@ -79,6 +79,16 @@ export declare class AppSearch<T> {
     /**
      * Permette di resettare un AppSearch ai valori di default.
      * Reso statico perché fra una deserializzazione e l'altra si potrebbe perdere il prototype del costruttore
+     *
+     * @param {AppSearch<any>} aps AppSearch da resettare
      */
     static reset(aps: AppSearch<any>): void;
+    /**
+     * Permette di ottenere un nuovo riferimento all'AppSearch passata come parametro.
+     * Internamente utilizza il JSON.parse(JSON.stringify(X)) con la differenza che prima stacca il riferimento agli items per evitare di
+     * reserializzare potenzialmente centinaia di elementi. Il riferimento viene poi ricollegato alla nuova appsearch generata
+     *
+     * @param {AppSearch<any>} aps AppSearch di cui estrarre un nuovo riferimento equivalente
+     */
+    static newref(aps: AppSearch<any>): any;
 }

package/lib/domain/internals/EsTableColumn.d.ts

@@ -22,6 +22,7 @@ export declare class EsTableColumn {
      * @param {string} description Descrizione (Header)
      * @param {boolean} visible Indica se di default mostrarla o meno
      * @param {boolean} fixed Indica se è una colonna fixed
+     * @param {boolean} pinnable Indica se una colonna può essere pinnata
      * @param {boolean} pinned Indica se è una colonna pinnata
      * @param {number} pinnedWidth Indica la dimensione da assegnare a questa colonna quando è pinnata
      * @param {TemplateRef<any>} template Indica il template da usare per mostrare il testo dell'Header

package/lib/domain/internals/GroupPager.d.ts

@@ -10,8 +10,9 @@ export declare class GroupPager {
     /**
      * Costruttore
      *
-     * @param {number} groupLevel Livello del gruppo a cui questo separatore fa riferimento
-     * @param {string} parentKey Chiave del gruppo parent se esiste
+     * @param {number} _grouplevel Livello del gruppo a cui questo separatore fa riferimento
+     * @param {string} _thisRoute Route che identifica la gerarchia del gruppo e chi sono i parent
+     * @param {string} _parent Chiave del gruppo parent se esiste
      * @param {AppSearch<any>} view Vista di ricerca collegata a questo elemento
      * @param {'groups' | 'items'} searches Indica che cosa cerca questo separatore, se sottogruppi o oggetti
      */

package/lib/domain/internals/TdElement.d.ts

@@ -1,4 +1,5 @@
 import { SafeHtml } from "@angular/platform-browser";
+/** Interfaccia di passaggio fra i dati che arrivano come direttiva / configurazione alla struttura interna su cui vengono generati i componenti es-td */
 export interface TdElement {
     /** Id della cella, dev'essere lo stesso della colonna **EsTh** relativa */
     ID: string;

package/lib/domain/internals/ThElement.d.ts

@@ -1,4 +1,9 @@
 import { TemplateRef } from "@angular/core";
+/**
+ * @ignore Interfaccia di passaggio fra i dati che arrivano come direttiva / configurazione alla struttura interna su cui vengono generati i componenti es-th
+ *
+ * Per informazioni sulle singole proprietà fare riferimento alla direttiva **EsThDirective**
+ */
 export interface ThElement {
     Pinned: boolean;
     Fixed: boolean;

package/package.json

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