Implement ESDoc (#226)

* Start on esdoc

* Beef up ESDoc comments, alphabetize class methods

* More comments

* Add more comments, refactor _setUpButtons

.esdoc.js

@@ -0,0 +1,13 @@
+module.exports = {
+  source: './src',
+  destination: './esdoc',
+  plugins: [
+    {
+      name: 'esdoc-standard-plugin'
+    },
+    {
+      name: 'esdoc-ecmascript-proposal-plugin',
+      option: { all: true }
+    }
+  ]
+};

.gitignore

@@ -4,6 +4,7 @@
 /coverage/
 /cypress/
 /dist/
+/esdoc/
 /node_modules/
 /test/unit/dist
 /.DS_Store

package.json

@@ -24,6 +24,7 @@
   ],
   "scripts": {
     "build": "yarn clean && webpack --mode production",
+    "esdoc": "esdoc",
     "postbuild": "rm -f dist/removable-*",
     "clean": "rm -rf dist",
     "cy:open": "./node_modules/.bin/cypress open",
@@ -70,6 +71,9 @@
     "css-loader": "^1.0.0",
     "cypress": "^3.0.3",
     "del": "^3.0.0",
+    "esdoc": "^1.1.0",
+    "esdoc-ecmascript-proposal-plugin": "^1.0.0",
+    "esdoc-standard-plugin": "^1.0.0",
     "eslint": "^5.1.0",
     "eslint-loader": "^2.1.0",
     "eslint-plugin-mocha": "^5.1.0",

src/js/bind.js

@@ -78,7 +78,7 @@ export function bindCancelLink(link) {
 
 /**
  * Take an array of strings and look up methods by name, then bind them to `this`
- * @param {[String]} methods The names of methods to bind
+ * @param {String[]} methods The names of methods to bind
  */
 export function bindMethods(methods) {
   methods.map((method) => {