@sme.up/ketchup 4.3.0-SNAPSHOT → 5.1.0-SNAPSHOT

package/dist/collection/{utils → managers}/kup-debug/kup-debug.js

@@ -10,7 +10,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
   return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _KupDebug_debugWidget;
-import { KupCardFamily } from '../../components/kup-card/kup-card-declarations';
+import { KupCardFamily, } from '../../components/kup-card/kup-card-declarations';
 import { KupLanguageDebug } from '../kup-language/kup-language-declarations';
 import { KupDebugCategory, KupDebugLogColor, } from './kup-debug-declarations';
 const dom = document.documentElement;
@@ -221,12 +221,83 @@ export class KupDebug {
     debugWidget.id = 'kup-debug-widget';
     debugWidget.layoutFamily = KupCardFamily.DIALOG;
     debugWidget.layoutNumber = 3;
-    debugWidget.sizeX = 'auto';
+    debugWidget.sizeX = 'max-content';
     debugWidget.sizeY = 'auto';
-    debugWidget.addEventListener('kup-card-event', (e) => this.handleEvents(e));
+    const handler = this.handleEvents;
+    debugWidget.addEventListener('kup-card-event', (e) => handler(e, this));
     this.container.append(debugWidget);
     __classPrivateFieldSet(this, _KupDebug_debugWidget, debugWidget, "f");
   }
+  /**
+   * Listens the card events and handles the related actions.
+   * @param {CustomEvent<KupCardEventPayload>} e - kup-card-event.
+   * @param {KupDebug} kupDebug - Instance of the KupDebug class.
+   */
+  handleEvents(e, kupDebug) {
+    const compEvent = e.detail.event;
+    const compID = compEvent.detail.id;
+    switch (compEvent.type) {
+      case 'kup-button-click':
+        switch (compID) {
+          case 'kup-debug-autoprint':
+            kupDebug.autoPrint = !kupDebug.autoPrint;
+            break;
+          case 'kup-debug-clear':
+            kupDebug.widgetClear();
+            __classPrivateFieldGet(kupDebug, _KupDebug_debugWidget, "f").refresh();
+            break;
+          case 'kup-debug-dl-props':
+            kupDebug.getProps().then((res) => {
+              kupDebug.downloadProps(res);
+            });
+            break;
+          case 'kup-debug-dl-all':
+            kupDebug.getProps(true).then((res) => {
+              kupDebug.downloadProps(res);
+            });
+            break;
+          case 'kup-debug-delete':
+            kupDebug.dump();
+            break;
+          case 'kup-debug-magic-box':
+            dom.ketchup.toggleMagicBox();
+            break;
+          case 'kup-debug-off':
+            kupDebug.toggle();
+            break;
+          case 'kup-debug-print':
+            kupDebug.widgetClear();
+            kupDebug.widgetPrint();
+            __classPrivateFieldGet(kupDebug, _KupDebug_debugWidget, "f").refresh();
+            break;
+        }
+        break;
+      case 'kup-combobox-itemclick':
+        switch (compID) {
+          case 'kup-debug-language-changer':
+            dom.ketchup.language.set(compEvent.detail.value);
+            break;
+          case 'kup-debug-locale-changer':
+            dom.ketchup.dates.setLocale(compEvent.detail.value);
+            break;
+          case 'kup-debug-theme-changer':
+            dom.ketchup.theme.set(compEvent.detail.value);
+            break;
+        }
+      case 'kup-textfield-input':
+        switch (compID) {
+          case 'kup-debug-log-limit':
+            if (compEvent.detail.value === '' ||
+              compEvent.detail.value < 1) {
+              kupDebug.logLimit = 1;
+            }
+            else {
+              kupDebug.logLimit = compEvent.detail.value;
+            }
+            break;
+        }
+    }
+  }
   /**
    * Closes the debug widget.
    */
@@ -330,7 +401,7 @@ export class KupDebug {
         printLog[type] = [];
       }
       printLog[type].push({
-        date: this.formatDate(this.logs[index].date),
+        date: dom.ketchup.dates.format(this.logs[index].date, 'LLL:ms'),
         element: isComponent
           ? this.logs[index].element
           : this.logs[index].id,
@@ -388,78 +459,8 @@ export class KupDebug {
       }
     }
   }
-  /**
-   * Listens the card events and handles the related actions.
-   * @param {CustomEvent} e - kup-card-event.
-   */
-  handleEvents(e) {
-    const compEvent = e.detail.event;
-    const compID = compEvent.detail.id;
-    switch (compEvent.type) {
-      case 'kup-button-click':
-        switch (compID) {
-          case 'kup-debug-autoprint':
-            this.autoPrint = !this.autoPrint;
-            break;
-          case 'kup-debug-clear':
-            this.widgetClear();
-            __classPrivateFieldGet(this, _KupDebug_debugWidget, "f").refresh();
-            break;
-          case 'kup-debug-dl-props':
-            this.getProps().then((res) => {
-              this.downloadProps(res);
-            });
-            break;
-          case 'kup-debug-dl-all':
-            this.getProps(true).then((res) => {
-              this.downloadProps(res);
-            });
-            break;
-          case 'kup-debug-delete':
-            this.dump();
-            break;
-          case 'kup-debug-magic-box':
-            dom.ketchup.toggleMagicBox();
-            break;
-          case 'kup-debug-off':
-            this.toggle();
-            break;
-          case 'kup-debug-print':
-            this.widgetClear();
-            this.widgetPrint();
-            __classPrivateFieldGet(this, _KupDebug_debugWidget, "f").refresh();
-            break;
-        }
-        break;
-      case 'kup-combobox-itemclick':
-        switch (compID) {
-          case 'kup-debug-language-changer':
-            dom.ketchup.language.set(compEvent.detail.value);
-            break;
-          case 'kup-debug-locale-changer':
-            dom.ketchup.dates.setLocale(compEvent.detail.value);
-            break;
-          case 'kup-debug-theme-changer':
-            dom.ketchup.theme.set(compEvent.detail.value);
-            break;
-        }
-      case 'kup-textfield-input':
-        switch (compID) {
-          case 'kup-debug-log-limit':
-            if (compEvent.detail.value === '' ||
-              compEvent.detail.value < 1) {
-              this.logLimit = 1;
-            }
-            else {
-              this.logLimit = compEvent.detail.value;
-            }
-            break;
-        }
-    }
-  }
   /**
    * Function used to check whether the debug is active or not.
-   * If kupDebug on documentElement's type is not a boolean, it will be set to false.
    * @returns {boolean} Status of the debug.
    */
   isDebug() {
@@ -580,7 +581,7 @@ export class KupDebug {
         message: message,
       };
       if (this.logs.length > this.logLimit) {
-        console.warn(this.formatDate(date) +
+        console.warn(dom.ketchup.dates.format(date, 'LLL:ms') +
           ' kup-debug => ' +
           'Too many logs (> ' +
           this.logLimit +
@@ -596,63 +597,17 @@ export class KupDebug {
     }
     switch (category) {
       case KupDebugCategory.ERROR:
-        console.error(this.formatDate(date) + id + message, obj);
-        window.dispatchEvent(new CustomEvent('kupError', {
+        console.error(dom.ketchup.dates.format(date, 'LLL:ms') + id + message, obj);
+        window.dispatchEvent(new CustomEvent('kup-debug-error', {
           bubbles: true,
           detail: { comp, date, message },
         }));
         break;
       case KupDebugCategory.WARNING:
-        console.warn(this.formatDate(date) + id + message, obj);
+        console.warn(dom.ketchup.dates.format(date, 'LLL:ms') + id + message, obj);
         break;
     }
   }
-  /**
-   * Function used to format a date.
-   * Example: "Sun Mar 14 2021 13:50:56,329pm"
-   * @param {Date} date - Date to be formatted.
-   * @returns {string} Formatted
-   */
-  formatDate(date) {
-    let minutes = date.getMinutes().toString().length == 1
-      ? '0' + date.getMinutes()
-      : date.getMinutes(), hours = date.getHours().toString().length == 1
-      ? '0' + date.getHours()
-      : date.getHours(), seconds = date.getSeconds().toString().length == 1
-      ? '0' + date.getSeconds()
-      : date.getSeconds(), milliseconds = date.getMilliseconds().toString().length == 1
-      ? '0' + date.getMilliseconds()
-      : date.getMilliseconds(), ampm = date.getHours() >= 12 ? 'pm' : 'am', months = [
-      'Jan',
-      'Feb',
-      'Mar',
-      'Apr',
-      'May',
-      'Jun',
-      'Jul',
-      'Aug',
-      'Sep',
-      'Oct',
-      'Nov',
-      'Dec',
-    ], days = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
-    return (days[date.getDay()] +
-      ' ' +
-      months[date.getMonth()] +
-      ' ' +
-      date.getDate() +
-      ' ' +
-      date.getFullYear() +
-      ' ' +
-      hours +
-      ':' +
-      minutes +
-      ':' +
-      seconds +
-      ',' +
-      milliseconds +
-      ampm);
-  }
   /**
    * Function used to time the loading times of a component.
    * @param {any} comp - The component calling this function or a string.

package/dist/collection/{utils → managers}/kup-dynamic-position/kup-dynamic-position.js

@@ -40,17 +40,26 @@ export class KupDynamicPosition {
     if (this.anchorIsHTMLElement(anchorEl)) {
       anchorEl.setAttribute(kupDynamicPositionAnchorAttribute, '');
     }
+    el.style.zIndex = `calc(var(--kup-navbar-zindex) - 1)`;
+    const originalPath = [];
     if (detach) {
+      let currentEl = el;
+      while (currentEl && currentEl !== document.body) {
+        currentEl = currentEl.parentNode
+          ? currentEl.parentNode
+          : currentEl.host;
+        originalPath.push(currentEl);
+      }
       el.style.position = 'absolute';
       this.container.appendChild(el);
     }
     else {
       el.style.position = 'fixed';
     }
-    el.style.zIndex = `calc(var(--kup-navbar-zindex) - 1)`;
     el.kupDynamicPosition = {
       anchor: anchorEl,
       detach: detach ? true : false,
+      originalPath: originalPath,
       margin: margin ? margin : 0,
       placement: placement ? placement : KupDynamicPositionPlacement.AUTO,
       rAF: null,

package/dist/collection/{utils → managers}/kup-interact/kup-interact-declarations.js

@@ -44,5 +44,6 @@ export var KupDropEventTypes;
 (function (KupDropEventTypes) {
   KupDropEventTypes["BOX"] = "text/kup-box-drag";
   KupDropEventTypes["DATATABLE"] = "text/kup-data-table-row-drag";
+  KupDropEventTypes["GENERIC"] = "text/generic";
   KupDropEventTypes["MAGICBOX"] = "text/kup-magic-box-drag";
 })(KupDropEventTypes || (KupDropEventTypes = {}));

package/dist/collection/{utils → managers}/kup-interact/kup-interact.js

@@ -35,7 +35,7 @@ export class KupInteract {
     if (!options) {
       options = {};
     }
-    if (!effect) {
+    if (effect === undefined || effect === null) {
       effect = KupDragEffect.MOVE;
     }
     options.listeners = {
@@ -111,10 +111,12 @@ export class KupInteract {
             ghostImage.style.height = draggable.clientHeight + 'px';
             ghostImage.style.left =
               e.clientX - draggable.clientWidth / 2 + 'px';
+            ghostImage.style.margin = '0';
             ghostImage.style.opacity = '0.75';
             ghostImage.style.position = 'fixed';
             ghostImage.style.top =
               e.clientY - draggable.clientHeight / 2 + 'px';
+            ghostImage.style.transform = '';
             ghostImage.style.width = draggable.clientWidth + 'px';
             ghostImage.style.zIndex =
               'calc(var(--kup-navbar-zindex) + 1)';
@@ -225,7 +227,6 @@ export class KupInteract {
               },
             },
           });
-          e.currentTarget.removeAttribute(kupDragOverAttr);
           eventData.dispatcher.dispatchEvent(ketchupDropEvent);
         }
         e.currentTarget.removeAttribute(kupDragOverAttr);
@@ -252,24 +253,32 @@ export class KupInteract {
    * @param {Partial<ResizableOptions>} options - Options of the resize action.
    * @param {KupResizeCallbacks} callbacks - Additional callbacks to invoke.
    * @param {boolean} moveOnResize - When true, the element will be moved when resizing in order to keep its position.
+   * @param {boolean} autoResize - When true, the element will be automatically resized (usually the behavior is specified in a callback).
    * @see https://interactjs.io/docs/action-options/ For more options
    */
-  resizable(el, options, callbacks, moveOnResize) {
-    if (!options) {
-      options = {};
+  resizable(el, options, callbacks, moveOnResize, autoResize) {
+    if (!options || !options.edges) {
+      options = Object.assign(Object.assign({}, options), { edges: {
+          left: true,
+          right: true,
+          bottom: true,
+          top: true,
+        } });
     }
     options.listeners = {
       move(e) {
         if (callbacks && callbacks.move) {
           callbacks.move(e);
         }
+        if (autoResize) {
+          el.style.width = e.rect.width + 'px';
+          el.style.height = e.rect.height + 'px';
+        }
         if (moveOnResize) {
           const el = e.target;
           const oldTransform = e.target.style.transform;
           let x = parseFloat(el.getAttribute('data-x')) || 0;
           let y = parseFloat(el.getAttribute('data-y')) || 0;
-          el.style.width = e.rect.width + 'px';
-          el.style.height = e.rect.height + 'px';
           x += e.deltaRect.left;
           y += e.deltaRect.top;
           el.style.transform = 'translate(' + x + 'px,' + y + 'px)';
@@ -286,7 +295,7 @@ export class KupInteract {
   /**
    * Adds a new interact.js event listener to the given argument.
    * @param {HTMLElement} el - The element on which the event listener will be added.
-   * @param {KupPointerEventTypes} event - Supported events.
+   * @param {KupPointerEventTypes} event - Name of the event.
    * @param {KupResizeCallbacks} callback - Callback to invoke when the event fires.
    */
   on(el, event, callback) {
@@ -313,7 +322,7 @@ export class KupInteract {
     return true;
   }
   /**
-   * This method treats the given element as a dialog, by activating moving-on-drag and, optionally, its resize.
+   * This method gives the element dialog-like features, by activating moving on drag and, optionally, the resize.
    * @param {HTMLElement} el - Dialog element.
    * @param {HTMLElement} handleEl - Element that must be dragged in order to trigger movement. When not provided, dragging anywhere on "el" will move it.
    * @param {boolean} unresizable - When true, the dialog can't be resized.
@@ -353,12 +362,12 @@ export class KupInteract {
             min: { width: 100, height: 100 },
           }),
         ],
-      }, null, true);
+      }, null, true, true);
     }
   }
   /**
-   * Removes the elements from the MoveOnDrag class watchlist.
-   * @param {HTMLElement[]} elements - Elements to remove.
+   * Removes all event listeners from the elements in the array.
+   * @param {HTMLElement[]} elements - Elements to handle.
    */
   unregister(elements) {
     if (this.managedElements) {
@@ -369,7 +378,7 @@ export class KupInteract {
     }
   }
   /**
-   * Returns whether an element was previously registered or not.
+   * Checks whether an element is currently registered or not.
    * @param {HTMLElement} el - Element to test.
    * @returns {boolean} True if the element was registered.
    */

package/dist/collection/{utils → managers}/kup-language/kup-language-declarations.js

@@ -30,6 +30,11 @@ export var KupLanguageColumn;
   KupLanguageColumn["ADD_DESCRIPTION"] = "columnAddDescription";
   KupLanguageColumn["COLUMNS"] = "columnColumns";
   KupLanguageColumn["HIDE"] = "columnHide";
+  KupLanguageColumn["MERGE"] = "columnMerge";
+  KupLanguageColumn["NO_FORMULA"] = "columnNoFormula";
+  KupLanguageColumn["NON_NUMERICAL"] = "columnNonNumerical";
+  KupLanguageColumn["NON_NUMERICAL_IN_TABLE"] = "columnNonNumericalInTable";
+  KupLanguageColumn["SWAP"] = "columnSwap";
 })(KupLanguageColumn || (KupLanguageColumn = {}));
 /**
  * Debug widget decodes.
@@ -93,8 +98,10 @@ export var KupLanguageGeneric;
   KupLanguageGeneric["LAYOUT_NYI"] = "genericLayoutNotYetImplemented";
   KupLanguageGeneric["LIST"] = "genericList";
   KupLanguageGeneric["LOAD_MORE"] = "genericLoadMoreData";
+  KupLanguageGeneric["MERGE"] = "genericMerge";
   KupLanguageGeneric["MENU"] = "genericMenu";
   KupLanguageGeneric["MONTH"] = "genericMonth";
+  KupLanguageGeneric["MOVE"] = "genericMove";
   KupLanguageGeneric["NEXT"] = "genericNext";
   KupLanguageGeneric["OPEN_NAVIGATION_MENU"] = "genericOpenNavigationMenu";
   KupLanguageGeneric["OPEN_IN_NEW_TAB"] = "genericOpenInNewTab";
@@ -106,6 +113,7 @@ export var KupLanguageGeneric;
   KupLanguageGeneric["SHOW_ROW_OPTIONS"] = "genericShowRowOptions";
   KupLanguageGeneric["SHOW_TOOLTIP_INFO"] = "genericShowTooltipInfo";
   KupLanguageGeneric["SORT_BY"] = "genericSortBy";
+  KupLanguageGeneric["SWAP"] = "genericSwap";
   KupLanguageGeneric["TOGGLE"] = "genericToggle";
   KupLanguageGeneric["TODAY"] = "genericToday";
   KupLanguageGeneric["TOTALS_TABLE"] = "genericTotalsTable";
@@ -174,9 +182,11 @@ export var KupLanguageTotals;
   KupLanguageTotals["CALCULATE"] = "totalsCalculate";
   KupLanguageTotals["CANCEL"] = "totalsCancel";
   KupLanguageTotals["COUNT"] = "totalsCount";
+  KupLanguageTotals["DIFFERENCE"] = "totalsDifference";
   KupLanguageTotals["DISTINCT"] = "totalsDistinct";
   KupLanguageTotals["FORMULA"] = "totalsFormula";
   KupLanguageTotals["MAXIMUM"] = "totalsMaximum";
   KupLanguageTotals["MINIMUM"] = "totalsMinimum";
+  KupLanguageTotals["PRODUCT"] = "totalsProduct";
   KupLanguageTotals["SUM"] = "totalsSum";
 })(KupLanguageTotals || (KupLanguageTotals = {}));

package/dist/collection/{utils → managers}/kup-language/kup-language.js

@@ -106,8 +106,8 @@ export class KupLanguage {
     };
     const separator = language.indexOf('_');
     if (separator > -1) {
-      result.variant = language.substr(separator + 1);
-      result.language = language.substr(0, separator);
+      result.variant = language.substring(separator + 1);
+      result.language = language.substring(0, separator);
     }
     else {
       result.language = language;
@@ -115,7 +115,7 @@ export class KupLanguage {
     return result;
   }
   /**
-   * Gets the name of available languages.
+   * Gets the name of available languages and variants.
    * @returns {Array<string>} Array of languages' names.
    */
   getLanguages() {
@@ -132,14 +132,14 @@ export class KupLanguage {
     return languages;
   }
   /**
-   * Registers a KupComponent in KupLanguage, in order to be properly handled whenever the language changes.
+   * Registers a KupComponent in KupLanguage, in order to be automatically refreshed whenever the language changes.
    * @param {any} component - The component calling this function.
    */
   register(component) {
     this.managedComponents.add(component.rootElement);
   }
   /**
-   * Unregisters a KupComponent, so it won't be handled when the theme changes.
+   * Unregisters a KupComponent, so it won't be refreshed when the language changes.
    *
    * @param {any} component - The component calling this function.
    */

package/dist/collection/{utils → managers}/kup-manager/kup-manager.js

@@ -8,10 +8,13 @@ import { KupTheme } from '../kup-theme/kup-theme';
 import { KupToolbar } from '../kup-toolbar/kup-toolbar';
 import { ResizeObserver } from 'resize-observer';
 import { KupLanguageDefaults, } from '../kup-language/kup-language-declarations';
+import { KupData } from '../kup-data/kup-data';
 import { KupDates } from '../kup-dates/kup-dates';
 import { KupDatesLocales } from '../kup-dates/kup-dates-declarations';
 import { KupDebugCategory } from '../kup-debug/kup-debug-declarations';
 import { KupSearch } from '../kup-search/kup-search';
+import { KupMathLocales } from '../kup-math/kup-math-declarations';
+import { KupMath } from '../kup-math/kup-math';
 const dom = document.documentElement;
 /**
  * This class controls every other Ketchup utility suite.
@@ -65,12 +68,14 @@ export class KupManager {
         themeName = theme.name ? theme.name : null;
       }
     }
+    this.data = new KupData();
     this.dates = new KupDates(datesLocale);
     this.debug = new KupDebug(debugActive, debugAutoprint, debugLogLimit);
     this.dynamicPosition = new KupDynamicPosition();
     this.interact = new KupInteract(dialogZIndex, dialogRestrictContainer);
     this.language = new KupLanguage(languageList, languageName);
     this.magicBox = null;
+    this.math = new KupMath();
     this.overrides = overrides ? overrides : null;
     this.objects = new KupObjects(objectsList);
     this.resize = new ResizeObserver((entries) => {
@@ -102,10 +107,14 @@ export class KupManager {
       const lastString = paths[0].innerText || paths[0].value;
       this.utilities.lastPointerDownString = lastString;
       if (lastString) {
-        document.dispatchEvent(new CustomEvent('kup-manager-stringfinder', {
+        const e = new CustomEvent('kup-manager-stringfinder', {
           bubbles: true,
-          detail: { string: lastString },
-        }));
+          cancelable: true,
+          detail: {
+            string: lastString,
+          },
+        });
+        document.dispatchEvent(e);
       }
     });
     document.addEventListener('click', (e) => {
@@ -115,7 +124,29 @@ export class KupManager {
           obj.el &&
           obj.el.isConnected &&
           !paths.includes(obj.el)) {
-          obj.cb();
+          const elAsDynamicPos = obj.el;
+          let found = false;
+          if (elAsDynamicPos.kupDynamicPosition &&
+            elAsDynamicPos.kupDynamicPosition.detach) {
+            for (let index = 0; index < paths.length; index++) {
+              const pathEl = paths[index];
+              const pathElAsDynamicPos = pathEl;
+              if (pathElAsDynamicPos.kupDynamicPosition &&
+                pathElAsDynamicPos.kupDynamicPosition.detach) {
+                const originalPath = pathElAsDynamicPos.kupDynamicPosition
+                  .originalPath;
+                if (originalPath.includes(obj.el)) {
+                  found = true;
+                }
+              }
+            }
+            if (!found) {
+              obj.cb();
+            }
+          }
+          else {
+            obj.cb();
+          }
         }
       });
     });
@@ -170,6 +201,7 @@ export class KupManager {
     }
     this.dates.setLocale(locale);
     this.language.set(KupLanguageDefaults[locale]);
+    this.math.setLocale(KupMathLocales[locale]);
   }
   /**
    * Adds a new click callback.
@@ -209,6 +241,15 @@ export function kupManagerInstance() {
       dom.ketchup.debug.toggle(dom.ketchup.debug.active);
     }
     globalThis.kupManager = dom.ketchup;
+    if (overrides && overrides.autoSetLocalization) {
+      const locale = dom.ketchup.dates.locale;
+      if (!overrides.language || !overrides.language.name) {
+        dom.ketchup.language.set(KupLanguageDefaults[locale]);
+      }
+      if (!overrides.math || !overrides.math.locale) {
+        dom.ketchup.math.setLocale(KupMathLocales[locale]);
+      }
+    }
     document.dispatchEvent(new CustomEvent('kup-manager-ready'));
   }
   return dom.ketchup;

package/dist/collection/managers/kup-math/kup-math-declarations.js

@@ -0,0 +1,13 @@
+/**
+ * Locales available for KupMath.
+ */
+export var KupMathLocales;
+(function (KupMathLocales) {
+  KupMathLocales["cn"] = "chs";
+  KupMathLocales["en"] = "en";
+  KupMathLocales["es"] = "es";
+  KupMathLocales["it"] = "it";
+  KupMathLocales["fr"] = "fr";
+  KupMathLocales["pl"] = "pl";
+  KupMathLocales["ru"] = "ru";
+})(KupMathLocales || (KupMathLocales = {}));

package/dist/collection/managers/kup-math/kup-math-helper.js

@@ -0,0 +1,39 @@
+import { KupDebugCategory } from '../kup-debug/kup-debug-declarations';
+const dom = document.documentElement;
+/**
+ * Takes a mathematical formula as string in input, with column names between brackets, and returns the result as a number.
+ * @param {string} formula - Mathematical operation (i.e.: ([COL1] - [COL2]) * 100 / [COL3]).
+ * @param {{ [index: string]: number }} row - Object containing column names as indexes and the related values as keys.
+ * @returns {number} Result of the formula.
+ */
+export function customFormula(formula, row) {
+  const keys = Object.keys(row);
+  for (let i = 0; i < keys.length; i++) {
+    let key = keys[i];
+    let value = row[key];
+    if (value != null && !isNaN(value)) {
+      let re = new RegExp(key, 'g');
+      formula = formula.replace(re, value.toString());
+    }
+  }
+  formula = formula.replace(/[\[\]']+/g, '');
+  try {
+    const result = Function('"use strict"; return (' + formula + ')')();
+    return result;
+  }
+  catch (e) {
+    dom.ketchup.debug.logMessage('kup-data', 'Error while evaluating the following formula!(' + formula + ')', KupDebugCategory.ERROR);
+    return NaN;
+  }
+}
+/**
+ * Calculates a single Y point of a normal distribution.
+ * @param {number} average - Average.
+ * @param {number} variance - Variance.
+ * @param {number} x - X coordinate.
+ * @returns {number} Result.
+ */
+export function normalDistributionFormula(average, variance, x) {
+  return ((1 / Math.sqrt(variance * 2 * Math.PI)) *
+    Math.exp(-Math.pow(x - average, 2) / (2 * variance)));
+}