Enable .d.ts generation from .js source

.gitignore

@@ -4,6 +4,7 @@ docs/_dist
 mocha.js
 .karma/
 !lib/mocha.js
+/types
 
 #########################################
 # NON-MOCHA STUFF GOES BELOW THIS THING #

index.d.ts

@@ -0,0 +1 @@
+export = import('./types/mocha');

lib/cli/options.js

@@ -165,9 +165,8 @@ const parseMochaOpts = content =>
 
 /**
  * Given filepath in `args.opts`, attempt to load and parse a `mocha.opts` file.
- * @param {Object} [args] - Arguments object
- * @param {string|boolean} [args.opts] - Filepath to mocha.opts; defaults to whatever's in `mocharc.opts`, or `false` to skip
- * @returns {external:yargsParser.Arguments|void} If read, object containing parsed arguments
+ * @param {import('./options_t').MochaArgs} [args] - Arguments object
+ * @returns {import('yargs-parser').Arguments | void} If read, object containing parsed arguments
  * @memberof module:lib/cli/options
  * @see {@link /#mochaopts|mocha.opts}
  * @public
@@ -210,11 +209,10 @@ module.exports.loadMochaOpts = loadMochaOpts;
 
 /**
  * Given path to config file in `args.config`, attempt to load & parse config file.
- * @param {Object} [args] - Arguments object
- * @param {string|boolean} [args.config] - Path to config file or `false` to skip
+ * @param {import('./options_t').MochaArgs} [args] - Arguments object
  * @public
  * @memberof module:lib/cli/options
- * @returns {external:yargsParser.Arguments|void} Parsed config, or nothing if `args.config` is `false`
+ * @returns {import('yargs-parser').Arguments | void} Parsed config, or nothing if `args.config` is `false`
  */
 const loadRc = (args = {}) => {
   if (args.config !== false) {
@@ -227,11 +225,10 @@ module.exports.loadRc = loadRc;
 
 /**
  * Given path to `package.json` in `args.package`, attempt to load config from `mocha` prop.
- * @param {Object} [args] - Arguments object
- * @param {string|boolean} [args.config] - Path to `package.json` or `false` to skip
+ * @param {import('./options_t').MochaArgs} [args] - Arguments object
  * @public
  * @memberof module:lib/cli/options
- * @returns {external:yargsParser.Arguments|void} Parsed config, or nothing if `args.package` is `false`
+ * @returns {import('yargs-parser').Arguments | void} Parsed config, or nothing if `args.package` is `false`
  */
 const loadPkgRc = (args = {}) => {
   let result;
@@ -275,7 +272,7 @@ module.exports.loadPkgRc = loadPkgRc;
  * @param {string|string[]} [argv] - Arguments to parse
  * @public
  * @memberof module:lib/cli/options
- * @returns {external:yargsParser.Arguments} Parsed args from everything
+ * @returns {import('yargs-parser').Arguments} Parsed args from everything
  */
 const loadOptions = (argv = []) => {
   let args = parse(argv);

lib/cli/options_t.ts

@@ -0,0 +1,7 @@
+export interface MochaArgs {
+  /** Path to `package.json` or `false` to skip */
+  config?: string | false;
+  package?: boolean;
+  /** Filepath to mocha.opts; defaults to whatever's in `mocharc.opts`, or `false` to skip */
+  opts?: string | false;
+}

lib/cli/run-option-metadata.js

@@ -9,7 +9,7 @@
 
 /**
  * Dictionary of yargs option types to list of options having said type
- * @type {{string:string[]}}
+ * @type {Record<string, string[]>}
  * @private
  */
 exports.types = {
@@ -63,7 +63,7 @@ exports.types = {
 /**
  * Option aliases keyed by canonical option name.
  * Arrays used to reduce
- * @type {{string:string[]}}
+ * @type {Record<string, string[]>}
  * @private
  */
 exports.aliases = {

lib/utils.js

@@ -708,7 +708,7 @@ exports.isPromise = function isPromise(value) {
  * Clamps a numeric value to an inclusive range.
  *
  * @param {number} value - Value to be clamped.
- * @param {numer[]} range - Two element array specifying [min, max] range.
+ * @param {number[]} range - Two element array specifying [min, max] range.
  * @returns {number} clamped value
  */
 exports.clamp = function clamp(value, range) {