Add generic types and fix types on Input and Structs

Author: orblazer

src/input/gamepad/Gamepad.js

@@ -87,7 +87,7 @@ var Gamepad = new Class({
          * [description]
          *
          * @name Phaser.Input.Gamepad.Gamepad#buttons
-         * @type {array}
+         * @type {Phaser.Input.Gamepad.Button[]}
          * @default []
          * @since 3.0.0
          */
@@ -97,7 +97,7 @@ var Gamepad = new Class({
          * [description]
          *
          * @name Phaser.Input.Gamepad.Gamepad#axes
-         * @type {array}
+         * @type {Phaser.Input.Gamepad.Axis[]}
          * @default []
          * @since 3.0.0
          */

src/input/gamepad/GamepadManager.js

@@ -19,6 +19,12 @@ var Gamepad = require('./Gamepad');
  * @property {number} index - [description]
  */
 
+/**
+ * @callback GamepadHandler
+ *
+ * @property {GamepadEvent} event - [description]
+ */
+
 /**
  * @classdesc
  * [description]
@@ -77,7 +83,7 @@ var GamepadManager = new Class({
          * [description]
          *
          * @name Phaser.Input.Gamepad.GamepadManager#handler
-         * @type {?function}
+         * @type {?GamepadHandler}
          * @since 3.0.0
          */
         this.handler;

src/input/keyboard/KeyboardManager.js

@@ -13,6 +13,12 @@ var KeyMap = require('./keys/KeyMap');
 var ProcessKeyDown = require('./keys/ProcessKeyDown');
 var ProcessKeyUp = require('./keys/ProcessKeyUp');
 
+/**
+ * @callback KeyboardHandler
+ *
+ * @property {KeyboardEvent} event - [description]
+ */
+
 /**
  * @classdesc
  * The Keyboard class monitors keyboard input and dispatches keyboard events.
@@ -114,7 +120,7 @@ var KeyboardManager = new Class({
          * [description]
          *
          * @name Phaser.Input.Keyboard.KeyboardManager#handler
-         * @type {?function}
+         * @type {?KeyboardHandler}
          * @since 3.0.0
          */
         this.handler;

src/input/mouse/MouseManager.js

@@ -10,6 +10,12 @@ var Features = require('../../device/Features');
 //  https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent
 //  https://github.com/WICG/EventListenerOptions/blob/gh-pages/explainer.md
 
+/**
+ * @callback MouseHandler
+ *
+ * @property {MouseEvent} event - [description]
+ */
+
 /**
  * @classdesc
  * [description]
@@ -69,7 +75,7 @@ var MouseManager = new Class({
          * [description]
          *
          * @name Phaser.Input.Mouse.MouseManager#handler
-         * @type {null}
+         * @type {?MouseHandler}
          * @since 3.0.0
          */
         this.handler;
@@ -136,13 +142,13 @@ var MouseManager = new Class({
 
     /**
      * If the browser supports it, you can request that the pointer be locked to the browser window.
-     * 
+     *
      * This is classically known as 'FPS controls', where the pointer can't leave the browser until
      * the user presses an exit key.
-     * 
+     *
      * If the browser successfully enters a locked state, a `POINTER_LOCK_CHANGE_EVENT` will be dispatched,
      * from the games Input Manager, with an `isPointerLocked` property.
-     * 
+     *
      * It is important to note that pointer lock can only be enabled after an 'engagement gesture',
      * see: https://w3c.github.io/pointerlock/#dfn-engagement-gesture.
      *
@@ -165,7 +171,7 @@ var MouseManager = new Class({
      * @method Phaser.Input.Mouse.MouseManager#pointerLockChange
      * @since 3.0.0
      *
-     * @param {Event} event - The native event from the browser.
+     * @param {MouseHandler} event - The native event from the browser.
      */
     pointerLockChange: function (event)
     {

src/input/touch/TouchManager.js

@@ -75,7 +75,7 @@ var TouchManager = new Class({
          * [description]
          *
          * @name Phaser.Input.Touch.TouchManager#handler
-         * @type {TouchHandler}
+         * @type {?TouchHandler}
          * @since 3.0.0
          */
         this.handler;