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

package/dist/class/selector.js

@@ -22,24 +22,24 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
     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) {
@@ -120,7 +120,7 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
   function program1(depth0,data) {
     
     var buffer = "", stack1, helper;
-    buffer += "\r\n    <a href=\"#\" class=\"selected truncate\" data-uri=\"";
+    buffer += "\n    <a href=\"#\" class=\"selected truncate\" data-uri=\"";
     if (helper = helpers.classUri) { stack1 = helper.call(depth0, {hash:{},data:data}); }
     else { helper = (depth0 && depth0.classUri); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
     buffer += escapeExpression(stack1)
@@ -132,29 +132,29 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
     if (helper = helpers.label) { stack1 = helper.call(depth0, {hash:{},data:data}); }
     else { helper = (depth0 && depth0.label); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
     buffer += escapeExpression(stack1)
-      + "</a>\r\n    ";
+      + "</a>\n    ";
     return buffer;
     }
 
   function program3(depth0,data) {
     
     var buffer = "", stack1, helper;
-    buffer += "\r\n    <a href=\"#\" class=\"selected truncate empty\">";
+    buffer += "\n    <a href=\"#\" class=\"selected truncate empty\">";
     if (helper = helpers.placeholder) { stack1 = helper.call(depth0, {hash:{},data:data}); }
     else { helper = (depth0 && depth0.placeholder); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
     buffer += escapeExpression(stack1)
-      + "</a>\r\n    ";
+      + "</a>\n    ";
     return buffer;
     }
 
-    buffer += "<div class=\"class-selector\">\r\n    ";
+    buffer += "<div class=\"class-selector\">\n    ";
     stack1 = helpers['if'].call(depth0, (depth0 && depth0.classUri), {hash:{},inverse:self.program(3, program3, data),fn:self.program(1, program1, data),data:data});
     if(stack1 || stack1 === 0) { buffer += stack1; }
-    buffer += "\r\n    <div class=\"options folded\">\r\n        <ul>";
+    buffer += "\n    <div class=\"options folded\">\n        <ul>";
     if (helper = helpers.tree) { stack1 = helper.call(depth0, {hash:{},data:data}); }
     else { helper = (depth0 && depth0.tree); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
     if(stack1 || stack1 === 0) { buffer += stack1; }
-    buffer += "</ul>\r\n    </div>\r\n</div>\r\n";
+    buffer += "</ul>\n    </div>\n</div>\n";
     return buffer;
     });
   function selectorTpl(data, options, asString) {
@@ -174,15 +174,15 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
   function program1(depth0,data) {
     
     var buffer = "", stack1, helper;
-    buffer += "\r\n        <ul>\r\n            ";
+    buffer += "\n        <ul>\n            ";
     if (helper = helpers.childList) { stack1 = helper.call(depth0, {hash:{},data:data}); }
     else { helper = (depth0 && depth0.childList); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
     if(stack1 || stack1 === 0) { buffer += stack1; }
-    buffer += "\r\n        </ul>\r\n    ";
+    buffer += "\n        </ul>\n    ";
     return buffer;
     }
 
-    buffer += "<li>\r\n    <a href=\"#\" data-uri=\"";
+    buffer += "<li>\n    <a href=\"#\" data-uri=\"";
     if (helper = helpers.uri) { stack1 = helper.call(depth0, {hash:{},data:data}); }
     else { helper = (depth0 && depth0.uri); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
     buffer += escapeExpression(stack1)
@@ -194,10 +194,10 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
     if (helper = helpers.label) { stack1 = helper.call(depth0, {hash:{},data:data}); }
     else { helper = (depth0 && depth0.label); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
     buffer += escapeExpression(stack1)
-      + "</a>\r\n    ";
+      + "</a>\n    ";
     stack1 = helpers['if'].call(depth0, (depth0 && depth0.childList), {hash:{},inverse:self.noop,fn:self.program(1, program1, data),data:data});
     if(stack1 || stack1 === 0) { buffer += stack1; }
-    buffer += "\r\n</li>\r\n\r\n";
+    buffer += "\n</li>\n\n";
     return buffer;
     });
   function listItemTpl(data, options, asString) {
@@ -205,35 +205,35 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
     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) 2017 (original work) 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) 2017 (original work) Open Assessment Technologies SA ;
    */
   var defaultConfig = {
     classes: [],
     placeholder: __('Select a class')
   };
-  /**
-   * Create a brand new class selector
-   * @param {jQueryElement} $container - where the component is rendered
-   * @param {Object} [config] - the configuration
-   * @param {String} [config.classUri] - the selected class URI (by default)
-   * @param {String} [config.placeholder] - when nothing is selected
-   * @param {Object[]} [config.classes] - the class tree data, a collection of objects as {uri, label, children}
-   * @returns {classSelector} the component itself
+  /**
+   * Create a brand new class selector
+   * @param {jQueryElement} $container - where the component is rendered
+   * @param {Object} [config] - the configuration
+   * @param {String} [config.classUri] - the selected class URI (by default)
+   * @param {String} [config.placeholder] - when nothing is selected
+   * @param {Object[]} [config.classes] - the class tree data, a collection of objects as {uri, label, children}
+   * @returns {classSelector} the component itself
    */
 
   function classesSelectorFactory($container, config) {
@@ -241,10 +241,10 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
     var $options; //create an index to manage classes easily
 
     var classList = {};
-    /**
-     * Build the Class Tree from the data
-     * @param {Object[]} classes - as {uri, label, children}
-     * @returns {String} the HTML tree
+    /**
+     * Build the Class Tree from the data
+     * @param {Object[]} classes - as {uri, label, children}
+     * @returns {String} the HTML tree
      */
 
     var buildTree = function buildTree(classes) {
@@ -274,17 +274,17 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
         $options.toggleClass('folded');
       }
     };
-    /**
-     * @typedef {classSelector} the component
+    /**
+     * @typedef {classSelector} the component
      */
 
 
     var classSelector = component({
-      /**
-       * Set the selected class
-       * @param {String} uri - the class URI to select
-       * @returns {classSelector} chains
-       * @fires classSelector#change
+      /**
+       * Set the selected class
+       * @param {String} uri - the class URI to select
+       * @returns {classSelector} chains
+       * @fires classSelector#change
        */
       setValue: function setValue(uri) {
         if (this.config.classUri !== uri && !_.isUndefined(classList[uri])) {
@@ -295,10 +295,10 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
               title: classList[uri].label,
               'data-uri': uri
             }).data('uri', uri).removeClass('empty');
-            /**
-             * @event classSelector#change
-             * @param {String} uri - the selected class URI
-             * @param {Object} class - the class node
+            /**
+             * @event classSelector#change
+             * @param {String} uri - the selected class URI
+             * @param {Object} class - the class node
              */
 
             this.trigger('change', uri, classList[uri]);
@@ -308,17 +308,17 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
         return this;
       },
 
-      /**
-       * Get the selected class
-       * @returns {String} the selected class URI
+      /**
+       * Get the selected class
+       * @returns {String} the selected class URI
        */
       getValue: function getValue() {
         return this.config.classUri;
       },
 
-      /**
-       * Get the selected class node
-       * @returns {Object} the node
+      /**
+       * Get the selected class node
+       * @returns {Object} the node
        */
       getClassNode: function getClassNode() {
         var node = null;
@@ -330,10 +330,10 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
         return node;
       },
 
-      /**
-       * Empty the component: remove the selection, set back the placeholder
-       * @returns {classSelector} chains
-       * @fires classSelector#change
+      /**
+       * Empty the component: remove the selection, set back the placeholder
+       * @returns {classSelector} chains
+       * @fires classSelector#change
        */
       empty: function empty() {
         if (this.is('rendered') && $selected.length && this.config.classUri) {
@@ -345,12 +345,12 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
         return this;
       },
 
-      /**
-       * Does the given node exists ?
-       *
-       * @param {Object|String} node - the node or directly the URI
-       * @param {String} [node.uri]
-       * @returns {Boolean}
+      /**
+       * Does the given node exists ?
+       *
+       * @param {Object|String} node - the node or directly the URI
+       * @param {String} [node.uri]
+       * @returns {Boolean}
        */
       hasNode: function hasNode(node) {
         var uri;
@@ -363,12 +363,12 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
         return false;
       },
 
-      /**
-       * Removes the given node
-       *
-       * @param {Object|String} node - the node or directly the URI
-       * @param {String} [node.uri]
-       * @returns {Boolean}
+      /**
+       * Removes the given node
+       *
+       * @param {Object|String} node - the node or directly the URI
+       * @param {String} [node.uri]
+       * @returns {Boolean}
        */
       removeNode: function removeNode(node) {
         var uri;
@@ -392,15 +392,15 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
         return false;
       },
 
-      /**
-       * Add a node.
-       *
-       * @param {Object} node - the node to add
-       * @param {String} node.uri
-       * @param {String} node.label
-       * @param {Object[]} node.children - let's you add a sub hierarchy
-       * @param {String} [parentUri] - where to append the new node
-       * @returns {classSelector} chains
+      /**
+       * Add a node.
+       *
+       * @param {Object} node - the node to add
+       * @param {String} node.uri
+       * @param {String} node.label
+       * @param {Object[]} node.children - let's you add a sub hierarchy
+       * @param {String} [parentUri] - where to append the new node
+       * @returns {classSelector} chains
        */
       addNode: function addNode(node, parentUri) {
         var subTree;
@@ -429,13 +429,13 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
         return this;
       },
 
-      /**
-       * Update a node (the label for now)
-       *
-       * @param {Object} node - the node to update
-       * @param {String} node.uri
-       * @param {String} node.label
-       * @returns {classSelector} chains
+      /**
+       * Update a node (the label for now)
+       *
+       * @param {Object} node - the node to update
+       * @param {String} node.uri
+       * @param {String} node.label
+       * @returns {classSelector} chains
        */
       updateNode: function updateNode(node) {
         if (node && node.uri && this.hasNode(node) && classList[node.uri].label !== node.label) {
@@ -449,15 +449,15 @@ define(['jquery', 'lodash', 'i18n', 'ui/component', 'handlebars', 'lib/dompurify
         return this;
       },
 
-      /**
-       * Update multiple nodes, recursively
-       * @see {classSelector#updateNode}
-       *
-       * @param {Object[]} node - the node to update
-       * @param {String} node.uri
-       * @param {String} node.label
-       * @param {Object[]} node.children
-       * @returns {classSelector} chains
+      /**
+       * Update multiple nodes, recursively
+       * @see {classSelector#updateNode}
+       *
+       * @param {Object[]} node - the node to update
+       * @param {String} node.uri
+       * @param {String} node.label
+       * @param {Object[]} node.children
+       * @returns {classSelector} chains
        */
       updateNodes: function updateNodes(nodes) {
         var self = this;

package/dist/component/alignable.js

@@ -3,22 +3,22 @@ define(['lodash', 'ui/component/placeable'], function (_, makePlaceable) { 'use
     _ = _ && Object.prototype.hasOwnProperty.call(_, 'default') ? _['default'] : _;
     makePlaceable = makePlaceable && Object.prototype.hasOwnProperty.call(makePlaceable, 'default') ? makePlaceable['default'] : makePlaceable;
 
-    /**
-     * 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) 2017 (original work) 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) 2017 (original work) Open Assessment Technologies SA;
      */
     var defaultConfig = {};
     var alignDefaults = {
@@ -26,17 +26,17 @@ define(['lodash', 'ui/component/placeable'], function (_, makePlaceable) { 'use
       vPos: 'center'
     };
     var alignableComponent = {
-      /**
-       * Place the component using another element as a reference position
-       * @param {jQuery} $element - the reference element
-       * @param {Object} [options]
-       * @param {('left'|'center'|'right')} [options.hPos] - horizontal position relative to the reference element
-       * @param {('left'|'center'|'right')} [options.hOrigin] - the origin of the transformation
-       * @param {Number} [options.hOffset] - horizontal offset
-       * @param {('top'|'center'|'bottom')} [options.vPos] - vertical position relative to the reference element
-       * @param {('top'|'center'|'bottom')} [options.vOrigin] - the origin of the transformation
-       * @param {Number} [options.vOffset] - vertical offset
-       * @returns {Component} chains
+      /**
+       * Place the component using another element as a reference position
+       * @param {jQuery} $element - the reference element
+       * @param {Object} [options]
+       * @param {('left'|'center'|'right')} [options.hPos] - horizontal position relative to the reference element
+       * @param {('left'|'center'|'right')} [options.hOrigin] - the origin of the transformation
+       * @param {Number} [options.hOffset] - horizontal offset
+       * @param {('top'|'center'|'bottom')} [options.vPos] - vertical position relative to the reference element
+       * @param {('top'|'center'|'bottom')} [options.vOrigin] - the origin of the transformation
+       * @param {Number} [options.vOffset] - vertical offset
+       * @returns {Component} chains
        */
       alignWith: function alignWith($element, options) {
         var alignedCoords = this._getAlignedCoords($element, options);
@@ -44,13 +44,13 @@ define(['lodash', 'ui/component/placeable'], function (_, makePlaceable) { 'use
         return this.moveTo(alignedCoords.x, alignedCoords.y);
       },
 
-      /**
-       * Place the component so it is horizontally aligned with a reference element
-       * @param {jQuery} $element - the reference element
-       * @param {('left'|'center'|'right')} [hPos] - horizontal position relative to the reference element
-       * @param {('left'|'center'|'right')} [hOrigin] - the origin of the transformation
-       * @param {Number} [hOffset] - horizontal offset
-       * @returns {Component} chains
+      /**
+       * Place the component so it is horizontally aligned with a reference element
+       * @param {jQuery} $element - the reference element
+       * @param {('left'|'center'|'right')} [hPos] - horizontal position relative to the reference element
+       * @param {('left'|'center'|'right')} [hOrigin] - the origin of the transformation
+       * @param {Number} [hOffset] - horizontal offset
+       * @returns {Component} chains
        */
       hAlignWith: function hAlignWith($element, hPos, hOrigin, hOffset) {
         var alignedCoords = this._getAlignedCoords($element, {
@@ -62,13 +62,13 @@ define(['lodash', 'ui/component/placeable'], function (_, makePlaceable) { 'use
         return this.moveToX(alignedCoords.x);
       },
 
-      /**
-       * Place the component so it is vertically aligned with a reference element
-       * @param {jQuery} $element - the reference element
-       * @param {('top'|'center'|'bottom')} [vPos] - vertical position relative to the reference element
-       * @param {('top'|'center'|'bottom')} [vOrigin] - the origin of the transformation
-       * @param {Number} [vOffset] - vertical offset
-       * @returns {Component} chains
+      /**
+       * Place the component so it is vertically aligned with a reference element
+       * @param {jQuery} $element - the reference element
+       * @param {('top'|'center'|'bottom')} [vPos] - vertical position relative to the reference element
+       * @param {('top'|'center'|'bottom')} [vOrigin] - the origin of the transformation
+       * @param {Number} [vOffset] - vertical offset
+       * @returns {Component} chains
        */
       vAlignWith: function vAlignWith($element, vPos, vOrigin, vOffset) {
         var alignedCoords = this._getAlignedCoords($element, {
@@ -80,18 +80,18 @@ define(['lodash', 'ui/component/placeable'], function (_, makePlaceable) { 'use
         return this.moveToY(alignedCoords.y);
       },
 
-      /**
-       * Get the coordinates of the component so it is aligned with a reference element
-       * @param {jQuery} $element - the reference element
-       * @param {Object} [options]
-       * @param {('left'|'center'|'right')} [options.hPos] - horizontal position relative to the reference element
-       * @param {('left'|'center'|'right')} [options.hOrigin] - the origin of the transformation
-       * @param {Number} [options.hOffset] - horizontal offset
-       * @param {('top'|'center'|'bottom')} [options.vPos] - vertical position relative to the reference element
-       * @param {('top'|'center'|'bottom')} [options.vOrigin] - the origin of the transformation
-       * @param {Number} [options.vOffset] - vertical offset
-       * @returns {x,y} - the aligned coordinates
-       * @private
+      /**
+       * Get the coordinates of the component so it is aligned with a reference element
+       * @param {jQuery} $element - the reference element
+       * @param {Object} [options]
+       * @param {('left'|'center'|'right')} [options.hPos] - horizontal position relative to the reference element
+       * @param {('left'|'center'|'right')} [options.hOrigin] - the origin of the transformation
+       * @param {Number} [options.hOffset] - horizontal offset
+       * @param {('top'|'center'|'bottom')} [options.vPos] - vertical position relative to the reference element
+       * @param {('top'|'center'|'bottom')} [options.vOrigin] - the origin of the transformation
+       * @param {Number} [options.vOffset] - vertical offset
+       * @returns {x,y} - the aligned coordinates
+       * @private
        */
       _getAlignedCoords: function _getAlignedCoords($element, options) {
         var $container = this.getContainer(),
@@ -184,19 +184,19 @@ define(['lodash', 'ui/component/placeable'], function (_, makePlaceable) { 'use
         };
       },
 
-      /**
-       * The default hOrigin changes according to the hPos value
-       * - left => right
-       *              REFERENCE_ELEMENT
-       *     COMPONENT
-       * - center => center
-       *              REFERENCE_ELEMENT
-       *                  COMPONENT
-       * - right => left
-       *              REFERENCE_ELEMENT
-       *                               COMPONENT
-       * @returns {('left'|'center'|'right')}
-       * @private
+      /**
+       * The default hOrigin changes according to the hPos value
+       * - left => right
+       *              REFERENCE_ELEMENT
+       *     COMPONENT
+       * - center => center
+       *              REFERENCE_ELEMENT
+       *                  COMPONENT
+       * - right => left
+       *              REFERENCE_ELEMENT
+       *                               COMPONENT
+       * @returns {('left'|'center'|'right')}
+       * @private
        */
       _getDefaultHOrigin: function _getDefaultHOrigin(hPos) {
         var hOrigin;
@@ -225,18 +225,18 @@ define(['lodash', 'ui/component/placeable'], function (_, makePlaceable) { 'use
         return hOrigin;
       },
 
-      /**
-       * The default vOrigin changes according to the vPos value
-       * - top => bottom
-       *                               COMPONENT
-       *              REFERENCE_ELEMENT
-       * - center => center
-       *              REFERENCE_ELEMENT COMPONENT
-       * - bottom => top
-       *              REFERENCE_ELEMENT
-       *                               COMPONENT
-       * @returns {('top'|'center'|'bottom')}
-       * @private
+      /**
+       * The default vOrigin changes according to the vPos value
+       * - top => bottom
+       *                               COMPONENT
+       *              REFERENCE_ELEMENT
+       * - center => center
+       *              REFERENCE_ELEMENT COMPONENT
+       * - bottom => top
+       *              REFERENCE_ELEMENT
+       *                               COMPONENT
+       * @returns {('top'|'center'|'bottom')}
+       * @private
        */
       _getDefaultVOrigin: function _getDefaultVOrigin(vPos) {
         var vOrigin;
@@ -265,9 +265,9 @@ define(['lodash', 'ui/component/placeable'], function (_, makePlaceable) { 'use
         return vOrigin;
       }
     };
-    /**
-     * @param {Component} component - an instance of ui/component
-     * @param {Object} config
+    /**
+     * @param {Component} component - an instance of ui/component
+     * @param {Object} config
      */
 
     function makeAlignable(component, config) {