@topconsultnpm/sdkui-react 6.20.0-dev1.13 → 6.20.0-dev1.131

package/lib/helper/TMPdfViewer.js

@@ -0,0 +1,373 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState, useRef, useCallback } from "react";
+import styled from "styled-components";
+import { LoadIndicator } from 'devextreme-react/load-indicator';
+import { IconCloseOutline } from "./TMIcons";
+import { SDKUI_Localizator } from "./SDKUI_Localizator";
+import { TMColors } from "../utils/theme";
+import { TMMessageBoxManager, ButtonNames } from "../components/base/TMPopUp";
+// Dynamic imports for optional dependencies
+let pdfjs;
+let Document;
+let Page;
+let isReactPdfAvailable = false;
+try {
+    const reactPdf = require('react-pdf');
+    pdfjs = reactPdf.pdfjs;
+    Document = reactPdf.Document;
+    Page = reactPdf.Page;
+    // Configura il worker PDF.js PRIMA del rendering
+    pdfjs.GlobalWorkerOptions.workerSrc = `https://unpkg.com/pdfjs-dist@${pdfjs.version}/build/pdf.worker.min.mjs`;
+    isReactPdfAvailable = true;
+}
+catch (error) {
+    // react-pdf not available - will use iframe fallback
+    // console.warn('react-pdf is not installed. TMPdfViewer will use iframe fallback.');
+}
+const PDFViewerContainer = styled.div `
+  width: 100%;
+  height: 100%;
+  overflow-y: auto;
+  overflow-x: hidden;
+  background-color: #f5f5f5;
+  position: relative;
+  
+  .react-pdf__Document {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 10px;
+    padding: 10px 0;
+  }
+  
+  .react-pdf__Page {
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+    margin: 0 auto;
+  }
+  
+  .react-pdf__Page__canvas {
+    max-width: 100%;
+    height: auto !important;
+  }
+`;
+const LoadingOverlay = styled.div `
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  background-color: rgba(245, 245, 245, 0.95);
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  z-index: 1000;
+`;
+const TMPdfViewer = (props) => {
+    const { pdfBlob, title = "Anteprima PDF", isResizingActive, enableFitToWidth = false } = props;
+    const [isMobile, setIsMobile] = useState(false);
+    const [totalPagesNumber, setTotalPagesNumber] = useState(0);
+    const [loadedPagesNumber, setLoadedPagesNumber] = useState(0);
+    const [visiblePages, setVisiblePages] = useState(new Set([1]));
+    const [pdfUrl, setPdfUrl] = useState("");
+    const [hasUnsafeContent, setHasUnsafeContent] = useState(false);
+    const [isCheckingPdf, setIsCheckingPdf] = useState(true);
+    const [jsMatches, setJsMatches] = useState([]);
+    const observerRef = useRef(null);
+    useEffect(() => {
+        const checkIsMobile = () => {
+            try {
+                const userAgent = navigator.userAgent || window.opera;
+                // Detect actual mobile/tablet devices
+                const isMobileDevice = 
+                // User agent detection (phones and tablets)
+                /android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(userAgent) ||
+                    // Media query for touch devices with coarse pointer (more reliable than screen width)
+                    (window.matchMedia?.('(hover: none) and (pointer: coarse)').matches ?? false) ||
+                    // Touch-capable devices excluding desktop OS
+                    (navigator.maxTouchPoints > 1 && !/Win|Mac|Linux x86_64/i.test(userAgent));
+                setIsMobile(isMobileDevice);
+            }
+            catch (error) {
+                setIsMobile(false);
+            }
+        };
+        const checkPdfForJavaScript = async () => {
+            setIsCheckingPdf(true);
+            try {
+                // Legge il PDF come testo per cercare pattern di JavaScript
+                const arrayBuffer = await pdfBlob.arrayBuffer();
+                const uint8Array = new Uint8Array(arrayBuffer);
+                const text = new TextDecoder('latin1').decode(uint8Array);
+                // Pattern specifici per rilevare JavaScript effettivo nelle strutture PDF
+                const jsPatterns = [
+                    // Esempio: /JavaScript [ (app.alert('Hello');) ]
+                    { name: 'JavaScript Dictionary Entry', pattern: /\/JavaScript\s*[(\[<][\s\S]*?[)\]>]/i },
+                    // Esempio: /JS 15 0 R (riferimento a un oggetto JavaScript)
+                    { name: 'JavaScript Object Reference', pattern: /\/JS\s+\d+\s+\d+\s+R/i },
+                    // Esempio: /JS (app.alert('Click');) o /JS <hexstring>
+                    { name: 'Inline JavaScript Code', pattern: /\/JS\s*[(<][\s\S]*?[)>]/i },
+                    // Esempio: /AA << /O << /S /JavaScript /JS (app.alert('Open');) >> >>
+                    { name: 'Additional Actions (AA) with JavaScript', pattern: /\/AA\s*<<[\s\S]*?\/JS[\s\S]*?>>/is },
+                    // Esempio: /OpenAction << /S /JavaScript /JS (this.print();) >>
+                    { name: 'Document Open Action with JavaScript', pattern: /\/OpenAction\s*<<[\s\S]*?\/JS[\s\S]*?>>/is },
+                    // Esempio: /Names << /JavaScript [ (MyScript) 12 0 R ] >>
+                    { name: 'Named JavaScript Functions', pattern: /\/Names\s*<<[\s\S]*?\/JavaScript[\s\S]*?>>/is },
+                ];
+                let foundJS = false;
+                const matches = [];
+                jsPatterns.forEach(({ name, pattern }) => {
+                    const match = text.match(pattern);
+                    if (match) {
+                        foundJS = true;
+                        const matchIndex = match.index || 0;
+                        const contextStart = Math.max(0, matchIndex - 50);
+                        const contextEnd = Math.min(text.length, matchIndex + match[0].length + 50);
+                        const context = text.substring(contextStart, contextEnd);
+                        matches.push({
+                            name,
+                            pattern: pattern.toString(),
+                            match: match[0],
+                            context: context.replace(/[\r\n]+/g, ' ').trim()
+                        });
+                    }
+                });
+                setHasUnsafeContent(foundJS);
+                setJsMatches(matches);
+            }
+            catch (error) {
+                // console.error('Errore nella validazione del PDF:', error);
+                // In caso di errore, permetti la visualizzazione
+                setHasUnsafeContent(false);
+            }
+            finally {
+                setIsCheckingPdf(false);
+            }
+        };
+        checkIsMobile();
+        checkPdfForJavaScript();
+        // Create URL for iframe
+        const url = URL.createObjectURL(pdfBlob);
+        setPdfUrl(url);
+        return () => {
+            if (url) {
+                URL.revokeObjectURL(url);
+            }
+        };
+    }, [pdfBlob]);
+    /**
+     * Callback per l'Intersection Observer che gestisce il lazy loading delle pagine PDF.
+     * Viene chiamato ogni volta che una pagina entra o esce dal viewport (area visibile).
+     *
+     * - Monitora quando gli elementi (pagine) diventano visibili
+     * - Aggiunge il numero di pagina al Set delle pagine visibili quando entra nel viewport
+     * - Il rootMargin di 500px carica le pagine prima che siano effettivamente visibili (preloading)
+     */
+    const pageObserverCallback = useCallback((entries) => {
+        entries.forEach(entry => {
+            const pageNum = parseInt(entry.target.getAttribute('data-page-number') || '0');
+            if (entry.isIntersecting) {
+                // Aggiunge la pagina al Set di quelle da renderizzare
+                setVisiblePages(prev => new Set([...prev, pageNum]));
+            }
+        });
+    }, []);
+    /**
+     * Crea e configura l'Intersection Observer per il lazy loading.
+     *
+     * Configurazione:
+     * - root: null → osserva rispetto al viewport del browser
+     * - rootMargin: '500px' → inizia il caricamento 500px prima che la pagina sia visibile (buffer)
+     * - threshold: 0.01 → trigger quando anche solo l'1% dell'elemento è visibile
+     *
+     * Benefici:
+     * - Non blocca l'UI durante il rendering
+     * - Carica solo le pagine necessarie
+     * - Migliora le performance su PDF con molte pagine
+     */
+    useEffect(() => {
+        observerRef.current = new IntersectionObserver(pageObserverCallback, {
+            root: null,
+            rootMargin: '500px',
+            threshold: 0.01
+        });
+        return () => {
+            // Cleanup: disconnette l'observer quando il componente viene smontato
+            observerRef.current?.disconnect();
+        };
+    }, [pageObserverCallback]);
+    const showMatchDetails = () => {
+        const highlightMatch = (context, matchText) => {
+            const matchIndex = context.indexOf(matchText);
+            if (matchIndex === -1) {
+                // Se non trova il match esatto, prova con una versione normalizzata
+                const normalizedContext = context.replace(/\s+/g, ' ');
+                const normalizedMatch = matchText.replace(/\s+/g, ' ');
+                const normalizedIndex = normalizedContext.indexOf(normalizedMatch);
+                if (normalizedIndex === -1) {
+                    // Se ancora non trova, mostra tutto in grassetto rosso
+                    return _jsx("strong", { style: { color: '#d32f2f', fontWeight: 'bold' }, children: context });
+                }
+                return (_jsxs(_Fragment, { children: [normalizedContext.substring(0, normalizedIndex), _jsx("strong", { style: { color: '#d32f2f', fontWeight: 'bold', background: '#ffebee' }, children: normalizedContext.substring(normalizedIndex, normalizedIndex + normalizedMatch.length) }), normalizedContext.substring(normalizedIndex + normalizedMatch.length)] }));
+            }
+            return (_jsxs(_Fragment, { children: [context.substring(0, matchIndex), _jsx("strong", { style: { color: '#d32f2f', fontWeight: 'bold', background: '#ffebee' }, children: context.substring(matchIndex, matchIndex + matchText.length) }), context.substring(matchIndex + matchText.length)] }));
+        };
+        TMMessageBoxManager.show({
+            title: `${SDKUI_Localizator.Attention}: ${SDKUI_Localizator.PotentiallyUnsafeContent}`,
+            buttons: [ButtonNames.OK],
+            showToppy: false,
+            resizable: true,
+            initialWidth: !isMobile ? '800px' : undefined,
+            message: (_jsxs("div", { style: { maxHeight: '500px', overflowY: 'auto', padding: '10px', lineHeight: '1.6' }, children: [_jsxs("div", { style: {
+                            marginBottom: '20px',
+                            padding: '12px',
+                            background: '#fff3cd',
+                            border: '1px solid #ffc107',
+                            borderRadius: '6px',
+                            fontSize: '14px',
+                            wordBreak: 'normal',
+                            hyphens: 'none'
+                        }, children: [_jsxs("strong", { children: [SDKUI_Localizator.Attention, ":"] }), " ", SDKUI_Localizator.PotentiallyUnsafeCodePatternsDetected.replaceParams(jsMatches.length.toString())] }), jsMatches.length > 0 ? (jsMatches.map((match, index) => (_jsxs("div", { style: {
+                            marginBottom: '16px',
+                            padding: '16px',
+                            border: '1px solid #ffcdd2',
+                            borderRadius: '8px',
+                            background: '#fff',
+                            boxShadow: '0 1px 3px rgba(0,0,0,0.1)'
+                        }, children: [_jsx("div", { style: {
+                                    marginBottom: '12px',
+                                    paddingBottom: '8px',
+                                    borderBottom: '2px solid #f44336'
+                                }, children: _jsxs("strong", { style: {
+                                        color: '#d32f2f',
+                                        fontSize: '15px',
+                                        display: 'flex',
+                                        alignItems: 'center',
+                                        gap: '8px'
+                                    }, children: [_jsx("span", { style: {
+                                                background: '#f44336',
+                                                color: '#fff',
+                                                borderRadius: '50%',
+                                                width: '24px',
+                                                height: '24px',
+                                                display: 'inline-flex',
+                                                alignItems: 'center',
+                                                justifyContent: 'center',
+                                                fontSize: '13px',
+                                                fontWeight: 'bold'
+                                            }, children: index + 1 }), match.name] }) }), _jsx("div", { style: { fontSize: '13px' }, children: _jsx("div", { style: {
+                                        background: '#f5f5f5',
+                                        padding: '10px',
+                                        borderRadius: '4px',
+                                        borderLeft: '3px solid #f44336',
+                                        fontFamily: 'Consolas, Monaco, monospace',
+                                        fontSize: '12px',
+                                        wordBreak: 'break-all',
+                                        color: '#333',
+                                        maxHeight: '200px',
+                                        overflowY: 'auto',
+                                        userSelect: 'text'
+                                    }, children: highlightMatch(match.context, match.match) }) })] }, index)))) : (_jsx("div", { style: { textAlign: 'center', padding: '20px', color: '#999' }, children: "Nessun dettaglio disponibile" }))] }))
+        });
+    };
+    // Mostra loading durante la validazione
+    if (isCheckingPdf) {
+        return (_jsx(PDFViewerContainer, { children: _jsxs("div", { style: {
+                    display: 'flex',
+                    justifyContent: 'center',
+                    alignItems: 'center',
+                    height: '100%',
+                    flexDirection: 'column',
+                    gap: '10px'
+                }, children: [_jsx(LoadIndicator, { height: 60, width: 60 }), _jsx("div", { children: "Validazione PDF in corso..." })] }) }));
+    }
+    /**
+     * Usa <iframe> nei seguenti casi:
+     * 1. react-pdf non è disponibile (libreria non installata)
+     * 2. Desktop E nessun contenuto JavaScript rilevato (visualizzazione nativa del browser più performante)
+     *
+     * L'iframe sfrutta il visualizzatore PDF nativo del browser, ma non può prevenire
+     * l'esecuzione di JavaScript embedded nel PDF.
+     */
+    if (!isReactPdfAvailable || (!isMobile && !hasUnsafeContent && pdfUrl)) {
+        return (_jsx(PDFViewerContainer, { children: _jsx("iframe", { src: `${pdfUrl}#${enableFitToWidth ? 'view=FitH&' : ''}scrollbar=1`, title: title, style: {
+                    width: '100%',
+                    height: '100%',
+                    border: 'none',
+                    zIndex: 0,
+                    pointerEvents: isResizingActive === true ? "none" : "auto"
+                } }, pdfUrl) }));
+    }
+    /**
+     * Usa react-pdf nei seguenti casi:
+     * 1. Dispositivo mobile (migliore esperienza utente con lazy loading)
+     * 2. Desktop con contenuto JavaScript rilevato (rendering sicuro senza esecuzione di script)
+     *
+     * react-pdf renderizza il PDF come canvas, prevenendo l'esecuzione di JavaScript embedded,
+     * ma è meno performante dell'iframe nativo su desktop.
+     */
+    return _jsxs(PDFViewerContainer, { style: { display: 'flex', flexDirection: 'column' }, children: [loadedPagesNumber === 0 && totalPagesNumber > 0 && _jsx(LoadingOverlay, { children: _jsxs("div", { style: {
+                        display: 'flex',
+                        justifyContent: 'center',
+                        alignItems: 'center',
+                        flexDirection: 'column',
+                        gap: '10px'
+                    }, children: [_jsx(LoadIndicator, { height: 60, width: 60 }), _jsxs("div", { children: [SDKUI_Localizator.Loading, "..."] })] }) }), _jsx("div", { style: {
+                    display: loadedPagesNumber > 0 && totalPagesNumber > 0 ? 'block' : 'none',
+                    flex: 1,
+                    overflow: 'auto'
+                }, children: _jsx(Document, { file: pdfBlob, onLoadSuccess: ({ numPages }) => {
+                        setTotalPagesNumber(numPages);
+                        setLoadedPagesNumber(0);
+                    }, loading: _jsxs("div", { style: {
+                            display: 'flex',
+                            justifyContent: 'center',
+                            alignItems: 'center',
+                            height: '100%',
+                            flexDirection: 'column',
+                            gap: '10px'
+                        }, children: [_jsx(LoadIndicator, { height: 60, width: 60 }), _jsxs("div", { children: [SDKUI_Localizator.Loading, "..."] })] }), error: _jsxs("div", { style: {
+                            display: 'flex',
+                            justifyContent: 'center',
+                            alignItems: 'center',
+                            height: '100%',
+                            flexDirection: 'column',
+                            gap: '10px'
+                        }, children: [_jsx(IconCloseOutline, { fontSize: 64, color: TMColors.error }), _jsx("div", { children: "Errore nel caricamento del PDF" })] }), children: Array.from(new Array(totalPagesNumber), (el, index) => {
+                        const pageNumber = index + 1;
+                        const shouldRender = visiblePages.has(pageNumber);
+                        return (_jsx("div", { "data-page-number": pageNumber, ref: (el) => {
+                                if (el && observerRef.current) {
+                                    observerRef.current.observe(el);
+                                }
+                            }, style: {
+                                minHeight: shouldRender ? 'auto' : '1000px',
+                                display: 'flex',
+                                justifyContent: 'center',
+                                alignItems: 'center'
+                            }, children: shouldRender && (_jsx(Page, { pageNumber: pageNumber, renderTextLayer: false, renderAnnotationLayer: false, width: Math.min(window.innerWidth - 40, 1200), loading: _jsx("div", { style: { padding: '20px' }, children: _jsx(LoadIndicator, { height: 40, width: 40 }) }), onLoadSuccess: () => {
+                                    setLoadedPagesNumber(prev => prev + 1);
+                                } })) }, `page_${pageNumber}`));
+                    }) }) }), hasUnsafeContent && (_jsxs("div", { style: {
+                    display: 'flex',
+                    justifyContent: 'center',
+                    alignItems: 'center',
+                    padding: '12px 20px',
+                    background: '#fff3cd',
+                    borderTop: '2px solid #ffc107',
+                    gap: '8px',
+                    flexShrink: 0
+                }, children: [_jsxs("span", { style: {
+                            color: '#856404',
+                            whiteSpace: 'nowrap',
+                            overflow: 'hidden',
+                            textOverflow: 'ellipsis',
+                            flex: 1
+                        }, children: [_jsx("strong", { children: "Attenzione:" }), " Questo documento contiene contenuti potenzialmente non sicuri."] }), jsMatches.length > 0 && (_jsx("span", { className: "dx-icon-info", style: {
+                            fontSize: '20px',
+                            color: '#d32f2f',
+                            cursor: 'pointer',
+                            transition: 'color 0.2s',
+                            marginLeft: '4px'
+                        }, onClick: showMatchDetails, title: "Clicca per vedere i dettagli", onMouseEnter: (e) => e.currentTarget.style.color = '#b71c1c', onMouseLeave: (e) => e.currentTarget.style.color = '#d32f2f' }))] }))] });
+};
+export default TMPdfViewer;

package/lib/helper/TMToppyMessage.js

@@ -19,6 +19,8 @@ const StyledToppyText = styled.div `
     color: #2559A5;
     font-size: 1rem;
     user-select: none;
+    -webkit-touch-callout: none;
+    -webkit-user-select: none;
     margin: 0;
     display: -webkit-box;
     -webkit-box-orient: vertical;
@@ -35,6 +37,8 @@ const StyledToppyImage = styled.img `
     height: auto;
     display: block;
     user-select: none;
+    -webkit-touch-callout: none;
+    -webkit-user-select: none;
 `;
 const TMToppyMessage = (props) => {
     const { message, titleTooltip, maxWidth } = props;

package/lib/helper/checkinCheckoutManager.d.ts

@@ -1,11 +1,20 @@
 import React from "react";
-import { DcmtTypeDescriptor, FileDescriptor, UserDescriptor } from "@topconsultnpm/sdk-ts";
+import { AccessLevels, DcmtTypeDescriptor, FileDescriptor, UserDescriptor } from "@topconsultnpm/sdk-ts";
 import { DcmtInfo, DownloadModes, DownloadTypes } from "../ts/types";
 import { FileItem } from "../components";
 /**
  * Check-in/Check-out Manager
  * Questo modulo gestisce tutte le operazioni di check-in e check-out
  * dei documenti e delle bozze dei gruppi di lavoro.
+ *
+ * Operazioni gestite:
+ * - Generazione nomi file per download e checkout con timestamp e identificatori univoci
+ * - Download di documenti in modalità checkout
+ * - Gestione dello storage locale delle informazioni di checkout (aggiunta, aggiornamento, rimozione)
+ * - Validazione dei nomi file secondo le convenzioni di naming CICO
+ * - Rendering dell'interfaccia utente per conferma check-in con visualizzazione anomalie
+ * - Determinazione dello stato di check-out dei documenti (editMode/lockMode)
+ * - Verifica permessi e abilitazione funzionalità CICO per tipo documento
  */
 export interface CheckoutInfo {
     DID: string;
@@ -18,6 +27,7 @@ interface CheckoutStatusResult {
     mode: 'editMode' | 'lockMode' | '';
     version: number;
     icon: React.ReactNode | null;
+    editLockTooltipText: React.ReactNode | null;
 }
 export type DownloadSource = {
     type: 'fileItem';
@@ -48,6 +58,26 @@ type FileNameValidation = {
     validationResults?: FileNameValidationItems;
 };
 export declare const renderCicoCheckInContent: (source: DownloadSource, selectedFilename: File, isValid: boolean, validationItems: FileNameValidationItems | undefined, color?: string) => React.ReactNode;
+interface CheckInCheckOutDcmtInfo {
+    CICO: number;
+    CanCICO: AccessLevels;
+    CanDelChronology: AccessLevels;
+    UserID_MID: number;
+    Date_MID: number;
+    Ver_MID: number;
+    UserID_CanViewOrUpdate: AccessLevels;
+    Date_CanViewOrUpdate: AccessLevels;
+    Ver_CanViewOrUpdate: AccessLevels;
+}
+export declare const getDcmtCicoInfo: (dtd: DcmtTypeDescriptor | undefined) => CheckInCheckOutDcmtInfo;
+/**
+ * Determina lo stato di check-in/check-out di un documento
+ *
+ * @param dcmt - Il documento in formato array (MetadataValueDescriptorEx[]) o oggetto piatto
+ * @param allUsers - Lista di tutti gli utenti per risolvere i nomi
+ * @param dtd - Descrittore del tipo documento contenente le definizioni dei metadati CICO
+ * @returns Oggetto con cicoEnabled (se CICO è abilitato) e checkoutStatus (dettagli dello stato)
+ */
 export declare const getDcmtCicoStatus: (dcmt: any, allUsers: Array<UserDescriptor>, dtd: DcmtTypeDescriptor | undefined) => {
     cicoEnabled: boolean;
     checkoutStatus: CheckoutStatusResult;

package/lib/helper/checkinCheckoutManager.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { AccessLevels, CICO_MetadataNames, SDK_Globals } from "@topconsultnpm/sdk-ts";
+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 { DownloadTypes } from "../ts/types";
@@ -191,7 +191,7 @@ export const renderCicoCheckInContent = (source, selectedFilename, isValid, vali
     const fileName = source.type === 'fileItem' ? source.fileItem.name : (source.dcmtInfo.fileName ?? SDKUI_Localizator.SearchResult);
     return _jsxs("div", { style: { width: "100%", height: "100%" }, children: [SDKUI_Localizator.CheckInElementConfirm.replaceParams(fileName), !isValid && _jsxs("div", { style: { width: "100%", height: "100%", marginTop: '15px' }, children: [_jsxs("div", { style: { display: 'flex', flexDirection: 'column' }, children: [_jsx("div", { style: { fontSize: '12px', color, marginBottom: '12px' }, children: SDKUI_Localizator.ElementNameConventionError }), _jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: '6px' }, children: [_jsxs("div", { style: { color }, children: [_jsx("strong", { style: { color }, children: SDKUI_Localizator.Expected }), ":", ' ', _jsx("span", { style: { fontStyle: 'italic' }, children: getCicoDownloadFileName(source, true, false) })] }), _jsxs("div", { style: { color }, children: [_jsx("strong", { style: { color }, children: SDKUI_Localizator.SelectedSingular }), ":", ' ', _jsx("span", { style: { fontStyle: 'italic' }, children: selectedFilename.name })] })] })] }), validationItems && Object.entries(validationItems).filter(([_, value]) => !value.isValid).length > 0 && (_jsxs("div", { style: { width: "100%", height: "100%", marginTop: '15px' }, children: [_jsx("hr", {}), _jsxs("table", { style: { width: "100%", borderCollapse: "collapse", color }, children: [_jsx("caption", { style: { textAlign: "center", fontWeight: "bold", marginBottom: "5px" }, children: SDKUI_Localizator.Anomalies }), _jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { style: { textAlign: "left", borderBottom: "1px solid #eee" }, children: SDKUI_Localizator.Value }), _jsx("th", { style: { textAlign: "left", borderBottom: "1px solid #eee" }, children: SDKUI_Localizator.Expected }), _jsx("th", { style: { textAlign: "left", borderBottom: "1px solid #eee" }, children: SDKUI_Localizator.Current })] }) }), _jsx("tbody", { children: Object.entries(validationItems).filter(([_, value]) => !value.isValid).map(([key, result]) => (_jsxs("tr", { children: [_jsx("td", { style: { borderBottom: "1px solid #eee" }, children: _jsx("strong", { style: { textTransform: "capitalize" }, children: key }) }), _jsxs("td", { style: { borderBottom: "1px solid #eee" }, children: [" ", result.expected || "-"] }), _jsxs("td", { style: { borderBottom: "1px solid #eee" }, children: [" ", result.current || "-"] })] }, key))) })] }), _jsx("hr", {})] })), _jsx("div", { style: { fontSize: '12px', marginTop: '15px', marginBottom: '15px' }, children: SDKUI_Localizator.ProceedAnyway })] })] });
 };
-const getDcmtCicoInfo = (dtd) => {
+export const getDcmtCicoInfo = (dtd) => {
     const cico = {
         CICO: 0,
         CanCICO: AccessLevels.No,
@@ -210,57 +210,139 @@ const getDcmtCicoInfo = (dtd) => {
     cico.CanDelChronology = dtd.perm?.canDelChron ?? AccessLevels.No;
     const mdCheckout = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_CheckoutUserID);
     if (mdCheckout) {
-        cico.UserID_MID = mdCheckout.fromMID;
+        cico.UserID_MID = mdCheckout.id;
         cico.UserID_CanViewOrUpdate = (mdCheckout.perm?.canView == AccessLevels.Yes || mdCheckout.perm?.canUpdate == AccessLevels.Yes) ? AccessLevels.Yes : AccessLevels.No;
     }
     const mdDate = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_CheckoutDate);
     if (mdDate) {
-        cico.Date_MID = mdDate.fromMID;
+        cico.Date_MID = mdDate.id;
         cico.Date_CanViewOrUpdate = (mdDate.perm?.canView == AccessLevels.Yes || mdDate.perm?.canUpdate == AccessLevels.Yes) ? AccessLevels.Yes : AccessLevels.No;
     }
     const mdVer = dtd.metadata?.find(md => md.name === CICO_MetadataNames.CICO_Version);
     if (mdVer) {
-        cico.Ver_MID = mdVer.fromMID;
+        cico.Ver_MID = mdVer.id;
         cico.Ver_CanViewOrUpdate = (mdVer.perm?.canView == AccessLevels.Yes || mdVer.perm?.canUpdate == AccessLevels.Yes) ? AccessLevels.Yes : AccessLevels.No;
     }
     return cico;
 };
+/**
+ * Determina lo stato di check-in/check-out di un documento
+ *
+ * @param dcmt - Il documento in formato array (MetadataValueDescriptorEx[]) o oggetto piatto
+ * @param allUsers - Lista di tutti gli utenti per risolvere i nomi
+ * @param dtd - Descrittore del tipo documento contenente le definizioni dei metadati CICO
+ * @returns Oggetto con cicoEnabled (se CICO è abilitato) e checkoutStatus (dettagli dello stato)
+ */
 export const getDcmtCicoStatus = (dcmt, allUsers, dtd) => {
+    // ========================================================================
+    // VALIDAZIONE PARAMETRI
+    // ========================================================================
+    // Se i parametri essenziali non sono forniti, ritorna stato di default
     if (dcmt === undefined || dtd === undefined) {
         return {
             cicoEnabled: false,
-            checkoutStatus: { isCheckedOut: false, mode: '', version: 1, icon: null }
+            checkoutStatus: { isCheckedOut: false, mode: '', version: 1, icon: null, editLockTooltipText: null }
         };
     }
+    // ========================================================================
+    // ESTRAZIONE INFORMAZIONI CICO DAL DTD
+    // ========================================================================
+    // Recupera le configurazioni e permessi CICO dal tipo documento
     const cicoInfo = getDcmtCicoInfo(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 keyVersion = dcmt.TID + "_" + (CICO_Version_Meta?.id ?? 0);
-    const versionRaw = CICO_Version_Meta?.id ? dcmt[keyVersion] : undefined;
-    const version = (versionRaw != null && !isNaN(Number(versionRaw))) ? Number(versionRaw) : 1;
-    let checkoutStatus = { isCheckedOut: false, mode: '', version: version, icon: null, };
     const userID = SDK_Globals.tmSession?.SessionDescr?.userID;
-    if (dcmt && CICO_CheckoutUserID_Meta?.id) {
-        const keyUserID = dcmt.TID + "_" + CICO_CheckoutUserID_Meta.id;
-        const checkoutUserIdValue = dcmt[keyUserID];
-        const checkoutUserId = Number(checkoutUserIdValue);
-        if (userID && checkoutUserIdValue && !isNaN(checkoutUserId) && checkoutUserId > 0) {
-            // editMode: l'utente corrente è quello che ha fatto il checkout
-            // lockMode: un altro utente ha fatto il checkout
-            const mode = (userID && userID === checkoutUserId) ? 'editMode' : 'lockMode';
-            // Recupera i dati aggiuntivi per il tooltip
-            const keyDate = dcmt.TID + "_" + (CICO_CheckoutDate_Meta?.id ?? 0);
-            const checkoutDate = CICO_CheckoutDate_Meta?.id ? dcmt[keyDate] : undefined;
-            const editLockTooltipText = _jsxs(_Fragment, { children: [_jsxs("div", { style: { textAlign: "center" }, children: [mode === 'editMode' && (_jsxs(_Fragment, { children: [_jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-edit" }), SDKUI_Localizator.CurrentUserExtract] })), mode === 'lockMode' && (_jsxs(_Fragment, { children: [_jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-lock" }), SDKUI_Localizator.ExtractedFromOtherUser] }))] }), _jsx("hr", {}), _jsxs("div", { style: { textAlign: "left" }, children: [_jsxs("ul", { children: [_jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.ExtractedBy }), ": ", findCheckOutUserName(allUsers, checkoutUserId), " (ID: ", checkoutUserId, ")"] }), _jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.ExtractedOn }), ": ", Globalization.getDateTimeDisplayValue(checkoutDate?.toString())] })] }), _jsx("hr", {}), _jsx("ul", { children: _jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.Version }), ": ", version ?? 1] }) })] })] });
-            const icon = mode === 'editMode'
-                ? _jsx(TMTooltip, { content: editLockTooltipText, children: _jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-edit" }) })
-                : _jsx(TMTooltip, { content: editLockTooltipText, children: _jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-lock" }) });
-            checkoutStatus = { isCheckedOut: true, mode: mode, icon: icon, version: version };
+    // Variabili comuni per entrambi i formati di documento
+    let checkoutUserId;
+    let checkoutDate;
+    let version = 1;
+    let fileExt;
+    // ========================================================================
+    // CASO 1: Documento come Array di MetadataValueDescriptorEx
+    // ========================================================================
+    // 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;
+        // 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;
+        checkoutUserId = checkoutUserIdValue ? Number(checkoutUserIdValue) : undefined;
+        // Estrai la data di checkout
+        const checkoutDateProperty = dcmtsArray.find((item) => item.md?.name === CICO_MetadataNames.CICO_CheckoutDate);
+        checkoutDate = checkoutDateProperty?.value;
+        // Estrai la versione del documento
+        const versionProperty = dcmtsArray.find((item) => item.md?.name === CICO_MetadataNames.CICO_Version);
+        const versionRaw = versionProperty?.value;
+        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;
+    }
+    // ========================================================================
+    // CASO 2: Documento come Oggetto Piatto (formato standard)
+    // ========================================================================
+    // Questo formato viene utilizzato quando il documento ha proprietà dirette
+    // nel formato chiave-valore: TID, DID, e "TID_MetadataID" per i metadati
+    else {
+        // Trova i metadati CICO nel descrittore del tipo documento
+        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);
+        fileExt = dcmt.FILEEXT ? dcmt.FILEEXT.toString() : null;
+        // Estrai l'ID dell'utente che ha effettuato il checkout
+        if (CICO_CheckoutUserID_Meta?.id) {
+            const keyUserID = dcmt.TID + "_" + CICO_CheckoutUserID_Meta.id;
+            const checkoutUserIdValue = dcmt[keyUserID];
+            checkoutUserId = checkoutUserIdValue ? Number(checkoutUserIdValue) : undefined;
+        }
+        // Estrai la data di checkout
+        if (CICO_CheckoutDate_Meta?.id) {
+            const keyDate = dcmt.TID + "_" + CICO_CheckoutDate_Meta.id;
+            checkoutDate = dcmt[keyDate];
+        }
+        // Estrai la versione del documento
+        if (CICO_Version_Meta?.id) {
+            const keyVersion = dcmt.TID + "_" + CICO_Version_Meta.id;
+            const versionRaw = dcmt[keyVersion];
+            version = (versionRaw != null && !isNaN(Number(versionRaw))) ? Number(versionRaw) : 1;
         }
     }
+    // ========================================================================
+    // COSTRUZIONE DELLO STATO DI CHECKOUT
+    // ========================================================================
+    let checkoutStatus = {
+        isCheckedOut: false,
+        mode: '',
+        version: version,
+        icon: null,
+        editLockTooltipText: null
+    };
+    // Verifica se il documento è effettivamente in stato di checkout
+    if (userID && checkoutUserId && !isNaN(checkoutUserId) && checkoutUserId > 0) {
+        // Determina la modalità in base all'utente:
+        // - editMode: l'utente corrente può modificare (è lui che ha fatto il checkout)
+        // - lockMode: il documento è bloccato da un altro utente
+        const mode = (userID === checkoutUserId) ? 'editMode' : 'lockMode';
+        // ====================================================================
+        // COSTRUZIONE DEL TOOLTIP INFORMATIVO
+        // ====================================================================
+        const editLockTooltipText = (_jsxs(_Fragment, { children: [_jsxs("div", { style: { textAlign: "center" }, children: [mode === 'editMode' && (_jsxs(_Fragment, { children: [_jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-edit" }), SDKUI_Localizator.CurrentUserExtract] })), mode === 'lockMode' && (_jsxs(_Fragment, { children: [_jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-lock" }), SDKUI_Localizator.ExtractedFromOtherUser] }))] }), _jsx("hr", {}), _jsxs("div", { style: { textAlign: "left" }, children: [_jsxs("ul", { children: [_jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.ExtractedBy }), ": ", findCheckOutUserName(allUsers, checkoutUserId), " (ID: ", checkoutUserId, ")"] }), _jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.ExtractedOn }), ": ", Globalization.getDateTimeDisplayValue(checkoutDate?.toString())] })] }), _jsx("hr", {}), _jsx("ul", { children: _jsxs("li", { children: ["- ", _jsx("span", { style: { fontWeight: 'bold' }, children: SDKUI_Localizator.Version }), ": ", version] }) })] })] }));
+        // Crea l'icona con tooltip appropriata alla modalità
+        const icon = mode === 'editMode'
+            ? _jsx(TMTooltip, { content: editLockTooltipText, children: _jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-edit" }) })
+            : _jsx(TMTooltip, { content: editLockTooltipText, children: _jsx("i", { style: { fontSize: "18px", color: colors.MEDIUM_GREEN, fontWeight: "bold" }, className: "dx-icon-lock" }) });
+        checkoutStatus = {
+            isCheckedOut: true,
+            mode: mode,
+            icon: icon,
+            version: version,
+            editLockTooltipText: editLockTooltipText
+        };
+    }
+    // ========================================================================
+    // RESTITUZIONE RISULTATO FINALE
+    // ========================================================================
     return {
-        cicoEnabled: cicoInfo.CICO === 1 && cicoInfo.CanCICO === AccessLevels.Yes,
+        // CICO è abilitato se configurato nel DTD e l'utente ha i permessi
+        cicoEnabled: cicoInfo.CICO === 1 && cicoInfo.CanCICO === AccessLevels.Yes && fileExt !== null && fileExt !== '',
         checkoutStatus: checkoutStatus
     };
 };