create-juisy 2.0.0-beta.9

package/index.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+
+/**
+ * Create a new Juisy project
+ * @author Hervé Perchec
+ * @see https://github.com/hperchec/juisy
+ */
+
+import fs from 'node:fs'
+import path, { dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import mri from 'mri'
+import { eject } from 'juisy'
+import { InterfaceUtils, OutputUtils } from 'juisy/cli'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const {
+  run,
+  prompts
+} = InterfaceUtils
+
+const {
+  $style,
+  log,
+  step,
+  substep
+} = OutputUtils
+
+// Use `mri` library to parse command line arguments
+// Usage: npm create juisy <project-name> -- [--template|-t <template>] [--force|-f]
+const argv = mri(process.argv.slice(2), {
+  alias: { t: 'template', f: 'force' },
+  boolean: [ 'force' ],
+  string: [ 'template' ]
+})
+
+const cwd = process.cwd()
+
+// Get juisy version from this package.json file
+const { version: JUISY_VERSION } = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, './package.json'), 'utf-8')
+)
+
+const defaultTargetDir = 'juisy-project'
+
+const rmTrailingSlashes = str => str.trim().replace(/\/+$/g, '') // remove trailing slashes
+
+async function main () {
+  // Get target dir argument (optional)
+  let targetDir = argv._[0]
+    ? rmTrailingSlashes(String(argv._[0])) // remove trailing slashes
+    : undefined
+
+  let devConfigFormat = '.ts' // default is typescript config
+
+  // Project name (& directory name)
+  if (!targetDir) {
+    const promptsResult = await prompts([
+      {
+        type: 'text',
+        message: 'Project name (directory):',
+        initial: defaultTargetDir,
+        name: 'projectName'
+      }
+    ])
+    targetDir = rmTrailingSlashes(promptsResult.projectName)
+  }
+
+  // Dev config format
+  const promptsResult = await prompts([
+    {
+      type: 'select',
+      message: 'Dev config format:',
+      choices: [
+        { title: 'TypeScript', description: 'dev.config.ts', value: '.ts' },
+        { title: 'JavaScript', description: 'dev.config.js', value: '.js' },
+        { title: 'JSON', description: 'dev.config.json', value: '.json' }
+      ],
+      initial: 0,
+      name: 'devConfigFormat'
+    }
+  ])
+  devConfigFormat = promptsResult.devConfigFormat
+
+  /**
+   * Eject files from template
+   */
+  step('Copying files')
+
+  await eject(path.resolve(__dirname, './template'), '**/*', {
+    force: argv.force,
+    targetDir: path.resolve(cwd, targetDir),
+    ignoreFiles: [
+      'dev.config.ts',
+      'dev.config.js',
+      'dev.config.json'
+    ].filter(identifier => !identifier.endsWith(devConfigFormat)), // don't ignore dev config file of chosen format
+    logLevel: 'warn',
+    processor: (content, identifier) => {
+      if (identifier === 'package.json') {
+        return content.replace(/__JUISY_VERSION__/g, JUISY_VERSION)
+      } else {
+        return content
+      }
+    }
+  })
+
+  substep($style.green(`✔ Successfuly copied`), { last: true })
+  log() // Blank line
+
+  const targetCliCommand = 'node ./bin/cli'
+
+  /**
+   * Update package.json file
+   */
+  const scripts = {
+    'docs:api': `${targetCliCommand} docs generate -c ./docs/docs.config.js`,
+    'docs:readme': `${targetCliCommand} docs generate:readme`,
+    'docs:lint': `${targetCliCommand} docs lint`,
+    'docs:lint:fix': 'npm run docs:lint -- --fix',
+    'docs': 'npm run docs:readme && npm run docs:api && npm run docs:lint',
+    'lint': `${targetCliCommand} lint`,
+    'lint:fix': 'npm run lint -- --fix',
+    'lint:markdown': 'npm run docs:lint',
+    'lint:markdown:fix': 'npm run docs:lint:fix',
+    'release': `${targetCliCommand} release`,
+    'changelog': `${targetCliCommand} changelog`,
+    'git-hooks:reset': `${targetCliCommand} git-hooks reset`,
+    'git-hooks:sync': `${targetCliCommand} git-hooks sync`,
+    'test': `${targetCliCommand} test`
+  }
+
+  step('Adding scripts to package.json')
+  const pkg = JSON.parse(
+    fs.readFileSync(path.join(path.resolve(cwd, targetDir), 'package.json'), 'utf-8')
+  )
+  pkg.scripts = pkg.scripts || {}
+
+  for (const scriptName of Object.keys(scripts)) {
+    // Is script already defined?
+    const setScript = pkg.scripts[scriptName]
+      ? argv.force
+      : true
+    const isLastStep = scriptName === Object.keys(scripts)[Object.keys(scripts).length - 1]
+    if (setScript) {
+      await run('npm', [ 'set-script', scriptName, scripts[scriptName] ], { stdio: 'pipe', cwd: path.resolve(cwd, targetDir) })
+      substep($style.green(`✔ Script "${scriptName}" successfuly added`), { last: isLastStep })
+    } else {
+      substep($style.yellow(`Script "${scriptName}" already set. Use --force option to overwrite`), { last: isLastStep })
+    }
+  }
+
+  log() // Blank line
+  log('You should now move into the created folder and run the following command:\n  - npm install')
+  log() // Blank line
+  log('You can use feature of .env file by copying .env.example:\n  - cp .env.example .env')
+  log() // Blank line
+}
+
+main()

package/package.json

@@ -0,0 +1,63 @@
+{
+    "name": "create-juisy",
+    "version": "2.0.0-beta.9",
+    "description": "Juisy boilerplate for npm init",
+    "type": "module",
+    "bin": {
+        "create-juisy": "index.js"
+    },
+    "files": [
+        "template",
+        "index.js"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "release": "release-it",
+        "test": "echo No test found..."
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://gitlab.com/hperchec/juisy.git"
+    },
+    "keywords": [
+        "js",
+        "build",
+        "release",
+        "changelog",
+        "bin",
+        "cmd",
+        "easy"
+    ],
+    "author": {
+        "name": "Hervé Perchec",
+        "email": "contact@herve-perchec.com",
+        "url": "https://gitlab.com/herveperchec"
+    },
+    "license": "GPL-3.0-only",
+    "bugs": {
+        "url": "https://gitlab.com/hperchec/juisy/issues"
+    },
+    "homepage": "https://gitlab.com/hperchec/juisy#readme",
+    "devDependencies": {
+        "juisy": "2.0.0-beta.9"
+    },
+    "dependencies": {
+        "execa": "^8",
+        "mri": "^1.2.0"
+    },
+    "release-it": {
+        "git": false,
+        "plugins": {
+            "@release-it/bumper": {
+                "out": {
+                    "file": "package.json",
+                    "path": [
+                        "devDependencies.juisy"
+                    ]
+                }
+            }
+        }
+    }
+}

package/template/.env.example

@@ -0,0 +1,4 @@
+NODE_ENV=development
+
+# CLI specific environement variables
+__JUISY_CLI_ENV__=private

package/template/bin/cli/cli.js

@@ -0,0 +1,27 @@
+const { createCli, utils } = require('@hperchec/juisy')
+const path = require('path')
+const {
+  rootDir,
+  $style
+} = utils
+// Get package.json content
+const packageJson = require(path.resolve(rootDir, './package.json'))
+
+function getBanner () {
+  let str = ''
+  const title = $style.bold('CLI: ') + packageJson.name
+  const length = title.length - 9 // removes characters generated by $style.bold from length
+  str += $style.cyan('-'.repeat(length) + '\n')
+  str += $style.cyan(title + '\n')
+  str += $style.cyan('-'.repeat(length) + '\n')
+  str += $style.italic('Made with') + ' ' + $style.red('❤') + '  ' + $style.italic('by ') + $style.bold('Hervé Perchec <contact@herve-perchec.com') + '\n'
+  return str
+}
+
+// CLI
+module.exports = createCli(cli => cli
+  .scriptName('./bin/cli')
+  .usage(`${getBanner()}\nUsage: $0 <command> [<options>]`)
+  .commandDir('cmds')
+  .demandCommand(1, ('Command is missing. See help to learn more.').red)
+)

package/template/bin/cli/cmds/index.js

@@ -0,0 +1,13 @@
+// Private commands
+import docs from './private/docs/index.js'
+import release from './private/release.js'
+import test from './private/test.js'
+
+export const commands = [
+  // Private commands
+  docs,
+  release,
+  test
+  // Public commands
+  // ...
+]

package/template/bin/cli/cmds/private/changelog.js

@@ -0,0 +1,44 @@
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'changelog',
+  describe: 'Generate CHANGELOG file',
+  meta: {
+    private: true
+  },
+  builder: function (cli) {
+    return cli.option('i', {
+      alias: 'infile',
+      type: 'string',
+      describe: 'Same as conventional-changelog option',
+      default: 'CHANGELOG.md',
+      requiresArg: true
+    })
+  },
+  async handler (argv) {
+    // Utils
+    const { $style, step, substep, error } = CLI.OutputUtils
+    const { run, wait } = CLI.InterfaceUtils
+    /**
+     * Generate changelog file
+     */
+    step('Generating changelog')
+    await wait('Generating', async () => {
+      try {
+        await run(
+          'npx',
+          [
+            'conventional-changelog',
+            '-p', 'angular',
+            '-i', argv.infile,
+            '-s' // same file to output
+          ],
+          { stdio: 'pipe' }
+        )
+      } catch (e) {
+        error('Unable to generate changelog', e)
+      }
+    })
+    substep($style.green('✔ Success'), { last: true })
+    this.log() // Blank line
+  }
+})

package/template/bin/cli/cmds/private/docs/generate-api.js

@@ -0,0 +1,22 @@
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'generate:api',
+  describe: 'Generate API docs from source code',
+  builder (cli) {
+    cli
+  },
+  async handler (argv) {
+    // Utils
+    const { $style, step, substep } = CLI.OutputUtils
+
+    /**
+     * Generate api documentation
+     */
+    step('Generating API documentation')
+
+    substep($style.yellow('⚠ This command does nothing...'), { last: true })
+    this.log() // blank line
+    this.log($style.yellow('You can use JSDoc or TypeDoc for example. See documentation'))
+    this.log() // blank line
+  }
+})

package/template/bin/cli/cmds/private/docs/generate-cli.js

@@ -0,0 +1,11 @@
+import { ReadmeTemplater } from 'juisy/templater'
+
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'generate:cli',
+  describe: 'Generate CLI docs',
+  async handler (argv) {
+    const templater = new ReadmeTemplater('./docs/cli/config.js')
+    await templater.generate()
+  }
+})

package/template/bin/cli/cmds/private/docs/generate-readme.js

@@ -0,0 +1,11 @@
+import { ReadmeTemplater } from 'juisy/templater'
+
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'generate:readme',
+  describe: 'Generate README.md',
+  async handler (argv) {
+    const templater = new ReadmeTemplater('./docs/readme/config.js')
+    await templater.generate()
+  }
+})

package/template/bin/cli/cmds/private/docs/index.js

@@ -0,0 +1,20 @@
+import generateAPI from './generate-api.js'
+
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'docs <command>',
+  describe: 'Manage project documentation',
+  meta: {
+    private: true
+  },
+  builder (cli) {
+    return cli
+      .command([
+        /**
+         * Default command are automatically injected here...
+         */
+        generateAPI
+      ])
+  },
+  handler (argv) {}
+})

package/template/bin/cli/cmds/private/docs/lint.js

@@ -0,0 +1,42 @@
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'lint',
+  describe: 'Lint markdown with markdownlint',
+  builder: function (cli) {
+    cli.option('c', {
+      alias: 'config',
+      type: 'string',
+      describe: 'Path to custom markdownlint config file (relative to root folder)',
+      requiresArg: true
+    })
+    cli.option('f', {
+      alias: 'fix',
+      type: 'boolean',
+      describe: 'Auto fix by passing --fix option to markdownlint-cli2',
+      default: false
+    })
+    return cli
+  },
+  async handler (argv) {
+    const { abort, run } = CLI.InterfaceUtils
+    const configPath = argv.config || './docs/.markdownlint-cli2.cjs' // default relative to root folder
+
+    /**
+     * Call markdownlint command
+     */
+    try {
+      await run(
+        'npx',
+        [
+          'markdownlint-cli2',
+          '--config',
+          configPath,
+          ...(argv.fix ? [ '--fix' ] : [])
+        ],
+        { stdio: 'inherit' }
+      )
+    } catch (error) {
+      abort(error.exitCode)
+    }
+  }
+})

package/template/bin/cli/cmds/private/git-hooks/index.js

@@ -0,0 +1,20 @@
+import reset from './reset.js'
+import sync from './sync.js'
+
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'git-hooks <command>',
+  describe: 'Git relative commands',
+  meta: {
+    private: true
+  },
+  builder: function (cli) {
+    return cli
+      .command([
+        reset,
+        sync
+      ])
+      .demandCommand(1, 'Command is missing. See help to learn more.')
+  },
+  handler: async function (argv) {}
+})

package/template/bin/cli/cmds/private/git-hooks/reset.js

@@ -0,0 +1,48 @@
+import path from 'node:path'
+import fs from 'fs-extra'
+
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'reset',
+  describe: 'Reset git hooks',
+  builder (cli) {
+    return cli
+  },
+  async handler (argv) {
+    // Utils
+    const { $style, step, substep } = CLI.OutputUtils
+    const { rootDir, run, abort } = CLI.InterfaceUtils
+    /**
+     * Reset git hooks
+     */
+    step('Reset git hooks')
+
+    // Create temporary empty configuration file
+    const tempConfigFilePath = './__TEMP_SIMPLE_GIT_HOOKS_CONFIG__.json' // relative to project root folder
+    fs.writeFileSync(path.resolve(rootDir, tempConfigFilePath), '{}')
+
+    // Run command with empty configuration
+    let commandError = false
+    try {
+      await run('npx', [
+        'simple-git-hooks',
+        tempConfigFilePath
+      ], { stdio: 'pipe', cwd: rootDir })
+    } catch (e) {
+      commandError = e
+    }
+
+    // Don't forget to always remove temporary file
+    fs.unlinkSync(path.resolve(rootDir, tempConfigFilePath))
+
+    // If error
+    if (commandError) {
+      substep($style.red('❌ Unable to reset git hooks.'), { last: true })
+      abort(1) // Abort with error
+    } else {
+      // Everything is okay
+      substep($style.green('✔ Git hooks successfuly reset'), { last: true })
+      this.log() // blank line
+    }
+  }
+})

package/template/bin/cli/cmds/private/git-hooks/sync.js

@@ -0,0 +1,19 @@
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'sync',
+  describe: 'Sync git hooks',
+  builder (cli) {
+    return cli
+  },
+  async handler (argv) {
+    // Utils
+    const { step } = CLI.OutputUtils
+    const { run } = CLI.InterfaceUtils
+    /**
+     * Sync git hooks
+     */
+    step('Sync git hooks')
+
+    await run('npx', [ 'simple-git-hooks' ])
+  }
+})

package/template/bin/cli/cmds/private/release.js

@@ -0,0 +1,223 @@
+// const path = require('path')
+// const {
+//   $style,
+//   log,
+//   step,
+//   substep,
+//   run,
+//   error,
+//   wait,
+//   confirm,
+//   prompts
+// } = juisy.utils
+
+// const rootDir = path.resolve(__dirname, '../../../')
+
+// const updateVersion = require('../lib/version/update-version')
+
+import semver from 'semver'
+
+import { getPackageInfo } from 'juisy'
+
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'release',
+  describe: 'Make a release',
+  meta: {
+    private: true
+  },
+  builder: function (cli) {
+    cli.option('p', {
+      alias: 'preid',
+      type: 'string',
+      describe: 'Pre-release id',
+      requiresArg: true
+    })
+    return cli
+  },
+  async handler (argv) {
+    const { step } = CLI.OutputUtils
+    const { abort, run } = CLI.InterfaceUtils
+
+    /**
+     * Generate docs
+     */
+    step('Release-it')
+    await run('npx', [ 'release-it' ], { stdio: 'pipe' })
+
+    // const packageJson = getPackageInfo()
+    // let targetVersion
+    // const currentVersion = packageJson.version
+    // const packageName = packageJson.name
+    // const preId = argv.preid || (semver.prerelease(currentVersion) && semver.prerelease(currentVersion)[0])
+    // const inc = i => semver.inc(currentVersion, i, preId)
+    // const versionIncrements = [
+    //   'patch',
+    //   'minor',
+    //   'major',
+    //   ...(preId ? [ 'prepatch', 'preminor', 'premajor', 'prerelease' ] : [])
+    // ]
+
+    // /**
+    //  * First, check if local repository is clean
+    //  */
+    // step('Checking changes to commit')
+    // const { stdout } = await run('git', [ 'diff' ], { stdio: 'pipe', cwd: rootDir })
+    // if (stdout) {
+    //   error('Please commit your changes before creating a new release!', new Error('There are changes to commit'))
+    // }
+    // substep($style.green('✔ Local repository is clean'), { last: true })
+    // log() // Blank line
+
+    // /**
+    //  * Release prompt
+    //  */
+    // step('Setup')
+    // const { release } = await prompts([
+    //   {
+    //     type: 'select',
+    //     name: 'release',
+    //     message: 'Release type:',
+    //     choices: versionIncrements.map(i => ({ title: `${i} (${inc(i)})`, value: inc(i) })).concat([ { title: 'custom', value: 'custom' } ])
+    //   }
+    // ])
+    // // If custom release
+    // if (release === 'custom') {
+    //   const { version: customVersion } = await prompts([
+    //     {
+    //       type: 'text',
+    //       name: 'version',
+    //       message: 'New custom version:',
+    //       initial: currentVersion,
+    //       validate: value => Boolean(semver.valid(value))
+    //     }
+    //   ])
+    //   targetVersion = customVersion
+    // } else {
+    //   targetVersion = release
+    // }
+
+    // /**
+    //  * Demand confirmation
+    //  */
+    // await confirm({ message: `Releasing v${targetVersion}. Confirm?` })
+    // log() // Blank line
+
+    // /**
+    //  * Run tests
+    //  */
+    // // step(`Running tests`)
+    // // ... here run tests
+
+    // /**
+    //  * Update version in necessary files
+    //  */
+    // await updateVersion(targetVersion)
+    // log() // Blank line
+
+    // /**
+    //  * Generate docs
+    //  */
+    // step('Generate docs')
+    // await wait('API docs', async () => {
+    //   await run('node', [ './bin/cli', 'docs', 'generate:api' ], { stdio: 'pipe', cwd: rootDir })
+    // })
+    // substep($style.green('✔ API docs successfuly generated'))
+    // await wait('CLI docs', async () => {
+    //   await run('node', [ './bin/cli', 'docs', 'generate:cli' ], { stdio: 'pipe', cwd: rootDir })
+    // })
+    // substep($style.green('✔ CLI docs successfuly generated'))
+    // await wait('README', async () => {
+    //   await run('node', [ './bin/cli', 'docs', 'generate:readme' ], { stdio: 'pipe', cwd: rootDir })
+    // })
+    // substep($style.green('✔ README successfuly generated'), { last: true })
+    // // await wait('Linting', async () => {
+    // //   await run('node', [ './bin/cli', 'docs', 'lint', '-c', './docs/.markdownlint-cli2.cjs' ], { stdio: 'pipe', cwd: rootDir })
+    // // })
+    // log() // Blank line
+
+    // /**
+    //  * Generate changelog file
+    //  */
+    // step('Generating changelog')
+    // await wait('Generating', async () => {
+    //   await run('node', [ './bin/cli', 'changelog' ], { stdio: 'pipe', cwd: rootDir })
+    // })
+    // substep($style.green('✔ Success'), { last: true })
+    // log() // Blank line
+
+    // /**
+    //  * Confirm changes to commit
+    //  */
+    // step('Confirm changes to commit')
+    // substep($style.yellow('↓ The following changes will be committed:'))
+    // await run('git', [ 'status', '-s' ], { stdio: 'inherit', cwd: rootDir })
+    // substep($style.yellow('- The following tag will be created: ') + `v${targetVersion}`, { last: true })
+
+    // /**
+    //  * Demand confirmation
+    //  */
+    // await confirm()
+    // log() // Blank line
+
+    // /**
+    //  * Publish package
+    //  */
+    // step(`Publishing ${packageName}`)
+    // const releaseTag = targetVersion.includes('alpha')
+    //   ? 'alpha'
+    //   : targetVersion.includes('beta')
+    //     ? 'beta'
+    //     : targetVersion.includes('rc')
+    //       ? 'rc'
+    //       : null
+    // let alreadyPublished = false
+    // await wait('Publishing', async () => {
+    //   try {
+    //     await run('npm', [ 'publish', ...(releaseTag ? [ '--tag', releaseTag ] : []) ], { stdio: 'pipe', cwd: rootDir })
+    //   } catch (e) {
+    //     if (e.stderr.match(/previously published/)) {
+    //       alreadyPublished = true
+    //     } else {
+    //       error('Unknown error during publishing', e)
+    //     }
+    //   }
+    // })
+    // substep(
+    //   alreadyPublished
+    //     ? $style.yellow(`Skipping already published: ${packageName}`)
+    //     : $style.green('✔ Success'),
+    //   { last: true }
+    // )
+    // log() // Blank line
+
+    // /**
+    //  * Push to git
+    //  */
+    // step('Pushing changes')
+    // await wait('Committing', async () => {
+    //   try {
+    //     await run('git', [ 'add', '.' ], { stdio: 'pipe', cwd: rootDir })
+    //     await run('git', [ 'commit', '-m', `chore(release): v${targetVersion}` ], { stdio: 'pipe', cwd: rootDir })
+    //   } catch (e) {
+    //     error('Unable to commit', e)
+    //   }
+    // })
+    // substep($style.green('✔ Committed'))
+    // await wait('Creating tag', async () => {
+    //   try {
+    //     await run('git', [ 'tag', '-a', `v${targetVersion}`, '-m', `v${targetVersion}` ], { stdio: 'pipe', cwd: rootDir })
+    //   } catch (e) {
+    //     error('Unable to create tag', e)
+    //   }
+    // })
+    // substep($style.green('✔ Tagged'))
+    // log() // blank line
+
+    // log($style.green(`✔ Release v${targetVersion} successfuly created`))
+    // log()
+
+    // log($style.yellow('IMPORTANT: You should now run ') + 'git push origin --follow-tags')
+    // log()
+  }
+})

package/template/bin/cli/cmds/private/test.js

@@ -0,0 +1,33 @@
+/** @type {import('juisy/cli').Command} */
+export default new CLI.Command({
+  command: 'test',
+  describe: 'Run project tests',
+  meta: {
+    private: true
+  },
+  builder (cli) {
+    cli.option('watch', {
+      alias: 'w',
+      type: 'boolean',
+      default: false,
+      describe: 'Run vitest in watch mode'
+    })
+    cli.option('ui', {
+      type: 'boolean',
+      default: false,
+      describe: 'Launch vitest UI'
+    })
+    return cli
+  },
+  async handler (args) {
+    const watchMode = args.watch || args.ui
+    const { run } = CLI.InterfaceUtils
+    /**
+     * Run tests
+     */
+    await run('vitest', [
+      ...(watchMode ? [] : [ 'run' ]),
+      ...(args.ui ? [ '--ui' ] : [])
+    ], { stdio: 'inherit' })
+  }
+})

package/template/bin/cli/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+'use strict'
+
+const cli = require('./cli')
+
+cli().parse(process.argv.slice(2))

package/template/bin/cli/lib/docs/generate-api-doc.js

@@ -0,0 +1,33 @@
+const fs = require('fs-extra')
+const path = require('path')
+const juisy = require('@hperchec/juisy')
+
+const {
+  rootDir,
+  $style,
+  step,
+  substep
+} = juisy.utils
+
+/**
+ * Generate doc function
+ * @param {Object} [options = {}] - The options object
+ */
+module.exports = async function generateAPIDoc (options = {}) {
+  // Process options
+  const distDir = options.distDir
+  const outputDir = options.outputDir
+
+  const outputFullPath = path.resolve(rootDir, distDir, outputDir)
+
+  /**
+   * Generate api documentation
+   */
+  step('Generating API documentation')
+
+  // Here do logic to generate your documentation
+  // ex: jsdoc
+  fs.writeFileSync(path.resolve(outputFullPath, './api.md'), '# Awesome API !', { encoding: 'utf8' })
+
+  substep($style.yellow('This command just creates an example file. Let\'s write your logic!'), { last: true })
+}

package/template/bin/cli/lib/release/generate-release-note.js

@@ -0,0 +1,3 @@
+module.exports = async function genReleaseNote () {
+  console.log('Not configured...')
+}

package/template/bin/cli/lib/version/update-version.js

@@ -0,0 +1,51 @@
+const fs = require('fs')
+const path = require('path')
+const juisy = require('@hperchec/juisy')
+
+const {
+  rootDir,
+  $style,
+  error,
+  step,
+  substep,
+  run,
+  wait
+} = juisy.utils
+
+// File paths
+const filePaths = {
+  packageJson: path.resolve(rootDir, './package.json')
+}
+// Get package.json content
+const packageJson = require(filePaths.packageJson)
+
+/**
+ * Update version in necessary files
+ * @param {string} version - The version
+ * @return {void}
+ */
+module.exports = async function updateVersion (version) {
+  // Update version for each file
+  packageJson.version = version
+
+  /**
+   * Update files
+   */
+  step('Updating version in necessary files')
+  // Update package.json
+  try {
+    fs.writeFileSync(filePaths.packageJson, JSON.stringify(packageJson, null, 4), 'utf8')
+  } catch (e) {
+    error('Unable to update package.json file', e)
+  }
+  substep($style.green('✔ package.json successfuly updated'))
+  // Updating package-lock
+  await wait('Updating package-lock.json', async () => {
+    try {
+      await run('npm', [ 'install', '--prefer-offline' ], { stdio: 'pipe' })
+    } catch (e) {
+      error('Unable to update package-lock.json file', e)
+    }
+  })
+  substep($style.green('✔ package-lock.json successfuly updated'), { last: true })
+}

package/template/bin/scripts/commit-msg.js

@@ -0,0 +1,42 @@
+const juisy = require('@hperchec/juisy')
+
+const {
+  $style,
+  abort,
+  log,
+  rootDir,
+  step,
+  substep,
+  run
+} = juisy.utils
+
+/**
+ * commit-msg git hook
+ */
+;(async function () {
+  step('Git hook: commit-msg')
+
+  // Get git commit msg path from args
+  const args = process.argv.slice(2)
+  const gitMsgPath = args[0]
+
+  try {
+    // original is: npx --no -- commitlint --edit ${1}
+    // we replace "${1}" by gitMsgPath arg
+    await run('npx', [
+      '--no',
+      '--',
+      'commitlint',
+      '--edit',
+      gitMsgPath
+    ], { cwd: rootDir })
+  } catch (e) {
+    substep($style.red('❌ Git hook: "commit-msg" failed. Please check ./COMMIT_CONVENTION.md for more informations.'), { last: true })
+    abort(1) // Abort with error
+  }
+
+  // Everything is okay
+  substep($style.green('✔ Git hook: "commit-msg" passed'), { last: true })
+
+  log() // blank line
+})()

package/template/bin/scripts/pre-commit.js

@@ -0,0 +1,32 @@
+const juisy = require('@hperchec/juisy')
+
+const {
+  $style,
+  error,
+  log,
+  rootDir,
+  step,
+  substep,
+  run
+} = juisy.utils
+
+/**
+ * Pre commit git hook
+ */
+;(async function () {
+  step('Git hook: pre-commit')
+
+  try {
+    // npx lint-staged
+    await run('npx', [
+      'lint-staged'
+    ], { stdio: 'pipe', cwd: rootDir })
+  } catch (e) {
+    error('Git hook: "commit-msg" error: ', e)
+  }
+
+  // Everything is okay
+  substep($style.green('✔ Git hook: "pre-commit" passed'), { last: true })
+
+  log() // blank line
+})()

package/template/dev.config.js

@@ -0,0 +1,34 @@
+/** @type {import('juisy/cli').GlobalSettings} */
+export default {
+  changelog: {
+    infile: 'CHANGELOG.md',
+    preset: 'angular',
+    sameFile: true
+  },
+  docs: {
+    readme: {
+      config: './docs/readme/config.js'
+    },
+    cli: {
+      config: './docs/cli/config.js'
+    }
+  },
+  gitHooks: {
+    'pre-commit': 'node ./bin/scripts/pre-commit.js',
+    'commit-msg': 'node ./bin/scripts/commit-msg.js ${1}'
+  },
+  lint: {
+    staged: {
+      '*.{js,cjs,ts}': [
+        'eslint --fix'
+      ]
+    }
+  },
+  release: {
+    git: {
+      commitMessage: 'chore(release): v${version}',
+      requireBranch: 'main',
+      tagAnnotation: 'v${version}'
+    }
+  }
+}

package/template/dev.config.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "./node_modules/juisy/dist/GlobalSettings.schema.json",
+  "changelog": {
+    "infile": "CHANGELOG.md",
+    "preset": "angular",
+    "sameFile": true
+  },
+  "docs": {
+    "readme": {
+      "config": "./docs/readme/config.js"
+    },
+    "cli": {
+      "config": "./docs/cli/config.js"
+    }
+  },
+  "gitHooks": {
+    "pre-commit": "node ./bin/scripts/pre-commit.js",
+    "commit-msg": "node ./bin/scripts/commit-msg.js ${1}"
+  },
+  "lint": {
+    "staged": {
+      "*.{js,cjs,ts}": [
+        "eslint --fix"
+      ]
+    }
+  }
+}

package/template/dev.config.ts

@@ -0,0 +1,28 @@
+import type { GlobalSettings } from 'juisy/cli'
+
+export default {
+  changelog: {
+    infile: 'CHANGELOG.md',
+    preset: 'angular',
+    sameFile: true
+  },
+  docs: {
+    readme: {
+      config: './docs/readme/config.js'
+    },
+    cli: {
+      config: './docs/cli/config.js'
+    }
+  },
+  gitHooks: {
+    'pre-commit': 'node ./bin/scripts/pre-commit.js',
+    'commit-msg': 'node ./bin/scripts/commit-msg.js ${1}'
+  },
+  lint: {
+    staged: {
+      '*.{js,cjs,ts}': [
+        'eslint --fix'
+      ]
+    }
+  }
+} satisfies GlobalSettings

package/template/docs/api/docs.config.js

@@ -0,0 +1,10 @@
+module.exports = {
+  /**
+   * Dist directory (relative to root folder)
+   */
+  distDir: './docs/api',
+  /**
+   * Output directory (relative to distDir folder)
+   */
+  outputDir: 'output'
+}

package/template/docs/readme/config.js

@@ -0,0 +1,22 @@
+/**
+ * @hperchec/readme-generator Example configuration file
+ */
+
+const path = require('path')
+
+// Export configuration
+module.exports = {
+  // Template path
+  templatePath: path.resolve(__dirname, './template.md'), // Default template file
+  // Output path
+  outputPath: path.resolve(__dirname, '../../'), // Your project root directory by default
+  // Output file name
+  outputName: 'README.md', // 'README.md' by default
+  // Path to ejs data file
+  ejsDataPath: path.resolve(__dirname, './readme.js'), // Default template ejs data file
+  // EJS options (see https://www.npmjs.com/package/ejs#options)
+  ejsOptions: {
+    async: true
+    /* your ejs options... */
+  }
+}

package/template/docs/readme/readme.js

@@ -0,0 +1,70 @@
+/**
+ * @hperchec/readme-generator Template EJS data example file
+ */
+
+const markdownTable = require('markdown-table') // ! v3 not compatible, use v2
+
+// Based on the package.json file, get some data and informations
+const pkg = require('../../package.json')
+const packageName = pkg.name
+const packageUrl = `https://www.npmjs.com/package/${packageName}`
+const dependencies = pkg.dependencies || {}
+const devDependencies = pkg.devDependencies || {}
+const peerDependencies = pkg.peerDependencies || {}
+const author = pkg.author
+const contributors = pkg.contributors || []
+const license = pkg.license || 'Unknown'
+const homepage = pkg.homepage
+const projectUrl = pkg.repository.url
+const issuesUrl = pkg.bugs.url
+
+// Output a markdown formatted table from a js object
+// Like:
+// |name|version|
+// |----|-------|
+// |    |       |
+function getMdDependencies (deps) {
+  return markdownTable([
+    [ 'name', 'version' ],
+    ...(Object.entries(deps))
+  ])
+}
+
+/**
+ * Return author link
+ * @param {Object} author
+ * @return {string}
+ */
+function getMdAuthor (author) {
+  return '[' + author.name + '](' + author.url + ')'
+}
+
+/**
+ * Return markdown list of persons
+ * @param {Array} contributors
+ * @return {String}
+ */
+function getMdContributors (contributors) {
+  let mdString = ''
+  contributors.forEach((person) => {
+    mdString += '- [' + person.name + '](' + person.url + ')\n'
+  })
+  return mdString
+}
+
+/**
+ * Export data for readme file templating
+ */
+module.exports = {
+  packageName,
+  packageUrl,
+  projectUrl,
+  homepage,
+  issuesUrl,
+  dependencies: getMdDependencies(dependencies),
+  devDependencies: getMdDependencies(devDependencies),
+  peerDependencies: getMdDependencies(peerDependencies),
+  author: getMdAuthor(author),
+  contributors: getMdContributors(contributors),
+  license
+}

package/template/docs/readme/template.md

@@ -0,0 +1,53 @@
+# Awesome project
+
+[![author](https://img.shields.io/static/v1?label=&message=Author:&color=black)]()
+[![herve-perchec](http://herve-perchec.com/badge.svg)](http://herve-perchec.com/)
+
+**Table of contents**:
+
+[[*TOC*]]
+
+## 🚀 Get started
+
+```sh
+# Let's go!
+```
+
+## 📙 Documentation
+
+Please check the [documentation](https://www.npmjs.com/package/@hperchec/juisy)
+
+## 🧱 Dependencies
+
+<details>
+<summary>Global</summary>
+
+<%%= dependencies %>
+
+</details>
+
+<details>
+<summary>Dev</summary>
+
+<%%= devDependencies %>
+
+</details>
+
+<details>
+<summary>Peer</summary>
+
+<%%= peerDependencies %>
+
+</details>
+
+## ✍ Author
+
+<%%= author %>
+
+## 📄 License
+
+<%%= license %>
+
+----
+
+Made with ❤ by <%%= author %>

package/template/package.json

@@ -0,0 +1,25 @@
+{
+    "name": "new-project",
+    "version": "1.0.0",
+    "description": "New project based on Juisy template",
+    "type": "module",
+    "scripts": {
+      "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://gitlab.com/hperchec/juisy.git"
+    },
+    "author": {
+        "name": "Hervé Perchec",
+        "url": "https://gitlab.com/herveperchec"
+    },
+    "license": "ISC",
+    "bugs": {
+        "url": "https://gitlab.com/hperchec/juisy/issues"
+    },
+    "homepage": "https://gitlab.com/hperchec/juisy#readme",
+    "dependencies": {
+        "juisy": "^__JUISY_VERSION__"
+    }
+}

package/template/project.globals.js

@@ -0,0 +1,33 @@
+import pkg from './package.json' assert { type: 'json' }
+
+// Exports globals object
+export default {
+  ENV: {
+    NODE_ENV: process.env.NODE_ENV
+  },
+  PACKAGE: {
+    NAME: pkg.name,
+    URL: `https://www.npmjs.com/package/${pkg.name}`
+  },
+  VERSION: pkg.version,
+  AUTHOR: {
+    EMAIL: pkg.author.email,
+    NAME: pkg.author.name,
+    URL: pkg.author.url
+  },
+  REPOSITORY: {
+    TYPE: pkg.repository.type,
+    URL: pkg.repository.url
+  },
+  ISSUES_URL: pkg.bugs.url,
+  HOMEPAGE: pkg.homepage,
+  BRAND: {
+    COLORS: {
+      GERALDINE: '#FF8E92',
+      SAND: '#FFC17A',
+      COGNAC: '#A04113',
+      DARK_PINK: '#E95185',
+      PINK_SHERBET: '#F583A3'
+    }
+  }
+}