numux 1.5.2 → 1.7.0

package/README.md

@@ -178,7 +178,7 @@ Each process accepts:
 | `delay` | `number` | — | Milliseconds to wait before starting the process |
 | `condition` | `string` | — | Env var name; process skipped if falsy. Prefix with `!` to negate |
 | `stopSignal` | `string` | `SIGTERM` | Signal for graceful stop (`SIGTERM`, `SIGINT`, or `SIGHUP`) |
-| `color` | `string` | auto | Hex color for tab icon and status bar (e.g. `"#ff6600"`) |
+| `color` | `string \| string[]` | auto | Hex (e.g. `"#ff6600"`) or basic name: black, red, green, yellow, blue, magenta, cyan, white, gray, orange, purple |
 | `watch` | `string \| string[]` | — | Glob patterns — restart process when matching files change |
 | `interactive` | `boolean` | `false` | When `true`, keyboard input is forwarded to the process |
 
@@ -268,18 +268,15 @@ Persistent processes that crash are auto-restarted with exponential backoff (1s
 | Key | Action |
 |-----|--------|
 | `Ctrl+C` | Quit (graceful shutdown) |
-| `Alt+R` | Restart active process |
-| `Alt+Shift+R` | Restart all processes |
-| `Alt+S` | Stop/start active process |
-| `Alt+L` | Clear active pane output |
-| `Alt+1`–`Alt+9` | Jump to tab |
-| `Alt+Left/Right` | Cycle tabs |
-| `Up/Down` | Navigate between tabs |
-| `PageUp/PageDown` | Scroll output by page (non-interactive panes) |
-| `Home/End` | Scroll to top/bottom (non-interactive panes) |
-| `Alt+PageUp/PageDown` | Scroll output up/down |
-| `Alt+Home/End` | Scroll to top/bottom |
-| `Alt+F` | Search in active pane output |
+| `R` | Restart active process |
+| `Shift+R` | Restart all processes |
+| `S` | Stop/start active process |
+| `L` | Clear active pane output |
+| `F` | Search in active pane output |
+| `1`–`9` | Jump to tab |
+| `Left/Right` | Cycle tabs |
+| `PageUp/PageDown` | Scroll output by page |
+| `Home/End` | Scroll to top/bottom |
 
 While searching: type to filter, `Enter`/`Shift+Enter` to navigate matches, `Escape` to close.
 
@@ -298,6 +295,12 @@ Panes are readonly by default — keyboard input is not forwarded to processes.
 | ✖ | Failed |
 | ⊘ | Skipped |
 
+## Dependencies
+
+### ghostty-opentui
+
+Despite the name, [`ghostty-opentui`](https://github.com/user/ghostty-opentui) is **not** a compatibility layer for the [Ghostty](https://ghostty.org) terminal. It uses Ghostty's Zig-based VT parser as the ANSI terminal emulation engine for OpenTUI's terminal renderable. It works in any terminal emulator (iTerm, Kitty, Alacritty, WezTerm, etc.) and adds ~8MB to install size due to native binaries.
+
 ## License
 
 MIT

package/dist/numux.js

@@ -22,7 +22,7 @@ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports,
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "1.5.2",
+    version: "1.7.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -382,15 +382,18 @@ function detectPackageManager(pkgJson, cwd) {
   }
   return "npm";
 }
+function isGlobPattern(name) {
+  return /[*?[]/.test(name);
+}
 function expandScriptPatterns(config, cwd) {
   const entries = Object.entries(config.processes);
-  const hasWildcard = entries.some(([name]) => name.startsWith("npm:"));
+  const hasWildcard = entries.some(([name]) => name.startsWith("npm:") || isGlobPattern(name));
   if (!hasWildcard)
     return config;
   const dir = config.cwd ?? cwd ?? process.cwd();
   const pkgPath = resolve(dir, "package.json");
   if (!existsSync(pkgPath)) {
-    throw new Error(`npm: patterns require a package.json (looked in ${dir})`);
+    throw new Error(`Wildcard patterns require a package.json (looked in ${dir})`);
   }
   const pkgJson = JSON.parse(readFileSync(pkgPath, "utf-8"));
   const scripts = pkgJson.scripts;
@@ -401,11 +404,11 @@ function expandScriptPatterns(config, cwd) {
   const pm = detectPackageManager(pkgJson, dir);
   const expanded = {};
   for (const [name, value] of entries) {
-    if (!name.startsWith("npm:")) {
+    if (!(name.startsWith("npm:") || isGlobPattern(name))) {
       expanded[name] = value;
       continue;
     }
-    const pattern = name.slice(4);
+    const pattern = name.startsWith("npm:") ? name.slice(4) : name;
     const template = value ?? {};
     if (template.command) {
       throw new Error(`"${name}": wildcard processes cannot have a "command" field (commands come from package.json scripts)`);
@@ -589,6 +592,31 @@ function findCycle(remaining, config) {
 }
 
 // src/utils/color.ts
+var BASIC_COLORS = {
+  black: "#000000",
+  red: "#ff0000",
+  green: "#00ff00",
+  yellow: "#ffff00",
+  blue: "#0000ff",
+  magenta: "#ff00ff",
+  cyan: "#00ffff",
+  white: "#ffffff",
+  gray: "#808080",
+  grey: "#808080",
+  orange: "#ffa500",
+  purple: "#800080"
+};
+function isValidColor(color) {
+  if (HEX_COLOR_RE.test(color))
+    return true;
+  return color.toLowerCase() in BASIC_COLORS;
+}
+function resolveToHex(color) {
+  if (HEX_COLOR_RE.test(color))
+    return color.startsWith("#") ? color : `#${color}`;
+  const hex = BASIC_COLORS[color.toLowerCase()];
+  return hex ?? "";
+}
 function hexToAnsi(hex) {
   const h = hex.replace("#", "");
   const r = Number.parseInt(h.slice(0, 2), 16);
@@ -638,7 +666,11 @@ function buildProcessColorMap(names, config) {
   for (const name of names) {
     const explicit = resolveColor(config.processes[name]?.color);
     if (explicit) {
-      map.set(name, hexToAnsi(explicit));
+      const hex = resolveToHex(explicit);
+      if (hex)
+        map.set(name, hexToAnsi(hex));
+      else
+        map.set(name, DEFAULT_ANSI_COLORS[paletteIndex++ % DEFAULT_ANSI_COLORS.length]);
     } else {
       map.set(name, DEFAULT_ANSI_COLORS[paletteIndex % DEFAULT_ANSI_COLORS.length]);
       paletteIndex++;
@@ -654,7 +686,11 @@ function buildProcessHexColorMap(names, config) {
   for (const name of names) {
     const explicit = resolveColor(config.processes[name]?.color);
     if (explicit) {
-      map.set(name, explicit.startsWith("#") ? explicit : `#${explicit}`);
+      const hex = resolveToHex(explicit);
+      if (hex)
+        map.set(name, hex);
+      else
+        map.set(name, DEFAULT_HEX_COLORS[paletteIndex++ % DEFAULT_HEX_COLORS.length]);
     } else {
       map.set(name, DEFAULT_HEX_COLORS[paletteIndex % DEFAULT_HEX_COLORS.length]);
       paletteIndex++;
@@ -718,13 +754,13 @@ function validateConfig(raw, warnings) {
       }
     }
     if (typeof p.color === "string") {
-      if (!HEX_COLOR_RE.test(p.color)) {
-        throw new Error(`Process "${name}".color must be a valid hex color (e.g. "#ff8800"), got "${p.color}"`);
+      if (!isValidColor(p.color)) {
+        throw new Error(`Process "${name}".color must be a hex color (e.g. "#ff8800") or basic name (black, red, green, yellow, blue, magenta, cyan, white, gray, orange, purple), got "${p.color}"`);
       }
     } else if (Array.isArray(p.color)) {
       for (const c of p.color) {
-        if (typeof c !== "string" || !HEX_COLOR_RE.test(c)) {
-          throw new Error(`Process "${name}".color entries must be valid hex colors (e.g. "#ff8800"), got "${c}"`);
+        if (typeof c !== "string" || !isValidColor(c)) {
+          throw new Error(`Process "${name}".color entries must be hex or basic names (black, red, green, yellow, blue, magenta, cyan, white, gray, orange), got "${c}"`);
         }
       }
     }
@@ -2400,7 +2436,7 @@ Usage:
 
 Options:
   -n, --name <name=command>  Add a named process
-  -c, --color <colors>       Comma-separated colors for processes (hex, e.g. #ff0,#0f0)
+  -c, --color <colors>       Comma-separated colors (hex or names: black, red, green, yellow, blue, magenta, cyan, white, gray, orange, purple)
   --config <path>            Config file path (default: auto-detect)
   -p, --prefix               Prefixed output mode (no TUI, for CI/scripts)
   --only <a,b,...>           Only run these processes (+ their dependencies)
@@ -2531,10 +2567,11 @@ async function main() {
   let config;
   const warnings = [];
   if (parsed.commands.length > 0 || parsed.named.length > 0) {
-    const hasNpmPatterns = parsed.commands.some((c) => c.startsWith("npm:"));
+    const isScriptPattern = (c) => c.startsWith("npm:") || /[*?[]/.test(c);
+    const hasNpmPatterns = parsed.commands.some(isScriptPattern);
     if (hasNpmPatterns) {
-      const npmPatterns = parsed.commands.filter((c) => c.startsWith("npm:"));
-      const otherCommands = parsed.commands.filter((c) => !c.startsWith("npm:"));
+      const npmPatterns = parsed.commands.filter(isScriptPattern);
+      const otherCommands = parsed.commands.filter((c) => !isScriptPattern(c));
       const processes = {};
       for (const pattern of npmPatterns) {
         const entry = {};

package/package.json

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