@eqproject/eqp-dynamic-module 2.10.58 → 2.10.62

package/README.md

@@ -1,259 +1,550 @@
-# EqpDynamicModule
-
-Progetto effettivo del modulo dinamico
-
-## Struttura del codice
-Nella cartella **exported** ci sono i componenti pubblici utilizzabili dall'esterno
-
-Nella cartella **private** ci sono i componenti privati del progetto non utilizzabili dall'esterno
-
-## Componenti pubblici
-I componenti pubblici sono due:
-1. eqp-dynamic-module : visualizza la form dinamica;
-2. eqp-dynamic-module-configuration: permette la configurazione delle form dinamiche
-
-
-### eqp-dynamic-module
-Componente che visualizza la form dinamica.
-
-Input
-| Input | obbligatorio/default | descrizione
-| ----- | ----------- | ----------- | ----------- |
-| configurations: dynamicModuleGeneralConfig | obbligatorio | configurazioni generiche per la connessione al DB
-| formID: string | obbligatorio | ID del form da compilare, visualizzare, 
-| starterViewMode: EndPointConfiguration | LIST |
-| userID: string | 0 | Set user id for save |
-| showTitle | boolean | true | Show/Hide module name in COMPILE |
-| userMode | boolean | false | Show/Hide the buttons for "save" and "back" |
-| showSaveButton | true | boolean | Show/Hide form save button when userMode is true |
-| values: Record[] | null |
-| FormJSON: string | "" |
-
-
-#### DynamicModuleConfig Outputs
-| Output  | Event Arguments | Required | Description |
-| ------------- | ------------- | ------------- | ------------- |
-| saveRecord | EventEmitter<Record> | - | Evento emesso quando si salva un record se non è stato specificato un endpoint da chiamare.
-| afterSaveRecord | EventEmitter<Record> | - | Evento emesso DOPO aver eseguito una chiamata al server per il salvataggio di un record all'endpoint specificato.
-| deleteRecord | EventEmitter<Record> | - | Evento emesso quando si elimina un record se non è stato specificato un endpoint da chiamare.
-| afterDeleteRecord | EventEmitter<Record> | - | Evento emesso DOPO aver eseguito una chiamata al server per il l'eliminazione di un record all'endpoint specificato.
-| duplicateRecord | EventEmitter<Record> | - | Evento emesso quando si duplica un record se non è stato specificato un endpoint da chiamare.
-| afterDuplicateRecord | EventEmitter<Record> | - | Evento emesso DOPO aver eseguito una chiamata al server per la duplicazione di un record all'endpoint specificato.
-| SaveJSON | EventEmitter<string> | - | Evento emesso quando si 
-
-### eqp-dynamic-module-configurator
-Componente che permette la configurazione delle form dinamiche
-
-4 modalità d'uso:
-## Nuovo Modulo: 
-```js
-    let specific: DynamicModuleConfiguratorSpecificConfig = new DynamicModuleConfiguratorSpecificConfig();
-    specific.UserID = this.currentUser.ID
-    specific.orgaID = this.currentOrga.ID;
-    let general: DynamicModuleGeneralConfig = new DynamicModuleGeneralConfig(this.baseServerUrl, "", this.context, null)
-
-    this.config = new DynamicModuleConfiguratorConfig(general, specific)
-    this.loader=true;
-```
-```html
-    <eqp-dynamic-module-configurator 
-        *ngIf="loader"
-        [configurations] = "config"
-        (saveFormEvent)="onSaveForm($event)">
-    </eqp-dynamic-module-configurator>
-```
-
-## Modifica di un modulo esistente:
-```js
-    let specific: DynamicModuleConfiguratorSpecificConfig = new DynamicModuleConfiguratorSpecificConfig();
-    specific.UserID = this.currentOrga.ID
-    specific.orgaID = "2";
-    let general: DynamicModuleGeneralConfig = new DynamicModuleGeneralConfig(this.baseServerUrl, "", this.context, null)
-
-    this.config = new DynamicModuleConfiguratorConfig(general, specific)
-    this.formID = "xxxxxx-xxxxxx-xxxxxx";
-    this.loader=true;
-```
-```html
-    <eqp-dynamic-module-configurator
-      *ngIf="loader"
-      [configurations] = "config"
-      [formID]="formID"
-      (saveFormEvent)="onSaveForm($event)">
-    </eqp-dynamic-module-configurator>
-```
-## Esportazione di un modulo dato l'ID:
-```js
-    let specific: DynamicModuleConfiguratorSpecificConfig = new DynamicModuleConfiguratorSpecificConfig();
-    specific.UserID = this.currentOrga.ID
-    specific.orgaID = "2";
-    let general: DynamicModuleGeneralConfig = new DynamicModuleGeneralConfig(this.baseServerUrl, "", this.context, null)
-
-    this.config = new DynamicModuleConfiguratorConfig(general, specific)
-    this.formID = "xxxxxx-xxxxxx-xxxxxx";
-    this.loader=true;
-```
-```html
-    <eqp-dynamic-module-configurator
-      *ngIf="loader"
-      [configurations] = "config"
-      [formID]="formID"
-      [viewMode] = "'Export'"
-      (saveFormEvent)="onSaveForm($event)">
-    </eqp-dynamic-module-configurator>
-```
-## importazione di un modulo dato il JSON:
-```js
-    let specific: DynamicModuleConfiguratorSpecificConfig = new DynamicModuleConfiguratorSpecificConfig();
-    specific.UserID = this.currentOrga.ID
-    specific.orgaID = "2";
-    specific.form = JSON.parse(this.stringForm)
-    let general: DynamicModuleGeneralConfig = new DynamicModuleGeneralConfig(this.baseServerUrl, "", this.context, null)
-
-    this.config = new DynamicModuleConfiguratorConfig(general, specific)
-    this.formID = null;
-    this.loader=true;
-```
-```html
-    <eqp-dynamic-module-configurator
-      *ngIf="loader"
-      [configurations] = "config"
-      [formID]="formID"
-      [viewMode] = "'Export'"
-      (saveFormEvent)="onSaveForm($event)">
-    </eqp-dynamic-module-configurator>
-```
-
-
-| Input | Descrizione |
-| ----- | ----------- |
-| configurations: DynamicModuleConfiguratorConfig | an object that is a configurations container. It holds 2 objects: dynamicModuleGeneralConfig, DynamicModuleConfiguratorSpecificConfig |
-| formID: string | obbligatorio | ID del form da compilare, visualizzare, 
-
-#### DynamicModuleConfiguratorConfig Outputs
-| Output  | Event Arguments | Required | Description |
-| ------------- | ------------- | ------------- | ------------- |
-| (saveFormEvent) | `EventEmitter<Form>` | - | Evento emesso quando si salva una form e non è stato specificato un endpoint da chiamare. |
-| (afterSaveFormEvent) | `EventEmitter<Form>` | - | Evento emesso DOPO aver eseguito una chiamata al server per il salvataggiodi una form all'endpoint specificato. |
-
-## Models used
-
-### DynamicModuleConfiguratorConfig
-| Property | Type | Description | Examples | 
-| ------------- | ------------- | ------------- | ------------- |
-| dynamicModuleGeneralConfig | dynamicModuleGeneralConfig | contiene le informazioni generali comuni per la visualizzazione |
-| DynamicModuleConfiguratorSpecificConfig | dynamicModuleGeneralConfig | contiene le informazioni generali comuni per la visualizzazione |
-
-
-### DynamicModuleConfig
-| Property | Type | Description | Examples | 
-| ------------- | ------------- | ------------- | ------------- |
-| dynamicModuleGeneralConfig | dynamicModuleGeneralConfig | contiene le informazioni generali comuni per la visualizzazione |
-| dynamicModuleCompileConfig | dynamicModuleCompileConfig | contiene le informazioni specifiche per la visualizzazione della risposta |
-| dynamicModuleListConfig | dynamicModuleListConfig | contiene le informazioni specifiche per la visualizzazione della lista di risposte |
-| dynamicModuleRepairConfig | dynamicModuleRepairConfig | contiene le configurazioni specifiche per la modalità repair |
-
-
-### DynamicModuleConfiguratorSpecificConfig | contiene le informazioni generali comuni per la visualizzazione
-| Property | Type | Description | Examples | 
-| ------------- | ------------- | ------------- | ------------- |
-| form | Form | 
-| orgaID | string | 
-| UserID | number | 
-| innerFormManagment | boolean | 
-| innerFormRef | MatDialogRef<TemplateRef<any>> |
-
-### dynamicModuleGeneralConfig | contiene le informazioni generali comuni per la visualizzazione
-| Property | Type | Description | Examples | 
-| ------------- | ------------- | ------------- | ------------- |
-| baseServerUrl | string | server Url to call for API | "http://localhost:5015/api"
-| userToken | string | Token dell'utente |
-| endPointConfiguration | EndPointConfiguration | Configurazione degli endpoint da chiamare per recuperare o salvare i dati. Può essere definita dall'utente oppure lasciata null, viene popolata con dei valori di default se viene valorizzata la proprietà "baseServerUrl" altrimenti viene lasciata null e non viene eseguita nessuna chiamata al server. |
-| context | Context | Contesto |
-
-
-Note:
-- se non viene fornita una configurazione degli EndPoint si utilizza la configurazione standard
-
-### dynamicModuleCompileConfig | contiene le informazioni specifiche per la visualizzazione della risposta
-| Property | Type | Description | Examples |
-| ------------- | ------------- | ------------- | ------------- |
-| showTitle | boolean | Show/Hide module name in COMPILE |
-| userMode | boolean | Show/Hide the buttons for "save" and "back" |
-| showSaveButton | boolean | Show/Hide form save button when userMode is true |
-| userID | string | Set user id for save |
-
-### dynamicModuleListConfig    | contiene le informazioni specifiche per la visualizzazione della lista di risposte
-| Property | Type | Description | Examples |
-| ------------- | ------------- | ------------- | ------------- |
-| showTitle | boolean | Show/Hide module name in LIST |
-| defaultListActions | dynamicModuleListFormRecordActionsDefault | Lista delle azioni di default da mostrare per visualizzare/modificare/duplicare/eliminare in LIST MODE |
-| values | Array<Record> |Lista dei record da mostrare in LIST MODE |
-
-### dynamicModuleRepairConfig  | contiene le configurazioni specifiche per la modalità repair
-| Property | Type | Description | Examples |
-| ------------- | ------------- | ------------- | ------------- |
-| FormJSON | string | stringa rappresentante il json del form da revisionare in REPAIR MODE |
-
-
-
-
-### EndPointConfiguration
-
-example
-```js
-export class EndPointConfiguration {
-    Records: {
-        GetByFormIDEndPoint?: EndPointData;
-        GetAllByEntAndUserIDEndPoint?: EndPointData;
-        GetByIDEndPoint?: EndPointData;
-        SaveEndPoint?: EndPointData;
-        DuplicateEndPoint?: EndPointData;
-        DeleteEndPoint?: EndPointData;
-        RepairEndPoint?: EndPointData;
-    };
-    Forms: {
-        GetByIDEndPoint: EndPointData;
-        GetByIDAndVersionEndPoint: EndPointData;
-        SaveEndPoint: EndPointData;
-    }
-}
-```
-
-### EndPointData
-export class EndPointData {
-    Url: string;
-    Token?: string;
-    RequestMethod: RequestMethodEnum;
-    Params?: EndPointDataParams[];
-}
-
-### EndPointDataParams
-export class EndPointDataParams {
-    ParamName: string;
-    ParamValue: any = null;
-    ParamType: ParamTypeEnum;
-}
-
-### ParamTypeEnum
-```js
-export enum ParamTypeEnum {
-    "Query param" = 1,
-    "In route" = 2,
-    "In Body" = 3
-}
-```
-
-### RequestMethodEnum
-
-```js
-export enum RequestMethodEnum {
-    GET = 'GET',
-    POST = 'POST',
-    PUT = 'PUT',
-    DELETE = 'DELETE'
-}
-```
-
-### Componenti privati
-
+# @eqproject/eqp-dynamic-module
+
+> Angular 15 library for building, rendering and managing dynamic forms with a no-code configurator.
+
+[![npm version](https://img.shields.io/npm/v/@eqproject/eqp-dynamic-module.svg)](https://www.npmjs.com/package/@eqproject/eqp-dynamic-module)
+[![Angular](https://img.shields.io/badge/Angular-15-red.svg)](https://angular.io/)
+
+---
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Prerequisites](#prerequisites)
+- [Installation](#installation)
+- [Module Setup](#module-setup)
+- [Components](#components)
+  - [eqp-dynamic-module — Form Viewer/Filler](#eqp-dynamic-module--form-viewerfiller)
+  - [eqp-dynamic-module-configurator — Form Builder](#eqp-dynamic-module-configurator--form-builder)
+- [Configuration Models](#configuration-models)
+- [View Modes](#view-modes)
+- [Endpoint Configuration](#endpoint-configuration)
+- [Data Models](#data-models)
+- [Field Types Reference](#field-types-reference)
+
+---
+
+## Overview
+
+`@eqproject/eqp-dynamic-module` exposes **two public components**:
+
+| Component | Purpose |
+|-----------|---------|
+| `<eqp-dynamic-module>` | Runtime form viewer, filler, list, filter and graphs |
+| `<eqp-dynamic-module-configurator>` | No-code form builder (create, edit, import, export) |
+
+Forms are defined as JSON structures stored server-side and fetched at runtime. The library handles rendering, validation, data retrieval, CRUD operations and advanced features like formulas, triggers, action buttons and speech-to-text.
+
+---
+
+## Prerequisites
+
+Install the following peer dependencies in your project (if not already present):
+
+```bash
+npm install @angular/cdk@^15.1.2 @angular/material@^15.1.2 @angular/material-luxon-adapter@^15.2.9 --legacy-peer-deps
+npm install @angular-material-components/datetime-picker@^15.0.0 @angular-material-components/moment-adapter@^15.0.0 --legacy-peer-deps
+npm install moment@^2.29.4 sweetalert2@^11.4.24 --legacy-peer-deps
+```
+
+> **Note:** All `npm install` commands for this library require `--legacy-peer-deps`.
+
+---
+
+## Installation
+
+```bash
+npm install @eqproject/eqp-dynamic-module --legacy-peer-deps
+```
+
+---
+
+## Module Setup
+
+Import `EqpDynamicModuleModule` in your `AppModule` (or the feature module where you need it):
+
+```typescript
+import { EqpDynamicModuleModule } from '@eqproject/eqp-dynamic-module';
+
+@NgModule({
+  imports: [
+    // ...
+    EqpDynamicModuleModule
+  ]
+})
+export class AppModule {}
+```
+
+Add Angular Material theme and icons to your `angular.json` styles:
+
+```json
+"styles": [
+  "node_modules/@angular/material/prebuilt-themes/indigo-pink.css",
+  "src/styles.css"
+]
+```
+
+---
+
+## Components
+
+### `eqp-dynamic-module` — Form Viewer/Filler
+
+Renders a dynamic form in one of several [view modes](#view-modes). Handles loading form definitions, displaying fields, collecting responses and communicating with the server.
+
+#### Basic usage
+
+```typescript
+import {
+  DynamicModuleGeneralConfig,
+  DynamicModuleViewModeEnum
+} from '@eqproject/eqp-dynamic-module';
+
+// component.ts
+generalConfig = new DynamicModuleGeneralConfig(
+  'https://your-api.example.com/api',
+  this.userToken,
+  this.context,
+  null   // endPointConfiguration — null uses defaults built from baseServerUrl
+);
+```
+
+```html
+<eqp-dynamic-module
+  [configurations]="generalConfig"
+  [formID]="'your-form-id'"
+  [starterViewMode]="DynamicModuleViewModeEnum.LIST"
+  [userID]="currentUser.id"
+  (saveRecord)="onSave($event)"
+  (afterSaveRecord)="onAfterSave($event)">
+</eqp-dynamic-module>
+```
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `configurations` | `DynamicModuleGeneralConfig` | — | **Required.** Server connection and endpoint configuration. |
+| `formID` | `string` | — | **Required.** ID of the form to display. |
+| `starterViewMode` | `DynamicModuleViewModeEnum` | `LIST` | Initial [view mode](#view-modes). |
+| `userID` | `string` | `"0"` | User ID stamped on saved records. |
+| `orgaID` | `string` | `"0"` | Organization ID for data scoping. |
+| `showTitle` | `boolean` | `true` | Show/hide the form name in COMPILE and LIST modes. |
+| `showBackButton` | `boolean` | `true` | Show/hide the back/cancel button. |
+| `showSaveButton` | `boolean` | `true` | Show/hide the save button. |
+| `values` | `Record[]` | `null` | Pre-load a set of records for LIST mode (bypasses server fetch). |
+| `FormJSON` | `string` | `""` | JSON string of a form definition for REPAIR mode. |
+| `formulaObject` | `any` | `{}` | Context object injected into formula evaluation (e.g. `{ role, user, patient }`). |
+| `selectedRecord` | `Record \| string` | `null` | Pre-select a record by object or ID when opening in COMPILE/VIEW mode. |
+| `externalButtons` | `RecordButton[]` | `[]` | Extra buttons rendered in the record action menu. |
+| `actionButtons` | `ActionButton[]` | `[]` | Action buttons bound to form fields of type `Bottone`. |
+| `defaultListActions` | `DynamicModuleListFormRecordActionsDefault` | all `true` | Toggle default list actions: add, view, edit, duplicate, delete, graphs. |
+| `listViewRecordTitle` | `string[]` | `[]` | Field keys whose values compose the accordion title in list view. |
+| `defaultListViewFunction` | `Function` | `null` | Override the default function called when the list view loads. |
+| `onSaveBackToList` | `boolean` | `false` | Automatically navigate back to LIST after a successful save. |
+| `onBackTo` | `DynamicModuleViewModeEnum` | `null` | View mode to navigate to when the back button is pressed. |
+| `numberOfColumns` | `number` | `3` | Number of layout columns for form fields. |
+| `showHiddenFields` | `boolean` | `true` | Show/hide fields marked as hidden. |
+| `filterResultViewMode` | `DynamicModuleFilterResultViewModeEnum` | `INTERNAL_EQPTABLE` | How filter results are displayed. |
+| `additionalParams` | `any` | `null` | Extra parameters forwarded to server-side filter calls. |
+| `additionalInfo` | `any` | `null` | Extra data forwarded to client-side operations. |
+| `prefilterParams` | `any` | `null` | Parameters applied before the user-driven filter. |
+| `updateInfo` | `any` | `null` | Data used to update response values after load. |
+| `contestualizationParams` | `any` | `null` | Contextualisation parameters for the result list. |
+| `showNewSearchButton` | `boolean` | `true` | Show/hide the "new search" button in FILTER mode. |
+| `highlightFilter` | `any` | — | Configuration for row/field highlighting in the result list. |
+| `isDraggableListView` | `boolean` | `true` | Enable drag-and-drop reordering in list view. |
+| `Statistic` | `FilterStatistic` | `null` | Statistics and filter configuration object. |
+| `QueryEditorComponent` | `any` | — | Custom query-editor component injected into lookup fields. |
+| `debugMode` | `boolean` | `false` | Log verbose debug information to the console. |
+
+#### Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `(saveRecord)` | `Record` | Emitted when a record is saved and **no** save endpoint is configured. Handle persistence yourself. |
+| `(afterSaveRecord)` | `Record` | Emitted after the library completes a server save call. |
+| `(deleteRecord)` | `Record` | Emitted when a record is deleted and **no** delete endpoint is configured. |
+| `(afterDeleteRecord)` | `Record` | Emitted after the library completes a server delete call. |
+| `(SaveJSON)` | `string` | Emitted when the form JSON is exported/saved. |
+| `(afterFilter)` | `DynRecord[]` | Emitted after a filter operation completes with the result set. |
+| `(dragStarted)` | `Record` | Emitted when the user starts dragging a record. |
+| `(dragReleased)` | `void` | Emitted when the drag operation ends. |
+| `(clickDragIndicator)` | `Record` | Emitted when the drag handle icon is clicked. |
+| `(out)` | `eventOut` | General-purpose output for external component communication. |
+| `(fireTrigger)` | `FireTrigger` | Emitted when a form trigger fires; handle custom side-effects here. |
+| `(afterOutputExternalFilters)` | `FilterStatistic` | Emitted after external filter outputs are applied. |
+
+---
+
+### `eqp-dynamic-module-configurator` — Form Builder
+
+No-code designer for creating and editing form definitions. Supports four usage modes controlled by `viewMode` and the `formID` / `specific.form` inputs.
+
+#### Usage modes
+
+##### 1. Create a new form
+
+```typescript
+const specific = new DynamicModuleConfiguratorSpecificConfig();
+specific.UserID = this.currentUser.id;
+specific.orgaID = this.currentOrga.id;
+
+const general = new DynamicModuleGeneralConfig(this.baseServerUrl, this.userToken, this.context, null);
+
+this.configuratorConfig = new DynamicModuleConfiguratorConfig(general, specific);
+```
+
+```html
+<eqp-dynamic-module-configurator
+  *ngIf="configuratorConfig"
+  [configurations]="configuratorConfig"
+  (saveFormEvent)="onFormSaved($event)"
+  (afterSaveFormEvent)="onFormAfterSaved($event)">
+</eqp-dynamic-module-configurator>
+```
+
+##### 2. Edit an existing form
+
+```typescript
+this.formID = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'; // existing form ID
+// same config setup as above
+```
+
+```html
+<eqp-dynamic-module-configurator
+  *ngIf="configuratorConfig"
+  [configurations]="configuratorConfig"
+  [formID]="formID"
+  (saveFormEvent)="onFormSaved($event)">
+</eqp-dynamic-module-configurator>
+```
+
+##### 3. Export a form by ID
+
+```html
+<eqp-dynamic-module-configurator
+  *ngIf="configuratorConfig"
+  [configurations]="configuratorConfig"
+  [formID]="formID"
+  [viewMode]="'Export'"
+  (saveFormEvent)="onFormSaved($event)">
+</eqp-dynamic-module-configurator>
+```
+
+##### 4. Import a form from JSON
+
+```typescript
+specific.form = JSON.parse(this.formJsonString);
+this.formID = null;
+```
+
+```html
+<eqp-dynamic-module-configurator
+  *ngIf="configuratorConfig"
+  [configurations]="configuratorConfig"
+  [formID]="formID"
+  [viewMode]="'Export'"
+  (saveFormEvent)="onFormSaved($event)">
+</eqp-dynamic-module-configurator>
+```
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `configurations` | `DynamicModuleConfiguratorConfig` | — | **Required.** Configuration container. |
+| `formID` | `string` | `null` | ID of the form to edit. `null` creates a new form. |
+| `viewMode` | `string` | `"addOrEdit"` | `"addOrEdit"` for create/edit, `"Export"` for export/import. |
+| `fieldsExtraConfig` | `FieldExtraConfig[]` | — | Extra configuration applied to specific fields. |
+| `triggers` | `any` | — | Trigger definitions available in the trigger editor. |
+| `actionButtons` | `any` | — | Action button definitions available in the button editor. |
+| `contestualization` | `Contestualization[]` | — | Contextualisation options for lookup and filter fields. |
+| `formulaObject` | `any` | — | Context object for formula preview and evaluation. |
+| `QueryEditorComponent` | `DynamicLoaderDirectiveData` | — | Custom query editor component for lookup fields. |
+| `debugMode` | `boolean` | `false` | Enable verbose console logging. |
+
+#### Outputs
+
+| Output | Payload | Description |
+|--------|---------|-------------|
+| `(saveFormEvent)` | `Form` | Emitted when a form is saved and **no** save endpoint is configured. |
+| `(afterSaveFormEvent)` | `Form` | Emitted after the library completes a server save call. |
+| `(out)` | `eventOut` | General-purpose external communication output. |
+| `(fireTrigger)` | `FireTrigger` | Emitted when a trigger fires during configurator interaction. |
+
+---
+
+## Configuration Models
+
+### `DynamicModuleGeneralConfig`
+
+Shared by both components. Describes the server connection.
+
+```typescript
+const general = new DynamicModuleGeneralConfig(
+  baseServerUrl,        // string — e.g. "https://api.example.com/api"
+  userToken,            // string — bearer token / auth token
+  context,              // Context — application context object
+  endPointConfiguration // EndPointConfiguration | null — null = use defaults
+);
+```
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `baseServerUrl` | `string` | Base API URL. Used to auto-build default endpoint URLs when `endPointConfiguration` is `null`. |
+| `userToken` | `string` | Authentication token sent with API calls. |
+| `endPointConfiguration` | `EndPointConfiguration \| null` | Full endpoint override. Leave `null` to use the standard route convention. |
+| `context` | `Context` | Application context forwarded to every server call. |
+
+---
+
+### `DynamicModuleConfig`
+
+Container for the viewer component configuration.
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `dynamicModuleGeneralConfig` | `DynamicModuleGeneralConfig` | Server connection settings. |
+| `dynamicModuleCompileConfig` | `DynamicModuleCompileConfig` | COMPILE mode settings. |
+| `dynamicModuleListConfig` | `DynamicModuleListConfig` | LIST mode settings. |
+| `dynamicModuleRepairConfig` | `DynamicModuleRepairConfig` | REPAIR mode settings. |
+
+#### `DynamicModuleCompileConfig`
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `showTitle` | `boolean` | `true` | Show/hide the form name. |
+| `showSaveButton` | `boolean` | `true` | Show/hide the save button. |
+| `showBackButton` | `boolean` | `true` | Show/hide the back button. |
+| `userID` | `string` | `"0"` | User ID stamped on saved records. |
+| `additionalParams` | `any` | `null` | Extra server-side filter parameters. |
+| `additionalInfo` | `any` | `null` | Extra client-side operation data. |
+| `prefilterParams` | `any` | `null` | Pre-filter parameters. |
+| `showNewSearchButton` | `boolean` | `true` | Show/hide the new search button. |
+
+#### `DynamicModuleListConfig`
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `showTitle` | `boolean` | Show/hide the form name in LIST mode. |
+| `defaultListActions` | `DynamicModuleListFormRecordActionsDefault` | Toggle default record actions (add, view, edit, duplicate, delete, graphs). |
+| `values` | `Record[]` | Pre-loaded records (skips server fetch). |
+| `externalButtons` | `RecordButton[]` | Extra buttons in the record action menu. |
+| `updateInfo` | `any` | Data used to update response values after load. |
+| `listViewRecordTitle` | `string[]` | Field keys composing the accordion record title. |
+| `userID` | `string` | User ID for server-side filtering. |
+| `isDraggableListView` | `boolean` | Enable drag-and-drop reordering. |
+
+#### `DynamicModuleRepairConfig`
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `FormJSON` | `string` | JSON string of the form to review/repair. |
+
+---
+
+### `DynamicModuleConfiguratorConfig`
+
+Container for the configurator component configuration.
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `dynamicModuleGeneralConfig` | `DynamicModuleGeneralConfig` | Server connection settings. |
+| `dynamicModuleConfiguratorSpecificConfig` | `DynamicModuleConfiguratorSpecificConfig` | Configurator-specific settings. |
+
+#### `DynamicModuleConfiguratorSpecificConfig`
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `orgaID` | `string` | Organization ID associated with the form. |
+| `UserID` | `number` | User ID for creation/modification tracking. |
+| `form` | `Form` | Pre-populate with a `Form` object for import mode. |
+| `innerFormManagment` | `boolean` | `true` when the configurator is opened inside a dialog. |
+| `innerFormRef` | `MatDialogRef<TemplateRef<any>>` | Dialog reference when opened in a dialog context. |
+
+---
+
+### `DynamicModuleListFormRecordActionsDefault`
+
+Controls which default actions appear in the record action menu in LIST mode.
+
+```typescript
+const actions = new DynamicModuleListFormRecordActionsDefault();
+actions.add       = true;   // "Add new record" button in list header
+actions.view      = true;   // View record (read-only)
+actions.edit      = true;   // Edit record
+actions.duplicate = false;  // Duplicate record
+actions.delete    = true;   // Delete record
+actions.graphs    = false;  // Show graphs for record
+```
+
+---
+
+## View Modes
+
+```typescript
+import { DynamicModuleViewModeEnum } from '@eqproject/eqp-dynamic-module';
+
+enum DynamicModuleViewModeEnum {
+  NONE            = 0,  // No view rendered
+  VIEW            = 1,  // Read-only display of a single record
+  COMPILE         = 2,  // Fill / edit a single record
+  LIST            = 3,  // List of records with add/view/edit/delete actions
+  REPAIR          = 4,  // Review and repair a form definition
+  LISTWIEW        = 5,  // Alternative compact list view
+  FILTER          = 6,  // Filter / search mode
+  GRAPHS          = 7,  // Statistics and charts
+  HLIST           = 8,  // Horizontal scrollable list
+  EXTERNAL_FILTER = 9   // Filter driven by an external parent component
+}
+```
+
+---
+
+## Endpoint Configuration
+
+By default the library builds all endpoint URLs from `baseServerUrl` using a standard convention. Pass a custom `EndPointConfiguration` to override individual routes.
+
+```typescript
+import {
+  EndPointConfiguration,
+  EndPointData,
+  EndPointDataParams,
+  RequestMethodEnum,
+  ParamTypeEnum
+} from '@eqproject/eqp-dynamic-module';
+
+const endPoints = new EndPointConfiguration();
+
+// Override the "save record" endpoint
+endPoints.Records.SaveEndPoint = new EndPointData();
+endPoints.Records.SaveEndPoint.Url = 'https://custom-api.example.com/records/save';
+endPoints.Records.SaveEndPoint.RequestMethod = RequestMethodEnum.POST;
+endPoints.Records.SaveEndPoint.Params = [
+  {
+    ParamName: 'orgId',
+    ParamValue: this.orgaId,
+    ParamType: ParamTypeEnum['Query param']
+  }
+];
+
+const general = new DynamicModuleGeneralConfig(baseUrl, token, context, endPoints);
+```
+
+### Available endpoints
+
+#### `EndPointConfiguration.Records`
+
+| Key | Default route | Description |
+|-----|--------------|-------------|
+| `GetWithContextualizationByFormCodeEndPoint` | `GET /records/getbyformcode` | Fetch records with contextualisation by form code. |
+| `GetByFormIDEndPoint` | `GET /records/getbyformid` | Fetch records by form ID. |
+| `GetByFormCodeEndPoint` | `GET /records/getbyformcode` | Fetch records by form code. |
+| `GetAllByEntAndUserIDEndPoint` | `GET /records/getallbyentanduserid` | Fetch all records for an entity + user. |
+| `GetByIDEndPoint` | `GET /records/getbyid` | Fetch a single record by its ID. |
+| `SaveEndPoint` | `POST /records/save` | Create or update a record. |
+| `DuplicateEndPoint` | `POST /records/duplicate` | Duplicate an existing record. |
+| `DeleteEndPoint` | `DELETE /records/delete` | Delete a record. |
+| `RepairEndPoint` | `POST /records/repair` | Repair/review a form record. |
+| `ApplyFilter` | `POST /records/filter` | Apply server-side filter. |
+| `GetAllAttachmentsEndPoint` | `GET /records/attachments` | Fetch all attachments for a record. |
+
+#### `EndPointConfiguration.Forms`
+
+| Key | Default route | Description |
+|-----|--------------|-------------|
+| `GetByIDEndPoint` | `GET /forms/getbyid` | Fetch a form definition by ID. |
+| `GetAllFormEndPoint` | `GET /forms/getall` | Fetch all form definitions. |
+| `GetByIDAndVersionEndPoint` | `GET /forms/getbyidandversion` | Fetch a specific form version. |
+| `SaveEndPoint` | `POST /forms/save` | Save a form definition. |
+| `SaveAttachmentEndPoint` | `POST /forms/saveattachment` | Save a form attachment. |
+| `ExportByIDEndPoint` | `GET /forms/exportbyid` | Export a form definition by ID. |
+| `GetAttachmentWithBases64` | `GET /forms/attachment` | Fetch attachment with Base64 encoding. |
+| `SpeechToFormEditEndPoint` | `POST /forms/speechtoedit` | Apply speech-to-text edits to a form. |
+
+### `EndPointData`
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `Url` | `string` | Full endpoint URL. |
+| `Token` | `string` | Per-endpoint auth token (overrides the general `userToken`). |
+| `RequestMethod` | `RequestMethodEnum` | `GET`, `POST`, `PUT` or `DELETE`. |
+| `Params` | `EndPointDataParams[]` | Parameters to include with the request. |
+
+### `EndPointDataParams`
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `ParamName` | `string` | Parameter name. |
+| `ParamValue` | `any` | Parameter value. |
+| `ParamType` | `ParamTypeEnum` | `1` = query string, `2` = route segment, `3` = request body. |
+
+---
+
+## Data Models
+
+### `Record`
+
+Represents a filled form response.
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `ID` | `string` | Unique record identifier. |
+| `EntID` | `string` | ID of the form (entity) this record belongs to. |
+| `Version` | `number` | Form version at the time of compilation. |
+| `userID` | `string` | ID of the user who created the record. |
+| `AnswerDate` | `string` | ISO date string of when the record was filled. |
+| `HTMLreadableValues` | `string` | Pre-rendered HTML representation of field values. |
+| `AdditionalParams` | `any` | Extra parameters stored with the record. |
+| `AdditionalInfo` | `any` | Extra information stored with the record. |
+
+### `Form`
+
+Describes a form definition returned by `(saveFormEvent)`.
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `ID` | `string` | Unique form identifier (GUID). |
+| `Code` | `string` | Short form code (uppercase, no special characters). |
+| `Name` | `string` | Display name. |
+| `Description` | `string` | Optional description. |
+| `Version` | `number` | Form version number. |
+| `OrgaID` | `string` | Owning organisation ID. |
+| `FormScalarType` | `FormScalarTypeEnum` | Layout: `Semplice` (1), `A step` (2), `In tab` (3), `In accordion` (4). |
+| `Fields` | `BaseField[]` | Ordered array of form fields. |
+| `Triggers` | `Trigger[]` | Automation triggers. |
+| `ActionButtons` | `ActionButton[]` | Action buttons. |
+| `InnerForms` | `Form[]` | Nested detail forms. |
+
+---
+
+## Field Types Reference
+
+The `FieldTypeEnum` describes every field type available in the form builder.
+
+| Value | Key | Description |
+|-------|-----|-------------|
+| `1` | `Campo di testo` | Single-line text input. |
+| `2` | `Area di testo` | Multi-line textarea. |
+| `3` | `Booleano` | Checkbox / boolean toggle. |
+| `4` | `Data e/ora` | Date and/or time picker. |
+| `5` | `Campo numerico` | Numeric input with mask. |
+| `6` | `Allegato` | File attachment upload. |
+| `7` | `Immagine` | Image upload with optional cropping. |
+| `8` | `Elenco generico` | Dropdown / multi-select list. |
+| `9` | `Lookup` | Server-side lookup with configurable query. |
+| `10` | `Form di dettaglio` | Embedded detail (inner) form. |
+| `11` | `Elenco immagini` | Image selector list. |
+| `12` | `Etichetta` | Display-only label. |
+| `13` | `Immagine con markers` | Image with interactive annotation markers. |
+| `14` | `Bottone` | Action button field. |
+
+### Field value sources (`DataGetterTypeEnum`)
+
+| Value | Description |
+|-------|-------------|
+| `Manuale` (1) | User enters the value manually. |
+| `Formula` (2) | Value is computed from a formula expression. |
+| `Da database` (3) | Value is fetched from a database query. |
+| `Da modulo dinamico` (4) | Value is pulled from another dynamic form record. |