@eqproject/eqp-dynamic-module 2.11.4 → 2.11.5

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

@@ -0,0 +1,130 @@
+import { BaseField, FieldTypeEnum } from '../models/baseField.model';
+/**
+ * Catalogo centralizzato della grafica dei campi.
+ *
+ * Ogni tipologia di campo espone una mappa piatta "Elemento + Stato" -> stringa CSS
+ * (es. TextFieldStyleCSS.InputFocused = "color: red;"). Qui stanno, in un unico posto,
+ * i metadati di quali elementi e quali stati esistono per ogni tipologia, insieme agli
+ * accessor generici per leggere/scrivere quelle mappe senza duplicare codice per tipo.
+ */
+export interface FieldStyleEntryDef {
+    key: string;
+    label: string;
+}
+export interface FieldStyleTypeDef {
+    fieldType: FieldTypeEnum;
+    /** Etichetta della tipologia mostrata a video */
+    label: string;
+    /** Nome della proprietà che contiene la mappa degli stili sul field */
+    styleProp: string;
+    elements: Array<FieldStyleEntryDef>;
+    states: Array<FieldStyleEntryDef>;
+}
+export declare const FIELD_STYLE_CATALOG: Array<FieldStyleTypeDef>;
+/**
+ * Nome di un campo da mostrare a video. Description può valere " " (uno spazio: truthy ma
+ * invisibile), quindi va ripulita prima di usarla; poi il testo dell'Etichetta, il codice, il Name.
+ */
+export declare function getFieldDisplayName(field: BaseField): string;
+/** Definizione del catalogo per una tipologia; null se la tipologia non ha grafica configurabile */
+export declare function getFieldStyleTypeDef(fieldType: FieldTypeEnum | number): FieldStyleTypeDef | null;
+/**
+ * Elementi grafici di un campo. Coincidono con quelli del catalogo, salvo l'Elenco generico
+ * dove dipendono dalla modalità di presentazione scelta sul campo.
+ */
+export declare function getFieldStyleElements(field: BaseField): Array<FieldStyleEntryDef>;
+/** Mappa degli stili del campo (può essere undefined se non è mai stata valorizzata) */
+export declare function getFieldStyleMap(field: BaseField): {
+    [key: string]: string;
+} | null;
+/** Come getFieldStyleMap, ma crea la mappa se manca */
+export declare function ensureFieldStyleMap(field: BaseField): {
+    [key: string]: string;
+} | null;
+/** Legge il CSS di un "Elemento + Stato" (es. "InputFocused") */
+export declare function getFieldStyleValue(field: BaseField, key: string): string;
+/** Scrive il CSS di un "Elemento + Stato"; il valore vuoto rimuove la chiave dal JSON */
+export declare function setFieldStyleValue(field: BaseField, key: string, value: string): void;
+/** True se il campo non ha ancora nessuna regola grafica impostata */
+export declare function isFieldStyleMapEmpty(field: BaseField): boolean;
+/** Copia profonda della mappa stili di un campo (solo le chiavi valorizzate) */
+export declare function cloneFieldStyleMap(field: BaseField): {
+    [key: string]: string;
+};
+/**
+ * Elemento "logico" della grafica globale: un concetto (contenitore, etichetta, area del valore)
+ * presente in quasi tutte le tipologie ma che ogni tipologia chiama con un nome diverso.
+ * Serve alla scheda "Grafica globale", dove si modificano insieme campi di tipologie diverse.
+ */
+export interface GlobalStyleElementDef {
+    key: string;
+    label: string;
+    /** Per ogni tipologia, gli elementi reali su cui scrivere */
+    perType: {
+        [fieldType: number]: Array<string>;
+    };
+}
+export declare const GLOBAL_STYLE_ELEMENTS: Array<GlobalStyleElementDef>;
+/**
+ * Elementi reali di un campo corrispondenti a un elemento logico globale.
+ * Interseca la mappatura per tipologia con gli elementi che il campo ha davvero
+ * (l'Elenco generico, per esempio, cambia elementi in base alla modalità di presentazione).
+ */
+export declare function resolveGlobalElementKeys(field: BaseField, globalKey: string): Array<string>;
+/** Stati comuni a tutte le tipologie passate: sono gli unici applicabili globalmente */
+export declare function getCommonStates(fieldTypes: Array<FieldTypeEnum | number>): Array<FieldStyleEntryDef>;
+/**
+ * I campi hanno due proprietà storiche, LabelstyleCSS e FieldstyleCSS, che i template
+ * applicano ancora con [ngStyle], quindi come stili INLINE. Essendo inline battono le regole
+ * "#uid { ... }" iniettate dalla grafica per elemento e stato: un colore impostato dall'editor
+ * grafico non si vedeva sui campi che avevano il CSS legacy valorizzato.
+ *
+ * Questa tabella dice, per ogni tipologia, su quale elemento della grafica nuova finisce
+ * ciascuna delle due proprietà legacy, in modo da poterle assorbire e avere una sola fonte
+ * di verità. Le tipologie assenti non usano [ngStyle] in nessun template.
+ */
+export declare const LEGACY_STYLE_TARGETS: {
+    [fieldType: number]: {
+        label?: string;
+        field?: string;
+    };
+};
+export interface LegacyMergeResult {
+    /** Proprietà legacy assorbite */
+    consumed: Array<'LabelstyleCSS' | 'FieldstyleCSS'>;
+    /** Chiavi "ElementoStato" toccate dall'assorbimento */
+    keys: Array<string>;
+}
+/**
+ * Riversa il CSS legacy del campo dentro una mappa "Elemento+Stato" -> CSS, sullo stato Normale.
+ * Non sovrascrive le proprietà già presenti nella mappa: la grafica nuova ha la precedenza.
+ */
+export declare function mergeLegacyStylesIntoMap(field: BaseField, map: {
+    [key: string]: string;
+}, only?: 'LabelstyleCSS' | 'FieldstyleCSS'): LegacyMergeResult;
+/** Chiave "ElementoNormale" su cui finirebbe una proprietà legacy, o null se non applicabile */
+export declare function legacyTargetKey(field: BaseField, name: 'LabelstyleCSS' | 'FieldstyleCSS'): string | null;
+/** Mappa stili "effettiva" di un campo: quella per elemento più il CSS legacy assorbito */
+export declare function getEffectiveStyleMap(field: BaseField): {
+    [key: string]: string;
+};
+/**
+ * True se il campo ha una grafica da qualche parte: nella mappa per elemento oppure nel CSS
+ * legacy. È il test giusto per "questo campo può fare da sorgente" (eredità, Copia Grafica):
+ * isFieldStyleMapEmpty guarda solo la mappa nuova e ignorerebbe i campi stilizzati solo col legacy.
+ */
+export declare function hasEffectiveStyles(field: BaseField): boolean;
+/**
+ * Grafica di default costruita a partire da campi di tipologia DIVERSA.
+ *
+ * L'eredità naturale è fra campi della stessa tipologia, che condividono i nomi degli elementi.
+ * Quando però una tipologia viene usata per la prima volta non c'è nessun campo simile da cui
+ * copiare: in quel caso si passa per gli elementi logici della grafica globale (contenitore,
+ * etichetta, area del valore), che ogni tipologia sa tradurre nei propri elementi.
+ *
+ * @param field   campo nuovo che deve ricevere la grafica
+ * @param sources campi già presenti nella form, in ordine
+ */
+export declare function buildGlobalInheritedMap(field: BaseField, sources: Array<BaseField>): {
+    [key: string]: string;
+};

package/package.json

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

package/public-api.d.ts

@@ -2,6 +2,7 @@ export * from './lib/eqp-dynamic-module.module';
 export * from './lib/components/exported/eqp-dynamic-module/eqp-dynamic-module.component';
 export * from './lib/components/exported/eqp-dynamic-module-configurator/eqp-dynamic-module-configurator.component';
 export * from './lib/components/private/add-form-field/add-form-field.component';
+export * from './lib/components/private/field-graphics-editor/field-graphics-editor.component';
 export * from './lib/components/private/dynamic-module-field-fix/dynamic-module-field.component';
 export * from './lib/components/private/dynamic-module-field-extra-fix/dynamic-module-field-extra-fix.component';
 export * from './lib/components/private/field-templates/attachment-field-template/attachment-field-template.component';
@@ -54,3 +55,7 @@ export * from './lib/services/utilityHelper.services';
 export * from './lib/models/graph.model';
 export * from './lib/directives/dynamic-loader/dynamic-loader.directive';
 export * from './lib/directives/speech-to-text/speech-to-text.directive';
+export * from './lib/utils/field-style-catalog';
+export * from './lib/utils/css-declarations';
+export * from './lib/utils/css-property-catalog';
+export * from './lib/utils/css-color';