fix(types): Add jsdoc plugin to handle ts-style imports (#8225)

.jsdoc.json

@@ -21,7 +21,7 @@
           "class": "link-vjs"
         },
         {
-          "title": "v8.0.2 source",
+          "title": "v8.2.1 source",
           "link": "https://github.com/videojs/video.js",
           "class": "link-gh"
         },
@@ -59,6 +59,7 @@
     }
   },
   "plugins": [
+    "node_modules/jsdoc-tsimport-plugin/index.js",
     "plugins/markdown",
     "build/jsdoc-typeof-plugin"
   ],

package.json

@@ -125,6 +125,7 @@
     "husky": "^1.3.1",
     "is-ci": "^3.0.0",
     "jsdoc": "^3.6.11",
+    "jsdoc-tsimport-plugin": "^1.0.5",
     "karma": "^6.4.0",
     "lint-staged": "^10.5.4",
     "markdown-table": "^1.1.3",

src/js/big-play-button.js

@@ -5,10 +5,6 @@ import Button from './button.js';
 import Component from './component.js';
 import {isPromise, silencePromise} from './utils/promise';
 
-/**
- *  @typedef {import('../event-target').Event} Event
- */
-
 /**
  * The initial play button that shows before the video has played. The hiding of the
  * `BigPlayButton` get done via CSS and `Player` states.
@@ -38,7 +34,7 @@ class BigPlayButton extends Button {
    * This gets called when a `BigPlayButton` "clicked". See {@link ClickableComponent}
    * for more detailed information on what a click can be.
    *
-   * @param {Event} event
+   * @param {KeyboardEvent} event
    *        The `keydown`, `tap`, or `click` event that caused this function to be
    *        called.
    *

src/js/clickable-component.js

@@ -6,10 +6,6 @@ import * as Dom from './utils/dom.js';
 import log from './utils/log.js';
 import keycode from 'keycode';
 
-/**
- * @typedef { import('./player').default } Player
- */
-
 /**
  * Component which is clickable or keyboard actionable, but is not a
  * native HTML button.
@@ -21,7 +17,7 @@ class ClickableComponent extends Component {
   /**
    * Creates an instance of this class.
    *
-   * @param  {Player} player
+   * @param  { import('./player').default } player
    *         The `Player` that this class should be attached to.
    *
    * @param  {Object} [options]