wuic-framework-lib 1.3.0 → 1.5.0

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

@@ -3,7 +3,7 @@ import { ErrorHandler, Injector, OnInit, OnDestroy, ChangeDetectorRef, NgZone, A
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Subject, Observable } from 'rxjs';
 import { MenuItem, MessageService, ConfirmationService, Confirmation, TreeNode, MegaMenuItem } from 'primeng/api';
-import { HttpClient, HttpInterceptorFn, HttpInterceptor, HttpRequest, HttpHandler, HttpEvent } from '@angular/common/http';
+import { HttpClient, HttpInterceptorFn, HttpContextToken, HttpInterceptor, HttpRequest, HttpHandler, HttpEvent } from '@angular/common/http';
 import { Router, ActivatedRoute, CanDeactivateFn, CanActivateFn, CanMatchFn, Routes } from '@angular/router';
 import * as _ngx_translate_core from '@ngx-translate/core';
 import { TranslateService } from '@ngx-translate/core';
@@ -975,6 +975,27 @@ type WorkflowRuntimeLinkedActionRouteMetadataEntry = {
     targetRoute: string;
     targetAction?: string;
     metadata: any;
+    /** Feature I: guardie di transizione (espressioni JS su `record`) raccolte dai nodi condition attraversati. */
+    conditionExpressions?: string[];
+    /** Feature J: permessi richiesti (es. 'role:<id_ruolo>') raccolti dalle transizioni sugli archi attraversati. */
+    requiredPermissions?: string[];
+};
+type WorkflowRuntimeInternalActionEntry = {
+    sourceRoute: string;
+    tableActionId: number;
+    /** Node id dell'azione trigger (per memorizzarne il payload di ritorno). */
+    triggerNodeId?: string;
+    /**
+     * Catena ordinata di azioni interne a valle del trigger. `splitConfig` e'
+     * presente SOLO per le azioni sintetiche del parallel_split (tipo 102, F5):
+     * il consumer (data-source) le esegue nativamente materializzando i task.
+     */
+    internalActions: Array<{
+        nodeId: string;
+        actionTypeId: number;
+        callback: string;
+        splitConfig?: any;
+    }>;
 };
 type WorkflowRuntimeRouteNodePayloadEntry = {
     nodeId: string;
@@ -989,21 +1010,38 @@ type WorkflowRuntimePreviousRouteNodeEntry = {
     previousAction?: string;
 };
 declare class WorkflowRuntimeMetadataService {
+    private userInfoSrv?;
     private static instance?;
     private readonly storageKey;
     private readonly byRouteAction;
     private readonly byRoute;
     private readonly linkedBySourceAction;
+    /** Feature L — azioni INTERNE (concatenate) a valle di una table action: key `route::actionId`. */
+    private readonly internalBySourceAction;
     private readonly pendingByRouteAction;
     private readonly pendingByRoute;
     private readonly routeNodePayloadByNodeId;
     private readonly routeNodeIdsByRouteAction;
     private readonly routeNodeIdsByRoute;
     private readonly previousRouteNodeByRouteNodeId;
+    /**
+     * Contesto della navigazione workflow in corso (impostato dal wrapper action
+     * del data-source prima di invocare il callback). Serve a `navigateToNextStep`
+     * per sapere QUALE azione/route sorgente sta risolvendo il prossimo step,
+     * senza che il callback debba conoscere l'action id. Transiente, non persistito.
+     */
+    private currentNavContext;
+    /**
+     * Chiave (`wg_key`) del grafo workflow ATTIVO nel runner. Viaggia verso il
+     * server dentro `routeContext.workflowGraphId` (buildCrudRouteContext): il
+     * server la usa per rileggere il bundle dal grafo persistito e applicare
+     * autorizzazioni tabella/colonne e record restriction server-side.
+     */
+    private activeGraphKey;
     /**
      * Inizializza il singleton runtime metadata e prova il restore dello stato persistito da sessionStorage.
      */
-    constructor();
+    constructor(userInfoSrv?: UserInfoService);
     /**
      * Restituisce l'istanza singleton runtime metadata inizializzata dal DI Angular.
      * Utile per accessi statici da utility/service non iniettati.
@@ -1016,6 +1054,14 @@ declare class WorkflowRuntimeMetadataService {
      * @param entries Elenco metadata runtime per route/azione.
      */
     setRouteMetadata(entries: WorkflowRuntimeRouteMetadataEntry[]): void;
+    /**
+     * Route degli step del workflow ATTIVO (chiavi di `byRoute`, lowercase).
+     * Usate dal menu-route-access guard: la navigazione fra gli step di un
+     * workflow attivo e' legittima anche quando le route non compaiono nel
+     * menu applicativo dell'utente (es. il runner instrada il richiedente
+     * sullo step successivo del flusso).
+     */
+    getActiveWorkflowRoutes(): string[];
     /**
      * Risolve i metadata runtime attivi per route/action usando priorita:
      * chiave specifica `route::action` e fallback metadata di sola route.
@@ -1024,6 +1070,14 @@ declare class WorkflowRuntimeMetadataService {
      * @returns Metadata runtime associato oppure `null`.
      */
     getRouteMetadata(route: string, action?: string): any | null;
+    /**
+     * Imposta la chiave del grafo workflow attivo (settata dal runner al load).
+     */
+    setActiveGraphKey(graphKey: string): void;
+    /**
+     * Chiave del grafo workflow attivo ('' se nessun workflow in corso).
+     */
+    getActiveGraphKey(): string;
     /**
      * Pulisce lo stato runtime e le cache associate.
      */
@@ -1034,13 +1088,108 @@ declare class WorkflowRuntimeMetadataService {
      * @param entries Collegamenti sourceRoute+tableActionId -> targetRoute/targetAction.
      */
     setLinkedActionRouteMetadata(entries: WorkflowRuntimeLinkedActionRouteMetadataEntry[]): void;
+    /**
+     * True se l'azione (route sorgente + table action id) ha collegamenti di
+     * navigazione nel grafo ATTIVO (archi verso condition/route). Usato dal
+     * wrapper action del data-source per attivare la meccanica di flusso in
+     * modo GRAPH-DRIVEN: e' il grafo a dire se un'azione naviga, il tipo
+     * dell'azione descrive solo il payload di business.
+     */
+    hasLinkedNavigation(sourceRoute: string, tableActionId: number): boolean;
     /**
      * Attiva i metadata di navigazione collegati a una specifica azione tabellare, spostandoli nelle mappe "pending".
      * I metadata pending verranno consumati dalla prima apertura della route target (con o senza action).
      * @param sourceRoute Route sorgente da cui parte l'azione.
      * @param tableActionId Id dell'azione tabellare eseguita.
      */
-    activateLinkedNavigationMetadata(sourceRoute: string, tableActionId: number): void;
+    activateLinkedNavigationMetadata(sourceRoute: string, tableActionId: number, record?: any, payload?: any): void;
+    /**
+     * Snapshot plain del record: i campi dei record framework sono BehaviorSubject,
+     * qui srotolati a valore per la valutazione delle espressioni-guardia.
+     */
+    private snapshotRecord;
+    /**
+     * `true` se TUTTE le espressioni-guardia del target sono soddisfatte contro
+     * lo snapshot (fail-closed: un'espressione invalida conta come non passata).
+     * In scope, oltre a `record`, c'e' `payload`: il valore consegnato
+     * dall'azione precedente della catena (3° argomento di `navigateToNextStep`,
+     * tipicamente lo stesso valore poi passato a `resolve(...)` nel trigger) —
+     * `undefined` se il chiamante non lo fornisce.
+     */
+    private targetGuardsPass;
+    /**
+     * Feature J — `true` se l'utente corrente soddisfa TUTTI i permessi richiesti
+     * dalla transizione. Formato canonico `role:<id_ruolo>` (match su `role_id`);
+     * valori legacy free-form confrontati case-insensitive col nome ruolo.
+     * Fail-closed: senza utente/servizio la transizione non e' percorribile.
+     */
+    /**
+     * Feature J — verifica pubblica dei permessi transizione per l'utente corrente
+     * (usata dal runner anche per il gate delle table action nell'overlay:
+     * permesso sull'arco route->action = chi puo' vedere/usare l'azione nello step).
+     */
+    userHasPermissions(requiredPermissions?: string[]): boolean;
+    private permissionsPass;
+    /**
+     * Feature J — valuta una singola voce permesso:
+     * - `deny:role:1,role:5` → i ruoli in lista sono BLOCCATI (lista vuota = tutti abilitati);
+     * - `grant:role:1,role:5` → SOLO i ruoli in lista sono ammessi;
+     * - legacy `role:<id>` o nome ruolo → grant singolo.
+     */
+    private permissionEntryPass;
+    /** Match di un token ruolo: `role:<id>`, `<id>` numerico o nome ruolo (case-insensitive). */
+    private roleTokenMatches;
+    /**
+     * Feature L — registra le catene di azioni INTERNE (concatenate) a valle
+     * delle table action del workflow attivo. Chiamato dal runner; consumato dal
+     * wrapper action del data-source dopo l'esecuzione del callback trigger.
+     */
+    setLinkedInternalActions(entries: WorkflowRuntimeInternalActionEntry[]): void;
+    /** Feature L — catena di azioni interne collegata a una table action (o `null`). */
+    getLinkedInternalActions(sourceRoute: string, tableActionId: number): WorkflowRuntimeInternalActionEntry | null;
+    /**
+     * Imposta il contesto della navigazione workflow in corso (sourceRoute +
+     * actionId dell'azione che sta per eseguire il proprio callback). Chiamato dal
+     * wrapper action del data-source; consumato da `navigateToNextStep`.
+     */
+    setNavigationContext(sourceRoute: string, tableActionId: number): void;
+    /** Contesto navigazione workflow corrente, o `null` se non in un'azione workflow. */
+    getNavigationContext(): {
+        sourceRoute: string;
+        actionId: number;
+    } | null;
+    /** Azzera il contesto navigazione (chiamato al termine del callback action). */
+    clearNavigationContext(): void;
+    /**
+     * Feature I — risolve la route del PROSSIMO step workflow per un'azione di
+     * navigazione, dato il record corrente (`context`):
+     * - se i target hanno guardie (nodo condition a valle) sceglie il ramo
+     *   VINCENTE (tutte le espressioni soddisfatte) — es. true=pop>1000;
+     * - se non ci sono guardie (il nodo successivo e' direttamente una route)
+     *   prende quella route.
+     * @returns `{ targetRoute, targetAction }` scelta, oppure `null` se non c'e'
+     *          linking workflow per (sourceRoute, actionId).
+     */
+    resolveNextStepRoute(sourceRoute: string, tableActionId: number, record: any, payload?: any): {
+        targetRoute: string;
+        targetAction: string;
+    } | null;
+    /**
+     * Feature I — valuta le guardie di transizione (espressioni dei nodi condition)
+     * collegate a un'azione di navigazione workflow, contro il record corrente.
+     *
+     * Semantica: la navigazione e' consentita se ALMENO UN target collegato ha
+     * tutte le sue guardie soddisfatte (nessuna espressione = sempre consentito).
+     * Le espressioni sono JS con in scope `record` (snapshot plain, BehaviorSubject
+     * gia' srotolati). Un errore di valutazione conta come guardia fallita.
+     *
+     * @returns `{ allowed, failedExpression }` — la prima espressione fallita
+     *          (per il toast) quando `allowed=false`.
+     */
+    evaluateLinkedNavigationGuards(sourceRoute: string, tableActionId: number, record: any): {
+        allowed: boolean;
+        failedExpression?: string;
+    };
     /**
      * Consuma (read-once) metadata pending per route/azione: se presenti li ritorna e li rimuove dallo stato runtime.
      * La lookup prova prima la chiave `route::action`, poi il fallback per sola route.
@@ -1670,12 +1819,41 @@ declare class DataSourceComponent implements OnInit, OnDestroy {
   */
     private applyWorkflowRuntimeRouteMetadata;
     /**
+     * Valuta le autorizzazioni del BUNDLE workflow (tablePermissions /
+     * columnPermissions autorate nel grafo, sezioni "Autorizzazioni
+     * tabella/colonna" del Metadata Route editor) per l'UTENTE CORRENTE e le
+     * proietta sui metadata client. Le autorizzazioni fisiche
+     * (_mtdt__tnt__trzzzioni__*) restano enforcement server-side globale; queste
+     * valgono SOLO dentro il workflow (overlay-only, come le azioni). Specchia la
+     * semantica di `applyTableRestrictions`/`applyColumnRestrictions` server:
+     * tri-state (null=neutro), precedenza utente > ruolo, admin bypass.
+     */
+    private applyWorkflowRuntimePermissionsForCurrentUser;
+    /**
   * Ricostruisce le callback delle custom action tabella (`action_callback__fn`, `disable_callback__fn`) e aggancia il linking di navigazione workflow.
   * @param actions Lista custom action tabella da rendere eseguibile (callback function ricostruite).
   * @param currentRoute Route sorgente usata per il linking automatico delle azioni di navigazione.
   */
     private rehydrateRuntimeTableActionCallbacks;
     /**
+     * Feature L — esegue la catena di azioni INTERNE (concatenate) collegate a
+     * una table action del workflow attivo. Il `payload` iniziale e' il valore
+     * ritornato dal callback del trigger; il return (non-undefined) di ogni
+     * interna diventa il payload della successiva. I payload sono memorizzati
+     * anche nella mappa payload del workflow (`setRouteNodePayload` per node id).
+     * Errori: notificati via errorHandler, non bloccano il flusso.
+     */
+    private executeLinkedInternalActions;
+    /**
+     * F5 — materializza i TASK PARALLELI del parallel_split: per ogni record del
+     * payload del trigger e per ogni ramo della config, un `insertRecord` sulla
+     * route task dell'app (CRUD standard: audit stamp e trigger dell'app gratis).
+     * Config: { task_route, fk_field, record_pk_field, caption_field, done_field,
+     * assignee_field?, due_days?, extra_defaults?, branches: [{caption,
+     * assignee_user_id?}] }. Ritorna il payload arricchito di `tasksCreated`.
+     */
+    private materializeWorkflowParallelTasks;
+    /**
   * Restituisce il primo valore definito tra più chiavi candidate, con fallback case-insensitive.
   * @param obj Oggetto su cui cercare i valori.
   * @param keys Lista ordinata di chiavi candidate da testare.
@@ -2829,10 +3007,19 @@ declare class MetadataProviderService {
     static loadDashboardUri: any;
     static deleteDashboardUri: any;
     static saveWorkflowGraphUri: any;
+    static saveWorkflowTransitionsUri: any;
+    static getWorkflowTransitionsUri: any;
+    static saveWorkflowGraphVersionUri: any;
+    static getWorkflowGraphVersionsUri: any;
+    static getWorkflowGraphVersionUri: any;
     static loadWorkflowGraphUri: any;
     static getWorkflowGraphsUri: any;
     static renameWorkflowGraphUri: any;
     static deleteWorkflowGraphUri: any;
+    static saveScene3dUri: any;
+    static saveScene3dThumbnailUri: any;
+    static loadScene3dUri: any;
+    static getScene3dsUri: any;
     static getCssClassesFromSheetsUri: any;
     static writeChangesToCssFileUri: any;
     static scaffoldODataUri: any;
@@ -3881,6 +4068,16 @@ declare class DataProviderMetaService {
      * @returns Esito serializzato con id/chiave/nome e numero route metadata processate.
      */
     saveWorkflowGraph(payload: any): Promise<any>;
+    /** Feature J — persiste le transizioni di stato del workflow (`MetaService.saveWorkflowTransitions`). */
+    saveWorkflowTransitions(payload: any): Promise<any>;
+    /** Feature J — rilegge le transizioni di stato del workflow (`MetaService.getWorkflowTransitions`). */
+    getWorkflowTransitions(payload: any): Promise<any>;
+    /** Feature K — salva uno snapshot versione del workflow graph (`MetaService.saveWorkflowGraphVersion`). */
+    saveWorkflowGraphVersion(payload: any): Promise<any>;
+    /** Feature K — elenca le versioni storicizzate (`MetaService.getWorkflowGraphVersions`). */
+    getWorkflowGraphVersions(payload: any): Promise<any>;
+    /** Feature K — ritorna il graph_json di una versione specifica (`MetaService.getWorkflowGraphVersion`). */
+    getWorkflowGraphVersion(payload: any): Promise<any>;
     /**
      * Carica un workflow graph via `MetaService.loadWorkflowGraph`.
      * Se la chiave non esiste, il backend ritorna un grafo vuoto (`nodes/connections`) con `route_metadata=[]`.
@@ -3906,6 +4103,33 @@ declare class DataProviderMetaService {
      * @returns Esito serializzato `{ deleted, affected }`.
      */
     deleteWorkflowGraph(payload: any): Promise<any>;
+    /**
+     * Salva/aggiorna una scena 3D via `MetaService.saveScene3d`.
+     * Il backend fa upsert su `_wuic_scene3d` partendo da `scene_json`.
+     * @param payload Richiesta con `scene_key`, `scene_name`, `scene_json`.
+     * @returns Esito serializzato con id/chiave/nome.
+     */
+    saveScene3d(payload: any): Promise<any>;
+    /**
+     * Salva la thumbnail (data-URL PNG) di una scena via
+     * `MetaService.saveScene3dThumbnail`. Non usa il busy globale: e' una
+     * chiamata di corredo fire-and-forget dopo il save (cattura del canvas GPU).
+     * @param payload Richiesta con `scene_key` e `thumbnail` (data:image/png;base64,...).
+     */
+    saveScene3dThumbnail(payload: any): Promise<any>;
+    /**
+     * Carica una scena 3D via `MetaService.loadScene3d`.
+     * Se la chiave non esiste, il backend ritorna una scena vuota.
+     * @param payload Richiesta con `scene_key`.
+     * @returns Struttura `{ scene_key, scene_name, scene_json }`.
+     */
+    loadScene3d(payload: any): Promise<any>;
+    /**
+     * Richiede al backend l'elenco delle scene 3D disponibili (`MetaService.getScene3ds`).
+     * @param payload Payload richiesta/risposta usato nel metodo.
+     * @returns Collezione scene restituita dal server.
+     */
+    getScene3ds(payload: any): Promise<any>;
     /**
      * Chiede al backend le classi CSS presenti nei fogli indicati (`MetaService.getCssClassesFromSheets`).
      * @param sheetPaths Percorsi fogli CSS da elaborare.
@@ -4311,6 +4535,16 @@ declare class DataProviderService {
      * @returns Valore restituito dal metodo (Promise<any>).
      */
     saveWorkflowGraph(payload: any): Promise<any>;
+    /** Feature J — persiste le transizioni di stato del workflow. */
+    saveWorkflowTransitions(payload: any): Promise<any>;
+    /** Feature J — rilegge le transizioni di stato del workflow. */
+    getWorkflowTransitions(payload: any): Promise<any>;
+    /** Feature K — salva uno snapshot versione del workflow graph. */
+    saveWorkflowGraphVersion(payload: any): Promise<any>;
+    /** Feature K — elenca le versioni storicizzate del workflow graph. */
+    getWorkflowGraphVersions(payload: any): Promise<any>;
+    /** Feature K — ritorna il graph_json di una versione specifica. */
+    getWorkflowGraphVersion(payload: any): Promise<any>;
     /**
      * Carica i dati richiesti dal flusso runtime del servizio.
      * @param payload Payload richiesta/risposta usato nel metodo.
@@ -4323,6 +4557,14 @@ declare class DataProviderService {
      * @returns Lista graph/metadata restituita dal backend.
      */
     getWorkflowGraphs(payload: any): Promise<any>;
+    /** Scene3D — salva/aggiorna una scena 3D delegando al provider metadata (`MetaService.saveScene3d`). */
+    saveScene3d(payload: any): Promise<any>;
+    /** Scene3D — salva la thumbnail di una scena (`MetaService.saveScene3dThumbnail`). */
+    saveScene3dThumbnail(payload: any): Promise<any>;
+    /** Scene3D — carica una scena 3D delegando al provider metadata (`MetaService.loadScene3d`). */
+    loadScene3d(payload: any): Promise<any>;
+    /** Scene3D — elenca le scene 3D disponibili delegando al provider metadata (`MetaService.getScene3ds`). */
+    getScene3ds(payload: any): Promise<any>;
     /**
      * Rinomina un workflow graph delegando al provider metadata.
      * @param payload Payload con identificativo grafo e nuovo nome.
@@ -4482,6 +4724,35 @@ declare class WtoolboxService {
     static get router(): {
         navigateByUrl: (url: string) => Promise<boolean>;
     };
+    /**
+     * Id dell'utente autenticato corrente (via `UserInfoService`, mai leggendo
+     * cookie/session direttamente — AGENTS.md regola 7). Utile nei callback delle
+     * table action per stampare "chi ha fatto l'azione" (es. `approvatore_id` nel
+     * workflow di approvazione). Ritorna '' se l'injector non e' pronto.
+     */
+    static getCurrentUserId(): string;
+    /**
+     * Username dell'utente autenticato corrente (stessa fonte di
+     * getCurrentUserId). Utile quando l'app ha una tabella utenti applicativa
+     * separata dai login (es. crm_users) mappata per username: i callback
+     * risolvono l'id applicativo cercando per username.
+     */
+    static getCurrentUsername(): string;
+    getCurrentUserId(): string;
+    getCurrentUsername(): string;
+    countRelatedRows(route: string, fkField: string, value: any, extraFilters?: Array<{
+        field: string;
+        operatore: string;
+        value: any;
+    }>): Promise<number>;
+    areWorkflowTasksDone(taskRoute: string, fkField: string, recordId: any, doneField: string): Promise<boolean>;
+    enqueueEmail(opts: {
+        to: string;
+        subject: string;
+        body?: string;
+        relatedRoute?: string;
+        relatedPk?: string | number;
+    }): Promise<any>;
     private static tr;
     /**
      * Salva nel runtime workflow il payload associato a uno specifico route node.
@@ -4518,6 +4789,85 @@ declare class WtoolboxService {
         route: string;
         action: string;
     } | null;
+    /**
+     * Navigazione condizionale guidata dal workflow. Da usare nel callback di
+     * un'azione di navigazione AL POSTO di una route hardcodata:
+     *
+     *   wtoolbox.navigateToNextStep(record, filterInfoJson, payload);
+     *
+     * La ROUTE del prossimo step viene scelta dal grafo workflow attivo:
+     * - se a valle dell'azione c'e' un nodo condition/switch, valuta le sue
+     *   guardie contro `context` (il record/selezione) e `payload` e segue il
+     *   ramo vincente;
+     * - altrimenti prende direttamente la route successiva del grafo.
+     * Applica anche il metadata overlay del ramo scelto e naviga passando `filter`
+     * come querystring `filterInfo` (oggetto o stringa JSON); se `filter` e' gia'
+     * una querystring `chiave=...` viene usata grezza.
+     *
+     * @param context Record/selezione corrente, passato al validatore della condition.
+     * @param filter  Payload filtro (oggetto o JSON string) o querystring grezza.
+     * @param payload Valore dell'azione corrente reso disponibile alle espressioni
+     *                di condition/switch come variabile `payload` (tipicamente lo
+     *                stesso valore poi consegnato a `resolve(...)` nel callback).
+     *                Le espressioni che citano `payload` sono deferite al momento
+     *                della scelta del ramo (il gate pre-click non le valuta).
+     * @returns `true` se ha risolto e avviato la navigazione; `false` se non c'e'
+     *          linking workflow attivo (il callback puo' gestire un fallback).
+     */
+    static navigateToNextStep(context?: any, filter?: any, payload?: any): boolean;
+    /**
+     * Invia (enqueue) una NOTIFICA server-side via `NotificationRealtimeService`
+     * (POST `Notifications/enqueue` -> righe in `_notifications` + push realtime
+     * a OGNI destinatario). Pensata per i callback utente
+     * (`wtoolbox.enqueueNotification({...})`), es. le azioni interne del workflow.
+     *
+     * Destinatari:
+     * - `userId`: singolo id o ARRAY di id utente;
+     * - `roleId`: singolo id o ARRAY di id ruolo — il server li risolve in utenti
+     *   (utenti.id_ruolo + utenti_ruoli, esclusi i cancellati) e fa fan-out;
+     * - senza destinatari espliciti: default l'utente corrente.
+     * Import dinamici per evitare cicli (il service importa WtoolboxService).
+     */
+    static enqueueNotification(payload: {
+        message: string;
+        userId?: number | number[];
+        roleId?: number | number[];
+        type?: string;
+        targetJson?: string;
+        payloadJson?: string;
+        source?: string;
+    }): Promise<boolean>;
+    /**
+     * F6 — conta le righe CORRELATE a un record su un'altra route (es. allegati
+     * di una fattura, task aperti di un onboarding). Pensata per i callback e le
+     * validazioni delle azioni workflow: `await wtoolbox.countRelatedRows(route,
+     * fkField, id)` (+ filtri extra opzionali in shape filterElement). Ritorna
+     * -1 su errore (i callback distinguano "0 righe" da "non verificabile").
+     */
+    static countRelatedRows(route: string, fkField: string, value: any, extraFilters?: Array<{
+        field: string;
+        operatore: string;
+        value: any;
+    }>): Promise<number>;
+    /**
+     * F5 — vero se TUTTI i task workflow correlati al record sono completati
+     * (nessuna riga con done_field = false). Usata dal template del parallel_join.
+     */
+    static areWorkflowTasksDone(taskRoute: string, fkField: string, recordId: any, doneField: string): Promise<boolean>;
+    /**
+     * F7 — accoda una email workflow nell'outbox server (`_wuic_mail_outbox`
+     * via `MetaService.enqueueWorkflowEmail`). L'invio reale avviene solo se
+     * l'app ha SMTP configurato (status `sent`), altrimenti la riga resta
+     * `logged` (simulazione demo). Ritorna `{ok, mo_id, status}` o `null` su
+     * errore. Usata dai callback delle azioni interne tipo 101 (Email).
+     */
+    static enqueueEmail(opts: {
+        to: string;
+        subject: string;
+        body?: string;
+        relatedRoute?: string;
+        relatedPk?: string | number;
+    }): Promise<any>;
     /**
      * Costruisce un contesto route/workflow utile ai CRUD hook host-side.
      * Include anche informazioni debug leggere per troubleshooting.
@@ -4644,6 +4994,9 @@ declare class WtoolboxService {
         }, field: MetadatiColonna, metaInfo: MetaInfo, newValue: any, oldValue: any, wtoolbox: typeof WtoolboxService, nestedIndex?: number, nodes?: any[]) => void;
         propsBag?: any;
         hide?: boolean;
+        suggest?: (record: {
+            [key: string]: BehaviorSubject<any>;
+        }, field: MetadatiColonna, metaInfo: MetaInfo, wtoolbox: typeof WtoolboxService) => any;
     }[], width?: string, height?: string, customValidation?: any): Promise<any>;
     private static openPromptDialogFallback;
     private static resolveDialogServiceFromInjector;
@@ -7636,7 +7989,11 @@ declare class NotificationRealtimeService {
     deleteRead(notificationId: number): Promise<void>;
     clearRead(userId?: number | null): Promise<void>;
     enqueue(payload: {
-        userId: number;
+        userId?: number;
+        /** Destinatari multipli (unione con userId). */
+        userIds?: number[];
+        /** Ruoli destinatari: il server li risolve in utenti (fan-out). */
+        roleIds?: number[];
         type?: string;
         message: string;
         targetJson?: string;
@@ -12382,6 +12739,223 @@ declare class LazyFieldEditorComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<LazyFieldEditorComponent, "wuic-field-editor-lazy", never, { "datasource": { "alias": "datasource"; "required": false; }; "record": { "alias": "record"; "required": false; }; "field": { "alias": "field"; "required": false; }; "metaInfo": { "alias": "metaInfo"; "required": false; }; "readOnly": { "alias": "readOnly"; "required": false; }; "isFilter": { "alias": "isFilter"; "required": false; }; "hideLabel": { "alias": "hideLabel"; "required": false; }; "forceShowLabel": { "alias": "forceShowLabel"; "required": false; }; "operator": { "alias": "operator"; "required": false; }; "nestedIndex": { "alias": "nestedIndex"; "required": false; }; "triggerProp": { "alias": "triggerProp"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "onInlineCellValueChange": { "alias": "onInlineCellValueChange"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+declare class PointFilterComponent {
+    /**
+     * Input dal componente padre per record; usata nella configurazione e nel rendering del componente.
+     */
+    record?: any;
+    /**
+     * Input dal componente padre per field; usata nella configurazione e nel rendering del componente.
+     */
+    field: MetadatiColonna;
+    /**
+     * Input dal componente padre per meta info; usata nella configurazione e nel rendering del componente.
+     */
+    metaInfo: MetaInfo;
+    /**
+     * Input dal componente padre per datasource; usata nella configurazione e nel rendering del componente.
+     */
+    datasource?: BehaviorSubject<DataSourceComponent>;
+    /**
+     * Riferimento a elementi o componenti figli usato dalla logica UI per map.
+     */
+    map?: GoogleMap;
+    /**
+     * Proprieta di stato del componente per dialog visible, usata dalla logica interna e dal template.
+     */
+    dialogVisible: boolean;
+    /**
+     * Proprieta di stato del componente per map center, usata dalla logica interna e dal template.
+     */
+    mapCenter: google.maps.LatLngLiteral;
+    /**
+     * Proprieta di stato del componente per map zoom, usata dalla logica interna e dal template.
+     */
+    mapZoom: number;
+    /**
+     * Modalita' di disegno corrente. Sostituisce `google.maps.drawing.DrawingManager`
+     * deprecato (Maps JavaScript API drawing library, deprecated 2025-08, removed
+     * in versions released starting 2026-05). Implementiamo polygon + circle
+     * manuali via click-handler diretti sulla mappa.
+     */
+    private drawingMode;
+    /**
+     * Listener registrati durante una sessione di drawing: vanno rimossi quando
+     * la sessione si conclude (overlaycomplete equivalente) o cambia modalita'.
+     */
+    private drawingListeners;
+    /**
+     * Stato intermedio per il disegno polygon: vertici accumulati al click,
+     * UX originale Google DrawingManager:
+     *   - 1° click → punto visibile (dot)
+     *   - click successivi → linea (polyline preview) + altri dot
+     *   - click sul 1° dot → chiude il poligono
+     *   - dblclick come alternativa di chiusura (compatibilita' con utenti
+     *     che si aspettano dblclick)
+     */
+    private polygonVertices;
+    /**
+     * Marker visibili per ogni vertice del polygon in draw (dot rossi).
+     * Tipo `any` perche' AdvancedMarkerElement non e' direttamente nei
+     * tipi `google.maps.*` esposti senza importLibrary('marker').
+     */
+    private polygonVertexMarkers;
+    /**
+     * Polyline di preview che collega i vertici durante il disegno.
+     * Si trasforma in `activePolygon` (closed shape) alla chiusura.
+     */
+    private polylinePreview?;
+    /**
+     * Stato intermedio per il disegno cerchio: center fissato al primo click,
+     * raggio calcolato live al mousemove, fissato al secondo click.
+     */
+    private circleCenter?;
+    private circleStage;
+    /**
+     * Valore corrente selezionato per active polygon, usato dai flussi interattivi del componente.
+     */
+    private activePolygon?;
+    /**
+     * Valore corrente selezionato per active circle, usato dai flussi interattivi del componente.
+     */
+    private activeCircle?;
+    /**
+     * Proprieta di stato del componente per pending operator, usata dalla logica interna e dal template.
+     */
+    pendingOperator: 'maparea' | 'mapdistance' | null;
+    /**
+     * Proprieta di stato del componente per pending value, usata dalla logica interna e dal template.
+     */
+    pendingValue: string | null;
+    /**
+* Gestisce comportamento UI tramite `openDialog` orchestrando le chiamate `setTimeout` e `initDrawingTools`.
+*/
+    openDialog(): void;
+    /**
+* Gestisce comportamento UI tramite `closeDialog` con il flusso specifico definito dalla sua implementazione.
+*/
+    closeDialog(): void;
+    /**
+     * Gestisce la logica di `initDrawingTools`. No-op nel nuovo path (i click
+     * handler vengono registrati on-demand in `drawArea`/`drawCircle`); il metodo
+     * resta per compatibilita' con i call site esistenti (es. `openDialog`).
+     */
+    initDrawingTools(): Promise<void>;
+    /**
+* Avvia il disegno di un'area poligonale: ogni click aggiunge un vertice,
+* il polygon di preview si aggiorna live, il doppio click chiude la forma
+* (richiede min 3 vertici). Sostituisce
+* `drawingManager.setDrawingMode(OverlayType.POLYGON)`.
+*
+* Note: il polygon di preview viene creato LAZY al primo click sulla mappa,
+* non subito al click del bottone. Pre-creare un polygon con `paths: []`
+* intercettava gli eventi `click` della mappa anche con `clickable: false`
+* e impediva al listener di firare → l'utente cliccava i bottoni e non
+* succedeva nulla.
+*/
+    drawArea(): void;
+    /**
+* Avvia il disegno di un cerchio: il primo click fissa il centro, il
+* mousemove successivo regola il raggio in tempo reale, il secondo click
+* lo conferma. Sostituisce `drawingManager.setDrawingMode(OverlayType.CIRCLE)`.
+*/
+    drawCircle(): void;
+    /**
+     * Attacca i listener click/mousemove/dblclick alla mappa Google.
+     * Schedule via `setTimeout` perche' alla prima apertura del dialog il
+     * `<google-map>` ViewChild puo' non aver ancora popolato `googleMap`
+     * (la libreria Maps si carica async). Riprova fino a 10 volte a 100ms.
+     */
+    private scheduleAttachMapListeners;
+    /**
+     * Effettiva attach dei listener. Chiamato da scheduleAttachMapListeners
+     * quando `googleMap` e' pronto.
+     */
+    private attachMapListeners;
+    /**
+     * Cambia il cursore della mappa per dare feedback visivo che la modalita'
+     * di disegno e' attiva (sostituisce il cursore drawingManager-managed).
+     */
+    private applyDrawingCursor;
+    /**
+     * Crea un AdvancedMarkerElement che rappresenta visivamente un vertice
+     * del polygon in fase di disegno (un piccolo dot rosso).
+     * Se `isFirst=true`, aggiunge un click handler per chiudere il polygon
+     * quando l'utente cliccher sul primo vertice (UX classica DrawingManager).
+     */
+    private createVertexMarker;
+    /**
+     * Chiude il polygon: trasforma la polyline preview + i dot vertex in un
+     * Polygon chiuso editabile e applica il filtro `maparea`.
+     */
+    private closePolygonFromFirstVertex;
+    /**
+     * Rimuove i listener registrati nella sessione di drawing corrente e
+     * resetta lo stato. Idempotente.
+     */
+    private exitDrawingMode;
+    /**
+     * Distanza Haversine in metri tra due `LatLng`. Replica
+     * `google.maps.geometry.spherical.computeDistanceBetween` senza forzare
+     * il caricamento della geometry library (che non e' importata da
+     * questo componente).
+     */
+    private haversineMeters;
+    /**
+* Applica aggiornamenti di stato tramite `applyFilter` con regole guidate dai metadati server `_Metadati_*` (tabella/colonna), preparando/aggiornando il dataset visualizzato.
+*
+* Se l'utente ha disegnato una shape ma non l'ha chiusa esplicitamente
+* (dblclick per polygon, 2° click per circle) prima di premere "Usa
+* filtro", finalizziamo qui la shape corrente — altrimenti il bottone
+* sembra non fare nulla. Il legacy `DrawingManager` chiudeva
+* automaticamente al click sul primo vertice (polygon) / drag-release
+* (circle); il path manual richiede una gesture esplicita che l'utente
+* non sempre conosce.
+*/
+    applyFilter(): Promise<void>;
+    /**
+* Gestisce la logica di `clearFilter` con regole guidate dai metadati server `_Metadati_*` (tabella/colonna), trasformando e filtrando collezioni dati.
+*
+* - Rimuove il filtro maparea/mapdistance dal `filterInfo.filters` per il
+*   campo corrente (match field-name case-insensitive per evitare
+*   mismatch di casing client/server).
+* - Resetta l'override `metaInfo.operators[<field>]` lasciato da
+*   `applyFilter` — altrimenti la UI continua a mostrare lo status
+*   "Filtro area pronto".
+* - Triggera `fetchData()` cosi' la query si rigenera senza il filtro:
+*   pre-fix il filtro spariva dalla UI ma il prossimo payload (e quindi
+*   l'SQL server-side) includeva ancora `operatore: 'maparea'`.
+*/
+    clearFilter(): Promise<void>;
+    /**
+* Gestisce la logica di `clearShapes` orchestrando le chiamate `setMap`.
+* Rimuove polygon + circle dalla mappa, esce da eventuale modalita' di
+* disegno attiva e svuota lo stato dei vertici accumulati.
+*/
+    clearShapes(): void;
+    /**
+* Gestisce la logica operativa di `toPolygonWkt` in modo coerente con l'implementazione corrente.
+* @param polygon Parametro utilizzato dal metodo nel flusso elaborativo.
+* @returns Stringa risultante calcolata da `toPolygonWkt` per chiavi/label o valori testuali.
+*/
+    private toPolygonWkt;
+    /**
+* Gestisce la logica operativa di `toCircleExpression` in modo coerente con l'implementazione corrente.
+* @param circle Parametro utilizzato dal metodo nel flusso elaborativo.
+* @returns Stringa risultante calcolata da `toCircleExpression` per chiavi/label o valori testuali.
+*/
+    private toCircleExpression;
+    /**
+* Gestisce la logica operativa di `extractCenterFromFilterValue` in modo coerente con l'implementazione corrente.
+* @param operator Parametro utilizzato dal metodo nel flusso elaborativo.
+* @param value Valore in ingresso elaborato o normalizzato dal metodo.
+* @returns Valore di tipo `{ lat: number; lng: number } | null` prodotto da `extractCenterFromFilterValue`.
+*/
+    private extractCenterFromFilterValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PointFilterComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PointFilterComponent, "wuic-point-filter", never, { "record": { "alias": "record"; "required": false; }; "field": { "alias": "field"; "required": false; }; "metaInfo": { "alias": "metaInfo"; "required": false; }; "datasource": { "alias": "datasource"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 /**
  * CodeEditorComponent (Monaco-based, ~3.4 MB) viene istanziato SOLO attraverso
  * il wrapper `LazyCodeEditorComponent`, che fa l'`import('./code-editor.component')`
@@ -12401,7 +12975,7 @@ declare class LazyFieldEditorComponent implements OnInit {
  *   `import('./code-editor.component')` dinamico → esbuild estrae Monaco +
  *   CodeEditorComponent + parser SQL/TS in un chunk separato caricato on-demand.
  */
-declare class CodeAreaEditorComponent {
+declare class CodeAreaEditorComponent implements OnInit {
     /**
      * Input dal componente padre per record; usata nella configurazione e nel rendering del componente.
      */
@@ -12445,6 +13019,13 @@ declare class CodeAreaEditorComponent {
    */
     constructor();
     /**
+     * `customEditorConfig.startInCodeView === true` -> il campo apre DIRETTAMENTE
+     * il code-editor (Monaco) invece della textarea col toggle manuale. Utile
+     * per i campi il cui valore e' sempre codice/JSON strutturato (es. effetti
+     * shader Scene3D, props bag con schema).
+     */
+    ngOnInit(): void;
+    /**
 * Gestisce comportamento UI tramite `toggleEditor` con regole guidate dai metadati server `_Metadati_*` (tabella/colonna).
 * @returns Esito booleano calcolato dal metodo.
 */
@@ -13020,6 +13601,10 @@ type WorkflowStartMenuItem = {
     mm_uri_menu: string;
     mm_ordine: number;
     mm_is_visible_by_default: boolean;
+    /** F8 — badge contatore: route da contare (es. la coda dello step). */
+    mm_badge_route?: string;
+    /** F8 — filterInfo JSON opzionale per il conteggio (array di filterElement). */
+    mm_badge_filter?: string;
     _Metadati_Utenti_Autorizzazioni_Menus: WorkflowMenuAuthorization[];
 };
 type WorkflowNodeSerialized = {
@@ -13037,14 +13622,35 @@ type WorkflowNodeSerialized = {
     }>;
     actionTypeId?: number;
     actionType?: string;
+    actionScopeId?: number;
+    /** Feature L — callback dell'azione INTERNA (concatenata), dal graph_json. */
+    actionCallback?: string;
     routeNodeId?: string;
     metadataTargetType?: 'table_action' | 'column_button' | '';
+    /** Feature I: espressione-guardia dei nodi condition (valutata come guardia di transizione). */
+    conditionExpression?: string;
+    /**
+     * Config del nodo SWITCH: formula JS (`expression`, corpo-funzione con
+     * `record` in scope) + case `{ key, label, condition }`. Le condizioni
+     * confrontano il risultato tramite il token `resultExpression`, sostituito a
+     * runtime con una IIFE della formula (vedi buildSwitchBranchGuard).
+     */
+    switchConfig?: {
+        expression: string;
+        cases: Array<{
+            key: string;
+            label: string;
+            condition: string;
+        }>;
+    } | null;
     metadataTargetId?: number;
     startMenus?: WorkflowStartMenuItem[];
     startMenuCaption?: string;
     startExclusiveMenu?: boolean;
     startShowExit?: boolean;
     routeMetadata?: any;
+    /** F5 — config del parallel_split (route task + mapping campi + rami). */
+    splitConfig?: any;
 };
 type WorkflowConnectionSerialized = {
     id?: string;
@@ -13052,9 +13658,14 @@ type WorkflowConnectionSerialized = {
     sourceOutput: string;
     target: string;
     targetInput: string;
+    /** Feature J: transizione di stato autorata sulla connessione (designer). */
+    transitionEvent?: string;
+    transitionGuard?: string;
+    transitionPermission?: string;
 };
 declare class WorkflowRunnerComponent implements OnInit, OnDestroy {
     private route;
+    private router;
     private dataSrv;
     private runtimeMetadataSrv;
     private runtimeMenuSrv;
@@ -13088,6 +13699,26 @@ declare class WorkflowRunnerComponent implements OnInit, OnDestroy {
      * Identificativo tecnico per route metadata by node id, usato in matching, lookup o routing interno.
      */
     routeMetadataByNodeId: Map<string, any>;
+    /**
+     * Bundle context-only del grafo (route metadata senza nodo corrispondente):
+     * tabelle fisiche bersaglio dei callback, registrate a runtime insieme ai
+     * bundle dei route-node.
+     */
+    contextRouteMetadata: {
+        route: string;
+        action: string;
+        metadata: any;
+    }[];
+    /**
+     * Prima route menu autorizzata per l'utente corrente (calcolata da
+     * applyRuntimeMenus): destinazione del redirect per gli utenti NON superadmin.
+     */
+    private firstAuthorizedRoute;
+    /**
+     * True mentre si sta reindirizzando un utente non-superadmin alla sua prima
+     * voce di menu: nasconde la vista di ispezione (riservata al superadmin).
+     */
+    redirecting: boolean;
     /**
      * Proprieta di stato del componente per param sub, usata dalla logica interna e dal template.
      */
@@ -13096,7 +13727,7 @@ declare class WorkflowRunnerComponent implements OnInit, OnDestroy {
      * Inietta le dipendenze runtime del runner:
      * route param source, provider dati workflow e servizi stato runtime (metadata/menu).
      */
-    constructor(route: ActivatedRoute, dataSrv: DataProviderService, runtimeMetadataSrv: WorkflowRuntimeMetadataService, runtimeMenuSrv: WorkflowRuntimeMenuService, userInfo: UserInfoService, trslSrv: TranslationManagerService);
+    constructor(route: ActivatedRoute, router: Router, dataSrv: DataProviderService, runtimeMetadataSrv: WorkflowRuntimeMetadataService, runtimeMenuSrv: WorkflowRuntimeMenuService, userInfo: UserInfoService, trslSrv: TranslationManagerService);
     private t;
     /**
      * Inizializza il componente preparando stato, sottoscrizioni e primi caricamenti richiesti.
@@ -13106,6 +13737,12 @@ declare class WorkflowRunnerComponent implements OnInit, OnDestroy {
      * Rilascia risorse e sottoscrizioni per evitare leak e stati pendenti.
      */
     ngOnDestroy(): void;
+    /**
+     * True se l'utente corrente e' superadmin (flag `ruoli.superadmin`). Solo il
+     * superadmin vede la vista di ispezione del runner; gli altri vengono
+     * reindirizzati alla prima voce di menu del workflow.
+     */
+    get isSuperAdmin(): boolean;
     /**
      * Restituisce il nodo `start` corrente del grafo caricato.
      */
@@ -13130,6 +13767,26 @@ declare class WorkflowRunnerComponent implements OnInit, OnDestroy {
      * poi pubblica il risultato su `runtimeMenuSrv`.
      */
     private applyRuntimeMenus;
+    /**
+     * Gate del runner: il superadmin resta sulla vista di ispezione; ogni altro
+     * utente viene reindirizzato alla prima voce di menu del workflow autorizzata
+     * per lui (fallback home `/` se il workflow non ne prevede nessuna). Usa
+     * `replaceUrl` perche' la pagina runner non deve restare nella history.
+     */
+    private maybeRedirectNonSuperadmin;
+    /**
+     * Prima route navigabile in un albero di `MenuItem` (DFS: scende nei figli,
+     * poi la route del nodo), escludendo la voce Esci (`route === '/'`). Ritorna
+     * null se nessuna voce ha una route utilizzabile.
+     */
+    private findFirstMenuLeafRoute;
+    /**
+     * F8 — risolve i badge contatore delle voci menu runtime (config stashata da
+     * buildStartMenuTree: `__badgeRoute` + `__badgeFilter`): un selectByRoute
+     * pageSize=1 per voce, `totalRowCount` come badge (nascosto se 0). Al termine
+     * ri-emette i menu per far ricostruire gli item al meta-menu. Best-effort.
+     */
+    private resolveStartMenuBadges;
     /**
      * Valuta la visibilita di una voce Start menu in base alle autorizzazioni:
      * priorita `utente+ruolo` > `utente` > `ruolo` > `globale`; fallback al default della voce.
@@ -13164,7 +13821,37 @@ declare class WorkflowRunnerComponent implements OnInit, OnDestroy {
      * Estrae le navigation action collegate a una table action:
      * risolve route sorgente/target dal grafo e allega metadata route target.
      */
+    /**
+     * Feature L — catene di azioni INTERNE (concatenate) a valle delle table
+     * action del grafo: per ogni action "trigger" (metadataTarget table_action,
+     * scope non interno) segue gli archi `out` verso nodi action con scope
+     * INTERNO (2) raccogliendo i callback in ordine. Le catene sono registrate
+     * nel runtime (`setLinkedInternalActions`) ed eseguite dal wrapper action del
+     * data-source DOPO il callback del trigger, passando il payload di ritorno.
+     */
+    private buildLinkedInternalActionEntries;
+    /**
+     * Feature J — gate delle TABLE ACTION per ruolo: un permesso autorato
+     * sull'arco route->action nasconde l'azione (rimossa dall'overlay dello step,
+     * `bundle.tableActions`) agli utenti che non lo soddisfano. Non tocca il
+     * metadata reale della route: vale solo dentro il workflow in esecuzione.
+     * Semantica distinta dal cammino action->...->route (che gata la NAVIGAZIONE).
+     */
+    private gateRouteNodeActionsByPermission;
     private buildLinkedActionRouteMetadataEntries;
+    /**
+     * Guardia di transizione di un RAMO del nodo switch, per SOSTITUZIONE: nella
+     * condizione del case il token `resultExpression` viene rimpiazzato con una
+     * IIFE della formula del nodo, cosi' l'espressione risultante e' valutabile
+     * dal consumer standard (`new Function('record', 'return (expr)')` in
+     * WorkflowRuntimeMetadataService.evaluateLinkedNavigationGuards).
+     *
+     * Esempio: formula `return record.x + record.y`, case `resultExpression <= 1`
+     * → guardia `((function(record){ return record.x + record.y })(record)) <= 1`.
+     * Ramo `else`: congiunzione delle negazioni di tutte le condizioni.
+     * Ritorna '' (nessuna guardia) se formula o condizione mancano.
+     */
+    private buildSwitchBranchGuard;
     /**
      * Normalizza il payload `loadWorkflowGraph` (string/object, alias legacy/nuovi):
      * produce nodi/connessioni tipizzati, metadata route per node id e nome workflow.
@@ -13217,6 +13904,14 @@ declare class NotificationBellComponent implements OnInit, OnDestroy {
     private resolveLabels;
     ngOnInit(): Promise<void>;
     ngOnDestroy(): void;
+    /**
+     * True per le notifiche "interne" del chatbot RAG (`rag.message.ready` /
+     * `rag.message.error`): NON sono voci utente del campanello, ma segnali che il
+     * componente chatbot usa per refreshare il messaggio in chat. Il bell le esclude
+     * da lista e badge; le `rag.engine.bootstrap.*` (started/ready/error) restano
+     * perche' sono feedback utente reale (download modelli in corso/pronto).
+     */
+    private isChatbotInternalNotification;
     clearRead(): Promise<void>;
     markAllRead(): Promise<void>;
     /**
@@ -13466,6 +14161,25 @@ declare class WorkflowDesignerRouteComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<WorkflowDesignerRouteComponent, "wuic-workflow-designer-route", never, {}, {}, never, never, true, never>;
 }
 
+declare class Scene3dDesignerRouteComponent implements OnInit {
+    private outlet?;
+    /** Componente designer runtime caricato lazy, usato dal template. */
+    loadedComponent: any;
+    ngOnInit(): Promise<void>;
+    /** Delega al designer runtime la conferma navigazione con pending changes. */
+    confirmNavigationWithPendingChanges(): Promise<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Scene3dDesignerRouteComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<Scene3dDesignerRouteComponent, "wuic-scene3d-designer-route", never, {}, {}, never, never, true, never>;
+}
+
+declare class Scene3dViewerRouteComponent implements OnInit {
+    /** Componente viewer runtime caricato lazy, usato dal template. */
+    loadedComponent: any;
+    ngOnInit(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Scene3dViewerRouteComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<Scene3dViewerRouteComponent, "wuic-scene3d-viewer-route", never, {}, {}, never, never, true, never>;
+}
+
 /**
  * Lazy wrapper di `<wuic-report-designer>`. Selector dedicato
  * `<wuic-report-designer-lazy>` per essere mountabile da template Angular
@@ -13917,6 +14631,12 @@ declare class DataRepeaterComponent implements OnInit, OnChanges, OnDestroy {
 
 declare const boundedRepeaterPendingChangesGuard: CanDeactivateFn<BoundedRepeaterComponent>;
 
+/**
+ * Guard di navigazione per il Scene3D Designer — mirror di designerPendingChangesGuard.
+ * Chiede conferma al designer runtime prima di lasciare la route con scena non salvata.
+ */
+declare const scene3dDesignerPendingChangesGuard: CanDeactivateFn<Scene3dDesignerRouteComponent>;
+
 declare const menuRouteAccessCanMatchGuard: CanMatchFn;
 declare const menuRouteAccessCanActivateGuard: CanActivateFn;
 
@@ -14467,7 +15187,27 @@ type RagProposedActionKind = 'toolbar_action' | 'row_action' | 'table_style' | '
  * Payload: `{kind, route, column_name, display_string, ui_column_type,
  * is_computed, real_column_name?, rationale}`.
  */
- | 'metadata_column_create';
+ | 'metadata_column_create'
+/**
+ * Iniezione/edit di nodi nel canvas del workflow-designer.
+ *
+ * NB: kind CLIENT-ONLY — NON viene applicato dal backend
+ * `RagController.ApplyAction` ma da un handler registrato dal
+ * workflow-designer.component via `ChatbotHostRegistryService`
+ * (`onChatbotProposedWorkflowAction`). Vedi
+ * docs/pages/_internal/workflow-tool-catalog.md per il catalogo dei tipi
+ * di nodo + config + constraint.
+ *
+ * Payload: `{ kind, action_type: 'inject'|'insert'|'set_property'|'remove'|
+ * 'connect'|'disconnect', nodes?: [{local_id, type, name?, route?, action?,
+ * actionTypeId?, actionScopeId?, x?, y?, conditionExpression?, switchConfig?,
+ * timerConfig?, splitConfig?, actionCallback?}], connections?/disconnect?:
+ * [{source, sourceOutput?, target, targetInput?}], node?/between? (insert),
+ * target_name?/prop_name?/value? (set_property/remove), rationale }`.
+ * Il chatbot popover bypassa `/api/Rag/ApplyAction` quando il registry ha un
+ * handler per questo kind.
+ */
+ | 'workflow_inject';
 interface RagProposedAction {
     kind: RagProposedActionKind | string;
     route?: string;
@@ -15758,6 +16498,19 @@ declare const AUTH_REDIRECT_REASON_KEY = "wuic_auth_redirect_reason";
  */
 declare const authExpiredInterceptor: HttpInterceptorFn;
 
+/**
+ * Quando una richiesta HTTP imposta questo token nel suo `HttpContext`,
+ * l'interceptor NON inoltra l'errore al `GlobalHandler` (niente dialog/toast
+ * globale): l'errore viene comunque normalizzato e rilanciato, ma la sua
+ * presentazione e' lasciata interamente al chiamante (es. il first-run wizard
+ * che mostra l'errore SOLO inline nel form). Default: false (comportamento
+ * standard col dialog globale).
+ *
+ * Uso:
+ *   import { HttpContext } from '@angular/common/http';
+ *   this.http.post(url, body, { context: new HttpContext().set(WUIC_SUPPRESS_GLOBAL_ERROR, true) });
+ */
+declare const WUIC_SUPPRESS_GLOBAL_ERROR: HttpContextToken<boolean>;
 /** Functional interceptor — preferred form for Angular 15+ withInterceptors. */
 declare const wuicErrorInterceptor: HttpInterceptorFn;
 /** Class interceptor — kept for legacy NgModule consumers. */
@@ -15853,5 +16606,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, CrashReporterService, CustomAttributesService, 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, WuicAziendaSwitcherComponent, WuicErrorDialogComponent, WuicErrorInterceptor, 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, wuicErrorInterceptor };
-export type { AuthSessionState, Breadcrumb, CompileDynamicComponentOptions, CrashReportPayload, CrashReportingConfig, CustomAttributeDefinition, CustomAttributeResolved, CustomLookupOption, CustomValue, CvUpsertItem, DataSourceAfterSyncEvent, DataSourceBeforeSyncEvent, DataSourceSyncOperation, ErrorDelegate, ErrorDelegateContext, IDataBoundHostComponent, IFieldEditor, KanbanStatusColumn, LicenseStatusResponse, ListGridAfterRenderEvent, ListGridAfterRowRenderEvent, ListGridBeforeRowRenderEvent, MultiDatasourceMeta, NotificationItem, NotifyOptions, RagApplyActionRequest, RagApplyActionResponse, RagAskAcceptedResponse, RagAskRequest, RagChatHistorySnapshot, RagChatMessageDto, RagChatMessageStatus, RagChatRequest, RagChatResponse, RagChatSessionDto, RagChatTurn, RagChatbotTurn, RagCompactRequest, RagCompactResponse, RagHealthResponse, RagProfile, RagProposedAction, RagProposedActionExtraField, RagProposedActionKind, RagQueryRequest, RagQueryResponse, RagRenameSessionRequest, RagRenameSessionResponse, RagSource, RagUpdateProposedActionRequest, RagUpdateProposedActionResponse, RealtimeProgressEvent, ThemeOption, ThemePresetName, ThemePrimaryName, WorkflowRuntimeLinkedActionRouteMetadataEntry, WorkflowRuntimePreviousRouteNodeEntry, WorkflowRuntimeRouteMetadataEntry, WorkflowRuntimeRouteNodePayloadEntry };
+export { AUTH_REDIRECT_REASON_KEY, AppSettingsEditorComponent, AuthSessionService, BooleanEditorComponent, BoundedRepeaterComponent, ButtonEditorComponent, CallbackPipe, CallbackPipe2, CarouselListComponent, CodeAreaEditorComponent, ColorEditorComponent, CrashReporterService, CustomAttributesService, 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, PointFilterComponent, PropertyArrayEditorComponent, PropertyObjectEditorComponent, Scene3dDesignerRouteComponent, Scene3dViewerRouteComponent, THEME_OPTIONS, TextAreaEditorComponent, TextEditorComponent, TranslationManagerService, TreeListComponent, TreeViewSelectorComponent, UploadDialogComponent, UploadEditorComponent, UserInfoService, ValidationRule, ValueChangedPayload, VisibleFieldListPipe, WUIC_SUPPRESS_GLOBAL_ERROR, WidgetDefinition, WorkflowDesignerRouteComponent, WorkflowRunnerComponent, WorkflowRuntimeMetadataService, WtoolboxService, WuicAziendaSwitcherComponent, WuicErrorDialogComponent, WuicErrorInterceptor, 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, scene3dDesignerPendingChangesGuard, wuicErrorInterceptor };
+export type { AuthSessionState, Breadcrumb, CompileDynamicComponentOptions, CrashReportPayload, CrashReportingConfig, CustomAttributeDefinition, CustomAttributeResolved, CustomLookupOption, CustomValue, CvUpsertItem, DataSourceAfterSyncEvent, DataSourceBeforeSyncEvent, DataSourceSyncOperation, ErrorDelegate, ErrorDelegateContext, IDataBoundHostComponent, IFieldEditor, KanbanStatusColumn, LicenseStatusResponse, ListGridAfterRenderEvent, ListGridAfterRowRenderEvent, ListGridBeforeRowRenderEvent, MultiDatasourceMeta, NotificationItem, NotifyOptions, RagApplyActionRequest, RagApplyActionResponse, RagAskAcceptedResponse, RagAskRequest, RagChatHistorySnapshot, RagChatMessageDto, RagChatMessageStatus, RagChatRequest, RagChatResponse, RagChatSessionDto, RagChatTurn, RagChatbotTurn, RagCompactRequest, RagCompactResponse, RagHealthResponse, RagProfile, RagProposedAction, RagProposedActionExtraField, RagProposedActionKind, RagQueryRequest, RagQueryResponse, RagRenameSessionRequest, RagRenameSessionResponse, RagSource, RagUpdateProposedActionRequest, RagUpdateProposedActionResponse, RealtimeProgressEvent, ThemeOption, ThemePresetName, ThemePrimaryName, WorkflowRuntimeInternalActionEntry, WorkflowRuntimeLinkedActionRouteMetadataEntry, WorkflowRuntimePreviousRouteNodeEntry, WorkflowRuntimeRouteMetadataEntry, WorkflowRuntimeRouteNodePayloadEntry };