@topconsultnpm/sdkui-react 6.22.0-dev3.9 → 6.22.0-dev4.10

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

@@ -8,8 +8,8 @@ import { useDeviceType } from '../../base/TMDeviceProvider';
 import TMTextBox from '../../editors/TMTextBox';
 import { ButtonNames, TMMessageBoxManager } from '../../base/TMPopUp';
 import { useDcmtOperations } from '../../../hooks/useDcmtOperations';
-import { TMLayoutWaitingContainer } from '../../base/TMWaitPanel';
 import { TMSplitterLayout } from '../../base/TMLayout';
+import TMWaitPanelManager from '../../base/waitPanel/TMWaitPanelManager';
 import { TMColors } from '../../../utils/theme';
 import TMDownloadRelationViewerSection from './TMDownloadRelationViewerSection';
 import { getDcmtInfosToDownload, getFloatingLabelStyle, isDirectoryPickerSupported, MIN_PDF_FOR_MERGE, } from './copyAndMergeDcmtsShared';
@@ -18,12 +18,6 @@ import ShowAlert from '../../base/TMAlert';
 import TMTooltip from '../../base/TMTooltip';
 import MergePdfManager from '../../../helper/MergePdfManager';
 import { TMResultManager } from '../../forms/TMResultDialog';
-/**
- * Numero di documenti scaricati in parallelo durante l'unione.
- * I file vengono consumati via callback (nessun click su <a download>), quindi il
- * parallelismo è sicuro; il riordino finale è garantito da pdfFilesMap.
- */
-const MERGE_DOWNLOAD_CONCURRENCY = 5;
 /**
  * Converte il formato di visualizzazione fatture impostato dall'utente nel corrispondente formato PDF:
  * il foglio di stile SDI resta SDI, in tutti gli altri casi si usa ASW.
@@ -56,16 +50,12 @@ const toPdfOrderRetrieveFormat = (format) => {
  */
 const TMMergeToPdfForm = (props) => {
     const { mode, selectedDcmtInfos, selectedItemsFull, onClose, showTMRelationViewer, allTasks, getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers } = props;
-    const { abortController, showWaitPanel, waitPanelTitle, showPrimary, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary, downloadDcmtsAsync, } = useDcmtOperations();
+    // Il wait panel del download lo apre e lo aggiorna l'hook: qui serve solo la funzione.
+    const { downloadDcmtsAsync } = useDcmtOperations();
     const deviceType = useDeviceType();
     const [pdfFileName, setPdfFileName] = useState(`${SDKUI_Localizator.Result.toLowerCase()}.pdf`);
     const [destinationFolder, setDestinationFolder] = useState('Download');
     const [selectedItemsRelationViewer, setSelectedItemsRelationViewer] = useState([]);
-    // ---- Stato per il merge PDF (progress bar) ----
-    const [isMergingPdf, setIsMergingPdf] = useState(false);
-    const [mergeProgressText, setMergeProgressText] = useState('');
-    const [mergeProgressValue, setMergeProgressValue] = useState(0);
-    const [mergeProgressMax, setMergeProgressMax] = useState(0);
     // ---- Ref per la selezione cartella (File System Access API) ----
     const folderHandleRef = useRef(null);
     const skipSelectFolderRef = useRef(false);
@@ -162,32 +152,37 @@ const TMMergeToPdfForm = (props) => {
         // Raccoglie gli errori come downloadDcmtsAsync
         const metadataConversionResults = [];
         if (metadataOnlyDcmts.length > 0) {
-            setIsMergingPdf(true);
-            setMergeProgressMax(metadataOnlyDcmts.length);
-            setMergeProgressValue(0);
-            setMergeProgressText('Creazione PDF metadati...');
+            const metadataPanel = TMWaitPanelManager.show({
+                title: SDKUI_Localizator.MergeToPdf,
+                subtitle: 'Creazione PDF metadati...',
+                max: metadataOnlyDcmts.length,
+            });
             for (let i = 0; i < metadataOnlyDcmts.length; i++) {
                 const dcmt = metadataOnlyDcmts[i];
                 try {
-                    setMergeProgressValue(i);
-                    setMergeProgressText(`Creazione PDF metadati... (${i + 1}/${metadataOnlyDcmts.length})`);
+                    metadataPanel.setSubtitle(`Creazione PDF metadati... (${i + 1}/${metadataOnlyDcmts.length})`);
                     const conversionResult = await createMetadataPdfFromDocument(dcmt);
                     if (conversionResult) {
                         pdfFilesMap.set(`${dcmt.TID}_${dcmt.DID}`, conversionResult.file);
                         metadataConversionResults.push({ rowIndex: i, id1: dcmt.TID, id2: dcmt.DID, resultType: ResultTypes.SUCCESS });
+                        metadataPanel.ok();
                     }
                     else {
                         // createMetadataPdfFromDocument ha restituito null (errore interno loggato)
-                        metadataConversionResults.push({ rowIndex: i, id1: dcmt.TID, id2: dcmt.DID, resultType: ResultTypes.ERROR, description: 'Creazione PDF metadati fallita' });
+                        metadataConversionResults.push({ rowIndex: i, id1: dcmt.TID, id2: dcmt.DID, resultType: ResultTypes.ERROR, description: SDKUI_Localizator.MetadataPdfCreationFailed });
+                        metadataPanel.error(1, `DID ${dcmt.DID}: ${SDKUI_Localizator.MetadataPdfCreationFailed}`);
                     }
                 }
                 catch (error) {
                     console.error(`Errore creazione PDF metadati per TID=${dcmt.TID}, DID=${dcmt.DID}`, error);
-                    metadataConversionResults.push({ rowIndex: i, id1: dcmt.TID, id2: dcmt.DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(error) });
+                    const description = getExceptionMessage(error);
+                    metadataConversionResults.push({ rowIndex: i, id1: dcmt.TID, id2: dcmt.DID, resultType: ResultTypes.ERROR, description });
+                    metadataPanel.error(1, `DID ${dcmt.DID}: ${description}`);
                 }
+                // Avanza a conversione conclusa: con un solo documento la barra non parte dal 100%
+                await metadataPanel.step();
             }
-            setMergeProgressValue(metadataOnlyDcmts.length);
-            setIsMergingPdf(false);
+            metadataPanel.close();
             // Mostra riepilogo errori se presenti (come downloadDcmtsAsync)
             const hasErrors = metadataConversionResults.some(r => r.resultType === ResultTypes.ERROR);
             if (hasErrors) {
@@ -206,7 +201,7 @@ const TMMergeToPdfForm = (props) => {
             const collectFileForMerge = async (file, dcmtInfo) => {
                 pdfFilesMap.set(`${dcmtInfo.TID}_${dcmtInfo.DID}`, file);
             };
-            await downloadDcmtsAsync({ inputDcmts: dcmtsWithFile, downloadType: DownloadTypes.Dcmt, downloadMode: 'download', onFileDownloaded: collectFileForMerge, skipConfirmation: true, retrieveOptions: rfo, useCache: false, downloadConcurrency: MERGE_DOWNLOAD_CONCURRENCY });
+            await downloadDcmtsAsync({ inputDcmts: dcmtsWithFile, downloadType: DownloadTypes.Dcmt, downloadMode: 'download', onFileDownloaded: collectFileForMerge, skipConfirmation: true, retrieveOptions: rfo, useCache: false });
         }
         // Ricostruisci l'array pdfFiles nell'ordine originale di selezione
         const pdfFiles = [];
@@ -233,16 +228,17 @@ const TMMergeToPdfForm = (props) => {
         if (!pdfFiles)
             return;
         const finalName = pdfFileName.trim().toLowerCase().endsWith('.pdf') ? pdfFileName.trim() : pdfFileName.trim() + '.pdf';
-        // Inizializza progress bar per il merge
-        setIsMergingPdf(true);
-        setMergeProgressMax(pdfFiles.length);
-        setMergeProgressValue(0);
-        setMergeProgressText(SDKUI_Localizator.MergeToPdf);
+        // Il merge non e' interrompibile: pannello senza Interrompi.
+        const mergePanel = TMWaitPanelManager.show({
+            title: SDKUI_Localizator.MergeToPdf,
+            subtitle: SDKUI_Localizator.MergeToPdf,
+            max: pdfFiles.length,
+            showCounters: false,
+        });
         try {
             const mergeOptions = {
                 onProgress: (current, total, file) => {
-                    setMergeProgressValue(current);
-                    setMergeProgressText(`${SDKUI_Localizator.MergeToPdf}: ${file.name}`);
+                    mergePanel.update({ value: current, subtitle: `${SDKUI_Localizator.MergeToPdf}: ${file.name}` });
                 }
             };
             // Se c'è una cartella selezionata (non Download di default), salva direttamente nella cartella
@@ -266,7 +262,7 @@ const TMMergeToPdfForm = (props) => {
             return;
         }
         finally {
-            setIsMergingPdf(false);
+            mergePanel.close();
         }
         onClose();
     };
@@ -367,29 +363,29 @@ const TMMergeToPdfForm = (props) => {
                                                 ? SDKUI_Localizator.FileNotPdfWillBeExcluded.replaceParams(extLabel)
                                                 : SDKUI_Localizator.FilesNotPdfWillBeExcluded.replaceParams(nonPdfSelectedItems.length.toString(), extLabel);
                                         })() }))] })] }))] })] }));
-    return (_jsx(TMLayoutWaitingContainer, { direction: 'vertical', showWaitPanel: showWaitPanel || isMergingPdf, showWaitPanelPrimary: isMergingPdf ? true : showPrimary, showWaitPanelSecondary: isMergingPdf ? false : showSecondary, waitPanelTitle: isMergingPdf ? SDKUI_Localizator.MergeToPdf : waitPanelTitle, waitPanelTextPrimary: isMergingPdf ? mergeProgressText : waitPanelTextPrimary, waitPanelValuePrimary: isMergingPdf ? mergeProgressValue : waitPanelValuePrimary, waitPanelMaxValuePrimary: isMergingPdf ? mergeProgressMax : waitPanelMaxValuePrimary, waitPanelTextSecondary: isMergingPdf ? '' : waitPanelTextSecondary, waitPanelValueSecondary: isMergingPdf ? 0 : waitPanelValueSecondary, waitPanelMaxValueSecondary: isMergingPdf ? 0 : waitPanelMaxValueSecondary, isCancelable: !isMergingPdf, abortController: abortController, usePortal: true, children: _jsx(TMModal, { width: calcResponsiveSizes(deviceType, showTMRelationViewer ? '90%' : '500px', showTMRelationViewer ? '90%' : '500px', '95%'), height: showTMRelationViewer ? '95%' : 'auto', title: getTitle(), onClose: onClose, showCloseButton: true, children: _jsxs("div", { onContextMenu: (e) => e.preventDefault(), style: { display: 'flex', flexDirection: 'column', gap: '16px', padding: '16px', width: '100%', height: '100%', boxSizing: 'border-box', overflow: 'hidden' }, children: [showTMRelationViewer ? (_jsx("div", { style: { flex: 1, minHeight: 0, display: 'flex', flexDirection: 'column' }, children: _jsxs(TMSplitterLayout, { direction: 'vertical', showSeparator: true, separatorSize: 8, separatorColor: 'transparent', separatorActiveColor: 'transparent', overflow: 'hidden', min: ["50", "50"], start: ["70%", "30%"], children: [_jsx(TMDownloadRelationViewerSection, { selectedDcmtInfos: selectedDcmtInfos, onSelectionChanged: setSelectedItemsRelationViewer, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }), configSection] }, "TMMergeToPdf-relation-config") })) : (configSection), _jsx("div", { style: { display: 'flex', justifyContent: 'center', alignItems: 'center', flexShrink: 0, marginTop: '12px' }, children: _jsxs("button", { disabled: !isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge, onClick: run, style: {
-                                display: 'flex',
-                                alignItems: 'center',
-                                justifyContent: 'center',
-                                gap: '6px',
-                                padding: '8px 20px',
-                                fontSize: '0.95rem',
-                                fontWeight: 600,
-                                color: '#fff',
-                                background: (!isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge)
-                                    ? '#b0b0b0'
-                                    : 'linear-gradient(135deg, #28a745 0%, #218838 100%)',
-                                border: 'none',
-                                borderRadius: '6px',
-                                cursor: (!isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge) ? 'not-allowed' : 'pointer',
-                                boxShadow: (!isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge)
-                                    ? 'none'
-                                    : '0 2px 8px rgba(40, 167, 69, 0.35)',
-                                transition: 'all 0.2s ease',
-                            }, children: [_jsx(IconPlay, {}), _jsx("span", { children: mergeableSelectedCount === 0
-                                        ? SDKUI_Localizator.MergeToPdf
-                                        : mergeableSelectedCount > 999
-                                            ? _jsx(TMTooltip, { content: mergeableSelectedCount.toString(), children: SDKUI_Localizator.MergeFilesToPdf.replaceParams('999+') })
-                                            : SDKUI_Localizator.MergeFilesToPdf.replaceParams(mergeableSelectedCount.toString()) })] }) })] }) }) }));
+    return (_jsx(TMModal, { width: calcResponsiveSizes(deviceType, showTMRelationViewer ? '90%' : '500px', showTMRelationViewer ? '90%' : '500px', '95%'), height: showTMRelationViewer ? '95%' : 'auto', title: getTitle(), onClose: onClose, showCloseButton: true, children: _jsxs("div", { onContextMenu: (e) => e.preventDefault(), style: { display: 'flex', flexDirection: 'column', gap: '16px', padding: '16px', width: '100%', height: '100%', boxSizing: 'border-box', overflow: 'hidden' }, children: [showTMRelationViewer ? (_jsx("div", { style: { flex: 1, minHeight: 0, display: 'flex', flexDirection: 'column' }, children: _jsxs(TMSplitterLayout, { direction: 'vertical', showSeparator: true, separatorSize: 8, separatorColor: 'transparent', separatorActiveColor: 'transparent', overflow: 'hidden', min: ["50", "50"], start: ["70%", "30%"], children: [_jsx(TMDownloadRelationViewerSection, { selectedDcmtInfos: selectedDcmtInfos, onSelectionChanged: setSelectedItemsRelationViewer, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }), configSection] }, "TMMergeToPdf-relation-config") })) : (configSection), _jsx("div", { style: { display: 'flex', justifyContent: 'center', alignItems: 'center', flexShrink: 0, marginTop: '12px' }, children: _jsxs("button", { disabled: !isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge, onClick: run, style: {
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                            gap: '6px',
+                            padding: '8px 20px',
+                            fontSize: '0.95rem',
+                            fontWeight: 600,
+                            color: '#fff',
+                            background: (!isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge)
+                                ? '#b0b0b0'
+                                : 'linear-gradient(135deg, #28a745 0%, #218838 100%)',
+                            border: 'none',
+                            borderRadius: '6px',
+                            cursor: (!isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge) ? 'not-allowed' : 'pointer',
+                            boxShadow: (!isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge)
+                                ? 'none'
+                                : '0 2px 8px rgba(40, 167, 69, 0.35)',
+                            transition: 'all 0.2s ease',
+                        }, children: [_jsx(IconPlay, {}), _jsx("span", { children: mergeableSelectedCount === 0
+                                    ? SDKUI_Localizator.MergeToPdf
+                                    : mergeableSelectedCount > 999
+                                        ? _jsx(TMTooltip, { content: mergeableSelectedCount.toString(), children: SDKUI_Localizator.MergeFilesToPdf.replaceParams('999+') })
+                                        : SDKUI_Localizator.MergeFilesToPdf.replaceParams(mergeableSelectedCount.toString()) })] }) })] }) }));
 };
 export default TMMergeToPdfForm;

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

@@ -1,4 +1,3 @@
-import React from "react";
 import { DcmtTypeDescriptor, HomeBlogPost, ObjectRef, TaskDescriptor } from "@topconsultnpm/sdk-ts";
 import { DcmtInfo, IGraphometricManagerProp, TaskContext } from "../../../ts";
 import { IntesiCertificateData } from "../../../helper";
@@ -42,5 +41,5 @@ interface TMMultiMasterDetailDcmtsFormProps {
     }>, tid?: number) => void;
     openWGsCopyMoveForm?: (mode: "copyToWgDraft" | "copyToWgArchivedDoc", dcmtTypeDescriptor: DcmtTypeDescriptor, documents: Array<DcmtInfo>) => void;
 }
-declare const TMMultiMasterDetailDcmtsForm: (props: TMMultiMasterDetailDcmtsFormProps) => React.JSX.Element | null;
+declare const TMMultiMasterDetailDcmtsForm: (props: TMMultiMasterDetailDcmtsFormProps) => import("react/jsx-runtime").JSX.Element | null;
 export default TMMultiMasterDetailDcmtsForm;

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

@@ -6,7 +6,6 @@ import { SearchResultContext } from "../../../ts";
 import { getFullFileExtension, getMultiDetailModalSize, getMultiDetailPanelStates, hasMultiDetailPanelStates, hoverStyle, IconArchive, IconArrowDown, IconArrowUp, IconDelete, IconDuplicate, IconEdit, IconEraser, IconInfo, IconMenuVertical, IconRefresh, IconSearch, IconSearchCheck, saveMultiDetailModalSize, saveMultiDetailPanelStates, SDKUI_Localizator } from "../../../helper";
 import { TMColors } from "../../../utils/theme";
 import { DeviceType, useDeviceType } from "../../base/TMDeviceProvider";
-import { TMLayoutWaitingContainer } from "../../base/TMWaitPanel";
 import TMModal from "../../base/TMModal";
 import TMDataGrid from "../../base/TMDataGrid";
 import TMTooltip from "../../base/TMTooltip";
@@ -48,7 +47,7 @@ const styles = {
 const MOBILE_SECTION = 'archiveList';
 const TMMultiMasterDetailDcmtsForm = (props) => {
     const { dtd, masterDcmt, onClose, canNavigateMaster, onNavigateMaster, allTasks, getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, showDcmtFormSidebar, showTodoDcmtForm, openFileUploaderPdfEditor, graphometricManager, editPdfForm, openS4TViewer, showToppyDraggableHelpCenter, toppyHelpCenterUsePortal, fetchRemoteCertificates, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onReferenceClick, onTaskCreateRequest, onRefreshAfterAddDcmtToFavs, onFileOpened, passToArchiveCallback, openWGsCopyMoveForm } = props;
-    const { isLoading, isSummaryReady, phase, setPhase, detailRelationItems, selectedRelation, selectedItem, hasMultipleTypes, selectRelation, backToTypeSelection, isBackLocked, closeModal, isMasterNavigationEnabled, canNavigateMasterPrev, canNavigateMasterNext, navigateMaster, sectionsOpen, setSectionOpen, openAllSections, clearLayout, layoutResetToken, hasSavedLayout, setHasSavedLayout, canUpdateMaster, masterFieldsCount, getMasterMetadataAsync, masterInfoReloadToken, isOpenMasterForm, setIsOpenMasterForm, handleMasterSavedAsync, archivedDetailResults, archivedDetailsCount, isLoadingArchivedDetails, refreshArchivedDetailsAsync, detailColumns, detailSupportsFile, archiveRows, currentRows, focusedRowKey, setFocusedRowKey, selectedRowKeys, setSelectedRowKeys, isOpenAddForm, editingRowId, editingRow, formInputMids, openAddForm, openEditForm, closeAddForm, deleteRow, duplicateRow, upsertRow, updateRowValues, copyArchivedDetailToRows, stopOnFirstError, setStopOnFirstError, isArchiving, archiveAllAsync, waitPanel, abortController, } = useMultiMasterDetailDcmts({ dtd, masterDcmt, onClose, canNavigateMaster, onNavigateMaster });
+    const { isLoading, isSummaryReady, phase, setPhase, detailRelationItems, selectedRelation, selectedItem, hasMultipleTypes, selectRelation, backToTypeSelection, isBackLocked, closeModal, isMasterNavigationEnabled, canNavigateMasterPrev, canNavigateMasterNext, navigateMaster, sectionsOpen, setSectionOpen, openAllSections, clearLayout, layoutResetToken, hasSavedLayout, setHasSavedLayout, canUpdateMaster, masterFieldsCount, getMasterMetadataAsync, masterInfoReloadToken, isOpenMasterForm, setIsOpenMasterForm, handleMasterSavedAsync, archivedDetailResults, archivedDetailsCount, isLoadingArchivedDetails, refreshArchivedDetailsAsync, detailColumns, detailSupportsFile, archiveRows, currentRows, focusedRowKey, setFocusedRowKey, selectedRowKeys, setSelectedRowKeys, isOpenAddForm, editingRowId, editingRow, formInputMids, openAddForm, openEditForm, closeAddForm, deleteRow, duplicateRow, upsertRow, updateRowValues, copyArchivedDetailToRows, stopOnFirstError, setStopOnFirstError, isArchiving, archiveAllAsync, } = useMultiMasterDetailDcmts({ dtd, masterDcmt, onClose, canNavigateMaster, onNavigateMaster });
     const deviceType = useDeviceType();
     // Su mobile il panel manager mostra un pannello alla volta: le sezioni si raggiungono dalla sua barra
     const isMobile = useMemo(() => deviceType === DeviceType.MOBILE, [deviceType]);
@@ -301,19 +300,19 @@ const TMMultiMasterDetailDcmtsForm = (props) => {
     // ----- Render principale --------------------------------------------------------------------
     if (isLoading)
         return null;
-    return _jsxs(_Fragment, { children: [_jsx("div", { style: { width: 0, height: 0 }, children: _jsx(TMLayoutWaitingContainer, { direction: 'vertical', ...waitPanel, isCancelable: true, abortController: abortController, usePortal: true, children: _jsx(TMModal, { width: modalSize.width, height: modalSize.height, onClose: closeModal, onResized: persistModalSize, sizeResetToken: layoutResetToken, title: modalTitle, hidePopup: false, askClosingConfirm: archiveRows.length > 0, recenterOnResize: true, titleActions: renderTitleActions(), children: _jsxs("div", { style: styles.content, children: [hasMultipleTypes && _jsx("div", { style: styles.header, children: renderStepper({
-                                        steps,
-                                        phase,
-                                        hasMultipleTypes,
-                                        isBackLocked,
-                                        showBackArrow: isSummaryPhase,
-                                        onBack: backToTypeSelection,
-                                        onStepClick: (stepPhase) => (stepPhase === MultiDetailArchivePhase.SelectDcmtType ? backToTypeSelection() : setPhase(stepPhase)),
-                                    }) }), !isSummaryPhase
-                                    ? renderSelectDcmtType({ detailRelationItems, selectedRelation, onSelectRelation: selectRelation })
-                                    : (isSummaryReady
-                                        ? renderArchiveSummary()
-                                        : _jsx("div", { style: styles.loader, children: _jsx(LoadIndicator, { height: 40, width: 40 }) }))] }) }) }) }), isOpenAddForm && selectedRelation?.detailTID && (_jsx(TMDcmtForm, { isModal: true, titleModal: getDtdDisplayName(selectedItem?.detailDtd), TID: selectedRelation.detailTID, layoutMode: LayoutModes.Ark, showBackButton: false, allowButtonsRefs: false, inputMids: formInputMids, inputFile: editingRow?.__file ?? null, archiveListMode: {
+    return _jsxs(_Fragment, { children: [_jsx("div", { style: { width: 0, height: 0 }, children: _jsx(TMModal, { width: modalSize.width, height: modalSize.height, onClose: closeModal, onResized: persistModalSize, sizeResetToken: layoutResetToken, title: modalTitle, hidePopup: false, askClosingConfirm: archiveRows.length > 0, recenterOnResize: true, titleActions: renderTitleActions(), children: _jsxs("div", { style: styles.content, children: [hasMultipleTypes && _jsx("div", { style: styles.header, children: renderStepper({
+                                    steps,
+                                    phase,
+                                    hasMultipleTypes,
+                                    isBackLocked,
+                                    showBackArrow: isSummaryPhase,
+                                    onBack: backToTypeSelection,
+                                    onStepClick: (stepPhase) => (stepPhase === MultiDetailArchivePhase.SelectDcmtType ? backToTypeSelection() : setPhase(stepPhase)),
+                                }) }), !isSummaryPhase
+                                ? renderSelectDcmtType({ detailRelationItems, selectedRelation, onSelectRelation: selectRelation })
+                                : (isSummaryReady
+                                    ? renderArchiveSummary()
+                                    : _jsx("div", { style: styles.loader, children: _jsx(LoadIndicator, { height: 40, width: 40 }) }))] }) }) }), isOpenAddForm && selectedRelation?.detailTID && (_jsx(TMDcmtForm, { isModal: true, titleModal: getDtdDisplayName(selectedItem?.detailDtd), TID: selectedRelation.detailTID, layoutMode: LayoutModes.Ark, showBackButton: false, allowButtonsRefs: false, inputMids: formInputMids, inputFile: editingRow?.__file ?? null, archiveListMode: {
                     isEditingRow: editingRowId !== undefined,
                     onUpsertRow: (values, file) => upsertRow(values, file),
                 }, onClose: closeAddForm, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, showDcmtFormSidebar: showDcmtFormSidebar, showTodoDcmtForm: showTodoDcmtForm, openFileUploaderPdfEditor: openFileUploaderPdfEditor, graphometricManager: graphometricManager })), isOpenMasterForm && masterDcmt?.TID !== undefined && masterDcmt?.DID !== undefined && (_jsx(TMDcmtForm, { isModal: true, titleModal: `${SDKUI_Localizator.Update}: ${getDtdDisplayName(dtd)}`, TID: masterDcmt.TID, DID: masterDcmt.DID, layoutMode: LayoutModes.Update, showBackButton: false, allowRelations: false, allowButtonsRefs: false, onSavedAsyncCallback: handleMasterSavedAsync, onClose: () => setIsOpenMasterForm(false), allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, onTaskCreateRequest: onTaskCreateRequest, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, showDcmtFormSidebar: showDcmtFormSidebar, showTodoDcmtForm: showTodoDcmtForm, openFileUploaderPdfEditor: openFileUploaderPdfEditor, graphometricManager: graphometricManager, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, fetchRemoteCertificates: fetchRemoteCertificates, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onReferenceClick: onReferenceClick }))] });

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

@@ -87,7 +87,7 @@ export declare const toGridNumber: (value: unknown) => number | undefined;
  * si rilegge nel form, si mostra in griglia e si archivia come una riga compilata a mano
  */
 export declare const toArchiveRowValue: (value: MetadataScalarValue, dataType: MetadataDataTypes | undefined) => string;
-/** Colonne della griglia di riepilogo dai metadati (utente) del tipo documento */
+/** Colonne della griglia di riepilogo dai metadati (utente) del tipo documento, esclusi quelli che l'utente non può vedere */
 export declare const buildColumnsFromDtd: (dtd: DcmtTypeDescriptor | undefined, renderDataListCell: (value: string | Date | number | undefined, dataListID: number, viewMode: DataListViewModes) => React.ReactElement) => Array<IColumnProps>;
 export declare const getDetailDtdAsync: (detailTID: number | undefined) => Promise<DcmtTypeDescriptor | undefined>;
 /** Nome visualizzato del tipo documento (localizzato se richiesto) */
@@ -312,7 +312,7 @@ export interface RenderStepperParams {
     /** Click su uno step completato: riceve la fase di destinazione */
     onStepClick: (phase: number) => void;
 }
-export declare const renderStepper: ({ steps, phase, hasMultipleTypes, isBackLocked, showBackArrow, onBack, onStepClick }: RenderStepperParams) => React.JSX.Element;
+export declare const renderStepper: ({ steps, phase, hasMultipleTypes, isBackLocked, showBackArrow, onBack, onStepClick }: RenderStepperParams) => import("react/jsx-runtime").JSX.Element;
 export interface RenderSelectDcmtTypeParams {
     /** Relazioni di dettaglio fra cui scegliere */
     detailRelationItems: Array<DetailRelationItem>;
@@ -321,7 +321,7 @@ export interface RenderSelectDcmtTypeParams {
     /** Selezione di una relazione */
     onSelectRelation: (item: DetailRelationItem) => void;
 }
-export declare const renderSelectDcmtType: ({ detailRelationItems, selectedRelation, onSelectRelation }: RenderSelectDcmtTypeParams) => React.JSX.Element;
+export declare const renderSelectDcmtType: ({ detailRelationItems, selectedRelation, onSelectRelation }: RenderSelectDcmtTypeParams) => import("react/jsx-runtime").JSX.Element;
 export interface RenderAccordionHeaderParams {
     /** Sezione a cui appartiene la testata */
     section: AccordionSection;
@@ -340,7 +340,7 @@ export interface RenderAccordionHeaderParams {
     /** Apre/chiude la sezione */
     onToggleOpen: (section: AccordionSection, isOpen: boolean) => void;
 }
-export declare const renderAccordionHeader: ({ section, isOpen, tooltip, count, title, actions, panel, onToggleOpen }: RenderAccordionHeaderParams) => React.JSX.Element;
+export declare const renderAccordionHeader: ({ section, isOpen, tooltip, count, title, actions, panel, onToggleOpen }: RenderAccordionHeaderParams) => import("react/jsx-runtime").JSX.Element;
 /**
  * Contenuto di un pannello: il contesto del panel manager è leggibile solo dentro l'albero del
  * provider, quindi è qui che si prende lo stato di ingrandimento da passare alla sezione
@@ -349,7 +349,7 @@ export declare const TMSummarySectionSlot: ({ section, render, onBeforeMaximize
     section: AccordionSection;
     render: (panel: SectionPanelState) => React.ReactNode;
     onBeforeMaximize?: (section: AccordionSection) => void;
-}) => React.JSX.Element;
+}) => import("react/jsx-runtime").JSX.Element;
 /**
  * Segnala che l'utente ha spostato un separatore: è l'unico caso in cui le altezze dei pannelli sono
  * una sua scelta, quindi la sola da salvare. Le quote calcolate all'apertura del riepilogo o al

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

@@ -2,7 +2,7 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import React, { useEffect, useRef } from 'react';
 import { AccessLevelsEx, DataListViewModes, DcmtTypeListCacheService, MetadataDataDomains, MetadataDataTypes, SDK_Globals } from '@topconsultnpm/sdk-ts';
 import { hoverStyle, IconChevronRight, IconWindowMaximize, IconWindowMinimize, SDKUI_Localizator } from '../../../helper';
-import { formatScalarValue, getUserMetadataSorted } from '../../../helper/dcmtsHelper';
+import { canViewMetadata, formatScalarValue, getUserMetadataSorted } from '../../../helper/dcmtsHelper';
 import { TMColors } from '../../../utils/theme';
 import { TMDcmtTypeIcon } from '../../viewers/TMTidViewer';
 import TMTooltip from '../../base/TMTooltip';
@@ -71,8 +71,8 @@ export const toArchiveRowValue = (value, dataType) => {
     }
     return String(value);
 };
-/** Colonne della griglia di riepilogo dai metadati (utente) del tipo documento */
-export const buildColumnsFromDtd = (dtd, renderDataListCell) => getUserMetadataSorted(dtd).map(md => {
+/** Colonne della griglia di riepilogo dai metadati (utente) del tipo documento, esclusi quelli che l'utente non può vedere */
+export const buildColumnsFromDtd = (dtd, renderDataListCell) => getUserMetadataSorted(dtd).filter(canViewMetadata).map(md => {
     const dataListID = md.dataListID ?? 0;
     const isDataList = md.dataDomain === MetadataDataDomains.DataList && dataListID > 0;
     const viewMode = md.dataListViewMode ?? DataListViewModes.None;

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

@@ -1,8 +1,9 @@
 import React from 'react';
 import { DcmtTypeDescriptor, SearchResultDescriptor, DataColumnDescriptor } from "@topconsultnpm/sdk-ts";
 import { DcmtMetadataMap } from '../../../helper';
-import { DcmtInfo, MetadataValueDescriptorEx } from '../../../ts';
+import { DcmtInfo } from '../../../ts';
 import { ITMTreeItem } from '../../base/TMTreeView';
+import { RelationTreeState } from './relationTreeState';
 /**
  * Tree item structure for relations
  */
@@ -26,6 +27,7 @@ export interface RelationTreeItem extends ITMTreeItem {
     fileExt?: string;
     fileCount?: number;
 }
+export type { RelationTreeState } from './relationTreeState';
 /**
  * Props for TMRelationViewer component
  */
@@ -111,11 +113,6 @@ export interface TMRelationViewerProps {
      * Use to show a context menu.
      */
     onItemContextMenu?: (item: RelationTreeItem, e: React.MouseEvent) => void;
-    /**
-     * Metadata values for the focused item
-     * (used in master-detail context)
-     */
-    focusedItemFormData?: MetadataValueDescriptorEx[];
     /**
      * If true, shows a toolbar button to expand/collapse all tree nodes.
      * Default: false
@@ -132,11 +129,6 @@ export interface TMRelationViewerProps {
      * Useful to disable interactions (like context menu) during loading.
      */
     onLoadingStateChanged?: (isLoading: boolean) => void;
-    /**
-     * Invoked while the initial correlations load progresses, with how many input
-     * documents have been processed out of the total.
-     */
-    onLoadingProgress?: (value: number, max: number) => void;
     /**
      * Invoked on mount to hand over a function that stops the ongoing correlations
      * calculation: no further GetMetadata calls are performed and only the
@@ -151,6 +143,14 @@ export interface TMRelationViewerProps {
      * Riceve quanti documenti di input sono stati completati sul totale.
      */
     onCalculationStopped?: (loadedCount: number, totalCount: number) => void;
+    /**
+     * Stato dell'albero da ripristinare al primo caricamento, al posto dell'espansione
+     * iniziale predefinita: permette al padre di rimontare il viewer dopo un'operazione
+     * senza che l'albero torni allo stato di partenza. Se assente vale il default.
+     */
+    initialTreeState?: RelationTreeState;
+    /** Notifica lo stato dell'albero, da restituire come `initialTreeState` dopo un refresh. */
+    onTreeStateChange?: (state: RelationTreeState) => void;
 }
 /**
  * Check if document type has detail relations
@@ -166,10 +166,9 @@ export declare const hasMasterRelations: (dTID: number | undefined) => Promise<b
 export declare const getDisplayValueByColumn: (col: DataColumnDescriptor | undefined, value: any) => any;
 /**
  * Convert SearchResultDescriptor to structured data source with metadata
- * I valori dei documenti sono GIÀ presenti nelle righe restituite dalla ricerca:
+ * I valori dei documenti sono già presenti nelle righe restituite dalla ricerca:
  * qui vengono solo abbinati ai rispettivi MetadataDescriptor (perm,
- * isSpecialSearchOutput, ...), risolti UNA SOLA VOLTA per tipo documento.
- * Nessuna chiamata al server per riga.
+ * isSpecialSearchOutput, ...), risolti una sola volta per tipo documento.
  */
 export declare const searchResultToDataSource: (searchResult: SearchResultDescriptor | undefined, hideSysMetadata?: boolean, signal?: AbortSignal) => Promise<any[]>;
 export declare const DEFAULT_RELATION_EXPAND_LEVEL = 4;