Add jsdoc

* add dependency jsdoc
* create jsdoc npm script
* ignore jsdoc output

Author: mroderick

.eslintignore

@@ -2,3 +2,4 @@ coverage/*
 dist/*
 test/*-test.js
 site/*
+out/*

.gitignore

@@ -4,3 +4,4 @@ site/
 coverage/
 dist/
 .nyc_output/
+out

jsdoc.conf.json

@@ -0,0 +1,18 @@
+{
+    "plugins": ["plugins/markdown"],
+    "recurseDepth": 10,
+    "source": {
+        "include": "lib/",
+        "includePattern": ".+\\.js(doc)?$",
+        "excludePattern": "(^|\\/|\\\\)_"
+    },
+    "sourceType": "module",
+    "tags": {
+        "allowUnknownTags": true,
+        "dictionaries": ["jsdoc","closure"]
+    },
+    "templates": {
+        "cleverLinks": false,
+        "monospaceLinks": false
+    }
+}

package-lock.json

@@ -18,6 +18,7 @@
     "build": "run-s build:dist-folder build:bundle",
     "build:bundle": "rollup -c > dist/samsam.js",
     "build:dist-folder": "mkdirp dist",
+    "jsdoc": "jsdoc -c jsdoc.conf.json",
     "lint": "eslint .",
     "prepublishOnly": "npm run build && mkdocs gh-deploy -r upstream || mkdocs gh-deploy -r origin",
     "test": "mocha ./lib/*.test.js",
@@ -47,6 +48,7 @@
     "eslint-plugin-mocha": "^6.0.0",
     "eslint-plugin-prettier": "^3.1.0",
     "husky": "^0.14.3",
+    "jsdoc": "^3.6.3",
     "jsdom": "^13.0.0",
     "jsdom-global": "^3.0.2",
     "lint-staged": "^6.1.0",