@form8ion/javascript 8.4.0 → 8.5.0

package/lib/index.mjs

@@ -43,6 +43,7 @@ const questionNames$1 = {
   AUTHOR_URL: 'authorUrl',
   HOST: 'host',
   CONFIGURE_LINTING: 'configureLint',
+  PROVIDE_EXAMPLE: 'provideExample',
   DIALECT: 'dialect'
 };
 
@@ -158,7 +159,7 @@ async function scaffoldUnitTesting ({projectRoot, frameworks, decisions, visibil
   ]);
 }
 
-async function scaffoldRemark ({config, projectRoot, projectType, vcs, dialect}) {
+async function scaffoldRemark ({config, projectRoot, projectType, vcs}) {
   await write$1({
     format: fileTypes.JSON,
     path: projectRoot,
@@ -188,19 +189,13 @@ async function scaffoldRemark ({config, projectRoot, projectType, vcs, dialect})
         'generate:md': 'remark . --output'
       }
     },
-    {
-      ...projectTypes.PACKAGE === projectType && {
-        devDependencies: ['remark-usage'],
-        ...dialects$1.COMMON_JS !== dialect && {scripts: {'pregenerate:md': 'run-s build'}}
-      }
-    }
+    {...projectTypes.PACKAGE === projectType && {devDependencies: ['remark-usage']}}
   );
 }
 
 async function scaffoldCodeStyle ({
   projectRoot,
   projectType,
-  dialect,
   configs,
   vcs,
   configureLinting
@@ -212,7 +207,6 @@ async function scaffoldCodeStyle ({
     scaffoldRemark({
       projectRoot,
       projectType,
-      dialect,
       vcs,
       config: configs.remark || '@form8ion/remark-lint-preset'
     }),
@@ -678,14 +672,14 @@ function buildDialectChoices ({babelPreset, typescript}) {
   ];
 }
 
-function projectIsPackage(answers) {
-  return projectTypes.PACKAGE === answers[questionNames$1.PROJECT_TYPE];
-}
-
 function projectIsCLI(answers) {
   return projectTypes.CLI === answers[questionNames$1.PROJECT_TYPE];
 }
 
+function projectIsPackage(answers) {
+  return projectTypes.PACKAGE === answers[questionNames$1.PROJECT_TYPE];
+}
+
 function projectIsApplication(answers) {
   return projectTypes.APPLICATION === answers[questionNames$1.PROJECT_TYPE];
 }
@@ -777,6 +771,7 @@ async function prompt(
     [questionNames$1.AUTHOR_EMAIL]: authorEmail,
     [questionNames$1.AUTHOR_URL]: authorUrl,
     [questionNames$1.CONFIGURE_LINTING]: configureLinting,
+    [questionNames$1.PROVIDE_EXAMPLE]: provideExample,
     [questionNames$1.PACKAGE_MANAGER]: packageManager,
     [questionNames$1.DIALECT]: dialect
   } = await prompt$1([
@@ -834,6 +829,12 @@ async function prompt(
       type: 'confirm',
       when: lintingPromptShouldBePresented
     },
+    {
+      name: questionNames$1.PROVIDE_EXAMPLE,
+      message: 'Should an example be provided in the README?',
+      type: 'confirm',
+      when: projectIsPackage
+    },
     {
       name: questionNames$1.HOST,
       type: 'list',
@@ -852,6 +853,7 @@ async function prompt(
     nodeVersionCategory,
     author: {name: authorName, email: authorEmail, url: authorUrl},
     configureLinting: false !== configureLinting,
+    provideExample,
     packageManager,
     dialect
   };
@@ -982,7 +984,7 @@ function getInstallationCommand(packageManager) {
   );
 }
 
-function scaffoldPackageDocumentation ({scope, packageName, packageManager, visibility}) {
+function scaffoldPackageDocumentation ({scope, packageName, packageManager, visibility, provideExample}) {
   return {
     usage: `### Installation
 ${'Private' === visibility ? `
@@ -992,11 +994,14 @@ access to private packages under \`@${scope}\`
 }
 \`\`\`sh
 $ ${getInstallationCommand(packageManager)} ${packageName}
-\`\`\`
+\`\`\`${provideExample
+    ? `
 
 ### Example
 
 run \`${buildDocumentationCommand(packageManager)}\` to inject the usage example`
+    : ''
+}`
   };
 }
 
@@ -1046,10 +1051,12 @@ async function createExample(projectRoot, projectName) {
   );
 }
 
-async function buildDetailsForCommonJsProject({projectRoot, projectName}) {
+async function buildDetailsForCommonJsProject({projectRoot, projectName, provideExample}) {
   await Promise.all([
     touch(`${projectRoot}/index.js`),
-    promises.writeFile(`${projectRoot}/example.js`, `const ${camelcase(projectName)} = require('.');\n`)
+    provideExample
+      ? promises.writeFile(`${projectRoot}/example.js`, `const ${camelcase(projectName)} = require('.');\n`)
+      : Promise.resolve()
   ]);
 
   return {};
@@ -1062,16 +1069,17 @@ async function buildDetails ({
   packageName,
   packageBundlers,
   dialect,
+  provideExample,
   decisions
 }) {
-  if (dialects$1.COMMON_JS === dialect) return buildDetailsForCommonJsProject({projectRoot, projectName});
+  if (dialects$1.COMMON_JS === dialect) return buildDetailsForCommonJsProject({projectRoot, projectName, provideExample});
 
   const chosenBundler = await chooseBundler({bundlers: packageBundlers, decisions});
 
   const pathToCreatedSrcDirectory = await makeDir(`${projectRoot}/src`);
   const [bundlerResults] = await Promise.all([
     scaffoldChoice(packageBundlers, chosenBundler, {projectRoot, dialect, projectType: projectTypes.PACKAGE}),
-    await createExample(projectRoot, projectName),
+    provideExample ? await createExample(projectRoot, projectName) : Promise.resolve,
     touch(`${pathToCreatedSrcDirectory}/index.js`)
   ]);
 
@@ -1083,7 +1091,8 @@ async function buildDetails ({
         clean: `rimraf ./${defaultBuildDirectory$2}`,
         prebuild: 'run-s clean',
         build: 'npm-run-all --print-label --parallel build:*',
-        prepack: 'run-s build'
+        prepack: 'run-s build',
+        ...provideExample && {'pregenerate:md': 'run-s build'}
       },
       vcsIgnore: {directories: [`/${defaultBuildDirectory$2}/`]},
       buildDirectory: defaultBuildDirectory$2,
@@ -1112,12 +1121,22 @@ async function scaffoldPackageType ({
   packageBundlers,
   decisions,
   dialect,
+  provideExample,
   publishRegistry
 }) {
   info('Scaffolding Package Details');
 
   const [detailsForBuild] = await Promise.all([
-    buildDetails({projectRoot, projectName, packageBundlers, visibility, packageName, dialect, decisions}),
+    buildDetails({
+      projectRoot,
+      projectName,
+      packageBundlers,
+      visibility,
+      packageName,
+      dialect,
+      provideExample,
+      decisions
+    }),
     mergeIntoExistingPackageJson({
       projectRoot,
       config: {
@@ -1156,7 +1175,7 @@ async function scaffoldPackageType ({
 
   return deepmerge.all([
     {
-      documentation: scaffoldPackageDocumentation({packageName, visibility, scope, packageManager}),
+      documentation: scaffoldPackageDocumentation({packageName, visibility, scope, packageManager, provideExample}),
       nextSteps: [
         {summary: 'Add the appropriate `save` flag to the installation instructions in the README'},
         {summary: 'Publish pre-release versions to npm until package is stable enough to publish v1.0.0'}
@@ -1254,6 +1273,7 @@ async function scaffoldProjectType ({
   vcs,
   decisions,
   dialect,
+  provideExample,
   publishRegistry
 }) {
   switch (projectType) {
@@ -1269,6 +1289,7 @@ async function scaffoldProjectType ({
         vcs,
         decisions,
         dialect,
+        provideExample,
         publishRegistry
       });
     case projectTypes.APPLICATION:
@@ -1471,6 +1492,7 @@ async function scaffolder (options) {
     nodeVersionCategory,
     author,
     configureLinting,
+    provideExample,
     packageManager,
     dialect
   } = await prompt(overrides, ciServices, hosts, visibility, vcs, decisions, configs, pathWithinParent);
@@ -1505,6 +1527,7 @@ async function scaffolder (options) {
     vcs,
     decisions,
     dialect,
+    provideExample,
     publishRegistry: registries.publish
   });
   const verificationResults = await scaffoldVerification({
@@ -1529,7 +1552,7 @@ async function scaffolder (options) {
       projectType,
       testFilenamePattern: verificationResults.testFilenamePattern
     }),
-    scaffoldCodeStyle({projectRoot, projectType, dialect, configs, vcs, configureLinting})
+    scaffoldCodeStyle({projectRoot, projectType, configs, vcs, configureLinting})
   ]);
   const projectTypePluginResults = await scaffoldProjectTypePlugin({
     projectRoot,