@topconsultnpm/sdkui-react 6.21.0-dev2.32 → 6.21.0-dev2.34

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

@@ -0,0 +1,263 @@
+import { DcmtTypeListCacheService, LayoutModes, SDK_Globals } from '@topconsultnpm/sdk-ts';
+import { searchResultToMetadataValues, DocumentDownloadSettings } from '../../../helper';
+import { TMColors } from '../../../utils/theme';
+// ============================================================
+// Costanti condivise tra TMCopyToFolderForm e TMMergeToPdfForm
+// ============================================================
+export const SPLITTER_MIN = ['50', '50'];
+export const SPLITTER_START_HALF = ['50%', '50%'];
+export const SPLITTER_START_65_35 = ['65%', '35%'];
+/** Numero minimo di file PDF necessari per poterli unire in un unico documento. */
+export const MIN_PDF_FOR_MERGE = 2;
+// ============================================================
+// Stili comuni
+// ============================================================
+/** Stile per le etichette "floating" posizionate sopra i bordi dei container */
+export const getFloatingLabelStyle = () => ({
+    position: 'absolute',
+    top: '-10px',
+    left: '12px',
+    maxWidth: 'calc(100% - 24px)',
+    fontSize: '0.85rem',
+    fontWeight: 600,
+    color: TMColors.primary,
+    padding: '0 8px',
+    backgroundColor: 'white',
+    zIndex: 1,
+    whiteSpace: 'nowrap',
+    overflow: 'hidden',
+    textOverflow: 'ellipsis',
+    display: 'inline-block',
+    width: 'fit-content',
+    lineHeight: '20px',
+    letterSpacing: '0.2px',
+    boxSizing: 'border-box'
+});
+// ============================================================
+// Helper su IRelatedDcmt
+// ============================================================
+/** Chiave univoca per un IRelatedDcmt basata sulla coppia tid+did */
+export const getDcmtKey = (item) => `${item.tid ?? ''}_${item.did ?? ''}`;
+/** Deduplica gli IRelatedDcmt in base alla coppia tid+did (mantiene la prima occorrenza) */
+export const dedupeByTidDid = (items) => {
+    const map = new Map();
+    for (const item of items) {
+        const key = getDcmtKey(item);
+        if (!map.has(key))
+            map.set(key, item);
+    }
+    return Array.from(map.values());
+};
+// ============================================================
+// Feature detection / Estensioni file
+// ============================================================
+/** Verifica se showDirectoryPicker è supportato (Chrome, Edge) */
+export const isDirectoryPickerSupported = () => {
+    return 'showDirectoryPicker' in window;
+};
+/**
+ * Verifica se un'estensione (con o senza punto iniziale, case-insensitive) è "pdf".
+ */
+export const isPdfExt = (ext) => {
+    if (!ext)
+        return false;
+    const normalized = ext.trim().toLowerCase().replace(/^\./, '');
+    return normalized === 'pdf';
+};
+// ============================================================
+// Sanitizzazione e gestione nomi file
+// ============================================================
+/** Sanitizza il nome file per Windows (rimuove caratteri illegali e limita la lunghezza) */
+export const sanitizeFileName = (fileName, fallbackName, maxLength = 255) => {
+    try {
+        const illegalCharsRegex = /[<>:"/\\|?*]/g;
+        const controlCharsRegex = /[\x00-\x1F\x7F]/g;
+        let sanitized = fileName
+            .replace(illegalCharsRegex, '_')
+            .replace(controlCharsRegex, '')
+            .trim();
+        sanitized = sanitized.replace(/[. ]+$/, '');
+        if (sanitized.length > maxLength) {
+            const lastDotIndex = sanitized.lastIndexOf('.');
+            if (lastDotIndex > 0) {
+                const extension = sanitized.substring(lastDotIndex);
+                const baseName = sanitized.substring(0, lastDotIndex);
+                const maxBaseLength = maxLength - extension.length;
+                sanitized = baseName.substring(0, maxBaseLength) + extension;
+            }
+            else {
+                sanitized = sanitized.substring(0, maxLength);
+            }
+        }
+        return sanitized || fallbackName;
+    }
+    catch {
+        return fallbackName;
+    }
+};
+/** Verifica se un file esiste nella cartella (FileSystemDirectoryHandle) */
+export const fileExists = async (dirHandle, fileName) => {
+    try {
+        await dirHandle.getFileHandle(fileName, { create: false });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/** Genera un nome file univoco aggiungendo un suffisso numerico se già esistente */
+export const generateUniqueFileName = async (dirHandle, originalName) => {
+    const splitName = (name) => {
+        const lastDotIndex = name.lastIndexOf('.');
+        const baseName = lastDotIndex > 0 ? name.substring(0, lastDotIndex) : name;
+        const extension = lastDotIndex > 0 ? name.substring(lastDotIndex) : '';
+        return { baseName, extension };
+    };
+    try {
+        const { baseName, extension } = splitName(originalName);
+        const MAX_ATTEMPTS = 1000;
+        for (let counter = 1; counter <= MAX_ATTEMPTS; counter++) {
+            const candidateName = counter === 1 ? originalName : `${baseName} (${counter - 1})${extension}`;
+            try {
+                await dirHandle.getFileHandle(candidateName, { create: false });
+            }
+            catch {
+                return candidateName;
+            }
+        }
+        return `${baseName}_${Date.now()}${extension}`;
+    }
+    catch {
+        const { baseName, extension } = splitName(originalName);
+        return `${baseName}_${Date.now()}${extension}`;
+    }
+};
+// ============================================================
+// Helper per la generazione del nome di destinazione del file
+// (in base alle impostazioni utente: tipo, metadati, separatore...)
+// ============================================================
+/** Recupera il nome leggibile del tipo documento (cache) */
+export const getTypeName = async (tid) => {
+    const typeList = await DcmtTypeListCacheService.GetAllWithoutMetadataAsync();
+    const foundDtd = typeList.find(dtd => dtd.id?.toString() === tid?.toString());
+    return foundDtd?.name ?? String(tid);
+};
+/** Formatta un valore convertendo le date in formato dd-MM-yyyy [HH-mm-ss] */
+export const formatMetadataValue = (value) => {
+    const date = new Date(value);
+    if (!isNaN(date.getTime())) {
+        const day = date.getDate().toString().padStart(2, '0');
+        const month = (date.getMonth() + 1).toString().padStart(2, '0');
+        const year = date.getFullYear();
+        const hours = date.getHours();
+        const minutes = date.getMinutes();
+        const seconds = date.getSeconds();
+        if (hours !== 0 || minutes !== 0 || seconds !== 0) {
+            const hh = hours.toString().padStart(2, '0');
+            const mm = minutes.toString().padStart(2, '0');
+            const ss = seconds.toString().padStart(2, '0');
+            return `${day}-${month}-${year} ${hh}-${mm}-${ss}`;
+        }
+        return `${day}-${month}-${year}`;
+    }
+    return value;
+};
+/** Recupera i metadati filtrati (primi 5 con mid > 100 e valore presente), concatenati con separatorChar */
+export const getFilteredMetadata = async (tid, did, separatorChar) => {
+    const metadata = await SDK_Globals.tmSession?.NewSearchEngine().GetMetadataAsync(tid, did, true);
+    if (!metadata)
+        return null;
+    const dtdResult = metadata.dtdResult;
+    const rows = dtdResult?.rows?.[0] ?? [];
+    const mids = metadata.selectMIDs;
+    const dtdWithMetadata = await DcmtTypeListCacheService.GetWithNotGrantedAsync(tid, did, metadata);
+    const mdList = dtdWithMetadata?.metadata ?? [];
+    const metadataList = searchResultToMetadataValues(tid, dtdResult, rows, mids, mdList, LayoutModes.Update);
+    return metadataList
+        .reduce((acc, md) => acc.length < 5 && md.mid && md.mid > 100 && md.value ? [...acc, formatMetadataValue(md.value)] : acc, [])
+        .join(separatorChar);
+};
+/** Genera il nome file di destinazione in base alle impostazioni di naming */
+export const generateTargetFileName = async (file, dcmtInfo, options) => {
+    const { fileNamingMode, separatorChar } = options;
+    const lastDotIndex = file.name.lastIndexOf('.');
+    const fileExtension = lastDotIndex > 0 ? file.name.substring(lastDotIndex) : '';
+    const fallbackName = dcmtInfo.DID + fileExtension;
+    let targetFileName = file.name;
+    switch (fileNamingMode) {
+        case 'onlyDid':
+            targetFileName = fallbackName;
+            break;
+        case 'documentTypeAndDid': {
+            const typeName = await getTypeName(dcmtInfo.TID);
+            targetFileName = `${typeName}${separatorChar}${dcmtInfo.DID}${fileExtension}`;
+            break;
+        }
+        case 'documentTypeAndCustomMetadata':
+        case 'onlyCustomMetadata': {
+            try {
+                const filteredMetadata = await getFilteredMetadata(dcmtInfo.TID, dcmtInfo.DID, separatorChar);
+                if (filteredMetadata) {
+                    if (fileNamingMode === 'documentTypeAndCustomMetadata') {
+                        const typeName = await getTypeName(dcmtInfo.TID);
+                        targetFileName = `${typeName}${separatorChar}${filteredMetadata}${fileExtension}`;
+                    }
+                    else {
+                        targetFileName = `${filteredMetadata}${fileExtension}`;
+                    }
+                }
+                else {
+                    targetFileName = fallbackName;
+                }
+            }
+            catch {
+                targetFileName = fallbackName;
+            }
+            break;
+        }
+        default:
+            break;
+    }
+    return sanitizeFileName(targetFileName, fallbackName);
+};
+// ============================================================
+// Build della lista di DcmtInfo effettivi da scaricare
+// ============================================================
+/**
+ * Restituisce i documenti da scaricare:
+ * - se è visibile il TMRelationViewer, usa gli isDcmt selezionati al suo interno
+ * - altrimenti restituisce i selectedDcmtInfos passati come prop
+ */
+export const getDcmtInfosToDownload = (selectedDcmtInfos, selectedItemsRelationViewer, showTMRelationViewer) => {
+    if (showTMRelationViewer) {
+        return selectedItemsRelationViewer
+            .filter(i => i.isDcmt && i.tid != null && i.did != null)
+            .map(i => ({ TID: i.tid, DID: i.did }));
+    }
+    return selectedDcmtInfos;
+};
+// ============================================================
+// Stato iniziale settings (con valori salvati o default)
+// ============================================================
+/**
+ * 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 const buildInitialDownloadSettings = (saved, defaultInvoiceFormat, defaultOrderFormat) => {
+    const defaults = new DocumentDownloadSettings();
+    return {
+        exportMode: saved?.exportMode ?? defaults.exportMode,
+        destinationFolder: 'Download',
+        zipFileName: saved?.zipFileName ?? defaults.zipFileName,
+        zipPassword: '',
+        fileNamingMode: saved?.fileNamingMode ?? defaults.fileNamingMode,
+        separatorChar: saved?.separatorChar ?? defaults.separatorChar,
+        invoiceFormat: saved?.invoiceFormat ?? defaultInvoiceFormat,
+        orderFormat: saved?.orderFormat ?? defaultOrderFormat,
+        fileExistsMode: saved?.fileExistsMode ?? defaults.fileExistsMode,
+        removeSignature: saved?.removeSignature ?? defaults.removeSignature,
+        pdfFileName: saved?.pdfFileName ?? defaults.pdfFileName,
+    };
+};

package/lib/components/features/search/TMSearch.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import { SavedQueryDescriptor, DcmtTypeDescriptor, TaskDescriptor, ObjectRef, HomeBlogPost } from '@topconsultnpm/sdk-ts';
+import { MergePdfManagerType } from '../../../helper';
 import { DcmtInfo, TaskContext } from '../../../ts';
 import { TMSearchResultFloatingActionConfig } from './TMSearchResultFloatingActionButton';
 interface ITMSearchProps {
@@ -40,6 +41,7 @@ interface ITMSearchProps {
     onCurrentTIDChangedCallback?: (tid: number | undefined) => void;
     onlyShowSearchQueryPanel?: boolean;
     onReferenceClick?: (ref: ObjectRef) => void;
+    mergePdfManager?: MergePdfManagerType;
 }
 declare const TMSearch: React.FunctionComponent<ITMSearchProps>;
 export default TMSearch;

package/lib/components/features/search/TMSearch.js

@@ -20,7 +20,7 @@ var TMSearchViews;
     TMSearchViews[TMSearchViews["Search"] = 0] = "Search";
     TMSearchViews[TMSearchViews["Result"] = 1] = "Result";
 })(TMSearchViews || (TMSearchViews = {}));
-const TMSearch = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, openInOffice, isVisible, inputTID, inputSqdID, inputMids, isExpertMode = SDKUI_Globals.userSettings.advancedSettings.expertMode === 1, floatingActionConfig, onFileOpened, onRefreshAfterAddDcmtToFavs, onTaskCreateRequest, openWGsCopyMoveForm, editPdfForm = false, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, openFileUploaderPdfEditor, showTodoDcmtForm, showToppyDraggableHelpCenter = true, toppyHelpCenterUsePortal = false, passToArchiveCallback, onCurrentTIDChangedCallback, onlyShowSearchQueryPanel, onReferenceClick, refreshFavoriteSavedQueries }) => {
+const TMSearch = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers, openInOffice, isVisible, inputTID, inputSqdID, inputMids, isExpertMode = SDKUI_Globals.userSettings.advancedSettings.expertMode === 1, floatingActionConfig, onFileOpened, onRefreshAfterAddDcmtToFavs, onTaskCreateRequest, openWGsCopyMoveForm, editPdfForm = false, openS4TViewer, onOpenS4TViewerRequest, onOpenPdfEditorRequest, openFileUploaderPdfEditor, showTodoDcmtForm, showToppyDraggableHelpCenter = true, toppyHelpCenterUsePortal = false, passToArchiveCallback, onCurrentTIDChangedCallback, onlyShowSearchQueryPanel, onReferenceClick, refreshFavoriteSavedQueries, mergePdfManager }) => {
     const [allSQDs, setAllSQDs] = useState([]);
     const [filteredByTIDSQDs, setFilteredByTIDSQDs] = useState([]);
     const [currentSQD, setCurrentSQD] = useState();
@@ -266,7 +266,7 @@ const TMSearch = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTask
             toolbarOptions: { icon: _jsx(IconSavedQuery, { fontSize: 24 }), visible: true, orderNumber: 4, isActive: allInitialPanelVisibility['TMSavedQuerySelector'] }
         }
     ], [tmTreeSelectorElement, showSearchResults, tmRecentsManagerElement, tmSearchQueryPanelElement, tmSavedQuerySelectorElement, fromDTD, mruTIDs]);
-    return (_jsxs(_Fragment, { children: [showSearchResults ? _jsx(StyledMultiViewPanel, { "$isVisible": currentSearchView === TMSearchViews.Search, children: _jsx(TMPanelManagerWithPersistenceProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: initialPanelDimensions, initialDimensions: initialPanelDimensions, initialMobilePanelId: 'TMRecentsManager', isPersistenceEnabled: !isMobile ? hasSavedLayout() : false, persistPanelStates: !isMobile ? (state) => persistPanelStates(state) : undefined, persistedPanelStates: getPersistedPanelStates(), children: _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", showToolbar: true, minPanelSizePx: !isMobile ? 250 : 150 }) }) }) : tmSearchQueryPanelElement, showSearchResults && _jsx(TMSearchResult, { isVisible: isVisible && currentSearchView === TMSearchViews.Result, context: SearchResultContext.METADATA_SEARCH, searchResults: searchResult, floatingActionConfig: floatingActionConfig, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, openInOffice: openInOffice, onRefreshSearchAsyncDatagrid: onRefreshSearchAsyncDatagrid, onClose: () => { onlyShowSearchQueryPanel ? setShowSearchResults(false) : setCurrentSearchView(TMSearchViews.Search); }, onFileOpened: onFileOpened, onTaskCreateRequest: onTaskCreateRequest, openWGsCopyMoveForm: openWGsCopyMoveForm, editPdfForm: editPdfForm, onOpenPdfEditorRequest: onOpenPdfEditorRequest, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, openFileUploaderPdfEditor: openFileUploaderPdfEditor, passToArchiveCallback: passToArchiveCallback, onSelectedTIDChanged: onCurrentTIDChangedCallback, showTodoDcmtForm: showTodoDcmtForm, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, onReferenceClick: onReferenceClick, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers })] }));
+    return (_jsxs(_Fragment, { children: [showSearchResults ? _jsx(StyledMultiViewPanel, { "$isVisible": currentSearchView === TMSearchViews.Search, children: _jsx(TMPanelManagerWithPersistenceProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: initialPanelDimensions, initialDimensions: initialPanelDimensions, initialMobilePanelId: 'TMRecentsManager', isPersistenceEnabled: !isMobile ? hasSavedLayout() : false, persistPanelStates: !isMobile ? (state) => persistPanelStates(state) : undefined, persistedPanelStates: getPersistedPanelStates(), children: _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", showToolbar: true, minPanelSizePx: !isMobile ? 250 : 150 }) }) }) : tmSearchQueryPanelElement, showSearchResults && _jsx(TMSearchResult, { isVisible: isVisible && currentSearchView === TMSearchViews.Result, context: SearchResultContext.METADATA_SEARCH, searchResults: searchResult, floatingActionConfig: floatingActionConfig, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, openInOffice: openInOffice, onRefreshSearchAsyncDatagrid: onRefreshSearchAsyncDatagrid, onClose: () => { onlyShowSearchQueryPanel ? setShowSearchResults(false) : setCurrentSearchView(TMSearchViews.Search); }, onFileOpened: onFileOpened, onTaskCreateRequest: onTaskCreateRequest, openWGsCopyMoveForm: openWGsCopyMoveForm, editPdfForm: editPdfForm, onOpenPdfEditorRequest: onOpenPdfEditorRequest, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, openFileUploaderPdfEditor: openFileUploaderPdfEditor, passToArchiveCallback: passToArchiveCallback, onSelectedTIDChanged: onCurrentTIDChangedCallback, showTodoDcmtForm: showTodoDcmtForm, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, onReferenceClick: onReferenceClick, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, mergePdfManager: mergePdfManager })] }));
 };
 export default TMSearch;
 const TMTreeSelectorWrapper = ({ isMobile, onSelectedTIDChanged }) => {

package/lib/components/features/search/TMSearchResult.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import { DcmtTypeDescriptor, HomeBlogPost, ObjectRef, SearchResultDescriptor, TaskDescriptor, WorkingGroupDescriptor } from '@topconsultnpm/sdk-ts';
+import { MergePdfManagerType } from '../../../helper';
 import { DcmtInfo, SearchResultContext, TaskContext } from '../../../ts';
 import { TMSearchResultFloatingActionConfig } from './TMSearchResultFloatingActionButton';
 export declare const getSearchResultCountersSingleCategory: (searchResults: SearchResultDescriptor[]) => string;
@@ -29,6 +30,7 @@ interface ITMSearchResultProps {
     showToppyDraggableHelpCenter?: boolean;
     toppyHelpCenterUsePortal?: boolean;
     showNoDcmtFoundMessage?: boolean;
+    mergePdfManager?: MergePdfManagerType;
     onClose?: () => void;
     openInOffice?: (selectedDcmtsOrFocused: Array<DcmtInfo>) => Promise<void>;
     onWFOperationCompleted?: () => Promise<void>;

package/lib/components/features/search/TMSearchResult.js

@@ -54,7 +54,7 @@ const TMSearchResult = ({
 // Data
 groupId, searchResults = [], context = SearchResultContext.METADATA_SEARCH, title, selectedSearchResultTID, floatingActionConfig, workingGroupContext = undefined, 
 // Boolean flags to enable/disable features
-isVisible = true, allowRelations = true, openDcmtFormAsModal = false, showSearchResultSidebar = true, showDcmtFormSidebar = true, showSelector = false, isClosable = false, allowFloatingBar = true, showToolbarHeader = true, showBackButton = true, disableAccordionIfSingleCategory = false, editPdfForm = false, openS4TViewer = false, showTodoDcmtForm = false, showToppyDraggableHelpCenter = true, toppyHelpCenterUsePortal = false, showNoDcmtFoundMessage = true, enablePinIcons = true, 
+isVisible = true, allowRelations = true, openDcmtFormAsModal = false, showSearchResultSidebar = true, showDcmtFormSidebar = true, showSelector = false, isClosable = false, allowFloatingBar = true, showToolbarHeader = true, showBackButton = true, disableAccordionIfSingleCategory = false, editPdfForm = false, openS4TViewer = false, showTodoDcmtForm = false, showToppyDraggableHelpCenter = true, toppyHelpCenterUsePortal = false, showNoDcmtFoundMessage = true, enablePinIcons = true, mergePdfManager, 
 // Callbacks (optional)
 openInOffice, onRefreshAfterAddDcmtToFavs, onRefreshSearchAsyncDatagrid, onSelectedTIDChanged, onWFOperationCompleted, onClose, onFileOpened, onTaskCreateRequest, openWGsCopyMoveForm, openCommentFormCallback, openAddDocumentForm, onOpenS4TViewerRequest, onOpenPdfEditorRequest, openFileUploaderPdfEditor, passToArchiveCallback, onReferenceClick, 
 // Tasks
@@ -291,7 +291,7 @@ handleNavigateToWGs, handleNavigateToDossiers, }) => {
             createTaskFromDocumentOrWorkItem();
         }
     };
-    const { operationItems, renderFloatingBar, renderDcmtOperations, features } = useDocumentOperations({
+    const { operationItems, renderFloatingBar, renderDcmtOperations, features, } = useDocumentOperations({
         context: context,
         documentData: {
             dtd: fromDTD,
@@ -361,6 +361,7 @@ handleNavigateToWGs, handleNavigateToDossiers, }) => {
             onTaskCreateRequest,
             openTaskFormHandler,
         },
+        mergePdfManager,
     });
     const { isOpenDcmtForm, openFormHandler, dcmtFormLayoutMode, onDcmtFormOpenChange, showSearchTMDatagrid, showExportForm, isOpenBatchUpdate, isModifiedBatchUpdate, updateBatchUpdateForm, closeDcmtFormHandler, handleSignApprove, checkoutInfo: { showCicoWaitPanel, cicoWaitPanelTitle, showCicoPrimaryProgress, cicoPrimaryProgressText, cicoPrimaryProgressValue, cicoPrimaryProgressMax, }, dcmtOperations: { abortController, showWaitPanel, showPrimary, waitPanelTitle, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary, downloadDcmtsAsync, runOperationAsync, }, relatedDocumentsInfo: { isOpenDetails, isOpenMaster, checkRelatedDcmtsArchiveCapability, checkManyToManyCapability, }, toppyOperations: { showApprovePopup, showRejectPopup, showReAssignPopup, showMoreInfoPopup, updateShowApprovePopup, updateShowRejectPopup, updateShowReAssignPopup, updateShowMoreInfoPopup } } = features;
     const deviceType = useDeviceType();

package/lib/components/forms/Login/TMLoginForm.d.ts

@@ -31,6 +31,14 @@ export declare const cultureIDsDataSource: {
     value: CultureIDs;
     display: string;
 }[];
+export interface ITMLoginDefaultValues {
+    endpoint: string;
+    archiveId?: string;
+    authenticationMode?: AuthenticationModes;
+    username?: string;
+    behalfUsername?: string;
+    domain?: string;
+}
 interface ITMLoginFormProps {
     isConnector?: boolean;
     sdInput?: SessionDescriptor;
@@ -39,6 +47,7 @@ interface ITMLoginFormProps {
     onLogged: (tmSession: ITopMediaSession) => void;
     onChangeLanguage?: (e: CultureIDs) => void;
     cultureID?: CultureIDs;
+    defaultLoginValues?: ITMLoginDefaultValues;
 }
 declare const TMLoginForm: React.FunctionComponent<ITMLoginFormProps>;
 export default TMLoginForm;

package/lib/components/forms/Login/TMLoginForm.js

@@ -106,6 +106,7 @@ const TMLoginForm = (props) => {
     const passwordRef = useRef(null);
     const usernameOnBehalfOfRef = useRef(null);
     const passwordOnBehalfOfRRef = useRef(null);
+    const defaultLoginAppliedRef = useRef(false);
     const [loginStep, setLoginStep] = useState(1);
     const [tmServer, setTmServer] = useState();
     const [tmSession, setTmSession] = useState();
@@ -201,6 +202,23 @@ const TMLoginForm = (props) => {
                 setUsername(props.sdInput.userName);
         }
     }, []);
+    useEffect(() => {
+        if (!props.defaultLoginValues)
+            return;
+        const matchingEndpoint = props.endpoints.find(ep => ep.URL === props.defaultLoginValues.endpoint);
+        if (!matchingEndpoint)
+            return;
+        setEndpoint(matchingEndpoint);
+        if (props.defaultLoginValues.archiveId)
+            setManualArchiveID(props.defaultLoginValues.archiveId);
+        setAuthMode(props.defaultLoginValues.authenticationMode ?? AuthenticationModes.TopMedia);
+        if (props.defaultLoginValues.username)
+            setUsername(props.defaultLoginValues.username);
+        if (props.defaultLoginValues.domain)
+            setAuthDomain(props.defaultLoginValues.domain);
+        if (props.defaultLoginValues.behalfUsername)
+            setUsernameOnBehalf(props.defaultLoginValues.behalfUsername);
+    }, [props.defaultLoginValues, props.endpoints]);
     useEffect(() => {
         if (!hasSingleOption)
             return;
@@ -216,6 +234,9 @@ const TMLoginForm = (props) => {
         setDcmtArchive(undefined);
     }, [isSuccess]);
     useEffect(() => {
+        // Skip default endpoint
+        if (props.defaultLoginValues && props.endpoints.some(ep => ep.URL === props.defaultLoginValues.endpoint))
+            return;
         let preferredRapidAccess = localRa?.find(ar => ar.preferred === true);
         if (preferredRapidAccess) {
             handleRapidAccessSelection(preferredRapidAccess);
@@ -240,6 +261,29 @@ const TMLoginForm = (props) => {
     useEffect(() => {
         getArchivesAsync();
     }, [tmSession]);
+    // Default values and step management 
+    useEffect(() => {
+        if (!props.defaultLoginValues || !props.defaultLoginValues.archiveId || defaultLoginAppliedRef.current || !tmSession || !tmSession.TopMediaServer?.BaseAddress)
+            return;
+        defaultLoginAppliedRef.current = true;
+        const archiveId = props.defaultLoginValues.archiveId;
+        const validateAndAdvance = async () => {
+            try {
+                TMSpinner.show({ description: '' });
+                const archiveEngine = tmSession.NewArchiveEngine();
+                const result = await archiveEngine.RetrieveAsync(archiveId);
+                setDcmtArchive(result);
+                setLoginStep(2);
+            }
+            catch (e) {
+                TMExceptionBoxManager.show({ exception: e });
+            }
+            finally {
+                TMSpinner.hide();
+            }
+        };
+        validateAndAdvance();
+    }, [tmSession, props.defaultLoginValues]);
     useEffect(() => {
         if (!saveLoginEnable || !dcmtArchive)
             return;

package/lib/helper/SDKUI_Globals.d.ts

@@ -1,5 +1,20 @@
 import { InvoiceRetrieveFormats, ObjectClasses, OrderRetrieveFormats } from "@topconsultnpm/sdk-ts";
 import { CheckoutInfo } from "./checkinCheckoutManager";
+export type FileNamingMode = 'onlyDid' | 'documentTypeAndDid' | 'documentTypeAndCustomMetadata' | 'onlyCustomMetadata';
+export type FileExistsMode = 'overwrite' | 'skip' | 'rename';
+export declare class DocumentDownloadSettings {
+    exportMode: 'copy' | 'zip';
+    destinationFolder: string;
+    zipFileName: string;
+    zipPassword: string;
+    fileNamingMode: FileNamingMode;
+    separatorChar: string;
+    invoiceFormat: InvoiceRetrieveFormats;
+    orderFormat: OrderRetrieveFormats;
+    fileExistsMode: FileExistsMode;
+    removeSignature: boolean;
+    pdfFileName: string;
+}
 export declare const dcmtsFileCacheDownload: Map<string, File>;
 export declare const dcmtsFileCachePreview: Map<string, File>;
 export declare const CACHE_SIZE_LIMIT = 10;
@@ -22,6 +37,7 @@ export declare class UserSettings {
     wgDraftCheckoutInfo: CheckoutInfo[];
     dcmtCheckoutInfo: CheckoutInfo[];
     defaultCheckInOutFolder: string;
+    documentDownloadSettings: DocumentDownloadSettings;
     constructor(skipCssUpdate?: boolean);
     /** Load settings from local storage or other sources */
     static LoadSettings(userID: number | undefined, archiveID: string | undefined): UserSettings;

package/lib/helper/SDKUI_Globals.js

@@ -1,6 +1,20 @@
 import { InvoiceRetrieveFormats, LocalStorageService, OrderRetrieveFormats } from "@topconsultnpm/sdk-ts";
 import { FontSize } from "../utils/theme";
-// import { LandingPages } from "./helpers";
+export class DocumentDownloadSettings {
+    constructor() {
+        this.exportMode = 'copy';
+        this.destinationFolder = 'Download';
+        this.zipFileName = '';
+        this.zipPassword = '';
+        this.fileNamingMode = 'documentTypeAndDid';
+        this.separatorChar = '_';
+        this.invoiceFormat = InvoiceRetrieveFormats.ASW_HTML;
+        this.orderFormat = OrderRetrieveFormats.NSO_HTML;
+        this.fileExistsMode = 'overwrite';
+        this.removeSignature = false;
+        this.pdfFileName = '';
+    }
+}
 export const dcmtsFileCacheDownload = new Map();
 export const dcmtsFileCachePreview = new Map();
 export const CACHE_SIZE_LIMIT = 10;
@@ -24,6 +38,7 @@ export class UserSettings {
         this.wgDraftCheckoutInfo = [];
         this.dcmtCheckoutInfo = [];
         this.defaultCheckInOutFolder = DEFAULT_CHECK_IN_OUT_FOLDER;
+        this.documentDownloadSettings = new DocumentDownloadSettings();
         this.themeSettings = new ThemeSettings(skipCssUpdate);
     }
     /** Load settings from local storage or other sources */

package/lib/helper/TMUtils.d.ts

@@ -53,4 +53,23 @@ type DcmtFormToolbarVisibility = {
     tmDcmtTasks: boolean;
 };
 export declare const getDcmtFormToolbarVisibility: (appModuleID: AppModules) => DcmtFormToolbarVisibility;
+export type MergePdfManagerType = {
+    merge: (files: File[], options?: {
+        onProgress?: (current: number, total: number, file: File) => void;
+    }) => Promise<{
+        bytes: Uint8Array;
+        blob: Blob;
+        pageCount: number;
+    }>;
+    mergeToFile: (files: File[], fileName?: string, options?: {
+        onProgress?: (current: number, total: number, file: File) => void;
+    }) => Promise<File>;
+    mergeAndDownload: (files: File[], fileName?: string, options?: {
+        onProgress?: (current: number, total: number, file: File) => void;
+    }) => Promise<{
+        bytes: Uint8Array;
+        blob: Blob;
+        pageCount: number;
+    }>;
+};
 export {};

package/lib/helper/ZipManager.d.ts

@@ -0,0 +1,56 @@
+/** File da aggiungere allo ZIP */
+export interface ZipFileEntry {
+    /** Nome/percorso nello ZIP (es. "docs/file.txt") */
+    filename: string;
+    /** Contenuto: string, File, Blob, ArrayBuffer o Uint8Array */
+    data: File | Blob | string | ArrayBuffer | Uint8Array;
+    /** Commento opzionale */
+    comment?: string;
+    /** Data modifica (default: ora) */
+    lastModDate?: Date;
+}
+/** Opzioni creazione ZIP */
+export interface ZipCreateOptions {
+    /** Password AES (opzionale) */
+    password?: string;
+    /** Compressione 0-9 (default: 6) */
+    compressionLevel?: number;
+    /** Cifratura: 1=128bit, 2=192bit, 3=256bit (default: 3) */
+    encryptionStrength?: 1 | 2 | 3;
+    /** Commento globale ZIP */
+    comment?: string;
+    /** Callback progresso: (indice, totale, nomeFile) */
+    onProgress?: (index: number, total: number, filename: string) => void;
+    /** Callback progresso singolo file: (bytesElaborati, bytesTotali) */
+    onEntryProgress?: (progress: number, total: number) => void;
+    /** AbortSignal per annullare */
+    signal?: AbortSignal;
+}
+/**
+ * Utility per creare file ZIP con password opzionale (AES-256).
+ * Tutti i metodi sono statici.
+ */
+export declare class ZipManager {
+    /** Configura zip.js (useWebWorkers, maxWorkers) */
+    static configure(options: {
+        useWebWorkers?: boolean;
+        maxWorkers?: number;
+    }): void;
+    /** Crea ZIP da array di file */
+    static createZip(files: ZipFileEntry[], options?: ZipCreateOptions): Promise<Blob>;
+    /** Crea ZIP da singolo file */
+    static createZipFromFile(filename: string, data: File | Blob | string | ArrayBuffer | Uint8Array, options?: ZipCreateOptions): Promise<Blob>;
+    /** Crea ZIP da oggetto { nomeFile: contenuto } */
+    static createZipFromMap(filesMap: Record<string, File | Blob | string | ArrayBuffer | Uint8Array>, options?: ZipCreateOptions): Promise<Blob>;
+    /** Crea ZIP e avvia download */
+    static createAndDownload(files: ZipFileEntry[], downloadFilename: string, options?: ZipCreateOptions): Promise<void>;
+    /** Scarica un Blob come file */
+    static downloadBlob(blob: Blob, filename: string): void;
+    /** Crea URL temporaneo per Blob (ricordarsi revokeObjectURL!) */
+    static createObjectURL(blob: Blob): string;
+    /** Rilascia URL creato con createObjectURL */
+    static revokeObjectURL(url: string): void;
+    /** Converte data nel reader appropriato per zip.js */
+    private static createReader;
+}
+export default ZipManager;