fix(controls): Ensured that fullscreen is the last icon on the contro…

…l bar; added missing documentation

src/js/controls.ts

@@ -322,16 +322,17 @@ class Controls implements PlayerComponent {
             ],
         };
 
-        if (isVideo(this.player.getElement())) {
-            this.fullscreen = new Fullscreen(this.player);
-            this.items.right.push(this.fullscreen);
-        }
-
+        // Append the custom items (if any)
         const customItems = this.player.getCustomControls();
-        // Append the custom items
         customItems.forEach(item => {
             this.items[item.position].push(item);
         });
+
+        // Make sure fullscreen is always the last one
+        if (isVideo(this.player.getElement())) {
+            this.fullscreen = new Fullscreen(this.player);
+            this.items.right.push(this.fullscreen);
+        }
     }
 
     /**
@@ -377,7 +378,7 @@ class Controls implements PlayerComponent {
     }
 
     /**
-     *
+     * Create a button for custom control items and activate `click` event on it.
      *
      * @private
      * @param {ControlItem} item
@@ -395,7 +396,7 @@ class Controls implements PlayerComponent {
     }
 
     /**
-     *
+     * Remove a custom control button and deactivate `click` event on it.
      *
      * @private
      * @param {ControlItem} item

src/js/interfaces/control-item.ts

@@ -6,9 +6,34 @@
  * @export
  */
 export default interface ControlItem {
+    /**
+     * The icon image to present the custom control
+     *
+     * @type string
+     */
     icon: string;
+    /**
+     * The custom control label (for accessibility purposes)
+     *
+     * @type string
+     */
     title: string;
+    /**
+     * The custom control position (left. middle or right)
+     *
+     * @type string
+     */
     position: string;
+    /**
+     * Flag to indicate is a custom control
+     *
+     * @type boolean
+     */
     custom?: boolean;
+    /**
+     * The custom control callback to be executed when clicking on it
+     *
+     * @memberof ControlItem
+     */
     click(): void;
 }