@topconsultnpm/sdkui-react 6.22.0-dev2.9 → 6.22.0-dev3.10

package/lib/hooks/useDcmtOperations.js

@@ -9,6 +9,10 @@ import { importCertificatesAsync } from '../helper/certificateImportHelper';
 import { isXMLFileExt } from '../helper/dcmtsHelper';
 import { ShowConfirm } from '../components/base/TMConfirm';
 import { generateTargetFileName } from '../components/features/documents/copyAndMergeDcmtsShared';
+/** Limite massimo di download paralleli accettato da `downloadDcmtsAsync`. */
+const MAX_DOWNLOAD_CONCURRENCY = 8;
+/** Intervallo minimo (ms) fra due aggiornamenti della progress bar di download. */
+const DOWNLOAD_PROGRESS_THROTTLE_MS = 100;
 const isScannerLicenseConfigured = () => {
     try {
         const scannerLicense = SDKUI_Globals.userSettings.advancedSettings.scannerLicense;
@@ -257,7 +261,7 @@ export const useDcmtOperations = () => {
             ShowAlert({ message: SDKUI_Localizator.ZipCreatedSavedInFolder.replaceParams(zipFileName, "Zip creato con successo"), mode: 'success', duration: 5000, title: SDKUI_Localizator.CompressToZipFile });
         }
     };
-    const _downloadDcmtsAsync = async (inputDcmts, downloadMode = "download", onFileDownloaded, skipConfirmation = false, retrieveOptions, useCache = true, showSuccessAlert = true, useInputFileName = false) => {
+    const _downloadDcmtsAsync = async (inputDcmts, downloadMode = "download", onFileDownloaded, skipConfirmation = false, retrieveOptions, useCache = true, showSuccessAlert = true, useInputFileName = false, downloadConcurrency = 1) => {
         if (inputDcmts === undefined)
             return;
         if (inputDcmts.length <= 0)
@@ -286,85 +290,150 @@ export const useDcmtOperations = () => {
         setShowSecondary(true);
         setWaitPanelTitle(operationTitle);
         abortController = new AbortController();
-        const rfo = new RetrieveFileOptions();
-        rfo.retrieveReason = retrieveOptions?.retrieveReason ?? DcmtOpers.ShowFile;
-        if (retrieveOptions?.cvtFormat !== undefined)
-            rfo.cvtFormat = retrieveOptions.cvtFormat;
-        if (retrieveOptions?.generalRetrieveFormat !== undefined)
-            rfo.generalRetrieveFormat = retrieveOptions.generalRetrieveFormat;
-        rfo.invoiceRetrieveFormat = retrieveOptions?.invoiceRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.invoiceRetrieveFormat;
-        rfo.orderRetrieveFormat = retrieveOptions?.orderRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.orderRetrieveFormat;
-        let result = [];
-        setWaitPanelMaxValuePrimary(inputDcmts.length);
-        let firstBlock = true;
-        let maxFileSize = 0;
-        for (let i = 0; i < inputDcmts.length; i++) {
-            if (abortController.signal.aborted) {
-                result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${i + 1} documenti` });
-                break;
+        // Riferimento const: il narrowing su inputDcmts non sopravvive dentro le closure del pool.
+        const dcmts = inputDcmts;
+        /**
+         * Ogni richiesta usa la propria istanza di RetrieveFileOptions: con il pool più
+         * download sono in volo contemporaneamente e non possono condividere lo stesso oggetto.
+         */
+        const buildRetrieveFileOptions = (dcmt) => {
+            const rfo = new RetrieveFileOptions();
+            rfo.retrieveReason = retrieveOptions?.retrieveReason ?? DcmtOpers.ShowFile;
+            if (retrieveOptions?.cvtFormat !== undefined)
+                rfo.cvtFormat = retrieveOptions.cvtFormat;
+            if (retrieveOptions?.generalRetrieveFormat !== undefined)
+                rfo.generalRetrieveFormat = retrieveOptions.generalRetrieveFormat;
+            rfo.invoiceRetrieveFormat = retrieveOptions?.invoiceRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.invoiceRetrieveFormat;
+            rfo.orderRetrieveFormat = retrieveOptions?.orderRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.orderRetrieveFormat;
+            return rfo;
+        };
+        const results = new Array(dcmts.length);
+        setWaitPanelMaxValuePrimary(dcmts.length);
+        // ---- Progress secondaria: aggregata sui download in volo e throttlata ----
+        // Gli eventi di avanzamento di axios arrivano a ogni chunk: senza throttle ognuno
+        // provoca un re-render dell'intera form (relation viewer compreso).
+        const inFlightBytes = new Map();
+        let pendingSecondary;
+        let secondaryTimer;
+        const flushSecondaryProgress = () => {
+            secondaryTimer = undefined;
+            if (!pendingSecondary)
+                return;
+            setWaitPanelMaxValueSecondary(pendingSecondary.max);
+            setWaitPanelValueSecondary(pendingSecondary.value);
+            setWaitPanelTextSecondary(pendingSecondary.text);
+            pendingSecondary = undefined;
+        };
+        const publishSecondaryProgress = () => {
+            let loaded = 0;
+            let total = 0;
+            for (const bytes of inFlightBytes.values()) {
+                loaded += bytes.loaded;
+                total += bytes.total;
             }
-            try {
-                setWaitPanelTextPrimary(`Download file ${i + 1} di ${inputDcmts.length}`);
-                let file;
-                const cacheKey = `${inputDcmts[i].TID}-${inputDcmts[i].DID}`;
-                if (useCache && dcmtsFileCacheDownload.has(cacheKey)) {
-                    file = dcmtsFileCacheDownload.get(cacheKey);
+            pendingSecondary = total > 0
+                ? { value: loaded, max: total, text: `Downloading... ${Globalization.getNumberDisplayValue(loaded, true)} / ${Globalization.getNumberDisplayValue(total, true)}` }
+                : { value: 0, max: 0, text: '' };
+            if (secondaryTimer === undefined)
+                secondaryTimer = setTimeout(flushSecondaryProgress, DOWNLOAD_PROGRESS_THROTTLE_MS);
+        };
+        // ---- Pool di download ----
+        let nextIndex = 0;
+        let started = 0;
+        let completed = 0;
+        let abortReported = false;
+        const downloadOne = async (i) => {
+            started++;
+            setWaitPanelTextPrimary(`Download file ${started} di ${dcmts.length}`);
+            let file;
+            const cacheKey = `${dcmts[i].TID}-${dcmts[i].DID}`;
+            if (useCache && dcmtsFileCacheDownload.has(cacheKey)) {
+                file = dcmtsFileCacheDownload.get(cacheKey);
+            }
+            else {
+                inFlightBytes.set(i, { loaded: 0, total: 0 });
+                try {
+                    file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(dcmts[i].TID, dcmts[i].DID, buildRetrieveFileOptions(dcmts[i]), abortController.signal, (pd) => {
+                        inFlightBytes.set(i, { loaded: pd.ProgressBarValue, total: pd.ProgressBarMaximum ?? 0 });
+                        publishSecondaryProgress();
+                    });
+                }
+                finally {
+                    inFlightBytes.delete(i);
+                    publishSecondaryProgress();
+                }
+            }
+            completed++;
+            setWaitPanelValuePrimary(completed);
+            if (downloadMode === "openInNewWindow") {
+                if (onFileDownloaded && file) {
+                    onFileDownloaded(file, dcmts[i]);
                 }
                 else {
-                    file = await SDK_Globals.tmSession?.NewSearchEngine().RetrieveFileAsync(inputDcmts[i].TID, inputDcmts[i].DID, rfo, abortController.signal, (pd) => {
-                        if (firstBlock) {
-                            maxFileSize = pd.ProgressBarMaximum ?? 0;
-                            setWaitPanelMaxValueSecondary(maxFileSize);
-                            firstBlock = false;
-                        }
-                        setWaitPanelValueSecondary(pd.ProgressBarValue);
-                        setWaitPanelTextSecondary(`Downloading... ${Globalization.getNumberDisplayValue(pd.ProgressBarValue, true)} / ${Globalization.getNumberDisplayValue(maxFileSize, true)}`);
-                        if (pd.ProgressBarValue === pd.ProgressBarMaximum) {
-                            setWaitPanelMaxValueSecondary(0);
-                            setWaitPanelValueSecondary(0);
-                            setWaitPanelTextSecondary('');
-                            firstBlock = true;
-                        }
-                    });
+                    window.open(window.URL.createObjectURL(file), '_blank', 'noopener');
                 }
-                setWaitPanelValuePrimary(i + 1);
-                const fileURL = window.URL.createObjectURL(file);
-                if (downloadMode === "openInNewWindow") {
-                    (onFileDownloaded && file)
-                        ? onFileDownloaded(file, inputDcmts[i])
-                        : window.open(fileURL, '_blank', 'noopener');
+            }
+            else {
+                if (onFileDownloaded && file) {
+                    await onFileDownloaded(file, dcmts[i]);
                 }
                 else {
-                    if (onFileDownloaded && file) {
-                        await onFileDownloaded(file, inputDcmts[i]);
-                    }
-                    else {
-                        const alink2 = document.createElement('a');
-                        alink2.href = fileURL;
-                        // Usa useInputFileName per determinare la priorità del nome file
-                        alink2.download = getDownloadFileName(file, inputDcmts[i], useInputFileName);
-                        alink2.target = "_blank";
-                        alink2.rel = "noreferrer";
-                        alink2.click();
-                    }
+                    // L'object URL serve solo in questo ramo: creato qui e revocato dopo il
+                    // click, così i blob non restano agganciati al documento per sempre.
+                    const fileURL = window.URL.createObjectURL(file);
+                    const alink2 = document.createElement('a');
+                    alink2.href = fileURL;
+                    // Usa useInputFileName per determinare la priorità del nome file
+                    alink2.download = getDownloadFileName(file, dcmts[i], useInputFileName);
+                    alink2.target = "_blank";
+                    alink2.rel = "noreferrer";
+                    alink2.click();
+                    // 60s come per l'iframe di stampa: revocare troppo presto può far fallire
+                    // il download se il browser non ha ancora risolto il blob URL.
+                    setTimeout(() => window.URL.revokeObjectURL(fileURL), 60000);
                 }
-                if (useCache) {
-                    if (dcmtsFileCacheDownload.size >= CACHE_SIZE_LIMIT) {
-                        const oldestKey = dcmtsFileCacheDownload.keys().next().value;
-                        dcmtsFileCacheDownload.delete(oldestKey);
-                    }
-                    dcmtsFileCacheDownload.set(cacheKey, file);
+            }
+            if (useCache) {
+                if (dcmtsFileCacheDownload.size >= CACHE_SIZE_LIMIT) {
+                    const oldestKey = dcmtsFileCacheDownload.keys().next().value;
+                    dcmtsFileCacheDownload.delete(oldestKey);
                 }
-                result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.SUCCESS });
+                dcmtsFileCacheDownload.set(cacheKey, file);
             }
-            catch (ex) {
-                result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(ex) });
-                const err = ex;
-                if (err.name === 'CanceledError') {
-                    ShowAlert({ message: err.message, mode: 'warning', duration: 3000, title: 'Abort' });
+            results[i] = { rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.SUCCESS };
+        };
+        const runWorker = async () => {
+            while (true) {
+                const i = nextIndex++;
+                if (i >= dcmts.length)
+                    return;
+                if (abortController.signal.aborted) {
+                    // Un solo avviso di interruzione anche quando più worker si fermano insieme.
+                    if (!abortReported) {
+                        abortReported = true;
+                        results[i] = { rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.WARNING, description: `Operazione interrotta. Elaborati ${completed} documenti` };
+                    }
+                    return;
+                }
+                try {
+                    await downloadOne(i);
+                }
+                catch (ex) {
+                    results[i] = { rowIndex: i, id1: dcmts[i].TID, id2: dcmts[i].DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(ex) };
+                    const err = ex;
+                    if (err.name === 'CanceledError') {
+                        ShowAlert({ message: err.message, mode: 'warning', duration: 3000, title: 'Abort' });
+                    }
                 }
             }
-        }
+        };
+        // `|| 1` intercetta NaN/0/negativi: senza, Array.from({length: NaN}) non creerebbe
+        // alcun worker e il download terminerebbe in silenzio senza scaricare nulla.
+        const workers = Math.max(1, Math.min(Math.trunc(downloadConcurrency) || 1, MAX_DOWNLOAD_CONCURRENCY, dcmts.length));
+        await Promise.all(Array.from({ length: workers }, () => runWorker()));
+        if (secondaryTimer !== undefined)
+            clearTimeout(secondaryTimer);
+        const result = results.filter((r) => r !== undefined);
         setWaitPanelTextPrimary('');
         setWaitPanelMaxValuePrimary(0);
         setWaitPanelValuePrimary(0);
@@ -436,12 +505,13 @@ export const useDcmtOperations = () => {
     };
     const downloadDcmtsAsync = async (params) => {
         const { inputDcmts, downloadType = DownloadTypes.Attachment, downloadMode = "download", onFileDownloaded, confirmAttachments, skipConfirmation = false, retrieveOptions, useCache = true, showSuccessAlert = true, useInputFileName = false, // Default: usa il nome dal backend
+        downloadConcurrency = 1, // Default: sequenziale
          } = params;
         switch (downloadType) {
             // Per il download di documenti, passa useInputFileName per controllare la priorità del nome
-            case DownloadTypes.Dcmt: return await _downloadDcmtsAsync(inputDcmts, downloadMode, onFileDownloaded, skipConfirmation, retrieveOptions, useCache, showSuccessAlert, useInputFileName);
+            case DownloadTypes.Dcmt: return await _downloadDcmtsAsync(inputDcmts, downloadMode, onFileDownloaded, skipConfirmation, retrieveOptions, useCache, showSuccessAlert, useInputFileName, downloadConcurrency);
             case DownloadTypes.Attachment: return await _downloadAttachmentsAsync(inputDcmts, confirmAttachments, showSuccessAlert);
-            default: return await _downloadDcmtsAsync(inputDcmts, undefined, undefined, skipConfirmation, retrieveOptions, useCache, showSuccessAlert, useInputFileName);
+            default: return await _downloadDcmtsAsync(inputDcmts, undefined, undefined, skipConfirmation, retrieveOptions, useCache, showSuccessAlert, useInputFileName, downloadConcurrency);
         }
     };
     const uploadDcmtsAsync = async (inputDcmts, operationTitle, operType, actionAfterOperationAsync) => {

package/lib/hooks/useDocumentOperations.d.ts

@@ -105,10 +105,13 @@ interface UseDocumentOperationsProps {
 }
 export interface UseDocumentOperationsResult {
     operationItems: Array<TMContextMenuItemProps>;
+    selectedDcmtInfos: Array<DcmtInfo>;
     renderFloatingBar: React.ReactNode;
     renderDcmtOperations: React.ReactNode;
     features: {
         isOpenDcmtForm: boolean;
+        /** Il form del documento è aperto come popup sopra il contenuto, che resta visibile sotto */
+        isDcmtFormModal: boolean;
         openFormHandler: (layoutMode: LayoutModes) => void;
         dcmtFormLayoutMode: LayoutModes;
         onDcmtFormOpenChange: (isOpen: boolean, layoutMode: LayoutModes) => void;
@@ -118,6 +121,7 @@ export interface UseDocumentOperationsResult {
         closeDcmtFormHandler: () => void;
         handleSignApprove: () => void;
         showSearchTMDatagrid: boolean;
+        showDcmtTypesSelection: boolean;
         showExportForm: boolean;
         checkoutInfo: UseCheckInOutOperationsReturn;
         relatedDocumentsInfo: UseRelatedDocumentsReturn;

package/lib/hooks/useDocumentOperations.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
 import { AccessLevels, AccessLevelsEx, AppModules, DcmtOpers, DcmtTypeListCacheService, FileFormats, GeneralRetrieveFormats, LayoutModes, RetrieveFileOptions, SDK_Globals } from "@topconsultnpm/sdk-ts";
 import { DcmtOperationTypes, DownloadTypes, SearchResultContext } from "../ts";
@@ -21,10 +21,11 @@ import { useDcmtOperations } from "./useDcmtOperations";
 import useFloatingBarPinnedItems from "./useFloatingBarPinnedItems";
 import { useInputAttachmentsDialog, useInputCvtFormatDialog } from "./useInputDialog";
 import { useRelatedDocuments } from "./useRelatedDocuments";
-import { convertSearchResultDescriptorToFileItems, dcmtsFileCachePreview, getDcmtCicoStatus, getMoreInfoTasksForDocument, IconActivity, IconArchiveDetail, IconArchiveDoc, IconArchiveMaster, IconBatchUpdate, IconCheck, IconCheckFile, IconCheckIn, IconCircleInfo, IconCloseCircle, IconConvertFilePdf, IconCopy, IconCustom, IconDelete, IconDetailDcmts, IconDotsVerticalCircleOutline, IconDownload, IconEdit, IconExportTo, IconFileDots, IconHide, IconInfo, IconMenuCAArchive, IconMoveToFolder, IconPair, IconPin, IconPlatform, IconPreview, IconRelation, IconSearch, IconShare, IconSharedDcmt, IconShow, IconSignaturePencil, IconStar, IconSubstFile, IconUndo, IconUnpair, IconUserGroupOutline, isConvertibleToPdfExt, isPdfEditorAvailable, S4T_USER_REGISTRY_MASTER, SDKUI_Globals, SDKUI_Localizator, searchResultToMetadataValues, TMImageLibrary, IconCertificateBadge } from '../helper';
+import { convertSearchResultDescriptorToFileItems, dcmtsFileCachePreview, getDcmtCicoStatus, getMoreInfoTasksForDocument, IconActivity, IconArchiveDetail, IconArchiveDoc, IconArchiveMaster, IconBatchUpdate, IconCheck, IconCheckFile, IconCheckIn, IconCircleInfo, IconCloseCircle, IconConvertFilePdf, IconCopy, IconCustom, IconDelete, IconDetailDcmts, IconDotsVerticalCircleOutline, IconDownload, IconEdit, IconExportTo, IconFileDots, IconHide, IconInfo, IconMenuCAArchive, IconMoveToFolder, IconPair, IconPin, IconPlatform, IconPreview, IconRelation, IconSearch, IconShare, IconSharedDcmt, IconShow, IconSignaturePencil, IconStar, IconSubstFile, IconUndo, IconUnpair, IconUserGroupOutline, isConvertibleToPdfExt, isPdfEditorAvailable, S4T_USER_REGISTRY_MASTER, SDKUI_Globals, SDKUI_Localizator, searchResultToMetadataValues, TMImageLibrary, IconCertificateBadge, IconArchiveMultipleDetailDocuments, isDraftsDTD } from '../helper';
 import { isXMLFileExt } from "../helper/dcmtsHelper";
 import TMCopyToFolderForm from "../components/features/documents/TMCopyToFolderForm";
 import TMMergeToPdfForm from "../components/features/documents/TMMergeToPdfForm";
+import TMMultiMasterDetailDcmtsForm from "../components/features/documents/TMMultiMasterDetailDcmtsForm";
 export const getSelectedDcmtsOrFocused = (selectedItems, focusedItem, fileFormat) => {
     if (selectedItems.length <= 0 && !focusedItem)
         return [];
@@ -116,7 +117,7 @@ export const useDocumentOperations = (props) => {
     // Data
     relatedDcmts, pairedSearchResults, manyToManyRelations, selectedManyToManyRelation, manyToManyChooserDataSource, relatedDcmtsChooserDataSource, 
     // Flags / State booleans
-    showRelatedDcmtsChooser, isOpenDetails, isOpenMaster, isOpenArchiveRelationForm, isPairingManyToMany, showManyToManyChooser, showPairSearchModal, currentTIDHasDetailRelations, currentTIDHasMasterRelations, canArchiveMasterRelation, canArchiveDetailRelation, hasManyToManyRelation, showPairDcmtsModal, 
+    showRelatedDcmtsChooser, isOpenDetails, isOpenMaster, isOpenArchiveRelationForm, isPairingManyToMany, showManyToManyChooser, showPairSearchModal, currentTIDHasDetailRelations, currentTIDHasMasterRelations, canArchiveMasterRelation, canArchiveDetailRelation, hasManyToManyRelation, showPairDcmtsModal, backToPairSearchModal, 
     // Pair search modal state
     pairSearchModalTargetTID, pairSearchModalParentTID, pairSearchModalParentDID, pairSearchModalRelation, pairSearchModalInputMids, 
     // Config
@@ -149,9 +150,16 @@ export const useDocumentOperations = (props) => {
     const [showFloatingBar, setShowFloatingBar] = useState(allowFloatingBar);
     const [isOpenDcmtForm, setIsOpenDcmtForm] = useState(false);
     const [dcmtFormLayoutMode, setDcmtFormLayoutMode] = useState(LayoutModes.Update);
+    /**
+     * Il form del documento è a popup: si sovrappone a chi lo ha aperto, che resta visibile sotto e non
+     * va nascosto. Oltre ai contesti che lo chiedono (openDcmtFormAsModal) è il caso della duplicazione,
+     * che parte da un documento a video (LayoutModes.Ark con un DID) per proporne uno nuovo da archiviare.
+     */
+    const isDcmtFormModal = openDcmtFormAsModal || (dcmtFormLayoutMode === LayoutModes.Ark && focusedItem?.DID !== undefined);
     const [currentCustomButton, setCurrentCustomButton] = useState();
     // State to control the visibility of the details form
     const [showSearchTMDatagrid, setShowSearchTMDatagrid] = useState(false);
+    const [showDcmtTypesSelection, setShowDcmtTypesSelection] = useState(false);
     const [secondaryMasterDcmts, setSecondaryMasterDcmts] = useState([]);
     const [isOpenSharedArchive, setIsOpenSharedArchive] = useState(false);
     const [sharedDcmtFile, setSharedDcmtFile] = useState(undefined);
@@ -169,6 +177,7 @@ export const useDocumentOperations = (props) => {
     // State to control modal opening for master/detail documents
     const [isOpenDetailsModal, setIsOpenDetailsModal] = useState(false);
     const [isOpenMasterModal, setIsOpenMasterModal] = useState(false);
+    const [isOpenMultiDetailModal, setIsOpenMultiDetailModal] = useState(false);
     const openDetailDcmtsFormHandler = (value) => { setIsOpenDetails(value); };
     const openMasterDcmtsFormHandler = (value) => { setIsOpenMaster(value); };
     const openDetailDcmtsModalHandler = (value) => { setIsOpenDetailsModal(value); };
@@ -755,6 +764,7 @@ export const useDocumentOperations = (props) => {
             id: 'cico',
             icon: _jsx(IconFileDots, {}),
             name: "Check in/Check out",
+            visible: !isDraftsDTD(dtd), // Non disponibile per le bozze dei gruppi di lavoro
             disabled: dcmt === undefined || isDisabledForSingleRow(),
             submenu: [
                 {
@@ -877,6 +887,7 @@ export const useDocumentOperations = (props) => {
             name: SDKUI_Localizator.Relations,
             operationType: 'multiRow',
             disabled: isDisabledForMultiRow(),
+            visible: !isDraftsDTD(dtd), // Non disponibile per le bozze dei gruppi di lavoro
             submenu: [
                 {
                     id: 'rel-pair',
@@ -907,10 +918,18 @@ export const useDocumentOperations = (props) => {
                     id: 'rel-ark-det',
                     icon: _jsx(IconArchiveDetail, {}),
                     name: SDKUI_Localizator.ArchiveDetailDocument,
-                    operationType: 'multiRow',
-                    disabled: canArchiveDetailRelation !== true,
+                    operationType: 'singleRow',
+                    disabled: canArchiveDetailRelation !== true || isDisabledForMultiRow(),
                     onClick: async () => await archiveDetailDocuments(selectedDcmtInfos?.[0]?.TID)
                 },
+                {
+                    id: 'multi-detail',
+                    icon: _jsx(IconArchiveMultipleDetailDocuments, {}),
+                    name: SDKUI_Localizator.ArchiveMultipleDetailDocuments,
+                    operationType: 'singleRow',
+                    disabled: canArchiveDetailRelation !== true || isDisabledForMultiRow(),
+                    onClick: () => setIsOpenMultiDetailModal(true),
+                },
                 {
                     id: 'rel-mst',
                     icon: _jsx(IconDetailDcmts, { transform: 'scale(-1, 1)' }),
@@ -1054,6 +1073,7 @@ export const useDocumentOperations = (props) => {
             ]
         };
     };
+    const canToggleDcmtTypesSelection = !isMobile && context === SearchResultContext.WORKFLOW_APPROVE;
     const otherOperationsMenuItem = () => {
         return {
             id: 'oth',
@@ -1085,7 +1105,15 @@ export const useDocumentOperations = (props) => {
                             disabled: false,
                             onClick: () => setShowFloatingBar(prev => !prev)
                         }]
-                    : [])
+                    : []),
+                {
+                    id: 'oth-dcmt-types',
+                    icon: showDcmtTypesSelection ? _jsx(IconHide, {}) : _jsx(IconShow, {}),
+                    name: showDcmtTypesSelection ? SDKUI_Localizator.HideDcmtTypes : SDKUI_Localizator.ShowDcmtTypes,
+                    visible: canToggleDcmtTypesSelection,
+                    disabled: false,
+                    onClick: () => setShowDcmtTypesSelection(prev => !prev)
+                }
             ]
         };
     };
@@ -1345,6 +1373,10 @@ export const useDocumentOperations = (props) => {
         dcmtUtility,
         fetchRemoteCertificates
     };
+    // Navigazione del master nell'archiviazione multipla dei dettagli: il modale prende il documento
+    // con il focus, quindi le frecce hanno senso solo senza selezione a checkbox, che ha la precedenza
+    // sul focus e terrebbe il master fermo (vedi getSelectedDcmtsOrFocused)
+    const canNavigateMultiDetailMaster = !!canNavigateHandler && !!onNavigateHandler && selectedItems.length === 0 && selectedDcmtInfos.length === 1;
     const masterDetailMasterCommonProps = {
         deviceType,
         isForMaster: true,
@@ -1373,15 +1405,16 @@ export const useDocumentOperations = (props) => {
         dcmtUtility,
         fetchRemoteCertificates
     };
-    const renderDcmtOperations = (_jsxs(_Fragment, { children: [(showExportForm && searchResult && dataColumns && dataSource && selectedRowKeys) && (_jsx(TMDataGridExportForm, { dataColumns: dataColumns, dataSource: dataSource, selectedRowKeys: selectedRowKeys, onCloseExportForm: () => setShowExportForm(false), searchResult: searchResult })), _jsx(StyledMultiViewPanel, { "$isVisible": isOpenDcmtForm, children: ((isOpenDcmtForm && focusedItem?.TID !== undefined && focusedItem?.DID !== undefined) &&
-                    _jsx(TMDcmtForm, { isModal: openDcmtFormAsModal || (dcmtFormLayoutMode === LayoutModes.Ark && focusedItem?.DID !== undefined), titleModal: dtd?.name ?? '', TID: focusedItem.TID, DID: focusedItem.DID, allowButtonsRefs: true, showTodoDcmtForm: showTodoDcmtForm, layoutMode: dcmtFormLayoutMode, count: visibleItems?.length, itemIndex: visibleItems ? visibleItems.findIndex(o => o.rowIndex === focusedItem?.rowIndex) + 1 : undefined, canNext: canNavigateHandler ? canNavigateHandler('next') : false, canPrev: canNavigateHandler ? canNavigateHandler('prev') : false, onNext: () => onNavigateHandler && onNavigateHandler('next'), onPrev: () => onNavigateHandler && onNavigateHandler('prev'), onClose: () => { (false); onDcmtFormOpenChange(false, LayoutModes.Update); }, onWFOperationCompleted: onWFOperationCompleted, onTaskCreateRequest: onTaskCreateRequest, onSavedAsyncCallback: onSavedAsyncCallback, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, editPdfForm: editPdfForm, onOpenPdfEditorRequest: onOpenPdfEditorRequest, openFileUploaderPdfEditor: openFileUploaderPdfEditor, onReferenceClick: onReferenceClick, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, moreInfoTasks: getMoreInfoTasksForDocument(allTasks, focusedItem?.TID, focusedItem?.DID), showDcmtFormSidebar: showDcmtFormSidebar, datagridUtility: {
+    const renderDcmtOperations = (_jsxs(_Fragment, { children: [(showExportForm && searchResult && dataColumns && dataSource && selectedRowKeys) && (_jsx(TMDataGridExportForm, { dataColumns: dataColumns, dataSource: dataSource, selectedRowKeys: selectedRowKeys, onCloseExportForm: () => setShowExportForm(false), searchResult: searchResult })), _jsx(StyledMultiViewPanel, { $isVisible: isOpenDcmtForm && !isDcmtFormModal, children: ((isOpenDcmtForm && focusedItem?.TID !== undefined && focusedItem?.DID !== undefined) &&
+                    _jsx(TMDcmtForm, { isModal: isDcmtFormModal, titleModal: dtd?.name ?? '', TID: focusedItem.TID, DID: focusedItem.DID, allowButtonsRefs: true, showTodoDcmtForm: showTodoDcmtForm, layoutMode: dcmtFormLayoutMode, count: visibleItems?.length, itemIndex: visibleItems ? visibleItems.findIndex(o => o.rowIndex === focusedItem?.rowIndex) + 1 : undefined, canNext: canNavigateHandler ? canNavigateHandler('next') : false, canPrev: canNavigateHandler ? canNavigateHandler('prev') : false, onNext: () => onNavigateHandler && onNavigateHandler('next'), onPrev: () => onNavigateHandler && onNavigateHandler('prev'), onClose: () => { (false); onDcmtFormOpenChange(false, LayoutModes.Update); }, onWFOperationCompleted: onWFOperationCompleted, onTaskCreateRequest: onTaskCreateRequest, onSavedAsyncCallback: onSavedAsyncCallback, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, editPdfForm: editPdfForm, onOpenPdfEditorRequest: onOpenPdfEditorRequest, openFileUploaderPdfEditor: openFileUploaderPdfEditor, onReferenceClick: onReferenceClick, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, moreInfoTasks: getMoreInfoTasksForDocument(allTasks, focusedItem?.TID, focusedItem?.DID), showDcmtFormSidebar: showDcmtFormSidebar, datagridUtility: {
                             onRefreshSearchAsyncDatagrid,
                             onRefreshDataRowsAsync,
                             refreshFocusedDataRowAsync,
                             onRefreshBlogDatagrid,
                             onRefreshPreviewDatagrid
                         }, fetchRemoteCertificates: fetchRemoteCertificates, graphometricManager: graphometricManager })) }), (showHistory && dtd && selectedDcmtInfos.length > 0) && _jsx(TMViewHistoryDcmt, { fromDTD: dtd, deviceType: deviceType, inputDcmt: selectedDcmtInfos[0], onClose: hideHistoryCallback, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }), (commentFormState.show && selectedDcmtInfos.length > 0) && _jsx(TMBlogCommentForm, { context: { engine: 'SearchEngine', object: { tid: selectedDcmtInfos[0].TID, did: selectedDcmtInfos[0].DID } }, onClose: hideCommentFormCallback, refreshCallback: onRefreshBlog, participants: [], showAttachmentsSection: true, allArchivedDocumentsFileItems: convertSearchResultDescriptorToFileItems(currentSearchResults ?? []), isCommentRequired: commentFormState.isRequired, removeAndEditAttachment: commentFormState.removeAndEditAttachment, selectedAttachmentDid: [Number(selectedDcmtInfos[0].DID)] }), (showCheckoutInformationForm && dtd && selectedDcmtInfos.length > 0) &&
-                _jsx(TMDcmtCheckoutInfoForm, { dtdName: dtd.name ?? SDKUI_Localizator.SearchResult, selectedDcmtOrFocused: selectedDcmtInfos[0], onClose: hideCheckoutInformationFormCallback }), isOpenDetailsModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenDetailsModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetailsModal(false) }) }), _jsx(StyledMultiViewPanel, { "$isVisible": isOpenDetails, children: isOpenDetails && _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetails(false) }) }), isOpenMasterModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenMasterModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMasterModal(false) }) }), _jsxs(StyledMultiViewPanel, { "$isVisible": isOpenMaster, children: [isOpenMaster && _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMaster(false) }), secondaryMasterDcmts.length > 0 && secondaryMasterDcmts.map((dcmt, index) => {
+                _jsx(TMDcmtCheckoutInfoForm, { dtdName: dtd.name ?? SDKUI_Localizator.SearchResult, selectedDcmtOrFocused: selectedDcmtInfos[0], onClose: hideCheckoutInformationFormCallback }), isOpenDetailsModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenDetailsModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetailsModal(false) }) }), _jsx(StyledMultiViewPanel, { $isVisible: isOpenDetails, children: isOpenDetails && _jsx(TMMasterDetailDcmts, { ...masterDetailDetailsCommonProps, onBack: () => setIsOpenDetails(false) }) }), (isOpenMultiDetailModal && dtd) &&
+                _jsx(TMMultiMasterDetailDcmtsForm, { dtd: dtd, masterDcmt: selectedDcmtInfos[0], onClose: () => setIsOpenMultiDetailModal(false), canNavigateMaster: canNavigateMultiDetailMaster ? canNavigateHandler : undefined, onNavigateMaster: canNavigateMultiDetailMaster ? onNavigateHandler : undefined, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, showDcmtFormSidebar: showDcmtFormSidebar, showTodoDcmtForm: showTodoDcmtForm, openFileUploaderPdfEditor: openFileUploaderPdfEditor, graphometricManager: graphometricManager, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, fetchRemoteCertificates: fetchRemoteCertificates, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, onReferenceClick: onReferenceClick, onTaskCreateRequest: onTaskCreateRequest, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, onFileOpened: onFileOpened, passToArchiveCallback: passToArchiveCallback, openWGsCopyMoveForm: openWGsCopyMoveForm }), isOpenMasterModal && _jsx(TMModal, { width: "95%", height: "95%", onClose: () => setIsOpenMasterModal(false), title: SDKUI_Localizator.Relations, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMasterModal(false) }) }), _jsxs(StyledMultiViewPanel, { $isVisible: isOpenMaster, children: [isOpenMaster && _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, onBack: () => setIsOpenMaster(false) }), secondaryMasterDcmts.length > 0 && secondaryMasterDcmts.map((dcmt, index) => {
                         return (_jsx(StyledModalContainer, { style: { backgroundColor: 'white' }, children: _jsx(TMMasterDetailDcmts, { ...masterDetailMasterCommonProps, inputDcmts: [dcmt], allowNavigation: false, onBack: () => handleRemoveItem(dcmt.TID, dcmt.DID) }) }, `${index}-${dcmt.DID}`));
                     })] }), isOpenArchiveRelationForm && _jsx(TMDcmtForm, { isModal: true, titleModal: SDKUI_Localizator.Archive + ' - ' + (archiveType === 'detail' ? SDKUI_Localizator.DcmtsDetail : SDKUI_Localizator.DcmtsMaster), TID: archiveRelatedDcmtFormTID, layoutMode: LayoutModes.Ark, inputMids: archiveRelatedDcmtFormMids, showBackButton: false, allowButtonsRefs: false, onClose: () => {
                     setIsOpenArchiveRelationForm(false);
@@ -1389,10 +1422,15 @@ export const useDocumentOperations = (props) => {
                     setArchiveRelatedDcmtFormTID(undefined);
                     setArchiveRelatedDcmtFormMids([]);
                 }, onSavedAsyncCallback: async (tid, did, metadataResult) => {
+                    const originDcmt = selectedDcmtInfos?.[0];
                     setIsOpenArchiveRelationForm(false);
                     setArchiveType(undefined);
                     setArchiveRelatedDcmtFormTID(undefined);
                     setArchiveRelatedDcmtFormMids([]);
+                    if (refreshFocusedDataRowAsync && originDcmt?.TID && originDcmt?.DID) {
+                        await refreshFocusedDataRowAsync(originDcmt.TID, originDcmt.DID, true);
+                        return;
+                    }
                     await onRefreshSearchAsyncDatagrid?.();
                 }, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, showDcmtFormSidebar: showDcmtFormSidebar, openFileUploaderPdfEditor: openFileUploaderPdfEditor, showTodoDcmtForm: showTodoDcmtForm, graphometricManager: graphometricManager }), showRelatedDcmtsChooser &&
                 _jsx(TMChooserForm, { dataSource: relatedDcmtsChooserDataSource, onChoose: async (selectedRelation) => {
@@ -1427,8 +1465,8 @@ export const useDocumentOperations = (props) => {
                             TMSpinner.hide();
                         }
                     }, onClose: () => setShowManyToManyChooser(false), manageUseLocalizedName: false }), showPairDcmtsModal &&
-                _jsx(TMModal, { title: (isPairingManyToMany ? "Abbina" : "Disabbina") + " documenti", onClose: () => setShowPairDcmtsModal(false), width: isMobile ? '90%' : '50%', height: isMobile ? '90%' : '70%', children: _jsx(TMSearchResult, { searchResults: pairedSearchResults, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, onRefreshSearchAsyncDatagrid: onRefreshSearchAsyncDatagrid, onFileOpened: onFileOpened, onTaskCreateRequest: onTaskCreateRequest, openWGsCopyMoveForm: openWGsCopyMoveForm, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, passToArchiveCallback: passToArchiveCallback, showTodoDcmtForm: showTodoDcmtForm, allowFloatingBar: false, floatingActionConfig: pairFloatingActionConfig, showBackButton: false, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, fetchRemoteCertificates: fetchRemoteCertificates }) }), showPairSearchModal &&
-                _jsx(TMModal, { title: "Ricerca documenti", onClose: () => setShowPairSearchModal(false), width: isMobile ? '90%' : '50%', height: isMobile ? '90%' : '70%', children: _jsx(TMSearch, { onlyShowSearchQueryPanel: true, inputTID: pairSearchModalTargetTID, inputMids: pairSearchModalInputMids, floatingActionConfig: pairSearchModalFloatingActionConfig, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }) }), isOpenSharedArchive && _jsx(TMModal, { title: SDKUI_Localizator.SharedArchiving, onClose: () => {
+                _jsx(TMModal, { title: isPairingManyToMany ? SDKUI_Localizator.MatchDcmts : SDKUI_Localizator.UnmatchDcmts, onClose: () => setShowPairDcmtsModal(false), width: '95%', height: '95%', children: _jsx(TMSearchResult, { searchResults: pairedSearchResults, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, onRefreshSearchAsyncDatagrid: onRefreshSearchAsyncDatagrid, onFileOpened: onFileOpened, onTaskCreateRequest: onTaskCreateRequest, openWGsCopyMoveForm: openWGsCopyMoveForm, editPdfForm: editPdfForm, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, passToArchiveCallback: passToArchiveCallback, showTodoDcmtForm: showTodoDcmtForm, allowFloatingBar: false, floatingActionConfig: pairFloatingActionConfig, showBackButton: backToPairSearchModal !== undefined, onClose: backToPairSearchModal, backCaption: SDKUI_Localizator.BackToSearch, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, fetchRemoteCertificates: fetchRemoteCertificates }) }), showPairSearchModal &&
+                _jsx(TMModal, { title: SDKUI_Localizator.Search_Dcmts, onClose: () => setShowPairSearchModal(false), width: '95%', height: '95%', children: _jsx(TMSearch, { onlyShowSearchQueryPanel: true, inputTID: pairSearchModalTargetTID, inputMids: pairSearchModalInputMids, floatingActionConfig: pairSearchModalFloatingActionConfig, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers }) }), isOpenSharedArchive && _jsx(TMModal, { title: SDKUI_Localizator.SharedArchiving, onClose: () => {
                     setIsOpenSharedArchive(false);
                 }, width: isMobile ? '90%' : '60%', height: isMobile ? '90%' : '80%', children: _jsx(TMArchive, { inputDID: selectedDcmtInfos?.[0].DID, inputTID: selectedDcmtInfos?.[0].TID, inputMids: currentMetadataValues.filter(md => md.mid && md.mid > 100).map(md => ({ mid: md.mid, value: md.value ?? '' })), isSharedArchive: true, inputFile: sharedDcmtFile, onSavedAsyncCallback: async (tid, did) => {
                         setIsOpenSharedArchive(false);
@@ -1446,14 +1484,17 @@ export const useDocumentOperations = (props) => {
                 } }))] }));
     return {
         operationItems: operationItems(),
+        selectedDcmtInfos,
         renderFloatingBar,
         renderDcmtOperations,
         features: {
             isOpenDcmtForm,
+            isDcmtFormModal,
             openFormHandler,
             dcmtFormLayoutMode,
             onDcmtFormOpenChange,
             showSearchTMDatagrid,
+            showDcmtTypesSelection,
             showExportForm,
             isOpenBatchUpdate,
             isModifiedBatchUpdate,
@@ -1521,6 +1562,7 @@ export const useDocumentOperations = (props) => {
                 canArchiveDetailRelation,
                 hasManyToManyRelation,
                 showPairDcmtsModal,
+                backToPairSearchModal,
                 // Pair search modal state
                 pairSearchModalTargetTID,
                 pairSearchModalParentTID,

package/lib/hooks/useInputDialog.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import { FileFormats } from '@topconsultnpm/sdk-ts';
 import { TMModal, TMRadioButton, TMButton, TMChooserForm } from "../components";

package/lib/hooks/useMultiMasterDetailDcmts.d.ts

@@ -0,0 +1,113 @@
+import { DcmtTypeDescriptor, RelationDescriptor, SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
+import { IColumnProps } from 'devextreme-react/data-grid';
+import { DcmtInfo, MetadataValueDescriptorEx } from '../ts';
+import { AccordionSection, ArchiveRow, ArchiveRowChanges, DetailRelationItem, MetadataScalarValue } from '../components/features/documents/TMMultiMasterDetailDcmtsUtils';
+/** Fasi del flusso di archiviazione multipla dei dettagli */
+export declare enum MultiDetailArchivePhase {
+    /** Scelta del tipo documento */
+    SelectDcmtType = 0,
+    /** Riepilogo delle archiviazioni */
+    ArchiveSummary = 1
+}
+/** Riga di riepilogo: definita con i tipi della feature (vedi TMMultiMasterDetailDcmtsUtils) */
+export type { ArchiveRow };
+/** Coppia mid/valore per pre-compilare il form */
+export type MidValue = {
+    mid: number;
+    value: string;
+};
+/** Stato del wait panel: le chiavi sono quelle dei props di TMLayoutWaitingContainer */
+export type WaitPanelState = {
+    showWaitPanel: boolean;
+    waitPanelTitle: string;
+    showWaitPanelPrimary: boolean;
+    waitPanelTextPrimary: string;
+    waitPanelValuePrimary: number;
+    waitPanelMaxValuePrimary: number;
+    showWaitPanelSecondary: boolean;
+    waitPanelTextSecondary: string;
+    waitPanelValueSecondary: number;
+    waitPanelMaxValueSecondary: number;
+};
+interface UseMultiMasterDetailDcmtsParams {
+    /** Tipo documento del master */
+    dtd: DcmtTypeDescriptor;
+    /** Documento master da cui parte l'archiviazione dei dettagli */
+    masterDcmt: DcmtInfo;
+    /** Chiusura del modale */
+    onClose: () => void;
+    /** true se nella lista di provenienza c'è un documento precedente/successivo su cui spostare il master */
+    canNavigateMaster?: (dir: 'next' | 'prev') => boolean;
+    /** Sposta il focus della lista di provenienza: il master arriva da lì e cambia da sé (vedi masterDcmt) */
+    onNavigateMaster?: (dir: 'next' | 'prev') => void;
+}
+/**
+ * Logica dell'archiviazione multipla dei dettagli: relazioni, sezioni, righe del riepilogo e
+ * archiviazione. Il rendering sta in TMMultiMasterDetailDcmtsForm
+ */
+export declare const useMultiMasterDetailDcmts: ({ dtd, masterDcmt, onClose, canNavigateMaster, onNavigateMaster }: UseMultiMasterDetailDcmtsParams) => {
+    isLoading: boolean;
+    isSummaryReady: boolean;
+    phase: MultiDetailArchivePhase;
+    setPhase: import("react").Dispatch<import("react").SetStateAction<MultiDetailArchivePhase>>;
+    detailRelationItems: DetailRelationItem[];
+    selectedRelation: RelationDescriptor | undefined;
+    selectedItem: DetailRelationItem | undefined;
+    hasMultipleTypes: boolean;
+    selectRelation: (item: DetailRelationItem) => void;
+    backToTypeSelection: () => void;
+    isBackLocked: boolean;
+    closeModal: () => void;
+    isMasterNavigationEnabled: boolean;
+    canNavigateMasterPrev: boolean;
+    canNavigateMasterNext: boolean;
+    navigateMaster: (dir: 'next' | 'prev') => void;
+    sectionsOpen: Record<AccordionSection, boolean>;
+    setSectionOpen: (section: AccordionSection, isOpen: boolean) => void;
+    openAllSections: () => void;
+    clearLayout: () => void;
+    layoutResetToken: number;
+    hasSavedLayout: boolean;
+    setHasSavedLayout: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    canUpdateMaster: boolean;
+    masterFieldsCount: number;
+    getMasterMetadataAsync: () => Promise<Map<number, MetadataScalarValue>>;
+    masterInfoReloadToken: number;
+    isOpenMasterForm: boolean;
+    setIsOpenMasterForm: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    handleMasterSavedAsync: () => Promise<void>;
+    archivedDetailResults: SearchResultDescriptor[];
+    archivedDetailsCount: number;
+    isLoadingArchivedDetails: boolean;
+    refreshArchivedDetailsAsync: () => Promise<void>;
+    detailColumns: IColumnProps[];
+    detailSupportsFile: boolean;
+    archiveRows: ArchiveRow[];
+    currentRows: ArchiveRow[];
+    focusedRowKey: number | undefined;
+    setFocusedRowKey: import("react").Dispatch<import("react").SetStateAction<number | undefined>>;
+    selectedRowKeys: number[];
+    setSelectedRowKeys: import("react").Dispatch<import("react").SetStateAction<number[]>>;
+    isOpenAddForm: boolean;
+    editingRowId: number | undefined;
+    editingRow: ArchiveRow | undefined;
+    formInputMids: MidValue[];
+    openAddForm: () => void;
+    openEditForm: (row: ArchiveRow | undefined) => void;
+    closeAddForm: () => void;
+    deleteRow: (row: ArchiveRow | undefined) => void;
+    duplicateRow: (row: ArchiveRow | undefined) => void;
+    upsertRow: (values: Array<MetadataValueDescriptorEx>, file: File | undefined) => void;
+    updateRowValues: (rowId: number, changes: ArchiveRowChanges) => void;
+    copyArchivedDetailToRows: (dcmt: {
+        TID?: number | string;
+        DID?: number | string;
+        FILEEXT?: string;
+    } | undefined) => Promise<void>;
+    stopOnFirstError: boolean;
+    setStopOnFirstError: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    isArchiving: boolean;
+    archiveAllAsync: () => Promise<void>;
+    waitPanel: WaitPanelState;
+    abortController: AbortController | undefined;
+};