.github/workflows/bb.yml

@@ -0,0 +1,13 @@
+name: bb
+on:
+  issues:
+    types: [opened, reopened, edited, closed, labeled, unlabeled]
+  pull_request_target:
+    types: [opened, reopened, edited, closed, labeled, unlabeled]
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: unifiedjs/beep-boop-beta@main
+        with:
+          repo-token: ${{secrets.GITHUB_TOKEN}}

.github/workflows/main.yml

@@ -0,0 +1,36 @@
+name: main
+on:
+  - pull_request
+  - push
+jobs:
+  main:
+    name: ${{matrix.node}}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: dcodeIO/setup-node-nvm@master
+        with:
+          node-version: ${{matrix.node}}
+      - run: npm install
+      - run: npm test
+      - uses: codecov/codecov-action@v1
+    strategy:
+      matrix:
+        node:
+          - lts/erbium
+          - node
+  windows:
+    name: ${{matrix.node}}
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: dcodeIO/setup-node-nvm@master
+        with:
+          node-version: ${{matrix.node}}
+      - run: npm install
+      - run: npm run test-api
+    strategy:
+      matrix:
+        node:
+          - lts/erbium
+          - node

.gitignore

@@ -1,5 +1,6 @@
-.DS_Store
-*.log
-.nyc_output/
 coverage/
 node_modules/
+.DS_Store
+*.d.ts
+*.log
+yarn.lock

.npmrc

@@ -0,0 +1 @@
+package-lock=false

.prettierignore

@@ -0,0 +1,2 @@
+coverage/
+*.md

index.js

@@ -1,2 +1,5 @@
-'use strict';
-module.exports = require('./lib/index.js');
+/**
+ * @typedef {import('./lib/index.js').Options} Options
+ */
+
+export {args} from './lib/index.js'

lib/index.js

@@ -1,156 +1,183 @@
-'use strict';
-
-var stream = require('stream');
-var engine = require('unified-engine');
-var chalk = require('chalk');
-var chokidar = require('chokidar');
-var options = require('./options');
-
-module.exports = start;
-
-/* No-op. */
-var noop = Function.prototype;
-
-/* Fake TTY stream. */
-var ttyStream = new stream.Readable();
-ttyStream.isTTY = true;
-
-/* Exit, lazily, with the correct exit status code. */
-var exitStatus = 0;
-
-process.on('exit', onexit);
-
-/* Handle uncaught errors, such as from unexpected async
- * behaviour. */
-process.on('uncaughtException', fail);
-
-/* Start the CLI. */
-function start(configuration) {
-  var config;
-  var output;
-  var watcher;
+/**
+ * @typedef {import('unified-engine').Options} EngineOptions
+ * @typedef {import('unified-engine').Context} EngineContext
+ * @typedef {import('unified-engine').Callback} EngineCallback
+ * @typedef {import('./options.js').Options} Options
+ */
+
+import process from 'node:process'
+import stream from 'node:stream'
+import chalk from 'chalk'
+import chokidar from 'chokidar'
+import {engine} from 'unified-engine'
+import {options} from './options.js'
+
+// Fake TTY stream.
+const ttyStream = Object.assign(new stream.Readable(), {isTTY: true})
+
+// Exit, lazily, with the correct exit status code.
+let exitStatus = 0
+
+process.on('exit', onexit)
+
+// Handle uncaught errors, such as from unexpected async behaviour.
+process.on('uncaughtException', fail)
+
+/**
+ * Start the CLI.
+ *
+ * @param {Options} cliConfig
+ */
+export function args(cliConfig) {
+  /** @type {EngineOptions & {help: boolean, helpMessage: string, watch: boolean, version: boolean}} */
+  let config
+  /** @type {chokidar.FSWatcher|undefined} */
+  let watcher
+  /** @type {boolean|string|undefined} */
+  let output
 
   try {
-    config = options(process.argv.slice(2), configuration);
-  } catch (err) {
-    return fail(err, true);
+    // @ts-expect-error: Close enough.
+    config = options(process.argv.slice(2), cliConfig)
+  } catch (error) {
+    return fail(error, true)
   }
 
   if (config.help) {
-    process.stderr.write([
-      'Usage: ' + configuration.name + ' [options] [path | glob ...]',
-      '',
-      '  ' + configuration.description,
-      '',
-      'Options:',
-      '',
-      config.helpMessage
-    ].join('\n') + '\n', noop);
-
-    return;
+    process.stdout.write(
+      [
+        'Usage: ' + cliConfig.name + ' [options] [path | glob ...]',
+        '',
+        '  ' + cliConfig.description,
+        '',
+        'Options:',
+        '',
+        config.helpMessage,
+        ''
+      ].join('\n'),
+      noop
+    )
+
+    return
   }
 
   if (config.version) {
-    process.stderr.write(configuration.version + '\n', noop);
+    process.stdout.write(cliConfig.version + '\n', noop)
 
-    return;
+    return
   }
 
-  /* Modify `config` for watching. */
+  // Modify `config` for watching.
   if (config.watch) {
-    output = config.output;
+    output = config.output
 
-    /* Do not read from stdin(4). */
-    config.streamIn = ttyStream;
+    // Do not read from stdin(4).
+    config.streamIn = ttyStream
 
-    /* Do not write to stdout(4). */
-    config.out = false;
+    // Do not write to stdout(4).
+    config.out = false
 
     process.stderr.write(
       chalk.bold('Watching...') + ' (press CTRL+C to exit)\n',
       noop
-    );
+    )
 
-    /* Prevent infinite loop if set to regeneration. */
+    // Prevent infinite loop if set to regeneration.
     if (output === true) {
-      config.output = false;
+      config.output = false
 
       process.stderr.write(
         chalk.yellow('Note') + ': Ignoring `--output` until exit.\n',
         noop
-      );
+      )
     }
   }
 
-  /* Subscribe a chokidar watcher to all processed files. */
+  // Initial run.
+  engine(config, done)
+
+  /**
+   * Handle complete run.
+   *
+   * @type {EngineCallback}
+   */
+  function done(error, code, context) {
+    if (error) {
+      clean()
+      fail(error)
+    } else {
+      exitStatus = code || 0
+
+      if (config.watch && !watcher && context) {
+        subscribe(context)
+      }
+    }
+  }
+
+  // Clean the watcher.
+  function clean() {
+    if (watcher) {
+      watcher.close()
+      watcher = undefined
+    }
+  }
+
+  /**
+   * Subscribe a chokidar watcher to all processed files.
+   *
+   * @param {EngineContext} context
+   */
   function subscribe(context) {
     watcher = chokidar
-      .watch(context.fileSet.origins, {
-        cwd: config.cwd,
-        ignoreInitial: true
-      })
+      // @ts-expect-error: `fileSet` is available.
+      .watch(context.fileSet.origins, {cwd: config.cwd, ignoreInitial: true})
       .on('error', done)
-      .on('change', onchange);
-
-    process.on('SIGINT', onsigint);
-
-    function onchange(filePath) {
-      config.files = [filePath];
+      .on('change', (filePath) => {
+        config.files = [filePath]
+        engine(config, done)
+      })
 
-      engine(config, done);
-    }
+    process.on('SIGINT', onsigint)
 
+    /**
+     * Handle a SIGINT.
+     */
     function onsigint() {
-      /* Hide the `^C` in terminal. */
-      process.stderr.write('\n', noop);
+      // Hide the `^C` in terminal.
+      process.stderr.write('\n', noop)
 
-      clean();
+      clean()
 
-      /* Do another process if `output` specified regeneration. */
+      // Do another process if `output` specified regeneration.
       if (output === true) {
-        config.output = output;
-        config.watch = false;
-        engine(config, done);
+        config.output = output
+        config.watch = false
+        engine(config, done)
       }
     }
   }
-
-  /* Initial run */
-  engine(config, done);
-
-  /* Handle complete run. */
-  function done(err, code, context) {
-    if (err) {
-      clean();
-      fail(err);
-    } else {
-      exitStatus = code;
-
-      if (config.watch && !watcher) {
-        subscribe(context);
-      }
-    }
-  }
-
-  /* Clean the watcher. */
-  function clean() {
-    if (watcher) {
-      watcher.close();
-      watcher = null;
-    }
-  }
 }
 
-/* Print an error, optionally with stack. */
-function fail(err, pretty) {
-  var message = (pretty ? String(err).trim() : err.stack) || err;
+/**
+ * Print an error, optionally with stack.
+ *
+ * @param {Error} error
+ * @param {boolean} [pretty=false]
+ */
+function fail(error, pretty) {
+  // Old versions of Node
+  /* c8 ignore next 1 */
+  const message = String((pretty ? error : error.stack) || error)
 
-  exitStatus = 1;
+  exitStatus = 1
 
-  process.stderr.write(message.trim() + '\n', noop);
+  process.stderr.write(message.trim() + '\n', noop)
 }
 
 function onexit() {
   /* eslint-disable unicorn/no-process-exit */
-  process.exit(exitStatus);
+  process.exit(exitStatus)
+  /* eslint-enable unicorn/no-process-exit */
 }
+
+function noop() {}