@modernpoacher/deps 2.2.19 → 2.2.21

package/src/common/index.mjs

@@ -5,14 +5,14 @@
  *  @typedef {DepsTypes.Configuration} Configuration
  */
 
-import debug from 'debug'
-
-import PATH from '#where-am-i'
-
 import {
   join
 } from 'node:path'
 
+import PATH from '#where-am-i'
+
+import debug from '#deps/src/common/debug'
+
 import {
   VERSION,
   PLATFORM
@@ -30,23 +30,31 @@ const log = debug('@modernpoacher/deps')
 
 log(`\`common\` (${VERSION} - ${PLATFORM}) is awake`)
 
+const LF = String.fromCharCode(10)
+const SP = String.fromCharCode(32)
+
 /**
  *  @param {string} v
  *  @returns {string}
  */
-export const tidy = (v) => v.replace(/\n{2,}}/gm, String.fromCharCode(10)).trim()
+export const tidy = (v) => v.replace(/\n{2,}}/gm, LF).trim()
 
 /**
  *  @param {string} v
  *  @returns {string}
  */
-export const trim = (v) => v.split(String.fromCharCode(10)).map((v) => v.trimEnd()).join(String.fromCharCode(10)).trim()
+export const trimEnd = (v) => v.trimEnd()
+
+/**
+ *  @param {string} v
+ *  @returns {string}
+ */
+export const trim = (v) => v.split(LF).map(trimEnd).join(LF).trim()
 
 /**
  *  @function getSaveProdParameter
- *
+ *  @description
  *  Get the `--save-prod` parameter
- *
  *  @param {string} commands commands string
  *  @returns {string}
  */
@@ -54,9 +62,8 @@ export const getSaveProdParameter = (commands) => commands.concat(' --save-prod'
 
 /**
  *  @function getSaveDevParameter
- *
+ *  @description
  *  Get the `--save-dev` parameter
- *
  *  @param {string} commands commands string
  *  @returns {string}
  */
@@ -64,9 +71,8 @@ export const getSaveDevParameter = (commands) => commands.concat(' --save-dev')
 
 /**
  *  @function getSaveBundleParameter
- *
+ *  @description
  *  Get the "save bundle" parameter
- *
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
@@ -74,9 +80,8 @@ export const getSaveBundleParameter = (commands) => commands.concat(' --save-bun
 
 /**
  *  @function getSaveOptionalParameter
- *
+ *  @description
  *  Get the `--save-optional` parameter
- *
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
@@ -84,9 +89,8 @@ export const getSaveOptionalParameter = (commands) => commands.concat(' --save-o
 
 /**
  *  @function getRegistryParameter
- *
+ *  @description
  *  Get the "registry" parameter and argument
- *
  *  @param {string} r - Registry
  *  @param {string} commands - Current commands string
  *  @returns {string}
@@ -95,9 +99,8 @@ export const getRegistryParameter = (r, commands) => r ? commands.concat(` --reg
 
 /**
  *  @function getForceParameter
- *
+ *  @description
  *  Get the "force" parameter and argument
- *
  *  @param {boolean} f - Force
  *  @param {string} commands - Current commands string
  *  @returns {string}
@@ -106,9 +109,8 @@ export const getForceParameter = (f, commands) => f ? commands.concat(' --force'
 
 /**
  *  @function getNoSaveParameter
- *
+ *  @description
  *  Get the `--no-save` parameter
- *
  *  @param {boolean} s - Save
  *  @param {string} commands - Current commands string
  *  @returns {string}
@@ -117,9 +119,8 @@ export const getNoSaveParameter = (s, commands) => s ? commands : commands.conca
 
 /**
  *  @function getSaveExactParameter
- *
+ *  @description
  *  Get the `--save-exact` parameter
- *
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
@@ -127,9 +128,8 @@ export const getSaveExactParameter = (commands) => commands.concat(' --save-exac
 
 /**
  *  @function getExportPath
- *
+ *  @description
  *  Get the export PATH shell script
- *
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
@@ -140,9 +140,8 @@ ${commands}
 
 /**
  *  @function getNvm
- *
+ *  @description
  *  Get the NVM shell script
- *
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
@@ -153,9 +152,8 @@ ${commands}
 
 /**
  *  @function getCommands
- *
+ *  @description
  *  Get the installation shell script
- *
  *  @param {string} commands - Current commands string
  *  @returns {string}
  */
@@ -165,9 +163,8 @@ export const getCommands = PLATFORM === 'win32'
 
 /**
  *  @function getProdDependencies
- *
+ *  @description
  *  Get the production dependencies by destructuring the package or configuration
- *
  *  @param {Package | Configuration} deps
  *  @returns {Dependencies}
  */
@@ -175,9 +172,8 @@ export const getProdDependencies = ({ dependencies = {} } = {}) => dependencies
 
 /**
  *  @function getDevDependencies
- *
+ *  @description
  *  Get the development dependencies by destructuring the package or configuration
- *
  *  @param {Package | Configuration} deps
  *  @returns {Dependencies}
  */
@@ -185,9 +181,8 @@ export const getDevDependencies = ({ devDependencies = {} } = {}) => devDependen
 
 /**
  *  @function getOptionalDependencies
- *
+ *  @description
  *  Get the optional dependencies by destructuring the package or configuration
- *
  *  @param {Package | Configuration} deps
  *  @returns {Dependencies}
  */
@@ -195,9 +190,8 @@ export const getOptionalDependencies = ({ optionalDependencies = {} } = {}) => o
 
 /**
  *  @function getBundleDependencies
- *
+ *  @description
  *  Get the bundle dependencies by destructuring the package or configuration
- *
  *  @param {Package | Configuration} deps
  *  @returns {Dependencies}
  */
@@ -205,9 +199,8 @@ export const getBundleDependencies = ({ bundleDependencies = {} } = {}) => bundl
 
 /**
  *  @function getPeerDependencies
- *
+ *  @description
  *  Get the peer dependencies by destructuring the package or configuration
- *
  *  @param {Package | Configuration} deps
  *  @returns {Dependencies}
  */
@@ -215,9 +208,8 @@ export const getPeerDependencies = ({ peerDependencies = {} } = {}) => peerDepen
 
 /**
  *  @function getIgnore
- *
+ *  @description
  *  Get the ignore flag by destructuring the configuration
- *
  *  @param {Configuration} deps
  *  @returns {boolean}
  */
@@ -225,9 +217,8 @@ export const getIgnore = ({ ignore = false } = {}) => ignore === true
 
 /**
  *  @function getAuthor
- *
+ *  @description
  *  Get the author by destructuring the package or configuration
- *
  *  @param {Package | Configuration} deps
  *  @returns {string | null}
  */
@@ -254,9 +245,8 @@ export const getAuthor = ({ author = '' } = {}) => {
 
 /**
  *  @function getMessage
- *
+ *  @description
  *  Get the message by destructuring the configuration
- *
  *  @param {Configuration} deps
  *  @returns {string | null}
  */
@@ -264,9 +254,8 @@ export const getMessage = ({ message = '' } = {}) => message || null
 
 /**
  *  @function isPreRelease
- *
+ *  @description
  *  Determine whether the dependency is a pre-release with a Regular Expression
- *
  *  @param {string} v
  *  @returns {boolean}
  */
@@ -274,9 +263,8 @@ export const isPreRelease = (v) => /-/.test(v)
 
 /**
  *  @function isExact
- *
+ *  @description
  *  Determine whether the dependency is exact with a Regular Expression
- *
  *  @param {string} v
  *  @returns {boolean}
  */
@@ -300,7 +288,7 @@ function excludeVersionIsExact ([name, version]) {
 
 /**
  *  @function getMapToDepsExactVersionFromConfiguration
- *
+ *  @description
  *  Produces an array of objects from the entries of `packageDependencies` which have
  *  exact versions
  *
@@ -308,7 +296,6 @@ 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]) => {
  *    name: string,
@@ -342,13 +329,12 @@ function getMapToDepsExactVersionFromConfiguration (configurationDependencies) {
 
 /**
  *  @function mapToDepsVersion
- *
+ *  @description
  *  Produces an array of objects from the entries of `packageDependencies` which do not have
  *  exact versions
  *
  *  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
  *  @returns {{
  *    name: string,
@@ -376,9 +362,8 @@ function mapToDepsVersion (entry) {
 
 /**
  *  @function getDepsExact
- *
+ *  @description
  *  Get an array of dependencies to be installed with the `--save-exact` parameter
- *
  *  @param {Dependencies} packageDependencies - Package dependencies
  *  @param {Dependencies} configurationDependencies - Configuration dependencies
  *  @returns {DependencyDescriptor[]}
@@ -395,9 +380,8 @@ export function getDepsExact (packageDependencies, configurationDependencies) {
 
 /**
  *  @function getDeps
- *
+ *  @description
  *  Get an array of dependencies to be installed
- *
  *  @param {Dependencies} packageDependencies - Package dependencies
  *  @returns {DependencyDescriptor[]}
  */
@@ -413,29 +397,27 @@ export function getDeps (packageDependencies) {
 
 /**
  *  @function normalizeCommands
- *
+ *  @description
  *  Normalise the commands string
- *
  *  @param {string} commands
  *  @returns {string}
  */
 export function normalizeCommands (commands) {
-  const s = String.fromCharCode(32)
+  let c = commands
 
-  while (/\s{2,} | \n+/.test(commands)) {
-    commands = commands.replace(/\s{2,}/gm, s).replace(/\n+/gm, s)
+  while (/\s{2,} | \n+/.test(c)) {
+    c = c.replace(/\s{2,}/gm, SP).replace(/\n+/gm, SP)
   }
 
   return (
-    commands.trim()
+    c.trim()
   )
 }
 
 /**
  *  @function transformDependency
- *
+ *  @description
  *  Transform by destructuring the value
- *
  *  @param {DependencyDescriptor | { name?: string, version?: string }} dependencyDescriptor
  *  @returns {string}
  */
@@ -443,9 +425,8 @@ export const transformDependency = ({ name = '@modernpoacher/deps', version = 'l
 
 /**
  *  @function transform
- *
+ *  @description
  *  Transform the parameter to a string
- *
  *  @param {DependencyDescriptor | DependencyDescriptor[]} value
  *  @returns {string}
  */
@@ -454,7 +435,7 @@ export function transform (value) {
 
   return (
     Array.isArray(value)
-      ? value.map(transformDependency).join(String.fromCharCode(32)).trim()
+      ? value.map(transformDependency).join(SP).trim()
       : transformDependency(value)
   )
 }

package/src/common/options/index.mjs

@@ -2,7 +2,7 @@
  *  @typedef {DepsTypes.Options} Options
  */
 
-import debug from 'debug'
+import debug from '#deps/src/common/debug'
 
 import {
   VERSION,
@@ -42,7 +42,8 @@ log(`\`common/options\` (${VERSION} - ${PLATFORM}) is awake`)
 
 /**
  *  @function getOptions
- *
+ *  @description
+ *  `exec` shell options
  *  @param {string} [cwd] normalized directory
  *  @returns {Options & { cwd?: string }}
  */