@esfaenza/es-table 13.3.2 → 14.2.0

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

@@ -1,31 +1,53 @@
+import { InputType } from "../types";
 /** Classe che identifica una colonna. Utilizzata in modalità "Colonne dinamiche" */
 export declare class EsTableColumnsDefinition {
-    description: string;
-    propertyName: string;
-    routePath: string;
-    routeParameterProperties: string[];
-    dataOrder: 'ASC' | 'DESC';
-    columnOrder: number;
-    visible: boolean;
-    clss: string;
-    orderable: boolean;
-    headerWraps: boolean;
+    Description: string;
+    PropertyName: string;
+    RoutePath: string;
+    RouteParameterProperties: string[];
+    DataOrder: 'ASC' | 'DESC';
+    ColumnOrder: number;
+    Visible: boolean;
+    Clss: string;
+    Orderable: boolean;
+    HeaderWraps: boolean;
+    PropertyType: InputType | string;
+    PropertySource: {
+        id: string;
+        description: string;
+    }[];
+    EditorName: string;
+    RendererName: string;
+    edits: {
+        [index: string]: {
+            _editing: boolean;
+            old_value: string;
+        };
+    };
     /**
      * Costruttore
      *
-     * @param {string} description Descrizione della colonna
-     * @param {string} propertyName Nome della proprietà del modello in cui sono contenuti i dati da visualizzare per questa colonna
-     * @param {string} routePath Route di navigazione. Es. "['/pages/mod/mod_detail', { 'idItem': '{0}', 'idItem2' : '{1}' }]"
-     * @param {string[]} routeParameterProperties Proprietà da bindare a **routePath** per generare la route completa.
+     * @param {string} Description Descrizione della colonna
+     * @param {string} PropertyName Nome della proprietà del modello in cui sono contenuti i dati da visualizzare per questa colonna
+     * @param {string} RoutePath Route di navigazione. Es. "['/pages/mod/mod_detail', { 'idItem': '{0}', 'idItem2' : '{1}' }]"
+     * @param {string[]} RouteParameterProperties Proprietà da bindare a **routePath** per generare la route completa.
      * L'indice scritto in **routePath** è l'indice di accesso a questo array. Es. ["iditem", "iditem2"]
-     * @param {'ASC' | 'DESC' } dataOrder Ordinamento dei dati presentati in questa colonna
-     * @param {number} columnOrder Ordinamento di questa colonna
-     * @param {boolean} visible Visibilità o meno della colonna
-     * @param {string} clss Classe da applicare sia ai TD che ai TH relativi a questa colonna
-     * @param {boolean} orderable Indica se la colonna è ordinabile o no (nel senso ASC / DESC / NONE)
-     * @param {boolean} headerWraps Indica se il testo dell'header dev'essere wrappato all'interno del th. Di default no.
+     * @param {'ASC' | 'DESC' } DataOrder Ordinamento dei dati presentati in questa colonna
+     * @param {number} ColumnOrder Ordinamento di questa colonna
+     * @param {boolean} Visible Visibilità o meno della colonna
+     * @param {string} Clss Classe da applicare sia ai TD che ai TH relativi a questa colonna
+     * @param {boolean} Orderable Indica se la colonna è ordinabile o no (nel senso ASC / DESC / NONE)
+     * @param {boolean} HeaderWraps Indica se il testo dell'header dev'essere wrappato all'interno del th. Di default no.
+     * @param {InputType | string} PropertyType Indica il tipo della proprietà identificata da **propertyName**.
+     * @param {{id: string, description: string}[]} PropertySource Sorgente dati su cui autocompletare/scegliere il valore per la proprietà **propertyName**, ha senso solo per **propType** enum o autocomplete.
+     * @param {string} EditorName Nome dell'editor da utilizzare per la modifica di questo campo
+     * @param {string} RendererName Nome del renderer da utilizzare per visualizzare questo campo
      */
-    constructor(description: string, propertyName: string, routePath?: string, routeParameterProperties?: string[], dataOrder?: 'ASC' | 'DESC', columnOrder?: number, visible?: boolean, clss?: string, orderable?: boolean, headerWraps?: boolean);
+    constructor(Description: string, PropertyName: string, RoutePath?: string, RouteParameterProperties?: string[], DataOrder?: 'ASC' | 'DESC', ColumnOrder?: number, Visible?: boolean, Clss?: string, Orderable?: boolean, HeaderWraps?: boolean, PropertyType?: InputType | string, PropertySource?: {
+        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/EsTableModelChange.d.ts

@@ -0,0 +1,17 @@
+/** Classe che rappresenta la modifica ad un singolo oggetto in una singola proprietà */
+export declare class EsTableModelChange {
+    item: any;
+    header: string;
+    property: string;
+    old_value: string;
+    new_value: string;
+    /**
+     * Costruttore
+     * @param {any} item Oggetto modificato
+     * @param {string} header Nome dell'Header che è stato modificato
+     * @param {string} property Nome della proprietà modificata
+     * @param {string} old_value Vecchio valore della proprietà **property** dell'oggetto **item**
+     * @param {string} new_value Nuovo valore della proprietà **property** dell'oggetto **item**
+     */
+    constructor(item: any, header: string, property: string, old_value: string, new_value: string);
+}

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

@@ -0,0 +1,30 @@
+import { InputType } from "../types";
+/** Classe che rappresenta il riferimento ad una proprietà di un oggetto bindato sulla tabella */
+export declare class ItemPropEditableReference {
+    /** Stato di selezione della cella relativa */
+    selected: boolean;
+    /** Oggetto relativo su cui si modificano le proprietà */
+    item: any;
+    /** ID dell'header in modifica (riferimento al TH relativo) */
+    header: string;
+    /** Proprietà Javascript effettivamente in modifica */
+    property: string;
+    /** Tipo dell'input */
+    type: InputType | string;
+    /** Valore attuale della proprietà **property** dell'oggetto **item** */
+    value: string;
+    /** Indica se la cella deve avere il bordino a sinistra */
+    lborder?: boolean;
+    /** Indica se la cella deve avere il bordino in alto */
+    tborder?: boolean;
+    /** Indica se la cella deve avere il bordino a destra */
+    rborder?: boolean;
+    /** Indica se la cella deve avere il bordino in basso */
+    bborder?: boolean;
+    /** Indica se il bordo a sinistra overlappa su un bordo di selezione destro della cella precedente */
+    loverlaps?: boolean;
+    /** Indica se il bordo a destra overlappa su un bordo di selezione sinistro della cella successiva */
+    roverlaps?: boolean;
+    /** Funzione che imposta il nuovo valore della proprietà **property** dell'oggetto **item** ed aggiorna il **value** di questo oggetto */
+    val_setter?: (value: string) => any;
+}

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

@@ -51,6 +51,8 @@ export declare class AppSearch<T> {
     savedstate: boolean;
     /** Indica se bisogna ancora effettuare la prima ricerca */
     firstsearch: boolean;
+    /** Indica se sto effettuando la ricerca post bind */
+    selfsearch: boolean;
     /**
      * Oggetto che indica la selezione corrente.
      *
@@ -75,7 +77,18 @@ export declare class AppSearch<T> {
      */
     requestedgroups: GroupFilter[];
     /**
-     * Permette di resettare questo oggetto ai valori di default
+     * 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
      */
-    reset(): void;
+    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;
@@ -32,11 +33,15 @@ export interface TdElement {
     Visible?: boolean;
     /** Indica se la cella deve wrappare o no il contenuto */
     Wraps?: boolean;
-    /** Impostazioni per la modifica inline di questo campo: la **Property** di riferimento e il **Type** (a scelta fra quelli supportati dal form-adaptive) */
-    UserEdits?: {
-        Property: string;
-        Type: string;
-    };
+    /** Nome della proprietà JS che questa cella mostra */
+    PropertyName?: string;
+    /** Tipo della proprietà **PropertyName** */
+    PropertyType?: string;
+    /** Sorgente dati per la valorizzazione della proprietà **PropertyName** */
+    PropertySource?: {
+        id: string;
+        description: string;
+    }[];
     /** Indica che l'oggetto di bindare per questo td è l'elemento all'indice Y della proprietà Z dove Y e Z vengono prese dall'**ID** scritto come Z_Y */
     Multi?: true;
     /** Indica l'eventuale proprietà a cui accedere nel caso sia **Content** che **Template** siano vuoti */

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/lib/domain/types.d.ts

@@ -0,0 +1,2 @@
+/** Tipo che rappresenta gli input visualizzabili lato tabella */
+export declare type InputType = 'string' | 'float' | 'date' | 'number' | 'int' | 'boolean' | 'enum' | 'autocomplete' | 'datetime' | 'time' | 'file' | 'currency';

package/lib/es-table.module.d.ts

@@ -6,22 +6,25 @@ import * as i2 from "./components/es-td/es_td.component";
 import * as i3 from "./components/es-table/es_table.component";
 import * as i4 from "./directives/es_td.directive";
 import * as i5 from "./directives/es_th.directive";
-import * as i6 from "./components/pager/table_pager.component";
-import * as i7 from "@angular/common";
-import * as i8 from "@angular/forms";
-import * as i9 from "@angular/router";
-import * as i10 from "@esfaenza/localizations";
-import * as i11 from "ngx-bootstrap/modal";
-import * as i12 from "ngx-bootstrap/dropdown";
-import * as i13 from "@ctrl/ngx-csv";
-import * as i14 from "@esfaenza/ngx-contextmenu";
-import * as i15 from "@angular/material/select";
-import * as i16 from "@angular/material/input";
-import * as i17 from "@angular/cdk/drag-drop";
-import * as i18 from "@esfaenza/forms-and-validations";
+import * as i6 from "./directives/es_td_editor.directive";
+import * as i7 from "./components/pager/table_pager.component";
+import * as i8 from "./components/es-table-template/es_table_template.component";
+import * as i9 from "@angular/common";
+import * as i10 from "@angular/forms";
+import * as i11 from "@angular/router";
+import * as i12 from "@esfaenza/localizations";
+import * as i13 from "ngx-bootstrap/modal";
+import * as i14 from "ngx-bootstrap/dropdown";
+import * as i15 from "@ctrl/ngx-csv";
+import * as i16 from "@esfaenza/ngx-contextmenu";
+import * as i17 from "@angular/material/select";
+import * as i18 from "@angular/material/input";
+import * as i19 from "@angular/material/tooltip";
+import * as i20 from "@angular/cdk/drag-drop";
+import * as i21 from "@esfaenza/forms-and-validations";
 export declare class EsTableModule {
     static forRoot(config?: EsTableModuleConfig): ModuleWithProviders<EsTableModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<EsTableModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<EsTableModule, [typeof i1.EsTh, typeof i2.EsTd, typeof i3.EsTableComponent, typeof i4.EsTdDirective, typeof i5.EsThDirective, typeof i6.TablePagerComponent], [typeof i7.CommonModule, typeof i8.FormsModule, typeof i9.RouterModule, typeof i10.LocalizationModule, typeof i11.ModalModule, typeof i12.BsDropdownModule, typeof i13.CsvModule, typeof i14.ContextMenuModule, typeof i15.MatSelectModule, typeof i16.MatInputModule, typeof i17.DragDropModule, typeof i18.FormsAndValidationsModule], [typeof i3.EsTableComponent, typeof i4.EsTdDirective, typeof i5.EsThDirective, typeof i6.TablePagerComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<EsTableModule, [typeof i1.EsTh, typeof i2.EsTd, typeof i3.EsTableComponent, typeof i4.EsTdDirective, typeof i5.EsThDirective, typeof i6.EsTdEditorDirective, typeof i7.TablePagerComponent, typeof i8.EsTableTemplate], [typeof i9.CommonModule, typeof i10.FormsModule, typeof i11.RouterModule, typeof i12.LocalizationModule, typeof i13.ModalModule, typeof i14.BsDropdownModule, typeof i15.CsvModule, typeof i16.ContextMenuModule, typeof i17.MatSelectModule, typeof i18.MatInputModule, typeof i19.MatTooltipModule, typeof i20.DragDropModule, typeof i21.FormsAndValidationsModule], [typeof i3.EsTableComponent, typeof i4.EsTdDirective, typeof i5.EsThDirective, typeof i6.EsTdEditorDirective, typeof i7.TablePagerComponent, typeof i8.EsTableTemplate]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<EsTableModule>;
 }

package/package.json

@@ -1,21 +1,21 @@
 {
   "name": "@esfaenza/es-table",
-  "version": "13.3.2",
+  "version": "14.2.0",
   "dependencies": {
     "tslib": "^2.0.0"
   },
   "peerDependencies": {
-    "@angular/common": "~13.3.9",
-    "@angular/core": "~13.3.9",
-    "@angular/material": "~13.3.7",
-    "@esfaenza/extensions": "^13.3.3",
-    "@esfaenza/localizations": "^13.3.2",
-    "@esfaenza/forms-and-validations": "^13.3.2",
-    "@ctrl/ngx-csv": "5.0.0",
-    "@esfaenza/ngx-contextmenu": "^13.3.2",
-    "@esfaenza/preferences": "^13.3.2",
-    "ngx-toastr": "14.3.0",
-    "ngx-bootstrap": "8.0.0",
+    "@angular/common": "~11.2.14",
+    "@angular/core": "~11.2.14",
+    "@angular/material": "~11.2.13",
+    "@esfaenza/extensions": "^11.2.28",
+    "@esfaenza/localizations": "^11.2.6",
+    "@esfaenza/forms-and-validations": "^11.2.60",
+    "@ctrl/ngx-csv": "4.0.0",
+    "@esfaenza/ngx-contextmenu": "^11.2.5",
+    "@esfaenza/preferences": "^11.2.18",
+    "ngx-toastr": "13.2.1",
+    "ngx-bootstrap": "7.0.0",
     "exceljs": "4.3.0",
     "stream": "0.0.2"
   },
@@ -24,13 +24,13 @@
   "esm2020": "esm2020/esfaenza-es-table.mjs",
   "fesm2020": "fesm2020/esfaenza-es-table.mjs",
   "fesm2015": "fesm2015/esfaenza-es-table.mjs",
-  "typings": "esfaenza-es-table.d.ts",
+  "typings": "index.d.ts",
   "exports": {
     "./package.json": {
       "default": "./package.json"
     },
     ".": {
-      "types": "./esfaenza-es-table.d.ts",
+      "types": "./index.d.ts",
       "esm2020": "./esm2020/esfaenza-es-table.mjs",
       "es2020": "./fesm2020/esfaenza-es-table.mjs",
       "es2015": "./fesm2015/esfaenza-es-table.mjs",

package/public-api.d.ts

@@ -1,6 +1,8 @@
 export * from './lib/components/pager/table_pager.component';
 export * from './lib/components/es-table/es_table.component';
+export * from './lib/components/es-table-template/es_table_template.component';
 export * from './lib/directives/es_td.directive';
+export * from './lib/directives/es_td_editor.directive';
 export * from './lib/directives/es_th.directive';
 export * from './lib/domain/configuration/EsTableModuleConfig';
 export * from './lib/domain/configuration/EsTableDefaultable';
@@ -20,3 +22,6 @@ export * from './lib/domain/externals/appsearch/EsTableMultiValue';
 export * from './lib/domain/externals/report/ReportColumn';
 export * from './lib/domain/externals/report/ReportParam';
 export * from './lib/domain/externals/report/ReportRow';
+export * from './lib/domain/externals/EsTableModelChange';
+export * from './lib/domain/externals/ItemPropEditableReference';
+export * from './lib/domain/types';