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

package/lib/helper/helpers.js

@@ -0,0 +1,858 @@
+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) {
+    switch (module) {
+        case moduleTypes.SDK:
+        case moduleTypes.SDKUI:
+            return moduleVersion(module).replace("-hotfix", "+hotfix");
+        default:
+            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_";