Add more precise types for the package-up utility

Author: stof

lib/utils/package-up.js

@@ -16,13 +16,18 @@ const { fileURLToPath } = require('url');
 /**
  * Inlined version of the package "package-up" (ESM only).
  *
- * @param {string} cwd The directory to start searching from.
+ * @param {object} options
+ * @param {string} options.cwd The directory to start searching from.
  * @returns {string|undefined} The path to the nearest package.json file or undefined if not found.
  */
 module.exports = function({ cwd }) {
     return findUpSync('package.json', { cwd, type: 'file' });
 };
 
+/**
+ * @param {string|URL} urlOrPath
+ * @returns {string}
+ */
 function toPath(urlOrPath) {
     return urlOrPath instanceof URL ? fileURLToPath(urlOrPath) : urlOrPath;
 }
@@ -32,7 +37,7 @@ function toPath(urlOrPath) {
  *
  * @param {string} name The name of the file to find
  * @param {object} options
- * @param {string} options.cwd The directory to start searching from.
+ * @param {string=} options.cwd The directory to start searching from.
  * @returns {string|undefined} The path to the file found or undefined if not found.
  */
 function findUpSync(name, { cwd = process.cwd() } = {}) {