@oat-sa/tao-core-ui 1.58.1 → 1.58.2

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

@@ -1,956 +1,947 @@
 define(['lodash', 'i18n', 'core/collections', 'ui/component', 'ui/maths/calculator/core/areaBroker', 'ui/maths/calculator/core/terms', 'ui/maths/calculator/core/tokens', 'ui/maths/calculator/core/expression', 'ui/maths/calculator/core/tokenizer', 'util/mathsEvaluator', 'handlebars', 'lib/dompurify/purify'], function (_, __, collections, componentFactory, areaBrokerFactory, registeredTerms, tokensHelper, expressionHelper, tokenizerFactory, mathsEvaluatorFactory, Handlebars, DOMPurify) { 'use strict';
 
-    _ = _ && Object.prototype.hasOwnProperty.call(_, 'default') ? _['default'] : _;
-    __ = __ && Object.prototype.hasOwnProperty.call(__, 'default') ? __['default'] : __;
-    collections = collections && Object.prototype.hasOwnProperty.call(collections, 'default') ? collections['default'] : collections;
-    componentFactory = componentFactory && Object.prototype.hasOwnProperty.call(componentFactory, 'default') ? componentFactory['default'] : componentFactory;
-    areaBrokerFactory = areaBrokerFactory && Object.prototype.hasOwnProperty.call(areaBrokerFactory, 'default') ? areaBrokerFactory['default'] : areaBrokerFactory;
-    registeredTerms = registeredTerms && Object.prototype.hasOwnProperty.call(registeredTerms, 'default') ? registeredTerms['default'] : registeredTerms;
-    tokensHelper = tokensHelper && Object.prototype.hasOwnProperty.call(tokensHelper, 'default') ? tokensHelper['default'] : tokensHelper;
-    expressionHelper = expressionHelper && Object.prototype.hasOwnProperty.call(expressionHelper, 'default') ? expressionHelper['default'] : expressionHelper;
-    tokenizerFactory = tokenizerFactory && Object.prototype.hasOwnProperty.call(tokenizerFactory, 'default') ? tokenizerFactory['default'] : tokenizerFactory;
-    mathsEvaluatorFactory = mathsEvaluatorFactory && Object.prototype.hasOwnProperty.call(mathsEvaluatorFactory, 'default') ? mathsEvaluatorFactory['default'] : mathsEvaluatorFactory;
-    Handlebars = Handlebars && Object.prototype.hasOwnProperty.call(Handlebars, 'default') ? Handlebars['default'] : Handlebars;
-    DOMPurify = DOMPurify && Object.prototype.hasOwnProperty.call(DOMPurify, 'default') ? DOMPurify['default'] : DOMPurify;
-
+  _ = _ && Object.prototype.hasOwnProperty.call(_, 'default') ? _['default'] : _;
+  __ = __ && Object.prototype.hasOwnProperty.call(__, 'default') ? __['default'] : __;
+  collections = collections && Object.prototype.hasOwnProperty.call(collections, 'default') ? collections['default'] : collections;
+  componentFactory = componentFactory && Object.prototype.hasOwnProperty.call(componentFactory, 'default') ? componentFactory['default'] : componentFactory;
+  areaBrokerFactory = areaBrokerFactory && Object.prototype.hasOwnProperty.call(areaBrokerFactory, 'default') ? areaBrokerFactory['default'] : areaBrokerFactory;
+  registeredTerms = registeredTerms && Object.prototype.hasOwnProperty.call(registeredTerms, 'default') ? registeredTerms['default'] : registeredTerms;
+  tokensHelper = tokensHelper && Object.prototype.hasOwnProperty.call(tokensHelper, 'default') ? tokensHelper['default'] : tokensHelper;
+  expressionHelper = expressionHelper && Object.prototype.hasOwnProperty.call(expressionHelper, 'default') ? expressionHelper['default'] : expressionHelper;
+  tokenizerFactory = tokenizerFactory && Object.prototype.hasOwnProperty.call(tokenizerFactory, 'default') ? tokenizerFactory['default'] : tokenizerFactory;
+  mathsEvaluatorFactory = mathsEvaluatorFactory && Object.prototype.hasOwnProperty.call(mathsEvaluatorFactory, 'default') ? mathsEvaluatorFactory['default'] : mathsEvaluatorFactory;
+  Handlebars = Handlebars && Object.prototype.hasOwnProperty.call(Handlebars, 'default') ? Handlebars['default'] : Handlebars;
+  DOMPurify = DOMPurify && Object.prototype.hasOwnProperty.call(DOMPurify, 'default') ? DOMPurify['default'] : DOMPurify;
+
+  function _typeof(obj) {
+    "@babel/helpers - typeof";
+
+    return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) {
+      return typeof obj;
+    } : function (obj) {
+      return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj;
+    }, _typeof(obj);
+  }
+
+  function Helpers0 (hb) {
+    //register a i18n helper
+    hb.registerHelper('__', function (key) {
+      return __(key);
+    });
     /**
-     * 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) 2013-2019 (original work) Open Assessment Technologies SA (under the project TAO-PRODUCT);
-     *
+     * Register dompurify helper
      *
+     * https://github.com/cure53/DOMPurify
+     * with config SAFE_FOR_TEMPLATES: true
+     * to make output safe for template systems
      */
-    function Helpers0 (hb) {
-      //register a i18n helper
-      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
-       */
-
-      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*
-       */
-
-      hb.registerHelper('join', function (arr, keyValueGlue, fragmentGlue, wrapper) {
-        var fragments = [];
-        keyValueGlue = typeof keyValueGlue === 'string' ? keyValueGlue : undefined;
-        fragmentGlue = typeof fragmentGlue === 'string' ? fragmentGlue : ' ';
-        wrapper = typeof wrapper === 'string' ? wrapper : '"';
-
-        _.forIn(arr, function (value, key) {
-          var fragment = '';
-
-          if (value !== null || value !== undefined) {
-            if (typeof value === 'boolean') {
-              value = value ? 'true' : 'false';
-            } else if (typeof value === 'object') {
-              value = _.values(value).join(' ');
-            }
-          } else {
-            value = '';
-          }
-
-          if (keyValueGlue !== undefined) {
-            fragment += key + keyValueGlue;
-          }
 
-          fragment += wrapper + value + wrapper;
-          fragments.push(fragment);
-        });
+    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*
+     */
 
-        return fragments.join(fragmentGlue);
-      }); //register a classic "for loop" helper
-      //it also adds a local variable "i" as the index in each iteration loop
+    hb.registerHelper('join', function (arr, keyValueGlue, fragmentGlue, wrapper) {
+      var fragments = [];
+      keyValueGlue = typeof keyValueGlue === 'string' ? keyValueGlue : undefined;
+      fragmentGlue = typeof fragmentGlue === 'string' ? fragmentGlue : ' ';
+      wrapper = typeof wrapper === 'string' ? wrapper : '"';
 
-      hb.registerHelper('for', function (startIndex, stopIndex, increment, options) {
-        var ret = '';
-        startIndex = parseInt(startIndex);
-        stopIndex = parseInt(stopIndex);
-        increment = parseInt(increment);
+      _.forIn(arr, function (value, key) {
+        var fragment = '';
 
-        for (var i = startIndex; i < stopIndex; i += increment) {
-          ret += options.fn(_.extend({}, this, {
-            i: i
-          }));
-        }
-
-        return ret;
-      });
-      hb.registerHelper('equal', function (var1, var2, options) {
-        if (var1 == var2) {
-          return options.fn(this);
+        if (value !== null || value !== undefined) {
+          if (typeof value === 'boolean') {
+            value = value ? 'true' : 'false';
+          } else if (_typeof(value) === 'object') {
+            value = _.values(value).join(' ');
+          }
         } else {
-          return options.inverse(this);
+          value = '';
         }
-      }); // register a "get property" helper
-      // it gets the named property from the provided context
-
-      hb.registerHelper('property', function (name, context) {
-        return context[name] || '';
-      }); // register an 'includes' helper
-      // it checks if value is in array
 
-      hb.registerHelper('includes', function (haystack, needle, options) {
-        if (_.contains(haystack, needle)) {
-          return options.fn(this);
+        if (keyValueGlue !== undefined) {
+          fragment += key + keyValueGlue;
         }
+
+        fragment += wrapper + value + wrapper;
+        fragments.push(fragment);
       });
-    }
 
-    if (!Helpers0.__initialized) {
-      Helpers0(Handlebars);
-      Helpers0.__initialized = true;
-    }
-    var Template = Handlebars.template(function (Handlebars,depth0,helpers,partials,data) {
-      this.compilerInfo = [4,'>= 1.0.0'];
-    helpers = this.merge(helpers, Handlebars.helpers);  
+      return fragments.join(fragmentGlue);
+    }); //register a classic "for loop" helper
+    //it also adds a local variable "i" as the index in each iteration loop
+
+    hb.registerHelper('for', function (startIndex, stopIndex, increment, options) {
+      var ret = '';
+      startIndex = parseInt(startIndex);
+      stopIndex = parseInt(stopIndex);
+      increment = parseInt(increment);
+
+      for (var i = startIndex; i < stopIndex; i += increment) {
+        ret += options.fn(_.extend({}, this, {
+          i: i
+        }));
+      }
+
+      return ret;
+    });
+    hb.registerHelper('equal', function (var1, var2, options) {
+      if (var1 == var2) {
+        return options.fn(this);
+      } else {
+        return options.inverse(this);
+      }
+    }); // register a "get property" helper
+    // it gets the named property from the provided context
+
+    hb.registerHelper('property', function (name, context) {
+      return context[name] || '';
+    }); // register an 'includes' helper
+    // it checks if value is in array
+
+    hb.registerHelper('includes', function (haystack, needle, options) {
+      if (_.contains(haystack, needle)) {
+        return options.fn(this);
+      }
+    });
+  }
+
+  if (!Helpers0.__initialized) {
+    Helpers0(Handlebars);
+    Helpers0.__initialized = true;
+  }
+  var Template = Handlebars.template(function (Handlebars,depth0,helpers,partials,data) {
+    this.compilerInfo = [4,'>= 1.0.0'];
+  helpers = this.merge(helpers, Handlebars.helpers);  
+
+
+    return "<div class=\"calculator\">\n    <div class=\"screen\"></div>\n    <div class=\"input\"></div>\n    <div class=\"keyboard\"></div>\n</div>";
+    });
+  function boardTpl(data, options, asString) {
+    var html = Template(data, options);
+    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) 2018-2019 Open Assessment Technologies SA ;
+   */
+  /**
+   * Default config values
+   * @type {Object}
+   */
+
+  var defaultConfig = {
+    expression: '',
+    position: 0
+  };
+  /**
+   * 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}
+   */
+
+  var rePrefixedTerm = /^@[a-zA-Z_]\w*$/;
+  /**
+   * The internal namespace for built-in events listeners
+   * @type {String}
+   */
+
+  var ns = 'calculator';
+  /**
+   * Build the basic UI for a calculator
+   * @param {jQuery|HTMLElement|String} $container
+   * @param {Function[]} pluginFactories
+   * @param {Object} [config]
+   * @param {String} [config.expression=''] - The initial expression
+   * @param {Number} [config.position=0] - The initial position in the expression
+   * @param {Object} [config.maths] - Optional config for the maths evaluator (@see util/mathsEvaluator)
+   * @param {Object} [config.plugins] - Optional config for each plugins
+   * @returns {calculator}
+   */
+
+  function calculatorBoardFactory($container, pluginFactories, config) {
+    /**
+     * Maths expression parser.
+     * @type {Function}
+     */
+    var mathsEvaluator;
+    /**
+     * Keep the area broker instance
+     * @see ui/maths/calculator/areaBroker
+     */
 
+    var areaBroker;
+    /**
+     * @type {Object} the registered plugins
+     */
 
-      return "<div class=\"calculator\">\n    <div class=\"screen\"></div>\n    <div class=\"input\"></div>\n    <div class=\"keyboard\"></div>\n</div>";
-      });
-    function boardTpl(data, options, asString) {
-      var html = Template(data, options);
-      return (asString || true) ? html : $(html);
-    }
+    var plugins = {};
+    /**
+     * The current expression
+     * @type {String}
+     */
 
+    var expression = '';
     /**
-     * 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 ;
+     * A list of variables that can be used in the expression
+     * @type {Map}
      */
+
+    var variables = new collections.Map();
     /**
-     * Default config values
-     * @type {Object}
+     * A list of registered commands that can be used inside the calculator
+     * @type {Map}
      */
 
-    var defaultConfig = {
-      expression: '',
-      position: 0
-    };
+    var commands = new collections.Map();
     /**
-     * Name of the variable that contains the last result
-     * @type {String}
+     * The current position in the current expression (i.e. the position of the caret)
+     * @type {Number}
      */
 
-    var lastResultVariableName = registeredTerms.ANS.value;
+    var position = 0;
     /**
-     * Regex that matches the prefixed function operators
-     * @type {RegExp}
+     * The tokenizer utilized to split down the expression
+     * @type {calculatorTokenizer}
      */
 
-    var rePrefixedTerm = /^@[a-zA-Z_]\w*$/;
+    var tokenizer = tokenizerFactory();
     /**
-     * The internal namespace for built-in events listeners
-     * @type {String}
+     * The list of tokens extracted from the expression
+     * @type {Array|null}
      */
 
-    var ns = 'calculator';
+    var tokens = null;
     /**
-     * Build the basic UI for a calculator
-     * @param {jQuery|HTMLElement|String} $container
-     * @param {Function[]} pluginFactories
-     * @param {Object} [config]
-     * @param {String} [config.expression=''] - The initial expression
-     * @param {Number} [config.position=0] - The initial position in the expression
-     * @param {Object} [config.maths] - Optional config for the maths evaluator (@see util/mathsEvaluator)
-     * @param {Object} [config.plugins] - Optional config for each plugins
-     * @returns {calculator}
+     *
+     * @type {Object}
      */
 
-    function calculatorBoardFactory($container, pluginFactories, config) {
+    var calculatorApi = {
       /**
-       * Maths expression parser.
-       * @type {Function}
+       * Returns the current expression
+       * @returns {String}
        */
-      var mathsEvaluator;
+      getExpression: function getExpression() {
+        return expression;
+      },
+
       /**
-       * Keep the area broker instance
-       * @see ui/maths/calculator/areaBroker
+       * Changes the current expression
+       * @param {String} expr
+       * @returns {calculator}
+       * @fires expressionchange after the expression has been changed
        */
+      setExpression: function setExpression(expr) {
+        expression = String(expr || '');
+        tokens = null;
+        /**
+         * @event expressionchange
+         * @param {String} expression
+         */
+
+        this.trigger('expressionchange', expression);
+        return this;
+      },
 
-      var areaBroker;
       /**
-       * @type {Object} the registered plugins
+       * Gets the current position inside the expression
+       * @returns {Number}
        */
+      getPosition: function getPosition() {
+        return position;
+      },
 
-      var plugins = {};
       /**
-       * The current expression
-       * @type {String}
+       * Sets the current position inside the expression
+       * @param {Number|String} pos
+       * @returns {calculator}
+       * @fires positionchange after the position has been changed
        */
+      setPosition: function setPosition(pos) {
+        position = Math.max(0, Math.min(parseInt(pos, 10) || 0, expression.length));
+        /**
+         * @event positionchange
+         * @param {Number} position
+         */
+
+        this.trigger('positionchange', position);
+        return this;
+      },
 
-      var expression = '';
       /**
-       * A list of variables that can be used in the expression
-       * @type {Map}
+       * Gets the tokens from the current expression
+       * @returns {token[]}
        */
+      getTokens: function getTokens() {
+        if (tokens === null) {
+          tokens = tokenizer.tokenize(expression);
+        }
+
+        return tokens;
+      },
 
-      var variables = new collections.Map();
       /**
-       * A list of registered commands that can be used inside the calculator
-       * @type {Map}
+       * Gets the token at the current position from the current expression
+       * @returns {token|null} Returns the token at the current position, or null if none
        */
+      getToken: function getToken() {
+        var tokensList = this.getTokens();
+        var index = this.getTokenIndex();
+        return tokensList[index] || null;
+      },
 
-      var commands = new collections.Map();
       /**
-       * The current position in the current expression (i.e. the position of the caret)
-       * @type {Number}
+       * Gets token index from the current position in the expression.
+       * @returns {Number} Returns the index of the token at the current position.
        */
+      getTokenIndex: function getTokenIndex() {
+        var index = 0;
+
+        _.forEach(this.getTokens(), function (token, idx) {
+          if (position >= token.offset) {
+            index = idx;
+          }
+        });
+
+        return index;
+      },
 
-      var position = 0;
       /**
-       * The tokenizer utilized to split down the expression
-       * @type {calculatorTokenizer}
+       * Gets access to the tokenizer
+       * @returns {calculatorTokenizer}
        */
+      getTokenizer: function getTokenizer() {
+        return tokenizer;
+      },
 
-      var tokenizer = tokenizerFactory();
       /**
-       * The list of tokens extracted from the expression
-       * @type {Array|null}
+       * Gets a variable defined for the expression.
+       * @param {String} name - The variable name
+       * @returns {mathsExpression} The value. Can be another expression.
        */
+      getVariable: function getVariable(name) {
+        return variables.get(name);
+      },
 
-      var tokens = null;
       /**
-       *
-       * @type {Object}
+       * Checks if a variable is registered
+       * @param {String} name
+       * @returns {Boolean}
        */
+      hasVariable: function hasVariable(name) {
+        return variables.has(name);
+      },
 
-      var calculatorApi = {
-        /**
-         * Returns the current expression
-         * @returns {String}
-         */
-        getExpression: function getExpression() {
-          return expression;
-        },
+      /**
+       * Sets a variable that can be used by the expression.
+       * @param {String} name - The variable name
+       * @param {String|Number|mathsExpression} value - The value. Can be another expression.
+       * @returns {calculator}
+       * @fires variableadd after the variable has been set
+       */
+      setVariable: function setVariable(name, value) {
+        var errValue;
+
+        try {
+          value = mathsEvaluator(value);
+        } catch (err) {
+          errValue = value && value.expression || value;
+          value = mathsEvaluator('0');
+          value.expression = errValue;
+        }
 
+        variables.set(name, value);
         /**
-         * Changes the current expression
-         * @param {String} expr
-         * @returns {calculator}
-         * @fires expressionchange after the expression has been changed
+         * @event variableadd
+         * @param {String} name
+         * @param {String} value
          */
-        setExpression: function setExpression(expr) {
-          expression = String(expr || '');
-          tokens = null;
-          /**
-           * @event expressionchange
-           * @param {String} expression
-           */
 
-          this.trigger('expressionchange', expression);
-          return this;
-        },
+        this.trigger('variableadd', name, value);
+        return this;
+      },
 
+      /**
+       * Deletes a variable defined for the expression.
+       * @param {String} name - The variable name
+       * @returns {calculator}
+       * @fires variabledelete after the variable has been deleted
+       */
+      deleteVariable: function deleteVariable(name) {
+        variables.delete(name);
         /**
-         * Gets the current position inside the expression
-         * @returns {Number}
+         * @event variabledelete
+         * @param {String} name
          */
-        getPosition: function getPosition() {
-          return position;
-        },
 
-        /**
-         * Sets the current position inside the expression
-         * @param {Number|String} pos
-         * @returns {calculator}
-         * @fires positionchange after the position has been changed
-         */
-        setPosition: function setPosition(pos) {
-          position = Math.max(0, Math.min(parseInt(pos, 10) || 0, expression.length));
-          /**
-           * @event positionchange
-           * @param {Number} position
-           */
+        this.trigger('variabledelete', name);
+        return this;
+      },
 
-          this.trigger('positionchange', position);
-          return this;
-        },
+      /**
+       * Gets the list of variables defined for the expression.
+       * @returns {Object} The list of defined variables.
+       */
+      getVariables: function getVariables() {
+        var defs = {};
+        variables.forEach(function (value, name) {
+          defs[name] = value;
+        });
+        return defs;
+      },
 
-        /**
-         * Gets the tokens from the current expression
-         * @returns {token[]}
-         */
-        getTokens: function getTokens() {
-          if (tokens === null) {
-            tokens = tokenizer.tokenize(expression);
-          }
+      /**
+       * Sets a list of variables that can be used by the expression.
+       * @param {Object} defs - A list variables to set.
+       * @returns {calculator}
+       * @fires variableadd after each variable has been set
+       */
+      setVariables: function setVariables(defs) {
+        var self = this;
 
-          return tokens;
-        },
+        _.forEach(defs, function (value, name) {
+          self.setVariable(name, value);
+        });
 
-        /**
-         * Gets the token at the current position from the current expression
-         * @returns {token|null} Returns the token at the current position, or null if none
-         */
-        getToken: function getToken() {
-          var tokensList = this.getTokens();
-          var index = this.getTokenIndex();
-          return tokensList[index] || null;
-        },
+        return this;
+      },
 
+      /**
+       * Deletes all variables defined for the expression.
+       * @returns {calculator}
+       * @fires variabledelete after the variables has been deleted
+       */
+      deleteVariables: function deleteVariables() {
+        variables.clear();
         /**
-         * Gets token index from the current position in the expression.
-         * @returns {Number} Returns the index of the token at the current position.
+         * @event variabledelete
+         * @param {null} name
          */
-        getTokenIndex: function getTokenIndex() {
-          var index = 0;
 
-          _.forEach(this.getTokens(), function (token, idx) {
-            if (position >= token.offset) {
-              index = idx;
-            }
-          });
+        this.trigger('variabledelete', null);
+        this.setLastResult('0');
+        return this;
+      },
 
-          return index;
-        },
+      /**
+       * Sets the value of the last result
+       * @param {String|Number|mathsExpression} [result='0']
+       * @returns {calculator}
+       */
+      setLastResult: function setLastResult(result) {
+        if (!result || expressionHelper.containsError(result)) {
+          result = '0';
+        }
 
-        /**
-         * Gets access to the tokenizer
-         * @returns {calculatorTokenizer}
-         */
-        getTokenizer: function getTokenizer() {
-          return tokenizer;
-        },
+        this.setVariable(lastResultVariableName, result);
+        return this;
+      },
 
-        /**
-         * Gets a variable defined for the expression.
-         * @param {String} name - The variable name
-         * @returns {mathsExpression} The value. Can be another expression.
-         */
-        getVariable: function getVariable(name) {
-          return variables.get(name);
-        },
+      /**
+       * Gets the value of the last result
+       * @returns {mathsExpression}
+       */
+      getLastResult: function getLastResult() {
+        return this.getVariable(lastResultVariableName);
+      },
 
+      /**
+       * Registers a command
+       * @param {String} name
+       * @param {String} [label]
+       * @param {String} [description]
+       * @returns {calculator}
+       * @fires commandadd after the command has been set
+       */
+      setCommand: function setCommand(name, label, description) {
+        commands.set(name, {
+          name: name,
+          label: label,
+          description: description
+        });
         /**
-         * Checks if a variable is registered
+         * @event commandadd
          * @param {String} name
-         * @returns {Boolean}
          */
-        hasVariable: function hasVariable(name) {
-          return variables.has(name);
-        },
 
-        /**
-         * Sets a variable that can be used by the expression.
-         * @param {String} name - The variable name
-         * @param {String|Number|mathsExpression} value - The value. Can be another expression.
-         * @returns {calculator}
-         * @fires variableadd after the variable has been set
-         */
-        setVariable: function setVariable(name, value) {
-          var errValue;
-
-          try {
-            value = mathsEvaluator(value);
-          } catch (err) {
-            errValue = value && value.expression || value;
-            value = mathsEvaluator('0');
-            value.expression = errValue;
-          }
+        this.trigger('commandadd', name);
+        return this;
+      },
 
-          variables.set(name, value);
-          /**
-           * @event variableadd
-           * @param {String} name
-           * @param {String} value
-           */
-
-          this.trigger('variableadd', name, value);
-          return this;
-        },
-
-        /**
-         * Deletes a variable defined for the expression.
-         * @param {String} name - The variable name
-         * @returns {calculator}
-         * @fires variabledelete after the variable has been deleted
-         */
-        deleteVariable: function deleteVariable(name) {
-          variables.delete(name);
-          /**
-           * @event variabledelete
-           * @param {String} name
-           */
+      /**
+       * Gets the definition of a registered command
+       * @returns {Object} The registered command
+       */
+      getCommand: function getCommand(name) {
+        return commands.get(name);
+      },
 
-          this.trigger('variabledelete', name);
-          return this;
-        },
+      /**
+       * Gets the list of registered commands
+       * @returns {Object} The list of registered commands
+       */
+      getCommands: function getCommands() {
+        var defs = {};
+        commands.forEach(function (value, name) {
+          defs[name] = value;
+        });
+        return defs;
+      },
 
-        /**
-         * Gets the list of variables defined for the expression.
-         * @returns {Object} The list of defined variables.
-         */
-        getVariables: function getVariables() {
-          var defs = {};
-          variables.forEach(function (value, name) {
-            defs[name] = value;
-          });
-          return defs;
-        },
+      /**
+       * Checks if a command is registered
+       * @param {String} name
+       * @returns {Boolean}
+       */
+      hasCommand: function hasCommand(name) {
+        return commands.has(name);
+      },
 
+      /**
+       * Delete a registered command
+       * @param {String} name
+       * @returns {calculator}
+       * @fires commanddelete after the command has been deleted
+       */
+      deleteCommand: function deleteCommand(name) {
+        commands.delete(name);
         /**
-         * Sets a list of variables that can be used by the expression.
-         * @param {Object} defs - A list variables to set.
-         * @returns {calculator}
-         * @fires variableadd after each variable has been set
+         * @event commanddelete
+         * @param {String} name
          */
-        setVariables: function setVariables(defs) {
-          var self = this;
 
-          _.forEach(defs, function (value, name) {
-            self.setVariable(name, value);
-          });
+        this.trigger('commanddelete', name);
+        return this;
+      },
 
-          return this;
-        },
+      /**
+       * Inserts a term in the expression at the current position
+       * @param {String} name - The name of the term to insert
+       * @param {Object} term - The definition of the term to insert
+       * @returns {calculator}
+       * @fires termerror if the term to add is invalid
+       * @fires termadd when the term has been added
+       * @fires termadd-<name> when the term has been added
+       */
+      addTerm: function addTerm(name, term) {
+        var tokensList = this.getTokens();
+        var index = this.getTokenIndex();
+        var currentToken = tokensList[index];
+        var nextToken = tokensList[index + 1];
+        var isIdentifier, needsSpace, value; // checks if the aforementioned token requires space around
+
+        function tokenNeedsSpace(token) {
+          return tokensHelper.isIdentifier(token) || isIdentifier && !tokensHelper.isSeparator(token);
+        }
 
-        /**
-         * Deletes all variables defined for the expression.
-         * @returns {calculator}
-         * @fires variabledelete after the variables has been deleted
-         */
-        deleteVariables: function deleteVariables() {
-          variables.clear();
+        if (!_.isPlainObject(term) || 'undefined' === typeof term.value) {
           /**
-           * @event variabledelete
-           * @param {null} name
+           * @event termerror
+           * @param {TypeError} err
            */
+          return this.trigger('termerror', new TypeError('Invalid term: ' + name));
+        }
 
-          this.trigger('variabledelete', null);
-          this.setLastResult('0');
-          return this;
-        },
-
-        /**
-         * Sets the value of the last result
-         * @param {String|Number|mathsExpression} [result='0']
-         * @returns {calculator}
-         */
-        setLastResult: function setLastResult(result) {
-          if (!result || expressionHelper.containsError(result)) {
-            result = '0';
-          }
-
-          this.setVariable(lastResultVariableName, result);
-          return this;
-        },
+        value = term.value; // will replace the current term if:
+        // - it is a 0, and the term to add is not an operator nor a dot
+        // - it is the last result, and the term to add is not an operator
 
-        /**
-         * Gets the value of the last result
-         * @returns {mathsExpression}
-         */
-        getLastResult: function getLastResult() {
-          return this.getVariable(lastResultVariableName);
-        },
+        if (!tokensHelper.isOperator(term.type) && !rePrefixedTerm.test(term.value) && tokensList.length === 1 && (currentToken.type === 'NUM0' && name !== 'DOT' || currentToken.type === 'ANS')) {
+          this.replace(value);
+        } else {
+          // simply add the term, with potentially spaces around
+          if (expression && !tokensHelper.isSeparator(term.type)) {
+            isIdentifier = tokensHelper.isIdentifier(term.type);
+            needsSpace = tokenNeedsSpace(currentToken); // prepend space when either the term to add or the previous term is an identifier
 
-        /**
-         * Registers a command
-         * @param {String} name
-         * @param {String} [label]
-         * @param {String} [description]
-         * @returns {calculator}
-         * @fires commandadd after the command has been set
-         */
-        setCommand: function setCommand(name, label, description) {
-          commands.set(name, {
-            name: name,
-            label: label,
-            description: description
-          });
-          /**
-           * @event commandadd
-           * @param {String} name
-           */
+            if (position && needsSpace) {
+              value = ' ' + value;
+            } // append space when either the term to add or the next term is an identifier
 
-          this.trigger('commandadd', name);
-          return this;
-        },
 
-        /**
-         * Gets the definition of a registered command
-         * @returns {Object} The registered command
-         */
-        getCommand: function getCommand(name) {
-          return commands.get(name);
-        },
+            if (!position && needsSpace || position < expression.length && tokenNeedsSpace(nextToken)) {
+              value += ' ';
+            }
+          }
 
+          this.insert(value);
+        }
         /**
-         * Gets the list of registered commands
-         * @returns {Object} The list of registered commands
+         * @event termadd
+         * @param {String} name - The name of the added term
+         * @param {Object} term - The descriptor of the added term
          */
-        getCommands: function getCommands() {
-          var defs = {};
-          commands.forEach(function (value, name) {
-            defs[name] = value;
-          });
-          return defs;
-        },
 
-        /**
-         * Checks if a command is registered
-         * @param {String} name
-         * @returns {Boolean}
-         */
-        hasCommand: function hasCommand(name) {
-          return commands.has(name);
-        },
 
+        this.trigger('termadd', name, term);
         /**
-         * Delete a registered command
-         * @param {String} name
-         * @returns {calculator}
-         * @fires commanddelete after the command has been deleted
+         * @event termadd-<name>
+         * @param {Object} term - The descriptor of the added term
          */
-        deleteCommand: function deleteCommand(name) {
-          commands.delete(name);
-          /**
-           * @event commanddelete
-           * @param {String} name
-           */
 
-          this.trigger('commanddelete', name);
-          return this;
-        },
+        this.trigger('termadd-' + name, term);
+        return this;
+      },
 
-        /**
-         * Inserts a term in the expression at the current position
-         * @param {String} name - The name of the term to insert
-         * @param {Object} term - The definition of the term to insert
-         * @returns {calculator}
-         * @fires termerror if the term to add is invalid
-         * @fires termadd when the term has been added
-         * @fires termadd-<name> when the term has been added
-         */
-        addTerm: function addTerm(name, term) {
-          var tokensList = this.getTokens();
-          var index = this.getTokenIndex();
-          var currentToken = tokensList[index];
-          var nextToken = tokensList[index + 1];
-          var isIdentifier, needsSpace, value; // checks if the aforementioned token requires space around
-
-          function tokenNeedsSpace(token) {
-            return tokensHelper.isIdentifier(token) || isIdentifier && !tokensHelper.isSeparator(token);
-          }
+      /**
+       * Inserts a term in the expression at the current position
+       * @param {String} name - The name of the term to insert
+       * @returns {calculator}
+       * @fires termerror if the term to add is invalid
+       * @fires termadd when the term has been added
+       */
+      useTerm: function useTerm(name) {
+        var term;
 
-          if (!_.isPlainObject(term) || 'undefined' === typeof term.value) {
-            /**
-             * @event termerror
-             * @param {TypeError} err
-             */
-            return this.trigger('termerror', new TypeError('Invalid term: ' + name));
-          }
+        if (rePrefixedTerm.test(name)) {
+          name = name.substring(1);
+          term = _.clone(registeredTerms[name]);
+          term.value = '@' + term.value;
+        } else {
+          term = registeredTerms[name];
+        }
 
-          value = term.value; // will replace the current term if:
-          // - it is a 0, and the term to add is not an operator nor a dot
-          // - it is the last result, and the term to add is not an operator
+        if ('undefined' === typeof term) {
+          /**
+           * @event termerror
+           * @param {TypeError} err
+           */
+          return this.trigger('termerror', new TypeError('Invalid term: ' + name));
+        }
 
-          if (!tokensHelper.isOperator(term.type) && !rePrefixedTerm.test(term.value) && tokensList.length === 1 && (currentToken.type === 'NUM0' && name !== 'DOT' || currentToken.type === 'ANS')) {
-            this.replace(value);
-          } else {
-            // simply add the term, with potentially spaces around
-            if (expression && !tokensHelper.isSeparator(term.type)) {
-              isIdentifier = tokensHelper.isIdentifier(term.type);
-              needsSpace = tokenNeedsSpace(currentToken); // prepend space when either the term to add or the previous term is an identifier
+        return this.addTerm(name, term);
+      },
 
-              if (position && needsSpace) {
-                value = ' ' + value;
-              } // append space when either the term to add or the next term is an identifier
+      /**
+       * Inserts a list of terms in the expression at the current position
+       * @param {String|String[]} names - The names of the terms to insert.
+       *                                  Could be either an array of names or a list separated by spaces.
+       * @returns {calculator}
+       * @fires termerror if a term to add is invalid
+       * @fires termadd when a term has been added
+       */
+      useTerms: function useTerms(names) {
+        if ('string' === typeof names) {
+          names = names.split(/\s+/);
+        }
 
+        _.forEach(names, this.useTerm.bind(this));
 
-              if (!position && needsSpace || position < expression.length && tokenNeedsSpace(nextToken)) {
-                value += ' ';
-              }
-            }
+        return this;
+      },
 
-            this.insert(value);
-          }
+      /**
+       * Inserts a variable as a term in the expression at the current position
+       * @param {String} name - The name of the variable to insert
+       * @returns {calculator}
+       * @fires termerror if the term to add is invalid
+       * @fires termadd when the term has been added
+       */
+      useVariable: function useVariable(name) {
+        if (!variables.has(name)) {
           /**
-           * @event termadd
-           * @param {String} name - The name of the added term
-           * @param {Object} term - The descriptor of the added term
+           * @event termerror
+           * @param {TypeError} err
            */
+          return this.trigger('termerror', new TypeError('Invalid variable: ' + name));
+        }
 
+        return this.addTerm('VAR_' + name.toUpperCase(), {
+          label: name,
+          value: name,
+          type: 'variable',
+          description: __('Variable %s', name)
+        });
+      },
 
-          this.trigger('termadd', name, term);
+      /**
+       * Calls a command
+       * @param {String} name - The name of the called command
+       * @param {*} ... - additional params for the command
+       * @returns {calculator}
+       * @fires command with the name and the parameters of the command
+       * @fires command-<name> with the parameters of the command
+       * @fires commanderror if the command is invalid
+       */
+      useCommand: function useCommand(name) {
+        if (!commands.has(name)) {
           /**
-           * @event termadd-<name>
-           * @param {Object} term - The descriptor of the added term
+           * @event commanderror
+           * @param {TypeError} err
            */
-
-          this.trigger('termadd-' + name, term);
-          return this;
-        },
-
+          return this.trigger('commanderror', new TypeError('Invalid command: ' + name));
+        }
         /**
-         * Inserts a term in the expression at the current position
-         * @param {String} name - The name of the term to insert
-         * @returns {calculator}
-         * @fires termerror if the term to add is invalid
-         * @fires termadd when the term has been added
+         * @event command
+         * @param {String} name - The name of the called command
+         * @param {*} ... - additional params for the command
          */
-        useTerm: function useTerm(name) {
-          var term;
 
-          if (rePrefixedTerm.test(name)) {
-            name = name.substring(1);
-            term = _.clone(registeredTerms[name]);
-            term.value = '@' + term.value;
-          } else {
-            term = registeredTerms[name];
-          }
-
-          if ('undefined' === typeof term) {
-            /**
-             * @event termerror
-             * @param {TypeError} err
-             */
-            return this.trigger('termerror', new TypeError('Invalid term: ' + name));
-          }
-
-          return this.addTerm(name, term);
-        },
 
+        this.trigger.apply(this, ['command'].concat([].slice.call(arguments)));
         /**
-         * Inserts a list of terms in the expression at the current position
-         * @param {String|String[]} names - The names of the terms to insert.
-         *                                  Could be either an array of names or a list separated by spaces.
-         * @returns {calculator}
-         * @fires termerror if a term to add is invalid
-         * @fires termadd when a term has been added
+         * @event command-<name>
+         * @param {*} ... - additional params for the command
          */
-        useTerms: function useTerms(names) {
-          if ('string' === typeof names) {
-            names = names.split(/\s+/);
-          }
 
-          _.forEach(names, this.useTerm.bind(this));
-
-          return this;
-        },
+        this.trigger.apply(this, ['command-' + name].concat([].slice.call(arguments, 1)));
+        return this;
+      },
 
+      /**
+       * Replaces the expression and move the cursor at the end.
+       * @param {String} newExpression - The new expression to set
+       * @param {Number|String} [newPosition=newExpression.length] - The new position to set
+       * @returns {calculator}
+       * @fires replace after the expression has been replaced
+       */
+      replace: function replace(newExpression, newPosition) {
+        var oldExpression = expression;
+        var oldPosition = position;
+        this.setExpression(newExpression).setPosition('undefined' !== typeof newPosition ? newPosition : expression.length);
         /**
-         * Inserts a variable as a term in the expression at the current position
-         * @param {String} name - The name of the variable to insert
-         * @returns {calculator}
-         * @fires termerror if the term to add is invalid
-         * @fires termadd when the term has been added
+         * @event replace
+         * @param {String} expression - the replaced expression
+         * @param {Number} position - the replaced position
          */
-        useVariable: function useVariable(name) {
-          if (!variables.has(name)) {
-            /**
-             * @event termerror
-             * @param {TypeError} err
-             */
-            return this.trigger('termerror', new TypeError('Invalid variable: ' + name));
-          }
 
-          return this.addTerm('VAR_' + name.toUpperCase(), {
-            label: name,
-            value: name,
-            type: 'variable',
-            description: __('Variable %s', name)
-          });
-        },
+        this.trigger('replace', oldExpression, oldPosition);
+        return this;
+      },
 
+      /**
+       * Inserts a sub-expression in the current expression and move the cursor.
+       * @param {String} subExpression - The sub-expression to insert
+       * @returns {calculator}
+       * @fires insert after the expression has been inserted
+       */
+      insert: function insert(subExpression) {
+        var oldExpression = expression;
+        var oldPosition = position;
+        this.setExpression(expression.substr(0, position) + subExpression + expression.substr(position)).setPosition(position + subExpression.length);
         /**
-         * Calls a command
-         * @param {String} name - The name of the called command
-         * @param {*} ... - additional params for the command
-         * @returns {calculator}
-         * @fires command with the name and the parameters of the command
-         * @fires command-<name> with the parameters of the command
-         * @fires commanderror if the command is invalid
+         * @event insert
+         * @param {String} expression - the replaced expression
+         * @param {Number} position - the replaced position
          */
-        useCommand: function useCommand(name) {
-          if (!commands.has(name)) {
-            /**
-             * @event commanderror
-             * @param {TypeError} err
-             */
-            return this.trigger('commanderror', new TypeError('Invalid command: ' + name));
-          }
-          /**
-           * @event command
-           * @param {String} name - The name of the called command
-           * @param {*} ... - additional params for the command
-           */
-
-
-          this.trigger.apply(this, ['command'].concat([].slice.call(arguments)));
-          /**
-           * @event command-<name>
-           * @param {*} ... - additional params for the command
-           */
 
-          this.trigger.apply(this, ['command-' + name].concat([].slice.call(arguments, 1)));
-          return this;
-        },
+        this.trigger('insert', oldExpression, oldPosition);
+        return this;
+      },
 
+      /**
+       * Clears the expression
+       * @returns {calculator}
+       * @fires clear after the expression has been cleared
+       */
+      clear: function clear() {
+        this.setExpression('').setPosition(0);
         /**
-         * Replaces the expression and move the cursor at the end.
-         * @param {String} newExpression - The new expression to set
-         * @param {Number|String} [newPosition=newExpression.length] - The new position to set
-         * @returns {calculator}
-         * @fires replace after the expression has been replaced
+         * @event clear
          */
-        replace: function replace(newExpression, newPosition) {
-          var oldExpression = expression;
-          var oldPosition = position;
-          this.setExpression(newExpression).setPosition('undefined' !== typeof newPosition ? newPosition : expression.length);
-          /**
-           * @event replace
-           * @param {String} expression - the replaced expression
-           * @param {Number} position - the replaced position
-           */
 
-          this.trigger('replace', oldExpression, oldPosition);
-          return this;
-        },
+        this.trigger('clear');
+        return this;
+      },
 
-        /**
-         * Inserts a sub-expression in the current expression and move the cursor.
-         * @param {String} subExpression - The sub-expression to insert
-         * @returns {calculator}
-         * @fires insert after the expression has been inserted
-         */
-        insert: function insert(subExpression) {
-          var oldExpression = expression;
-          var oldPosition = position;
-          this.setExpression(expression.substr(0, position) + subExpression + expression.substr(position)).setPosition(position + subExpression.length);
+      /**
+       * Evaluates the current expression
+       * @returns {mathsExpression|null}
+       * @fires evaluate when the expression has been evaluated
+       * @fires syntaxerror when the expression contains an error
+       */
+      evaluate: function evaluate() {
+        var result = null;
+
+        try {
+          if (expression.trim()) {
+            result = mathsEvaluator(expression, _.mapValues(this.getVariables(), 'result'));
+          } else {
+            result = mathsEvaluator('0');
+          }
           /**
-           * @event insert
-           * @param {String} expression - the replaced expression
-           * @param {Number} position - the replaced position
+           * @event evaluate
+           * @param {mathsExpression} result
            */
 
-          this.trigger('insert', oldExpression, oldPosition);
-          return this;
-        },
 
-        /**
-         * Clears the expression
-         * @returns {calculator}
-         * @fires clear after the expression has been cleared
-         */
-        clear: function clear() {
-          this.setExpression('').setPosition(0);
+          this.trigger('evaluate', result);
+        } catch (e) {
           /**
-           * @event clear
+           * @event syntaxerror
+           * @param {Error} err
            */
+          this.trigger('syntaxerror', e);
+        }
 
-          this.trigger('clear');
-          return this;
-        },
-
-        /**
-         * Evaluates the current expression
-         * @returns {mathsExpression|null}
-         * @fires evaluate when the expression has been evaluated
-         * @fires syntaxerror when the expression contains an error
-         */
-        evaluate: function evaluate() {
-          var result = null;
-
-          try {
-            if (expression.trim()) {
-              result = mathsEvaluator(expression, _.mapValues(this.getVariables(), 'result'));
-            } else {
-              result = mathsEvaluator('0');
-            }
-            /**
-             * @event evaluate
-             * @param {mathsExpression} result
-             */
-
-
-            this.trigger('evaluate', result);
-          } catch (e) {
-            /**
-             * @event syntaxerror
-             * @param {Error} err
-             */
-            this.trigger('syntaxerror', e);
-          }
-
-          return result;
-        },
-
-        /**
-         * Runs a method in all plugins
-         *
-         * @param {String} method - the method to run
-         * @returns {Promise} once that resolve when all plugins are done
-         */
-        runPlugins: function runPlugins(method) {
-          var execStack = [];
-
-          _.forEach(plugins, function (plugin) {
-            if (_.isFunction(plugin[method])) {
-              execStack.push(plugin[method]());
-            }
-          });
-
-          return Promise.all(execStack);
-        },
-
-        /**
-         * Gets the calculator plugins
-         * @returns {Array} the plugins
-         */
-        getPlugins: function getPlugins() {
-          return _.toArray(plugins);
-        },
+        return result;
+      },
 
-        /**
-         * Gets a plugin
-         * @param {String} name - the plugin name
-         * @returns {plugin} the plugin
-         */
-        getPlugin: function getPlugin(name) {
-          return plugins[name];
-        },
+      /**
+       * Runs a method in all plugins
+       *
+       * @param {String} method - the method to run
+       * @returns {Promise} once that resolve when all plugins are done
+       */
+      runPlugins: function runPlugins(method) {
+        var execStack = [];
 
-        /**
-         * Gets access to the areaBroker
-         * @returns {areaBroker}
-         */
-        getAreaBroker: function getAreaBroker() {
-          return areaBroker;
-        },
+        _.forEach(plugins, function (plugin) {
+          if (_.isFunction(plugin[method])) {
+            execStack.push(plugin[method]());
+          }
+        });
 
-        /**
-         * Setups the maths evaluator
-         * @returns {calculator}
-         */
-        setupMathsEvaluator: function setupMathsEvaluator() {
-          mathsEvaluator = mathsEvaluatorFactory(this.getConfig().maths);
-          return this;
-        },
+        return Promise.all(execStack);
+      },
 
-        /**
-         * Gets access to the mathsEvaluator
-         * @returns {Function}
-         */
-        getMathsEvaluator: function getMathsEvaluator() {
-          return mathsEvaluator;
-        }
-      };
       /**
-       * @typedef {component} calculator
+       * Gets the calculator plugins
+       * @returns {Array} the plugins
        */
+      getPlugins: function getPlugins() {
+        return _.toArray(plugins);
+      },
 
-      var calculator = componentFactory(calculatorApi, defaultConfig).setTemplate(boardTpl).before('init', function () {
-        this.setupMathsEvaluator();
-        this.setLastResult('0');
-
-        if (this.config.expression) {
-          this.setExpression(this.config.expression);
-        }
+      /**
+       * Gets a plugin
+       * @param {String} name - the plugin name
+       * @returns {plugin} the plugin
+       */
+      getPlugin: function getPlugin(name) {
+        return plugins[name];
+      },
 
-        if (this.config.position) {
-          this.setPosition(this.config.position);
-        } // built-in commands
+      /**
+       * Gets access to the areaBroker
+       * @returns {areaBroker}
+       */
+      getAreaBroker: function getAreaBroker() {
+        return areaBroker;
+      },
 
+      /**
+       * Setups the maths evaluator
+       * @returns {calculator}
+       */
+      setupMathsEvaluator: function setupMathsEvaluator() {
+        mathsEvaluator = mathsEvaluatorFactory(this.getConfig().maths);
+        return this;
+      },
 
-        this.setCommand('clear', __('Clear'), __('Clear expression')).setCommand('clearAll', __('Clear All'), __('Clear all data')).setCommand('execute', __('Execute'), __('Compute the expression')).setCommand('var', __('Variable'), __('Use a variable')).setCommand('term', __('Term'), __('Use a term')).on('command-term', this.useTerms.bind(this)).on('command-var', this.useVariable.bind(this)).on('command-execute', this.evaluate.bind(this)).on('command-clearAll', this.deleteVariables.bind(this)).on('command-clear command-clearAll', this.clear.bind(this));
-      }).after('evaluate', function (result) {
-        this.setLastResult(result);
-      }).after('init', function () {
-        this.render($container);
-      }).before('render', function () {
-        var self = this;
-        var pluginsConfig = this.getConfig().plugins || {};
-        var $element = this.getElement();
-        areaBroker = areaBrokerFactory($element, {
-          screen: $element.find('.screen'),
-          // where the expressions and their result are rendered
-          input: $element.find('.input'),
-          // where the expressions are input
-          keyboard: $element.find('.keyboard') // the keyboard area that should provide a way to interact with the calculator
+      /**
+       * Gets access to the mathsEvaluator
+       * @returns {Function}
+       */
+      getMathsEvaluator: function getMathsEvaluator() {
+        return mathsEvaluator;
+      }
+    };
+    /**
+     * @typedef {component} calculator
+     */
 
-        });
+    var calculator = componentFactory(calculatorApi, defaultConfig).setTemplate(boardTpl).before('init', function () {
+      this.setupMathsEvaluator();
+      this.setLastResult('0');
+
+      if (this.config.expression) {
+        this.setExpression(this.config.expression);
+      }
+
+      if (this.config.position) {
+        this.setPosition(this.config.position);
+      } // built-in commands
+
+
+      this.setCommand('clear', __('Clear'), __('Clear expression')).setCommand('clearAll', __('Clear All'), __('Clear all data')).setCommand('execute', __('Execute'), __('Compute the expression')).setCommand('var', __('Variable'), __('Use a variable')).setCommand('term', __('Term'), __('Use a term')).on('command-term', this.useTerms.bind(this)).on('command-var', this.useVariable.bind(this)).on('command-execute', this.evaluate.bind(this)).on('command-clearAll', this.deleteVariables.bind(this)).on('command-clear command-clearAll', this.clear.bind(this));
+    }).after('evaluate', function (result) {
+      this.setLastResult(result);
+    }).after('init', function () {
+      this.render($container);
+    }).before('render', function () {
+      var self = this;
+      var pluginsConfig = this.getConfig().plugins || {};
+      var $element = this.getElement();
+      areaBroker = areaBrokerFactory($element, {
+        screen: $element.find('.screen'),
+        // where the expressions and their result are rendered
+        input: $element.find('.input'),
+        // where the expressions are input
+        keyboard: $element.find('.keyboard') // the keyboard area that should provide a way to interact with the calculator
 
-        _.forEach(pluginFactories, function (pluginFactory) {
-          var plugin = pluginFactory(self, self.getAreaBroker());
-          var pluginName = plugin.getName();
+      });
 
-          if (pluginsConfig[pluginName]) {
-            plugin.setConfig(pluginsConfig[pluginName]);
-          }
+      _.forEach(pluginFactories, function (pluginFactory) {
+        var plugin = pluginFactory(self, self.getAreaBroker());
+        var pluginName = plugin.getName();
 
-          plugins[plugin.getName()] = plugin;
-        });
+        if (pluginsConfig[pluginName]) {
+          plugin.setConfig(pluginsConfig[pluginName]);
+        }
 
-        return this.runPlugins('install').then(function () {
-          return self.runPlugins('init');
-        }).then(function () {
-          return self.runPlugins('render');
-        }).then(function () {
-          /**
-           * @event ready
-           */
-          self.trigger('ready');
-        }).catch(function (err) {
-          self.trigger('error', err);
-        });
-      }).on('destroy', function () {
-        var self = this;
-        return this.runPlugins('destroy').then(function () {
-          self.off('.' + ns);
-          tokenizer = null;
-          areaBroker = null;
-          mathsEvaluator = null;
-          variables.clear();
-          plugins = {};
-        });
+        plugins[plugin.getName()] = plugin;
       });
 
-      _.defer(function () {
-        calculator.init(config);
+      return this.runPlugins('install').then(function () {
+        return self.runPlugins('init');
+      }).then(function () {
+        return self.runPlugins('render');
+      }).then(function () {
+        /**
+         * @event ready
+         */
+        self.trigger('ready');
+      }).catch(function (err) {
+        self.trigger('error', err);
       });
+    }).on('destroy', function () {
+      var self = this;
+      return this.runPlugins('destroy').then(function () {
+        self.off('.' + ns);
+        tokenizer = null;
+        areaBroker = null;
+        mathsEvaluator = null;
+        variables.clear();
+        plugins = {};
+      });
+    });
+
+    _.defer(function () {
+      calculator.init(config);
+    });
 
-      return calculator;
-    }
+    return calculator;
+  }
 
-    return calculatorBoardFactory;
+  return calculatorBoardFactory;
 
 });