@formio/js 5.0.0-dev.5633.8d2b30d → 5.0.0-dev.5633.fde3bc9

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 = __importDefault(require("./Evaluator"));
-exports.Evaluator = Evaluator_1.default;
+const Evaluator_1 = require("./Evaluator");
+Object.defineProperty(exports, "Evaluator", { enumerable: true, get: function () { return Evaluator_1.Evaluator; } });
 const conditionOperators_1 = __importDefault(require("./conditionOperators"));
 exports.ConditionOperators = conditionOperators_1.default;
-const interpolate = Evaluator_1.default.interpolate;
+const interpolate = Evaluator_1.Evaluator.interpolate;
 exports.interpolate = interpolate;
 const { fetch } = (0, fetch_ponyfill_1.default)({
     Promise: Promise
@@ -67,6 +67,10 @@ 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);
@@ -76,79 +80,30 @@ function setPathToComponentAndPerentSchema(component) {
 }
 /**
  * Evaluate a method.
- *
- * @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;
+ * @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);
 }
 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 style
- * @param prop
- * @return {number}
+ * @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.
  */
 function getPropertyValue(style, prop) {
     let value = style.getPropertyValue(prop);
@@ -158,9 +113,8 @@ function getPropertyValue(style, prop) {
 exports.getPropertyValue = getPropertyValue;
 /**
  * Get an elements bounding rectagle.
- *
- * @param element
- * @return {{x: string, y: string, width: string, height: string}}
+ * @param {HTMLElement} element - A DOM element to get the bounding rectangle for.
+ * @returns {{x: number, y: number, width: number, height: number}} - The bounding rectangle.
  */
 function getElementRect(element) {
     const style = window.getComputedStyle(element, null);
@@ -174,8 +128,8 @@ function getElementRect(element) {
 exports.getElementRect = getElementRect;
 /**
  * Get non HTMLElement property in the window object
- * @param {String} property
- * @return {any || undefined}
+ * @param {string} property - The window property to fetch the script plugin from.
+ * @returns {any | undefined} - The HTML Element property on the window object.
  */
 function getScriptPlugin(property) {
     const obj = window[property];
@@ -188,9 +142,8 @@ function getScriptPlugin(property) {
 exports.getScriptPlugin = getScriptPlugin;
 /**
  * Determines the boolean value of a setting.
- *
- * @param value
- * @return {boolean}
+ * @param {string|boolean} value - A string or boolean value to convert to boolean.
+ * @returns {boolean} - The boolean value of the setting.
  */
 function boolValue(value) {
     if (lodash_1.default.isBoolean(value)) {
@@ -206,22 +159,18 @@ function boolValue(value) {
 exports.boolValue = boolValue;
 /**
  * Check to see if an ID is a mongoID.
- * @param text
- * @return {Array|{index: number, input: string}|Boolean|*}
+ * @param {string} text - The text to check if it is a mongoID.
+ * @returns {boolean} - TRUE if the text is a mongoID; FALSE otherwise.
  */
 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 {Object} component
- *   The component to check for the calculated value.
- * @param {Object} submission
- *   A submission object.
- * @param data
- *   The full submission 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.
  */
 function checkCalculated(component, submission, rowData) {
     // Process calculated value stuff if present.
@@ -238,13 +187,12 @@ function checkCalculated(component, submission, rowData) {
 exports.checkCalculated = checkCalculated;
 /**
  * Check if a simple conditional evaluates to true.
- *
- * @param condition
- * @param condition
- * @param row
- * @param data
- * @param instance
- * @returns {boolean}
+ * @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.
  */
 function checkSimpleConditional(component, condition, row, data, instance) {
     if (condition.when) {
@@ -289,6 +237,13 @@ 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) {
@@ -306,12 +261,15 @@ function getComponentActualValue(compPath, data, row) {
 exports.getComponentActualValue = getComponentActualValue;
 /**
  * Check custom javascript conditional.
- *
- * @param component
- * @param custom
- * @param row
- * @param data
- * @returns {*}
+ * @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.
  */
 function checkCustomConditional(component, custom, row, data, form, variable, onError, instance) {
     if (typeof custom === 'string') {
@@ -326,6 +284,16 @@ 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, {
@@ -341,6 +309,14 @@ 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;
@@ -363,15 +339,12 @@ function getRow(component, row, instance, conditional) {
 }
 /**
  * Checks the conditions for a provided component and data.
- *
- * @param component
- *   The component to check for the condition.
- * @param row
- *   The data within a row
- * @param data
- *   The full submission data.
- *
- * @returns {boolean}
+ * @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.
  */
 function checkCondition(component, row, data, form, instance) {
     const { customConditional, conditional } = component;
@@ -391,12 +364,13 @@ function checkCondition(component, row, data, form, instance) {
 exports.checkCondition = checkCondition;
 /**
  * Test a trigger on a component.
- *
- * @param component
- * @param action
- * @param data
- * @param row
- * @returns {mixed}
+ * @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.
  */
 function checkTrigger(component, trigger, row, data, form, instance) {
     // If trigger is empty, don't fire it
@@ -416,6 +390,16 @@ 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) {
@@ -438,7 +422,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.default.interpolate(textValue, evalData);
+                : Evaluator_1.Evaluator.interpolate(textValue, evalData);
             if (newValue !== currentValue) {
                 lodash_1.default.set(component, property, newValue);
             }
@@ -450,8 +434,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
- * @returns {string}
+ * @param {string} str - The string to remove HTML tags from.
+ * @returns {string} - The string without HTML tags.
  */
 function removeHTML(str) {
     const doc = new window.DOMParser().parseFromString(str, 'text/html');
@@ -460,8 +444,8 @@ function removeHTML(str) {
 exports.removeHTML = removeHTML;
 /**
  * Unescape HTML characters like &lt, &gt, &amp and etc.
- * @param str
- * @returns {string}
+ * @param {string} str - The string to unescape.
+ * @returns {string} - The unescaped string.
  */
 function unescapeHTML(str) {
     if (typeof window === 'undefined' || !('DOMParser' in window)) {
@@ -474,9 +458,9 @@ function unescapeHTML(str) {
 exports.unescapeHTML = unescapeHTML;
 /**
  * Make HTML element from string
- * @param str
- * @param selector
- * @returns {HTMLElement}
+ * @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.
  */
 function convertStringToHTMLElement(str, selector) {
     const doc = new window.DOMParser().parseFromString(str, 'text/html');
@@ -485,10 +469,10 @@ function convertStringToHTMLElement(str, selector) {
 exports.convertStringToHTMLElement = convertStringToHTMLElement;
 /**
  * Make a filename guaranteed to be unique.
- * @param name
- * @param template
- * @param evalContext
- * @returns {string}
+ * @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.
  */
 function uniqueName(name, template, evalContext) {
     template = template || '{{fileName}}-{{guid}}';
@@ -508,10 +492,14 @@ 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.default.interpolate(template, evalContext)}${extension}`.replace(/[^0-9a-zA-Z.\-_ ]/g, '-');
+    const uniqueName = `${Evaluator_1.Evaluator.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;
@@ -524,9 +512,8 @@ function guid() {
 exports.guid = guid;
 /**
  * Return a translated date setting.
- *
- * @param date
- * @return {(null|Date)}
+ * @param {string|Date} date - The date to translate.
+ * @returns {(null|Date)} - The translated date.
  */
 function getDateSetting(date) {
     if (lodash_1.default.isNil(date) || lodash_1.default.isNaN(date) || date === '') {
@@ -544,7 +531,7 @@ function getDateSetting(date) {
     }
     dateSetting = null;
     try {
-        const value = Evaluator_1.default.evaluator(`return ${date};`, 'moment')(moment_timezone_1.default);
+        const value = Evaluator_1.Evaluator.evaluator(`return ${date};`, 'moment')(moment_timezone_1.default);
         if (typeof value === 'string') {
             dateSetting = (0, moment_timezone_1.default)(value);
         }
@@ -568,14 +555,18 @@ 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.
- *
- * @return {string}
+ * @returns {string} - The current timezone.
  */
 function currentTimezone() {
     if (moment_timezone_1.default.currentTimezone) {
@@ -587,10 +578,9 @@ function currentTimezone() {
 exports.currentTimezone = currentTimezone;
 /**
  * Get an offset date provided a date object and timezone object.
- *
- * @param date
- * @param timezone
- * @return {Date}
+ * @param {Date} date - The date to offset.
+ * @param {string} timezone - The timezone to offset the date to.
+ * @returns {Date} - The offset date.
  */
 function offsetDate(date, timezone) {
     if (timezone === 'UTC') {
@@ -608,8 +598,7 @@ function offsetDate(date, timezone) {
 exports.offsetDate = offsetDate;
 /**
  * Returns if the zones are loaded.
- *
- * @return {boolean}
+ * @returns {boolean} - TRUE if the zones are loaded; FALSE otherwise.
  */
 function zonesLoaded() {
     return moment_timezone_1.default.zonesLoaded;
@@ -617,9 +606,8 @@ function zonesLoaded() {
 exports.zonesLoaded = zonesLoaded;
 /**
  * Returns if we should load the zones.
- *
- * @param timezone
- * @return {boolean}
+ * @param {string} timezone - The timezone to check if we should load the zones.
+ * @returns {boolean} - TRUE if we should load the zones; FALSE otherwise.
  */
 function shouldLoadZones(timezone) {
     if (timezone === currentTimezone() || timezone === 'UTC') {
@@ -630,8 +618,9 @@ function shouldLoadZones(timezone) {
 exports.shouldLoadZones = shouldLoadZones;
 /**
  * Externally load the timezone data.
- *
- * @return {Promise<any> | *}
+ * @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.
  */
 function loadZones(url, timezone) {
     if (timezone && !shouldLoadZones(timezone)) {
@@ -656,11 +645,10 @@ function loadZones(url, timezone) {
 exports.loadZones = loadZones;
 /**
  * Get the moment date object for translating dates with timezones.
- *
- * @param value
- * @param format
- * @param timezone
- * @return {*}
+ * @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.
  */
 function momentDate(value, format, timezone) {
     const momentDate = (0, moment_timezone_1.default)(value);
@@ -678,11 +666,12 @@ function momentDate(value, format, timezone) {
 exports.momentDate = momentDate;
 /**
  * Format a date provided a value, format, and timezone object.
- *
- * @param value
- * @param format
- * @param timezone
- * @return {string}
+ * @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.
  */
 function formatDate(timezonesUrl, value, format, timezone, flatPickrInputFormat) {
     const momentDate = (0, moment_timezone_1.default)(value, flatPickrInputFormat || undefined);
@@ -716,12 +705,12 @@ function formatDate(timezonesUrl, value, format, timezone, flatPickrInputFormat)
 exports.formatDate = formatDate;
 /**
  * Pass a format function to format within a timezone.
- *
- * @param formatFn
- * @param date
- * @param format
- * @param timezone
- * @return {string}
+ * @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.
  */
 function formatOffset(timezonesUrl, formatFn, date, format, timezone) {
     if (timezone === currentTimezone()) {
@@ -741,6 +730,11 @@ 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;
@@ -752,8 +746,8 @@ function getLocaleDateFormatInfo(locale) {
 exports.getLocaleDateFormatInfo = getLocaleDateFormatInfo;
 /**
  * Convert the format from the angular-datepicker module to flatpickr format.
- * @param format
- * @return {string}
+ * @param {string} format - The format to convert.
+ * @returns {string} - The converted format.
  */
 function convertFormatToFlatpickr(format) {
     return format
@@ -784,8 +778,8 @@ function convertFormatToFlatpickr(format) {
 exports.convertFormatToFlatpickr = convertFormatToFlatpickr;
 /**
  * Convert the format from the angular-datepicker module to moment format.
- * @param format
- * @return {string}
+ * @param {string} format - The format to convert.
+ * @returns {string} - The converted format.
  */
 function convertFormatToMoment(format) {
     return format
@@ -801,6 +795,11 @@ 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.
@@ -860,6 +859,13 @@ 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;
@@ -876,6 +882,12 @@ 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;
@@ -894,6 +906,11 @@ 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(/..(.)...(.)../);
@@ -909,6 +926,12 @@ 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');
@@ -925,6 +948,15 @@ 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)}`;
@@ -947,10 +979,9 @@ function getCurrencyAffixes({ currency, decimalLimit, decimalSeparator, lang, })
 exports.getCurrencyAffixes = getCurrencyAffixes;
 /**
  * Fetch the field data provided a component.
- *
- * @param data
- * @param component
- * @return {*}
+ * @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.
  */
 function fieldData(data, component) {
     if (!data) {
@@ -997,16 +1028,23 @@ function fieldData(data, component) {
 exports.fieldData = fieldData;
 /**
  * Delays function execution with possibility to execute function synchronously or cancel it.
- *
- * @param fn Function to delay
- * @param delay Delay time
- * @return {*}
+ * @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
  */
 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);
@@ -1018,11 +1056,9 @@ 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) {
@@ -1036,10 +1072,9 @@ function iterateKey(key) {
 exports.iterateKey = iterateKey;
 /**
  * Determines a unique key within a map provided the base key.
- *
- * @param map
- * @param base
- * @return {*}
+ * @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.
  */
 function uniqueKey(map, base) {
     let newKey = base;
@@ -1051,8 +1086,9 @@ function uniqueKey(map, base) {
 exports.uniqueKey = uniqueKey;
 /**
  * Determines the major version number of bootstrap.
- *
- * @return {number}
+ * @param {object} options - The options to check for bootstrap version.
+ * @param {string} options.bootstrap - The bootstrap version to use.
+ * @returns {number} - The bootstrap version.
  */
 function bootstrapVersion(options) {
     if (options.bootstrap) {
@@ -1070,9 +1106,8 @@ exports.bootstrapVersion = bootstrapVersion;
 /**
  * Retrun provided argument.
  * If argument is a function, returns the result of a function call.
- * @param {*} e;
- *
- * @return {*}
+ * @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.
  */
 function unfold(e) {
     if (typeof e === 'function') {
@@ -1083,27 +1118,32 @@ function unfold(e) {
 exports.unfold = unfold;
 /**
  * Map values through unfold and return first non-nil value.
- * @param {Array<T>} collection;
- *
- * @return {T}
+ * @param {Array<T>} collection - The collection to map through unfold.;
+ * @returns {T} - The first non-nil value.
  */
 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.
- * @return {Functions[]} -- [get, toggle];
+ * @returns {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;
@@ -1112,6 +1152,14 @@ 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;
@@ -1132,6 +1180,13 @@ 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) => {
@@ -1146,6 +1201,11 @@ 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) => {
@@ -1163,18 +1223,15 @@ 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
- * @param {Function} translate
- *
- * @returns {String}
- *   Translated element template.
+ * @param {HTMLElement} elem - The element to translate.
+ * @param {Function} translate - The translation function.
+ * @returns {string} - Translated element template.
  */
 function translateElemValue(elem, translate) {
     if (!elem.innerText) {
         return elem.innerHTML;
     }
-    const elemValue = elem.innerText.replace(Evaluator_1.default.templateSettings.interpolate, '').replace(/\s\s+/g, ' ').trim();
+    const elemValue = elem.innerText.replace(Evaluator_1.Evaluator.templateSettings.interpolate, '').replace(/\s\s+/g, ' ').trim();
     const translatedValue = translate(elemValue);
     if (elemValue !== translatedValue) {
         const links = elem.innerHTML.match(/<a[^>]*>(.*?)<\/a>/g);
@@ -1199,10 +1256,8 @@ 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
- * @param {Function} translate
- *
+ * @param {HTMLElement} tag - The tag to translate.
+ * @param {Function} translate - The translation function.
  * @returns {void}
  */
 function translateDeepTag(tag, translate) {
@@ -1218,12 +1273,9 @@ function translateDeepTag(tag, translate) {
 }
 /**
  * Translates text values in html template.
- *
- * @param {String} template
- * @param {Function} translate
- *
- * @returns {String}
- *   Html template with translated values.
+ * @param {string} template - The template to translate.
+ * @param {Function} translate - The translation function.
+ * @returns {string} - Html template with translated values.
  */
 function translateHTMLTemplate(template, translate) {
     const isHTML = /<[^>]*>/.test(template);
@@ -1241,9 +1293,9 @@ function translateHTMLTemplate(template, translate) {
 exports.translateHTMLTemplate = translateHTMLTemplate;
 /**
  * Sanitize an html string.
- *
- * @param string
- * @returns {*}
+ * @param {string} string - The string to sanitize.
+ * @param {any} options - The options to use for sanitization.
+ * @returns {string} - The sanitized html string.
  */
 function sanitize(string, options) {
     if (typeof dompurify_1.default.sanitize !== 'function') {
@@ -1292,11 +1344,18 @@ 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;
@@ -1317,6 +1376,11 @@ 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)) {
@@ -1331,6 +1395,12 @@ 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) {
@@ -1341,6 +1411,11 @@ 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;
@@ -1357,17 +1432,22 @@ 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;
+    return number.toString();
 }
 exports.round = round;
 /**
  * Check for Internet Explorer browser version
- *
- * @return {(number|null)}
+ * @returns {(number|null)} - The IE browser version or null if not IE
  */
 function getIEBrowserVersion() {
     const { ie, version } = getBrowserInfo();
@@ -1376,8 +1456,7 @@ function getIEBrowserVersion() {
 exports.getIEBrowserVersion = getIEBrowserVersion;
 /**
  * Get browser name and version (modified from 'jquery-browser-plugin')
- *
- * @return {Object} -- {{browser name, version, isWebkit?}}
+ * @returns {object} -- {{browser name, version, isWebkit?}}
  * Possible browser names: chrome, safari, ie, edge, opera, mozilla, yabrowser
  */
 function getBrowserInfo() {
@@ -1426,13 +1505,20 @@ 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 {*} component is a component's schema containing link to its parent's schema in the 'parent' property
+ * @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
  */
 function getComponentPath(component, path = '') {
     var _a;
@@ -1445,8 +1531,8 @@ function getComponentPath(component, path = '') {
 exports.getComponentPath = getComponentPath;
 /**
  * Returns a parent component of the passed component instance skipping all the Layout components
- * @param {*} componentInstance
- * @return {(Component|undefined)}
+ * @param {Component} componentInstance - The component to check for the parent.
+ * @returns {Component|undefined} - The parent data component.
  */
 function getDataParentComponent(componentInstance) {
     if (!componentInstance) {
@@ -1463,8 +1549,8 @@ function getDataParentComponent(componentInstance) {
 exports.getDataParentComponent = getDataParentComponent;
 /**
  * Returns whether the value is a promise
- * @param value
- * @return {boolean}
+ * @param {any} value - The value to check
+ * @returns {boolean} - TRUE if the value is a promise; FALSE otherwise
  */
 function isPromise(value) {
     return value
@@ -1476,9 +1562,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 componentInstance
- * @param firstPass
- * @returns {boolean|boolean|*}
+ * @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
  */
 function isInsideScopingComponent(componentInstance, firstPass = true) {
     if (!firstPass && (componentInstance === null || componentInstance === void 0 ? void 0 : componentInstance.hasScopedChildren)) {
@@ -1494,6 +1580,11 @@ 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]`;
@@ -1509,6 +1600,11 @@ 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) {
@@ -1522,9 +1618,10 @@ function getComponentSavedTypes(fullSchema) {
 exports.getComponentSavedTypes = getComponentSavedTypes;
 /**
  * Interpolates @formio/core errors so that they are compatible with the renderer
- * @param {FieldError[]} errors
- * @param firstPass
- * @returns {[]}
+ * @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
  */
 const interpolateErrors = (component, errors, interpolateFn) => {
     return errors.map((error) => {
@@ -1535,6 +1632,11 @@ 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) {
@@ -1552,6 +1654,11 @@ 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'));