wuic-framework-lib 1.0.7 → 1.0.9

package/fesm2022/wuic-framework-lib.mjs

@@ -1,2 +1,2 @@
-export { p as AUTH_REDIRECT_REASON_KEY, q as AppSettingsEditorComponent, l as AuthSessionService, B as BooleanEditorComponent, r as BoundedRepeaterComponent, s as ButtonEditorComponent, C as CallbackPipe, t as CallbackPipe2, u as CarouselListComponent, v as CodeAreaEditorComponent, w as ColorEditorComponent, x as CustomException, y as DataActionButtonComponent, z as DataProviderOdataService, c as DataRepeaterComponent, b as DataSourceComponent, E as DateEditorComponent, G as DesignerRouteComponent, H as DictionaryEditorComponent, a as DynamicCompilerService, J as DynamicRowTemplateComponent, i as FieldEditorComponent, F as FilterBarComponent, m as FilterInfo, K as FormatGridViewValuePipe, N as GetSrcUploadPreviewPipe, O as GlobalHandler, Q as HtmlEditorComponent, R as ImageWrapperComponent, I as ImportExportButtonComponent, S as IsSelectedRowPipe, V as KanbanListComponent, X as KanbanOptions, Y as KanbanStatusColumnItem, Z as LazyChartListComponent, _ as LazyCodeEditorComponent, $ as LazyDataActionButtonComponent, a0 as LazyDataSourceComponent, a1 as LazyFieldEditorComponent, a2 as LazyFirstRunWizardComponent, a3 as LazyImageWrapperComponent, a4 as LazyKanbanListComponent, a5 as LazyMetaMenuComponent, a6 as LazyPivotBuilderComponent, a7 as LazyReportDesignerComponent, a8 as LazyReportViewerComponent, a9 as LazySchedulerListComponent, aa as LazySpreadsheetListSfComponent, ab as LicenseFeatureService, ac as ListGridComponent, ad as LookupEditorComponent, ae as MapListComponent, k as MetaInfo, af as MetaMenuComponent, g as MetadataEditorService, M as MetadataProviderService, e as MetadatiColonna, ag as MetadatiTabella, ah as NotificationBellComponent, ai as NotificationRealtimeService, aj as NumberEditorComponent, ak as PRIMARY_PALETTES, P as PagerComponent, d as ParametricDialogComponent, al as PropertyArrayEditorComponent, am as PropertyObjectEditorComponent, an as THEME_OPTIONS, ao as TextAreaEditorComponent, ap as TextEditorComponent, T as TranslationManagerService, aq as TreeListComponent, ar as TreeViewSelectorComponent, as as UploadDialogComponent, at as UploadEditorComponent, U as UserInfoService, au as ValidationRule, av as ValueChangedPayload, aw as VisibleFieldListPipe, ax as WidgetDefinition, ay as WorkflowDesignerRouteComponent, az as WorkflowRunnerComponent, h as WorkflowRuntimeMetadataService, W as WtoolboxService, aA as WuicFeatureDirective, aB as WuicFrozenColumnDirective, aC as WuicRagChatbotComponent, aD as WuicRagChatbotFabComponent, aE as WuicRagService, aF as WuicRowTogglerDirective, aG as _PRIMENG_TABLE_DIRECTIVES_NAMES, aH as authExpiredInterceptor, aI as boundedRepeaterPendingChangesGuard, aJ as featureRouteCanActivateGuard, aK as featureRouteCanMatchGuard, o as getThemeOptions, aL as getThemePrimaryHex, aM as loadBooleanEditorComponent, aN as loadButtonEditorComponent, aO as loadCodeAreaEditorComponent, aP as loadColorEditorComponent, aQ as loadDateEditorComponent, aR as loadDictionaryEditorComponent, aS as loadHtmlEditorComponent, aT as loadLookupEditorComponent, aU as loadNumberEditorComponent, aV as loadPropertyArrayEditorComponent, aW as loadPropertyObjectEditorComponent, aX as loadTextAreaEditorComponent, aY as loadTextEditorComponent, aZ as loadTreeViewSelectorComponent, a_ as loadUploadEditorComponent, a$ as menuRouteAccessCanActivateGuard, b0 as menuRouteAccessCanMatchGuard, b1 as routes } from './wuic-framework-lib-wuic-framework-lib-KFbUlRIT.mjs';
+export { r as AUTH_REDIRECT_REASON_KEY, s as AppSettingsEditorComponent, n as AuthSessionService, B as BooleanEditorComponent, t as BoundedRepeaterComponent, u as ButtonEditorComponent, C as CallbackPipe, v as CallbackPipe2, w as CarouselListComponent, x as CodeAreaEditorComponent, y as ColorEditorComponent, z as CrashReporterService, E as CustomException, H as DataActionButtonComponent, J as DataProviderOdataService, c as DataRepeaterComponent, b as DataSourceComponent, K as DateEditorComponent, N as DesignerRouteComponent, O as DictionaryEditorComponent, a as DynamicCompilerService, Q as DynamicRowTemplateComponent, i as FieldEditorComponent, F as FilterBarComponent, o as FilterInfo, R as FormatGridViewValuePipe, S as GetSrcUploadPreviewPipe, G as GlobalHandler, V as HtmlEditorComponent, X as ImageWrapperComponent, I as ImportExportButtonComponent, Y as IsSelectedRowPipe, Z as KanbanListComponent, _ as KanbanOptions, $ as KanbanStatusColumnItem, a0 as LazyChartListComponent, a1 as LazyCodeEditorComponent, a2 as LazyDataActionButtonComponent, a3 as LazyDataSourceComponent, a4 as LazyFieldEditorComponent, a5 as LazyFirstRunWizardComponent, a6 as LazyImageWrapperComponent, a7 as LazyKanbanListComponent, a8 as LazyMetaMenuComponent, a9 as LazyPivotBuilderComponent, aa as LazyReportDesignerComponent, ab as LazyReportViewerComponent, ac as LazySchedulerListComponent, ad as LazySpreadsheetListSfComponent, ae as LicenseFeatureService, af as ListGridComponent, ag as LookupEditorComponent, ah as MapListComponent, m as MetaInfo, ai as MetaMenuComponent, g as MetadataEditorService, M as MetadataProviderService, e as MetadatiColonna, aj as MetadatiTabella, ak as NotificationBellComponent, al as NotificationRealtimeService, am as NumberEditorComponent, an as PRIMARY_PALETTES, P as PagerComponent, d as ParametricDialogComponent, ao as PropertyArrayEditorComponent, ap as PropertyObjectEditorComponent, aq as THEME_OPTIONS, ar as TextAreaEditorComponent, as as TextEditorComponent, T as TranslationManagerService, at as TreeListComponent, au as TreeViewSelectorComponent, av as UploadDialogComponent, aw as UploadEditorComponent, U as UserInfoService, ax as ValidationRule, ay as ValueChangedPayload, az as VisibleFieldListPipe, aA as WidgetDefinition, aB as WorkflowDesignerRouteComponent, aC as WorkflowRunnerComponent, h as WorkflowRuntimeMetadataService, W as WtoolboxService, aD as WuicErrorDialogComponent, aE as WuicFeatureDirective, aF as WuicFrozenColumnDirective, aG as WuicRagChatbotComponent, aH as WuicRagChatbotFabComponent, aI as WuicRagService, aJ as WuicRowTogglerDirective, aK as _PRIMENG_TABLE_DIRECTIVES_NAMES, aL as authExpiredInterceptor, aM as boundedRepeaterPendingChangesGuard, aN as featureRouteCanActivateGuard, aO as featureRouteCanMatchGuard, q as getThemeOptions, aP as getThemePrimaryHex, aQ as inferTemplateFieldFromBaseClass, aR as loadBooleanEditorComponent, aS as loadButtonEditorComponent, aT as loadCodeAreaEditorComponent, aU as loadColorEditorComponent, aV as loadDateEditorComponent, aW as loadDictionaryEditorComponent, aX as loadHtmlEditorComponent, aY as loadLookupEditorComponent, aZ as loadNumberEditorComponent, a_ as loadPropertyArrayEditorComponent, a$ as loadPropertyObjectEditorComponent, b0 as loadTextAreaEditorComponent, b1 as loadTextEditorComponent, b2 as loadTreeViewSelectorComponent, b3 as loadUploadEditorComponent, b4 as menuRouteAccessCanActivateGuard, b5 as menuRouteAccessCanMatchGuard, b6 as routes } from './wuic-framework-lib-wuic-framework-lib-WQiFu5aA.mjs';
 //# sourceMappingURL=wuic-framework-lib.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wuic-framework-lib",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Wuic Angular Framework Library",
   "author": "Wuic",
   "license": "MIT",

package/types/wuic-framework-lib.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { ErrorHandler, Injector, OnInit, OnDestroy, ChangeDetectorRef, AfterViewInit, EventEmitter, ElementRef, NgZone, OnChanges, SimpleChanges, QueryList, AfterViewChecked, DoCheck, TemplateRef, ViewContainerRef, Type, NgModuleRef, PipeTransform } from '@angular/core';
+import { ErrorHandler, Injector, OnInit, OnDestroy, ChangeDetectorRef, AfterViewInit, EventEmitter, ElementRef, NgZone, OnChanges, SimpleChanges, QueryList, ViewContainerRef, AfterViewChecked, DoCheck, TemplateRef, Type, NgModuleRef, PipeTransform } from '@angular/core';
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Subject, Observable } from 'rxjs';
 import { MenuItem, MessageService, ConfirmationService, Confirmation, TreeNode, MegaMenuItem } from 'primeng/api';
@@ -29,6 +29,69 @@ declare class CustomException {
     stackTrace: string;
     query: string;
     code: number;
+    /**
+     * Discriminator used by dialog consumers to pick the layout:
+     *  - undefined / 'plain': legacy single-message dialog
+     *  - 'sql-passthrough': SQL passthrough — body + expandable Stack/Query/Parameters
+     */
+    kind?: 'plain' | 'sql-passthrough';
+    /** Free-form body text shown under the title (e.g. raw SQL engine message — NOT translated). */
+    body?: string;
+    /** Stable error code for the new typed envelope (server + client). */
+    errorCode?: string;
+    /** Structured args used to fill placeholders in the localized title. */
+    args?: Record<string, unknown>;
+    /** Distributed trace id propagated from the server via Activity.Current?.TraceId. */
+    traceId?: string;
+    /** Inner cause for client-side typed exceptions; left undefined in production. */
+    cause?: unknown;
+    sqlDetails?: {
+        number?: number;
+        state?: number;
+        class?: number;
+        line?: number;
+        procedure?: string;
+        server?: string;
+        database?: string;
+    };
+    parameters?: Record<string, unknown>;
+    innerExceptions?: {
+        type?: string;
+        message?: string;
+    }[];
+    /** Localized labels for the dialog sections (so the dialog template stays language-agnostic). */
+    labels?: {
+        stack?: string;
+        query?: string;
+        params?: string;
+        copy?: string;
+    };
+}
+
+/**
+ * Typed exception thrown by services / components / archetypes of the
+ * framework. Caught by GlobalHandler.handleError and rendered as a
+ * localized dialog via TranslationManagerService.instant('errors.' + code, args).
+ *
+ * Always prefer this over `throw new Error('...')` for any error meant to
+ * be shown to the user. The raw Error is reserved for genuinely unexpected
+ * runtime failures and is wrapped by GlobalHandler under
+ * `errors.client.unknown` as a safety net.
+ */
+type WuicClientSurface = 'service' | 'component' | 'archetype' | 'callback' | 'window' | 'http';
+declare class WuicClientException extends Error {
+    readonly errorCode: string;
+    readonly args: Record<string, unknown>;
+    readonly surface: WuicClientSurface;
+    readonly targetName?: string;
+    readonly fallbackMessage?: string;
+    readonly cause?: unknown;
+    constructor(errorCode: string, args?: Record<string, unknown>, opts?: {
+        surface?: WuicClientSurface;
+        targetName?: string;
+        fallbackMessage?: string;
+        cause?: unknown;
+    });
 }
 
 declare class GlobalHandler implements ErrorHandler {
@@ -36,7 +99,37 @@ declare class GlobalHandler implements ErrorHandler {
         show: boolean;
         exception: CustomException;
     }>;
+    /**
+     * Static dispatcher — lets framework code that doesn't have access to
+     * the Angular ErrorHandler instance (e.g. the HTTP interceptor)
+     * trigger the same dialog flow. Internally creates a transient
+     * GlobalHandler to honour the same branch ordering as the DI version.
+     */
+    static handleErrorStatic(e: any): void;
+    /**
+     * Entry point used by safeJsonParse / wrapClient helpers when they
+     * decide to notify a typed exception without throwing it through the
+     * Angular zone (e.g. swallowed lifecycle errors).
+     */
+    static emitClientException(exc: WuicClientException): void;
+    /**
+     * Optional bootstrap: install window/promise handlers that wrap any
+     * native unhandled error into a typed WuicClientException. Call once
+     * from app.module / main.ts of the consumer app.
+     *
+     * Also exposes `window.__wuicExposeLastException = true` so
+     * WuicClientException stores the last instance on window for tests.
+     */
+    static installWindowHandlers(opts?: {
+        exposeForTests?: boolean;
+    }): void;
     handleError(e: any): void;
+    /**
+     * @deprecated Pre-typed-envelope branches. Remove once server migration
+     * is complete — kept to avoid regressing payloads still produced by
+     * controllers/services not yet routed through MetaExceptionTranslator.
+     */
+    private handleLegacyError;
 }
 
 declare class WidgetDefinition {
@@ -292,6 +385,22 @@ declare class TranslationManagerService {
     private backendRetryTimer?;
     private firstRunStatusChecked;
     private firstRunStatusValue;
+    /**
+     * Dedup set per i warning "Missing translation resource". Senza questo
+     * Angular ChangeDetection invoca `instant(key)` ad ogni ciclo per ogni
+     * tooltip presente nel template → la stessa chiave logga 100s di volte
+     * al secondo intasando la console DevTools. Limitiamo a 1 log per chiave
+     * + locale (poi pruning dopo `updateTranslations`).
+     */
+    private readonly _missingResourceLogged;
+    /**
+     * Guard contro reload-storm quando `instant()` rileva un mismatch
+     * lang-cache (table caricata per lang X, runtime cerca lang Y).
+     * Senza questo flag il primo render dopo cambio lingua scatenerebbe
+     * N reload paralleli (uno per ogni binding template che ha bisogno
+     * del missing key).
+     */
+    private _langMismatchReloadInFlight;
     /**
      * Bundle minimo di traduzioni hardcoded per il SOLO scenario firstRun (DB
      * metadati ancora non inizializzato → tabella `_wuic_translations` non
@@ -2553,7 +2662,7 @@ declare class MetadataProviderService {
      * @param col Metadato colonna da analizzare.
      * @returns Nome tipo TypeScript stimato (`string`, `number`, `boolean`, `Date`, `any`).
      */
-    static getTSTypeFromMetaColumn(col: MetadatiColonna): "any" | "string" | "boolean" | "number" | "Date";
+    static getTSTypeFromMetaColumn(col: MetadatiColonna): "string" | "any" | "boolean" | "number" | "Date";
     /**
      * Normalizza e arricchisce i metadata colonna/tabella: ordina campi, inizializza callback dinamiche, parse di bag JSON
      * e garantisce fallback robusti per funzioni custom non compilabili.
@@ -3754,6 +3863,92 @@ declare class WtoolboxService {
     private static readonly fallbackRouter;
     static isBusy: BehaviorSubject<boolean>;
     static menuUpdated: BehaviorSubject<boolean>;
+    /**
+     * Generic wrapper for invoking user-supplied callbacks compiled from
+     * metadata fields (mc_*_callback / md_*_callback / mc_*_fn). Catches
+     * BOTH synchronous throws AND awaited Promise rejections, then surfaces
+     * the failure as a typed `errors.client.user_callback.failed` dialog
+     * via `GlobalHandler.emitClientException` (instead of letting the raw
+     * error escape to NgZone unhandled → `errors.client.unknown` fallback).
+     *
+     * Use this anywhere the framework invokes user-supplied JS — it
+     * collapses the boilerplate try/catch + Promise.catch + typed wrap that
+     * was previously duplicated across DataSource (after_save / before_save
+     * / after_load / default_value), FieldEditor (suggest), and any future
+     * call sites.
+     *
+     * @param callbackName    Logical metadata name (e.g. 'mc_suggest_value_callback').
+     * @param fn              The compiled callback (sync or async).
+     * @param args            Args to pass to the callback.
+     * @param ctx             Optional context (route / column / phase / target)
+     *                        merged into the typed exception args for diagnostics.
+     * @param opts.rethrow    If true, re-throws the typed exception after
+     *                        emitting (use when the calling flow must halt,
+     *                        e.g. before_save canceling the save). Default false.
+     * @param opts.targetName Optional `targetName` override for the typed
+     *                        WuicClientException (defaults to callbackName).
+     * @returns The callback's resolved value, or `undefined` on failure.
+     */
+    static runUserCallback<T = any>(callbackName: string, fn: (...args: any[]) => T | Promise<T>, args?: any[], ctx?: {
+        route?: string;
+        column?: string;
+        phase?: string;
+        [k: string]: any;
+    }, opts?: {
+        rethrow?: boolean;
+        targetName?: string;
+    }): Promise<T | undefined>;
+    /**
+     * Synchronous sibling of `runUserCallback`. Use when the call site needs
+     * the return value INLINE (e.g. PrimeNG chart drillDown returning a DOM
+     * element, marker content callback returning a node, archetype formatter
+     * returning a derived data shape) — `await` would break the synchronous
+     * contract with the surrounding renderer.
+     *
+     * Catches synchronous throws ONLY (the wrapped fn must be sync). If the
+     * fn returns a Promise it is returned as-is (the caller handles it).
+     *
+     * On throw: emits `errors.client.user_callback.failed` typed exception
+     * via GlobalHandler and returns `opts.fallback` (default `undefined`).
+     * If `opts.rethrow=true`, re-throws the typed exception after emitting.
+     */
+    static runUserCallbackSync<T = any>(callbackName: string, fn: (...args: any[]) => T, args?: any[], ctx?: {
+        route?: string;
+        column?: string;
+        phase?: string;
+        archetype?: string;
+        [k: string]: any;
+    }, opts?: {
+        rethrow?: boolean;
+        targetName?: string;
+        fallback?: T;
+    }): T | undefined;
+    /**
+     * Wrap synchronous archetype lifecycle bodies (parseData, processData,
+     * ngOnInit, refreshOptions, ...) so any throw bubbles into a typed
+     * `errors.client.archetype.<archetypeName>.init_failed` envelope —
+     * instead of leaking a raw stack trace into the GlobalHandler unknown
+     * fallback (e.g. "TypeError: dataOptions.datasets.forEach is not a
+     * function" surfacing with full minified chunk paths).
+     *
+     * The caller decides what to return on failure via `opts.fallback`
+     * (default `undefined`) — most renderers can gracefully fall through
+     * with empty data so the page still mounts.
+     */
+    static wrapArchetypeLifecycleSync<T = any>(archetypeName: string, phase: string, fn: () => T, ctx?: {
+        route?: string;
+        [k: string]: any;
+    }, opts?: {
+        fallback?: T;
+        rethrow?: boolean;
+    }): T | undefined;
+    /**
+     * Builds a typed `errors.client.user_callback.failed` WuicClientException
+     * from any thrown value (Error / primitive / plain object / undefined),
+     * preserving an `innerMessage` + `innerName` for the translation template.
+     * Shared by both `runUserCallback` (async) and `runUserCallbackSync`.
+     */
+    private static buildTypedUserCallbackException;
     constructor(_http: HttpClient, injector: Injector);
     static get router(): {
         navigateByUrl: (url: string) => Promise<boolean>;
@@ -6870,7 +7065,7 @@ declare class DynamicGenericTemplateComponent {
      * privata per sbloccare prod mode con `optimization.scripts: true`. Vedi
      * skills/angular-jit-compiler-migration/SKILL.md.
      */
-    static getComponentFromTemplate(template: string): typeof DynamicGenericTemplateComponent;
+    static getComponentFromTemplate(template: string, templateField?: string, route?: string): typeof DynamicGenericTemplateComponent;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicGenericTemplateComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DynamicGenericTemplateComponent, "wuic-dynamic-generic-template", never, { "rowData": { "alias": "rowData"; "required": false; }; "record": { "alias": "record"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; "expanded": { "alias": "expanded"; "required": false; }; "metaInfo": { "alias": "metaInfo"; "required": false; }; "datasource": { "alias": "datasource"; "required": false; }; "getDescription": { "alias": "getDescription"; "required": false; }; "MetadatiColonna": { "alias": "MetadatiColonna"; "required": false; }; "parentField": { "alias": "parentField"; "required": false; }; }, {}, never, never, false, never>;
 }
@@ -7967,6 +8162,7 @@ declare class TreeListComponent implements OnDestroy, IDataBoundHostComponent {
   * @returns Struttura dati prodotta da `parseData` dopo normalizzazione/elaborazione.
   */
     parseData(data: any): TreeNode<any>[];
+    private _parseDataInternal;
     /**
   * Gestisce la logica operativa di `recursiveTreeSearch` in modo coerente con l'implementazione corrente.
   * @param node Collezione in ingresso processata dal metodo.
@@ -8332,6 +8528,24 @@ declare class ParametricDialogComponent implements OnDestroy, IDataBoundHostComp
   */
     private recomputeActionDisabledState;
     /**
+     * Stato di navigazione wizard usato per calcolare l'auto-disable dei
+     * bottoni wizard.{prev,next,complete}.action.
+     *  - currentVisibleIndex: posizione del tab attivo nell'array dei tab
+     *    visibili (= activeTabValue, perche' getTabValue ritorna l'indice).
+     *  - visibleCount: numero di tab visibili (non-hidden).
+     *  - hasPrev: ci sono tab visibili a sinistra del corrente.
+     *  - hasNext: ci sono tab visibili a destra del corrente.
+     */
+    private computeWizardNavState;
+    /**
+     * Ritorna `true` se l'action e' un bottone wizard.{prev,next,complete}.action
+     * che il framework deve auto-disabilitare in base allo stato di navigazione.
+     * Ritorna `false` se l'action e' un wizard button ma deve restare enabled.
+     * Ritorna `null` se l'action NON e' un wizard nav button (= no opinion,
+     * la logica precedente decide il fallback default).
+     */
+    private computeWizardActionAutoDisabled;
+    /**
   * Esegue il salvataggio del record: usa `saveCallback` custom se presente, altrimenti `datasource.syncData`; a esito positivo chiude dialog o naviga indietro.
   */
     submitData(): Promise<void>;
@@ -8535,6 +8749,21 @@ declare class AppSettingsEditorComponent implements OnInit {
      * Usato sia per sezioni (tLabel(sec.labelKey, sec.label)) sia per field.
      */
     t(key: string | null | undefined, fallback: string | null | undefined): string;
+    /**
+     * Mostra il disclaimer GDPR (solo per opt-IN), poi POSTa
+     * `MetaService.crashConsent` per registrare il consenso lato receiver +
+     * scrivere in appsettings il toggle + audit fields.
+     *
+     * Ritorna `true` se l'utente ha confermato E il consent upstream e' andato
+     * a buon fine. `false` se l'utente ha annullato o se la rete/upstream ha
+     * rifiutato — in entrambi i casi il save deve essere abortito.
+     *
+     * Per opt-OUT (granted=false): nessun dialog (regola GDPR: withdraw
+     * sempre permesso senza friction). Solo POST consent + return ok.
+     */
+    private handleCrashReportingConsent;
+    /** Minimal HTML escape per inserire testo tradotto in stringhe HTML. */
+    private escapeHtml;
     /**
      * Custom action "Save & Apply": calcola il diff (== _changes), lo POSTa,
      * legge la classification dalla response e reagisce di conseguenza.
@@ -9688,22 +9917,21 @@ declare class LazyMetaMenuComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<LazyMetaMenuComponent, "wuic-meta-menu-lazy", never, {}, {}, never, never, true, never>;
 }
 
-declare class LazyFirstRunWizardComponent implements OnInit {
+declare class LazyFirstRunWizardComponent implements OnInit, OnDestroy {
     private readonly cdr;
     /**
      * Mirror dell'output `(complete)` del componente reale. Il consumer si lega a
      * <wuic-first-run-wizard (complete)="..."> sul wrapper lazy senza sapere che
-     * sotto c'e' un dynamic import. La forwarding e' fatta via la `outletOutputs`
-     * dictionary di NgComponentOutlet, che chiama questo emitter quando il child
-     * emette.
+     * sotto c'e' un dynamic import. La forwarding e' fatta in ngOnInit:
+     * subscribe al `complete` dell'instance reale dopo `createComponent()`.
      */
     complete: EventEmitter<void>;
-    loadedComponent: any;
-    outletOutputs: {
-        complete: () => void;
-    };
+    vcr: ViewContainerRef;
+    private componentRef;
+    private completeSub;
     constructor(cdr: ChangeDetectorRef);
     ngOnInit(): Promise<void>;
+    ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<LazyFirstRunWizardComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LazyFirstRunWizardComponent, "wuic-first-run-wizard", never, {}, { "complete": "complete"; }, never, never, true, never>;
 }
@@ -10673,6 +10901,14 @@ declare class FieldEditorComponent implements OnInit, OnChanges, OnDestroy, DoCh
   */
     setOperator($event: any): void;
     /**
+     * Click handler for the suggest button (sparkles icon next to the label
+     * when `mc_suggest_value_callback` is configured). Routes through the
+     * generic `WtoolboxService.runUserCallback` helper so any throw becomes
+     * a typed `errors.client.user_callback.failed` dialog instead of the
+     * raw `errors.client.unknown` fallback.
+     */
+    onSuggestClick(field: any): Promise<void>;
+    /**
   * Gestisce la logica di `editLookupRecord` con regole guidate dai metadati server `_Metadati_*` (tabella/colonna), gestendo esplicitamente il ciclo di vita delle subscription RxJS, propagando aggiornamenti sui campi reattivi usati dalla UI.
   */
     editLookupRecord(): void;
@@ -11006,7 +11242,7 @@ declare class DynamicRowTemplateComponent {
      * @param template Template HTML della row da compilare a runtime.
      * @returns Subclass compilata pronta per `createComponent` / viewChild.
      */
-    static getComponentFromTemplate(template: string): typeof DynamicRowTemplateComponent;
+    static getComponentFromTemplate(template: string, route?: string): typeof DynamicRowTemplateComponent;
     /**
   * Gestisce la logica di `onRowSelect` orchestrando le chiamate `rowCustomSelect`.
   * @param $event Evento UI/payload evento che innesca la logica del metodo.
@@ -12599,7 +12835,29 @@ interface CompileDynamicComponentOptions {
      * path a file .css: il `Compiler` pubblico a runtime non risolve i path).
      */
     styles?: string[];
+    /**
+     * Origin metadata field that supplied the template (e.g. `md_rowTemplate`,
+     * `md_edit_template`, `mc_ui_grid_column_data_template`,
+     * `md_book_html_template`). Used to enrich typed compile/runtime errors
+     * with the SPECIFIC field the user has to fix instead of a generic
+     * 'template invalid' message. Optional — if omitted, falls back to
+     * baseClass-name inference.
+     */
+    templateField?: string;
+    /**
+     * Route name (`md_route_name`) that owns the template. Optional but
+     * highly recommended — surfaces in the typed error dialog so the user
+     * knows WHICH route to open in the metadata editor.
+     */
+    route?: string;
 }
+/**
+ * Maps a baseClass to its conventional `templateField` when the call site
+ * doesn't pass an explicit `templateField` in `CompileDynamicComponentOptions`.
+ * Best-effort: covers the common 1:1 mappings, falls back to the class name.
+ * Exported so `GlobalHandler` can reuse it for runtime-error stack inference.
+ */
+declare function inferTemplateFieldFromBaseClass(baseClassName: string): string;
 /**
  * Compila dinamicamente un componente da template stringa usando l'API
  * pubblica `Compiler`. Mantiene una cache per riutilizzo.
@@ -12638,6 +12896,20 @@ declare class DynamicCompilerService {
      * dal compiler.
      */
     static compile(opts: CompileDynamicComponentOptions): Type<any>;
+    /**
+     * Builds a degenerate component with the SAME baseClass + selector but
+     * an empty template (or a small visible warning marker). Used when the
+     * user-supplied template fails to compile so the rest of the page can
+     * still render. Cached under the same key so we don't re-attempt the
+     * failing compile on every render.
+     */
+    private static buildFallbackComponent;
+    /**
+     * Builds a typed errors.metadata.props_bag.malformed exception with the
+     * template snippet + parser message + base class hint, then dispatches
+     * it via GlobalHandler so the dialog appears localized.
+     */
+    private static emitTemplateCompileError;
     /**
      * Se un componente dinamico richiede un `NgModuleRef` per essere istanziato
      * via `NgComponentOutlet` con `[ngModuleRef]`, questa utility lo crea e lo
@@ -13228,6 +13500,168 @@ declare class WuicRagChatbotFabComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<WuicRagChatbotFabComponent, "wuic-rag-chatbot-fab", never, { "fabTooltip": { "alias": "fabTooltip"; "required": false; }; "dialogTitle": { "alias": "dialogTitle"; "required": false; }; "dialogWidth": { "alias": "dialogWidth"; "required": false; }; "chatHeight": { "alias": "chatHeight"; "required": false; }; "forceVisible": { "alias": "forceVisible"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Frontend crash reporter (skill crash-reporting Commit 8).
+ *
+ * Capture surface:
+ *   - `window.onerror`               (sync runtime errors fuori da Angular zone)
+ *   - `window.onunhandledrejection`  (promise rejection unhandled)
+ *   - `GlobalHandler.handleError()`  (extension point: vedi `report(err)`)
+ *
+ * Per ogni errore catturato:
+ *   1. Costruisce un `CrashReportPayload` con stack + url + UA + breadcrumbs ring buffer
+ *   2. Calcola `stackHash` (SHA-256 dello stack canonicalizzato) per dedup in-memory
+ *   3. Se nuovo o se occorrenza N-th (default 10), POSTa a `/api/Meta/AsmxProxy/MetaService.crashForward`
+ *   4. Al `beforeunload`, flush con `navigator.sendBeacon` per non perdere errori last-mile
+ *
+ * Il backend (`MetaController.AsmxProxy` -> `MetaService.crashForward`) e'
+ * responsabile di aggiungere gli header `X-Wuic-License-*` server-side e di
+ * fare effettivamente il POST upstream a `errors.wuic-framework.com`. Cosi'
+ * niente secret nel browser.
+ *
+ * ── Lazy init ────────────────────────────────────────────────────────
+ * `init()` va chiamato una-tantum nell'`APP_INITIALIZER` (o equivalente
+ * lifecycle hook) del consumer. Probe `/api/Meta/AsmxProxy/MetaService.getCrashReportingConfig`:
+ *   - se `enabled=false` -> tutti i metodi diventano no-op senza ulteriori HTTP.
+ *   - se `enabled=true` -> hooks DOM + breadcrumb listeners attivi.
+ *
+ * ── No-op gating ─────────────────────────────────────────────────────
+ * Default OFF: niente attivita' lato browser finche' il backend non dice
+ * `enabled=true`. Nessun fingerprinting, nessun listener DOM aggiunto.
+ *
+ * ── Privacy ──────────────────────────────────────────────────────────
+ * I breadcrumb non includono mai contenuto form (input.value), header
+ * Authorization, cookie, o body di response. Solo URL pattern, status code,
+ * route changes, console.error message (truncated).
+ */
+declare class CrashReporterService {
+    /** Set after `init()` resolves with backend config. */
+    private _enabled;
+    get enabled(): boolean;
+    private readonly forwardUrl;
+    private readonly configUrl;
+    private maxBreadcrumbs;
+    private dedupCapacity;
+    private dedupFlushEvery;
+    private breadcrumbs;
+    /** LRU map: stackHash -> occurrence count. */
+    private dedupMap;
+    /** Cache of last enqueued payloads pending sendBeacon at beforeunload. */
+    private pendingBeacon;
+    private hooksInstalled;
+    private initInFlight;
+    private readonly http;
+    private readonly zone;
+    /**
+     * Bootstrap. Idempotent — multiple calls return the same in-flight promise.
+     * Resolves when the config probe is complete (or when it fails — silent).
+     */
+    init(): Promise<void>;
+    /** Public API for `GlobalHandler` to forward an Angular-zone error. */
+    report(error: unknown, context?: {
+        url?: string;
+        userId?: string;
+    }): void;
+    /**
+     * Append a breadcrumb (navigation, XHR, console message, etc.). Cheap —
+     * O(1) amortized via FIFO with cap. Safe to call before `init()`.
+     */
+    pushBreadcrumb(crumb: Breadcrumb): void;
+    private bootstrapAsync;
+    private fetchConfig;
+    private installDomHooks;
+    private normalize;
+    private captureInternal;
+    private touchDedup;
+    private enqueuePending;
+    private postForward;
+    private canonicalize;
+    private hash;
+    private truncate;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CrashReporterService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CrashReporterService>;
+}
+interface Breadcrumb {
+    category: 'nav' | 'xhr' | 'console' | 'ui' | string;
+    message?: string;
+    data?: Record<string, unknown>;
+    timestamp?: string;
+}
+interface CrashReportPayload {
+    type: string;
+    message: string;
+    stackRaw: string;
+    stackHash: string;
+    source: 'js' | '.net';
+    url?: string;
+    userId?: string;
+    userAgent?: string;
+    breadcrumbs?: Breadcrumb[];
+    extra?: Record<string, unknown>;
+    release?: string;
+    /** errorCode tipizzato di una WuicClientException (es. errors.client.archetype.chart.init_failed). */
+    errorCode?: string;
+    /** Args strutturati associati al codice tipizzato. */
+    args?: Record<string, unknown>;
+    /** True se proviene da WuicClientException tipizzata. */
+    isTyped?: boolean;
+}
+interface CrashReportingConfig {
+    enabled: boolean;
+    upstreamUrl?: string;
+    disclaimerVersion?: string;
+    maxBreadcrumbsLen?: number;
+    dedupFlushEvery?: number;
+}
+
+/**
+ * Reusable WUIC error dialog (skill crash-reporting Commit 9b — Opzione B).
+ *
+ * Si auto-sottoscrive a <c>GlobalHandler.messageNotification</c> e renderizza
+ * il `CustomException` corrente. Sostituisce il template duplicato che vive
+ * tra i consumer (WuicTest, CrmApp): basta dropparlo nel template della
+ * shell con `<wuic-error-dialog />` e il dialog appare in automatico ogni
+ * volta che `GlobalHandler.handleError` produce un evento.
+ *
+ * ── Layout ─────────────────────────────────────────────────────────────
+ * - Header: `currentException.title` (gia' tradotto da `tryTranslate` /
+ *   `buildTypedException` lato GlobalHandler).
+ * - Body principale:
+ *    - `kind === 'sql-passthrough'` → body raw SQL + sqlDetails meta-line.
+ *    - default → title text + (se presenti) `parserMessage`, `lineNumber`,
+ *      `linePosition`, `route` da args dell'envelope tipizzato.
+ * - Sezioni espandibili (collapsed by default):
+ *    - Executed query (solo SQL)
+ *    - Parameters (solo SQL)
+ *    - Stack trace (per qualsiasi exception non vuota)
+ * - traceId in fondo se presente.
+ * - Footer: bottone "Copia" (clipboard JSON-like) + "OK" che chiude.
+ *
+ * ── Esposizione test ───────────────────────────────────────────────────
+ * `(window as any).__wuicLastDialogException` viene scritto al next() della
+ * subscription, cosi' i test e2e possono asserire shape senza DOM scraping.
+ */
+declare class WuicErrorDialogComponent implements OnInit, OnDestroy {
+    private cdr;
+    visible: boolean;
+    currentException: CustomException | null;
+    private sub?;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    formatParameters(params: Record<string, unknown> | undefined | null): string;
+    formatSqlDetails(d: any): string;
+    /**
+     * Copia un blob testuale self-contained con tutti i dettagli che servono
+     * per aprire un ticket / chat con il DBA: title, body, sqlDetails, query,
+     * parameters, stack, traceId.
+     */
+    copyErrorDetails(): void;
+    onClose(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WuicErrorDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WuicErrorDialogComponent, "wuic-error-dialog", never, {}, {}, never, never, true, never>;
+}
+
 /**
  * localStorage key used to pass the logout reason across the full
  * page reload so the login form can display a user-friendly message.
@@ -13346,5 +13780,5 @@ declare const THEME_OPTIONS: ThemeOption[];
 declare function getThemeOptions(): ThemeOption[];
 declare function getThemePrimaryHex(value: string): string;
 
-export { AUTH_REDIRECT_REASON_KEY, AppSettingsEditorComponent, AuthSessionService, BooleanEditorComponent, BoundedRepeaterComponent, ButtonEditorComponent, CallbackPipe, CallbackPipe2, CarouselListComponent, CodeAreaEditorComponent, ColorEditorComponent, CustomException, DataActionButtonComponent, DataProviderOdataService, DataRepeaterComponent, DataSourceComponent, DateEditorComponent, DesignerRouteComponent, DictionaryEditorComponent, DynamicCompilerService, DynamicRowTemplateComponent, FieldEditorComponent, FilterBarComponent, FilterInfo, FormatGridViewValuePipe, GetSrcUploadPreviewPipe, GlobalHandler, HtmlEditorComponent, ImageWrapperComponent, ImportExportButtonComponent, IsSelectedRowPipe, KanbanListComponent, KanbanOptions, KanbanStatusColumnItem, LazyChartListComponent, LazyCodeEditorComponent, LazyDataActionButtonComponent, LazyDataSourceComponent, LazyFieldEditorComponent, LazyFirstRunWizardComponent, LazyImageWrapperComponent, LazyKanbanListComponent, LazyMetaMenuComponent, LazyPivotBuilderComponent, LazyReportDesignerComponent, LazyReportViewerComponent, LazySchedulerListComponent, LazySpreadsheetListSfComponent, LicenseFeatureService, ListGridComponent, LookupEditorComponent, MapListComponent, MetaInfo, MetaMenuComponent, MetadataEditorService, MetadataProviderService, MetadatiColonna, MetadatiTabella, NotificationBellComponent, NotificationRealtimeService, NumberEditorComponent, PRIMARY_PALETTES, PagerComponent, ParametricDialogComponent, PropertyArrayEditorComponent, PropertyObjectEditorComponent, THEME_OPTIONS, TextAreaEditorComponent, TextEditorComponent, TranslationManagerService, TreeListComponent, TreeViewSelectorComponent, UploadDialogComponent, UploadEditorComponent, UserInfoService, ValidationRule, ValueChangedPayload, VisibleFieldListPipe, WidgetDefinition, WorkflowDesignerRouteComponent, WorkflowRunnerComponent, WorkflowRuntimeMetadataService, WtoolboxService, WuicFeatureDirective, WuicFrozenColumnDirective, WuicRagChatbotComponent, WuicRagChatbotFabComponent, WuicRagService, WuicRowTogglerDirective, _PRIMENG_TABLE_DIRECTIVES_NAMES, authExpiredInterceptor, boundedRepeaterPendingChangesGuard, featureRouteCanActivateGuard, featureRouteCanMatchGuard, getThemeOptions, getThemePrimaryHex, loadBooleanEditorComponent, loadButtonEditorComponent, loadCodeAreaEditorComponent, loadColorEditorComponent, loadDateEditorComponent, loadDictionaryEditorComponent, loadHtmlEditorComponent, loadLookupEditorComponent, loadNumberEditorComponent, loadPropertyArrayEditorComponent, loadPropertyObjectEditorComponent, loadTextAreaEditorComponent, loadTextEditorComponent, loadTreeViewSelectorComponent, loadUploadEditorComponent, menuRouteAccessCanActivateGuard, menuRouteAccessCanMatchGuard, routes };
-export type { AuthSessionState, CompileDynamicComponentOptions, DataSourceAfterSyncEvent, DataSourceBeforeSyncEvent, DataSourceSyncOperation, IDataBoundHostComponent, IFieldEditor, KanbanStatusColumn, LicenseStatusResponse, ListGridAfterRenderEvent, ListGridAfterRowRenderEvent, ListGridBeforeRowRenderEvent, MultiDatasourceMeta, NotificationItem, RagAskAcceptedResponse, RagAskRequest, RagChatHistorySnapshot, RagChatMessageDto, RagChatMessageStatus, RagChatRequest, RagChatResponse, RagChatSessionDto, RagChatTurn, RagChatbotTurn, RagHealthResponse, RagQueryRequest, RagQueryResponse, RagSource, RealtimeProgressEvent, ThemeOption, ThemePresetName, ThemePrimaryName, WorkflowRuntimeLinkedActionRouteMetadataEntry, WorkflowRuntimePreviousRouteNodeEntry, WorkflowRuntimeRouteMetadataEntry, WorkflowRuntimeRouteNodePayloadEntry };
+export { AUTH_REDIRECT_REASON_KEY, AppSettingsEditorComponent, AuthSessionService, BooleanEditorComponent, BoundedRepeaterComponent, ButtonEditorComponent, CallbackPipe, CallbackPipe2, CarouselListComponent, CodeAreaEditorComponent, ColorEditorComponent, CrashReporterService, CustomException, DataActionButtonComponent, DataProviderOdataService, DataRepeaterComponent, DataSourceComponent, DateEditorComponent, DesignerRouteComponent, DictionaryEditorComponent, DynamicCompilerService, DynamicRowTemplateComponent, FieldEditorComponent, FilterBarComponent, FilterInfo, FormatGridViewValuePipe, GetSrcUploadPreviewPipe, GlobalHandler, HtmlEditorComponent, ImageWrapperComponent, ImportExportButtonComponent, IsSelectedRowPipe, KanbanListComponent, KanbanOptions, KanbanStatusColumnItem, LazyChartListComponent, LazyCodeEditorComponent, LazyDataActionButtonComponent, LazyDataSourceComponent, LazyFieldEditorComponent, LazyFirstRunWizardComponent, LazyImageWrapperComponent, LazyKanbanListComponent, LazyMetaMenuComponent, LazyPivotBuilderComponent, LazyReportDesignerComponent, LazyReportViewerComponent, LazySchedulerListComponent, LazySpreadsheetListSfComponent, LicenseFeatureService, ListGridComponent, LookupEditorComponent, MapListComponent, MetaInfo, MetaMenuComponent, MetadataEditorService, MetadataProviderService, MetadatiColonna, MetadatiTabella, NotificationBellComponent, NotificationRealtimeService, NumberEditorComponent, PRIMARY_PALETTES, PagerComponent, ParametricDialogComponent, PropertyArrayEditorComponent, PropertyObjectEditorComponent, THEME_OPTIONS, TextAreaEditorComponent, TextEditorComponent, TranslationManagerService, TreeListComponent, TreeViewSelectorComponent, UploadDialogComponent, UploadEditorComponent, UserInfoService, ValidationRule, ValueChangedPayload, VisibleFieldListPipe, WidgetDefinition, WorkflowDesignerRouteComponent, WorkflowRunnerComponent, WorkflowRuntimeMetadataService, WtoolboxService, WuicErrorDialogComponent, WuicFeatureDirective, WuicFrozenColumnDirective, WuicRagChatbotComponent, WuicRagChatbotFabComponent, WuicRagService, WuicRowTogglerDirective, _PRIMENG_TABLE_DIRECTIVES_NAMES, authExpiredInterceptor, boundedRepeaterPendingChangesGuard, featureRouteCanActivateGuard, featureRouteCanMatchGuard, getThemeOptions, getThemePrimaryHex, inferTemplateFieldFromBaseClass, loadBooleanEditorComponent, loadButtonEditorComponent, loadCodeAreaEditorComponent, loadColorEditorComponent, loadDateEditorComponent, loadDictionaryEditorComponent, loadHtmlEditorComponent, loadLookupEditorComponent, loadNumberEditorComponent, loadPropertyArrayEditorComponent, loadPropertyObjectEditorComponent, loadTextAreaEditorComponent, loadTextEditorComponent, loadTreeViewSelectorComponent, loadUploadEditorComponent, menuRouteAccessCanActivateGuard, menuRouteAccessCanMatchGuard, routes };
+export type { AuthSessionState, Breadcrumb, CompileDynamicComponentOptions, CrashReportPayload, CrashReportingConfig, DataSourceAfterSyncEvent, DataSourceBeforeSyncEvent, DataSourceSyncOperation, IDataBoundHostComponent, IFieldEditor, KanbanStatusColumn, LicenseStatusResponse, ListGridAfterRenderEvent, ListGridAfterRowRenderEvent, ListGridBeforeRowRenderEvent, MultiDatasourceMeta, NotificationItem, RagAskAcceptedResponse, RagAskRequest, RagChatHistorySnapshot, RagChatMessageDto, RagChatMessageStatus, RagChatRequest, RagChatResponse, RagChatSessionDto, RagChatTurn, RagChatbotTurn, RagHealthResponse, RagQueryRequest, RagQueryResponse, RagSource, RealtimeProgressEvent, ThemeOption, ThemePresetName, ThemePrimaryName, WorkflowRuntimeLinkedActionRouteMetadataEntry, WorkflowRuntimePreviousRouteNodeEntry, WorkflowRuntimeRouteMetadataEntry, WorkflowRuntimeRouteNodePayloadEntry };