@form8ion/javascript 15.1.1 → 15.1.3

package/lib/index.js

@@ -1,21 +1,22 @@
 import { questionNames as questionNames$2, questions } from '@travi/language-scaffolder-prompts';
 import deepmerge from 'deepmerge';
-import { fileTypes, fileExists, optionsSchemas, validateOptions, loadConfigFile, writeConfigFile, applyEnhancers } from '@form8ion/core';
+import { fileExists, optionsSchemas, validateOptions, fileTypes, loadConfigFile, writeConfigFile, applyEnhancers } from '@form8ion/core';
 import { scaffoldChoice, dialects as dialects$1, projectTypes as projectTypes$1, packageManagers as packageManagers$1, writePackageJson, PROD_DEPENDENCY_TYPE, DEV_DEPENDENCY_TYPE, mergeIntoExistingPackageJson } from '@form8ion/javascript-core';
 import { prompt as prompt$1 } from '@form8ion/overridable-prompts';
 import joi from 'joi';
-import { scaffold, lift as lift$3 } from '@form8ion/codecov';
-import { write as write$2 } from '@form8ion/config-file';
+import { scaffold as scaffold$1, lift as lift$2 } from '@form8ion/codecov';
+import { scaffold, test as test$1 } from '@form8ion/c8';
 import { warn, info, error } from '@travi/cli-messages';
 import { promises } from 'node:fs';
 import * as huskyPlugin from '@form8ion/husky';
-import { scaffold as scaffold$1 } from '@form8ion/husky';
+import { scaffold as scaffold$2 } from '@form8ion/husky';
 import * as commitConventionPlugin from '@form8ion/commit-convention';
-import { scaffold as scaffold$4 } from '@form8ion/commit-convention';
+import { scaffold as scaffold$5 } from '@form8ion/commit-convention';
+import { write as write$1 } from '@form8ion/config-file';
 import { stringify, parse } from 'ini';
-import { scaffold as scaffold$3 } from '@form8ion/prettier';
+import { scaffold as scaffold$4 } from '@form8ion/prettier';
 import * as eslintPlugin from '@form8ion/eslint';
-import { scaffold as scaffold$2, test as test$1 } from '@form8ion/eslint';
+import { scaffold as scaffold$3, test as test$2 } from '@form8ion/eslint';
 import { promises as promises$1 } from 'fs';
 import touch from 'touch';
 import { execa } from 'execa';
@@ -42,33 +43,15 @@ const questionNames$1 = {
   DIALECT: 'dialect'
 };
 
-async function scaffoldC8 ({projectRoot}) {
-  await write$2({
-    name: 'c8',
-    format: fileTypes.JSON,
-    path: projectRoot,
-    config: {
-      reporter: ['lcov', 'text-summary', 'html'],
-      exclude: ['src/**/*-test.js', 'test/', 'thirdparty-wrappers/', 'vendor/']
-    }
-  });
-
-  return {
-    dependencies: {javascript: {development: ['cross-env', 'c8']}},
-    vcsIgnore: {files: [], directories: ['/coverage/']},
-    eslint: {ignore: {directories: ['/coverage/']}}
-  };
-}
-
-async function scaffoldCoverage ({projectRoot, vcs, visibility, pathWithinParent}) {
-  return deepmerge(await scaffoldC8({projectRoot}), await scaffold({vcs, visibility, pathWithinParent}));
+async function scaffoldCoverage({projectRoot, vcs, visibility, pathWithinParent}) {
+  return deepmerge(await scaffold({projectRoot}), await scaffold$1({vcs, visibility, pathWithinParent}));
 }
 
-function nycIsConfigured ({projectRoot}) {
+function nyvInUse({projectRoot}) {
   return fileExists(`${projectRoot}/.nycrc`);
 }
 
-async function removeNyc ({projectRoot}) {
+async function removeNyc({projectRoot}) {
   await Promise.all([
     promises.unlink(`${projectRoot}/.nycrc`),
     promises.rm(`${projectRoot}/.nyc_output`, {recursive: true, force: true})
@@ -83,12 +66,12 @@ async function removeNyc ({projectRoot}) {
   };
 }
 
-async function lift$2({projectRoot, packageManager, vcs}) {
-  const codecovResults = await lift$3({projectRoot, packageManager, vcs});
+async function lift$1({projectRoot, packageManager, vcs}) {
+  const codecovResults = await lift$2({projectRoot, packageManager, vcs});
 
-  if (await nycIsConfigured({projectRoot})) {
+  if (await nyvInUse({projectRoot})) {
     const [c8Results, nycResults] = await Promise.all([
-      scaffoldC8({projectRoot}),
+      scaffold({projectRoot}),
       removeNyc({projectRoot})
     ]);
 
@@ -109,24 +92,20 @@ async function lift$2({projectRoot, packageManager, vcs}) {
   return codecovResults;
 }
 
-function c8IsConfigured ({projectRoot}) {
-  return fileExists(`${projectRoot}/.c8rc.json`);
-}
-
-async function tester$5 ({projectRoot}) {
-  const [c8Exists, nycExists] = await Promise.all([c8IsConfigured({projectRoot}), nycIsConfigured({projectRoot})]);
+async function testCoverageBeingCollected({projectRoot}) {
+  const [c8Exists, nycExists] = await Promise.all([test$1({projectRoot}), nyvInUse({projectRoot})]);
 
   return c8Exists || nycExists;
 }
 
 var coveragePlugin = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  lift: lift$2,
+  lift: lift$1,
   scaffold: scaffoldCoverage,
-  test: tester$5
+  test: testCoverageBeingCollected
 });
 
-async function chooseFramework ({frameworks, decisions}) {
+async function gatherUnitTestingInput({frameworks, decisions}) {
   if (!Object.keys(frameworks).length) return 'Other';
 
   const answers = await prompt$1([{
@@ -141,10 +120,18 @@ async function chooseFramework ({frameworks, decisions}) {
 
 const pluginsSchema = joi.object().pattern(/^/, optionsSchemas.form8ionPlugin).default({});
 
-async function scaffoldUnitTesting ({projectRoot, frameworks, decisions, visibility, vcs, pathWithinParent, dialect}) {
+async function scaffoldUnitTesting({
+  projectRoot,
+  frameworks,
+  decisions,
+  visibility,
+  vcs,
+  pathWithinParent,
+  dialect
+}) {
   const validatedFrameworks = validateOptions(pluginsSchema, frameworks);
   const [framework, coverage] = await Promise.all([
-    chooseFramework({frameworks: validatedFrameworks, decisions})
+    gatherUnitTestingInput({frameworks: validatedFrameworks, decisions})
       .then(chosenFramework => scaffoldChoice(validatedFrameworks, chosenFramework, {projectRoot, dialect})),
     scaffoldCoverage({projectRoot, vcs, visibility, pathWithinParent})
   ]);
@@ -208,7 +195,7 @@ function validate(options) {
   return validateOptions(schema, options);
 }
 
-function buildDialectChoices ({babelPreset, typescript}) {
+function gatherDialectInput({babelPreset, typescript}) {
   return [
     {name: 'Common JS (no transpilation)', value: dialects$1.COMMON_JS, short: 'cjs'},
     ...babelPreset ? [{name: 'Modern JavaScript (transpiled)', value: dialects$1.BABEL, short: 'modern'}] : [],
@@ -221,11 +208,11 @@ function projectIsCLI(answers) {
   return projectTypes$1.CLI === answers[questionNames$1.PROJECT_TYPE];
 }
 
-function projectIsPackage(answers) {
+function projectIsPackage$1(answers) {
   return projectTypes$1.PACKAGE === answers[questionNames$1.PROJECT_TYPE];
 }
 
-function projectIsApplication(answers) {
+function projectIsApplication$1(answers) {
   return projectTypes$1.APPLICATION === answers[questionNames$1.PROJECT_TYPE];
 }
 
@@ -234,7 +221,7 @@ function packageShouldBeScoped(visibility, answers) {
 }
 
 function willBePublishedToNpm(answers) {
-  return projectIsPackage(answers) || projectIsCLI(answers);
+  return projectIsPackage$1(answers) || projectIsCLI(answers);
 }
 
 function shouldBeScopedPromptShouldBePresented(answers) {
@@ -323,7 +310,7 @@ async function prompt(
       name: questionNames$1.DIALECT,
       message: 'Which JavaScript dialect should this project follow?',
       type: 'list',
-      choices: buildDialectChoices(configs),
+      choices: gatherDialectInput(configs),
       default: 'babel'
     },
     ...pathWithinParent ? [] : [{
@@ -377,13 +364,13 @@ async function prompt(
       name: questionNames$1.PROVIDE_EXAMPLE,
       message: 'Should an example be provided in the README?',
       type: 'confirm',
-      when: projectIsPackage
+      when: projectIsPackage$1
     },
     {
       name: questionNames$1.HOST,
       type: 'list',
       message: 'Where will the application be hosted?',
-      when: projectIsApplication,
+      when: projectIsApplication$1,
       choices: [...Object.keys(hosts), 'Other']
     }
   ], decisions);
@@ -403,28 +390,28 @@ async function prompt(
   };
 }
 
-function write$1 ({projectRoot, config}) {
-  return write$2({path: projectRoot, name: 'babel', format: fileTypes.JSON, config});
+function writeBabelConfig({projectRoot, config}) {
+  return write$1({path: projectRoot, name: 'babel', format: fileTypes.JSON, config});
 }
 
-function loadConfig ({projectRoot}) {
+function loadBabelConfig({projectRoot}) {
   return loadConfigFile({path: projectRoot, name: '.babelrc', format: fileTypes.JSON});
 }
 
-async function addIgnore ({projectRoot, ignore}) {
+async function addIgnores({projectRoot, ignore}) {
   if (ignore) {
-    const existingConfig = await loadConfig({projectRoot});
+    const existingConfig = await loadBabelConfig({projectRoot});
 
-    await write$1({projectRoot, config: {...existingConfig, ignore: [`./${ignore}/`]}});
+    await writeBabelConfig({projectRoot, config: {...existingConfig, ignore: [`./${ignore}/`]}});
   }
 }
 
-async function scaffoldBabel ({projectRoot, preset}) {
+async function scaffoldBabel({projectRoot, preset}) {
   if (!preset) {
     throw new Error('No babel preset provided. Cannot configure babel transpilation');
   }
 
-  await write$1({projectRoot, config: {presets: [preset.name]}});
+  await writeBabelConfig({projectRoot, config: {presets: [preset.name]}});
 
   return {
     dependencies: {javascript: {development: ['@babel/register', preset.packageName]}},
@@ -432,17 +419,17 @@ async function scaffoldBabel ({projectRoot, preset}) {
   };
 }
 
-async function lifter$4 ({results, projectRoot}) {
-  await addIgnore({ignore: results.buildDirectory, projectRoot});
+async function liftBabel({results, projectRoot}) {
+  await addIgnores({ignore: results.buildDirectory, projectRoot});
 
   return {};
 }
 
-function predicate ({projectRoot}) {
+function babelIsInUse({projectRoot}) {
   return fileExists(`${projectRoot}/.babelrc.json`);
 }
 
-async function scaffoldTypescript ({config, projectType, projectRoot, testFilenamePattern}) {
+async function scaffoldTypescript({config, projectType, projectRoot, testFilenamePattern}) {
   const shareableTsConfigPackage = `${config.scope}/tsconfig`;
 
   await writeConfigFile({
@@ -471,7 +458,7 @@ async function scaffoldTypescript ({config, projectType, projectRoot, testFilena
   };
 }
 
-function scaffoldDialect ({dialect, projectType, projectRoot, configs, testFilenamePattern}) {
+function scaffoldDialect({dialect, projectType, projectRoot, configs, testFilenamePattern}) {
   switch (dialect) {
     case dialects$1.BABEL:
       return scaffoldBabel({preset: configs.babelPreset, projectRoot});
@@ -484,12 +471,12 @@ function scaffoldDialect ({dialect, projectType, projectRoot, configs, testFilen
 
 var dialects = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  lift: lifter$4,
+  lift: liftBabel,
   scaffold: scaffoldDialect,
-  test: predicate
+  test: babelIsInUse
 });
 
-async function writeNpmConfig ({projectRoot, config}) {
+async function writeNpmConfig({projectRoot, config}) {
   await promises.writeFile(`${projectRoot}/.npmrc`, stringify(config));
 }
 
@@ -497,7 +484,7 @@ function projectWillNotBeConsumed(projectType) {
   return projectTypes$1.APPLICATION === projectType || projectTypes$1.CLI === projectType;
 }
 
-async function scaffoldNpmConfig ({projectRoot, projectType}) {
+async function scaffoldNpmConfiguration({projectRoot, projectType}) {
   await writeNpmConfig({
     projectRoot,
     config: {'update-notifier': false, ...projectWillNotBeConsumed(projectType) && {'save-exact': true}}
@@ -506,11 +493,11 @@ async function scaffoldNpmConfig ({projectRoot, projectType}) {
   return {scripts: {'lint:peer': 'npm ls >/dev/null'}};
 }
 
-function tester$4 ({projectRoot}) {
+function npmConfigExists({projectRoot}) {
   return fileExists(`${projectRoot}/.npmrc`);
 }
 
-async function readNpmConfig ({projectRoot}) {
+async function readNpmConfig({projectRoot}) {
   const pathToConfig = `${projectRoot}/.npmrc`;
 
   if (!(await fileExists(pathToConfig))) return {};
@@ -518,7 +505,7 @@ async function readNpmConfig ({projectRoot}) {
   return parse(await promises.readFile(pathToConfig, 'utf-8'));
 }
 
-async function lifter$3 ({projectRoot}) {
+async function liftNpmConfig({projectRoot}) {
   const {
     provenance,
     'engines-strict': enginesStrict,
@@ -532,14 +519,14 @@ async function lifter$3 ({projectRoot}) {
 
 var npmConfigPlugin = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  lift: lifter$3,
+  lift: liftNpmConfig,
   read: readNpmConfig,
-  scaffold: scaffoldNpmConfig,
-  test: tester$4,
+  scaffold: scaffoldNpmConfiguration,
+  test: npmConfigExists,
   write: writeNpmConfig
 });
 
-async function scaffoldNpm ({projectRoot}) {
+async function scaffoldNpmPackageManager({projectRoot}) {
   const [packageContents, {stdout}] = await Promise.all([
     promises.readFile(`${projectRoot}/package.json`, 'utf-8'),
     execa('npm', ['--version'])
@@ -555,7 +542,7 @@ async function scaffoldNpm ({projectRoot}) {
   });
 }
 
-function determineLockfilePathFor (packageManager) {
+function resolveLockfilePath(packageManager) {
   const lockfilePaths = {
     [packageManagers$1.NPM]: 'package-lock.json',
     [packageManagers$1.YARN]: 'yarn.lock'
@@ -564,14 +551,14 @@ function determineLockfilePathFor (packageManager) {
   return lockfilePaths[packageManager];
 }
 
-function npmIsUsed ({projectRoot, pinnedPackageManager = ''}) {
+function packageManagerIsNpm({projectRoot, pinnedPackageManager = ''}) {
   const [packageManager] = pinnedPackageManager.split('@');
 
   return packageManagers$1.NPM === packageManager
-    || fileExists(`${projectRoot}/${determineLockfilePathFor(packageManagers$1.NPM)}`);
+    || fileExists(`${projectRoot}/${resolveLockfilePath(packageManagers$1.NPM)}`);
 }
 
-async function scaffoldYarn ({projectRoot}) {
+async function scaffoldYarn({projectRoot}) {
   const [packageContents, {stdout}] = await Promise.all([
     promises.readFile(`${projectRoot}/package.json`, 'utf-8'),
     execa('yarn', ['--version'])
@@ -587,51 +574,51 @@ async function scaffoldYarn ({projectRoot}) {
   });
 }
 
-function yarnIsUsed ({projectRoot, pinnedPackageManager = ''}) {
+function packageManagerIsYarn({projectRoot, pinnedPackageManager = ''}) {
   const [packageManager] = pinnedPackageManager.split('@');
 
   return packageManagers$1.YARN === packageManager
-    || fileExists(`${projectRoot}/${determineLockfilePathFor(packageManagers$1.YARN)}`);
+    || fileExists(`${projectRoot}/${resolveLockfilePath(packageManagers$1.YARN)}`);
 }
 
-async function jsPackageManagerIsUsed ({projectRoot}) {
+async function packageManagerInUse({projectRoot}) {
   const [npmFound, yarnFound] = await Promise.all([
-    npmIsUsed({projectRoot}),
-    yarnIsUsed({projectRoot})
+    packageManagerIsNpm({projectRoot}),
+    packageManagerIsYarn({projectRoot})
   ]);
 
   return npmFound || yarnFound;
 }
 
-async function liftCorepack () {
+async function liftCorepack() {
   await execa('corepack', ['use', 'npm@latest']);
 }
 
-async function lifter$2 () {
+async function liftPackageManagers() {
   await liftCorepack();
 
   return {};
 }
 
 const scaffolders = {
-  npm: scaffoldNpm,
+  npm: scaffoldNpmPackageManager,
   yarn: scaffoldYarn
 };
 
-function scaffoldPackageManager ({projectRoot, packageManager}) {
+function scaffoldPackageManager({projectRoot, packageManager}) {
   return scaffolders[packageManager]({projectRoot});
 }
 
-async function resolvePackageManager ({projectRoot, packageManager}) {
+async function resolveCurrentPackageManager({projectRoot, packageManager}) {
   if (packageManager) return packageManager;
 
   const {packageManager: pinnedPackageManager} = JSON.parse(await promises.readFile(`${projectRoot}/package.json`, 'utf-8'));
 
-  if (await npmIsUsed({projectRoot, pinnedPackageManager})) {
+  if (await packageManagerIsNpm({projectRoot, pinnedPackageManager})) {
     return packageManagers$1.NPM;
   }
 
-  if (await yarnIsUsed({projectRoot, pinnedPackageManager})) {
+  if (await packageManagerIsYarn({projectRoot, pinnedPackageManager})) {
     return packageManagers$1.YARN;
   }
 
@@ -640,14 +627,14 @@ async function resolvePackageManager ({projectRoot, packageManager}) {
 
 var packageManagers = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  defineLockfilePath: determineLockfilePathFor,
-  determineCurrent: resolvePackageManager,
-  lift: lifter$2,
+  defineLockfilePath: resolveLockfilePath,
+  determineCurrent: resolveCurrentPackageManager,
+  lift: liftPackageManagers,
   scaffold: scaffoldPackageManager,
-  test: jsPackageManagerIsUsed
+  test: packageManagerInUse
 });
 
-function buildDocumentationCommand (packageManager) {
+function scaffoldGenerationCommand(packageManager) {
   if (packageManagers$1.NPM === packageManager) return 'npm run generate:md';
   if (packageManagers$1.YARN === packageManager) return 'yarn generate:md';
 
@@ -657,9 +644,9 @@ function buildDocumentationCommand (packageManager) {
   );
 }
 
-function scaffoldDocumentation ({projectTypeResults, packageManager}) {
+function scaffoldDocumentation({projectTypeResults, packageManager}) {
   return {
-    toc: `Run \`${buildDocumentationCommand(packageManager)}\` to generate a table of contents`,
+    toc: `Run \`${scaffoldGenerationCommand(packageManager)}\` to generate a table of contents`,
     ...projectTypeResults.documentation,
     contributing: `### Dependencies
 
@@ -690,7 +677,7 @@ async function determineLatestVersionOf(nodeVersionCategory) {
   return lsLine.match(/(v[0-9]+)\.[0-9]+\.[0-9]+/)[1];
 }
 
-function install$1(nodeVersionCategory) {
+function install(nodeVersionCategory) {
   info(`Installing ${nodeVersionCategory} version of node using nvm`, {level: 'secondary'});
 
   const subprocess = execa('. ~/.nvm/nvm.sh && nvm install', {shell: true});
@@ -698,7 +685,7 @@ function install$1(nodeVersionCategory) {
   return subprocess;
 }
 
-async function scaffoldNodeVersion ({projectRoot, nodeVersionCategory}) {
+async function scaffoldNodeVersion({projectRoot, nodeVersionCategory}) {
   if (!nodeVersionCategory) return undefined;
 
   const lowerCaseCategory = nodeVersionCategory.toLowerCase();
@@ -708,23 +695,23 @@ async function scaffoldNodeVersion ({projectRoot, nodeVersionCategory}) {
 
   await promises.writeFile(`${projectRoot}/.nvmrc`, version);
 
-  await install$1(nodeVersionCategory);
+  await install(nodeVersionCategory);
 
   return version;
 }
 
-function nvmIsUsed ({projectRoot}) {
+function nodeVersionMangerInUse({projectRoot}) {
   return fileExists(`${projectRoot}/.nvmrc`);
 }
 
-function buildVcsIgnoreLists (vcsIgnoreLists = {}) {
+function buildIgnoreLists(vcsIgnoreLists = {}) {
   return {
     files: vcsIgnoreLists.files || [],
     directories: ['/node_modules/', ...vcsIgnoreLists.directories || []]
   };
 }
 
-function buildPackageName (projectName, scope) {
+function determinePackageName(projectName, scope) {
   const name = `${scope ? `@${scope}/` : ''}${projectName}`;
 
   const {validForNewPackages, errors} = validatePackageName(name);
@@ -735,7 +722,7 @@ function buildPackageName (projectName, scope) {
   throw new Error(`The package name ${name} is invalid:${EOL}\t* ${errors.join(`${EOL}\t* `)}`);
 }
 
-function buildPackageDetails ({
+function scaffoldPackageJsonDetails({
   packageName,
   dialect,
   license,
@@ -752,7 +739,7 @@ function buildPackageDetails ({
   };
 }
 
-async function scaffoldPackage ({
+async function scaffoldPackage({
   projectRoot,
   projectName,
   scope,
@@ -763,11 +750,11 @@ async function scaffoldPackage ({
 }) {
   info('Configuring package.json');
 
-  const packageName = buildPackageName(projectName, scope);
+  const packageName = determinePackageName(projectName, scope);
 
   await writePackageJson({
     projectRoot,
-    config: await buildPackageDetails({
+    config: await scaffoldPackageJsonDetails({
       packageName,
       dialect,
       license,
@@ -816,7 +803,7 @@ function sortProperties(packageContents) {
   );
 }
 
-function defineVcsHostDetails (vcs, pathWithinParent) {
+function scaffoldVcsHostDetails(vcs, pathWithinParent) {
   return vcs && 'github' === vcs.host && {
     repository: pathWithinParent
       ? {
@@ -860,7 +847,12 @@ function getExactFlag(manager) {
   return details[manager].installationFlags.exact;
 }
 
-async function install (dependencies, dependenciesType, projectRoot, packageManager = packageManagers$1.NPM) {
+async function installDependencies(
+  dependencies,
+  dependenciesType,
+  projectRoot,
+  packageManager = packageManagers$1.NPM
+) {
   if (dependencies.length) {
     info(`Installing ${dependenciesType} dependencies`, {level: 'secondary'});
 
@@ -899,8 +891,8 @@ async function processDependencies({dependencies = {}, devDependencies, projectR
   const {javascript: {production = [], development = [], remove: dependenciesToRemove = []} = {}} = dependencies;
 
   try {
-    await install(production, PROD_DEPENDENCY_TYPE, projectRoot, packageManager);
-    await install(development, DEV_DEPENDENCY_TYPE, projectRoot, packageManager);
+    await installDependencies(production, PROD_DEPENDENCY_TYPE, projectRoot, packageManager);
+    await installDependencies(development, DEV_DEPENDENCY_TYPE, projectRoot, packageManager);
     await removeDependencies({packageManager, dependencies: dependenciesToRemove});
   } catch (e) {
     error('Failed to update dependencies');
@@ -965,8 +957,8 @@ function compareScriptNames(a, b) {
   const aStripped = stripPrefix(a);
   const bStripped = stripPrefix(b);
 
-  const aKey = aStripped.startsWith(`${b}:`) ? aStripped : a;
-  const bKey = bStripped.startsWith(`${a}:`) ? bStripped : b;
+  const aKey = aStripped !== a ? aStripped : a;
+  const bKey = bStripped !== b ? bStripped : b;
 
   return aKey.localeCompare(bKey);
 }
@@ -1009,7 +1001,7 @@ async function liftPackageJson({
     projectRoot,
     config: sortProperties({
       ...existingPackageJsonContents,
-      ...defineVcsHostDetails(vcs, pathWithinParent),
+      ...scaffoldVcsHostDetails(vcs, pathWithinParent),
       scripts: liftedScripts,
       ...tags && {
         keywords: existingPackageJsonContents.keywords ? [...existingPackageJsonContents.keywords, ...tags] : tags
@@ -1025,11 +1017,11 @@ async function liftPackageJson({
   });
 }
 
-function determinePackageAccessLevelFromProjectVisibility ({projectVisibility}) {
+function mapProjectVisibility({projectVisibility}) {
   return 'Public' === projectVisibility ? 'public' : 'restricted';
 }
 
-function defineBadges (packageName, accessLevel) {
+function scaffoldPublishableBadges(packageName, accessLevel) {
   return {
     consumer: {
       ...'public' === accessLevel && {
@@ -1044,7 +1036,7 @@ function defineBadges (packageName, accessLevel) {
   };
 }
 
-function enhanceSlsa ({provenance}) {
+function scaffoldSlsa({provenance}) {
   {
     return {
       badges: {
@@ -1060,13 +1052,13 @@ function enhanceSlsa ({provenance}) {
   }
 }
 
-async function liftProvenance ({projectRoot, packageDetails}) {
+async function liftProvenance({projectRoot, packageDetails}) {
   const {publishConfig: {access} = {}} = packageDetails;
 
   if ('public' === access) {
     await mergeIntoExistingPackageJson({projectRoot, config: {publishConfig: {provenance: true}}});
 
-    return enhanceSlsa({provenance: true});
+    return scaffoldSlsa({provenance: true});
   }
 
   return {};
@@ -1084,14 +1076,14 @@ async function liftPublishable({projectRoot, packageDetails}) {
       homepage,
       dependencies: {javascript: {development: ['publint']}},
       scripts: {'lint:publish': 'publint --strict'},
-      badges: defineBadges(packageName, packageAccessLevel)
+      badges: scaffoldPublishableBadges(packageName, packageAccessLevel)
     }
   );
 }
 
-async function scaffoldPublishable ({packageName, packageAccessLevel}) {
+async function scaffoldPublishable({packageName, packageAccessLevel}) {
   return {
-    badges: await defineBadges(packageName, packageAccessLevel)
+    badges: await scaffoldPublishableBadges(packageName, packageAccessLevel)
   };
 }
 
@@ -1105,7 +1097,7 @@ function getInstallationCommand(packageManager) {
   );
 }
 
-function scaffoldPackageDocumentation ({scope, packageName, packageManager, visibility, provideExample}) {
+function scaffoldPackageDocumentation({scope, packageName, packageManager, visibility, provideExample}) {
   return {
     usage: `### Installation
 ${'Private' === visibility ? `
@@ -1120,13 +1112,13 @@ $ ${getInstallationCommand(packageManager)} ${packageName}
 
 ### Example
 
-run \`${buildDocumentationCommand(packageManager)}\` to inject the usage example`
+run \`${scaffoldGenerationCommand(packageManager)}\` to inject the usage example`
     : ''
 }`
   };
 }
 
-async function chooseBundler ({bundlers, decisions}) {
+async function gatherBundlerInput({bundlers, decisions}) {
   if (!Object.keys(bundlers).length) return 'Other';
 
   const answers = await prompt$1([{
@@ -1139,8 +1131,8 @@ async function chooseBundler ({bundlers, decisions}) {
   return answers[questionNames$1.PACKAGE_BUNDLER];
 }
 
-async function scaffoldBundler ({projectRoot, projectType, bundlers, dialect, decisions}) {
-  const chosenBundler = await chooseBundler({bundlers, decisions});
+async function scaffoldBundler({projectRoot, projectType, bundlers, dialect, decisions}) {
+  const chosenBundler = await gatherBundlerInput({bundlers, decisions});
 
   return scaffoldChoice(bundlers, chosenBundler, {projectRoot, projectType, dialect});
 }
@@ -1211,7 +1203,7 @@ async function scaffoldPackageProjectType({
 }) {
   info('Scaffolding Package Details');
 
-  const packageAccessLevel = determinePackageAccessLevelFromProjectVisibility({projectVisibility: visibility});
+  const packageAccessLevel = mapProjectVisibility({projectVisibility: visibility});
   const [detailsForBuild, publishableResults] = await Promise.all([
     buildDetails({
       projectRoot,
@@ -1276,13 +1268,15 @@ function liftPackage({projectRoot, packageDetails}) {
   return liftPublishable({projectRoot, packageDetails});
 }
 
-async function isPackage ({packageDetails: {exports: exports$1, publishConfig, bin, private: projectMarkedPrivate}}) {
+async function projectIsPackage({
+  packageDetails: {exports: exports$1, publishConfig, bin, private: projectMarkedPrivate}
+}) {
   return !projectMarkedPrivate && (!!exports$1 || (!!publishConfig && !bin));
 }
 
 const defaultBuildDirectory$1 = 'public';
 
-async function scaffoldApplicationType ({projectRoot}) {
+async function scaffoldApplication({projectRoot}) {
   info('Scaffolding Application Details');
 
   await mergeIntoExistingPackageJson({projectRoot, config: {private: true}});
@@ -1302,11 +1296,11 @@ async function scaffoldApplicationType ({projectRoot}) {
   };
 }
 
-function isApplication ({packageDetails}) {
+function projectIsApplication({packageDetails}) {
   return !!packageDetails.private;
 }
 
-async function scaffoldMonorepoType ({projectRoot}) {
+async function scaffoldMonorepo({projectRoot}) {
   info('Scaffolding Monorepo Details');
 
   await mergeIntoExistingPackageJson({projectRoot, config: {private: true}});
@@ -1331,7 +1325,7 @@ async function scaffoldCli({
   decisions,
   packageBundlers
 }) {
-  const packageAccessLevel = determinePackageAccessLevelFromProjectVisibility({projectVisibility: visibility});
+  const packageAccessLevel = mapProjectVisibility({projectVisibility: visibility});
   const [bundlerResults, publishableResults] = await Promise.all([
     scaffoldBundler({bundlers: packageBundlers, projectRoot, dialect, decisions, projectType: projectTypes$1.CLI}),
     scaffoldPublishable({packageName, packageAccessLevel}),
@@ -1366,7 +1360,7 @@ async function scaffoldCli({
   ]);
 }
 
-async function isCli ({packageDetails: {bin}}) {
+async function projectIsCli({packageDetails: {bin}}) {
   return !!bin;
 }
 
@@ -1374,7 +1368,7 @@ function liftCli({projectRoot, packageDetails}) {
   return liftPublishable({projectRoot, packageDetails});
 }
 
-async function scaffoldProjectType ({
+async function scaffoldProjectType({
   projectType,
   projectRoot,
   projectName,
@@ -1404,7 +1398,7 @@ async function scaffoldProjectType ({
         publishRegistry
       });
     case projectTypes$1.APPLICATION:
-      return scaffoldApplicationType({projectRoot});
+      return scaffoldApplication({projectRoot});
     case projectTypes$1.CLI:
       return scaffoldCli({
         packageName,
@@ -1416,7 +1410,7 @@ async function scaffoldProjectType ({
         packageBundlers
       });
     case projectTypes$1.MONOREPO:
-      return scaffoldMonorepoType({projectRoot});
+      return scaffoldMonorepo({projectRoot});
     case 'Other':
       return {};
     default:
@@ -1424,10 +1418,10 @@ async function scaffoldProjectType ({
   }
 }
 
-async function tester$3 ({projectRoot, packageDetails}) {
-  return await isPackage({packageDetails})
-    || await isCli({packageDetails})
-    || isApplication({packageDetails});
+async function isProjectType({projectRoot, packageDetails}) {
+  return await projectIsPackage({packageDetails})
+    || await projectIsCli({packageDetails})
+    || projectIsApplication({packageDetails});
 }
 
 function vcsRepositoryHostedOnGithub(vcs) {
@@ -1435,8 +1429,8 @@ function vcsRepositoryHostedOnGithub(vcs) {
 }
 
 async function liftProjectType({projectRoot, packageDetails, vcs}) {
-  if (await isPackage({packageDetails})) return liftPackage({projectRoot, packageDetails});
-  if (await isCli({packageDetails})) return liftCli({projectRoot, packageDetails});
+  if (await projectIsPackage({packageDetails})) return liftPackage({projectRoot, packageDetails});
+  if (await projectIsCli({packageDetails})) return liftCli({projectRoot, packageDetails});
 
   let homepage;
 
@@ -1453,10 +1447,10 @@ var projectTypes = /*#__PURE__*/Object.freeze({
   __proto__: null,
   lift: liftProjectType,
   scaffold: scaffoldProjectType,
-  test: tester$3
+  test: isProjectType
 });
 
-async function chooseProjectTypePlugin ({types, projectType, decisions}) {
+async function gatherProjectTypePluginInput({types, projectType, decisions}) {
   if (!Object.keys(types).length) return 'Other';
 
   const answers = await prompt$1([{
@@ -1469,7 +1463,7 @@ async function chooseProjectTypePlugin ({types, projectType, decisions}) {
   return answers[questionNames$1.PROJECT_TYPE_CHOICE];
 }
 
-async function scaffoldProjectTypePlugin ({
+async function scaffoldProjectTypePlugin({
   projectRoot,
   projectType,
   projectName,
@@ -1485,7 +1479,7 @@ async function scaffoldProjectTypePlugin ({
 
   if (!pluginsForProjectType) return {};
 
-  const chosenType = await chooseProjectTypePlugin({types: pluginsForProjectType, decisions, projectType});
+  const chosenType = await gatherProjectTypePluginInput({types: pluginsForProjectType, decisions, projectType});
 
   return scaffoldChoice(
     pluginsForProjectType,
@@ -1494,7 +1488,7 @@ async function scaffoldProjectTypePlugin ({
   );
 }
 
-async function scaffoldTesting ({
+async function scaffoldTesting({
   projectRoot,
   visibility,
   tests: {unit, integration},
@@ -1522,7 +1516,7 @@ async function scaffoldTesting ({
   );
 }
 
-function buildAllowedHostsList ({packageManager, registries = {}}) {
+function buildAllowedHosts({packageManager, registries = {}}) {
   return [
     ...!registries.registry ? [packageManager] : [],
     ...Object.values(Object.fromEntries(Object.entries(registries).filter(([scope]) => 'publish' !== scope)))
@@ -1535,7 +1529,7 @@ function lockfileLintSupports(packageManager) {
   return lockfileLintSupportedPackageManagers.includes(packageManager);
 }
 
-async function scaffoldLockfileLint ({projectRoot, packageManager, registries}) {
+async function scaffoldLockfileLint({projectRoot, packageManager, registries}) {
   if (!lockfileLintSupports(packageManager)) {
     throw new Error(
       `The ${packageManager} package manager is currently not supported by lockfile-lint. `
@@ -1543,15 +1537,15 @@ async function scaffoldLockfileLint ({projectRoot, packageManager, registries})
     );
   }
 
-  await write$2({
+  await write$1({
     name: 'lockfile-lint',
     format: fileTypes.JSON,
     path: projectRoot,
     config: {
-      path: determineLockfilePathFor(packageManager),
+      path: resolveLockfilePath(packageManager),
       type: packageManager,
       'validate-https': true,
-      'allowed-hosts': buildAllowedHostsList({packageManager, registries})
+      'allowed-hosts': buildAllowedHosts({packageManager, registries})
     }
   });
 
@@ -1561,7 +1555,7 @@ async function scaffoldLockfileLint ({projectRoot, packageManager, registries})
   };
 }
 
-function lockfileLintIsAlreadyConfigured ({projectRoot}) {
+function lockfileLintInUse({projectRoot}) {
   return fileExists(`${projectRoot}/.lockfile-lintrc.json`);
 }
 
@@ -1572,10 +1566,10 @@ function read({projectRoot}) {
 }
 
 function write({projectRoot, config}) {
-  return write$2({name: configName, format: fileTypes.JSON, path: projectRoot, config});
+  return write$1({name: configName, format: fileTypes.JSON, path: projectRoot, config});
 }
 
-async function scaffoldLinting ({projectRoot, packageManager, registries}) {
+async function scaffoldLinting({projectRoot, packageManager, registries}) {
   return scaffoldLockfileLint({projectRoot, packageManager, registries});
 }
 
@@ -1603,14 +1597,14 @@ async function scaffoldVerification({
       pathWithinParent
     }),
     scaffoldLinting({projectRoot, packageManager, registries}),
-    scaffold$1({projectRoot, packageManager, pathWithinParent})
+    scaffold$2({projectRoot, packageManager, pathWithinParent})
   ]);
 
   return deepmerge.all([testingResults, lintingResults, huskyResults]);
 }
 
-async function scaffoldRemark ({config, projectRoot, projectType, vcs}) {
-  await write$2({
+async function scaffoldRemark({config, projectRoot, projectType, vcs}) {
+  await write$1({
     format: fileTypes.JSON,
     path: projectRoot,
     name: 'remark',
@@ -1643,7 +1637,7 @@ async function scaffoldRemark ({config, projectRoot, projectType, vcs}) {
   );
 }
 
-async function scaffoldCodeStyle ({
+async function scaffoldCodeStyle({
   projectRoot,
   projectType,
   configs,
@@ -1653,33 +1647,33 @@ async function scaffoldCodeStyle ({
   return deepmerge.all(await Promise.all([
     configs.eslint
       && configureLinting
-      && scaffold$2({projectRoot, config: configs.eslint}),
+      && scaffold$3({projectRoot, config: configs.eslint}),
     scaffoldRemark({
       projectRoot,
       projectType,
       vcs,
       config: configs.remark || '@form8ion/remark-lint-preset'
     }),
-    scaffold$3({projectRoot, config: configs.prettier})
+    scaffold$4({projectRoot, config: configs.prettier})
   ].filter(Boolean)));
 }
 
-function lifter$1 (options) {
+function liftCodeStyle(options) {
   return applyEnhancers({options, enhancers: [eslintPlugin]});
 }
 
-function tester$2 (options) {
-  return test$1(options);
+function codeStyleConfigured(options) {
+  return test$2(options);
 }
 
 var codeStylePlugin = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  lift: lifter$1,
+  lift: liftCodeStyle,
   scaffold: scaffoldCodeStyle,
-  test: tester$2
+  test: codeStyleConfigured
 });
 
-async function scaffolder (options) {
+async function scaffoldJavascript(options) {
   info('Initializing JavaScript project');
 
   const {
@@ -1756,7 +1750,7 @@ async function scaffolder (options) {
   });
   const [nodeVersion, npmResults, dialectResults, codeStyleResults] = await Promise.all([
     scaffoldNodeVersion({projectRoot, nodeVersionCategory}),
-    scaffoldNpmConfig({projectType, projectRoot}),
+    scaffoldNpmConfiguration({projectType, projectRoot}),
     scaffoldDialect({
       dialect,
       configs,
@@ -1791,7 +1785,7 @@ async function scaffolder (options) {
         {buildDirectory: `./${projectTypeResults.buildDirectory}`, projectRoot, projectName, nodeVersion}
       ),
       scaffoldChoice(ciServices, ci, {projectRoot, vcs, visibility, projectType, projectName, nodeVersion, tests}),
-      scaffold$4({projectRoot, projectType, configs, pathWithinParent})
+      scaffold$5({projectRoot, projectType, configs, pathWithinParent})
     ])),
     projectTypeResults,
     verificationResults,
@@ -1805,16 +1799,16 @@ async function scaffolder (options) {
     ...mergedContributions,
     documentation: scaffoldDocumentation({projectTypeResults, packageManager}),
     tags: projectTypeResults.tags,
-    vcsIgnore: buildVcsIgnoreLists(mergedContributions.vcsIgnore),
-    verificationCommand: `${buildDocumentationCommand(packageManager)} && ${packageManager} test`
+    vcsIgnore: buildIgnoreLists(mergedContributions.vcsIgnore),
+    verificationCommand: `${scaffoldGenerationCommand(packageManager)} && ${packageManager} test`
   };
 }
 
-function tester$1 () {
+function registriesAreInUse() {
   return true;
 }
 
-function buildRegistriesConfig (registries = {}) {
+function buildRegistriesList(registries = {}) {
   return Object.entries(registries)
     .filter(([scope]) => 'publish' !== scope)
     .reduce((acc, [scope, url]) => {
@@ -1825,7 +1819,7 @@ function buildRegistriesConfig (registries = {}) {
 }
 
 async function updateRegistriesInNpmConfig(registries, projectRoot) {
-  const registriesForNpmConfig = buildRegistriesConfig(registries);
+  const registriesForNpmConfig = buildRegistriesList(registries);
 
   await writeNpmConfig({
     projectRoot,
@@ -1841,15 +1835,15 @@ async function updateRegistriesInLockfileLintConfig(projectRoot, packageManager,
     projectRoot,
     config: {
       ...await read({projectRoot}),
-      'allowed-hosts': buildAllowedHostsList({packageManager, registries})
+      'allowed-hosts': buildAllowedHosts({packageManager, registries})
     }
   });
 }
 
-async function lifter ({projectRoot, packageManager, configs: {registries}}) {
+async function liftRegistries({projectRoot, packageManager, configs: {registries}}) {
   await updateRegistriesInNpmConfig(registries, projectRoot);
 
-  if (!(await lockfileLintIsAlreadyConfigured({projectRoot}))) {
+  if (!(await lockfileLintInUse({projectRoot}))) {
     return scaffoldLockfileLint({projectRoot, packageManager, registries});
   }
 
@@ -1860,8 +1854,8 @@ async function lifter ({projectRoot, packageManager, configs: {registries}}) {
 
 var registriesPlugin = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  lift: lifter,
-  test: tester$1
+  lift: liftRegistries,
+  test: registriesAreInUse
 });
 
 async function test({projectRoot}) {
@@ -1870,7 +1864,7 @@ async function test({projectRoot}) {
   return !!engines?.node;
 }
 
-async function lift$1({packageDetails: {name}}) {
+async function lift({packageDetails: {name}}) {
   return {
     dependencies: {javascript: {development: ['ls-engines']}},
     scripts: {'lint:engines': 'ls-engines'},
@@ -1880,15 +1874,22 @@ async function lift$1({packageDetails: {name}}) {
 
 var enginesEnhancer = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  lift: lift$1,
+  lift: lift,
   test: test
 });
 
-async function lift ({projectRoot, vcs, results, pathWithinParent, enhancers = {}, configs = {}}) {
+async function liftJavaScript({
+  projectRoot,
+  vcs,
+  results,
+  pathWithinParent,
+  enhancers = {},
+  configs = {}
+}) {
   info('Lifting JavaScript-specific details');
 
   const [packageManager, packageContents] = await Promise.all([
-    resolvePackageManager({projectRoot, packageManager: results.packageManager}),
+    resolveCurrentPackageManager({projectRoot, packageManager: results.packageManager}),
     promises.readFile(`${projectRoot}/package.json`, 'utf8')
   ]);
 
@@ -1915,10 +1916,10 @@ async function lift ({projectRoot, vcs, results, pathWithinParent, enhancers = {
   return enhancerResults;
 }
 
-async function tester ({projectRoot}) {
+async function projectUsesJavaScript({projectRoot}) {
   const [nvmFound, jsPackageManagerFound] = await Promise.all([
-    nvmIsUsed({projectRoot}),
-    jsPackageManagerIsUsed({projectRoot})
+    nodeVersionMangerInUse({projectRoot}),
+    packageManagerInUse({projectRoot})
   ]);
 
   const jsProjectFound = nvmFound || jsPackageManagerFound;
@@ -1930,5 +1931,5 @@ async function tester ({projectRoot}) {
 
 const questionNames = {...questionNames$2, ...questionNames$1};
 
-export { lift, questionNames, scaffolder as scaffold, scaffoldUnitTesting, tester as test };
+export { liftJavaScript as lift, questionNames, scaffoldJavascript as scaffold, scaffoldUnitTesting, projectUsesJavaScript as test };
 //# sourceMappingURL=index.js.map