runset 0.0.2 → 0.0.4

package/README.md

@@ -1,5 +1,8 @@
 # runset
 
+[![Tests](https://github.com/megahertz/runset/actions/workflows/tests.yml/badge.svg)](https://github.com/megahertz/runset/actions/workflows/tests.yml)
+[![NPM version](https://badge.fury.io/js/runset.svg)](https://badge.fury.io/js/runset)
+
 Run npm scripts and shell commands in parallel or sequence, with glob matching,
 reusable pipelines, colored labels, and grouped output. Inspired by
 `npm-run-all`, with more control over execution and output.
@@ -12,6 +15,12 @@ reusable pipelines, colored labels, and grouped output. Inspired by
 - **Workspace support**
 - **Zero dependencies**
 
+<p align="center">
+  <img src="docs/screenshot.png" alt="runset output: realtime on the left, grouped on the right">
+  <br>
+  <sub>Realtime output (default) on the left, grouped (<code>-o grouped</code>) on the right</sub>
+</p>
+
 ```sh
 npm install --save-dev runset
 ```
@@ -191,9 +200,9 @@ show their status and duration: `✓ 2.1s`, `✗ code 1 · 2.1s`, or
 `– stopped · 2.1s`. Failure and stop lines also name the command. These lines
 follow the command's stdout settings, including grouping and redirection.
 
-`-w, --wrap` wraps long labelled lines and repeats the label on every line. It
+Long labelled lines are wrapped, with the label repeated on every line. Wrapping
 uses the terminal width, or `COLUMNS` when no terminal width is available;
-without either, lines stay whole. Wrapping is off by default.
+without either, lines stay whole. `--no-wrap` or `wrap: false` turns it off.
 
 ## Config
 
@@ -343,7 +352,7 @@ setting from the config. `--no-color` is an alias for `--color none`.
 | `--color <mode>`       | `auto` (default), `none`, `basic`, `soft`, or `all`.                                                         |
 | `--show-command`       | Print each command when it starts; default: off.                                                             |
 | `--show-exit-code`     | Print each command's exit status and duration; default: off.                                                 |
-| `-w, --wrap`           | Wrap long labelled lines, repeating the label; default: off.                                                 |
+| `--no-wrap`            | Leave long labelled lines whole instead of wrapping them with the label repeated.                            |
 | `--log-level <level>`  | Filter runset's own messages: `error`, `warn`, `info` (default), or `debug`. Does not filter command output. |
 
 ### Configuration and help

package/dist/index.d.mts

@@ -7,7 +7,6 @@ export interface Std {
   timing: StdTiming;
 }
 export type ExitAction = 'continue' | 'restart' | 'stop';
-export declare const EXIT_ACTIONS: Set<ExitAction>;
 export type LogLevel = 'debug' | 'error' | 'info' | 'warn';
 /**
  * How much color runset uses: `basic` is the terminal's 16 theme colors,
@@ -23,7 +22,6 @@ export interface Command {
   color: string;
   command: string;
   cwd: string;
-  disabled: boolean;
   env: NodeJS.ProcessEnv;
   label: string;
   /** What is handed to the shell: for an npm command, the script's body. */
@@ -32,9 +30,6 @@ export interface Command {
   onSuccess: ExitAction;
   /** The workspace package a `recursive` command was expanded into. */
   packageName?: string;
-  parallel: boolean;
-  /** Run an npm script in every workspace package that has it. */
-  recursive: boolean;
   /** The `package.json` script name, when `type` is `'npm'`. */
   scriptName?: string;
   /** Commands sharing a stage run together; stages run in order. */
@@ -52,13 +47,26 @@ export type LabelFormatter = (context: {
   defaultPrefix: string;
   stream: 'stderr' | 'stdout';
 }) => string;
-/** The parts of a {@link Command} a user may set by hand. */
-export type CommandOptions = {
+/** What a user may set about a command, by hand. */
+export interface CommandOptions {
+  bgColor?: string;
+  color?: string;
+  cwd?: string;
+  /** Leave the command out of the run. */
+  disabled?: boolean;
+  env?: NodeJS.ProcessEnv;
+  label?: string;
+  onFailure?: ExitAction;
+  onSuccess?: ExitAction;
   /** Both streams at once; `stdout` / `stderr` in the same place outrank it. */
   output?: Partial<Std> | string;
+  /** Join the group of commands beside it rather than open a stage of its own. */
+  parallel?: boolean;
+  /** Run an npm script in every workspace package that has it. */
+  recursive?: boolean;
   stderr?: Partial<Std> | string;
   stdout?: Partial<Std> | string;
-} & Partial<Omit<Command, 'line' | 'packageName' | 'scriptName' | 'stage' | 'stderr' | 'stdout' | 'type'>>;
+}
 /** One command written as an object; `command` is what makes it one. */
 export type CommandEntry = {
   command: string;
@@ -69,7 +77,7 @@ export type CommandEntry = {
  */
 export type CommandSettings = {
   serial?: boolean;
-} & Omit<CommandOptions, 'command'>;
+} & CommandOptions;
 /** A command before normalization; falsy entries are skipped. */
 export type CommandDefinition = CommandEntry | CommandSettings | false | null | string | undefined;
 /** What a user writes in `runset.config.*`, or hands to `runset({ … })`. */
@@ -113,7 +121,7 @@ export interface ConfigJs {
   showExitCode?: boolean;
   stderr?: Partial<Std> | string;
   stdout?: Partial<Std> | string;
-  /** Wrap labelled lines to the terminal, labelling each piece. Default: `false`. */
+  /** Wrap labelled lines to the terminal, labelling each piece. Default: `true`. */
   wrap?: boolean;
 }
 /** A config module may export the object itself or a sync factory for it. */
@@ -128,14 +136,6 @@ export interface TerminateOptions {
   /** Default: SIGTERM. Ignored under `force`. */
   signal?: NodeJS.Signals;
 }
-/** Where a run writes. */
-export interface Destinations {
-  stderr: NodeJS.WritableStream;
-  stdout: NodeJS.WritableStream;
-}
-/** True for an object written without a `command` — a settings entry. */
-export declare function isCommandSettings(definition: CommandEntry | CommandSettings): definition is CommandSettings;
-export declare function isStreamDestination(destination: string): destination is 'stderr' | 'stdout';
 //#endregion
 //#region src/utils/colors.d.ts
 /** A `ColorMode` once `auto` has been settled. */
@@ -144,17 +144,17 @@ type ColorLevel = Exclude<ColorMode, 'auto'>;
 //#region src/config/parseCli.d.ts
 /** Run-wide options a CLI flag can set. */
 interface CliOptions {
-  color?: string;
+  color?: ColorMode;
   config?: string;
   cwd?: string;
   dryRun?: boolean;
   env?: Record<string, string>;
   jobs?: number;
   killTimeout?: number;
-  labels?: string;
-  logLevel?: string;
-  onFailure?: string;
-  onSuccess?: string;
+  labels?: LabelMode;
+  logLevel?: LogLevel;
+  onFailure?: ExitAction;
+  onSuccess?: ExitAction;
   output?: string;
   recursive?: boolean;
   showCommand?: boolean;
@@ -210,6 +210,11 @@ declare class Config {
   /** True when `commands` holds something to run, not just settings entries. */
   hasCommands(): boolean;
 }
+/** Where a run writes. */
+interface Destinations {
+  stderr: NodeJS.WritableStream;
+  stdout: NodeJS.WritableStream;
+}
 interface ResolvedConfigOptions {
   /** Defaults to the process's own argv; a library caller passes `parseCli([])`. */
   cli: ParsedCli;
@@ -239,7 +244,6 @@ interface Plan {
 //#region src/run/Run.d.ts
 /** One run: the processes built from a plan, and what stops them. */
 export declare class Run {
-  readonly config: Config;
   private readonly logger;
   private readonly files;
   private stopping;
@@ -269,8 +273,6 @@ export declare class Run {
 /** Any failure runset reports itself; `exitCode` is what the CLI exits with. */
 export declare class RunsetError extends Error {
   readonly exitCode: number;
-  /** What the CLI prints in place of `message`; empty when it already said so. */
-  readonly report: string | undefined;
   constructor(message: string, exitCode?: number, report?: string);
 }
 /** A command line runset cannot read. */