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

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

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

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

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

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

@@ -1,263 +0,0 @@
-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/helper/ZipManager.d.ts

@@ -1,56 +0,0 @@
-/** 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;

package/lib/helper/ZipManager.js

@@ -1,104 +0,0 @@
-import { BlobReader, BlobWriter, TextReader, Uint8ArrayReader, ZipWriter, configure } from "@zip.js/zip.js";
-// ============================================================================
-// ZIP MANAGER CLASS
-// ============================================================================
-/**
- * Utility per creare file ZIP con password opzionale (AES-256).
- * Tutti i metodi sono statici.
- */
-export class ZipManager {
-    /** Configura zip.js (useWebWorkers, maxWorkers) */
-    static configure(options) {
-        configure(options);
-    }
-    // ========================================================================
-    // CREAZIONE ZIP
-    // ========================================================================
-    /** Crea ZIP da array di file */
-    static async createZip(files, options = {}) {
-        const { password, compressionLevel = 6, encryptionStrength = 3, comment, onProgress, onEntryProgress, signal } = options;
-        // Validazione password: stringa vuota = nessuna cifratura
-        const usePassword = typeof password === "string" && password.length > 0 ? password : undefined;
-        const blobWriter = new BlobWriter("application/zip");
-        const zipWriter = new ZipWriter(blobWriter, { password: usePassword, zipCrypto: true });
-        try {
-            const total = files.length;
-            for (let i = 0; i < files.length; i++) {
-                if (signal?.aborted) {
-                    throw new DOMException("Operazione annullata", "AbortError");
-                }
-                const file = files[i];
-                onProgress?.(i + 1, total, file.filename);
-                const reader = this.createReader(file.data);
-                await zipWriter.add(file.filename, reader, {
-                    comment: file.comment,
-                    lastModDate: file.lastModDate,
-                    signal,
-                    password: usePassword,
-                    encryptionStrength,
-                    onprogress: onEntryProgress ? (progress, total) => onEntryProgress(progress, total) : undefined
-                });
-            }
-            const commentBytes = comment ? new TextEncoder().encode(comment) : undefined;
-            return await zipWriter.close(commentBytes);
-        }
-        catch (error) {
-            try {
-                await zipWriter.close();
-            }
-            catch { /* ignora */ }
-            throw error;
-        }
-    }
-    /** Crea ZIP da singolo file */
-    static async createZipFromFile(filename, data, options = {}) {
-        return this.createZip([{ filename, data }], options);
-    }
-    /** Crea ZIP da oggetto { nomeFile: contenuto } */
-    static async createZipFromMap(filesMap, options = {}) {
-        const files = Object.entries(filesMap).map(([filename, data]) => ({ filename, data }));
-        return this.createZip(files, options);
-    }
-    // ========================================================================
-    // DOWNLOAD
-    // ========================================================================
-    /** Crea ZIP e avvia download */
-    static async createAndDownload(files, downloadFilename, options = {}) {
-        const blob = await this.createZip(files, options);
-        this.downloadBlob(blob, downloadFilename);
-    }
-    /** Scarica un Blob come file */
-    static downloadBlob(blob, filename) {
-        const url = URL.createObjectURL(blob);
-        const link = document.createElement("a");
-        link.href = url;
-        link.download = filename;
-        link.style.display = "none";
-        document.body.appendChild(link);
-        link.click();
-        document.body.removeChild(link);
-        setTimeout(() => URL.revokeObjectURL(url), 100);
-    }
-    /** Crea URL temporaneo per Blob (ricordarsi revokeObjectURL!) */
-    static createObjectURL(blob) {
-        return URL.createObjectURL(blob);
-    }
-    /** Rilascia URL creato con createObjectURL */
-    static revokeObjectURL(url) {
-        URL.revokeObjectURL(url);
-    }
-    // ========================================================================
-    // PRIVATE
-    // ========================================================================
-    /** Converte data nel reader appropriato per zip.js */
-    static createReader(data) {
-        if (typeof data === "string")
-            return new TextReader(data);
-        if (data instanceof Uint8Array)
-            return new Uint8ArrayReader(data);
-        if (data instanceof ArrayBuffer)
-            return new Uint8ArrayReader(new Uint8Array(data));
-        return new BlobReader(data);
-    }
-}
-export default ZipManager;