wuic-framework-lib 0.1.0 → 0.3.1

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

@@ -3,7 +3,7 @@ import { ErrorHandler, Injector, OnInit, OnDestroy, AfterViewInit, EventEmitter,
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Subject, Observable, Subscription } from 'rxjs';
 import { MenuItem, MessageService, ConfirmationService, Confirmation, TreeNode, MegaMenuItem } from 'primeng/api';
-import { HttpClient } from '@angular/common/http';
+import { HttpClient, HttpInterceptorFn } from '@angular/common/http';
 import { Router, ActivatedRoute, CanDeactivateFn, CanActivateFn, CanMatchFn, Routes } from '@angular/router';
 import { CookieService } from 'ngx-cookie-service';
 import { TranslateService } from '@ngx-translate/core';
@@ -27,10 +27,10 @@ import { Select } from 'primeng/select';
 import { PrimeNG } from 'primeng/config';
 import { MonacoEditorComponent, MonacoEditorLoaderService } from '@materia-ui/ngx-monaco-editor';
 import { Popover } from 'primeng/popover';
+import * as wuic_framework_lib from 'wuic-framework-lib';
 import { StimulsoftDesignerComponent } from 'stimulsoft-designer-angular';
 import { StimulsoftViewerComponent } from 'stimulsoft-viewer-angular';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
-import * as wuic_framework_lib from 'wuic-framework-lib';
 
 declare class CustomException {
     title: string;
@@ -113,6 +113,8 @@ declare class FilterItem {
     __extra?: boolean;
     __descriptorManaged?: boolean;
     __querystring?: boolean;
+    __routefilter?: boolean;
+    __nestedroute?: boolean;
     nestedFilters?: FilterInfo;
     operator?: string;
     constructor(params: {
@@ -122,6 +124,8 @@ declare class FilterItem {
         fixed?: boolean;
         __extra?: boolean;
         __descriptorManaged?: boolean;
+        __routefilter?: boolean;
+        __nestedroute?: boolean;
     });
 }
 
@@ -172,12 +176,26 @@ declare class UserInfoService {
     private cookieService;
     constructor(cookieService: CookieService);
     /**
-     * Valuta una condizione booleana sullo stato o sull'input corrente.
-     * @returns Valore restituito dal metodo (boolean).
+     * Reads the user-info snapshot from sessionStorage. Returns `null` when
+     * absent or malformed. Used as the primary cache — the `k-user` cookie
+     * may be HttpOnly (server-managed mode) and is therefore not readable
+     * from JS.
+     */
+    private readFromStorage;
+    private writeToStorage;
+    private removeFromStorage;
+    /**
+     * Returns `true` when the UI has a cached user snapshot. Checks
+     * sessionStorage FIRST (works in both legacy and server-managed cookie
+     * modes) and falls back to the readable cookie (legacy-only path).
      */
     hasStoredUserInfo(): boolean;
     /**
-     * Pulisce lo stato runtime e le cache associate.
+     * Clears UI-side user state. Removes the sessionStorage snapshot and the
+     * JS-readable cookie. NOTE: when the backend runs in server-managed mode
+     * the HttpOnly `k-user` cookie cannot be deleted from JavaScript — the
+     * server-side logout endpoint (`MetaService.logoutSession`) must be
+     * invoked to emit a proper `Set-Cookie` delete header.
      */
     clearUserInfo(): void;
     /**
@@ -199,7 +217,22 @@ declare class UserInfoService {
         }[];
     } | null): boolean;
     /**
-     * Normalizza un payload utente eterogeneo e lo salva nel cookie `k-user` usato dal framework legacy.
+     * Normalizza un payload utente eterogeneo e lo salva come snapshot UI.
+     *
+     * Cambio di semantica vs la versione pre-cookie-auth-hardening:
+     *   - PRIMA scriveva solo nel cookie `k-user` via `CookieService.set`;
+     *   - ORA scrive PRIMA in sessionStorage (source of truth per la UI,
+     *     leggibile anche quando il cookie e' HttpOnly), POI prova a
+     *     scrivere anche il cookie — se il cookie HttpOnly esiste gia'
+     *     (server-managed mode), la scrittura JS viene silenziosamente
+     *     droppata dal browser senza errori, e non ci interessa: il cookie
+     *     di autenticazione e' gia' quello settato dal backend via
+     *     Set-Cookie.
+     *
+     * In legacy mode questa logica e' trasparente: la scrittura JS del
+     * cookie funziona ancora, il cookie e' l'autenticazione, sessionStorage
+     * e' solo un mirror per velocita'.
+     *
      * @param userLike Oggetto utente in formato libero (server/legacy/client).
      */
     setUserInfoCookie(userLike: any): void;
@@ -213,9 +246,12 @@ declare class UserInfoService {
      */
     getuserInfo(): UserInfo;
     /**
-   * Legge e deserializza il cookie `k-user` restituendo il profilo utente persistito dal login legacy.
-   * @returns Profilo utente oppure `null` se cookie assente/non valido.
-   */
+     * Read path: prefer sessionStorage (source of truth, works in both cookie
+     * modes) and fall back to the JS-readable cookie when sessionStorage is
+     * empty. In server-managed mode the cookie is HttpOnly and this fallback
+     * always returns `null`, so the caller must hydrate via
+     * `MetaService.me` at boot (see `AuthSessionService.refreshAll`).
+     */
     getStoredUserInfo(): UserInfo | null;
     setUserLanguage(languageId: string): UserInfo | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<UserInfoService, never>;
@@ -1624,6 +1660,15 @@ declare class MetadatiTabella {
     ProjectMetadataVersion: number;
     md_id: number;
     md_nome_tabella: string;
+    /**
+     * True quando la route metadata punta a una stored procedure invece di
+     * una tabella/vista. In questo caso il datasource fetcher dispatcha la
+     * read verso `MetaService.getFlatDataFromStored` invece di
+     * `MetaService.getFlatRecordData`, e i `parameterInfo` (derivati da
+     * `md_props_bag.parameters`) vengono inviati come `filterElement[]`
+     * con i placeholder `{{currentUser.*}}` interpolati lato client.
+     */
+    md_is_stored: boolean;
     md_editable: boolean;
     md_deletable: boolean;
     md_insertable: boolean;
@@ -2317,6 +2362,17 @@ declare class MetadataProviderService {
         castDate?: boolean;
         groupBy?: string;
     }>): Promise<any>;
+    /**
+     * Creates a DB VIEW from a multi-table view definition built by the
+     * View Builder canvas. Scaffolds the view as a new route so the
+     * existing pivot builder can operate on it.
+     */
+    createViewFromDefinition(viewDefinition: any, viewName?: string, targetSchema?: string, createMenu?: boolean, parentMenuId?: number, overwriteIfExists?: boolean, scaffold?: boolean, manualSql?: string): Promise<any>;
+    /**
+     * Executes a SELECT query from a ViewDefinition without creating a DB view.
+     * Returns { ok, sql, columns, rows }.
+     */
+    previewViewDefinition(viewDefinition: any, maxRows?: number, generateOnly?: boolean, filterInfo?: any, manualSql?: string): Promise<any>;
     createPivotView(route: string, rowColumns: string[], columnColumns: string[], valueColumns: string[] | string, aggregateFunction?: string, valueDefinitions?: Array<{
         alias: string;
         aggregateFunction?: string;
@@ -2366,6 +2422,10 @@ declare class MetadataProviderService {
      * @returns Payload backend normalizzato.
      */
     listPivotConfigurations(route?: string | null): Promise<any>;
+    getViewBuilderForeignKeys(): Promise<{
+        source: string;
+        target: string;
+    }[]>;
     private tryParseJsonPayload;
     /**
      * Esegue il bootstrap dei custom settings in localStorage subito dopo login/session bootstrap.
@@ -2496,10 +2556,43 @@ declare class DataProviderOdataService {
 declare class DataProviderMetaService {
     private _http;
     http: HttpClient;
+    private userInfoService;
     /**
      * Inizializza il provider dati metadata con l'istanza `HttpClient` usata da tutti gli endpoint `MetaService.*`.
      */
     constructor(_http: HttpClient);
+    /**
+     * Risolve i placeholder di tipo `{{path.to.value}}` su un oggetto sorgente.
+     * Supporta path annidati con dot-notation. Esempi:
+     *   - `{{currentUser.lingua.id}}` -> `userInfo.lingua.id`
+     *   - `{{currentUser.user_id}}` -> `userInfo.user_id`
+     * Se il valore non e una stringa o non contiene placeholder, viene
+     * ritornato invariato. Se la risoluzione fallisce, il placeholder viene
+     * lasciato vuoto (stringa vuota) per evitare di propagare il template
+     * letterale al backend.
+     *
+     * Usato per interpolare i `parameters[].value` di una SP route prima di
+     * inviarli a `MetaService.getFlatDataFromStored`.
+     */
+    private interpolateUserPlaceholders;
+    /**
+     * Costruisce la lista `filterElement[]` per un fetch SP-route a partire
+     * dai `parameterInfo` (derivati da `md_props_bag.parameters`) gia
+     * popolati in `tableMetadata.parameterInfo` da `MetadataProviderService.prepareMetadatas`.
+     *
+     * Per ogni parameter declarato:
+     *   1. legge il `value` dal raw `md_props_bag.parameters[i].value` (gli
+     *      `extraProps.parameters` raw sono accessibili via
+     *      `tableMetadata.extraProps.parameters`),
+     *   2. interpola i placeholder `{{currentUser.*}}`,
+     *   3. emette un `filterElement` con `field=Name`, `value=interpolated`,
+     *      `Type`, `isOut`.
+     *
+     * Il backend `GetFlatDataFromStored` matcha il `field` (case-insensitive,
+     * con/senza `@` prefix) col parameter Name in `mdpropsbag.parameters` e
+     * lo bind via Dapper DynamicParameters.
+     */
+    private buildStoredParametersPayload;
     /**
      * Pulisce la cache localStorage preservando le traduzioni gia caricate.
      * Evita regressioni UX dove, dopo save metadata non-translation, le label tornano alle chiavi raw.
@@ -4031,6 +4124,7 @@ declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDa
     private trslSrv;
     private cd;
     userInfo: UserInfoService;
+    private elementRef;
     private static readonly FORCED_VIRTUALIZATION_PAGE_SIZE_THRESHOLD;
     private static readonly FORCED_VIRTUALIZATION_ITEM_SIZE;
     private static readonly ACTION_BUTTON_VISIBLE_ROWS_OVERSCAN;
@@ -4097,6 +4191,9 @@ declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDa
     columnCtxMenu: ContextMenu;
     metadataColumnsDatasource: DataSourceComponent;
     gridContainerRef?: ElementRef<HTMLElement>;
+    /** ResizeObserver per esporre --wuic-outer-thead-h alle nested grid figlie. */
+    private outerTheadResizeObserver?;
+    private outerTheadObserveRetryTimer?;
     records: any[];
     cols: any[];
     metas: MetadatiColonna[];
@@ -4205,7 +4302,7 @@ declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDa
      * @param cd Parametro in ingresso utilizzato per determinare il flusso operativo del metodo.
      * @param userInfo Parametro in ingresso utilizzato per determinare il flusso operativo del metodo.
      */
-    constructor(metaSrv: MetadataProviderService, sanitizer: DomSanitizer, route: ActivatedRoute, router: Router, location: Location, titleService: Title, trslSrv: TranslationManagerService, cd: ChangeDetectorRef, userInfo: UserInfoService);
+    constructor(metaSrv: MetadataProviderService, sanitizer: DomSanitizer, route: ActivatedRoute, router: Router, location: Location, titleService: Title, trslSrv: TranslationManagerService, cd: ChangeDetectorRef, userInfo: UserInfoService, elementRef: ElementRef<HTMLElement>);
     /**
      * Inizializza il componente preparando stato, sottoscrizioni e primi caricamenti richiesti.
      */
@@ -4218,6 +4315,15 @@ declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDa
      * Completa inizializzazione dopo il rendering della view e collega riferimenti UI.
      */
     ngAfterViewInit(): void;
+    /**
+     * Espone l'altezza del thead OUTER (top-level grid) come CSS var `--wuic-outer-thead-h`
+     * sull'host element, per permettere a `position: sticky; top: var(...)` sull'inner thead
+     * di lasciare spazio sotto l'header outer (anch'esso sticky a top:0).
+     *
+     * Si attiva SOLO sulla grid root (non nested): le inner ListGridComponent leggono la var
+     * via cascade CSS dall'ancestor `wuic-list-grid` piu vicino, che corrisponde all'outer.
+     */
+    private observeOuterTheadHeight;
     /**
      * Ricalcola l'altezza disponibile della grid al resize finestra.
      */
@@ -4245,6 +4351,7 @@ declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDa
      * Restituisce le classi della p-table includendo il profilo inline-cell-editing.
      */
     getTableStyleClass(): string;
+    private isNestedGridInstance;
     private isInlineEditEnabled;
     /**
      * Gestisce la logica operativa di `subscribeToDS` in modo coerente con l'implementazione corrente.
@@ -4933,6 +5040,11 @@ declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDa
      * @param stateId Identificativo tecnico usato per lookup, match o aggiornamento mirato.
      */
     applySelectedGridState(stateId?: string): Promise<void>;
+    /**
+     * Unisce i filtri dello stato salvato con i filtri runtime "fissi" (route/nested),
+     * evitando che apply state perda il vincolo master-detail.
+     */
+    private mergeSavedFilterInfoWithRuntimeFixedFilters;
     /**
      * Apre il popup di rinomina per lo stato corrente selezionato.
      */
@@ -5510,6 +5622,11 @@ interface AdvancedFilterRule {
 type AdvancedFilterNode = AdvancedFilterRule | {
     nestedFilters: AdvancedFilterGroup;
 };
+interface MultiDatasourceMeta {
+    tableAlias: string;
+    tableCaption: string;
+    metaInfo: MetaInfo;
+}
 declare class FilterBarComponent implements OnInit, OnChanges, OnDestroy {
     private router;
     private aroute;
@@ -5517,6 +5634,7 @@ declare class FilterBarComponent implements OnInit, OnChanges, OnDestroy {
     private trnsl;
     datasource: BehaviorSubject<DataSourceComponent>;
     hardcodedDatasource: DataSourceComponent;
+    multiDatasourceMetas: MultiDatasourceMeta[];
     filterApplied: EventEmitter<void>;
     onFilterApplied: EventEmitter<{
         mode: "basic" | "advanced" | "clear";
@@ -5582,11 +5700,14 @@ declare class FilterBarComponent implements OnInit, OnChanges, OnDestroy {
     constructor(router: Router, aroute: ActivatedRoute, location: Location, trnsl: TranslationManagerService);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    private mergeMultiDatasourceColumns;
+    get isMultiDatasourceMode(): boolean;
     ngOnDestroy(): void;
     private bindToDatasource;
     private subscribeToDatasource;
     private isFilterable;
     filter(): Promise<void>;
+    private buildMultiDatasourceFilterInfo;
     clearFilter(): Promise<void>;
     addGroupField(): void;
     addAggregateField(): void;
@@ -5650,7 +5771,7 @@ declare class FilterBarComponent implements OnInit, OnChanges, OnDestroy {
     private syncGridStateQueryString;
     private resetCursorPagingState;
     static ɵfac: i0.ɵɵFactoryDeclaration<FilterBarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FilterBarComponent, "wuic-filter-bar", never, { "datasource": { "alias": "datasource"; "required": false; }; "hardcodedDatasource": { "alias": "hardcodedDatasource"; "required": false; }; }, { "filterApplied": "filterApplied"; "onFilterApplied": "onFilterApplied"; "onSortingApplied": "onSortingApplied"; "onPageSizeApplied": "onPageSizeApplied"; "onGroupingChanged": "onGroupingChanged"; "onFilterBarCollapseChanged": "onFilterBarCollapseChanged"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FilterBarComponent, "wuic-filter-bar", never, { "datasource": { "alias": "datasource"; "required": false; }; "hardcodedDatasource": { "alias": "hardcodedDatasource"; "required": false; }; "multiDatasourceMetas": { "alias": "multiDatasourceMetas"; "required": false; }; }, { "filterApplied": "filterApplied"; "onFilterApplied": "onFilterApplied"; "onSortingApplied": "onSortingApplied"; "onPageSizeApplied": "onPageSizeApplied"; "onGroupingChanged": "onGroupingChanged"; "onFilterBarCollapseChanged": "onFilterBarCollapseChanged"; }, never, never, true, never>;
 }
 
 declare class DynamicGenericTemplateComponent {
@@ -5658,6 +5779,10 @@ declare class DynamicGenericTemplateComponent {
      * Input dal componente padre per row data; usata nella configurazione e nel rendering del componente.
      */
     rowData: any;
+    /**
+     * Input dal componente padre per record (alias di rowData); usata nella configurazione e nel rendering del componente.
+     */
+    record: any;
     /**
      * Input dal componente padre per columns; usata nella configurazione e nel rendering del componente.
      */
@@ -5683,31 +5808,31 @@ declare class DynamicGenericTemplateComponent {
      */
     MetadatiColonna: typeof MetadatiColonna;
     /**
-* Individua l'elemento richiesto in `findColumn` applicando i criteri di matching implementati.
-* @param columnName Parametro utilizzato dal metodo nel flusso elaborativo.
-* @returns Valore di tipo `MetadatiColonna | null` prodotto da `findColumn`.
-*/
+  * Individua l'elemento richiesto in `findColumn` applicando i criteri di matching implementati.
+  * @param columnName Parametro utilizzato dal metodo nel flusso elaborativo.
+  * @returns Valore di tipo `MetadatiColonna | null` prodotto da `findColumn`.
+  */
     findColumn(columnName: string): MetadatiColonna | null;
     /**
-* Recupera i dati/valori richiesti da `getFieldValue`.
-* @param record Dato/record su cui il metodo applica elaborazioni o aggiornamenti.
-* @param fieldName Parametro utilizzato dal metodo nel flusso elaborativo.
-* @returns Valore risolto da `getFieldValue` in base ai criteri implementati.
-*/
+  * Recupera i dati/valori richiesti da `getFieldValue`.
+  * @param record Dato/record su cui il metodo applica elaborazioni o aggiornamenti.
+  * @param fieldName Parametro utilizzato dal metodo nel flusso elaborativo.
+  * @returns Valore risolto da `getFieldValue` in base ai criteri implementati.
+  */
     getFieldValue(record: any, fieldName: string): any;
     /**
- * Gestisce la logica operativa di `classes` usando metadati di tabella/colonna allineati al modello server `_Metadati_*`.
- * @returns Valore calcolato dinamicamente a partire dallo stato corrente del componente.
- */
+  * Gestisce la logica operativa di `classes` usando metadati di tabella/colonna allineati al modello server `_Metadati_*`.
+  * @returns Valore calcolato dinamicamente a partire dallo stato corrente del componente.
+  */
     get classes(): string | null;
     /**
-* Recupera i dati/valori richiesti da `getComponentFromTemplate`.
-* @param template Parametro utilizzato dal metodo nel flusso elaborativo.
-* @returns Valore risolto da `getComponentFromTemplate` in base ai criteri implementati.
-*/
+  * Recupera i dati/valori richiesti da `getComponentFromTemplate`.
+  * @param template Parametro utilizzato dal metodo nel flusso elaborativo.
+  * @returns Valore risolto da `getComponentFromTemplate` in base ai criteri implementati.
+  */
     static getComponentFromTemplate(template: string): typeof DynamicGenericTemplateComponent;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicGenericTemplateComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicGenericTemplateComponent, "wuic-dynamic-generic-template", never, { "rowData": { "alias": "rowData"; "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; }; }, {}, never, never, false, 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; }; }, {}, never, never, false, never>;
 }
 
 interface IBindable {
@@ -6985,11 +7110,20 @@ declare class MapListComponent implements OnInit, IBindable, IDesigner<MapOption
     private setPolygonEditability;
     private getVerticesFromMapPolygon;
     /**
-     * Converte una geometria WKT polygon (es. `POLYGON((lng lat,...))` o `POLYGON ((lng lat,...))`)
-     * in un array di vertici Google Maps (`{lat,lng}`), scartando coordinate invalide.
+     * Converte una geometria WKT polygon (`POLYGON((lng lat,...))`,
+     * `POLYGON((outer),(hole))`) o multi-polygon
+     * (`MULTIPOLYGON(((p1)),((p2),(hole)))`) in un array di RING di vertici
+     * Google Maps (`LatLngLiteral[][]`), scartando coordinate invalide.
+     *
+     * Ogni ring e' una sequenza chiusa: outer, holes e sub-polygon vengono
+     * appiattiti a livello di array di array, in modo che possa essere passato
+     * direttamente a `<map-polygon [paths]>`. Cosi' una singola istanza di
+     * map-polygon disegna correttamente sub-polygon disgiunti (es. esclavi,
+     * isole) e holes, senza tracciare linee diagonali "ponte" tra i ring.
+     *
      * Compatibile con output MySQL/SQLServer e con prefisso opzionale `SRID=...;`.
      */
-    private parsePolygonVertices;
+    private parsePolygonRings;
     /**
      * Serializza una lista vertici `{lat,lng}` nel formato WKT `POLYGON` usato per il salvataggio.
      * @param vertices Vertici del poligono in ordine di percorrenza.
@@ -7219,10 +7353,10 @@ declare class CarouselListComponent implements IBindable, IDesigner<CarouselOpti
      */
     ngOnDestroy(): void;
     /**
-* Interpreta e normalizza input/configurazione in `parseData` per l'utilizzo nel componente.
-* @param dato Collezione in ingresso processata dal metodo.
-* @returns Struttura dati prodotta da `parseData` dopo normalizzazione/elaborazione.
-*/
+  * Interpreta e normalizza input/configurazione in `parseData` per l'utilizzo nel componente.
+  * @param dato Collezione in ingresso processata dal metodo.
+  * @returns Struttura dati prodotta da `parseData` dopo normalizzazione/elaborazione.
+  */
     parseData(dato: any[]): any[];
     /**
      * Apre il popup di configurazione caricando prima i valori correnti dal `md_props_bag`
@@ -7230,9 +7364,9 @@ declare class CarouselListComponent implements IBindable, IDesigner<CarouselOpti
      */
     openConfigDialog(): void;
     /**
-* Applica aggiornamenti di stato tramite `applyConfig` mantenendo coerenti UI e dati.
-* @param nextConfig Parametro utilizzato dal metodo nel flusso elaborativo.
-*/
+  * Applica aggiornamenti di stato tramite `applyConfig` mantenendo coerenti UI e dati.
+  * @param nextConfig Parametro utilizzato dal metodo nel flusso elaborativo.
+  */
     applyConfig(nextConfig?: any): void;
     /**
      * Salva nel metadata tabella (`md_props_bag`) la configurazione carousel corrente
@@ -7262,9 +7396,9 @@ declare class CarouselListComponent implements IBindable, IDesigner<CarouselOpti
      */
     suggestItemTemplate(): void;
     /**
-* Applica aggiornamenti di stato tramite `applyPageSizeChange` preparando/aggiornando il dataset visualizzato.
-* @param value Valore in ingresso elaborato o normalizzato dal metodo.
-*/
+  * Applica aggiornamenti di stato tramite `applyPageSizeChange` preparando/aggiornando il dataset visualizzato.
+  * @param value Valore in ingresso elaborato o normalizzato dal metodo.
+  */
     applyPageSizeChange(value?: number): void;
     /**
      * Allinea la bozza `configDraft` alle opzioni effettive del carousel,
@@ -7288,10 +7422,10 @@ declare class CarouselListComponent implements IBindable, IDesigner<CarouselOpti
      */
     private ensureMergedExtraProps;
     /**
-* Carica dati e li armonizza per l'uso nel componente usando i metadati per determinare campi, chiavi e comportamento runtime, allineando i record al formato atteso dal framework, coordinando chiamate verso servizi applicativi.
-* @param userId Identificativo tecnico usato per lookup, confronto o aggiornamento mirato.
-* @returns Promise che completa il flusso asincrono e restituisce un risultato di tipo `Promise<any | null>`.
-*/
+  * Carica dati e li armonizza per l'uso nel componente usando i metadati per determinare campi, chiavi e comportamento runtime, allineando i record al formato atteso dal framework, coordinando chiamate verso servizi applicativi.
+  * @param userId Identificativo tecnico usato per lookup, confronto o aggiornamento mirato.
+  * @returns Promise che completa il flusso asincrono e restituisce un risultato di tipo `Promise<any | null>`.
+  */
     private loadCurrentTableMetadataRecord;
     private scheduleVisibilitySync;
     private refreshItemVisibilityObserver;
@@ -8465,6 +8599,119 @@ declare class ParametricDialogComponent implements OnDestroy, IDataBoundHostComp
     static ɵcmp: i0.ɵɵComponentDeclaration<ParametricDialogComponent, "wuic-parametric-dialog", never, { "datasource": { "alias": "datasource"; "required": false; }; "hardcodedDatasource": { "alias": "hardcodedDatasource"; "required": false; }; "hideToolbar": { "alias": "hideToolbar"; "required": false; }; "isWizard": { "alias": "isWizard"; "required": false; }; "isEditForm": { "alias": "isEditForm"; "required": false; }; "readOnly": { "alias": "readOnly"; "required": false; }; }, { "onDialogDataBound": "onDialogDataBound"; "onDialogTabChange": "onDialogTabChange"; "onWizardStepChange": "onWizardStepChange"; "onDialogCustomAction": "onDialogCustomAction"; "onDialogSubmit": "onDialogSubmit"; "onDialogRollback": "onDialogRollback"; "onDialogCloseRequested": "onDialogCloseRequested"; }, never, never, true, never>;
 }
 
+/**
+ * Tipo di campo riconosciuto dal renderer. Allineato alla `FieldType` enum
+ * del backend `AppSettingsController`.
+ */
+type FieldType = 'string' | 'bool' | 'int' | 'password' | 'longtext';
+/**
+ * Livello di impatto di una modifica. Allineato alla `ChangeImpact` enum del
+ * backend, in lower-case (serializzazione JSON di ToString().ToLowerInvariant()).
+ */
+type ChangeImpact = 'hotreload' | 'restart' | 'restartandlogout';
+interface AppSettingFieldDef {
+    key: string;
+    label: string;
+    type: FieldType;
+    impact: ChangeImpact;
+    description?: string | null;
+    value: any;
+    /**
+     * If non-empty, render a `<p-select>` constrained to these values instead
+     * of the free-text input dictated by `type`. The backend populates this
+     * for enum-like settings (dbms, encriptionMethod, log levels, etc.) so the
+     * user can't accidentally write `mssqll` and brick the next backend boot.
+     */
+    options?: string[] | null;
+}
+interface AppSettingSection {
+    name: string;
+    label: string;
+    icon: string;
+    fields: AppSettingFieldDef[];
+}
+interface SaveChange {
+    key: string;
+    oldValue: any;
+    newValue: any;
+}
+/**
+ * Editor visuale per `appsettings.json` organizzato in tab per sezione.
+ *
+ * Architettura: il componente carica lo schema (campi + valori correnti) da
+ * `GET /api/AppSettings/Get`, mantiene un `pristine` snapshot per calcolare il
+ * diff, e su "Save & Apply" POSTa solo le modifiche a `POST /api/AppSettings/Save`.
+ *
+ * Il backend classifica le modifiche in tre livelli (`hotreload`, `restart`,
+ * `restartandlogout`) — il componente reagisce di conseguenza:
+ * - **hotreload**: mostra toast di successo, aggiorna pristine, end of story.
+ * - **restart**: mostra overlay "Backend is restarting...", polla `Health` ogni
+ *   500ms fino a che il backend torna su, ricarica lo schema, mostra toast.
+ * - **restartandlogout**: come `restart`, ma al ritorno forza il logout
+ *   chiamando `AuthSessionService.legacyLogout()` + redirect a `/`.
+ *
+ * NOTA architetturale: questo NON e' un metadata-bound parametric-dialog perche'
+ * `appsettings.json` non ha backing DB e creare una route metadata fittizia con
+ * tabella DB virtuale + 50 colonne in `_metadati__colonne` aggiungerebbe ~3x il
+ * codice senza alcun vantaggio funzionale. La UI usa lo stesso `<p-tabs>` di
+ * PrimeNG che usa il parametric-dialog, quindi visivamente sono indistinguibili.
+ */
+declare class AppSettingsEditorComponent implements OnInit {
+    private readonly http;
+    private readonly authSession;
+    private readonly router;
+    readonly loading: i0.WritableSignal<boolean>;
+    readonly saving: i0.WritableSignal<boolean>;
+    readonly waitingRestart: i0.WritableSignal<boolean>;
+    readonly errorMsg: i0.WritableSignal<string>;
+    readonly sections: i0.WritableSignal<AppSettingSection[]>;
+    readonly filePath: i0.WritableSignal<string>;
+    private pristine;
+    current: Map<string, any>;
+    readonly activeTabValue: i0.WritableSignal<number>;
+    readonly pendingChanges: i0.Signal<SaveChange[]>;
+    readonly hasPendingChanges: i0.Signal<boolean>;
+    readonly pendingChangesCount: i0.Signal<number>;
+    private readonly changeTick;
+    ngOnInit(): Promise<void>;
+    private apiUrl;
+    private buildApiBaseUrl;
+    private loadSchema;
+    private rebuildMaps;
+    /**
+     * Trasforma il valore raw che arriva dal backend in un valore tipizzato
+     * stabile per il binding ngModel. Questo evita falsi diff dovuti a
+     * confronto string-vs-number o "true"-vs-true.
+     */
+    private normalizeValueForType;
+    private valuesEqual;
+    /**
+     * Bind handler per ngModel sui field. Aggiorna current e bumpa il tick
+     * cosi' il computed pendingChanges si rivaluta.
+     */
+    onFieldChange(key: string, newValue: any): void;
+    fieldValue(key: string): any;
+    impactSeverity(impact: ChangeImpact): 'success' | 'warn' | 'danger';
+    impactLabel(impact: ChangeImpact): string;
+    /**
+     * Custom action "Save & Apply": calcola il diff (== _changes), lo POSTa,
+     * legge la classification dalla response e reagisce di conseguenza.
+     *
+     * - hotreload: toast + aggiorna pristine.
+     * - restart: overlay + poll Health + reload schema.
+     * - restartandlogout: overlay + poll Health + force logout.
+     */
+    onSaveAndApply(): Promise<void>;
+    onResetChanges(): Promise<void>;
+    onReload(): Promise<void>;
+    private confirmDiscardChanges;
+    private sleep;
+    private waitForHealth;
+    private forceLogout;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AppSettingsEditorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AppSettingsEditorComponent, "wuic-app-settings-editor", never, {}, {}, never, never, true, never>;
+}
+
 declare class DataActionButtonComponent implements AfterViewInit, OnDestroy {
     private trslSrv;
     private cd;
@@ -8689,6 +8936,29 @@ declare class AuthSessionService {
      * @param force Se `true` forza una nuova inizializzazione anche se gia avvenuta.
      */
     initialize(force?: boolean): Promise<void>;
+    /**
+     * Hydrates the UI-side user snapshot from the backend when sessionStorage
+     * is empty but a server-managed HttpOnly `k-user` cookie might still be
+     * valid. This is the critical step for `enableCookieAuthentication=true`:
+     * after a browser restart (or new tab) sessionStorage is gone, the cookie
+     * is HttpOnly and invisible to JS, so without this call the guard would
+     * wrongly redirect to `/unauthorized` despite a valid session.
+     *
+     * Flow:
+     *   1. If sessionStorage already has a snapshot → no hydration needed.
+     *   2. Otherwise call `MetaService.me` with `withCredentials:true`. The
+     *      backend reads the HttpOnly cookie server-side and returns the
+     *      public user fields (and `cookieAuthEnabled` for introspection).
+     *   3. If `me()` returns a populated payload, write it to sessionStorage
+     *      via `userInfoService.setUserInfoCookie` so subsequent calls see
+     *      the user. If `me()` returns an empty object `{}` (no valid
+     *      cookie) the hydration is a no-op and the UI stays logged out.
+     *
+     * Errors are swallowed on purpose: if `me()` throws (network, backend
+     * down, legacy backend without the endpoint), we fall back to whatever
+     * the cookie/sessionStorage already has without blocking the boot.
+     */
+    private hydrateFromServerCookie;
     /**
      * Ricalcola lo stato autenticazione combinando configurazione OAuth, endpoint `Auth/Enabled`, endpoint `Auth/Me`
      * e fallback sessione legacy (`k-user`), poi sincronizza eventuali custom settings utente.
@@ -8717,7 +8987,29 @@ declare class AuthSessionService {
      */
     legacyLogin(username: string, password: string, captchaToken?: string): Promise<boolean>;
     /**
-     * Esegue logout legacy via `MetaService.logout` (se presente utente), poi ripulisce runtime locale e ricarica stato sessione.
+     * Logout flow that works in BOTH cookie modes:
+     *
+     *  - **Server-managed mode** (`enableCookieAuthentication=true`): the
+     *    `k-user` cookie is HttpOnly, so the only way to delete it is via a
+     *    `Set-Cookie` delete header from the server. We call
+     *    `MetaService.logoutSession` (parameterless) which:
+     *      1. derives the user from the cookie server-side,
+     *      2. wipes the DB session token via the existing `logout(user)`
+     *         per-DBMS dispatcher,
+     *      3. emits the `Set-Cookie` delete with matching CookieOptions.
+     *
+     *  - **Legacy mode** (`enableCookieAuthentication=false`): we still call
+     *    `logoutSession` because the server-side helper is idempotent in
+     *    legacy mode and always wipes the DB token. The local
+     *    `userInfoService.clearUserInfo()` then deletes the JS-readable
+     *    cookie + sessionStorage snapshot.
+     *
+     * Why not call the legacy `MetaService.logout(user)` overload? It only
+     * runs the per-DBMS DB cleanup; it does NOT emit the cookie delete
+     * header, so the HttpOnly cookie would survive the logout in
+     * server-managed mode and the next page load would re-hydrate the
+     * supposedly-logged-out user via `MetaService.me`. The new
+     * `logoutSession` does both atomically.
      */
     legacyLogout(): Promise<void>;
     /**
@@ -8767,6 +9059,21 @@ declare class AuthSessionService {
      * Applica un aggiornamento parziale allo stato `AuthSessionState` preservando le proprieta non toccate.
      * @param partial Delta stato da fondere con lo stato corrente.
      */
+    /**
+     * Sets a user-visible error message in the auth state.
+     * Used by the auth-expired interceptor to communicate the logout
+     * reason (e.g. "session replaced by another login") after the
+     * logout flow has completed and the login form is visible.
+     */
+    setError(message: string): void;
+    /** User-facing messages keyed by server reason code. */
+    private static readonly REASON_MESSAGES;
+    /**
+     * Reads and removes the redirect reason left by the auth-expired
+     * interceptor in localStorage, then sets the corresponding error
+     * message in the auth state so the login form displays it.
+     */
+    private applyRedirectReason;
     private patchState;
     /**
      * Costruisce una struttura derivata a partire dallo stato corrente.
@@ -13540,6 +13847,7 @@ interface DocsSection {
 }
 interface DocsPage {
     slug: string;
+    lang: string;
     title: string;
     description: string;
     audience: DocsAudience[];
@@ -13556,6 +13864,7 @@ interface DocsPage {
 interface DocsNavItem {
     slug: string;
     title: string;
+    titles?: Record<string, string>;
     icon?: string;
     status?: DocsStatus;
     audience?: DocsAudience[];
@@ -13563,6 +13872,7 @@ interface DocsNavItem {
 interface DocsNavGroup {
     id: string;
     title: string;
+    titles?: Record<string, string>;
     items: DocsNavItem[];
 }
 interface DocsContentManifest {
@@ -13572,17 +13882,6 @@ interface DocsContentManifest {
     pages: DocsPage[];
 }
 
-type ThemePresetName = 'aura' | 'lara' | 'nora' | 'material';
-type ThemePrimaryName = 'blue' | 'emerald' | 'violet' | 'amber' | 'cyan' | 'teal' | 'indigo' | 'rose' | 'pink' | 'lime';
-interface ThemeOption {
-    label: string;
-    value: string;
-    preset: ThemePresetName;
-    primary: ThemePrimaryName;
-    primaryHex: string;
-    isHighContrast?: boolean;
-}
-
 declare class FrameworkDocsComponent {
     private router;
     private route;
@@ -13591,16 +13890,35 @@ declare class FrameworkDocsComponent {
     readonly query: i0.WritableSignal<string>;
     readonly dark: i0.WritableSignal<boolean>;
     readonly currentSlug: i0.WritableSignal<string>;
-    readonly allThemes: ThemeOption[];
+    readonly currentLang: i0.WritableSignal<string>;
+    readonly allThemes: wuic_framework_lib.ThemeOption[];
     private readonly collapsedCodeMaxLines;
     private readonly expandedSamples;
     private readonly highlightedHtmlCache;
-    readonly pagesBySlug: Map<string, DocsPage>;
+    private trslSrv;
+    private ngxTranslate;
+    readonly langPages: i0.Signal<DocsPage[]>;
+    readonly pagesBySlug: i0.Signal<Map<string, DocsPage>>;
     private readonly searchIndexBySlug;
     private readonly sectionPartsCache;
-    readonly filteredGroups: i0.Signal<DocsNavGroup[]>;
+    readonly filteredGroups: i0.Signal<{
+        title: any;
+        items: {
+            title: any;
+            slug: string;
+            titles?: Record<string, string>;
+            icon?: string;
+            status?: DocsStatus;
+            audience?: DocsAudience[];
+        }[];
+        id: string;
+        titles?: Record<string, string>;
+    }[]>;
     readonly currentPage: i0.Signal<DocsPage>;
     readonly breadcrumbs: i0.Signal<string[]>;
+    private static readonly SUPPORTED_LANGS;
+    t(key: string, fallback: string): string;
+    private resolveLang;
     constructor(router: Router, route: ActivatedRoute);
     openPage(slug: string): void;
     toggleTheme(): void;
@@ -13661,6 +13979,182 @@ declare class DesignerRouteComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<DesignerRouteComponent, "wuic-designer-route", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Data model for the multi-table View Builder (Tab 1 of the pivot-builder).
+ *
+ * The ViewDefinition is the contract between the view-builder canvas and
+ * the pivot configuration (Tab 2). It serializes cleanly to JSON for
+ * save/load persistence inside `pivot_config_json`.
+ */
+/** A column from a table in the view builder. */
+interface ViewColumn {
+    /** mc_nome_colonna */
+    alias: string;
+    /** mc_real_column_name */
+    realName: string;
+    /** mc_display_string_in_view */
+    label: string;
+    /** mc_db_column_type */
+    dbType: string;
+    /** mc_ui_column_type */
+    uiType: string;
+    /** Route of the table this column belongs to */
+    tableRoute: string;
+    /** SQL alias for the table (e.g., "t0", "t1") */
+    tableAlias: string;
+    /** "TableCaption.ColumnLabel" — used in Tab 2 to distinguish same-named columns */
+    qualifiedLabel: string;
+    /** Whether user selected this column for the view */
+    selected: boolean;
+    /** True when the column exists only in metadata (e.g. button) and has no physical DB column */
+    virtual?: boolean;
+    /** If this is a lookupByID column, the target entity route */
+    lookupEntityName?: string;
+    /** If this is a lookupByID column, the FK value field */
+    lookupDataValueField?: string;
+    /** If this is a lookupByID column, the display text field on the target */
+    lookupDataTextField?: string;
+    /** Whether this column is filterable in the filter-bar (from mc_show_in_filters) */
+    showInFilters?: boolean;
+    /** Custom SQL formula to use instead of the column reference (e.g. "YEAR(t0.ValidFrom)") */
+    formula?: string;
+    /** Custom alias for the formula output */
+    formulaAlias?: string;
+}
+/** A table node placed on the view-builder Rete.js canvas. */
+interface ViewTableNode {
+    /** Rete node ID */
+    nodeId: string;
+    /** Scaffolded route name */
+    route: string;
+    /** Metadata table ID (_metadati__tabelle.md_id) */
+    mdId: number | null;
+    /** Physical table name (md_nome_tabella) */
+    tableName: string;
+    /** Schema (default 'dbo') */
+    schemaName: string;
+    /** Human-readable caption */
+    caption: string;
+    /** SQL alias assigned (t0, t1, t2, ...) */
+    tableAlias: string;
+    /** All columns, each with a `selected` flag */
+    columns: ViewColumn[];
+    /** Canvas X position */
+    x: number;
+    /** Canvas Y position */
+    y: number;
+    /** Whether the node is collapsed in the canvas */
+    collapsed?: boolean;
+}
+/** A JOIN edge between two table nodes. */
+interface ViewJoinEdge {
+    /** Rete connection ID */
+    edgeId: string;
+    /** FK source node ID */
+    sourceNodeId: string;
+    /** FK source route */
+    sourceRoute: string;
+    /** FK column alias on the source table */
+    sourceColumn: string;
+    /** PK target node ID */
+    targetNodeId: string;
+    /** PK target route */
+    targetRoute: string;
+    /** PK column on the target table */
+    targetColumn: string;
+    /** JOIN type */
+    joinType: 'INNER' | 'LEFT' | 'RIGHT' | 'FULL';
+    /** true if created automatically from lookupByID metadata */
+    autoDetected: boolean;
+}
+/** Complete view definition — the output of Tab 1, input to Tab 2 and backend. */
+interface ViewDefinition {
+    tables: ViewTableNode[];
+    joins: ViewJoinEdge[];
+}
+
+type RouteOption$1 = {
+    label: string;
+    value: string;
+    mdId: number | null;
+};
+declare class ViewBuilderComponent implements AfterViewInit, OnDestroy {
+    private injector;
+    private dataSrv;
+    private metaSrv;
+    viewDefinitionChange: EventEmitter<ViewDefinition>;
+    canvasRef?: ElementRef<HTMLDivElement>;
+    private editor?;
+    private area?;
+    routeOptions: RouteOption$1[];
+    filteredRouteOptions: RouteOption$1[];
+    selectedRouteOption?: RouteOption$1;
+    private tableAliasCounter;
+    showRelatedOnly: boolean;
+    private fkRelationships;
+    joinTypeOptions: {
+        label: string;
+        value: string;
+    }[];
+    joinBadges: {
+        connId: string;
+        x: number;
+        y: number;
+        type: string;
+        label: string;
+        glyph: string;
+    }[];
+    contextMenuVisible: boolean;
+    contextMenuX: number;
+    contextMenuY: number;
+    contextMenuConnectionId: string | null;
+    private http;
+    private userInfo;
+    private cdr;
+    private trslSrv;
+    constructor(injector: Injector, dataSrv: DataProviderService, metaSrv: MetadataProviderService);
+    t(key: string, fallback: string): string;
+    /** True when at least one table is on the canvas */
+    get hasCanvasNodes(): boolean;
+    /** Routes shown in the palette (filtered by FK when checkbox is on) */
+    get displayedRouteOptions(): RouteOption$1[];
+    ngAfterViewInit(): Promise<void>;
+    ngOnDestroy(): void;
+    private loadRouteOptions;
+    private loadForeignKeys;
+    filterRouteOptions(event: AutoCompleteCompleteEvent): void;
+    onPaletteDragStart(event: DragEvent, option: RouteOption$1): void;
+    onCanvasDragOver(event: DragEvent): void;
+    onCanvasDrop(event: DragEvent): Promise<void>;
+    /** Adds a table via the autocomplete "Add" button (positioned at center) */
+    addSelectedRoute(): Promise<void>;
+    private addTableNode;
+    private refreshConnectedSockets;
+    private routeMatch;
+    private autoDetectJoins;
+    removeNode(nodeId: string): Promise<void>;
+    /** Map connection ID → join type (default LEFT) */
+    private connectionJoinTypes;
+    private findConnectionIdFromSvg;
+    private findConnectionIdFromElement;
+    showConnectionContextMenu(x: number, y: number, connId: string): void;
+    setJoinType(type: string): void;
+    getJoinType(connId: string): string;
+    removeConnection(): Promise<void>;
+    private showDropRejection;
+    hideContextMenu(): void;
+    private emitDebounceTimer;
+    private emitViewDefinition;
+    private updateJoinGlyphs;
+    private emitViewDefinitionNow;
+    serializeViewDefinition(): ViewDefinition | null;
+    restoreFromDefinition(def: ViewDefinition): Promise<void>;
+    private buildApiBaseUrl;
+    zoomToFit(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ViewBuilderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ViewBuilderComponent, "wuic-view-builder", never, {}, { "viewDefinitionChange": "viewDefinitionChange"; }, never, never, true, never>;
+}
+
 type RouteOption = {
     label: string;
     value: string;
@@ -13692,9 +14186,11 @@ declare class PivotBuilderComponent implements OnInit, AfterViewInit {
     private metaSrv;
     private trslSrv;
     private aRoute;
+    activeTab: number;
     activeFilterPanel: string;
     pivotName: string;
     routeOptions: RouteOption[];
+    viewDefinition: ViewDefinition | null;
     filteredRouteOptions: RouteOption[];
     selectedRouteOption?: RouteOption;
     selectedRouteName: string;
@@ -13713,6 +14209,12 @@ declare class PivotBuilderComponent implements OnInit, AfterViewInit {
         label: string;
         value: string;
     }[];
+    /** True when the view builder has at least one table with selected columns. */
+    get hasViewDefinition(): boolean;
+    /** True when enough context exists for pivot actions (Tab 1). */
+    get canExecutePivot(): boolean;
+    /** True when enough context for either tab. Used internally. */
+    get canExecute(): boolean;
     generatedSql: string;
     loadingRouteColumns: boolean;
     generatingSql: boolean;
@@ -13720,8 +14222,15 @@ declare class PivotBuilderComponent implements OnInit, AfterViewInit {
     executingQuery: boolean;
     creatingView: boolean;
     creatingMaterializedTable: boolean;
+    creatingViewFromDef: boolean;
+    generatingViewDefSql: boolean;
+    executingViewDefQuery: boolean;
+    autoGenerateQuery: boolean;
+    manualSqlMode: boolean;
+    createdViewName: string;
     draggingColumn?: PivotColumn;
     nestedSource?: DataSourceComponent;
+    viewBuilderRef?: ViewBuilderComponent;
     pivotDatasource?: DataSourceComponent;
     pivotDatasourceSub?: Subscription;
     persistedFilterInfo?: any;
@@ -13737,18 +14246,40 @@ declare class PivotBuilderComponent implements OnInit, AfterViewInit {
     reopeningPivotList: boolean;
     savedPivotOptions: SavedPivotOption[];
     reopenDialogSelectedPivotName: string | null;
-    readonly sqlEditorOptions: {
-        theme: string;
-        language: string;
-        automaticLayout: boolean;
-        minimap: {
-            enabled: boolean;
-        };
-        readOnly: boolean;
-    };
+    sqlEditorOptions: any;
     constructor(dataSrv: DataProviderService, metaSrv: MetadataProviderService, trslSrv: TranslationManagerService, aRoute: ActivatedRoute);
-    private t;
+    t(key: string, fallback: string): string;
     private buildDateGroupByOptions;
+    /** Route of the first table in the View Builder — drives the filter-bar datasource */
+    viewBuilderFilterRoute: string;
+    viewBuilderFilterMetas: MultiDatasourceMeta[];
+    multiDatasourceFilterInfo: FilterInfo | null;
+    onViewDefinitionChange(def: ViewDefinition | null): void;
+    onManualSqlModeChange(enabled: boolean): Promise<void>;
+    private autoGenerateDebounce;
+    /** When true, all columns are shown in filter-bar regardless of mc_show_in_filters */
+    forceAllColumnsFilterable: boolean;
+    onForceAllColumnsFilterableChange(): void;
+    private buildMetaInfoFromViewTable;
+    onViewBuilderFilterApplied(): void;
+    onViewBuilderMultiFilterApplied(event: {
+        mode: string;
+        filterInfo: FilterInfo | null;
+    }): void;
+    /**
+     * Creates a DB VIEW from the multi-table view definition (Tab 0 action).
+     * After creation, the scaffolded view appears as a route in Tab 1.
+     */
+    createViewFromDefinition(): Promise<void>;
+    /**
+     * Calls the backend to generate a SELECT SQL from the ViewDefinition
+     * (generate only, no execution).
+     */
+    generateSqlFromViewDefinition(): Promise<void>;
+    /**
+     * Calls the backend to generate and execute the SELECT query.
+     */
+    executeViewDefinitionQuery(): Promise<void>;
     ngOnInit(): Promise<void>;
     ngAfterViewInit(): void;
     loadRouteOptions(): Promise<void>;
@@ -13802,6 +14333,9 @@ declare class PivotBuilderComponent implements OnInit, AfterViewInit {
     private requestCreatePivotMaterializedTable;
     onFilterBarApplied(): void;
     savePivotConfiguration(): Promise<void>;
+    saveViewBuilderDefinition(silent?: boolean): Promise<void>;
+    viewBuilderOpenMode: boolean;
+    openViewBuilderDefinition(): Promise<void>;
     openReopenPivotDialog(): Promise<void>;
     cancelReopenPivotDialog(): void;
     confirmReopenPivotDialog(): Promise<void>;
@@ -14362,6 +14896,297 @@ declare const boundedRepeaterPendingChangesGuard: CanDeactivateFn<BoundedRepeate
 declare const menuRouteAccessCanMatchGuard: CanMatchFn;
 declare const menuRouteAccessCanActivateGuard: CanActivateFn;
 
+/**
+ * Singolo "source" (chunk del codebase) restituito dal RAG.
+ *
+ * Mappa 1:1 il payload `RagSourceOut` di `rag_server.py`.
+ */
+interface RagSource {
+    rank: number;
+    chunk_id?: string | null;
+    rel_path?: string | null;
+    symbol_name?: string | null;
+    symbol_type?: string | null;
+    start_line?: number | null;
+    end_line?: number | null;
+    score_vector?: number | null;
+    score_bm25?: number | null;
+    snippet: string;
+}
+/**
+ * Turno della cronologia chat passato al modello LLM in modalita' RAG+LLM.
+ */
+interface RagChatTurn {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/** Payload `POST /api/Rag/Query`. */
+interface RagQueryRequest {
+    query: string;
+    top_k?: number;
+    use_lora?: boolean;
+}
+/** Risposta `POST /api/Rag/Query`. */
+interface RagQueryResponse {
+    results: RagSource[];
+}
+/** Payload `POST /api/Rag/Chat`. */
+interface RagChatRequest {
+    query: string;
+    history?: RagChatTurn[];
+    top_k?: number;
+    model?: string;
+}
+/**
+ * Risposta `POST /api/Rag/Chat`.
+ *
+ * Quando `mode === 'retrieval-only'`, il backend ha trovato `ANTHROPIC_API_KEY`
+ * mancante o ha avuto un errore di chiamata Claude: `answer` e' null e
+ * `warning` contiene la causa. I `sources` sono comunque popolati.
+ */
+interface RagChatResponse {
+    mode: 'rag-llm' | 'retrieval-only';
+    answer: string | null;
+    sources: RagSource[];
+    warning?: string | null;
+    model?: string | null;
+    tokens_in?: number | null;
+    tokens_out?: number | null;
+}
+/** Risposta `GET /api/Rag/Health`. */
+interface RagHealthResponse {
+    status: string;
+    llm_enabled: boolean;
+    docs_loaded: number;
+    translate_cache_size: number;
+    loaded_at?: number | null;
+    default_model: string;
+}
+/**
+ * Service tipizzato sopra `RagController` C# che a sua volta proxa il server
+ * Python `rag_server.py`. Tutte le chiamate viaggiano con il cookie di sessione
+ * `k-user` (auth gia' enforced dal middleware globale di KonvergenceCore).
+ *
+ * Il path API e' hardcoded su `/api/Rag/...` (path-relative al backend WUIC),
+ * coerente con la skill `rag-chatbot-creation` che richiede WUIC-specific
+ * deployment, non OEM.
+ */
+declare class WuicRagService {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Esegue una query di sola retrieval (top-K chunk) sul codebase.
+     *
+     * @param query Testo della query (italiano o inglese; il server traduce IT->EN dalla cache).
+     * @param options `top_k` (default 8), `use_lora` (default true).
+     */
+    query(query: string, options?: {
+        topK?: number;
+        useLora?: boolean;
+    }): Observable<RagQueryResponse>;
+    /** Variant Promise di {@link query}. */
+    queryAsync(query: string, options?: {
+        topK?: number;
+        useLora?: boolean;
+    }): Promise<RagQueryResponse>;
+    /**
+     * Esegue una chat completa (RAG + Claude). Se il server non ha
+     * `ANTHROPIC_API_KEY`, il backend degrada automaticamente in
+     * modalita' `retrieval-only` (controlla `response.mode`).
+     *
+     * @param query Domanda dell'utente.
+     * @param history Cronologia di messaggi precedenti (per multi-turn).
+     * @param options `top_k` (default 5), `model` (default `claude-haiku-4-5-20251001`).
+     */
+    chat(query: string, history?: RagChatTurn[], options?: {
+        topK?: number;
+        model?: string;
+    }): Observable<RagChatResponse>;
+    /** Variant Promise di {@link chat}. */
+    chatAsync(query: string, history?: RagChatTurn[], options?: {
+        topK?: number;
+        model?: string;
+    }): Promise<RagChatResponse>;
+    /**
+     * Stato del server RAG (status, LLM enabled, chunks indicizzati).
+     *
+     * Usato dal componente `<wuic-rag-chatbot>` per decidere se mostrare il
+     * badge "RAG+LLM" o "retrieval-only" e per disabilitare la mode `chat` se
+     * il backend non ha la API key configurata.
+     */
+    health(): Observable<RagHealthResponse>;
+    /** Variant Promise di {@link health}. */
+    healthAsync(): Promise<RagHealthResponse>;
+    /**
+     * Forza il reload dell'indice + LoRA del server Python. Da chiamare dopo
+     * la skill `rag-rebuild-pipeline` per evitare di dover restartare il
+     * processo uvicorn.
+     */
+    reload(): Observable<{
+        status: string;
+        docs_loaded: number;
+        llm_enabled: boolean;
+    }>;
+    /**
+     * Costruisce l'URL `<api_base>Rag/<action>` rispettando l'eventuale
+     * `WtoolboxService.appSettings.api_url` configurato lato runtime (stesso
+     * pattern di NotificationRealtimeService).
+     */
+    private buildUrl;
+    private buildApiBaseUrl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WuicRagService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WuicRagService>;
+}
+
+/**
+ * Singolo turno della conversazione visualizzato nel chatbot.
+ *
+ * Differenza con `RagChatTurn` (passato all'API): qui ci sono anche i meta
+ * per il rendering UI -- sources, modalita' del backend, warning, errori,
+ * stato di loading.
+ */
+interface RagChatbotTurn {
+    role: 'user' | 'assistant';
+    content: string;
+    loading?: boolean;
+    mode?: 'rag-llm' | 'retrieval-only' | null;
+    sources?: RagSource[];
+    warning?: string | null;
+    errorMessage?: string | null;
+    tokensIn?: number | null;
+    tokensOut?: number | null;
+}
+/**
+ * Componente standalone che espone una chat sopra il RAG del codebase WUIC.
+ *
+ * Modalita':
+ * - `auto`     : usa chat (RAG+LLM) se il backend ha l'API key Claude, altrimenti retrieval pure
+ * - `chat`     : forza la modalita' RAG+LLM (mostra errore se LLM non disponibile)
+ * - `retrieval`: forza la modalita' retrieval pure (top-K snippets)
+ *
+ * Auth: tutte le chiamate passano per `WuicRagService` che a sua volta usa
+ * `withCredentials: true` per inviare il cookie di sessione `k-user`.
+ *
+ * Per uso, vedi la skill `rag-chatbot-creation` e la pagina di docs framework.
+ */
+declare class WuicRagChatbotComponent implements OnInit {
+    private readonly ragService;
+    /** Titolo mostrato nell'header del chatbot. */
+    title: string;
+    /** Modalita' operativa: vedi nota nella classDoc. */
+    mode: 'auto' | 'chat' | 'retrieval';
+    /** Numero di chunk top-K da chiedere al RAG (default 5). */
+    topK: number;
+    /** Mostra/nasconde i source chip nei messaggi assistant. */
+    showSources: boolean;
+    /** Numero massimo di turni di history mantenuti (default 20). */
+    maxHistory: number;
+    /** Placeholder dell'input. */
+    placeholder: string;
+    /** Modello Claude da usare in modalita' chat (default haiku 4.5). */
+    model: string;
+    /** Altezza fissa dell'area chat in CSS units (default `420px`). */
+    chatHeight: string;
+    /** Mostra il bottone "Svuota cronologia" nell'header. */
+    showClearButton: boolean;
+    /** Emette quando l'utente clicca su un source chip. */
+    resultSelected: EventEmitter<RagSource>;
+    /** Emette in caso di errore HTTP non recuperabile. */
+    errorOccurred: EventEmitter<{
+        message: string;
+        details?: unknown;
+    }>;
+    /** Emette dopo ogni turno (user o assistant) aggiunto alla history. */
+    turnAdded: EventEmitter<RagChatbotTurn>;
+    history: RagChatbotTurn[];
+    inputValue: string;
+    loading: boolean;
+    healthInfo: RagHealthResponse | null;
+    healthError: string | null;
+    inputTextarea?: ElementRef<HTMLTextAreaElement>;
+    scrollContainer?: ElementRef<HTMLElement>;
+    constructor(ragService: WuicRagService);
+    ngOnInit(): void;
+    /**
+     * Modalita' effettivamente usata per la prossima chiamata, dopo aver
+     * considerato il valore di `mode` e lo stato di `healthInfo.llm_enabled`.
+     */
+    get effectiveMode(): 'rag-llm' | 'retrieval-only';
+    /** Etichetta del badge in alto a destra. */
+    get modeBadgeLabel(): string;
+    /** Severity del badge (PrimeNG severity). */
+    get modeBadgeSeverity(): 'success' | 'info' | 'warn' | 'danger';
+    /** Disabilita il send button quando appropriato. */
+    get sendDisabled(): boolean;
+    /**
+     * Invia la query corrente al backend secondo `effectiveMode` e aggiunge
+     * il turno utente + il turno assistant (placeholder loading) alla history.
+     */
+    onSend(): Promise<void>;
+    /**
+     * Svuota la cronologia chat. Usa `WtoolboxService.promptDialog` come da
+     * regola 12 di AGENTS (no native confirm/prompt).
+     */
+    onClearHistory(): Promise<void>;
+    /**
+     * Click su un source chip: emette il source verso il padre e tenta di
+     * aprire VS Code via deep-link `vscode://file/<abs>:<line>` se disponibile.
+     * Il padre puo' override-are il comportamento intercettando l'output.
+     */
+    onSourceClick(source: RagSource): void;
+    /** Etichetta breve per un source (path::symbol oppure solo path). */
+    sourceLabel(source: RagSource): string;
+    /** Tooltip esteso per un source (path completo + line). */
+    sourceTooltip(source: RagSource): string;
+    /** Gestisce Enter (send) vs Shift+Enter (newline). */
+    onKeyDown(event: KeyboardEvent): void;
+    private runChatTurn;
+    private runRetrievalTurn;
+    /**
+     * Costruisce un summary testuale dei top-K chunk in modalita' retrieval-only.
+     * Usato sia quando il backend e' senza Claude sia per la modalita' `mode='retrieval'`.
+     */
+    private buildRetrievalSummary;
+    private trimHistory;
+    private scheduleScrollToBottom;
+    private focusInput;
+    private extractErrorMessage;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WuicRagChatbotComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WuicRagChatbotComponent, "wuic-rag-chatbot", never, { "title": { "alias": "title"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "topK": { "alias": "topK"; "required": false; }; "showSources": { "alias": "showSources"; "required": false; }; "maxHistory": { "alias": "maxHistory"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "model": { "alias": "model"; "required": false; }; "chatHeight": { "alias": "chatHeight"; "required": false; }; "showClearButton": { "alias": "showClearButton"; "required": false; }; }, { "resultSelected": "resultSelected"; "errorOccurred": "errorOccurred"; "turnAdded": "turnAdded"; }, 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.
+ * Written in the `finally` callback AFTER legacyLogout (which clears
+ * localStorage) but BEFORE the redirect. Read and removed by
+ * AuthSessionService.initialize on the next page load.
+ */
+declare const AUTH_REDIRECT_REASON_KEY = "wuic_auth_redirect_reason";
+/**
+ * HTTP interceptor that detects 401 (Unauthorized) responses and
+ * triggers an automatic logout + full page redirect to `/`.
+ *
+ * This is critical for `enableCookieAuthentication=true`: the
+ * server-managed HttpOnly cookie can expire (via `sessionTimeoutMinutes`)
+ * while the client-side session snapshot in sessionStorage is still
+ * populated. Without this interceptor, expired sessions produce a
+ * generic error dialog instead of a clean redirect to login.
+ *
+ * When the 401 carries a `session_replaced` reason (another browser
+ * logged in with the same user, overwriting the token), the reason is
+ * persisted to localStorage (survives the session clear) and displayed
+ * by the login form after the redirect.
+ *
+ * Auth-related endpoints (login, logout, me) are excluded to avoid
+ * infinite loops when the logout call itself returns 401.
+ *
+ * ALL 401 responses on non-auth endpoints are swallowed (including
+ * concurrent ones while logout is in progress) to prevent the
+ * GlobalHandler from showing error dialogs during the redirect.
+ */
+declare const authExpiredInterceptor: HttpInterceptorFn;
+
 declare const routes: Routes;
 
 declare function loadTextEditorComponent(): Promise<typeof wuic_framework_lib.TextEditorComponent>;
@@ -14416,5 +15241,20 @@ declare class GetSrcUploadPreviewPipe implements PipeTransform {
     static ɵpipe: i0.ɵɵPipeDeclaration<GetSrcUploadPreviewPipe, "getSrcUploadPreview", true>;
 }
 
-export { AuthSessionService, BooleanEditorComponent, BoundedRepeaterComponent, ButtonEditorComponent, CallbackPipe, CallbackPipe2, CarouselListComponent, ChartListComponent, CodeAreaEditorComponent, CodeEditorComponent, ColorEditorComponent, CustomException, DataActionButtonComponent, DataRepeaterComponent, DataSourceComponent, DateEditorComponent, DesignerRouteComponent, DictionaryEditorComponent, DynamicRowTemplateComponent, EditorOptions, FieldEditorComponent, FilterBarComponent, FormatGridViewValuePipe, FrameworkDocsComponent, GetSrcUploadPreviewPipe, GlobalHandler, HtmlEditorComponent, ImageWrapperComponent, ImportExportButtonComponent, IsSelectedRowPipe, KanbanListComponent, KanbanOptions, KanbanStatusColumnItem, LazyDataActionButtonComponent, LazyDataSourceComponent, LazyFieldEditorComponent, LazyImageWrapperComponent, LazyKanbanListComponent, LazyMetaMenuComponent, ListGridComponent, LookupEditorComponent, MapListComponent, MetaInfo, MetaMenuComponent, MetadataEditorService, MetadataProviderService, MetadatiColonna, NotificationBellComponent, NotificationRealtimeService, NumberEditorComponent, PagerComponent, ParametricDialogComponent, PivotBuilderComponent, PropertyArrayEditorComponent, PropertyObjectEditorComponent, ReportDesignerComponent, ReportViewerComponent, SchedulerListComponent, SpreadsheetListComponent, TextAreaEditorComponent, TextEditorComponent, TranslationManagerService, TreeListComponent, TreeViewSelectorComponent, UploadEditorComponent, ValidationRule, ValueChangedPayload, VisibleFieldListPipe, WidgetDefinition, WorkflowDesignerComponent, WorkflowDesignerRouteComponent, WorkflowRunnerComponent, WorkflowRuntimeMetadataService, WtoolboxService, boundedRepeaterPendingChangesGuard, loadBooleanEditorComponent, loadButtonEditorComponent, loadCodeAreaEditorComponent, loadColorEditorComponent, loadDateEditorComponent, loadDictionaryEditorComponent, loadHtmlEditorComponent, loadLookupEditorComponent, loadNumberEditorComponent, loadPropertyArrayEditorComponent, loadPropertyObjectEditorComponent, loadTextAreaEditorComponent, loadTextEditorComponent, loadTreeViewSelectorComponent, loadUploadEditorComponent, menuRouteAccessCanActivateGuard, menuRouteAccessCanMatchGuard, routes };
-export type { AuthSessionState, DataSourceAfterSyncEvent, DataSourceBeforeSyncEvent, DataSourceSyncOperation, IDataBoundHostComponent, IFieldEditor, KanbanStatusColumn, ListGridAfterRenderEvent, ListGridAfterRowRenderEvent, ListGridBeforeRowRenderEvent, NotificationItem, RealtimeProgressEvent, WorkflowRuntimeLinkedActionRouteMetadataEntry, WorkflowRuntimePreviousRouteNodeEntry, WorkflowRuntimeRouteMetadataEntry, WorkflowRuntimeRouteNodePayloadEntry };
+type ThemePresetName = 'aura' | 'lara' | 'nora' | 'material';
+type ThemePrimaryName = 'blue' | 'emerald' | 'violet' | 'amber' | 'cyan' | 'teal' | 'indigo' | 'rose' | 'pink' | 'lime';
+interface ThemeOption {
+    label: string;
+    value: string;
+    preset: ThemePresetName;
+    primary: ThemePrimaryName;
+    primaryHex: string;
+    isHighContrast?: boolean;
+}
+declare const PRIMARY_PALETTES: Record<ThemePrimaryName, Record<string, string>>;
+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, ChartListComponent, CodeAreaEditorComponent, CodeEditorComponent, ColorEditorComponent, CustomException, DataActionButtonComponent, DataRepeaterComponent, DataSourceComponent, DateEditorComponent, DesignerRouteComponent, DictionaryEditorComponent, DynamicRowTemplateComponent, EditorOptions, FieldEditorComponent, FilterBarComponent, FormatGridViewValuePipe, FrameworkDocsComponent, GetSrcUploadPreviewPipe, GlobalHandler, HtmlEditorComponent, ImageWrapperComponent, ImportExportButtonComponent, IsSelectedRowPipe, KanbanListComponent, KanbanOptions, KanbanStatusColumnItem, LazyDataActionButtonComponent, LazyDataSourceComponent, LazyFieldEditorComponent, LazyImageWrapperComponent, LazyKanbanListComponent, LazyMetaMenuComponent, ListGridComponent, LookupEditorComponent, MapListComponent, MetaInfo, MetaMenuComponent, MetadataEditorService, MetadataProviderService, MetadatiColonna, NotificationBellComponent, NotificationRealtimeService, NumberEditorComponent, PRIMARY_PALETTES, PagerComponent, ParametricDialogComponent, PivotBuilderComponent, PropertyArrayEditorComponent, PropertyObjectEditorComponent, ReportDesignerComponent, ReportViewerComponent, SchedulerListComponent, SpreadsheetListComponent, THEME_OPTIONS, TextAreaEditorComponent, TextEditorComponent, TranslationManagerService, TreeListComponent, TreeViewSelectorComponent, UploadEditorComponent, UserInfoService, ValidationRule, ValueChangedPayload, VisibleFieldListPipe, WidgetDefinition, WorkflowDesignerComponent, WorkflowDesignerRouteComponent, WorkflowRunnerComponent, WorkflowRuntimeMetadataService, WtoolboxService, WuicRagChatbotComponent, WuicRagService, authExpiredInterceptor, boundedRepeaterPendingChangesGuard, getThemeOptions, getThemePrimaryHex, loadBooleanEditorComponent, loadButtonEditorComponent, loadCodeAreaEditorComponent, loadColorEditorComponent, loadDateEditorComponent, loadDictionaryEditorComponent, loadHtmlEditorComponent, loadLookupEditorComponent, loadNumberEditorComponent, loadPropertyArrayEditorComponent, loadPropertyObjectEditorComponent, loadTextAreaEditorComponent, loadTextEditorComponent, loadTreeViewSelectorComponent, loadUploadEditorComponent, menuRouteAccessCanActivateGuard, menuRouteAccessCanMatchGuard, routes };
+export type { AuthSessionState, DataSourceAfterSyncEvent, DataSourceBeforeSyncEvent, DataSourceSyncOperation, IDataBoundHostComponent, IFieldEditor, KanbanStatusColumn, ListGridAfterRenderEvent, ListGridAfterRowRenderEvent, ListGridBeforeRowRenderEvent, MultiDatasourceMeta, NotificationItem, RagChatRequest, RagChatResponse, RagChatTurn, RagChatbotTurn, RagHealthResponse, RagQueryRequest, RagQueryResponse, RagSource, RealtimeProgressEvent, ThemeOption, ThemePresetName, ThemePrimaryName, WorkflowRuntimeLinkedActionRouteMetadataEntry, WorkflowRuntimePreviousRouteNodeEntry, WorkflowRuntimeRouteMetadataEntry, WorkflowRuntimeRouteNodePayloadEntry };