@topconsultnpm/sdkui-react 6.21.0-dev4.9 → 6.21.0-dev5.10

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

@@ -7,15 +7,18 @@ import { IconMultipleSelection, IconCheckFile, IconDetailDcmts, SDKUI_Localizato
 import { FormModes, SearchResultContext } from '../../../ts';
 import { TMColors } from '../../../utils/theme';
 import ShowAlert from '../../base/TMAlert';
-import { DeviceType } from '../../base/TMDeviceProvider';
+import { DeviceType, useDeviceType } from '../../base/TMDeviceProvider';
 import { TMSaveFormButtonPrevious, TMSaveFormButtonNext } from '../../forms/TMSaveForm';
 import TMPanelManagerContainer from '../../layout/panelManager/TMPanelManagerContainer';
 import { TMPanelManagerProvider, useTMPanelManagerContext } from '../../layout/panelManager/TMPanelManagerContext';
 import TMSearchResult from '../search/TMSearchResult';
 import TMDcmtForm from './TMDcmtForm';
 import { TMNothingToShow } from './TMDcmtPreview';
-import { Spinner, TMButton } from '../..';
+import { TMButton, TMLayoutWaitingContainer } from '../..';
 import { useDocumentOperations } from '../../../hooks/useDocumentOperations';
+import TMToppyMessage from '../../../helper/TMToppyMessage';
+import TMPanel from '../../base/TMPanel';
+import sixLogo from '../../../assets/six.png';
 const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, deviceType, inputDcmts, isForMaster, showCurrentDcmtIndicator = true, allowNavigation, canNext, canPrev, onNext, onPrev, onBack, appendMasterDcmts, onTaskCreateRequest, onRefreshAfterAddDcmtToFavs, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, datagridUtility, dcmtUtility, fetchRemoteCertificates }) => {
     const floatingBarContainerRef = useRef(null);
     const [focusedItem, setFocusedItem] = useState();
@@ -27,6 +30,12 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
     const [isCheckingFirstLoad, setIsCheckingFirstLoad] = useState(true);
     const [contextMenuVisible, setContextMenuVisible] = useState(false);
     const [contextMenuPosition, setContextMenuPosition] = useState({ x: 0, y: 0 });
+    // Track if TMRelationViewer is loading (used to disable context menu during loading)
+    const [isRelationViewerLoading, setIsRelationViewerLoading] = useState(false);
+    // Track if loading has ever been TRUE (to distinguish initial false from post-load false)
+    const hasLoadingBeenTrueRef = useRef(false);
+    // Track the previous loading state to detect transitions
+    const prevIsRelationViewerLoadingRef = useRef(false);
     const [dtdFocused, setDtdFocused] = useState();
     const [refreshKey, setRefreshKey] = useState(0);
     // Separate refresh key for TMFormOrResultWrapper only (doesn't affect tmTreeView)
@@ -35,6 +44,21 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
     const [focusedItemFormData, setFocusedItemFormData] = useState([]);
     // Trigger operationItems refresh (after file substitution, etc.)
     const [refreshOperationsTrigger, setRefreshOperationsTrigger] = useState(0);
+    // Safety net: when TMRelationViewer finishes loading (transition from TRUE to FALSE),
+    // hide the spinner regardless of whether a document was focused or not.
+    // This handles edge cases where no document gets isRoot=true.
+    useEffect(() => {
+        const prevLoading = prevIsRelationViewerLoadingRef.current;
+        prevIsRelationViewerLoadingRef.current = isRelationViewerLoading;
+        if (isRelationViewerLoading) {
+            // Loading started - mark that we've seen a true state
+            hasLoadingBeenTrueRef.current = true;
+        }
+        else if (prevLoading && hasLoadingBeenTrueRef.current && isCheckingFirstLoad) {
+            // Transition from TRUE to FALSE (loading completed) - hide spinner
+            setIsCheckingFirstLoad(false);
+        }
+    }, [isRelationViewerLoading, isCheckingFirstLoad]);
     // Increments trigger counter to force operationItems to re-calculate
     const onRefreshOperationsDatagrid = useCallback(async () => {
         setRefreshOperationsTrigger(prev => prev + 1);
@@ -213,6 +237,7 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
             onRefreshAfterAddDcmtToFavs,
         },
     });
+    const { dcmtOperations: { abortController, showWaitPanel, showPrimary, waitPanelTitle, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary, }, } = features;
     // Load dtdMaster when inputDcmts changes
     useEffect(() => {
         const loadDtdMaster = async () => {
@@ -253,6 +278,7 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
     useEffect(() => {
         if (noRelationsOnFirstLoad) {
             setNoRelationsOnFirstLoad(false);
+            setIsCheckingFirstLoad(false); // Hide spinner before navigating back
             ShowAlert({
                 message: SDKUI_Localizator.RelatedDcmtsNotFound,
                 title: SDKUI_Localizator.RelationsNotFound,
@@ -265,14 +291,14 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
     const commandsMenuItems = [
         {
             icon: _jsx(IconMultipleSelection, { color: allowMultipleSelection ? TMColors.tertiary : TMColors.text_normal }),
-            name: "Selezione multipla",
+            name: allowMultipleSelection ? SDKUI_Localizator.DisableMultipleSelection : SDKUI_Localizator.EnableMultipleSelection,
             onClick: () => {
                 setAllowMultipleSelection(prev => !prev);
             }
         },
         {
-            icon: _jsx(IconCheckFile, {}),
-            name: "Consenti dettagli con 0 documenti",
+            icon: _jsx(IconCheckFile, { color: showZeroDcmts ? TMColors.tertiary : TMColors.text_normal }),
+            name: showZeroDcmts ? SDKUI_Localizator.HideDetailsWithZeroDocs : SDKUI_Localizator.ShowDetailsWithZeroDocs,
             onClick: () => {
                 setShowZeroDcmts(prev => !prev);
             }
@@ -294,17 +320,22 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
                 _jsx(TMNothingToShow, { text: getTitle(), secondText: SDKUI_Localizator.NoDataToDisplay, icon: isForMaster ? _jsx(IconDetailDcmts, { fontSize: 96, transform: 'scale(-1, 1)' }) : _jsx(IconDetailDcmts, { fontSize: 96 }) })
             :
                 _jsxs("div", { ref: floatingBarContainerRef, style: { width: "100%", height: "100%" }, onContextMenu: (e) => {
+                        // Disable context menu when loading
+                        if (isRelationViewerLoading) {
+                            e.preventDefault();
+                            return;
+                        }
                         // Mostra context menu anche sullo spazio bianco (quando non si clicca su un item)
                         e.preventDefault();
                         setContextMenuPosition({ x: e.clientX, y: e.clientY });
                         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: onItemContextMenu, focusedItemFormData: focusedItemFormData }), _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 }), _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]);
+                            } })] }) }), [inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, allowMultipleSelection, focusedItem, selectedItems, handleFocusedItemChanged, handleSelectedItemsChanged, handleNoRelationsFound, onItemContextMenu, contextMenuVisible, contextMenuPosition, refreshKey, focusedItemFormData, isRelationViewerLoading]);
     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%' },
@@ -382,7 +413,10 @@ 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(Spinner, { description: SDKUI_Localizator.Loading, flat: true })), _jsxs("div", { style: isCheckingFirstLoad ? { position: 'absolute', width: 0, height: 0, overflow: 'hidden', opacity: 0, pointerEvents: 'none' } : { width: '100%', height: '100%' }, 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: () => {
+                    setIsCheckingFirstLoad(false);
+                    onBack?.();
+                } })), _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;
 /**
@@ -391,8 +425,37 @@ 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 }) => {
+const TMRelationViewerWrapper = ({ refreshKey, inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, customItemRender, allowMultipleSelection, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onNoRelationsFound, onItemContextMenu, focusedItemFormData, onLoadingStateChanged }) => {
     const { setPanelVisibilityById, setToolbarButtonVisibility } = useTMPanelManagerContext();
+    // Monitor device type changes to restore panel visibility when switching from mobile to desktop
+    const deviceType = useDeviceType();
+    const prevDeviceTypeRef = useRef(deviceType);
+    // Restore panel visibility when switching from mobile to desktop
+    useEffect(() => {
+        const prevDeviceType = prevDeviceTypeRef.current;
+        prevDeviceTypeRef.current = deviceType;
+        // When switching from mobile to desktop, restore panel visibility based on current focused item
+        if (prevDeviceType === DeviceType.MOBILE && deviceType !== DeviceType.MOBILE) {
+            // Small delay to let the panel manager complete its internal state update
+            setTimeout(() => {
+                // Force tmFormOrResult panel to be visible
+                setPanelVisibilityById('tmFormOrResult', true);
+                // Restore child panel visibility based on focused item
+                if (focusedItem?.isDcmt) {
+                    setPanelVisibilityById('tmSearchResult', false);
+                    setPanelVisibilityById('tmDcmtForm', true);
+                    setToolbarButtonVisibility('tmSearchResult', false);
+                    setToolbarButtonVisibility('tmDcmtForm', true);
+                }
+                else {
+                    setPanelVisibilityById('tmSearchResult', true);
+                    setPanelVisibilityById('tmDcmtForm', false);
+                    setToolbarButtonVisibility('tmSearchResult', true);
+                    setToolbarButtonVisibility('tmDcmtForm', false);
+                }
+            }, 50);
+        }
+    }, [deviceType, focusedItem, setPanelVisibilityById, setToolbarButtonVisibility]);
     // Handle focused item changes with panel visibility management
     const handleFocusedItemChanged = useCallback((item) => {
         onFocusedItemChanged?.(item);
@@ -422,7 +485,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 }, 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 }, 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();
@@ -430,5 +493,96 @@ const TMFormOrResultWrapper = ({ refreshKey, deviceType, focusedItem, onTaskCrea
             _jsx(TMDcmtForm, { groupId: 'tmFormOrResult', TID: focusedItem?.tid, DID: focusedItem.did, allowButtonsRefs: true, isClosable: deviceType !== DeviceType.MOBILE, allowNavigation: false, allowRelations: deviceType !== DeviceType.MOBILE, showDcmtFormSidebar: false, onClose: () => { setPanelVisibilityById('tmTreeView', true); }, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, onReferenceClick: handleNavigateToReference, moreInfoTasks: getMoreInfoTasksForDocument(allTasks, focusedItem?.tid, focusedItem?.did), openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, datagridUtility: {
                     onRefreshSearchAsyncDatagrid,
                 }, fetchRemoteCertificates: fetchRemoteCertificates }, refreshKey) :
-            _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) }));
+            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, description, cancelText }) => {
+    return (_jsx("div", { style: {
+            position: 'absolute',
+            top: 0,
+            left: 0,
+            width: '100%',
+            height: '100%',
+            backgroundColor: 'rgba(248, 250, 252, 0.92)',
+            zIndex: 1000,
+            display: 'flex',
+            justifyContent: 'center',
+            alignItems: 'center',
+        }, children: _jsxs("div", { style: {
+                display: 'flex',
+                flexDirection: 'column',
+                alignItems: 'center',
+                gap: '16px',
+                padding: '24px 32px',
+                background: '#fcfcfc',
+                borderRadius: '8px',
+                boxShadow: '0 4px 16px rgba(0, 0, 0, 0.1)',
+            }, children: [_jsxs("div", { style: { position: 'relative', width: '80px', height: '80px' }, children: [_jsx("img", { style: {
+                                position: 'absolute',
+                                top: '50%',
+                                left: '50%',
+                                transform: 'translate(-54%, -54%)'
+                            }, src: sixLogo, width: 35, alt: "" }), _jsx("style", { children: `
+						@keyframes tmSpinnerRotate {
+							0% { transform: rotate(0deg); }
+							100% { transform: rotate(360deg); }
+						}
+						.tm-spinner-animation {
+							display: inline-block;
+							width: 80px;
+							height: 80px;
+							position: absolute;
+							top: 50%;
+							left: 50%;
+							transform: translate(-50%, -50%);
+						}
+						.tm-spinner-animation div {
+							animation: tmSpinnerRotate 1.2s cubic-bezier(0.5, 0, 0.5, 1) infinite;
+							transform-origin: 40px 40px;
+						}
+						.tm-spinner-animation div:after {
+							content: " ";
+							display: block;
+							position: absolute;
+							width: 7px;
+							height: 7px;
+							border-radius: 50%;
+							background: #0c448e;
+							margin: -4px 0 0 -4px;
+						}
+						.tm-spinner-animation div:nth-child(1) { animation-delay: -0.036s; }
+						.tm-spinner-animation div:nth-child(1):after { top: 63px; left: 63px; background: #f7a51f; }
+						.tm-spinner-animation div:nth-child(2) { animation-delay: -0.072s; }
+						.tm-spinner-animation div:nth-child(2):after { top: 68px; left: 56px; background: #f7a51f; }
+						.tm-spinner-animation div:nth-child(3) { animation-delay: -0.108s; }
+						.tm-spinner-animation div:nth-child(3):after { top: 71px; left: 48px; background: #d3237b; }
+						.tm-spinner-animation div:nth-child(4) { animation-delay: -0.144s; }
+						.tm-spinner-animation div:nth-child(4):after { top: 72px; left: 40px; background: #d3237b; }
+						.tm-spinner-animation div:nth-child(5) { animation-delay: -0.18s; }
+						.tm-spinner-animation div:nth-child(5):after { top: 71px; left: 32px; background: #d12a1c; }
+						.tm-spinner-animation div:nth-child(6) { animation-delay: -0.216s; }
+						.tm-spinner-animation div:nth-child(6):after { top: 68px; left: 24px; background: #d12a1c; }
+						.tm-spinner-animation div:nth-child(7) { animation-delay: -0.252s; }
+						.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 }), onCancel && (_jsx("button", { onClick: onCancel, style: {
+                        marginTop: '4px',
+                        padding: '8px 24px',
+                        fontSize: '13px',
+                        fontWeight: 500,
+                        color: '#64748b',
+                        background: 'transparent',
+                        border: '1.5px solid #cbd5e1',
+                        borderRadius: '6px',
+                        cursor: 'pointer',
+                        transition: 'all 0.2s ease',
+                    }, onMouseEnter: (e) => {
+                        e.currentTarget.style.background = '#f1f5f9';
+                        e.currentTarget.style.borderColor = '#94a3b8';
+                        e.currentTarget.style.color = '#475569';
+                    }, onMouseLeave: (e) => {
+                        e.currentTarget.style.background = 'transparent';
+                        e.currentTarget.style.borderColor = '#cbd5e1';
+                        e.currentTarget.style.color = '#64748b';
+                    }, children: cancelText ?? SDKUI_Localizator.Cancel }))] }) }));
 };

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

@@ -100,15 +100,18 @@ const TMMergeToPdfForm = (props) => {
             });
             return null;
         }
-        if (pdfDcmtInfosToDownload.length < MIN_PDF_FOR_MERGE) {
+        // Permetti merge anche con 1 solo file se convertibile o metadata-only
+        if (!hasEnoughPdfForMerge) {
             TMMessageBoxManager.show({
                 message: SDKUI_Localizator.OnlyOnePdfOrConvertibleFileMergeBlocked.replaceParams(MIN_PDF_FOR_MERGE.toString()),
                 buttons: [ButtonNames.OK]
             });
             return null;
         }
-        // Mappa per lookup veloce di FILECOUNT e FILEEXT da selectedItemsFull
-        const fileInfoMap = new Map(selectedItemsFull.map(d => [`${d.TID}_${d.DID}`, { fileExt: d.FILEEXT, fileCount: d.FILECOUNT }]));
+        // Mappa per lookup veloce di FILECOUNT e FILEEXT
+        const fileInfoMap = new Map(showTMRelationViewer
+            ? selectedItemsRelationViewer.map(d => [`${d.tid}_${d.did}`, { fileExt: d.fileExt ?? null, fileCount: d.fileCount ?? null }])
+            : selectedItemsFull.map(d => [`${d.TID}_${d.DID}`, { fileExt: d.FILEEXT, fileCount: d.FILECOUNT }]));
         // Mappa per i risultati: mantiene l'ordine originale
         const pdfFilesMap = new Map();
         // Identifica documenti di soli metadati e documenti con file

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

@@ -1,5 +1,6 @@
 import React from 'react';
 import { DcmtTypeDescriptor, SearchResultDescriptor, DataColumnDescriptor } from "@topconsultnpm/sdk-ts";
+import { DcmtMetadataMap } from '../../../helper';
 import { DcmtInfo, MetadataValueDescriptorEx } from '../../../ts';
 import { ITMTreeItem } from '../../base/TMTreeView';
 /**
@@ -19,10 +20,11 @@ export interface RelationTreeItem extends ITMTreeItem {
     isSeparator?: boolean;
     isInfoMessage?: boolean;
     isLogDel?: number;
-    values?: any;
+    values?: DcmtMetadataMap;
     searchResult?: SearchResultDescriptor[];
     itemsCount?: number;
     fileExt?: string;
+    fileCount?: number;
 }
 /**
  * Props for TMRelationViewer component
@@ -72,7 +74,10 @@ export interface TMRelationViewerProps {
      * Value rendering respects DataDomain (uses TMDataListItemViewer for lists, TMDataUserIdItemViewer for users, etc.)
      */
     showMetadataNames?: boolean;
-    /** Maximum depth level for recursive loading (default: 2) */
+    /**
+     * Maximum depth level for recursive loading (default: 2).
+     * Use 0 for unlimited depth (expand as much as possible).
+     */
     maxDepthLevel?: number;
     /**
      * If true (default), when isForMaster=true shows: detail doc → master docs as children (inverted navigation)
@@ -122,6 +127,11 @@ export interface TMRelationViewerProps {
      * (root container + first document + first correlation folder).
      */
     defaultExpandAll?: boolean;
+    /**
+     * Callback invoked when loading state changes.
+     * Useful to disable interactions (like context menu) during loading.
+     */
+    onLoadingStateChanged?: (isLoading: boolean) => void;
 }
 /**
  * Check if document type has detail relations
@@ -131,21 +141,16 @@ export declare const hasDetailRelations: (mTID: number | undefined) => Promise<b
  * Check if document type has master relations
  */
 export declare const hasMasterRelations: (dTID: number | undefined) => Promise<boolean>;
-/**
- * Get metadata keys excluding system metadata
- */
-export declare const getMetadataKeys: (obj: any) => string[];
-/**
- * Get display value keys for a document (max 5, prioritize SYS_Abstract)
- */
-export declare const getDcmtDisplayValue: (obj: any) => string[];
 /**
  * Get display value formatted by column type
  */
 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
  */
 export declare const searchResultToDataSource: (searchResult: SearchResultDescriptor | undefined, hideSysMetadata?: boolean) => Promise<any[]>;
+export declare const DEFAULT_RELATION_EXPAND_LEVEL = 4;
 declare const TMRelationViewer: React.FC<TMRelationViewerProps>;
 export default TMRelationViewer;