@topconsultnpm/sdkui-react 6.21.0-dev2.4 → 6.21.0-dev2.40

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

@@ -0,0 +1,276 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef, useState } from 'react';
+import { DownloadTypes } from '../../../ts';
+import { calcResponsiveSizes, IconFolderOpen, IconPlay, IconUndo, SDKUI_Globals, SDKUI_Localizator, } from '../../../helper';
+import { DcmtOpers, FileFormats, 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, isDirectoryPickerSupported, isPdfExt, MIN_PDF_FOR_MERGE, SPLITTER_MIN, SPLITTER_START_70_30, } from './copyAndMergeDcmtsShared';
+import ShowAlert from '../../base/TMAlert';
+/**
+ * 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, allTasks, getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers }) => {
+    const { abortController, showWaitPanel, waitPanelTitle, showPrimary, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary, downloadDcmtsAsync, } = useDcmtOperations();
+    const deviceType = useDeviceType();
+    const [pdfFileName, setPdfFileName] = useState('merged.pdf');
+    const [destinationFolder, setDestinationFolder] = useState('Download');
+    const [selectedItemsRelationViewer, setSelectedItemsRelationViewer] = useState([]);
+    // ---- Ref per la selezione cartella (File System Access API) ----
+    const folderHandleRef = useRef(null);
+    const skipSelectFolderRef = useRef(false);
+    const isPickerActiveRef = useRef(false);
+    const isUsingDefaultDownloads = destinationFolder === 'Download' && !folderHandleRef.current;
+    // ---- Handler dei campi cartella ----
+    const handleFolderValueChange = (e) => {
+        setDestinationFolder(e.target.value);
+        folderHandleRef.current = null;
+    };
+    const handleSelectFolder = async () => {
+        if (skipSelectFolderRef.current) {
+            skipSelectFolderRef.current = false;
+            return;
+        }
+        if (isPickerActiveRef.current)
+            return;
+        try {
+            isPickerActiveRef.current = true;
+            const dirHandle = await window.showDirectoryPicker({ mode: 'readwrite' });
+            folderHandleRef.current = dirHandle;
+            setDestinationFolder(dirHandle.name);
+        }
+        catch (err) {
+            if (err.name !== 'AbortError') {
+                console.error('Errore nella selezione della cartella:', err);
+            }
+        }
+        finally {
+            isPickerActiveRef.current = false;
+        }
+    };
+    const getTitle = () => {
+        const count = ` (${selectedDcmtInfos.length})`;
+        const modeLabelMap = {
+            onlySelected: 'Documenti selezionati',
+            customized: 'Documenti selezionati e i correlati',
+        };
+        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));
+    }
+    // ---- Helper per file convertibili in PDF ----
+    const isConvertibleToPdfExt = (ext) => {
+        if (!ext)
+            return false;
+        const normalized = ext.toString().trim().toLowerCase().replace(/^\./, '');
+        return [
+            'doc', 'docx', 'dot', 'dotx', 'docm', 'dotm', 'odt', 'rtf', 'txt',
+            'csv', 'xls', 'xlsx',
+            'ppt', 'pptx', 'ppsx',
+            'htm', 'html', 'xml',
+            'bmp', 'jpg', 'jpeg', 'tif', 'tiff',
+            'eml', 'msg'
+        ].includes(normalized);
+    };
+    // ---- Statistiche selezione PDF / convertibili / non-PDF ----
+    const convertibleSelectedItems = (() => {
+        if (showTMRelationViewer) {
+            return selectedItemsRelationViewer
+                .filter(i => i.isDcmt && isConvertibleToPdfExt(i.fileExt))
+                .map(i => ({ key: `${i.tid}_${i.did}`, ext: i.fileExt ?? undefined }));
+        }
+        return selectedDcmtInfos
+            .filter(d => isConvertibleToPdfExt(d.FILEEXT))
+            .map(d => ({ key: `${d.TID}_${d.DID}`, ext: d.FILEEXT }));
+    })();
+    const hasConvertibleSelected = convertibleSelectedItems.length > 0;
+    const nonPdfSelectedItems = (() => {
+        if (showTMRelationViewer) {
+            return selectedItemsRelationViewer
+                .filter(i => i.isDcmt && !isPdfExt(i.fileExt) && !isConvertibleToPdfExt(i.fileExt))
+                .map(i => ({ key: `${i.tid}_${i.did}`, ext: i.fileExt ?? undefined }));
+        }
+        return selectedDcmtInfos
+            .filter(d => !isPdfExt(d.FILEEXT) && !isConvertibleToPdfExt(d.FILEEXT))
+            .map(d => ({ key: `${d.TID}_${d.DID}`, ext: d.FILEEXT }));
+    })();
+    const hasNonPdfSelected = nonPdfSelectedItems.length > 0;
+    // Conteggio file unibili: PDF nativi + file convertibili
+    const mergeableSelectedCount = (() => {
+        if (showTMRelationViewer) {
+            return selectedItemsRelationViewer.filter(i => i.isDcmt && (isPdfExt(i.fileExt) || isConvertibleToPdfExt(i.fileExt))).length;
+        }
+        return selectedDcmtInfos.filter(d => isPdfExt(d.FILEEXT) || isConvertibleToPdfExt(d.FILEEXT)).length;
+    })();
+    const hasEnoughPdfForMerge = mergeableSelectedCount >= 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 o convertibile in 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 o convertibile: per l'unione ne servono almeno ${MIN_PDF_FOR_MERGE}.`,
+                buttons: [ButtonNames.OK]
+            });
+            return null;
+        }
+        const pdfFiles = [];
+        const rfo = new RetrieveFileOptions();
+        rfo.retrieveReason = DcmtOpers.None;
+        rfo.generalRetrieveFormat = GeneralRetrieveFormats.Original;
+        rfo.cvtFormat = FileFormats.PDF;
+        rfo.invoiceRetrieveFormat = SDKUI_Globals.userSettings?.searchSettings.invoiceRetrieveFormat;
+        rfo.orderRetrieveFormat = SDKUI_Globals.userSettings?.searchSettings.orderRetrieveFormat;
+        const collectFileForMerge = async (file, _dcmtInfo) => {
+            pdfFiles.push(file);
+        };
+        await downloadDcmtsAsync(pdfDcmtInfosToDownload, DownloadTypes.Dcmt, 'download', collectFileForMerge, undefined, true, rfo, 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 {
+            // Se c'è una cartella selezionata (non Download di default), salva direttamente nella cartella
+            if (folderHandleRef.current) {
+                const mergedFile = await mergePdfManager.mergeToFile(pdfFiles, finalName);
+                const fileHandle = await folderHandleRef.current.getFileHandle(finalName, { create: true });
+                const writable = await fileHandle.createWritable();
+                await writable.write(mergedFile);
+                await writable.close();
+                ShowAlert({ message: `Il file PDF unito è stato salvato nella cartella "${folderHandleRef.current.name}".`, mode: 'success', duration: 3000, title: 'Successo' });
+            }
+            else {
+                // Altrimenti usa il download standard del browser
+                await mergePdfManager.mergeAndDownload(pdfFiles, finalName);
+                ShowAlert({ message: 'Il file PDF unito è stato scaricato.', mode: 'success', duration: 3000, title: 'Successo' });
+            }
+        }
+        catch (err) {
+            console.error('Errore durante l\'unione dei file PDF o convertibili:', err);
+            TMMessageBoxManager.show({ message: 'Errore durante l\'unione dei file PDF o convertibili.', 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',
+                    flex: 1,
+                    overflowY: 'auto',
+                    minHeight: 0,
+                }, children: [_jsxs("div", { style: { display: 'grid', gridTemplateColumns: isDirectoryPickerSupported() ? '1fr 1fr' : '1fr', gap: '12px' }, children: [isDirectoryPickerSupported() && (_jsx(TMTextBox, { label: "Percorso", value: destinationFolder, onValueChanged: handleFolderValueChange, readOnly: true, placeHolder: "Download", onClick: handleSelectFolder, buttons: [
+                                    {
+                                        icon: _jsx(IconFolderOpen, {}),
+                                        text: 'Seleziona cartella',
+                                        onClick: handleSelectFolder
+                                    },
+                                    ...(!isUsingDefaultDownloads ? [{
+                                            icon: _jsx(IconUndo, {}),
+                                            text: 'Ripristina Download',
+                                            onClick: () => {
+                                                skipSelectFolderRef.current = true;
+                                                setDestinationFolder('Download');
+                                                folderHandleRef.current = null;
+                                            }
+                                        }] : [])
+                                ] })), _jsx(TMTextBox, { label: "Nome file PDF", value: pdfFileName, validationItems: pdfValidationItems, autoComplete: "one-time-code", onValueChanged: (e) => setPdfFileName(e.target.value) })] }), hasConvertibleSelected && (_jsxs("div", { style: {
+                            display: 'flex',
+                            flexDirection: 'column',
+                            gap: '6px',
+                            padding: '8px 12px',
+                            border: '1px solid #6db3f0',
+                            borderRadius: '5px',
+                            backgroundColor: '#e2f0fd',
+                            color: '#00527a',
+                            fontSize: '0.85rem'
+                        }, children: [_jsx("strong", { children: "Nota" }), _jsx("ul", { style: { margin: 0, paddingLeft: '18px', display: 'flex', flexDirection: 'column', gap: '4px' }, children: _jsx("li", { children: (() => {
+                                        const extSet = Array.from(new Set(convertibleSelectedItems.map(i => (i.ext ?? '').toString().trim().toLowerCase().replace(/^\./, '')).filter(e => e.length > 0)));
+                                        const extLabel = extSet.length > 0
+                                            ? ` (${extSet.map(e => '.' + e).join(', ')})`
+                                            : '';
+                                        return convertibleSelectedItems.length === 1
+                                            ? `Un documento${extLabel} verrà convertito in PDF durante l'unione.`
+                                            : `${convertibleSelectedItems.length} documenti${extLabel} verranno convertiti in PDF durante l'unione.`;
+                                    })() }) })] })), (!hasEnoughPdfForMerge || hasNonPdfSelected || !isDirectoryPickerSupported()) && (_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: [!isDirectoryPickerSupported() && (_jsx("li", { children: "Il browser in uso non supporta la selezione della cartella. I file verranno scaricati nella cartella Download." })), !hasEnoughPdfForMerge && (_jsx("li", { children: mergeableSelectedCount === 0
+                                            ? `Nessun file PDF o convertibile tra i selezionati: ne servono almeno ${MIN_PDF_FOR_MERGE}.`
+                                            : `Solo 1 file PDF o convertibile 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%' : '500px', showTMRelationViewer ? '90%' : '500px', '95%'), height: calcResponsiveSizes(deviceType, showTMRelationViewer ? '90%' : '500px', showTMRelationViewer ? '90%' : '500px', showTMRelationViewer ? '95%' : '500px'), 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: 'hidden', min: SPLITTER_MIN, start: SPLITTER_START_70_30, children: [_jsx(TMDownloadRelationViewerSection, { selectedDcmtInfos: selectedDcmtInfos, onSelectionChanged: setSelectedItemsRelationViewer, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }), configSection] }, "TMMergeToPdf-relation-config") })) : (configSection), _jsx("div", { style: { display: 'flex', justifyContent: 'center', alignItems: 'center', gap: '12px', flexShrink: 0 }, children: _jsx(TMButton, { caption: mergeableSelectedCount === 0 ? 'Unisci in PDF' : `Unisci ${mergeableSelectedCount} 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,54 @@
+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_60_40: string[];
+export declare const SPLITTER_START_70_30: string[];
+export declare const SPLITTER_START_75_25: 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;