numux 1.18.0 → 1.19.0

package/README.md

@@ -191,7 +191,8 @@ Top-level options apply to all processes (process-level settings override):
 |-------|------|-------------|
 | `cwd` | `string` | Working directory for all processes (process `cwd` overrides) |
 | `env` | `Record<string, string>` | Environment variables merged into all processes (process `env` overrides per key) |
-| `envFile` | `string \| string[]` | `.env` file(s) for all processes (process `envFile` replaces if set) |
+| `envFile` | `string \| string[] \| false` | `.env` file(s) for all processes (process `envFile` replaces if set; `false` disables) |
+| `showCommand` | `boolean` | Print the command being run as the first line of output (default: `true`) |
 
 ```ts
 export default defineConfig({
@@ -211,10 +212,10 @@ Each process accepts:
 
 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
-| `command` | `string` | *required* | Shell command to run |
+| `command` | `string` | *required* | Shell command to run. Supports `$dep.group` references from dependency capture groups |
 | `cwd` | `string` | `process.cwd()` | Working directory |
-| `env` | `Record<string, string>` | — | Extra environment variables |
-| `envFile` | `string \| string[]` | — | `.env` file path(s) to load (relative to `cwd`) |
+| `env` | `Record<string, string>` | — | Extra environment variables. Values support `$dep.group` references from dependency capture groups |
+| `envFile` | `string \| string[] \| false` | — | `.env` file path(s) to load (relative to `cwd`); `false` disables inherited envFile |
 | `dependsOn` | `string[]` | — | Processes that must be ready first |
 | `readyPattern` | `string \| RegExp` | — | Regex matched against stdout to signal readiness. Use `RegExp` to capture groups (see below) |
 | `readyTimeout` | `number` | — | Milliseconds to wait for `readyPattern` before failing |
@@ -227,6 +228,7 @@ Each process accepts:
 | `watch` | `string \| string[]` | — | Glob patterns — restart process when matching files change |
 | `interactive` | `boolean` | `false` | When `true`, keyboard input is forwarded to the process |
 | `errorMatcher` | `boolean \| string` | — | `true` detects ANSI red output, string = regex pattern — shows error indicator on tab |
+| `showCommand` | `boolean` | `true` | Print the command being run as the first line of output |
 
 ### File watching
 

package/dist/config.d.ts

@@ -1,4 +1,4 @@
 import type { NumuxConfig } from './types';
 export type { NumuxConfig, NumuxProcessConfig } from './types';
 /** Type-safe helper for numux.config.ts files. */
-export declare function defineConfig(config: NumuxConfig): NumuxConfig;
+export declare function defineConfig<K extends string>(config: NumuxConfig<K>): NumuxConfig<K>;

package/dist/numux.js

@@ -36,7 +36,7 @@ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports,
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "1.18.0",
+    version: "1.19.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -1030,8 +1030,10 @@ function validateConfig(raw, warnings) {
       throw new Error(`Process "${name}" must have a non-empty "command" string`);
     }
     if (p.dependsOn !== undefined) {
+      if (typeof p.dependsOn === "string")
+        p.dependsOn = [p.dependsOn];
       if (!Array.isArray(p.dependsOn)) {
-        throw new Error(`Process "${name}".dependsOn must be an array`);
+        throw new Error(`Process "${name}".dependsOn must be a string or array`);
       }
       for (const dep of p.dependsOn) {
         if (typeof dep !== "string") {

package/dist/types.d.ts

@@ -1,42 +1,89 @@
-export interface NumuxProcessConfig {
+export interface NumuxProcessConfig<K extends string = string> {
+    /** Shell command to run. Supports `$dep.group` references from dependency capture groups */
     command: string;
+    /** Working directory for the process */
     cwd?: string;
+    /**
+     * Extra environment variables. Values support `$dep.group` references
+     * from dependency capture groups.
+     * @example { DB_PORT: '$db.port' }
+     */
     env?: Record<string, string>;
+    /** .env file path(s) to load, or `false` to disable */
     envFile?: string | string[] | false;
-    dependsOn?: string[];
+    /** Processes that must be ready before this one starts */
+    dependsOn?: NoInfer<K> | NoInfer<K>[];
+    /** Regex matched against stdout to signal readiness. Use `RegExp` to capture groups for `$dep.group` expansion */
     readyPattern?: string | RegExp;
+    /**
+     * Set to `false` for one-shot processes
+     * @default true
+     */
     persistent?: boolean;
+    /**
+     * Limit auto-restart attempts
+     * @default Infinity
+     */
     maxRestarts?: number;
+    /** Milliseconds to wait for readyPattern before failing */
     readyTimeout?: number;
+    /** Milliseconds to wait before starting the process */
     delay?: number;
+    /** Env var name (prefix with `!` to negate); process skipped if condition is falsy */
     condition?: string;
+    /**
+     * Signal for graceful stop
+     * @default 'SIGTERM'
+     */
     stopSignal?: 'SIGTERM' | 'SIGINT' | 'SIGHUP';
+    /** Hex color (e.g. `"#ff6600"`) or color name. Array for round-robin in script patterns */
     color?: string | string[];
+    /** Glob patterns — restart process when matching files change */
     watch?: string | string[];
+    /**
+     * When true, keyboard input is forwarded to the process
+     * @default false
+     */
     interactive?: boolean;
+    /** `true` = detect ANSI red output, string = regex pattern */
     errorMatcher?: boolean | string;
+    /**
+     * Print the command being run as the first line of output
+     * @default true
+     */
     showCommand?: boolean;
 }
 /** Config for npm: wildcard entries — command is derived from package.json scripts */
-export type NumuxScriptPattern = Omit<NumuxProcessConfig, 'command'> & {
+export type NumuxScriptPattern<K extends string = string> = Omit<NumuxProcessConfig<K>, 'command'> & {
     command?: never;
 };
 /** Raw config as authored — processes can be string shorthand, full objects, or wildcard patterns */
-export interface NumuxConfig {
+export interface NumuxConfig<K extends string = string> {
+    /** Global working directory, inherited by all processes */
     cwd?: string;
+    /** Global env vars, merged into each process (process-level overrides) */
     env?: Record<string, string>;
+    /** Global .env file(s), inherited by processes without their own envFile; `false` disables */
     envFile?: string | string[] | false;
+    /**
+     * Global showCommand flag, inherited by all processes
+     * @default true
+     */
     showCommand?: boolean;
-    processes: Record<string, NumuxProcessConfig | NumuxScriptPattern | string>;
+    processes: Record<K, NumuxProcessConfig<K> | NumuxScriptPattern<K> | string>;
+}
+/** Process config after validation — dependsOn is always normalized to an array */
+export interface ResolvedProcessConfig extends Omit<NumuxProcessConfig, 'dependsOn'> {
+    dependsOn?: string[];
 }
 /** Validated config with all shorthand expanded to full objects */
 export interface ResolvedNumuxConfig {
-    processes: Record<string, NumuxProcessConfig>;
+    processes: Record<string, ResolvedProcessConfig>;
 }
 export type ProcessStatus = 'pending' | 'starting' | 'ready' | 'running' | 'stopping' | 'stopped' | 'finished' | 'failed' | 'skipped';
 export interface ProcessState {
     name: string;
-    config: NumuxProcessConfig;
+    config: ResolvedProcessConfig;
     status: ProcessStatus;
     exitCode: number | null;
     restartCount: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numux",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "description": "Terminal multiplexer with dependency orchestration",
   "type": "module",
   "license": "MIT",