@gnggln/ng-ui-system 1.0.0-alpha.18 → 1.0.0-alpha.19

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

@@ -1,20 +1,11 @@
 import { EventEmitter, OnInit, OnChanges, OnDestroy, SimpleChanges, AfterViewInit, TemplateRef } from '@angular/core';
-import { FormGroup, FormControl, FormArray, FormGroupDirective, NgForm } from '@angular/forms';
-import { ErrorStateMatcher } from '@angular/material/core';
+import { FormGroup, FormControl, FormArray } from '@angular/forms';
 import { UiAccordionDescriptor } from '../accordion/index';
 import { UiButtonDescriptor } from '../../components/button/index';
 import { UiFormSchema, UiFormSection, UiFormData, UiFormCustomEvent } from './types/schema.types';
 import { UiFormFieldDescriptor, UiFieldOption, UiCustomFieldTemplateContext } from './types/field.types';
 import { UiFormValidationState, UiFormErrorDetail } from './types/validation.types';
 import * as i0 from "@angular/core";
-/**
- * ErrorStateMatcher custom per il form builder.
- * Mostra lo stato di errore quando il campo e invalido E (touched OPPURE dirty).
- * Sostituisce il matcher di default di Angular Material.
- */
-export declare class UiFormErrorStateMatcher implements ErrorStateMatcher {
-    isErrorState(control: FormControl | null, form: FormGroupDirective | NgForm | null): boolean;
-}
 /**
  * Form builder data-driven e schema-based.
  *
@@ -40,6 +31,7 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
     private readonly elRef;
     private readonly conditionService;
     private readonly validationService;
+    private readonly fieldErrorService;
     /** @internal Optional BlackBox service — auto-tracks form events when available. */
     private readonly blackbox;
     /** @internal Router inject for BlackBox route context. */
@@ -277,13 +269,6 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
         max: number;
     } | null;
     private isObservable;
-    /**
-     * Normalizza la chiave del tipo di validazione dallo schema (camelCase)
-     * alla chiave di errore usata da Angular (lowercase).
-     * Es: "minLength" -> "minlength", "maxLength" -> "maxlength".
-     */
-    private normalizeValidationKey;
-    private getDefaultErrorMessage;
     getRepeatableAddButtons(section: UiFormSection): UiButtonDescriptor[];
     static ɵfac: i0.ɵɵFactoryDeclaration<UiFormBuilderComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UiFormBuilderComponent, "ui-form-builder", never, { "schema": { "alias": "schema"; "required": false; }; "initialData": { "alias": "initialData"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "buttonsOverride": { "alias": "buttonsOverride"; "required": false; }; "loadingFor": { "alias": "loadingFor"; "required": false; }; "customFieldTemplates": { "alias": "customFieldTemplates"; "required": false; }; "customFieldTemplateFallback": { "alias": "customFieldTemplateFallback"; "required": false; }; }, { "valueChange": "valueChange"; "validationChange": "validationChange"; "formSubmit": "formSubmit"; "formReset": "formReset"; "customEvent": "customEvent"; }, never, never, true, never>;

package/crud-table/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/crud-table/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/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,2 @@
+export { UiFormTextFieldComponent } from './form-text-field.component';
+export { UiFormTextareaFieldComponent } from './form-textarea-field.component';