@topconsultnpm/sdkui-react 6.20.0-dev1.3 → 6.20.0-dev1.30

package/lib/helper/TMPdfViewer.js

@@ -0,0 +1,187 @@
+import { jsx as _jsx, 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";
+// 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 observerRef = useRef(null);
+    useEffect(() => {
+        const checkIsMobile = () => {
+            const userAgent = navigator.userAgent || navigator.vendor || 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);
+        };
+        checkIsMobile();
+        // 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]);
+    // Use iframe se react-pdf non è disponibile O se è desktop
+    if (!isReactPdfAvailable || (!isMobile && 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 solo per mobile e solo se disponibile
+    return _jsxs(PDFViewerContainer, { 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' }, 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}`));
+                    }) }) })] });
+};
+export default TMPdfViewer;

package/lib/helper/TMUtils.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
-import { DataColumnDescriptor, PdGs } from '@topconsultnpm/sdk-ts';
+import { FileItem } from '../components';
+import { DataColumnDescriptor, PdGs, SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
 export declare const getFileIcon: (fileExtension: string | undefined, fileCount: number | undefined, tooltipContent?: JSX.Element | string) => import("react/jsx-runtime").JSX.Element;
 export declare function formatBytes(bytes: number | undefined, decimalPlaces?: number): string;
 export interface RowData {
@@ -64,4 +65,5 @@ export declare const parseSignatureConfiguration: (did: number, informationSign:
     allowCopyright: boolean;
     copyrightValue: string;
 };
+export declare const convertSearchResultDescriptorToFileItems: (documents: Array<SearchResultDescriptor>) => Array<FileItem>;
 export {};

package/lib/helper/TMUtils.js

@@ -382,3 +382,54 @@ export const parseSignatureConfiguration = (did, informationSign, firstName, las
         throw error;
     }
 };
+export const convertSearchResultDescriptorToFileItems = (documents) => {
+    const fileItems = [];
+    documents.forEach((doc, docIndex) => {
+        const columns = doc.dtdResult?.columns || [];
+        const rows = doc.dtdResult?.rows || [];
+        // Map column captions to their indexes for quick lookup
+        const colIndexMap = {};
+        columns.forEach((col, i) => {
+            if (col.caption !== undefined) {
+                colIndexMap[col.caption] = i;
+            }
+        });
+        const getVal = (row, caption) => {
+            const idx = colIndexMap[caption];
+            return idx !== undefined ? row[idx] : undefined;
+        };
+        rows.forEach((row, rowIndex) => {
+            let baseName = doc.fromName || `Document ${docIndex + 1}`;
+            const did = getVal(row, 'DID');
+            const fileExt = getVal(row, 'FileExt');
+            const tid = getVal(row, 'TID');
+            const fileSize = getVal(row, 'FileSize');
+            if (did) {
+                baseName += ` (DID: ${did})`;
+            }
+            if (fileExt) {
+                baseName += `.${fileExt}`;
+            }
+            fileItems.push({
+                id: did ? Number(did) : Number(`${docIndex}${rowIndex}`),
+                name: baseName,
+                isDirectory: false,
+                items: [],
+                tid: tid !== undefined ? Number(tid) : undefined,
+                did: did !== undefined ? Number(did) : undefined,
+                ext: fileExt ?? undefined,
+                size: fileSize !== undefined ? Number(fileSize) : 1,
+                creationTime: undefined,
+                lastUpdateTime: undefined,
+                updaterID: undefined,
+                updaterName: undefined,
+                description: undefined,
+                checkOutUserID: undefined,
+                checkOutUserName: undefined,
+                checkoutDate: null,
+                version: undefined,
+            });
+        });
+    });
+    return fileItems;
+};

package/lib/helper/checkinCheckoutManager.d.ts

@@ -0,0 +1,85 @@
+import React from "react";
+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;
+    TID: string;
+    checkoutFolder: string;
+    checkoutName: string;
+}
+interface CheckoutStatusResult {
+    isCheckedOut: boolean;
+    mode: 'editMode' | 'lockMode' | '';
+    version: number;
+    icon: React.ReactNode | null;
+    editLockTooltipText: React.ReactNode | null;
+}
+export type DownloadSource = {
+    type: 'fileItem';
+    fileItem: FileItem;
+} | {
+    type: 'dcmtInfo';
+    dcmtInfo: DcmtInfo;
+    originalFileName: string;
+};
+export declare const getCicoDownloadFileName: (source: DownloadSource, checkout: boolean, withTimestampAndExt: boolean) => string;
+export declare const cicoDownloadFilesCallback: (sources: Array<DownloadSource>, checkout: boolean, downloadDcmtsAsync: (inputDcmts: Array<DcmtInfo> | undefined, downloadType?: DownloadTypes, downloadMode?: DownloadModes, onFileDownloaded?: (dcmtFile: File) => void, confirmAttachments?: (list: FileDescriptor[]) => Promise<string[] | undefined>, skipConfirmation?: boolean) => Promise<void>) => Promise<void>;
+export declare const updateCicoCheckoutStorageItem: (item: CheckoutInfo, type: "fileItem" | "dcmtInfo", action?: "addOrUpdate" | "remove") => void;
+export declare const validateCicoFileName: (source: DownloadSource, fileName: string) => FileNameValidation;
+type ValidationResult = {
+    expected: string | number | undefined;
+    current: string | number | undefined;
+    isValid: boolean;
+};
+type FileNameValidationItems = {
+    name: ValidationResult;
+    archiveID: ValidationResult;
+    did: ValidationResult;
+    tid: ValidationResult;
+    fileExtension: ValidationResult;
+};
+type FileNameValidation = {
+    isValid: boolean;
+    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;
+};
+export {};