@oat-sa/tao-core-ui 1.64.2 → 1.65.0

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

@@ -75,101 +75,101 @@ 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);
@@ -190,11 +190,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]) {
@@ -202,20 +202,20 @@ 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;
@@ -223,10 +223,10 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
         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) {
           if (!previous || tokensHelper.isModifier(previous.type) || previous.token === 'LPAR' || previous.token === 'EXP10') {
@@ -249,8 +249,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 = {
             type: token.type,
@@ -310,19 +310,19 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
       }
     };
 
-    /**
-     * 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() {
         next = term;
@@ -364,10 +364,10 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
       }
     }
 
-    /**
-     * 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
      */
     function exponentOnTheRight(index, terms) {
       var last = terms.length - 1;
@@ -377,18 +377,18 @@ define(['lodash', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/to
       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.
        */
       function previousTerm() {
         term = previous;

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

@@ -52,22 +52,22 @@ define(['i18n', 'handlebars', 'lib/handlebars/helpers'], function (__, Handlebar
       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,27 +3,27 @@ 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) {
       return pluginFactory(provider, _.defaults({

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

@@ -3,36 +3,36 @@ 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 = {
       // Digits definition