first commit

2026-10-07 18:56:27 +02:00
commit 2a8a60b725
7768 changed files with 1550851 additions and 0 deletions
@@ -0,0 +1,71 @@
+/**
+ * @author Toru Nagashima
+ * @copyright 2016 Toru Nagashima. All rights reserved.
+ * @copyright 2026 Bret Comnes. All rights reserved.
+ * See LICENSE file in root directory for full license.
+ *
+ * @import { Writable } from 'node:stream'
+ */
+
+// ------------------------------------------------------------------------------
+// Public Interface
+// ------------------------------------------------------------------------------
+
+/**
+ * Print a help text.
+ *
+ * @param {Writable} output - A writable stream to print.
+ * @returns {Promise<null>} Always a fulfilled promise.
+ * @private
+ */
+export default function printHelp (output) {
+  output.write(`
+Usage:
+    $ run-s [--help | -h | --version | -v]
+    $ run-s [OPTIONS] <tasks>
+
+    Run given npm-scripts sequentially.
+
+    <tasks> : A list of npm-scripts' names and Glob-like patterns.
+
+Options:
+    -c, --continue-on-error  - Set the flag to continue executing subsequent
+                               tasks even if a task threw an error. 'run-s'
+                               itself will exit with non-zero code if one or
+                               more tasks threw error(s).
+    --npm-path <string>  - - - Set the path to npm. Default is the value of
+                               environment variable npm_execpath.
+                               If the variable is not defined, then it's "npm."
+                               In this case, the "npm" command must be found in
+                               environment variable PATH.
+    -l, --print-label  - - - - Set the flag to print the task name as a prefix
+                               on each line of output. Tools in tasks may stop
+                               coloring their output if this option was given.
+    -n, --print-name   - - - - Set the flag to print the task name before
+                               running each task.
+    -s, --silent   - - - - - - Set 'silent' to the log level of npm.
+    -x, --node-run   - - - - - Use \`node --run\` to execute scripts instead of
+                               the package manager. This is faster but
+                               intentionally omits: pre/post lifecycle hooks
+                               and npm_* environment variables. node_modules/.bin
+                               is still added to PATH. Sets NODE_RUN_SCRIPT_NAME
+                               and NODE_RUN_PACKAGE_JSON_PATH instead.
+                               Can also be enabled project-wide by setting
+                               \`"npm-run-all2": { "nodeRun": true }\` in
+                               package.json.
+
+    Shorthand aliases can be combined.
+    For example, '-clns' equals to '-c -l -n -s'.
+
+Examples:
+    $ run-s build:**
+    $ run-s lint clean build:**
+    $ run-s --silent --print-name lint clean build:**
+    $ run-s -sn lint clean build:**
+
+See Also:
+    https://github.com/mysticatea/npm-run-all#readme
+`)
+
+  return Promise.resolve(null)
+}
@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * @author Toru Nagashima
+ * @copyright 2015 Toru Nagashima. All rights reserved.
+ * @copyright 2026 Bret Comnes. All rights reserved.
+ * See LICENSE file in root directory for full license.
+ */
+
+// ------------------------------------------------------------------------------
+// Main
+// ------------------------------------------------------------------------------
+
+import bootstrap from '#bin/common/bootstrap.js'
+
+bootstrap('run-s')
@@ -0,0 +1,79 @@
+/**
+ * @author Toru Nagashima
+ * @copyright 2016 Toru Nagashima. All rights reserved.
+ * @copyright 2026 Bret Comnes. All rights reserved.
+ * See LICENSE file in root directory for full license.
+ *
+ * @import { Writable } from 'node:stream'
+ */
+
+// ------------------------------------------------------------------------------
+// Requirements
+// ------------------------------------------------------------------------------
+
+import runAll from '#lib'
+import parseCLIArgs from '#bin/common/parse-cli-args.js'
+
+// ------------------------------------------------------------------------------
+// Public Interface
+// ------------------------------------------------------------------------------
+
+/**
+ * Parses arguments, then run specified npm-scripts.
+ *
+ * @param {string[]} args - Arguments to parse.
+ * @param {Writable} stdout - A writable stream to print logs.
+ * @param {Writable} stderr - A writable stream to print errors.
+ * @returns {Promise<unknown>} A promise which comes to be fulfilled when all npm-scripts are completed.
+ * @private
+ */
+export default function npmRunAll (args, stdout, stderr) {
+  try {
+    const stdin = process.stdin
+    const argv = parseCLIArgs(args, { parallel: false }, { singleMode: true })
+    const group = argv.lastGroup
+
+    if (group.patterns.length === 0) {
+      return Promise.resolve(null)
+    }
+
+    const promise = runAll(
+      group.patterns,
+      {
+        stdout,
+        stderr,
+        stdin,
+        parallel: group.parallel,
+        continueOnError: argv.continueOnError,
+        printLabel: argv.printLabel,
+        printName: argv.printName,
+        config: argv.config,
+        packageConfig: argv.packageConfig,
+        silent: argv.silent,
+        arguments: argv.rest,
+        npmPath: argv.npmPath,
+        nodeRun: argv.nodeRun,
+        colorMode: argv.colorMode,
+      }
+    )
+
+    if (!argv.silent) {
+      promise.catch(
+        /**
+         * @param {unknown} err - The rejection reason.
+         */
+        err => {
+          const message = err instanceof Error ? err.message : String(err)
+          console.error('ERROR:', message)
+        }
+      )
+    }
+
+    return promise
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err)
+    console.error('ERROR:', message)
+
+    return Promise.reject(err)
+  }
+}