Remove insecure dependency and add promisified API to docs

Author: milindl

Makefile

@@ -80,10 +80,10 @@ endef
 
 docs: node_modules/.dirstamp
 	@rm -rf docs
-	@./node_modules/jsdoc/jsdoc.js --destination docs \
+	@./node_modules/jsdoc/jsdoc.js --debug --destination docs \
 		--recurse -R ./README.md \
-		-t "./node_modules/toolkit-jsdoc/" \
-		--tutorials examples ./lib
+		-c ./jsdoc.conf \
+		--tutorials examples/ ./lib
 
 gh-pages: node_modules/.dirstamp
 	@./make_docs.sh

jsdoc.conf

@@ -0,0 +1,16 @@
+{
+    "plugins": [],
+    "recurseDepth": 10,
+    "source": {
+        "includePattern": ".+\\.js(doc|x)?$"
+    },
+    "sourceType": "module",
+    "tags": {
+        "allowUnknownTags": true,
+        "dictionaries": ["jsdoc","closure"]
+    },
+    "templates": {
+        "cleverLinks": false,
+        "monospaceLinks": false
+    }
+}

package-lock.json

@@ -38,7 +38,6 @@
     "jshint": "^2.10.1",
     "mocha": "^10.2.0",
     "node-gyp": "^9.3.1",
-    "toolkit-jsdoc": "^1.0.0",
     "typescript": "^5.1.6"
   },
   "dependencies": {