@eqproject/eqp-dynamic-module 2.11.5 → 2.11.7

package/lib/components/private/field-graphics-editor/field-graphics-editor.component.d.ts

@@ -2,7 +2,7 @@ import { EventEmitter, OnInit } from '@angular/core';
 import { UntypedFormBuilder } from '@angular/forms';
 import { BaseField, FieldTypeEnum } from '../../../models/baseField.model';
 import { EndPointConfiguration } from '../../../models/endPointConfiguration.model';
-import { CssPropertyDef } from '../../../utils/css-property-catalog';
+import { CssElementProfile, CssPropertyDef } from '../../../utils/css-property-catalog';
 import { FieldStyleEntryDef, FieldStyleTypeDef, getFieldDisplayName, GlobalStyleElementDef } from '../../../utils/field-style-catalog';
 import * as i0 from "@angular/core";
 /** Un gruppo raccoglie tutti i campi selezionati che condividono la stessa tipologia */
@@ -149,6 +149,7 @@ export declare class FieldGraphicsEditorComponent implements OnInit {
     get currentElements(): Array<{
         key: string;
         label: string;
+        profile?: CssElementProfile;
     }>;
     get currentStates(): Array<FieldStyleEntryDef>;
     get currentSelectedState(): string;
@@ -157,9 +158,21 @@ export declare class FieldGraphicsEditorComponent implements OnInit {
     toggleCurrentElement(elementKey: string): void;
     get currentShowAllProperties(): boolean;
     toggleCurrentShowAll(): void;
+    /** False per gli elementi con un elenco di proprietà chiuso (niente "Altre proprietà...") */
+    rowHasMoreProperties(elementKey: string): boolean;
     rowProperties(elementKey: string): Array<CssPropertyDef>;
     rowCount(elementKey: string): number;
+    /** Valore impostato direttamente sull'elemento, senza eredità */
+    private rowGetOwn;
+    /**
+     * Valore mostrato a video. "Etichetta sul bordo" parte dalla grafica di "Etichetta nel
+     * contenitore" e sovrascrive solo ciò che vi è impostato: dove non ha un valore proprio
+     * mostra quello ereditato, così lo specchietto riflette ciò che si vede in anteprima.
+     */
     rowGet(elementKey: string, prop: string): string;
+    /** Elemento da cui "…Sollevata" eredita (la chiave base), null per gli altri */
+    private inheritanceSourceKey;
+    rowIsInherited(elementKey: string, prop: string): boolean;
     rowSet(elementKey: string, prop: string, value: string): void;
     rowIsSet(elementKey: string, prop: string): boolean;
     rowReset(elementKey: string, prop: string): void;
@@ -183,6 +196,11 @@ export declare class FieldGraphicsEditorComponent implements OnInit {
     }): string;
     /** Crea il campo fittizio dell'anteprima agganciandogli la mappa stili passata */
     private buildPreviewField;
+    /**
+     * Stato della label che l'anteprima deve mostrare per l'elemento aperto: la label Material
+     * si solleva sul bordo solo se il campo ha un valore, quindi l'anteprima lo simula.
+     */
+    private previewLabelMode;
     private getPreviewInitialValue;
     /** Completa il campo di anteprima con i valori minimi richiesti dai singoli template */
     private prepareTypeSpecificPreview;

package/lib/components/private/field-templates/image-field-selector-template/image-field-selector-template.component.d.ts

@@ -1,14 +1,16 @@
-import { EventEmitter, OnChanges, OnDestroy, OnInit, Renderer2, SimpleChanges } from '@angular/core';
+import { AfterViewInit, EventEmitter, OnChanges, OnDestroy, OnInit, Renderer2, SimpleChanges } from '@angular/core';
+import { MatFormField } from '@angular/material/form-field';
 import { Record } from '../../../../models/record.model';
 import { ImageSelectorField } from '../../../../models/fields/imageSelectorField.model';
 import * as i0 from "@angular/core";
-export declare class ImageFieldSelectorTemplateComponent implements OnInit, OnChanges, OnDestroy {
+export declare class ImageFieldSelectorTemplateComponent implements AfterViewInit, OnInit, OnChanges, OnDestroy {
     private renderer;
     record: Record;
     formulaObject: any;
     field: ImageSelectorField;
     inConfig: boolean;
     styleVersion: number;
+    formField: MatFormField;
     forceState: string | null;
     recordChange: EventEmitter<Record>;
     FieldstyleObj: any;
@@ -16,9 +18,11 @@ export declare class ImageFieldSelectorTemplateComponent implements OnInit, OnCh
     transformedRecord: any;
     fieldUid: string;
     private styleEl;
+    private notchObserver;
     constructor(renderer: Renderer2);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    ngAfterViewInit(): void;
     ngOnDestroy(): void;
     initStyles(): void;
     ToLowerCase(el: string): string;

package/lib/components/private/field-templates/numeric-field-template/numeric-field-template.component.d.ts

@@ -1,10 +1,11 @@
-import { EventEmitter, OnChanges, OnDestroy, OnInit, Renderer2, SimpleChanges } from '@angular/core';
+import { AfterViewInit, EventEmitter, OnChanges, OnDestroy, OnInit, Renderer2, SimpleChanges } from '@angular/core';
+import { MatFormField } from '@angular/material/form-field';
 import { TmwNumericOptions } from 'tmw-numeric';
 import { Record } from '../../../../models/record.model';
 import { NumericField, NumericFieldIconPositionEnum } from '../../../../models/fields/numericField.model';
 import { IBaseFieldComponent } from '../../../../interfaces/iBaseFieldComponent.interface';
 import * as i0 from "@angular/core";
-export declare class NumericFieldTemplateComponent implements OnInit, OnChanges, OnDestroy, IBaseFieldComponent {
+export declare class NumericFieldTemplateComponent implements AfterViewInit, OnInit, OnChanges, OnDestroy, IBaseFieldComponent {
     private renderer;
     field: NumericField;
     record: Record;
@@ -12,6 +13,7 @@ export declare class NumericFieldTemplateComponent implements OnInit, OnChanges,
     inConfig: boolean;
     /** Incrementa dall'esterno per forzare il ricalcolo degli stili CSS (es. dal configuratore) */
     styleVersion: number;
+    formField: MatFormField;
     /** Forza visivamente uno stato specifico nell'anteprima del configuratore */
     forceState: string | null;
     recordChange: EventEmitter<Record>;
@@ -24,9 +26,11 @@ export declare class NumericFieldTemplateComponent implements OnInit, OnChanges,
     fieldUid: string;
     private styleEl;
     private statusSub;
+    private notchObserver;
     constructor(renderer: Renderer2);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    ngAfterViewInit(): void;
     ngOnDestroy(): void;
     initStyles(): void;
     /** Rigenera il tag <style> con defaults + regole utente, entrambi scoped per #uid */

package/lib/components/private/field-templates/text-field-template/text-field-template.component.d.ts

@@ -1,10 +1,11 @@
-import { EventEmitter, OnChanges, OnDestroy, OnInit, Renderer2, SimpleChanges } from '@angular/core';
+import { AfterViewInit, EventEmitter, OnChanges, OnDestroy, OnInit, Renderer2, SimpleChanges } from '@angular/core';
+import { MatFormField } from '@angular/material/form-field';
 import { Record } from '../../../../models/record.model';
 import { TextFieldIconPositionEnum, TextMaskEnum, TextField } from '../../../../models/fields/textField.model';
 import { IBaseFieldComponent } from '../../../../interfaces/iBaseFieldComponent.interface';
 import { Subscription } from 'rxjs';
 import * as i0 from "@angular/core";
-export declare class TextFieldTemplateComponent implements OnInit, OnChanges, OnDestroy, IBaseFieldComponent {
+export declare class TextFieldTemplateComponent implements AfterViewInit, OnInit, OnChanges, OnDestroy, IBaseFieldComponent {
     private renderer;
     isStillRecoginze: boolean;
     source: import("rxjs").Observable<number>;
@@ -16,6 +17,7 @@ export declare class TextFieldTemplateComponent implements OnInit, OnChanges, On
     inConfig: boolean;
     /** Incrementa dall'esterno per forzare il ricalcolo degli stili CSS (es. dal configuratore) */
     styleVersion: number;
+    formField: MatFormField;
     /** Forza visivamente uno stato specifico nell'anteprima del configuratore */
     forceState: string | null;
     FieldstyleObj: any;
@@ -27,9 +29,11 @@ export declare class TextFieldTemplateComponent implements OnInit, OnChanges, On
     fieldUid: string;
     private styleEl;
     private statusSub;
+    private notchObserver;
     constructor(renderer: Renderer2);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    ngAfterViewInit(): void;
     ngOnDestroy(): void;
     initStyles(): void;
     /** Rigenera il tag <style> con defaults + regole utente, entrambi scoped per #uid */

package/lib/components/private/field-templates/textarea-field-template/textarea-field-template.component.d.ts

@@ -1,10 +1,11 @@
-import { EventEmitter, OnChanges, OnDestroy, OnInit, Renderer2, SimpleChanges } from '@angular/core';
+import { AfterViewInit, EventEmitter, OnChanges, OnDestroy, OnInit, Renderer2, SimpleChanges } from '@angular/core';
+import { MatFormField } from '@angular/material/form-field';
 import { IBaseFieldComponent } from '../../../../interfaces/iBaseFieldComponent.interface';
 import { Record } from '../../../../models/record.model';
 import { TextareaField, TextareaFieldIconPositionEnum } from '../../../../models/fields/textareaField.model';
 import { Subscription } from 'rxjs';
 import * as i0 from "@angular/core";
-export declare class TextareaFieldTemplateComponent implements OnInit, OnChanges, OnDestroy, IBaseFieldComponent {
+export declare class TextareaFieldTemplateComponent implements AfterViewInit, OnInit, OnChanges, OnDestroy, IBaseFieldComponent {
     private renderer;
     isStillRecoginze: boolean;
     field: TextareaField;
@@ -13,6 +14,7 @@ export declare class TextareaFieldTemplateComponent implements OnInit, OnChanges
     inConfig: boolean;
     /** Incrementa dall'esterno per forzare il ricalcolo degli stili CSS (es. dal configuratore) */
     styleVersion: number;
+    formField: MatFormField;
     /** Forza visivamente uno stato specifico nell'anteprima del configuratore */
     forceState: string | null;
     source: import("rxjs").Observable<number>;
@@ -26,9 +28,11 @@ export declare class TextareaFieldTemplateComponent implements OnInit, OnChanges
     fieldUid: string;
     private styleEl;
     private statusSub;
+    private notchObserver;
     constructor(renderer: Renderer2);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    ngAfterViewInit(): void;
     ngOnDestroy(): void;
     initStyles(): void;
     /** Rigenera il tag <style> con defaults + regole utente, entrambi scoped per #uid */

package/lib/directives/speech-to-text/speech-to-text.directive.d.ts

@@ -3,6 +3,8 @@ import { Subscription } from "rxjs";
 import * as i0 from "@angular/core";
 export declare class SpeechToTextDirective implements OnDestroy {
     private elementRef;
+    /** True mentre QUESTA icona è quella in ascolto — usato dal template per mostrare tmw-icon in variante 'filled' */
+    get isListening(): boolean;
     debug: boolean;
     bindedText: string;
     bindedTextChange: EventEmitter<string>;
@@ -27,5 +29,5 @@ export declare class SpeechToTextDirective implements OnDestroy {
     private wordConcat;
     private printDebug;
     static ɵfac: i0.ɵɵFactoryDeclaration<SpeechToTextDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<SpeechToTextDirective, "[SpeechToText]", never, { "bindedText": "bindedText"; }, { "bindedTextChange": "bindedTextChange"; }, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SpeechToTextDirective, "[SpeechToText]", ["speechToText"], { "bindedText": "bindedText"; }, { "bindedTextChange": "bindedTextChange"; }, never, never, false, never>;
 }

package/lib/utils/css-property-catalog.d.ts

@@ -19,6 +19,8 @@ export interface CssPropertyDef {
     max?: number;
     step?: number;
     unit?: string;
+    /** Solo per type 'size': posizione iniziale dello slider quando la proprietà non è impostata */
+    defaultValue?: number;
     /** Solo per type 'select' */
     options?: Array<{
         value: string;
@@ -31,6 +33,29 @@ export declare const CSS_CORE_PROPERTIES: Array<CssPropertyDef>;
 /** Proprietà aggiuntive, mostrate solo aprendo "Altre proprietà" */
 export declare const CSS_EXTRA_PROPERTIES: Array<CssPropertyDef>;
 export declare const CSS_ALL_PROPERTIES: Array<CssPropertyDef>;
+/**
+ * Proprietà che hanno senso solo su alcuni elementi: non compaiono nelle liste generali,
+ * vengono aggiunte dai profili dei singoli elementi (vedi CssElementProfile).
+ */
+export declare const CSS_ELEMENT_ONLY_PROPERTIES: Array<CssPropertyDef>;
 export declare function getCssPropertyDef(prop: string): CssPropertyDef | null;
+/**
+ * Personalizza l'elenco delle proprietà mostrate per un elemento grafico.
+ * Le proprietà già valorizzate sul campo restano sempre visibili, così si possono azzerare.
+ */
+export interface CssElementProfile {
+    /** Se presente, l'elemento mostra solo queste proprietà e niente "Altre proprietà..." */
+    only?: Array<string>;
+    /** Proprietà tolte dalle liste generali */
+    hidden?: Array<string>;
+    /** Proprietà aggiunte in coda alle principali */
+    extra?: Array<string>;
+}
+export declare const CSS_PROFILE_LABEL: CssElementProfile;
+export declare const CSS_PROFILE_VALUE: CssElementProfile;
+/** Label dentro la casella o sollevata sul bordo: solo le proprietà che cambiano fra i due casi */
+export declare const CSS_PROFILE_FLOATING_LABEL: CssElementProfile;
+/** Proprietà da mostrare per un elemento, applicando l'eventuale profilo */
+export declare function getCssPropertiesForProfile(profile: CssElementProfile | undefined, showAll: boolean): Array<CssPropertyDef>;
 /** Definizione di ripiego per una proprietà scritta a mano e non catalogata */
 export declare function buildCustomCssPropertyDef(prop: string): CssPropertyDef;

package/lib/utils/field-style-catalog.d.ts

@@ -1,4 +1,5 @@
 import { BaseField, FieldTypeEnum } from '../models/baseField.model';
+import { CssElementProfile } from './css-property-catalog';
 /**
  * Catalogo centralizzato della grafica dei campi.
  *
@@ -10,6 +11,8 @@ import { BaseField, FieldTypeEnum } from '../models/baseField.model';
 export interface FieldStyleEntryDef {
     key: string;
     label: string;
+    /** Proprietà mostrate dall'editor per questo elemento (default: elenco generale) */
+    profile?: CssElementProfile;
 }
 export interface FieldStyleTypeDef {
     fieldType: FieldTypeEnum;
@@ -59,6 +62,8 @@ export declare function cloneFieldStyleMap(field: BaseField): {
 export interface GlobalStyleElementDef {
     key: string;
     label: string;
+    /** Proprietà mostrate dall'editor per questo elemento (default: elenco generale) */
+    profile?: CssElementProfile;
     /** Per ogni tipologia, gli elementi reali su cui scrivere */
     perType: {
         [fieldType: number]: Array<string>;

package/lib/utils/floating-label-styles.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Label "flottante" dei mat-form-field outline (Angular Material 15).
+ *
+ * La stessa label ha due aspetti: a riposo dentro la casella (campo vuoto e non selezionato)
+ * e sollevata sul bordo (campo compilato o selezionato). L'editor li mostra come due elementi:
+ * "Etichetta nel contenitore" è la chiave storica (Descrizione / Label): grafica base della
+ * label, valida sempre. "Etichetta sul bordo" (DescrizioneSollevata / LabelSollevata) sovrascrive
+ * solo ciò che vi è impostato quando la label è sollevata.
+ *
+ * Il server conosce solo le chiavi storiche: l'override del bordo viene quindi salvato DENTRO la
+ * stringa CSS della chiave base, come proprietà custom `--eqp-sollevata: "<css>"`. È CSS valido
+ * (il browser la ignora) e passa intatta per le classi tipizzate del server. Le chiavi
+ * "…Sollevata" esistono solo in memoria, nell'editor: readStyleCss/writeStyleCss fanno da ponte.
+ */
+/** Suffisso del selettore della label per la label sollevata */
+export declare const LABEL_FLOATING_SUFFIX = ".mdc-floating-label--float-above";
+/** Proprietà custom, dentro la chiave base, che contiene il CSS dell'etichetta sul bordo */
+export declare const FLOATING_OVERRIDE_PROP = "--eqp-sollevata";
+/** True per le chiavi virtuali dell'etichetta sul bordo (es. "DescrizioneSollevataNormale") */
+export declare function isFloatingOverrideKey(key: string): boolean;
+/** Chiave reale in cui è salvato l'override: "DescrizioneSollevataNormale" -> "DescrizioneNormale" */
+export declare function floatingBaseKey(key: string): string;
+/**
+ * CSS di una chiave "Elemento+Stato", anche virtuale, letto da una mappa nel formato salvato.
+ * Per le chiavi base restituisce il CSS senza la proprietà custom (che non va iniettata).
+ */
+export declare function readStyleCss(map: {
+    [key: string]: string;
+}, key: string): string;
+/** Scrive il CSS di una chiave, anche virtuale, in una mappa nel formato salvato */
+export declare function writeStyleCss(map: {
+    [key: string]: string;
+}, key: string, css: string): void;
+/** Mappa "esplosa" per l'editor: chiavi base pulite più le chiavi virtuali "…Sollevata…" */
+export declare function decodeFloatingMap(map: {
+    [key: string]: string;
+}): {
+    [key: string]: string;
+};
+/** Inverso di decodeFloatingMap: riporta la mappa al formato salvato */
+export declare function encodeFloatingMap(decoded: {
+    [key: string]: string;
+}): {
+    [key: string]: string;
+};
+/** Aggiunge !important a ogni dichiarazione: serve dove regole globali con !important coprono le nostre */
+export declare function forceImportantCss(css: string): string;
+/** True se il campo ha una grafica sulla label (base o sul bordo) con quel prefisso di chiave */
+export declare function hasFloatingLabelStyles(styleMap: {
+    [key: string]: string;
+}, basePrefix?: string): boolean;
+/**
+ * Regole di base da iniettare prima di quelle dell'utente quando la label è personalizzata. Material la rimpicciolisce al 75% con una trasformazione: dimensione testo,
+ * padding e larghezza impostati dall'utente risulterebbero ridotti. Qui la scala torna a 1 e il
+ * testo riparte dalla stessa dimensione che Material mostrava (12px); la label resta centrata
+ * sulla linea del bordo, e "top" la sposta da lì.
+ * I selettori sono dentro :where() per restare più deboli di qualsiasi regola dell'utente,
+ * anche di quelle su Descrizione che valgono per entrambe le posizioni.
+ *
+ * @param uid           id del wrapper del campo
+ * @param labelSelector selettore della label, relativo al wrapper (es. " label.mat-mdc-floating-label")
+ * @param styleMap      mappa "Elemento+Stato" -> CSS del campo
+ */
+export declare function buildFloatingLabelBaseRules(uid: string, labelSelector: string, styleMap: {
+    [key: string]: string;
+}): Array<string>;
+/**
+ * True se il CSS imposta "top". Il top dell'etichetta nel contenitore non deve propagarsi alla
+ * label sollevata, che ha la propria posizione: i template, dopo la regola della chiave base (Descrizione / Label),
+ * ne emettono una che riporta a 0 il top della label sollevata; quella di "…Sollevata",
+ * venendo dopo, la sovrascrive.
+ */
+export declare function cssSetsTop(css: string): boolean;

package/lib/utils/refresh-outline-notch.d.ts

@@ -0,0 +1,15 @@
+import { MatFormField } from '@angular/material/form-field';
+/**
+ * Rimisura la label di un mat-form-field "outline" e riallinea l'apertura nel bordo.
+ *
+ * Material misura la label solo alla creazione del campo: se poi gli stili iniettati
+ * cambiano font, spaziatura o larghezza della descrizione, l'apertura resta stretta
+ * e la label sollevata viene tagliata.
+ */
+export declare function refreshOutlineNotch(formField: MatFormField | undefined): void;
+/**
+ * Rimisura la label ogni volta che si solleva o torna dentro la casella: le due posizioni
+ * possono avere grafiche diverse, e Material misurerebbe quella a riposo anche per il bordo.
+ * Restituisce l'osservatore, da scollegare nell'ngOnDestroy.
+ */
+export declare function watchOutlineNotch(formField: MatFormField | undefined): MutationObserver | null;

package/package.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "EqProject"
   },
-  "version": "2.11.5",
+  "version": "2.11.7",
   "peerDependencies": {
     "@angular/cdk": "^15.1.2",
     "@angular/common": "^15.1.2",