@topconsultnpm/sdkui-react 6.21.0-t1 → 6.21.0-t2

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

@@ -0,0 +1,293 @@
+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, isConvertibleToPdfExt, 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 { 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, } from './copyAndMergeDcmtsShared';
+import ShowAlert from '../../base/TMAlert';
+import TMTooltip from '../../base/TMTooltip';
+/**
+ * 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('Error selecting folder::', err);
+            }
+        }
+        finally {
+            isPickerActiveRef.current = false;
+        }
+    };
+    const getTitle = () => {
+        const count = ` (${selectedDcmtInfos.length})`;
+        const modeLabelMap = {
+            onlySelected: SDKUI_Localizator.SelectedDocuments,
+            customized: SDKUI_Localizator.SelectedDocumentsAndRelated,
+        };
+        const modeLabel = modeLabelMap[mode] || modeLabelMap.onlySelected;
+        return `${SDKUI_Localizator.MergeToPdf} - ${modeLabel}${count}`;
+    };
+    // ---- Validazione ----
+    const pdfValidationItems = [];
+    if (!pdfFileName.trim()) {
+        pdfValidationItems.push(new ValidationItem(ResultTypes.ERROR, SDKUI_Localizator.PdfFileName, SDKUI_Localizator.RequiredField));
+    }
+    // ---- 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: SDKUI_Localizator.NoDcmtSelected, 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: SDKUI_Localizator.NoPdfOrConvertibleFilesAmongSelectedMergeBlocked,
+                buttons: [ButtonNames.OK]
+            });
+            return null;
+        }
+        if (pdfDcmtInfosToDownload.length < MIN_PDF_FOR_MERGE) {
+            TMMessageBoxManager.show({
+                message: SDKUI_Localizator.OnlyOnePdfOrConvertibleFileMergeBlocked.replaceParams(MIN_PDF_FOR_MERGE.toString()),
+                buttons: [ButtonNames.OK]
+            });
+            return null;
+        }
+        const pdfFiles = [];
+        const rfo = new RetrieveFileOptions();
+        rfo.retrieveReason = DcmtOpers.None;
+        rfo.generalRetrieveFormat = GeneralRetrieveFormats.OriginalUnsigned;
+        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: SDKUI_Localizator.NoFilesAvailableForMerge, buttons: [ButtonNames.OK] });
+            return null;
+        }
+        return pdfFiles;
+    };
+    // ---- Esecuzione: scarica i PDF e li unisce ----
+    const run = async () => {
+        if (pdfValidationItems.length > 0) {
+            TMMessageBoxManager.show({ message: SDKUI_Localizator.PleaseCorrectErrorsBeforeProceeding, buttons: [ButtonNames.OK] });
+            return;
+        }
+        if (!mergePdfManager) {
+            TMMessageBoxManager.show({ message: SDKUI_Localizator.PdfMergeFeatureNotAvailable, 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: SDKUI_Localizator.PdfMergedSavedInFolder.replaceParams(folderHandleRef.current.name), mode: 'success', duration: 5000, title: SDKUI_Localizator.MergeToPdf });
+            }
+            else {
+                // Altrimenti usa il download standard del browser
+                await mergePdfManager.mergeAndDownload(pdfFiles, finalName);
+                ShowAlert({ message: SDKUI_Localizator.PdfMergedSavedInFolder.replaceParams('Download'), mode: 'success', duration: 5000, title: SDKUI_Localizator.MergeToPdf });
+            }
+        }
+        catch (err) {
+            console.error('Error merging PDF or convertible files:', err);
+            TMMessageBoxManager.show({ message: SDKUI_Localizator.PdfMergeError, 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 ? 'calc(100% - 7px)' : undefined,
+            marginTop: '7px',
+            flex: showTMRelationViewer ? undefined : 1,
+            minHeight: 0,
+            display: 'flex',
+            flexDirection: 'column',
+            boxSizing: 'border-box'
+        }, children: [_jsx("span", { style: getFloatingLabelStyle(), title: `${SDKUI_Localizator.ConfigurationParameters} (${SDKUI_Localizator.MergeToPdf})`, children: SDKUI_Localizator.ConfigurationParameters }), _jsxs("div", { style: {
+                    display: 'flex',
+                    flexDirection: 'column',
+                    flex: 1,
+                    overflowY: 'auto',
+                    minHeight: 0,
+                }, children: [_jsxs("div", { style: { display: 'flex', flexWrap: 'wrap', columnGap: '10px' }, children: [isDirectoryPickerSupported() ? (_jsx("div", { style: { flex: '1 1 280px', minWidth: '280px' }, children: _jsx(TMTextBox, { label: SDKUI_Localizator.FolderName, value: destinationFolder, onValueChanged: handleFolderValueChange, readOnly: true, placeHolder: "Download", onClick: handleSelectFolder, buttons: [
+                                        {
+                                            icon: _jsx(IconFolderOpen, {}),
+                                            text: SDKUI_Localizator.SelectFolder,
+                                            onClick: handleSelectFolder
+                                        },
+                                        ...(!isUsingDefaultDownloads ? [{
+                                                icon: _jsx(IconUndo, {}),
+                                                text: SDKUI_Localizator.RestoreDownload,
+                                                onClick: () => {
+                                                    skipSelectFolderRef.current = true;
+                                                    setDestinationFolder('Download');
+                                                    folderHandleRef.current = null;
+                                                }
+                                            }] : [])
+                                    ] }) })) : (_jsx("div", { style: { flex: '1 1 280px', minWidth: '280px' }, children: _jsxs("div", { style: { position: 'relative', marginTop: '16px' }, children: [_jsx("span", { style: {
+                                                position: 'absolute',
+                                                top: '-10px',
+                                                left: '12px',
+                                                fontSize: '0.9rem',
+                                                color: TMColors.label_normal,
+                                                padding: '0 3px',
+                                                userSelect: 'none',
+                                                WebkitTouchCallout: 'none',
+                                                WebkitUserSelect: 'none',
+                                                width: 'max-content',
+                                                backgroundColor: TMColors.default_background,
+                                                zIndex: 1,
+                                            }, children: SDKUI_Localizator.Path }), _jsxs("div", { style: { border: `1px solid ${TMColors.border_normal}`, borderRadius: '5px', padding: '4px 10px 4px 13px', display: 'flex', alignItems: 'center', gap: '8px', backgroundColor: '#fafafa' }, children: [_jsx(IconFolderOpen, {}), _jsx("span", { style: { fontSize: '0.9rem', color: '#333' }, children: "Download" })] }), _jsx("span", { style: { fontSize: '0.8rem', color: '#888', fontStyle: 'italic', marginTop: '4px', display: 'block' }, children: SDKUI_Localizator.BrowserDoesNotSupportFolderSelection })] }) })), _jsx("div", { style: { flex: '1.5 1 420px', minWidth: '350px', width: '100%' }, children: _jsx(TMTextBox, { label: SDKUI_Localizator.PdfFileName, value: pdfFileName, validationItems: pdfValidationItems, autoComplete: "one-time-code", onValueChanged: (e) => setPdfFileName(e.target.value) }) })] }), (hasConvertibleSelected || !hasEnoughPdfForMerge || hasNonPdfSelected) && (_jsxs("div", { style: {
+                            display: 'flex',
+                            flexDirection: 'column',
+                            gap: '6px',
+                            padding: '8px 12px',
+                            border: '1px solid #c0c0c0',
+                            borderRadius: '5px',
+                            backgroundColor: '#f8f8f8',
+                            fontSize: '0.85rem',
+                            marginTop: '12px',
+                        }, children: [_jsx("div", { style: {
+                                    display: 'flex',
+                                    alignItems: 'center',
+                                    gap: '6px',
+                                    fontWeight: 600,
+                                    color: '#555',
+                                    fontSize: '0.9rem',
+                                    borderBottom: '1px solid #e0e0e0',
+                                    paddingBottom: '6px',
+                                    marginBottom: '2px'
+                                }, children: SDKUI_Localizator.NotesAndWarnings }), _jsxs("ul", { style: { margin: 0, paddingLeft: '18px', display: 'flex', flexDirection: 'column', gap: '4px' }, children: [hasConvertibleSelected && (_jsx("li", { style: { color: '#00527a' }, 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
+                                                ? SDKUI_Localizator.DocumentWillBeConvertedDuringMerge.replaceParams(extLabel)
+                                                : SDKUI_Localizator.DocumentsWillBeConvertedDuringMerge.replaceParams(convertibleSelectedItems.length.toString(), extLabel);
+                                        })() })), !hasEnoughPdfForMerge && (_jsx("li", { style: { color: '#7a5d00' }, children: mergeableSelectedCount === 0
+                                            ? SDKUI_Localizator.NoPdfOrConvertibleFilesSelected_Param.replaceParams(MIN_PDF_FOR_MERGE.toString())
+                                            : SDKUI_Localizator.OnlyOnePdfOrConvertibleFileSelected.replaceParams(MIN_PDF_FOR_MERGE.toString()) })), hasNonPdfSelected && (_jsx("li", { style: { color: '#7a5d00' }, 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
+                                                ? SDKUI_Localizator.FileNotPdfWillBeExcluded.replaceParams(extLabel)
+                                                : SDKUI_Localizator.FilesNotPdfWillBeExcluded.replaceParams(nonPdfSelectedItems.length.toString(), extLabel);
+                                        })() }))] })] }))] })] }));
+    return (_jsx(TMModal, { width: calcResponsiveSizes(deviceType, showTMRelationViewer ? '90%' : '500px', showTMRelationViewer ? '90%' : '500px', '95%'), height: 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: 'hidden', min: ["50", "50"], 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', flexShrink: 0, marginTop: '12px' }, children: _jsxs("button", { disabled: !isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge, onClick: run, style: {
+                                display: 'flex',
+                                alignItems: 'center',
+                                justifyContent: 'center',
+                                gap: '6px',
+                                padding: '8px 20px',
+                                fontSize: '0.95rem',
+                                fontWeight: 600,
+                                color: '#fff',
+                                background: (!isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge)
+                                    ? '#b0b0b0'
+                                    : 'linear-gradient(135deg, #28a745 0%, #218838 100%)',
+                                border: 'none',
+                                borderRadius: '6px',
+                                cursor: (!isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge) ? 'not-allowed' : 'pointer',
+                                boxShadow: (!isFormValid() || (showTMRelationViewer && selectedItemsRelationViewer.filter(i => i.isDcmt).length === 0) || !hasEnoughPdfForMerge)
+                                    ? 'none'
+                                    : '0 2px 8px rgba(40, 167, 69, 0.35)',
+                                transition: 'all 0.2s ease',
+                            }, children: [_jsx(IconPlay, {}), _jsx("span", { children: mergeableSelectedCount === 0
+                                        ? SDKUI_Localizator.MergeToPdf
+                                        : mergeableSelectedCount > 999
+                                            ? _jsx(TMTooltip, { content: mergeableSelectedCount.toString(), children: SDKUI_Localizator.MergeFilesToPdf.replaceParams('999+') })
+                                            : SDKUI_Localizator.MergeFilesToPdf.replaceParams(mergeableSelectedCount.toString()) })] }) })] }) }) }));
+};
+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, SDKUI_Localizator } 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 ? SDKUI_Localizator.CollapseAll : SDKUI_Localizator.ExpandAll, 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 ? SDKUI_Localizator.CollapseAll : SDKUI_Localizator.ExpandAll })] }) })), _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,71 @@
+import React from 'react';
+import { DcmtInfo } from '../../../ts';
+import { DocumentDownloadSettings, FileNamingMode } from '../../../helper';
+import { IRelatedDcmt } from './TMMasterDetailDcmts';
+/** 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"
+ * o un PDF firmato (pdf.p7m, pdf.tsd, pdf.m7m).
+ * Questi formati firmati vengono trattati come PDF nativi perché con OriginalUnsigned
+ * il file viene restituito senza firma.
+ */
+export declare const isPdfExt: (ext: string | null | undefined) => boolean;
+/**
+ * Estrae l'estensione completa da un nome file, gestendo estensioni composite
+ * a più livelli come .PDF.P7M, .XML.P7M.TS, etc.
+ *
+ * Esempi:
+ * - "documento.pdf" -> ".pdf"
+ * - "DCMT_123.PDF.P7M" -> ".PDF.P7M"
+ * - "fattura.xml.p7m" -> ".xml.p7m"
+ * - "example.XML.P7M.TS" -> ".XML.P7M.TS"
+ * - "file.tar.gz" -> ".gz" (tar.gz non è gestito come firma)
+ * - "file" -> ""
+ */
+export declare const getFullFileExtension: (fileName: string, depth?: number) => string;
+/**
+ * Estrae il nome base del file (senza estensione completa).
+ * Gestisce estensioni composite come .PDF.P7M
+ */
+export declare const getFileBaseName: (fileName: string) => string;
+/** 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;