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

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

@@ -0,0 +1,179 @@
+/**
+ * @module ng-ui-system/form-builder
+ * Tipi relativi alla validazione dei campi.
+ */
+import { ValidatorFn } from '@angular/forms';
+import { UiFieldCondition } from './condition.types';
+/**
+ * Operatori di confronto per validazioni cross-field.
+ */
+export type UiCrossFieldOperator = 'greater_than' | 'greater_equal' | 'less_than' | 'less_equal' | 'not_equal';
+/**
+ * Configurazione per validazione cross-field.
+ * Confronta il valore del campo corrente con quello di un altro campo.
+ *
+ * @example
+ * ```typescript
+ * // La data di fine deve essere successiva alla data di inizio
+ * crossField: {
+ *   targetField: 'data-inizio',
+ *   operator: 'greater_than',
+ *   dataType: 'date',
+ * }
+ * ```
+ */
+export interface UiCrossFieldConfig {
+    /** Chiave del campo di confronto. */
+    targetField: string;
+    /** Operatore di confronto. */
+    operator: UiCrossFieldOperator;
+    /** Tipo di dato per il confronto. */
+    dataType: 'date' | 'number';
+    /** Per le date, specifica se il formato e MM/YYYY. */
+    isMonthYear?: boolean;
+}
+/**
+ * Keyword predefinite per date di riferimento.
+ */
+export type UiDateKeyword = 'today' | 'tomorrow' | 'yesterday';
+/**
+ * Configurazione per validazione date-min / date-max.
+ * Permette di validare che una data sia precedente o successiva
+ * a un valore di riferimento, con supporto per offset temporali.
+ *
+ * @example
+ * ```typescript
+ * // Data deve essere >= oggi
+ * { type: 'date-min', value: 'today', message: 'La data deve essere futura' }
+ *
+ * // Data deve essere <= oggi + 1 anno
+ * { type: 'date-max', value: 'today', offset: '1y', message: 'Max 1 anno da oggi' }
+ *
+ * // Data deve essere >= una data specifica
+ * { type: 'date-min', value: '01/01/2024', message: 'Almeno dal 2024' }
+ * ```
+ */
+export interface UiDateValidationConfig {
+    /**
+     * Data di riferimento.
+     * Puo essere una keyword (`'today'`, `'tomorrow'`, `'yesterday'`)
+     * o una data nel formato `DD/MM/YYYY`.
+     */
+    value: string | UiDateKeyword;
+    /**
+     * Offset da applicare alla data di riferimento.
+     *
+     * Formato: `numero + unita`
+     * - `'y'` o `'a'` per anni (es. `'1y'`, `'2a'`)
+     * - `'m'` per mesi (es. `'6m'`, `'12m'`)
+     * - `'g'` o `'d'` per giorni (es. `'30g'`, `'7d'`)
+     * - `'w'` per settimane (es. `'2w'`)
+     */
+    offset?: string;
+}
+/**
+ * Tipi di validazione supportati dal form builder.
+ *
+ * | Tipo         | Valore atteso      | Descrizione                             |
+ * |-------------|--------------------|-----------------------------------------|
+ * | `required`  | —                  | Campo obbligatorio                      |
+ * | `email`     | —                  | Formato email valido                    |
+ * | `min`       | `number`           | Valore numerico minimo                  |
+ * | `max`       | `number`           | Valore numerico massimo                 |
+ * | `minLength` | `number`           | Lunghezza minima stringa                |
+ * | `maxLength` | `number`           | Lunghezza massima stringa               |
+ * | `pattern`   | `string` (regex)   | Pattern regex da rispettare             |
+ * | `custom`    | `ValidatorFn`      | Validatore Angular custom               |
+ * | `crossField`| `CrossFieldConfig` | Confronto con un altro campo            |
+ * | `date-min`  | `string`           | Data minima (keyword o DD/MM/YYYY)      |
+ * | `date-max`  | `string`           | Data massima (keyword o DD/MM/YYYY)     |
+ * | `fileSize`  | `number` (bytes)   | Dimensione massima file                 |
+ * | `fileType`  | `string[]` (MIME)  | Tipi file accettati                     |
+ * | `fileCount` | `number`           | Numero massimo file                     |
+ */
+export type UiValidationType = 'required' | 'email' | 'min' | 'max' | 'minLength' | 'maxLength' | 'pattern' | 'custom' | 'crossField' | 'date-min' | 'date-max' | 'fileSize' | 'fileType' | 'fileCount';
+/**
+ * Regola di validazione per un campo del form.
+ *
+ * Supporta validazioni standard, cross-field, date con offset,
+ * file e validatori custom Angular. Ogni regola puo avere
+ * condizioni che ne controllano l'applicazione.
+ *
+ * @example
+ * ```typescript
+ * // Validazione required condizionale
+ * {
+ *   type: 'required',
+ *   message: 'Campo obbligatorio se attivo',
+ *   conditions: [{ field: 'is-active', operator: 'equals', value: true }],
+ * }
+ *
+ * // Validazione cross-field
+ * {
+ *   type: 'crossField',
+ *   crossField: {
+ *     targetField: 'eta-minima',
+ *     operator: 'greater_than',
+ *     dataType: 'number',
+ *   },
+ *   message: "L'eta massima deve essere maggiore dell'eta minima",
+ * }
+ * ```
+ */
+export interface UiValidationRule {
+    /** Tipo di validazione. */
+    type: UiValidationType;
+    /**
+     * Valore per la validazione.
+     * - Per `min`/`max`: valore numerico
+     * - Per `minLength`/`maxLength`: lunghezza
+     * - Per `pattern`: stringa regex
+     * - Per `date-min`/`date-max`: keyword o data `DD/MM/YYYY`
+     * - Per `fileSize`: dimensione in bytes
+     * - Per `fileType`: array di MIME types
+     * - Per `fileCount`: numero massimo file
+     */
+    value?: any;
+    /**
+     * Offset temporale per `date-min`/`date-max`.
+     * @see UiDateValidationConfig.offset
+     */
+    offset?: string;
+    /** Configurazione per validazione cross-field. */
+    crossField?: UiCrossFieldConfig;
+    /** Messaggio di errore personalizzato. */
+    message?: string;
+    /** Funzione validatore Angular custom (per `type: 'custom'`). */
+    validator?: ValidatorFn;
+    /** Condizioni per applicare questa regola (validazione condizionale). */
+    conditions?: UiFieldCondition[];
+}
+/**
+ * Stato di validazione complessivo del form.
+ */
+export interface UiFormValidationState {
+    /** Se il form e valido. */
+    valid: boolean;
+    /** Mappa errori per chiave campo. */
+    errors: Record<string, string[]>;
+    /** Chiavi dei campi modificati. */
+    dirty: string[];
+    /** Chiavi dei campi toccati. */
+    touched: string[];
+}
+/**
+ * Chiave `ValidationErrors` usata dai CVA custom per esporre errori granulari
+ * sui campi interni (atomici) verso l'error-summary del form-builder.
+ */
+export declare const UI_FORM_NESTED_FIELD_ERRORS_KEY = "uiNestedFieldErrors";
+/**
+ * Dettaglio di un errore per l'error summary.
+ */
+export interface UiFormErrorDetail {
+    /** Chiave del campo in errore. */
+    fieldKey: string;
+    /** Label del campo per visualizzazione. */
+    fieldLabel: string;
+    /** Lista messaggi di errore. */
+    errors: string[];
+}

package/crud-table/lib/components/modal/confirm-dialog.component.d.ts

@@ -0,0 +1,46 @@
+import { UiConfirmDialogData, UiConfirmVariant, UiIconName, UiVariant } from './modal.types';
+import * as i0 from "@angular/core";
+/**
+ * Dialogo di conferma leggero per azioni condizionali.
+ *
+ * Non va utilizzato direttamente nel template: viene aperto
+ * programmaticamente tramite `UiModalService.confirm()` e i suoi
+ * metodi scorciatoia (`confirmDelete`, `confirmDiscard`, `confirmSave`).
+ *
+ * Supporta quattro varianti semantiche — confirm, delete, warn, info —
+ * ciascuna con icona e colore preconfigurati.
+ *
+ * @selector ui-confirm-dialog
+ *
+ * @example
+ * ```typescript
+ * // Apertura tramite servizio
+ * this.modalService.confirm({
+ *   title: 'Conferma eliminazione',
+ *   message: 'Questa azione non puo essere annullata.',
+ *   variant: 'delete',
+ * }).subscribe(confirmed => {
+ *   if (confirmed) this.deleteItem();
+ * });
+ * ```
+ */
+export declare class UiConfirmDialogComponent {
+    /** @internal Dati iniettati dal servizio modale. */
+    readonly data: UiConfirmDialogData;
+    /** @internal Riferimento al dialogo per la chiusura. */
+    private readonly dialogRef;
+    /** Variante semantica corrente. */
+    get variant(): UiConfirmVariant;
+    /** Nome icona Lucide da visualizzare. */
+    get iconName(): UiIconName;
+    /** Variante del pulsante di conferma. */
+    get confirmButtonVariant(): UiVariant;
+    /** Classi CSS per il contenitore icona. */
+    get iconClasses(): string;
+    /** Conferma e chiude il dialogo con `true`. */
+    confirm(): void;
+    /** Annulla e chiude il dialogo con `false`. */
+    cancel(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiConfirmDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiConfirmDialogComponent, "ui-confirm-dialog", never, {}, {}, never, never, true, never>;
+}

package/crud-table/lib/components/modal/modal.service.d.ts

@@ -0,0 +1,93 @@
+import { Type } from '@angular/core';
+import { MatDialogRef } from '@angular/material/dialog';
+import { Observable } from 'rxjs';
+import { UiConfirmDialogData, UiModalOpenConfig } from './modal.types';
+import * as i0 from "@angular/core";
+/**
+ * Servizio per aprire modali e dialoghi di conferma.
+ *
+ * Gestisce lo stacking intelligente: una modale regolare puo
+ * ospitare al massimo un dialogo di conferma sopra di se.
+ * Non e possibile stackare due modali regolari.
+ *
+ * @usageNotes
+ *
+ * ### Aprire una modale personalizzata
+ * ```typescript
+ * const ref = this.modalService.open(MyDialogComponent, {
+ *   size: 'lg',
+ *   data: { userId: 123 },
+ * });
+ *
+ * ref.afterClosed().subscribe(result => {
+ *   console.log('Risultato:', result);
+ * });
+ * ```
+ *
+ * ### Conferma rapida
+ * ```typescript
+ * this.modalService.confirm('Confermi questa azione?')
+ *   .subscribe(ok => { if (ok) this.procedi(); });
+ * ```
+ *
+ * ### Preset di conferma
+ * ```typescript
+ * this.modalService.confirmDelete('Progetto Alpha')
+ *   .subscribe(ok => { if (ok) this.elimina(); });
+ * ```
+ */
+export declare class UiModalService {
+    /** @internal Istanza MatDialog per la gestione overlay. */
+    private readonly dialog;
+    /** @internal Stack delle modali regolari aperte. */
+    private _modalStack;
+    /** @internal Traccia se un dialogo di conferma e attualmente aperto. */
+    private _confirmOpen;
+    /**
+     * Apre una modale con un componente personalizzato.
+     *
+     * Il componente aperto puo iniettare `MAT_DIALOG_DATA` per accedere
+     * ai dati e `MatDialogRef` per chiudere la modale.
+     *
+     * @param component - Componente standalone da renderizzare nella modale
+     * @param config - Configurazione (dimensione, dati, comportamento)
+     * @returns Riferimento alla modale aperta
+     */
+    open<T, D = unknown, R = unknown>(component: Type<T>, config?: UiModalOpenConfig<D>): MatDialogRef<T, R>;
+    /**
+     * Apre un dialogo di conferma.
+     *
+     * Accetta una stringa semplice (messaggio) o un oggetto di
+     * configurazione completo. Puo essere aperto sopra una modale
+     * esistente (stacking consentito).
+     *
+     * @param messageOrConfig - Messaggio o configurazione completa
+     * @returns Observable che emette `true` se confermato, `false` se annullato
+     */
+    confirm(messageOrConfig: string | UiConfirmDialogData): Observable<boolean>;
+    /**
+     * Scorciatoia: conferma eliminazione.
+     * Variante `delete` con icona cestino e pulsante warn.
+     *
+     * @param itemName - Nome opzionale dell'elemento da eliminare
+     */
+    confirmDelete(itemName?: string): Observable<boolean>;
+    /**
+     * Scorciatoia: conferma abbandono modifiche.
+     * Variante `warn` con icona avviso.
+     */
+    confirmDiscard(): Observable<boolean>;
+    /**
+     * Scorciatoia: conferma salvataggio.
+     * Variante `confirm` con icona check.
+     */
+    confirmSave(): Observable<boolean>;
+    /** Chiude tutte le modali e dialoghi aperti. */
+    closeAll(): void;
+    /** Indica se ci sono modali o dialoghi attualmente aperti. */
+    get hasOpenDialogs(): boolean;
+    /** Numero di modali regolari attualmente aperte. */
+    get openModalCount(): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiModalService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiModalService>;
+}

package/crud-table/lib/components/modal/modal.types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @module ng-ui-system/modal
+ * Tipi e interfacce per UiModal, UiConfirmDialog e UiModalService.
+ */
+import { UiVariant, UiIconName } from '../../core/types';
+export { UiVariant, UiIconName };
+/**
+ * Dimensioni predefinite della modale.
+ *
+ * | Valore        | Larghezza | Caso d'uso                        |
+ * |--------------|-----------|-----------------------------------|
+ * | `sm`         | 400px     | Confirm, messaggi brevi           |
+ * | `md`         | 560px     | Form semplici, dettagli           |
+ * | `lg`         | 720px     | Form complessi, tabelle interne   |
+ * | `xl`         | 900px     | Dashboard modali, preview         |
+ * | `fullscreen` | 95vw      | Operazioni a schermo intero       |
+ */
+export type UiModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen';
+/**
+ * Configurazione strutturale della modale.
+ * Passata come `@Input()` al componente `UiModalComponent`.
+ *
+ * @usageNotes
+ * ### Utilizzo base
+ * ```typescript
+ * const config: UiModalConfig = {
+ *   title: 'Modifica utente',
+ *   size: 'md',
+ * };
+ * ```
+ */
+export interface UiModalConfig {
+    /** Titolo visualizzato nell'header della modale. */
+    title?: string;
+    /** Dimensione della modale. @default 'md' */
+    size?: UiModalSize;
+    /** Mostra il pulsante di chiusura nell'header. @default true */
+    showCloseButton?: boolean;
+    /** Impedisce la chiusura tramite backdrop click o tasto Escape. @default false */
+    disableClose?: boolean;
+    /** Nasconde l'area footer della modale. @default false */
+    hideFooter?: boolean;
+}
+/**
+ * Configurazione per aprire una modale tramite `UiModalService.open()`.
+ *
+ * @usageNotes
+ * ```typescript
+ * this.modalService.open(MyComponent, {
+ *   size: 'lg',
+ *   data: { userId: 123 },
+ *   disableClose: true,
+ * });
+ * ```
+ */
+export interface UiModalOpenConfig<D = unknown> {
+    /** Dimensione della modale. @default 'md' */
+    size?: UiModalSize;
+    /** Dati da iniettare nel componente aperto tramite MAT_DIALOG_DATA. */
+    data?: D;
+    /** Impedisce la chiusura tramite backdrop click o tasto Escape. @default false */
+    disableClose?: boolean;
+    /** Classe CSS aggiuntiva per il pannello overlay. */
+    panelClass?: string;
+}
+/**
+ * Varianti semantiche del dialogo di conferma.
+ *
+ * | Variante   | Icona default      | Colore pulsante | Caso d'uso                |
+ * |-----------|-------------------|----------------|---------------------------|
+ * | `confirm` | `check-circle`     | `primary`       | Conferma azione positiva   |
+ * | `delete`  | `trash-2`          | `warn`          | Eliminazione irreversibile |
+ * | `warn`    | `alert-triangle`   | `warn`          | Avviso con conferma        |
+ * | `info`    | `info`             | `primary`       | Informazione con azione    |
+ */
+export type UiConfirmVariant = 'confirm' | 'delete' | 'warn' | 'info';
+/**
+ * Configurazione per il dialogo di conferma.
+ * Passata a `UiModalService.confirm()`.
+ *
+ * @usageNotes
+ * ### Conferma semplice (solo stringa)
+ * ```typescript
+ * this.modalService.confirm('Sei sicuro di voler procedere?');
+ * ```
+ *
+ * ### Conferma configurata
+ * ```typescript
+ * this.modalService.confirm({
+ *   title: 'Elimina elemento',
+ *   message: 'Questa azione non puo essere annullata.',
+ *   variant: 'delete',
+ *   confirmText: 'Elimina',
+ * });
+ * ```
+ */
+export interface UiConfirmDialogData {
+    /** Titolo del dialogo. */
+    title?: string;
+    /** Messaggio principale del dialogo. */
+    message: string;
+    /** Testo del pulsante di conferma. @default 'Conferma' */
+    confirmText?: string;
+    /** Testo del pulsante di annullamento. @default 'Annulla' */
+    cancelText?: string;
+    /** Variante semantica che determina icona e colore. @default 'confirm' */
+    variant?: UiConfirmVariant;
+    /** Icona personalizzata (sovrascrive quella della variante). */
+    icon?: UiIconName;
+}

package/crud-table/lib/core/logging/logger.config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module ng-ui-system/core/logging
+ * Configurazione IndexedDB per UiLoggerService.
+ * Pattern omologato a action-logger.config.ts del progetto Siform-PAL.
+ */
+import type { UiLogLevel } from './logger.types';
+/** Durata default retention log (7 giorni). */
+export declare const UI_LOGGER_DEFAULT_TTL_MS: number;
+/** Nome database IndexedDB. */
+export declare const UI_LOGGER_IDB_NAME = "ng-ui-system-logs";
+/** Versione database (incrementare su schema change). */
+export declare const UI_LOGGER_IDB_VERSION = 1;
+/** Nome object store. */
+export declare const UI_LOGGER_IDB_STORE = "entries";
+/** Max entry totali per cleanup automatico. */
+export declare const UI_LOGGER_MAX_ENTRIES = 10000;
+/** Livelli di log ordinati per severità crescente. */
+export declare const UI_LOGGER_LEVELS: readonly UiLogLevel[];

package/crud-table/lib/core/logging/logger.service.d.ts

@@ -0,0 +1,75 @@
+import type { UiLogCategory, UiLogEntry, UiLogFilter, UiLogLevel, UiLogSummary, UiLoggerConfig } from './logger.types';
+import * as i0 from "@angular/core";
+/**
+ * Logger centralizzato per componenti ng-ui-system.
+ * Persiste su IndexedDB con cleanup automatico.
+ */
+export declare class UiLoggerService {
+    private readonly platformId;
+    private dbPromise;
+    /** Stato toggle runtime. */
+    readonly enabled: import("@angular/core").WritableSignal<boolean>;
+    /** Configurazione runtime. */
+    private config;
+    /** True se IndexedDB disponibile e siamo in browser. */
+    private idbSupported;
+    /** Rileva se logging attivo (default: true in dev se non production). */
+    private detectEnabled;
+    /** Abilita/disabilita logging runtime. */
+    setEnabled(value: boolean): void;
+    /** Configura il logger. */
+    configure(config: Partial<UiLoggerConfig>): void;
+    /**
+     * Log generico con controllo enabled e livello.
+     */
+    log(category: UiLogCategory, level: UiLogLevel, action: string, payload?: Record<string, unknown>, duration?: number): void;
+    /**
+     * Log azione form (submit, reset, valueChange, etc).
+     */
+    logFormAction(action: 'init' | 'submit' | 'reset' | 'valueChange' | 'validationChange' | 'customEvent' | 'destroy', payload: {
+        schemaId: string;
+        [key: string]: unknown;
+    }): void;
+    /**
+     * Log azione wizard (stepChange, complete, validationFailed, etc).
+     */
+    logWizardAction(action: 'init' | 'stepChange' | 'stepComplete' | 'stepValidationFailed' | 'complete' | 'navigation' | 'save' | 'valueChange' | 'keyboardNavigation' | 'destroy', payload: {
+        wizardId?: string;
+        step?: number;
+        [key: string]: unknown;
+    }): void;
+    /**
+     * Log errore.
+     */
+    logError(error: Error | unknown, context?: Record<string, unknown>): void;
+    /**
+     * Log debug (solo se enabled e minLevel <= debug).
+     */
+    debug(category: UiLogCategory, action: string, payload?: Record<string, unknown>): void;
+    private persist;
+    /** Recupera userId da localStorage se disponibile. */
+    private getUserId;
+    /** Verifica se il livello deve essere loggato in base a minLevel. */
+    private shouldLogLevel;
+    /**
+     * Recupera log con filtri.
+     */
+    query(filter?: UiLogFilter): Promise<UiLogEntry[]>;
+    /**
+     * Riepilogo log per dashboard.
+     */
+    summary(): Promise<UiLogSummary>;
+    /**
+     * Cancella log più vecchi di TTL.
+     */
+    purgeOld(): Promise<number>;
+    /**
+     * Cancella tutti i log.
+     */
+    clear(): Promise<void>;
+    private openDb;
+    private cleanupIfNeeded;
+    private applyFilter;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiLoggerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiLoggerService>;
+}

package/crud-table/lib/core/logging/logger.types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @module ng-ui-system/core/logging
+ * Tipologie per il sistema di logging centralizzato della libreria.
+ * Pattern omologato a ActionLoggerService del progetto Siform-PAL.
+ */
+/**
+ * Categorie di log per filtraggio e organizzazione.
+ */
+export type UiLogCategory = 'form' | 'wizard' | 'navigation' | 'system' | 'error';
+/**
+ * Livelli di severità log.
+ */
+export type UiLogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Entry singola nel log. Persistita su IndexedDB.
+ */
+export interface UiLogEntry {
+    /** ID univoco (timestamp + random). */
+    id: string;
+    /** Categoria log. */
+    category: UiLogCategory;
+    /** Livello severità. */
+    level: UiLogLevel;
+    /** Azione/etichetta descrittiva (es. 'form_submit', 'step_change'). */
+    action: string;
+    /** Payload dati (schema id, step, valori, errori). */
+    payload?: Record<string, unknown>;
+    /** Timestamp creazione (ms). */
+    timestamp: number;
+    /** Durata operazione (ms), opzionale. */
+    duration?: number;
+    /** URL corrente al momento del log. */
+    url: string;
+    /** User ID se disponibile. */
+    userId?: string;
+}
+/**
+ * Filtri per query log.
+ */
+export interface UiLogFilter {
+    category?: UiLogCategory;
+    level?: UiLogLevel;
+    action?: string;
+    from?: number;
+    to?: number;
+    limit?: number;
+}
+/**
+ * Riepilogo log per UI admin/debug.
+ */
+export interface UiLogSummary {
+    total: number;
+    byCategory: Record<UiLogCategory, number>;
+    byLevel: Record<UiLogLevel, number>;
+    oldest: number;
+    newest: number;
+}
+/**
+ * Configurazione runtime del logger.
+ */
+export interface UiLoggerConfig {
+    /** Abilita/disabilita logging. Default: true in dev, false in production. */
+    enabled: boolean;
+    /** Livello minimo da loggare. */
+    minLevel: UiLogLevel;
+    /** Durata retention log in ms. Default: 7 giorni. */
+    ttlMs: number;
+    /** Max entry totali per cleanup automatico. */
+    maxEntries: number;
+}