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

package/lib/components/features/assistant/TMToppyDraggableHelpCenter.d.ts

@@ -11,5 +11,5 @@ interface TMToppyDraggableHelpCenterProps {
     /** Callback chiamato quando si clicca sull'immagine di Toppy */
     onToppyImageClick?: () => void;
 }
-declare const TMToppyDraggableHelpCenter: (props: TMToppyDraggableHelpCenterProps) => React.JSX.Element;
+declare const TMToppyDraggableHelpCenter: (props: TMToppyDraggableHelpCenterProps) => import("react/jsx-runtime").JSX.Element;
 export default TMToppyDraggableHelpCenter;

package/lib/components/features/assistant/TMToppyDraggableHelpCenter.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, useMemo, useRef, useState } from 'react';
 import ReactDOM from 'react-dom';
 import styled from 'styled-components';
@@ -433,7 +433,7 @@ const TMToppyDraggableHelpCenter = (props) => {
             window.removeEventListener('resize', handleResize);
         };
     }, []);
-    const toppyContent = (_jsxs(_Fragment, { children: [isDragging && _jsx(DragOverlay, {}), _jsxs(TMToppyButton, { ref: toppyButtonRef, "$align": align, "$isDragging": isDragging, "$isVisible": isVisible, "$isCollapsed": isCollapsed, "$isMobile": isMobile, "$usePortal": usePortal, onContextMenu: (e) => e.preventDefault(), onMouseDown: !isMobile ? handleMouseDown : undefined, onTouchStart: isMobile ? handleTouchStart : undefined, onDoubleClick: !isMobile ? toggleCollapse : undefined, "$x": position?.x, "$y": position?.y, children: [(content && !isCollapsed) && _jsx(TMToppySpeechBubble, { ref: bubbleRef, align: align, onClose: toggleCollapse, children: content }), (content && isCollapsed) && (_jsx(ExpandButton, { onMouseDown: (e) => {
+    const toppyContent = (_jsxs(_Fragment, { children: [isDragging && _jsx(DragOverlay, {}), _jsxs(TMToppyButton, { ref: toppyButtonRef, $align: align, $isDragging: isDragging, $isVisible: isVisible, $isCollapsed: isCollapsed, $isMobile: isMobile, $usePortal: usePortal, onContextMenu: (e) => e.preventDefault(), onMouseDown: !isMobile ? handleMouseDown : undefined, onTouchStart: isMobile ? handleTouchStart : undefined, onDoubleClick: !isMobile ? toggleCollapse : undefined, $x: position?.x, $y: position?.y, children: [(content && !isCollapsed) && _jsx(TMToppySpeechBubble, { ref: bubbleRef, align: align, onClose: toggleCollapse, children: content }), (content && isCollapsed) && (_jsx(ExpandButton, { onMouseDown: (e) => {
                             isExpandButtonDraggingRef.current = false;
                             expandButtonMouseDownPosRef.current = { x: e.clientX, y: e.clientY };
                         }, onMouseMove: (e) => {

package/lib/components/features/assistant/TMToppySpeechBubble.js

@@ -120,7 +120,7 @@ const TMToppySpeechBubble = forwardRef((props, ref) => {
         e.stopPropagation();
         onClose?.();
     };
-    return (_jsx(BubbleContainer, { "$align": align, children: _jsxs(BubbleWrapper, { ref: ref, "$hasCloseButton": !!onClose, children: [onClose && (_jsx(CloseButton, { onMouseDown: handleMouseDown, onMouseMove: handleMouseMove, onMouseUp: handleMouseUp, onClick: handleClick, "aria-label": SDKUI_Localizator.Minimize, title: SDKUI_Localizator.Minimize, type: "button", children: _jsx(IconWindowMinimize, {}) })), _jsx(Bubble, { "$align": align, children: _jsx(Content, { children: children }) })] }) }));
+    return (_jsx(BubbleContainer, { $align: align, children: _jsxs(BubbleWrapper, { ref: ref, $hasCloseButton: !!onClose, children: [onClose && (_jsx(CloseButton, { onMouseDown: handleMouseDown, onMouseMove: handleMouseMove, onMouseUp: handleMouseUp, onClick: handleClick, "aria-label": SDKUI_Localizator.Minimize, title: SDKUI_Localizator.Minimize, type: "button", children: _jsx(IconWindowMinimize, {}) })), _jsx(Bubble, { $align: align, children: _jsx(Content, { children: children }) })] }) }));
 });
 TMToppySpeechBubble.displayName = 'TMToppySpeechBubble';
 export default TMToppySpeechBubble;

package/lib/components/features/blog/TMBlogCommentForm.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { BlogPost, UserDescriptor } from "@topconsultnpm/sdk-ts";
 import { FileItem } from '../../base/TMFileManagerUtils';
 import { TMBlogContextDescriptor } from '../../grids/TMBlogsPostUtils';
@@ -19,5 +18,5 @@ interface TMBlogCommentFormProps {
     /** External save handler - when provided, bypasses internal engine logic */
     onCustomSave?: (blogPost: BlogPost) => Promise<void>;
 }
-declare const TMBlogCommentForm: (props: TMBlogCommentFormProps) => React.JSX.Element;
+declare const TMBlogCommentForm: (props: TMBlogCommentFormProps) => import("react/jsx-runtime").JSX.Element;
 export default TMBlogCommentForm;

package/lib/components/features/documents/TMBatchUpdateForm.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 { AccessLevels, DcmtTypeListCacheService, LayoutModes, MetadataDataDomains, ResultTypes, SDK_Globals, ValidationItem } from '@topconsultnpm/sdk-ts';
 import { searchResultToMetadataValues, getSystemMetadata, calcIsModified, getListMaxItems, SDKUI_Localizator, SDKUI_Globals } from '../../../helper';
@@ -7,7 +7,7 @@ import { DcmtOperationTypes, FormModes } from '../../../ts';
 import { StyledToolbarCardContainer, StyledFormButtonsContainer } from '../../base/Styled';
 import { useDeviceType, DeviceType } from '../../base/TMDeviceProvider';
 import { TMSplitterLayout } from '../../base/TMLayout';
-import { TMExceptionBoxManager } from '../../base/TMPopUp';
+import { TMExceptionBoxManager, TMMessageBoxManager, ButtonNames } from '../../base/TMPopUp';
 import TMShowAllOrMaxItemsButton from '../../base/TMShowAllOrMaxItemsButton';
 import TMSpinner from '../../base/TMSpinner';
 import { TMLayoutWaitingContainer } from '../../base/TMWaitPanel';
@@ -114,10 +114,24 @@ const TMBatchUpdateForm = ({ inputDcmts, TID, DID, isExpertMode = SDKUI_Globals.
     const totalItems = metadataValues.filter(o => o.mid && o.mid > 100).length;
     const metadataValuesSource = metadataValues.filter(o => o.mid && o.mid > 100).slice(0, showAll ? metadataValues.filter(o => o.mid && o.mid > 100).length : listMaxItems);
     const metadataValuesSourceOrig = metadataValuesOrig.filter(o => o.mid && o.mid > 100).slice(0, showAll ? metadataValuesOrig.filter(o => o.mid && o.mid > 100).length : listMaxItems);
+    /**
+     * Chiusura del form: con modifiche pendenti chiede conferma prima di scartarle.
+     * Il TMModal è montato con askClosingConfirm, quindi non si auto-nasconde: la chiusura
+     * effettiva avviene solo quando onBack smonta il componente.
+     */
+    const handleClose = () => {
+        if (!isModified) {
+            onBack?.();
+            return;
+        }
+        TMMessageBoxManager.show({
+            title: SDKUI_Localizator.Cancel, message: SDKUI_Localizator.ConfirmOnCancel, buttons: [ButtonNames.YES, ButtonNames.NO],
+            onButtonClick: (e) => { if (e === ButtonNames.YES)
+                onBack?.(); }
+        });
+    };
     const renderContent = () => {
-        return (_jsx(TMLayoutWaitingContainer, { showWaitPanel: showWaitPanel, showWaitPanelPrimary: showPrimary, waitPanelTitle: waitPanelTitle, waitPanelTextPrimary: waitPanelTextPrimary, waitPanelValuePrimary: waitPanelValuePrimary, waitPanelMaxValuePrimary: waitPanelMaxValuePrimary, isCancelable: true, abortController: abortController, children: _jsxs(TMSplitterLayout, { direction: 'horizontal', overflow: 'visible', separatorSize: Gutters.getGutters(), separatorColor: 'transparent', separatorActiveColor: 'transparent', showSeparator: showFormulaEditor, start: showFormulaEditor ? ['50%', '50%'] : ['100%', '0%'], min: ['0', '0'], children: [_jsx(TMPanel, { title: isModal ? 'Modifica i metadati' : `${SDKUI_Localizator.BatchUpdate} (${inputDcmts.length} documenti selezionati)`, onBack: deviceType === DeviceType.MOBILE ? onBack : undefined, 
-                        // onClose={deviceType !== DeviceType.MOBILE ? onBack : undefined}
-                        allowMaximize: !isModal, showHeader: !isModal, children: _jsxs(StyledToolbarCardContainer, { children: [_jsx(TMMetadataValues, { TID: TID, isExpertMode: isExpertMode, showCheckBoxes: ShowCheckBoxesMode.Always, showNullValueCheckBoxes: true, metadataValues: metadataValuesSource, metadataValuesOrig: metadataValuesSourceOrig, validationItems: validationItems, isOpenDistinctValues: showDistinctValuesPanel, selectedMID: focusedMetadataValue?.mid, onFocusedItemChanged: (item) => { setFocusedMetadataValue(item); }, onValueChanged: (newItems) => {
+        return (_jsx(TMLayoutWaitingContainer, { showWaitPanel: showWaitPanel, showWaitPanelPrimary: showPrimary, waitPanelTitle: waitPanelTitle, waitPanelTextPrimary: waitPanelTextPrimary, waitPanelValuePrimary: waitPanelValuePrimary, waitPanelMaxValuePrimary: waitPanelMaxValuePrimary, isCancelable: true, abortController: abortController, children: _jsxs(TMSplitterLayout, { direction: 'horizontal', overflow: 'visible', separatorSize: Gutters.getGutters(), separatorColor: 'transparent', separatorActiveColor: 'transparent', showSeparator: showFormulaEditor, start: showFormulaEditor ? ['50%', '50%'] : ['100%', '0%'], min: ['0', '0'], children: [_jsx(TMPanel, { title: isModal ? 'Modifica i metadati' : `${SDKUI_Localizator.BatchUpdate} (${inputDcmts.length} documenti selezionati)`, onBack: deviceType === DeviceType.MOBILE ? handleClose : undefined, allowMaximize: !isModal, showHeader: !isModal, children: _jsxs(StyledToolbarCardContainer, { children: [_jsx(TMMetadataValues, { TID: TID, isExpertMode: isExpertMode, showCheckBoxes: ShowCheckBoxesMode.Always, showNullValueCheckBoxes: true, metadataValues: metadataValuesSource, metadataValuesOrig: metadataValuesSourceOrig, validationItems: validationItems, isOpenDistinctValues: showDistinctValuesPanel, selectedMID: focusedMetadataValue?.mid, onFocusedItemChanged: (item) => { setFocusedMetadataValue(item); }, onValueChanged: (newItems) => {
                                         setMetadataValues((prevItems) => prevItems.map((item) => {
                                             const newItem = newItems.find((newItem) => newItem.tid === item.tid && newItem.mid === item.mid);
                                             return newItem ? { ...item, ...newItem } : item;
@@ -153,7 +167,7 @@ const TMBatchUpdateForm = ({ inputDcmts, TID, DID, isExpertMode = SDKUI_Globals.
                                         } })] }) })] }) }));
     };
     return (_jsx(_Fragment, { children: (isModal && onBack)
-            ? _jsx(TMModal, { title: titleModal, onClose: onBack, width: widthModal ?? '100%', height: heightModal ?? '100%', hidePopup: false, askClosingConfirm: true, children: _jsx("div", { style: { width: "100%", height: "100%", display: 'block', padding: "4px" }, children: renderContent() }) })
+            ? _jsx(TMModal, { title: titleModal, onClose: handleClose, width: widthModal ?? '100%', height: heightModal ?? '100%', hidePopup: false, askClosingConfirm: true, children: _jsx("div", { style: { width: "100%", height: "100%", display: 'block', padding: "4px" }, children: renderContent() }) })
             : renderContent() }));
 };
 export default TMBatchUpdateForm;

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

@@ -20,6 +20,12 @@ import ShowAlert from '../../base/TMAlert';
 import { TMColors } from '../../../utils/theme';
 import TMDownloadRelationViewerSection from './TMDownloadRelationViewerSection';
 import { buildInitialDownloadSettings, fileExists, generateTargetFileName, generateUniqueFileName, getDcmtInfosToDownload, getFloatingLabelStyle, isDirectoryPickerSupported, } from './copyAndMergeDcmtsShared';
+/**
+ * Numero di documenti scaricati in parallelo.
+ * I file vengono consumati via callback (scrittura su cartella o raccolta per lo ZIP),
+ * quindi il parallelismo è sicuro; l'ordine finale è garantito a valle del download.
+ */
+const COPY_DOWNLOAD_CONCURRENCY = 5;
 /**
  * Form per la copia/zip dei documenti in una cartella locale.
  * Logica condivisa con TMMergeToPdfForm è esternalizzata in copyAndMergeDcmtsShared
@@ -111,10 +117,24 @@ const TMCopyToFolderForm = ({ mode, selectedDcmtInfos, onClose, showTMRelationVi
     const handleSeparatorChange = (e) => {
         updateSettings('separatorChar', e.target.value.slice(0, 1));
     };
+    // ---- Serializzazione delle scritture su filesystem ----
+    // I download sono paralleli, le scritture no: fileExists/generateUniqueFileName/
+    // getFileHandle sono check-then-act sulla stessa cartella e due scritture contemporanee
+    // potrebbero sovrascriversi o calcolare lo stesso nome "univoco".
+    const writeChainRef = useRef(Promise.resolve());
+    const runExclusive = (action) => {
+        const result = writeChainRef.current.then(action);
+        // La catena non deve interrompersi se una scrittura fallisce: l'errore viene
+        // comunque propagato al chiamante tramite il promise restituito.
+        writeChainRef.current = result.catch(() => undefined);
+        return result;
+    };
     // ---- Scrittura file nel filesystem locale ----
     const writeFileToFolder = async (file, dcmtInfo) => {
         try {
-            let targetFileName = await generateTargetFileName(file, dcmtInfo, {
+            // Fuori dal lock: con la denominazione da metadati questa fa una chiamata al
+            // server per documento e deve poter andare in parallelo agli altri download.
+            const baseFileName = await generateTargetFileName(file, dcmtInfo, {
                 fileNamingMode: settings.fileNamingMode,
                 separatorChar: settings.separatorChar,
             });
@@ -123,7 +143,7 @@ const TMCopyToFolderForm = ({ mode, selectedDcmtInfos, onClose, showTMRelationVi
                 const url = URL.createObjectURL(file);
                 const a = document.createElement('a');
                 a.href = url;
-                a.download = targetFileName;
+                a.download = baseFileName;
                 document.body.appendChild(a);
                 a.target = '_blank';
                 a.rel = 'noreferrer';
@@ -132,23 +152,29 @@ const TMCopyToFolderForm = ({ mode, selectedDcmtInfos, onClose, showTMRelationVi
                 URL.revokeObjectURL(url);
                 return;
             }
-            const exists = await fileExists(folderHandleRef.current, targetFileName);
-            if (exists) {
-                switch (settings.fileExistsMode) {
-                    case 'skip':
-                        return;
-                    case 'rename':
-                        targetFileName = await generateUniqueFileName(folderHandleRef.current, targetFileName);
-                        break;
-                    case 'overwrite':
-                    default:
-                        break;
+            // Dentro il lock: controllo esistenza, calcolo del nome univoco e scrittura
+            // devono restare un'unica operazione atomica sulla cartella.
+            const folderHandle = folderHandleRef.current;
+            await runExclusive(async () => {
+                let targetFileName = baseFileName;
+                const exists = await fileExists(folderHandle, targetFileName);
+                if (exists) {
+                    switch (settings.fileExistsMode) {
+                        case 'skip':
+                            return;
+                        case 'rename':
+                            targetFileName = await generateUniqueFileName(folderHandle, targetFileName);
+                            break;
+                        case 'overwrite':
+                        default:
+                            break;
+                    }
                 }
-            }
-            const fileHandle = await folderHandleRef.current.getFileHandle(targetFileName, { create: true });
-            const writable = await fileHandle.createWritable();
-            await writable.write(file);
-            await writable.close();
+                const fileHandle = await folderHandle.getFileHandle(targetFileName, { create: true });
+                const writable = await fileHandle.createWritable();
+                await writable.write(file);
+                await writable.close();
+            });
         }
         catch (err) {
             console.error('Errore nella scrittura del file:', err);
@@ -176,10 +202,12 @@ const TMCopyToFolderForm = ({ mode, selectedDcmtInfos, onClose, showTMRelationVi
         retrieveOptions.invoiceRetrieveFormat = settings.invoiceFormat ?? SDKUI_Globals.userSettings.searchSettings.invoiceRetrieveFormat;
         retrieveOptions.orderRetrieveFormat = settings.orderFormat ?? SDKUI_Globals.userSettings.searchSettings.orderRetrieveFormat;
         if (settings.exportMode === 'copy') {
-            await downloadDcmtsAsync({ inputDcmts: dcmtInfosToDownload, downloadType: DownloadTypes.Dcmt, downloadMode: 'download', onFileDownloaded: writeFileToFolder, skipConfirmation: true, retrieveOptions, useCache: false });
+            // Senza handle della cartella ogni file viene salvato con un click su <a download>:
+            // in quel caso si resta sequenziali, perché il browser blocca i click ravvicinati.
+            const copyConcurrency = folderHandleRef.current ? COPY_DOWNLOAD_CONCURRENCY : 1;
+            await downloadDcmtsAsync({ inputDcmts: dcmtInfosToDownload, downloadType: DownloadTypes.Dcmt, downloadMode: 'download', onFileDownloaded: writeFileToFolder, skipConfirmation: true, retrieveOptions, useCache: false, downloadConcurrency: copyConcurrency });
         }
         else if (settings.exportMode === 'zip') {
-            const zipEntries = [];
             const fileNameCounts = new Map();
             const getUniqueZipFileName = (fileName) => {
                 const lowerName = fileName.toLowerCase();
@@ -192,14 +220,25 @@ const TMCopyToFolderForm = ({ mode, selectedDcmtInfos, onClose, showTMRelationVi
                 const ext = dotIndex > 0 ? fileName.substring(dotIndex) : '';
                 return `${baseName} (${count})${ext}`;
             };
+            // Con i download paralleli i file arrivano in ordine di completamento: si raccolgono
+            // in mappa (nome incluso, calcolato in parallelo) e l'archivio viene costruito dopo
+            // nell'ordine di selezione, così i suffissi di deduplica restano quelli sequenziali.
+            const downloadedEntries = new Map();
             const collectFileForZip = async (file, dcmtInfo) => {
                 const targetFileName = await generateTargetFileName(file, dcmtInfo, {
                     fileNamingMode: settings.fileNamingMode,
                     separatorChar: settings.separatorChar,
                 });
-                zipEntries.push({ filename: getUniqueZipFileName(targetFileName), data: file });
+                downloadedEntries.set(`${dcmtInfo.TID}_${dcmtInfo.DID}`, { file, targetFileName });
             };
-            await downloadDcmtsAsync({ inputDcmts: dcmtInfosToDownload, downloadType: DownloadTypes.Dcmt, downloadMode: 'download', onFileDownloaded: collectFileForZip, skipConfirmation: true, retrieveOptions, useCache: false });
+            await downloadDcmtsAsync({ inputDcmts: dcmtInfosToDownload, downloadType: DownloadTypes.Dcmt, downloadMode: 'download', onFileDownloaded: collectFileForZip, skipConfirmation: true, retrieveOptions, useCache: false, downloadConcurrency: COPY_DOWNLOAD_CONCURRENCY });
+            const zipEntries = [];
+            for (const dcmtInfo of dcmtInfosToDownload) {
+                const entry = downloadedEntries.get(`${dcmtInfo.TID}_${dcmtInfo.DID}`);
+                if (!entry)
+                    continue;
+                zipEntries.push({ filename: getUniqueZipFileName(entry.targetFileName), data: entry.file });
+            }
             if (zipEntries.length > 0) {
                 const zipFileName = settings.zipFileName.trim().toLowerCase().endsWith('.zip')
                     ? settings.zipFileName.trim()

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

@@ -3,7 +3,10 @@ import { HomeBlogPost, TaskDescriptor } from '@topconsultnpm/sdk-ts';
 interface ITMDcmtBlogProps {
     tid: number | undefined;
     did: number | undefined;
+    /** Il pannello è aperto. La inietta TMPanelWrapper, non va passata dal chiamante */
     isVisible?: boolean;
+    /** La pagina che contiene il pannello è a video: quelle in secondo piano restano montate e non devono caricare */
+    isPageVisible?: boolean;
     fetchBlogDataTrigger?: number;
     onRefreshBlogDatagrid?: () => Promise<void>;
     showFloatingCommentButton?: boolean;

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

@@ -8,7 +8,7 @@ import TMBlogCommentForm from '../blog/TMBlogCommentForm';
 import TMBlogsPost from '../../grids/TMBlogsPost';
 import TMSpinner from '../../base/TMSpinner';
 import { TMExceptionBoxManager } from '../../base/TMPopUp';
-const TMDcmtBlog = ({ tid, did, isVisible, fetchBlogDataTrigger, onRefreshBlogDatagrid, showFloatingCommentButton = true, allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers }) => {
+const TMDcmtBlog = ({ tid, did, isVisible, isPageVisible = true, fetchBlogDataTrigger, onRefreshBlogDatagrid, showFloatingCommentButton = true, allTasks = [], getAllTasks, deleteTaskByIdsCallback, addTaskCallback, editTaskCallback, handleNavigateToWGs, handleNavigateToDossiers }) => {
     const [blogsDatasource, setBlogsDatasource] = useState([]);
     const [hasLoadedDataOnce, setHasLoadedDataOnce] = useState(false); //traccia se *qualsiasi* dato è stato caricato per la prima volta
     const [lastLoadedDid, setLastLoadedDid] = useState(undefined); // `lastLoadedDid` tiene traccia dell'ultimo `did` per cui abbiamo caricato i dati
@@ -47,15 +47,15 @@ const TMDcmtBlog = ({ tid, did, isVisible, fetchBlogDataTrigger, onRefreshBlogDa
             return;
         }
         // Condizione per eseguire il fetch:
-        // 1. Il pannello è visibile
+        // 1. Il pannello è visibile in una pagina a video
         // 2. E (non abbiamo ancora caricato dati o il `did` è cambiato rispetto all'ultima volta)
-        const shouldFetch = isVisible && (!hasLoadedDataOnce || did !== lastLoadedDid);
+        const shouldFetch = isVisible && isPageVisible && (!hasLoadedDataOnce || did !== lastLoadedDid);
         // Esegui la chiamata API solo se il pannello è visibile E i dati non sono già stati caricati
         // O, se vuoi ricaricare ogni volta che diventa visibile (ma è meno efficiente per "pesante")
         if (shouldFetch) {
             fetchBlogDataAsync(tid, did);
         }
-    }, [tid, did, isVisible, hasLoadedDataOnce, lastLoadedDid]);
+    }, [tid, did, isVisible, isPageVisible, hasLoadedDataOnce, lastLoadedDid]);
     const refreshCallback = async () => {
         await fetchBlogDataAsync(tid, did);
         await onRefreshBlogDatagrid?.();

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

@@ -2,6 +2,7 @@ import React from 'react';
 import { DcmtTypeDescriptor, HomeBlogPost, LayoutModes, ObjectRef, SearchResultDescriptor, TaskDescriptor, ValidationItem } from '@topconsultnpm/sdk-ts';
 import { DcmtInfo, FormModes, MetadataValueDescriptorEx, TaskContext, IGraphometricManagerProp } from '../../../ts';
 import { IntesiCertificateData } from '../../../helper';
+import { ArchiveListMode } from '../../../hooks/useArchiveListForm';
 /**
  * Definisce il contesto da cui è stato invocato il TMDcmtForm.
  * Permette di gestire logiche diverse in base alla provenienza.
@@ -77,6 +78,12 @@ interface ITMDcmtFormProps {
         mid: number;
         value: string;
     }>, tid?: number) => void;
+    /**
+     * Modalità "aggiungi a elenco" (es. archiviazione dettagli multipli): se valorizzata, in layout di archiviazione
+     * il form non archivia ma emette i metadati compilati al chiamante (pulsanti "Aggiungi"/"Modifica" + "Pulisci").
+     * Tutta la logica è incapsulata in useArchiveListForm; usata solo da TMMultiMasterDetailDcmts.
+     */
+    archiveListMode?: ArchiveListMode;
     fetchRemoteCertificates?: (email: string) => Promise<IntesiCertificateData[]>;
     datagridUtility?: {
         onRefreshSearchAsyncDatagrid?: () => Promise<void>;