@modernpoacher/deps 2.2.30 → 2.2.32

package/bin/bash/deps.sh

@@ -7,13 +7,6 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 EXP="[-0-9a-zA-Z]*$"
 
 function update {

package/bin/bash/head.sh

@@ -7,13 +7,6 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 EXP="[-0-9a-zA-Z]*$"
 
 function report {

package/bin/bash/push.sh

@@ -7,13 +7,6 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 EXP="[-0-9a-zA-Z]*$"
 
 function report {

package/bin/bash/wipe.sh

@@ -7,13 +7,6 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 EXP="[-0-9a-zA-Z]*$"
 
 function has_git {

package/bin/common/index.mjs

@@ -83,19 +83,25 @@ const SP = String.fromCodePoint(32)
  *  @param {string} v
  *  @returns {string}
  */
-export const trimEnd = (v) => v.trimEnd()
+export function trim (v) {
+  return v.split(LF).map(trimEnd).join(LF).trim()
+}
 
 /**
  *  @param {string} v
  *  @returns {string}
  */
-export const tidy = (v) => v.replace(/\n{2,}}/gm, LF).trim()
+export function trimEnd (v) {
+  return v.trimEnd()
+}
 
 /**
  *  @param {string} v
  *  @returns {string}
  */
-export const trim = (v) => v.split(LF).map(trimEnd).join(LF).trim()
+export function tidy (v) {
+  return v.replace(/\n{2,}}/gm, LF).trim()
+}
 
 const getRmrfCommands = PLATFORM === 'win32'
   ? () => tidy(`
@@ -211,18 +217,40 @@ export function handleComplete (e) {
 /**
  *  @param {{ code?: number, message?: string }} e
  */
-const handlePackageError = ({ message = MESSAGE }) => { info(`Package error: "${message}"`) }
+function handlePackageError ({ message = MESSAGE }) {
+  info(`Package error: "${message}"`)
+}
 
 /**
  *  @param {{ code?: number, message?: string }} e
  */
-const handleConfigurationError = ({ message = MESSAGE }) => { info(`Configuration error: "${message}"`) }
+function handleConfigurationError ({ message = MESSAGE }) {
+  info(`Configuration error: "${message}"`)
+}
 
-const getPackageJsonPath = (directory = DIRECTORY) => resolve(join(directory, 'package.json'))
+/**
+ *
+ * @param directory
+ */
+function getPackageJsonPath (directory = DIRECTORY) {
+  return resolve(join(directory, 'package.json'))
+}
 
-const getDepsRcPath = (directory = DIRECTORY) => resolve(join(directory, '.depsrc'))
+/**
+ *
+ * @param directory
+ */
+function getDepsRcPath (directory = DIRECTORY) {
+  return resolve(join(directory, '.depsrc'))
+}
 
-const getDepsRcJsonPath = (directory = DIRECTORY) => resolve(join(directory, '.depsrc.json'))
+/**
+ *
+ * @param directory
+ */
+function getDepsRcJsonPath (directory = DIRECTORY) {
+  return resolve(join(directory, '.depsrc.json'))
+}
 
 /**
  *  @param {string} directory

package/bin/deps/deps.sh

@@ -7,11 +7,4 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 node "$BIN/node/deps.mjs" "$@"

package/bin/deps/execute.sh

@@ -7,11 +7,4 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 node "$BIN/node/execute.mjs" "$@"

package/bin/deps/head.sh

@@ -7,11 +7,4 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 node "$BIN/node/head.mjs" "$@"

package/bin/deps/install.sh

@@ -7,11 +7,4 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 node "$BIN/node/install.mjs" "$@"

package/bin/deps/push.sh

@@ -7,11 +7,4 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 node "$BIN/node/push.mjs" "$@"

package/bin/deps/wipe.sh

@@ -7,11 +7,4 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 node "$BIN/node/wipe.mjs" "$@"

package/bin/deps.sh

@@ -9,11 +9,4 @@ source "$BIN/common.sh"
 
 source_home "$BIN"
 
-# echo SSH auth sock is $SSH_AUTH_SOCK
-# echo Home is $HOME
-# echo Path is $PATH
-
-# echo DIR is $DIR
-# echo BIN is $BIN
-
 node "$BIN/deps.mjs" "$@"

package/bin/node/execute.mjs

@@ -25,6 +25,8 @@ import {
 import {
   MESSAGE,
   AUTHOR,
+  gitConfigUserName,
+  gitConfigUserEmail,
   catGitRefsRemotesOriginHead,
   awkGitRemoteShowOriginHead,
   gitRevParseShowTopLevel,
@@ -147,6 +149,26 @@ async function getAuthorFromConfiguration (directory) {
   )
 }
 
+/**
+ *  @function getAuthorFromGit
+ *  @description
+ *  Interrogates Git config for the user name and email
+ *  @param {string} directory
+ *  @returns {Promise<string | null>}
+ */
+async function getAuthorFromGit (directory) {
+  log('getAuthorFromGitConfig')
+
+  const GIT = {
+    name: await gitConfigUserName(directory),
+    email: await gitConfigUserEmail(directory)
+  }
+
+  return (
+    getAuthor(GIT)
+  )
+}
+
 /**
  *  @function getAuthorFromPackage
  *  @description
@@ -201,7 +223,7 @@ async function getMessageFromConfiguration (directory) {
  *  @returns {Promise<string | { name: string; email: string }>}
  */
 async function toAuthor (author, directory) {
-  return author || await getAuthorFromConfiguration(directory) || await getAuthorFromPackage(directory) || AUTHOR
+  return author || await getAuthorFromConfiguration(directory) || await getAuthorFromGit(directory) || await getAuthorFromPackage(directory) || AUTHOR
 }
 
 /**
@@ -336,8 +358,10 @@ async function iterate (directory, registry, force, message, author) {
     try {
       if (D === await gitRevParseShowTopLevel(D)) {
         const B = await isHeadDefaultBranch(D)
+
         if (B) {
           const ignore = await getIgnoreFromConfiguration(D)
+
           if (!ignore) {
             await execute(D, registry, force, await toMessage(message, D), await toAuthor(author, D))
           }
@@ -355,6 +379,7 @@ async function iterate (directory, registry, force, message, author) {
  *  @param {boolean} force
  *  @param {string} message
  *  @param {string | { name: string; email: string }} author
+ *  @returns {Promise<void>}
  */
 async function iteratePath (directory, registry, force, message, author) {
   log('iteratePath')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modernpoacher/deps",
-  "version": "2.2.30",
+  "version": "2.2.32",
   "description": "Update NPM package dependencies from the command line",
   "keywords": [
     "deps",
@@ -54,26 +54,26 @@
     "deps-wipe": "bin/deps/wipe.sh"
   },
   "dependencies": {
-    "@sequencemedia/write": "^0.2.2",
+    "@sequencemedia/write": "^0.2.9",
     "commander": "^14.0.1",
-    "debug": "^4.4.1",
+    "debug": "^4.4.3",
     "glob": "^11.0.3",
     "strip-ansi": "^7.1.2",
     "supports-color": "^10.2.2"
   },
   "devDependencies": {
-    "@sequencemedia/eslint-config-standard": "^0.2.80",
-    "@sequencemedia/eslint-config-typescript": "^0.1.138",
-    "@sequencemedia/eslint-merge": "^0.0.48",
+    "@sequencemedia/eslint-config-standard": "^0.2.85",
+    "@sequencemedia/eslint-config-typescript": "^0.1.146",
+    "@sequencemedia/eslint-merge": "^0.0.52",
     "@types/chai": "^5.2.2",
     "@types/debug": "^4.1.12",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^24.3.2",
-    "@typescript-eslint/parser": "^8.43.0",
+    "@types/node": "^24.5.2",
+    "@typescript-eslint/parser": "^8.44.1",
     "chai": "^6.0.1",
     "cross-env": "^10.0.0",
-    "eslint": "^9.35.0",
-    "eslint-plugin-jsdoc": "^56.1.2",
+    "eslint": "^9.36.0",
+    "eslint-plugin-jsdoc": "^60.1.1",
     "globals": "^16.4.0",
     "husky": "^9.1.7",
     "mocha": "^11.7.2"

package/src/common/format/index.mjs

@@ -0,0 +1,63 @@
+import debug from 'debug'
+
+import stripAnsi from 'strip-ansi'
+
+const LF = String.fromCodePoint(32)
+
+/**
+ *  @param {string} v
+ *  @returns {string}
+ */
+export function tidy (v) {
+  return v.replace(/\n{2,}}/gm, LF).trim()
+}
+
+/**
+ *  @param {string} v
+ *  @returns {string}
+ */
+export function trimEnd (v) {
+  return v.trimEnd()
+}
+
+/**
+ *  @param {string} v
+ *  @returns {string}
+ */
+export function trim (v) {
+  return v.split(LF).map(trimEnd).join(LF).trim()
+}
+
+/**
+ *  @param {string} v
+ *  @returns {boolean}
+ */
+function filter (v) {
+  return Boolean(stripAnsi(v).trim())
+}
+
+/**
+ *  @param {string} key
+ *  @returns {(value: string) => void}
+ */
+export function use (key) {
+  const log = debug(`@modernpoacher/deps:${key}`)
+
+  /**
+   *  @param {string} v
+   *  @returns {void}
+   */
+  function write (v) {
+    log(v.trimEnd())
+  }
+
+  /**
+   *  @param {string} value
+   *  @returns {void}
+   */
+  return function use (value) {
+    value.split(LF)
+      .filter(filter)
+      .forEach(write)
+  }
+}

package/src/common/git/index.mjs

@@ -77,13 +77,25 @@ const LF = String.fromCodePoint(10)
  *  @param {string} v
  *  @returns {string}
  */
-const trimEnd = (v) => v.trimEnd()
+export function trim (v) {
+  return v.split(LF).map(trimEnd).join(LF).trim()
+}
 
 /**
  *  @param {string} v
  *  @returns {string}
  */
-const trim = (v) => v.split(LF).map(trimEnd).join(LF).trim()
+export function trimEnd (v) {
+  return v.trimEnd()
+}
+
+/**
+ *  @param {string} v
+ *  @returns {string}
+ */
+export function tidy (v) {
+  return v.replace(/\n{2,}}/gm, LF).trim()
+}
 
 /**
  *  @param {string} v
@@ -126,6 +138,10 @@ export function use (key) {
     log(v.trimEnd())
   }
 
+  /**
+   *  @param {string} value
+   *  @returns {void}
+   */
   return function use (value) {
     value.split(LF)
       .filter(filter)
@@ -214,7 +230,7 @@ export function err (key, directory) {
  *  @param {{code?: number, message?: string}} e
  *  @returns {number}
  */
-const getErrorCode = ({ code = 0 } = {}) => code
+const getErrorCode = ({ code = 0 }) => code
 
 /**
  *  @function getErrorMessage
@@ -223,7 +239,7 @@ const getErrorCode = ({ code = 0 } = {}) => code
  *  @param {{code?: number, message?: string}} e
  *  @returns {string}
  */
-const getErrorMessage = ({ message = '' } = {}) => message
+const getErrorMessage = ({ message = '' }) => message
 
 /**
  *  @function isCommandError
@@ -241,6 +257,78 @@ function isCommandError (e) {
   )
 }
 
+/**
+ *  @function gitConfigUserName
+ *  @description
+ *  Get the user email from Git config
+ *  @param {string} d - A directory configured for Git
+ *  @returns {Promise<string>}
+ */
+export function gitConfigUserName (d = DIRECTORY) {
+  const directory = normalize(d.trim())
+
+  return (
+    new Promise((resolve, reject) => {
+      const commands = 'git config user.name'
+      const options = getOptions(directory)
+      /**
+       *  @type {HandleComplete}
+       */
+      function handleComplete (e, v) {
+        if (!e) {
+          resolve(trim(v))
+        } else {
+          reject(e)
+        }
+      }
+
+      const {
+        stdout,
+        stderr
+      } = exec(commands, options, handleComplete)
+
+      if (stdout) stdout.on('data', out('git-config-user-name', directory))
+      if (stderr) stderr.on('data', err('git-config-user-name', directory))
+    })
+  )
+}
+
+/**
+ *  @function gitConfigUserEmail
+ *  @description
+ *  Get the user email from Git config
+ *  @param {string} d - A directory configured for Git
+ *  @returns {Promise<string>}
+ */
+export function gitConfigUserEmail (d = DIRECTORY) {
+  const directory = normalize(d.trim())
+
+  return (
+    new Promise((resolve, reject) => {
+      const commands = 'git config user.email'
+      const options = getOptions(directory)
+      /**
+       *  @type {HandleComplete}
+       */
+      function handleComplete (e, v) {
+        if (!e) {
+          resolve(trim(v))
+        } else {
+          reject(e)
+        }
+      }
+
+      const {
+        stdout,
+        stderr
+      } = exec(commands, options, handleComplete)
+
+      if (stdout) stdout.on('data', out('git-config-user-email', directory))
+      if (stderr) stderr.on('data', err('git-config-user-email', directory))
+    })
+  )
+}
+
 /**
  *  @function catGitRefsRemotesOriginHead
  *  @description

package/src/common/index.mjs

@@ -37,19 +37,25 @@ const SP = String.fromCodePoint(32)
  *  @param {string} v
  *  @returns {string}
  */
-export const tidy = (v) => v.replace(/\n{2,}}/gm, LF).trim()
+export function trim (v) {
+  return v.split(LF).map(trimEnd).join(LF).trim()
+}
 
 /**
  *  @param {string} v
  *  @returns {string}
  */
-export const trimEnd = (v) => v.trimEnd()
+export function trimEnd (v) {
+  return v.trimEnd()
+}
 
 /**
  *  @param {string} v
  *  @returns {string}
  */
-export const trim = (v) => v.split(LF).map(trimEnd).join(LF).trim()
+export function tidy (v) {
+  return v.replace(/\n{2,}}/gm, LF).trim()
+}
 
 /**
  *  @function getSaveProdParameter
@@ -58,7 +64,9 @@ export const trim = (v) => v.split(LF).map(trimEnd).join(LF).trim()
  *  @param {string} commands commands string
  *  @returns {string}
  */
-export const getSaveProdParameter = (commands) => commands.concat(' --save-prod')
+export function getSaveProdParameter (commands) {
+  return commands.concat(' --save-prod')
+}
 
 /**
  *  @function getSaveDevParameter
@@ -67,7 +75,9 @@ export const getSaveProdParameter = (commands) => commands.concat(' --save-prod'
  *  @param {string} commands commands string
  *  @returns {string}
  */
-export const getSaveDevParameter = (commands) => commands.concat(' --save-dev')
+export function getSaveDevParameter (commands) {
+  return commands.concat(' --save-dev')
+}
 
 /**
  *  @function getSaveBundleParameter
@@ -76,7 +86,9 @@ export const getSaveDevParameter = (commands) => commands.concat(' --save-dev')
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
-export const getSaveBundleParameter = (commands) => commands.concat(' --save-bundle')
+export function getSaveBundleParameter (commands) {
+  return commands.concat(' --save-bundle')
+}
 
 /**
  *  @function getSaveOptionalParameter
@@ -85,7 +97,9 @@ export const getSaveBundleParameter = (commands) => commands.concat(' --save-bun
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
-export const getSaveOptionalParameter = (commands) => commands.concat(' --save-optional')
+export function getSaveOptionalParameter (commands) {
+  return commands.concat(' --save-optional')
+}
 
 /**
  *  @function getRegistryParameter
@@ -95,7 +109,9 @@ export const getSaveOptionalParameter = (commands) => commands.concat(' --save-o
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
-export const getRegistryParameter = (r, commands) => r ? commands.concat(` --registry ${r}`) : commands
+export function getRegistryParameter (r, commands) {
+  return r ? commands.concat(` --registry ${r}`) : commands
+}
 
 /**
  *  @function getForceParameter
@@ -105,7 +121,9 @@ export const getRegistryParameter = (r, commands) => r ? commands.concat(` --reg
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
-export const getForceParameter = (f, commands) => f ? commands.concat(' --force') : commands
+export function getForceParameter (f, commands) {
+  return f ? commands.concat(' --force') : commands
+}
 
 /**
  *  @function getNoSaveParameter
@@ -115,7 +133,9 @@ export const getForceParameter = (f, commands) => f ? commands.concat(' --force'
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
-export const getNoSaveParameter = (s, commands) => s ? commands : commands.concat(' --no-save')
+export function getNoSaveParameter (s, commands) {
+  return s ? commands : commands.concat(' --no-save')
+}
 
 /**
  *  @function getSaveExactParameter
@@ -124,7 +144,9 @@ export const getNoSaveParameter = (s, commands) => s ? commands : commands.conca
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
-export const getSaveExactParameter = (commands) => commands.concat(' --save-exact')
+export function getSaveExactParameter (commands) {
+  return commands.concat(' --save-exact')
+}
 
 /**
  *  @function getExportPath
@@ -133,10 +155,12 @@ export const getSaveExactParameter = (commands) => commands.concat(' --save-exac
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
-export const getExportPath = (commands) => `
+export function getExportPath (commands) {
+  return `
 export PATH=/usr/local/bin:$PATH &> /dev/null
 ${commands}
 `
+}
 
 /**
  *  @function getNvm
@@ -145,10 +169,12 @@ ${commands}
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
-export const getNvm = (commands) => `
+export function getNvm (commands) {
+  return `
 bash "${NVM}" 2> /dev/null
 ${commands}
 `
+}
 
 /**
  *  @function getCommands
@@ -168,7 +194,9 @@ export const getCommands = PLATFORM === 'win32'
  *  @param {Package | Configuration} deps
  *  @returns {Dependencies}
  */
-export const getProdDependencies = ({ dependencies = {} } = {}) => dependencies
+export function getProdDependencies ({ dependencies = {} }) {
+  return dependencies
+}
 
 /**
  *  @function getDevDependencies
@@ -177,7 +205,9 @@ export const getProdDependencies = ({ dependencies = {} } = {}) => dependencies
  *  @param {Package | Configuration} deps
  *  @returns {Dependencies}
  */
-export const getDevDependencies = ({ devDependencies = {} } = {}) => devDependencies
+export function getDevDependencies ({ devDependencies = {} }) {
+  return devDependencies
+}
 
 /**
  *  @function getOptionalDependencies
@@ -186,7 +216,9 @@ export const getDevDependencies = ({ devDependencies = {} } = {}) => devDependen
  *  @param {Package | Configuration} deps
  *  @returns {Dependencies}
  */
-export const getOptionalDependencies = ({ optionalDependencies = {} } = {}) => optionalDependencies
+export function getOptionalDependencies ({ optionalDependencies = {} }) {
+  return optionalDependencies
+}
 
 /**
  *  @function getBundleDependencies
@@ -195,7 +227,9 @@ export const getOptionalDependencies = ({ optionalDependencies = {} } = {}) => o
  *  @param {Package | Configuration} deps
  *  @returns {Dependencies}
  */
-export const getBundleDependencies = ({ bundleDependencies = {} } = {}) => bundleDependencies
+export function getBundleDependencies ({ bundleDependencies = {} }) {
+  return bundleDependencies
+}
 
 /**
  *  @function getPeerDependencies
@@ -204,7 +238,9 @@ export const getBundleDependencies = ({ bundleDependencies = {} } = {}) => bundl
  *  @param {Package | Configuration} deps
  *  @returns {Dependencies}
  */
-export const getPeerDependencies = ({ peerDependencies = {} } = {}) => peerDependencies
+export function getPeerDependencies ({ peerDependencies = {} }) {
+  return peerDependencies
+}
 
 /**
  *  @function getIgnore
@@ -213,7 +249,9 @@ export const getPeerDependencies = ({ peerDependencies = {} } = {}) => peerDepen
  *  @param {Configuration} deps
  *  @returns {boolean}
  */
-export const getIgnore = ({ ignore = false } = {}) => ignore === true
+export function getIgnore ({ ignore = false }) {
+  return ignore === true
+}
 
 /**
  *  @function getAuthor
@@ -222,7 +260,7 @@ export const getIgnore = ({ ignore = false } = {}) => ignore === true
  *  @param {Package | Configuration} deps
  *  @returns {string | null}
  */
-export const getAuthor = ({ author = '' } = {}) => {
+export function getAuthor ({ author = '' }) {
   if (typeof author === 'string') return author
   if (typeof (author || false) === 'object') {
     const {
@@ -250,7 +288,9 @@ export const getAuthor = ({ author = '' } = {}) => {
  *  @param {Configuration} deps
  *  @returns {string | null}
  */
-export const getMessage = ({ message = '' } = {}) => message || null
+export function getMessage ({ message = '' }) {
+  return message || null
+}
 
 /**
  *  @function isPreRelease
@@ -259,7 +299,9 @@ export const getMessage = ({ message = '' } = {}) => message || null
  *  @param {string} v
  *  @returns {boolean}
  */
-export const isPreRelease = (v) => /-/.test(v)
+export function isPreRelease (v) {
+  return /-/.test(v)
+}
 
 /**
  *  @function isExact
@@ -268,10 +310,15 @@ export const isPreRelease = (v) => /-/.test(v)
  *  @param {string} v
  *  @returns {boolean}
  */
-export const isExact = (v) => /^\d/.test(v)
+export function isExact (v) {
+  return /^\d/.test(v)
+}
 
 /**
- *  @param {[name: string, version: string]} entry
+ *  @param {[
+ *    name: string,
+ *    version: string
+ *  ]} entry
  *  @returns {boolean}
  */
 function includeVersionIsExact ([name, version]) {
@@ -279,7 +326,10 @@ function includeVersionIsExact ([name, version]) {
 }
 
 /**
- *  @param {[name: string, version: string]} entry
+ *  @param {[
+ *    name: string,
+ *    version: string
+ *  ]} entry
  *  @returns {boolean}
  */
 function excludeVersionIsExact ([name, version]) {
@@ -297,14 +347,20 @@ function excludeVersionIsExact ([name, version]) {
  *  Each entry is mapped to the same package name in `configurationDependencies` if it
  *  appears there. Otherwise, the `packageDependencies` version is used
  *  @param {Record<string, string>} configurationDependencies
- *  @returns {(entry: [name: string, version: string]) => {
+ *  @returns {(entry: [
+ *    name: string,
+ *    version: string
+ *  ]) => {
  *    name: string,
  *    version: string
  *  }}
  */
 function getMapToDepsExactVersionFromConfiguration (configurationDependencies) {
   /**
-   *  @param {[name: string, version: string]} entry
+   *  @param {[
+   *    name: string,
+   *    version: string
+   *  ]} entry
    *  @returns {{
    *    name: string,
    *    version: string
@@ -335,7 +391,10 @@ function getMapToDepsExactVersionFromConfiguration (configurationDependencies) {
  *
  *  Where the version is a pre-release, that version is used. Otherwise the version is
  *  set to `latest` to ensure that package is updated
- *  @param {[name: string, version: string]} entry
+ *  @param {[
+ *    name: string,
+ *    version: string
+ *  ]} entry
  *  @returns {{
  *    name: string,
  *    version: string
@@ -421,7 +480,9 @@ export function normalizeCommands (commands) {
  *  @param {DependencyDescriptor | { name?: string, version?: string }} dependencyDescriptor
  *  @returns {string}
  */
-export const transformDependency = ({ name = '@modernpoacher/deps', version = 'latest' } = {}) => `${name}@${version}`
+export function transformDependency ({ name = '@modernpoacher/deps', version = 'latest' }) {
+  return `${name}@${version}`
+}
 
 /**
  *  @function transform

package/src/index.mjs

@@ -87,6 +87,10 @@ export function use (key) {
     log(v.trimEnd())
   }
 
+  /**
+   *  @param {string} value
+   *  @returns {void}
+   */
   return function use (value) {
     value.split(LF)
       .filter(filter)

package/tsconfig.json

@@ -12,9 +12,9 @@
     "."
   ],
   "exclude": [
-    "test",
     ".circleci",
     ".github",
     ".husky",
+    "test"
   ]
 }