numux 2.17.3 → 2.18.0

package/README.md

@@ -286,6 +286,7 @@ Top-level options apply to all processes (process-level settings override):
 | `noWatch` | `boolean` | Disable file watching even if processes have watch patterns |
 | `logDir` | `string` | Directory to write per-process log files |
 | `theme` | `ThemePref` | TUI color theme. `'auto'` detects the terminal background via OSC 11 (falling back to `COLORFGBG` then dark). `'light'`/`'dark'` skip detection. |
+| `autowrap` | `boolean` | Whether to leave the host terminal's autowrap (DECAWM) enabled. Set `false` to have numux disable host autowrap (`\x1b[?7l`) on startup, restoring it on exit. This works around an OpenTUI renderer bug where a run that fills the last screen column wraps right-pane output into the tab sidebar ([anomalyco/opentui#1187](https://github.com/anomalyco/opentui/issues/1187)). Pane content still wraps within its own grid — only the host emit-cursor wrap is turned off. Leave enabled (the default) unless you hit the smear. |
 <!-- /generated:config-global -->
 
 ```ts

package/dist/man/numux.1

@@ -1,4 +1,4 @@
-.TH "NUMUX" "1" "June 2026" "2.17.3" "numux manual"
+.TH "NUMUX" "1" "June 2026" "2.18.0" "numux manual"
 .SH "NAME"
 \fBnumux\fR
 .P
@@ -552,6 +552,18 @@ T}|T{
 T}|T{
 TUI color theme\. \fB'auto'\fP detects the terminal background via OSC 11 (falling back to \fBCOLORFGBG\fP then dark)\. \fB'light'\fP/\fB'dark'\fP skip detection\.
 T}
+_
+T{
+\fBautowrap\fP
+T}|T{
+\fBboolean\fP
+T}|T{
+Whether to leave the host terminal's autowrap (DECAWM) enabled\. Set \fBfalse\fP to have numux disable host autowrap (\fB\\x1b[?7l\fP) on startup, restoring it on exit\. This works around an OpenTUI renderer bug where a run that fills the last screen column wraps right\-pane output into the tab sidebar (
+.UR https://github.com/anomalyco/opentui/issues/1187
+.I anomalyco/opentui#1187
+.UE
+)\. Pane content still wraps within its own grid — only the host emit\-cursor wrap is turned off\. Leave enabled (the default) unless you hit the smear\.
+T}
 .TE
 <!\-\- /generated:config\-global \-\->
 

package/dist/numux.js

@@ -292,6 +292,7 @@ numux logs api | tail -f           # Follow process log output
 | \`noWatch\` | \`boolean\` | Disable file watching even if processes have watch patterns |
 | \`logDir\` | \`string\` | Directory to write per-process log files |
 | \`theme\` | \`ThemePref\` | TUI color theme. \`'auto'\` detects the terminal background via OSC 11 (falling back to \`COLORFGBG\` then dark). \`'light'\`/\`'dark'\` skip detection. |
+| \`autowrap\` | \`boolean\` | Whether to leave the host terminal's autowrap (DECAWM) enabled. Set \`false\` to have numux disable host autowrap (\`\\x1b[?7l\`) on startup, restoring it on exit. This works around an OpenTUI renderer bug where a run that fills the last screen column wraps right-pane output into the tab sidebar ([anomalyco/opentui#1187](https://github.com/anomalyco/opentui/issues/1187)). Pane content still wraps within its own grid \u2014 only the host emit-cursor wrap is turned off. Leave enabled (the default) unless you hit the smear. |
 <!-- /generated:config-global -->
 
 \`\`\`ts
@@ -885,7 +886,7 @@ var init_help = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "2.17.3",
+    version: "2.18.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -2133,6 +2134,7 @@ function validateConfig(raw, _warnings) {
   const noWatch = config.noWatch === true ? true : undefined;
   const logDir = typeof config.logDir === "string" && config.logDir.trim() ? config.logDir.trim() : undefined;
   const theme = validateTheme(config.theme);
+  const autowrap = config.autowrap === false ? false : undefined;
   const validated = {};
   for (const name of names) {
     let proc = processes[name];
@@ -2232,6 +2234,7 @@ function validateConfig(raw, _warnings) {
     ...noWatch ? { noWatch } : {},
     ...logDir ? { logDir } : {},
     ...theme ? { theme } : {},
+    ...autowrap === false ? { autowrap: false } : {},
     processes: validated
   };
 }
@@ -4997,7 +5000,9 @@ class App {
       useMouse: true,
       useKittyKeyboard: {}
     });
-    this.forceFullRepaints(this.renderer);
+    if (this.config.autowrap === false) {
+      this.disableAutowrap();
+    }
     const { width, height } = this.renderer;
     const maxNameLen = Math.max(...this.names.map((n) => n.length));
     this.sidebarWidth = Math.min(30, Math.max(16, maxNameLen + 5));
@@ -5280,15 +5285,8 @@ class App {
       }
     }
   }
-  forceFullRepaints(renderer) {
-    const r = renderer;
-    if (!("forceFullRepaintRequested" in r)) {
-      log("warning: @opentui/core has no forceFullRepaintRequested flag \u2014 render-drift workaround inactive");
-      return;
-    }
-    renderer.setFrameCallback(async () => {
-      r.forceFullRepaintRequested = true;
-    });
+  disableAutowrap() {
+    process.stdout.write("\x1B[?7l");
   }
   switchPane(name) {
     if (this.activePane === name)
@@ -5390,6 +5388,9 @@ class App {
     for (const pane of this.panes.values()) {
       pane.destroy();
     }
+    if (this.config.autowrap === false) {
+      process.stdout.write("\x1B[?7h");
+    }
     if (!this.renderer.isDestroyed) {
       this.renderer.destroy();
     }

package/dist/types.d.ts

@@ -129,6 +129,18 @@ export interface NumuxConfig<K extends string = string> {
      * @default 'auto'
      */
     theme?: ThemePref;
+    /**
+     * Whether to leave the host terminal's autowrap (DECAWM) enabled.
+     *
+     * Set `false` to have numux disable host autowrap (`\x1b[?7l`) on startup,
+     * restoring it on exit. This works around an OpenTUI renderer bug where a run
+     * that fills the last screen column wraps right-pane output into the tab
+     * sidebar ([anomalyco/opentui#1187](https://github.com/anomalyco/opentui/issues/1187)).
+     * Pane content still wraps within its own grid — only the host emit-cursor
+     * wrap is turned off. Leave enabled (the default) unless you hit the smear.
+     * @default true
+     */
+    autowrap?: boolean;
     processes: Record<K, NumuxProcessConfig<K> | NumuxScriptPattern<K> | string | true>;
 }
 export type SortOrder = 'config' | 'alphabetical' | 'topological' | 'status';
@@ -146,6 +158,7 @@ export interface ResolvedNumuxConfig {
     noWatch?: boolean;
     logDir?: string;
     theme?: ThemePref;
+    autowrap?: boolean;
     processes: Record<string, ResolvedProcessConfig>;
 }
 export type ProcessStatus = 'pending' | 'starting' | 'ready' | 'running' | 'stopping' | 'stopped' | 'finished' | 'failed' | 'skipped';

package/package.json

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