wuic-framework-lib 1.0.11 → 1.0.20

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

@@ -18,7 +18,7 @@ import { GoogleMap, MapInfoWindow, MapPolygon } from '@angular/google-maps';
 import { MarkerClusterer } from '@googlemaps/markerclusterer';
 import { SplitButton } from 'primeng/splitbutton';
 import { Menubar } from 'primeng/menubar';
-import { AutoCompleteCompleteEvent } from 'primeng/autocomplete';
+import { AutoComplete, AutoCompleteCompleteEvent } from 'primeng/autocomplete';
 import { Select } from 'primeng/select';
 import { PrimeNG } from 'primeng/config';
 import { Popover } from 'primeng/popover';
@@ -94,11 +94,106 @@ declare class WuicClientException extends Error {
     });
 }
 
+/**
+ * Normalized context passed to error delegates registered via
+ * {@link GlobalHandler.registerDelegate}.
+ *
+ * Built from any raw error (HttpErrorResponse, Error, WuicClientException,
+ * or arbitrary thrown object) so component delegates can do lookups
+ * (e.g. `ctx.message.includes('METADATA_DB_EXISTS_CONFIRM_REQUIRED')`)
+ * without caring about the envelope shape.
+ */
+interface ErrorDelegateContext {
+    /** Raw error as received by the GlobalHandler. */
+    error: any;
+    /** `errorCode` from the typed-exception envelope (e.g. `errors.server.unhandled`). */
+    errorCode?: string;
+    /** `args` map from the typed-exception envelope. */
+    args?: Record<string, unknown>;
+    /** Server's `fallbackMessage` (raw, untranslated). */
+    fallbackMessage?: string;
+    /** Best-effort merged message — concatenates every plausible source
+     *  (body.message, body.rootMessage, args.message, fallbackMessage,
+     *  err.message) so substring matches work regardless of envelope shape. */
+    message: string;
+    /** HTTP status code, if the error is an HttpErrorResponse. */
+    status?: number;
+    /** Request URL, if the error is an HttpErrorResponse. */
+    url?: string;
+    /** True if the raw error looks like an HttpErrorResponse. */
+    isHttpError: boolean;
+    /** True if the raw error is a typed `WuicClientException`. */
+    isClientException: boolean;
+}
+/**
+ * Delegate function: returns true (sync or via Promise) to suppress the
+ * default error dialog. See {@link GlobalHandler.registerDelegate} for the
+ * full contract and async semantics.
+ */
+type ErrorDelegate = (ctx: ErrorDelegateContext) => boolean | void | Promise<boolean | void>;
+/**
+ * Options for {@link GlobalHandler.notify}: controls how the error is
+ * surfaced to the user (toast vs dialog) and what header/severity to use.
+ */
+interface NotifyOptions {
+    /** True → render as PrimeNG toast (via WtoolboxService.messageNotificationService).
+     *  False/undefined → full dialog flow (handleError path). Default: false. */
+    isToast?: boolean;
+    /** Toast header text. Default: 'Errore'. (Toast-only.) */
+    summary?: string;
+    /** Toast severity (PrimeNG). Default: 'error'. (Toast-only.) */
+    severity?: 'success' | 'info' | 'warn' | 'error';
+    /** Toast lifetime ms. Default: 6000. (Toast-only.) */
+    life?: number;
+    /** True → bypass registered delegates (rare; default false). */
+    skipDelegates?: boolean;
+}
 declare class GlobalHandler implements ErrorHandler {
     static messageNotification: BehaviorSubject<{
         show: boolean;
         exception: CustomException;
     }>;
+    /**
+     * Flag globale "backend in restart" — quando true, `handleError` non
+     * mostra dialog/toast di errore e non inoltra al CrashReporter. Acceso
+     * da `app-settings-editor.component.ts:saveAndApply` mentre l'overlay
+     * "Riavvio in corso" e' visibile (poll-fail → bump → poll-up). Spento
+     * appena il nuovo worker risponde.
+     *
+     * Razionale: durante il restart il worker e' down per ~5-30s. Tutte le
+     * chiamate HTTP correnti (notification polling, crashForward, lazy
+     * fetches) falliscono con `ERR_CONNECTION_REFUSED`. Ogni fallimento
+     * fa partire `handleError` → dialog "Errore HTTP 0" sotto il dialog
+     * "Riavvio in corso". Brutto e fuorviante per l'utente che sta
+     * legittimamente aspettando il restart. Soppresso fino a fine restart.
+     */
+    private static _restartInProgress;
+    static setRestartInProgress(value: boolean): void;
+    static isRestartInProgress(): boolean;
+    /**
+     * Auto-bootstrap del CrashReporterService al primo istanziamento del
+     * GlobalHandler (registrato dal consumer come `{ provide: ErrorHandler,
+     * useClass: GlobalHandler }` → eager-instantiated dal DI Angular al boot).
+     *
+     * Bug fix 2026-04-28: prima nessun consumer (WuicTest, WuicDemo, CrmApp)
+     * chiamava `CrashReporterService.init()` esplicitamente → l'`enabled`
+     * restava false → `(globalThis as any).__wuicCrashReporter` mai assegnato
+     * → `handleError` saltava silenziosamente il forward → tutti i crash JS
+     * (incluse le `TypeError` da librerie 3p come Stimulsoft viewer)
+     * non arrivavano mai a `MetaService.crashForward` → e di conseguenza
+     * mai al receiver `errors.wuic-framework.com`. Visibile anche dal
+     * Network panel browser: nessuna POST a `crashForward` dopo un errore.
+     *
+     * Centralizzare il bootstrap qui ha questi vantaggi:
+     *   1. Niente codice consumer-side richiesto — la lib si auto-attiva.
+     *   2. Garantisce che `__wuicCrashReporter` sia popolato PRIMA che
+     *      `handleError` lo legga (stesso ciclo di costruzione DI).
+     *   3. Guard `_bootstrapAttempted`: niente double-init se per qualche
+     *      ragione GlobalHandler venisse istanziato N volte (es.
+     *      `handleErrorStatic` ne crea uno transient per request).
+     */
+    private static _bootstrapAttempted;
+    constructor();
     /**
      * Static dispatcher — lets framework code that doesn't have access to
      * the Angular ErrorHandler instance (e.g. the HTTP interceptor)
@@ -112,6 +207,24 @@ declare class GlobalHandler implements ErrorHandler {
      * Angular zone (e.g. swallowed lifecycle errors).
      */
     static emitClientException(exc: WuicClientException): void;
+    /**
+     * Component-friendly entry point: take an error and surface it to the
+     * user as a TOAST (default) or DIALOG, choosing the right message
+     * automatically from the typed-exception envelope.
+     *
+     * Use case: components doing their own try/catch on HTTP calls (e.g.
+     * pivot-builder, view-builder) want to show a contextual error in a
+     * PrimeNG toast — they used to do
+     *   `messageService.add({ severity:'error', detail: err.message })`
+     * which prints the useless "Http failure response for X: 500 OK".
+     * With `notify(err, { isToast:true })` the toast shows the SERVER's
+     * `fallbackMessage` / `args.message` from the JsonExceptionFilter envelope.
+     *
+     * Also runs the registered delegates first, so a marker-intercepting
+     * delegate (e.g. wizard's METADATA_DB_EXISTS) can take over and
+     * suppress the toast/dialog if it handles the error itself.
+     */
+    static notify(error: any, opts?: NotifyOptions): void;
     /**
      * Optional bootstrap: install window/promise handlers that wrap any
      * native unhandled error into a typed WuicClientException. Call once
@@ -123,6 +236,25 @@ declare class GlobalHandler implements ErrorHandler {
     static installWindowHandlers(opts?: {
         exposeForTests?: boolean;
     }): void;
+    private static delegates;
+    private static nextDelegateId;
+    /**
+     * Register a delegate that intercepts errors before the default dialog.
+     * Higher priority delegates are called first; first one returning true
+     * suppresses the default dialog and stops further delegate calls.
+     * @returns disposer function — call it to unregister (e.g. ngOnDestroy).
+     */
+    static registerDelegate(fn: ErrorDelegate, opts?: {
+        priority?: number;
+    }): () => void;
+    /** Build a normalized context from a raw error (HttpErrorResponse, Error,
+     *  WuicClientException, or anything else with .error).  */
+    private static extractErrorContext;
+    /** Iterate delegates; first one returning true suppresses default flow.
+     *  Async delegates: their Promise is dispatched fire-and-forget; the
+     *  return value seen here is `Promise` (truthy), which we treat as
+     *  "delegate took over" → suppress default dialog. */
+    private static dispatchToDelegates;
     handleError(e: any): void;
     /**
      * @deprecated Pre-typed-envelope branches. Remove once server migration
@@ -1702,6 +1834,19 @@ declare class DataSourceComponent implements OnInit, OnDestroy {
   */
     private refreshPristineFromCurrent;
     /**
+     * Rebase: sposta la pristine baseline al record corrente e azzera il tracker
+     * dei pending changes. Usato dai custom edit-form component dopo aver
+     * applicato `mc_default_value_callback` async (es. progressivo da stored)
+     * sul record gia' BS-wrappato — senza questo refresh il record `__new=true`
+     * risulterebbe `hasPendingChanges()=true` al primo open del dialog Insert
+     * (i BS.next dei default callback vengono tracciati come edit utente).
+     *
+     * NB: usare SOLO se il record e' `__new=true` (modalita' Insert) e i valori
+     * applicati sono default-set, non user-edit. Su record gia' persistente
+     * questo metodo cancella i changes pendenti -> rischio data loss.
+     */
+    rebasePristineAfterDefaults(): void;
+    /**
   * Pubblica uno stato locale aggiornato su `fetchInfo$` per riallineare i consumer del datasource.
   */
     private publishLocalStateUpdate;
@@ -1833,18 +1978,103 @@ declare class MapOptions implements IDesignerProperties {
     useCurrentLocation: boolean;
     useClusterer: boolean;
     filterByBoundaries: boolean;
+    /**
+     * Pass-through al `google.maps.MapOptions.clickableIcons`. Quando `false`,
+     * Google Maps NON apre la propria info window built-in sui POI cliccati
+     * (negozi, fermate, indirizzi, ecc.) — utile quando l'app deve gestire
+     * solo i click dei marker custom (l'info window del POI di Google
+     * intercetta i click che dovrebbero arrivare al marker e copre l'info
+     * window del framework). Default `undefined` (= comportamento Google,
+     * `true`).
+     */
+    clickableIcons?: boolean;
     customMarkerImageSrc: string;
     customMarkerImageSrcField: string;
     markerContentCallback: string;
+    /**
+     * Campo del record che contiene il colore (CSS string `#rrggbb`) da usare
+     * sul `PinElement` del marker. Ignorato se il record ha
+     * `customMarkerImageSrcField` valorizzato (immagine/SVG ha precedenza).
+     */
+    markerColorField?: string;
     titleField: string;
     infoField: string;
     infoFunction: string;
     itemTemplateString: string;
+    /**
+     * Polyline overlay configurabile via `mdpropsbag.archetypes.map.polyline`.
+     * Quando `enabled=true`, il componente raggruppa i record per `groupByField`,
+     * li ordina per `orderByField` e disegna una `<map-polyline>` per ogni gruppo
+     * unendo i punti `{lat: record[latField], lng: record[lngField]}`.
+     * Caso d'uso: tracciamento percorsi GPS (mezzi, persone, asset) dove ogni
+     * record e' una posizione storicizzata.
+     */
+    polyline?: PolylineOverlayOptions;
     constructor();
     init(metaInfo: MetaInfo): void;
     archetypePropName: string;
     getDesignerProps(metaInfo: MetaInfo, action: BehaviorSubject<any>): MetaInfo;
 }
+/**
+ * Configurazione overlay polyline per archetype map. Permette di trasformare un
+ * elenco di record (es. posizioni GPS storicizzate) in una o piu' polyline,
+ * raggruppate per un campo (es. mezzo_id) e ordinate per un campo (es. timestamp).
+ *
+ * Le coordinate vengono lette dalla colonna `point` esistente sulla tabella/view
+ * (auto-detect: la stessa colonna che il map-list usa per i marker). Per usarla,
+ * la tabella DEVE avere una colonna con `mc_ui_column_type='point'` contenente
+ * JSON `{"lat":..,"lng":..}`.
+ *
+ * Quando `snapToRoads=true` il componente usa Google DirectionsService per
+ * snappare i waypoint alle strade reali (max 25 waypoint per chiamata; se ci
+ * sono piu' punti viene fatto batching automatico).
+ */
+interface PolylineOverlayOptions {
+    enabled: boolean;
+    /** Campo record per raggruppare (es. 'mezzo_id'). Se omesso → 1 sola polyline globale. */
+    groupByField?: string;
+    /** Campo record per ordinare i punti dentro ogni gruppo (es. 'timestamp_pos'). */
+    orderByField?: string;
+    /**
+     * Campo record alternativo per leggere le coordinate (auto-detect via
+     * colonna `point` se omesso). Utile se la tabella/view ha piu' colonne
+     * point e vuoi specificare quale usare per la polyline.
+     */
+    pointField?: string;
+    /**
+     * Campo record che contiene il colore della polyline (CSS string `#rrggbb`).
+     * Quando valorizzato, il colore viene letto dal primo record del gruppo
+     * (assume omogeneita' per gruppo) e sovrascrive `strokeColor` /
+     * `strokeColorByGroup`. Tipico use-case: colore configurato sul mezzo
+     * (FK lookup) e portato nella view sorgente.
+     */
+    colorField?: string;
+    /** Colore tratto polyline (default `#1d4ed8`). */
+    strokeColor?: string;
+    /** Se true, ogni gruppo riceve un colore distinto (palette interna). */
+    strokeColorByGroup?: boolean;
+    /** Spessore tratto in pixel (default 4). */
+    strokeWeight?: number;
+    /** Opacita 0..1 (default 0.85). */
+    strokeOpacity?: number;
+    /** Se true, snappa la polyline alle strade reali via Google DirectionsService. */
+    snapToRoads?: boolean;
+    /** Se false, nasconde i marker (mostra solo la polyline). Default true. */
+    showMarkers?: boolean;
+    /** Modalita di viaggio per snapToRoads (`DRIVING` default, `WALKING`, `BICYCLING`). */
+    travelMode?: 'DRIVING' | 'WALKING' | 'BICYCLING';
+    /**
+     * Se true, oltre alla polyline disegna un dot (`<map-circle>`) sulle
+     * coordinate originali di ciascun record. Utile per distinguere visivamente
+     * i punti GPS realmente storicizzati dal path interpolato/snapped.
+     * Default false.
+     */
+    showWaypointDots?: boolean;
+    /**
+     * Raggio in metri del dot (cerchio reale, scala con lo zoom). Default 8.
+     */
+    waypointDotRadius?: number;
+}
 declare class Point {
     lat: number;
     lng: number;
@@ -2246,7 +2476,7 @@ declare class MetadatiTabella {
          * Flag toolbar-level controllati da `md_props_bag.toolbar.*` (JSON).
          * Cambiabili per-route senza toccare lo schema SQL di
          * `_metadati__tabelle`. Esempio in `md_props_bag`:
-         *   { "toolbar": { "hideManageState": true } }
+         *   { "toolbar": { "hideManageState": true, "hideBatchActions": true } }
          *
          *  - `hideManageState`: nasconde il bottone "Gestione stato"
          *     (icona bookmark) + la select degli stati salvati nella
@@ -2254,9 +2484,18 @@ declare class MetadatiTabella {
          *     demo dove il saved-state feature (persistenza user_id +
          *     route via MetaService) non ha senso — es. Pattern 3 puro
          *     OData senza route metadata registrata.
+         *  - `hideBatchActions`: nasconde dalla caption-left i pulsanti
+         *     "Salva modifiche" / "Annulla modifiche" + l'indicatore
+         *     conteggio changes (badge pencil + count) generati quando
+         *     `md_inline_cell_editing` + `md_batch_save` sono attivi.
+         *     Utile per nested grid (es. righe documento dentro un
+         *     parametric-dialog) dove il save/cancel del padre persiste
+         *     master + righe in un colpo via batch save framework e i
+         *     duplicati toolbar sulla nested confondono l'UX.
          */
         toolbar?: {
             hideManageState?: boolean;
+            hideBatchActions?: boolean;
         };
         /**
          * Tuning server-side letto da `DataProviderMetaService.select`
@@ -3012,6 +3251,16 @@ declare class MetadataProviderService {
         value: string;
         type: string;
     }>>;
+    /**
+     * Elimina un report (file `.mrt`) e relativo cleanup metadata via `MetaService.removeReport`.
+     * Solo gli utenti admin possono effettivamente cancellare; il backend ritorna `false` per non-admin.
+     * Dopo successo invalida la cache report-list locale per la route, cosi' il prossimo
+     * `getReportList` ricarica dal backend.
+     * @param route Route applicativa che ospita il report.
+     * @param name  Nome file `.mrt` da rimuovere.
+     * @returns `true` se la cancellazione e' andata a buon fine.
+     */
+    removeReport(route: string, name: string): Promise<boolean>;
     static ɵfac: i0.ɵɵFactoryDeclaration<MetadataProviderService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MetadataProviderService>;
 }
@@ -3212,6 +3461,18 @@ declare class DataProviderMetaService {
      * additional columns alongside the text field).
      */
     static buildSlimComboRestriction(field: MetadatiColonna | null | undefined): string[];
+    /**
+     * Sanitize di un body HTTP rimuovendo qualunque BehaviorSubject (e
+     * BS-of-BS) che potrebbe essere finito dentro `filterInfo`,
+     * `currentRecord`, slot di un record BS-wrapped, ecc. Pre-serializza
+     * con replacer BS-aware e parse back: il risultato e' un body plain
+     * che Angular `HttpRequest.serializeBody` puo' stringificare senza
+     * "Converting circular structure to JSON" (SafeSubscriber →
+     * Subscription._finalizers → _parentage). Da usare in tutti i
+     * `http.post`/`http.put` che possono ricevere payload provenienti da
+     * datasource reattive.
+     */
+    static sanitizeBodyForHttp(body: any): any;
     /**
      * Carica i dati della route corrente chiamando `MetaService.getFlatRecordData` (`MetadataProviderService.readUri`).
      * Invia paginazione/ordinamenti/gruppi/filtri/aggregazioni e `has_server_operation`, poi mappa la risposta
@@ -4267,6 +4528,36 @@ declare class WtoolboxService {
         suggestColumnMD(record: {
             [key: string]: BehaviorSubject<any>;
         }, field: MetadatiColonna, type: string, routeRef?: string): Promise<void>;
+        /**
+         * Suggest del campo `mc_ui_lookup_computed_dataTextField` (Lookup
+         * Computed Data Text Field — formula display nella grid del parent):
+         * apre albero da `MetaService.getLookupListByIDLevelUP` (root = tabella
+         * proprietaria di mc_id, con i lookup edges per navigare alle target)
+         * e genera il select con `appendOnly=2` (JOIN alias `<colFK>_<target>`
+         * coerente con quello costruito da JoinBuilder a runtime nella query
+         * della grid). Vedi anche `suggestLookupComputedEdit` per il caso
+         * speculare nel field-editor.
+         * @param record Record metadata corrente (`mc_id` usato dal backend).
+         * @param field Campo formula da aggiornare.
+         */
+        suggestLookupComputed(record: {
+            [key: string]: BehaviorSubject<any>;
+        }, field: MetadatiColonna): Promise<void>;
+        /**
+         * Suggest del campo `mc_ui_lookup_combo_text_edit_computed_dataTextField`
+         * (Lookup Edit Text Computed Formula — testo del lookup nel field-editor):
+         * apre albero da `MetaService.getLookupListFromLookupTarget` con root
+         * spostata sulla TABELLA TARGET del lookup (es. mc_id=`prodotto_id` -> root
+         * `prodotti` con i suoi campi `codice`/`descrizione`/...). Genera il
+         * select con `appendOnly=3` -> qualifier `[<targetTable>].[<col>]`
+         * (es. `[prodotti].[codice]`), perche' la formula gira in un SELECT
+         * diretto sulla target nel field-editor, senza JOIN alias.
+         * @param record Record metadata corrente (`mc_id` usato dal backend).
+         * @param field Campo formula da aggiornare.
+         */
+        suggestLookupComputedEdit(record: {
+            [key: string]: BehaviorSubject<any>;
+        }, field: MetadatiColonna): Promise<void>;
         /**
          * Costruisce formula computed partendo da gerarchia lookup: apre albero da
          * `MetaService.getLookupListByIDLevelUP` e invia la selezione a `getClauseByLookupHierarchy`
@@ -5078,6 +5369,14 @@ declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDa
     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()`.
@@ -5127,6 +5426,15 @@ declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDa
     private outerTheadObserveRetryTimer?;
     records: any[];
     cols: any[];
+    /**
+     * Constant CSS value for `<col>`/`<th>` min-width binding. Pulled into a
+     * field (instead of `getColumnMinWidthCss()` method) so the template binding
+     * `[style.min-width]="columnMinWidthCss"` resolves to a property read
+     * (no function call) and Angular's change-detection short-circuits when
+     * the value didn't change. Saves ~3 function calls per column per CD cycle
+     * (template uses it on `<col>`, header `<th>`, and filter row `<th>`).
+     */
+    readonly columnMinWidthCss = "10px";
     metas: MetadatiColonna[];
     metaInfo: MetaInfo;
     routeName: string;
@@ -6141,6 +6449,11 @@ declare class ListGridComponent implements AfterViewInit, OnInit, OnDestroy, IDa
     /**
      * Restituisce il valore CSS per `min-width` sulle colonne della tabella.
      * @returns Valore CSS da applicare.
+     *
+     * NOTE: per i template binding usare direttamente il field
+     * `columnMinWidthCss`. Questa funzione resta solo per i call-site interni
+     * (TS) che la consumano via `getColumnMinWidthForCol` o
+     * `Number.parseFloat(getColumnMinWidthCss())`.
      */
     getColumnMinWidthCss(): string;
     /**
@@ -6480,8 +6793,25 @@ declare class ImportExportButtonComponent {
     private notificationRealtime;
     private trslSrv;
     private userInfo;
+    private cdr;
     routeName: string;
     tableMetadata: any;
+    /**
+     * Callback opzionale fornito dal componente host (list-grid, spreadsheet-list-sf, ...)
+     * per leggere il `filterInfo` corrente del datasource al momento del click su Export.
+     *
+     * Razionale: prima del fix, l'export leggeva il filtro SOLO dalla query string
+     * (`?filterInfo=...`), che NON viene aggiornata quando l'utente filtra in-grid via
+     * intestazioni di colonna o filter-bar — la URL resta `/cities/list` mentre lo stato
+     * filtri vive in `datasource.value.filterInfo`. Risultato: l'XLS scaricato conteneva
+     * SEMPRE l'intero dataset ignorando il filtro applicato.
+     *
+     * Il provider e' una funzione (non un binding `@Input() filterInfo: any`) per garantire
+     * che venga letto il valore CORRENTE al click, non quello catturato all'ultima CD.
+     * Fallback (provider non bindato): `parseFilterInfoFromQueryString()` per back-compat
+     * con eventuali host esterni che non passano il provider.
+     */
+    filterInfoProvider?: () => any;
     importFileInputRef?: ElementRef<HTMLInputElement>;
     private popupMenuItemsCache;
     private popupMenuItemsCacheKey;
@@ -6526,7 +6856,7 @@ declare class ImportExportButtonComponent {
     private exportMonitoringOnly;
     private lastHandledExportResumeGuid;
     private exportBackgroundNotifiedGuids;
-    constructor(route: ActivatedRoute, dataSrv: DataProviderService, dataMetaSrv: DataProviderMetaService, notificationRealtime: NotificationRealtimeService, trslSrv: TranslationManagerService, userInfo: UserInfoService);
+    constructor(route: ActivatedRoute, dataSrv: DataProviderService, dataMetaSrv: DataProviderMetaService, notificationRealtime: NotificationRealtimeService, trslSrv: TranslationManagerService, userInfo: UserInfoService, cdr: ChangeDetectorRef);
     private t;
     get canExportXls(): boolean;
     get canImportXls(): boolean;
@@ -6562,7 +6892,7 @@ declare class ImportExportButtonComponent {
     private applyImportProgressValue;
     private stopImportProgressPolling;
     static ɵfac: i0.ɵɵFactoryDeclaration<ImportExportButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ImportExportButtonComponent, "wuic-import-export-button", never, { "routeName": { "alias": "routeName"; "required": false; }; "tableMetadata": { "alias": "tableMetadata"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ImportExportButtonComponent, "wuic-import-export-button", never, { "routeName": { "alias": "routeName"; "required": false; }; "tableMetadata": { "alias": "tableMetadata"; "required": false; }; "filterInfoProvider": { "alias": "filterInfoProvider"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare class PagerComponent implements OnInit, OnChanges, OnDestroy {
@@ -6797,6 +7127,14 @@ declare class FilterBarComponent implements OnInit, OnChanges, OnDestroy {
      * a bloated, unreadable URL with duplicated filter serializations.
      */
     skipUrlSync: boolean;
+    /**
+     * Quando true, il filter-bar non lancia `datasource.value.fetchData()` (e
+     * quindi nessuna `MetaService.getFlatRecordData`) sugli apply* — emette solo
+     * gli output. Usato dal pivot-builder dove il `nestedSource` non rappresenta
+     * una grid visibile: la SQL preview viene rigenerata via
+     * `previewViewDefinition` come reazione agli output, niente fetch sul route.
+     */
+    skipFetch: boolean;
     filterApplied: EventEmitter<void>;
     onFilterApplied: EventEmitter<{
         mode: "basic" | "advanced" | "clear";
@@ -6939,7 +7277,7 @@ declare class FilterBarComponent implements OnInit, OnChanges, OnDestroy {
     private syncGridStateQueryString;
     private resetCursorPagingState;
     static ɵfac: i0.ɵɵFactoryDeclaration<FilterBarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FilterBarComponent, "wuic-filter-bar", never, { "datasource": { "alias": "datasource"; "required": false; }; "hardcodedDatasource": { "alias": "hardcodedDatasource"; "required": false; }; "multiDatasourceMetas": { "alias": "multiDatasourceMetas"; "required": false; }; "skipUrlSync": { "alias": "skipUrlSync"; "required": false; }; }, { "filterApplied": "filterApplied"; "onFilterApplied": "onFilterApplied"; "onSortingApplied": "onSortingApplied"; "onPageSizeApplied": "onPageSizeApplied"; "onGroupingChanged": "onGroupingChanged"; "onFilterBarCollapseChanged": "onFilterBarCollapseChanged"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FilterBarComponent, "wuic-filter-bar", never, { "datasource": { "alias": "datasource"; "required": false; }; "hardcodedDatasource": { "alias": "hardcodedDatasource"; "required": false; }; "multiDatasourceMetas": { "alias": "multiDatasourceMetas"; "required": false; }; "skipUrlSync": { "alias": "skipUrlSync"; "required": false; }; "skipFetch": { "alias": "skipFetch"; "required": false; }; }, { "filterApplied": "filterApplied"; "onFilterApplied": "onFilterApplied"; "onSortingApplied": "onSortingApplied"; "onPageSizeApplied": "onPageSizeApplied"; "onGroupingChanged": "onGroupingChanged"; "onFilterBarCollapseChanged": "onFilterBarCollapseChanged"; }, never, never, true, never>;
 }
 
 declare class LazySchedulerListComponent implements OnInit {
@@ -7088,7 +7426,7 @@ interface IDesigner<T extends IDesignerProperties> {
     archetypeOptions: T;
 }
 
-declare class MapListComponent implements OnInit, IBindable, IDesigner<MapOptions>, IDataBoundHostComponent {
+declare class MapListComponent implements OnInit, AfterViewInit, OnDestroy, IBindable, IDesigner<MapOptions>, IDataBoundHostComponent {
     private titleService;
     private cd;
     private route;
@@ -7122,10 +7460,6 @@ declare class MapListComponent implements OnInit, IBindable, IDesigner<MapOption
      * Proprieta di stato del componente per place lib, usata dalla logica interna e dal template.
      */
     PLACE_LIB: google.maps.PlacesLibrary;
-    /**
-     * Proprieta di stato del componente per drawing lib, usata dalla logica interna e dal template.
-     */
-    DRAWING_LIB: google.maps.DrawingLibrary;
     /**
      * Input dal componente padre per hardcoded route; usata nella configurazione e nel rendering del componente.
      */
@@ -7269,6 +7603,34 @@ declare class MapListComponent implements OnInit, IBindable, IDesigner<MapOption
      * Collezione dati per data, consumata dal rendering e dalle operazioni del componente.
      */
     data: any[];
+    /**
+     * Polyline overlay calcolate da `parseData` quando
+     * `archetypeOptions.polyline.enabled=true`. Una polyline per gruppo
+     * (`groupByField`), ordinate per `orderByField`. Renderizzate via
+     * `<map-polyline>` nel template.
+     */
+    polylines: {
+        path: {
+            lat: number;
+            lng: number;
+        }[];
+        options: any;
+        group: any;
+    }[];
+    /**
+     * Dot sui waypoint originali (coordinate reali dei record) renderizzati
+     * via `<map-circle>` quando `archetypeOptions.polyline.showWaypointDots=true`.
+     * Utile per distinguere i punti GPS storicizzati dal path interpolato/snapped.
+     */
+    polylineDots: {
+        center: {
+            lat: number;
+            lng: number;
+        };
+        options: any;
+        group: any;
+        record: any;
+    }[];
     /**
      * Configurazione di presentazione per item template string, usata nel rendering del componente.
      */
@@ -7436,6 +7798,21 @@ declare class MapListComponent implements OnInit, IBindable, IDesigner<MapOption
      * Rilascia risorse e sottoscrizioni per evitare leak e stati pendenti.
      */
     ngOnDestroy(): void;
+    /** Cleanup function per ogni listener gmp-click attivo. */
+    private markerGmpClickCleanups;
+    /** Subscription a `markerElements.changes`. */
+    private markerElementsChangesSub?;
+    ngAfterViewInit(): void;
+    /**
+     * Iterazione `markerElements` ↔ `data.filter(__marker)` in parallelo
+     * (stesso ordine di rendering). Per ogni AdvancedMarkerElement:
+     *  - removeEventListener su quello vecchio (cleanup);
+     *  - addEventListener('gmp-click', ...) sul nuovo, capturando record/marker
+     *    nello scope per chiamare `openInfo` esattamente come faceva
+     *    `(mapClick)="openInfo(markerElem, record.__marker)"`.
+     */
+    private wireMarkerGmpClick;
+    private detachAllMarkerGmpClick;
     /**
      * Si sottoscrive a `fetchInfo$` del datasource, aggiorna metadati/viewport e inizializza Google Maps al primo caricamento.
      * Nei caricamenti successivi ripopola marker/poligoni e aggiorna clusterer e resize pass.
@@ -7454,11 +7831,54 @@ declare class MapListComponent implements OnInit, IBindable, IDesigner<MapOption
 */
     parseData(data: any): any;
     /**
+     * Costruisce le polyline overlay dai record applicando
+     * `archetypeOptions.polyline`. Ogni gruppo (`groupByField`) → 1 polyline
+     * con path ordinato per `orderByField`. Estende `bounds` cosi' fitBounds
+     * include i punti del percorso.
+     *
+     * Se `snapToRoads=true`, dopo il render iniziale (path = punti raw) viene
+     * lanciato `snapPolylinesToRoads()` async che chiama Google DirectionsService
+     * e sostituisce ogni `path` con `overview_path` della rotta calcolata.
+     */
+    buildPolylines(data: any[], bounds: google.maps.LatLngBounds): {
+        path: {
+            lat: number;
+            lng: number;
+        }[];
+        options: any;
+        group: any;
+    }[];
+    /**
+     * Snap async delle polyline alle strade reali. Usa la nuova
+     * **Routes API** (`google.maps.routes.Route.computeRoutes`) che sostituisce
+     * `DirectionsService` deprecato dal 2026-02-25. Fallback automatico a
+     * `DirectionsService` legacy se la libreria `routes` non e' disponibile
+     * o la chiamata fallisce (key senza "Routes API" abilitata, ecc.).
+     *
+     * Migration guide: https://developers.google.com/maps/documentation/javascript/routes/routes-js-migration
+     *
+     * Limite waypoint per chiamata = 25 (origin + 23 intermediates + destination):
+     * polyline piu' lunghe vengono chunkate.
+     *
+     * Travel mode legacy → routes mapping: DRIVING→DRIVE, WALKING→WALK,
+     * BICYCLING→BICYCLE.
+     */
+    private snapPolylinesToRoads;
+    /**
 * Recupera i dati/valori richiesti da `getMarkerContent`.
 * @param record Dato/record su cui il metodo applica elaborazioni o aggiornamenti.
 * @returns Valore risolto da `getMarkerContent` in base ai criteri implementati.
 */
     getMarkerContent(record: any): any;
+    /**
+     * Costruisce un HTMLElement marker-content da una stringa che puo' essere:
+     *  - SVG inline (`<svg ...>...</svg>`) → wrappato in un `<div>` per renderlo
+     *    un AdvancedMarker content valido (deve essere un Element, non un
+     *    DocumentFragment). Dimensioni controllate dal viewBox dell'SVG.
+     *  - URL immagine (http/https/data:image/...) → `<img src>`.
+     *  - Stringa vuota / null → null (caller usa il fallback successivo).
+     */
+    private buildMarkerVisualFromValue;
     /**
      * Restituisce una Promise che wrappa `navigator.geolocation.getCurrentPosition`.
      * @returns Posizione geolocalizzata del browser oppure errore se non disponibile/negata.
@@ -7618,6 +8038,15 @@ declare class MapListComponent implements OnInit, IBindable, IDesigner<MapOption
      * Apre l'info window del marker selezionato valorizzando `infoContent` con il template record.
      */
     openInfo(markerElem: any, marker: any): void;
+    /**
+     * Apre l'info window su un waypoint (`<map-circle>`) della polyline overlay.
+     * Riusa lo stesso `itemTemplate` del marker principale: il record del
+     * waypoint contiene tutti i campi (incluso `timestamp_pos`, `velocita_kmh`,
+     * `note`, ecc.) che il template puo' leggere via `rowData.record?.<field>`.
+     * L'anchor non e' un marker — passiamo la posizione esplicita via
+     * `infoWindowOptions.position`.
+     */
+    openWaypointInfo(dot: any, $event?: any): void;
     /**
      * Apre la stessa info window usata dai marker quando l'utente clicca un poligono.
      * Se non e disponibile un anchor marker, usa la posizione click o il centro geometrico del poligono.
@@ -7745,7 +8174,7 @@ declare class MapListComponent implements OnInit, IBindable, IDesigner<MapOption
     static ɵcmp: i0.ɵɵComponentDeclaration<MapListComponent, "wuic-map-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; }; }, { "onMapClick": "onMapClick"; "onMarkerDragStart": "onMarkerDragStart"; "onMarkerDragEnd": "onMarkerDragEnd"; "onMarkerClick": "onMarkerClick"; "onPolygonClick": "onPolygonClick"; "onPolygonShapeChangedEvent": "onPolygonShapeChangedEvent"; "onMapDataBound": "onMapDataBound"; "onMapBoundsChanged": "onMapBoundsChanged"; "onMapCenterChanged": "onMapCenterChanged"; "onMapContextMenu": "onMapContextMenu"; "onMapDrag": "onMapDrag"; "onMapDragEnd": "onMapDragEnd"; "onMapDragStart": "onMapDragStart"; "onMapMouseMove": "onMapMouseMove"; "onMapMouseOut": "onMapMouseOut"; "onMapMouseOver": "onMapMouseOver"; "onMapResize": "onMapResize"; "onMapZoomChanged": "onMapZoomChanged"; }, never, never, true, never>;
 }
 
-declare class CarouselListComponent implements IBindable, IDesigner<CarouselOptions>, AfterViewInit, OnDestroy, IDataBoundHostComponent {
+declare class CarouselListComponent implements IBindable, IDesigner<CarouselOptions>, OnInit, AfterViewInit, OnDestroy, IDataBoundHostComponent {
     private titleService;
     private cd;
     private route;
@@ -8002,7 +8431,7 @@ declare class LazySpreadsheetListSfComponent implements OnInit {
     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>;
 }
 
-declare class TreeListComponent implements OnDestroy, IDataBoundHostComponent {
+declare class TreeListComponent implements OnInit, OnDestroy, IDataBoundHostComponent {
     private titleService;
     private dataSrv;
     private cd;
@@ -8146,8 +8575,12 @@ declare class TreeListComponent implements OnDestroy, IDataBoundHostComponent {
     constructor(titleService: Title, dataSrv: DataProviderService, cd: ChangeDetectorRef, trslSrv: TranslationManagerService);
     /**
      * Inizializza il componente preparando stato, sottoscrizioni e primi caricamenti richiesti.
+     *
+     * Fire-and-forget: Angular `OnInit.ngOnInit` deve ritornare void; deleghiamo
+     * la logica async a `initAsync()` per evitare Promise floating tipizzata void.
      */
-    ngOnInit(): Promise<void>;
+    ngOnInit(): void;
+    private initAsync;
     /**
   * Gestisce la logica di `subscribeToDS` con regole guidate dai metadati server `_Metadati_*` (tabella/colonna), gestendo esplicitamente il ciclo di vita delle subscription RxJS, preparando/aggiornando il dataset visualizzato.
   */
@@ -8209,7 +8642,7 @@ declare class TreeListComponent implements OnDestroy, IDataBoundHostComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<TreeListComponent, "wuic-tree-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; }; }, { "onTreeDataBound": "onTreeDataBound"; "onTreeNodeExpand": "onTreeNodeExpand"; "onTreeNodeExpanded": "onTreeNodeExpanded"; "onTreeNodeSelect": "onTreeNodeSelect"; "onTreeNodeUnselect": "onTreeNodeUnselect"; "onTreeNodeCollapse": "onTreeNodeCollapse"; }, never, never, true, never>;
 }
 
-declare class ParametricDialogComponent implements OnDestroy, IDataBoundHostComponent {
+declare class ParametricDialogComponent implements OnInit, AfterViewInit, OnDestroy, IDataBoundHostComponent {
     ref: DynamicDialogRef | null;
     config: DynamicDialogConfig | null;
     private route;
@@ -8709,6 +9142,18 @@ declare class AppSettingsEditorComponent implements OnInit {
     private pristine;
     current: Map<string, any>;
     readonly activeTabValue: i0.WritableSignal<number>;
+    /**
+     * Chiave localStorage per persistere il tab corrente. Salvato per `name`
+     * (stable identifier della sezione, non per index che puo' cambiare se
+     * vengono aggiunte/rimosse sezioni). Letto in `loadSchema` per ripristinare
+     * il tab dopo refresh / restart-driven reload.
+     */
+    private static readonly ACTIVE_TAB_LS_KEY;
+    /**
+     * Wire-up dal template: persiste il tab corrente su localStorage ad
+     * ogni cambio. Salva il `name` della sezione (stabile cross-reload).
+     */
+    onTabChange(newIndex: number): void;
     readonly pendingChanges: i0.Signal<SaveChange[]>;
     readonly hasPendingChanges: i0.Signal<boolean>;
     readonly pendingChangesCount: i0.Signal<number>;
@@ -8777,6 +9222,52 @@ declare class AppSettingsEditorComponent implements OnInit {
     onReload(): Promise<void>;
     private confirmDiscardChanges;
     private sleep;
+    /**
+     * Restart-completion poll con flow a 4 fasi (algoritmo concordato):
+     *
+     *   1) Phase A — poll Health finche' fallisce. Quando il save di un setting
+     *      con impact `restart` ritorna, il vecchio worker e' ancora vivo per
+     *      ~800ms-5s prima dello StopApplication. Se non aspettiamo che muoia
+     *      davvero, qualunque "200 OK" iniziale e' un FALSE POSITIVE — il vecchio
+     *      worker risponde, dismissa il dialog, l'utente naviga e si schianta.
+     *
+     *   2) Phase B — wait `postDownGraceMs` (default 10s) DOPO la prima failure.
+     *      Margine per dotnet-watch di completare lo shutdown e arrivare in
+     *      "Waiting for changes" idle state.
+     *
+     *   3) Phase C — chiama `/api/__dev__/bump-watch-trigger` (Angular dev-server
+     *      proxy bypass middleware in `proxy.conf.js`). Il middleware riscrive
+     *      `HotReloadTrigger.cs` con un nome metodo unico → rude edit → dotnet-watch
+     *      fa rebuild + restart del worker. In IIS/ANCM o dotnet run puro l'endpoint
+     *      non esiste, la chiamata fallisce silente, ANCM/NSSM ricicla per conto suo.
+     *
+     *   4) Phase D — poll Health finche' un nuovo response 200 arriva: nuovo worker up.
+     *
+     * @param maxWaitMs budget totale in ms (default 90s).
+     * @param postDownGraceMs grace post-down (default 10s).
+     * @returns true se il restart e' stato completato, false su timeout.
+     */
+    private waitForRestart;
+    /**
+     * [PROD path] Polling semplice usato sotto IIS/ANCM/NSSM dove il
+     * supervisor ricicla il worker autonomamente in pochi secondi.
+     * Comportamento identico alla versione legacy: polla finche' Health
+     * risponde 200, senza fasi di pre-attesa o trigger esterni.
+     *
+     * Nota: c'e' un piccolo rischio di falso positivo nel primo ping se il
+     * 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>;
@@ -8987,6 +9478,19 @@ interface LicenseStatusResponse {
     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.
+     */
+    dataDbms?: string;
+    /**
+     * 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).
+     */
+    metaDbms?: string;
 }
 /**
  * Client-side view of the current license. Exposes synchronous `has(feature)`
@@ -9235,6 +9739,11 @@ declare class AuthSessionService {
      */
     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.
@@ -9410,6 +9919,7 @@ declare class MetaMenuComponent implements OnInit, AfterViewInit, OnDestroy {
      */
     private runtimeMenuSub?;
     private authStateSub?;
+    private authConfigRefreshHandler;
     /**
      * Proprieta di stato del componente per menu updated sub, usata dalla logica interna e dal template.
      */
@@ -9639,7 +10149,18 @@ declare class MetaMenuComponent implements OnInit, AfterViewInit, OnDestroy {
      * sincronizza permessi/menu e applica l'eventuale redirect richiesto via query/hash.
      */
     loginLegacy(): Promise<void>;
-    private loadAuthConfig;
+    /**
+     * Re-carica la AuthConfig dal backend. Chiamato in `ngOnInit` al boot e
+     * (via global event `wuic:auth-config-refresh`) dopo il restart del
+     * backend per applicare immediatamente nuovi `sessionTimeoutMinutes`,
+     * `notifySessionExpirationBefore`, `enableUserLanguageSwitch` e altri
+     * setting hot-reload-relevant senza richiedere page reload.
+     *
+     * Esposto come `public` cosi' altri componenti (es. app-settings-editor
+     * post-save) possono triggerarlo direttamente quando hanno il riferimento
+     * al meta-menu, oppure dispatcciare l'evento globale.
+     */
+    loadAuthConfig(): Promise<void>;
     onDocumentClick(): void;
     toggleUserLanguageMenu(event?: Event): void;
     isCurrentUserLanguage(langId: string): boolean;
@@ -10120,7 +10641,7 @@ declare class NumberEditorComponent implements IFieldEditor, AfterViewInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<NumberEditorComponent, "wuic-number-editor", never, { "record": { "alias": "record"; "required": false; }; "field": { "alias": "field"; "required": false; }; "metaInfo": { "alias": "metaInfo"; "required": false; }; "isFilter": { "alias": "isFilter"; "required": false; }; "nestedIndex": { "alias": "nestedIndex"; "required": false; }; "triggerProp": { "alias": "triggerProp"; "required": false; }; "readOnly": { "alias": "readOnly"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-declare class LookupEditorComponent implements IFieldEditor, AfterViewInit, AfterViewChecked, OnInit, OnChanges {
+declare class LookupEditorComponent implements IFieldEditor, AfterViewInit, AfterViewChecked, OnChanges, OnDestroy {
     private trslSrv;
     private cd;
     private hostElementRef;
@@ -10167,6 +10688,14 @@ declare class LookupEditorComponent implements IFieldEditor, AfterViewInit, Afte
      * Riferimento a elementi o componenti figli usato dalla logica UI per nested source.
      */
     nestedSource: DataSourceComponent;
+    /**
+     * Riferimento al p-autoComplete PrimeNG, usato per re-triggerare l'apertura
+     * della dropdown dopo che il layout di focus-expand inline-cell-editing ha
+     * riposizionato l'input (cell -> 360px). Senza re-show, la prima onDropdownClick
+     * calcola la posizione overlay sulla larghezza vecchia e l'overlay puo' restare
+     * chiuso o ancorato male.
+     */
+    autoCompleteRef: AutoComplete;
     /**
      * Collezione dati per items, consumata dal rendering e dalle operazioni del componente.
      */
@@ -10194,11 +10723,8 @@ declare class LookupEditorComponent implements IFieldEditor, AfterViewInit, Afte
   * @param hostElementRef Parametro in ingresso utilizzato per determinare il flusso operativo del metodo.
   */
     constructor(trslSrv: TranslationManagerService, cd: ChangeDetectorRef, hostElementRef: ElementRef<HTMLElement>);
-    /**
-     * Inizializza il componente preparando stato, sottoscrizioni e primi caricamenti richiesti.
-     */
-    ngOnInit(): void;
     ngOnChanges(_changes: SimpleChanges): void;
+    ngOnDestroy(): void;
     /**
      * Legge `mc_props_bag.lookup.virtualize` e determina se abilitare il virtual scroll del p-autocomplete.
      * Supporta boolean/number/string oppure object con `enabled`.
@@ -10213,6 +10739,52 @@ declare class LookupEditorComponent implements IFieldEditor, AfterViewInit, Afte
      * Completa inizializzazione dopo il rendering della view e collega riferimenti UI.
      */
     ngAfterViewInit(): void;
+    /**
+     * Subscribe a `record[mc_nome_colonna]` BehaviorSubject: quando un FK viene
+     * settato programmaticamente (es. importazione documento sorgente, CAI
+     * setRecordValue, custom callback) e il valore NON e' presente in `items`
+     * — perche' la prima fetch e' avvenuta prima che il setRecordValue propagasse,
+     * o il valore e' fuori dalla pagina corrente del combo — avviare una
+     * second-stage fetch filtrata sul valore per recuperare il record correlato e
+     * popolare `__lookup_obj` (cosi' il dropdown mostra il display text).
+     *
+     * Skip cases:
+     *  - lookupByID multi-value (isFilter operatore=eqor, multiple_check)
+     *  - prima emit del BS (init flow gia' coperto sopra)
+     *  - valore null/undefined (utente ha clearato)
+     *  - valore gia' nei items
+     *  - hasActiveLookupQuery true (utente sta typing una query manuale)
+     */
+    private installProgrammaticValueAutoFetch;
+    /**
+     * Workaround per inline-cell-editing + focus-expand:
+     *
+     * Quando la lookup vive dentro una <wuic-list-grid> con `md_inline_cell_editing=1`,
+     * il primo click sul chevron (button.p-autocomplete-dropdown) genera questa sequenza:
+     *   1. mousedown sul chevron alla posizione X
+     *   2. PrimeNG sposta il focus sull'input
+     *   3. il selector CSS `:focus-within` sul TD espande l'input da cell-width a 360px
+     *   4. il chevron, che e' inline-flex accanto all'input, si sposta verso destra
+     *   5. mouseup avviene alla posizione X originale, che ora e' DENTRO l'input
+     *      espanso (non piu' sul chevron)
+     *   6. il browser NON emette `click` perche' mouseup-target != mousedown-target
+     *   7. di conseguenza ne il PrimeNG handler interno ne il nostro
+     *      `(onDropdownClick)` ricevono mai l'evento -> overlay mai aperto
+     *
+     * Soluzione: ascoltare `mousedown` sul chevron (che PARTE prima di qualunque
+     * reflow e si triggera regolarmente) e schedulare `show()` con un delay che
+     * lascia stabilizzare il focus-expand. Cosi' l'overlay si aggancia al chevron
+     * nella sua posizione finale, esattamente come ci si aspetta.
+     */
+    /**
+     * Handler delegato dal template (`<p-autoComplete (mousedown)="onLookupHostMousedown($event)">`).
+     * Si triggera al mousedown su qualunque punto dell'autoComplete, e in particolare
+     * cattura il mousedown sul chevron PRIMA del reflow del focus-expand.
+     *
+     * Solo dentro inline-cell-editing: in normale edit form il click funziona gia'
+     * nativamente (nessun focus-expand che muove il chevron) e qui ritorniamo NOOP.
+     */
+    onLookupHostMousedown(event: MouseEvent): void;
     ngAfterViewChecked(): void;
     private applyAriaLabelledByToInput;
     /**
@@ -10243,11 +10815,27 @@ declare class LookupEditorComponent implements IFieldEditor, AfterViewInit, Afte
     private restoreLookupInputFocusIfNeeded;
     onLookupOverlayShow(): void;
     onLookupOverlayHide(): void;
+    /**
+     * Re-triggera l'apertura della dropdown dopo un breve delay.
+     *
+     * Use case: quando la lookup vive dentro una <wuic-list-grid> con
+     * `md_inline_cell_editing=1`, il click sul chevron mette il focus sull'input
+     * e attiva la regola CSS `:focus-within` che espande l'input da cell-width a
+     * 360px (Excel-like). PrimeNG calcola la posizione dell'overlay e fa il
+     * primo `show()` PRIMA che il reflow CSS sia stato applicato, quindi
+     * l'overlay puo' risultare chiuso, mal posizionato o riagganciato a
+     * un'ancora di larghezza vecchia.
+     *
+     * Il delay di 120ms lascia che il reflow del focus-expand si stabilizzi,
+     * poi forziamo un secondo `show()` che ricalcola posizione/larghezza
+     * coerenti con l'input gia' espanso.
+     */
+    onDropdownClickHandler(_event: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<LookupEditorComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LookupEditorComponent, "wuic-lookup-editor", never, { "record": { "alias": "record"; "required": false; }; "field": { "alias": "field"; "required": false; }; "metaInfo": { "alias": "metaInfo"; "required": false; }; "isFilter": { "alias": "isFilter"; "required": false; }; "nestedIndex": { "alias": "nestedIndex"; "required": false; }; "triggerProp": { "alias": "triggerProp"; "required": false; }; "readOnly": { "alias": "readOnly"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-declare class DictionaryEditorComponent implements OnInit, OnChanges, AfterViewChecked, OnDestroy {
+declare class DictionaryEditorComponent implements OnInit, OnChanges, AfterViewChecked, AfterViewInit, OnDestroy {
     private trnSrv;
     private hostElementRef;
     /**
@@ -10688,10 +11276,6 @@ declare class ButtonEditorComponent {
  */
     constructor(confirmationService: ConfirmationService, trn: TranslateService, wtoolbox: WtoolboxService);
     /**
-     * Completa inizializzazione dopo il rendering della view e collega riferimenti UI.
-     */
-    ngAfterViewInit(): void;
-    /**
 * Valuta una condizione tramite `isButtonVisible` con il flusso specifico definito dalla sua implementazione.
 * @returns Esito booleano calcolato dal metodo.
 */
@@ -10841,6 +11425,23 @@ declare class FieldEditorComponent implements OnInit, OnChanges, OnDestroy, DoCh
   * @returns Valore calcolato dinamicamente a partire dallo stato corrente del componente.
   */
     get classes(): string | null;
+    /**
+     * True quando il field-editor e' renderizzato dentro una cella di una
+     * list-grid in `md_inline_cell_editing` mode. In quel contesto la
+     * larghezza della cella e' governata dalla colonna del p-table (e da
+     * `mc_ui_grid_size_width`), non dalla form-default `mc_ui_size_width`
+     * — applicare 300px sull'editor o sul span readonly inflerebbe le
+     * colonne. Il caller (list-grid row template) NON passa un input
+     * dedicato: identifichiamo l'inline mode dal flag tableMetadata.
+     */
+    get isInlineCellHost(): boolean;
+    /**
+     * Width da applicare all'editor / span readonly. In inline cell host
+     * usa `100%` (la cella ha gia' la sua larghezza dalla colonna). Fuori
+     * inline-grid (form/dialog) usa la logica storica:
+     * `mc_ui_size_width || widgetMap[type].width || undefined`.
+     */
+    get widgetWidth(): string | undefined;
     private syncDomAttrs;
     /**
   * function Object() { [native code] }
@@ -10861,6 +11462,16 @@ declare class FieldEditorComponent implements OnInit, OnChanges, OnDestroy, DoCh
   */
     ngOnChanges(_changes: SimpleChanges): void;
     ngOnDestroy(): void;
+    /**
+     * Valore formattato per il readonly span (template: `{{readonlySpanValue}}`).
+     * Aggiornato reattivamente in setupReadonlySpanBinding subscribendo alla
+     * BehaviorSubject del campo: quando un setRecordValue programmatico (es.
+     * default async di sp_next_progressivo) chiama BS.next, lo span si
+     * aggiorna senza dover rendere `formatGridViewValue` impure.
+     */
+    readonlySpanValue: unknown;
+    private readonlySpanSub?;
+    private setupReadonlySpanBinding;
     /**
      * Rileva mutazioni in-place del tipo widget (es. da text a dictionary nel designer)
      * e riallinea il componente editor visualizzato.
@@ -13645,8 +14256,18 @@ declare class WuicErrorDialogComponent implements OnInit, OnDestroy {
     private cdr;
     visible: boolean;
     currentException: CustomException | null;
+    /**
+     * Set di firme errori che l'utente ha gia' chiuso esplicitamente in
+     * questa sessione (dismissedSignatures). Il dialog NON si riapre per
+     * eventi successivi con stessa firma -> evita il loop "fetch fallisce
+     * -> dialog si riapre" che impedisce all'utente di intervenire sulla
+     * pagina sotto (es. aprire metadata-editor per riparare la causa).
+     * Firma = `<traceId>` se presente, altrimenti `<title>::<body>`.
+     */
+    private dismissedSignatures;
     private sub?;
     constructor(cdr: ChangeDetectorRef);
+    private signatureOf;
     ngOnInit(): void;
     ngOnDestroy(): void;
     formatParameters(params: Record<string, unknown> | undefined | null): string;
@@ -13790,4 +14411,4 @@ 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, IDataBoundHostComponent, IFieldEditor, KanbanStatusColumn, LicenseStatusResponse, ListGridAfterRenderEvent, ListGridAfterRowRenderEvent, ListGridBeforeRowRenderEvent, MultiDatasourceMeta, NotificationItem, RagAskAcceptedResponse, RagAskRequest, RagChatHistorySnapshot, RagChatMessageDto, RagChatMessageStatus, RagChatRequest, RagChatResponse, RagChatSessionDto, RagChatTurn, RagChatbotTurn, RagHealthResponse, RagQueryRequest, RagQueryResponse, RagSource, RealtimeProgressEvent, ThemeOption, ThemePresetName, ThemePrimaryName, WorkflowRuntimeLinkedActionRouteMetadataEntry, WorkflowRuntimePreviousRouteNodeEntry, WorkflowRuntimeRouteMetadataEntry, WorkflowRuntimeRouteNodePayloadEntry };
+export 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 };