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

package/lib/components/blackbox/blackbox.types.d.ts

@@ -0,0 +1,238 @@
+/**
+ * @module ng-ui-system/blackbox
+ * Types and interfaces for the BlackBox observability service.
+ *
+ * The BlackBox service acts as a "black box recorder" for user sessions,
+ * capturing navigation, UI interactions, form events and HTTP calls
+ * in a compressed, opaque format stored in IndexedDB.
+ */
+/**
+ * Form tracking granularity flags.
+ *
+ * Controls which form events are captured by the BlackBox service.
+ * All flags default to `true` except `trackValues` which defaults to `false`
+ * for privacy reasons.
+ */
+export interface UiBlackboxFormTrackingConfig {
+    /**
+     * When `true`, the actual field values are stored in form events.
+     * When `false`, only the fact that a change occurred is recorded.
+     * @default false
+     */
+    trackValues: boolean;
+    /** Track focus events on form fields. @default true */
+    trackFocus: boolean;
+    /** Track blur events on form fields. @default true */
+    trackBlur: boolean;
+    /** Track value change events on form fields. @default true */
+    trackValueChanges: boolean;
+    /** Track validation error events on form fields. @default true */
+    trackValidation: boolean;
+    /**
+     * Debounce interval (ms) for `valueChanges` subscriptions.
+     * Higher values reduce noise but increase latency.
+     * @default 500
+     */
+    debounceMs: number;
+}
+/**
+ * Root configuration for the BlackBox service.
+ *
+ * All properties are optional — sensible defaults are applied when omitted.
+ *
+ * @example
+ * ```typescript
+ * blackboxService.configure({
+ *   maxStorageMb: 30,
+ *   formTracking: { trackValues: true, debounceMs: 1000 },
+ * });
+ * ```
+ */
+export interface UiBlackboxConfig {
+    /**
+     * Maximum IndexedDB storage quota in megabytes.
+     * Oldest sessions are pruned when the quota is exceeded.
+     * @default 50
+     */
+    maxStorageMb: number;
+    /**
+     * Interval (ms) at which the in-memory buffer is flushed to IndexedDB.
+     * @default 5000
+     */
+    flushIntervalMs: number;
+    /**
+     * Number of buffered events that trigger an immediate flush.
+     * @default 20
+     */
+    flushThreshold: number;
+    /**
+     * Centralised debounce (ms) applied to the event buffer.
+     * @default 500
+     */
+    bufferDebounceMs: number;
+    /** Per-field form tracking configuration. */
+    formTracking: UiBlackboxFormTrackingConfig;
+}
+/**
+ * Stable device/browser fingerprint generated by FingerprintJS (open-source).
+ * Persists across sessions and incognito mode.
+ */
+export type UiBlackboxFingerprint = string;
+/**
+ * A single recording session, corresponding to one browser tab lifecycle.
+ *
+ * Sessions are associated to a stable `fingerprint` so that multiple
+ * sessions from the same device can be grouped together.
+ */
+export interface UiBlackboxSession {
+    /** Unique session identifier (UUID v4). */
+    sessionId: string;
+    /** Stable device/browser fingerprint. */
+    fingerprint: UiBlackboxFingerprint;
+    /** Timestamp (ms since epoch) when the session started. */
+    startedAt: number;
+    /** Timestamp (ms since epoch) when the session ended (tab closed). */
+    endedAt?: number;
+    /** Raw `navigator.userAgent` string captured at session start. */
+    userAgent: string;
+    /**
+     * Ordered list of navigation steps (route changes).
+     * Each step contains the actions performed on that page.
+     */
+    steps: UiBlackboxStep[];
+    /**
+     * Parallel stream of form interaction events.
+     * Ordered by timestamp, correlated to routes via `route` field.
+     */
+    formEvents: UiBlackboxFormEvent[];
+    /**
+     * Intercepted HTTP calls, ordered by timestamp.
+     * Only requests explicitly marked with the `X-Ui-Blackbox` header.
+     */
+    calls: UiBlackboxHttpCall[];
+}
+/**
+ * A single navigation step created on every `NavigationEnd` event.
+ * Contains all UI actions performed during this route.
+ */
+export interface UiBlackboxStep {
+    /** Timestamp (ms) of the navigation event. */
+    timestamp: number;
+    /** The route URL navigated to. */
+    route: string;
+    /** The previous route URL (undefined for the first step). */
+    previousRoute?: string;
+    /**
+     * Ordered list of UI actions (clicks) performed on this page.
+     */
+    actions: UiBlackboxAction[];
+}
+/**
+ * A single tracked UI action, typically a click.
+ */
+export interface UiBlackboxAction {
+    /** Timestamp (ms) of the action. */
+    timestamp: number;
+    /** Type discriminator. Currently only `click` is supported. */
+    type: 'click';
+    /** Information about the clicked element. */
+    target: UiBlackboxActionTarget;
+}
+/**
+ * Minimal information about the element that was interacted with.
+ */
+export interface UiBlackboxActionTarget {
+    /** HTML tag name (lowercase). */
+    tag: string;
+    /** Element `id` attribute, if present. */
+    id?: string;
+    /**
+     * Custom tracking identifier, set via `data-track-id` attribute
+     * or the `[uiTrack]` directive value.
+     */
+    trackId?: string;
+    /** First 50 characters of `innerText` (trimmed). */
+    text?: string;
+}
+/** Discriminator for form event types. */
+export type UiBlackboxFormEventType = 'focus' | 'blur' | 'valueChange' | 'validationError';
+/**
+ * A single form interaction event from the parallel form stream.
+ *
+ * Each event is timestamped and tagged with the current route, allowing
+ * correlation with navigation steps on a shared timeline.
+ */
+export interface UiBlackboxFormEvent {
+    /** Timestamp (ms) of the event. */
+    timestamp: number;
+    /** Route URL where the event occurred. */
+    route: string;
+    /** Schema `id` of the `UiFormBuilderComponent` that owns the field. */
+    formId: string;
+    /** `key` of the field descriptor from the form schema. */
+    fieldKey: string;
+    /** Type of form interaction. */
+    eventType: UiBlackboxFormEventType;
+    /** Optional metadata depending on event type and config. */
+    metadata?: UiBlackboxFormEventMetadata;
+}
+/**
+ * Optional metadata attached to a `UiBlackboxFormEvent`.
+ */
+export interface UiBlackboxFormEventMetadata {
+    /** Field value (only captured when `config.formTracking.trackValues` is `true`). */
+    value?: any;
+    /** Whether the field is currently valid. */
+    valid?: boolean;
+    /** List of active validation error keys. */
+    errors?: string[];
+    /**
+     * Full form values snapshot at the moment of the event.
+     * Only captured when `config.formTracking.trackValues` is `true`.
+     */
+    formValues?: Record<string, any>;
+}
+/**
+ * A single intercepted HTTP call.
+ *
+ * Only requests bearing the `X-Ui-Blackbox` header are captured.
+ */
+export interface UiBlackboxHttpCall {
+    /** Timestamp (ms) when the request was initiated. */
+    timestamp: number;
+    /** HTTP method (GET, POST, PUT, DELETE, …). */
+    method: string;
+    /** Request URL. */
+    url: string;
+    /** HTTP status code of the response (undefined if the request failed). */
+    status?: number;
+    /** Round-trip duration in milliseconds. */
+    durationMs?: number;
+    /** Request body payload (serialisable). */
+    requestPayload?: any;
+    /** Response headers filtered by the `X-Ui-Blackbox-Headers` regex. */
+    responseHeaders?: Record<string, string>;
+    /** The regex pattern used to filter response headers. */
+    headerFilter?: string;
+}
+/**
+ * Union type for all events flowing through the centralised buffer.
+ * @internal
+ */
+export type UiBlackboxBufferEvent = {
+    kind: 'action';
+    payload: UiBlackboxAction & {
+        route: string;
+    };
+} | {
+    kind: 'formEvent';
+    payload: UiBlackboxFormEvent;
+} | {
+    kind: 'httpCall';
+    payload: UiBlackboxHttpCall;
+} | {
+    kind: 'step';
+    payload: UiBlackboxStep;
+};
+/** Default configuration values. */
+export declare const UI_BLACKBOX_DEFAULTS: UiBlackboxConfig;

package/lib/components/blackbox/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ng-ui-system — BlackBox Observability entry point.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   UiBlackboxService,
+ *   UiBlackboxConfig,
+ *   UiTrackDirective,
+ *   uiBlackboxInterceptor,
+ * } from '@gnggln/ng-ui-system';
+ * ```
+ */
+export { UiBlackboxService } from './blackbox.service';
+export { UiBlackboxFingerprintService } from './blackbox-fingerprint.service';
+export { UiBlackboxStorageService } from './blackbox-storage.service';
+export { UiBlackboxDebuggerService } from './blackbox-debugger.service';
+export { UiBlackboxDebuggerComponent } from './blackbox-debugger.component';
+export { UiBlackboxJsonViewerComponent } from './blackbox-json-viewer.component';
+export { uiBlackboxInterceptor } from './blackbox.interceptor';
+export { UiTrackDirective } from './ui-track.directive';
+export type { UiBlackboxConfig, UiBlackboxFormTrackingConfig, UiBlackboxFingerprint, UiBlackboxSession, UiBlackboxStep, UiBlackboxAction, UiBlackboxActionTarget, UiBlackboxFormEvent, UiBlackboxFormEventType, UiBlackboxFormEventMetadata, UiBlackboxHttpCall, } from './blackbox.types';
+export { UI_BLACKBOX_DEFAULTS } from './blackbox.types';

package/lib/components/blackbox/ui-track.directive.d.ts

@@ -0,0 +1,20 @@
+import * as i0 from "@angular/core";
+/**
+ * Standalone directive that tracks click actions on the host element.
+ *
+ * The tracking identifier is provided via the `uiTrack` input binding.
+ * Clicking the host element records an action in the active BlackBox session
+ * with the element's tag, id, and truncated innerText.
+ */
+export declare class UiTrackDirective {
+    /**
+     * Tracking identifier for this element.
+     * Used as the `trackId` in the recorded action.
+     */
+    trackId: string;
+    private readonly blackbox;
+    private readonly el;
+    onClick(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiTrackDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<UiTrackDirective, "[uiTrack]", never, { "trackId": { "alias": "uiTrack"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/button/button-area.component.d.ts

@@ -8,6 +8,9 @@ import * as i0 from "@angular/core";
  * Supports per-button loading/disabled states, dynamic visibility,
  * alignment control, and optional navigation via Angular Router.
  *
+ * When the `UiBlackboxService` is provided, button clicks are
+ * automatically tracked in the active session.
+ *
  * @selector ui-button-area
  *
  * @example
@@ -71,6 +74,8 @@ export declare class UiButtonAreaComponent {
     private _loadingIds;
     /** @internal Optional router for href navigation. */
     private router;
+    /** @internal Optional BlackBox service — auto-tracks button clicks when available. */
+    private blackbox;
     /** Buttons filtered to visible (non-hidden) entries. */
     get visibleButtons(): UiButtonDescriptor[];
     /** Assembled CSS class string for the button area container. */
@@ -81,7 +86,7 @@ export declare class UiButtonAreaComponent {
     isButtonLoading(button: UiButtonDescriptor): boolean;
     /** Whether a specific button is disabled (includes loading logic). */
     isButtonDisabled(button: UiButtonDescriptor): boolean;
-    /** @internal Handles button click: calls action callback and/or navigates. */
+    /** @internal Handles button click: tracks action, calls callback and/or navigates. */
     handleButtonClick(button: UiButtonDescriptor, event: MouseEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<UiButtonAreaComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UiButtonAreaComponent, "ui-button-area", never, { "buttons": { "alias": "buttons"; "required": false; }; "align": { "alias": "align"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "gap": { "alias": "gap"; "required": false; }; "stackOnMobile": { "alias": "stackOnMobile"; "required": false; }; "disableWhileLoading": { "alias": "disableWhileLoading"; "required": false; }; "loadingIds": { "alias": "loadingIds"; "required": false; }; }, {}, never, never, true, never>;

package/lib/components/button/button.component.d.ts

@@ -17,8 +17,8 @@ import * as i0 from "@angular/core";
  * <!-- Loading -->
  * <ui-button label="Submitting..." variant="primary" [loading]="true" />
  *
- * <!-- Icon-only -->
- * <ui-button icon="trash-2" variant="warn" ariaLabel="Delete item" (click)="delete()" />
+ * <!-- Icon-only: tooltip o ariaLabel forniscono il nome accessibile -->
+ * <ui-button icon="trash-2" variant="warn" tooltip="Elimina" (click)="delete()" />
  * ```
  */
 export declare class UiButtonComponent {
@@ -46,6 +46,12 @@ export declare class UiButtonComponent {
     ariaLabel?: string;
     /** Additional CSS class for edge cases. */
     customClass?: string;
+    /**
+     * Nome accessibile risolto per il pulsante nativo.
+     * Usa `ariaLabel` se impostato; per pulsanti solo icona senza testo visibile
+     * ricade sul `tooltip` (il tooltip Material non sostituisce il nome accessibile).
+     */
+    get effectiveAriaLabel(): string | undefined;
     /** Computed icon pixel size based on button size. */
     get iconSize(): number;
     /** Assembled CSS class string for the native button element. */

package/lib/components/button/button.types.d.ts

@@ -40,6 +40,11 @@ export interface UiButtonDescriptor {
     label: string;
     /** Tooltip text shown on hover. */
     tooltip?: string;
+    /**
+     * Nome accessibile esplicito (override).
+     * Per pulsanti solo icona senza `label`, se omesso si usa `tooltip` come `aria-label`.
+     */
+    ariaLabel?: string;
     /**
      * Click handler. Supports both sync and async callbacks.
      * Receives the native MouseEvent as argument.

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

@@ -1,24 +1,16 @@
-import { EventEmitter, OnInit, OnChanges, OnDestroy, SimpleChanges, AfterViewInit } from '@angular/core';
-import { FormGroup, FormControl, FormGroupDirective, NgForm } from '@angular/forms';
-import { ErrorStateMatcher } from '@angular/material/core';
+import { EventEmitter, OnInit, OnChanges, OnDestroy, SimpleChanges, AfterViewInit, TemplateRef } from '@angular/core';
+import { FormGroup, FormControl, FormArray } from '@angular/forms';
+import { UiAccordionDescriptor } from '../accordion/index';
 import { UiButtonDescriptor } from '../../components/button/index';
-import { UiFormSchema, UiFormData, UiFormCustomEvent } from './types/schema.types';
-import { UiFormFieldDescriptor, UiFieldOption } from './types/field.types';
+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.
  *
  * Genera un form completo a partire da uno schema dichiarativo (`UiFormSchema`).
- * Supporta 16 tipi di campo, validazione condizionale, cross-field validation,
+ * Supporta i tipi di campo del form builder, validazione condizionale, cross-field validation,
  * date con offset, opzioni dipendenti/dinamiche, sezioni collapsibili,
  * error summary con scroll-to-field e button override.
  *
@@ -39,8 +31,18 @@ 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. */
+    private readonly bbRouter;
+    /** @internal Optional Logger service — logs form actions when available. */
+    private readonly logger;
     private readonly destroy$;
     private valueChangeSub?;
+    /** @internal Listener cleanup for BlackBox focus/blur tracking. */
+    private bbFocusHandler;
+    private bbBlurHandler;
     /** ID schema corrente -- usato per evitare rebuild superflui. */
     private currentSchemaId;
     /** Schema del form. */
@@ -55,6 +57,16 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
     buttonsOverride?: UiButtonDescriptor[];
     /** Chiave del pulsante in stato di caricamento. */
     loadingFor: string | null;
+    /**
+     * Mappa chiave logica → template per campi `type: 'custom'`.
+     * La chiave si risolve con `customConfig.templateKey`, poi `customConfig.component`, poi `field.key`.
+     */
+    customFieldTemplates: Record<string, TemplateRef<unknown>>;
+    /**
+     * Template usato quando non esiste una voce in `customFieldTemplates` per la chiave risolta
+     * (es. un unico `ng-template` con `@switch` sul campo).
+     */
+    customFieldTemplateFallback?: TemplateRef<unknown>;
     valueChange: EventEmitter<UiFormData>;
     validationChange: EventEmitter<UiFormValidationState>;
     formSubmit: EventEmitter<UiFormData>;
@@ -69,9 +81,18 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
     private validationRulesMap;
     /** Mappa dipendenze: campoTarget -> campi dipendenti. */
     private fieldDependencies;
+    /** @internal Accordion descriptors per le sezioni collapsibili. */
+    sectionAccordionMap: Map<string, UiAccordionDescriptor[]>;
+    /** @internal Accordion descriptors per le istanze repeatable (sectionId -> descriptors). */
+    repeatableAccordionMap: Map<string, UiAccordionDescriptor[]>;
     /** Flag per evitare emissioni durante l'inizializzazione. */
     private isInitializing;
+    /** Tutti i campi di tutte le sezioni (incluse repeatable). */
     get allFields(): UiFormFieldDescriptor[];
+    /** Campi delle sole sezioni non-repeatable (piatti nel root FormGroup). */
+    get allFlatFields(): UiFormFieldDescriptor[];
+    /** Sezioni con configurazione repeatable. */
+    get repeatableSections(): UiFormSection[];
     get formErrors(): UiFormErrorDetail[];
     get formButtons(): UiButtonDescriptor[];
     ngOnInit(): void;
@@ -93,24 +114,89 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
      */
     private destroyForm;
     private buildForm;
+    /** Costruisce un FormGroup per una singola istanza di sezione repeatable. */
+    private buildInstanceFormGroup;
+    /**
+     * Sets up BlackBox form event tracking.
+     * - Focus/blur: DOM event delegation on the host element
+     * - Value changes: per-field subscriptions with debounce
+     * - Validation errors: per-field statusChanges subscriptions
+     * @internal
+     */
+    private setupBlackboxTracking;
+    /**
+     * Resolve the form field key from a focus/blur DOM event.
+     * Walks up from the event target looking for `formControlName` or `data-field-key`.
+     * @internal
+     */
+    private resolveFieldKeyFromEvent;
     private applyAllValidators;
     private evaluateAllConditions;
+    /** Valuta condizioni di visibilita/disabilitazione per un singolo campo nel contesto del FormGroup dato. */
+    private evaluateFieldConditions;
     private buildDependencyMap;
+    /**
+     * Costruisce la mappa dei descriptors accordion per le sezioni collapsibili.
+     * Ogni sezione collapsibile viene mappata a un singolo UiAccordionDescriptor.
+     * @internal
+     */
+    private buildSectionAccordionMap;
+    /**
+     * Numero di istanze repeatable da creare al build/reset:
+     * almeno `repeatable.min` (se `min > 0` o omesso default 1), mai meno delle righe in `initialData[section.id]`.
+     * Con `min: 0` non si aggiungono righe oltre a quelle già presenti nei dati iniziali.
+     */
+    private getRepeatableInitialInstanceCount;
+    /** Ricostruisce i descriptor accordion per le istanze di una sezione repeatable. */
+    private rebuildRepeatableAccordion;
     private updateDependentOptions;
-    /** Verifica se un campo e visibile. */
-    isFieldVisible(fieldKey: string): boolean;
+    /** Verifica se un campo e visibile (opzionalmente nel contesto di un FormGroup specifico). */
+    isFieldVisible(fieldKey: string, fg?: FormGroup): boolean;
     /** Verifica se un campo e obbligatorio (include validazione condizionale). */
-    isFieldRequired(fieldKey: string): boolean;
+    isFieldRequired(fieldKey: string, fg?: FormGroup): boolean;
     /** Verifica se una sezione e visibile. */
     isSectionVisible(sectionId: string): boolean;
+    /** Descriptors accordion per una sezione collapsibile. */
+    getSectionAccordionItems(sectionId: string): UiAccordionDescriptor[];
+    /** Descriptors accordion per le istanze di una sezione repeatable. */
+    getRepeatableAccordionItems(sectionId: string): UiAccordionDescriptor[];
     /** Verifica se mostrare errori per un campo. */
-    shouldShowFieldErrors(fieldKey: string): boolean;
+    shouldShowFieldErrors(fieldKey: string, fg?: FormGroup): boolean;
     /** Errori di un campo come array di messaggi. */
-    getFieldErrors(fieldKey: string): string[];
+    getFieldErrors(fieldKey: string, fg?: FormGroup): string[];
     /** Valore completo del form (include campi disabilitati). */
     getFormValue(): UiFormData;
     /** Il form e valido. */
     isFormValid(): boolean;
+    /**
+     * True se tutti i controlli sono validi, ignorando le chiavi indicate
+     * (flat e dentro ogni istanza repeatable).
+     */
+    isFormValidExcludingFieldKeys(excludedKeys: ReadonlySet<string>): boolean;
+    /**
+     * Risolve la chiave per `customFieldTemplates` (`templateKey` → `component` → `field.key`).
+     */
+    resolveCustomTemplateKey(field: UiFormFieldDescriptor): string;
+    /**
+     * Template Angular registrato per il campo custom, o fallback globale.
+     */
+    getCustomTemplateRef(field: UiFormFieldDescriptor): TemplateRef<unknown> | null;
+    /**
+     * Contesto passato a `ngTemplateOutlet` per il campo custom (CVA sul `control`).
+     */
+    getCustomFieldOutletContext(field: UiFormFieldDescriptor, fg: FormGroup, nestedErrorKeyPrefix?: string): UiCustomFieldTemplateContext;
+    /**
+     * Template e contesto in un solo oggetto (evita doppie valutazioni nel template).
+     */
+    getCustomFieldOutlet(field: UiFormFieldDescriptor, fg: FormGroup, nestedErrorKeyPrefix?: string): {
+        template: TemplateRef<unknown>;
+        context: UiCustomFieldTemplateContext;
+    } | null;
+    /** Prefisso chiavi errore per campi custom annidati (flat o repeatable). */
+    buildNestedErrorKeyPrefix(fieldKey: string, instanceKeyPrefix?: string): string;
+    /** Merge errori nested da CVA custom nel dettaglio error-summary. */
+    private appendCustomNestedFieldErrors;
+    private isFormGroupValidExcluding;
     /** Stato di validazione completo. */
     getValidationState(): UiFormValidationState;
     /** Errori dettagliati per l'error summary. */
@@ -123,8 +209,24 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
     getFieldControl(key: string): FormControl | null;
     /** Aggiorna il valore di un campo programmaticamente. */
     updateFieldValue(key: string, value: any): void;
-    /** Forza la validazione di tutti i campi. */
+    /** Forza la validazione di tutti i campi (incluse istanze repeatable). */
     validateAllFields(): void;
+    /** Restituisce il FormArray di una sezione repeatable. */
+    getRepeatableArray(sectionId: string): FormArray | null;
+    /** Restituisce il FormGroup di una specifica istanza repeatable. */
+    getInstanceFormGroup(sectionId: string, index: number): FormGroup | null;
+    /** Verifica se e possibile aggiungere nuove istanze. */
+    canAddInstance(sectionId: string): boolean;
+    /** Verifica se e possibile rimuovere istanze. */
+    canRemoveInstance(sectionId: string): boolean;
+    /** Aggiunge una nuova istanza vuota a una sezione repeatable. */
+    addRepeatableInstance(sectionId: string): void;
+    /** Rimuove un'istanza da una sezione repeatable. */
+    removeRepeatableInstance(sectionId: string, index: number): void;
+    /** Duplica un'istanza esistente con i suoi valori. */
+    duplicateRepeatableInstance(sectionId: string, index: number): void;
+    /** Titolo di un'istanza repeatable. */
+    getInstanceTitle(section: UiFormSection, index: number): string;
     /** Scrolla al campo e lo evidenzia. */
     scrollToField(fieldKey: string): void;
     /** Submit del form. */
@@ -166,18 +268,12 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
      */
     getFieldWrapperClasses(field: UiFormFieldDescriptor): string;
     /** Character count per textarea/text con maxLength. */
-    getCharCount(fieldKey: string): {
+    getCharCount(fieldKey: string, fg?: FormGroup): {
         current: number;
         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; }; }, { "valueChange": "valueChange"; "validationChange": "validationChange"; "formSubmit": "formSubmit"; "formReset": "formReset"; "customEvent": "customEvent"; }, never, never, true, 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>;
 }