@topconsultnpm/sdkui-react 6.22.0-dev3.2 → 6.22.0-dev3.21

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

@@ -1,3 +1,4 @@
+import React from "react";
 import { FormModes, TaskContext } from "../../../ts";
 import { HomeBlogPost, TaskDescriptor } from "@topconsultnpm/sdk-ts";
 interface TMDcmtTasksProps {
@@ -12,5 +13,5 @@ interface TMDcmtTasksProps {
     handleNavigateToDossiers?: (value: HomeBlogPost | number) => Promise<void>;
     onBack?: () => void;
 }
-declare const TMDcmtTasks: (props: TMDcmtTasksProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMDcmtTasks: (props: TMDcmtTasksProps) => React.JSX.Element;
 export default TMDcmtTasks;

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

@@ -2,5 +2,5 @@ interface TMDragDropOverlayProps {
     handleFile: (file: File) => void;
     refocusAfterFileInput: () => void;
 }
-declare const TMDragDropOverlay: (props: TMDragDropOverlayProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMDragDropOverlay: (props: TMDragDropOverlayProps) => import("react").JSX.Element;
 export default TMDragDropOverlay;

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

@@ -29,6 +29,7 @@ const TMFileUploader = ({ fromDTD, deviceType = DeviceType.DESKTOP, onClose, onF
     const [fileSize, setFileSize] = useState(undefined);
     const [fileExt, setFileExt] = useState(undefined);
     const uploaderRef = useRef(null);
+    const fileInputRef = useRef(null);
     // Ref al TMPanel per chiamare focusPanel()
     const fileUploaderPanelRef = useRef(null);
     usePreventFileDrop([uploaderRef]);
@@ -85,19 +86,18 @@ const TMFileUploader = ({ fromDTD, deviceType = DeviceType.DESKTOP, onClose, onF
         setFileSize(undefined);
         setFileExt(undefined);
         onFileUpload?.(null);
-        const fileInput = document.getElementById('fileInput');
-        if (fileInput) {
-            fileInput.value = '';
+        if (fileInputRef.current) {
+            fileInputRef.current.value = '';
         }
         //Rifocalizza dopo la cancellazione del file
         if (refocus)
             refocusAfterFileInput();
     }, [onFileUpload, refocusAfterFileInput]);
     const browseHandler = useCallback(() => {
-        document.getElementById('fileInput')?.click();
+        fileInputRef.current?.click();
     }, []);
     let content = !uploadedFile ?
-        _jsxs("div", { style: { display: 'flex', gap: 10, width: '100%', height: '100%' }, children: [_jsx(HiddenInput, { id: "fileInput", type: "file", onChange: handleInputChange }), _jsxs(UploadContainer, { ref: uploaderRef, tabIndex: 0, onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, style: { backgroundColor: dragOver ? '#76b1e6' : 'white' }, onDoubleClick: browseHandler, $isRequired: isRequired, children: [_jsxs("div", { style: { display: 'flex', gap: '10px', flexDirection: 'column', position: 'absolute', right: 5, top: 5 }, children: [_jsx(TMButton, { btnStyle: 'icon', caption: 'Sfoglia', color: isRequired && !uploadedFile ? 'error' : 'primary', onClick: browseHandler, icon: _jsx(IconFolderOpen, { fontSize: 22 }) }), showScannerIcon && isScannerLicenseConfigured() && onScanRequest && _jsx(TMButton, { btnStyle: 'icon', caption: 'Scanner', color: 'primary', onClick: () => { onScanRequest((file) => { onFileUpload?.(file); }); }, icon: _jsx(IconScanner, { fontSize: 22 }) }), showScannerIcon && isScannerLicenseConfigured() && !onScanRequest && _jsx(TMButton, { btnStyle: 'icon', caption: 'Scanner', color: 'primary', onClick: () => { ShowAlert({ message: SDKUI_Localizator.ScanFeatureUnavailableInThisContext, mode: 'info', duration: 3000, title: 'Scanner' }); }, icon: _jsx(IconScanner, { fontSize: 22 }) })] }), _jsx("p", { style: { fontSize: '1.2rem', fontWeight: 'bold' }, children: deviceType === DeviceType.MOBILE ? SDKUI_Localizator.ClickToBrowseFile : SDKUI_Localizator.DragOrDoubleClickToBrowseFile }), isRequired && _jsxs("p", { style: { fontWeight: 'bold' }, children: [" ", SDKUI_Localizator.RequiredField, " "] })] })] }) :
+        _jsxs("div", { style: { display: 'flex', gap: 10, width: '100%', height: '100%' }, children: [_jsx(HiddenInput, { ref: fileInputRef, type: "file", onChange: handleInputChange }), _jsxs(UploadContainer, { ref: uploaderRef, tabIndex: 0, onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, style: { backgroundColor: dragOver ? '#76b1e6' : 'white' }, onDoubleClick: browseHandler, $isRequired: isRequired, children: [_jsxs("div", { style: { display: 'flex', gap: '10px', flexDirection: 'column', position: 'absolute', right: 5, top: 5 }, children: [_jsx(TMButton, { btnStyle: 'icon', caption: 'Sfoglia', color: isRequired && !uploadedFile ? 'error' : 'primary', onClick: browseHandler, icon: _jsx(IconFolderOpen, { fontSize: 22 }) }), showScannerIcon && isScannerLicenseConfigured() && onScanRequest && _jsx(TMButton, { btnStyle: 'icon', caption: 'Scanner', color: 'primary', onClick: () => { onScanRequest((file) => { onFileUpload?.(file); }); }, icon: _jsx(IconScanner, { fontSize: 22 }) }), showScannerIcon && isScannerLicenseConfigured() && !onScanRequest && _jsx(TMButton, { btnStyle: 'icon', caption: 'Scanner', color: 'primary', onClick: () => { ShowAlert({ message: SDKUI_Localizator.ScanFeatureUnavailableInThisContext, mode: 'info', duration: 3000, title: 'Scanner' }); }, icon: _jsx(IconScanner, { fontSize: 22 }) })] }), _jsx("p", { style: { fontSize: '1.2rem', fontWeight: 'bold' }, children: deviceType === DeviceType.MOBILE ? SDKUI_Localizator.ClickToBrowseFile : SDKUI_Localizator.DragOrDoubleClickToBrowseFile }), isRequired && _jsxs("p", { style: { fontWeight: 'bold' }, children: [" ", SDKUI_Localizator.RequiredField, " "] })] })] }) :
         _jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 10, width: '100%', height: '100%' }, children: [_jsxs("div", { style: { backgroundColor: 'white', padding: '5px 10px', borderRadius: 8, display: 'flex', alignItems: 'center', justifyContent: 'space-between', color: TMColors.primaryColor }, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 5 }, children: [_jsx("p", { children: "File name:" }), _jsxs("div", { style: { fontWeight: 'bold' }, children: [fileName, " ", _jsxs("span", { children: [" ", ` (${formatBytes(fileSize)})`, " "] })] })] }), uploadedFile && _jsx(TMButton, { btnStyle: 'icon', color: 'error', caption: 'Pulisci', onClick: () => clearFile(true), icon: _jsx(IconClear, { fontSize: 22 }) })] }), extensionHandler(fileExt) === FileExtensionHandler.READY_TO_SHOW ? _jsx(TMFileViewer, { fileBlob: uploadedFile, isResizingActive: isResizingActive }) :
                     _jsx("div", { style: { backgroundColor: '#f6dbdb', padding: '5px 10px', borderRadius: 8, display: 'flex', alignItems: 'center', justifyContent: 'space-between', color: TMColors.error }, children: _jsxs("div", { children: [" ", SDKUI_Localizator.PreviewNotAvailable, fileExt && _jsx("b", { children: ` (*.${fileExt})` })] }) })] });
     const innerContent = (_jsxs("div", { style: { width: '100%', height: '100%', padding: '2px', display: 'flex', flexDirection: 'column', gap: 10 }, children: [enableDragDropOverlay && _jsx(TMDragDropOverlay, { handleFile: handleFile, refocusAfterFileInput: refocusAfterFileInput }), content] }));
@@ -112,27 +112,27 @@ const TMFileUploader = ({ fromDTD, deviceType = DeviceType.DESKTOP, onClose, onF
     }, [deviceType, fromDTD, onClose]);
     return showTMPanel ? (_jsx(TMPanel, { ref: fileUploaderPanelRef, panelID: 'file-uploader-panel', title: SDKUI_Localizator.FileUpload, onBack: deviceType === DeviceType.MOBILE ? () => onClose?.() : undefined, toolbar: toolbar, children: innerContent })) : (innerContent);
 };
-const UploadContainer = styled.div ` 
-position: relative;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  flex-direction: column;
-  gap: 5px;
-  border: 2px dashed ${props => props.$isRequired ? () => TMColors.error : () => TMColors.primaryColor};
-  /* max-height: 100px; */
-  width: 100%;
-  height: 100%;
-  border-radius: 8px;
-  padding: 30px;
-  text-align: center;
-  color: ${props => props.$isRequired ? () => TMColors.error : () => TMColors.primaryColor};
-  transition: background-color 0.3s;
-  &:hover {
-    background-color: #658cab;
-  } 
+const UploadContainer = styled.div ` 
+position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-direction: column;
+  gap: 5px;
+  border: 2px dashed ${props => props.$isRequired ? () => TMColors.error : () => TMColors.primaryColor};
+  /* max-height: 100px; */
+  width: 100%;
+  height: 100%;
+  border-radius: 8px;
+  padding: 30px;
+  text-align: center;
+  color: ${props => props.$isRequired ? () => TMColors.error : () => TMColors.primaryColor};
+  transition: background-color 0.3s;
+  &:hover {
+    background-color: #658cab;
+  } 
 `;
-const HiddenInput = styled.input `
-  display: none;
+const HiddenInput = styled.input `
+  display: none;
 `;
 export default TMFileUploader;

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

@@ -45,6 +45,13 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
     const [refreshKey, setRefreshKey] = useState(0);
     // Separate refresh key for TMFormOrResultWrapper only (doesn't affect tmTreeView)
     const [refreshKeyFormOrResult, setRefreshKeyFormOrResult] = useState(0);
+    // Stato dell'albero conservato qui perché il bump di refreshKey rimonta TMRelationViewer:
+    // una ref interna al viewer non sopravvivrebbe. Riletto dal useMemo di tmTreeView,
+    // che si ricalcola proprio al refresh.
+    const treeStateRef = useRef(undefined);
+    const handleTreeStateChange = useCallback((state) => {
+        treeStateRef.current = state;
+    }, []);
     /** State for transformed focusedItem metadata values (similar to formData in TMDcmtForm) */
     const [focusedItemFormData, setFocusedItemFormData] = useState([]);
     // Trigger operationItems refresh (after file substitution, etc.)
@@ -90,12 +97,19 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
         setIsCheckingFirstLoad(false);
         handleBack();
     }, [handleBack]);
+    // Avanzamento del calcolo correlazioni, mostrato nell'overlay di primo caricamento
+    const [relationsProgress, setRelationsProgress] = useState({ value: 0, max: 0 });
+    const handleRelationsProgress = useCallback((value, max) => {
+        setRelationsProgress({ value, max });
+    }, []);
     // Notifica all'utente che i dati mostrati sono parziali (non quando si sta uscendo)
-    const handleRelationsCalculationStopped = useCallback(() => {
+    const handleRelationsCalculationStopped = useCallback((loadedCount, totalCount) => {
         if (isLeavingRef.current)
             return;
+        // Con piu' documenti in input, indica quanti sono stati completati (es. "3/10")
+        const progress = totalCount > 1 ? ` (${loadedCount}/${totalCount})` : '';
         ShowAlert({
-            message: SDKUI_Localizator.RelationsCalculationStopped,
+            message: `${SDKUI_Localizator.RelationsCalculationStopped}${progress}`,
             title: SDKUI_Localizator.Attention,
             duration: 4000,
             mode: 'info',
@@ -379,11 +393,11 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
                         setContextMenuVisible(true);
                     }, children: [_jsx(TMRelationViewerWrapper, { refreshKey: refreshKey, inputDcmts: inputDcmts, isForMaster: isForMaster, showCurrentDcmtIndicator: showCurrentDcmtIndicator, showZeroDcmts: showZeroDcmts, 
                             // customItemRender={customItemRender}
-                            allowMultipleSelection: allowMultipleSelection, focusedItem: focusedItem, selectedItems: selectedItems, onFocusedItemChanged: handleFocusedItemChanged, onSelectedItemsChanged: handleSelectedItemsChanged, onNoRelationsFound: handleNoRelationsFound, onItemContextMenu: isRelationViewerLoading ? undefined : onItemContextMenu, focusedItemFormData: focusedItemFormData, onLoadingStateChanged: setIsRelationViewerLoading, onStopCalculationReady: handleStopCalculationReady, onCalculationStopped: handleRelationsCalculationStopped }), _jsx(TMContextMenu, { items: operationItems, externalControl: {
+                            allowMultipleSelection: allowMultipleSelection, focusedItem: focusedItem, selectedItems: selectedItems, onFocusedItemChanged: handleFocusedItemChanged, onSelectedItemsChanged: handleSelectedItemsChanged, onNoRelationsFound: handleNoRelationsFound, onItemContextMenu: isRelationViewerLoading ? undefined : onItemContextMenu, focusedItemFormData: focusedItemFormData, onLoadingStateChanged: setIsRelationViewerLoading, onLoadingProgress: handleRelationsProgress, onStopCalculationReady: handleStopCalculationReady, onCalculationStopped: handleRelationsCalculationStopped, initialTreeState: treeStateRef.current, onTreeStateChange: handleTreeStateChange }), _jsx(TMContextMenu, { items: operationItems, externalControl: {
                                 visible: contextMenuVisible,
                                 position: contextMenuPosition,
                                 onClose: () => setContextMenuVisible(false)
-                            } })] }) }), [inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, allowMultipleSelection, focusedItem, selectedItems, handleFocusedItemChanged, handleSelectedItemsChanged, handleNoRelationsFound, onItemContextMenu, contextMenuVisible, contextMenuPosition, refreshKey, focusedItemFormData, isRelationViewerLoading, handleStopCalculationReady, handleRelationsCalculationStopped]);
+                            } })] }) }), [inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, allowMultipleSelection, focusedItem, selectedItems, handleFocusedItemChanged, handleSelectedItemsChanged, handleNoRelationsFound, onItemContextMenu, contextMenuVisible, contextMenuPosition, refreshKey, focusedItemFormData, isRelationViewerLoading, handleStopCalculationReady, handleRelationsCalculationStopped, handleTreeStateChange]);
     const tmFormOrResult = useMemo(() => _jsx(TMFormOrResultWrapper, { refreshKey: refreshKeyFormOrResult, deviceType: deviceType, focusedItem: focusedItem, onTaskCreateRequest: onTaskCreateRequest, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, handleNavigateToReference: handleNavigateToReference, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onRefreshSearchResults: onRefreshAllPanels }), [focusedItem, deviceType, allTasks, handleNavigateToWGs, handleNavigateToDossiers, handleNavigateToReference, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onRefreshAfterAddDcmtToFavs, refreshKeyFormOrResult]);
     const initialPanelDimensions = {
         'tmTreeView': { width: '50%', height: '100%' },
@@ -463,7 +477,12 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
             toolbarOptions: { icon: _jsx(IconSearchCheck, { fontSize: 24 }), visible: false, orderNumber: 2, isActive: allInitialPanelVisibility['tmFormOrResult'] }
         }
     ], [tmTreeView, tmFormOrResult, focusedItem?.isDcmt, dtdMaster]);
-    return (_jsxs("div", { style: { width: '100%', height: '100%', position: 'relative' }, children: [isCheckingFirstLoad && (_jsx(TMLoadingOverlay, { onCancel: handleCancelFirstLoad, onStop: handleStopRelationsCalculation })), _jsxs("div", { style: isCheckingFirstLoad ? { position: 'absolute', width: 0, height: 0, overflow: 'hidden', opacity: 0, pointerEvents: 'none' } : { width: '100%', height: '100%' }, children: [_jsx(TMLayoutWaitingContainer, { direction: 'vertical', showWaitPanel: showWaitPanel, showWaitPanelPrimary: showPrimary, showWaitPanelSecondary: showSecondary, waitPanelTitle: waitPanelTitle, waitPanelTextPrimary: waitPanelTextPrimary, waitPanelValuePrimary: waitPanelValuePrimary, waitPanelMaxValuePrimary: waitPanelMaxValuePrimary, waitPanelTextSecondary: waitPanelTextSecondary, waitPanelValueSecondary: waitPanelValueSecondary, waitPanelMaxValueSecondary: waitPanelMaxValueSecondary, isCancelable: true, abortController: abortController, children: _jsx(TMPanelManagerProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: initialPanelDimensions, initialDimensions: initialPanelDimensions, initialMobilePanelId: 'tmTreeView', children: _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", showToolbar: true }) }) }), renderDcmtOperations, renderFloatingBar] })] }));
+    return (_jsxs("div", { style: { width: '100%', height: '100%', position: 'relative' }, children: [isCheckingFirstLoad && (_jsx(TMLoadingOverlay, { onCancel: handleCancelFirstLoad, onStop: handleStopRelationsCalculation, description: relationsProgress.max > 1
+                    ? `${isForMaster ? SDKUI_Localizator.LoadingMasterDocuments : SDKUI_Localizator.LoadingDetailDocuments} (${relationsProgress.value}/${relationsProgress.max})`
+                    : undefined, progressValue: relationsProgress.value, progressMax: relationsProgress.max, 
+                // Con un solo documento in input la chiamata è unica: non ci sono
+                // risultati parziali da mostrare, quindi il pulsante resta disabilitato
+                stopDisabled: (inputDcmts?.length ?? 0) <= 1 })), _jsxs("div", { style: isCheckingFirstLoad ? { position: 'absolute', width: 0, height: 0, overflow: 'hidden', opacity: 0, pointerEvents: 'none' } : { width: '100%', height: '100%' }, children: [_jsx(TMLayoutWaitingContainer, { direction: 'vertical', showWaitPanel: showWaitPanel, showWaitPanelPrimary: showPrimary, showWaitPanelSecondary: showSecondary, waitPanelTitle: waitPanelTitle, waitPanelTextPrimary: waitPanelTextPrimary, waitPanelValuePrimary: waitPanelValuePrimary, waitPanelMaxValuePrimary: waitPanelMaxValuePrimary, waitPanelTextSecondary: waitPanelTextSecondary, waitPanelValueSecondary: waitPanelValueSecondary, waitPanelMaxValueSecondary: waitPanelMaxValueSecondary, isCancelable: true, abortController: abortController, children: _jsx(TMPanelManagerProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: initialPanelDimensions, initialDimensions: initialPanelDimensions, initialMobilePanelId: 'tmTreeView', children: _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", showToolbar: true }) }) }), renderDcmtOperations, renderFloatingBar] })] }));
 };
 export default TMMasterDetailDcmts;
 /**
@@ -472,7 +491,7 @@ export default TMMasterDetailDcmts;
  * - Panel visibility toggling
  * - Focus delay handling
  */
-const TMRelationViewerWrapper = ({ refreshKey, inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, customItemRender, allowMultipleSelection, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onNoRelationsFound, onItemContextMenu, focusedItemFormData, onLoadingStateChanged, onStopCalculationReady, onCalculationStopped }) => {
+const TMRelationViewerWrapper = ({ refreshKey, inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, customItemRender, allowMultipleSelection, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onNoRelationsFound, onItemContextMenu, focusedItemFormData, onLoadingStateChanged, onLoadingProgress, onStopCalculationReady, onCalculationStopped, initialTreeState, onTreeStateChange }) => {
     const { setPanelVisibilityById, setToolbarButtonVisibility } = useTMPanelManagerContext();
     // Monitor device type changes to restore panel visibility when switching from mobile to desktop
     const deviceType = useDeviceType();
@@ -532,7 +551,7 @@ const TMRelationViewerWrapper = ({ refreshKey, inputDcmts, isForMaster, showCurr
             onItemContextMenu?.(item, e);
         }, 100);
     }, [onItemContextMenu, handleFocusedItemChanged]);
-    return (_jsx(TMRelationViewer, { inputDcmts: inputDcmts, isForMaster: isForMaster, showCurrentDcmtIndicator: showCurrentDcmtIndicator, initialShowZeroDcmts: showZeroDcmts, customItemRender: customItemRender, allowMultipleSelection: allowMultipleSelection, focusedItem: focusedItem, selectedItems: selectedItems, onFocusedItemChanged: handleFocusedItemChanged, onSelectedItemsChanged: onSelectedItemsChanged, maxDepthLevel: 1, invertMasterNavigation: false, showExpandAllButton: true, onNoRelationsFound: onNoRelationsFound, onItemContextMenu: onContextMenu, focusedItemFormData: focusedItemFormData, onLoadingStateChanged: onLoadingStateChanged, onStopCalculationReady: onStopCalculationReady, onCalculationStopped: onCalculationStopped }, refreshKey));
+    return (_jsx(TMRelationViewer, { inputDcmts: inputDcmts, isForMaster: isForMaster, showCurrentDcmtIndicator: showCurrentDcmtIndicator, initialShowZeroDcmts: showZeroDcmts, customItemRender: customItemRender, allowMultipleSelection: allowMultipleSelection, focusedItem: focusedItem, selectedItems: selectedItems, onFocusedItemChanged: handleFocusedItemChanged, onSelectedItemsChanged: onSelectedItemsChanged, maxDepthLevel: 1, invertMasterNavigation: false, showExpandAllButton: true, onNoRelationsFound: onNoRelationsFound, onItemContextMenu: onContextMenu, focusedItemFormData: focusedItemFormData, onLoadingStateChanged: onLoadingStateChanged, onLoadingProgress: onLoadingProgress, onStopCalculationReady: onStopCalculationReady, onCalculationStopped: onCalculationStopped, initialTreeState: initialTreeState, onTreeStateChange: onTreeStateChange }, refreshKey));
 };
 const TMFormOrResultWrapper = ({ refreshKey, deviceType, focusedItem, onTaskCreateRequest, allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, onRefreshAfterAddDcmtToFavs, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onRefreshSearchAsyncDatagrid, onRefreshSearchResults, handleNavigateToReference, fetchRemoteCertificates }) => {
     const { setPanelVisibilityById } = useTMPanelManagerContext();
@@ -542,7 +561,11 @@ const TMFormOrResultWrapper = ({ refreshKey, deviceType, focusedItem, onTaskCrea
                 }, fetchRemoteCertificates: fetchRemoteCertificates }, refreshKey) :
             focusedItem?.searchResult === undefined ? (_jsx(TMPanel, { title: SDKUI_Localizator.SearchResult, children: _jsx(TMToppyMessage, { message: SDKUI_Localizator.SelectDocumentToViewSearchResults }) })) : (_jsx(TMSearchResult, { groupId: 'tmFormOrResult', isClosable: deviceType !== DeviceType.MOBILE, context: SearchResultContext.METADATA_SEARCH, allowFloatingBar: false, allowRelations: false, openDcmtFormAsModal: true, searchResults: focusedItem?.searchResult ?? [], showSearchResultSidebar: false, showDcmtFormSidebar: false, autoFocusFirstRow: false, onTaskCreateRequest: onTaskCreateRequest, onClose: () => { setPanelVisibilityById('tmTreeView', true); }, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, editPdfForm: editPdfForm, onOpenPdfEditorRequest: onOpenPdfEditorRequest, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, enablePinIcons: false, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, showBackButton: false, onRefreshSearchAsyncDatagrid: onRefreshSearchResults, onReferenceClick: handleNavigateToReference, fetchRemoteCertificates: fetchRemoteCertificates }, refreshKey)) }));
 };
-const TMLoadingOverlay = ({ onCancel, onStop, description, cancelText, stopText }) => {
+const TMLoadingOverlay = ({ onCancel, onStop, description, cancelText, stopText, progressValue, progressMax, stopDisabled }) => {
+    // Stesso calcolo di TMWaitPanel: 0 quando il massimo non è ancora noto
+    const progressPercent = (progressMax ?? 0) > 0
+        ? Math.min(100, ((progressValue ?? 0) / (progressMax ?? 1)) * 100)
+        : 0;
     return (_jsx("div", { style: {
             position: 'absolute',
             top: 0,
@@ -612,20 +635,24 @@ const TMLoadingOverlay = ({ onCancel, onStop, description, cancelText, stopText
 						.tm-spinner-animation div:nth-child(7):after { top: 63px; left: 17px; background: #782b7d; }
 						.tm-spinner-animation div:nth-child(8) { animation-delay: -0.288s; }
 						.tm-spinner-animation div:nth-child(8):after { top: 56px; left: 12px; background: #782b7d; }
-					` }), _jsxs("div", { className: "tm-spinner-animation", children: [_jsx("div", {}), _jsx("div", {}), _jsx("div", {}), _jsx("div", {}), _jsx("div", {}), _jsx("div", {}), _jsx("div", {}), _jsx("div", {})] })] }), _jsx("span", { style: { fontSize: '14px', color: '#334155', textAlign: 'center' }, children: description ?? SDKUI_Localizator.Loading }), (onStop || onCancel) && (_jsxs("div", { style: { marginTop: '4px', display: 'flex', alignItems: 'center', justifyContent: 'center', flexWrap: 'wrap', gap: '10px' }, children: [onStop && (_jsx("button", { onClick: onStop, title: SDKUI_Localizator.StopRelationsCalculation, style: {
+					` }), _jsxs("div", { className: "tm-spinner-animation", children: [_jsx("div", {}), _jsx("div", {}), _jsx("div", {}), _jsx("div", {}), _jsx("div", {}), _jsx("div", {}), _jsx("div", {}), _jsx("div", {})] })] }), _jsx("span", { style: { fontSize: '14px', color: '#334155', textAlign: 'center' }, children: description ?? SDKUI_Localizator.Loading }), (progressMax ?? 0) > 1 && (_jsxs("div", { style: { width: '260px' }, children: [_jsx("div", { style: { width: '100%', height: '20px', background: '#e0e0e0', borderRadius: '10px', overflow: 'hidden' }, children: _jsx("div", { style: { width: `${progressPercent.toFixed(2)}%`, height: '100%', background: '#4caf50', transition: 'width 0.3s ease' } }) }), _jsxs("p", { style: { fontWeight: 'bold', color: '#333', margin: '8px 0 0', textAlign: 'center' }, children: [progressPercent.toFixed(2), "%"] })] })), (onStop || onCancel) && (_jsxs("div", { style: { marginTop: '4px', display: 'flex', alignItems: 'center', justifyContent: 'center', flexWrap: 'wrap', gap: '10px' }, children: [onStop && (_jsx("button", { onClick: onStop, disabled: stopDisabled, title: SDKUI_Localizator.StopRelationsCalculation, style: {
                                 padding: '8px 24px',
                                 fontSize: '13px',
                                 fontWeight: 500,
-                                color: 'white',
-                                background: '#0c448e',
-                                border: '1.5px solid #0c448e',
+                                color: stopDisabled ? '#94a3b8' : 'white',
+                                background: stopDisabled ? '#e2e8f0' : '#0c448e',
+                                border: `1.5px solid ${stopDisabled ? '#e2e8f0' : '#0c448e'}`,
                                 borderRadius: '6px',
-                                cursor: 'pointer',
+                                cursor: stopDisabled ? 'not-allowed' : 'pointer',
                                 transition: 'all 0.2s ease',
                             }, onMouseEnter: (e) => {
+                                if (stopDisabled)
+                                    return;
                                 e.currentTarget.style.background = '#0a3872';
                                 e.currentTarget.style.borderColor = '#0a3872';
                             }, onMouseLeave: (e) => {
+                                if (stopDisabled)
+                                    return;
                                 e.currentTarget.style.background = '#0c448e';
                                 e.currentTarget.style.borderColor = '#0c448e';
                             }, children: stopText ?? SDKUI_Localizator.ShowPartialResults })), onCancel && (_jsx("button", { onClick: onCancel, style: {

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import { DcmtTypeDescriptor } from '@topconsultnpm/sdk-ts';
 import { DcmtInfo } from '../../../ts';
 interface TMMasterInfoFieldsProps {
@@ -15,5 +16,5 @@ interface TMMasterInfoFieldsProps {
      */
     isExpandedView?: boolean;
 }
-declare const TMMasterInfoFields: ({ dtd, dcmt, getValuesByMidAsync, reloadToken, isExpandedView }: TMMasterInfoFieldsProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMMasterInfoFields: ({ dtd, dcmt, getValuesByMidAsync, reloadToken, isExpandedView }: TMMasterInfoFieldsProps) => React.JSX.Element;
 export default TMMasterInfoFields;

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import { DcmtInfo } from '../../../ts';
 import { HomeBlogPost, TaskDescriptor } from '@topconsultnpm/sdk-ts';
 import { TMCopyToFolderMode } from '../../../hooks/useDocumentOperations';
@@ -19,5 +20,5 @@ interface ITMMergeToPdfFormProps {
  * Form per l'unione di più documenti PDF in un singolo file.
  * Condivide TMDownloadRelationViewerSection e gli helper in copyAndMergeDcmtsShared con TMCopyToFolderForm.
  */
-declare const TMMergeToPdfForm: (props: ITMMergeToPdfFormProps) => import("react/jsx-runtime").JSX.Element;
+declare const TMMergeToPdfForm: (props: ITMMergeToPdfFormProps) => React.JSX.Element;
 export default TMMergeToPdfForm;

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

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useRef, useState } from 'react';
 import { DownloadTypes } from '../../../ts';
 import { calcResponsiveSizes, getExceptionMessage, IconFolderOpen, IconPlay, IconUndo, SDKUI_Globals, SDKUI_Localizator, } from '../../../helper';
-import { DcmtOpers, FileFormats, GeneralRetrieveFormats, InvoiceRetrieveFormats, OrderRetrieveFormats, ResultTypes, RetrieveFileOptions, ValidationItem, } from '@topconsultnpm/sdk-ts';
+import { DcmtOpers, FileFormats, GeneralRetrieveFormats, InvoiceRetrieveFormats, OrderRetrieveFormats, ResultTypes, ValidationItem, } from '@topconsultnpm/sdk-ts';
 import TMModal from '../../base/TMModal';
 import { useDeviceType } from '../../base/TMDeviceProvider';
 import TMTextBox from '../../editors/TMTextBox';
@@ -190,12 +190,13 @@ const TMMergeToPdfForm = (props) => {
         }
         // Per i documenti con file, usa il download normale
         if (dcmtsWithFile.length > 0) {
-            const rfo = new RetrieveFileOptions();
-            rfo.retrieveReason = DcmtOpers.None;
-            rfo.generalRetrieveFormat = GeneralRetrieveFormats.OriginalUnsigned;
-            rfo.cvtFormat = FileFormats.PDF;
-            rfo.invoiceRetrieveFormat = toPdfInvoiceRetrieveFormat(SDKUI_Globals.userSettings?.searchSettings.invoiceRetrieveFormat);
-            rfo.orderRetrieveFormat = toPdfOrderRetrieveFormat(SDKUI_Globals.userSettings?.searchSettings.orderRetrieveFormat);
+            const rfo = {
+                retrieveReason: DcmtOpers.None,
+                generalRetrieveFormat: GeneralRetrieveFormats.OriginalUnsigned,
+                cvtFormat: FileFormats.PDF,
+                invoiceRetrieveFormat: toPdfInvoiceRetrieveFormat(SDKUI_Globals.userSettings?.searchSettings.invoiceRetrieveFormat),
+                orderRetrieveFormat: toPdfOrderRetrieveFormat(SDKUI_Globals.userSettings?.searchSettings.orderRetrieveFormat),
+            };
             const collectFileForMerge = async (file, dcmtInfo) => {
                 pdfFilesMap.set(`${dcmtInfo.TID}_${dcmtInfo.DID}`, file);
             };

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

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

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

@@ -301,21 +301,19 @@ const TMMultiMasterDetailDcmtsForm = (props) => {
     // ----- Render principale --------------------------------------------------------------------
     if (isLoading)
         return null;
-    return _jsxs(_Fragment, { 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, 
-                    // Cancellato il layout il popup torna alle dimensioni di default
-                    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(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: {
                     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

@@ -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) => import("react/jsx-runtime").JSX.Element;
+export declare const renderStepper: ({ steps, phase, hasMultipleTypes, isBackLocked, showBackArrow, onBack, onStepClick }: RenderStepperParams) => React.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) => import("react/jsx-runtime").JSX.Element;
+export declare const renderSelectDcmtType: ({ detailRelationItems, selectedRelation, onSelectRelation }: RenderSelectDcmtTypeParams) => React.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) => import("react/jsx-runtime").JSX.Element;
+export declare const renderAccordionHeader: ({ section, isOpen, tooltip, count, title, actions, panel, onToggleOpen }: RenderAccordionHeaderParams) => React.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;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.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/TMRelationViewer.d.ts

@@ -3,6 +3,7 @@ import { DcmtTypeDescriptor, SearchResultDescriptor, DataColumnDescriptor } from
 import { DcmtMetadataMap } from '../../../helper';
 import { DcmtInfo, MetadataValueDescriptorEx } 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
  */
@@ -132,6 +134,11 @@ 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
@@ -143,8 +150,17 @@ export interface TMRelationViewerProps {
     /**
      * Callback invoked when the calculation has actually been stopped
      * (loadData terminated after an abort request).
+     * 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.
      */
-    onCalculationStopped?: () => void;
+    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
@@ -160,8 +176,10 @@ 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
- * For each document, fetches complete metadata using GetMetadataAsync to ensure
- * all metadata properties (isSpecialSearchOutput, permissions, etc.) are available
+ * 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.
  */
 export declare const searchResultToDataSource: (searchResult: SearchResultDescriptor | undefined, hideSysMetadata?: boolean, signal?: AbortSignal) => Promise<any[]>;
 export declare const DEFAULT_RELATION_EXPAND_LEVEL = 4;