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

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

@@ -1,12 +1,50 @@
-import { EventEmitter, OnInit, OnDestroy } from '@angular/core';
+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
  *
@@ -23,6 +61,7 @@ import * as i0 from "@angular/core";
 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). */
@@ -39,6 +78,10 @@ export declare class UiFormWizardComponent implements OnInit, OnDestroy {
     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<{
@@ -50,8 +93,11 @@ export declare class UiFormWizardComponent implements OnInit, OnDestroy {
     validationChange: EventEmitter<UiFormValidationState>;
     customEvent: EventEmitter<UiFormCustomEvent>;
     state: UiWizardState;
-    /** Step ordinati per stepNumber. */
-    wizardSteps: UiFormSection[];
+    /**
+     * 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;
     /**
@@ -66,12 +112,36 @@ export declare class UiFormWizardComponent implements OnInit, OnDestroy {
     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. */
@@ -80,8 +150,23 @@ export declare class UiFormWizardComponent implements OnInit, OnDestroy {
     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; }; }, { "stepChange": "stepChange"; "stepComplete": "stepComplete"; "stepValidationFailed": "stepValidationFailed"; "wizardComplete": "wizardComplete"; "valueChange": "valueChange"; "validationChange": "validationChange"; "customEvent": "customEvent"; }, never, never, true, 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/lib/components/form-builder/index.d.ts

@@ -1,13 +1,19 @@
-export { UiFormBuilderComponent, UiFormErrorStateMatcher } from './form-builder.component';
+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/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/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/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/lib/components/form-builder/sub-components/error-summary/form-error-summary.component.d.ts

@@ -2,11 +2,10 @@ import { EventEmitter } from '@angular/core';
 import { UiFormErrorDetail } from '../../types/validation.types';
 import * as i0 from "@angular/core";
 /**
- * Componente per il riepilogo errori del form.
+ * Riepilogo stato validazione del form.
  *
- * Mostra un indicatore con il conteggio degli errori e un dropdown
- * con il dettaglio per campo. Click su un errore emette `fieldClick`
- * per consentire lo scroll-to-field con highlight nel form builder.
+ * 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
  */
@@ -15,14 +14,18 @@ export declare class UiFormErrorSummaryComponent {
     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. */
+    /** @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; }; }, { "fieldClick": "fieldClick"; }, never, never, true, 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/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>;
+}

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

@@ -0,0 +1,45 @@
+import { EventEmitter } from '@angular/core';
+import { FormControl, FormGroup } from '@angular/forms';
+import { UiFieldErrorDisplayOptions } from '../../services/form-field-error.service';
+import { UiFieldOption, UiFormFieldDescriptor } from '../../types/field.types';
+import { UiValidationRule } from '../../types/validation.types';
+import * as i0 from "@angular/core";
+/**
+
+ * Campo atomico radio group — stesso rendering del form-builder.
+
+ *
+
+ * @selector ui-form-radio-field
+
+ */
+export declare class UiFormRadioFieldComponent {
+    private readonly fieldErrorService;
+    field?: UiFormFieldDescriptor;
+    formGroup?: FormGroup;
+    readonly: boolean;
+    errors: string[] | null;
+    options: UiFieldOption[];
+    /** Indica asterisco obbligatorio (builder: `isFieldRequired`). */
+    required: boolean;
+    /** Override visibilità errori; se null deriva dal controllo. */
+    showErrors: boolean | null;
+    errorDisplayOptions: UiFieldErrorDisplayOptions;
+    control?: FormControl;
+    label?: string;
+    validationRules?: UiValidationRule[];
+    color: 'primary' | 'accent' | 'warn';
+    blurred: EventEmitter<void>;
+    get effectiveLabel(): string;
+    get isDisabled(): boolean;
+    get effectiveOptions(): UiFieldOption[];
+    get effectiveColor(): 'primary' | 'accent' | 'warn';
+    get effectiveRules(): UiValidationRule[];
+    get showRequiredMarker(): boolean;
+    get fieldControl(): FormControl | null;
+    resolvedErrors(control: FormControl | null): string[];
+    shouldShowErrors(control: FormControl | null): boolean;
+    onBlur(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFormRadioFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiFormRadioFieldComponent, "ui-form-radio-field", never, { "field": { "alias": "field"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "errors": { "alias": "errors"; "required": false; }; "options": { "alias": "options"; "required": false; }; "required": { "alias": "required"; "required": false; }; "showErrors": { "alias": "showErrors"; "required": false; }; "errorDisplayOptions": { "alias": "errorDisplayOptions"; "required": false; }; "control": { "alias": "control"; "required": false; }; "label": { "alias": "label"; "required": false; }; "validationRules": { "alias": "validationRules"; "required": false; }; "color": { "alias": "color"; "required": false; }; }, { "blurred": "blurred"; }, never, never, true, never>;
+}

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

@@ -0,0 +1,44 @@
+import { EventEmitter } from '@angular/core';
+import { FormControl, FormGroup } from '@angular/forms';
+import { UiFieldOption, UiFormFieldDescriptor } from '../../types/field.types';
+import { UiValidationRule } from '../../types/validation.types';
+import * as i0 from "@angular/core";
+/**
+
+ * Campo atomico select (mat-select o autocomplete searchable).
+
+ *
+
+ * @selector ui-form-select-field
+
+ */
+export declare class UiFormSelectFieldComponent {
+    private readonly fieldErrorService;
+    field?: UiFormFieldDescriptor;
+    formGroup?: FormGroup;
+    readonly: boolean;
+    errors: string[] | null;
+    options: UiFieldOption[];
+    control?: FormControl;
+    label?: string;
+    placeholder?: string;
+    searchable: boolean;
+    hideEmptyOption: boolean;
+    validationRules?: UiValidationRule[];
+    optionsFilter: EventEmitter<string>;
+    blurred: EventEmitter<void>;
+    get effectiveLabel(): string;
+    get effectivePlaceholder(): string;
+    get isReadonly(): boolean;
+    get isSearchable(): boolean;
+    get showEmptyOption(): boolean;
+    get effectiveOptions(): UiFieldOption[];
+    get effectiveRules(): UiValidationRule[];
+    get fieldControl(): FormControl | null;
+    resolvedErrors(control: FormControl | null): string[];
+    displayWith: (value: unknown) => string;
+    onInput(query: string): void;
+    onBlur(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFormSelectFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiFormSelectFieldComponent, "ui-form-select-field", never, { "field": { "alias": "field"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "errors": { "alias": "errors"; "required": false; }; "options": { "alias": "options"; "required": false; }; "control": { "alias": "control"; "required": false; }; "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "hideEmptyOption": { "alias": "hideEmptyOption"; "required": false; }; "validationRules": { "alias": "validationRules"; "required": false; }; }, { "optionsFilter": "optionsFilter"; "blurred": "blurred"; }, never, never, true, never>;
+}

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

@@ -0,0 +1,62 @@
+import { EventEmitter } from '@angular/core';
+import { FormControl, FormGroup } from '@angular/forms';
+import { UiFormFieldDescriptor, UiFieldOption } from '../../types/field.types';
+import { UiValidationRule } from '../../types/validation.types';
+import * as i0 from "@angular/core";
+/**
+ * Campo atomico text / email / password — stesso rendering del form-builder.
+ * Modalità builder: `field` + `formGroup`. Modalità standalone: `control` + `label`.
+ *
+ * @selector ui-form-text-field
+ */
+export declare class UiFormTextFieldComponent {
+    private readonly fieldErrorService;
+    /** Descriptor schema (modalità builder). */
+    field?: UiFormFieldDescriptor;
+    /** FormGroup dell'istanza (modalità builder). */
+    formGroup?: FormGroup;
+    /** Readonly globale dal form-builder. */
+    readonly: boolean;
+    /** Errori pre-calcolati dal builder; se null, derivati dal controllo. */
+    errors: string[] | null;
+    /** Control diretto (modalità standalone / CVA). */
+    control?: FormControl;
+    label?: string;
+    placeholder?: string;
+    maxLength?: number;
+    inputType: 'text' | 'email' | 'password';
+    validationRules?: UiValidationRule[];
+    /** Opzioni autocomplete (campo text searchable nel builder). */
+    options: UiFieldOption[];
+    optionsFilter: EventEmitter<string>;
+    blurred: EventEmitter<void>;
+    /** True se il campo schema è text searchable. */
+    get isSearchableText(): boolean;
+    /** Etichetta effettiva. */
+    get effectiveLabel(): string;
+    /** Placeholder effettivo. */
+    get effectivePlaceholder(): string;
+    /** Tipo input HTML nativo. */
+    get nativeInputType(): string;
+    /** Readonly effettivo sul campo. */
+    get isReadonly(): boolean;
+    /** Controllo risolto per modalità standalone. */
+    get resolvedControl(): FormControl | null;
+    /** Regole validation per messaggi errore. */
+    get effectiveRules(): UiValidationRule[];
+    /** Max length da regole o input. */
+    get effectiveMaxLength(): number | undefined;
+    /** Controllo del campo in modalità builder. */
+    get fieldControl(): FormControl | null;
+    /** Messaggi errore da mostrare in mat-error. */
+    resolvedErrors(control: FormControl | null): string[];
+    /** Conteggio caratteri (solo text con maxLength). */
+    charCount(control: FormControl | null): {
+        current: number;
+        max: number;
+    } | null;
+    onInput(query: string): void;
+    onBlur(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFormTextFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiFormTextFieldComponent, "ui-form-text-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; }; "maxLength": { "alias": "maxLength"; "required": false; }; "inputType": { "alias": "inputType"; "required": false; }; "validationRules": { "alias": "validationRules"; "required": false; }; "options": { "alias": "options"; "required": false; }; }, { "optionsFilter": "optionsFilter"; "blurred": "blurred"; }, never, never, true, never>;
+}

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

@@ -0,0 +1,39 @@
+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 textarea — stesso rendering del form-builder.
+ *
+ * @selector ui-form-textarea-field
+ */
+export declare class UiFormTextareaFieldComponent {
+    private readonly fieldErrorService;
+    field?: UiFormFieldDescriptor;
+    formGroup?: FormGroup;
+    readonly: boolean;
+    errors: string[] | null;
+    control?: FormControl;
+    label?: string;
+    placeholder?: string;
+    rows: number;
+    maxLength?: number;
+    validationRules?: UiValidationRule[];
+    blurred: EventEmitter<void>;
+    get effectiveLabel(): string;
+    get effectivePlaceholder(): string;
+    get isReadonly(): boolean;
+    get effectiveRules(): UiValidationRule[];
+    /** Controllo del campo in modalità builder. */
+    get fieldControl(): FormControl | null;
+    get effectiveMaxLength(): number | undefined;
+    resolvedErrors(control: FormControl | null): string[];
+    charCount(control: FormControl | null): {
+        current: number;
+        max: number;
+    } | null;
+    onBlur(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiFormTextareaFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiFormTextareaFieldComponent, "ui-form-textarea-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; }; "rows": { "alias": "rows"; "required": false; }; "maxLength": { "alias": "maxLength"; "required": false; }; "validationRules": { "alias": "validationRules"; "required": false; }; }, { "blurred": "blurred"; }, never, never, true, never>;
+}

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

@@ -0,0 +1,5 @@
+export { UiFormTextFieldComponent } from './form-text-field.component';
+export { UiFormTextareaFieldComponent } from './form-textarea-field.component';
+export { UiFormNumberFieldComponent } from './form-number-field.component';
+export { UiFormSelectFieldComponent } from './form-select-field.component';
+export { UiFormRadioFieldComponent } from './form-radio-field.component';

package/lib/components/form-builder/sub-components/location-geocoded/location-geocoded.component.d.ts

@@ -0,0 +1,84 @@
+import { OnInit } from '@angular/core';
+import { ControlValueAccessor, FormControl } from '@angular/forms';
+import { MatAutocompleteSelectedEvent } from '@angular/material/autocomplete';
+import type { UiGeocodedLocationInput, UiGeocodedLocationType, UiLocationGeocodedFieldConfig } from '../../types/geocoded-location.types';
+import * as i0 from "@angular/core";
+/** Stati UI per hint e messaggi accessibili. */
+type UiGeocodedPanelState = 'idle' | 'loading' | 'results' | 'empty' | 'error';
+/**
+ * Campo indirizzo con ricerca geocodificata (Nominatim) e selezione atomica da autocomplete.
+ * Implementa `ControlValueAccessor`; il valore è {@link UiGeocodedLocationType} o `null`.
+ *
+ * L'applicazione host deve fornire `provideHttpClient()` (o `HttpClient` equivalente).
+ */
+export declare class UiLocationGeocodedComponent implements ControlValueAccessor, OnInit {
+    private readonly nominatim;
+    private readonly cdr;
+    private readonly destroyRef;
+    private readonly document;
+    /** Configurazione ricerca (URL base, debounce, limiti). */
+    config: UiLocationGeocodedFieldConfig;
+    /** Placeholder dell'input. */
+    placeholder: string;
+    /** Etichetta accessibile dell'input (se la label visibile è esterna al componente). */
+    inputAriaLabel: string;
+    /** `id` HTML dell'input (per associare la label esterna con `for`). */
+    inputId: string;
+    /** Disabilita il campo. */
+    set disabled(v: boolean);
+    get disabled(): boolean;
+    /** Input in sola lettura (testo non modificabile). */
+    readonly: boolean;
+    /** Trigger Material: serve a non trattare il blur verso il pannello come uscita senza selezione. */
+    private autoTrigger?;
+    /** Testo digitabile e label selezionata (sempre stringa, compatibile con MatAutocomplete). */
+    readonly searchControl: FormControl<string>;
+    /** Suggerimenti correnti per il pannello autocomplete. */
+    suggestions: UiGeocodedLocationType[];
+    /** Ultima query usata per evidenziare i match nel pannello. */
+    lastQueryForHighlight: string;
+    panelState: UiGeocodedPanelState;
+    private _disabled;
+    private selected;
+    /** Evita che la selezione da autocomplete venga trattata come cancellazione del valore. */
+    private selecting;
+    /** `pointerdown` sul pannello overlay (fase capture): il blur dell'input avviene prima del click; senza questo si azzera il valore. */
+    private pointerDownOnOverlay;
+    private readonly resultCache;
+    private readonly maxCacheEntries;
+    private onChange;
+    private onTouched;
+    ngOnInit(): void;
+    private pushCache;
+    onOptionSelected(event: MatAutocompleteSelectedEvent): void;
+    /**
+     * Chiusura focus sull'input: differita così `optionSelected` può aggiornare il modello prima di eventuale reset.
+     * `pointerDownOnOverlay` copre il caso blur → click sulla lista (relatedTarget spesso null).
+     */
+    onBlur(event: FocusEvent): void;
+    /** Imposta il flag prima del blur quando l'utente preme sul pannello (stesso gesto del click su `mat-option`). */
+    private onDocumentPointerDown;
+    /**
+     * Identità stabile per `@for` sui suggerimenti (evita `??` nel template e problemi di codegen).
+     */
+    trackSuggestion(opt: UiGeocodedLocationType): string;
+    /** Segmenta la label per evidenziazione accessibile (match letterale case-insensitive). */
+    highlightParts(label: string): {
+        text: string;
+        highlight: boolean;
+    }[];
+    /** Messaggio per `aria-live` in base allo stato del pannello. */
+    getStatusMessage(): string;
+    writeValue(value: UiGeocodedLocationInput | null): void;
+    registerOnChange(fn: (v: UiGeocodedLocationType | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    private syncDisabled;
+    /**
+     * Completa `territory` e gli slice `italian` / `foreign` se assenti (payload legacy o altri provider).
+     */
+    private ensureTerritory;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiLocationGeocodedComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiLocationGeocodedComponent, "ui-location-geocoded", never, { "config": { "alias": "config"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "inputAriaLabel": { "alias": "inputAriaLabel"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; }, {}, never, never, true, never>;
+}
+export {};