@oat-sa/tao-core-ui 1.54.2 → 1.55.0

package/dist/maths/calculator/core/expression.js

@@ -23,24 +23,24 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
     hb.registerHelper('__', function (key) {
       return __(key);
     });
-    /**
-     * Register dompurify helper
-     *
-     * https://github.com/cure53/DOMPurify
-     * with config SAFE_FOR_TEMPLATES: true
-     * to make output safe for template systems
+    /**
+     * Register dompurify helper
+     *
+     * https://github.com/cure53/DOMPurify
+     * with config SAFE_FOR_TEMPLATES: true
+     * to make output safe for template systems
      */
 
     hb.registerHelper('dompurify', function (context) {
       return DOMPurify.sanitize(context);
     });
-    /**
-     * Register join helper
-     *
-     * Example :
-     * var values = {a:v1, b:v2, c:v3};
-     * Using {{{join attributes '=' ' ' '"'}}} will return : a="v1" b="v2" c="v3"
-     * Using {{{join values null ' or ' '*'}}} will return : *v1* or *v2* or *v3*
+    /**
+     * Register join helper
+     *
+     * Example :
+     * var values = {a:v1, b:v2, c:v3};
+     * Using {{{join attributes '=' ' ' '"'}}} will return : a="v1" b="v2" c="v3"
+     * Using {{{join values null ' or ' '*'}}} will return : *v1* or *v2* or *v3*
      */
 
     hb.registerHelper('join', function (arr, keyValueGlue, fragmentGlue, wrapper) {
@@ -177,103 +177,103 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
     return (asString || true) ? html : $(html);
   }
 
-  /**
-   * This program is free software; you can redistribute it and/or
-   * modify it under the terms of the GNU General Public License
-   * as published by the Free Software Foundation; under version 2
-   * of the License (non-upgradable).
-   *
-   * This program is distributed in the hope that it will be useful,
-   * but WITHOUT ANY WARRANTY; without even the implied warranty of
-   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-   * GNU General Public License for more details.
-   *
-   * You should have received a copy of the GNU General Public License
-   * along with this program; if not, write to the Free Software
-   * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
-   *
-   * Copyright (c) 2019 Open Assessment Technologies SA ;
+  /**
+   * This program is free software; you can redistribute it and/or
+   * modify it under the terms of the GNU General Public License
+   * as published by the Free Software Foundation; under version 2
+   * of the License (non-upgradable).
+   *
+   * This program is distributed in the hope that it will be useful,
+   * but WITHOUT ANY WARRANTY; without even the implied warranty of
+   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   * GNU General Public License for more details.
+   *
+   * You should have received a copy of the GNU General Public License
+   * along with this program; if not, write to the Free Software
+   * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+   *
+   * Copyright (c) 2019 Open Assessment Technologies SA ;
    */
-  /**
-   * @typedef {term} renderTerm - Represents a renderable tokenizable term
-   * @property {Array} startExponent - List of exponent starts (will produce exponent notation for the term)
-   * @property {Array} endExponent - List of exponent ends (will finish exponent notation for the term)
-   * @property {Boolean} prefixed - Tells if the term is prefixed (i.e. function treated as binary operator)
-   * @property {Boolean} elide - Allows to hide the term when operands exist on each side
+  /**
+   * @typedef {term} renderTerm - Represents a renderable tokenizable term
+   * @property {Array} startExponent - List of exponent starts (will produce exponent notation for the term)
+   * @property {Array} endExponent - List of exponent ends (will finish exponent notation for the term)
+   * @property {Boolean} prefixed - Tells if the term is prefixed (i.e. function treated as binary operator)
+   * @property {Boolean} elide - Allows to hide the term when operands exist on each side
    */
 
-  /**
-   * Name of the variable that contains the last result
-   * @type {String}
+  /**
+   * Name of the variable that contains the last result
+   * @type {String}
    */
 
   var lastResultVariableName = registeredTerms.ANS.value;
-  /**
-   * Regex that matches the prefixed function operators
-   * @type {RegExp}
+  /**
+   * Regex that matches the prefixed function operators
+   * @type {RegExp}
    */
 
   var rePrefixedTerm = /^@[a-zA-Z_]\w*$/;
-  /**
-   * Regex that matches the usual error tokens in a result
-   * @type {RegExp}
+  /**
+   * Regex that matches the usual error tokens in a result
+   * @type {RegExp}
    */
 
   var reErrorValue = /(NaN|[+-]?Infinity)/;
-  /**
-   * Regex that matches the last result variable
-   * @type {RegExp}
+  /**
+   * Regex that matches the last result variable
+   * @type {RegExp}
    */
 
   var reAnsVar = new RegExp('\\b' + lastResultVariableName + '\\b', 'g');
-  /**
-   * List of tokens representing sign or sum
-   * @type {String[]}
+  /**
+   * List of tokens representing sign or sum
+   * @type {String[]}
    */
 
   var signOperators = ['NEG', 'POS', 'SUB', 'ADD'];
-  /**
-   * List of tokens representing sub exponent parts to continue
-   * @type {String[]}
+  /**
+   * List of tokens representing sub exponent parts to continue
+   * @type {String[]}
    */
 
   var continueExponent = ['POW', 'NTHRT'];
-  /**
-   * Default number of significant digits used to round displayed variables
-   * @type {Number}
+  /**
+   * Default number of significant digits used to round displayed variables
+   * @type {Number}
    */
 
   var defaultDecimalDigits = 5;
-  /**
-   * List of helpers that apply on expression
-   * @type {Object}
+  /**
+   * List of helpers that apply on expression
+   * @type {Object}
    */
 
   var expressionHelper = {
-    /**
-     * Checks if an expression contains an error token
-     * @param {String|Number|Object} expression
-     * @returns {Boolean}
+    /**
+     * Checks if an expression contains an error token
+     * @param {String|Number|Object} expression
+     * @returns {Boolean}
      */
     containsError: function containsError(expression) {
       return reErrorValue.test(tokensHelper.stringValue(expression));
     },
 
-    /**
-     * Replace the last result variable by a particular value in an expression
-     * @param {String|Number|Object} expression
-     * @param {String|Number|Object} value
-     * @returns {String}
+    /**
+     * Replace the last result variable by a particular value in an expression
+     * @param {String|Number|Object} expression
+     * @param {String|Number|Object} value
+     * @returns {String}
      */
     replaceLastResult: function replaceLastResult(expression, value) {
       return tokensHelper.stringValue(expression).replace(reAnsVar, tokensHelper.stringValue(value || '0'));
     },
 
-    /**
-     * Rounds the value of a variable
-     * @param {Object} variable
-     * @param {Number} [decimalDigits=5]
-     * @returns {String}
+    /**
+     * Rounds the value of a variable
+     * @param {Object} variable
+     * @param {Number} [decimalDigits=5]
+     * @returns {String}
      */
     roundVariable: function roundVariable(variable, decimalDigits) {
       var resultString = tokensHelper.stringValue(variable);
@@ -298,11 +298,11 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
       return resultString;
     },
 
-    /**
-     * Rounds the value of the last result variable
-     * @param {Object} variables
-     * @param {Number} [decimalDigits=5]
-     * @returns {Object}
+    /**
+     * Rounds the value of the last result variable
+     * @param {Object} variables
+     * @param {Number} [decimalDigits=5]
+     * @returns {Object}
      */
     roundLastResultVariable: function roundLastResultVariable(variables, decimalDigits) {
       if (variables && 'undefined' !== typeof variables[lastResultVariableName]) {
@@ -312,31 +312,31 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
       return variables;
     },
 
-    /**
-     * Replace sign operators by a proper symbol
-     * @param {String|Number|Object} expression
-     * @returns {String}
+    /**
+     * Replace sign operators by a proper symbol
+     * @param {String|Number|Object} expression
+     * @returns {String}
      */
     renderSign: function renderSign(expression) {
       return tokensHelper.stringValue(expression).replace(registeredTerms.SUB.value, registeredTerms.NEG.label).replace(registeredTerms.ADD.value, registeredTerms.POS.label);
     },
 
-    /**
-     * Renders an expression into a HTML string, using the display label of each extracted token .
-     * @param {String|Number|Object|token[]} expression
-     * @param {Object} [variables]
-     * @param {calculatorTokenizer} [tokenizer]
-     * @returns {String}
+    /**
+     * Renders an expression into a HTML string, using the display label of each extracted token .
+     * @param {String|Number|Object|token[]} expression
+     * @param {Object} [variables]
+     * @param {calculatorTokenizer} [tokenizer]
+     * @returns {String}
      */
     render: function render(expression, variables, tokenizer) {
       var tokens = expression;
       var exponents = [];
       var terms = [];
       var previous;
-      /**
-       * Transform an operator to a sign
-       * @param {renderTerm} term
-       * @param {String} token
+      /**
+       * Transform an operator to a sign
+       * @param {renderTerm} term
+       * @param {String} token
        */
 
       function toSignOperator(term, token) {
@@ -360,8 +360,8 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
 
       _.forEach(tokens, function (token, index) {
         var registeredTerm = registeredTerms[token.type];
-        /**
-         * @type {renderTerm}
+        /**
+         * @type {renderTerm}
          */
 
         var term = {
@@ -425,19 +425,19 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
       return termsTpl(terms);
     }
   };
-  /**
-   * Search for the full operand on the left, then tag the edges with exponent flags
-   * @param {Number} index
-   * @param {renderTerm[]} terms
+  /**
+   * Search for the full operand on the left, then tag the edges with exponent flags
+   * @param {Number} index
+   * @param {renderTerm[]} terms
    */
 
   function exponentOnTheLeft(index, terms) {
     var parenthesis = 0;
     var next = terms[index];
     var term = terms[--index];
-    /**
-     * Simply moves the cursor to the next term to examine.
-     * Here the move is made from the right to the left.
+    /**
+     * Simply moves the cursor to the next term to examine.
+     * Here the move is made from the right to the left.
      */
 
     function nextTerm() {
@@ -484,10 +484,10 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
       term.startExponent.push(term.startExponent.length);
     }
   }
-  /**
-   * Search for the full operand on the right, then tag the edges with exponent flags
-   * @param {Number} index
-   * @param {renderTerm[]} terms
+  /**
+   * Search for the full operand on the right, then tag the edges with exponent flags
+   * @param {Number} index
+   * @param {renderTerm[]} terms
    */
 
 
@@ -498,18 +498,18 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
     var previous = terms[index];
     var term = terms[++index];
     var shouldContinue;
-    /**
-     * Simply moves the cursor to the next term to examine.
-     * Here the move is made from the left to the right.
+    /**
+     * Simply moves the cursor to the next term to examine.
+     * Here the move is made from the left to the right.
      */
 
     function nextTerm() {
       previous = term;
       term = terms[++index];
     }
-    /**
-     * Simply moves back the cursor to the previous term.
-     * Here the move is made from the right to the left.
+    /**
+     * Simply moves back the cursor to the previous term.
+     * Here the move is made from the right to the left.
      */
 
 

package/dist/maths/calculator/core/labels.js

@@ -20,24 +20,24 @@ define(['i18n', 'handlebars', 'lodash', 'lib/dompurify/purify'], function (__, H
     hb.registerHelper('__', function (key) {
       return __(key);
     });
-    /**
-     * Register dompurify helper
-     *
-     * https://github.com/cure53/DOMPurify
-     * with config SAFE_FOR_TEMPLATES: true
-     * to make output safe for template systems
+    /**
+     * Register dompurify helper
+     *
+     * https://github.com/cure53/DOMPurify
+     * with config SAFE_FOR_TEMPLATES: true
+     * to make output safe for template systems
      */
 
     hb.registerHelper('dompurify', function (context) {
       return DOMPurify.sanitize(context);
     });
-    /**
-     * Register join helper
-     *
-     * Example :
-     * var values = {a:v1, b:v2, c:v3};
-     * Using {{{join attributes '=' ' ' '"'}}} will return : a="v1" b="v2" c="v3"
-     * Using {{{join values null ' or ' '*'}}} will return : *v1* or *v2* or *v3*
+    /**
+     * Register join helper
+     *
+     * Example :
+     * var values = {a:v1, b:v2, c:v3};
+     * Using {{{join attributes '=' ' ' '"'}}} will return : a="v1" b="v2" c="v3"
+     * Using {{{join values null ' or ' '*'}}} will return : *v1* or *v2* or *v3*
      */
 
     hb.registerHelper('join', function (arr, keyValueGlue, fragmentGlue, wrapper) {
@@ -154,22 +154,22 @@ define(['i18n', 'handlebars', 'lodash', 'lib/dompurify/purify'], function (__, H
     return (asString || true) ? html : $(html);
   }
 
-  /**
-   * This program is free software; you can redistribute it and/or
-   * modify it under the terms of the GNU General Public License
-   * as published by the Free Software Foundation; under version 2
-   * of the License (non-upgradable).
-   *
-   * This program is distributed in the hope that it will be useful,
-   * but WITHOUT ANY WARRANTY; without even the implied warranty of
-   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-   * GNU General Public License for more details.
-   *
-   * You should have received a copy of the GNU General Public License
-   * along with this program; if not, write to the Free Software
-   * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
-   *
-   * Copyright (c) 2019 Open Assessment Technologies SA ;
+  /**
+   * This program is free software; you can redistribute it and/or
+   * modify it under the terms of the GNU General Public License
+   * as published by the Free Software Foundation; under version 2
+   * of the License (non-upgradable).
+   *
+   * This program is distributed in the hope that it will be useful,
+   * but WITHOUT ANY WARRANTY; without even the implied warranty of
+   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   * GNU General Public License for more details.
+   *
+   * You should have received a copy of the GNU General Public License
+   * along with this program; if not, write to the Free Software
+   * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+   *
+   * Copyright (c) 2019 Open Assessment Technologies SA ;
    */
   var labels = {
     // Digits definition

package/dist/maths/calculator/core/plugin.js

@@ -3,26 +3,26 @@ define(['lodash', 'core/plugin'], function (_, pluginFactory) { 'use strict';
     _ = _ && Object.prototype.hasOwnProperty.call(_, 'default') ? _['default'] : _;
     pluginFactory = pluginFactory && Object.prototype.hasOwnProperty.call(pluginFactory, 'default') ? pluginFactory['default'] : pluginFactory;
 
-    /**
-     * This program is free software; you can redistribute it and/or
-     * modify it under the terms of the GNU General Public License
-     * as published by the Free Software Foundation; under version 2
-     * of the License (non-upgradable).
-     *
-     * This program is distributed in the hope that it will be useful,
-     * but WITHOUT ANY WARRANTY; without even the implied warranty of
-     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-     * GNU General Public License for more details.
-     *
-     * You should have received a copy of the GNU General Public License
-     * along with this program; if not, write to the Free Software
-     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
-     *
-     * Copyright (c) 2018 Open Assessment Technologies SA ;
+    /**
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU General Public License
+     * as published by the Free Software Foundation; under version 2
+     * of the License (non-upgradable).
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+     *
+     * Copyright (c) 2018 Open Assessment Technologies SA ;
      */
-    /**
-     * A pluginFactory configured for the calculator
-     * @returns {Function} the preconfigured plugin factory
+    /**
+     * A pluginFactory configured for the calculator
+     * @returns {Function} the preconfigured plugin factory
      */
 
     function calculatorPluginFactory(provider, defaultConfig) {

package/dist/maths/calculator/core/terms.js

@@ -3,35 +3,35 @@ define(['i18n', 'ui/maths/calculator/core/labels'], function (__, labels) { 'use
     __ = __ && Object.prototype.hasOwnProperty.call(__, 'default') ? __['default'] : __;
     labels = labels && Object.prototype.hasOwnProperty.call(labels, 'default') ? labels['default'] : labels;
 
-    /**
-     * This program is free software; you can redistribute it and/or
-     * modify it under the terms of the GNU General Public License
-     * as published by the Free Software Foundation; under version 2
-     * of the License (non-upgradable).
-     *
-     * This program is distributed in the hope that it will be useful,
-     * but WITHOUT ANY WARRANTY; without even the implied warranty of
-     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-     * GNU General Public License for more details.
-     *
-     * You should have received a copy of the GNU General Public License
-     * along with this program; if not, write to the Free Software
-     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
-     *
-     * Copyright (c) 2018-2019 Open Assessment Technologies SA ;
+    /**
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU General Public License
+     * as published by the Free Software Foundation; under version 2
+     * of the License (non-upgradable).
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+     *
+     * Copyright (c) 2018-2019 Open Assessment Technologies SA ;
      */
-    /**
-     * @typedef {Object} term - Represents a tokenizable term
-     * @property {String} label - The displayable text
-     * @property {String} value - The related text that should be found in the expression
-     * @property {String} type - The type of token
-     * @property {String} description - A description of what represent the term
-     * @property {String|null} exponent - Some terms introduce exponent notation, and this property tells on which side
+    /**
+     * @typedef {Object} term - Represents a tokenizable term
+     * @property {String} label - The displayable text
+     * @property {String} value - The related text that should be found in the expression
+     * @property {String} type - The type of token
+     * @property {String} description - A description of what represent the term
+     * @property {String|null} exponent - Some terms introduce exponent notation, and this property tells on which side
      */
 
-    /**
-     * Defines the terms that can be tokenized from an expression
-     * @type {term[]}
+    /**
+     * Defines the terms that can be tokenized from an expression
+     * @type {term[]}
      */
 
     var terms = {