chore: fix esdoc

esdoc.json

@@ -1,7 +1,5 @@
 {
   "source": "./lib",
   "destination": "./pages",
-  "plugins": [
-    {"name": "esdoc-es7-plugin"}
-  ]
+  "plugins": [{"name": "@itsjamie/esdoc-standard-plugin"}]
 }

lib/decorators/element.js

@@ -19,6 +19,7 @@ const { registerOrUpdateElement } = require('atom-utils')
  * placing the `include` decorator after the `element` one as shown in the
  * second example.**
  *
+ * @param  {Class} cls the class to decorate
  * @param  {string} elementName the node name of the element to register
  * @return {Function} the element class as returned by
  *                    `document.registerElement`

lib/decorators/include.js

@@ -3,6 +3,7 @@
 /**
  * Generates a decorator function to includes many `mixto` mixins into a class.
  *
+ * @param  {Class} cls the class to decorate
  * @param  {...Mixin} mixins the mixins to include in the class
  * @return {function(cls:Function):Function} the decorator function that will
  *                                           include the specified mixins

lib/minimap-element.js

@@ -1045,9 +1045,10 @@ class MinimapElement {
   /**
    * Callback triggered when the mouse is pressed on the MinimapElement canvas.
    *
-   * @param  {number} y the vertical coordinate of the event
-   * @param  {boolean} isLeftMouse was the left mouse button pressed?
-   * @param  {boolean} isMiddleMouse was the middle mouse button pressed?
+   * @param  {object} opts an options object with the following properties
+   * @param  {number} opts.y the vertical coordinate of the event
+   * @param  {boolean} opts.isLeftMouse was the left mouse button pressed?
+   * @param  {boolean} opts.isMiddleMouse was the middle mouse button pressed?
    * @access private
    */
   canvasPressed ({ y, isLeftMouse, isMiddleMouse }) {
@@ -1065,9 +1066,7 @@ class MinimapElement {
    * Callback triggered when the mouse left button is pressed on the
    * MinimapElement canvas.
    *
-   * @param  {MouseEvent} e the mouse event object
-   * @param  {number} e.pageY the mouse y position in page
-   * @param  {HTMLElement} e.target the source of the event
+   * @param  {number} y the mouse y position in page
    * @access private
    */
   canvasLeftMousePressed (y) {
@@ -1114,8 +1113,7 @@ class MinimapElement {
    * Callback triggered when the mouse middle button is pressed on the
    * MinimapElement canvas.
    *
-   * @param  {MouseEvent} e the mouse event object
-   * @param  {number} e.pageY the mouse y position in page
+   * @param  {number} y the mouse y position in page
    * @access private
    */
   canvasMiddleMousePressed (y) {
@@ -1203,9 +1201,10 @@ class MinimapElement {
    * A method triggered when the mouse is pressed over the visible area that
    * starts the dragging gesture.
    *
-   * @param  {number} y the vertical coordinate of the event
-   * @param  {boolean} isLeftMouse was the left mouse button pressed?
-   * @param  {boolean} isMiddleMouse was the middle mouse button pressed?
+   * @param  {object} opts an options object with the following properties
+   * @param  {number} opts.y the vertical coordinate of the event
+   * @param  {boolean} opts.isLeftMouse was the left mouse button pressed?
+   * @param  {boolean} opts.isMiddleMouse was the middle mouse button pressed?
    * @access private
    */
   startDrag ({ y, isLeftMouse, isMiddleMouse }) {
@@ -1251,9 +1250,11 @@ class MinimapElement {
   /**
    * The method called during the drag gesture.
    *
-   * @param  {number} y the vertical coordinate of the event
-   * @param  {boolean} isLeftMouse was the left mouse button pressed?
-   * @param  {boolean} isMiddleMouse was the middle mouse button pressed?
+   * @param  {object} opts an options object with the following properties
+   * @param  {number} opts.y the vertical coordinate of the event
+   * @param  {boolean} opts.isLeftMouse was the left mouse button pressed?
+   * @param  {boolean} opts.isMiddleMouse was the middle mouse button pressed?
+   * @param  {object} initial an object with the following properties
    * @param  {number} initial.dragOffset the mouse offset within the visible
    *                                     area
    * @param  {number} initial.offsetTop the MinimapElement offset at the moment

lib/minimap.js

@@ -578,7 +578,8 @@ class Minimap {
   /**
    * Sets the scroll top of the `TextEditor`.
    *
-   * @param {number} scrollTop the new scroll top value
+   * @param {number}  scrollTop the new scroll top value
+   * @param {boolean} ignoreTextEditorScroll ignore TeextEditor scroll
    */
   setTextEditorScrollTop (scrollTop, ignoreTextEditorScroll = false) {
     this.ignoreTextEditorScroll = ignoreTextEditorScroll

lib/mixins/canvas-drawer.js

@@ -293,7 +293,7 @@ module.exports = class CanvasDrawer extends Mixin {
    * changes.
    *
    * @param  {Function} method the render method to use for the lines drawing
-   * @param  {Array<Object>} intactRanges the intact ranges in the minimap
+   * @param  {Array<Object>} ranges the intact ranges in the minimap
    * @param  {number} firstRow the first row of the rendered region
    * @param  {number} lastRow the last row of the rendered region
    * @access private
@@ -408,8 +408,9 @@ module.exports = class CanvasDrawer extends Mixin {
   /**
    * Returns an array of tokens by line.
    *
-   * @param  {number} startRow The start row
-   * @param  {number} endRow The end row
+   * @param  {number}   startRow The start row
+   * @param  {number}   endRow The end row
+   * @param  {Function} callback The callback
    * @return {Array<Array>} An array of tokens by line
    * @access private
    */
@@ -751,6 +752,7 @@ module.exports = class CanvasDrawer extends Mixin {
    *
    * @param  {number} firstRow the first row of the rendered region
    * @param  {number} lastRow the last row of the rendered region
+   * @param  {Array<Object>} changes an array of changes
    * @return {Array<Object>} the intact ranges in the rendered region
    * @access private
    */