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

package/crud-table/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/crud-table/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/crud-table/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/crud-table/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/crud-table/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/crud-table/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/crud-table/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/crud-table/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/crud-table/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/crud-table/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/crud-table/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/crud-table/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 {};