spawn-term 3.0.4 → 3.0.6

package/dist/cjs/lib/TerminalBuffer.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "TerminalBuffer", {
+    enumerable: true,
+    get: function() {
+        return TerminalBuffer;
+    }
+});
+var _headless = /*#__PURE__*/ _interop_require_wildcard(require("@xterm/headless"));
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _defineProperties(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    if (staticProps) _defineProperties(Constructor, staticProps);
+    return Constructor;
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+var _xterm_default;
+// Handle both ESM and CJS module formats
+var Terminal = _headless.Terminal || ((_xterm_default = _headless.default) === null || _xterm_default === void 0 ? void 0 : _xterm_default.Terminal);
+var TerminalBuffer = /*#__PURE__*/ function() {
+    "use strict";
+    function TerminalBuffer(cols) {
+        var scrollback = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 10000;
+        _class_call_check(this, TerminalBuffer);
+        this.terminal = new Terminal({
+            cols: cols,
+            rows: 50,
+            scrollback: scrollback,
+            allowProposedApi: true
+        });
+    }
+    var _proto = TerminalBuffer.prototype;
+    /**
+   * Write raw data to the terminal buffer.
+   * The terminal interprets all ANSI sequences automatically.
+   */ _proto.write = function write(data) {
+        var str = typeof data === 'string' ? data : data.toString('utf8');
+        this.terminal.write(str);
+    };
+    /**
+   * Resize the terminal width.
+   */ _proto.resize = function resize(cols) {
+        this.terminal.resize(cols, this.terminal.rows);
+    };
+    /**
+   * Extract the rendered lines from the terminal buffer.
+   * This returns the actual visible content after all ANSI sequences
+   * have been processed.
+   */ _proto.getLines = function getLines() {
+        var buffer = this.terminal.buffer.active;
+        var lines = [];
+        for(var i = 0; i < buffer.length; i++){
+            var line = buffer.getLine(i);
+            if (line) {
+                // translateToString(trimRight) - trim trailing whitespace
+                // Also trim leading whitespace - tools like ncu/npm use cursor positioning
+                // which creates lines with leading spaces when interpreted by xterm
+                lines.push(line.translateToString(true).trimStart());
+            }
+        }
+        // Trim trailing empty lines
+        while(lines.length > 0 && lines[lines.length - 1] === ''){
+            lines.pop();
+        }
+        return lines;
+    };
+    /**
+   * Clean up terminal resources.
+   */ _proto.dispose = function dispose() {
+        this.terminal.dispose();
+    };
+    _create_class(TerminalBuffer, [
+        {
+            key: "lineCount",
+            get: /**
+   * Get the number of rendered lines.
+   */ function get() {
+                return this.getLines().length;
+            }
+        }
+    ]);
+    return TerminalBuffer;
+}();
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/lib/TerminalBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/lib/TerminalBuffer.ts"],"sourcesContent":["import * as xterm from '@xterm/headless';\n\n// Handle both ESM and CJS module formats\nconst Terminal = (xterm as { Terminal: typeof xterm.Terminal; default?: { Terminal: typeof xterm.Terminal } }).Terminal || (xterm as { default?: { Terminal: typeof xterm.Terminal } }).default?.Terminal;\n\n/**\n * Wrapper around @xterm/headless Terminal that provides a virtual terminal buffer.\n * Interprets ANSI escape sequences (cursor movement, line clearing, etc.) to produce\n * the actual rendered output rather than raw intermediate states.\n */\nexport class TerminalBuffer {\n  private terminal: InstanceType<typeof Terminal>;\n\n  constructor(cols: number, scrollback = 10000) {\n    this.terminal = new Terminal({\n      cols,\n      rows: 50, // Visible rows (doesn't matter much for headless)\n      scrollback,\n      allowProposedApi: true,\n    });\n  }\n\n  /**\n   * Write raw data to the terminal buffer.\n   * The terminal interprets all ANSI sequences automatically.\n   */\n  write(data: string | Buffer): void {\n    const str = typeof data === 'string' ? data : data.toString('utf8');\n    this.terminal.write(str);\n  }\n\n  /**\n   * Resize the terminal width.\n   */\n  resize(cols: number): void {\n    this.terminal.resize(cols, this.terminal.rows);\n  }\n\n  /**\n   * Extract the rendered lines from the terminal buffer.\n   * This returns the actual visible content after all ANSI sequences\n   * have been processed.\n   */\n  getLines(): string[] {\n    const buffer = this.terminal.buffer.active;\n    const lines: string[] = [];\n\n    for (let i = 0; i < buffer.length; i++) {\n      const line = buffer.getLine(i);\n      if (line) {\n        // translateToString(trimRight) - trim trailing whitespace\n        // Also trim leading whitespace - tools like ncu/npm use cursor positioning\n        // which creates lines with leading spaces when interpreted by xterm\n        lines.push(line.translateToString(true).trimStart());\n      }\n    }\n\n    // Trim trailing empty lines\n    while (lines.length > 0 && lines[lines.length - 1] === '') {\n      lines.pop();\n    }\n\n    return lines;\n  }\n\n  /**\n   * Get the number of rendered lines.\n   */\n  get lineCount(): number {\n    return this.getLines().length;\n  }\n\n  /**\n   * Clean up terminal resources.\n   */\n  dispose(): void {\n    this.terminal.dispose();\n  }\n}\n"],"names":["TerminalBuffer","Terminal","xterm","default","cols","scrollback","terminal","rows","allowProposedApi","write","data","str","toString","resize","getLines","buffer","active","lines","i","length","line","getLine","push","translateToString","trimStart","pop","dispose","lineCount"],"mappings":";;;;+BAUaA;;;eAAAA;;;gEAVU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGoG;AAD3H,yCAAyC;AACzC,IAAMC,WAAW,AAACC,UAA6FD,QAAQ,MAAI,iBAAA,AAACC,UAA4DC,OAAO,cAApE,qCAAA,eAAsEF,QAAQ;AAOlM,IAAA,AAAMD,+BAAN;;aAAMA,eAGCI,IAAY;YAAEC,aAAAA,iEAAa;gCAH5BL;QAIT,IAAI,CAACM,QAAQ,GAAG,IAAIL,SAAS;YAC3BG,MAAAA;YACAG,MAAM;YACNF,YAAAA;YACAG,kBAAkB;QACpB;;iBATSR;IAYX;;;GAGC,GACDS,OAAAA,KAGC,GAHDA,SAAAA,MAAMC,IAAqB;QACzB,IAAMC,MAAM,OAAOD,SAAS,WAAWA,OAAOA,KAAKE,QAAQ,CAAC;QAC5D,IAAI,CAACN,QAAQ,CAACG,KAAK,CAACE;IACtB;IAEA;;GAEC,GACDE,OAAAA,MAEC,GAFDA,SAAAA,OAAOT,IAAY;QACjB,IAAI,CAACE,QAAQ,CAACO,MAAM,CAACT,MAAM,IAAI,CAACE,QAAQ,CAACC,IAAI;IAC/C;IAEA;;;;GAIC,GACDO,OAAAA,QAoBC,GApBDA,SAAAA;QACE,IAAMC,SAAS,IAAI,CAACT,QAAQ,CAACS,MAAM,CAACC,MAAM;QAC1C,IAAMC,QAAkB,EAAE;QAE1B,IAAK,IAAIC,IAAI,GAAGA,IAAIH,OAAOI,MAAM,EAAED,IAAK;YACtC,IAAME,OAAOL,OAAOM,OAAO,CAACH;YAC5B,IAAIE,MAAM;gBACR,0DAA0D;gBAC1D,2EAA2E;gBAC3E,oEAAoE;gBACpEH,MAAMK,IAAI,CAACF,KAAKG,iBAAiB,CAAC,MAAMC,SAAS;YACnD;QACF;QAEA,4BAA4B;QAC5B,MAAOP,MAAME,MAAM,GAAG,KAAKF,KAAK,CAACA,MAAME,MAAM,GAAG,EAAE,KAAK,GAAI;YACzDF,MAAMQ,GAAG;QACX;QAEA,OAAOR;IACT;IASA;;GAEC,GACDS,OAAAA,OAEC,GAFDA,SAAAA;QACE,IAAI,CAACpB,QAAQ,CAACoB,OAAO;IACvB;kBAnEW1B;;YA0DP2B,KAAAA;iBAAJ,AAHA;;GAEC,GACD;gBACE,OAAO,IAAI,CAACb,QAAQ,GAAGK,MAAM;YAC/B;;;WA5DWnB"}

package/dist/cjs/session.js

@@ -16,16 +16,28 @@ var _onone = /*#__PURE__*/ _interop_require_default(require("on-one"));
 var _queuecb = /*#__PURE__*/ _interop_require_default(require("queue-cb"));
 var _Appts = /*#__PURE__*/ _interop_require_default(require("./components/App.js"));
 var _constantsts = require("./constants.js");
-var _addLinests = /*#__PURE__*/ _interop_require_default(require("./lib/addLines.js"));
 var _concatWritablets = /*#__PURE__*/ _interop_require_default(require("./lib/concatWritable.js"));
 var _formatArgumentsts = /*#__PURE__*/ _interop_require_default(require("./lib/formatArguments.js"));
+var _TerminalBufferts = require("./lib/TerminalBuffer.js");
 var _processStorets = require("./state/processStore.js");
-var _typests = require("./types.js");
 function _class_call_check(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
@@ -72,6 +84,45 @@ function _interop_require_wildcard(obj, nodeInterop) {
     }
     return newObj;
 }
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
 function _object_without_properties(source, excluded) {
     if (source == null) return {};
     var target = _object_without_properties_loose(source, excluded);
@@ -111,13 +162,21 @@ var SessionImpl = /*#__PURE__*/ function() {
         this.store = new _processStorets.ProcessStore(options);
         var _options_interactive;
         this.isInteractive = (_options_interactive = options.interactive) !== null && _options_interactive !== void 0 ? _options_interactive : false;
-        // Render Ink app immediately
-        this.inkApp = (0, _ink.render)(/*#__PURE__*/ (0, _jsxruntime.jsx)(_Appts.default, {
-            store: this.store
-        }), {
-            incrementalRendering: true,
-            maxFps: _constantsts.DEFAULT_MAX_FPS
-        });
+        // Use a very wide buffer to prevent line wrapping in xterm
+        // Actual display truncation is handled by Ink components
+        this.terminalWidth = 10000;
+        // Only render Ink when stdout is a real terminal
+        // When piped (e.g., nested spawn-term), skip Ink to avoid cursor positioning artifacts
+        if (process.stdout.isTTY) {
+            // Note: incrementalRendering disabled to prevent corruption when content shifts vertically
+            // (e.g., error footer appearing, processes completing, scroll position changes)
+            this.inkApp = (0, _ink.render)(/*#__PURE__*/ (0, _jsxruntime.jsx)(_Appts.default, {
+                store: this.store
+            }), {
+                incrementalRendering: false,
+                maxFps: _constantsts.DEFAULT_MAX_FPS
+            });
+        }
     }
     var _proto = SessionImpl.prototype;
     _proto.spawn = function spawn(command, args, spawnOptions, options, callback) {
@@ -130,8 +189,28 @@ var SessionImpl = /*#__PURE__*/ function() {
             "stdio"
         ]);
         if (stdio === 'inherit') {
+            // When Ink is not rendering (stdout not a TTY), pass output directly to stdout
+            if (!this.inkApp) {
+                var cp = (0, _crossspawncb.crossSpawn)(command, args, _object_spread_props(_object_spread({}, csOptions), {
+                    stdio: 'inherit'
+                }));
+                _crossspawncb.default.worker(cp, csOptions, function(err) {
+                    var res = err ? err : {};
+                    res.stdout = null;
+                    res.stderr = null;
+                    res.output = [
+                        null,
+                        null,
+                        null
+                    ];
+                    err ? callback(err) : callback(null, res);
+                });
+                return;
+            }
             this.runningCount++;
             var id = _crypto.default.randomUUID();
+            // Create terminal buffer for ANSI sequence interpretation
+            var terminalBuffer = new _TerminalBufferts.TerminalBuffer(this.terminalWidth);
             this.store.addProcess({
                 id: id,
                 title: [
@@ -139,55 +218,49 @@ var SessionImpl = /*#__PURE__*/ function() {
                 ].concat((0, _formatArgumentsts.default)(args)).join(' '),
                 state: 'running',
                 lines: [],
+                terminalBuffer: terminalBuffer,
                 group: options.group,
                 expanded: options.expanded
             });
-            var cp = (0, _crossspawncb.crossSpawn)(command, args, csOptions);
-            var outputs = {
-                stdout: null,
-                stderr: null
-            };
-            var queue = new _queuecb.default();
-            if (cp.stdout) {
-                outputs.stdout = (0, _addLinests.default)(function(lines) {
-                    _this.store.appendLines(id, lines.map(function(text) {
-                        return {
-                            type: _typests.LineType.stdout,
-                            text: text
-                        };
-                    }));
+            var cp1 = (0, _crossspawncb.crossSpawn)(command, args, csOptions);
+            // Pipe stdout and stderr directly to terminal buffer
+            // Both streams go to the same buffer to maintain correct ordering
+            if (cp1.stdout) {
+                cp1.stdout.on('data', function(chunk) {
+                    terminalBuffer.write(chunk);
+                    _this.store.notify();
                 });
-                queue.defer(_onone.default.bind(null, cp.stdout.pipe(outputs.stdout), [
+            }
+            if (cp1.stderr) {
+                cp1.stderr.on('data', function(chunk) {
+                    terminalBuffer.write(chunk);
+                    _this.store.notify();
+                });
+            }
+            // Wait for process to complete
+            var queue = new _queuecb.default();
+            if (cp1.stdout) {
+                queue.defer(_onone.default.bind(null, cp1.stdout, [
                     'error',
                     'end',
-                    'close',
-                    'finish'
+                    'close'
                 ]));
             }
-            if (cp.stderr) {
-                outputs.stderr = (0, _addLinests.default)(function(lines) {
-                    _this.store.appendLines(id, lines.map(function(text) {
-                        return {
-                            type: _typests.LineType.stderr,
-                            text: text
-                        };
-                    }));
-                });
-                queue.defer(_onone.default.bind(null, cp.stderr.pipe(outputs.stderr), [
+            if (cp1.stderr) {
+                queue.defer(_onone.default.bind(null, cp1.stderr, [
                     'error',
                     'end',
-                    'close',
-                    'finish'
+                    'close'
                 ]));
             }
-            queue.defer(_crossspawncb.default.worker.bind(null, cp, csOptions));
+            queue.defer(_crossspawncb.default.worker.bind(null, cp1, csOptions));
             queue.await(function(err) {
                 var res = err ? err : {};
-                res.stdout = outputs.stdout ? outputs.stdout.output : null;
-                res.stderr = outputs.stderr ? outputs.stderr.output : null;
+                res.stdout = null; // Not collecting raw output in inherit mode
+                res.stderr = null;
                 res.output = [
-                    res.stdout,
-                    res.stderr,
+                    null,
+                    null,
                     null
                 ];
                 _this.store.updateProcess(id, {
@@ -198,39 +271,39 @@ var SessionImpl = /*#__PURE__*/ function() {
             });
         } else {
             // Non-inherit mode: collect output but don't display in UI
-            var cp1 = (0, _crossspawncb.crossSpawn)(command, args, csOptions);
-            var outputs1 = {
+            var cp2 = (0, _crossspawncb.crossSpawn)(command, args, csOptions);
+            var outputs = {
                 stdout: null,
                 stderr: null
             };
             var queue1 = new _queuecb.default();
-            if (cp1.stdout) {
-                outputs1.stdout = (0, _concatWritablets.default)(function(output) {
-                    outputs1.stdout.output = output.toString(encoding || 'utf8');
+            if (cp2.stdout) {
+                outputs.stdout = (0, _concatWritablets.default)(function(output) {
+                    outputs.stdout.output = output.toString(encoding || 'utf8');
                 });
-                queue1.defer(_onone.default.bind(null, cp1.stdout.pipe(outputs1.stdout), [
+                queue1.defer(_onone.default.bind(null, cp2.stdout.pipe(outputs.stdout), [
                     'error',
                     'end',
                     'close',
                     'finish'
                 ]));
             }
-            if (cp1.stderr) {
-                outputs1.stderr = (0, _concatWritablets.default)(function(output) {
-                    outputs1.stderr.output = output.toString(encoding || 'utf8');
+            if (cp2.stderr) {
+                outputs.stderr = (0, _concatWritablets.default)(function(output) {
+                    outputs.stderr.output = output.toString(encoding || 'utf8');
                 });
-                queue1.defer(_onone.default.bind(null, cp1.stderr.pipe(outputs1.stderr), [
+                queue1.defer(_onone.default.bind(null, cp2.stderr.pipe(outputs.stderr), [
                     'error',
                     'end',
                     'close',
                     'finish'
                 ]));
             }
-            queue1.defer(_crossspawncb.default.worker.bind(null, cp1, csOptions));
+            queue1.defer(_crossspawncb.default.worker.bind(null, cp2, csOptions));
             queue1.await(function(err) {
                 var res = err ? err : {};
-                res.stdout = outputs1.stdout ? outputs1.stdout.output : null;
-                res.stderr = outputs1.stderr ? outputs1.stderr.output : null;
+                res.stdout = outputs.stdout ? outputs.stdout.output : null;
+                res.stderr = outputs.stderr ? outputs.stderr.output : null;
                 res.output = [
                     res.stdout,
                     res.stderr,

package/dist/cjs/session.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/session.tsx"],"sourcesContent":["import spawn, { crossSpawn, type SpawnResult } from 'cross-spawn-cb';\nimport crypto from 'crypto';\nimport { render } from 'ink';\nimport oo from 'on-one';\nimport Queue from 'queue-cb';\n\nimport App from './components/App.ts';\nimport { DEFAULT_MAX_FPS } from './constants.ts';\nimport addLines from './lib/addLines.ts';\nimport concatWritable from './lib/concatWritable.ts';\nimport formatArguments from './lib/formatArguments.ts';\nimport { ProcessStore } from './state/processStore.ts';\nimport type { ProcessOptions, SessionOptions, SpawnError, SpawnOptions, TerminalCallback } from './types.ts';\nimport { LineType } from './types.ts';\n\nexport interface Session {\n  spawn(command: string, args: string[], spawnOptions: SpawnOptions, options: ProcessOptions, callback: TerminalCallback): void;\n  close(): void;\n  waitAndClose(callback?: () => void): void;\n}\n\nclass SessionImpl implements Session {\n  private store: ProcessStore;\n  private inkApp: ReturnType<typeof render> | null = null;\n  private runningCount = 0;\n  private closed = false;\n  private waitCallbacks: (() => void)[] = [];\n  private isInteractive: boolean;\n\n  constructor(options: SessionOptions = {}) {\n    this.store = new ProcessStore(options);\n    this.isInteractive = options.interactive ?? false;\n\n    // Render Ink app immediately\n    this.inkApp = render(<App store={this.store} />, {\n      incrementalRendering: true,\n      maxFps: DEFAULT_MAX_FPS,\n    });\n  }\n\n  spawn(command: string, args: string[], spawnOptions: SpawnOptions, options: ProcessOptions, callback: TerminalCallback): void {\n    if (this.closed) {\n      throw new Error('Session is closed');\n    }\n\n    const { encoding, stdio, ...csOptions } = spawnOptions;\n\n    if (stdio === 'inherit') {\n      this.runningCount++;\n      const id = crypto.randomUUID();\n      this.store.addProcess({\n        id,\n        title: [command].concat(formatArguments(args)).join(' '),\n        state: 'running',\n        lines: [],\n        group: options.group,\n        expanded: options.expanded,\n      });\n\n      const cp = crossSpawn(command, args, csOptions);\n      const outputs = { stdout: null as ReturnType<typeof addLines> | null, stderr: null as ReturnType<typeof addLines> | null };\n\n      const queue = new Queue();\n      if (cp.stdout) {\n        outputs.stdout = addLines((lines) => {\n          this.store.appendLines(\n            id,\n            lines.map((text) => ({ type: LineType.stdout, text }))\n          );\n        });\n        queue.defer(oo.bind(null, cp.stdout.pipe(outputs.stdout), ['error', 'end', 'close', 'finish']));\n      }\n      if (cp.stderr) {\n        outputs.stderr = addLines((lines) => {\n          this.store.appendLines(\n            id,\n            lines.map((text) => ({ type: LineType.stderr, text }))\n          );\n        });\n        queue.defer(oo.bind(null, cp.stderr.pipe(outputs.stderr), ['error', 'end', 'close', 'finish']));\n      }\n      queue.defer(spawn.worker.bind(null, cp, csOptions));\n      queue.await((err?: SpawnError) => {\n        const res = (err ? err : {}) as SpawnResult;\n        res.stdout = outputs.stdout ? (outputs.stdout as unknown as { output: string }).output : null;\n        res.stderr = outputs.stderr ? (outputs.stderr as unknown as { output: string }).output : null;\n        res.output = [res.stdout, res.stderr, null];\n        this.store.updateProcess(id, { state: err ? 'error' : 'success' });\n\n        this.onProcessComplete();\n        err ? callback(err) : callback(null, res);\n      });\n    } else {\n      // Non-inherit mode: collect output but don't display in UI\n      const cp = crossSpawn(command, args, csOptions);\n      const outputs = { stdout: null as ReturnType<typeof concatWritable> | null, stderr: null as ReturnType<typeof concatWritable> | null };\n\n      const queue = new Queue();\n      if (cp.stdout) {\n        outputs.stdout = concatWritable((output) => {\n          (outputs.stdout as unknown as { output: string }).output = output.toString(encoding || 'utf8');\n        });\n        queue.defer(oo.bind(null, cp.stdout.pipe(outputs.stdout), ['error', 'end', 'close', 'finish']));\n      }\n      if (cp.stderr) {\n        outputs.stderr = concatWritable((output) => {\n          (outputs.stderr as unknown as { output: string }).output = output.toString(encoding || 'utf8');\n        });\n        queue.defer(oo.bind(null, cp.stderr.pipe(outputs.stderr), ['error', 'end', 'close', 'finish']));\n      }\n      queue.defer(spawn.worker.bind(null, cp, csOptions));\n      queue.await((err?: SpawnError) => {\n        const res = (err ? err : {}) as SpawnResult;\n        res.stdout = outputs.stdout ? (outputs.stdout as unknown as { output: string }).output : null;\n        res.stderr = outputs.stderr ? (outputs.stderr as unknown as { output: string }).output : null;\n        res.output = [res.stdout, res.stderr, null];\n        err ? callback(err) : callback(null, res);\n      });\n    }\n  }\n\n  close(): void {\n    if (this.closed) return;\n    this.closed = true;\n    this.cleanup();\n  }\n\n  waitAndClose(callback?: () => void): void {\n    if (this.closed) {\n      callback?.();\n      return;\n    }\n\n    if (callback) this.waitCallbacks.push(callback);\n\n    if (this.runningCount === 0) {\n      if (this.isInteractive) {\n        // In interactive mode, wait for user to quit (press 'q')\n        const unsubscribe = this.store.subscribe(() => {\n          if (this.store.getShouldExit()) {\n            unsubscribe();\n            this.closeAndCallWaitCallbacks();\n          }\n        });\n      } else {\n        this.closeAndCallWaitCallbacks();\n      }\n    }\n    // If runningCount > 0, will close when it hits 0 in onProcessComplete\n  }\n\n  private onProcessComplete(): void {\n    this.runningCount--;\n    if (this.runningCount === 0 && this.waitCallbacks.length > 0) {\n      if (this.isInteractive) {\n        // In interactive mode, wait for user to quit (press 'q')\n        const unsubscribe = this.store.subscribe(() => {\n          if (this.store.getShouldExit()) {\n            unsubscribe();\n            this.closeAndCallWaitCallbacks();\n          }\n        });\n      } else {\n        this.closeAndCallWaitCallbacks();\n      }\n    }\n  }\n\n  private closeAndCallWaitCallbacks(): void {\n    if (this.closed) return;\n    this.closed = true;\n    this.cleanup(() => {\n      for (const cb of this.waitCallbacks) cb();\n      this.waitCallbacks = [];\n    });\n  }\n\n  private cleanup(onComplete?: () => void): void {\n    // Signal exit to React component\n    this.store.signalExit(() => {\n      this.store.reset();\n      process.stdout.write('\\x1b[?25h'); // show cursor\n    });\n\n    // Wait for Ink to finish\n    if (this.inkApp) {\n      this.inkApp\n        .waitUntilExit()\n        .then(() => {\n          const cb = this.store.getExitCallback();\n          cb?.();\n          onComplete?.();\n        })\n        .catch(() => {\n          const cb = this.store.getExitCallback();\n          cb?.();\n          onComplete?.();\n        });\n      this.inkApp = null;\n    } else {\n      onComplete?.();\n    }\n  }\n}\n\nexport function createSession(options: SessionOptions = {}): Session {\n  return new SessionImpl(options);\n}\n"],"names":["createSession","SessionImpl","options","inkApp","runningCount","closed","waitCallbacks","store","ProcessStore","isInteractive","interactive","render","App","incrementalRendering","maxFps","DEFAULT_MAX_FPS","spawn","command","args","spawnOptions","callback","Error","encoding","stdio","csOptions","id","crypto","randomUUID","addProcess","title","concat","formatArguments","join","state","lines","group","expanded","cp","crossSpawn","outputs","stdout","stderr","queue","Queue","addLines","appendLines","map","text","type","LineType","defer","oo","bind","pipe","worker","await","err","res","output","updateProcess","onProcessComplete","concatWritable","toString","close","cleanup","waitAndClose","push","unsubscribe","subscribe","getShouldExit","closeAndCallWaitCallbacks","length","cb","onComplete","signalExit","reset","process","write","waitUntilExit","then","getExitCallback","catch"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/session.tsx"],"sourcesContent":["import spawn, { crossSpawn, type SpawnResult } from 'cross-spawn-cb';\nimport crypto from 'crypto';\nimport { render } from 'ink';\nimport oo from 'on-one';\nimport Queue from 'queue-cb';\n\nimport App from './components/App.ts';\nimport { DEFAULT_MAX_FPS } from './constants.ts';\nimport concatWritable from './lib/concatWritable.ts';\nimport formatArguments from './lib/formatArguments.ts';\nimport { TerminalBuffer } from './lib/TerminalBuffer.ts';\nimport { ProcessStore } from './state/processStore.ts';\nimport type { ProcessOptions, SessionOptions, SpawnError, SpawnOptions, TerminalCallback } from './types.ts';\n\nexport interface Session {\n  spawn(command: string, args: string[], spawnOptions: SpawnOptions, options: ProcessOptions, callback: TerminalCallback): void;\n  close(): void;\n  waitAndClose(callback?: () => void): void;\n}\n\nclass SessionImpl implements Session {\n  private store: ProcessStore;\n  private inkApp: ReturnType<typeof render> | null = null;\n  private runningCount = 0;\n  private closed = false;\n  private waitCallbacks: (() => void)[] = [];\n  private isInteractive: boolean;\n  private terminalWidth: number;\n\n  constructor(options: SessionOptions = {}) {\n    this.store = new ProcessStore(options);\n    this.isInteractive = options.interactive ?? false;\n    // Use a very wide buffer to prevent line wrapping in xterm\n    // Actual display truncation is handled by Ink components\n    this.terminalWidth = 10000;\n\n    // Only render Ink when stdout is a real terminal\n    // When piped (e.g., nested spawn-term), skip Ink to avoid cursor positioning artifacts\n    if (process.stdout.isTTY) {\n      // Note: incrementalRendering disabled to prevent corruption when content shifts vertically\n      // (e.g., error footer appearing, processes completing, scroll position changes)\n      this.inkApp = render(<App store={this.store} />, {\n        incrementalRendering: false,\n        maxFps: DEFAULT_MAX_FPS,\n      });\n    }\n  }\n\n  spawn(command: string, args: string[], spawnOptions: SpawnOptions, options: ProcessOptions, callback: TerminalCallback): void {\n    if (this.closed) {\n      throw new Error('Session is closed');\n    }\n\n    const { encoding, stdio, ...csOptions } = spawnOptions;\n\n    if (stdio === 'inherit') {\n      // When Ink is not rendering (stdout not a TTY), pass output directly to stdout\n      if (!this.inkApp) {\n        const cp = crossSpawn(command, args, { ...csOptions, stdio: 'inherit' });\n        spawn.worker(cp, csOptions, (err?: SpawnError) => {\n          const res = (err ? err : {}) as SpawnResult;\n          res.stdout = null;\n          res.stderr = null;\n          res.output = [null, null, null];\n          err ? callback(err) : callback(null, res);\n        });\n        return;\n      }\n\n      this.runningCount++;\n      const id = crypto.randomUUID();\n\n      // Create terminal buffer for ANSI sequence interpretation\n      const terminalBuffer = new TerminalBuffer(this.terminalWidth);\n\n      this.store.addProcess({\n        id,\n        title: [command].concat(formatArguments(args)).join(' '),\n        state: 'running',\n        lines: [],\n        terminalBuffer,\n        group: options.group,\n        expanded: options.expanded,\n      });\n\n      const cp = crossSpawn(command, args, csOptions);\n\n      // Pipe stdout and stderr directly to terminal buffer\n      // Both streams go to the same buffer to maintain correct ordering\n      if (cp.stdout) {\n        cp.stdout.on('data', (chunk: Buffer) => {\n          terminalBuffer.write(chunk);\n          this.store.notify();\n        });\n      }\n      if (cp.stderr) {\n        cp.stderr.on('data', (chunk: Buffer) => {\n          terminalBuffer.write(chunk);\n          this.store.notify();\n        });\n      }\n\n      // Wait for process to complete\n      const queue = new Queue();\n      if (cp.stdout) {\n        queue.defer(oo.bind(null, cp.stdout, ['error', 'end', 'close']));\n      }\n      if (cp.stderr) {\n        queue.defer(oo.bind(null, cp.stderr, ['error', 'end', 'close']));\n      }\n      queue.defer(spawn.worker.bind(null, cp, csOptions));\n      queue.await((err?: SpawnError) => {\n        const res = (err ? err : {}) as SpawnResult;\n        res.stdout = null; // Not collecting raw output in inherit mode\n        res.stderr = null;\n        res.output = [null, null, null];\n        this.store.updateProcess(id, { state: err ? 'error' : 'success' });\n\n        this.onProcessComplete();\n        err ? callback(err) : callback(null, res);\n      });\n    } else {\n      // Non-inherit mode: collect output but don't display in UI\n      const cp = crossSpawn(command, args, csOptions);\n      const outputs = { stdout: null as ReturnType<typeof concatWritable> | null, stderr: null as ReturnType<typeof concatWritable> | null };\n\n      const queue = new Queue();\n      if (cp.stdout) {\n        outputs.stdout = concatWritable((output) => {\n          (outputs.stdout as unknown as { output: string }).output = output.toString(encoding || 'utf8');\n        });\n        queue.defer(oo.bind(null, cp.stdout.pipe(outputs.stdout), ['error', 'end', 'close', 'finish']));\n      }\n      if (cp.stderr) {\n        outputs.stderr = concatWritable((output) => {\n          (outputs.stderr as unknown as { output: string }).output = output.toString(encoding || 'utf8');\n        });\n        queue.defer(oo.bind(null, cp.stderr.pipe(outputs.stderr), ['error', 'end', 'close', 'finish']));\n      }\n      queue.defer(spawn.worker.bind(null, cp, csOptions));\n      queue.await((err?: SpawnError) => {\n        const res = (err ? err : {}) as SpawnResult;\n        res.stdout = outputs.stdout ? (outputs.stdout as unknown as { output: string }).output : null;\n        res.stderr = outputs.stderr ? (outputs.stderr as unknown as { output: string }).output : null;\n        res.output = [res.stdout, res.stderr, null];\n        err ? callback(err) : callback(null, res);\n      });\n    }\n  }\n\n  close(): void {\n    if (this.closed) return;\n    this.closed = true;\n    this.cleanup();\n  }\n\n  waitAndClose(callback?: () => void): void {\n    if (this.closed) {\n      callback?.();\n      return;\n    }\n\n    if (callback) this.waitCallbacks.push(callback);\n\n    if (this.runningCount === 0) {\n      if (this.isInteractive) {\n        // In interactive mode, wait for user to quit (press 'q')\n        const unsubscribe = this.store.subscribe(() => {\n          if (this.store.getShouldExit()) {\n            unsubscribe();\n            this.closeAndCallWaitCallbacks();\n          }\n        });\n      } else {\n        this.closeAndCallWaitCallbacks();\n      }\n    }\n    // If runningCount > 0, will close when it hits 0 in onProcessComplete\n  }\n\n  private onProcessComplete(): void {\n    this.runningCount--;\n    if (this.runningCount === 0 && this.waitCallbacks.length > 0) {\n      if (this.isInteractive) {\n        // In interactive mode, wait for user to quit (press 'q')\n        const unsubscribe = this.store.subscribe(() => {\n          if (this.store.getShouldExit()) {\n            unsubscribe();\n            this.closeAndCallWaitCallbacks();\n          }\n        });\n      } else {\n        this.closeAndCallWaitCallbacks();\n      }\n    }\n  }\n\n  private closeAndCallWaitCallbacks(): void {\n    if (this.closed) return;\n    this.closed = true;\n    this.cleanup(() => {\n      for (const cb of this.waitCallbacks) cb();\n      this.waitCallbacks = [];\n    });\n  }\n\n  private cleanup(onComplete?: () => void): void {\n    // Signal exit to React component\n    this.store.signalExit(() => {\n      this.store.reset();\n      process.stdout.write('\\x1b[?25h'); // show cursor\n    });\n\n    // Wait for Ink to finish\n    if (this.inkApp) {\n      this.inkApp\n        .waitUntilExit()\n        .then(() => {\n          const cb = this.store.getExitCallback();\n          cb?.();\n          onComplete?.();\n        })\n        .catch(() => {\n          const cb = this.store.getExitCallback();\n          cb?.();\n          onComplete?.();\n        });\n      this.inkApp = null;\n    } else {\n      onComplete?.();\n    }\n  }\n}\n\nexport function createSession(options: SessionOptions = {}): Session {\n  return new SessionImpl(options);\n}\n"],"names":["createSession","SessionImpl","options","inkApp","runningCount","closed","waitCallbacks","store","ProcessStore","isInteractive","interactive","terminalWidth","process","stdout","isTTY","render","App","incrementalRendering","maxFps","DEFAULT_MAX_FPS","spawn","command","args","spawnOptions","callback","Error","encoding","stdio","csOptions","cp","crossSpawn","worker","err","res","stderr","output","id","crypto","randomUUID","terminalBuffer","TerminalBuffer","addProcess","title","concat","formatArguments","join","state","lines","group","expanded","on","chunk","write","notify","queue","Queue","defer","oo","bind","await","updateProcess","onProcessComplete","outputs","concatWritable","toString","pipe","close","cleanup","waitAndClose","push","unsubscribe","subscribe","getShouldExit","closeAndCallWaitCallbacks","length","cb","onComplete","signalExit","reset","waitUntilExit","then","getExitCallback","catch"],"mappings":"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"}

package/dist/cjs/src/components/ErrorFooter.d.ts

@@ -0,0 +1,11 @@
+import type { Line } from '../types.js';
+type ErrorGroup = {
+    processName: string;
+    lines: Line[];
+};
+type Props = {
+    errors: ErrorGroup[];
+    isExpanded: boolean;
+};
+declare const _default: import("react").NamedExoticComponent<Props>;
+export default _default;

package/dist/cjs/src/index-esm.d.ts

@@ -1,5 +1,6 @@
 export { default as figures } from './lib/figures.js';
 export { default as formatArguments } from './lib/formatArguments.js';
+export { TerminalBuffer } from './lib/TerminalBuffer.js';
 export * from './types.js';
 import type { createSession as createSessionType, Session } from './createSessionWrapper.js';
 export type { Session };

package/dist/cjs/src/lib/TerminalBuffer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Wrapper around @xterm/headless Terminal that provides a virtual terminal buffer.
+ * Interprets ANSI escape sequences (cursor movement, line clearing, etc.) to produce
+ * the actual rendered output rather than raw intermediate states.
+ */
+export declare class TerminalBuffer {
+    private terminal;
+    constructor(cols: number, scrollback?: number);
+    /**
+     * Write raw data to the terminal buffer.
+     * The terminal interprets all ANSI sequences automatically.
+     */
+    write(data: string | Buffer): void;
+    /**
+     * Resize the terminal width.
+     */
+    resize(cols: number): void;
+    /**
+     * Extract the rendered lines from the terminal buffer.
+     * This returns the actual visible content after all ANSI sequences
+     * have been processed.
+     */
+    getLines(): string[];
+    /**
+     * Get the number of rendered lines.
+     */
+    get lineCount(): number;
+    /**
+     * Clean up terminal resources.
+     */
+    dispose(): void;
+}

package/dist/cjs/src/state/processStore.d.ts

@@ -1,6 +1,6 @@
 import type { ChildProcess, Line, SessionOptions } from '../types.js';
 type Listener = () => void;
-type Mode = 'normal' | 'interactive' | 'errorList' | 'errorDetail';
+type Mode = 'normal' | 'interactive';
 export declare class ProcessStore {
     private processes;
     private completedIds;
@@ -9,10 +9,11 @@ export declare class ProcessStore {
     private exitCallback;
     private mode;
     private selectedIndex;
-    private selectedErrorIndex;
     private expandedId;
     private scrollOffset;
     private listScrollOffset;
+    private errorFooterExpanded;
+    private bufferVersion;
     private header;
     private showStatusBar;
     private isInteractive;
@@ -29,10 +30,11 @@ export declare class ProcessStore {
     getErrorLineCount: () => number;
     getMode: () => Mode;
     getSelectedIndex: () => number;
-    getSelectedErrorIndex: () => number;
     getExpandedId: () => string | null;
     getScrollOffset: () => number;
     getListScrollOffset: () => number;
+    getErrorFooterExpanded: () => boolean;
+    getBufferVersion: () => number;
     getHeader: () => string | undefined;
     getShowStatusBar: () => boolean;
     getIsInteractive: () => boolean;
@@ -41,14 +43,19 @@ export declare class ProcessStore {
     updateProcess(id: string, update: Partial<ChildProcess>): void;
     appendLines(id: string, newLines: Line[]): void;
     getProcess(id: string): ChildProcess | undefined;
+    getProcessLines(id: string): Line[];
+    getProcessLineCount(id: string): number;
     setMode(mode: Mode): void;
     selectNext(visibleCount?: number): void;
     selectPrev(visibleCount?: number): void;
     private adjustListScroll;
     getSelectedProcess(): ChildProcess | undefined;
-    selectNextError(): void;
-    selectPrevError(): void;
-    getSelectedError(): ChildProcess | undefined;
+    toggleErrorFooter(): void;
+    expandErrorFooter(): void;
+    getErrorLines(): Array<{
+        processName: string;
+        lines: Line[];
+    }>;
     toggleExpand(): void;
     collapse(): void;
     scrollDown(maxVisible: number): void;
@@ -57,6 +64,6 @@ export declare class ProcessStore {
     getShouldExit: () => boolean;
     getExitCallback: () => (() => void) | null;
     reset(): void;
-    private notify;
+    notify(): void;
 }
 export {};

package/dist/cjs/src/types.d.ts

@@ -19,11 +19,13 @@ export type Line = {
     text: string;
 };
 export type State = 'running' | 'error' | 'success';
+import type { TerminalBuffer } from './lib/TerminalBuffer.js';
 export type ChildProcess = {
     id: string;
     group?: string;
     title: string;
     state: State;
     lines: Line[];
+    terminalBuffer?: TerminalBuffer;
     expanded?: boolean;
 };