numux 1.10.3 → 1.11.0

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.10.3",
+    version: "1.11.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -122,6 +122,16 @@ var FLAGS = [
     key: "autoColors",
     description: "Auto-assign colors to processes based on their name"
   },
+  {
+    type: "value",
+    long: "--env-file",
+    short: "-e",
+    key: "envFile",
+    description: 'Env file path, or "false" to disable env file loading',
+    valueName: "<path|false>",
+    completionHint: "file",
+    parse: (raw) => raw === "false" ? false : raw
+  },
   {
     type: "value",
     long: "--config",
@@ -970,7 +980,7 @@ function validateConfig(raw, warnings) {
     throw new Error("Config must define at least one process");
   }
   const globalCwd = typeof config.cwd === "string" ? config.cwd : undefined;
-  const globalEnvFile = validateStringOrStringArray(config.envFile);
+  const globalEnvFile = validateEnvFile(config.envFile);
   let globalEnv;
   if (config.env && typeof config.env === "object") {
     for (const [k, v] of Object.entries(config.env)) {
@@ -1066,7 +1076,11 @@ function validateStringOrStringArray(value) {
     return value;
   return;
 }
-var validateEnvFile = validateStringOrStringArray;
+function validateEnvFile(value) {
+  if (value === false)
+    return false;
+  return validateStringOrStringArray(value);
+}
 function validateErrorMatcher(name, value) {
   if (value === true)
     return true;
@@ -2119,6 +2133,37 @@ var STATUS_ICON_HEX = {
   skipped: "#888888"
 };
 var TERMINAL_STATUSES = new Set(["finished", "stopped", "failed", "skipped"]);
+function formatTab(name, status) {
+  return `${STATUS_ICONS[status]} ${name}`;
+}
+function formatDescription(status, exitCode, restartCount) {
+  let desc = status;
+  if ((status === "failed" || status === "stopped") && exitCode != null && exitCode !== 0) {
+    desc = `exit ${exitCode}`;
+  }
+  if (restartCount && restartCount > 0) {
+    desc += ` \xD7${restartCount}`;
+  }
+  return desc;
+}
+function getDisplayOrder(originalNames, statuses) {
+  const active = originalNames.filter((n) => !TERMINAL_STATUSES.has(statuses.get(n)));
+  const terminal = originalNames.filter((n) => TERMINAL_STATUSES.has(statuses.get(n)));
+  return [...active, ...terminal];
+}
+function resolveOptionColors(names, statuses, processColors, inputWaiting, erroredProcesses) {
+  return names.map((name) => {
+    const status = statuses.get(name);
+    const waiting = inputWaiting.has(name);
+    const errored = erroredProcesses.has(name);
+    const statusHex = waiting ? "#ffaa00" : errored ? "#ff5555" : STATUS_ICON_HEX[status];
+    const processHex = processColors.get(name);
+    return {
+      iconHex: statusHex ?? processHex ?? "#888888",
+      nameHex: processHex ?? null
+    };
+  });
+}
 
 class ColoredSelectRenderable extends SelectRenderable {
   _optionColors = [];
@@ -2126,12 +2171,11 @@ class ColoredSelectRenderable extends SelectRenderable {
     this._optionColors = colors;
     this.requestRender();
   }
-  renderSelf(buffer, deltaTime) {
-    const wasDirty = this.isDirty;
-    super.renderSelf(buffer, deltaTime);
-    if (wasDirty && this.frameBuffer && this._optionColors.length > 0) {
-      this.colorizeOptions();
-    }
+  renderSelf(_buffer, _deltaTime) {
+    if (!(this.visible && this.frameBuffer))
+      return;
+    if (this.isDirty)
+      this.renderOptions();
   }
   onMouseEvent(event) {
     if (event.type === "down") {
@@ -2144,28 +2188,45 @@ class ColoredSelectRenderable extends SelectRenderable {
       }
     }
   }
-  colorizeOptions() {
+  renderOptions() {
+    if (!this.frameBuffer || this.options.length === 0)
+      return;
     const fb = this.frameBuffer;
+    const bgColor = this._focused ? this._focusedBackgroundColor : this._backgroundColor;
+    fb.clear(bgColor);
     const scrollOffset = this.scrollOffset;
     const maxVisibleItems = this.maxVisibleItems;
     const linesPerItem = this.linesPerItem;
+    const fontHeight = this.fontHeight;
     const selectedIndex = this.getSelectedIndex();
-    const options = this.options;
-    const visibleCount = Math.min(maxVisibleItems, options.length - scrollOffset);
+    const showDescription = this._showDescription;
     const baseTextColor = this._focused ? this._focusedTextColor : this._textColor;
     const selectedTextColor = this._selectedTextColor;
-    const lineWidth = fb.width;
+    const descColor = this._descriptionColor;
+    const selectedDescColor = this._selectedDescriptionColor;
+    const selectedBgColor = this._selectedBackgroundColor;
+    const itemSpacing = this._itemSpacing;
+    const visibleCount = Math.min(maxVisibleItems, this.options.length - scrollOffset);
     for (let i = 0;i < visibleCount; i++) {
       const actualIndex = scrollOffset + i;
-      const itemY = i * linesPerItem;
-      const optName = options[actualIndex].name;
+      const option = this.options[actualIndex];
       const isSelected = actualIndex === selectedIndex;
-      const defaultColor = isSelected ? selectedTextColor : baseTextColor;
+      const itemY = i * linesPerItem;
+      if (itemY + linesPerItem - 1 >= this.height)
+        break;
+      if (isSelected) {
+        fb.fillRect(0, itemY, this.width, linesPerItem - itemSpacing, selectedBgColor);
+      }
       const colors = this._optionColors[actualIndex];
-      const textColor = colors?.name ?? defaultColor;
-      fb.drawText(optName.padEnd(lineWidth), 1, itemY, textColor);
+      const defaultColor = isSelected ? selectedTextColor : baseTextColor;
+      const nameColor = colors?.name ?? defaultColor;
+      fb.drawText(option.name, 1, itemY, nameColor);
       if (colors?.icon) {
-        fb.drawText(optName.charAt(0), 1, itemY, colors.icon);
+        fb.drawText(option.name.charAt(0), 1, itemY, colors.icon);
+      }
+      if (showDescription && itemY + fontHeight < this.height) {
+        const dc = isSelected ? selectedDescColor : descColor;
+        fb.drawText(option.description, 3, itemY + fontHeight, dc);
       }
     }
   }
@@ -2191,7 +2252,7 @@ class TabBar {
       width: "100%",
       height: "100%",
       options: names.map((n) => ({
-        name: this.formatTab(n, "pending"),
+        name: formatTab(n, "pending"),
         description: "pending"
       })),
       selectedBackgroundColor: "#334455",
@@ -2214,7 +2275,7 @@ class TabBar {
   }
   updateStatus(name, status, exitCode, restartCount) {
     this.statuses.set(name, status);
-    this.baseDescriptions.set(name, this.formatDescription(status, exitCode, restartCount));
+    this.baseDescriptions.set(name, formatDescription(status, exitCode, restartCount));
     if (TERMINAL_STATUSES.has(status) || status === "stopping") {
       this.inputWaiting.delete(name);
     }
@@ -2246,9 +2307,9 @@ class TabBar {
   refreshOptions() {
     const currentIdx = this.renderable.getSelectedIndex();
     const currentName = this.names[currentIdx];
-    this.names = this.getDisplayOrder();
+    this.names = getDisplayOrder(this.originalNames, this.statuses);
     this.renderable.options = this.names.map((n) => ({
-      name: this.formatTab(n, this.statuses.get(n)),
+      name: formatTab(n, this.statuses.get(n)),
       description: this.getDescription(n)
     }));
     const newIdx = this.names.indexOf(currentName);
@@ -2257,11 +2318,6 @@ class TabBar {
     }
     this.updateOptionColors();
   }
-  getDisplayOrder() {
-    const active = this.originalNames.filter((n) => !TERMINAL_STATUSES.has(this.statuses.get(n)));
-    const terminal = this.originalNames.filter((n) => TERMINAL_STATUSES.has(this.statuses.get(n)));
-    return [...active, ...terminal];
-  }
   getDescription(name) {
     if (this.inputWaiting.has(name))
       return "awaiting input";
@@ -2270,33 +2326,13 @@ class TabBar {
     return this.baseDescriptions.get(name) ?? "pending";
   }
   updateOptionColors() {
-    const colors = this.names.map((name) => {
-      const status = this.statuses.get(name);
-      const waiting = this.inputWaiting.has(name);
-      const errored = this.erroredProcesses.has(name);
-      const statusHex = waiting ? "#ffaa00" : errored ? "#ff5555" : STATUS_ICON_HEX[status];
-      const processHex = this.processColors.get(name);
-      return {
-        icon: parseColor(statusHex ?? processHex ?? "#888888"),
-        name: processHex ? parseColor(processHex) : null
-      };
-    });
+    const resolved = resolveOptionColors(this.names, this.statuses, this.processColors, this.inputWaiting, this.erroredProcesses);
+    const colors = resolved.map((c) => ({
+      icon: parseColor(c.iconHex),
+      name: c.nameHex ? parseColor(c.nameHex) : null
+    }));
     this.renderable.setOptionColors(colors);
   }
-  formatDescription(status, exitCode, restartCount) {
-    let desc = status;
-    if ((status === "failed" || status === "stopped") && exitCode != null && exitCode !== 0) {
-      desc = `exit ${exitCode}`;
-    }
-    if (restartCount && restartCount > 0) {
-      desc += ` \xD7${restartCount}`;
-    }
-    return desc;
-  }
-  formatTab(name, status) {
-    const icon = STATUS_ICONS[status];
-    return `${icon} ${name}`;
-  }
   getSelectedIndex() {
     return this.renderable.getSelectedIndex();
   }
@@ -3114,6 +3150,11 @@ async function main() {
       }
     }
   }
+  if (parsed.envFile !== undefined) {
+    for (const proc of Object.values(config.processes)) {
+      proc.envFile = parsed.envFile;
+    }
+  }
   if (parsed.noWatch) {
     for (const proc of Object.values(config.processes)) {
       delete proc.watch;

package/dist/types.d.ts

@@ -2,7 +2,7 @@ export interface NumuxProcessConfig {
     command: string;
     cwd?: string;
     env?: Record<string, string>;
-    envFile?: string | string[];
+    envFile?: string | string[] | false;
     dependsOn?: string[];
     readyPattern?: string;
     persistent?: boolean;
@@ -24,7 +24,7 @@ export type NumuxScriptPattern = Omit<NumuxProcessConfig, 'command'> & {
 export interface NumuxConfig {
     cwd?: string;
     env?: Record<string, string>;
-    envFile?: string | string[];
+    envFile?: string | string[] | false;
     processes: Record<string, NumuxProcessConfig | NumuxScriptPattern | string>;
 }
 /** Validated config with all shorthand expanded to full objects */

package/package.json

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