wuic-framework-lib 1.0.20 → 1.2.0

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

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { ErrorHandler, Injector, OnInit, OnDestroy, ChangeDetectorRef, AfterViewInit, EventEmitter, ElementRef, NgZone, OnChanges, SimpleChanges, QueryList, ViewContainerRef, AfterViewChecked, DoCheck, TemplateRef, Type, NgModuleRef, PipeTransform } from '@angular/core';
+import { ErrorHandler, Injector, OnInit, OnDestroy, ChangeDetectorRef, NgZone, AfterViewInit, EventEmitter, ElementRef, OnChanges, SimpleChanges, QueryList, AfterViewChecked, ViewContainerRef, DoCheck, TemplateRef, Type, NgModuleRef, PipeTransform } from '@angular/core';
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Subject, Observable } from 'rxjs';
 import { MenuItem, MessageService, ConfirmationService, Confirmation, TreeNode, MegaMenuItem } from 'primeng/api';
@@ -385,6 +385,29 @@ declare class UserInfo {
     lingua: Lingua;
     language?: string;
     optimisticCheckEnabled?: boolean;
+    /**
+     * Multi-tenant: id azienda attiva per la sessione corrente. Quando il
+     * server gira con `multiConnectionEnabled=true` e l'utente ha un
+     * `utenti.id_azienda` impostato (o e' un superadmin che ha selezionato
+     * un'azienda via `MetaService.switchAzienda`), questo campo riflette
+     * l'azienda. Valore `0` = "no tenant scope" (single-tenant mode oppure
+     * superadmin senza azienda selezionata).
+     *
+     * Usato dal client per:
+     *   - costruire il nome del DB Dexie (`MetaDB__a${azienda_id}`,
+     *     `WuicClientSideCrudDB__a${azienda_id}`);
+     *   - suffissare le chiavi `localStorage` di metadata / settings utente;
+     *   - decidere se mostrare il componente `<wuic-azienda-switcher>`
+     *     (solo se `isSuperAdmin === true`).
+     */
+    azienda_id?: number;
+    /**
+     * Mirror del flag server `Cms.multiConnectionEnabled`. Se `true`, il
+     * client applica lo scoping per tenant (Dexie name, localStorage keys);
+     * se `false`/undefined, mantiene il comportamento single-tenant
+     * bit-identico al pre-rollout.
+     */
+    multiConnectionEnabled?: boolean;
     constructor(params: {
         user_id: number;
         user_name: string;
@@ -396,6 +419,8 @@ declare class UserInfo {
         lingua: Lingua;
         language?: string;
         optimisticCheckEnabled?: boolean;
+        azienda_id?: number;
+        multiConnectionEnabled?: boolean;
     });
 }
 
@@ -481,6 +506,24 @@ declare class UserInfoService {
      * @returns Profilo utente corrente.
      */
     getuserInfo(): UserInfo;
+    /**
+     * Multi-tenant: ritorna l'`id_azienda` attivo per la sessione corrente,
+     * oppure `0` se non c'e' tenant scope (single-tenant mode oppure
+     * superadmin senza azienda selezionata). Wrapper safe in tutti gli stati
+     * (no user logged in, multiConnectionEnabled=false, ecc).
+     */
+    getCurrentAziendaId(): number;
+    /**
+     * `true` SOLO se il server e' in modalita' multi-connection E l'utente
+     * corrente ha un tenant scope attivo (`azienda_id > 0`). Usato dal client
+     * per decidere il suffisso `__a{id}` su Dexie / localStorage.
+     */
+    isTenantScoped(): boolean;
+    /**
+     * Suffisso univoco per chiavi storage / nomi Dexie quando l'utente e'
+     * tenant-scoped. Stringa vuota altrimenti → backward compat dei naming.
+     */
+    getTenantSuffix(): string;
     /**
      * Read path: prefer sessionStorage (source of truth, works in both cookie
      * modes) and fall back to the JS-readable cookie when sessionStorage is
@@ -517,6 +560,24 @@ declare class TranslationManagerService {
     private backendRetryTimer?;
     private firstRunStatusChecked;
     private firstRunStatusValue;
+    /**
+     * Circuit breaker BE-offline: dopo {@link MAX_BACKEND_RETRIES} fallimenti
+     * consecutivi di `loadTranslations`, smettiamo di rischedulare il retry
+     * automatico. Con il vecchio loop a 1s, un BE offline generava ~60 chiamate
+     * fallite/min (vedi screenshot 2026-05-19: 318 errori console + ~190 XHR in
+     * pochi secondi). Ora dopo 5 fallimenti il timer si ferma e l'utente vede
+     * un banner globale "Backend offline" + bottone "Riprova" che chiama
+     * `retryBackendNow()` per resettare il circuito.
+     *
+     * Reset condizioni:
+     *  - chiamata esplicita a `ensureTranslationsLoaded(true)` (forceReload);
+     *  - chiamata esplicita a `retryBackendNow()` (bottone UI);
+     *  - prima chiamata con successo (counter back to 0).
+     */
+    private static readonly MAX_BACKEND_RETRIES;
+    private consecutiveBackendFailures;
+    /** True quando MAX_BACKEND_RETRIES e' stato raggiunto → niente piu' retry automatici. */
+    backendCircuitOpen$: BehaviorSubject<boolean>;
     /**
      * Dedup set per i warning "Missing translation resource". Senza questo
      * Angular ChangeDetection invoca `instant(key)` ad ogni ciclo per ogni
@@ -620,6 +681,33 @@ declare class TranslationManagerService {
      * Legge/scrive dati persistenti su storage browser.
      */
     loadTranslations(): Promise<void>;
+    /**
+     * Reset esplicito del circuit breaker BE-offline + retry immediato.
+     * Da chiamare quando l'utente clicca "Riprova" sul banner offline, o
+     * quando un altro servizio rileva che il BE e' tornato online (es. ping
+     * health check, network 'online' event, ecc.). NON usare in retry loops
+     * automatici — il senso del breaker e' proprio fermarli.
+     */
+    retryBackendNow(): void;
+    /**
+     * Revalidate background: rifetcha la tabella traduzioni dal backend SENZA
+     * bloccare l'UI. Confronta size + contenuto (hash leggero su `id,resource,
+     * translation`) con la tabella attualmente in memoria; se differente,
+     * sostituisce + `syncNgxTranslate()` cosi' il translate pipe rivaluta
+     * automaticamente via evento `onTranslationChange`. Usato dal branch cache-
+     * hit di `ensureTranslationsLoaded` per propagare key aggiunte/modificate
+     * lato DB dopo la prima sessione (es. scaffolding di una route nuova che
+     * aggiunge `menu.x.y` in `_wuic_translations`).
+     *
+     * Best-effort: errori network NON propagano. L'UI ha gia' la cache come
+     * fallback funzionante, una revalidate fallita non e' peggio della cache.
+     */
+    private revalidateCacheInBackground;
+    /**
+     * Fingerprint deterministico di una tabella traduzioni. Usato per decidere
+     * se la cache differisce dal backend senza confronto byte-a-byte.
+     */
+    private computeTableFingerprint;
     /**
      * Controlla che la translationTable contenga le chiavi indispensabili per
      * renderizzare il form di login senza chiavi grezze visibili. Se anche una
@@ -1067,6 +1155,18 @@ declare class DataSourceComponent implements OnInit, OnDestroy {
     private aRoute;
     private userInfo;
     private static readonly liveInstances;
+    /**
+     * Riferimento al DOM host element. Iniettato via `inject()` (Angular 14+ functional
+     * DI) invece che da costruttore per non rompere i call site manuali tipo
+     * `new DataSourceComponent(metaSrv, dataSrv, ...)` in designer.component.ts
+     * e metadata-editor.service.ts (che mantengono i 7 params posizionali storici).
+     * `{ optional: true }` rende il field null fuori da un Angular DI context
+     * (es. unit test che istanziano la classe a mano) — il consumo in ngOnInit
+     * usa `?.nativeElement` per sopportare entrambi i path.
+     * Scopo: esporre `this` su `host.__wuicCmp` per E2E introspection senza
+     * dipendere da `window.ng.getComponent` (tree-shaken in prod build).
+     */
+    private elementRef;
     static getLiveInstances(): DataSourceComponent[];
     /**
      * Input dal componente padre per route; usata nella configurazione e nel rendering del componente.
@@ -2334,6 +2434,24 @@ declare class MetadatiTabella {
     md_inline_cell_editing: boolean;
     md_batch_save: boolean;
     md_props_bag: any;
+    /**
+     * Phase I.3 — Custom Attributes integration (W0.1 = A full parity).
+     * Quando valorizzato (es. 'program', 'project', 'resource', 'scenario',
+     * 'xbs_node'), il framework attiva il pattern "custom attributes runtime"
+     * per questa route:
+     *  - `<wuic-parametric-dialog>` renderizza inline i CA della entity corrente
+     *    chiamando `CustomAttributesService.resolve(context, scope)`.
+     *  - `<wuic-list-grid>` accetta filter tokens `CA_<code>___value` e
+     *    `CS_<code>___order` per filtrare/ordinare per Custom Value.
+     *  - Save batch su entity invoca anche `CustomAttributesService.upsert()`
+     *    per gli eventuali CV editati.
+     *
+     * App-side: ogni app che vuole usare i CA deve avere le 5 tabelle
+     * `core.custom_attribute*` (Phase I.1 schema) + endpoint
+     * `/api/custom-attributes/*` (Phase I.2 controller). Backward-compat:
+     * route che NON settano questo campo si comportano esattamente come prima.
+     */
+    custom_attribute_context: string;
     md_hide_select_all_check: boolean;
     md_multiple_radio_selection: boolean;
     md_persist_row_selection_accross_paging: boolean;
@@ -2759,6 +2877,33 @@ declare class MetadataProviderService {
      * @returns Istanza Dexie `MetaDB`.
      */
     static getMetaDB(): Promise<any>;
+    /**
+     * Calcola il nome del DB Dexie metadata tenant-scoped per l'utente
+     * corrente. Read-only, statico, niente Angular DI: leggiamo direttamente
+     * lo snapshot UserInfo da `sessionStorage` (chiave `k-user-memory`,
+     * mirror-ata anche da UserInfoService).
+     *
+     * Regola: `MetaDB__a{azienda_id}` quando
+     * `userInfo.multiConnectionEnabled === true` E `azienda_id > 0`. In tutti
+     * gli altri casi (single-tenant, utente non loggato, superadmin senza
+     * azienda selezionata) ritorna `MetaDB` — backward compat con installazioni
+     * pre-multi-tenant.
+     *
+     * Inline helper qui dentro evita di importare `UserInfoService` (che ha
+     * dipendenze su CookieService) in un metodo statico.
+     */
+    static resolveTenantDbName(baseName?: string): string;
+    /**
+     * Cleanup orfani di Dexie tenant-scoped. Drop di tutti i DB
+     * `MetaDB__a*` e `WuicClientSideCrudDB__a*` il cui suffisso non
+     * corrisponde all'azienda attiva. Da invocare all'avvio app (post-`me()`
+     * hydration) per evitare accumulo di DB di tenant precedenti quando un
+     * superadmin switcha frequentemente.
+     *
+     * No-op se `indexedDB.databases()` non e' supportato (Safari < 15) — in
+     * quel caso i DB orfani restano ma non si rompe nulla.
+     */
+    static cleanupOrphanTenantDbs(currentAziendaId: number): Promise<void>;
     /**
      * Inizializza (o riusa) il database Dexie `MetaDB` con lo schema metadata richiesto dalla versione passata.
      * Configura tabelle/indici per colonne, tabelle, stili, autorizzazioni, condition group e custom actions.
@@ -2810,7 +2955,17 @@ declare class MetadataProviderService {
      */
     private isClientSideCrudModeEnabled;
     /**
-     * Costruisce la chiave cache menu utente (`menu_{userId}`) usata per persistenza localStorage.
+     * Multi-tenant: suffisso tenant per la chiave locale corrente. Mirror di
+     * `UserInfoService.getTenantSuffix()` ma legge sessionStorage direttamente
+     * per evitare DI Angular in metodi statici / helper privati. Empty quando
+     * il flag server `multiConnectionEnabled` e' off oppure non c'e' tenant
+     * scope (`azienda_id = 0`) → backward compat keys originali.
+     */
+    private getTenantSuffix;
+    /**
+     * Costruisce la chiave cache menu utente. Tenant-scoped quando l'utente
+     * e' su un tenant (`menu_{userId}__a{aziendaId}`), plain altrimenti
+     * (`menu_{userId}`) per backward compat single-tenant.
      * @param userId Identificativo utente usato per contesto e persistenza.
      * @returns Chiave localStorage della cache menu.
      */
@@ -2901,7 +3056,7 @@ declare class MetadataProviderService {
      * @param col Metadato colonna da analizzare.
      * @returns Nome tipo TypeScript stimato (`string`, `number`, `boolean`, `Date`, `any`).
      */
-    static getTSTypeFromMetaColumn(col: MetadatiColonna): "string" | "any" | "boolean" | "number" | "Date";
+    static getTSTypeFromMetaColumn(col: MetadatiColonna): "string" | "number" | "any" | "boolean" | "Date";
     /**
      * Normalizza e arricchisce i metadata colonna/tabella: ordina campi, inizializza callback dinamiche, parse di bag JSON
      * e garantisce fallback robusti per funzioni custom non compilabili.
@@ -3725,6 +3880,17 @@ declare class ClientSideCrudService {
     private db?;
     private dbInitPromise?;
     private readonly localModePrefix;
+    /**
+     * Multi-tenant: ritorna il nome Dexie tenant-scoped per l'utente corrente.
+     * Mirror di `MetadataProviderService.resolveTenantDbName` per evitare un
+     * import cross-service (questi due servizi non dovrebbero dipendere
+     * l'uno dall'altro).
+     *
+     * `<baseName>__a{azienda_id}` quando `multiConnectionEnabled` e' attivo
+     * e l'utente ha `azienda_id > 0`. Altrimenti `<baseName>` → backward
+     * compat bit-identica.
+     */
+    static resolveTenantDbName(baseName: string): string;
     /**
      * Inizializza una sola volta il database Dexie locale (`WuicClientSideCrudDB`) e ne riusa l'istanza.
      * @returns Istanza DB locale usata per cache/sync CRUD client-side.
@@ -3782,6 +3948,12 @@ declare class ClientSideCrudService {
      * @param userId Identificativo utente usato per contesto e persistenza.
      * @returns Chiave storage del flag modalita locale.
      */
+    /**
+     * Suffisso tenant per la chiave locale (`__a{azienda_id}`) quando l'utente
+     * e' su un tenant + server in modalita' multi-connection. Stringa vuota
+     * altrimenti → backward compat single-tenant.
+     */
+    private getTenantSuffix;
     private getModeKey;
     /**
      * Attiva/disattiva il flag modalita CRUD locale per route+utente in localStorage.
@@ -5262,156 +5434,731 @@ declare class LazyDataSourceComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<LazyDataSourceComponent, "wuic-data-source-lazy", never, { "route": { "alias": "route"; "required": false; }; "routeFromRouting": { "alias": "routeFromRouting"; "required": false; }; "hardcodedRoute": { "alias": "hardcodedRoute"; "required": false; }; "autoload": { "alias": "autoload"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "changeTracking": { "alias": "changeTracking"; "required": false; }; "parentRecord": { "alias": "parentRecord"; "required": false; }; "parentMetaInfo": { "alias": "parentMetaInfo"; "required": false; }; "parentDatasource": { "alias": "parentDatasource"; "required": false; }; "componentRef": { "alias": "componentRef"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-declare class DeviceAwarenessService implements OnDestroy {
-    private static readonly DEFAULT_BREAKPOINT_PX;
-    private mediaQueryList?;
-    private mediaQueryListener?;
-    private readonly isMobileSubject;
-    readonly isMobile$: Observable<boolean>;
-    constructor();
-    get isMobile(): boolean;
-    ngOnDestroy(): void;
-    private resolveBreakpointPx;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DeviceAwarenessService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<DeviceAwarenessService>;
-}
-
-interface ListGridSavedState {
-    id: string;
-    name: string;
-    description: string;
-    isDefault: boolean;
-    createdAt: string;
-    filterInfo: any;
-    sortInfo: any[];
-    pageInfo: {
-        currentPage: number;
-        pageSize: number;
-    };
-    columnWidths: {
-        [field: string]: number;
-    };
-    columnLayout?: ListGridColumnLayout;
-}
-interface ListGridColumnLayout {
-    order: string[];
-    hidden: string[];
-    pinnedLeft: string[];
-    pinnedRight: string[];
-}
-interface ReportVariableInput {
-    name: string;
-    alias: string;
-    value: string;
-    type?: string;
-}
-interface GridPendingChangeItem {
-    id: string;
-    change: TrackedChange;
-    label: string;
-    details: string;
-    selected: boolean;
-}
-interface ListGridBeforeRowRenderEvent {
-    row: any;
-    rowIndex: number;
-    cancel: boolean;
-    cancelRender: () => void;
-}
-interface ListGridAfterRowRenderEvent {
-    row: any;
-    rowIndex: number;
-}
-interface ListGridAfterRenderEvent {
-    rows: any[];
-    totalRecords: number;
-    metaInfo: MetaInfo;
-    datasource?: DataSourceComponent;
+interface AuthSessionState {
+    initialized: boolean;
+    loading: boolean;
+    enabled: boolean;
+    authenticated: boolean;
+    legacyAuthenticated: boolean;
+    provider?: string;
+    name?: string;
+    legacyName?: string;
+    legacyRole?: string;
+    claims?: {
+        type: string;
+        value: string;
+    }[];
+    error?: string;
+    returnUrl: string;
+    sessionExpiring?: boolean;
+    sessionExpiresInSeconds?: number;
 }
-declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDataBoundHostComponent {
-    private metaSrv;
-    private sanitizer;
-    private route;
-    private router;
-    private location;
-    private titleService;
-    private trslSrv;
-    private cd;
-    userInfo: UserInfoService;
-    private elementRef;
-    deviceAwareness: DeviceAwarenessService;
-    private static readonly FORCED_VIRTUALIZATION_PAGE_SIZE_THRESHOLD;
-    private static readonly FORCED_VIRTUALIZATION_ITEM_SIZE;
-    private static readonly ACTION_BUTTON_VISIBLE_ROWS_OVERSCAN;
-    private static readonly ACTION_BUTTON_INITIAL_VISIBLE_ROWS_FALLBACK;
-    private static readonly GRID_VIEW_STATES_SETTINGS_KEY;
-    private static readonly GRID_COLUMN_LAYOUT_SETTINGS_KEY;
-    private static selectButtonGuardInstalled;
-    private columnFilterRenderEpochByField;
-    private actionButtonsVisibleStartIndex;
-    private actionButtonsVisibleEndIndex;
-    private actionButtonsLimitToVisibleRows;
-    private actionButtonsPreLimitBeforeContainerReady;
-    private actionButtonsScrollContainer;
-    private actionButtonsScrollRafToken;
-    private actionButtonsScrollHandler;
-    private inlineCellSaveInFlightByRowKey;
-    private inlineCellSaveDebounceByRowKey;
-    private inlineCellLastChangedFieldByRowKey;
-    private inlineBatchOriginalByRowKey;
-    private inlineGridRuntimeFieldCacheByKey;
-    private suppressNextInlineFetchInfoRebind;
-    getRuntimeGridFieldMetaFn: (metaColumn: MetadatiColonna, rowData: any) => MetadatiColonna;
-    hardcodedRoute: string;
-    parentRecord: any;
-    parentMetaInfo: MetaInfo;
-    datasource: BehaviorSubject<DataSourceComponent>;
-    hardcodedDatasource: DataSourceComponent;
-    rowCustomSelect: (rowData: any, $event: any, dt: Table) => void;
-    hideToolbar: boolean;
+declare class AuthSessionService {
+    private http;
+    private userInfoService;
+    private metadataProvider;
+    private translationManager;
+    private ngZone;
+    private initialized;
+    private sessionTimeoutMs;
+    private sessionWarningMs;
+    private sessionTimer;
+    private sessionWarningTimer;
+    private sessionCountdownTimer;
+    private readonly stateSubject;
+    readonly state$: rxjs.Observable<AuthSessionState>;
+    get snapshot(): AuthSessionState;
+    constructor(http: HttpClient, userInfoService: UserInfoService, metadataProvider: MetadataProviderService, translationManager: TranslationManagerService, ngZone: NgZone);
     /**
-     * Provider letto da `<wuic-import-export-button>` al click su Export XLS.
-     * Arrow function (NON metodo) per preservare il binding di `this` quando
-     * passata come Input — un metodo verrebbe richiamato col `this` del child.
-     * Ritorna lo stato filtri LIVE del datasource: include i filtri applicati
-     * via header/filter-bar che NON vengono propagati nella URL query string.
+     * Allinea ngx-translate alla lingua dell'utente appena autenticato/hydratato.
+     * Necessario perche' il TranslationManagerService bootstrap risolve la lingua
+     * via `userInfoService.getuserInfo()` quando NESSUN utente e' ancora loggato,
+     * finendo di default su `navigator.language` o 'it-IT'. Senza questa call
+     * esplicita post-login, le traduzioni rese dal primo render (toolbar, menu,
+     * dialog) restano "appiccicate" alla lingua di bootstrap finche' l'utente
+     * non cambia lingua manualmente dal selettore, che invece chiama direttamente
+     * `useLanguage()`. Chiamata best-effort: fallisce silenzioso se la lingua non
+     * e' supportata o la tabella traduzioni non e' ancora pronta.
      */
-    getCurrentFilterInfoForExport: () => any;
+    private applyUserLanguageToTranslations;
     /**
-     * Evento emesso subito prima del rendering logico della singola riga.
-     * Il consumer puo annullare la riga chiamando `cancelRender()`.
+     * Inizializza il servizio una sola volta (o forzatamente) e carica lo stato sessione corrente via `refreshAll`.
+     * @param force Se `true` forza una nuova inizializzazione anche se gia avvenuta.
      */
-    onBeforeRowRender: EventEmitter<ListGridBeforeRowRenderEvent>;
+    initialize(force?: boolean): Promise<void>;
     /**
-     * Evento emesso subito dopo il rendering logico della singola riga.
+     * 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.
      */
-    onAfterRowRender: EventEmitter<ListGridAfterRowRenderEvent>;
+    private hydrateFromServerCookie;
     /**
-     * Evento emesso al termine del ciclo di binding dati della griglia.
+     * 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.
      */
-    onAfterRender: EventEmitter<ListGridAfterRenderEvent>;
+    refreshAll(): Promise<void>;
     /**
-     * Evento emesso su paging (evento p-table onPage).
+     * Aggiorna il `returnUrl` nello stato sessione applicando normalizzazione anti-open-redirect.
+     * @param returnUrl URL di ritorno post login/logout.
      */
-    onPaging: EventEmitter<any>;
+    setReturnUrl(returnUrl: string): void;
     /**
-     * Evento emesso su sorting (evento p-table onSort).
+     * Avvia il login OAuth reindirizzando il browser a `Auth/Login` con `returnUrl` codificato.
+     * @param returnUrl URL di ritorno post login/logout.
      */
-    onSorting: EventEmitter<any>;
+    login(returnUrl?: string): void;
     /**
-     * Evento emesso su filtering (evento p-table onFilter).
+     * Esegue logout OAuth: pulisce prima stato client (storage + DB locali) e custom settings, poi redirect a `Auth/Logout`.
+     * @param returnUrl URL di ritorno post login/logout.
      */
-    onFiltering: EventEmitter<any>;
+    logout(returnUrl?: string): Promise<void>;
     /**
-     * Evento emesso dopo un refresh esplicito (click su bottone "Aggiorna"
-     * del toolbar o invocazione di `refresh()` da codice). Gli host in Pattern 3
-     * server-side possono usarlo per ri-fetchare dal loro backend custom.
+     * Esegue login legacy via `MetaService.login`, interpreta le varianti payload storiche (`isLogged`, `value`, JSON string)
+     * e in caso positivo salva l'utente nel cookie `k-user`.
+     * @param username Username credenziale di autenticazione.
+     * @param password Password credenziale di autenticazione.
      */
-    onRefresh: EventEmitter<void>;
+    legacyLogin(username: string, password: string, captchaToken?: string): Promise<boolean>;
     /**
-     * Eventi p-table esposti lato host.
-     */
-    onPTableSelectionChange: EventEmitter<any>;
+     * 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>;
+    /**
+     * Multi-tenant: invoca `MetaService.switchAzienda` lato server per
+     * cambiare l'azienda attiva della sessione corrente. Solo i superadmin
+     * possono usarla — il server ritorna 401 altrimenti.
+     *
+     * Dopo lo switch e' OBBLIGATORIO un `window.location.reload()`:
+     *   - il cookie `k-user` e' stato riemesso con il nuovo `azienda_id`,
+     *     ma `UserInfoService` ha ancora in cache la vecchia copia;
+     *   - il singleton Dexie `MetaDB` punta al DB del tenant precedente,
+     *     `cleanupOrphanTenantDbs` lo droppa al boot successivo;
+     *   - tutte le pagine aperte vanno ricaricate per rifrescare menu /
+     *     metadata / cache locali con la tenant nuova.
+     *
+     * Convenzione: `idAzienda = 0` significa "torna al DB primario" (no
+     * tenant scope) — utile a superadmin per amministrare il livello
+     * primario senza loggare con un altro account.
+     */
+    switchAzienda(idAzienda: number): Promise<{
+        ok: boolean;
+        azienda_id: number;
+        azienda_id_previous: number;
+    } | null>;
+    /**
+     * Multi-tenant: legge la lista delle aziende disponibili dal server.
+     * Usa l'endpoint AsmxProxy `MetaService.getCompaniesList` (legge da
+     * tabella `aziende` sul DB metadati primario). Il server filtra alle
+     * aziende con mapping di connessione valido (colonne
+     * `Aziende.Connessione_DB_Dati` / `CONNESSIONE_DB_Meta` valorizzate)
+     * quando il flag `multiConnectionEnabled` e' on.
+     */
+    getAvailableCompanies(): Promise<Array<{
+        ID_Azienda: number;
+        Nome_Azienda: string;
+    }>>;
+    /**
+     * Pulisce lo stato runtime e le cache associate.
+     * Gestisce anche persistenza locale su IndexedDB/Dexie quando prevista.
+     * @returns Valore restituito dal metodo (Promise<void>).
+     */
+    private clearClientRuntimeState;
+    /**
+     * Pulisce lo stato runtime e le cache associate.
+     * Legge/scrive dati persistenti su storage browser.
+     */
+    private clearBrowserStorage;
+    /**
+     * Rimuove i dati target aggiornando lo stato del servizio.
+     * Gestisce anche persistenza locale su IndexedDB/Dexie quando prevista.
+     * @param dbName Nome database locale/remote da trattare.
+     * @returns Valore restituito dal metodo (Promise<void>).
+     */
+    private deleteDexieDatabase;
+    /**
+     * Rimuove i dati target aggiornando lo stato del servizio.
+     * Gestisce anche persistenza locale su IndexedDB/Dexie quando prevista.
+     * @param dbName Nome database locale/remote da trattare.
+     * @returns Valore restituito dal metodo (Promise<void>).
+     */
+    private deleteIndexedDbByName;
+    /**
+     * Carica e cache-a i custom settings dell'utente loggato in localStorage allineando il bootstrap sessione con MetadataProvider.
+     */
+    private bootstrapUserCustomSettings;
+    /**
+     * Configura il timeout di sessione in minuti. Chiamato dal meta-menu dopo aver letto AuthConfig.
+     */
+    setSessionTimeout(minutes: number, warningMinutes?: number): void;
+    private activityListenersAttached;
+    /** Timestamp dell'ultimo reset throttled, in ms epoch. */
+    private lastActivityResetAt;
+    /** Min intervallo tra reset throttled (mousemove/scroll). 1s e' un buon compromesso
+     *  tra responsiveness al "vero" idle e overhead da event flood. */
+    private static readonly ACTIVITY_RESET_THROTTLE_MS;
+    private setupActivityListeners;
+    /**
+     * Avvia/riavvia i timer di sessione. Chiamato dopo login e ad ogni attività HTTP.
+     */
+    resetSessionTimer(): void;
+    private startSessionExpiryCountdown;
+    private handleSessionExpired;
+    private clearSessionTimers;
+    private isUserAuthenticated;
+    /**
+     * 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.
+     * @param action Azione richiesta nel flusso corrente.
+     */
+    private buildEndpoint;
+    /**
+     * Costruisce una struttura derivata a partire dallo stato corrente.
+     * @param fullMethodName Nome completo metodo legacy (es. `MetaService.login`).
+     */
+    private buildMetaAsmxEndpoint;
+    /**
+     * Risolve la base URL API usata dal servizio: preferisce `appSettings.api_url`, fallback su `${window.location.origin}/api/`.
+     */
+    private getApiBaseUrl;
+    /**
+     * Valuta una condizione booleana sullo stato o sull'input corrente.
+     * @returns Valore restituito dal metodo (boolean).
+     */
+    private isOAuthEnabledInSettings;
+    /**
+     * Normalizza il payload in una forma coerente per i passaggi successivi.
+     * @param returnUrl URL di ritorno post login/logout.
+     */
+    private normalizeReturnUrl;
+    /**
+     * Ritorna l'URL browser corrente usato come `returnUrl` predefinito in login/logout.
+     */
+    private getCurrentLocalUrl;
+    /**
+     * Esegue il parsing del valore in ingresso con fallback sicuro.
+     * @param raw Payload legacy da interpretare (stringa JSON, oggetto o wrapper con `value`).
+     * @returns Valore restituito dal metodo (any).
+     */
+    private parseLegacyLoginResponse;
+    /**
+     * Estrae un messaggio errore leggibile da payload legacy eterogenei (raw/parsing/error/value) del login storico.
+     * @param raw Payload grezzo risposta/errore.
+     * @param parsed Payload gia interpretato.
+     * @returns Messaggio errore normalizzato oppure `null`.
+     */
+    private extractLegacyLoginError;
+    /**
+     * Prova a leggere un messaggio errore da stringhe plain/JSON o da oggetti con chiavi comuni (`message`, `error`, `ExceptionMessage`).
+     * @param candidate Sorgente messaggio da analizzare.
+     * @returns Messaggio trovato oppure `null`.
+     */
+    private readMessage;
+    /**
+     * Log diagnostico opzionale del flusso login legacy, attivo solo con `appSettings.debugLegacyLogin === true`.
+     * @param kind Tipo evento (`response` o `error`).
+     * @param payload Payload da tracciare in console.
+     */
+    private debugLegacyLogin;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AuthSessionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AuthSessionService>;
+}
+
+/**
+ * Multi-tenant azienda switcher.
+ *
+ * Componente standalone visibile SOLO ai superadmin quando il server e' in
+ * modalita' `multiConnectionEnabled`. Espone una dropdown con le aziende
+ * disponibili (lette da `MetaService.getCompaniesList`, intersect con
+ * mapping connection valido su Aziende) + un'opzione "Nessuna azienda" (id=0) che
+ * fa tornare il superadmin al DB metadati primario (no tenant scope,
+ * comportamento single-tenant).
+ *
+ * Lifecyle:
+ *   - alla creazione legge `UserInfoService` per determinare se mostrarsi;
+ *   - fetcha la lista aziende dal server una sola volta;
+ *   - su change → invoca `AuthSessionService.switchAzienda(id)` che riemette
+ *     il cookie e fa `window.location.reload()`.
+ *
+ * Drop-in usage (esempio in CrmApp / WuicTest topbar):
+ * <code>&lt;wuic-azienda-switcher /&gt;</code>
+ *
+ * Performance:
+ *   - OnPush change detection;
+ *   - fetch one-shot al mount, niente polling;
+ *   - early return invisibile quando l'utente non e' superadmin → costo
+ *     trascurabile sulle shell che lo includono incondizionatamente.
+ */
+declare class WuicAziendaSwitcherComponent implements OnInit {
+    private userInfoService;
+    private authSessionService;
+    private cdr;
+    /**
+     * True se il componente deve renderizzare la dropdown. False per
+     * (a) utenti non superadmin, (b) flag `multiConnectionEnabled=false`,
+     * (c) sessione anonima. Calcolato una volta a `ngOnInit`.
+     *
+     * Quando `false`, l'**host element** stesso viene nascosto via
+     * <see cref="hostHidden"/> HostBinding: niente margine, niente spazio
+     * occupato. Cosi' chi embedda `<wuic-azienda-switcher />` in una topbar
+     * non deve gestire la visibilita' del wrapper esternamente (regola DRY:
+     * la condizione di mostrare/nascondere il widget e' una proprieta'
+     * intrinseca del widget, non del consumer).
+     */
+    visible: boolean;
+    /**
+     * HostBinding: applica l'attributo HTML `hidden` sull'host quando il
+     * widget non deve mostrarsi. `hidden` e' un attributo standard W3C che
+     * imposta `display: none` di default → l'elemento collassa dal layout
+     * (margini inclusi) e non e' nemmeno tab-navigable.
+     *
+     * Ritorno: stringa vuota (presente) o null (assente). Angular gestisce
+     * la presenza/assenza dell'attributo in base al valore.
+     */
+    get hostHidden(): string | null;
+    /**
+     * Lista delle aziende disponibili. Sempre include `{ ID_Azienda: 0,
+     * Nome_Azienda: 'Nessuna azienda (DB primario)' }` come prima opzione.
+     * Ogni entry puo' avere `LogoFileName` (relativo a `/assets/azienda-logos/`)
+     * — quando null/missing il client fa fallback alle iniziali del nome.
+     */
+    companies: Array<{
+        ID_Azienda: number;
+        Nome_Azienda: string;
+        LogoFileName?: string | null;
+    }>;
+    /**
+     * Base path per le immagini logo aziendali. `/assets/azienda-logos/` =
+     * servito staticamente da ASP.NET Core (`wwwroot/assets/azienda-logos/`).
+     */
+    private static readonly LOGO_BASE;
+    /**
+     * ID dell'azienda attualmente selezionata. Bind two-way con la dropdown
+     * PrimeNG. Inizializzato dall'`UserInfo.azienda_id` cached.
+     */
+    selectedAziendaId: number;
+    /**
+     * True mentre la chiamata HTTP `switchAzienda` e' in volo. Previene click
+     * doppi che scatenerebbero due reload.
+     */
+    switching: boolean;
+    /**
+     * Eventuale messaggio di errore da mostrare sotto la dropdown. Reset al
+     * prossimo tentativo.
+     */
+    errorMessage: string | null;
+    /**
+     * Label leggibile dell'azienda attiva nella sessione corrente. Mostrato
+     * come tooltip al hover sul widget icon-only. Aggiornato al boot e ad
+     * ogni `onAziendaChange`.
+     */
+    currentLabel: string;
+    /**
+     * URL del logo dell'azienda attiva, oppure null per fallback icona.
+     */
+    currentLogoUrl: string | null;
+    constructor(userInfoService: UserInfoService, authSessionService: AuthSessionService, cdr: ChangeDetectorRef);
+    ngOnInit(): Promise<void>;
+    /**
+     * Aggiorna `currentLabel`, `currentLogoUrl` dal `selectedAziendaId`
+     * corrente. Chiamato dopo fetch lista e dopo cambio selezione. Quando
+     * `selectedAziendaId` non corrisponde a nessuna azienda (tipicamente 0
+     * = mai assegnato), tooltip + display mostrano "Seleziona azienda…".
+     */
+    private refreshCurrentLabel;
+    /**
+     * True se non c'e' un'azienda selezionata valida (selectedAziendaId=0
+     * o id non presente nella lista). Usato dal template per swap
+     * icona/placeholder.
+     */
+    get noSelection(): boolean;
+    /**
+     * Costruisce l'URL dell'immagine logo per l'azienda passata, o null se
+     * non c'e' `LogoFileName`. URL e' assoluto relativo al root del frontend
+     * (`/assets/azienda-logos/<file>`) — il dev server Angular proxa lo
+     * stesso path da `wwwroot/assets/azienda-logos/` in prod.
+     */
+    logoUrlFor(c: {
+        LogoFileName?: string | null;
+    } | undefined | null): string | null;
+    /**
+     * Classe icona PrimeIcons di fallback quando l'azienda non ha `LogoFileName`
+     * (o il file non si carica). Per le aziende reali sempre `pi-building`.
+     * Per `id=0` (mai assegnato / lista vuota) `pi-question` come hint che
+     * l'utente DEVE selezionare un'azienda.
+     */
+    defaultIconClassFor(idAzienda: number | undefined | null): string;
+    /**
+     * onerror handler dell'<img> nel selectedItem template. Se il logo
+     * fallisce a caricarsi (404 o broken), ricadiamo sull'icona predefinita.
+     */
+    onLogoError(): void;
+    /**
+     * Handler del change PrimeNG. Filtra no-op (stesso valore) per evitare
+     * reload infiniti se PrimeNG emette change al mount.
+     */
+    onAziendaChange(event: {
+        value: number;
+    }): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WuicAziendaSwitcherComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WuicAziendaSwitcherComponent, "wuic-azienda-switcher", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Phase I.3 — CustomAttributesService (framework, additive feature flag).
+ *
+ * Service centralizzato per leggere/scrivere Custom Attributes/Values/Lookup
+ * per una entity in una route. Attivato per route con
+ * `MetadatiTabella.custom_attribute_context` valorizzato.
+ *
+ * Backend contract (app-level, es. CostCnh `CustomAttributesController.cs`):
+ *   GET    /api/custom-attributes/definitions?context=program
+ *   GET    /api/custom-attributes/resolve?context=program&siteId=N&projectClassId=M
+ *   GET    /api/custom-attributes/values?entitySchema=core&entityName=program&entityId=42
+ *   POST   /api/custom-attributes/values          (upsert batch)
+ *   DELETE /api/custom-attributes/values/{cvId}
+ *   GET    /api/custom-attributes/lookup/{attributeId}
+ *   POST   /api/custom-attributes/lookup          (upsert option)
+ *
+ * App-side: per usare questo service, l'app deve esporre i 7 endpoint sopra.
+ * Vedi `CostCnh.Controllers.CustomAttributesController` come reference impl.
+ */
+interface CustomAttributeDefinition {
+    id: number;
+    context: string;
+    code: string;
+    display_name: string;
+    description?: string;
+    value_type: 'text' | 'number' | 'date' | 'bool' | 'lookup' | 'currency' | 'structure';
+    allow_multiple: boolean;
+    has_lookup: boolean;
+    is_required: boolean;
+    is_readonly: boolean;
+    edit_order: number;
+    is_time_based: boolean;
+    mode: number;
+    external_system?: string;
+    external_code?: string;
+}
+interface CustomAttributeResolved extends CustomAttributeDefinition {
+    attribute_id: number;
+    mapping_id?: number;
+    label_loc?: string;
+    year_from?: number;
+    year_to?: number;
+    is_visible: boolean;
+    effective_order: number;
+}
+interface CustomValue {
+    cv_id: number;
+    attribute_id: number;
+    attribute_code: string;
+    attribute_label: string;
+    value_type: string;
+    has_lookup: boolean;
+    allow_multiple: boolean;
+    value_text?: string | null;
+    value_number?: number | null;
+    value_date?: string | null;
+    value_bool?: boolean | null;
+    custom_lookup_id?: number | null;
+    lookup_code?: string | null;
+    lookup_value?: string | null;
+    lookup_descr?: string | null;
+    year_num?: number | null;
+    ref_object_id?: string | null;
+}
+interface CustomLookupOption {
+    id: number;
+    custom_attribute_id: number;
+    code: string;
+    value: string;
+    descr?: string;
+    sort_order: number;
+    is_active: boolean;
+    external_id?: string;
+}
+interface CvUpsertItem {
+    attributeId: number;
+    entitySchema: string;
+    entityName: string;
+    entityId: string;
+    valueText?: string | null;
+    valueNumber?: number | null;
+    valueDate?: string | null;
+    valueBool?: boolean | null;
+    customLookupId?: number | null;
+    yearNum?: number | null;
+    existingCvId?: number | null;
+}
+declare class CustomAttributesService {
+    private http;
+    /** Endpoint base. Override-abile via DI/config se l'app usa path diverso. */
+    endpointBase: string;
+    /**
+     * Cache per (context+scope) → applicable definitions.
+     * Invalidata su `clearCache()` (es. dopo invalidate-metadata-runtime).
+     */
+    private resolveCache;
+    /** Cache per (attribute_id) → lookup options. */
+    private lookupCache;
+    constructor(http: HttpClient);
+    /** Lista tutte le definizioni di un context (admin UI). */
+    listDefinitions(context?: string): Promise<CustomAttributeDefinition[]>;
+    /**
+     * Risolve le CA applicabili a una entity in uno scope (site, project_class, tree_kind).
+     * Usata da `<wuic-parametric-dialog>` per sapere quali field inline mostrare.
+     */
+    resolve(context: string, siteId?: number, projectClassId?: number, treeKindId?: number): Promise<CustomAttributeResolved[]>;
+    /** Leggi i CV correnti di una entity specifica. */
+    getValues(entitySchema: string, entityName: string, entityId: string | number, yearNum?: number): Promise<CustomValue[]>;
+    /** Upsert batch (INSERT new + UPDATE existing via `existingCvId`). */
+    upsertValues(items: CvUpsertItem[]): Promise<{
+        upserted: number;
+    }>;
+    /** Soft delete di un CV. */
+    deleteValue(cvId: number): Promise<{
+        deleted: number;
+    }>;
+    /** Lookup options di un attribute (cached). */
+    getLookupOptions(attributeId: number): Promise<CustomLookupOption[]>;
+    /** Upsert lookup option (admin UI). Trigger cascade rename gestito server-side. */
+    upsertLookup(option: Omit<CustomLookupOption, 'id' | 'is_active'> & {
+        attributeId: number;
+    }): Promise<{
+        affected: number;
+    }>;
+    /** Reset cache (chiamato dopo `invalidateMetadataRuntime`). */
+    clearCache(): void;
+    /**
+     * Estrae i CA token da una filter string e produce un payload separato
+     * `wherestringCA` / `wherevaluesCA` da passare al backend, lasciando i
+     * filter standard sui campi nativi non alterati.
+     *
+     * Pattern legacy: `CA_<attribute_code>___<value>` AND `CS_<attribute_code>___<sortdir>`.
+     *
+     * @returns { nativeFilter, caTokens: { code, value, op }[] }
+     */
+    parseFilterTokens(rawFilter: string | null | undefined): {
+        nativeFilter: string;
+        caTokens: {
+            code: string;
+            value: string;
+            op: 'eq' | 'contains';
+        }[];
+    };
+    static ɵfac: i0.ɵɵFactoryDeclaration<CustomAttributesService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CustomAttributesService>;
+}
+
+declare class DeviceAwarenessService implements OnDestroy {
+    private static readonly DEFAULT_BREAKPOINT_PX;
+    private mediaQueryList?;
+    private mediaQueryListener?;
+    private readonly isMobileSubject;
+    readonly isMobile$: Observable<boolean>;
+    constructor();
+    get isMobile(): boolean;
+    ngOnDestroy(): void;
+    private resolveBreakpointPx;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DeviceAwarenessService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DeviceAwarenessService>;
+}
+
+interface ListGridSavedState {
+    id: string;
+    name: string;
+    description: string;
+    isDefault: boolean;
+    createdAt: string;
+    filterInfo: any;
+    sortInfo: any[];
+    pageInfo: {
+        currentPage: number;
+        pageSize: number;
+    };
+    columnWidths: {
+        [field: string]: number;
+    };
+    columnLayout?: ListGridColumnLayout;
+}
+interface ListGridColumnLayout {
+    order: string[];
+    hidden: string[];
+    pinnedLeft: string[];
+    pinnedRight: string[];
+}
+interface ReportVariableInput {
+    name: string;
+    alias: string;
+    value: string;
+    type?: string;
+}
+interface GridPendingChangeItem {
+    id: string;
+    change: TrackedChange;
+    label: string;
+    details: string;
+    selected: boolean;
+}
+interface ListGridBeforeRowRenderEvent {
+    row: any;
+    rowIndex: number;
+    cancel: boolean;
+    cancelRender: () => void;
+}
+interface ListGridAfterRowRenderEvent {
+    row: any;
+    rowIndex: number;
+}
+interface ListGridAfterRenderEvent {
+    rows: any[];
+    totalRecords: number;
+    metaInfo: MetaInfo;
+    datasource?: DataSourceComponent;
+}
+declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDataBoundHostComponent {
+    private metaSrv;
+    private sanitizer;
+    private route;
+    private router;
+    private location;
+    private titleService;
+    private trslSrv;
+    private cd;
+    userInfo: UserInfoService;
+    private elementRef;
+    deviceAwareness: DeviceAwarenessService;
+    private customAttributesService?;
+    private static readonly FORCED_VIRTUALIZATION_PAGE_SIZE_THRESHOLD;
+    private static readonly FORCED_VIRTUALIZATION_ITEM_SIZE;
+    private static readonly ACTION_BUTTON_VISIBLE_ROWS_OVERSCAN;
+    private static readonly ACTION_BUTTON_INITIAL_VISIBLE_ROWS_FALLBACK;
+    private static readonly GRID_VIEW_STATES_SETTINGS_KEY;
+    private static readonly GRID_COLUMN_LAYOUT_SETTINGS_KEY;
+    private static selectButtonGuardInstalled;
+    private columnFilterRenderEpochByField;
+    private actionButtonsVisibleStartIndex;
+    private actionButtonsVisibleEndIndex;
+    private actionButtonsLimitToVisibleRows;
+    private actionButtonsPreLimitBeforeContainerReady;
+    private actionButtonsScrollContainer;
+    private actionButtonsScrollRafToken;
+    private actionButtonsScrollHandler;
+    private inlineCellSaveInFlightByRowKey;
+    private inlineCellSaveDebounceByRowKey;
+    private inlineCellLastChangedFieldByRowKey;
+    private inlineBatchOriginalByRowKey;
+    private inlineGridRuntimeFieldCacheByKey;
+    private suppressNextInlineFetchInfoRebind;
+    getRuntimeGridFieldMetaFn: (metaColumn: MetadatiColonna, rowData: any) => MetadatiColonna;
+    hardcodedRoute: string;
+    parentRecord: any;
+    parentMetaInfo: MetaInfo;
+    datasource: BehaviorSubject<DataSourceComponent>;
+    hardcodedDatasource: DataSourceComponent;
+    rowCustomSelect: (rowData: any, $event: any, dt: Table) => void;
+    hideToolbar: boolean;
+    /**
+     * Provider letto da `<wuic-import-export-button>` al click su Export XLS.
+     * Arrow function (NON metodo) per preservare il binding di `this` quando
+     * passata come Input — un metodo verrebbe richiamato col `this` del child.
+     * Ritorna lo stato filtri LIVE del datasource: include i filtri applicati
+     * via header/filter-bar che NON vengono propagati nella URL query string.
+     */
+    getCurrentFilterInfoForExport: () => any;
+    /**
+     * Evento emesso subito prima del rendering logico della singola riga.
+     * Il consumer puo annullare la riga chiamando `cancelRender()`.
+     */
+    onBeforeRowRender: EventEmitter<ListGridBeforeRowRenderEvent>;
+    /**
+     * Evento emesso subito dopo il rendering logico della singola riga.
+     */
+    onAfterRowRender: EventEmitter<ListGridAfterRowRenderEvent>;
+    /**
+     * Evento emesso al termine del ciclo di binding dati della griglia.
+     */
+    onAfterRender: EventEmitter<ListGridAfterRenderEvent>;
+    /**
+     * Evento emesso su paging (evento p-table onPage).
+     */
+    onPaging: EventEmitter<any>;
+    /**
+     * Evento emesso su sorting (evento p-table onSort).
+     */
+    onSorting: EventEmitter<any>;
+    /**
+     * Evento emesso su filtering (evento p-table onFilter).
+     */
+    onFiltering: EventEmitter<any>;
+    /**
+     * Evento emesso dopo un refresh esplicito (click su bottone "Aggiorna"
+     * del toolbar o invocazione di `refresh()` da codice). Gli host in Pattern 3
+     * server-side possono usarlo per ri-fetchare dal loro backend custom.
+     */
+    onRefresh: EventEmitter<void>;
+    /**
+     * Eventi p-table esposti lato host.
+     */
+    onPTableSelectionChange: EventEmitter<any>;
     onPTableRowExpand: EventEmitter<TableRowExpandEvent<any>>;
     onPTableRowCollapse: EventEmitter<TableRowCollapseEvent>;
     onPTableColumnResize: EventEmitter<any>;
@@ -5555,7 +6302,29 @@ 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, elementRef: ElementRef<HTMLElement>, deviceAwareness: DeviceAwarenessService);
+    constructor(metaSrv: MetadataProviderService, sanitizer: DomSanitizer, route: ActivatedRoute, router: Router, location: Location, titleService: Title, trslSrv: TranslationManagerService, cd: ChangeDetectorRef, userInfo: UserInfoService, elementRef: ElementRef<HTMLElement>, deviceAwareness: DeviceAwarenessService, customAttributesService?: CustomAttributesService);
+    /**
+     * Phase I.3 — Estrae i CA token (CA_<code>___value / CS_<code>___order) dalla
+     * filter string corrente, ritornandoli separati per il backend SP che
+     * costruisce il JOIN dinamico su core.custom_value.
+     *
+     * Pattern legacy `Filter_ApplyProjects.sql` con `wherestringCA`/`wherevaluesCA`.
+     *
+     * Backward-compat: se nessun CA token presente, ritorna `caTokens: []`.
+     * Le app possono usare questo getter per accodare i CA token al payload
+     * delle chiamate stored procedure (es. via `_extra` field di filterInfo).
+     */
+    getCustomAttributeFilterTokens(): {
+        code: string;
+        value: string;
+        op: 'eq' | 'contains';
+    }[];
+    /**
+     * Helper interno: serializza i filtri attivi in una stringa con tokens CA_X / CS_X.
+     * Cerca tra i filterInfo.filters quelli con field name del tipo `ca:code`
+     * o `cs:code` (convenzione opt-in) e li emette in formato CA_code___value.
+     */
+    private serializeFilterInfoToTokenString;
     /**
      * Inizializza il componente preparando stato, sottoscrizioni e primi caricamenti richiesti.
      */
@@ -6709,7 +7478,7 @@ declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDa
      * @returns Valore numerico derivato dai calcoli interni (conteggio, indice, priorita o metrica operativa).
      */
     private getWidthFromResizeEvent;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ListGridComponent, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ListGridComponent, [null, null, null, null, null, null, null, null, null, null, null, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ListGridComponent, "wuic-list-grid", never, { "hardcodedRoute": { "alias": "hardcodedRoute"; "required": false; }; "parentRecord": { "alias": "parentRecord"; "required": false; }; "parentMetaInfo": { "alias": "parentMetaInfo"; "required": false; }; "datasource": { "alias": "datasource"; "required": false; }; "hardcodedDatasource": { "alias": "hardcodedDatasource"; "required": false; }; "rowCustomSelect": { "alias": "rowCustomSelect"; "required": false; }; "hideToolbar": { "alias": "hideToolbar"; "required": false; }; }, { "onBeforeRowRender": "onBeforeRowRender"; "onAfterRowRender": "onAfterRowRender"; "onAfterRender": "onAfterRender"; "onPaging": "onPaging"; "onSorting": "onSorting"; "onFiltering": "onFiltering"; "onRefresh": "onRefresh"; "onPTableSelectionChange": "onPTableSelectionChange"; "onPTableRowExpand": "onPTableRowExpand"; "onPTableRowCollapse": "onPTableRowCollapse"; "onPTableColumnResize": "onPTableColumnResize"; "onPTableColumnReorder": "onPTableColumnReorder"; }, never, never, true, never>;
 }
 
@@ -8407,8 +9176,9 @@ declare class CarouselListComponent implements IBindable, IDesigner<CarouselOpti
     static ɵcmp: i0.ɵɵComponentDeclaration<CarouselListComponent, "wuic-carousel-list", never, { "hardcodedRoute": { "alias": "hardcodedRoute"; "required": false; }; "parentRecord": { "alias": "parentRecord"; "required": false; }; "parentMetaInfo": { "alias": "parentMetaInfo"; "required": false; }; "datasource": { "alias": "datasource"; "required": false; }; "hardcodedDatasource": { "alias": "hardcodedDatasource"; "required": false; }; "hideToolbar": { "alias": "hideToolbar"; "required": false; }; }, { "onCarouselPage": "onCarouselPage"; "onCarouselItemClick": "onCarouselItemClick"; "onCarouselDataBound": "onCarouselDataBound"; }, never, never, true, never>;
 }
 
-declare class LazySpreadsheetListSfComponent implements OnInit {
+declare class LazySpreadsheetListSfComponent implements OnInit, OnDestroy, AfterViewChecked {
     private readonly cdr;
+    private readonly activatedRoute;
     innerOutlet?: NgComponentOutlet;
     hardcodedRoute: string;
     parentRecord: any;
@@ -8416,9 +9186,46 @@ declare class LazySpreadsheetListSfComponent implements OnInit {
     datasource: BehaviorSubject<DataSourceComponent>;
     hardcodedDatasource: DataSourceComponent;
     hideToolbar: boolean;
+    /** Override esplicito che forza l'attivazione lock-awareness. Default false. */
+    enableLockAwareness: boolean;
+    /**
+     * Scope di lock generico. Se non valorizzato dal parent, viene auto-popolato
+     * dalla URL: tutti i query param vengono caricati come key→value (numeric
+     * coercion best-effort). La mdpropsbag della route definisce quali field sono
+     * "primary" (URL path segment) e quali sono required.
+     */
+    lockScope: Record<string, any>;
+    /**
+     * Override heartbeat in secondi. Se omesso, viene preso dalla
+     * `mdpropsbag.archetypes.spreadsheet.lock.heartbeatIntervalSec` (default 60).
+     */
+    heartbeatIntervalSec?: number;
+    /** Mostra formula bar Syncfusion. Default false (BC). Override anche via URL `?show_formula_bar=1`. */
+    showFormulaBar: boolean;
+    /** Mostra ribbon Syncfusion completo. Default false. Override anche via URL `?show_ribbon=1`. */
+    showRibbon: boolean;
+    onLockAcquired: EventEmitter<{
+        lockToken: string;
+        lockId: number;
+        lockExpiresUtc: Date;
+        outcome: "acquired" | "refreshed";
+    }>;
+    onLockConflict: EventEmitter<{
+        conflictUserId: number | null;
+        lockExpiresUtc: Date | null;
+    }>;
+    onLockReleased: EventEmitter<{
+        released: number;
+    }>;
+    onLockExpired: EventEmitter<void>;
     loadedComponent: any;
-    constructor(cdr: ChangeDetectorRef);
+    private routeQuerySub?;
+    constructor(cdr: ChangeDetectorRef, activatedRoute: ActivatedRoute);
     ngOnInit(): Promise<void>;
+    ngOnDestroy(): void;
+    private lockEventSubs;
+    private innerHooked;
+    ngAfterViewChecked(): void;
     componentInputs(): {
         hardcodedRoute: string;
         parentRecord: any;
@@ -8426,9 +9233,14 @@ declare class LazySpreadsheetListSfComponent implements OnInit {
         datasource: BehaviorSubject<DataSourceComponent>;
         hardcodedDatasource: DataSourceComponent;
         hideToolbar: boolean;
+        enableLockAwareness: boolean;
+        lockScope: Record<string, any>;
+        heartbeatIntervalSec: number;
+        showFormulaBar: boolean;
+        showRibbon: boolean;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<LazySpreadsheetListSfComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LazySpreadsheetListSfComponent, "wuic-spreadsheet-list-sf-lazy", never, { "hardcodedRoute": { "alias": "hardcodedRoute"; "required": false; }; "parentRecord": { "alias": "parentRecord"; "required": false; }; "parentMetaInfo": { "alias": "parentMetaInfo"; "required": false; }; "datasource": { "alias": "datasource"; "required": false; }; "hardcodedDatasource": { "alias": "hardcodedDatasource"; "required": false; }; "hideToolbar": { "alias": "hideToolbar"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LazySpreadsheetListSfComponent, "wuic-spreadsheet-list-sf-lazy", never, { "hardcodedRoute": { "alias": "hardcodedRoute"; "required": false; }; "parentRecord": { "alias": "parentRecord"; "required": false; }; "parentMetaInfo": { "alias": "parentMetaInfo"; "required": false; }; "datasource": { "alias": "datasource"; "required": false; }; "hardcodedDatasource": { "alias": "hardcodedDatasource"; "required": false; }; "hideToolbar": { "alias": "hideToolbar"; "required": false; }; "enableLockAwareness": { "alias": "enableLockAwareness"; "required": false; }; "lockScope": { "alias": "lockScope"; "required": false; }; "heartbeatIntervalSec": { "alias": "heartbeatIntervalSec"; "required": false; }; "showFormulaBar": { "alias": "showFormulaBar"; "required": false; }; "showRibbon": { "alias": "showRibbon"; "required": false; }; }, { "onLockAcquired": "onLockAcquired"; "onLockConflict": "onLockConflict"; "onLockReleased": "onLockReleased"; "onLockExpired": "onLockExpired"; }, never, never, true, never>;
 }
 
 declare class TreeListComponent implements OnInit, OnDestroy, IDataBoundHostComponent {
@@ -8649,6 +9461,7 @@ declare class ParametricDialogComponent implements OnInit, AfterViewInit, OnDest
     private router;
     private trnsl;
     private hostElementRef;
+    private customAttributesService;
     private dialogService?;
     /**
      * Input dal componente padre per datasource; usata nella configurazione e nel rendering del componente.
@@ -8749,6 +9562,32 @@ declare class ParametricDialogComponent implements OnInit, AfterViewInit, OnDest
      * Configurazione di presentazione per form template, usata nel rendering del componente.
      */
     formTemplate: any;
+    /**
+     * Phase I.3 — Custom Attributes runtime state.
+     * Popolato in `applyDatasourceSnapshot` quando `tableMetadata.custom_attribute_context`
+     * e' valorizzato. Le definitions resolved vengono iniettate come MetadatiColonna sintetiche
+     * (prefisso `__ca_<code>__`) in `metaInfo.columnMetadata`; i values esistenti vengono
+     * caricati in `record['__ca_<code>__']`. Al save, l'app-level hook va connesso a
+     * `(onCustomAttributesSave)` con `CustomAttributesService.upsertValues()`.
+     */
+    customAttributesResolved: CustomAttributeResolved[];
+    customAttributesValues: CustomValue[];
+    /** Emesso quando l'utente conferma il save: l'app dovrebbe chiamare `caService.upsertValues()`. */
+    onCustomAttributesSave: EventEmitter<{
+        items: {
+            attributeId: number;
+            entitySchema: string;
+            entityName: string;
+            entityId: string;
+            valueText?: string;
+            valueNumber?: number;
+            valueDate?: string;
+            valueBool?: boolean;
+            customLookupId?: number;
+            yearNum?: number;
+            existingCvId?: number;
+        }[];
+    }>;
     /**
    * Flag di stato che governa il comportamento UI/logico relativo a cloning.
    */
@@ -8825,7 +9664,8 @@ declare class ParametricDialogComponent implements OnInit, AfterViewInit, OnDest
   * @param route Informazione di navigazione usata per risolvere la route di destinazione.
   * @param router Informazione di navigazione usata per risolvere la route di destinazione.
   */
-    constructor(ref: DynamicDialogRef | null, config: DynamicDialogConfig | null, route: ActivatedRoute, router: Router, trnsl: TranslationManagerService, hostElementRef: ElementRef<HTMLElement>, dialogService?: DialogService);
+    constructor(ref: DynamicDialogRef | null, config: DynamicDialogConfig | null, route: ActivatedRoute, router: Router, trnsl: TranslationManagerService, hostElementRef: ElementRef<HTMLElement>, customAttributesService: CustomAttributesService | null, // Phase I.3
+    dialogService?: DialogService);
     /**
      * Inizializza il componente preparando stato, sottoscrizioni e primi caricamenti richiesti.
      */
@@ -9028,8 +9868,25 @@ declare class ParametricDialogComponent implements OnInit, AfterViewInit, OnDest
      * quando la schermata viene riaperta subito dopo.
      */
     private reloadTranslationsIfMetadataSave;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ParametricDialogComponent, [{ optional: true; }, { optional: true; }, null, null, null, null, { optional: true; }]>;
-    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>;
+    /**
+     * Se la route ha `tableMetadata.custom_attribute_context` valorizzato e il
+     * `CustomAttributesService` è injectabile, carica:
+     *  1. Le definitions applicable allo scope (resolve TVF)
+     *  2. I CV correnti della entity (getValues TVF)
+     * I CV vengono mergiati in `record` con chiave `__ca_<code>__` cosi' che
+     * eventuali template/form a livello app possano renderizzarli.
+     * Feature flag: senza `custom_attribute_context` settato (default), NO-OP.
+     */
+    private tryLoadCustomAttributes;
+    /**
+     * Helper esposto per app-level form/template: collect i valori CA correnti
+     * dal record e emette `onCustomAttributesSave`. L'app deve chiamare
+     * `CustomAttributesService.upsertValues(items)` come step post-save standard.
+     * Backward-compat: se il listener non e' attaccato, no-op silenzioso.
+     */
+    collectAndEmitCustomAttributesSave(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ParametricDialogComponent, [{ optional: true; }, { optional: true; }, null, null, null, null, { optional: true; }, { optional: true; }]>;
+    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"; "onCustomAttributesSave": "onCustomAttributesSave"; }, never, never, true, never>;
 }
 
 /**
@@ -9258,576 +10115,330 @@ declare class AppSettingsEditorComponent implements OnInit {
      * vecchio worker non e' ancora morto (~1-2s di sovrapposizione), ma sotto
      * ANCM/NSSM la finestra e' molto stretta e il caller (`saveAndApply`)
      * gia' fa un `sleep(Math.max(800, restartDelayMs+200))` prima di chiamare
-     * questo metodo, coprendo il caso normale.
-     */
-    private waitForHealthSimple;
-    /**
-     * Wrapper legacy mantenuto per back-compat: alias di
-     * `waitForHealthSimple`. Eventuali consumer storici che chiamavano
-     * `waitForHealth(ms)` continuano a vedere il polling semplice (non il
-     * 4-phase) — coerente con ambienti prod dove il supervisor gestisce
-     * il restart.
-     */
-    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;
-    private messageService;
-    private confirmationService;
-    private router;
-    private http;
-    private metadataProvider;
-    private static readonly ACTION_KEY_EDIT;
-    data: any;
-    metaInfo: MetaInfo;
-    datasource: BehaviorSubject<DataSourceComponent>;
-    filter?: () => void;
-    simplified: boolean;
-    parentField: string;
-    btn: SplitButton;
-    simpleMenu?: Menu;
-    simplifiedMenuOpen: boolean;
-    items: MenuItem[];
-    selectedValue: any;
-    pkName: string;
-    inlineItems: any[];
-    nonInlineEditingItems: MenuItem[];
-    private translationsLoadedSub?;
-    constructor(trslSrv: TranslationManagerService, cd: ChangeDetectorRef, messageService: MessageService, confirmationService: ConfirmationService, router: Router, http: HttpClient, metadataProvider: MetadataProviderService);
-    /**
-     * Hook di debug locale per ispezionare l'evento click sul pulsante azioni.
-     * @param $event Evento UI ricevuto dal template.
-     */
-    test($event: any): void;
-    /**
-     * Inizializza il menu azioni in base ai metadati tabella/colonna (`md_editable`, `md_deletable`, `md_inline_edit`, colonne `button`).
-     * Calcola anche la PK corrente per le azioni route-based.
-     */
-    ngAfterViewInit(): void;
-    ngOnDestroy(): void;
-    private rebuildActionMenus;
-    private translateLabel;
-    /**
-     * Esegue il comando dell'item selezionato se non disabilitato.
-     * @param item Voce menu azione.
-     */
-    select(item: any): void;
-    /**
-     * Aggiunge al menu le azioni dinamiche derivate dalle colonne metadata di tipo `button`.
-     * @param target Collezione menu da arricchire.
-     */
-    private appendMetadataButtonItems;
-    private getButtonActionRecord;
-    /**
-     * Valuta se un bottone metadata e attivo verificando callback azione e condizione visibilita (`mc_button_visibility_condition`).
-     * @param col Metadato colonna di tipo button.
-     * @returns `true` se il bottone e eseguibile.
-     */
-    private isMetadataButtonEnabled;
-    /**
-     * Esegue l'azione custom del bottone metadata, con eventuale conferma (`mc_button_confirm_message`) e gestione errori centralizzata.
-     * @param col Metadato colonna button.
-     * @param record Record osservabile corrente.
-     * @param event Evento UI di invocazione.
-     */
-    private executeMetadataButton;
-    /**
-     * Avvia il flusso edit del record corrente:
-     * inline edit, popup `EditFormComponent` oppure navigazione route `/{route}/edit/{pk}`.
-     */
-    edit(): void;
-    /**
-     * Richiede conferma e, in caso positivo, elimina il record via `datasource.syncData(..., true)` ricaricando la griglia.
-     */
-    delete(): Promise<void>;
-    private canRestoreFromChangeMaster;
-    private appendRestoreFromChangeMasterActionAsync;
-    private isLogicalDeleteSupportedRoute;
-    private getRecordFieldIgnoreCase;
-    private restoreFromChangeMaster;
-    /**
-     * Apre il record in modalita sola lettura tramite `EditFormComponent` con `readOnly: true`.
-     */
-    detail(): void;
-    /**
-     * Apre `EditFormComponent` in modalita cloning per creare una copia del record corrente.
-     */
-    clone(): void;
-    /**
-     * Salva modifiche inline sincronizzando il record osservabile con backend e riallineando il modello riga in tabella.
-     */
-    save(): Promise<void>;
-    /**
-     * Annulla l'inline edit locale della riga corrente.
-     */
-    cancelEdit(): Promise<void>;
-    /**
-     * Hook evento click principale (attualmente usato come placeholder/debug).
-     * @param $event Evento click.
-     */
-    onClick($event: any): void;
-    /**
-     * Hook richiamato alla chiusura del menu split button.
-     * @param $event Evento PrimeNG.
-     */
-    onMenuHide($event: any): void;
-    /**
-     * Hook richiamato all'apertura del menu split button.
-     * @param $event Evento PrimeNG.
-     */
-    onMenuShow($event: any): void;
-    /**
-     * Hook click dropdown del pulsante azioni (punto estensione per custom behavior).
-     * @param $event Evento click dropdown.
-     */
-    onDropdownClick($event: any): void;
-    /**
-     * Ferma la propagazione dell'evento per evitare side effects sul contenitore (es. row click/select).
-     * @param $event Evento DOM.
-     */
-    fix($event: any): void;
-    /**
-     * Apre/chiude il popup menu in modalita semplificata con overlay appeso al body.
-     * Evita clipping dentro i contenitori FullCalendar.
-     * @param event Evento click del trigger.
-     */
-    onSimplifiedMenuClick(event: Event): void;
-    onSimplifiedMenuShow(): void;
-    onSimplifiedMenuHide(): void;
-    /**
-     * Abilita modalita inline-cell-editing via metadata tabella (con fallback legacy).
-     */
-    isInlineCellEditingEnabled(): boolean;
-    /**
-     * In inline-cell-editing, anche se la riga e marcata editing, mostra menu standard senza "edit".
-     */
-    showInlineEditingMenu(): boolean;
-    /**
-     * Modello menu effettivo da renderizzare nel pulsante azioni.
-     */
-    getActionMenuModel(): MenuItem[];
-    private toBooleanLoose;
-    addRecord(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DataActionButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DataActionButtonComponent, "wuic-data-action-button", never, { "data": { "alias": "data"; "required": false; }; "metaInfo": { "alias": "metaInfo"; "required": false; }; "datasource": { "alias": "datasource"; "required": false; }; "filter": { "alias": "filter"; "required": false; }; "simplified": { "alias": "simplified"; "required": false; }; "parentField": { "alias": "parentField"; "required": false; }; }, {}, never, never, true, never>;
-}
-
-declare class LazyDataActionButtonComponent implements OnInit {
-    private readonly cdr;
-    /**
-     * Input dal componente padre per data; usata nella configurazione e nel rendering del componente.
-     */
-    data: any;
-    /**
-     * 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<any>;
-    /**
-     * Input dal componente padre per filter; usata nella configurazione e nel rendering del componente.
-     */
-    filter?: () => void;
-    /**
-     * Input dal componente padre per simplified; usata nella configurazione e nel rendering del componente.
-     */
-    simplified: boolean;
-    parentField: string;
-    /**
-     * Proprieta di stato del componente per loaded component, usata dalla logica interna e dal template.
-     */
-    loadedComponent: any;
-    constructor(cdr: ChangeDetectorRef);
-    /**
-     * Inizializza il componente preparando stato, sottoscrizioni e primi caricamenti richiesti.
-     */
-    ngOnInit(): Promise<void>;
-    /**
-  * Gestisce la logica di `componentInputs` con regole guidate dai metadati server `_Metadati_*` (tabella/colonna).
-  * @returns Oggetto risultato costruito dal metodo per il passo successivo del flusso.
-  */
-    componentInputs(): {
-        data: any;
-        metaInfo: MetaInfo;
-        datasource: BehaviorSubject<any>;
-        filter: () => void;
-        simplified: boolean;
-        parentField: string;
-    };
-    static ɵfac: i0.ɵɵFactoryDeclaration<LazyDataActionButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LazyDataActionButtonComponent, "wuic-data-action-button-lazy", never, { "data": { "alias": "data"; "required": false; }; "metaInfo": { "alias": "metaInfo"; "required": false; }; "datasource": { "alias": "datasource"; "required": false; }; "filter": { "alias": "filter"; "required": false; }; "simplified": { "alias": "simplified"; "required": false; }; "parentField": { "alias": "parentField"; "required": false; }; }, {}, never, never, true, never>;
-}
-
-/**
- * Shape of the response returned by `/api/Meta/LicenseStatus` (GET).
- * The endpoint is defined in `Controllers/MetaController.cs` LicenseStatus action.
- */
-interface LicenseStatusResponse {
-    machineFingerprint?: string;
-    licenseValid?: boolean;
-    licenseReason?: string;
-    licenseExpiryUtc?: string | null;
-    licenseEmail?: string;
-    maintenanceExpiryUtc?: string | null;
-    tier?: string;
-    features?: string[];
-    /**
-     * DBMS utilizzato dal backend per il **DB DATI** (`AppSettings.dbms`):
-     * `'mssql'` o `'mysql'`. Aggiunto 2026-04-28 per il tooltip license del
-     * meta-menu — sysadmin vede a colpo d'occhio su quale provider gira il
-     * deploy.
+     * questo metodo, coprendo il caso normale.
      */
-    dataDbms?: string;
+    private waitForHealthSimple;
     /**
-     * DBMS utilizzato dal backend per il **DB METADATI** (`AppSettings.meta-dbms`).
-     * Tipicamente uguale a `dataDbms` ma puo' divergere quando
-     * `allowMultipleDBMS=true` (es. data MySQL + metadata MSSQL).
+     * Wrapper legacy mantenuto per back-compat: alias di
+     * `waitForHealthSimple`. Eventuali consumer storici che chiamavano
+     * `waitForHealth(ms)` continuano a vedere il polling semplice (non il
+     * 4-phase) — coerente con ambienti prod dove il supervisor gestisce
+     * il restart.
      */
-    metaDbms?: string;
+    private waitForHealth;
+    private forceLogout;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AppSettingsEditorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AppSettingsEditorComponent, "wuic-app-settings-editor", never, {}, {}, never, never, true, never>;
 }
-/**
- * Client-side view of the current license. Exposes synchronous `has(feature)`
- * predicate for use in templates, directives, guards, and components.
- *
- * Lifecycle:
- *   1) App bootstrap calls `refresh()` once.
- *   2) All `*wuicFeature` directives and `FeatureRouteGuard` read from the
- *      cached snapshot via `has()`.
- *   3) On license change (upgrade via new appsettings.json) restart the app
- *      OR call `refresh()` again to re-fetch.
- *
- * IMPORTANT: this service is a UX layer only. The real security is server-side
- * (see `SanitizeBoardContent` + `[RequireFeature]` + data-decoration in
- * `AsmxCrudRead`). A client can patch this service and unlock everything locally,
- * but the server will still refuse premium operations.
- */
-declare class LicenseFeatureService {
+
+declare class DataActionButtonComponent implements AfterViewInit, OnDestroy {
+    private trslSrv;
+    private cd;
+    private messageService;
+    private confirmationService;
+    private router;
     private http;
-    private static readonly ALWAYS_ALLOWED_ARCHETYPES;
-    private statusSubject;
-    private loadedOnce;
+    private metadataProvider;
+    private static readonly ACTION_KEY_EDIT;
+    data: any;
+    metaInfo: MetaInfo;
+    datasource: BehaviorSubject<DataSourceComponent>;
+    filter?: () => void;
+    simplified: boolean;
+    parentField: string;
+    btn: SplitButton;
+    simpleMenu?: Menu;
+    simplifiedMenuOpen: boolean;
+    items: MenuItem[];
+    selectedValue: any;
+    pkName: string;
+    inlineItems: any[];
+    nonInlineEditingItems: MenuItem[];
+    private translationsLoadedSub?;
+    constructor(trslSrv: TranslationManagerService, cd: ChangeDetectorRef, messageService: MessageService, confirmationService: ConfirmationService, router: Router, http: HttpClient, metadataProvider: MetadataProviderService);
     /**
-     * Promise risolta dopo il PRIMO `refresh()` (success or fail-closed).
-     * Usata dai route guard per attendere che lo snapshot iniziale sia
-     * disponibile prima di decidere access → evita race post-refresh pagina
-     * dove il guard partiva con `statusSubject.value === null` e denyava la
-     * feature anche con licenza valida.
+     * Hook di debug locale per ispezionare l'evento click sul pulsante azioni.
+     * @param $event Evento UI ricevuto dal template.
      */
-    private readyResolve;
-    private readyPromise;
-    constructor(http: HttpClient);
+    test($event: any): void;
     /**
-     * Ritorna una Promise che risolve quando il primo `refresh()` ha completato
-     * (con successo o con fail-closed fallback). Dopo il primo load, ritorna
-     * una Promise gia' risolta → overhead zero. Il guard la await per decidere
-     * solo con snapshot reale, non con `null` iniziale.
+     * Inizializza il menu azioni in base ai metadati tabella/colonna (`md_editable`, `md_deletable`, `md_inline_edit`, colonne `button`).
+     * Calcola anche la PK corrente per le azioni route-based.
      */
-    ready(): Promise<void>;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    private rebuildActionMenus;
+    private translateLabel;
     /**
-     * Observable of the current license status snapshot. Emits `null` until the
-     * first `refresh()` completes.
+     * Esegue il comando dell'item selezionato se non disabilitato.
+     * @param item Voce menu azione.
      */
-    status$(): Observable<LicenseStatusResponse | null>;
+    select(item: any): void;
     /**
-     * Synchronous accessor to the cached snapshot. Returns `null` if not yet loaded.
+     * Aggiunge al menu le azioni dinamiche derivate dalle colonne metadata di tipo `button`.
+     * @param target Collezione menu da arricchire.
      */
-    snapshot(): LicenseStatusResponse | null;
+    private appendMetadataButtonItems;
+    private getButtonActionRecord;
     /**
-     * Fetches `/api/Meta/LicenseStatus` and caches the result. Returns the promise
-     * so callers (like an APP_INITIALIZER) can await it.
+     * Valuta se un bottone metadata e attivo verificando callback azione e condizione visibilita (`mc_button_visibility_condition`).
+     * @param col Metadato colonna di tipo button.
+     * @returns `true` se il bottone e eseguibile.
      */
-    refresh(): Promise<LicenseStatusResponse | null>;
-    /** Idempotent: il primo refresh risolve `readyPromise`; i successivi no-op. */
-    private signalReady;
+    private isMetadataButtonEnabled;
     /**
-     * Returns true when the current license includes the given feature flag.
-     * Returns `false` when:
-     *   - license not yet loaded (conservative default);
-     *   - license is invalid;
-     *   - feature is not in the `features` array.
+     * Esegue l'azione custom del bottone metadata, con eventuale conferma (`mc_button_confirm_message`) e gestione errori centralizzata.
+     * @param col Metadato colonna button.
+     * @param record Record osservabile corrente.
+     * @param event Evento UI di invocazione.
      */
-    has(feature: string): boolean;
+    private executeMetadataButton;
     /**
-     * Returns true when the archetype (e.g. "spreadsheet", "pivot-grid", "list")
-     * is permitted by the current license. Archetypes in the always-allowed set
-     * (list, kanban, chart, ...) return true unconditionally.
+     * Avvia il flusso edit del record corrente:
+     * inline edit, popup `EditFormComponent` oppure navigazione route `/{route}/edit/{pk}`.
      */
-    isArchetypeAllowed(archetype: string): boolean;
+    edit(): void;
     /**
-     * Mirrors the server-side `LicenseFeatureMap.ArchetypeFeatureMap`. Kept
-     * hardcoded on both sides so a patched client gets UX unlock, but the
-     * server-side gate (boardcontent sanitizer + data-decoration) still enforces.
+     * Richiede conferma e, in caso positivo, elimina il record via `datasource.syncData(..., true)` ricaricando la griglia.
      */
-    private archetypeToFeature;
+    delete(): Promise<void>;
+    private canRestoreFromChangeMaster;
+    private appendRestoreFromChangeMasterActionAsync;
+    private isLogicalDeleteSupportedRoute;
+    private getRecordFieldIgnoreCase;
+    private restoreFromChangeMaster;
     /**
-     * Builds the LicenseStatus endpoint URL from `global_root_url`. The root is
-     * typically `"/api/Meta/AsmxProxy/"` (AsmxProxy pattern) or `"/api/Meta/"`
-     * (direct). LicenseStatus is a direct GET action on MetaController, so we
-     * strip any trailing `AsmxProxy/` segment before appending the action name.
+     * Apre il record in modalita sola lettura tramite `EditFormComponent` con `readOnly: true`.
      */
-    private resolveLicenseStatusUrl;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LicenseFeatureService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<LicenseFeatureService>;
-}
-
-interface AuthSessionState {
-    initialized: boolean;
-    loading: boolean;
-    enabled: boolean;
-    authenticated: boolean;
-    legacyAuthenticated: boolean;
-    provider?: string;
-    name?: string;
-    legacyName?: string;
-    legacyRole?: string;
-    claims?: {
-        type: string;
-        value: string;
-    }[];
-    error?: string;
-    returnUrl: string;
-    sessionExpiring?: boolean;
-    sessionExpiresInSeconds?: number;
-}
-declare class AuthSessionService {
-    private http;
-    private userInfoService;
-    private metadataProvider;
-    private translationManager;
-    private ngZone;
-    private initialized;
-    private sessionTimeoutMs;
-    private sessionWarningMs;
-    private sessionTimer;
-    private sessionWarningTimer;
-    private sessionCountdownTimer;
-    private readonly stateSubject;
-    readonly state$: rxjs.Observable<AuthSessionState>;
-    get snapshot(): AuthSessionState;
-    constructor(http: HttpClient, userInfoService: UserInfoService, metadataProvider: MetadataProviderService, translationManager: TranslationManagerService, ngZone: NgZone);
+    detail(): void;
     /**
-     * Allinea ngx-translate alla lingua dell'utente appena autenticato/hydratato.
-     * Necessario perche' il TranslationManagerService bootstrap risolve la lingua
-     * via `userInfoService.getuserInfo()` quando NESSUN utente e' ancora loggato,
-     * finendo di default su `navigator.language` o 'it-IT'. Senza questa call
-     * esplicita post-login, le traduzioni rese dal primo render (toolbar, menu,
-     * dialog) restano "appiccicate" alla lingua di bootstrap finche' l'utente
-     * non cambia lingua manualmente dal selettore, che invece chiama direttamente
-     * `useLanguage()`. Chiamata best-effort: fallisce silenzioso se la lingua non
-     * e' supportata o la tabella traduzioni non e' ancora pronta.
+     * Apre `EditFormComponent` in modalita cloning per creare una copia del record corrente.
      */
-    private applyUserLanguageToTranslations;
+    clone(): void;
     /**
-     * Inizializza il servizio una sola volta (o forzatamente) e carica lo stato sessione corrente via `refreshAll`.
-     * @param force Se `true` forza una nuova inizializzazione anche se gia avvenuta.
+     * Salva modifiche inline sincronizzando il record osservabile con backend e riallineando il modello riga in tabella.
      */
-    initialize(force?: boolean): Promise<void>;
+    save(): 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.
+     * Annulla l'inline edit locale della riga corrente.
      */
-    private hydrateFromServerCookie;
+    cancelEdit(): Promise<void>;
     /**
-     * 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.
+     * Hook evento click principale (attualmente usato come placeholder/debug).
+     * @param $event Evento click.
      */
-    refreshAll(): Promise<void>;
+    onClick($event: any): void;
     /**
-     * Aggiorna il `returnUrl` nello stato sessione applicando normalizzazione anti-open-redirect.
-     * @param returnUrl URL di ritorno post login/logout.
+     * Hook richiamato alla chiusura del menu split button.
+     * @param $event Evento PrimeNG.
      */
-    setReturnUrl(returnUrl: string): void;
+    onMenuHide($event: any): void;
     /**
-     * Avvia il login OAuth reindirizzando il browser a `Auth/Login` con `returnUrl` codificato.
-     * @param returnUrl URL di ritorno post login/logout.
+     * Hook richiamato all'apertura del menu split button.
+     * @param $event Evento PrimeNG.
      */
-    login(returnUrl?: string): void;
+    onMenuShow($event: any): void;
     /**
-     * Esegue logout OAuth: pulisce prima stato client (storage + DB locali) e custom settings, poi redirect a `Auth/Logout`.
-     * @param returnUrl URL di ritorno post login/logout.
+     * Hook click dropdown del pulsante azioni (punto estensione per custom behavior).
+     * @param $event Evento click dropdown.
      */
-    logout(returnUrl?: string): Promise<void>;
+    onDropdownClick($event: any): void;
     /**
-     * Esegue login legacy via `MetaService.login`, interpreta le varianti payload storiche (`isLogged`, `value`, JSON string)
-     * e in caso positivo salva l'utente nel cookie `k-user`.
-     * @param username Username credenziale di autenticazione.
-     * @param password Password credenziale di autenticazione.
+     * Ferma la propagazione dell'evento per evitare side effects sul contenitore (es. row click/select).
+     * @param $event Evento DOM.
      */
-    legacyLogin(username: string, password: string, captchaToken?: string): Promise<boolean>;
+    fix($event: any): void;
+    /**
+     * Apre/chiude il popup menu in modalita semplificata con overlay appeso al body.
+     * Evita clipping dentro i contenitori FullCalendar.
+     * @param event Evento click del trigger.
+     */
+    onSimplifiedMenuClick(event: Event): void;
+    onSimplifiedMenuShow(): void;
+    onSimplifiedMenuHide(): void;
     /**
-     * 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.
+     * Abilita modalita inline-cell-editing via metadata tabella (con fallback legacy).
      */
-    legacyLogout(): Promise<void>;
+    isInlineCellEditingEnabled(): boolean;
     /**
-     * Pulisce lo stato runtime e le cache associate.
-     * Gestisce anche persistenza locale su IndexedDB/Dexie quando prevista.
-     * @returns Valore restituito dal metodo (Promise<void>).
+     * In inline-cell-editing, anche se la riga e marcata editing, mostra menu standard senza "edit".
      */
-    private clearClientRuntimeState;
+    showInlineEditingMenu(): boolean;
     /**
-     * Pulisce lo stato runtime e le cache associate.
-     * Legge/scrive dati persistenti su storage browser.
+     * Modello menu effettivo da renderizzare nel pulsante azioni.
      */
-    private clearBrowserStorage;
+    getActionMenuModel(): MenuItem[];
+    private toBooleanLoose;
+    addRecord(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DataActionButtonComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DataActionButtonComponent, "wuic-data-action-button", never, { "data": { "alias": "data"; "required": false; }; "metaInfo": { "alias": "metaInfo"; "required": false; }; "datasource": { "alias": "datasource"; "required": false; }; "filter": { "alias": "filter"; "required": false; }; "simplified": { "alias": "simplified"; "required": false; }; "parentField": { "alias": "parentField"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare class LazyDataActionButtonComponent implements OnInit {
+    private readonly cdr;
     /**
-     * Rimuove i dati target aggiornando lo stato del servizio.
-     * Gestisce anche persistenza locale su IndexedDB/Dexie quando prevista.
-     * @param dbName Nome database locale/remote da trattare.
-     * @returns Valore restituito dal metodo (Promise<void>).
+     * Input dal componente padre per data; usata nella configurazione e nel rendering del componente.
      */
-    private deleteDexieDatabase;
+    data: any;
     /**
-     * Rimuove i dati target aggiornando lo stato del servizio.
-     * Gestisce anche persistenza locale su IndexedDB/Dexie quando prevista.
-     * @param dbName Nome database locale/remote da trattare.
-     * @returns Valore restituito dal metodo (Promise<void>).
+     * Input dal componente padre per meta info; usata nella configurazione e nel rendering del componente.
      */
-    private deleteIndexedDbByName;
+    metaInfo: MetaInfo;
     /**
-     * Carica e cache-a i custom settings dell'utente loggato in localStorage allineando il bootstrap sessione con MetadataProvider.
+     * Input dal componente padre per datasource; usata nella configurazione e nel rendering del componente.
      */
-    private bootstrapUserCustomSettings;
+    datasource: BehaviorSubject<any>;
     /**
-     * Configura il timeout di sessione in minuti. Chiamato dal meta-menu dopo aver letto AuthConfig.
+     * Input dal componente padre per filter; usata nella configurazione e nel rendering del componente.
      */
-    setSessionTimeout(minutes: number, warningMinutes?: number): void;
-    private activityListenersAttached;
-    /** Timestamp dell'ultimo reset throttled, in ms epoch. */
-    private lastActivityResetAt;
-    /** Min intervallo tra reset throttled (mousemove/scroll). 1s e' un buon compromesso
-     *  tra responsiveness al "vero" idle e overhead da event flood. */
-    private static readonly ACTIVITY_RESET_THROTTLE_MS;
-    private setupActivityListeners;
+    filter?: () => void;
     /**
-     * Avvia/riavvia i timer di sessione. Chiamato dopo login e ad ogni attività HTTP.
+     * Input dal componente padre per simplified; usata nella configurazione e nel rendering del componente.
      */
-    resetSessionTimer(): void;
-    private startSessionExpiryCountdown;
-    private handleSessionExpired;
-    private clearSessionTimers;
-    private isUserAuthenticated;
+    simplified: boolean;
+    parentField: string;
     /**
-     * Applica un aggiornamento parziale allo stato `AuthSessionState` preservando le proprieta non toccate.
-     * @param partial Delta stato da fondere con lo stato corrente.
+     * Proprieta di stato del componente per loaded component, usata dalla logica interna e dal template.
      */
+    loadedComponent: any;
+    constructor(cdr: ChangeDetectorRef);
     /**
-     * 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.
+     * Inizializza il componente preparando stato, sottoscrizioni e primi caricamenti richiesti.
      */
-    setError(message: string): void;
-    /** User-facing messages keyed by server reason code. */
-    private static readonly REASON_MESSAGES;
+    ngOnInit(): Promise<void>;
     /**
-     * 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.
+  * Gestisce la logica di `componentInputs` con regole guidate dai metadati server `_Metadati_*` (tabella/colonna).
+  * @returns Oggetto risultato costruito dal metodo per il passo successivo del flusso.
+  */
+    componentInputs(): {
+        data: any;
+        metaInfo: MetaInfo;
+        datasource: BehaviorSubject<any>;
+        filter: () => void;
+        simplified: boolean;
+        parentField: string;
+    };
+    static ɵfac: i0.ɵɵFactoryDeclaration<LazyDataActionButtonComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LazyDataActionButtonComponent, "wuic-data-action-button-lazy", never, { "data": { "alias": "data"; "required": false; }; "metaInfo": { "alias": "metaInfo"; "required": false; }; "datasource": { "alias": "datasource"; "required": false; }; "filter": { "alias": "filter"; "required": false; }; "simplified": { "alias": "simplified"; "required": false; }; "parentField": { "alias": "parentField"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Shape of the response returned by `/api/Meta/LicenseStatus` (GET).
+ * The endpoint is defined in `Controllers/MetaController.cs` LicenseStatus action.
+ */
+interface LicenseStatusResponse {
+    machineFingerprint?: string;
+    licenseValid?: boolean;
+    licenseReason?: string;
+    licenseExpiryUtc?: string | null;
+    licenseEmail?: string;
+    maintenanceExpiryUtc?: string | null;
+    tier?: string;
+    features?: string[];
+    /**
+     * DBMS utilizzato dal backend per il **DB DATI** (`AppSettings.dbms`):
+     * `'mssql'` o `'mysql'`. Aggiunto 2026-04-28 per il tooltip license del
+     * meta-menu — sysadmin vede a colpo d'occhio su quale provider gira il
+     * deploy.
      */
-    private applyRedirectReason;
-    private patchState;
+    dataDbms?: string;
     /**
-     * Costruisce una struttura derivata a partire dallo stato corrente.
-     * @param action Azione richiesta nel flusso corrente.
+     * DBMS utilizzato dal backend per il **DB METADATI** (`AppSettings.meta-dbms`).
+     * Tipicamente uguale a `dataDbms` ma puo' divergere quando
+     * `allowMultipleDBMS=true` (es. data MySQL + metadata MSSQL).
      */
-    private buildEndpoint;
+    metaDbms?: string;
+}
+/**
+ * Client-side view of the current license. Exposes synchronous `has(feature)`
+ * predicate for use in templates, directives, guards, and components.
+ *
+ * Lifecycle:
+ *   1) App bootstrap calls `refresh()` once.
+ *   2) All `*wuicFeature` directives and `FeatureRouteGuard` read from the
+ *      cached snapshot via `has()`.
+ *   3) On license change (upgrade via new appsettings.json) restart the app
+ *      OR call `refresh()` again to re-fetch.
+ *
+ * IMPORTANT: this service is a UX layer only. The real security is server-side
+ * (see `SanitizeBoardContent` + `[RequireFeature]` + data-decoration in
+ * `AsmxCrudRead`). A client can patch this service and unlock everything locally,
+ * but the server will still refuse premium operations.
+ */
+declare class LicenseFeatureService {
+    private http;
+    private static readonly ALWAYS_ALLOWED_ARCHETYPES;
+    private statusSubject;
+    private loadedOnce;
     /**
-     * Costruisce una struttura derivata a partire dallo stato corrente.
-     * @param fullMethodName Nome completo metodo legacy (es. `MetaService.login`).
+     * Promise risolta dopo il PRIMO `refresh()` (success or fail-closed).
+     * Usata dai route guard per attendere che lo snapshot iniziale sia
+     * disponibile prima di decidere access → evita race post-refresh pagina
+     * dove il guard partiva con `statusSubject.value === null` e denyava la
+     * feature anche con licenza valida.
      */
-    private buildMetaAsmxEndpoint;
+    private readyResolve;
+    private readyPromise;
+    constructor(http: HttpClient);
     /**
-     * Risolve la base URL API usata dal servizio: preferisce `appSettings.api_url`, fallback su `${window.location.origin}/api/`.
+     * Ritorna una Promise che risolve quando il primo `refresh()` ha completato
+     * (con successo o con fail-closed fallback). Dopo il primo load, ritorna
+     * una Promise gia' risolta → overhead zero. Il guard la await per decidere
+     * solo con snapshot reale, non con `null` iniziale.
      */
-    private getApiBaseUrl;
+    ready(): Promise<void>;
     /**
-     * Valuta una condizione booleana sullo stato o sull'input corrente.
-     * @returns Valore restituito dal metodo (boolean).
+     * Observable of the current license status snapshot. Emits `null` until the
+     * first `refresh()` completes.
      */
-    private isOAuthEnabledInSettings;
+    status$(): Observable<LicenseStatusResponse | null>;
     /**
-     * Normalizza il payload in una forma coerente per i passaggi successivi.
-     * @param returnUrl URL di ritorno post login/logout.
+     * Synchronous accessor to the cached snapshot. Returns `null` if not yet loaded.
      */
-    private normalizeReturnUrl;
+    snapshot(): LicenseStatusResponse | null;
     /**
-     * Ritorna l'URL browser corrente usato come `returnUrl` predefinito in login/logout.
+     * Fetches `/api/Meta/LicenseStatus` and caches the result. Returns the promise
+     * so callers (like an APP_INITIALIZER) can await it.
      */
-    private getCurrentLocalUrl;
+    refresh(): Promise<LicenseStatusResponse | null>;
+    /** Idempotent: il primo refresh risolve `readyPromise`; i successivi no-op. */
+    private signalReady;
     /**
-     * Esegue il parsing del valore in ingresso con fallback sicuro.
-     * @param raw Payload legacy da interpretare (stringa JSON, oggetto o wrapper con `value`).
-     * @returns Valore restituito dal metodo (any).
+     * Returns true when the current license includes the given feature flag.
+     * Returns `false` when:
+     *   - license not yet loaded (conservative default);
+     *   - license is invalid;
+     *   - feature is not in the `features` array.
+     *
+     * Wildcard `"*"` nel features array sblocca tutte le feature (usato dai
+     * tier top-level "enterprise" / host-bound bundled e dal server-side
+     * `LicenseFeatureMap.ExpandFeatures` per Pro tier). Senza questo branch
+     * la licenza con `features:["*"]` falliva ogni `has('dashboard-designer'/
+     * 'spreadsheet'/...)` e il client nascondeva tutte le voci di menu
+     * archetype-gated nonostante `licenseValid:true` e tier `professional`.
      */
-    private parseLegacyLoginResponse;
+    has(feature: string): boolean;
     /**
-     * Estrae un messaggio errore leggibile da payload legacy eterogenei (raw/parsing/error/value) del login storico.
-     * @param raw Payload grezzo risposta/errore.
-     * @param parsed Payload gia interpretato.
-     * @returns Messaggio errore normalizzato oppure `null`.
+     * Returns true when the archetype (e.g. "spreadsheet", "pivot-grid", "list")
+     * is permitted by the current license. Archetypes in the always-allowed set
+     * (list, kanban, chart, ...) return true unconditionally.
      */
-    private extractLegacyLoginError;
+    isArchetypeAllowed(archetype: string): boolean;
     /**
-     * Prova a leggere un messaggio errore da stringhe plain/JSON o da oggetti con chiavi comuni (`message`, `error`, `ExceptionMessage`).
-     * @param candidate Sorgente messaggio da analizzare.
-     * @returns Messaggio trovato oppure `null`.
+     * Mirrors the server-side `LicenseFeatureMap.ArchetypeFeatureMap`. Kept
+     * hardcoded on both sides so a patched client gets UX unlock, but the
+     * server-side gate (boardcontent sanitizer + data-decoration) still enforces.
      */
-    private readMessage;
+    private archetypeToFeature;
     /**
-     * Log diagnostico opzionale del flusso login legacy, attivo solo con `appSettings.debugLegacyLogin === true`.
-     * @param kind Tipo evento (`response` o `error`).
-     * @param payload Payload da tracciare in console.
+     * Builds the LicenseStatus endpoint URL from `global_root_url`. The root is
+     * typically `"/api/Meta/AsmxProxy/"` (AsmxProxy pattern) or `"/api/Meta/"`
+     * (direct). LicenseStatus is a direct GET action on MetaController, so we
+     * strip any trailing `AsmxProxy/` segment before appending the action name.
      */
-    private debugLegacyLogin;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AuthSessionService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AuthSessionService>;
+    private resolveLicenseStatusUrl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LicenseFeatureService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LicenseFeatureService>;
 }
 
 type WorkflowRuntimeMenuState = {
@@ -9973,6 +10584,13 @@ declare class MetaMenuComponent implements OnInit, AfterViewInit, OnDestroy {
      * tradotti, che e' un'esperienza confusa.
      */
     translationsLoaded$: Observable<boolean>;
+    /**
+     * Stato circuit breaker BE-offline esposto dal TranslationManagerService.
+     * Quando true → mostriamo il banner "Backend offline" + bottone "Riprova"
+     * al posto dello spinner "Loading…" altrimenti infinito. Il click sul
+     * bottone chiama `retryBackend()` che riarma il circuito e ritenta.
+     */
+    backendCircuitOpen$: Observable<boolean>;
     /**
      * Proprieta di stato del componente per auth return url, usata dalla logica interna e dal template.
      */
@@ -10054,6 +10672,14 @@ declare class MetaMenuComponent implements OnInit, AfterViewInit, OnDestroy {
      * @param workflowRuntimeMenu Stream dei menu runtime da fondere con il menu base.
      */
     constructor(metaSrv: MetadataProviderService, authSession: AuthSessionService, trslSrv: TranslationManagerService, userInfo: UserInfoService, workflowRuntimeMenu: WorkflowRuntimeMenuService, http: HttpClient, ngZone: NgZone, router: Router, licenseFeature: LicenseFeatureService, elementRef: ElementRef);
+    /**
+     * Handler del bottone "Riprova" del banner BE-offline. Resetta il circuit
+     * breaker nel TranslationManagerService e tenta immediatamente una nuova
+     * fetch di `MetaService.GetTranslation`. Se il BE e' di nuovo online il
+     * banner sparisce e parte lo spinner standard; se il BE e' ancora offline,
+     * dopo altri 5 fallimenti consecutivi il banner riappare.
+     */
+    retryBackend(): void;
     /**
      * Completa inizializzazione dopo il rendering della view e collega riferimenti UI.
      */
@@ -10293,17 +10919,6 @@ declare class MetaMenuComponent implements OnInit, AfterViewInit, OnDestroy {
      * altrimenti svuota il menu locale e interrompe il flusso.
      */
     private loadMenuIfAllowed;
-    /**
-     * Removes menu entries pointing to routes that require a license feature not
-     * included in the current license. Works recursively on nested items. The
-     * `route` shape of menu items comes from `mm_uri_menu` and matches the
-     * Angular route templates (e.g. `workflow-designer`, `<route>/spreadsheet`,
-     * `<route>/pivot-builder`, `<route>/dashboard`, `rag-chatbot`).
-     *
-     * UX layer only — server-side `SanitizeBoardContent` + `[RequireFeature]`
-     * are the authoritative gates.
-     */
-    private filterMenuByLicenseFeatures;
     /**
      * Ricompone `items` unendo menu base e runtime; quando `runtimeMenuExclusive` è attivo
      * mostra solo le voci runtime.
@@ -12439,6 +13054,14 @@ declare class NotificationBellComponent implements OnInit, OnDestroy {
     deleteNotificationTitle: string;
     private readonly sub;
     constructor(realtime: NotificationRealtimeService, router: Router, trslSrv: TranslationManagerService);
+    /**
+     * Risolve il valore di una translation key con fallback safe.
+     * ngx-translate's `instant()` ritorna la chiave letterale quando la
+     * traduzione non e' ancora caricata; senza il controllo `!== key` il
+     * fallback `|| default` non scatta (la stringa "notification_bell.title"
+     * e' truthy) e l'UI renderizza la chiave grezza.
+     */
+    private safeT;
     /** Risolve i label dalle traduzioni, rispettando eventuali @Input espliciti. */
     private resolveLabels;
     ngOnInit(): Promise<void>;
@@ -12767,6 +13390,8 @@ declare class KanbanListComponent implements OnInit, OnDestroy, IDataBoundHostCo
     private trslSrv;
     private dataProviderSrv;
     private userInfo;
+    private cdr;
+    private ngZone;
     hardcodedRoute: string;
     parentRecord: any;
     parentMetaInfo: MetaInfo;
@@ -12814,7 +13439,7 @@ declare class KanbanListComponent implements OnInit, OnDestroy, IDataBoundHostCo
     private datasourceReadySubscription?;
     private fetchInfoSubscription?;
     private pendingChanges;
-    constructor(router: Router, trslSrv: TranslationManagerService, dataProviderSrv: DataProviderService, userInfo: UserInfoService);
+    constructor(router: Router, trslSrv: TranslationManagerService, dataProviderSrv: DataProviderService, userInfo: UserInfoService, cdr: ChangeDetectorRef, ngZone: NgZone);
     private t;
     ngOnInit(): void;
     ngOnDestroy(): void;
@@ -14410,5 +15035,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, CustomException, DataActionButtonComponent, DataProviderOdataService, DataRepeaterComponent, DataSourceComponent, DateEditorComponent, DesignerRouteComponent, DictionaryEditorComponent, DynamicCompilerService, DynamicRowTemplateComponent, FieldEditorComponent, FilterBarComponent, FilterInfo, FormatGridViewValuePipe, GetSrcUploadPreviewPipe, GlobalHandler, HtmlEditorComponent, ImageWrapperComponent, ImportExportButtonComponent, IsSelectedRowPipe, KanbanListComponent, KanbanOptions, KanbanStatusColumnItem, LazyChartListComponent, LazyCodeEditorComponent, LazyDataActionButtonComponent, LazyDataSourceComponent, LazyFieldEditorComponent, LazyFirstRunWizardComponent, LazyImageWrapperComponent, LazyKanbanListComponent, LazyMetaMenuComponent, LazyPivotBuilderComponent, LazyReportDesignerComponent, LazyReportViewerComponent, LazySchedulerListComponent, LazySpreadsheetListSfComponent, LicenseFeatureService, ListGridComponent, LookupEditorComponent, MapListComponent, MetaInfo, MetaMenuComponent, MetadataEditorService, MetadataProviderService, MetadatiColonna, MetadatiTabella, NotificationBellComponent, NotificationRealtimeService, NumberEditorComponent, PRIMARY_PALETTES, PagerComponent, ParametricDialogComponent, PropertyArrayEditorComponent, PropertyObjectEditorComponent, THEME_OPTIONS, TextAreaEditorComponent, TextEditorComponent, TranslationManagerService, TreeListComponent, TreeViewSelectorComponent, UploadDialogComponent, UploadEditorComponent, UserInfoService, ValidationRule, ValueChangedPayload, VisibleFieldListPipe, WidgetDefinition, WorkflowDesignerRouteComponent, WorkflowRunnerComponent, WorkflowRuntimeMetadataService, WtoolboxService, WuicErrorDialogComponent, 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, DataSourceAfterSyncEvent, DataSourceBeforeSyncEvent, DataSourceSyncOperation, ErrorDelegate, ErrorDelegateContext, IDataBoundHostComponent, IFieldEditor, KanbanStatusColumn, LicenseStatusResponse, ListGridAfterRenderEvent, ListGridAfterRowRenderEvent, ListGridBeforeRowRenderEvent, MultiDatasourceMeta, NotificationItem, NotifyOptions, RagAskAcceptedResponse, RagAskRequest, RagChatHistorySnapshot, RagChatMessageDto, RagChatMessageStatus, RagChatRequest, RagChatResponse, RagChatSessionDto, RagChatTurn, RagChatbotTurn, RagHealthResponse, RagQueryRequest, RagQueryResponse, RagSource, RealtimeProgressEvent, ThemeOption, ThemePresetName, ThemePrimaryName, WorkflowRuntimeLinkedActionRouteMetadataEntry, WorkflowRuntimePreviousRouteNodeEntry, WorkflowRuntimeRouteMetadataEntry, WorkflowRuntimeRouteNodePayloadEntry };
+export { AUTH_REDIRECT_REASON_KEY, AppSettingsEditorComponent, AuthSessionService, BooleanEditorComponent, BoundedRepeaterComponent, ButtonEditorComponent, CallbackPipe, CallbackPipe2, CarouselListComponent, CodeAreaEditorComponent, ColorEditorComponent, CrashReporterService, 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, RagAskAcceptedResponse, RagAskRequest, RagChatHistorySnapshot, RagChatMessageDto, RagChatMessageStatus, RagChatRequest, RagChatResponse, RagChatSessionDto, RagChatTurn, RagChatbotTurn, RagHealthResponse, RagQueryRequest, RagQueryResponse, RagSource, RealtimeProgressEvent, ThemeOption, ThemePresetName, ThemePrimaryName, WorkflowRuntimeLinkedActionRouteMetadataEntry, WorkflowRuntimePreviousRouteNodeEntry, WorkflowRuntimeRouteMetadataEntry, WorkflowRuntimeRouteNodePayloadEntry };