@topconsultnpm/sdkui-react 6.19.0-dev1.10

package/lib/helper/TMUtils.js

@@ -0,0 +1,176 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import styled from "styled-components";
+import { TMTooltip } from '../components';
+import { IconKey } from './TMIcons';
+import { DataListCacheService, MetadataDataDomains } from '@topconsultnpm/sdk-ts';
+import { SDKUI_Localizator } from './SDKUI_Localizator';
+const StyledIconFileContainer = styled.div ` 
+    height: 22px;
+    width: 18px;
+    border-radius: 5px;
+    background-color: #d2dae2;
+    position: relative;
+`;
+const StyledIconFileExt = styled.div ` 
+    top: 25%;
+    width: 30px;
+    left: -6px;
+    border-radius: 5px;
+    background-color: ${props => props.$backgroundColor};
+    color: ${props => props.$color};
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 0.7rem;
+    position: absolute;
+    height: 12px;
+`;
+export const getFileIcon = (fileExtension, fileCount, tooltipContent) => {
+    if (!fileExtension)
+        fileExtension = "";
+    if (fileExtension.startsWith("."))
+        fileExtension = fileExtension.substring(1).toUpperCase();
+    let fileExtOri = fileExtension;
+    fileExtension = fileExtension.replace(".P7M", "").replace(".M7M", "").replace(".TSR", "").replace(".TSD", "").replace(".TS", "");
+    let fileBgColor;
+    let fileColor = "#FFFFFF";
+    switch (fileExtension) {
+        case "PDF":
+            fileBgColor = '#F15642';
+            break;
+        case "XLS":
+        case "XLSX":
+        case "CSV":
+            fileBgColor = '#1d6f42';
+            break;
+        case "PEC":
+            fileBgColor = '#F15642';
+            break;
+        case "MSG":
+        case "EML":
+        case "RTF":
+        case "DOC":
+        case "DOTX":
+        case "DOCX":
+            fileBgColor = '#205ccc';
+            break;
+        case 'PPT':
+        case 'PPTX':
+            fileBgColor = '#c45a1c';
+            break;
+        case 'PNG':
+        case 'JPG':
+        case 'JPEG':
+        case 'SVG':
+        case 'TIFF':
+        case 'TIF':
+        case 'ICO':
+        case 'GIF':
+        case 'DWG':
+        case 'DCM':
+        case 'SLDDRW':
+        case 'WEBP':
+            fileBgColor = '#A066AA';
+            break;
+        case 'HTM':
+        case 'HTML':
+        case 'TXT':
+        case 'XML':
+            fileBgColor = '#576D7E';
+            break;
+        default:
+            fileBgColor = '#576D7E';
+            break;
+    }
+    return (_jsx(StyledIconFileContainer, { children: _jsx(StyledIconFileExt, { "$backgroundColor": (fileCount === 0 || !fileExtension) ? "#424040" : fileBgColor, "$color": fileColor, children: (fileCount === 0 || !fileExtOri)
+                ? _jsxs(TMTooltip, { content: SDKUI_Localizator.MetadataOnlyDocument, children: [" ", _jsx(IconKey, { fontSize: 17, color: '#f8d775' }), " "] })
+                : _jsx(TMTooltip, { content: tooltipContent ?? fileExtOri, children: fileExtension.toUpperCase() }) }) }));
+};
+export function formatBytes(bytes, decimalPlaces = 2) {
+    if (!bytes)
+        return '0 B';
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    const value = parseFloat((bytes / Math.pow(k, i)).toFixed(decimalPlaces));
+    return `${value} ${units[i]}`;
+}
+// Function to associate columns to rows and return an array of RowData objects
+export const associateColumnsToRows = (columns, rows) => {
+    if (columns === undefined || rows === undefined)
+        return [];
+    // Map over each row and associate each value with the corresponding column's caption
+    return rows.map(row => {
+        // Create an empty object to hold the key-value pairs for each row
+        const rowObject = {};
+        // Loop through each cell in the row and map its value to the corresponding column's caption
+        row.forEach((value, index) => {
+            const column = columns[index]; // Get the column corresponding to the current index
+            // If a column exists at this index, add the value to the rowObject with the column's caption as the key
+            if (column && column.caption) {
+                rowObject[column.caption] = value;
+            }
+        });
+        // Return the populated rowObject, which represents the row with columns as keys
+        return rowObject;
+    });
+};
+export const buildValueToLabelMapFromDataColumns = async (columns) => {
+    const valueToNameMap = new Map();
+    const captions = new Set();
+    for (const col of columns) {
+        const dataDomain = MetadataDataDomains[(col.extendedProperties?.["DataDomain"] ?? "None")];
+        const dataListID = Number(col.extendedProperties?.["DataListID"]);
+        if (dataDomain === MetadataDataDomains.DataList) {
+            if (col.caption) {
+                captions.add(col.caption);
+            }
+            const dl = await DataListCacheService.GetAsync(dataListID);
+            dl?.items?.forEach((item) => {
+                if (item?.name !== undefined && item?.value !== undefined) {
+                    valueToNameMap.set(item.value, item.name);
+                }
+            });
+        }
+    }
+    return { valueToNameMap, captions };
+};
+export const getAvatarColor = (name) => {
+    const colors = [
+        '#6264A7', '#8C6BAD', '#C239B3', '#E33B9A', '#F2707C',
+        '#FF8C00', '#CA5010', '#8E562E', '#498205', '#107C10',
+        '#0078D4', '#038387', '#8764B8', '#881798', '#C50E20'
+    ];
+    const hash = name.split('').reduce((acc, char) => char.charCodeAt(0) + acc, 0);
+    return colors[hash % colors.length];
+};
+export const extractInitialsFromName = (name) => {
+    if (!name)
+        return '';
+    const lettersOnly = name.replace(/[^a-zA-Z]/g, '');
+    if (lettersOnly.length === 0) {
+        return name[0]?.toUpperCase() || '';
+    }
+    if (lettersOnly.toLowerCase() === 'sysadmin') {
+        return 'SYS';
+    }
+    return lettersOnly.substring(0, 2).toUpperCase();
+};
+export const SIGN4_TOP_WIDGET_ID = "60003";
+export const CREATE_CERTIFICATE_WIDGET_ID = "60003_1";
+export const PDF_EDITOR_ID = "60007";
+export const isWidgetEnabled = (widgetId, widgetsString) => {
+    const widgets = widgetsString.split(";").filter(Boolean);
+    return widgets.includes(widgetId);
+};
+export const isSign4TopEnabled = (widgetsString) => {
+    return isWidgetEnabled(SIGN4_TOP_WIDGET_ID, widgetsString);
+};
+export const isCreateCertificateEnabled = (widgetsString) => {
+    return isWidgetEnabled(CREATE_CERTIFICATE_WIDGET_ID, widgetsString);
+};
+export const isPdfEditorEnabled = (widgetsString) => {
+    return isWidgetEnabled(PDF_EDITOR_ID, widgetsString);
+};

package/lib/helper/dcmtsHelper.d.ts

@@ -0,0 +1,5 @@
+/** Check if dcmtType (mTID) has configured Detail or Many-to-Many relations */
+export declare const hasDetailRelations: (mTID: number | undefined) => Promise<boolean>;
+/** Check if dcmtType (mTID) has configured Master or Many-to-Many relations */
+export declare const hasMasterRelations: (mTID: number | undefined) => Promise<boolean>;
+export declare const isXMLFileExt: (fileExt: string | undefined) => boolean;

package/lib/helper/dcmtsHelper.js

@@ -0,0 +1,25 @@
+import { RelationCacheService, RelationTypes } from "@topconsultnpm/sdk-ts";
+/** Check if dcmtType (mTID) has configured Detail or Many-to-Many relations */
+export const hasDetailRelations = async (mTID) => {
+    let allRelations = await RelationCacheService.GetAllAsync();
+    let rdlOneToMany = allRelations?.filter(o => o.masterTID == mTID && o.relationType == RelationTypes.OneToMany) ?? [];
+    let rdlManyToMany = allRelations?.filter(o => o.relationType == RelationTypes.ManyToMany && (o.masterTID == mTID || o.detailTID == mTID)) ?? [];
+    return rdlManyToMany.length > 0 || rdlOneToMany.length > 0;
+};
+/** Check if dcmtType (mTID) has configured Master or Many-to-Many relations */
+export const hasMasterRelations = async (mTID) => {
+    let allRelations = await RelationCacheService.GetAllAsync();
+    let rdlOneToMany = allRelations?.filter(o => o.detailTID == mTID && o.relationType == RelationTypes.OneToMany) ?? [];
+    let rdlManyToMany = allRelations?.filter(o => o.relationType == RelationTypes.ManyToMany && (o.masterTID == mTID || o.detailTID == mTID)) ?? [];
+    return rdlManyToMany.length > 0 || rdlOneToMany.length > 0;
+};
+export const isXMLFileExt = (fileExt) => {
+    const fileExtension = fileExt?.toLowerCase() ?? '';
+    switch (fileExtension) {
+        case 'xml':
+        case 'xml.p7m':
+        case 'xml.p7m.ts':
+        case 'xml.p7m.tsd': return true;
+        default: return false;
+    }
+};

package/lib/helper/helpers.d.ts

@@ -0,0 +1,84 @@
+import { Colors as ColorsType } from "../components/base/TMEditorBase";
+import { DeviceType } from "../components";
+import { AppModules, DataColumnDescriptor, ITopMediaSession, MetadataDescriptor, QueryDescriptor, SearchResultDescriptor } from "@topconsultnpm/sdk-ts";
+import { FileExtensionHandler, FormModes, moduleTypes } from "../ts";
+declare const TABLET_WIDTH = 1024;
+declare const MOBILE_WIDTH = 640;
+declare const calcResponsiveDirection: (deviceType: DeviceType, desktopDir: "horizontal" | "vertical", tabletDir: "horizontal" | "vertical", mobileDir: "horizontal" | "vertical") => "horizontal" | "vertical";
+declare const openApps: (appModule: AppModules, tmSession: ITopMediaSession, appRoutes?: any[]) => Promise<void>;
+export declare const setSDK_GlobalsInfoAsync: (tms: ITopMediaSession | undefined) => Promise<ITopMediaSession>;
+declare const calcResponsiveSizes: (deviceType: DeviceType | undefined, desktopSize: string, tabletSize: string, mobileSize: string) => string;
+declare const getColor: (color: ColorsType) => string;
+/**
+ * Genera un Universally Unique Identifier (UUID) versione 4.
+ * Simile a Guid.NewGuid() in C#.
+ * @returns {string} Un UUID in formato stringa.
+ */
+export declare const generateUUID: () => string;
+declare const makeID: (length: number) => string;
+export declare const truncateText: (text: string, maxLength: number) => string;
+declare function genUniqueId(): string;
+export declare const captionToDataField: (caption: string | undefined) => string;
+export declare const getDataColumnName: (fromTID: number | undefined, dtColumn: DataColumnDescriptor | undefined) => string;
+export declare const searchResultDescriptorToSimpleArray: (searchResult: SearchResultDescriptor | undefined) => any[] | undefined;
+export declare const getCompleteMetadataName: (dcmtTypeName: string | undefined, metadataName: string | undefined) => string;
+export declare const getQueryCountAsync: (qd: QueryDescriptor, showSpinner: boolean) => Promise<void>;
+export declare function getTIDByMID(mid: number | undefined, defaultTid?: number): number;
+export declare const getSystemMetadata: (withPerm?: boolean) => MetadataDescriptor[];
+export declare function deepCompare(obj1: any, obj2: any): boolean;
+export declare const extensionHandler: (fileExt: string | undefined) => FileExtensionHandler;
+export declare const downloadBase64File: (base64Data: string, fileName: string) => void;
+export declare const TASK_MORE_INFO_PREFIX_NAME: string;
+export declare const isTaskMoreInfo: (taskName: string | undefined) => boolean | undefined;
+export declare const canNext: (visibleItems: any[], selectedItems: any[]) => boolean;
+export declare const getNext: (visibleItems: any[], selectedItems: any[]) => any;
+export declare const canPrev: (visibleItems: any[], selectedItems: any[]) => boolean;
+export declare const getPrev: (visibleItems: any[], selectedItems: any[]) => any;
+export declare const calcSaveFormTitle: (rootTitle: string | undefined, formMode: FormModes, updateId: number | undefined, pathKeys: string[] | undefined) => string;
+export declare function calcIsModified(formData: any, formDataOrig: any): boolean;
+export { openApps, calcResponsiveDirection, calcResponsiveSizes, getColor, genUniqueId, makeID, MOBILE_WIDTH, TABLET_WIDTH };
+export declare function moduleVersion(module: moduleTypes): string;
+export declare function buildtype(module: moduleTypes): string;
+export declare const highlightText: (text: string, searchValue: string) => JSX.Element;
+export declare const renderHighlightedText: (text: string, searchText: string, isSelected: boolean) => string | (string | import("react/jsx-runtime").JSX.Element)[];
+export declare function versionAndBuildtypeInfo(module: moduleTypes): string;
+export declare const getListMaxItems: (deviceType: DeviceType | undefined) => number;
+export declare const svgToString: (icon: React.ReactElement) => string;
+export declare function stringIsNullOrEmpty(value: string | undefined): boolean;
+export declare function isPositiveNumber(val: unknown): val is number;
+export declare function sleep(ms: number): Promise<void>;
+export declare const dialogConfirmOperation: (title: string, msg: string, operationAsync: () => Promise<void>) => void;
+export declare enum LandingPages {
+    DASHBOARD = "dashboard",
+    SEARCH = "search",
+    ARCHIVE = "archive",
+    WORKING_GROUPS = "workingGroups",
+    WORKFLOW_APPR = "workflowAppr",
+    DOSSIERS = "dossiers",
+    FAVORITES = "favorites",
+    RECENT = "recent",
+    AREA_MANAGER = "areaManager",
+    NOTIFICATIONS = "notifications",
+    ACTIVITIES = "activities"
+}
+export declare function getExceptionMessage(ex: any): string;
+export declare function getContrastColor(inputColor: string): {
+    bgColor: string;
+    textColor: string;
+};
+/** Adds TID to a list of "most recently used" (MRU) TIDs, keeping a maximum of 10 elements  */
+export declare function updateMruTids(currentMruTIDs: number[] | undefined | null, newTid: unknown): number[];
+/** Remove TID to a list of "most recently used" (MRU) TIDs, keeping a maximum of 10 elements  */
+export declare function removeMruTid(currentMruTIDs: number[] | undefined | null, tidToRemove: unknown): number[];
+export declare class AreaValues {
+    aid: number;
+    subFolder: string;
+    fileName: string;
+}
+export declare class AreaHelper {
+    static readonly AreaPathPrefix: string;
+    static readonly AreaFolderNamePrefix: string;
+    static IsAreaPath(areaPath: string | undefined): boolean;
+    static ExtractAreaInfo_1(areaPath: string): AreaValues;
+    static ExtractAreaInfo_2(areaPath: string, extractFileName: boolean): AreaValues;
+}