@gnggln/ng-ui-system 1.0.0-alpha.0

package/lib/components/form-builder/sub-components/table-territoriale/table-territoriale.component.d.ts

@@ -0,0 +1,108 @@
+import { OnInit, OnDestroy, OnChanges, SimpleChanges, ChangeDetectorRef, Injector } from '@angular/core';
+import { ControlValueAccessor, Validator, AbstractControl, ValidationErrors, NgControl } from '@angular/forms';
+import { MatTableDataSource } from '@angular/material/table';
+import { UiSpecificaTerritorialeComponent } from '../specifica-territoriale/specifica-territoriale.component';
+import { UiLocationService } from '../../services/location.service';
+import { UiButtonDescriptor } from '../../../button/index';
+import { UiLocationTableConfig, UiLocationRow } from '../../types/territoriale.types';
+import * as i0 from "@angular/core";
+/**
+ * Componente standalone per la gestione tabellare di location multiple.
+ *
+ * Permette l'inserimento, la modifica e l'eliminazione di righe
+ * territoriali (italiane o estere) tramite una tabella Material
+ * con form inline basato su `UiSpecificaTerritorialeComponent`.
+ *
+ * Implementa `ControlValueAccessor` e `Validator` per l'integrazione
+ * con Angular Reactive Forms. Il valore e un array di `UiLocationRow`.
+ *
+ * @selector ui-table-territoriale
+ *
+ * @example
+ * ```html
+ * <ui-table-territoriale
+ *   [formControl]="sedeControl"
+ *   [config]="{
+ *     tableLabel: 'Sedi operative',
+ *     subFieldConfig: { italyByDefault: true, cap: { show: true } }
+ *   }"
+ * />
+ * ```
+ */
+export declare class UiTableTerritorialeComponent implements ControlValueAccessor, Validator, OnInit, OnDestroy, OnChanges {
+    private readonly cdr;
+    private readonly injector;
+    private readonly locationService;
+    /** Configurazione della tabella. */
+    config: UiLocationTableConfig;
+    /** Stato disabilitato globale. */
+    disabled: boolean;
+    /** Righe della tabella. */
+    rows: UiLocationRow[];
+    /** DataSource Material per la tabella. */
+    dataSource: MatTableDataSource<UiLocationRow, import("@angular/material/paginator").MatPaginator>;
+    /** Modalita editing attiva. */
+    editMode: boolean;
+    /** Modalita inserimento attiva. */
+    insertMode: boolean;
+    /** Riga in modifica. */
+    editingRow: UiLocationRow | null;
+    /** Indice della riga in modifica. */
+    editingIndex: number | null;
+    /** Colonne visualizzate nella tabella. */
+    displayedColumns: string[];
+    /** Configurazione delle colonne. */
+    columnConfig: Record<string, {
+        label: string;
+        show: boolean;
+    }>;
+    /** Pulsanti per il form di inserimento/modifica. */
+    formButtons: UiButtonDescriptor[];
+    /** Pulsante per aggiungere una nuova riga. */
+    addButton: UiButtonDescriptor[];
+    /** NgControl per accedere alla validazione del form parent. */
+    ngControl: NgControl | null;
+    specificaForm: UiSpecificaTerritorialeComponent;
+    private readonly destroy$;
+    private onChange;
+    private onTouched;
+    private onValidatorChange;
+    constructor(cdr: ChangeDetectorRef, injector: Injector, locationService: UiLocationService);
+    ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    writeValue(value: UiLocationRow[] | null): void;
+    registerOnChange(fn: (value: UiLocationRow[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    validate(control: AbstractControl): ValidationErrors | null;
+    get isRequired(): boolean;
+    get hasValidationErrors(): boolean;
+    get validationErrors(): string[];
+    private initializeColumns;
+    /** Attiva la modalita inserimento. */
+    activateInsertMode(): void;
+    /** Attiva la modalita modifica per una riga. */
+    editRow(row: UiLocationRow, index: number): void;
+    /** Annulla l'operazione in corso (inserimento o modifica). */
+    cancelEdit(): void;
+    /** Rimuove una riga dalla tabella. */
+    removeRow(index: number): void;
+    /** Salva la riga corrente (nuova o in modifica). */
+    saveRow(): Promise<void>;
+    /** Marca il componente come touched. */
+    markAsTouched(): void;
+    /** Resetta lo stato del componente. */
+    resetComponentState(): void;
+    /** Funzione track by per la tabella. */
+    trackByFn(_index: number, item: UiLocationRow): string;
+    private mapRowToFormValue;
+    private mapFormValueToRow;
+    private propagateChange;
+    private generateUUID;
+    private calculateActions;
+    private calculateFormButtons;
+    private calculateAddButton;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiTableTerritorialeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiTableTerritorialeComponent, "ui-table-territoriale", never, { "config": { "alias": "config"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/form-builder/types/condition.types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @module ng-ui-system/form-builder
+ * Tipi per il sistema di condizioni (visibilita, required, disable).
+ */
+/**
+ * Operatori di confronto supportati dal sistema di condizioni.
+ *
+ * | Operatore        | Descrizione                                |
+ * |------------------|--------------------------------------------|
+ * | `equals`         | Uguale a `value`                           |
+ * | `not_equals`     | Diverso da `value`                         |
+ * | `contains`       | La stringa contiene `value`                |
+ * | `not_contains`   | La stringa non contiene `value`            |
+ * | `greater_than`   | Maggiore di `value` (numerico)             |
+ * | `less_than`      | Minore di `value` (numerico)               |
+ * | `greater_equal`  | Maggiore o uguale a `value`                |
+ * | `less_equal`     | Minore o uguale a `value`                  |
+ * | `is_empty`       | Il campo e vuoto/null/undefined            |
+ * | `is_not_empty`   | Il campo ha un valore non vuoto            |
+ * | `in_array`       | Il valore e presente nell'array `value`    |
+ * | `not_in_array`   | Il valore non e presente nell'array `value`|
+ */
+export type UiConditionalOperator = 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'greater_than' | 'less_than' | 'greater_equal' | 'less_equal' | 'is_empty' | 'is_not_empty' | 'in_array' | 'not_in_array';
+/**
+ * Condizione per il rendering condizionale dei campi.
+ *
+ * Piu condizioni possono essere combinate con logica AND/OR.
+ * Default: AND (tutte le condizioni devono essere vere).
+ *
+ * @example
+ * ```typescript
+ * // Campo visibile solo se 'tipo' == 'persona-fisica'
+ * conditions: [{ field: 'tipo', operator: 'equals', value: 'persona-fisica' }]
+ *
+ * // Combinazione AND/OR
+ * conditions: [
+ *   { field: 'stato', operator: 'equals', value: 'attivo', logic: 'AND' },
+ *   { field: 'ruolo', operator: 'in_array', value: ['admin', 'editor'] },
+ * ]
+ * ```
+ */
+export interface UiFieldCondition {
+    /** Chiave del campo da valutare. Supporta dot notation (es. `'address.city'`). */
+    field: string;
+    /** Operatore di confronto. */
+    operator: UiConditionalOperator;
+    /** Valore di confronto (opzionale per `is_empty`/`is_not_empty`). */
+    value?: any;
+    /** Logica di combinazione con le altre condizioni. @default 'AND' */
+    logic?: 'AND' | 'OR';
+}

package/lib/components/form-builder/types/field.types.d.ts

@@ -0,0 +1,288 @@
+/**
+ * @module ng-ui-system/form-builder
+ * Tipi relativi ai campi del form builder.
+ */
+import { Observable } from 'rxjs';
+import { UiIconName } from '../../../core/types';
+export { UiIconName };
+/**
+ * Tipi di campo supportati dal form builder.
+ *
+ * | Tipo              | Descrizione                                       |
+ * |-------------------|---------------------------------------------------|
+ * | `text`            | Input testuale generico                           |
+ * | `email`           | Input email con validazione formato               |
+ * | `password`        | Input password con oscuramento                    |
+ * | `number`          | Input numerico (supporta currency directive)       |
+ * | `textarea`        | Area di testo multi-riga                          |
+ * | `select`          | Select singola (con autocomplete opzionale)        |
+ * | `multiselect`     | Select multipla con chips e autocomplete           |
+ * | `freemultiselect` | Multiselect a testo libero con chips               |
+ * | `checkbox`        | Checkbox (puo renderizzare come switch)            |
+ * | `switch`          | Toggle switch (mat-slide-toggle)                   |
+ * | `radio`           | Gruppo radio button (supporta icone)               |
+ * | `date`            | Date picker (supporta vista mese/anno)             |
+ * | `datetime`        | Date e time picker combinato                       |
+ * | `file`            | Upload file con drag & drop e preview              |
+ * | `divider`         | Separatore visuale (nessun valore nel form)        |
+ * | `flag`            | Campo nascosto per logica interna (sempre readonly)|
+ * | `custom`          | Extension point per componenti custom              |
+ * | `location`        | Selezione territorio (nazione/provincia/comune/CAP)|
+ * | `location-table`  | Tabella CRUD di location multiple                  |
+ */
+export type UiFieldType = 'text' | 'email' | 'password' | 'number' | 'textarea' | 'select' | 'multiselect' | 'freemultiselect' | 'checkbox' | 'switch' | 'radio' | 'date' | 'datetime' | 'file' | 'divider' | 'flag' | 'custom' | 'location' | 'location-table';
+/**
+ * Singola opzione per campi select, radio, multiselect.
+ */
+export interface UiFieldOption {
+    /** Valore dell'opzione (chiave logica). */
+    value: any;
+    /** Etichetta visualizzata all'utente. */
+    label: string;
+    /** Disabilita l'opzione nella lista. */
+    disabled?: boolean;
+    /** Metadati aggiuntivi associati all'opzione. */
+    metadata?: Record<string, any>;
+    /** Icona Lucide da mostrare accanto alla label. */
+    icon?: UiIconName;
+    /** Tooltip al passaggio del mouse. */
+    tooltip?: string;
+}
+/**
+ * Generazione dinamica di opzioni.
+ * Supporta generatori predefiniti (es. range anni) o funzioni custom.
+ *
+ * @example
+ * ```typescript
+ * // Range anni dall'anno corrente a 5 anni fa
+ * dynamicOptions: { type: 'year-range', minYear: 2020, maxYear: 2026 }
+ *
+ * // Generatore custom
+ * dynamicOptions: { type: 'custom', generator: (formData) => [...] }
+ * ```
+ */
+export interface UiDynamicOptionsConfig {
+    /** Tipo di generazione. */
+    type: 'year-range' | 'custom';
+    /** Anno minimo (per `year-range`). */
+    minYear?: number;
+    /** Anno massimo (per `year-range`, default: anno corrente). */
+    maxYear?: number;
+    /** Funzione custom per generare le opzioni. */
+    generator?: (formData: Record<string, any>) => UiFieldOption[];
+}
+/**
+ * Filtraggio opzioni basato sul valore di un altro campo.
+ *
+ * @example
+ * ```typescript
+ * // Mostra solo anni >= dell'anno selezionato in 'anno-inizio'
+ * dependentOptions: {
+ *   dependsOn: 'anno-inizio',
+ *   filterType: 'greater_equal',
+ * }
+ * ```
+ */
+export interface UiDependentOptionsConfig {
+    /** Chiave del campo da cui dipendono le opzioni. */
+    dependsOn: string;
+    /** Tipo di filtro predefinito da applicare. */
+    filterType: 'greater_than' | 'greater_equal' | 'less_than' | 'less_equal' | 'equals' | 'not_equals' | 'custom';
+    /** Funzione custom per filtrare le opzioni. */
+    filterFn?: (option: UiFieldOption, dependentValue: any, formData: Record<string, any>) => boolean;
+    /** Messaggio mostrato se nessuna opzione disponibile dopo il filtro. */
+    noOptionsMessage?: string;
+    /** Se `true`, disabilita le opzioni filtrate invece di nasconderle. */
+    disableInsteadOfHide?: boolean;
+}
+/**
+ * Configurazione per tooltip con icona affiancata al campo.
+ */
+export interface UiIconTooltip {
+    /** Testo visualizzato nel tooltip. */
+    text: string;
+    /** Icona Lucide da mostrare. @default 'info' */
+    icon?: UiIconName;
+    /** Classe CSS aggiuntiva per il tooltip. */
+    tooltipClass?: string;
+}
+/**
+ * Dati di un singolo file gestito dal componente file input.
+ */
+export interface UiFileData {
+    /** Nome del file. */
+    filename: string;
+    /** Contenuto del file come byte array. */
+    content: Uint8Array;
+    /** Tipo MIME del file. */
+    mimeType: string;
+    /** Estensione del file (es. `pdf`, `jpg`). */
+    extension: string;
+    /** Dimensione del file in bytes. */
+    size: number;
+    /** Flag che indica se il file deve essere ancora caricato. */
+    needsUpload: boolean;
+    /** ID univoco per tracciamento interno. */
+    id?: string;
+    /** URL per l'anteprima (immagini/PDF). */
+    previewUrl?: string;
+    /** Timestamp di creazione/modifica. */
+    timestamp?: Date;
+    /** ID del file sul server (per file gia caricati). */
+    serverFileId?: number;
+    /** Path del file sul server (per file gia caricati). */
+    serverPath?: string;
+}
+/**
+ * Configurazione per il campo file input.
+ */
+export interface UiFileInputConfig {
+    /** Dimensione massima per singolo file in bytes. */
+    maxFileSize?: number;
+    /** Tipi MIME accettati (es. `['application/pdf', 'image/*']`). */
+    acceptedTypes?: string[];
+    /** Numero massimo di file caricabili. */
+    maxFiles?: number;
+    /** Abilita selezione multipla. */
+    multiple?: boolean;
+    /** Mostra anteprime per immagini e PDF. */
+    showPreview?: boolean;
+    /** Abilita drag & drop. @default true */
+    enableDragDrop?: boolean;
+    /** Testo placeholder quando nessun file e selezionato. */
+    placeholder?: string;
+    /** Testo mostrato nell'area drag & drop. */
+    dragDropText?: string;
+}
+/**
+ * Configurazione per componenti custom iniettati nel form.
+ * Permette di estendere il form builder con componenti applicativi.
+ *
+ * @example
+ * ```typescript
+ * customConfig: {
+ *   component: 'my-location-picker',
+ *   config: { showMap: true, zoom: 12 },
+ * }
+ * ```
+ */
+export interface UiCustomComponentConfig {
+    /** Selettore del componente. */
+    component: string;
+    /** Input da passare al componente. */
+    inputs?: Record<string, any>;
+    /** Output da ascoltare dal componente. */
+    outputs?: Record<string, string>;
+    /** Configurazione specifica del componente. */
+    config?: Record<string, any>;
+}
+/**
+ * Interfaccia che i componenti custom devono implementare
+ * per integrarsi con il form builder.
+ */
+export interface UiCustomFormComponent {
+    /** Valore corrente del componente. */
+    value: any;
+    /** Stato disabilitato. */
+    disabled: boolean;
+    /** Configurazione ricevuta dal descriptor. */
+    config: Record<string, any>;
+    /** Callback per notificare cambiamenti di valore. */
+    onChange: (value: any) => void;
+    /** Callback per emettere eventi custom. */
+    onEvent: (event: string, data: any) => void;
+}
+/**
+ * Descrittore completo di un campo del form.
+ *
+ * Definisce tipo, label, validazione, condizioni di visibilita,
+ * opzioni per select/radio e ogni altra configurazione necessaria
+ * per il rendering e la logica del campo.
+ *
+ * @example
+ * ```typescript
+ * const field: UiFormFieldDescriptor = {
+ *   key: 'email',
+ *   type: 'email',
+ *   label: 'Indirizzo email',
+ *   placeholder: 'nome@esempio.it',
+ *   required: true,
+ *   validation: [
+ *     { type: 'required', message: 'Campo obbligatorio' },
+ *     { type: 'email', message: 'Formato email non valido' },
+ *   ],
+ * };
+ * ```
+ */
+export interface UiFormFieldDescriptor {
+    /** Chiave univoca del campo nel FormGroup. */
+    key: string;
+    /** Tipo di campo da renderizzare. */
+    type: UiFieldType;
+    /** Etichetta visualizzata sopra/accanto al campo. */
+    label: string;
+    /** Testo placeholder. */
+    placeholder?: string;
+    /** Tooltip testuale per il campo. */
+    tooltip?: string;
+    /** Configurazione tooltip con icona. */
+    iconTooltip?: UiIconTooltip;
+    /** Valore di default. */
+    defaultValue?: any;
+    /** Se il campo e obbligatorio (shortcut per validazione `required`). */
+    required?: boolean;
+    /** Se il campo e disabilitato. */
+    disabled?: boolean;
+    /** Se il campo e in sola lettura. */
+    readonly?: boolean;
+    /** Regole di validazione. @see UiValidationRule */
+    validation?: import('./validation.types').UiValidationRule[];
+    /** Opzioni statiche o osservabili. */
+    options?: UiFieldOption[] | Observable<UiFieldOption[]>;
+    /** Nasconde l'opzione vuota iniziale nelle select. */
+    hideEmptyOption?: boolean;
+    /** Trasforma la select in autocomplete con ricerca. */
+    searchable?: boolean;
+    /** Mostra pulsante "Seleziona tutto" per multiselect. */
+    allowSelectAll?: boolean;
+    /** Callback per recupero asincrono di opzioni filtrate per query. */
+    asyncOptions?: (query: string) => Promise<UiFieldOption[]>;
+    /** Callback per recupero asincrono di opzioni per ID (prevalorizzazione). */
+    recoverAsyncValues?: (ids: any[]) => Promise<UiFieldOption[]>;
+    /** Generazione dinamica di opzioni. */
+    dynamicOptions?: UiDynamicOptionsConfig;
+    /** Filtraggio opzioni dipendente da altro campo. */
+    dependentOptions?: UiDependentOptionsConfig;
+    /** Condizioni per la visibilita del campo. */
+    conditions?: import('./condition.types').UiFieldCondition[];
+    /** Condizioni per disabilitare il campo. */
+    disableConditions?: import('./condition.types').UiFieldCondition[];
+    /** Congela il valore quando il campo viene disabilitato da `disableConditions`. */
+    freezeValueOnDisable?: boolean;
+    /** Configurazione per componenti custom. */
+    customConfig?: UiCustomComponentConfig;
+    /** Configurazione per il campo file. */
+    fileConfig?: UiFileInputConfig;
+    /** Configurazione aspetto del campo. */
+    appearance?: {
+        /** Per checkbox: 'switch' rende il campo come mat-slide-toggle. */
+        style?: 'default' | 'switch';
+        /** Colore del componente. */
+        color?: 'primary' | 'accent' | 'warn';
+    };
+    /** Classi CSS aggiuntive sul wrapper del campo. */
+    cssClasses?: string[];
+    /** Attributi HTML aggiuntivi. */
+    attributes?: Record<string, any>;
+    /** Metadati arbitrari (chips protetti, configurazioni extra, etc.). */
+    metadata?: Record<string, any>;
+    /** Configurazione layout del campo nel grid. */
+    layout?: {
+        /** Numero di colonne che il campo occupa (default: dipende dal tipo). */
+        columns?: number;
+        /** Ordine nel grid. */
+        order?: number;
+        /** Override colonne per breakpoint (`{ md: 6, lg: 4 }`). */
+        breakpoints?: Record<string, number>;
+    };
+}

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

@@ -0,0 +1,5 @@
+export { UiFieldType, UiFieldOption, UiDynamicOptionsConfig, UiDependentOptionsConfig, UiIconTooltip, UiFileData, UiFileInputConfig, UiCustomComponentConfig, UiCustomFormComponent, UiFormFieldDescriptor, } from './field.types';
+export { UiCrossFieldOperator, UiCrossFieldConfig, UiDateKeyword, UiDateValidationConfig, UiValidationType, UiValidationRule, UiFormValidationState, UiFormErrorDetail, } from './validation.types';
+export { UiConditionalOperator, UiFieldCondition, } from './condition.types';
+export { UiLocationFieldConfig, UiLocationConfig, UiLocationLabels, UiLocationValue, UiLocationTableConfig, UiLocationRow, } from './territoriale.types';
+export { UiWizardStepValidation, UiWizardValidationFn, UiWizardStepConfig, UiFormSection, UiFormBuilderConfig, UiWizardConfig, UiWizardState, UiFormSchema, UiFormData, UiFormCustomEvent, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, } from './schema.types';

package/lib/components/form-builder/types/schema.types.d.ts

@@ -0,0 +1,227 @@
+/**
+ * @module ng-ui-system/form-builder
+ * Tipi per lo schema del form, sezioni e configurazione.
+ */
+import { UiFormFieldDescriptor } from './field.types';
+import { UiFieldCondition } from './condition.types';
+/**
+ * Configurazione di validazione per un singolo step del wizard.
+ */
+export interface UiWizardStepValidation {
+    /** Se lo step richiede validazione prima di procedere. @default true */
+    required?: boolean;
+    /** Campi specifici da validare in questo step (se omesso, tutti i campi dello step). */
+    validateFields?: string[];
+    /** Se validare anche i componenti custom nello step. @default true */
+    validateCustomComponents?: boolean;
+}
+/**
+ * Funzione di validazione custom per uno step del wizard.
+ * Viene invocata prima della navigazione allo step successivo.
+ *
+ * @param formData - Dati correnti del form completo.
+ * @param currentStep - Indice dello step corrente (0-based).
+ * @param isValid - Risultato della validazione standard del form.
+ * @returns `true` per permettere la navigazione, `false` per bloccarla.
+ */
+export type UiWizardValidationFn = (formData: Record<string, any>, currentStep: number, isValid: boolean) => Promise<boolean> | boolean;
+/**
+ * Configurazione wizard per una sezione del form.
+ */
+export interface UiWizardStepConfig {
+    /** Numero dello step (1-based per UI, convertito a 0-based internamente). */
+    stepNumber: number;
+    /** Titolo personalizzato per lo step. */
+    stepTitle?: string;
+    /** Descrizione dello step. */
+    stepDescription?: string;
+    /** Configurazione di validazione per questo step. */
+    validation?: UiWizardStepValidation;
+    /** Permette di saltare questo step senza validazione. */
+    allowSkip?: boolean;
+    /** Nome del metodo di validazione custom (deve essere registrato nel wizard). */
+    customValidationFn?: string;
+    /** Metadati aggiuntivi per lo step. */
+    metadata?: Record<string, any>;
+}
+/**
+ * Sezione del form che raggruppa campi correlati.
+ * Supporta collapsibilita (accordion), condizioni di visibilita
+ * e configurazione wizard opzionale.
+ *
+ * @example
+ * ```typescript
+ * const section: UiFormSection = {
+ *   id: 'anagrafica',
+ *   title: 'Dati anagrafici',
+ *   description: 'Informazioni personali del candidato',
+ *   collapsible: true,
+ *   fields: [ ... ],
+ * };
+ * ```
+ */
+export interface UiFormSection {
+    /** ID univoco della sezione. */
+    id: string;
+    /** Titolo della sezione. */
+    title?: string;
+    /** Descrizione della sezione. */
+    description?: string;
+    /** Campi contenuti nella sezione. */
+    fields: UiFormFieldDescriptor[];
+    /** Condizioni per la visibilita della sezione. */
+    conditions?: UiFieldCondition[];
+    /** Se la sezione e collassabile (accordion). */
+    collapsible?: boolean;
+    /** Se la sezione e inizialmente collassata. @default false */
+    collapsed?: boolean;
+    /** Classi CSS aggiuntive per la sezione. */
+    cssClasses?: string[];
+    /** Configurazione wizard per questa sezione. */
+    wizardStep?: UiWizardStepConfig;
+}
+/**
+ * Configurazione globale del form builder.
+ */
+export interface UiFormBuilderConfig {
+    /** Layout del form. @default 'grid' */
+    layout?: 'vertical' | 'horizontal' | 'grid';
+    /** Numero di colonne nel grid. @default 12 */
+    columns?: number;
+    /** Mostra i pulsanti di azione (submit/reset). @default true */
+    showButtons?: boolean;
+    /** Nasconde l'intero footer (pulsanti + error summary). */
+    hideFooter?: boolean;
+    /** Label personalizzate per i pulsanti. */
+    buttonLabels?: {
+        submit?: string;
+        reset?: string;
+        cancel?: string;
+    };
+    /** Classi CSS globali sul container del form. */
+    cssClasses?: string[];
+}
+/**
+ * Configurazione per la modalita wizard del form.
+ * Usata dal componente `UiFormWizardComponent`.
+ *
+ * @example
+ * ```typescript
+ * const wizardConfig: UiWizardConfig = {
+ *   showProgress: true,
+ *   progressStyle: 'steps',
+ *   allowBackNavigation: true,
+ *   buttonLabels: { next: 'Avanti', previous: 'Indietro', finish: 'Completa' },
+ * };
+ * ```
+ */
+export interface UiWizardConfig {
+    /** ID per sincronizzazione wireless tra istanze. */
+    wizardId?: string;
+    /** Nasconde l'header interno del wizard per consentire un header esterno. */
+    wirelessHeading?: boolean;
+    /** Mostra la barra di progresso. @default true */
+    showProgress?: boolean;
+    /** Stile della barra di progresso. @default 'steps' */
+    progressStyle?: 'linear' | 'steps';
+    /** Permette navigazione all'indietro. @default true */
+    allowBackNavigation?: boolean;
+    /** Permette navigazione in avanti senza validazione. @default false */
+    allowForwardNavigation?: boolean;
+    /** Salva automaticamente i dati ad ogni cambio step. */
+    autoSave?: boolean;
+    /** Callback per il salvataggio dei dati dello step. */
+    onStepSave?: (stepData: Record<string, any>, stepNumber: number) => Promise<void> | void;
+    /** Mostra pulsanti di navigazione (precedente/successivo). @default true */
+    showNavigationButtons?: boolean;
+    /** Label personalizzate per i pulsanti del wizard. */
+    buttonLabels?: {
+        previous?: string;
+        next?: string;
+        finish?: string;
+        save?: string;
+    };
+}
+/**
+ * Stato corrente del wizard, esposto dal `WizardSyncService`.
+ */
+export interface UiWizardState {
+    /** Step corrente (0-based). */
+    currentStep: number;
+    /** Numero totale di step. */
+    totalSteps: number;
+    /** Indici degli step completati. */
+    completedSteps: Set<number>;
+    /** Indici degli step visitati. */
+    visitedSteps: Set<number>;
+    /** Se il form nello step corrente e valido. */
+    isValid: boolean;
+    /** Errori per step. */
+    stepErrors: Record<number, string[]>;
+}
+/**
+ * Schema completo del form.
+ *
+ * Rappresenta la configurazione dichiarativa dell'intero form:
+ * sezioni, campi, validazioni, condizioni e impostazioni globali.
+ *
+ * @example
+ * ```typescript
+ * export const myForm: UiFormSchema = {
+ *   id: 'user-registration',
+ *   title: 'Registrazione utente',
+ *   sections: [
+ *     { id: 'personal', title: 'Dati personali', fields: [...] },
+ *     { id: 'address', title: 'Indirizzo', fields: [...], collapsible: true },
+ *   ],
+ *   config: { columns: 12, showButtons: true },
+ * };
+ * ```
+ */
+export interface UiFormSchema {
+    /** ID univoco del form. */
+    id: string;
+    /** Titolo del form. */
+    title?: string;
+    /** Descrizione del form. */
+    description?: string;
+    /** Sezioni del form. */
+    sections: UiFormSection[];
+    /** Configurazione globale. */
+    config?: UiFormBuilderConfig;
+}
+/**
+ * Dati del form come mappa chiave-valore.
+ */
+export type UiFormData = Record<string, any>;
+/**
+ * Evento emesso dai campi custom.
+ */
+export interface UiFormCustomEvent {
+    /** Chiave del campo che ha emesso l'evento. */
+    field: string;
+    /** Nome dell'evento. */
+    event: string;
+    /** Dati associati all'evento. */
+    data: any;
+}
+/**
+ * Evento emesso al cambio step del wizard.
+ */
+export interface UiWizardStepChangeEvent {
+    /** Indice dello step di partenza. */
+    from: number;
+    /** Indice dello step di destinazione. */
+    to: number;
+    /** Direzione della navigazione. */
+    direction: 'next' | 'previous';
+}
+/**
+ * Evento emesso al completamento di uno step.
+ */
+export interface UiWizardStepCompleteEvent {
+    /** Indice dello step completato. */
+    step: number;
+    /** Dati del form al momento del completamento. */
+    data: Record<string, any>;
+}