Add JSDoc to linting via eslint-plugin-jsdoc, address newly-reported …

…issues.

.eslintrc.json

@@ -8,11 +8,13 @@
     "es6": true
   },
   "plugins": [
+    "jsdoc",
     "n",
     "unicorn"
   ],
   "extends": [
     "eslint:all",
+    "plugin:jsdoc/recommended",
     "plugin:n/recommended",
     "plugin:unicorn/all"
   ],

append-to-array.js

@@ -6,9 +6,9 @@ const sliceSize = 1000;
 
 /**
  * Efficiently appends the source array to the destination array.
- * @param {Object[]} destination Destination Array.
- * @param {Object[]} source Source Array.
- * @returns void
+ * @param {object[]} destination Destination Array.
+ * @param {object[]} source Source Array.
+ * @returns {void}
  */
 const appendToArray = (destination, source) => {
   // NOTE: destination.push(...source) throws "RangeError: Maximum call stack

merge-options.js

@@ -4,9 +4,9 @@
 
 /**
  * Merges two options objects by combining config and replacing properties.
- * @param {Object} first First options object.
- * @param {Object} second Second options object.
- * @returns {Object} Merged options object.
+ * @param {object} first First options object.
+ * @param {object} second Second options object.
+ * @returns {object} Merged options object.
  */
 const mergeOptions = (first, second) => {
   const merged = {

package.json

@@ -84,6 +84,7 @@
     "cpy-cli": "5.0.0",
     "del": "7.1.0",
     "eslint": "8.56.0",
+    "eslint-plugin-jsdoc": "48.0.4",
     "eslint-plugin-n": "16.6.2",
     "eslint-plugin-unicorn": "50.0.1",
     "execa": "8.0.1",

parsers/jsonc-parse.js

@@ -6,7 +6,6 @@ const { parse, printParseErrorCode } = require("jsonc-parser");
 
 /**
  * Parses a JSONC string, returning the corresponding object.
- *
  * @param {string} text String to parse as JSONC.
  * @returns {object} Corresponding object.
  */

parsers/yaml-parse.js

@@ -6,7 +6,6 @@ const yaml = require("yaml");
 
 /**
  * Parses a YAML string, returning the corresponding object.
- *
  * @param {string} text String to parse as YAML.
  * @returns {object} Corresponding object.
  */

resolve-and-require.js

@@ -4,10 +4,10 @@
 
 /**
  * Wrapper for calling Node's require.resolve/require with an additional path.
- * @param {Object} req Node's require implementation (or equivalent).
- * @param {String} id Package identifier to require.
- * @param {String[]} dirs Directories to include when resolving paths.
- * @returns {Object} Exported module content.
+ * @param {object} req Node's require implementation (or equivalent).
+ * @param {string} id Package identifier to require.
+ * @param {string[]} dirs Directories to include when resolving paths.
+ * @returns {object} Exported module content.
  */
 const resolveAndRequire = (req, id, dirs) => {
   const resolvePaths = req.resolve.paths ? req.resolve.paths("") : [];