@topconsultnpm/sdkui-react 6.22.0-dev3.24 → 6.22.0-dev3.26

package/lib/hooks/useDcmtOperations.js

@@ -1,7 +1,7 @@
-import { useState } from 'react';
+import { useEffect, useRef } from 'react';
 import { LocalizeDcmtOperationTypes } from '../helper/Enum_Localizator';
 import { SDK_Globals, RetrieveFileOptions, DcmtOpers, ResultTypes, RecentCategories, MetadataDataTypes, MetadataDataDomains, DataListCacheService, DcmtTypeListCacheService, TemplateTIDs } from '@topconsultnpm/sdk-ts';
-import { ShowAlert, TMResultManager, FormulaHelper, TMExceptionBoxManager, TMSpinner } from '../components';
+import { ShowAlert, TMResultManager, FormulaHelper, TMExceptionBoxManager, TMSpinner, TMWaitPanelManager } from '../components';
 import { Globalization, getExceptionMessage, dialogConfirmOperation, extensionHandler, downloadBase64File, SDKUI_Globals, dcmtsFileCacheDownload, CACHE_SIZE_LIMIT, clearDcmtsFileCache, dcmtsFileCachePreview, isDcmtFileInCache, removeDcmtsFileCache, SDKUI_Localizator, ZipManager } from '../helper';
 import { DcmtOperationTypes, DownloadTypes, FileExtensionHandler } from '../ts';
 import { useFileDialog, useFileSourceDialog } from './useInputDialog';
@@ -9,8 +9,6 @@ import { importCertificatesAsync } from '../helper/certificateImportHelper';
 import { isXMLFileExt } from '../helper/dcmtsHelper';
 import { ShowConfirm } from '../components/base/TMConfirm';
 import { generateTargetFileName } from '../components/features/documents/copyAndMergeDcmtsShared';
-/** Intervallo minimo (ms) fra due aggiornamenti della progress bar di download. */
-const DOWNLOAD_PROGRESS_THROTTLE_MS = 100;
 const isScannerLicenseConfigured = () => {
     try {
         const scannerLicense = SDKUI_Globals.userSettings.advancedSettings.scannerLicense;
@@ -109,16 +107,22 @@ const getDownloadFileName = (file, dcmtInfo, useInputFileName = false) => {
     return `${baseFileName.slice(0, firstDot)}(${count})${baseFileName.slice(firstDot)}`;
 };
 export const useDcmtOperations = () => {
-    const [showWaitPanel, setShowWaitPanel] = useState(false);
-    const [waitPanelTitle, setWaitPanelTitle] = useState('');
-    const [showPrimary, setShowPrimary] = useState(false);
-    const [waitPanelTextPrimary, setWaitPanelTextPrimary] = useState('');
-    const [waitPanelValuePrimary, setWaitPanelValuePrimary] = useState(0);
-    const [waitPanelMaxValuePrimary, setWaitPanelMaxValuePrimary] = useState(0);
-    const [showSecondary, setShowSecondary] = useState(false);
-    const [waitPanelTextSecondary, setWaitPanelTextSecondary] = useState('');
-    const [waitPanelValueSecondary, setWaitPanelValueSecondary] = useState(0);
-    const [waitPanelMaxValueSecondary, setWaitPanelMaxValueSecondary] = useState(0);
+    // Pannello imperativo: l'avanzamento non passa da uno stato React.
+    const waitPanelRef = useRef(null);
+    /** Apre il wait panel dell'operazione. Interrompi agisce sull'abortController del ciclo. */
+    const openWaitPanel = (options) => {
+        waitPanelRef.current?.close();
+        const panel = TMWaitPanelManager.show({ cancelable: true, onAbort: () => abortController.abort(), ...options });
+        waitPanelRef.current = panel;
+        return panel;
+    };
+    const closeWaitPanel = (panel) => {
+        panel.close();
+        if (waitPanelRef.current === panel)
+            waitPanelRef.current = null;
+    };
+    // Il pannello vive fuori dall'albero del chiamante: allo smontaggio va chiuso a mano.
+    useEffect(() => () => { waitPanelRef.current?.close(); waitPanelRef.current = null; }, []);
     const { OpenFileDialog } = useFileDialog();
     const [selectFileSource, FileSourceDialog] = useFileSourceDialog();
     const copyCompliantDcmtsAsync = async (inputDcmt, onFileDownloaded) => {
@@ -131,8 +135,14 @@ export const useDcmtOperations = () => {
         let returnDcmtInfos = [];
         const rfo = new RetrieveFileOptions();
         rfo.retrieveReason = DcmtOpers.ShowFile;
-        let firstBlock = true;
-        let maxFileSize = 0;
+        // Gira dentro runOperationAsync: i byte vanno sulla barra secondaria del pannello gia' aperto.
+        const publishSecondary = (pd, label) => {
+            const max = pd.ProgressBarMaximum ?? 0;
+            const completed = pd.ProgressBarValue === pd.ProgressBarMaximum;
+            waitPanelRef.current?.setSecondary(completed
+                ? { value: 0, max: 0, text: '' }
+                : { value: pd.ProgressBarValue, max, text: `${label} ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(max, true)}` });
+        };
         let signerInfoDescriptor = undefined;
         if (inputDcmt?.FILEEXT == undefined || inputDcmt.FILEEXT == '') {
             throw new Error('WARNING#' + SDKUI_Localizator.MetadataOnlyDocument);
@@ -181,21 +191,7 @@ export const useDcmtOperations = () => {
             else
                 throw new Error('IdC non firmato e non marcato temporalmente!');
             //Ricerca dell'impronta SHA256 nel contenuto dell'IdC
-            let fileIdC = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(serachResultIdC.dtdResult.rows[0][0], serachResultIdC.dtdResult.rows[0][1], rfo, abortController.signal, (pd) => {
-                if (firstBlock) {
-                    maxFileSize = pd.ProgressBarMaximum ?? 0;
-                    setWaitPanelMaxValueSecondary(maxFileSize);
-                    firstBlock = false;
-                }
-                setWaitPanelValueSecondary(pd.ProgressBarValue);
-                setWaitPanelTextSecondary(`Downloading IdC... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
-                if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                    setWaitPanelMaxValueSecondary(0);
-                    setWaitPanelValueSecondary(0);
-                    setWaitPanelTextSecondary('');
-                    firstBlock = true;
-                }
-            });
+            let fileIdC = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(serachResultIdC.dtdResult.rows[0][0], serachResultIdC.dtdResult.rows[0][1], rfo, abortController.signal, (pd) => publishSecondary(pd, 'Downloading IdC...'));
             let hashOk = false;
             if (fileIdC) {
                 try {
@@ -212,21 +208,7 @@ export const useDcmtOperations = () => {
                 throw new Error('Impronta non trovata nel file IdC o non corrispondente a quella del documento');
             }
             let file;
-            file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(inputDcmt.TID, inputDcmt.DID, rfo, abortController.signal, (pd) => {
-                if (firstBlock) {
-                    maxFileSize = pd.ProgressBarMaximum ?? 0;
-                    setWaitPanelMaxValueSecondary(maxFileSize);
-                    firstBlock = false;
-                }
-                setWaitPanelValueSecondary(pd.ProgressBarValue);
-                setWaitPanelTextSecondary(`Downloading... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
-                if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                    setWaitPanelMaxValueSecondary(0);
-                    setWaitPanelValueSecondary(0);
-                    setWaitPanelTextSecondary('');
-                    firstBlock = true;
-                }
-            });
+            file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(inputDcmt.TID, inputDcmt.DID, rfo, abortController.signal, (pd) => publishSecondary(pd, 'Downloading...'));
             if (file && fileIdC) {
                 returnDcmtFiles.push(file);
                 returnDcmtInfos.push(inputDcmt);
@@ -283,13 +265,20 @@ export const useDcmtOperations = () => {
             }
         }
         let operationTitle = 'Download File';
-        setShowWaitPanel(true);
-        setShowPrimary(inputDcmts.length > 1);
-        setShowSecondary(true);
-        setWaitPanelTitle(operationTitle);
         abortController = new AbortController();
         // Riferimento const: il narrowing su inputDcmts non sopravvive dentro le closure.
         const dcmts = inputDcmts;
+        // Con un solo documento c'e' un avanzamento solo, quello dei byte, e sta sulla barra
+        // principale: la doppia barra (documenti + byte) serve solo all'elaborazione multipla.
+        const isBatch = dcmts.length > 1;
+        const panel = openWaitPanel({
+            title: operationTitle,
+            max: isBatch ? dcmts.length : 0,
+            showSecondary: isBatch,
+            showCounters: isBatch,
+            primaryLabel: isBatch ? SDKUI_Localizator.Documents : undefined,
+            secondaryLabel: isBatch ? 'File corrente' : undefined,
+        });
         const rfo = new RetrieveFileOptions();
         rfo.retrieveReason = retrieveOptions?.retrieveReason ?? DcmtOpers.ShowFile;
         if (retrieveOptions?.cvtFormat !== undefined)
@@ -299,55 +288,38 @@ export const useDcmtOperations = () => {
         rfo.invoiceRetrieveFormat = retrieveOptions?.invoiceRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.invoiceRetrieveFormat;
         rfo.orderRetrieveFormat = retrieveOptions?.orderRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.orderRetrieveFormat;
         const results = [];
-        setWaitPanelMaxValuePrimary(dcmts.length);
-        // ---- Progress secondaria: throttlata ----
-        // Gli eventi di avanzamento di axios arrivano a ogni chunk: senza throttle ognuno
-        // provoca un re-render dell'intera form (relation viewer compreso).
-        let currentBytes;
-        let pendingSecondary;
-        let secondaryTimer;
-        const flushSecondaryProgress = () => {
-            secondaryTimer = undefined;
-            if (!pendingSecondary)
-                return;
-            setWaitPanelMaxValueSecondary(pendingSecondary.max);
-            setWaitPanelValueSecondary(pendingSecondary.value);
-            setWaitPanelTextSecondary(pendingSecondary.text);
-            pendingSecondary = undefined;
-        };
-        const publishSecondaryProgress = () => {
-            const loaded = currentBytes?.loaded ?? 0;
-            const total = currentBytes?.total ?? 0;
-            pendingSecondary = total > 0
-                ? { value: loaded, max: total, text: `Downloading... ${Globalization.getNumberDisplayValue(loaded, true)} / ${Globalization.getNumberDisplayValue(total, true)}` }
-                : { value: 0, max: 0, text: '' };
-            if (secondaryTimer === undefined)
-                secondaryTimer = setTimeout(flushSecondaryProgress, DOWNLOAD_PROGRESS_THROTTLE_MS);
+        // Il pannello coalesce le scritture in un flush per frame: nessun throttle serve.
+        const publishBytes = (loaded, total) => {
+            const text = total > 0
+                ? `Downloading... ${Globalization.getNumberDisplayValue(loaded, true)} / ${Globalization.getNumberDisplayValue(total, true)}`
+                : '';
+            if (isBatch)
+                panel.setSecondary({ value: loaded, max: total, text });
+            else
+                panel.update({ value: loaded, max: total, subtitle: text });
         };
         // ---- Download sequenziale: un documento per volta ----
         let completed = 0;
         const downloadOne = async (i) => {
-            setWaitPanelTextPrimary(`Download file ${i + 1} di ${dcmts.length}`);
+            if (isBatch)
+                panel.setSubtitle(`Download file ${i + 1} di ${dcmts.length}`);
             let file;
             const cacheKey = `${dcmts[i].TID}-${dcmts[i].DID}`;
             if (useCache && dcmtsFileCacheDownload.has(cacheKey)) {
                 file = dcmtsFileCacheDownload.get(cacheKey);
             }
             else {
-                currentBytes = { loaded: 0, total: 0 };
                 try {
-                    file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(dcmts[i].TID, dcmts[i].DID, rfo, abortController.signal, (pd) => {
-                        currentBytes = { loaded: pd.ProgressBarValue, total: pd.ProgressBarMaximum ?? 0 };
-                        publishSecondaryProgress();
-                    });
+                    file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(dcmts[i].TID, dcmts[i].DID, rfo, abortController.signal, (pd) => publishBytes(pd.ProgressBarValue, pd.ProgressBarMaximum ?? 0));
                 }
                 finally {
-                    currentBytes = undefined;
-                    publishSecondaryProgress();
+                    if (isBatch)
+                        publishBytes(0, 0);
                 }
             }
             completed++;
-            setWaitPanelValuePrimary(completed);
+            if (isBatch)
+                panel.setValue(completed);
             if (downloadMode === "openInNewWindow") {
                 if (onFileDownloaded && file) {
                     onFileDownloaded(file, dcmts[i]);
@@ -386,30 +358,28 @@ export const useDcmtOperations = () => {
             results.push({ rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.SUCCESS });
         };
         for (let i = 0; i < dcmts.length; i++) {
+            // Con la conferma di interruzione aperta il ciclo si ferma qui invece di
+            // continuare a scaricare dietro al dialogo.
+            await panel.waitWhilePaused();
             if (abortController.signal.aborted) {
                 results.push({ rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${completed} documenti` });
+                panel.warning();
                 break;
             }
             try {
                 await downloadOne(i);
+                panel.ok();
             }
             catch (ex) {
                 results.push({ rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(ex) });
+                panel.error();
                 const err = ex;
                 if (err.name === 'CanceledError') {
                     ShowAlert({ message: err.message, mode: 'warning', duration: 3000, title: 'Abort' });
                 }
             }
         }
-        if (secondaryTimer !== undefined)
-            clearTimeout(secondaryTimer);
-        setWaitPanelTextPrimary('');
-        setWaitPanelMaxValuePrimary(0);
-        setWaitPanelValuePrimary(0);
-        setWaitPanelTextSecondary('');
-        setWaitPanelMaxValueSecondary(0);
-        setWaitPanelValueSecondary(0);
-        setShowWaitPanel(false);
+        closeWaitPanel(panel);
         TMResultManager.show(results, operationTitle, "TID", "DID", undefined, undefined, showSuccessAlert);
     };
     const _downloadAttachmentsAsync = async (inputDcmts, confirmAttachments, showSuccessAlert = true) => {
@@ -544,22 +514,37 @@ export const useDcmtOperations = () => {
         }
         if (!file)
             return;
-        setShowWaitPanel(true);
-        setShowPrimary(inputDcmts.length > 1);
-        setShowSecondary(true);
-        setWaitPanelTitle(operationTitle);
         abortController = new AbortController();
+        // Come nel download: con un solo documento resta il solo avanzamento in byte.
+        const isBatch = inputDcmts.length > 1;
+        const panel = openWaitPanel({
+            title: operationTitle,
+            max: isBatch ? inputDcmts.length : 0,
+            showSecondary: isBatch,
+            showCounters: isBatch,
+            primaryLabel: isBatch ? SDKUI_Localizator.Documents : undefined,
+            secondaryLabel: isBatch ? 'File corrente' : undefined,
+        });
+        const publishBytes = (loaded, total) => {
+            const text = total > 0
+                ? `Uploading... ${Globalization.getNumberDisplayValue(loaded, true)} / ${Globalization.getNumberDisplayValue(total, true)}`
+                : '';
+            if (isBatch)
+                panel.setSecondary({ value: loaded, max: total, text });
+            else
+                panel.update({ value: loaded, max: total, subtitle: text });
+        };
         let result = [];
-        setWaitPanelMaxValuePrimary(inputDcmts.length);
-        let firstBlock = true;
-        let maxFileSize = 0;
         for (let i = 0; i < inputDcmts.length; i++) {
+            await panel.waitWhilePaused();
             if (abortController.signal.aborted) {
                 result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${i + 1} documenti` });
+                panel.warning();
                 break;
             }
             try {
-                setWaitPanelTextPrimary(`${SDKUI_Localizator.FileUpload} ${i + 1} di ${inputDcmts.length}`);
+                if (isBatch)
+                    panel.setSubtitle(`${SDKUI_Localizator.FileUpload} ${i + 1} di ${inputDcmts.length}`);
                 const cacheKey = `${inputDcmts[i].TID}-${inputDcmts[i].DID}`;
                 if (dcmtsFileCachePreview.has(cacheKey))
                     removeDcmtsFileCache(cacheKey);
@@ -567,41 +552,30 @@ export const useDcmtOperations = () => {
                 if (ue) {
                     ue.TID = inputDcmts[i].TID;
                     ue.DID = inputDcmts[i].DID;
-                    await ue.SubstituteFileAsync(file, operType, undefined, abortController.signal, (pd) => {
-                        if (firstBlock) {
-                            maxFileSize = pd.ProgressBarMaximum ?? 0;
-                            setWaitPanelMaxValueSecondary(maxFileSize);
-                            firstBlock = false;
-                        }
-                        setWaitPanelValueSecondary(pd.ProgressBarValue);
-                        setWaitPanelTextSecondary(`Uploading... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
-                        if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                            setWaitPanelMaxValueSecondary(0);
-                            setWaitPanelValueSecondary(0);
-                            setWaitPanelTextSecondary('');
-                            firstBlock = true;
-                        }
-                    });
+                    await ue.SubstituteFileAsync(file, operType, undefined, abortController.signal, 
+                    // Byte finiti ma il server elabora ancora: la barra si azzera invece di restare al 100%.
+                    (pd) => pd.ProgressBarValue === pd.ProgressBarMaximum
+                        ? publishBytes(0, 0)
+                        : publishBytes(pd.ProgressBarValue, pd.ProgressBarMaximum ?? 0));
+                }
+                if (isBatch) {
+                    publishBytes(0, 0);
+                    panel.setValue(i + 1);
                 }
-                setWaitPanelValuePrimary(i + 1);
                 result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.SUCCESS });
+                panel.ok();
             }
             catch (ex) {
                 result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(ex) });
+                panel.error();
                 const err = ex;
                 if (err.name === 'CanceledError') {
                     ShowAlert({ message: err.message, mode: 'warning', duration: 3000, title: 'Abort' });
                 }
             }
         }
-        setWaitPanelTextPrimary('');
-        setWaitPanelMaxValuePrimary(0);
-        setWaitPanelValuePrimary(0);
-        setWaitPanelTextSecondary('');
-        setWaitPanelMaxValueSecondary(0);
-        setWaitPanelValueSecondary(0);
+        closeWaitPanel(panel);
         actionAfterOperationAsync?.();
-        setShowWaitPanel(false);
         TMResultManager.show(result, operationTitle, "TID", "DID");
     };
     const getDcmtFileAsync = async (inputDcmt, rfo, operationTitle, keepWaitPanelPrimary, bypassCache = false) => {
@@ -612,29 +586,21 @@ export const useDcmtOperations = () => {
         const cacheKey = `${inputDcmt.TID}-${inputDcmt.DID}`;
         if (!bypassCache && dcmtsFileCachePreview.has(cacheKey))
             return { file: dcmtsFileCachePreview.get(cacheKey), isFromCache: true };
-        setShowWaitPanel(true);
-        setShowPrimary(keepWaitPanelPrimary);
-        setShowSecondary(true);
-        setWaitPanelTitle(operationTitle);
         abortController = new AbortController();
-        let firstBlock = true;
-        let maxFileSize = 0;
+        // Un file solo: l'unico avanzamento e' quello in byte e sta sulla barra principale.
+        const panel = openWaitPanel({
+            title: operationTitle,
+            subtitle: extensionHandler(inputDcmt.FILEEXT ?? '') === FileExtensionHandler.CONVERTIBLE ? 'Conversione file in corso...' : 'Recupero file in corso...',
+            showCounters: false,
+        });
         try {
-            setWaitPanelTextSecondary(extensionHandler(inputDcmt.FILEEXT ?? '') === FileExtensionHandler.CONVERTIBLE ? 'Conversione file in corso...' : 'Recupero file in corso...');
             const file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(inputDcmt?.TID, inputDcmt?.DID, rfo, abortController.signal, (pd) => {
-                if (firstBlock) {
-                    maxFileSize = pd.ProgressBarMaximum ?? 0;
-                    setWaitPanelMaxValueSecondary(maxFileSize);
-                    firstBlock = false;
-                }
-                setWaitPanelValueSecondary(pd.ProgressBarValue);
-                setWaitPanelTextSecondary(`Downloading... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
-                if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                    setWaitPanelMaxValueSecondary(0);
-                    setWaitPanelValueSecondary(0);
-                    setWaitPanelTextSecondary('');
-                    firstBlock = true;
-                }
+                const max = pd.ProgressBarMaximum ?? 0;
+                panel.update({
+                    value: pd.ProgressBarValue,
+                    max,
+                    subtitle: `Downloading... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(max, true)}`,
+                });
             });
             if (dcmtsFileCachePreview.size >= CACHE_SIZE_LIMIT) {
                 const oldestKey = dcmtsFileCachePreview.keys().next().value;
@@ -646,10 +612,7 @@ export const useDcmtOperations = () => {
             return { file: file, isFromCache: false };
         }
         finally {
-            setWaitPanelTextSecondary('');
-            setWaitPanelMaxValueSecondary(0);
-            setWaitPanelValueSecondary(0);
-            setShowWaitPanel(false);
+            closeWaitPanel(panel);
         }
     };
     const getDisplayValueMetadataValueDescriptor = async (mvd) => {
@@ -706,19 +669,26 @@ export const useDcmtOperations = () => {
                 return;
             }
             let zipEntries = [];
-            setShowWaitPanel(true);
-            setShowPrimary(true);
-            setShowSecondary(false);
-            setWaitPanelTitle(operationTitle);
             abortController = new AbortController();
+            // La copia conforme scarica due file per documento: e' l'unica operazione del ciclo
+            // con un avanzamento di dettaglio, e gli serve la seconda barra.
+            const isCopyCompliant = dcmtOperationType === DcmtOperationTypes.CopyCompliant;
+            const panel = openWaitPanel({
+                title: operationTitle,
+                max: inputDcmts.length,
+                showSecondary: isCopyCompliant,
+                primaryLabel: isCopyCompliant ? SDKUI_Localizator.Documents : undefined,
+                secondaryLabel: isCopyCompliant ? 'File corrente' : undefined,
+            });
             let result = [];
-            setWaitPanelMaxValuePrimary(inputDcmts.length);
             for (let i = 0; i < inputDcmts.length; i++) {
+                await panel.waitWhilePaused();
                 if (abortController.signal.aborted) {
                     result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${i + 1} documenti` });
+                    panel.warning();
                     break;
                 }
-                setWaitPanelTextPrimary(`Documento ${i + 1} di ${inputDcmts.length}`);
+                panel.setSubtitle(`Documento ${i + 1} di ${inputDcmts.length}`);
                 try {
                     switch (dcmtOperationType) {
                         case DcmtOperationTypes.AddToFavs:
@@ -828,28 +798,29 @@ export const useDcmtOperations = () => {
                         }
                     }
                     result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.SUCCESS });
+                    panel.ok();
                 }
                 catch (ex) {
                     let msg = getExceptionMessage(ex);
                     if (msg.startsWith('WARNING#')) {
                         result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description: msg.replace('WARNING#', '') });
+                        panel.warning();
                     }
-                    else
+                    else {
                         result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.ERROR, description: msg });
+                        panel.error();
+                    }
                     const err = ex;
                     if (err.name === 'CanceledError') {
                         ShowAlert({ message: err.message, mode: 'warning', duration: 3000, title: 'Abort' });
                     }
                 }
-                setWaitPanelValuePrimary(i + 1);
+                panel.setValue(i + 1);
             }
             if (zipEntries.length > 0) {
                 await zipDocuments(zipEntries, dcmtOperationType, inputDcmts[0].TID);
             }
-            setWaitPanelMaxValuePrimary(0);
-            setWaitPanelValuePrimary(0);
-            setWaitPanelTextPrimary('');
-            setShowWaitPanel(false);
+            closeWaitPanel(panel);
             actionAfterOperationAsync?.();
             TMResultManager.show(result, operationTitle, "TID", "DID");
         };
@@ -862,7 +833,6 @@ export const useDcmtOperations = () => {
         }
     };
     return {
-        abortController, showWaitPanel, showPrimary, waitPanelTitle, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary,
         downloadDcmtsAsync, getDcmtFileAsync, clearDcmtsFileCache, removeDcmtsFileCache, isDcmtFileInCache, runOperationAsync, FileSourceDialog
     };
 };

package/lib/hooks/useDocumentOperations.js

@@ -109,10 +109,10 @@ export const useDocumentOperations = (props) => {
     // Context helpers
     const isDcmtFormContext = context === SearchResultContext.DCMT_FORM;
     const isMasterDetailContext = context === SearchResultContext.MASTER_DETAIL;
-    const { showHistory, showHistoryCallback, hideHistoryCallback, showCheckoutInformationForm, commentFormState, hideCommentFormCallback, showCheckoutInformationFormCallback, hideCheckoutInformationFormCallback, copyCheckoutPathToClipboardCallback, handleCheckOutCallback, handleCheckInCallback, showCicoWaitPanel, cicoWaitPanelTitle, showCicoPrimaryProgress, cicoPrimaryProgressText, cicoPrimaryProgressValue, cicoPrimaryProgressMax, } = useCheckInOutOperations({
+    const { showHistory, showHistoryCallback, hideHistoryCallback, showCheckoutInformationForm, commentFormState, hideCommentFormCallback, showCheckoutInformationFormCallback, hideCheckoutInformationFormCallback, copyCheckoutPathToClipboardCallback, handleCheckOutCallback, handleCheckInCallback, } = useCheckInOutOperations({
         onRefreshPreview: onRefreshPreviewCallback
     });
-    const { abortController, showWaitPanel, waitPanelTitle, showPrimary, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary, downloadDcmtsAsync, runOperationAsync, getDcmtFileAsync, clearDcmtsFileCache, removeDcmtsFileCache, isDcmtFileInCache, FileSourceDialog } = useDcmtOperations();
+    const { downloadDcmtsAsync, runOperationAsync, getDcmtFileAsync, clearDcmtsFileCache, removeDcmtsFileCache, isDcmtFileInCache, FileSourceDialog } = useDcmtOperations();
     const { 
     // Data
     relatedDcmts, pairedSearchResults, manyToManyRelations, selectedManyToManyRelation, manyToManyChooserDataSource, relatedDcmtsChooserDataSource, 
@@ -178,8 +178,14 @@ export const useDocumentOperations = (props) => {
     const [isOpenDetailsModal, setIsOpenDetailsModal] = useState(false);
     const [isOpenMasterModal, setIsOpenMasterModal] = useState(false);
     const [isOpenMultiDetailModal, setIsOpenMultiDetailModal] = useState(false);
-    const openDetailDcmtsFormHandler = (value) => { setIsOpenDetails(value); };
-    const openMasterDcmtsFormHandler = (value) => { setIsOpenMaster(value); };
+    // La maschera delle correlazioni viene montata subito (parte il calcolo, con il wait panel)
+    // ma resa visibile (isOpen...) solo a calcolo finito: intanto sotto restano i risultati.
+    const [isMountedDetails, setIsMountedDetails] = useState(false);
+    const [isMountedMaster, setIsMountedMaster] = useState(false);
+    const openDetailDcmtsFormHandler = (value) => { setIsMountedDetails(value); if (!value)
+        setIsOpenDetails(false); };
+    const openMasterDcmtsFormHandler = (value) => { setIsMountedMaster(value); if (!value)
+        setIsOpenMaster(false); };
     const openDetailDcmtsModalHandler = (value) => { setIsOpenDetailsModal(value); };
     const openMasterDcmtsModalHandler = (value) => { setIsOpenMasterModal(value); };
     // State to control whether the export form (for exporting to Excel/CSV/txt and others) should be shown
@@ -1413,8 +1419,8 @@ export const useDocumentOperations = (props) => {
                             onRefreshBlogDatagrid,
                             onRefreshPreviewDatagrid
                         }, fetchRemoteCertificates: fetchRemoteCertificates, graphometricManager: graphometricManager })) }), (showHistory && dtd && selectedDcmtInfos.length > 0) && _jsx(TMViewHistoryDcmt, { fromDTD: dtd, deviceType: deviceType, inputDcmt: selectedDcmtInfos[0], onClose: hideHistoryCallback, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }), (commentFormState.show && selectedDcmtInfos.length > 0) && _jsx(TMBlogCommentForm, { context: { engine: 'SearchEngine', object: { tid: selectedDcmtInfos[0].TID, did: selectedDcmtInfos[0].DID } }, onClose: hideCommentFormCallback, refreshCallback: onRefreshBlog, participants: [], showAttachmentsSection: true, allArchivedDocumentsFileItems: convertSearchResultDescriptorToFileItems(currentSearchResults ?? []), isCommentRequired: commentFormState.isRequired, removeAndEditAttachment: commentFormState.removeAndEditAttachment, selectedAttachmentDid: [Number(selectedDcmtInfos[0].DID)] }), (showCheckoutInformationForm && dtd && selectedDcmtInfos.length > 0) &&
-                _jsx(TMDcmtCheckoutInfoForm, { dtdName: dtd.name ?? SDKUI_Localizator.SearchResult, selectedDcmtOrFocused: selectedDcmtInfos[0], onClose: hideCheckoutInformationFormCallback }), isOpenDetailsModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenDetailsModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetailsModal(false) }) }), _jsx(StyledMultiViewPanel, { $isVisible: isOpenDetails, children: isOpenDetails && _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetails(false) }) }), (isOpenMultiDetailModal && dtd) &&
-                _jsx(TMMultiMasterDetailDcmtsForm, { dtd: dtd, masterDcmt: selectedDcmtInfos[0], onClose: () => setIsOpenMultiDetailModal(false), canNavigateMaster: canNavigateMultiDetailMaster ? canNavigateHandler : undefined, onNavigateMaster: canNavigateMultiDetailMaster ? onNavigateHandler : undefined, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, showDcmtFormSidebar: showDcmtFormSidebar, showTodoDcmtForm: showTodoDcmtForm, openFileUploaderPdfEditor: openFileUploaderPdfEditor, graphometricManager: graphometricManager, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, fetchRemoteCertificates: fetchRemoteCertificates, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onReferenceClick: onReferenceClick, onTaskCreateRequest: onTaskCreateRequest, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, onFileOpened: onFileOpened, passToArchiveCallback: passToArchiveCallback, openWGsCopyMoveForm: openWGsCopyMoveForm }), isOpenMasterModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenMasterModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMasterModal(false) }) }), _jsxs(StyledMultiViewPanel, { $isVisible: isOpenMaster, children: [isOpenMaster && _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMaster(false) }), secondaryMasterDcmts.length > 0 && secondaryMasterDcmts.map((dcmt, index) => {
+                _jsx(TMDcmtCheckoutInfoForm, { dtdName: dtd.name ?? SDKUI_Localizator.SearchResult, selectedDcmtOrFocused: selectedDcmtInfos[0], onClose: hideCheckoutInformationFormCallback }), isOpenDetailsModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenDetailsModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetailsModal(false) }) }), _jsx(StyledMultiViewPanel, { $isVisible: isOpenDetails, children: isMountedDetails && _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onFirstLoadCompleted: () => setIsOpenDetails(true), onBack: () => openDetailDcmtsFormHandler(false) }) }), (isOpenMultiDetailModal && dtd) &&
+                _jsx(TMMultiMasterDetailDcmtsForm, { dtd: dtd, masterDcmt: selectedDcmtInfos[0], onClose: () => setIsOpenMultiDetailModal(false), canNavigateMaster: canNavigateMultiDetailMaster ? canNavigateHandler : undefined, onNavigateMaster: canNavigateMultiDetailMaster ? onNavigateHandler : undefined, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, showDcmtFormSidebar: showDcmtFormSidebar, showTodoDcmtForm: showTodoDcmtForm, openFileUploaderPdfEditor: openFileUploaderPdfEditor, graphometricManager: graphometricManager, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, fetchRemoteCertificates: fetchRemoteCertificates, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onReferenceClick: onReferenceClick, onTaskCreateRequest: onTaskCreateRequest, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, onFileOpened: onFileOpened, passToArchiveCallback: passToArchiveCallback, openWGsCopyMoveForm: openWGsCopyMoveForm }), isOpenMasterModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenMasterModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMasterModal(false) }) }), _jsxs(StyledMultiViewPanel, { $isVisible: isOpenMaster, children: [isMountedMaster && _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onFirstLoadCompleted: () => setIsOpenMaster(true), onBack: () => openMasterDcmtsFormHandler(false) }), secondaryMasterDcmts.length > 0 && secondaryMasterDcmts.map((dcmt, index) => {
                         return (_jsx(StyledModalContainer, { style: { backgroundColor: 'white' }, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, inputDcmts: [dcmt], allowNavigation: false, onBack: () => handleRemoveItem(dcmt.TID, dcmt.DID) }) }, `${index}-${dcmt.DID}`));
                     })] }), isOpenArchiveRelationForm && _jsx(TMDcmtForm, { isModal: true, titleModal: SDKUI_Localizator.Archive + ' - ' + (archiveType === 'detail' ? SDKUI_Localizator.DcmtsDetail : SDKUI_Localizator.DcmtsMaster), TID: archiveRelatedDcmtFormTID, layoutMode: LayoutModes.Ark, inputMids: archiveRelatedDcmtFormMids, showBackButton: false, allowButtonsRefs: false, onClose: () => {
                     setIsOpenArchiveRelationForm(false);
@@ -1513,25 +1519,8 @@ export const useDocumentOperations = (props) => {
                 copyCheckoutPathToClipboardCallback,
                 handleCheckOutCallback,
                 handleCheckInCallback,
-                showCicoWaitPanel,
-                cicoWaitPanelTitle,
-                showCicoPrimaryProgress,
-                cicoPrimaryProgressText,
-                cicoPrimaryProgressValue,
-                cicoPrimaryProgressMax,
             },
             dcmtOperations: {
-                abortController,
-                showWaitPanel,
-                showPrimary,
-                waitPanelTitle,
-                waitPanelTextPrimary,
-                waitPanelValuePrimary,
-                waitPanelMaxValuePrimary,
-                showSecondary,
-                waitPanelTextSecondary,
-                waitPanelValueSecondary,
-                waitPanelMaxValueSecondary,
                 downloadDcmtsAsync,
                 getDcmtFileAsync,
                 clearDcmtsFileCache,

package/lib/hooks/useInputDialog.d.ts

@@ -1,4 +1,3 @@
-import React from "react";
 import { FileDescriptor, FileFormats } from '@topconsultnpm/sdk-ts';
 export declare const useInputCvtFormatDialog: () => [() => Promise<FileFormats>, () => JSX.Element];
 export declare const useFileDialog: () => {
@@ -6,7 +5,7 @@ export declare const useFileDialog: () => {
 };
 export declare const useInputAttachmentsDialog: () => {
     openConfirmAttachmentsDialog: (list: FileDescriptor[]) => Promise<string[] | undefined>;
-    ConfirmAttachmentsDialog: () => React.JSX.Element | null;
+    ConfirmAttachmentsDialog: () => import("react/jsx-runtime").JSX.Element | null;
 };
 export type FileSourceType = 'filesystem' | 'scanner-new' | 'scanner-edit' | undefined;
 export declare const useFileSourceDialog: () => [(hasExistingFile?: boolean) => Promise<FileSourceType>, () => JSX.Element];

package/lib/hooks/useMultiMasterDetailDcmts.d.ts

@@ -16,19 +16,6 @@ export type MidValue = {
     mid: number;
     value: string;
 };
-/** Stato del wait panel: le chiavi sono quelle dei props di TMLayoutWaitingContainer */
-export type WaitPanelState = {
-    showWaitPanel: boolean;
-    waitPanelTitle: string;
-    showWaitPanelPrimary: boolean;
-    waitPanelTextPrimary: string;
-    waitPanelValuePrimary: number;
-    waitPanelMaxValuePrimary: number;
-    showWaitPanelSecondary: boolean;
-    waitPanelTextSecondary: string;
-    waitPanelValueSecondary: number;
-    waitPanelMaxValueSecondary: number;
-};
 interface UseMultiMasterDetailDcmtsParams {
     /** Tipo documento del master */
     dtd: DcmtTypeDescriptor;
@@ -108,6 +95,4 @@ export declare const useMultiMasterDetailDcmts: ({ dtd, masterDcmt, onClose, can
     setStopOnFirstError: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     isArchiving: boolean;
     archiveAllAsync: () => Promise<void>;
-    waitPanel: WaitPanelState;
-    abortController: AbortController | undefined;
 };