@formio/js 5.0.0-dev.5641.d9ab3df → 5.0.0-dev.5642.f9208f7

package/lib/cjs/utils/utils.js

@@ -42,11 +42,11 @@ const jstimezonedetect_1 = __importDefault(require("jstimezonedetect"));
 const operators_1 = require("./jsonlogic/operators");
 const dompurify_1 = __importDefault(require("dompurify"));
 const formUtils_1 = require("./formUtils");
-const Evaluator_1 = require("./Evaluator");
-Object.defineProperty(exports, "Evaluator", { enumerable: true, get: function () { return Evaluator_1.Evaluator; } });
+const Evaluator_1 = __importDefault(require("./Evaluator"));
+exports.Evaluator = Evaluator_1.default;
 const conditionOperators_1 = __importDefault(require("./conditionOperators"));
 exports.ConditionOperators = conditionOperators_1.default;
-const interpolate = Evaluator_1.Evaluator.interpolate;
+const interpolate = Evaluator_1.default.interpolate;
 exports.interpolate = interpolate;
 const { fetch } = (0, fetch_ponyfill_1.default)({
     Promise: Promise
@@ -67,10 +67,6 @@ json_logic_js_1.default.add_operation('relativeMaxDate', (relativeMaxDate) => {
     return (0, moment_timezone_1.default)().add(relativeMaxDate, 'days').toISOString();
 });
 exports.moment = __importStar(require("moment-timezone/moment-timezone"));
-/**
- * Sets the path to the component and parent schema.
- * @param {import('@formio/core').Component} component - The component to set the path for.
- */
 function setPathToComponentAndPerentSchema(component) {
     component.path = getComponentPath(component);
     const dataParent = getDataParentComponent(component);
@@ -80,30 +76,79 @@ function setPathToComponentAndPerentSchema(component) {
 }
 /**
  * Evaluate a method.
- * @param {Function|string|object} func - The function to evaluate.
- * @param {*} args - A map of arguments to pass to the function.
- * @param {string} ret - The name of the "return" variable in the script.
- * @param {boolean} interpolate - True if the script should be interpolated before being executed.
- * @param {import('@formio/core').EvaluatorOptions} options - The evaluator options.
- * @returns {*} - The result of the evaluation.
- */
-function evaluate(func, args, ret, interpolate, options = {}) {
-    return Evaluator_1.Evaluator.evaluate(func, args, ret, interpolate, undefined, options);
+ *
+ * @param func
+ * @param args
+ * @return {*}
+ */
+function evaluate(func, args, ret, tokenize) {
+    let returnVal = null;
+    const component = args.component ? args.component : { key: 'unknown' };
+    if (!args.form && args.instance) {
+        args.form = lodash_1.default.get(args.instance, 'root._form', {});
+    }
+    const componentKey = component.key;
+    if (typeof func === 'string') {
+        if (ret) {
+            func += `;return ${ret}`;
+        }
+        if (tokenize) {
+            // Replace all {{ }} references with actual data.
+            func = func.replace(/({{\s+(.*)\s+}})/, (match, $1, $2) => {
+                if ($2.indexOf('data.') === 0) {
+                    return lodash_1.default.get(args.data, $2.replace('data.', ''));
+                }
+                else if ($2.indexOf('row.') === 0) {
+                    return lodash_1.default.get(args.row, $2.replace('row.', ''));
+                }
+                // Support legacy...
+                return lodash_1.default.get(args.data, $2);
+            });
+        }
+        try {
+            func = Evaluator_1.default.evaluator(func, args);
+            args = lodash_1.default.values(args);
+        }
+        catch (err) {
+            console.warn(`An error occured within the custom function for ${componentKey}`, err);
+            returnVal = null;
+            func = false;
+        }
+    }
+    if (typeof func === 'function') {
+        try {
+            returnVal = Evaluator_1.default.evaluate(func, args);
+        }
+        catch (err) {
+            returnVal = null;
+            console.warn(`An error occured within custom function for ${componentKey}`, err);
+        }
+    }
+    else if (typeof func === 'object') {
+        try {
+            returnVal = json_logic_js_1.default.apply(func, args);
+        }
+        catch (err) {
+            returnVal = null;
+            console.warn(`An error occured within custom function for ${componentKey}`, err);
+        }
+    }
+    else if (func) {
+        console.warn(`Unknown function type for ${componentKey}`);
+    }
+    return returnVal;
 }
 exports.evaluate = evaluate;
-/**
- * Returns a random compoennt ID.
- * @returns {string} - A random component ID.
- */
 function getRandomComponentId() {
     return `e${Math.random().toString(36).substring(7)}`;
 }
 exports.getRandomComponentId = getRandomComponentId;
 /**
  * Get a property value of an element.
- * @param {CSSStyleDeclaration} style - The style element to get the property value from.
- * @param {string} prop - The property to get the value for.
- * @returns {number} - The value of the property.
+ *
+ * @param style
+ * @param prop
+ * @return {number}
  */
 function getPropertyValue(style, prop) {
     let value = style.getPropertyValue(prop);
@@ -113,8 +158,9 @@ function getPropertyValue(style, prop) {
 exports.getPropertyValue = getPropertyValue;
 /**
  * Get an elements bounding rectagle.
- * @param {HTMLElement} element - A DOM element to get the bounding rectangle for.
- * @returns {{x: number, y: number, width: number, height: number}} - The bounding rectangle.
+ *
+ * @param element
+ * @return {{x: string, y: string, width: string, height: string}}
  */
 function getElementRect(element) {
     const style = window.getComputedStyle(element, null);
@@ -128,8 +174,8 @@ function getElementRect(element) {
 exports.getElementRect = getElementRect;
 /**
  * Get non HTMLElement property in the window object
- * @param {string} property - The window property to fetch the script plugin from.
- * @returns {any | undefined} - The HTML Element property on the window object.
+ * @param {String} property
+ * @return {any || undefined}
  */
 function getScriptPlugin(property) {
     const obj = window[property];
@@ -142,8 +188,9 @@ function getScriptPlugin(property) {
 exports.getScriptPlugin = getScriptPlugin;
 /**
  * Determines the boolean value of a setting.
- * @param {string|boolean} value - A string or boolean value to convert to boolean.
- * @returns {boolean} - The boolean value of the setting.
+ *
+ * @param value
+ * @return {boolean}
  */
 function boolValue(value) {
     if (lodash_1.default.isBoolean(value)) {
@@ -159,18 +206,22 @@ function boolValue(value) {
 exports.boolValue = boolValue;
 /**
  * Check to see if an ID is a mongoID.
- * @param {string} text - The text to check if it is a mongoID.
- * @returns {boolean} - TRUE if the text is a mongoID; FALSE otherwise.
+ * @param text
+ * @return {Array|{index: number, input: string}|Boolean|*}
  */
 function isMongoId(text) {
-    return !!text.toString().match(/^[0-9a-fA-F]{24}$/);
+    return text.toString().match(/^[0-9a-fA-F]{24}$/);
 }
 exports.isMongoId = isMongoId;
 /**
  * Checks the calculated value for a provided component and data.
- * @param {import('@formio/core').Component} component - The component to check for the calculated value.
- * @param {import('@formio/core').Submission} submission - A submission object.
- * @param {*} rowData - The contextual row data for the component.
+ *
+ * @param {Object} component
+ *   The component to check for the calculated value.
+ * @param {Object} submission
+ *   A submission object.
+ * @param data
+ *   The full submission data.
  */
 function checkCalculated(component, submission, rowData) {
     // Process calculated value stuff if present.
@@ -187,12 +238,13 @@ function checkCalculated(component, submission, rowData) {
 exports.checkCalculated = checkCalculated;
 /**
  * Check if a simple conditional evaluates to true.
- * @param {import('@formio/core').Component} component - The component to check for the conditional.
- * @param {import('@formio/core').SimpleConditional} condition - The condition to check.
- * @param {*} row - The row data for the component.
- * @param {*} data - The full submission data.
- * @param {import('../../src/components/_classes/component/Component').Component} instance - The instance of the component.
- * @returns {boolean} - TRUE if the condition is true; FALSE otherwise.
+ *
+ * @param condition
+ * @param condition
+ * @param row
+ * @param data
+ * @param instance
+ * @returns {boolean}
  */
 function checkSimpleConditional(component, condition, row, data, instance) {
     if (condition.when) {
@@ -237,13 +289,6 @@ function checkSimpleConditional(component, condition, row, data, instance) {
     }
 }
 exports.checkSimpleConditional = checkSimpleConditional;
-/**
- * Returns a components normalized value.
- * @param {string} compPath - The full path to the component.
- * @param {*} data - The data object to get the value from.
- * @param {*} row - The contextual row data for the component.
- * @returns {*} - The normalized value of the component.
- */
 function getComponentActualValue(compPath, data, row) {
     let value = null;
     if (row) {
@@ -261,15 +306,12 @@ function getComponentActualValue(compPath, data, row) {
 exports.getComponentActualValue = getComponentActualValue;
 /**
  * Check custom javascript conditional.
- * @param {import('@formio/core').Component} component - The component to check for the conditional.
- * @param {string} custom - The custom conditional string to evaluate.
- * @param {*} row - The row data for the component.
- * @param {*} data - The full submission data.
- * @param {import('@formio/core').Form} form - The form object.
- * @param {string} variable - The variable name for the result of the custom conditional.
- * @param {*} onError - A custom return if there is an error or the value is null from the evaluation.
- * @param {import('../../src/components/_classes/component/Component').Component} instance - The component instance.
- * @returns {*} - The result of the evaulation.
+ *
+ * @param component
+ * @param custom
+ * @param row
+ * @param data
+ * @returns {*}
  */
 function checkCustomConditional(component, custom, row, data, form, variable, onError, instance) {
     if (typeof custom === 'string') {
@@ -284,16 +326,6 @@ function checkCustomConditional(component, custom, row, data, form, variable, on
     return value;
 }
 exports.checkCustomConditional = checkCustomConditional;
-/**
- * Check a component for JSON conditionals.
- * @param {import('@formio/core').Component} component - The component
- * @param {import('@formio/core').JSONConditional} json - The json conditional to check.
- * @param {*} row - The contextual row data for the component.
- * @param {*} data - The full submission data.
- * @param {import('@formio/core').Form} form - The Form JSON of the form.
- * @param {*} onError - Custom return value if there is an error.
- * @returns {boolean} - TRUE if the condition is true; FALSE otherwise.
- */
 function checkJsonConditional(component, json, row, data, form, onError) {
     try {
         return json_logic_js_1.default.apply(json, {
@@ -309,14 +341,6 @@ function checkJsonConditional(component, json, row, data, form, onError) {
     }
 }
 exports.checkJsonConditional = checkJsonConditional;
-/**
- * Returns the contextual row data for a component.
- * @param {import('@formio/core').Component} component - The component to get the row data for.
- * @param {*} row - The row data for the component.
- * @param {import('../../src/components/_classes/component/Component').Component} instance - The component instance.
- * @param {*} conditional - The component conditional.
- * @returns {*} - The contextual row data for the component.
- */
 function getRow(component, row, instance, conditional) {
     var _a;
     const condition = conditional || component.conditional;
@@ -339,12 +363,15 @@ function getRow(component, row, instance, conditional) {
 }
 /**
  * Checks the conditions for a provided component and data.
- * @param {import('@formio/core').Component} component - The component to check for the condition.
- * @param {*} row - The data within a row
- * @param {*} data - The full submission data.
- * @param {import('@formio/core').Form} form - The form object.
- * @param {import('../../src/components/_classes/component/Component').Component} instance - The component instance.
- * @returns {boolean} - TRUE if the condition is true; FALSE otherwise.
+ *
+ * @param component
+ *   The component to check for the condition.
+ * @param row
+ *   The data within a row
+ * @param data
+ *   The full submission data.
+ *
+ * @returns {boolean}
  */
 function checkCondition(component, row, data, form, instance) {
     const { customConditional, conditional } = component;
@@ -364,13 +391,12 @@ function checkCondition(component, row, data, form, instance) {
 exports.checkCondition = checkCondition;
 /**
  * Test a trigger on a component.
- * @param {import('@formio/core').Component} component - The component to test the trigger against.
- * @param {import('@formio/core').LogicTrigger} trigger - The trigger configuration.
- * @param {import('@formio/core').DataObject} row - The contextual row data.
- * @param {import('@formio/core').DataObject} data - The root data object.
- * @param {import('@formio/core').Form} form - The form object.
- * @param {any} instance - The component that is performing the trigger.
- * @returns {boolean} - TRUE if the trigger should fire; FALSE otherwise.
+ *
+ * @param component
+ * @param action
+ * @param data
+ * @param row
+ * @returns {mixed}
  */
 function checkTrigger(component, trigger, row, data, form, instance) {
     // If trigger is empty, don't fire it
@@ -390,16 +416,6 @@ function checkTrigger(component, trigger, row, data, form, instance) {
     return false;
 }
 exports.checkTrigger = checkTrigger;
-/**
- * Sets a property on a component via an executed Logic action.
- * @param {import('@formio/core').Component} component - The component to set the property on.
- * @param {import('@formio/core').LogicAction} action - The action to perform on the component.
- * @param {string} result - The name of the variable in the evaulation to use as the result.
- * @param {import('@formio/core').DataObject} row - The contextual row data.
- * @param {import('@formio/core').DataObject} data - The full submission data.
- * @param {any} instance - The component instance.
- * @returns {import('@formio/core').Component} - The modified component.
- */
 function setActionProperty(component, action, result, row, data, instance) {
     const property = action.property.value;
     switch (action.property.type) {
@@ -422,7 +438,7 @@ function setActionProperty(component, action, result, row, data, instance) {
             const currentValue = lodash_1.default.get(component, property, '');
             const newValue = (instance && instance.interpolate)
                 ? instance.interpolate(textValue, evalData)
-                : Evaluator_1.Evaluator.interpolate(textValue, evalData);
+                : Evaluator_1.default.interpolate(textValue, evalData);
             if (newValue !== currentValue) {
                 lodash_1.default.set(component, property, newValue);
             }
@@ -434,8 +450,8 @@ function setActionProperty(component, action, result, row, data, instance) {
 exports.setActionProperty = setActionProperty;
 /**
  * Removes HTML tags from string e.g. <div>Hello World</div> => Hello World
- * @param {string} str - The string to remove HTML tags from.
- * @returns {string} - The string without HTML tags.
+ * @param {string} str
+ * @returns {string}
  */
 function removeHTML(str) {
     const doc = new window.DOMParser().parseFromString(str, 'text/html');
@@ -444,8 +460,8 @@ function removeHTML(str) {
 exports.removeHTML = removeHTML;
 /**
  * Unescape HTML characters like &lt, &gt, &amp and etc.
- * @param {string} str - The string to unescape.
- * @returns {string} - The unescaped string.
+ * @param str
+ * @returns {string}
  */
 function unescapeHTML(str) {
     if (typeof window === 'undefined' || !('DOMParser' in window)) {
@@ -458,9 +474,9 @@ function unescapeHTML(str) {
 exports.unescapeHTML = unescapeHTML;
 /**
  * Make HTML element from string
- * @param {string} str - The string to convert to an HTML element.
- * @param {string} selector - The selector to use to get the element once it is created.
- * @returns {HTMLElement} - The HTML element that was created.
+ * @param str
+ * @param selector
+ * @returns {HTMLElement}
  */
 function convertStringToHTMLElement(str, selector) {
     const doc = new window.DOMParser().parseFromString(str, 'text/html');
@@ -469,10 +485,10 @@ function convertStringToHTMLElement(str, selector) {
 exports.convertStringToHTMLElement = convertStringToHTMLElement;
 /**
  * Make a filename guaranteed to be unique.
- * @param {string} name - The original name of the file.
- * @param {string} template - The template to use for the unique name.
- * @param {object} evalContext - The context to use for the evaluation.
- * @returns {string} - A unique filename.
+ * @param name
+ * @param template
+ * @param evalContext
+ * @returns {string}
  */
 function uniqueName(name, template, evalContext) {
     template = template || '{{fileName}}-{{guid}}';
@@ -492,14 +508,10 @@ function uniqueName(name, template, evalContext) {
         guid: guid()
     });
     //only letters, numbers, dots, dashes, underscores and spaces are allowed. Anything else will be replaced with dash
-    const uniqueName = `${Evaluator_1.Evaluator.interpolate(template, evalContext)}${extension}`.replace(/[^0-9a-zA-Z.\-_ ]/g, '-');
+    const uniqueName = `${Evaluator_1.default.interpolate(template, evalContext)}${extension}`.replace(/[^0-9a-zA-Z.\-_ ]/g, '-');
     return uniqueName;
 }
 exports.uniqueName = uniqueName;
-/**
- * Returns a GUID
- * @returns {string} - A GUID.
- */
 function guid() {
     return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
         const r = Math.random() * 16 | 0;
@@ -512,8 +524,9 @@ function guid() {
 exports.guid = guid;
 /**
  * Return a translated date setting.
- * @param {string|Date} date - The date to translate.
- * @returns {(null|Date)} - The translated date.
+ *
+ * @param date
+ * @return {(null|Date)}
  */
 function getDateSetting(date) {
     if (lodash_1.default.isNil(date) || lodash_1.default.isNaN(date) || date === '') {
@@ -531,7 +544,7 @@ function getDateSetting(date) {
     }
     dateSetting = null;
     try {
-        const value = Evaluator_1.Evaluator.evaluator(`return ${date};`, 'moment')(moment_timezone_1.default);
+        const value = Evaluator_1.default.evaluator(`return ${date};`, 'moment')(moment_timezone_1.default);
         if (typeof value === 'string') {
             dateSetting = (0, moment_timezone_1.default)(value);
         }
@@ -555,18 +568,14 @@ function getDateSetting(date) {
     return dateSetting.toDate();
 }
 exports.getDateSetting = getDateSetting;
-/**
- * Returns true if the date is a valid date. False otherwise.
- * @param {Date|string} date - The date to check for validity.
- * @returns {boolean} - TRUE if the date is valid; FALSE otherwise.
- */
 function isValidDate(date) {
     return lodash_1.default.isDate(date) && !lodash_1.default.isNaN(date.getDate());
 }
 exports.isValidDate = isValidDate;
 /**
  * Get the current timezone string.
- * @returns {string} - The current timezone.
+ *
+ * @return {string}
  */
 function currentTimezone() {
     if (moment_timezone_1.default.currentTimezone) {
@@ -578,9 +587,10 @@ function currentTimezone() {
 exports.currentTimezone = currentTimezone;
 /**
  * Get an offset date provided a date object and timezone object.
- * @param {Date} date - The date to offset.
- * @param {string} timezone - The timezone to offset the date to.
- * @returns {Date} - The offset date.
+ *
+ * @param date
+ * @param timezone
+ * @return {Date}
  */
 function offsetDate(date, timezone) {
     if (timezone === 'UTC') {
@@ -598,7 +608,8 @@ function offsetDate(date, timezone) {
 exports.offsetDate = offsetDate;
 /**
  * Returns if the zones are loaded.
- * @returns {boolean} - TRUE if the zones are loaded; FALSE otherwise.
+ *
+ * @return {boolean}
  */
 function zonesLoaded() {
     return moment_timezone_1.default.zonesLoaded;
@@ -606,8 +617,9 @@ function zonesLoaded() {
 exports.zonesLoaded = zonesLoaded;
 /**
  * Returns if we should load the zones.
- * @param {string} timezone - The timezone to check if we should load the zones.
- * @returns {boolean} - TRUE if we should load the zones; FALSE otherwise.
+ *
+ * @param timezone
+ * @return {boolean}
  */
 function shouldLoadZones(timezone) {
     if (timezone === currentTimezone() || timezone === 'UTC') {
@@ -618,9 +630,8 @@ function shouldLoadZones(timezone) {
 exports.shouldLoadZones = shouldLoadZones;
 /**
  * Externally load the timezone data.
- * @param {string} url - The URL to load the timezone data from.
- * @param {string} timezone - The timezone to load.
- * @returns {Promise<any> | *} - Resolves when the zones for this timezone are loaded.
+ *
+ * @return {Promise<any> | *}
  */
 function loadZones(url, timezone) {
     if (timezone && !shouldLoadZones(timezone)) {
@@ -645,10 +656,11 @@ function loadZones(url, timezone) {
 exports.loadZones = loadZones;
 /**
  * Get the moment date object for translating dates with timezones.
- * @param {string|Date} value - The value to convert into a moment date.
- * @param {string} format - The format to convert the date to.
- * @param {string} timezone - The timezone to convert the date to.
- * @returns {Date} - The moment date object.
+ *
+ * @param value
+ * @param format
+ * @param timezone
+ * @return {*}
  */
 function momentDate(value, format, timezone) {
     const momentDate = (0, moment_timezone_1.default)(value);
@@ -666,12 +678,11 @@ function momentDate(value, format, timezone) {
 exports.momentDate = momentDate;
 /**
  * Format a date provided a value, format, and timezone object.
- * @param {string} timezonesUrl - The URL to load the timezone data from.
- * @param {string|Date} value - The value to format.
- * @param {string} format - The format to format the date to.
- * @param {string} timezone - The timezone to format the date to.
- * @param {string} flatPickrInputFormat - The format to use for flatpickr input.
- * @returns {string} - The formatted date.
+ *
+ * @param value
+ * @param format
+ * @param timezone
+ * @return {string}
  */
 function formatDate(timezonesUrl, value, format, timezone, flatPickrInputFormat) {
     const momentDate = (0, moment_timezone_1.default)(value, flatPickrInputFormat || undefined);
@@ -705,12 +716,12 @@ function formatDate(timezonesUrl, value, format, timezone, flatPickrInputFormat)
 exports.formatDate = formatDate;
 /**
  * Pass a format function to format within a timezone.
- * @param {string} timezonesUrl - The URL to load the timezone data from.
- * @param {Function} formatFn - The format function to use.
- * @param {Date|string} date - The date to format.
- * @param {string} format - The format to format the date to.
- * @param {string} timezone - The timezone to format the date to.
- * @returns {string} - The formatted date.
+ *
+ * @param formatFn
+ * @param date
+ * @param format
+ * @param timezone
+ * @return {string}
  */
 function formatOffset(timezonesUrl, formatFn, date, format, timezone) {
     if (timezone === currentTimezone()) {
@@ -730,11 +741,6 @@ function formatOffset(timezonesUrl, formatFn, date, format, timezone) {
     }
 }
 exports.formatOffset = formatOffset;
-/**
- * Returns the local date format information.
- * @param {Intl.LocalesArgument} locale - The locale to get the date format for.
- * @returns {object} - The local date format information.
- */
 function getLocaleDateFormatInfo(locale) {
     const formatInfo = {};
     const day = 21;
@@ -746,8 +752,8 @@ function getLocaleDateFormatInfo(locale) {
 exports.getLocaleDateFormatInfo = getLocaleDateFormatInfo;
 /**
  * Convert the format from the angular-datepicker module to flatpickr format.
- * @param {string} format - The format to convert.
- * @returns {string} - The converted format.
+ * @param format
+ * @return {string}
  */
 function convertFormatToFlatpickr(format) {
     return format
@@ -778,8 +784,8 @@ function convertFormatToFlatpickr(format) {
 exports.convertFormatToFlatpickr = convertFormatToFlatpickr;
 /**
  * Convert the format from the angular-datepicker module to moment format.
- * @param {string} format - The format to convert.
- * @returns {string} - The converted format.
+ * @param format
+ * @return {string}
  */
 function convertFormatToMoment(format) {
     return format
@@ -795,11 +801,6 @@ function convertFormatToMoment(format) {
         .replace(/U/g, 'X');
 }
 exports.convertFormatToMoment = convertFormatToMoment;
-/**
- * Convert the format from the angular-datepicker module to mask format.
- * @param {string} format - The format to convert.
- * @returns {string} - The converted format.
- */
 function convertFormatToMask(format) {
     return format
         // Long month replacement.
@@ -859,13 +860,6 @@ function getInputMask(mask, placeholderChar) {
     return maskArray;
 }
 exports.getInputMask = getInputMask;
-/**
- * Unmasks a value using the provided mask and placeholder characters.
- * @param {string} value - The value to unmask.
- * @param {string} mask - The mask to use for unmasking.
- * @param {string} placeholderChar - The placeholder character to use for unmasking.
- * @returns {string} - The unmasked value.
- */
 function unmaskValue(value, mask, placeholderChar) {
     if (!mask || !value || value.length > mask.length) {
         return value;
@@ -882,12 +876,6 @@ function unmaskValue(value, mask, placeholderChar) {
     return unmaskedValue;
 }
 exports.unmaskValue = unmaskValue;
-/**
- * Returns true if the value matches the input mask format.
- * @param {string} value - The value to check.
- * @param {string} inputMask - The input mask to check against.
- * @returns {boolean} - TRUE if the value matches the input mask; FALSE otherwise.
- */
 function matchInputMask(value, inputMask) {
     if (!inputMask) {
         return true;
@@ -906,11 +894,6 @@ function matchInputMask(value, inputMask) {
     return true;
 }
 exports.matchInputMask = matchInputMask;
-/**
- * Returns the number separators (i.e. 1,000) for the provided language.
- * @param {string} lang - The language code to get the number separators for.
- * @returns {{delimiter: string, decimalSeparator: string}} - The number separators.
- */
 function getNumberSeparators(lang = 'en') {
     const formattedNumberString = (12345.6789).toLocaleString(lang);
     const delimeters = formattedNumberString.match(/..(.)...(.)../);
@@ -926,12 +909,6 @@ function getNumberSeparators(lang = 'en') {
     };
 }
 exports.getNumberSeparators = getNumberSeparators;
-/**
- * Returns the number for the maximum amount of decimal places for a number.
- * @param {import('@formio/core').Component} component - The component to check for decimal limits.
- * @param {number} defaultLimit - The default limit to use if none is provided in the component.
- * @returns {number} - The number of decimal places allowed.
- */
 function getNumberDecimalLimit(component, defaultLimit) {
     if (lodash_1.default.has(component, 'decimalLimit')) {
         return lodash_1.default.get(component, 'decimalLimit');
@@ -948,15 +925,6 @@ function getNumberDecimalLimit(component, defaultLimit) {
     return decimalLimit;
 }
 exports.getNumberDecimalLimit = getNumberDecimalLimit;
-/**
- * Returns the currency affixes for a specific language.
- * @param {object} arg0 - The arguments object.
- * @param {string} arg0.currency - The currency code to get the affixes for.
- * @param {number} arg0.decimalLimit - The number of decimal places to use.
- * @param {string} arg0.decimalSeparator - The decimal separator to use.
- * @param {string} arg0.lang - The language code to use.
- * @returns {{prefix: string, suffix: string}} - The currency affixes.
- */
 function getCurrencyAffixes({ currency, decimalLimit, decimalSeparator, lang, }) {
     // Get the prefix and suffix from the localized string.
     let regex = `(.*)?${(100).toLocaleString(lang)}`;
@@ -979,9 +947,10 @@ function getCurrencyAffixes({ currency, decimalLimit, decimalSeparator, lang, })
 exports.getCurrencyAffixes = getCurrencyAffixes;
 /**
  * Fetch the field data provided a component.
- * @param {import('@formio/core').DataObject} data - The data object to fetch the field data from.
- * @param {import('@formio/core').Component} component - The component to fetch the field data for.
- * @returns {*} - The field data.
+ *
+ * @param data
+ * @param component
+ * @return {*}
  */
 function fieldData(data, component) {
     if (!data) {
@@ -1028,23 +997,16 @@ function fieldData(data, component) {
 exports.fieldData = fieldData;
 /**
  * Delays function execution with possibility to execute function synchronously or cancel it.
- * @param {Function} fn - Function to delay
- * @param {number} delay - Delay time
- * @param {...any} args - Arguments to pass to the function
- * @returns {*} - Function to cancel the delay
+ *
+ * @param fn Function to delay
+ * @param delay Delay time
+ * @return {*}
  */
 function delay(fn, delay = 0, ...args) {
     const timer = setTimeout(fn, delay, ...args);
-    /**
-     *
-     */
     function cancel() {
         clearTimeout(timer);
     }
-    /**
-     * Execute the function early.
-     * @returns {*} - The result of the function.
-     */
     function earlyCall() {
         cancel();
         return fn(...args);
@@ -1056,9 +1018,11 @@ function delay(fn, delay = 0, ...args) {
 exports.delay = delay;
 /**
  * Iterate the given key to make it unique.
- * @param {string} key
+ *
+ * @param {String} key
  *   Modify the component key to be unique.
- * @returns {string}
+ *
+ * @returns {String}
  *   The new component key.
  */
 function iterateKey(key) {
@@ -1072,9 +1036,10 @@ function iterateKey(key) {
 exports.iterateKey = iterateKey;
 /**
  * Determines a unique key within a map provided the base key.
- * @param {Record<string, string>} map - The map to check for uniqueness.
- * @param {string} base - The base path of the key.
- * @returns {string} - The unique key.
+ *
+ * @param map
+ * @param base
+ * @return {*}
  */
 function uniqueKey(map, base) {
     let newKey = base;
@@ -1086,9 +1051,8 @@ function uniqueKey(map, base) {
 exports.uniqueKey = uniqueKey;
 /**
  * Determines the major version number of bootstrap.
- * @param {object} options - The options to check for bootstrap version.
- * @param {string} options.bootstrap - The bootstrap version to use.
- * @returns {number} - The bootstrap version.
+ *
+ * @return {number}
  */
 function bootstrapVersion(options) {
     if (options.bootstrap) {
@@ -1106,8 +1070,9 @@ exports.bootstrapVersion = bootstrapVersion;
 /**
  * Retrun provided argument.
  * If argument is a function, returns the result of a function call.
- * @param {Function|any} e - The argument to check if a function and call if so.
- * @returns {any} - Either the result of the function call (e) or e if it is not a function.
+ * @param {*} e;
+ *
+ * @return {*}
  */
 function unfold(e) {
     if (typeof e === 'function') {
@@ -1118,32 +1083,27 @@ function unfold(e) {
 exports.unfold = unfold;
 /**
  * Map values through unfold and return first non-nil value.
- * @param {Array<T>} collection - The collection to map through unfold.;
- * @returns {T} - The first non-nil value.
+ * @param {Array<T>} collection;
+ *
+ * @return {T}
  */
 exports.firstNonNil = lodash_1.default.flow([
     lodash_1.default.partialRight(lodash_1.default.map, unfold),
     lodash_1.default.partialRight(lodash_1.default.find, v => !lodash_1.default.isUndefined(v))
 ]);
-/**
- * Create enclosed state. Returns functions to getting and cycling between states.
+/*
+ * Create enclosed state.
+ * Returns functions to getting and cycling between states.
  * @param {*} a - initial state.
  * @param {*} b - next state.
- * @returns {Functions[]} -- [get, toggle];
+ * @return {Functions[]} -- [get, toggle];
  */
 function withSwitch(a, b) {
     let state = a;
     let next = b;
-    /**
-     * Returns the state of the switch.
-     * @returns {*} - The current state.
-     */
     function get() {
         return state;
     }
-    /**
-     * Toggles the state of the switch.
-     */
     function toggle() {
         const prev = state;
         state = next;
@@ -1152,14 +1112,6 @@ function withSwitch(a, b) {
     return [get, toggle];
 }
 exports.withSwitch = withSwitch;
-/**
- * Create a function that will call the provided function only the provided limit.
- * @param {Function} callback - The callback to call.
- * @param {object} options - The options to use.
- * @param {number} options.limit - The limit to call the callback.
- * @param {number} options.delay - The delay to wait before resetting the call count.
- * @returns {Function} - The function that will call the callback only the provided limit.
- */
 function observeOverload(callback, options = {}) {
     const { limit = 50, delay = 500 } = options;
     let callCount = 0;
@@ -1180,13 +1132,6 @@ function observeOverload(callback, options = {}) {
     };
 }
 exports.observeOverload = observeOverload;
-/**
- * Returns the components that are provided within an evaluation context.
- * @param {any} context - The evaluation context to get the components from.
- * @param {boolean} excludeNested - Exclude nested components.
- * @param {Array<string>} excludedTypes - The types of components to exclude.
- * @returns {Array} - The components within the evaluation context.
- */
 function getContextComponents(context, excludeNested, excludedTypes = []) {
     const values = [];
     context.utils.eachComponent(context.instance.options.editForm.components, (component, path) => {
@@ -1201,11 +1146,6 @@ function getContextComponents(context, excludeNested, excludedTypes = []) {
     return values;
 }
 exports.getContextComponents = getContextComponents;
-/**
- * Returns the button components that are within an evaluation context.
- * @param {any} context - The evaluation context to get the components from.
- * @returns {Array} - The button components within the evaluation context.
- */
 function getContextButtons(context) {
     const values = [];
     context.utils.eachComponent(context.instance.options.editForm.components, (component) => {
@@ -1223,15 +1163,18 @@ exports.getContextButtons = getContextButtons;
 const inTextTags = ['#text', 'A', 'B', 'EM', 'I', 'SMALL', 'STRONG', 'SUB', 'SUP', 'INS', 'DEL', 'MARK', 'CODE'];
 /**
  * Helper function for 'translateHTMLTemplate'. Translates text value of the passed html element.
- * @param {HTMLElement} elem - The element to translate.
- * @param {Function} translate - The translation function.
- * @returns {string} - Translated element template.
+ *
+ * @param {HTMLElement} elem
+ * @param {Function} translate
+ *
+ * @returns {String}
+ *   Translated element template.
  */
 function translateElemValue(elem, translate) {
     if (!elem.innerText) {
         return elem.innerHTML;
     }
-    const elemValue = elem.innerText.replace(Evaluator_1.Evaluator.templateSettings.interpolate, '').replace(/\s\s+/g, ' ').trim();
+    const elemValue = elem.innerText.replace(Evaluator_1.default.templateSettings.interpolate, '').replace(/\s\s+/g, ' ').trim();
     const translatedValue = translate(elemValue);
     if (elemValue !== translatedValue) {
         const links = elem.innerHTML.match(/<a[^>]*>(.*?)<\/a>/g);
@@ -1256,8 +1199,10 @@ function translateElemValue(elem, translate) {
 }
 /**
  * Helper function for 'translateHTMLTemplate'. Goes deep through html tag children and calls function to translate their text values.
- * @param {HTMLElement} tag - The tag to translate.
- * @param {Function} translate - The translation function.
+ *
+ * @param {HTMLElement} tag
+ * @param {Function} translate
+ *
  * @returns {void}
  */
 function translateDeepTag(tag, translate) {
@@ -1273,9 +1218,12 @@ function translateDeepTag(tag, translate) {
 }
 /**
  * Translates text values in html template.
- * @param {string} template - The template to translate.
- * @param {Function} translate - The translation function.
- * @returns {string} - Html template with translated values.
+ *
+ * @param {String} template
+ * @param {Function} translate
+ *
+ * @returns {String}
+ *   Html template with translated values.
  */
 function translateHTMLTemplate(template, translate) {
     const isHTML = /<[^>]*>/.test(template);
@@ -1293,9 +1241,9 @@ function translateHTMLTemplate(template, translate) {
 exports.translateHTMLTemplate = translateHTMLTemplate;
 /**
  * Sanitize an html string.
- * @param {string} string - The string to sanitize.
- * @param {any} options - The options to use for sanitization.
- * @returns {string} - The sanitized html string.
+ *
+ * @param string
+ * @returns {*}
  */
 function sanitize(string, options) {
     if (typeof dompurify_1.default.sanitize !== 'function') {
@@ -1344,18 +1292,11 @@ function sanitize(string, options) {
 exports.sanitize = sanitize;
 /**
  * Fast cloneDeep for JSON objects only.
- * @param {any} obj - The object to perform a fast clone deep against.
- * @returns {any} - The cloned object.
  */
 function fastCloneDeep(obj) {
     return obj ? JSON.parse(JSON.stringify(obj)) : obj;
 }
 exports.fastCloneDeep = fastCloneDeep;
-/**
- * Returns if the component is an input component.
- * @param {import('@formio/core').Component} componentJson - The JSON of a component.
- * @returns {bool} - TRUE if the component is an input component; FALSE otherwise.
- */
 function isInputComponent(componentJson) {
     if (componentJson.input === false || componentJson.input === true) {
         return componentJson.input;
@@ -1376,11 +1317,6 @@ function isInputComponent(componentJson) {
     }
 }
 exports.isInputComponent = isInputComponent;
-/**
- * Takes a component path, and returns a component path array.
- * @param {string} pathStr - The path string to convert to an array.
- * @returns {Arryay<number>} - The array of paths.
- */
 function getArrayFromComponentPath(pathStr) {
     if (!pathStr || !lodash_1.default.isString(pathStr)) {
         if (!lodash_1.default.isArray(pathStr)) {
@@ -1395,12 +1331,6 @@ function getArrayFromComponentPath(pathStr) {
         .map(part => lodash_1.default.defaultTo(lodash_1.default.toNumber(part), part));
 }
 exports.getArrayFromComponentPath = getArrayFromComponentPath;
-/**
- * Returns true if the component is a child of the parent.
- * @param {any} child - The child component to check.
- * @param {any} parent - The parent component to check.
- * @returns {boolean} - TRUE if the child is a child of the parent; FALSE otherwise.
- */
 function isChildOf(child, parent) {
     while (child && child.parent) {
         if (child.parent === parent) {
@@ -1411,11 +1341,6 @@ function isChildOf(child, parent) {
     return false;
 }
 exports.isChildOf = isChildOf;
-/**
- * Takes an array of component path indexes, and returns a string version of that array.
- * @param {Array<number>} path - The path array to convert to a string.
- * @returns {string} - The string version of the path.
- */
 function getStringFromComponentPath(path) {
     if (!lodash_1.default.isArray(path)) {
         return path;
@@ -1432,22 +1357,17 @@ function getStringFromComponentPath(path) {
     return strPath;
 }
 exports.getStringFromComponentPath = getStringFromComponentPath;
-/**
- * Takes a number and rounds it to the provided precision amount.
- * @param {number} number - The number to round.
- * @param {number} precision - The precision to round the number to.
- * @returns {string} - The rounded number.
- */
 function round(number, precision) {
     if (lodash_1.default.isNumber(number)) {
         return number.toFixed(precision);
     }
-    return number.toString();
+    return number;
 }
 exports.round = round;
 /**
  * Check for Internet Explorer browser version
- * @returns {(number|null)} - The IE browser version or null if not IE
+ *
+ * @return {(number|null)}
  */
 function getIEBrowserVersion() {
     const { ie, version } = getBrowserInfo();
@@ -1456,7 +1376,8 @@ function getIEBrowserVersion() {
 exports.getIEBrowserVersion = getIEBrowserVersion;
 /**
  * Get browser name and version (modified from 'jquery-browser-plugin')
- * @returns {object} -- {{browser name, version, isWebkit?}}
+ *
+ * @return {Object} -- {{browser name, version, isWebkit?}}
  * Possible browser names: chrome, safari, ie, edge, opera, mozilla, yabrowser
  */
 function getBrowserInfo() {
@@ -1505,20 +1426,13 @@ function getBrowserInfo() {
     return browser;
 }
 exports.getBrowserInfo = getBrowserInfo;
-/**
- * Takes a component path, which may include array indicies (i.e. [0][1]), and returns the compoennt path without the indicies.
- * @param {string} path - The path to remove the indicies from.
- * @returns {string} - The path without the indicies.
- */
 function getComponentPathWithoutIndicies(path = '') {
     return path.replace(/\[\d+\]/, '');
 }
 exports.getComponentPathWithoutIndicies = getComponentPathWithoutIndicies;
 /**
  * Returns a path to the component which based on its schema
- * @param {import('@formio/core').Component} component - Component containing link to its parent's schema in the 'parent' property
- * @param {string} path - Path to the component
- * @returns {string} - Path to the component
+ * @param {*} component is a component's schema containing link to its parent's schema in the 'parent' property
  */
 function getComponentPath(component, path = '') {
     var _a;
@@ -1531,8 +1445,8 @@ function getComponentPath(component, path = '') {
 exports.getComponentPath = getComponentPath;
 /**
  * Returns a parent component of the passed component instance skipping all the Layout components
- * @param {Component} componentInstance - The component to check for the parent.
- * @returns {Component|undefined} - The parent data component.
+ * @param {*} componentInstance
+ * @return {(Component|undefined)}
  */
 function getDataParentComponent(componentInstance) {
     if (!componentInstance) {
@@ -1549,8 +1463,8 @@ function getDataParentComponent(componentInstance) {
 exports.getDataParentComponent = getDataParentComponent;
 /**
  * Returns whether the value is a promise
- * @param {any} value - The value to check
- * @returns {boolean} - TRUE if the value is a promise; FALSE otherwise
+ * @param value
+ * @return {boolean}
  */
 function isPromise(value) {
     return value
@@ -1562,9 +1476,9 @@ exports.isPromise = isPromise;
 /**
  * Determines if the component has a scoping parent in tree (a component which scopes its children and manages its
  * changes by itself, e.g. EditGrid)
- * @param {Component} componentInstance - The component to check for the scoping parent.
- * @param {boolean} firstPass - Whether it is the first pass of the function
- * @returns {boolean|*} - TRUE if the component has a scoping parent; FALSE otherwise
+ * @param componentInstance
+ * @param firstPass
+ * @returns {boolean|boolean|*}
  */
 function isInsideScopingComponent(componentInstance, firstPass = true) {
     if (!firstPass && (componentInstance === null || componentInstance === void 0 ? void 0 : componentInstance.hasScopedChildren)) {
@@ -1580,11 +1494,6 @@ function isInsideScopingComponent(componentInstance, firstPass = true) {
     return false;
 }
 exports.isInsideScopingComponent = isInsideScopingComponent;
-/**
- * Returns all the focusable elements within the provided dom element.
- * @param {HTMLElement} element - The element to get the focusable elements from.
- * @returns {NodeList<HTMLElement>} - The focusable elements within the provided element.
- */
 function getFocusableElements(element) {
     const focusableSelector = `button:not([disabled]), input:not([disabled]), select:not([disabled]),
     textarea:not([disabled]), button:not([disabled]), [href]`;
@@ -1600,11 +1509,6 @@ exports.componentValueTypes = {
     date: 'date',
     any: 'any',
 };
-/**
- * Returns the saved types for the component
- * @param {import('@formio/core').Component} fullSchema - The component schema
- * @returns {Array<string>|null} - The saved types for the component
- */
 function getComponentSavedTypes(fullSchema) {
     const schema = fullSchema || {};
     if (schema.persistent !== true) {
@@ -1618,10 +1522,9 @@ function getComponentSavedTypes(fullSchema) {
 exports.getComponentSavedTypes = getComponentSavedTypes;
 /**
  * Interpolates @formio/core errors so that they are compatible with the renderer
- * @param {Component} component - The component to interpolate the errors for
- * @param {FieldError[]} errors - The errors to interpolate
- * @param {Function} interpolateFn - The interpolation function
- * @returns {[]} - The interpolated errors
+ * @param {FieldError[]} errors
+ * @param firstPass
+ * @returns {[]}
  */
 const interpolateErrors = (component, errors, interpolateFn) => {
     return errors.map((error) => {
@@ -1632,11 +1535,6 @@ const interpolateErrors = (component, errors, interpolateFn) => {
     });
 };
 exports.interpolateErrors = interpolateErrors;
-/**
- * Returns the template keys inside the template code.
- * @param {string} template - The template to get the keys from.
- * @returns {Array<string>} - The keys inside the template.
- */
 function getItemTemplateKeys(template) {
     const templateKeys = [];
     if (!template) {
@@ -1654,11 +1552,6 @@ function getItemTemplateKeys(template) {
     return templateKeys;
 }
 exports.getItemTemplateKeys = getItemTemplateKeys;
-/**
- * Returns if the component is a select resource with an object for its value.
- * @param {import('@formio/core').Component} comp - The component to check.
- * @returns {boolean} - TRUE if the component is a select resource with an object for its value; FALSE otherwise.
- */
 function isSelectResourceWithObjectValue(comp = {}) {
     const { reference, dataSrc, valueProperty } = comp;
     return reference || (dataSrc === 'resource' && (!valueProperty || valueProperty === 'data'));