@topconsultnpm/sdkui-react 6.20.0 → 6.21.0-dev1.11

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

@@ -87,6 +87,12 @@ const TMViewHistoryDcmt = (props) => {
                         IsSigned: row.IsSigned ? row.IsSigned.toString() === '1' : false,
                     };
                 });
+                // Sort by LastUpdateTime ascending
+                historyFileItems.sort((a, b) => {
+                    const dateA = a.LastUpdateTime ? new Date(a.LastUpdateTime).getTime() : 0;
+                    const dateB = b.LastUpdateTime ? new Date(b.LastUpdateTime).getTime() : 0;
+                    return dateA - dateB;
+                });
                 return historyFileItems;
             }
             return [];

package/lib/components/features/tasks/TMTaskForm.d.ts

@@ -32,7 +32,8 @@ export interface TMTaskFormProps {
     width?: string;
     height?: string;
     usersList?: Array<UserDescriptor>;
-    onOpenS4TViewerRequest?: (dcmtInfo: Array<DcmtInfo>, onRefreshSearchAsync?: (() => Promise<void>)) => void;
+    onOpenS4TViewerRequest?: (dcmtInfo: Array<DcmtInfo>, refreshDocumentPreview?: (() => Promise<void>)) => void;
+    onOpenPdfEditorRequest?: (dcmtInfo: Array<DcmtInfo>, refreshDocumentPreview?: () => Promise<void>) => void;
     s4TViewerDialogComponent?: React.ReactNode;
 }
 declare const TMTaskForm: (props: TMTaskFormProps) => import("react/jsx-runtime").JSX.Element;

package/lib/components/features/tasks/TMTaskForm.js

@@ -18,7 +18,7 @@ const TMTaskForm = (props) => {
     const { refreshWorkflowApprove } = useWorkflowApprove();
     const validator = async (taskDescriptor) => { return await taskValidatorAsync(taskDescriptor, requestMoreInfo); };
     // Destructure the props object to extract individual properties
-    const { id, title, isModal, formMode, requestMoreInfo = false, visualizedTasks, editTaskCallback, currentTask, setCurrentTask, isContextualCreate = false, selectedRowKeys, handleFocusedRowKeyChange, onStatusChanged, onSaved, onClose, onCancel, taskContext, startDate, endDate, showBackButton = true, hasNavigation = true, width = "100%", height = "100%", usersList, onOpenS4TViewerRequest, s4TViewerDialogComponent, allTasks, getAllTasks, deleteTaskByIdsCallback, addTaskCallback, handleNavigateToWGs, handleNavigateToDossiers } = props;
+    const { id, title, isModal, formMode, requestMoreInfo = false, visualizedTasks, editTaskCallback, currentTask, setCurrentTask, isContextualCreate = false, selectedRowKeys, handleFocusedRowKeyChange, onStatusChanged, onSaved, onClose, onCancel, taskContext, startDate, endDate, showBackButton = true, hasNavigation = true, width = "100%", height = "100%", usersList, onOpenS4TViewerRequest, onOpenPdfEditorRequest, s4TViewerDialogComponent, allTasks, getAllTasks, deleteTaskByIdsCallback, addTaskCallback, handleNavigateToWGs, handleNavigateToDossiers } = props;
     const sfo = new SaveFormOptions();
     sfo.objClass = ObjectClasses.Task;
     const customizeFormData = (task) => {
@@ -305,6 +305,6 @@ const TMTaskForm = (props) => {
                                 justifyContent: 'flex-end',
                                 alignItems: 'center'
                             }, children: _jsx(TaskFormAssignmentNoticeBadge, { task: formData, users: users, requestMoreInfo: requestMoreInfo }) })), (showDcmtForm && formData?.iD1 && formData?.iD2) &&
-                            _jsx(TMDcmtForm, { titleModal: formData.iD1Name ?? '-', isModal: true, TID: formData.iD1, DID: formData.iD2, allowButtonsRefs: true, moreInfoTasks: getMoreInfoTasksForDocument(allTasks, formData?.iD1, formData?.iD2), onWFOperationCompleted: refreshWorkflowApprove, onTaskCompleted: onTaskCompleted, onClose: () => { setShowDcmtForm(false); }, onOpenS4TViewerRequest: onOpenS4TViewerRequest, s4TViewerDialogComponent: s4TViewerDialogComponent, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, onReferenceClick: handleNavigateToReference })] }), formData && showChangeStateForm && _jsx(TMChangeStateForm, { formData: formData, formDataOrig: formDataOrig, handleShowChangeStateForm: handleShowChangeStateForm, setFormData: setFormData })] }) }));
+                            _jsx(TMDcmtForm, { titleModal: formData.iD1Name ?? '-', isModal: true, TID: formData.iD1, DID: formData.iD2, allowButtonsRefs: true, moreInfoTasks: getMoreInfoTasksForDocument(allTasks, formData?.iD1, formData?.iD2), onWFOperationCompleted: refreshWorkflowApprove, onTaskCompleted: onTaskCompleted, onClose: () => { setShowDcmtForm(false); }, onOpenS4TViewerRequest: onOpenS4TViewerRequest, onOpenPdfEditorRequest: onOpenPdfEditorRequest, s4TViewerDialogComponent: s4TViewerDialogComponent, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, onReferenceClick: handleNavigateToReference })] }), formData && showChangeStateForm && _jsx(TMChangeStateForm, { formData: formData, formDataOrig: formDataOrig, handleShowChangeStateForm: handleShowChangeStateForm, setFormData: setFormData })] }) }));
 };
 export default TMTaskForm;

package/lib/helper/checkinCheckoutManager.d.ts

@@ -22,7 +22,7 @@ export interface CheckoutInfo {
     checkoutFolder: string;
     checkoutName: string;
 }
-interface CheckoutStatusResult {
+export interface CheckoutStatusResult {
     isCheckedOut: boolean;
     mode: 'editMode' | 'lockMode' | '';
     version: number;

package/lib/helper/checkinCheckoutManager.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { AccessLevels, CICO_MetadataNames, SDK_Globals, SystemMIDsAsNumber } from "@topconsultnpm/sdk-ts";
 import TMTooltip from "../components/base/TMTooltip";
-import { Globalization, SDKUI_Globals, SDKUI_Localizator } from "./index";
+import { dcmtsFileCachePreview, Globalization, removeDcmtsFileCache, SDKUI_Globals, SDKUI_Localizator } from "./index";
 import { DownloadTypes } from "../ts/types";
 const findCheckOutUserName = (users, checkoutUserId) => {
     let checkOutUser = users.find(user => user.id === checkoutUserId);
@@ -67,11 +67,15 @@ export const cicoDownloadFilesCallback = async (sources, checkout, downloadDcmts
                 const newItem = { TID: tid.toString(), DID: did.toString(), checkoutFolder: "", checkoutName: fileName };
                 updateCicoCheckoutStorageItem(newItem, source.type, "addOrUpdate");
             }
+            const cacheKey = `${tid}-${did}`;
+            if (dcmtsFileCachePreview.has(cacheKey))
+                removeDcmtsFileCache(cacheKey);
             files.push({ TID: tid, DID: did, FILEEXT: ext, fileName });
         }
     });
-    if (files.length > 0)
+    if (files.length > 0) {
         await downloadDcmtsAsync(files, DownloadTypes.Dcmt, "download");
+    }
 };
 export const updateCicoCheckoutStorageItem = (item, type, action = "addOrUpdate") => {
     // Select the appropriate array based on type
@@ -255,13 +259,15 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
     let checkoutDate;
     let version = 1;
     let fileExt;
+    let isMetadata = false;
     // ========================================================================
-    // CASO 1: Documento come Array di MetadataValueDescriptorEx
+    // CASO 1: Documento come Array di MetadataValueDescriptorEx: Form del documento
     // ========================================================================
     // Questo formato viene utilizzato quando il documento proviene da query
     // o liste dove ogni metadato è un oggetto separato con proprietà 'md' e 'value'
     if (Array.isArray(dcmt) && dcmt.length > 0 && dcmt[0]?.md !== undefined) {
         const dcmtsArray = dcmt;
+        console.log("dcmtsArray:", dcmtsArray);
         // Estrai l'ID dell'utente che ha effettuato il checkout
         const checkoutUserIdProperty = dcmtsArray.find((item) => item.md?.name === CICO_MetadataNames.CICO_CheckoutUserID);
         const checkoutUserIdValue = checkoutUserIdProperty?.value;
@@ -275,9 +281,11 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
         version = (versionRaw != null && !isNaN(Number(versionRaw))) ? Number(versionRaw) : 1;
         const fileExtProperty = dcmtsArray.find((item) => item.mid === SystemMIDsAsNumber.FileExt);
         fileExt = fileExtProperty?.value ? fileExtProperty.value.toString() : null;
+        const fileCountProperty = dcmtsArray.find((item) => item.mid === SystemMIDsAsNumber.FileCount);
+        isMetadata = !(fileCountProperty?.value && Number(fileCountProperty.value) > 0);
     }
     // ========================================================================
-    // CASO 2: Documento come Oggetto Piatto (formato standard)
+    // CASO 2: Documento come Oggetto Piatto (formato standard): Risultato della ricerca
     // ========================================================================
     // Questo formato viene utilizzato quando il documento ha proprietà dirette
     // nel formato chiave-valore: TID, DID, e "TID_MetadataID" per i metadati
@@ -286,6 +294,8 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
         const CICO_CheckoutUserID_Meta = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_CheckoutUserID);
         const CICO_CheckoutDate_Meta = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_CheckoutDate);
         const CICO_Version_Meta = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_Version);
+        const fileCountValue = dcmt.FILECOUNT != null ? Number(dcmt.FILECOUNT) : NaN;
+        isMetadata = isNaN(fileCountValue) || fileCountValue <= 0;
         fileExt = dcmt.FILEEXT ? dcmt.FILEEXT.toString() : null;
         // Estrai l'ID dell'utente che ha effettuato il checkout
         if (CICO_CheckoutUserID_Meta?.id) {
@@ -306,6 +316,15 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
         }
     }
     // ========================================================================
+    // EARLY RETURN: Documento di soli metadati (senza file)
+    // ========================================================================
+    if (isMetadata) {
+        return {
+            cicoEnabled: false,
+            checkoutStatus: { isCheckedOut: false, mode: '', version: 1, icon: null, editLockTooltipText: null }
+        };
+    }
+    // ========================================================================
     // COSTRUZIONE DELLO STATO DI CHECKOUT
     // ========================================================================
     let checkoutStatus = {
@@ -341,8 +360,8 @@ export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
     // RESTITUZIONE RISULTATO FINALE
     // ========================================================================
     return {
-        // CICO è abilitato se configurato nel DTD e l'utente ha i permessi
-        cicoEnabled: cicoInfo.CICO === 1 && cicoInfo.CanCICO === AccessLevels.Yes && fileExt !== null && fileExt !== '',
+        // CICO è abilitato se configurato nel DTD, l'utente ha i permessi e il documento non è di soli metadati
+        cicoEnabled: cicoInfo.CICO === 1 && cicoInfo.CanCICO === AccessLevels.Yes && fileExt !== null && fileExt !== '' && !isMetadata,
         checkoutStatus: checkoutStatus
     };
 };

package/lib/hooks/useCheckInOutOperations.d.ts

@@ -1,6 +1,9 @@
 import { DcmtInfo, DownloadModes, DownloadTypes } from '../ts';
 import { FileDescriptor, SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
-interface UseCheckInOutOperationsReturn {
+export interface UseCheckInOutOperationsProps {
+    onRefreshPreview: () => Promise<void>;
+}
+export interface UseCheckInOutOperationsReturn {
     showHistory: boolean;
     showHistoryCallback: () => void;
     hideHistoryCallback: () => void;
@@ -14,9 +17,8 @@ interface UseCheckInOutOperationsReturn {
     };
     hideCommentFormCallback: () => void;
     copyCheckoutPathToClipboardCallback: (dcmt: DcmtInfo, filename: string) => void;
-    handleCheckOutCallback: (dcmt: DcmtInfo, checkout: boolean, filename: string, downloadDcmtsAsync: (inputDcmts: Array<DcmtInfo> | undefined, downloadType?: DownloadTypes, downloadMode?: DownloadModes, onFileDownloaded?: (dcmtFile: File) => void, confirmAttachments?: (list: FileDescriptor[]) => Promise<string[] | undefined>, skipConfirmation?: boolean) => Promise<void>, refreshCurrentDcmt?: () => Promise<void>, refreshFocusedDataRowAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
-    handleCheckInCallback: (dcmt: DcmtInfo, refreshCurrentDcmt?: () => Promise<void>, refreshFocusedDataRowAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
-    refreshPreviewTrigger: number;
+    handleCheckOutCallback: (dcmt: DcmtInfo, checkout: boolean, filename: string, downloadDcmtsAsync: (inputDcmts: Array<DcmtInfo> | undefined, downloadType?: DownloadTypes, downloadMode?: DownloadModes, onFileDownloaded?: (dcmtFile: File) => void, confirmAttachments?: (list: FileDescriptor[]) => Promise<string[] | undefined>, skipConfirmation?: boolean) => Promise<void>, onRefreshAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
+    handleCheckInCallback: (dcmt: DcmtInfo, onRefreshAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
     showCicoWaitPanel: boolean;
     cicoWaitPanelTitle: string;
     showCicoPrimaryProgress: boolean;
@@ -24,5 +26,4 @@ interface UseCheckInOutOperationsReturn {
     cicoPrimaryProgressValue: number;
     cicoPrimaryProgressMax: number;
 }
-export declare const useCheckInOutOperations: () => UseCheckInOutOperationsReturn;
-export {};
+export declare const useCheckInOutOperations: (props: UseCheckInOutOperationsProps) => UseCheckInOutOperationsReturn;

package/lib/hooks/useCheckInOutOperations.js

@@ -3,12 +3,11 @@ import { cicoDownloadFilesCallback, dcmtsFileCachePreview, getCicoDownloadFileNa
 import { ButtonNames, ShowAlert, TMMessageBoxManager, TMResultManager } from '../components';
 import { ResultTypes, SDK_Globals } from '@topconsultnpm/sdk-ts';
 let abortController = new AbortController();
-export const useCheckInOutOperations = () => {
+export const useCheckInOutOperations = (props) => {
+    const { onRefreshPreview } = props;
     const [showHistory, setShowHistory] = useState(false);
     // State to manage show history selected file
     const [showCheckoutInformationForm, setShowCheckoutInformationForm] = useState(false);
-    // Stato per triggerare il refresh della preview dall'esterno
-    const [refreshPreviewTrigger, setRefreshPreviewTrigger] = useState(0);
     // State to manage comment form
     const [commentFormState, setCommentFormState] = useState({
         removeAndEditAttachment: true,
@@ -39,9 +38,6 @@ export const useCheckInOutOperations = () => {
     const hideCheckoutInformationFormCallback = useCallback(() => {
         setShowCheckoutInformationForm(false);
     }, []);
-    const triggerPreviewRefresh = useCallback(() => {
-        setRefreshPreviewTrigger(prev => prev + 1);
-    }, []);
     const hideCommentFormCallback = useCallback(() => {
         setCommentFormState(prev => ({ ...prev, show: false }));
     }, []);
@@ -60,7 +56,7 @@ export const useCheckInOutOperations = () => {
             ShowAlert({ message: err, mode: 'error', duration: 5000, title: SDKUI_Localizator.OperationResult });
         });
     };
-    const handleCheckOutCallback = async (dcmt, checkout, filename, downloadDcmtsAsync, refreshMetadataAsync, refreshFocusedDataRowAsync) => {
+    const handleCheckOutCallback = async (dcmt, checkout, filename, downloadDcmtsAsync, onRefreshAsync) => {
         if (!dcmt)
             throw new Error("Document info is required");
         const title = checkout ? 'Check out' : SDKUI_Localizator.CancelCheckOut;
@@ -88,8 +84,7 @@ export const useCheckInOutOperations = () => {
                             .then(async () => {
                             await cicoDownloadFilesCallback([{ type: 'dcmtInfo', dcmtInfo: dcmt, originalFileName: filename }], true, downloadDcmtsAsync);
                             result.push({ rowIndex: 1, id1: dcmt.TID, id2: dcmt.DID, description: SDKUI_Localizator.UpdateCompletedSuccessfully, resultType: ResultTypes.SUCCESS });
-                            await refreshMetadataAsync?.();
-                            await refreshFocusedDataRowAsync?.(dcmt.TID, dcmt.DID, true);
+                            await onRefreshAsync?.(dcmt.TID, dcmt.DID, true);
                         })
                             .catch((error) => {
                             result.push({ rowIndex: 1, id1: dcmt.TID, id2: dcmt.DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(error) });
@@ -102,8 +97,7 @@ export const useCheckInOutOperations = () => {
                             result.push({ rowIndex: 1, id1: dcmt.TID, id2: dcmt.DID, description: SDKUI_Localizator.UpdateCompletedSuccessfully, resultType: ResultTypes.SUCCESS });
                             // Remove the corresponding draft checkout item
                             updateCicoCheckoutStorageItem({ TID: dcmt.TID.toString(), DID: dcmt.DID.toString(), checkoutFolder: "", checkoutName: "" }, "dcmtInfo", "remove");
-                            await refreshMetadataAsync?.();
-                            await refreshFocusedDataRowAsync?.(dcmt.TID, dcmt.DID, true);
+                            await onRefreshAsync?.(dcmt.TID, dcmt.DID, true);
                         })
                             .catch((error) => {
                             result.push({ rowIndex: 0, id1: dcmt.TID, id2: dcmt.DID, resultType: ResultTypes.ERROR, description: getExceptionMessage(error) });
@@ -133,7 +127,7 @@ export const useCheckInOutOperations = () => {
             });
         }
     };
-    const handleCheckInCallback = async (dcmt, refreshMetadataAsync, refreshFocusedDataRowAsync) => {
+    const handleCheckInCallback = async (dcmt, onRefreshAsync) => {
         if (!dcmt)
             throw new Error("Document info is required");
         // Create a new file input element
@@ -175,12 +169,12 @@ export const useCheckInOutOperations = () => {
                                 // Remove the corresponding draft checkout item
                                 updateCicoCheckoutStorageItem({ TID: dcmt.TID.toString(), DID: dcmt.DID.toString(), checkoutFolder: "", checkoutName: "" }, "dcmtInfo", "remove");
                                 result.push({ rowIndex: i, id1: dcmt.DID, id2: dcmt.DID, description: SDKUI_Localizator.UpdateCompletedSuccessfully, resultType: ResultTypes.SUCCESS });
-                                await refreshMetadataAsync?.();
-                                await refreshFocusedDataRowAsync?.(dcmt.TID, dcmt.DID, true);
+                                await onRefreshAsync?.(dcmt.TID, dcmt.DID, true);
+                                // remove file from preview cache to force refresh with the new checked-in file
                                 const cacheKey = `${dcmt.TID}-${dcmt.DID}`;
                                 if (dcmtsFileCachePreview.has(cacheKey))
                                     removeDcmtsFileCache(cacheKey);
-                                triggerPreviewRefresh();
+                                await onRefreshPreview();
                                 triggerCommentOnFileAdd([dcmt.DID]);
                             }
                         }
@@ -212,7 +206,6 @@ export const useCheckInOutOperations = () => {
         copyCheckoutPathToClipboardCallback,
         handleCheckOutCallback,
         handleCheckInCallback,
-        refreshPreviewTrigger,
         showCicoWaitPanel,
         cicoWaitPanelTitle,
         showCicoPrimaryProgress,

package/lib/hooks/useDcmtOperations.d.ts

@@ -1,6 +1,6 @@
 import { RetrieveFileOptions, FileDescriptor } from '@topconsultnpm/sdk-ts';
 import { DcmtInfo, DcmtOperationTypes, DownloadModes, DownloadTypes } from '../ts';
-export declare function useDcmtOperations(): {
+export interface UseDcmtOperationsReturn {
     abortController: AbortController;
     showWaitPanel: boolean;
     showPrimary: boolean;
@@ -21,4 +21,5 @@ export declare function useDcmtOperations(): {
     removeDcmtsFileCache: (key: string) => void;
     isDcmtFileInCache: (key: string) => boolean;
     runOperationAsync: (inputDcmts: DcmtInfo[] | undefined, dcmtOperationType: DcmtOperationTypes, actionAfterOperationAsync?: () => Promise<void>) => Promise<void>;
-};
+}
+export declare const useDcmtOperations: () => UseDcmtOperationsReturn;

package/lib/hooks/useDcmtOperations.js

@@ -20,7 +20,7 @@ const getDownloadFileName = (fileName) => {
         return fileName;
     return `${fileName.slice(0, firstDot)}(${count})${fileName.slice(firstDot)}`;
 };
-export function useDcmtOperations() {
+export const useDcmtOperations = () => {
     const [showWaitPanel, setShowWaitPanel] = useState(false);
     const [waitPanelTitle, setWaitPanelTitle] = useState('');
     const [showPrimary, setShowPrimary] = useState(false);
@@ -495,4 +495,4 @@ export function useDcmtOperations() {
         abortController, showWaitPanel, showPrimary, waitPanelTitle, waitPanelTextPrimary, waitPanelValuePrimary, waitPanelMaxValuePrimary, showSecondary, waitPanelTextSecondary, waitPanelValueSecondary, waitPanelMaxValueSecondary,
         downloadDcmtsAsync, getDcmtFileAsync, clearDcmtsFileCache, removeDcmtsFileCache, isDcmtFileInCache, runOperationAsync
     };
-}
+};

package/lib/hooks/useDocumentOperations.d.ts

@@ -0,0 +1,140 @@
+import React, { RefObject } from "react";
+import { DcmtTypeDescriptor, FileFormats, HomeBlogPost, LayoutDescriptor, LayoutModes, ObjectRef, SearchResultDescriptor, TaskDescriptor, UserDescriptor, WorkingGroupDescriptor } from "@topconsultnpm/sdk-ts";
+import { IColumnProps } from "devextreme-react/cjs/data-grid";
+import { TMContextMenuItemProps } from '../components/NewComponents/ContextMenu/types';
+import { DcmtInfo, MetadataValueDescriptorEx, SearchResultContext, TaskContext } from "../ts";
+import { UseCheckInOutOperationsReturn } from "./useCheckInOutOperations";
+import { UseDcmtOperationsReturn } from "./useDcmtOperations";
+import { UseRelatedDocumentsReturn } from "./useRelatedDocuments";
+export interface DocumentDataProps {
+    dtd: DcmtTypeDescriptor | undefined;
+    selectedItems: Array<any>;
+    focusedItem: any;
+    currentSearchResults: Array<SearchResultDescriptor>;
+    currentMetadataValues: Array<MetadataValueDescriptorEx>;
+    allUsers?: Array<UserDescriptor>;
+    searchResult?: SearchResultDescriptor;
+    datagridUtility?: {
+        visibleItems?: any[];
+        onRefreshSearchAsyncDatagrid?: () => Promise<void>;
+        onRefreshDataRowsAsync?: (() => Promise<void>);
+        refreshFocusedDataRowAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>;
+        onRefreshBlogDatagrid?: () => Promise<void>;
+        onRefreshPreviewDatagrid?: () => Promise<void>;
+        refreshOperationsTrigger?: number;
+        onRefreshOperationsDatagrid?: () => Promise<void>;
+    };
+    dcmtUtility?: {
+        approvalVID?: number;
+        dcmtDataRowForCicoStatus?: Array<MetadataValueDescriptorEx> | any;
+        selectedDcmtSearchResultRelations?: SearchResultDescriptor;
+        dcmtTIDHasDetailRelations?: boolean;
+        dcmtTIDHasMasterRelations?: boolean;
+        updateCurrentDcmt?: () => Promise<void>;
+        onCloseDcmtForm?: () => void;
+        onRefreshBlogForm?: () => Promise<void>;
+        onRefreshPreviewForm?: () => Promise<void>;
+        taskFormDialogComponent?: React.ReactNode;
+        s4TViewerDialogComponent?: React.ReactNode;
+    };
+}
+export interface ExportDataProps {
+    dataColumns?: Array<IColumnProps>;
+    dataSource?: Array<any>;
+    selectedRowKeys?: Array<number>;
+}
+export interface UIConfigProps {
+    floatingBarContainerRef?: RefObject<HTMLElement | null>;
+    customButtonsLayout?: LayoutDescriptor;
+    workingGroupContext?: WorkingGroupDescriptor;
+    allowFloatingBar?: boolean;
+    enablePinIcons?: boolean;
+    openDcmtFormAsModal?: boolean;
+    showDcmtFormSidebar?: boolean;
+    allowRelations?: boolean;
+    openS4TViewer?: boolean;
+    editPdfForm?: boolean;
+    showTodoDcmtForm?: boolean;
+    showToppyDraggableHelpCenter?: boolean;
+    toppyHelpCenterUsePortal?: boolean;
+    inputDcmtFormLayoutMode?: LayoutModes;
+}
+export interface TasksProps {
+    allTasks?: Array<TaskDescriptor>;
+    getAllTasks?: () => Promise<void>;
+    deleteTaskByIdsCallback?: (deletedTaskIds: Array<number>) => Promise<void>;
+    addTaskCallback?: (task: TaskDescriptor) => Promise<void>;
+    editTaskCallback?: (task: TaskDescriptor) => Promise<void>;
+}
+export interface OperationCallbacks {
+    onRefreshSearchAsync?: (() => Promise<void>);
+    onSavedAsyncCallback?: (tid: number | undefined, did: number | undefined, metadataResult?: SearchResultDescriptor | null) => Promise<void>;
+    onRefreshAfterAddDcmtToFavs?: () => void;
+    onWFOperationCompleted?: () => Promise<void>;
+    canNavigateHandler?: (dir: "next" | "prev") => boolean;
+    onNavigateHandler?: (dir: "next" | "prev") => void;
+    handleNavigateToWGs?: (value: HomeBlogPost | number) => Promise<void>;
+    handleNavigateToDossiers?: (value: HomeBlogPost | number) => Promise<void>;
+    onReferenceClick?: (ref: ObjectRef) => void;
+    openAddDocumentForm?: () => void;
+    openCommentFormCallback?: ((documents: Array<DcmtInfo>) => void);
+    onFileOpened?: (blob: File | undefined) => void;
+    passToArchiveCallback?: (outputMids: Array<{
+        mid: number;
+        value: string;
+    }>, tid?: number) => void;
+    openWGsCopyMoveForm?: (mode: "copyToWgDraft" | "copyToWgArchivedDoc", dcmtTypeDescriptor: DcmtTypeDescriptor, documents: Array<DcmtInfo>) => void;
+    onOpenS4TViewerRequest?: (dcmtInfo: Array<DcmtInfo>, refreshDocumentPreview?: () => Promise<void>) => void;
+    onOpenPdfEditorRequest?: (dcmtInfo: Array<DcmtInfo>, refreshDocumentPreview?: () => Promise<void>) => void;
+    openFileUploaderPdfEditor?: (fromDTD?: DcmtTypeDescriptor, file?: File | null, handleFile?: (file: File) => void) => void;
+    onTaskCreateRequest?: (taskContext: TaskContext, onTaskCreated?: (task?: TaskDescriptor) => void) => void;
+    openTaskFormHandler?: (onTaskCreated?: (task?: TaskDescriptor) => void) => void;
+}
+interface UseDocumentOperationsProps {
+    context: SearchResultContext;
+    documentData: DocumentDataProps;
+    uiConfig: UIConfigProps;
+    tasks: TasksProps;
+    callbacks: OperationCallbacks;
+    exportData?: ExportDataProps;
+}
+export interface UseDocumentOperationsResult {
+    operationItems: Array<TMContextMenuItemProps>;
+    renderFloatingBar: React.ReactNode;
+    renderDcmtOperations: React.ReactNode;
+    features: {
+        isOpenDcmtForm: boolean;
+        openFormHandler: (layoutMode: LayoutModes) => void;
+        dcmtFormLayoutMode: LayoutModes;
+        onDcmtFormOpenChange: (isOpen: boolean, layoutMode: LayoutModes) => void;
+        isOpenBatchUpdate: boolean;
+        isModifiedBatchUpdate: boolean;
+        updateBatchUpdateForm: (value: boolean) => void;
+        handleSignApprove: () => void;
+        showSearchTMDatagrid: boolean;
+        showExportForm: boolean;
+        checkoutInfo: UseCheckInOutOperationsReturn;
+        relatedDocumentsInfo: UseRelatedDocumentsReturn;
+        dcmtOperations: UseDcmtOperationsReturn;
+        toppyOperations: {
+            showApprovePopup: boolean;
+            showRejectPopup: boolean;
+            showReAssignPopup: boolean;
+            showMoreInfoPopup: boolean;
+            updateShowApprovePopup: (value: boolean) => void;
+            updateShowRejectPopup: (value: boolean) => void;
+            updateShowReAssignPopup: (value: boolean) => void;
+            updateShowMoreInfoPopup: (value: boolean) => void;
+        };
+    };
+}
+export interface ExportData {
+    dataColumns?: Array<IColumnProps>;
+    dataSource?: Array<any>;
+    selectedRowKeys?: Array<number>;
+    searchResult?: SearchResultDescriptor;
+}
+export declare const getSelectedDcmtsOrFocused: (selectedItems: Array<any>, focusedItem: any, fileFormat?: FileFormats) => DcmtInfo[];
+export declare const getAllFieldSelectedDcmtsOrFocused: (selectedItems: Array<any>, focusedItem: any, fileFormat?: FileFormats) => any[];
+export declare const useDocumentOperations: (props: UseDocumentOperationsProps) => UseDocumentOperationsResult;
+export {};