@gnggln/ng-ui-system 1.0.0-alpha.14 → 1.0.0-alpha.15

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

@@ -44,6 +44,8 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
     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. */

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

@@ -273,9 +273,16 @@ export interface UiFormFieldDescriptor {
     searchable?: boolean;
     /** Mostra pulsante "Seleziona tutto" per multiselect. */
     allowSelectAll?: boolean;
-    /** Callback per recupero asincrono di opzioni filtrate per query. */
+    /**
+     * Con `searchable: true` su `select`/`text`, ogni `input` dell'autocomplete
+     * invoca la callback: il risultato sostituisce l'elenco opzioni mostrato.
+     */
     asyncOptions?: (query: string) => Promise<UiFieldOption[]>;
-    /** Callback per recupero asincrono di opzioni per ID (prevalorizzazione). */
+    /**
+     * Contratto per risolvere opzioni da id (es. prefill da API). Il Form Builder
+     * Angular attuale non invoca questa callback; l'app può comporre le opzioni
+     * in `options` o collegarla a logica custom.
+     */
     recoverAsyncValues?: (ids: any[]) => Promise<UiFieldOption[]>;
     /** Generazione dinamica di opzioni. */
     dynamicOptions?: UiDynamicOptionsConfig;

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;
+}