@topconsultnpm/sdkui-react 6.21.0-dev2.9 → 6.21.0-t2

package/lib/components/features/documents/copyAndMergeDcmtsShared.d.ts

@@ -0,0 +1,71 @@
+import React from 'react';
+import { DcmtInfo } from '../../../ts';
+import { DocumentDownloadSettings, FileNamingMode } from '../../../helper';
+import { IRelatedDcmt } from './TMMasterDetailDcmts';
+/** Numero minimo di file PDF necessari per poterli unire in un unico documento. */
+export declare const MIN_PDF_FOR_MERGE = 2;
+/** Stile per le etichette "floating" posizionate sopra i bordi dei container */
+export declare const getFloatingLabelStyle: () => React.CSSProperties;
+/** Chiave univoca per un IRelatedDcmt basata sulla coppia tid+did */
+export declare const getDcmtKey: (item: IRelatedDcmt) => string;
+/** Deduplica gli IRelatedDcmt in base alla coppia tid+did (mantiene la prima occorrenza) */
+export declare const dedupeByTidDid: (items: ReadonlyArray<IRelatedDcmt>) => Array<IRelatedDcmt>;
+/** Verifica se showDirectoryPicker è supportato (Chrome, Edge) */
+export declare const isDirectoryPickerSupported: () => boolean;
+/**
+ * Verifica se un'estensione (con o senza punto iniziale, case-insensitive) è "pdf"
+ * o un PDF firmato (pdf.p7m, pdf.tsd, pdf.m7m).
+ * Questi formati firmati vengono trattati come PDF nativi perché con OriginalUnsigned
+ * il file viene restituito senza firma.
+ */
+export declare const isPdfExt: (ext: string | null | undefined) => boolean;
+/**
+ * Estrae l'estensione completa da un nome file, gestendo estensioni composite
+ * a più livelli come .PDF.P7M, .XML.P7M.TS, etc.
+ *
+ * Esempi:
+ * - "documento.pdf" -> ".pdf"
+ * - "DCMT_123.PDF.P7M" -> ".PDF.P7M"
+ * - "fattura.xml.p7m" -> ".xml.p7m"
+ * - "example.XML.P7M.TS" -> ".XML.P7M.TS"
+ * - "file.tar.gz" -> ".gz" (tar.gz non è gestito come firma)
+ * - "file" -> ""
+ */
+export declare const getFullFileExtension: (fileName: string, depth?: number) => string;
+/**
+ * Estrae il nome base del file (senza estensione completa).
+ * Gestisce estensioni composite come .PDF.P7M
+ */
+export declare const getFileBaseName: (fileName: string) => string;
+/** Sanitizza il nome file per Windows (rimuove caratteri illegali e limita la lunghezza) */
+export declare const sanitizeFileName: (fileName: string, fallbackName: string, maxLength?: number) => string;
+/** Verifica se un file esiste nella cartella (FileSystemDirectoryHandle) */
+export declare const fileExists: (dirHandle: FileSystemDirectoryHandle, fileName: string) => Promise<boolean>;
+/** Genera un nome file univoco aggiungendo un suffisso numerico se già esistente */
+export declare const generateUniqueFileName: (dirHandle: FileSystemDirectoryHandle, originalName: string) => Promise<string>;
+/** Recupera il nome leggibile del tipo documento (cache) */
+export declare const getTypeName: (tid: number | undefined) => Promise<string>;
+/** Formatta un valore convertendo le date in formato dd-MM-yyyy [HH-mm-ss] */
+export declare const formatMetadataValue: (value: string) => string;
+/** Recupera i metadati filtrati (primi 5 con mid > 100 e valore presente), concatenati con separatorChar */
+export declare const getFilteredMetadata: (tid: number, did: number, separatorChar: string) => Promise<string | null>;
+/** Opzioni di naming necessarie per generare il nome del file di destinazione */
+export interface IFileNamingOptions {
+    fileNamingMode: FileNamingMode;
+    separatorChar: string;
+}
+/** Genera il nome file di destinazione in base alle impostazioni di naming */
+export declare const generateTargetFileName: (file: File, dcmtInfo: DcmtInfo, options: IFileNamingOptions) => Promise<string>;
+/**
+ * Restituisce i documenti da scaricare:
+ * - se è visibile il TMRelationViewer, usa gli isDcmt selezionati al suo interno
+ * - altrimenti restituisce i selectedDcmtInfos passati come prop
+ */
+export declare const getDcmtInfosToDownload: (selectedDcmtInfos: Array<DcmtInfo>, selectedItemsRelationViewer: Array<IRelatedDcmt>, showTMRelationViewer: boolean) => Array<DcmtInfo>;
+/**
+ * Costruisce lo stato iniziale di DocumentDownloadSettings combinando:
+ * - i valori salvati in userSettings (se presenti)
+ * - i default della classe
+ * Nota: destinationFolder e zipPassword vengono sempre resettati per sicurezza.
+ */
+export declare const buildInitialDownloadSettings: (saved: DocumentDownloadSettings | undefined, defaultInvoiceFormat: DocumentDownloadSettings["invoiceFormat"], defaultOrderFormat: DocumentDownloadSettings["orderFormat"]) => DocumentDownloadSettings;

package/lib/components/features/documents/copyAndMergeDcmtsShared.js

@@ -0,0 +1,304 @@
+import { DcmtTypeListCacheService, LayoutModes, SDK_Globals } from '@topconsultnpm/sdk-ts';
+import { searchResultToMetadataValues, DocumentDownloadSettings } from '../../../helper';
+import { TMColors } from '../../../utils/theme';
+/** Numero minimo di file PDF necessari per poterli unire in un unico documento. */
+export const MIN_PDF_FOR_MERGE = 2;
+// ============================================================
+// Stili comuni
+// ============================================================
+/** Stile per le etichette "floating" posizionate sopra i bordi dei container */
+export const getFloatingLabelStyle = () => ({
+    position: 'absolute',
+    top: '-10px',
+    left: '12px',
+    maxWidth: 'calc(100% - 24px)',
+    fontSize: '0.85rem',
+    fontWeight: 600,
+    color: TMColors.primary,
+    padding: '0 8px',
+    backgroundColor: 'white',
+    zIndex: 1,
+    whiteSpace: 'nowrap',
+    overflow: 'hidden',
+    textOverflow: 'ellipsis',
+    display: 'inline-block',
+    width: 'fit-content',
+    lineHeight: '20px',
+    letterSpacing: '0.2px',
+    boxSizing: 'border-box'
+});
+// ============================================================
+// Helper su IRelatedDcmt
+// ============================================================
+/** Chiave univoca per un IRelatedDcmt basata sulla coppia tid+did */
+export const getDcmtKey = (item) => `${item.tid ?? ''}_${item.did ?? ''}`;
+/** Deduplica gli IRelatedDcmt in base alla coppia tid+did (mantiene la prima occorrenza) */
+export const dedupeByTidDid = (items) => {
+    const map = new Map();
+    for (const item of items) {
+        const key = getDcmtKey(item);
+        if (!map.has(key))
+            map.set(key, item);
+    }
+    return Array.from(map.values());
+};
+// ============================================================
+// Feature detection / Estensioni file
+// ============================================================
+/** Verifica se showDirectoryPicker è supportato (Chrome, Edge) */
+export const isDirectoryPickerSupported = () => {
+    return 'showDirectoryPicker' in window;
+};
+/**
+ * Verifica se un'estensione (con o senza punto iniziale, case-insensitive) è "pdf"
+ * o un PDF firmato (pdf.p7m, pdf.tsd, pdf.m7m).
+ * Questi formati firmati vengono trattati come PDF nativi perché con OriginalUnsigned
+ * il file viene restituito senza firma.
+ */
+export const isPdfExt = (ext) => {
+    if (!ext)
+        return false;
+    const normalized = ext.trim().toLowerCase().replace(/^\./, '');
+    return normalized === 'pdf' || normalized === 'pdf.p7m' || normalized === 'pdf.tsd' || normalized === 'pdf.m7m';
+};
+/**
+ * Estensioni di firma/marca temporale note che possono avvolgere altre estensioni.
+ * Es: file.pdf.p7m, file.xml.p7m, file.docx.p7m, file.xml.p7m.ts
+ */
+const SIGNATURE_EXTENSIONS = new Set(['p7m', 'p7s', 'm7m', 'tsd', 'tsr', 'ts']);
+/** Profondità massima di ricorsione per la ricerca di estensioni composite */
+const MAX_EXTENSION_DEPTH = 5;
+/**
+ * Estrae l'estensione completa da un nome file, gestendo estensioni composite
+ * a più livelli come .PDF.P7M, .XML.P7M.TS, etc.
+ *
+ * Esempi:
+ * - "documento.pdf" -> ".pdf"
+ * - "DCMT_123.PDF.P7M" -> ".PDF.P7M"
+ * - "fattura.xml.p7m" -> ".xml.p7m"
+ * - "example.XML.P7M.TS" -> ".XML.P7M.TS"
+ * - "file.tar.gz" -> ".gz" (tar.gz non è gestito come firma)
+ * - "file" -> ""
+ */
+export const getFullFileExtension = (fileName, depth = 0) => {
+    if (!fileName || depth > MAX_EXTENSION_DEPTH)
+        return '';
+    const lastDotIndex = fileName.lastIndexOf('.');
+    if (lastDotIndex <= 0)
+        return '';
+    const lastExtension = fileName.substring(lastDotIndex + 1).toLowerCase();
+    // Se l'ultima estensione è una firma/marca, cerca ricorsivamente le estensioni precedenti
+    if (SIGNATURE_EXTENSIONS.has(lastExtension)) {
+        const nameWithoutLastExt = fileName.substring(0, lastDotIndex);
+        const innerExtension = getFullFileExtension(nameWithoutLastExt, depth + 1);
+        if (innerExtension) {
+            // Concatena l'estensione interna con quella corrente
+            return innerExtension + fileName.substring(lastDotIndex);
+        }
+    }
+    // Estensione singola (o estensione base dopo le firme)
+    return fileName.substring(lastDotIndex);
+};
+/**
+ * Estrae il nome base del file (senza estensione completa).
+ * Gestisce estensioni composite come .PDF.P7M
+ */
+export const getFileBaseName = (fileName) => {
+    if (!fileName)
+        return '';
+    const fullExtension = getFullFileExtension(fileName);
+    if (!fullExtension)
+        return fileName;
+    return fileName.substring(0, fileName.length - fullExtension.length);
+};
+// ============================================================
+// Sanitizzazione e gestione nomi file
+// ============================================================
+/** Sanitizza il nome file per Windows (rimuove caratteri illegali e limita la lunghezza) */
+export const sanitizeFileName = (fileName, fallbackName, maxLength = 255) => {
+    try {
+        const illegalCharsRegex = /[<>:"/\\|?*]/g;
+        const controlCharsRegex = /[\x00-\x1F\x7F]/g;
+        let sanitized = fileName
+            .replace(illegalCharsRegex, '_')
+            .replace(controlCharsRegex, '')
+            .trim();
+        sanitized = sanitized.replace(/[. ]+$/, '');
+        if (sanitized.length > maxLength) {
+            const extension = getFullFileExtension(sanitized);
+            if (extension) {
+                const baseName = getFileBaseName(sanitized);
+                const maxBaseLength = maxLength - extension.length;
+                sanitized = baseName.substring(0, maxBaseLength) + extension;
+            }
+            else {
+                sanitized = sanitized.substring(0, maxLength);
+            }
+        }
+        return sanitized || fallbackName;
+    }
+    catch {
+        return fallbackName;
+    }
+};
+/** Verifica se un file esiste nella cartella (FileSystemDirectoryHandle) */
+export const fileExists = async (dirHandle, fileName) => {
+    try {
+        await dirHandle.getFileHandle(fileName, { create: false });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/** Genera un nome file univoco aggiungendo un suffisso numerico se già esistente */
+export const generateUniqueFileName = async (dirHandle, originalName) => {
+    try {
+        const baseName = getFileBaseName(originalName);
+        const extension = getFullFileExtension(originalName);
+        const MAX_ATTEMPTS = 1000;
+        for (let counter = 1; counter <= MAX_ATTEMPTS; counter++) {
+            const candidateName = counter === 1 ? originalName : `${baseName} (${counter - 1})${extension}`;
+            try {
+                await dirHandle.getFileHandle(candidateName, { create: false });
+            }
+            catch {
+                return candidateName;
+            }
+        }
+        return `${baseName}_${Date.now()}${extension}`;
+    }
+    catch {
+        const baseName = getFileBaseName(originalName);
+        const extension = getFullFileExtension(originalName);
+        return `${baseName}_${Date.now()}${extension}`;
+    }
+};
+// ============================================================
+// Helper per la generazione del nome di destinazione del file
+// (in base alle impostazioni utente: tipo, metadati, separatore...)
+// ============================================================
+/** Recupera il nome leggibile del tipo documento (cache) */
+export const getTypeName = async (tid) => {
+    const typeList = await DcmtTypeListCacheService.GetAllWithoutMetadataAsync();
+    const foundDtd = typeList.find(dtd => dtd.id?.toString() === tid?.toString());
+    return foundDtd?.name ?? String(tid);
+};
+/** Formatta un valore convertendo le date in formato dd-MM-yyyy [HH-mm-ss] */
+export const formatMetadataValue = (value) => {
+    const date = new Date(value);
+    if (!isNaN(date.getTime())) {
+        const day = date.getDate().toString().padStart(2, '0');
+        const month = (date.getMonth() + 1).toString().padStart(2, '0');
+        const year = date.getFullYear();
+        const hours = date.getHours();
+        const minutes = date.getMinutes();
+        const seconds = date.getSeconds();
+        if (hours !== 0 || minutes !== 0 || seconds !== 0) {
+            const hh = hours.toString().padStart(2, '0');
+            const mm = minutes.toString().padStart(2, '0');
+            const ss = seconds.toString().padStart(2, '0');
+            return `${day}-${month}-${year} ${hh}-${mm}-${ss}`;
+        }
+        return `${day}-${month}-${year}`;
+    }
+    return value;
+};
+/** Recupera i metadati filtrati (primi 5 con mid > 100 e valore presente), concatenati con separatorChar */
+export const getFilteredMetadata = async (tid, did, separatorChar) => {
+    const metadata = await SDK_Globals.tmSession?.NewSearchEngine().GetMetadataAsync(tid, did, true);
+    if (!metadata)
+        return null;
+    const dtdResult = metadata.dtdResult;
+    const rows = dtdResult?.rows?.[0] ?? [];
+    const mids = metadata.selectMIDs;
+    const dtdWithMetadata = await DcmtTypeListCacheService.GetWithNotGrantedAsync(tid, did, metadata);
+    const mdList = dtdWithMetadata?.metadata ?? [];
+    const metadataList = searchResultToMetadataValues(tid, dtdResult, rows, mids, mdList, LayoutModes.Update);
+    return metadataList
+        .reduce((acc, md) => acc.length < 5 && md.mid && md.mid > 100 && md.value ? [...acc, formatMetadataValue(md.value)] : acc, [])
+        .join(separatorChar);
+};
+/** Genera il nome file di destinazione in base alle impostazioni di naming */
+export const generateTargetFileName = async (file, dcmtInfo, options) => {
+    const { fileNamingMode, separatorChar } = options;
+    // Usa getFullFileExtension per gestire estensioni composite come .PDF.P7M, .DOCX.p7m
+    const fileExtension = getFullFileExtension(file.name);
+    const fallbackName = dcmtInfo.DID + fileExtension;
+    let targetFileName = file.name;
+    switch (fileNamingMode) {
+        case 'onlyDid':
+            targetFileName = fallbackName;
+            break;
+        case 'documentTypeAndDid': {
+            const typeName = await getTypeName(dcmtInfo.TID);
+            targetFileName = `${typeName}${separatorChar}${dcmtInfo.DID}${fileExtension}`;
+            break;
+        }
+        case 'documentTypeAndCustomMetadata':
+        case 'onlyCustomMetadata': {
+            try {
+                const filteredMetadata = await getFilteredMetadata(dcmtInfo.TID, dcmtInfo.DID, separatorChar);
+                if (filteredMetadata) {
+                    if (fileNamingMode === 'documentTypeAndCustomMetadata') {
+                        const typeName = await getTypeName(dcmtInfo.TID);
+                        targetFileName = `${typeName}${separatorChar}${filteredMetadata}${fileExtension}`;
+                    }
+                    else {
+                        targetFileName = `${filteredMetadata}${fileExtension}`;
+                    }
+                }
+                else {
+                    targetFileName = fallbackName;
+                }
+            }
+            catch {
+                targetFileName = fallbackName;
+            }
+            break;
+        }
+        default:
+            break;
+    }
+    return sanitizeFileName(targetFileName, fallbackName);
+};
+// ============================================================
+// Build della lista di DcmtInfo effettivi da scaricare
+// ============================================================
+/**
+ * Restituisce i documenti da scaricare:
+ * - se è visibile il TMRelationViewer, usa gli isDcmt selezionati al suo interno
+ * - altrimenti restituisce i selectedDcmtInfos passati come prop
+ */
+export const getDcmtInfosToDownload = (selectedDcmtInfos, selectedItemsRelationViewer, showTMRelationViewer) => {
+    if (showTMRelationViewer) {
+        return selectedItemsRelationViewer
+            .filter(i => i.isDcmt && i.tid != null && i.did != null)
+            .map(i => ({ TID: i.tid, DID: i.did }));
+    }
+    return selectedDcmtInfos;
+};
+// ============================================================
+// Stato iniziale settings (con valori salvati o default)
+// ============================================================
+/**
+ * Costruisce lo stato iniziale di DocumentDownloadSettings combinando:
+ * - i valori salvati in userSettings (se presenti)
+ * - i default della classe
+ * Nota: destinationFolder e zipPassword vengono sempre resettati per sicurezza.
+ */
+export const buildInitialDownloadSettings = (saved, defaultInvoiceFormat, defaultOrderFormat) => {
+    const defaults = new DocumentDownloadSettings();
+    return {
+        exportMode: saved?.exportMode ?? defaults.exportMode,
+        destinationFolder: 'Download',
+        zipFileName: saved?.zipFileName ?? defaults.zipFileName,
+        zipPassword: '',
+        fileNamingMode: saved?.fileNamingMode ?? defaults.fileNamingMode,
+        separatorChar: saved?.separatorChar ?? defaults.separatorChar,
+        invoiceFormat: saved?.invoiceFormat ?? defaultInvoiceFormat,
+        orderFormat: saved?.orderFormat ?? defaultOrderFormat,
+        fileExistsMode: saved?.fileExistsMode ?? defaults.fileExistsMode,
+        removeSignature: saved?.removeSignature ?? defaults.removeSignature,
+    };
+};

package/lib/components/features/search/SignatureParamsManager.d.ts

@@ -0,0 +1,70 @@
+export declare const DEFAULT_SIGNATURE_TID = -1;
+export type SignatureMethodCode = 'T' | 'D' | 'U';
+export interface SignatureEntry {
+    /** TID del tipo documento associato alla firma (-1 = firma di default globale) */
+    tid: number;
+    /** Immagine della firma in formato base64 (data URL) */
+    imgSign: string;
+    /** Metodo utilizzato: 'T' = Testo, 'D' = Disegno, 'U' = Upload */
+    method: SignatureMethodCode;
+    /** Testo utilizzato per generare la firma (solo per method='T') */
+    signText?: string;
+}
+export interface SignatureResult {
+    /** Immagine della firma in formato base64 (data URL) */
+    imgSign: string;
+    /** true se è stata usata la firma di default (tid = -1) */
+    isDefault: boolean;
+    /** TID effettivo della firma trovata */
+    sourceTid: number;
+    /** Metodo utilizzato: 'T' = Testo, 'D' = Disegno, 'U' = Upload */
+    method: SignatureMethodCode;
+    /** Testo utilizzato per generare la firma (solo per method='T') */
+    signText?: string;
+}
+/**
+ * Classe helper per gestire le firme predefinite salvate come JSON array.
+ * Centralizza tutte le operazioni di lettura/scrittura/eliminazione.
+ */
+export declare class SignatureParamsManager {
+    private static cache;
+    /**
+     * Svuota la cache locale. Utile per forzare un refresh dei dati.
+     */
+    static clearCache(): void;
+    /**
+     * Recupera tutte le firme salvate (usa cache locale se disponibile)
+     */
+    static getAll(): Promise<SignatureEntry[]>;
+    /**
+     * Recupera la firma per un TID specifico (senza fallback).
+     * Restituisce solo la firma associata al TID richiesto, o undefined se non esiste.
+     */
+    static getByTid(tid: number): Promise<SignatureResult | undefined>;
+    /**
+     * Recupera la firma per un TID specifico con fallback alla firma di default.
+     * Se non trova la firma per il TID specifico, prova con la firma di default (tid = -1).
+     * Se non esiste neanche quella, restituisce undefined.
+     * Restituisce anche l'informazione se è stata usata la firma di default.
+     */
+    static getByTidWithFallback(tid: number): Promise<SignatureResult | undefined>;
+    /**
+     * Salva la firma di default valida per tutti i tipi documento (tid = 0)
+     * @param imgSign Immagine firma in base64
+     * @param method Metodo utilizzato per creare la firma
+     * @param signText Testo utilizzato per generare la firma (solo per method='T')
+     */
+    static saveDefault(imgSign: string, method: SignatureMethodCode, signText?: string): Promise<void>;
+    /**
+     * Salva o aggiorna la firma per un TID specifico
+     * @param tid ID del tipo documento
+     * @param imgSign Immagine firma in base64
+     * @param method Metodo utilizzato per creare la firma
+     * @param signText Testo utilizzato per generare la firma (solo per method='T')
+     */
+    static save(tid: number, imgSign: string, method: SignatureMethodCode, signText?: string): Promise<void>;
+    /**
+     * Elimina la firma per un TID specifico
+     */
+    static delete(tid: number): Promise<void>;
+}

package/lib/components/features/search/SignatureParamsManager.js

@@ -0,0 +1,145 @@
+import { SDK_Globals } from "@topconsultnpm/sdk-ts";
+const SIGNATURE_PARAM_KEY = 'signParams'; // Chiave unica parametro per tutte le firme predefinite (JSON array)
+export const DEFAULT_SIGNATURE_TID = -1; // TID speciale per firma di default valida per tutti i tipi documento
+/**
+ * Classe helper per gestire le firme predefinite salvate come JSON array.
+ * Centralizza tutte le operazioni di lettura/scrittura/eliminazione.
+ */
+export class SignatureParamsManager {
+    /**
+     * Svuota la cache locale. Utile per forzare un refresh dei dati.
+     */
+    static clearCache() {
+        this.cache = null;
+    }
+    /**
+     * Recupera tutte le firme salvate (usa cache locale se disponibile)
+     */
+    static async getAll() {
+        // Se la cache è valorizzata, restituisci direttamente
+        if (this.cache !== null) {
+            return this.cache;
+        }
+        const jsonValue = await SDK_Globals.tmSession?.NewUserEngine().ParamGetAsync(SIGNATURE_PARAM_KEY);
+        if (!jsonValue || jsonValue === '') {
+            this.cache = [];
+            return this.cache;
+        }
+        try {
+            this.cache = JSON.parse(jsonValue);
+            return this.cache;
+        }
+        catch {
+            console.warn('Errore parsing JSON firme, formato non valido');
+            this.cache = [];
+            return this.cache;
+        }
+    }
+    /**
+     * Recupera la firma per un TID specifico (senza fallback).
+     * Restituisce solo la firma associata al TID richiesto, o undefined se non esiste.
+     */
+    static async getByTid(tid) {
+        const signatures = await this.getAll();
+        const entry = signatures.find(s => s.tid.toString() === tid.toString());
+        if (entry?.imgSign) {
+            return {
+                imgSign: entry.imgSign,
+                isDefault: tid.toString() === DEFAULT_SIGNATURE_TID.toString(),
+                sourceTid: tid,
+                method: entry.method,
+                signText: entry.signText
+            };
+        }
+        return undefined;
+    }
+    /**
+     * Recupera la firma per un TID specifico con fallback alla firma di default.
+     * Se non trova la firma per il TID specifico, prova con la firma di default (tid = -1).
+     * Se non esiste neanche quella, restituisce undefined.
+     * Restituisce anche l'informazione se è stata usata la firma di default.
+     */
+    static async getByTidWithFallback(tid) {
+        // Prima cerca la firma per il TID specifico
+        const specificResult = await this.getByTid(tid);
+        if (specificResult) {
+            return specificResult;
+        }
+        // Se non trova e il tid richiesto non è già il default, cerca la firma di default (tid = -1)
+        if (tid.toString() !== DEFAULT_SIGNATURE_TID.toString()) {
+            const defaultResult = await this.getByTid(DEFAULT_SIGNATURE_TID);
+            if (defaultResult) {
+                return {
+                    ...defaultResult,
+                    isDefault: true
+                };
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Salva la firma di default valida per tutti i tipi documento (tid = 0)
+     * @param imgSign Immagine firma in base64
+     * @param method Metodo utilizzato per creare la firma
+     * @param signText Testo utilizzato per generare la firma (solo per method='T')
+     */
+    static async saveDefault(imgSign, method, signText) {
+        await this.save(DEFAULT_SIGNATURE_TID, imgSign, method, signText);
+    }
+    /**
+     * Salva o aggiorna la firma per un TID specifico
+     * @param tid ID del tipo documento
+     * @param imgSign Immagine firma in base64
+     * @param method Metodo utilizzato per creare la firma
+     * @param signText Testo utilizzato per generare la firma (solo per method='T')
+     */
+    static async save(tid, imgSign, method, signText) {
+        const signatures = await this.getAll();
+        const existingIndex = signatures.findIndex(s => s.tid.toString() === tid.toString());
+        // Il testo della firma (signText) viene salvato SOLO quando:
+        // 1. Il metodo di creazione è 'T' (TextEditor) 
+        // 2. Il testo esiste ed è valorizzato
+        // Per i metodi 'D' (Disegno) e 'U' (Upload) il campo signText non viene mai salvato
+        const shouldSaveText = method === 'T' && signText;
+        // Pattern UPSERT: aggiorna se esiste, altrimenti crea nuova entry
+        if (existingIndex >= 0) {
+            // Aggiorna una firma esistente
+            signatures[existingIndex].imgSign = imgSign;
+            signatures[existingIndex].method = method;
+            if (shouldSaveText) {
+                // Salva il testo solo per metodo 'T' con testo valorizzato
+                signatures[existingIndex].signText = signText;
+            }
+            else {
+                // Rimuove signText se presente (es. cambio da 'T' a 'D' o 'U')
+                delete signatures[existingIndex].signText;
+            }
+        }
+        else {
+            // Crea una nuova entry senza includere signText di default
+            const entry = { tid, imgSign, method };
+            if (shouldSaveText) {
+                // Aggiunge signText solo se necessario
+                entry.signText = signText;
+            }
+            signatures.push(entry);
+        }
+        await SDK_Globals.tmSession?.NewUserEngine().ParamSetAsync(SIGNATURE_PARAM_KEY, JSON.stringify(signatures));
+        // Aggiorna la cache dopo il salvataggio
+        this.clearCache();
+        await this.getAll();
+    }
+    /**
+     * Elimina la firma per un TID specifico
+     */
+    static async delete(tid) {
+        const signatures = await this.getAll();
+        const filtered = signatures.filter(s => s.tid.toString() !== tid.toString());
+        await SDK_Globals.tmSession?.NewUserEngine().ParamSetAsync(SIGNATURE_PARAM_KEY, JSON.stringify(filtered));
+        // Aggiorna la cache dopo l'eliminazione
+        this.clearCache();
+        await this.getAll();
+    }
+}
+// Cache locale per evitare chiamate ripetute
+SignatureParamsManager.cache = null;

package/lib/components/features/search/TMSavedQuerySelector.d.ts

@@ -9,8 +9,8 @@ interface ITMSavedQuerySelectorProps {
     manageDefault?: boolean;
     onItemClick?: (sqd: SavedQueryDescriptor) => void;
     onDeleted?: (sqd: SavedQueryDescriptor) => void;
-    onFavoritesAdded?: (sqd: SavedQueryDescriptor) => void;
+    refreshFavoriteSavedQueries?: (sqd: SavedQueryDescriptor) => void;
     onRefreshData?: () => void;
 }
-declare const TMSavedQuerySelector: React.MemoExoticComponent<({ items, selectedId, allowShowSearch, height, manageDefault, onItemClick, onDeleted, onFavoritesAdded, onRefreshData }: ITMSavedQuerySelectorProps) => import("react/jsx-runtime").JSX.Element>;
+declare const TMSavedQuerySelector: React.MemoExoticComponent<({ items, selectedId, allowShowSearch, height, manageDefault, onItemClick, onDeleted, refreshFavoriteSavedQueries, onRefreshData }: ITMSavedQuerySelectorProps) => import("react/jsx-runtime").JSX.Element>;
 export default TMSavedQuerySelector;

package/lib/components/features/search/TMSavedQuerySelector.js

@@ -105,7 +105,7 @@ const getContextMenuItems = (sqd, manageDefault, isMobile, deleteAsync, setDefau
             onClick: () => { setInfoSQD?.(sqd); }
         }] : [])
 ];
-const TMSavedQuerySelector = React.memo(({ items, selectedId, allowShowSearch = true, height, manageDefault = true, onItemClick, onDeleted, onFavoritesAdded, onRefreshData }) => {
+const TMSavedQuerySelector = React.memo(({ items, selectedId, allowShowSearch = true, height, manageDefault = true, onItemClick, onDeleted, refreshFavoriteSavedQueries, onRefreshData }) => {
     const [dataSource, setDataSource] = useState([]);
     const [selectedItem, setSelectedItem] = useState();
     const [searchText, setSearchText] = useState('');
@@ -135,6 +135,7 @@ const TMSavedQuerySelector = React.memo(({ items, selectedId, allowShowSearch =
                     await SDK_Globals.tmSession?.NewSavedQueryEngine().DeleteAsync(sqd?.id);
                     await loadDataAsync(true);
                     onDeleted?.(sqd);
+                    refreshFavoriteSavedQueries?.(sqd);
                     TMSpinner.hide();
                 }
                 catch (ex) {
@@ -148,7 +149,7 @@ const TMSavedQuerySelector = React.memo(({ items, selectedId, allowShowSearch =
         try {
             TMSpinner.show();
             await SDK_Globals.tmSession?.NewSavedQueryEngine().FavoritesAddOrRemoveAsync(sqd?.id, false);
-            onFavoritesAdded?.(sqd);
+            refreshFavoriteSavedQueries?.(sqd);
             TMSpinner.hide();
             ShowAlert({ mode: 'success', title: SDK_Localizator.SavedQuery, message: SDKUI_Localizator.OperationSuccess, duration: 3000 });
         }

package/lib/components/features/search/TMSearch.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
-import { DcmtTypeDescriptor, TaskDescriptor, ObjectRef, HomeBlogPost } from '@topconsultnpm/sdk-ts';
+import { SavedQueryDescriptor, DcmtTypeDescriptor, TaskDescriptor, ObjectRef, HomeBlogPost } from '@topconsultnpm/sdk-ts';
+import { MergePdfManagerType } from '../../../helper';
 import { DcmtInfo, TaskContext } from '../../../ts';
 import { TMSearchResultFloatingActionConfig } from './TMSearchResultFloatingActionButton';
 interface ITMSearchProps {
@@ -36,9 +37,13 @@ interface ITMSearchProps {
         mid: number;
         value: string;
     }>, tid?: number) => void;
+    refreshFavoriteSavedQueries?: (sqd: SavedQueryDescriptor) => void;
     onCurrentTIDChangedCallback?: (tid: number | undefined) => void;
     onlyShowSearchQueryPanel?: boolean;
     onReferenceClick?: (ref: ObjectRef) => void;
+    inputDID?: number;
+    formAutoOpen?: boolean;
+    mergePdfManager?: MergePdfManagerType;
 }
 declare const TMSearch: React.FunctionComponent<ITMSearchProps>;
 export default TMSearch;