@topconsultnpm/sdkui-react 6.20.0 → 6.21.0-dev1.10

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

@@ -0,0 +1,34 @@
+import React from "react";
+import { DcmtTypeDescriptor, TaskDescriptor, ObjectRef } from "@topconsultnpm/sdk-ts";
+import { IWorkItemData } from "../../../ts";
+import { DeviceType } from "../../base/TMDeviceProvider";
+interface TMDcmtFormActionButtonsProps {
+    showToppyForApprove: boolean;
+    workItems: Array<IWorkItemData>;
+    deviceType: DeviceType | undefined;
+    isMobile: boolean;
+    handleSignApprove: () => void;
+    updateShowApprovePopup: (value: boolean) => void;
+    updateShowRejectPopup: (value: boolean) => void;
+    updateShowReAssignPopup: (value: boolean) => void;
+    updateShowMoreInfoPopup: (value: boolean) => void;
+    fromDTD: DcmtTypeDescriptor | undefined;
+    showToppyForCompleteMoreInfo: boolean;
+    moreInfoTasks?: Array<TaskDescriptor>;
+    setShowCommentForm: React.Dispatch<React.SetStateAction<boolean>>;
+    showToppyForReferences: boolean;
+    dcmtReferences: ObjectRef[] | undefined;
+    referenceActionMap: {
+        Dossier: {
+            label: string;
+        };
+        WorkingGroup: {
+            label: string;
+        };
+    };
+    handleNavigateToReference: (ref: ObjectRef) => void;
+    setShowMoreInfoTaskPopup: React.Dispatch<React.SetStateAction<boolean>>;
+    setShowMoreInfoTaskTask: React.Dispatch<React.SetStateAction<TaskDescriptor | undefined>>;
+}
+declare const TMDcmtFormActionButtons: (props: TMDcmtFormActionButtonsProps) => import("react/jsx-runtime").JSX.Element;
+export default TMDcmtFormActionButtons;

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

@@ -0,0 +1,124 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useMemo, useRef } from "react";
+import { ObjectClasses, SDK_Globals } from "@topconsultnpm/sdk-ts";
+import { TASK_MORE_INFO_PREFIX_NAME, SDKUI_Localizator, PDGS_COLORS } from "../../../helper";
+import { TMColors } from "../../../utils/theme";
+import { ReferencesContainer, StyledReferenceButton } from "../../base/Styled";
+import TMButton from "../../base/TMButton";
+import TMTooltip from "../../base/TMTooltip";
+import { WorkFlowOperationButtons } from "../workflow/TMWorkflowPopup";
+const TMDcmtFormActionButtons = (props) => {
+    const { showToppyForApprove, workItems, deviceType, isMobile, handleSignApprove, updateShowApprovePopup, updateShowRejectPopup, updateShowReAssignPopup, updateShowMoreInfoPopup, fromDTD, showToppyForCompleteMoreInfo, moreInfoTasks, setShowCommentForm, showToppyForReferences, dcmtReferences, referenceActionMap, handleNavigateToReference, setShowMoreInfoTaskPopup, setShowMoreInfoTaskTask } = props;
+    const tasksNumber = useMemo(() => moreInfoTasks?.length ?? 0, [moreInfoTasks]);
+    const currentTask = useMemo(() => {
+        if (!moreInfoTasks || moreInfoTasks.length === 0)
+            return null;
+        if (moreInfoTasks.length === 1)
+            return moreInfoTasks[0];
+        // If there are multiple tasks, we cannot determine which one is relevant, so we return null
+        return null;
+    }, [moreInfoTasks]);
+    const { hasMoreInfo, hasApprove, hasReferences } = useMemo(() => {
+        const referencesExist = showToppyForReferences && dcmtReferences?.some(ref => ref.objClass === ObjectClasses.Dossier || ref.objClass === ObjectClasses.WorkingGroup);
+        return {
+            hasMoreInfo: Boolean(showToppyForCompleteMoreInfo),
+            hasApprove: Boolean(showToppyForApprove),
+            hasReferences: Boolean(referencesExist)
+        };
+    }, [
+        showToppyForCompleteMoreInfo,
+        showToppyForApprove,
+        showToppyForReferences,
+        dcmtReferences
+    ]);
+    const Divider = () => (_jsx("div", { style: { height: '1px', width: '100%', background: 'linear-gradient(to right, transparent, rgba(255,255,255,0.4), transparent)', margin: '3px 0', opacity: 0.8, } }));
+    return _jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: '10px' }, children: [hasMoreInfo && (tasksNumber === 1 ? (_jsx("div", { style: { display: 'flex', gap: "10px", flexDirection: 'column', alignItems: 'center' }, children: _jsx("div", { style: {
+                        padding: '10px',
+                        color: '#FFFFFF',
+                        maxWidth: '240px',
+                        background: 'linear-gradient(135deg, #1E90FF 0%, #0077BE 60%, #00509E 100%)',
+                        border: '1px solid rgba(255,255,255,0.15)',
+                        boxShadow: '0 8px 20px rgba(0, 0, 50, 0.4)',
+                        backdropFilter: 'blur(6px)',
+                        display: 'flex',
+                        flexDirection: 'column',
+                        alignItems: 'center',
+                        textAlign: 'center',
+                        gap: '10px',
+                        cursor: 'default',
+                    }, children: (() => {
+                        const userID = SDK_Globals.tmSession?.SessionDescr?.userID;
+                        const isSender = currentTask?.fromID !== undefined && currentTask.fromID === userID;
+                        const isRecipient = currentTask?.toID !== undefined && currentTask.toID === userID;
+                        const truncate = (str, maxLength) => str && str.length > maxLength ? str.substring(0, maxLength) + '...' : str;
+                        const senderNameTruncated = currentTask?.fromName ? truncate(currentTask.fromName, 30) : 'N/A';
+                        const recipientNameTruncated = currentTask?.toName ? truncate(currentTask.toName, 30) : 'N/A';
+                        const taskNameTrunc = currentTask?.name ? truncate(currentTask.name.replace(TASK_MORE_INFO_PREFIX_NAME ?? '', ''), 30) : 'N/A';
+                        return (_jsxs(_Fragment, { children: [(isSender && !isRecipient) && (_jsx(TaskLink, { messagePrefix: `Hai richiesto maggiori informazioni a "${recipientNameTruncated}" tramite l'attività`, name: currentTask.name ?? 'N/A', taskNameTrunc: taskNameTrunc ?? 'N/A', description: currentTask.description ?? 'N/A', currentTask: currentTask, setShowMoreInfoTaskPopup: setShowMoreInfoTaskPopup, setShowMoreInfoTaskTask: setShowMoreInfoTaskTask })), (isRecipient && !isSender) && (_jsxs("div", { style: {
+                                        display: 'flex',
+                                        flexDirection: 'column',
+                                        alignItems: 'center',
+                                        gap: '10px'
+                                    }, children: [_jsx(TaskLink, { messagePrefix: `"${senderNameTruncated}" ti ha richiesto maggiori informazioni tramite l'attività`, name: currentTask.name ?? 'N/A', taskNameTrunc: taskNameTrunc ?? 'N/A', description: currentTask.description ?? 'N/A', currentTask: currentTask, setShowMoreInfoTaskPopup: setShowMoreInfoTaskPopup, setShowMoreInfoTaskTask: setShowMoreInfoTaskTask }), _jsx(TMButton, { btnStyle: isMobile ? 'toolbar' : 'advanced', showTooltip: isMobile, icon: _jsx("span", { className: "dx-icon-chat" }), caption: SDKUI_Localizator.CommentAndComplete, width: "180px", disabled: false, onClick: () => setShowCommentForm(true), onMouseDown: e => e.stopPropagation(), advancedColor: TMColors.success, color: "success" })] }))] }));
+                    })() }) })) : (_jsx("div", { style: {
+                    padding: '10px',
+                    color: '#FFFFFF',
+                    maxWidth: '240px',
+                    background: 'linear-gradient(135deg, #1E90FF 0%, #0077BE 60%, #00509E 100%)',
+                    border: '1px solid rgba(255,255,255,0.15)',
+                    boxShadow: '0 8px 20px rgba(0, 0, 50, 0.4)',
+                    backdropFilter: 'blur(6px)',
+                    display: 'flex',
+                    flexDirection: 'column',
+                    alignItems: 'center',
+                    textAlign: 'center',
+                    gap: '10px',
+                    cursor: 'default',
+                }, children: `Ci sono ${moreInfoTasks?.length ?? 0} richieste di maggiori informazioni. ${SDKUI_Localizator.ManageFromTaskPanel}` }))), hasMoreInfo && hasApprove && _jsx(Divider, {}), hasApprove && (workItems.length === 1 ?
+                _jsx(WorkFlowOperationButtons, { dtd: fromDTD, deviceType: deviceType, onApprove: () => updateShowApprovePopup(true), onSignApprove: handleSignApprove, onReject: () => updateShowRejectPopup(true), onReAssign: () => updateShowReAssignPopup(true), onMoreInfo: () => updateShowMoreInfoPopup(true) })
+                :
+                    _jsxs("div", { style: { padding: 10, color: 'white', maxWidth: '180px', borderRadius: 10, background: '#1B1464 0% 0% no-repeat padding-box', border: '1px solid #FFFFFF' }, children: [`Questo documento è associato a ${workItems.length} workitem.`, _jsx("br", {}), `Per approvare, vai alla pagina "Approvazione workflow".`] })), (hasApprove && hasReferences) || (hasMoreInfo && !hasApprove && hasReferences) ? (_jsx(Divider, {})) : null, hasReferences && (_jsx(ReferencesContainer, { children: dcmtReferences?.filter(ref => ref.objClass === ObjectClasses.Dossier || ref.objClass === ObjectClasses.WorkingGroup)
+                    .map((ref, index) => {
+                    const mapEntry = referenceActionMap[String(ref.objClass)];
+                    const label = mapEntry?.label ?? 'Vai a riferimento';
+                    let backgroundColor;
+                    switch (ref.objClass) {
+                        case ObjectClasses.WorkingGroup:
+                            backgroundColor = PDGS_COLORS.WORKING_GROUP;
+                            break;
+                        case ObjectClasses.Dossier:
+                            backgroundColor = PDGS_COLORS.DOSSIER;
+                            break;
+                        case ObjectClasses.Document:
+                            backgroundColor = PDGS_COLORS.DOCUMENT;
+                            break;
+                        default:
+                            backgroundColor = "#C2388B";
+                            break;
+                    }
+                    return (_jsxs(StyledReferenceButton, { onClick: () => handleNavigateToReference(ref), onDoubleClick: (e) => { e.preventDefault(); e.stopPropagation(); }, "$bgColor": backgroundColor, children: [_jsx("span", { children: label }), _jsx("span", { children: `"${ref.objName}"` })] }, `ref-${index}-${ref.objID}`));
+                }) }))] });
+};
+export default TMDcmtFormActionButtons;
+const TaskLink = (props) => {
+    const { messagePrefix, name, taskNameTrunc, description, currentTask, setShowMoreInfoTaskPopup, setShowMoreInfoTaskTask } = props;
+    const mouseMoved = useRef(false);
+    const handleMouseDown = () => {
+        mouseMoved.current = false;
+    };
+    const handleMouseMove = () => {
+        mouseMoved.current = true;
+    };
+    return (_jsx(_Fragment, { children: _jsx("div", { style: { display: 'inline-flex', alignItems: 'center', gap: '4px' }, children: _jsxs("div", { onMouseDown: handleMouseDown, onMouseMove: handleMouseMove, style: { display: 'inline' }, children: [messagePrefix, ' "', _jsx("span", { style: {
+                            cursor: 'pointer',
+                            fontWeight: 500,
+                            textDecoration: 'none',
+                            transition: 'text-decoration 0.2s',
+                        }, onClick: () => {
+                            setShowMoreInfoTaskPopup(true);
+                            setShowMoreInfoTaskTask(currentTask);
+                        }, onMouseEnter: e => e.currentTarget.style.textDecoration = 'underline', onMouseLeave: e => e.currentTarget.style.textDecoration = 'none', children: taskNameTrunc }), '" ', _jsx(TMTooltip, { parentStyle: { display: 'inline' }, childStyle: { display: 'inline' }, content: _jsxs("div", { style: { whiteSpace: 'pre-line', textAlign: 'left' }, children: [_jsxs("div", { children: [_jsx("b", { children: SDKUI_Localizator.Name }), ": ", name] }), _jsxs("div", { children: [_jsx("b", { children: SDKUI_Localizator.Description }), ": ", description] })] }), children: _jsx("i", { className: "dx-icon dx-icon-info", onClick: () => {
+                                setShowMoreInfoTaskPopup(true);
+                                setShowMoreInfoTaskTask(currentTask);
+                            }, style: { fontSize: '16px', lineHeight: 1, cursor: 'pointer' } }) })] }) }) }));
+};

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

@@ -4,7 +4,7 @@ import { DcmtTypeDescriptor } from '@topconsultnpm/sdk-ts';
 interface ITMFileUploader {
     fromDTD?: DcmtTypeDescriptor;
     onFileUpload?: (file: File | null) => void;
-    openPdfEditor?: (fromDTD?: DcmtTypeDescriptor, file?: File | null, handleFile?: (file: File) => void) => void;
+    openFileUploaderPdfEditor?: (fromDTD?: DcmtTypeDescriptor, file?: File | null, handleFile?: (file: File) => void) => void;
     onClose?: () => void;
     onScanRequest?: (onFileScanned: (file: File) => void) => void;
     isRequired?: boolean;

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

@@ -23,7 +23,7 @@ const isScannerLicenseConfigured = () => {
         return false;
     }
 };
-const TMFileUploader = ({ fromDTD, deviceType = DeviceType.DESKTOP, onClose, onFileUpload, openPdfEditor, onScanRequest, isRequired = false, defaultBlob = null, isResizingActive, showTMPanel = true, enableDragDropOverlay = false, showScannerIcon = true }) => {
+const TMFileUploader = ({ fromDTD, deviceType = DeviceType.DESKTOP, onClose, onFileUpload, openFileUploaderPdfEditor, onScanRequest, isRequired = false, defaultBlob = null, isResizingActive, showTMPanel = true, enableDragDropOverlay = false, showScannerIcon = true }) => {
     const isBetaFeaturesEnabled = useBetaFeatures();
     const [dragOver, setDragOver] = useState(false);
     const [uploadedFile, setUploadedFile] = useState(defaultBlob);
@@ -101,11 +101,11 @@ const TMFileUploader = ({ fromDTD, deviceType = DeviceType.DESKTOP, onClose, onF
                     _jsx("div", { style: { backgroundColor: '#f6dbdb', padding: '5px 10px', borderRadius: 8, display: 'flex', alignItems: 'center', justifyContent: 'space-between', color: TMColors.error }, children: _jsxs("div", { children: [" ", 'Anteprima non disponibile.', 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] }));
     const toolbar = useMemo(() => {
-        return (_jsxs(_Fragment, { children: [(isPdfEditorAvailable(fromDTD, fileExt) && openPdfEditor) && (_jsx(TMCommandsContextMenu, { target: "#TMPanel-FileUploader-Commands-Header", menuItems: [
+        return (_jsxs(_Fragment, { children: [(isPdfEditorAvailable(fromDTD, fileExt) && openFileUploaderPdfEditor) && (_jsx(TMCommandsContextMenu, { target: "#TMPanel-FileUploader-Commands-Header", menuItems: [
                         {
                             icon: _jsx(IconEdit, {}),
                             text: 'PDF Editor',
-                            onClick: () => openPdfEditor(fromDTD, uploadedFile, handleFile)
+                            onClick: () => openFileUploaderPdfEditor(fromDTD, uploadedFile, handleFile)
                         }
                     ], showEvent: "click", children: _jsx(IconMenuVertical, { id: "TMPanel-FileUploader-Commands-Header", color: "white", cursor: "pointer" }) })), deviceType !== DeviceType.MOBILE && (_jsx(StyledHeaderIcon, { onClick: onClose, "$color": "white", children: _jsx(TMTooltip, { content: SDKUI_Localizator.Close, children: _jsx(IconCloseOutline, {}) }) }))] }));
     }, [deviceType, fromDTD, onClose]);

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

@@ -1,6 +1,6 @@
 import React from 'react';
-import { HomeBlogPost, TaskDescriptor } from '@topconsultnpm/sdk-ts';
-import { DcmtInfo, TaskContext } from '../../../ts';
+import { HomeBlogPost, SearchResultDescriptor, TaskDescriptor } from '@topconsultnpm/sdk-ts';
+import { DcmtInfo, TaskContext, MetadataValueDescriptorEx } from '../../../ts';
 import { DeviceContextProps } from '../../base/TMDeviceProvider';
 interface ITMMasterDetailDcmtsProps extends DeviceContextProps {
     allTasks?: Array<TaskDescriptor>;
@@ -21,6 +21,31 @@ interface ITMMasterDetailDcmtsProps extends DeviceContextProps {
     onBack?: () => void;
     appendMasterDcmts?: (tid: number | undefined, did: number | undefined) => void;
     onTaskCreateRequest?: (taskContext: TaskContext, onTaskCreated?: (task?: TaskDescriptor) => void) => void;
+    onRefreshAfterAddDcmtToFavs?: () => void;
+    editPdfForm?: boolean;
+    openS4TViewer?: boolean;
+    onOpenS4TViewerRequest?: (dcmtInfo: Array<DcmtInfo>, refreshDocumentPreview?: (() => Promise<void>)) => void;
+    onOpenPdfEditorRequest?: ((dcmtInfo: Array<DcmtInfo>, refreshDocumentPreview?: () => Promise<void>) => void);
+    datagridUtility?: {
+        onRefreshSearchAsyncDatagrid?: () => Promise<void>;
+        onRefreshDataRowsAsync?: (() => Promise<void>);
+        refreshFocusedDataRowAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>;
+        onRefreshBlogDatagrid?: () => Promise<void>;
+        onRefreshPreviewDatagrid?: () => Promise<void>;
+    };
+    dcmtUtility?: {
+        approvalVID?: number;
+        dcmtDataRowForCicoStatus?: Array<MetadataValueDescriptorEx> | any;
+        selectedDcmtSearchResultRelations?: SearchResultDescriptor;
+        dcmtTIDHasDetailRelations?: boolean;
+        dcmtTIDHasMasterRelations?: boolean;
+        updateCurrentDcmt?: () => Promise<void>;
+        onCloseDcmtForm?: () => void;
+        onRefreshBlogForm?: () => Promise<void>;
+        onRefreshPreviewForm?: () => Promise<void>;
+        taskFormDialogComponent?: React.ReactNode;
+        s4TViewerDialogComponent?: React.ReactNode;
+    };
 }
 declare const TMMasterDetailDcmts: React.FC<ITMMasterDetailDcmtsProps>;
 export default TMMasterDetailDcmts;

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

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useCallback, useEffect, useMemo, useState } from 'react';
-import { DcmtTypeListCacheService, SDK_Localizator } from '@topconsultnpm/sdk-ts';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { DcmtTypeListCacheService, LayoutModes, SDK_Globals, SDK_Localizator } from '@topconsultnpm/sdk-ts';
 import TMRelationViewer from './TMRelationViewer';
 import TMContextMenu from '../../NewComponents/ContextMenu/TMContextMenu';
-import { IconMultipleSelection, IconCheckFile, IconDetailDcmts, SDKUI_Localizator, IconMenuVertical, IconDataList, IconPreview, IconSearchCheck, IconBoard, IconDcmtTypeSys, IconShow, getMoreInfoTasksForDocument } from '../../../helper';
+import { IconMultipleSelection, IconCheckFile, IconDetailDcmts, SDKUI_Localizator, IconMenuVertical, IconDataList, IconPreview, IconSearchCheck, IconBoard, IconDcmtTypeSys, IconShow, getMoreInfoTasksForDocument, isApprovalWorkflowView, searchResultToMetadataValues } from '../../../helper';
 import { FormModes, SearchResultContext } from '../../../ts';
 import { TMColors } from '../../../utils/theme';
 import ShowAlert from '../../base/TMAlert';
@@ -15,7 +15,9 @@ import TMSearchResult from '../search/TMSearchResult';
 import TMDcmtForm from './TMDcmtForm';
 import { TMNothingToShow } from './TMDcmtPreview';
 import { Spinner } from '../..';
-const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, deviceType, inputDcmts, isForMaster, showCurrentDcmtIndicator = true, allowNavigation, canNext, canPrev, onNext, onPrev, onBack, appendMasterDcmts, onTaskCreateRequest }) => {
+import { useDocumentOperations } from '../../../hooks/useDocumentOperations';
+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 }) => {
+    const floatingBarContainerRef = useRef(null);
     const [focusedItem, setFocusedItem] = useState();
     const [selectedItems, setSelectedItems] = useState([]);
     const [showZeroDcmts, setShowZeroDcmts] = useState(false);
@@ -23,6 +25,179 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
     const [dtdMaster, setDtdMaster] = useState();
     const [noRelationsOnFirstLoad, setNoRelationsOnFirstLoad] = useState(false);
     const [isCheckingFirstLoad, setIsCheckingFirstLoad] = useState(true);
+    const [contextMenuVisible, setContextMenuVisible] = useState(false);
+    const [contextMenuPosition, setContextMenuPosition] = useState({ x: 0, y: 0 });
+    const [dtdFocused, setDtdFocused] = useState();
+    const [refreshKey, setRefreshKey] = useState(0);
+    // Stato per gestire la transizione fluida durante il refresh
+    const [isRefreshing, setIsRefreshing] = useState(false);
+    /** State for transformed focusedItem metadata values (similar to formData in TMDcmtForm) */
+    const [focusedItemFormData, setFocusedItemFormData] = useState([]);
+    // Trigger operationItems refresh (after file substitution, etc.)
+    const [refreshOperationsTrigger, setRefreshOperationsTrigger] = useState(0);
+    // Increments trigger counter to force operationItems to re-calculate
+    const onRefreshOperationsDatagrid = useCallback(async () => {
+        setRefreshOperationsTrigger(prev => prev + 1);
+    }, []);
+    // Refresh con transizione fluida: fade-out -> update -> fade-in
+    const onRefreshSearch = async () => {
+        await dcmtUtility?.onRefreshPreviewForm?.();
+        // Avvia fade-out
+        setIsRefreshing(true);
+        // Attendi che il fade-out sia completato, poi aggiorna
+        setTimeout(() => {
+            setRefreshKey(prev => prev + 1);
+            onRefreshOperationsDatagrid();
+            // Attendi un po' per dare tempo al re-render, poi fade-in
+            setTimeout(() => {
+                setIsRefreshing(false);
+            }, 300); // Durata extra dell'overlay dopo l'update
+        }, 200); // Durata del fade-out
+    };
+    useEffect(() => {
+        const fetchFocusedItemMetadata = async () => {
+            if (!focusedItem?.tid || !focusedItem?.did) {
+                setFocusedItemFormData([]);
+                return;
+            }
+            try {
+                const tid = focusedItem?.tid;
+                const did = focusedItem?.did;
+                const metadata = await SDK_Globals.tmSession?.NewSearchEngine().GetMetadataAsync(tid, did, true);
+                // Transform metadata to MetadataValueDescriptorEx[] (similar to setMetadataList in TMDcmtForm)
+                if (metadata) {
+                    const dtdResult = metadata.dtdResult;
+                    const rows = dtdResult?.rows ? dtdResult.rows[0] : [];
+                    const mids = metadata.selectMIDs;
+                    // Get DTD with metadata descriptors
+                    const dtdWithMetadata = await DcmtTypeListCacheService.GetWithNotGrantedAsync(tid, did, metadata);
+                    const mdList = dtdWithMetadata?.metadata ?? [];
+                    const metadataList = searchResultToMetadataValues(tid, dtdResult, rows, mids, mdList, LayoutModes.Update);
+                    setFocusedItemFormData(structuredClone(metadataList));
+                }
+            }
+            catch (error) {
+                console.error('Error fetching focusedItem metadata:', error);
+                setFocusedItemFormData([]);
+            }
+        };
+        fetchFocusedItemMetadata();
+    }, [focusedItem?.tid, focusedItem?.did, refreshOperationsTrigger]);
+    // Load dtdFocused when focusedItem changes
+    useEffect(() => {
+        const loadDtdFocused = async () => {
+            if (!focusedItem?.tid) {
+                setDtdFocused(undefined);
+                return;
+            }
+            const dtd = await DcmtTypeListCacheService.GetAsync(focusedItem.tid);
+            setDtdFocused(dtd);
+        };
+        loadDtdFocused();
+    }, [focusedItem?.tid]);
+    const openTaskFormHandler = (onTaskCreated) => {
+        if (selectedItems.length > 1)
+            return;
+        const item = selectedItems.length === 1 ? selectedItems[0] : focusedItem;
+        if (item && item.tid && item.did) {
+            const createTaskFromDocumentOrWorkItem = async () => {
+                try {
+                    const dtd = await DcmtTypeListCacheService.GetWithNotGrantedAsync(item.tid, item?.did);
+                    if (dtd) {
+                        const isWorkItem = isApprovalWorkflowView(dtd);
+                        if (item.tid === undefined || item.did === undefined) {
+                            console.error("TID or DID is undefined for the selected item.");
+                            return;
+                        }
+                        const name = `${dtd.name ?? '-'} (DID: ${item.did})`;
+                        onTaskCreateRequest?.(isWorkItem
+                            ? { workItem: { tid: item.tid, did: item.did, name } }
+                            : { document: { tid: item.tid, did: item.did, name } }, onTaskCreated);
+                    }
+                }
+                catch (error) {
+                    console.error("Error fetching data:", error);
+                }
+            };
+            createTaskFromDocumentOrWorkItem();
+        }
+    };
+    const { operationItems, renderFloatingBar, renderDcmtOperations, features } = useDocumentOperations({
+        context: SearchResultContext.MASTER_DETAIL,
+        documentData: {
+            dtd: dtdFocused,
+            selectedItems: selectedItems ? selectedItems.map(item => ({ TID: item.tid, DID: item.did, FILEEXT: item.fileExt })) : [],
+            focusedItem: focusedItem ? { TID: focusedItem.tid, DID: focusedItem.did, FILEEXT: focusedItem.fileExt } : undefined,
+            currentSearchResults: [],
+            currentMetadataValues: [],
+            allUsers: [],
+            // searchResult: selectedSearchResult,
+            datagridUtility: {
+                visibleItems: [],
+                onRefreshSearchAsyncDatagrid: datagridUtility?.onRefreshSearchAsyncDatagrid,
+                onRefreshDataRowsAsync: datagridUtility?.onRefreshDataRowsAsync,
+                refreshFocusedDataRowAsync: datagridUtility?.refreshFocusedDataRowAsync,
+                onRefreshBlogDatagrid: datagridUtility?.onRefreshBlogDatagrid,
+                onRefreshPreviewDatagrid: datagridUtility?.onRefreshPreviewDatagrid,
+                refreshOperationsTrigger,
+                onRefreshOperationsDatagrid,
+            },
+            dcmtUtility: {
+                approvalVID: dcmtUtility?.approvalVID,
+                dcmtDataRowForCicoStatus: focusedItemFormData, // Passa i metadata trasformati del focusedItem per le operazioni di CICO
+                selectedDcmtSearchResultRelations: dcmtUtility?.selectedDcmtSearchResultRelations,
+                dcmtTIDHasDetailRelations: dcmtUtility?.dcmtTIDHasDetailRelations,
+                dcmtTIDHasMasterRelations: dcmtUtility?.dcmtTIDHasMasterRelations,
+                updateCurrentDcmt: onRefreshSearch,
+                onCloseDcmtForm: dcmtUtility?.onCloseDcmtForm,
+                onRefreshBlogForm: dcmtUtility?.onRefreshBlogForm,
+                onRefreshPreviewForm: onRefreshSearch,
+                taskFormDialogComponent: dcmtUtility?.taskFormDialogComponent,
+                s4TViewerDialogComponent: dcmtUtility?.s4TViewerDialogComponent
+            },
+        },
+        uiConfig: {
+            floatingBarContainerRef,
+            openS4TViewer,
+            showDcmtFormSidebar: true,
+            openDcmtFormAsModal: true,
+            allowFloatingBar: false,
+            enablePinIcons: false,
+            allowRelations: true,
+            inputDcmtFormLayoutMode: LayoutModes.Update,
+        },
+        tasks: {
+            allTasks: allTasks,
+            getAllTasks: getAllTasks,
+            deleteTaskByIdsCallback: deleteTaskByIdsCallback,
+            addTaskCallback: addTaskCallback,
+            editTaskCallback: editTaskCallback
+        },
+        callbacks: {
+            // Refresh operations (data consistency)
+            /* onSavedAsyncCallback, */
+            // Workflow operations
+            /* onWFOperationCompleted, */
+            // Navigation
+            /* canNavigateHandler,
+            onNavigateHandler, */
+            handleNavigateToWGs,
+            handleNavigateToDossiers,
+            /* onReferenceClick, */
+            // Document forms/operations
+            /* openAddDocumentForm,
+            openCommentFormCallback,
+            onFileOpened,
+            passToArchiveCallback,
+            openWGsCopyMoveForm, */
+            onOpenS4TViewerRequest,
+            onOpenPdfEditorRequest,
+            // Task related
+            onTaskCreateRequest,
+            openTaskFormHandler,
+            onRefreshAfterAddDcmtToFavs,
+        },
+    });
     // Load dtdMaster when inputDcmts changes
     useEffect(() => {
         const loadDtdMaster = async () => {
@@ -53,6 +228,12 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
             setNoRelationsOnFirstLoad(true);
         }
     }, [isCheckingFirstLoad]);
+    const onItemContextMenu = useCallback((item, e) => {
+        if (!item.isDcmt)
+            return; // Show context menu only for document items
+        setContextMenuPosition({ x: e.clientX, y: e.clientY });
+        setContextMenuVisible(true);
+    }, []);
     // Show warning alert and navigate back when no relations found on first load
     useEffect(() => {
         if (noRelationsOnFirstLoad) {
@@ -97,10 +278,19 @@ 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 }) })
             :
-                _jsx(TMRelationViewerWrapper, { inputDcmts: inputDcmts, isForMaster: isForMaster, showCurrentDcmtIndicator: showCurrentDcmtIndicator, showZeroDcmts: showZeroDcmts, 
-                    // customItemRender={customItemRender}
-                    allowMultipleSelection: allowMultipleSelection, focusedItem: focusedItem, selectedItems: selectedItems, onFocusedItemChanged: handleFocusedItemChanged, onSelectedItemsChanged: handleSelectedItemsChanged, onNoRelationsFound: handleNoRelationsFound }) }), [inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, allowMultipleSelection, focusedItem, selectedItems, handleFocusedItemChanged, handleSelectedItemsChanged, handleNoRelationsFound]);
-    const tmFormOrResult = useMemo(() => _jsx(TMFormOrResultWrapper, { deviceType: deviceType, focusedItem: focusedItem, onTaskCreateRequest: onTaskCreateRequest, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }), [focusedItem, deviceType, allTasks, handleNavigateToWGs, handleNavigateToDossiers]);
+                _jsxs("div", { ref: floatingBarContainerRef, style: { width: "100%", height: "100%" }, onContextMenu: (e) => {
+                        // 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: {
+                                visible: contextMenuVisible,
+                                position: contextMenuPosition,
+                                onClose: () => setContextMenuVisible(false)
+                            } })] }) }), [inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, allowMultipleSelection, focusedItem, selectedItems, handleFocusedItemChanged, handleSelectedItemsChanged, handleNoRelationsFound, onItemContextMenu, contextMenuVisible, contextMenuPosition, refreshKey, focusedItemFormData]);
+    const tmFormOrResult = useMemo(() => _jsx(TMFormOrResultWrapper, { refreshKey: refreshKey, deviceType: deviceType, focusedItem: focusedItem, onTaskCreateRequest: onTaskCreateRequest, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest }), [focusedItem, deviceType, allTasks, handleNavigateToWGs, handleNavigateToDossiers, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onRefreshAfterAddDcmtToFavs, refreshKey]);
     const initialPanelDimensions = {
         'tmTreeView': { width: '50%', height: '100%' },
         'tmFormOrResult': { width: '50%', height: '100%' },
@@ -177,7 +367,28 @@ 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 })), _jsx("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 }) }) })] }));
+    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 }) }), _jsxs("div", { style: {
+                            position: 'absolute',
+                            top: 0,
+                            left: 0,
+                            right: 0,
+                            bottom: 0,
+                            backgroundColor: 'rgba(255, 255, 255, 0.7)',
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                            opacity: isRefreshing ? 1 : 0,
+                            pointerEvents: isRefreshing ? 'auto' : 'none',
+                            transition: 'opacity 200ms ease-in-out',
+                            zIndex: 10,
+                        }, children: [_jsx("div", { style: {
+                                    width: 40,
+                                    height: 40,
+                                    border: '3px solid #e0e0e0',
+                                    borderTopColor: TMColors.primaryColor,
+                                    borderRadius: '50%',
+                                    animation: 'spin 0.8s linear infinite',
+                                } }), _jsx("style", { children: `@keyframes spin { to { transform: rotate(360deg); } }` })] }), renderDcmtOperations, renderFloatingBar] })] }));
 };
 export default TMMasterDetailDcmts;
 /**
@@ -186,7 +397,7 @@ export default TMMasterDetailDcmts;
  * - Panel visibility toggling
  * - Focus delay handling
  */
-const TMRelationViewerWrapper = ({ inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, customItemRender, allowMultipleSelection, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onNoRelationsFound }) => {
+const TMRelationViewerWrapper = ({ refreshKey, inputDcmts, isForMaster, showCurrentDcmtIndicator, showZeroDcmts, customItemRender, allowMultipleSelection, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onNoRelationsFound, onItemContextMenu, focusedItemFormData }) => {
     const { setPanelVisibilityById, setToolbarButtonVisibility } = useTMPanelManagerContext();
     // Handle focused item changes with panel visibility management
     const handleFocusedItemChanged = useCallback((item) => {
@@ -205,15 +416,25 @@ const TMRelationViewerWrapper = ({ inputDcmts, isForMaster, showCurrentDcmtIndic
             setToolbarButtonVisibility('tmDcmtForm', false);
         }
     }, [onFocusedItemChanged, setPanelVisibilityById, setToolbarButtonVisibility]);
-    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, onNoRelationsFound: onNoRelationsFound }));
+    const onContextMenu = useCallback((item, e) => {
+        // Ferma la propagazione per evitare che l'evento arrivi al div contenitore
+        // (che ha il suo handler per il context menu sullo spazio bianco)
+        e.stopPropagation();
+        handleFocusedItemChanged(item);
+        // Il setTimeout è necessario per permettere a React di completare il re-render
+        // dopo il cambio di focus (handleFocusedItemChanged aggiorna stato e visibilità pannelli).
+        // Senza il delay, il context menu potrebbe mostrare opzioni basate sul vecchio stato.
+        setTimeout(() => {
+            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, onNoRelationsFound: onNoRelationsFound, onItemContextMenu: onContextMenu, focusedItemFormData: focusedItemFormData }, refreshKey));
 };
-const TMFormOrResultWrapper = ({ deviceType, focusedItem, onTaskCreateRequest, allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers }) => {
+const TMFormOrResultWrapper = ({ refreshKey, deviceType, focusedItem, onTaskCreateRequest, allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, onRefreshAfterAddDcmtToFavs, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onRefreshSearchAsyncDatagrid }) => {
     const { setPanelVisibilityById } = useTMPanelManagerContext();
     return (_jsx(_Fragment, { children: focusedItem?.isDcmt ?
-            _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, moreInfoTasks: getMoreInfoTasksForDocument(allTasks, focusedItem?.tid, focusedItem?.did) }) :
-            _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, onTaskCreateRequest: onTaskCreateRequest, onClose: () => {
-                    setPanelVisibilityById('tmTreeView', true);
-                }, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }) }));
+            _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, moreInfoTasks: getMoreInfoTasksForDocument(allTasks, focusedItem?.tid, focusedItem?.did), openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, datagridUtility: {
+                    onRefreshSearchAsyncDatagrid,
+                } }, 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, 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 }, refreshKey) }));
 };

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

@@ -1,6 +1,6 @@
 import React from 'react';
 import { DcmtTypeDescriptor, SearchResultDescriptor, DataColumnDescriptor } from "@topconsultnpm/sdk-ts";
-import { DcmtInfo } from '../../../ts';
+import { DcmtInfo, MetadataValueDescriptorEx } from '../../../ts';
 import { ITMTreeItem } from '../../base/TMTreeView';
 /**
  * Tree item structure for relations
@@ -22,6 +22,7 @@ export interface RelationTreeItem extends ITMTreeItem {
     values?: any;
     searchResult?: SearchResultDescriptor[];
     itemsCount?: number;
+    fileExt?: string;
 }
 /**
  * Props for TMRelationViewer component
@@ -98,6 +99,16 @@ export interface TMRelationViewerProps {
      * Useful to notify parent component that there are no correlated documents to display.
      */
     onNoRelationsFound?: () => void;
+    /**
+     * Callback invoked when user right-clicks on a tree item.
+     * 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[];
 }
 /**
  * Check if document type has detail relations