@topconsultnpm/sdkui-react 6.21.0-dev2.35 → 6.21.0-dev2.36

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

@@ -16,7 +16,7 @@ import TMDcmtForm from './TMDcmtForm';
 import { TMNothingToShow } from './TMDcmtPreview';
 import { Spinner, TMButton } from '../..';
 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 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, mergePdfManager }) => {
     const floatingBarContainerRef = useRef(null);
     const [focusedItem, setFocusedItem] = useState();
     const [selectedItems, setSelectedItems] = useState([]);
@@ -117,7 +117,7 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
             createTaskFromDocumentOrWorkItem();
         }
     };
-    const { operationItems, renderFloatingBar, renderDcmtOperations, features } = useDocumentOperations({
+    const { operationItems, renderFloatingBar, renderDcmtOperations, features, } = useDocumentOperations({
         context: SearchResultContext.MASTER_DETAIL,
         documentData: {
             dtd: dtdFocused,
@@ -192,6 +192,7 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
             openTaskFormHandler,
             onRefreshAfterAddDcmtToFavs,
         },
+        mergePdfManager: mergePdfManager
     });
     // Load dtdMaster when inputDcmts changes
     useEffect(() => {
@@ -285,7 +286,7 @@ const TMMasterDetailDcmts = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallba
                                 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: refreshKeyFormOrResult, 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, onRefreshSearchResults: onRefreshAllPanels }), [focusedItem, deviceType, allTasks, handleNavigateToWGs, handleNavigateToDossiers, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onRefreshAfterAddDcmtToFavs, refreshKeyFormOrResult]);
+    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, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onRefreshSearchResults: onRefreshAllPanels, mergePdfManager: mergePdfManager }), [focusedItem, deviceType, allTasks, handleNavigateToWGs, handleNavigateToDossiers, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onRefreshAfterAddDcmtToFavs, refreshKeyFormOrResult]);
     const initialPanelDimensions = {
         'tmTreeView': { width: '50%', height: '100%' },
         'tmFormOrResult': { width: '50%', height: '100%' },
@@ -404,11 +405,11 @@ const TMRelationViewerWrapper = ({ refreshKey, inputDcmts, isForMaster, showCurr
     }, [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 = ({ refreshKey, deviceType, focusedItem, onTaskCreateRequest, allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, onRefreshAfterAddDcmtToFavs, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onRefreshSearchAsyncDatagrid, onRefreshSearchResults }) => {
+const TMFormOrResultWrapper = ({ refreshKey, deviceType, focusedItem, onTaskCreateRequest, allTasks = [], mergePdfManager, getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, onRefreshAfterAddDcmtToFavs, editPdfForm, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, onRefreshSearchAsyncDatagrid, onRefreshSearchResults }) => {
     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), 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, showBackButton: false, onRefreshSearchAsyncDatagrid: onRefreshSearchResults }, 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, showBackButton: false, onRefreshSearchAsyncDatagrid: onRefreshSearchResults, mergePdfManager: mergePdfManager }, refreshKey) }));
 };

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

@@ -0,0 +1,18 @@
+import React from 'react';
+import { DcmtInfo } from '../../../ts';
+import { MergePdfManagerType } from '../../../helper';
+import { TMCopyToFolderMode } from '../../../hooks/useDocumentOperations';
+interface ITMMergeToPdfFormProps {
+    mode: TMCopyToFolderMode;
+    selectedDcmtInfos: Array<DcmtInfo>;
+    onClose: () => void;
+    showTMRelationViewer: boolean;
+    mergePdfManager?: MergePdfManagerType;
+}
+/**
+ * Form per l'unione di più documenti PDF in un singolo file.
+ * Condivide TMDownloadRelationViewerSection e gli helper in copyAndMergeDcmtsShared
+ * con TMCopyToFolderForm.
+ */
+declare const TMMergeToPdfForm: React.FC<ITMMergeToPdfFormProps>;
+export default TMMergeToPdfForm;

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

@@ -0,0 +1,164 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { DownloadTypes } from '../../../ts';
+import { calcResponsiveSizes, IconPlay, SDKUI_Globals, SDKUI_Localizator, } from '../../../helper';
+import { DcmtOpers, GeneralRetrieveFormats, ResultTypes, RetrieveFileOptions, ValidationItem, } from '@topconsultnpm/sdk-ts';
+import TMModal from '../../base/TMModal';
+import { useDeviceType } from '../../base/TMDeviceProvider';
+import TMTextBox from '../../editors/TMTextBox';
+import TMButton from '../../base/TMButton';
+import { ButtonNames, TMMessageBoxManager } from '../../base/TMPopUp';
+import { useDcmtOperations } from '../../../hooks/useDcmtOperations';
+import { TMLayoutWaitingContainer } from '../../base/TMWaitPanel';
+import { TMSplitterLayout } from '../../base/TMLayout';
+import { TMColors } from '../../../utils/theme';
+import TMDownloadRelationViewerSection from './TMDownloadRelationViewerSection';
+import { getDcmtInfosToDownload, getFloatingLabelStyle, isPdfExt, MIN_PDF_FOR_MERGE, SPLITTER_MIN, SPLITTER_START_65_35, } from './copyAndMergeDcmtsShared';
+/**
+ * Form per l'unione di più documenti PDF in un singolo file.
+ * Condivide TMDownloadRelationViewerSection e gli helper in copyAndMergeDcmtsShared
+ * con TMCopyToFolderForm.
+ */
+const TMMergeToPdfForm = ({ mode, selectedDcmtInfos, onClose, showTMRelationViewer, mergePdfManager }) => {
+    const { abortController, showWaitPanel, waitPanelTitle, showPrimary, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary, downloadDcmtsAsync, } = useDcmtOperations();
+    const deviceType = useDeviceType();
+    const [pdfFileName, setPdfFileName] = useState('');
+    const [selectedItemsRelationViewer, setSelectedItemsRelationViewer] = useState([]);
+    const getTitle = () => {
+        const count = ` (${selectedDcmtInfos.length})`;
+        const modeLabelMap = {
+            onlySelected: 'Solo i documenti selezionati',
+            customized: 'Documenti di primo livello e i correlati selezionati',
+        };
+        const modeLabel = modeLabelMap[mode] || modeLabelMap.onlySelected;
+        return `Unisci in un file PDF - ${modeLabel}${count}`;
+    };
+    // ---- Validazione ----
+    const pdfValidationItems = [];
+    if (!pdfFileName.trim()) {
+        pdfValidationItems.push(new ValidationItem(ResultTypes.ERROR, 'Nome file PDF', SDKUI_Localizator.RequiredField));
+    }
+    // ---- Statistiche selezione PDF / non-PDF ----
+    const nonPdfSelectedItems = (() => {
+        if (showTMRelationViewer) {
+            return selectedItemsRelationViewer
+                .filter(i => i.isDcmt && !isPdfExt(i.fileExt))
+                .map(i => ({ key: `${i.tid}_${i.did}`, ext: i.fileExt ?? undefined }));
+        }
+        return selectedDcmtInfos
+            .filter(d => !isPdfExt(d.FILEEXT))
+            .map(d => ({ key: `${d.TID}_${d.DID}`, ext: d.FILEEXT }));
+    })();
+    const hasNonPdfSelected = nonPdfSelectedItems.length > 0;
+    const pdfSelectedCount = (() => {
+        if (showTMRelationViewer) {
+            return selectedItemsRelationViewer.filter(i => i.isDcmt && isPdfExt(i.fileExt)).length;
+        }
+        return selectedDcmtInfos.filter(d => isPdfExt(d.FILEEXT)).length;
+    })();
+    const hasEnoughPdfForMerge = pdfSelectedCount >= MIN_PDF_FOR_MERGE;
+    const isFormValid = () => pdfValidationItems.length === 0;
+    // ---- Recupero dei file PDF da unire (condiviso tra Esegui e Anteprima) ----
+    const collectPdfFilesToMerge = async () => {
+        const dcmtInfosToDownload = getDcmtInfosToDownload(selectedDcmtInfos, selectedItemsRelationViewer, showTMRelationViewer);
+        if (dcmtInfosToDownload.length === 0) {
+            TMMessageBoxManager.show({ message: 'Nessun documento selezionato.', buttons: [ButtonNames.OK] });
+            return null;
+        }
+        const nonPdfKeys = new Set(nonPdfSelectedItems.map(i => i.key));
+        const pdfDcmtInfosToDownload = dcmtInfosToDownload.filter(d => !nonPdfKeys.has(`${d.TID}_${d.DID}`));
+        if (pdfDcmtInfosToDownload.length === 0) {
+            TMMessageBoxManager.show({
+                message: 'Tra i documenti selezionati non è presente alcun file PDF: l\'unione non può essere eseguita.',
+                buttons: [ButtonNames.OK]
+            });
+            return null;
+        }
+        if (pdfDcmtInfosToDownload.length < MIN_PDF_FOR_MERGE) {
+            TMMessageBoxManager.show({
+                message: `Tra i documenti selezionati è presente un solo file PDF: per l'unione ne servono almeno ${MIN_PDF_FOR_MERGE}.`,
+                buttons: [ButtonNames.OK]
+            });
+            return null;
+        }
+        const pdfFiles = [];
+        const retrieveOptions = new RetrieveFileOptions();
+        retrieveOptions.retrieveReason = DcmtOpers.None;
+        retrieveOptions.generalRetrieveFormat = GeneralRetrieveFormats.Original;
+        retrieveOptions.invoiceRetrieveFormat = SDKUI_Globals.userSettings.searchSettings.invoiceRetrieveFormat;
+        retrieveOptions.orderRetrieveFormat = SDKUI_Globals.userSettings.searchSettings.orderRetrieveFormat;
+        const collectFileForMerge = async (file, _dcmtInfo) => {
+            pdfFiles.push(file);
+        };
+        await downloadDcmtsAsync(pdfDcmtInfosToDownload, DownloadTypes.Dcmt, 'download', collectFileForMerge, undefined, true, retrieveOptions, false);
+        if (pdfFiles.length === 0) {
+            TMMessageBoxManager.show({ message: 'Nessun file disponibile per l\'unione.', buttons: [ButtonNames.OK] });
+            return null;
+        }
+        return pdfFiles;
+    };
+    // ---- Esecuzione: scarica i PDF e li unisce ----
+    const run = async () => {
+        if (pdfValidationItems.length > 0) {
+            TMMessageBoxManager.show({ message: 'Per favore, correggi gli errori prima di procedere.', buttons: [ButtonNames.OK] });
+            return;
+        }
+        if (!mergePdfManager) {
+            TMMessageBoxManager.show({ message: 'La funzionalità di unione PDF non è disponibile.', buttons: [ButtonNames.OK] });
+            return;
+        }
+        const pdfFiles = await collectPdfFilesToMerge();
+        if (!pdfFiles)
+            return;
+        const finalName = pdfFileName.trim().toLowerCase().endsWith('.pdf')
+            ? pdfFileName.trim()
+            : pdfFileName.trim() + '.pdf';
+        try {
+            await mergePdfManager.mergeAndDownload(pdfFiles, finalName);
+        }
+        catch (err) {
+            console.error('Errore durante l\'unione dei PDF:', err);
+            TMMessageBoxManager.show({ message: 'Errore durante l\'unione dei PDF.', buttons: [ButtonNames.OK] });
+            return;
+        }
+        onClose();
+    };
+    // ---- Render della sezione configurazione (solo PDF file name + warning) ----
+    const configSection = (_jsxs("div", { style: {
+            position: 'relative',
+            border: `1px solid ${TMColors.border_normal}`,
+            borderRadius: '8px',
+            padding: '8px',
+            height: showTMRelationViewer ? '100%' : undefined,
+            flex: showTMRelationViewer ? undefined : 1,
+            minHeight: 0,
+            marginTop: showTMRelationViewer ? '10px' : undefined,
+            display: 'flex',
+            flexDirection: 'column',
+            boxSizing: 'border-box'
+        }, children: [_jsx("span", { style: getFloatingLabelStyle(), title: "Parametri di configurazione (Unisci in PDF)", children: "Parametri di configurazione" }), _jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: '12px', overflowY: 'auto', flex: 1 }, children: [_jsx(TMTextBox, { label: "Nome file PDF", value: pdfFileName, validationItems: pdfValidationItems, autoComplete: "one-time-code", placeHolder: "merged.pdf", onValueChanged: (e) => setPdfFileName(e.target.value) }), (!hasEnoughPdfForMerge || hasNonPdfSelected) && (_jsxs("div", { style: {
+                            display: 'flex',
+                            flexDirection: 'column',
+                            gap: '6px',
+                            padding: '8px 12px',
+                            border: '1px solid #f0c36d',
+                            borderRadius: '5px',
+                            backgroundColor: '#fdf5e2',
+                            color: '#7a5d00',
+                            fontSize: '0.85rem'
+                        }, children: [_jsx("strong", { children: "Attenzione" }), _jsxs("ul", { style: { margin: 0, paddingLeft: '18px', display: 'flex', flexDirection: 'column', gap: '4px' }, children: [!hasEnoughPdfForMerge && (_jsx("li", { children: pdfSelectedCount === 0
+                                            ? `Nessun PDF tra i selezionati: ne servono almeno ${MIN_PDF_FOR_MERGE}.`
+                                            : `Solo 1 PDF tra i selezionati: ne servono almeno ${MIN_PDF_FOR_MERGE}.` })), hasNonPdfSelected && (_jsx("li", { children: (() => {
+                                            const extSet = Array.from(new Set(nonPdfSelectedItems.map(i => (i.ext ?? '').toString().trim().toLowerCase().replace(/^\./, '')).filter(e => e.length > 0)));
+                                            const extLabel = extSet.length > 0
+                                                ? ` (${extSet.map(e => '.' + e).join(', ')})`
+                                                : '';
+                                            return nonPdfSelectedItems.length === 1
+                                                ? `Un documento non è in formato PDF${extLabel} e sarà escluso dall'unione.`
+                                                : `${nonPdfSelectedItems.length} documenti non sono in formato PDF${extLabel} e saranno esclusi dall'unione.`;
+                                        })() }))] })] }))] })] }));
+    return (_jsx(TMModal, { width: calcResponsiveSizes(deviceType, showTMRelationViewer ? '90%' : '480px', showTMRelationViewer ? '90%' : '480px', '95%'), height: calcResponsiveSizes(deviceType, showTMRelationViewer ? '90%' : 'auto', showTMRelationViewer ? '90%' : 'auto', showTMRelationViewer ? '95%' : 'auto'), title: getTitle(), onClose: onClose, showCloseButton: true, 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: _jsxs("div", { onContextMenu: (e) => e.preventDefault(), style: { display: 'flex', flexDirection: 'column', gap: '16px', padding: '16px', width: '100%', height: '100%', boxSizing: 'border-box', overflow: 'hidden' }, children: [showTMRelationViewer ? (_jsx("div", { style: { flex: 1, minHeight: 0, display: 'flex', flexDirection: 'column' }, children: _jsxs(TMSplitterLayout, { direction: 'vertical', showSeparator: true, separatorSize: 8, separatorColor: 'transparent', separatorActiveColor: 'transparent', overflow: 'visible', min: SPLITTER_MIN, start: SPLITTER_START_65_35, children: [_jsx(TMDownloadRelationViewerSection, { selectedDcmtInfos: selectedDcmtInfos, onSelectionChanged: setSelectedItemsRelationViewer }), configSection] }, "TMMergeToPdf-relation-config") })) : (configSection), _jsx("div", { style: { display: 'flex', justifyContent: 'center', alignItems: 'center', gap: '12px', flexShrink: 0 }, children: _jsx(TMButton, { caption: pdfSelectedCount === 0 ? 'Unisci in PDF' : `Unisci ${pdfSelectedCount} file in PDF`, icon: _jsx(IconPlay, {}), color: 'success', showTooltip: false, disabled: !isFormValid()
+                                || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0)
+                                || !hasEnoughPdfForMerge, onClick: run }) })] }) }) }));
+};
+export default TMMergeToPdfForm;

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

@@ -50,6 +50,8 @@ export interface TMRelationViewerProps {
     onFocusedItemChanged?: (item: RelationTreeItem | null) => void;
     /** Callback when selected items change */
     onSelectedItemsChanged?: (items: RelationTreeItem[]) => void;
+    /** Callback fired when the internal tree data changes, providing a flattened list of all items currently rendered */
+    onAllItemsChanged?: (items: RelationTreeItem[]) => void;
     /** Callback when a document is double-clicked */
     onDocumentDoubleClick?: (tid: number, did: number, name?: string) => void;
     /** Custom item renderer (full control). Return undefined to use default renderer. */
@@ -109,6 +111,17 @@ export interface TMRelationViewerProps {
      * (used in master-detail context)
      */
     focusedItemFormData?: MetadataValueDescriptorEx[];
+    /**
+     * If true, shows a toolbar button to expand/collapse all tree nodes.
+     * Default: false
+     */
+    showExpandAllButton?: boolean;
+    /**
+     * If true, all tree nodes are expanded by default on initial load.
+     * If false (default), uses the standard initial expansion behavior
+     * (root container + first document + first correlation folder).
+     */
+    defaultExpandAll?: boolean;
 }
 /**
  * Check if document type has detail relations

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

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import React, { useCallback, useEffect, useMemo, useState } from 'react';
 import { DcmtTypeListCacheService, SDK_Globals, DataColumnTypes, MetadataFormats, SystemMIDs, MetadataDataDomains, RelationCacheService, RelationTypes, UserListCacheService } from "@topconsultnpm/sdk-ts";
-import { genUniqueId, IconFolder, IconBackhandIndexPointingRight, IconCircleInfo, getDcmtCicoStatus } from '../../../helper';
+import { genUniqueId, IconFolder, IconBackhandIndexPointingRight, IconCircleInfo, getDcmtCicoStatus, IconChevronDown, IconChevronRight } from '../../../helper';
 import { TMColors } from '../../../utils/theme';
-import { StyledDivHorizontal, StyledBadge } from '../../base/Styled';
+import { StyledDivHorizontal, StyledBadge, StyledToolbarForm } from '../../base/Styled';
 import TMTreeView from '../../base/TMTreeView';
 import { TMWaitPanel } from '../../base/TMWaitPanel';
 import TMDataListItemViewer from '../../viewers/TMDataListItemViewer';
@@ -136,12 +136,14 @@ export const searchResultToDataSource = async (searchResult, hideSysMetadata) =>
     }
     return output;
 };
-const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndicator = true, allowShowZeroDcmts = true, initialShowZeroDcmts = false, allowedTIDs, allowMultipleSelection = false, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onDocumentDoubleClick, customItemRender, customDocumentStyle, customMainContainerContent, customDocumentContent, showMetadataNames = false, maxDepthLevel = 2, invertMasterNavigation = true, additionalStaticItems, showMainDocument = true, labelMainContainer, onNoRelationsFound, onItemContextMenu, focusedItemFormData = [] }) => {
+const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndicator = true, allowShowZeroDcmts = true, initialShowZeroDcmts = false, allowedTIDs, allowMultipleSelection = false, focusedItem, selectedItems, onFocusedItemChanged, onSelectedItemsChanged, onAllItemsChanged, onDocumentDoubleClick, customItemRender, customDocumentStyle, customMainContainerContent, customDocumentContent, showMetadataNames = false, maxDepthLevel = 2, invertMasterNavigation = true, additionalStaticItems, showMainDocument = true, labelMainContainer, onNoRelationsFound, onItemContextMenu, focusedItemFormData = [], showExpandAllButton = false, defaultExpandAll = false }) => {
     // State
     const [dcmtTypes, setDcmtTypes] = useState([]);
     const [treeData, setTreeData] = useState([]);
     const [showZeroDcmts, setShowZeroDcmts] = useState(initialShowZeroDcmts);
     const [staticItemsState, setStaticItemsState] = useState([]);
+    const [allExpanded, setAllExpanded] = useState(defaultExpandAll);
+    const initialExpandAllAppliedRef = React.useRef(false);
     const [showWaitPanel, setShowWaitPanel] = useState(false);
     const [waitPanelTextPrimary, setWaitPanelTextPrimary] = useState('');
     const [waitPanelValuePrimary, setWaitPanelValuePrimary] = useState(0);
@@ -271,7 +273,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
             console.error('❌ Error loading detail documents:', error);
         }
         return items;
-    }, [allowedTIDs, focusedItemFormData, focusedItem?.dtd?.id]);
+    }, [allowedTIDs]);
     /**
      * Recursively retrieve master documents
      */
@@ -734,6 +736,24 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
         // and may contain custom properties that would be lost by the spread operator
         return [...treeData, ...itemsToMerge];
     }, [treeData, additionalStaticItems, staticItemsState]);
+    /**
+     * Notify parent with a flattened list of all items whenever the merged tree data changes.
+     */
+    useEffect(() => {
+        if (!onAllItemsChanged)
+            return;
+        const flatten = (items) => {
+            const out = [];
+            for (const it of items) {
+                out.push(it);
+                if (it.items && Array.isArray(it.items)) {
+                    out.push(...flatten(it.items));
+                }
+            }
+            return out;
+        };
+        onAllItemsChanged(flatten(mergedTreeData));
+    }, [mergedTreeData, onAllItemsChanged]);
     /**
      * Load data when inputs change
      */
@@ -1118,7 +1138,7 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
             }
         }
         return (_jsxs("div", { onDoubleClick: handleDoubleClick, style: documentStyle, children: [item.did && item.tid && showCurrentDcmtIndicator && inputDcmts?.some(d => d.DID === item.did && d.TID === item.tid) ? _jsx(IconBackhandIndexPointingRight, { fontSize: 22, overflow: 'visible' }) : _jsx(_Fragment, {}), item.values && (_jsx(TMDcmtIcon, { tid: item.values?.TID?.value, did: item.values?.DID?.value, fileExtension: item.values?.FILEEXT?.value, fileCount: item.values?.FILECOUNT?.value, isLexProt: item.values?.IsLexProt?.value, isMail: item.values?.ISMAIL?.value, isShared: item.values?.ISSHARED?.value, isSigned: item.values?.ISSIGNED?.value, downloadMode: 'openInNewWindow' })), checkoutStatusIcon, metadataContent] }));
-    }, [onDocumentDoubleClick, showCurrentDcmtIndicator, inputDcmts, customMainContainerContent, customDocumentStyle, customDocumentContent, showMetadataNames, showMainDocument, focusedItemFormData, focusedItem?.dtd, allUsers]);
+    }, [onDocumentDoubleClick, showCurrentDcmtIndicator, inputDcmts, customMainContainerContent, customDocumentStyle, customDocumentContent, showMetadataNames, showMainDocument, allUsers]);
     /**
      * Wrapper renderer that handles custom rendering if provided
      */
@@ -1148,6 +1168,42 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
     const handleSelectedItemsChanged = useCallback((items) => {
         onSelectedItemsChanged?.(items);
     }, [onSelectedItemsChanged]);
+    /**
+     * Recursively set the `expanded` property on every node that has children loaded.
+     * Nodes without `items` are left untouched (will be loaded lazily on user click).
+     */
+    const setExpandedRecursively = useCallback((nodes, expanded) => {
+        if (!nodes || !Array.isArray(nodes))
+            return [];
+        return nodes.map(node => {
+            const hasChildren = Array.isArray(node.items) && node.items.length > 0;
+            const newItems = hasChildren ? setExpandedRecursively(node.items, expanded) : node.items;
+            // Only toggle expansion if the node is expandable (container/doc with children or marked expandible)
+            const canExpand = hasChildren || node.isExpandible;
+            return { ...node, expanded: canExpand ? expanded : node.expanded, items: newItems };
+        });
+    }, []);
+    const handleToggleExpandAll = useCallback(() => {
+        const next = !allExpanded;
+        setAllExpanded(next);
+        setTreeData(prev => setExpandedRecursively(prev, next));
+        setStaticItemsState(prev => setExpandedRecursively(prev, next));
+        userInteractedWithStaticItemsRef.current = true;
+    }, [allExpanded, setExpandedRecursively]);
+    /**
+     * Apply defaultExpandAll once on initial tree load.
+     */
+    useEffect(() => {
+        if (!defaultExpandAll)
+            return;
+        if (initialExpandAllAppliedRef.current)
+            return;
+        if (!treeData || treeData.length === 0)
+            return;
+        initialExpandAllAppliedRef.current = true;
+        setTreeData(prev => setExpandedRecursively(prev, true));
+        setStaticItemsState(prev => setExpandedRecursively(prev, true));
+    }, [defaultExpandAll, treeData, setExpandedRecursively]);
     /**
      * Handle data changed - separate static items from dynamic tree data
      */
@@ -1169,7 +1225,20 @@ const TMRelationViewer = ({ inputDcmts, isForMaster = false, showCurrentDcmtIndi
             return null;
         return _jsx("div", { style: { padding: '20px', textAlign: 'center', color: '#666' }, children: "Nessuna relazione disponibile." });
     }
-    return (_jsxs(_Fragment, { children: [_jsx(TMTreeView, { dataSource: mergedTreeData, itemRender: finalItemRender, calculateItemsForNode: calculateItemsForNode, onDataChanged: handleDataChanged, focusedItem: focusedItem, onFocusedItemChanged: handleFocusedItemChanged, allowMultipleSelection: allowMultipleSelection, selectedItems: selectedItems, itemsPerPage: 100, onSelectionChanged: handleSelectedItemsChanged, onItemContextMenu: onItemContextMenu }), showExpansionWaitPanel && (_jsx(TMWaitPanel, { title: isForMaster ? 'Caricamento documenti master' : 'Caricamento documenti dettaglio', showPrimary: true, textPrimary: expansionWaitPanelText, valuePrimary: expansionWaitPanelValue, maxValuePrimary: expansionWaitPanelMaxValue, isCancelable: true, abortController: expansionAbortController, onAbortClick: (abortController) => {
+    return (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', height: '100%', minHeight: 0, width: '100%' }, children: [showExpandAllButton && (_jsx(StyledToolbarForm, { style: { flexShrink: 0 }, children: _jsxs("button", { type: "button", onClick: handleToggleExpandAll, title: allExpanded ? 'Comprimi tutto' : 'Espandi tutto', style: {
+                        display: 'inline-flex',
+                        alignItems: 'center',
+                        gap: '4px',
+                        padding: '4px 8px',
+                        fontSize: '0.8rem',
+                        color: TMColors.primary,
+                        background: 'transparent',
+                        border: `1px solid ${TMColors.border_normal}`,
+                        borderRadius: '4px',
+                        cursor: 'pointer',
+                        lineHeight: 1,
+                        whiteSpace: 'nowrap'
+                    }, children: [allExpanded ? _jsx(IconChevronRight, { fontSize: 14 }) : _jsx(IconChevronDown, { fontSize: 14 }), _jsx("span", { children: allExpanded ? 'Comprimi tutto' : 'Espandi tutto' })] }) })), _jsx("div", { style: { flex: 1, minHeight: 0, overflow: 'auto' }, children: _jsx(TMTreeView, { dataSource: mergedTreeData, itemRender: finalItemRender, calculateItemsForNode: calculateItemsForNode, onDataChanged: handleDataChanged, focusedItem: focusedItem, onFocusedItemChanged: handleFocusedItemChanged, allowMultipleSelection: allowMultipleSelection, selectedItems: selectedItems, itemsPerPage: 100, onSelectionChanged: handleSelectedItemsChanged, onItemContextMenu: onItemContextMenu }) }), showExpansionWaitPanel && (_jsx(TMWaitPanel, { title: isForMaster ? 'Caricamento documenti master' : 'Caricamento documenti dettaglio', showPrimary: true, textPrimary: expansionWaitPanelText, valuePrimary: expansionWaitPanelValue, maxValuePrimary: expansionWaitPanelMaxValue, isCancelable: true, abortController: expansionAbortController, onAbortClick: (abortController) => {
                     setTimeout(() => {
                         abortController?.abort();
                     }, 100);

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

@@ -0,0 +1,53 @@
+import React from 'react';
+import { DcmtInfo } from '../../../ts';
+import { DocumentDownloadSettings, FileNamingMode } from '../../../helper';
+import { IRelatedDcmt } from './TMMasterDetailDcmts';
+export declare const SPLITTER_MIN: string[];
+export declare const SPLITTER_START_HALF: string[];
+export declare const SPLITTER_START_65_35: string[];
+/** Numero minimo di file PDF necessari per poterli unire in un unico documento. */
+export declare const MIN_PDF_FOR_MERGE = 2;
+/** Stile per le etichette "floating" posizionate sopra i bordi dei container */
+export declare const getFloatingLabelStyle: () => React.CSSProperties;
+/** Chiave univoca per un IRelatedDcmt basata sulla coppia tid+did */
+export declare const getDcmtKey: (item: IRelatedDcmt) => string;
+/** Deduplica gli IRelatedDcmt in base alla coppia tid+did (mantiene la prima occorrenza) */
+export declare const dedupeByTidDid: (items: ReadonlyArray<IRelatedDcmt>) => Array<IRelatedDcmt>;
+/** Verifica se showDirectoryPicker è supportato (Chrome, Edge) */
+export declare const isDirectoryPickerSupported: () => boolean;
+/**
+ * Verifica se un'estensione (con o senza punto iniziale, case-insensitive) è "pdf".
+ */
+export declare const isPdfExt: (ext: string | null | undefined) => boolean;
+/** Sanitizza il nome file per Windows (rimuove caratteri illegali e limita la lunghezza) */
+export declare const sanitizeFileName: (fileName: string, fallbackName: string, maxLength?: number) => string;
+/** Verifica se un file esiste nella cartella (FileSystemDirectoryHandle) */
+export declare const fileExists: (dirHandle: FileSystemDirectoryHandle, fileName: string) => Promise<boolean>;
+/** Genera un nome file univoco aggiungendo un suffisso numerico se già esistente */
+export declare const generateUniqueFileName: (dirHandle: FileSystemDirectoryHandle, originalName: string) => Promise<string>;
+/** Recupera il nome leggibile del tipo documento (cache) */
+export declare const getTypeName: (tid: number | undefined) => Promise<string>;
+/** Formatta un valore convertendo le date in formato dd-MM-yyyy [HH-mm-ss] */
+export declare const formatMetadataValue: (value: string) => string;
+/** Recupera i metadati filtrati (primi 5 con mid > 100 e valore presente), concatenati con separatorChar */
+export declare const getFilteredMetadata: (tid: number, did: number, separatorChar: string) => Promise<string | null>;
+/** Opzioni di naming necessarie per generare il nome del file di destinazione */
+export interface IFileNamingOptions {
+    fileNamingMode: FileNamingMode;
+    separatorChar: string;
+}
+/** Genera il nome file di destinazione in base alle impostazioni di naming */
+export declare const generateTargetFileName: (file: File, dcmtInfo: DcmtInfo, options: IFileNamingOptions) => Promise<string>;
+/**
+ * Restituisce i documenti da scaricare:
+ * - se è visibile il TMRelationViewer, usa gli isDcmt selezionati al suo interno
+ * - altrimenti restituisce i selectedDcmtInfos passati come prop
+ */
+export declare const getDcmtInfosToDownload: (selectedDcmtInfos: Array<DcmtInfo>, selectedItemsRelationViewer: Array<IRelatedDcmt>, showTMRelationViewer: boolean) => Array<DcmtInfo>;
+/**
+ * Costruisce lo stato iniziale di DocumentDownloadSettings combinando:
+ * - i valori salvati in userSettings (se presenti)
+ * - i default della classe
+ * Nota: destinationFolder e zipPassword vengono sempre resettati per sicurezza.
+ */
+export declare const buildInitialDownloadSettings: (saved: DocumentDownloadSettings | undefined, defaultInvoiceFormat: DocumentDownloadSettings["invoiceFormat"], defaultOrderFormat: DocumentDownloadSettings["orderFormat"]) => DocumentDownloadSettings;