@gnggln/ng-ui-system 1.0.0-alpha.2 → 1.0.0-alpha.21

package/form-builder/lib/components/form-builder/form-wizard.component.d.ts

@@ -0,0 +1,172 @@
+import { EventEmitter, OnInit, OnDestroy, TemplateRef } from '@angular/core';
+import { UiFormBuilderComponent } from './form-builder.component';
+import { UiFormSchema, UiFormSection, UiFormData, UiWizardConfig, UiWizardState, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, UiWizardValidationFn, UiFormCustomEvent } from './types/schema.types';
+import { UiFormValidationState } from './types/validation.types';
+import * as i0 from "@angular/core";
+/**
+ * Header del wizard: progresso e info dello step corrente.
+ * Con `progressStyle: 'steps'` emette `stepSelect` per saltare a uno step già completato.
+ */
+export declare class UiWizardHeaderComponent {
+    config: UiWizardConfig;
+    stepGroups: UiFormSection[][];
+    state: UiWizardState;
+    progressPercent: number;
+    currentStepTitle: string;
+    currentStepDescription: string;
+    /** Quando true, i bullet step non sono interattivi (es. wizard disabilitato). */
+    disableStepIndicators: boolean;
+    stepSelect: EventEmitter<number>;
+    /** Indice step selezionabile tramite bullet/titolo (solo step già completati, non il corrente). */
+    isStepIndicatorNavigable(stepIndex: number): boolean;
+    /** Testo accessibile per il pulsante step (navigazione). */
+    stepAriaLabel(stepTitle: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiWizardHeaderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiWizardHeaderComponent, "ui-wizard-header", never, { "config": { "alias": "config"; "required": false; }; "stepGroups": { "alias": "stepGroups"; "required": false; }; "state": { "alias": "state"; "required": false; }; "progressPercent": { "alias": "progressPercent"; "required": false; }; "currentStepTitle": { "alias": "currentStepTitle"; "required": false; }; "currentStepDescription": { "alias": "currentStepDescription"; "required": false; }; "disableStepIndicators": { "alias": "disableStepIndicators"; "required": false; }; }, { "stepSelect": "stepSelect"; }, never, never, true, never>;
+}
+/**
+ * Footer del wizard: pulsanti di navigazione e salvataggio.
+ * Emette eventi per Previous, Next, Finish, Save.
+ */
+export declare class UiWizardFooterComponent {
+    config: UiWizardConfig;
+    state: UiWizardState;
+    isLastStep: boolean;
+    previous: EventEmitter<void>;
+    next: EventEmitter<void>;
+    finish: EventEmitter<void>;
+    save: EventEmitter<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiWizardFooterComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiWizardFooterComponent, "ui-wizard-footer", never, { "config": { "alias": "config"; "required": false; }; "state": { "alias": "state"; "required": false; }; "isLastStep": { "alias": "isLastStep"; "required": false; }; }, { "previous": "previous"; "next": "next"; "finish": "finish"; "save": "save"; }, never, never, true, never>;
+}
+/**
+ * Componente wizard che wrappa `UiFormBuilderComponent`
+ * aggiungendo navigazione multi-step, barra di progresso,
+ * validazione per step e sincronizzazione wireless.
+ * Più sezioni schema con lo stesso `wizardStep.stepNumber` formano un unico passo
+ * (es. più blocchi collassabili per step); metadati del passo dalla prima sezione del gruppo.
+ *
+ * @selector ui-form-wizard
+ *
+ * @example
+ * ```html
+ * <ui-form-wizard
+ *   [schema]="wizardSchema"
+ *   [wizardConfig]="wizardConfig"
+ *   (wizardComplete)="onComplete($event)"
+ *   (stepChange)="onStepChange($event)"
+ * />
+ * ```
+ */
+export declare class UiFormWizardComponent implements OnInit, OnDestroy {
+    private readonly cdr;
+    private readonly wizardSync;
+    private readonly logger;
+    private readonly destroy$;
+    formBuilder?: UiFormBuilderComponent;
+    /** Schema completo del form (tutte le sezioni con wizardStep). */
+    schema: UiFormSchema;
+    /** Configurazione del wizard. */
+    wizardConfig: UiWizardConfig;
+    /** Metodi di validazione custom per step. */
+    customValidationMethods: Record<string, UiWizardValidationFn>;
+    /** Dati iniziali. */
+    initialData: UiFormData;
+    /** Modalita sola lettura. */
+    readonly: boolean;
+    /** Stato disabilitato. */
+    disabled: boolean;
+    /** Pulsante in caricamento. */
+    loadingFor: string | null;
+    /** Template per campi `type: 'custom'` (inoltro al form builder). */
+    customFieldTemplates: Record<string, TemplateRef<unknown>>;
+    /** Fallback template per campi custom (inoltro al form builder). */
+    customFieldTemplateFallback?: TemplateRef<unknown>;
+    stepChange: EventEmitter<UiWizardStepChangeEvent>;
+    stepComplete: EventEmitter<UiWizardStepCompleteEvent>;
+    stepValidationFailed: EventEmitter<{
+        step: number;
+        errors: string[];
+    }>;
+    wizardComplete: EventEmitter<UiFormData>;
+    valueChange: EventEmitter<UiFormData>;
+    validationChange: EventEmitter<UiFormValidationState>;
+    customEvent: EventEmitter<UiFormCustomEvent>;
+    state: UiWizardState;
+    /**
+     * Gruppi di sezioni schema per passo logico del wizard.
+     * Sezioni con lo stesso `wizardStep.stepNumber` compongono un unico passo (ordine: come in `schema.sections` dopo sort per numero).
+     */
+    wizardStepGroups: UiFormSection[][];
+    /** Dati accumulati del form. */
+    private accumulatedData;
+    /**
+     * Schema cachato per lo step corrente.
+     * Evita di creare un nuovo oggetto ad ogni ciclo di change detection,
+     * cosa che causerebbe rebuild infiniti nel form builder.
+     */
+    _cachedStepSchema: UiFormSchema | null;
+    private _cachedStepIndex;
+    get currentStepSchema(): UiFormSchema | null;
+    get currentStepTitle(): string;
+    get currentStepDescription(): string;
+    get isLastStep(): boolean;
+    get progressPercent(): number;
+    /**
+     * Dati passati al form builder: unione tra valori forniti dal consumer e
+     * stato accumulato tra gli step. Senza questo, tornando indietro il builder
+     * riceverebbe solo `initialData` e ricreerebbe i campi vuoti, pur avendo
+     * i valori ancora in `accumulatedData`.
+     */
+    get mergedInitialDataForBuilder(): UiFormData;
+    /** Mostra la navigazione sopra il form builder. */
+    get showTopNav(): boolean;
+    /** Mostra la navigazione sotto il form builder. */
+    get showBottomNav(): boolean;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * Scorciatoia: Ctrl + Freccia sinistra/destra per navigare come i pulsanti
+     * Indietro / Avanti (sull'ultimo step, Avanti equivale a Completa).
+     * Ignorata se il focus è in un campo di input per non interferire con la digitazione.
+     */
+    onDocumentKeydown(event: KeyboardEvent): void;
+    /** True se il target del keydown è un elemento dove la digitazione ha priorità sulla shortcut wizard. */
+    private isEditableKeyboardTarget;
+    /** Vai allo step successivo con validazione. */
+    goToNextStep(): Promise<void>;
+    /** Torna allo step precedente. */
+    goToPreviousStep(): void;
+    /**
+     * Navigazione tramite indicatori step (bullet + titolo) quando `progressStyle` è `'steps'`.
+     * Consentito solo verso step già marcati completati.
+     */
+    onWizardStepIndicatorSelect(stepIndex: number): void;
+    /** Completa il wizard. */
+    finishWizard(): Promise<void>;
+    /** Salva lo step corrente manualmente. */
+    saveCurrentStep(): Promise<void>;
+    onValueChange(data: UiFormData): void;
+    onValidationChange(state: UiFormValidationState): void;
+    private navigateToStep;
+    private validateCurrentStep;
+    /**
+     * Raggruppa le sezioni con `wizardStep` per `stepNumber` (ordine stabile per numero, poi ordine di apparizione nello schema).
+     */
+    private buildWizardStepGroups;
+    /** Chiavi dei campi `custom` in tutte le sezioni del passo corrente. */
+    private getCustomFieldKeysForGroup;
+    /** Rimuove dagli errori i campi custom quando `validateCustomComponents` è false. */
+    private filterErrorDetailsExcludingCustomFields;
+    /**
+     * Risolve la chiave logica del campo rispetto a tutte le sezioni del gruppo (campi flat o repeatable).
+     */
+    private logicalFieldKeyFromDetailKeyForGroup;
+    /** Estrae la chiave campo da `fieldKey` flat o `sectionId[i].fieldKey`. */
+    private logicalFieldKeyFromDetailKey;
+    private escapeRegExp;
+    private autoSaveIfNeeded;
+    private syncWizardState;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFormWizardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiFormWizardComponent, "ui-form-wizard", never, { "schema": { "alias": "schema"; "required": false; }; "wizardConfig": { "alias": "wizardConfig"; "required": false; }; "customValidationMethods": { "alias": "customValidationMethods"; "required": false; }; "initialData": { "alias": "initialData"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "loadingFor": { "alias": "loadingFor"; "required": false; }; "customFieldTemplates": { "alias": "customFieldTemplates"; "required": false; }; "customFieldTemplateFallback": { "alias": "customFieldTemplateFallback"; "required": false; }; }, { "stepChange": "stepChange"; "stepComplete": "stepComplete"; "stepValidationFailed": "stepValidationFailed"; "wizardComplete": "wizardComplete"; "valueChange": "valueChange"; "validationChange": "validationChange"; "customEvent": "customEvent"; }, never, never, true, never>;
+}

package/form-builder/lib/components/form-builder/index.d.ts

@@ -0,0 +1,19 @@
+export { UiFormBuilderComponent } from './form-builder.component';
+export { UiFormErrorStateMatcher } from './services/form-error-state.matcher';
+export { UiFormWizardComponent } from './form-wizard.component';
+export { UiFormErrorSummaryComponent } from './sub-components/error-summary/form-error-summary.component';
+export { UiFileInputComponent } from './sub-components/file-input/file-input.component';
+export { UiSpecificaTerritorialeComponent } from './sub-components/specifica-territoriale/specifica-territoriale.component';
+export { UiTableTerritorialeComponent } from './sub-components/table-territoriale/table-territoriale.component';
+export { UiLocationGeocodedComponent } from './sub-components/location-geocoded/location-geocoded.component';
+export { UiFormTextFieldComponent, UiFormTextareaFieldComponent, UiFormNumberFieldComponent, UiFormSelectFieldComponent, UiFormRadioFieldComponent } from './sub-components/form-fields/index';
+export { UiFormConditionService } from './services/form-condition.service';
+export { UiFormValidationService } from './services/form-validation.service';
+export { UiFormFieldErrorService } from './services/form-field-error.service';
+export type { UiFieldErrorDisplayOptions } from './services/form-field-error.service';
+export { UiLocationService, type UiNazione, type UiProvincia, type UiComune, } from './services/location.service';
+export { UiWizardSyncService, type UiWizardSyncData, } from './services/wizard-sync.service';
+export { UiNominatimGeocodingService } from './services/nominatim-geocoding.service';
+export { UiCurrencyInputDirective } from './directives/currency-input.directive';
+export { UiItalianDateAdapter, UI_IT_DATE_FORMATS } from './adapters/it-date-adapter';
+export * from './types/index';

package/form-builder/lib/components/form-builder/services/form-condition.service.d.ts

@@ -0,0 +1,46 @@
+import { UiFieldCondition } from '../types/condition.types';
+import * as i0 from "@angular/core";
+/**
+ * Servizio per la valutazione delle condizioni di visibilita,
+ * required e disable dei campi del form.
+ *
+ * Supporta 12 operatori di confronto, logica AND/OR
+ * e accesso a valori annidati tramite dot notation.
+ *
+ * @providedIn 'root'
+ */
+export declare class UiFormConditionService {
+    /**
+     * Valuta una singola condizione rispetto ai dati del form.
+     *
+     * @param condition - Condizione da valutare.
+     * @param formData - Stato corrente dei dati del form.
+     * @returns `true` se la condizione e soddisfatta.
+     */
+    evaluateCondition(condition: UiFieldCondition, formData: Record<string, any>): boolean;
+    /**
+     * Valuta un array di condizioni con logica AND/OR.
+     *
+     * La prima condizione stabilisce il valore iniziale.
+     * Le condizioni successive usano la proprieta `logic` per
+     * combinare il risultato (`AND` per default).
+     *
+     * @param conditions - Array di condizioni.
+     * @param formData - Stato corrente dei dati del form.
+     * @returns `true` se le condizioni combinate sono soddisfatte.
+     */
+    evaluateConditions(conditions: UiFieldCondition[], formData: Record<string, any>): boolean;
+    /** Accesso a valori annidati tramite dot notation (es. `'address.city'`). */
+    private getNestedValue;
+    /** Confronto stringa case-insensitive. */
+    private stringContains;
+    /** Confronto numerico generico. */
+    private numericCompare;
+    /**
+     * Verifica se un valore e vuoto in modo robusto.
+     * Gestisce null, undefined, false, stringhe vuote, array vuoti e oggetti vuoti.
+     */
+    private isEmpty;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFormConditionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiFormConditionService>;
+}

package/form-builder/lib/components/form-builder/services/form-error-state.matcher.d.ts

@@ -0,0 +1,9 @@
+import { FormControl, FormGroupDirective, NgForm } from '@angular/forms';
+import { ErrorStateMatcher } from '@angular/material/core';
+/**
+ * ErrorStateMatcher condiviso tra form-builder e campi atomici.
+ * Mostra errore quando il controllo è invalido e (touched o dirty).
+ */
+export declare class UiFormErrorStateMatcher implements ErrorStateMatcher {
+    isErrorState(control: FormControl | null, _form: FormGroupDirective | NgForm | null): boolean;
+}

package/form-builder/lib/components/form-builder/services/form-field-error.service.d.ts

@@ -0,0 +1,38 @@
+import { AbstractControl } from '@angular/forms';
+import { UiValidationRule } from '../types/validation.types';
+import * as i0 from "@angular/core";
+/** Opzioni per la visibilità degli errori di un campo. */
+export interface UiFieldErrorDisplayOptions {
+    /** Tratta il campo come prevalorizzato (mostra errori anche senza touched). */
+    treatAsPrevalorized?: boolean;
+}
+/**
+ * Servizio condiviso per messaggi di errore, visibilità errori e conteggio caratteri
+ * dei campi form-builder e dei componenti atomici standalone.
+ */
+export declare class UiFormFieldErrorService {
+    /**
+     * Restituisce i messaggi di errore user-facing per un controllo.
+     *
+     * @param control Controllo Angular del campo
+     * @param rules Regole di validazione dichiarative (messaggi custom dallo schema)
+     */
+    getFieldErrors(control: AbstractControl | null, rules?: UiValidationRule[]): string[];
+    /**
+     * Indica se mostrare gli errori per un controllo (invalid + touched/dirty/prevalorizzato).
+     */
+    shouldShowFieldErrors(control: AbstractControl | null, options?: UiFieldErrorDisplayOptions): boolean;
+    /**
+     * Conteggio caratteri corrente/massimo per campi text/textarea con maxLength.
+     */
+    getCharCount(control: AbstractControl | null, maxLength?: number): {
+        current: number;
+        max: number;
+    } | null;
+    /** Estrae maxLength dalle regole schema. */
+    resolveMaxLength(rules?: UiValidationRule[]): number | undefined;
+    private normalizeValidationKey;
+    private getDefaultErrorMessage;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFormFieldErrorService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiFormFieldErrorService>;
+}

package/form-builder/lib/components/form-builder/services/form-validation.service.d.ts

@@ -0,0 +1,63 @@
+import { AbstractControl, ValidatorFn } from '@angular/forms';
+import { UiValidationRule } from '../types/validation.types';
+import { UiFormConditionService } from './form-condition.service';
+import * as i0 from "@angular/core";
+/**
+ * Servizio per la creazione e gestione dei validatori Angular
+ * basati sulle regole dichiarative dello schema del form.
+ *
+ * Supporta validazioni standard, cross-field, date con offset,
+ * file e validatori condizionali.
+ *
+ * @providedIn 'root'
+ */
+export declare class UiFormValidationService {
+    private conditionService;
+    constructor(conditionService: UiFormConditionService);
+    /** Crea un array di validatori Angular dalle regole di validazione. */
+    createValidators(rules: UiValidationRule[]): ValidatorFn[];
+    /**
+     * Crea validatori con supporto condizionale.
+     * Le regole con `conditions` vengono applicate solo se le condizioni sono soddisfatte.
+     */
+    createConditionalValidators(rules: UiValidationRule[], formData: Record<string, any>): ValidatorFn[];
+    /**
+     * Aggiorna i validatori di un campo in base allo stato corrente del form.
+     * Usato per ricalcolare validazioni condizionali quando i dati cambiano.
+     */
+    updateFieldValidators(control: AbstractControl, rules: UiValidationRule[] | undefined, formData: Record<string, any>): void;
+    /** Verifica se un campo dovrebbe mostrare gli errori. */
+    shouldShowFieldErrors(control: AbstractControl): boolean;
+    /** Restituisce i campi correlati da cross-field validation. */
+    getCrossFieldRelatedFields(fieldKey: string, allRules: Record<string, UiValidationRule[]>): string[];
+    /** Verifica se un campo ha validazioni cross-field che lo referenziano. */
+    hasCrossFieldValidations(fieldKey: string, allRules: Record<string, UiValidationRule[]>): boolean;
+    /** Formatta la dimensione del file in una stringa leggibile. */
+    formatFileSize(bytes: number): string;
+    private createValidator;
+    private createCrossFieldValidator;
+    /** Confronto date con date-fns. */
+    private validateDateComparison;
+    /** Confronto numerico. */
+    private validateNumberComparison;
+    private createDateMinValidator;
+    private createDateMaxValidator;
+    /**
+     * Parsa una data di riferimento da keyword o stringa DD/MM/YYYY
+     * e applica un eventuale offset temporale.
+     */
+    private parseReferenceDate;
+    /**
+     * Applica un offset temporale a una data.
+     *
+     * Formato: `numero + unita`
+     * - `y`/`a` = anni, `m` = mesi, `g`/`d` = giorni, `s`/`w` = settimane
+     */
+    private applyDateOffset;
+    private formatRefDate;
+    private createFileSizeValidator;
+    private createFileTypeValidator;
+    private createFileCountValidator;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFormValidationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiFormValidationService>;
+}

package/form-builder/lib/components/form-builder/services/location.service.d.ts

@@ -0,0 +1,83 @@
+import * as i0 from "@angular/core";
+/** Voce nazione nel JSON ottimizzato. */
+export interface MinifiedNazioneOption {
+    /** Codice nazione (es. `'ITA'`). */
+    x: string;
+    /** Descrizione (es. `'Italia'`). */
+    d: string;
+}
+/** Voce provincia/comune nel JSON ottimizzato. */
+export interface MinifiedSelectOption {
+    /** Codice (provincia o comune). */
+    x: string;
+    /** Descrizione. */
+    d: string;
+    /** CAP singolo o multipli. */
+    c?: string | string[];
+}
+/** Nazione. */
+export interface UiNazione {
+    codStatoPk: string;
+    codiceCatastale: string;
+    descrizione: string;
+}
+/** Provincia. */
+export interface UiProvincia {
+    codiceProvinciaPk: string;
+    nomeProvincia: string;
+    siglaProvincia: string;
+    visibile: boolean;
+}
+/** Comune. */
+export interface UiComune {
+    codiceCatastale: string;
+    codiceComunePk: string;
+    comuneSoppresso: boolean;
+    nomeComune: string;
+    prov: UiProvincia;
+    visibile: boolean;
+}
+/**
+ * Servizio per la gestione dei dati geografici italiani
+ * da file JSON statici ottimizzati.
+ *
+ * Elimina la necessita di chiamate backend per nazioni,
+ * province, comuni e CAP. I dati vengono caricati in memoria
+ * al primo accesso e poi serviti dalla cache.
+ *
+ * @providedIn 'root'
+ *
+ * @example
+ * ```typescript
+ * const nazioni = await this.locationService.getNazioni();
+ * const province = await this.locationService.getProvince();
+ * const comuni = await this.locationService.getComuniByProvincia('015');
+ * const caps = await this.locationService.getCapList('015146');
+ * ```
+ */
+export declare class UiLocationService {
+    private readonly nazioniMap;
+    private readonly locationMap;
+    private readonly nazioniCache;
+    private readonly provinceCache;
+    private readonly comuniCache;
+    constructor();
+    /** Elenco completo delle nazioni (Italia prima). */
+    getNazioni(): Promise<{
+        data: UiNazione[];
+    }>;
+    /** Elenco completo delle province, ordinate alfabeticamente. */
+    getProvince(): Promise<{
+        content: UiProvincia[];
+    }>;
+    /** Elenco dei comuni per una specifica provincia. */
+    getComuniByProvincia(provinciaId: string): Promise<UiComune[]>;
+    /** Elenco dei CAP per un comune. */
+    getCapList(comuneId: string): Promise<string[]>;
+    /** Dati completi di una location (nazione, provincia o comune). */
+    getLocationFullData(type: 'nazione' | 'provincia' | 'comune', id: string, provinciaId?: string): Promise<UiNazione | UiProvincia | UiComune | null>;
+    private initializeCaches;
+    private sortNazioniItaliaFirst;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiLocationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiLocationService>;
+}

package/form-builder/lib/components/form-builder/services/nominatim-geocoding.service.d.ts

@@ -0,0 +1,37 @@
+import { Observable } from 'rxjs';
+import type { UiGeocodedLocationType, UiLocationGeocodedFieldConfig } from '../types/geocoded-location.types';
+import * as i0 from "@angular/core";
+/** Risposta elementare dell'API search di Nominatim (format=json). */
+interface NominatimSearchItem {
+    place_id: number;
+    lat: string;
+    lon: string;
+    display_name: string;
+    importance?: number;
+    boundingbox?: [string, string, string, string];
+    address?: Record<string, string>;
+}
+/**
+ * Integrazione con l'API pubblica Nominatim (OpenStreetMap) per la ricerca indirizzi.
+ * Mappa i risultati sul tipo {@link UiGeocodedLocationType}.
+ *
+ * In browser è consigliato usare un proxy same-origin per CORS e User-Agent;
+ * vedi {@link UiLocationGeocodedFieldConfig.nominatimBaseUrl}.
+ *
+ * @providedIn root
+ */
+export declare class UiNominatimGeocodingService {
+    private readonly http;
+    /**
+     * Cerca indirizzi in base alla query testuale.
+     *
+     * @param query - Testo libero inserito dall'utente
+     * @param config - Opzioni di ricerca e base URL
+     */
+    search(query: string, config?: UiLocationGeocodedFieldConfig): Observable<UiGeocodedLocationType[]>;
+    /** Converte un risultato Nominatim in {@link UiGeocodedLocationType}. */
+    mapItem(item: NominatimSearchItem): UiGeocodedLocationType;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiNominatimGeocodingService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiNominatimGeocodingService>;
+}
+export {};

package/form-builder/lib/components/form-builder/services/wizard-sync.service.d.ts

@@ -0,0 +1,63 @@
+import { Observable } from 'rxjs';
+import { UiWizardState, UiFormSchema } from '../types/schema.types';
+import * as i0 from "@angular/core";
+/**
+ * Dati sincronizzati tra istanze wizard.
+ * Usato per la funzionalita "wireless heading" che permette
+ * a un componente esterno di controllare la visualizzazione
+ * dell'header del wizard.
+ */
+export interface UiWizardSyncData {
+    /** ID del wizard. */
+    wizardId: string;
+    /** Stato corrente del wizard. */
+    wizardState: UiWizardState;
+    /** Configurazioni degli step. */
+    wizardSteps: {
+        title?: string;
+        description?: string;
+    }[];
+    /** Se il wizard e attivo. */
+    isWizardMode: boolean;
+    /** Schema corrente del form. */
+    schema: UiFormSchema | null;
+}
+/**
+ * Servizio per la sincronizzazione dello stato del wizard
+ * tra istanze multiple (es. header esterno e form wizard).
+ *
+ * Utilizza BehaviorSubject per mantenere lo stato corrente
+ * e notificare i sottoscrittori in tempo reale.
+ *
+ * @providedIn 'root'
+ *
+ * @example
+ * ```typescript
+ * // Nel componente header esterno
+ * this.wizardSync.getWizardState$('my-wizard')
+ *   .subscribe(data => {
+ *     this.currentStep = data?.wizardState.currentStep;
+ *     this.totalSteps = data?.wizardState.totalSteps;
+ *   });
+ *
+ * // Navigazione da header esterno
+ * this.wizardSync.navigateToStep('my-wizard', 2);
+ * ```
+ */
+export declare class UiWizardSyncService {
+    private readonly instances;
+    /** Registra un nuovo wizard o aggiorna uno esistente. */
+    registerWizard(wizardId: string, data: UiWizardSyncData): void;
+    /** Ottiene un observable per monitorare lo stato di un wizard. */
+    getWizardState$(wizardId: string): Observable<UiWizardSyncData | null>;
+    /** Ottiene lo stato corrente (snapshot). */
+    getCurrentWizardState(wizardId: string): UiWizardSyncData | null;
+    /** Rimuove un wizard dal registro (cleanup su destroy). */
+    unregisterWizard(wizardId: string): void;
+    /** Aggiorna parzialmente lo stato del wizard. */
+    updateWizardState(wizardId: string, partial: Partial<UiWizardState>): void;
+    /** Emette un evento di navigazione verso uno step specifico. */
+    navigateToStep(wizardId: string, stepIndex: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiWizardSyncService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiWizardSyncService>;
+}

package/form-builder/lib/components/form-builder/sub-components/error-summary/form-error-summary.component.d.ts

@@ -0,0 +1,31 @@
+import { EventEmitter } from '@angular/core';
+import { UiFormErrorDetail } from '../../types/validation.types';
+import * as i0 from "@angular/core";
+/**
+ * Riepilogo stato validazione del form.
+ *
+ * Con errori: indicatore + dropdown hover/click per il dettaglio e navigazione ai campi.
+ * Senza errori: messaggio di stato positivo fisso (no dropdown), UI prevedibile.
+ *
+ * @selector ui-form-error-summary
+ */
+export declare class UiFormErrorSummaryComponent {
+    /** Lista di errori dettagliati per campo. */
+    errors: UiFormErrorDetail[];
+    /** Conteggio totale degli errori (somma di tutti i messaggi). */
+    totalErrorCount: number;
+    /** Testo mostrato quando non ci sono errori. */
+    validMessage: string;
+    /** Emesso quando l'utente clicca su un errore per navigare al campo. */
+    fieldClick: EventEmitter<string>;
+    /** @internal Stato del dropdown (solo con errori). */
+    showDropdown: boolean;
+    /** True se il form ha almeno un errore da mostrare nel summary. */
+    get hasErrors(): boolean;
+    /** Conteggio da visualizzare: usa totalErrorCount se fornito, altrimenti conta dai dettagli. */
+    get displayCount(): number;
+    /** @internal Gestione click su errore. */
+    onFieldClick(fieldKey: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFormErrorSummaryComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiFormErrorSummaryComponent, "ui-form-error-summary", never, { "errors": { "alias": "errors"; "required": false; }; "totalErrorCount": { "alias": "totalErrorCount"; "required": false; }; "validMessage": { "alias": "validMessage"; "required": false; }; }, { "fieldClick": "fieldClick"; }, never, never, true, never>;
+}

package/form-builder/lib/components/form-builder/sub-components/file-input/file-input.component.d.ts

@@ -0,0 +1,41 @@
+import { EventEmitter } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { UiFileData, UiFileInputConfig } from '../../types/field.types';
+import * as i0 from "@angular/core";
+/**
+ * Componente file input standalone con drag & drop,
+ * anteprima, validazione e supporto multiplo.
+ *
+ * Implementa `ControlValueAccessor` per integrazione
+ * diretta con Angular Reactive Forms.
+ *
+ * @selector ui-file-input
+ */
+export declare class UiFileInputComponent implements ControlValueAccessor {
+    /** Configurazione del file input. */
+    config: UiFileInputConfig | undefined;
+    /** File rimosso dalla lista. */
+    fileRemoved: EventEmitter<UiFileData>;
+    /** Errore di validazione file. */
+    validationError: EventEmitter<string>;
+    readonly files: import("@angular/core").WritableSignal<UiFileData[]>;
+    readonly disabled: import("@angular/core").WritableSignal<boolean>;
+    readonly isDragOver: import("@angular/core").WritableSignal<boolean>;
+    private onChange;
+    private onTouched;
+    /** Stringa accept per l'input nativo. */
+    get acceptString(): string;
+    writeValue(value: UiFileData[]): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState(isDisabled: boolean): void;
+    onDragOver(event: DragEvent): void;
+    onDragLeave(): void;
+    onDrop(event: DragEvent): void;
+    onFileSelected(event: Event): void;
+    removeFile(index: number): void;
+    formatSize(bytes: number): string;
+    private processFiles;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFileInputComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiFileInputComponent, "ui-file-input", never, { "config": { "alias": "config"; "required": false; }; }, { "fileRemoved": "fileRemoved"; "validationError": "validationError"; }, never, never, true, never>;
+}

package/form-builder/lib/components/form-builder/sub-components/form-fields/form-number-field.component.d.ts

@@ -0,0 +1,42 @@
+import { EventEmitter } from '@angular/core';
+import { FormControl, FormGroup } from '@angular/forms';
+import { UiFormFieldDescriptor } from '../../types/field.types';
+import { UiValidationRule } from '../../types/validation.types';
+import * as i0 from "@angular/core";
+/**
+
+ * Campo atomico number / currency — stesso rendering del form-builder.
+
+ *
+
+ * @selector ui-form-number-field
+
+ */
+export declare class UiFormNumberFieldComponent {
+    private readonly fieldErrorService;
+    field?: UiFormFieldDescriptor;
+    formGroup?: FormGroup;
+    readonly: boolean;
+    errors: string[] | null;
+    control?: FormControl;
+    label?: string;
+    placeholder?: string;
+    validationRules?: UiValidationRule[];
+    /** Modalità valuta standalone (equivalente a `field.metadata.type === 'currency'`). */
+    currencyMode: boolean;
+    currencySymbol: string;
+    decimalPlaces: number;
+    blurred: EventEmitter<void>;
+    get effectiveLabel(): string;
+    get effectivePlaceholder(): string;
+    get isReadonly(): boolean;
+    get isCurrency(): boolean;
+    get effectiveCurrencySymbol(): string;
+    get effectiveDecimalPlaces(): number;
+    get effectiveRules(): UiValidationRule[];
+    get fieldControl(): FormControl | null;
+    resolvedErrors(control: FormControl | null): string[];
+    onBlur(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFormNumberFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiFormNumberFieldComponent, "ui-form-number-field", never, { "field": { "alias": "field"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "errors": { "alias": "errors"; "required": false; }; "control": { "alias": "control"; "required": false; }; "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "validationRules": { "alias": "validationRules"; "required": false; }; "currencyMode": { "alias": "currencyMode"; "required": false; }; "currencySymbol": { "alias": "currencySymbol"; "required": false; }; "decimalPlaces": { "alias": "decimalPlaces"; "required": false; }; }, { "blurred": "blurred"; }, never, never, true, never>;
+}