@topconsultnpm/sdkui-react 6.20.0-dev1.14 → 6.20.0-dev1.15

package/lib/helper/helpers.js

@@ -1,852 +0,0 @@
-import { Fragment as _Fragment, jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { Colors } from "../utils/theme";
-import { ButtonNames, DeviceType, TMExceptionBoxManager, TMMessageBoxManager, TMSpinner } from "../components";
-import { AccessLevels, MetadataDataDomains, MetadataDataTypes, MetadataDescriptor, MetadataFormatDescriptor, MetadataFormats, MetadataPermission, SDK_Globals, SetGlobalsInfoAsync, SystemMIDs, SystemMIDsAsNumber, TopMediaServer } from "@topconsultnpm/sdk-ts";
-import { Buffer } from 'buffer';
-import { buildTypes, FileExtensionHandler, FormModes, moduleTypes } from "../ts";
-import { SDKUI_Localizator } from "./SDKUI_Localizator";
-import ReactDOMServer from "react-dom/server";
-import { DeepCompareHelper } from "./DeepCompareHelper";
-//#region Responsive Helpers
-const TABLET_WIDTH = 1024;
-const MOBILE_WIDTH = 640;
-const calcResponsiveDirection = (deviceType, desktopDir, tabletDir, mobileDir) => {
-    if (deviceType === DeviceType.DESKTOP)
-        return desktopDir;
-    if (deviceType === DeviceType.TABLET)
-        return tabletDir;
-    return mobileDir;
-};
-const openApps = async (appModule, tmSession, appRoutes) => {
-    try {
-        window.Buffer = Buffer;
-        TMSpinner.show();
-        let toSessionDescr = await tmSession?.LoginToAsync(appModule);
-        const tmServer = new TopMediaServer(tmSession?.TopMediaServer?.BaseAddress);
-        const toTMSession = tmServer?.NewSession();
-        toTMSession.SessionDescr = toSessionDescr;
-        let str = (JSON.stringify(toTMSession));
-        let sessionToBase64 = Buffer.from(str).toString("base64");
-        window.open(appRoutes?.find(route => route.appName === appModule).URL + '/Homepage' + '?session=' + sessionToBase64);
-    }
-    catch (e) {
-        TMExceptionBoxManager.show({ exception: e.message });
-    }
-    finally {
-        TMSpinner.hide();
-    }
-};
-export const setSDK_GlobalsInfoAsync = async (tms) => {
-    try {
-        const result = await SetGlobalsInfoAsync(tms);
-        if (result?.SessionDescr?.userID && result?.SessionDescr?.archiveID) {
-            const { UserSettings } = await import('./SDKUI_Globals');
-            UserSettings.LoadSettings(result.SessionDescr.userID, result.SessionDescr.archiveID);
-        }
-        return result;
-    }
-    catch (e) {
-        TMExceptionBoxManager.show({ exception: e.message });
-        return undefined;
-    }
-};
-const calcResponsiveSizes = (deviceType, desktopSize, tabletSize, mobileSize) => {
-    if (deviceType === DeviceType.DESKTOP)
-        return desktopSize;
-    if (deviceType === DeviceType.TABLET)
-        return tabletSize;
-    return mobileSize;
-};
-//#endregion 
-const getColor = (color) => {
-    let c = '';
-    switch (color) {
-        case 'primary':
-            c = Colors.primary;
-            break;
-        case 'secondary':
-            c = Colors.secondary;
-            break;
-        case 'tertiary':
-            c = Colors.tertiary;
-            break;
-        case 'error':
-            c = Colors.error;
-            break;
-        case 'success':
-            c = Colors.success;
-            break;
-        case 'info':
-            c = Colors.info;
-            break;
-        case 'warning':
-            c = Colors.warning;
-            break;
-    }
-    return c;
-};
-/**
- * Genera un Universally Unique Identifier (UUID) versione 4.
- * Simile a Guid.NewGuid() in C#.
- * @returns {string} Un UUID in formato stringa.
- */
-export const generateUUID = () => {
-    return crypto.randomUUID();
-};
-const makeID = (length) => {
-    let result = '';
-    const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
-    const charactersLength = characters.length;
-    let counter = 0;
-    while (counter < length) {
-        result += characters.charAt(Math.floor(Math.random() * charactersLength));
-        counter += 1;
-    }
-    return result;
-};
-export const truncateText = (text, maxLength) => {
-    if (text.length <= maxLength)
-        return text;
-    return text.slice(0, maxLength) + "...";
-};
-function genUniqueId() {
-    const dateStr = Date
-        .now()
-        .toString(36); // convert num to base 36 and stringify
-    const randomStr = Math
-        .random()
-        .toString(36)
-        .substring(2, 8); // start at index 2 to skip decimal point
-    return `${dateStr}-${randomStr}`;
-}
-export const captionToDataField = (caption) => {
-    if (!caption)
-        return '';
-    //Data field names cannot be equal to this and should not contain the following characters: ., :, [, and ].
-    return caption.replace('this', '_').replace('.', '_').replace(':', '_').replace('[', '_').replace(']', '_');
-};
-const MIDtoColName = (tid, mid) => {
-    if (mid == SystemMIDsAsNumber.DID)
-        return "DID";
-    if (mid == SystemMIDsAsNumber.TID)
-        return "TID";
-    if (mid == SystemMIDsAsNumber.OwnerID)
-        return "OWNERID";
-    if (mid == SystemMIDsAsNumber.UpdaterID)
-        return "UPDATERID";
-    if (mid == SystemMIDsAsNumber.FileCount)
-        return "FILECOUNT";
-    if (mid == SystemMIDsAsNumber.FileExt)
-        return "FILEEXT";
-    if (mid == SystemMIDsAsNumber.CreationTime)
-        return "CREATIONTIME";
-    if (mid == SystemMIDsAsNumber.LastUpdateTime)
-        return "LASTUPDATETIME";
-    if (mid == SystemMIDsAsNumber.FileSize)
-        return "FILESIZE";
-    if (mid == SystemMIDsAsNumber.PageCount)
-        return "PAGECOUNT";
-    if (mid == SystemMIDsAsNumber.IsSigned)
-        return "ISSIGNED";
-    if (mid == SystemMIDsAsNumber.IsShared)
-        return "ISSHARED";
-    if (mid == SystemMIDsAsNumber.IsMail)
-        return "ISMAIL";
-    if (mid == SystemMIDsAsNumber.IsLogDel)
-        return "ISLOGDEL";
-    if (mid == SystemMIDsAsNumber.IsLex)
-        return "ISLEX";
-    return `${tid}_${mid}`;
-};
-export const getDataColumnName = (fromTID, dtColumn) => {
-    let tid = Number(dtColumn?.extendedProperties?.["TID"] ?? "0");
-    let mid = Number(dtColumn?.extendedProperties?.["MID"] ?? "0");
-    if (!tid || !mid)
-        return captionToDataField(dtColumn?.caption);
-    if (fromTID == tid)
-        return MIDtoColName(tid, mid);
-    return `${tid}_${mid}`;
-};
-/**
- * Generates unique column keys handling duplicates by adding incremental suffixes.
- * @param columns Array of DataColumnDescriptor
- * @param fromTID The TID to use for column name generation
- * @returns Array of unique column keys
- */
-export const generateUniqueColumnKeys = (columns, fromTID) => {
-    if (!columns)
-        return [];
-    const usedKeys = {};
-    const uniqueKeys = [];
-    for (let i = 0; i < columns.length; i++) {
-        let baseKey = getDataColumnName(fromTID, columns[i]);
-        let key = baseKey;
-        // If key already exists, add incremental suffix
-        if (usedKeys[baseKey] !== undefined) {
-            usedKeys[baseKey]++;
-            key = `${baseKey}_${usedKeys[baseKey]}`;
-        }
-        else {
-            usedKeys[baseKey] = 0;
-        }
-        uniqueKeys.push(key);
-    }
-    return uniqueKeys;
-};
-export const searchResultDescriptorToSimpleArray = (searchResult) => {
-    // Generate unique keys for all columns
-    const uniqueKeys = generateUniqueColumnKeys(searchResult?.dtdResult?.columns, searchResult?.fromTID);
-    let result = searchResult?.dtdResult?.rows?.map((row, index) => {
-        let item = { rowIndex: index };
-        for (let i = 0; i < row.length; i++) {
-            item[uniqueKeys[i]] = row[i];
-        }
-        return item;
-    });
-    return result;
-};
-export const getCompleteMetadataName = (dcmtTypeName, metadataName) => `${dcmtTypeName}...${metadataName}`;
-export const getQueryCountAsync = async (qd, showSpinner) => {
-    try {
-        if (showSpinner)
-            TMSpinner.show({ description: 'Conteggio in corso...' });
-        let count = await SDK_Globals.tmSession?.NewSearchEngine().GetDcmtCountByQdAsync(qd);
-        TMMessageBoxManager.show({ title: 'Info', message: `${SDKUI_Localizator.DcmtCount} = ${count?.toLocaleString()}`, buttons: [ButtonNames.OK] });
-    }
-    catch (e) {
-        TMExceptionBoxManager.show({ exception: e });
-    }
-    finally {
-        if (showSpinner)
-            TMSpinner.hide();
-    }
-};
-export function getTIDByMID(mid, defaultTid = 0) {
-    if (mid == undefined)
-        return defaultTid;
-    if (mid < 100)
-        return defaultTid;
-    let tid = Math.floor(mid / 1000);
-    if (tid == 0)
-        return defaultTid;
-    return tid;
-}
-export const getSystemMetadata = (withPerm) => {
-    let sysMDs = [];
-    let md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.id = SystemMIDsAsNumber.TID;
-    md.name = SystemMIDs.TID;
-    md.nameLoc = SystemMIDs.TID;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.id = SystemMIDsAsNumber.DID;
-    md.name = SystemMIDs.DID;
-    md.nameLoc = SystemMIDs.DID;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.dataDomain = MetadataDataDomains.UserID;
-    md.id = SystemMIDsAsNumber.OwnerID;
-    md.name = SystemMIDs.OwnerID;
-    md.nameLoc = SystemMIDs.OwnerID;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.dataDomain = MetadataDataDomains.UserID;
-    md.id = SystemMIDsAsNumber.UpdaterID;
-    md.name = SystemMIDs.UpdaterID;
-    md.nameLoc = SystemMIDs.UpdaterID;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.id = SystemMIDsAsNumber.FileCount;
-    md.name = SystemMIDs.FileCount;
-    md.nameLoc = SystemMIDs.FileCount;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Varchar;
-    md.length = 10;
-    md.isSystem = 1;
-    md.id = SystemMIDsAsNumber.FileExt;
-    md.name = SystemMIDs.FileExt;
-    md.nameLoc = SystemMIDs.FileExt;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.format = new MetadataFormatDescriptor();
-    md.format.format = MetadataFormats.NumberWithThousandsSeparator;
-    md.id = SystemMIDsAsNumber.FileSize;
-    md.name = SystemMIDs.FileSize;
-    md.nameLoc = SystemMIDs.FileSize;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.id = SystemMIDsAsNumber.PageCount;
-    md.name = SystemMIDs.PageCount;
-    md.nameLoc = SystemMIDs.PageCount;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.id = SystemMIDsAsNumber.IsSigned;
-    md.name = SystemMIDs.IsSigned;
-    md.nameLoc = SystemMIDs.IsSigned;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.id = SystemMIDsAsNumber.IsShared;
-    md.name = SystemMIDs.IsShared;
-    md.nameLoc = SystemMIDs.IsShared;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.id = SystemMIDsAsNumber.IsMail;
-    md.name = SystemMIDs.IsMail;
-    md.nameLoc = SystemMIDs.IsMail;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.Number;
-    md.length = 10;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.id = SystemMIDsAsNumber.IsLogDel;
-    md.name = SystemMIDs.IsLogDel;
-    md.nameLoc = SystemMIDs.IsLogDel;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.DateTime;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.format = new MetadataFormatDescriptor();
-    md.format.format = MetadataFormats.ShortDateLongTime;
-    md.id = SystemMIDsAsNumber.IsLex;
-    md.name = SystemMIDs.IsLex;
-    md.nameLoc = SystemMIDs.IsLex;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.DateTime;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.format = new MetadataFormatDescriptor();
-    md.format.format = MetadataFormats.ShortDateLongTime;
-    md.id = SystemMIDsAsNumber.IsLex;
-    md.name = SystemMIDs.IsLex;
-    md.nameLoc = SystemMIDs.IsLex;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.DateTime;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.format = new MetadataFormatDescriptor();
-    md.format.format = MetadataFormats.ShortDateLongTime;
-    md.id = SystemMIDsAsNumber.CreationTime;
-    md.name = SystemMIDs.CreationTime;
-    md.nameLoc = SystemMIDs.CreationTime;
-    sysMDs.push(md);
-    md = new MetadataDescriptor();
-    md.dataType = MetadataDataTypes.DateTime;
-    md.isRequired = 1;
-    md.isSystem = 1;
-    md.format = new MetadataFormatDescriptor();
-    md.format.format = MetadataFormats.ShortDateLongTime;
-    md.id = SystemMIDsAsNumber.LastUpdateTime;
-    md.name = SystemMIDs.LastUpdateTime;
-    md.nameLoc = SystemMIDs.LastUpdateTime;
-    sysMDs.push(md);
-    if (withPerm) {
-        sysMDs.forEach((md) => {
-            md.perm = new MetadataPermission();
-            md.perm.canArchive = AccessLevels.No;
-            md.perm.canView = AccessLevels.Yes;
-            md.perm.canSearch = AccessLevels.Yes;
-            md.perm.canUpdate = AccessLevels.No;
-        });
-    }
-    return sysMDs;
-};
-export function deepCompare(obj1, obj2) {
-    // If objects are not the same type, return false
-    if (typeof obj1 !== typeof obj2) {
-        return false;
-    }
-    // If objects are both null or undefined, return true
-    if (!obj1 && !obj2) {
-        return true;
-    }
-    // If objects are both primitive types, compare them directly
-    if (typeof obj1 !== 'object') {
-        return obj1 === obj2;
-    }
-    // If objects are arrays, compare their elements recursively
-    if (Array.isArray(obj1) && Array.isArray(obj2)) {
-        if (obj1.length !== obj2.length) {
-            return false;
-        }
-        for (let i = 0; i < obj1.length; i++) {
-            if (!deepCompare(obj1[i], obj2[i])) {
-                return false;
-            }
-        }
-        return true;
-    }
-    // If objects are both objects, compare their properties recursively
-    const keys1 = Object.keys(obj1);
-    const keys2 = Object.keys(obj2);
-    if (keys1.length !== keys2.length) {
-        return false;
-    }
-    for (let key of keys1) {
-        if (!obj2.hasOwnProperty(key) || !deepCompare(obj1[key], obj2[key])) {
-            return false;
-        }
-    }
-    return true;
-}
-export const extensionHandler = (fileExt) => {
-    if (!fileExt || fileExt.length === 0) {
-        return FileExtensionHandler.NONE;
-    }
-    switch (fileExt.toLowerCase()) {
-        case 'pdf.p7m':
-        case 'pdf.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'doc':
-        case 'doc.p7m':
-        case 'doc.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'docx':
-        case 'docx.p7m':
-        case 'docx.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'xls':
-        case 'xls.p7m':
-        case 'xls.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'xlsx':
-        case 'xlsx.p7m':
-        case 'xlsx.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'ppt':
-        case 'ppt.p7m':
-        case 'ppt.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'pptx':
-        case 'pptx.p7m':
-        case 'pptx.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'pptm':
-        case 'pptm.p7m':
-        case 'pptm.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'pps':
-        case 'pps.p7m':
-        case 'pps.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'ppsx':
-        case 'ppsx.p7m':
-        case 'ppsx.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'tif':
-        case 'tif.p7m':
-        case 'tif.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'tiff':
-        case 'tiff.p7m':
-        case 'tiff.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'eml':
-        case 'eml.p7m':
-        case 'eml.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'msg':
-        case 'msg.p7m':
-        case 'msg.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'htm.p7m':
-        case 'htm.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'html.p7m':
-        case 'html.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'txt.p7m':
-        case 'txt.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'csv': return FileExtensionHandler.CONVERTIBLE;
-        // case 'xml.p7m': case 'xml.p7m.ts': return FileExtensionHandler.CONVERTIBLE;
-        case 'jpg':
-        case 'jpeg':
-        case 'png':
-        case 'bmp':
-        case 'gif':
-        case 'svg': return FileExtensionHandler.READY_TO_SHOW;
-        case 'htm':
-        case 'html': return FileExtensionHandler.READY_TO_SHOW;
-        case 'mp4':
-        case 'webm': return FileExtensionHandler.READY_TO_SHOW;
-        case 'xml': return FileExtensionHandler.READY_TO_SHOW;
-        case 'xml.p7m':
-        case 'xml.p7m.ts':
-        case 'xml.p7m.tsd': return FileExtensionHandler.READY_TO_SHOW;
-        case 'pdf': return FileExtensionHandler.READY_TO_SHOW;
-        case 'txt': return FileExtensionHandler.READY_TO_SHOW;
-        case 'config':
-        case 'cfg':
-        case 'json': return FileExtensionHandler.READY_TO_SHOW;
-        default: return FileExtensionHandler.NONE;
-    }
-};
-export const downloadBase64File = (base64Data, fileName) => {
-    // Decodifica la stringa base64 in un Blob
-    const byteCharacters = atob(base64Data);
-    const byteNumbers = new Array(byteCharacters.length).fill(0).map((_, i) => byteCharacters.charCodeAt(i));
-    const byteArray = new Uint8Array(byteNumbers);
-    const blob = new Blob([byteArray], { type: 'application/octet-stream' });
-    // Crea un URL per il Blob
-    const blobUrl = URL.createObjectURL(blob);
-    // Crea un link di download
-    const link = document.createElement('a');
-    link.href = blobUrl;
-    link.download = fileName;
-    // Simula un click sul link
-    document.body.appendChild(link);
-    link.click();
-    // Rimuovi il link dal DOM
-    document.body.removeChild(link);
-    // Libera l'URL del Blob
-    URL.revokeObjectURL(blobUrl);
-};
-export const TASK_MORE_INFO_PREFIX_NAME = `${SDKUI_Localizator.MoreInformation} - `;
-export const isTaskMoreInfo = (taskName) => taskName?.startsWith(TASK_MORE_INFO_PREFIX_NAME);
-//#region Form, Page Helpers
-export const canNext = (visibleItems, selectedItems) => {
-    if (!visibleItems)
-        return false;
-    if (visibleItems.length == 1)
-        return false;
-    if (!selectedItems)
-        return false;
-    if (selectedItems.length != 1)
-        return false;
-    return visibleItems.indexOf(selectedItems[0]) < visibleItems.length - 1;
-};
-export const getNext = (visibleItems, selectedItems) => {
-    if (!visibleItems)
-        return;
-    if (!selectedItems[0])
-        return;
-    if (selectedItems.length != 1)
-        return;
-    let index = visibleItems.findIndex(o => o.id == selectedItems[0].id);
-    return visibleItems[index + 1];
-};
-export const canPrev = (visibleItems, selectedItems) => {
-    if (!visibleItems)
-        return false;
-    if (visibleItems.length == 1)
-        return false;
-    if (!selectedItems)
-        return false;
-    if (selectedItems.length != 1)
-        return false;
-    return visibleItems.indexOf(selectedItems[0]) > 0;
-};
-export const getPrev = (visibleItems, selectedItems) => {
-    if (!visibleItems)
-        return;
-    if (!selectedItems[0])
-        return;
-    if (selectedItems.length != 1)
-        return;
-    let index = visibleItems.findIndex(o => o.id == selectedItems[0].id);
-    return visibleItems[index - 1];
-};
-export const calcSaveFormTitle = (rootTitle, formMode, updateId, pathKeys) => {
-    let title = rootTitle ?? "";
-    if (formMode == FormModes.Update && updateId)
-        title += ` (${updateId})`;
-    title += " - ";
-    switch (formMode) {
-        case FormModes.Create:
-            title += SDKUI_Localizator.Create;
-            break;
-        case FormModes.Update:
-            title += SDKUI_Localizator.Update;
-            break;
-        case FormModes.Duplicate:
-            title += SDKUI_Localizator.Duplicate;
-            break;
-    }
-    if (!pathKeys || pathKeys.length <= 0)
-        return title;
-    return title + " > " + pathKeys.join(" > ");
-};
-export function calcIsModified(formData, formDataOrig) {
-    if (!formData && !formDataOrig)
-        return false;
-    let isMailSender = formData?.mailFormat !== undefined &&
-        formDataOrig?.mailFormat !== undefined;
-    if (isMailSender)
-        return !DeepCompareHelper.deepCompareUnorderedNormalized(formData, formDataOrig);
-    return JSON.stringify(formData) !== JSON.stringify(formDataOrig);
-}
-//#endregion
-export { openApps, calcResponsiveDirection, calcResponsiveSizes, getColor, genUniqueId, makeID, MOBILE_WIDTH, TABLET_WIDTH };
-export function moduleVersion(module) {
-    switch (module) {
-        case moduleTypes.SDK: return SDK_Globals.sdkVersion ?? '0.0.0';
-        case moduleTypes.SDKUI: return SDK_Globals.sdkuiVersion ?? '0.0.0';
-        case moduleTypes.WEBSDK: return SDK_Globals.websdkVersion ?? '0.0.0';
-        default: return SDK_Globals.appVersion ?? '0.0.0';
-    }
-}
-export function buildtype(module) {
-    let versionApp = moduleVersion(moduleTypes.APP);
-    let version = moduleVersion(module);
-    let nameSDK = SDK_Globals.sdkName ?? "";
-    let buildType;
-    if (nameSDK.endsWith('-beta') && version.endsWith('.0'))
-        buildType = buildTypes.TEST;
-    else if (nameSDK.endsWith('-beta') && versionApp.endsWith('.0'))
-        buildType = buildTypes.TEST;
-    else if (nameSDK.endsWith('-beta'))
-        buildType = buildTypes.DEV;
-    else if (version.endsWith('.0'))
-        buildType = buildTypes.RTM;
-    else
-        buildType = buildTypes.PATCH;
-    return buildType;
-}
-export const highlightText = (text, searchValue) => {
-    if (!text.trim() || !searchValue.trim())
-        return _jsxs(_Fragment, { children: [text, " "] });
-    const foundStrings = searchValue.match(/[^\s]+/g) || [];
-    const escapedStrings = foundStrings
-        .map((str) => str.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&')) // NOSONAR
-        .filter(Boolean);
-    if (escapedStrings.length === 0)
-        return _jsxs(_Fragment, { children: [text, " "] });
-    const regex = new RegExp(`(${escapedStrings.join('|')})`, 'gi');
-    const parts = [];
-    let lastIndex = 0;
-    for (const match of text.matchAll(regex)) {
-        const matchStart = match.index;
-        const matchEnd = matchStart + match[0].length;
-        if (lastIndex < matchStart) {
-            parts.push(text.substring(lastIndex, matchStart));
-        }
-        parts.push(_jsx("span", { style: { backgroundColor: "yellow", borderRadius: '2px' }, children: match[0] }, matchStart));
-        lastIndex = matchEnd;
-    }
-    if (lastIndex < text.length) {
-        parts.push(text.substring(lastIndex));
-    }
-    return _jsxs(_Fragment, { children: [parts, " "] });
-};
-export const renderHighlightedText = (text, searchText, isSelected) => {
-    if (!searchText)
-        return text;
-    const escapedSearchText = searchText.trim().replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const regex = new RegExp(`(${escapedSearchText})`, 'gi');
-    return text.split(regex).map((part, index) => regex.test(part) ? (_jsx("span", { style: { backgroundColor: isSelected ? '#6c9023' : 'yellow' }, children: part }, index)) : (part));
-};
-export function versionAndBuildtypeInfo(module) {
-    return moduleVersion(module);
-}
-export const getListMaxItems = (deviceType) => { return deviceType === DeviceType.MOBILE ? 8 : 12; };
-export const svgToString = (icon) => {
-    return ReactDOMServer.renderToString(icon);
-};
-export function stringIsNullOrEmpty(value) {
-    if (value == undefined)
-        return true;
-    if (value == null)
-        return true;
-    if (value == "")
-        return true;
-    return false;
-}
-export function isPositiveNumber(val) {
-    // unknown is used to maximize type safety and reusability for type guard functions.
-    return typeof val === 'number' && val > 0;
-}
-export async function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-// #region Dialog
-export const dialogConfirmOperation = (title, msg, operationAsync) => {
-    TMMessageBoxManager.show({
-        title: title, message: msg, buttons: [ButtonNames.YES, ButtonNames.NO],
-        onButtonClick: async (e) => {
-            if (e !== ButtonNames.YES)
-                return;
-            await operationAsync();
-        }
-    });
-};
-export var LandingPages;
-(function (LandingPages) {
-    LandingPages["DASHBOARD"] = "dashboard";
-    LandingPages["SEARCH"] = "search";
-    LandingPages["ARCHIVE"] = "archive";
-    LandingPages["WORKING_GROUPS"] = "workingGroups";
-    LandingPages["WORKFLOW_APPR"] = "workflowAppr";
-    LandingPages["DOSSIERS"] = "dossiers";
-    LandingPages["FAVORITES"] = "favorites";
-    LandingPages["RECENT"] = "recent";
-    LandingPages["AREA_MANAGER"] = "areaManager";
-    LandingPages["NOTIFICATIONS"] = "notifications";
-    LandingPages["ACTIVITIES"] = "activities";
-})(LandingPages || (LandingPages = {}));
-// #endregion
-// #region Exception
-export function getExceptionMessage(ex) {
-    let msg = ex.isApiException ? ex.response.title : ex.message;
-    return msg ?? ex.toString();
-}
-export function getContrastColor(inputColor) {
-    let hex = inputColor;
-    if (!/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(inputColor)) {
-        const temp = document.createElement('div');
-        temp.style.color = inputColor;
-        document.body.appendChild(temp);
-        const rgb = getComputedStyle(temp).color;
-        document.body.removeChild(temp);
-        const regex = /^rgb\((\d+),\s*(\d+),\s*(\d+)\)$/;
-        const match = regex.exec(rgb);
-        if (match) {
-            const r = parseInt(match[1]).toString(16).padStart(2, '0');
-            const g = parseInt(match[2]).toString(16).padStart(2, '0');
-            const b = parseInt(match[3]).toString(16).padStart(2, '0');
-            hex = `#${r}${g}${b}`;
-        }
-        else {
-            hex = '#000000';
-        }
-    }
-    const color = hex.replace('#', '');
-    const r = parseInt(color.substring(0, 2), 16);
-    const g = parseInt(color.substring(2, 4), 16);
-    const b = parseInt(color.substring(4, 6), 16);
-    const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
-    if (inputColor === 'transparent' || inputColor === 'rgba(255, 255, 255, 0)' || inputColor === 'none' || inputColor === 'white' || inputColor === '#ffffff' || inputColor === '#fff') {
-        return {
-            bgColor: '#aeaeae',
-            textColor: '#2559A5'
-        };
-    }
-    return {
-        bgColor: hex,
-        textColor: luminance > 0.6 ? '#2559A5' : '#FFFFFF'
-    };
-}
-// #endregion
-/** Adds TID to a list of "most recently used" (MRU) TIDs, keeping a maximum of 10 elements  */
-export function updateMruTids(currentMruTIDs, newTid) {
-    // 1. Make sure newTid is a valid number.
-    // Using unknown forces validation. 
-    // This is a best practice for robust functions that need to handle potentially non-compliant input.
-    const tidAsNumber = Number(newTid);
-    if (isNaN(tidAsNumber)) {
-        console.warn(`Tentativo di aggiungere un TID non numerico: ${newTid}. Ignorato.`);
-        return currentMruTIDs ? currentMruTIDs.filter(tid => tid != null) : [];
-    }
-    // 2. Initialize or copy existing MRU list.
-    let updatedMruTIDs = currentMruTIDs ? currentMruTIDs.filter(tid => tid != null) : [];
-    // 3. Remove the TID if it already exists to avoid duplicates and update its position.
-    const existingIndex = updatedMruTIDs.findIndex((o) => o === tidAsNumber);
-    if (existingIndex >= 0) {
-        updatedMruTIDs.splice(existingIndex, 1);
-    }
-    // 4. Remove oldest element if list exceeds maximum size of 10.
-    if (updatedMruTIDs.length >= 10) {
-        updatedMruTIDs.splice(0, 1); // Rimuove il primo elemento (il più vecchio)
-    }
-    // 5. Add new TID to queue (most recent).
-    updatedMruTIDs.push(tidAsNumber);
-    return updatedMruTIDs;
-}
-/** Remove TID to a list of "most recently used" (MRU) TIDs, keeping a maximum of 10 elements  */
-export function removeMruTid(currentMruTIDs, tidToRemove) {
-    // 1. Make sure tidToRemove is a valid number.
-    const tidAsNumber = Number(tidToRemove);
-    if (isNaN(tidAsNumber)) {
-        console.warn(`Tentativo di rimuovere un TID non numerico: ${tidToRemove}. Ignorato.`);
-        return currentMruTIDs ? currentMruTIDs.filter(tid => tid != null) : [];
-    }
-    // 2. Initialize or copy existing MRU list.
-    let updatedMruTIDs = currentMruTIDs ? currentMruTIDs.filter(tid => tid != null) : [];
-    // 3. Find the TID index to remove.
-    const indexToRemove = updatedMruTIDs.findIndex((o) => o === tidAsNumber);
-    // 4. If the TID is found, remove it from the list.
-    if (indexToRemove >= 0) {
-        updatedMruTIDs.splice(indexToRemove, 1);
-    }
-    return updatedMruTIDs;
-}
-export class AreaValues {
-    constructor() {
-        this.aid = 0;
-        this.subFolder = "";
-        this.fileName = "";
-    }
-}
-export class AreaHelper {
-    static IsAreaPath(areaPath) {
-        if (stringIsNullOrEmpty(areaPath))
-            return false;
-        return areaPath.toLowerCase().startsWith((AreaHelper.AreaPathPrefix + AreaHelper.AreaFolderNamePrefix).toLowerCase());
-    }
-    // Overloading con diverso numero di paramentri non è supportato (ma solo con diverso tipo)
-    // public static void ExtractAreaInfo(string areaPath, out int aid, out string subFolder)
-    static ExtractAreaInfo_1(areaPath) {
-        let fileName;
-        return AreaHelper.ExtractAreaInfo_2(areaPath, false);
-    }
-    // public static void ExtractAreaInfo(string areaPath, out int aid, out string subFolder, ref string? fileName)
-    static ExtractAreaInfo_2(areaPath, extractFileName) {
-        let areaValues = new AreaValues();
-        areaValues.aid = 0;
-        areaValues.subFolder = "";
-        if (!AreaHelper.IsAreaPath(areaPath))
-            return areaValues;
-        areaPath = areaPath.replace(areaPath.substring(0, AreaHelper.AreaPathPrefix.length + AreaHelper.AreaFolderNamePrefix.length), "");
-        // areaPath = 5002\BarcodeArchiver\71232\00001.tiff
-        let pathTokens = areaPath.split('\\');
-        let id = pathTokens[0];
-        if (isNaN(parseInt(id)))
-            return areaValues;
-        areaValues.aid = parseInt(id);
-        let subFolders = "";
-        let lastFolderIndex = extractFileName ? pathTokens.length - 2 : pathTokens.length - 1;
-        let fileNameIndex = lastFolderIndex + 1;
-        for (let i = 1; i <= lastFolderIndex; i++) {
-            let s = pathTokens[i].trim();
-            if (stringIsNullOrEmpty(s))
-                continue;
-            subFolders += s + "\\";
-        }
-        if (subFolders.endsWith("\\"))
-            subFolders = subFolders.substring(0, subFolders.length - 1);
-        areaValues.fileName = (extractFileName && fileNameIndex > 0 && fileNameIndex < pathTokens.length) ? pathTokens[fileNameIndex].trim() : "";
-        if (subFolders.length == 0)
-            return areaValues;
-        areaValues.subFolder = subFolders;
-        return areaValues;
-    }
-}
-AreaHelper.AreaPathPrefix = "tmarea:\\\\";
-AreaHelper.AreaFolderNamePrefix = "AID_";