spawn-term 2.0.0 → 2.1.0

package/dist/esm/constants.js

@@ -0,0 +1,11 @@
+// Column width defaults
+export const DEFAULT_COLUMN_WIDTH = 15;
+export const MAX_COLUMN_WIDTH_PERCENT = 0.4; // 40% of terminal width
+export const FALLBACK_COLUMN_WIDTH = 25;
+// Batching defaults
+export const BATCH_MAX_LINES = 20;
+export const BATCH_MAX_WAIT_MS = 50;
+// Rendering
+export const DEFAULT_MAX_FPS = 20;
+// Expansion
+export const EXPANDED_MAX_VISIBLE_LINES = 10;

package/dist/esm/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/constants.ts"],"sourcesContent":["// Column width defaults\nexport const DEFAULT_COLUMN_WIDTH = 15;\nexport const MAX_COLUMN_WIDTH_PERCENT = 0.4; // 40% of terminal width\nexport const FALLBACK_COLUMN_WIDTH = 25;\n\n// Batching defaults\nexport const BATCH_MAX_LINES = 20;\nexport const BATCH_MAX_WAIT_MS = 50;\n\n// Rendering\nexport const DEFAULT_MAX_FPS = 20;\n\n// Expansion\nexport const EXPANDED_MAX_VISIBLE_LINES = 10;\n"],"names":["DEFAULT_COLUMN_WIDTH","MAX_COLUMN_WIDTH_PERCENT","FALLBACK_COLUMN_WIDTH","BATCH_MAX_LINES","BATCH_MAX_WAIT_MS","DEFAULT_MAX_FPS","EXPANDED_MAX_VISIBLE_LINES"],"mappings":"AAAA,wBAAwB;AACxB,OAAO,MAAMA,uBAAuB,GAAG;AACvC,OAAO,MAAMC,2BAA2B,IAAI,CAAC,wBAAwB;AACrE,OAAO,MAAMC,wBAAwB,GAAG;AAExC,oBAAoB;AACpB,OAAO,MAAMC,kBAAkB,GAAG;AAClC,OAAO,MAAMC,oBAAoB,GAAG;AAEpC,YAAY;AACZ,OAAO,MAAMC,kBAAkB,GAAG;AAElC,YAAY;AACZ,OAAO,MAAMC,6BAA6B,GAAG"}

package/dist/esm/createApp.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { render } from 'ink';
 import App from './components/App.js';
+import { DEFAULT_MAX_FPS } from './constants.js';
 import { processStore } from './state/processStore.js';
 export default function createApp() {
     let refCount = 0;
@@ -9,7 +10,11 @@ export default function createApp() {
         retain () {
             if (++refCount > 1) return processStore;
             // Render once - React handles all subsequent updates via useSyncExternalStore
-            inkApp = render(/*#__PURE__*/ _jsx(App, {}));
+            // Enable incremental rendering to only rewrite changed lines (reduces flicker)
+            inkApp = render(/*#__PURE__*/ _jsx(App, {}), {
+                incrementalRendering: true,
+                maxFps: DEFAULT_MAX_FPS
+            });
             return processStore;
         },
         release (callback) {
@@ -18,16 +23,11 @@ export default function createApp() {
                 return;
             }
             if (!inkApp) throw new Error('Expecting inkApp');
-            // Defer signalExit to allow React's reconciliation to complete fully
-            // Using setImmediate ensures we run after I/O callbacks and microtasks,
-            // preventing the Static component from outputting the last item twice
-            // (the second notify() from signalExit can race with Static's useLayoutEffect)
-            setImmediate(()=>{
-                processStore.signalExit(()=>{
-                    processStore.reset();
-                    process.stdout.write('\x1b[?25h'); // show cursor
-                    callback();
-                });
+            // Signal exit to React component
+            processStore.signalExit(()=>{
+                processStore.reset();
+                process.stdout.write('\x1b[?25h'); // show cursor
+                callback();
             });
             // Wait for Ink to finish, then call the callback
             inkApp.waitUntilExit().then(()=>{

package/dist/esm/createApp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/createApp.tsx"],"sourcesContent":["import { render } from 'ink';\nimport App from './components/App.ts';\nimport { type ProcessStore, processStore } from './state/processStore.ts';\n\nexport type ReleaseCallback = () => void;\n\nexport default function createApp() {\n  let refCount = 0;\n  let inkApp: ReturnType<typeof render> | null = null;\n\n  return {\n    retain(): ProcessStore {\n      if (++refCount > 1) return processStore;\n\n      // Render once - React handles all subsequent updates via useSyncExternalStore\n      inkApp = render(<App />);\n      return processStore;\n    },\n\n    release(callback: ReleaseCallback): void {\n      if (--refCount > 0) {\n        callback();\n        return;\n      }\n      if (!inkApp) throw new Error('Expecting inkApp');\n\n      // Defer signalExit to allow React's reconciliation to complete fully\n      // Using setImmediate ensures we run after I/O callbacks and microtasks,\n      // preventing the Static component from outputting the last item twice\n      // (the second notify() from signalExit can race with Static's useLayoutEffect)\n      setImmediate(() => {\n        processStore.signalExit(() => {\n          processStore.reset();\n          process.stdout.write('\\x1b[?25h'); // show cursor\n          callback();\n        });\n      });\n\n      // Wait for Ink to finish, then call the callback\n      inkApp\n        .waitUntilExit()\n        .then(() => {\n          const cb = processStore.getExitCallback();\n          cb?.();\n        })\n        .catch(() => {\n          const cb = processStore.getExitCallback();\n          cb?.();\n        });\n\n      inkApp = null;\n    },\n  };\n}\n"],"names":["render","App","processStore","createApp","refCount","inkApp","retain","release","callback","Error","setImmediate","signalExit","reset","process","stdout","write","waitUntilExit","then","cb","getExitCallback","catch"],"mappings":";AAAA,SAASA,MAAM,QAAQ,MAAM;AAC7B,OAAOC,SAAS,sBAAsB;AACtC,SAA4BC,YAAY,QAAQ,0BAA0B;AAI1E,eAAe,SAASC;IACtB,IAAIC,WAAW;IACf,IAAIC,SAA2C;IAE/C,OAAO;QACLC;YACE,IAAI,EAAEF,WAAW,GAAG,OAAOF;YAE3B,8EAA8E;YAC9EG,SAASL,qBAAO,KAACC;YACjB,OAAOC;QACT;QAEAK,SAAQC,QAAyB;YAC/B,IAAI,EAAEJ,WAAW,GAAG;gBAClBI;gBACA;YACF;YACA,IAAI,CAACH,QAAQ,MAAM,IAAII,MAAM;YAE7B,qEAAqE;YACrE,wEAAwE;YACxE,sEAAsE;YACtE,+EAA+E;YAC/EC,aAAa;gBACXR,aAAaS,UAAU,CAAC;oBACtBT,aAAaU,KAAK;oBAClBC,QAAQC,MAAM,CAACC,KAAK,CAAC,cAAc,cAAc;oBACjDP;gBACF;YACF;YAEA,iDAAiD;YACjDH,OACGW,aAAa,GACbC,IAAI,CAAC;gBACJ,MAAMC,KAAKhB,aAAaiB,eAAe;gBACvCD,eAAAA,yBAAAA;YACF,GACCE,KAAK,CAAC;gBACL,MAAMF,KAAKhB,aAAaiB,eAAe;gBACvCD,eAAAA,yBAAAA;YACF;YAEFb,SAAS;QACX;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/createApp.tsx"],"sourcesContent":["import { render } from 'ink';\nimport App from './components/App.ts';\nimport { DEFAULT_MAX_FPS } from './constants.ts';\nimport { type ProcessStore, processStore } from './state/processStore.ts';\n\nexport type ReleaseCallback = () => void;\n\nexport default function createApp() {\n  let refCount = 0;\n  let inkApp: ReturnType<typeof render> | null = null;\n\n  return {\n    retain(): ProcessStore {\n      if (++refCount > 1) return processStore;\n\n      // Render once - React handles all subsequent updates via useSyncExternalStore\n      // Enable incremental rendering to only rewrite changed lines (reduces flicker)\n      inkApp = render(<App />, {\n        incrementalRendering: true,\n        maxFps: DEFAULT_MAX_FPS,\n      });\n      return processStore;\n    },\n\n    release(callback: ReleaseCallback): void {\n      if (--refCount > 0) {\n        callback();\n        return;\n      }\n      if (!inkApp) throw new Error('Expecting inkApp');\n\n      // Signal exit to React component\n      processStore.signalExit(() => {\n        processStore.reset();\n        process.stdout.write('\\x1b[?25h'); // show cursor\n        callback();\n      });\n\n      // Wait for Ink to finish, then call the callback\n      inkApp\n        .waitUntilExit()\n        .then(() => {\n          const cb = processStore.getExitCallback();\n          cb?.();\n        })\n        .catch(() => {\n          const cb = processStore.getExitCallback();\n          cb?.();\n        });\n\n      inkApp = null;\n    },\n  };\n}\n"],"names":["render","App","DEFAULT_MAX_FPS","processStore","createApp","refCount","inkApp","retain","incrementalRendering","maxFps","release","callback","Error","signalExit","reset","process","stdout","write","waitUntilExit","then","cb","getExitCallback","catch"],"mappings":";AAAA,SAASA,MAAM,QAAQ,MAAM;AAC7B,OAAOC,SAAS,sBAAsB;AACtC,SAASC,eAAe,QAAQ,iBAAiB;AACjD,SAA4BC,YAAY,QAAQ,0BAA0B;AAI1E,eAAe,SAASC;IACtB,IAAIC,WAAW;IACf,IAAIC,SAA2C;IAE/C,OAAO;QACLC;YACE,IAAI,EAAEF,WAAW,GAAG,OAAOF;YAE3B,8EAA8E;YAC9E,+EAA+E;YAC/EG,SAASN,qBAAO,KAACC,UAAQ;gBACvBO,sBAAsB;gBACtBC,QAAQP;YACV;YACA,OAAOC;QACT;QAEAO,SAAQC,QAAyB;YAC/B,IAAI,EAAEN,WAAW,GAAG;gBAClBM;gBACA;YACF;YACA,IAAI,CAACL,QAAQ,MAAM,IAAIM,MAAM;YAE7B,iCAAiC;YACjCT,aAAaU,UAAU,CAAC;gBACtBV,aAAaW,KAAK;gBAClBC,QAAQC,MAAM,CAACC,KAAK,CAAC,cAAc,cAAc;gBACjDN;YACF;YAEA,iDAAiD;YACjDL,OACGY,aAAa,GACbC,IAAI,CAAC;gBACJ,MAAMC,KAAKjB,aAAakB,eAAe;gBACvCD,eAAAA,yBAAAA;YACF,GACCE,KAAK,CAAC;gBACL,MAAMF,KAAKjB,aAAakB,eAAe;gBACvCD,eAAAA,yBAAAA;YACF;YAEFd,SAAS;QACX;IACF;AACF"}

package/dist/esm/lib/addLines.js

@@ -1,20 +1,47 @@
 import { Writable } from 'stream';
+import { BATCH_MAX_LINES, BATCH_MAX_WAIT_MS } from '../constants.js';
 const REGEX_NEW_LINE = /\r?\n|\r/g;
-export default function addLines(fn) {
+export default function addLines(fn, options = {}) {
+    const { maxLines = BATCH_MAX_LINES, maxWait = BATCH_MAX_WAIT_MS } = options;
     let last = '';
+    let lineBuffer = [];
+    let flushTimer = null;
+    const flush = ()=>{
+        if (flushTimer) {
+            clearTimeout(flushTimer);
+            flushTimer = null;
+        }
+        if (lineBuffer.length > 0) {
+            fn(lineBuffer);
+            lineBuffer = [];
+        }
+    };
+    const scheduleFlush = ()=>{
+        if (!flushTimer) {
+            flushTimer = setTimeout(flush, maxWait);
+        }
+    };
     const stream = new Writable({
         write (chunk, _enc, callback) {
             const more = last + chunk.toString('utf8');
             const lines = more.split(REGEX_NEW_LINE);
             last = lines.pop();
-            if (lines.length > 0) fn(lines);
+            if (lines.length > 0) {
+                lineBuffer.push(...lines);
+                // Flush immediately if buffer is large enough
+                if (lineBuffer.length >= maxLines) {
+                    flush();
+                } else {
+                    scheduleFlush();
+                }
+            }
             callback();
         }
     });
     stream.on('finish', ()=>{
-        if (last.length) fn([
-            last
-        ]);
+        // Flush any remaining buffered lines
+        if (last.length) lineBuffer.push(last);
+        flush();
         last = '';
     });
     return stream;

package/dist/esm/lib/addLines.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/lib/addLines.ts"],"sourcesContent":["import { Writable } from 'stream';\n\nconst REGEX_NEW_LINE = /\\r?\\n|\\r/g;\n\nexport type Callback = (lines: string[]) => undefined;\n\nexport default function addLines(fn: Callback): Writable {\n  let last = '';\n\n  const stream = new Writable({\n    write(chunk, _enc, callback) {\n      const more = last + chunk.toString('utf8');\n      const lines = more.split(REGEX_NEW_LINE);\n      last = lines.pop();\n      if (lines.length > 0) fn(lines);\n      callback();\n    },\n  });\n  stream.on('finish', () => {\n    if (last.length) fn([last]);\n    last = '';\n  });\n  return stream;\n}\n"],"names":["Writable","REGEX_NEW_LINE","addLines","fn","last","stream","write","chunk","_enc","callback","more","toString","lines","split","pop","length","on"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,SAAS;AAElC,MAAMC,iBAAiB;AAIvB,eAAe,SAASC,SAASC,EAAY;IAC3C,IAAIC,OAAO;IAEX,MAAMC,SAAS,IAAIL,SAAS;QAC1BM,OAAMC,KAAK,EAAEC,IAAI,EAAEC,QAAQ;YACzB,MAAMC,OAAON,OAAOG,MAAMI,QAAQ,CAAC;YACnC,MAAMC,QAAQF,KAAKG,KAAK,CAACZ;YACzBG,OAAOQ,MAAME,GAAG;YAChB,IAAIF,MAAMG,MAAM,GAAG,GAAGZ,GAAGS;YACzBH;QACF;IACF;IACAJ,OAAOW,EAAE,CAAC,UAAU;QAClB,IAAIZ,KAAKW,MAAM,EAAEZ,GAAG;YAACC;SAAK;QAC1BA,OAAO;IACT;IACA,OAAOC;AACT"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/lib/addLines.ts"],"sourcesContent":["import { Writable } from 'stream';\nimport { BATCH_MAX_LINES, BATCH_MAX_WAIT_MS } from '../constants.ts';\n\nconst REGEX_NEW_LINE = /\\r?\\n|\\r/g;\n\nexport type Callback = (lines: string[]) => undefined;\n\ninterface BatchOptions {\n  maxLines?: number;\n  maxWait?: number;\n}\n\nexport default function addLines(fn: Callback, options: BatchOptions = {}): Writable {\n  const { maxLines = BATCH_MAX_LINES, maxWait = BATCH_MAX_WAIT_MS } = options;\n\n  let last = '';\n  let lineBuffer: string[] = [];\n  let flushTimer: NodeJS.Timeout | null = null;\n\n  const flush = () => {\n    if (flushTimer) {\n      clearTimeout(flushTimer);\n      flushTimer = null;\n    }\n    if (lineBuffer.length > 0) {\n      fn(lineBuffer);\n      lineBuffer = [];\n    }\n  };\n\n  const scheduleFlush = () => {\n    if (!flushTimer) {\n      flushTimer = setTimeout(flush, maxWait);\n    }\n  };\n\n  const stream = new Writable({\n    write(chunk, _enc, callback) {\n      const more = last + chunk.toString('utf8');\n      const lines = more.split(REGEX_NEW_LINE);\n      last = lines.pop();\n\n      if (lines.length > 0) {\n        lineBuffer.push(...lines);\n\n        // Flush immediately if buffer is large enough\n        if (lineBuffer.length >= maxLines) {\n          flush();\n        } else {\n          scheduleFlush();\n        }\n      }\n      callback();\n    },\n  });\n\n  stream.on('finish', () => {\n    // Flush any remaining buffered lines\n    if (last.length) lineBuffer.push(last);\n    flush();\n    last = '';\n  });\n\n  return stream;\n}\n"],"names":["Writable","BATCH_MAX_LINES","BATCH_MAX_WAIT_MS","REGEX_NEW_LINE","addLines","fn","options","maxLines","maxWait","last","lineBuffer","flushTimer","flush","clearTimeout","length","scheduleFlush","setTimeout","stream","write","chunk","_enc","callback","more","toString","lines","split","pop","push","on"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,SAAS;AAClC,SAASC,eAAe,EAAEC,iBAAiB,QAAQ,kBAAkB;AAErE,MAAMC,iBAAiB;AASvB,eAAe,SAASC,SAASC,EAAY,EAAEC,UAAwB,CAAC,CAAC;IACvE,MAAM,EAAEC,WAAWN,eAAe,EAAEO,UAAUN,iBAAiB,EAAE,GAAGI;IAEpE,IAAIG,OAAO;IACX,IAAIC,aAAuB,EAAE;IAC7B,IAAIC,aAAoC;IAExC,MAAMC,QAAQ;QACZ,IAAID,YAAY;YACdE,aAAaF;YACbA,aAAa;QACf;QACA,IAAID,WAAWI,MAAM,GAAG,GAAG;YACzBT,GAAGK;YACHA,aAAa,EAAE;QACjB;IACF;IAEA,MAAMK,gBAAgB;QACpB,IAAI,CAACJ,YAAY;YACfA,aAAaK,WAAWJ,OAAOJ;QACjC;IACF;IAEA,MAAMS,SAAS,IAAIjB,SAAS;QAC1BkB,OAAMC,KAAK,EAAEC,IAAI,EAAEC,QAAQ;YACzB,MAAMC,OAAOb,OAAOU,MAAMI,QAAQ,CAAC;YACnC,MAAMC,QAAQF,KAAKG,KAAK,CAACtB;YACzBM,OAAOe,MAAME,GAAG;YAEhB,IAAIF,MAAMV,MAAM,GAAG,GAAG;gBACpBJ,WAAWiB,IAAI,IAAIH;gBAEnB,8CAA8C;gBAC9C,IAAId,WAAWI,MAAM,IAAIP,UAAU;oBACjCK;gBACF,OAAO;oBACLG;gBACF;YACF;YACAM;QACF;IACF;IAEAJ,OAAOW,EAAE,CAAC,UAAU;QAClB,qCAAqC;QACrC,IAAInB,KAAKK,MAAM,EAAEJ,WAAWiB,IAAI,CAAClB;QACjCG;QACAH,OAAO;IACT;IAEA,OAAOQ;AACT"}

package/dist/esm/lib/format.js

@@ -0,0 +1,10 @@
+import { FALLBACK_COLUMN_WIDTH, MAX_COLUMN_WIDTH_PERCENT } from '../constants.js';
+export function calculateColumnWidth(groupWidth, terminalWidth, maxGroupLength) {
+    if (typeof groupWidth === 'number') return groupWidth;
+    if (groupWidth === 'max') return Math.min(maxGroupLength, Math.floor(terminalWidth * MAX_COLUMN_WIDTH_PERCENT));
+    if (typeof groupWidth === 'string' && groupWidth.endsWith('%')) {
+        const pct = parseInt(groupWidth, 10) / 100;
+        return Math.floor(terminalWidth * pct);
+    }
+    return FALLBACK_COLUMN_WIDTH;
+}

package/dist/esm/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/lib/format.ts"],"sourcesContent":["import { FALLBACK_COLUMN_WIDTH, MAX_COLUMN_WIDTH_PERCENT } from '../constants.ts';\n\nexport type GroupWidth = number | `${number}%` | 'max';\n\nexport function calculateColumnWidth(groupWidth: GroupWidth, terminalWidth: number, maxGroupLength: number): number {\n  if (typeof groupWidth === 'number') return groupWidth;\n  if (groupWidth === 'max') return Math.min(maxGroupLength, Math.floor(terminalWidth * MAX_COLUMN_WIDTH_PERCENT));\n  if (typeof groupWidth === 'string' && groupWidth.endsWith('%')) {\n    const pct = parseInt(groupWidth, 10) / 100;\n    return Math.floor(terminalWidth * pct);\n  }\n  return FALLBACK_COLUMN_WIDTH;\n}\n"],"names":["FALLBACK_COLUMN_WIDTH","MAX_COLUMN_WIDTH_PERCENT","calculateColumnWidth","groupWidth","terminalWidth","maxGroupLength","Math","min","floor","endsWith","pct","parseInt"],"mappings":"AAAA,SAASA,qBAAqB,EAAEC,wBAAwB,QAAQ,kBAAkB;AAIlF,OAAO,SAASC,qBAAqBC,UAAsB,EAAEC,aAAqB,EAAEC,cAAsB;IACxG,IAAI,OAAOF,eAAe,UAAU,OAAOA;IAC3C,IAAIA,eAAe,OAAO,OAAOG,KAAKC,GAAG,CAACF,gBAAgBC,KAAKE,KAAK,CAACJ,gBAAgBH;IACrF,IAAI,OAAOE,eAAe,YAAYA,WAAWM,QAAQ,CAAC,MAAM;QAC9D,MAAMC,MAAMC,SAASR,YAAY,MAAM;QACvC,OAAOG,KAAKE,KAAK,CAACJ,gBAAgBM;IACpC;IACA,OAAOV;AACT"}

package/dist/esm/src/components/CompactProcessLine.d.ts

@@ -1,6 +1,7 @@
 import type { ChildProcess } from '../types.js';
 type Props = {
     item: ChildProcess;
+    isSelected?: boolean;
 };
 declare const _default: import("react").NamedExoticComponent<Props>;
 export default _default;

package/dist/esm/src/components/ExpandedOutput.d.ts

@@ -0,0 +1,8 @@
+import type { Line } from '../types.js';
+type Props = {
+    lines: Line[];
+    scrollOffset: number;
+    maxVisible?: number;
+};
+declare const _default: import("react").NamedExoticComponent<Props>;
+export default _default;

package/dist/esm/src/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const DEFAULT_COLUMN_WIDTH = 15;
+export declare const MAX_COLUMN_WIDTH_PERCENT = 0.4;
+export declare const FALLBACK_COLUMN_WIDTH = 25;
+export declare const BATCH_MAX_LINES = 20;
+export declare const BATCH_MAX_WAIT_MS = 50;
+export declare const DEFAULT_MAX_FPS = 20;
+export declare const EXPANDED_MAX_VISIBLE_LINES = 10;

package/dist/esm/src/lib/addLines.d.ts

@@ -1,3 +1,8 @@
 import { Writable } from 'stream';
 export type Callback = (lines: string[]) => undefined;
-export default function addLines(fn: Callback): Writable;
+interface BatchOptions {
+    maxLines?: number;
+    maxWait?: number;
+}
+export default function addLines(fn: Callback, options?: BatchOptions): Writable;
+export {};

package/dist/esm/src/lib/format.d.ts

@@ -0,0 +1,2 @@
+export type GroupWidth = number | `${number}%` | 'max';
+export declare function calculateColumnWidth(groupWidth: GroupWidth, terminalWidth: number, maxGroupLength: number): number;

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

@@ -1,6 +1,6 @@
 import type { ChildProcess, Line } from '../types.js';
 type Listener = () => void;
-type Mode = 'normal' | 'errorList' | 'errorDetail';
+type Mode = 'normal' | 'interactive' | 'errorList' | 'errorDetail';
 declare class ProcessStore {
     private processes;
     private completedIds;
@@ -8,26 +8,45 @@ declare class ProcessStore {
     private shouldExit;
     private exitCallback;
     private mode;
+    private selectedIndex;
     private selectedErrorIndex;
+    private expandedId;
+    private scrollOffset;
+    private header;
     subscribe: (listener: Listener) => (() => void);
     getSnapshot: () => ChildProcess[];
     getRunningProcesses: () => ChildProcess[];
     getCompletedProcesses: () => ChildProcess[];
     getFailedProcesses: () => ChildProcess[];
     getRunningCount: () => number;
+    getMaxGroupLength: () => number;
     getDoneCount: () => number;
     getErrorCount: () => number;
     getErrorLineCount: () => number;
     getMode: () => Mode;
+    getSelectedIndex: () => number;
     getSelectedErrorIndex: () => number;
+    getExpandedId: () => string | null;
+    getScrollOffset: () => number;
+    getHeader: () => string | undefined;
+    getShowStatusBar: () => boolean;
+    getIsInteractive: () => boolean;
+    isAllComplete: () => boolean;
     addProcess(process: ChildProcess): void;
     updateProcess(id: string, update: Partial<ChildProcess>): void;
     appendLines(id: string, newLines: Line[]): void;
     getProcess(id: string): ChildProcess | undefined;
     setMode(mode: Mode): void;
+    selectNext(): void;
+    selectPrev(): void;
+    getSelectedProcess(): ChildProcess | undefined;
     selectNextError(): void;
     selectPrevError(): void;
     getSelectedError(): ChildProcess | undefined;
+    toggleExpand(): void;
+    collapse(): void;
+    scrollDown(maxVisible: number): void;
+    scrollUp(): void;
     signalExit(callback: () => void): void;
     getShouldExit: () => boolean;
     getExitCallback: () => (() => void) | null;

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

@@ -3,6 +3,9 @@ import type { SpawnError, SpawnResult } from 'cross-spawn-cb';
 export type TerminalOptions = {
     group?: string;
     expanded?: boolean;
+    header?: string;
+    showStatusBar?: boolean;
+    interactive?: boolean;
 };
 export type TerminalCallback = (error?: SpawnError, result?: SpawnResult) => undefined;
 export declare const LineType: {
@@ -21,4 +24,7 @@ export type ChildProcess = {
     state: State;
     lines: Line[];
     expanded?: boolean;
+    header?: string;
+    showStatusBar?: boolean;
+    interactive?: boolean;
 };

package/dist/esm/state/processStore.js

@@ -26,10 +26,15 @@ function _object_spread(target) {
     }
     return target;
 }
+import { DEFAULT_COLUMN_WIDTH } from '../constants.js';
 import { LineType } from '../types.js';
 class ProcessStore {
     // Mutations - Ink handles render throttling at 30 FPS
     addProcess(process) {
+        // Set header on first process that provides one
+        if (this.header === undefined && process.header !== undefined) {
+            this.header = process.header;
+        }
         this.processes = [
             ...this.processes,
             process
@@ -64,11 +69,29 @@ class ProcessStore {
     // UI state mutations
     setMode(mode) {
         this.mode = mode;
-        if (mode === 'errorList') {
+        if (mode === 'interactive') {
+            this.selectedIndex = 0;
+        } else if (mode === 'errorList') {
             this.selectedErrorIndex = 0;
         }
         this.notify();
     }
+    // Interactive mode navigation
+    selectNext() {
+        if (this.processes.length > 0) {
+            this.selectedIndex = (this.selectedIndex + 1) % this.processes.length;
+            this.notify();
+        }
+    }
+    selectPrev() {
+        if (this.processes.length > 0) {
+            this.selectedIndex = (this.selectedIndex - 1 + this.processes.length) % this.processes.length;
+            this.notify();
+        }
+    }
+    getSelectedProcess() {
+        return this.processes[this.selectedIndex];
+    }
     selectNextError() {
         const failed = this.getFailedProcesses();
         if (failed.length > 0) {
@@ -87,6 +110,43 @@ class ProcessStore {
         const failed = this.getFailedProcesses();
         return failed[this.selectedErrorIndex];
     }
+    // Expansion methods
+    toggleExpand() {
+        const selected = this.getSelectedProcess();
+        if (!selected) return;
+        if (this.expandedId === selected.id) {
+            // Collapse
+            this.expandedId = null;
+            this.scrollOffset = 0;
+        } else {
+            // Expand
+            this.expandedId = selected.id;
+            this.scrollOffset = 0;
+        }
+        this.notify();
+    }
+    collapse() {
+        this.expandedId = null;
+        this.scrollOffset = 0;
+        this.notify();
+    }
+    scrollDown(maxVisible) {
+        if (!this.expandedId) return;
+        const process = this.getProcess(this.expandedId);
+        if (!process) return;
+        const maxOffset = Math.max(0, process.lines.length - maxVisible);
+        if (this.scrollOffset < maxOffset) {
+            this.scrollOffset++;
+            this.notify();
+        }
+    }
+    scrollUp() {
+        if (!this.expandedId) return;
+        if (this.scrollOffset > 0) {
+            this.scrollOffset--;
+            this.notify();
+        }
+    }
     // Exit signaling
     signalExit(callback) {
         this.shouldExit = true;
@@ -99,7 +159,11 @@ class ProcessStore {
         this.shouldExit = false;
         this.exitCallback = null;
         this.mode = 'normal';
+        this.selectedIndex = 0;
         this.selectedErrorIndex = 0;
+        this.expandedId = null;
+        this.scrollOffset = 0;
+        this.header = undefined;
     }
     notify() {
         this.listeners.forEach((l)=>{
@@ -114,7 +178,10 @@ class ProcessStore {
         this.exitCallback = null;
         // UI state
         this.mode = 'normal';
+        this.selectedIndex = 0;
         this.selectedErrorIndex = 0;
+        this.expandedId = null;
+        this.scrollOffset = 0;
         // useSyncExternalStore API
         this.subscribe = (listener)=>{
             this.listeners.add(listener);
@@ -134,6 +201,10 @@ class ProcessStore {
         };
         // Counts
         this.getRunningCount = ()=>this.processes.filter((p)=>p.state === 'running').length;
+        this.getMaxGroupLength = ()=>{
+            if (this.processes.length === 0) return DEFAULT_COLUMN_WIDTH;
+            return Math.max(...this.processes.map((p)=>(p.group || p.title).length));
+        };
         this.getDoneCount = ()=>this.processes.filter((p)=>p.state !== 'running').length;
         this.getErrorCount = ()=>this.processes.filter((p)=>p.state === 'error').length;
         this.getErrorLineCount = ()=>{
@@ -141,7 +212,17 @@ class ProcessStore {
         };
         // UI state getters
         this.getMode = ()=>this.mode;
+        this.getSelectedIndex = ()=>this.selectedIndex;
         this.getSelectedErrorIndex = ()=>this.selectedErrorIndex;
+        this.getExpandedId = ()=>this.expandedId;
+        this.getScrollOffset = ()=>this.scrollOffset;
+        // Get header
+        this.getHeader = ()=>this.header;
+        // Show status bar only if any process sets showStatusBar: true (default: false)
+        this.getShowStatusBar = ()=>this.processes.some((p)=>p.showStatusBar === true);
+        // Interactive mode if any process has interactive: true
+        this.getIsInteractive = ()=>this.processes.some((p)=>p.interactive === true);
+        this.isAllComplete = ()=>this.processes.length > 0 && this.processes.every((p)=>p.state !== 'running');
         this.getShouldExit = ()=>this.shouldExit;
         this.getExitCallback = ()=>this.exitCallback;
     }

package/dist/esm/state/processStore.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/state/processStore.ts"],"sourcesContent":["import type { ChildProcess, Line } from '../types.ts';\nimport { LineType } from '../types.ts';\n\ntype Listener = () => void;\ntype Mode = 'normal' | 'errorList' | 'errorDetail';\n\nclass ProcessStore {\n  private processes: ChildProcess[] = [];\n  private completedIds: string[] = []; // Track completion order\n  private listeners = new Set<Listener>();\n  private shouldExit = false;\n  private exitCallback: (() => void) | null = null;\n\n  // UI state\n  private mode: Mode = 'normal';\n  private selectedErrorIndex = 0;\n\n  // useSyncExternalStore API\n  subscribe = (listener: Listener): (() => void) => {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  };\n\n  getSnapshot = (): ChildProcess[] => this.processes;\n\n  // Filtered getters\n  getRunningProcesses = (): ChildProcess[] => {\n    return this.processes.filter((p) => p.state === 'running');\n  };\n\n  getCompletedProcesses = (): ChildProcess[] => {\n    // Return in completion order\n    return this.completedIds.map((id) => this.processes.find((p) => p.id === id)).filter((p): p is ChildProcess => p !== undefined);\n  };\n\n  getFailedProcesses = (): ChildProcess[] => {\n    return this.processes.filter((p) => p.state === 'error');\n  };\n\n  // Counts\n  getRunningCount = (): number => this.processes.filter((p) => p.state === 'running').length;\n  getDoneCount = (): number => this.processes.filter((p) => p.state !== 'running').length;\n  getErrorCount = (): number => this.processes.filter((p) => p.state === 'error').length;\n  getErrorLineCount = (): number => {\n    return this.processes.filter((p) => p.state === 'error').reduce((total, p) => total + p.lines.filter((l) => l.type === LineType.stderr).length, 0);\n  };\n\n  // UI state getters\n  getMode = (): Mode => this.mode;\n  getSelectedErrorIndex = (): number => this.selectedErrorIndex;\n\n  // Mutations - Ink handles render throttling at 30 FPS\n  addProcess(process: ChildProcess): void {\n    this.processes = [...this.processes, process];\n    this.notify();\n  }\n\n  updateProcess(id: string, update: Partial<ChildProcess>): void {\n    const oldProcess = this.processes.find((p) => p.id === id);\n    const wasRunning = oldProcess?.state === 'running';\n    const isNowComplete = update.state && update.state !== 'running';\n\n    this.processes = this.processes.map((p) => (p.id === id ? { ...p, ...update } : p));\n\n    // Track completion order\n    if (wasRunning && isNowComplete && !this.completedIds.includes(id)) {\n      this.completedIds = [...this.completedIds, id];\n    }\n\n    this.notify();\n  }\n\n  appendLines(id: string, newLines: Line[]): void {\n    const process = this.processes.find((p) => p.id === id);\n    if (process) {\n      this.updateProcess(id, { lines: process.lines.concat(newLines) });\n    }\n  }\n\n  getProcess(id: string): ChildProcess | undefined {\n    return this.processes.find((p) => p.id === id);\n  }\n\n  // UI state mutations\n  setMode(mode: Mode): void {\n    this.mode = mode;\n    if (mode === 'errorList') {\n      this.selectedErrorIndex = 0;\n    }\n    this.notify();\n  }\n\n  selectNextError(): void {\n    const failed = this.getFailedProcesses();\n    if (failed.length > 0) {\n      this.selectedErrorIndex = (this.selectedErrorIndex + 1) % failed.length;\n      this.notify();\n    }\n  }\n\n  selectPrevError(): void {\n    const failed = this.getFailedProcesses();\n    if (failed.length > 0) {\n      this.selectedErrorIndex = (this.selectedErrorIndex - 1 + failed.length) % failed.length;\n      this.notify();\n    }\n  }\n\n  getSelectedError(): ChildProcess | undefined {\n    const failed = this.getFailedProcesses();\n    return failed[this.selectedErrorIndex];\n  }\n\n  // Exit signaling\n  signalExit(callback: () => void): void {\n    this.shouldExit = true;\n    this.exitCallback = callback;\n    this.notify();\n  }\n\n  getShouldExit = (): boolean => this.shouldExit;\n  getExitCallback = (): (() => void) | null => this.exitCallback;\n\n  reset(): void {\n    this.processes = [];\n    this.completedIds = [];\n    this.shouldExit = false;\n    this.exitCallback = null;\n    this.mode = 'normal';\n    this.selectedErrorIndex = 0;\n  }\n\n  private notify(): void {\n    this.listeners.forEach((l) => {\n      l();\n    });\n  }\n}\n\nexport const processStore = new ProcessStore();\nexport type { ProcessStore };\n"],"names":["LineType","ProcessStore","addProcess","process","processes","notify","updateProcess","id","update","oldProcess","find","p","wasRunning","state","isNowComplete","map","completedIds","includes","appendLines","newLines","lines","concat","getProcess","setMode","mode","selectedErrorIndex","selectNextError","failed","getFailedProcesses","length","selectPrevError","getSelectedError","signalExit","callback","shouldExit","exitCallback","reset","listeners","forEach","l","Set","subscribe","listener","add","delete","getSnapshot","getRunningProcesses","filter","getCompletedProcesses","undefined","getRunningCount","getDoneCount","getErrorCount","getErrorLineCount","reduce","total","type","stderr","getMode","getSelectedErrorIndex","getShouldExit","getExitCallback","processStore"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAASA,QAAQ,QAAQ,cAAc;AAKvC,MAAMC;IA6CJ,sDAAsD;IACtDC,WAAWC,OAAqB,EAAQ;QACtC,IAAI,CAACC,SAAS,GAAG;eAAI,IAAI,CAACA,SAAS;YAAED;SAAQ;QAC7C,IAAI,CAACE,MAAM;IACb;IAEAC,cAAcC,EAAU,EAAEC,MAA6B,EAAQ;QAC7D,MAAMC,aAAa,IAAI,CAACL,SAAS,CAACM,IAAI,CAAC,CAACC,IAAMA,EAAEJ,EAAE,KAAKA;QACvD,MAAMK,aAAaH,CAAAA,uBAAAA,iCAAAA,WAAYI,KAAK,MAAK;QACzC,MAAMC,gBAAgBN,OAAOK,KAAK,IAAIL,OAAOK,KAAK,KAAK;QAEvD,IAAI,CAACT,SAAS,GAAG,IAAI,CAACA,SAAS,CAACW,GAAG,CAAC,CAACJ,IAAOA,EAAEJ,EAAE,KAAKA,KAAK,mBAAKI,GAAMH,UAAWG;QAEhF,yBAAyB;QACzB,IAAIC,cAAcE,iBAAiB,CAAC,IAAI,CAACE,YAAY,CAACC,QAAQ,CAACV,KAAK;YAClE,IAAI,CAACS,YAAY,GAAG;mBAAI,IAAI,CAACA,YAAY;gBAAET;aAAG;QAChD;QAEA,IAAI,CAACF,MAAM;IACb;IAEAa,YAAYX,EAAU,EAAEY,QAAgB,EAAQ;QAC9C,MAAMhB,UAAU,IAAI,CAACC,SAAS,CAACM,IAAI,CAAC,CAACC,IAAMA,EAAEJ,EAAE,KAAKA;QACpD,IAAIJ,SAAS;YACX,IAAI,CAACG,aAAa,CAACC,IAAI;gBAAEa,OAAOjB,QAAQiB,KAAK,CAACC,MAAM,CAACF;YAAU;QACjE;IACF;IAEAG,WAAWf,EAAU,EAA4B;QAC/C,OAAO,IAAI,CAACH,SAAS,CAACM,IAAI,CAAC,CAACC,IAAMA,EAAEJ,EAAE,KAAKA;IAC7C;IAEA,qBAAqB;IACrBgB,QAAQC,IAAU,EAAQ;QACxB,IAAI,CAACA,IAAI,GAAGA;QACZ,IAAIA,SAAS,aAAa;YACxB,IAAI,CAACC,kBAAkB,GAAG;QAC5B;QACA,IAAI,CAACpB,MAAM;IACb;IAEAqB,kBAAwB;QACtB,MAAMC,SAAS,IAAI,CAACC,kBAAkB;QACtC,IAAID,OAAOE,MAAM,GAAG,GAAG;YACrB,IAAI,CAACJ,kBAAkB,GAAG,AAAC,CAAA,IAAI,CAACA,kBAAkB,GAAG,CAAA,IAAKE,OAAOE,MAAM;YACvE,IAAI,CAACxB,MAAM;QACb;IACF;IAEAyB,kBAAwB;QACtB,MAAMH,SAAS,IAAI,CAACC,kBAAkB;QACtC,IAAID,OAAOE,MAAM,GAAG,GAAG;YACrB,IAAI,CAACJ,kBAAkB,GAAG,AAAC,CAAA,IAAI,CAACA,kBAAkB,GAAG,IAAIE,OAAOE,MAAM,AAAD,IAAKF,OAAOE,MAAM;YACvF,IAAI,CAACxB,MAAM;QACb;IACF;IAEA0B,mBAA6C;QAC3C,MAAMJ,SAAS,IAAI,CAACC,kBAAkB;QACtC,OAAOD,MAAM,CAAC,IAAI,CAACF,kBAAkB,CAAC;IACxC;IAEA,iBAAiB;IACjBO,WAAWC,QAAoB,EAAQ;QACrC,IAAI,CAACC,UAAU,GAAG;QAClB,IAAI,CAACC,YAAY,GAAGF;QACpB,IAAI,CAAC5B,MAAM;IACb;IAKA+B,QAAc;QACZ,IAAI,CAAChC,SAAS,GAAG,EAAE;QACnB,IAAI,CAACY,YAAY,GAAG,EAAE;QACtB,IAAI,CAACkB,UAAU,GAAG;QAClB,IAAI,CAACC,YAAY,GAAG;QACpB,IAAI,CAACX,IAAI,GAAG;QACZ,IAAI,CAACC,kBAAkB,GAAG;IAC5B;IAEQpB,SAAe;QACrB,IAAI,CAACgC,SAAS,CAACC,OAAO,CAAC,CAACC;YACtBA;QACF;IACF;;aAjIQnC,YAA4B,EAAE;aAC9BY,eAAyB,EAAE,EAAE,yBAAyB;aACtDqB,YAAY,IAAIG;aAChBN,aAAa;aACbC,eAAoC;QAE5C,WAAW;aACHX,OAAa;aACbC,qBAAqB;QAE7B,2BAA2B;aAC3BgB,YAAY,CAACC;YACX,IAAI,CAACL,SAAS,CAACM,GAAG,CAACD;YACnB,OAAO,IAAM,IAAI,CAACL,SAAS,CAACO,MAAM,CAACF;QACrC;aAEAG,cAAc,IAAsB,IAAI,CAACzC,SAAS;QAElD,mBAAmB;aACnB0C,sBAAsB;YACpB,OAAO,IAAI,CAAC1C,SAAS,CAAC2C,MAAM,CAAC,CAACpC,IAAMA,EAAEE,KAAK,KAAK;QAClD;aAEAmC,wBAAwB;YACtB,6BAA6B;YAC7B,OAAO,IAAI,CAAChC,YAAY,CAACD,GAAG,CAAC,CAACR,KAAO,IAAI,CAACH,SAAS,CAACM,IAAI,CAAC,CAACC,IAAMA,EAAEJ,EAAE,KAAKA,KAAKwC,MAAM,CAAC,CAACpC,IAAyBA,MAAMsC;QACvH;aAEArB,qBAAqB;YACnB,OAAO,IAAI,CAACxB,SAAS,CAAC2C,MAAM,CAAC,CAACpC,IAAMA,EAAEE,KAAK,KAAK;QAClD;QAEA,SAAS;aACTqC,kBAAkB,IAAc,IAAI,CAAC9C,SAAS,CAAC2C,MAAM,CAAC,CAACpC,IAAMA,EAAEE,KAAK,KAAK,WAAWgB,MAAM;aAC1FsB,eAAe,IAAc,IAAI,CAAC/C,SAAS,CAAC2C,MAAM,CAAC,CAACpC,IAAMA,EAAEE,KAAK,KAAK,WAAWgB,MAAM;aACvFuB,gBAAgB,IAAc,IAAI,CAAChD,SAAS,CAAC2C,MAAM,CAAC,CAACpC,IAAMA,EAAEE,KAAK,KAAK,SAASgB,MAAM;aACtFwB,oBAAoB;YAClB,OAAO,IAAI,CAACjD,SAAS,CAAC2C,MAAM,CAAC,CAACpC,IAAMA,EAAEE,KAAK,KAAK,SAASyC,MAAM,CAAC,CAACC,OAAO5C,IAAM4C,QAAQ5C,EAAES,KAAK,CAAC2B,MAAM,CAAC,CAACR,IAAMA,EAAEiB,IAAI,KAAKxD,SAASyD,MAAM,EAAE5B,MAAM,EAAE;QAClJ;QAEA,mBAAmB;aACnB6B,UAAU,IAAY,IAAI,CAAClC,IAAI;aAC/BmC,wBAAwB,IAAc,IAAI,CAAClC,kBAAkB;aAuE7DmC,gBAAgB,IAAe,IAAI,CAAC1B,UAAU;aAC9C2B,kBAAkB,IAA2B,IAAI,CAAC1B,YAAY;;AAgBhE;AAEA,OAAO,MAAM2B,eAAe,IAAI7D,eAAe"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/state/processStore.ts"],"sourcesContent":["import { DEFAULT_COLUMN_WIDTH } from '../constants.ts';\nimport type { ChildProcess, Line } from '../types.ts';\nimport { LineType } from '../types.ts';\n\ntype Listener = () => void;\ntype Mode = 'normal' | 'interactive' | 'errorList' | 'errorDetail';\n\nclass ProcessStore {\n  private processes: ChildProcess[] = [];\n  private completedIds: string[] = []; // Track completion order\n  private listeners = new Set<Listener>();\n  private shouldExit = false;\n  private exitCallback: (() => void) | null = null;\n\n  // UI state\n  private mode: Mode = 'normal';\n  private selectedIndex = 0;\n  private selectedErrorIndex = 0;\n  private expandedId: string | null = null;\n  private scrollOffset = 0;\n\n  // App-level display settings\n  private header: string | undefined;\n\n  // useSyncExternalStore API\n  subscribe = (listener: Listener): (() => void) => {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  };\n\n  getSnapshot = (): ChildProcess[] => this.processes;\n\n  // Filtered getters\n  getRunningProcesses = (): ChildProcess[] => {\n    return this.processes.filter((p) => p.state === 'running');\n  };\n\n  getCompletedProcesses = (): ChildProcess[] => {\n    // Return in completion order\n    return this.completedIds.map((id) => this.processes.find((p) => p.id === id)).filter((p): p is ChildProcess => p !== undefined);\n  };\n\n  getFailedProcesses = (): ChildProcess[] => {\n    return this.processes.filter((p) => p.state === 'error');\n  };\n\n  // Counts\n  getRunningCount = (): number => this.processes.filter((p) => p.state === 'running').length;\n  getMaxGroupLength = (): number => {\n    if (this.processes.length === 0) return DEFAULT_COLUMN_WIDTH;\n    return Math.max(...this.processes.map((p) => (p.group || p.title).length));\n  };\n  getDoneCount = (): number => this.processes.filter((p) => p.state !== 'running').length;\n  getErrorCount = (): number => this.processes.filter((p) => p.state === 'error').length;\n  getErrorLineCount = (): number => {\n    return this.processes.filter((p) => p.state === 'error').reduce((total, p) => total + p.lines.filter((l) => l.type === LineType.stderr).length, 0);\n  };\n\n  // UI state getters\n  getMode = (): Mode => this.mode;\n  getSelectedIndex = (): number => this.selectedIndex;\n  getSelectedErrorIndex = (): number => this.selectedErrorIndex;\n  getExpandedId = (): string | null => this.expandedId;\n  getScrollOffset = (): number => this.scrollOffset;\n  // Get header\n  getHeader = (): string | undefined => this.header;\n  // Show status bar only if any process sets showStatusBar: true (default: false)\n  getShowStatusBar = (): boolean => this.processes.some((p) => p.showStatusBar === true);\n  // Interactive mode if any process has interactive: true\n  getIsInteractive = (): boolean => this.processes.some((p) => p.interactive === true);\n  isAllComplete = (): boolean => this.processes.length > 0 && this.processes.every((p) => p.state !== 'running');\n\n  // Mutations - Ink handles render throttling at 30 FPS\n  addProcess(process: ChildProcess): void {\n    // Set header on first process that provides one\n    if (this.header === undefined && process.header !== undefined) {\n      this.header = process.header;\n    }\n    this.processes = [...this.processes, process];\n    this.notify();\n  }\n\n  updateProcess(id: string, update: Partial<ChildProcess>): void {\n    const oldProcess = this.processes.find((p) => p.id === id);\n    const wasRunning = oldProcess?.state === 'running';\n    const isNowComplete = update.state && update.state !== 'running';\n\n    this.processes = this.processes.map((p) => (p.id === id ? { ...p, ...update } : p));\n\n    // Track completion order\n    if (wasRunning && isNowComplete && !this.completedIds.includes(id)) {\n      this.completedIds = [...this.completedIds, id];\n    }\n\n    this.notify();\n  }\n\n  appendLines(id: string, newLines: Line[]): void {\n    const process = this.processes.find((p) => p.id === id);\n    if (process) {\n      this.updateProcess(id, { lines: process.lines.concat(newLines) });\n    }\n  }\n\n  getProcess(id: string): ChildProcess | undefined {\n    return this.processes.find((p) => p.id === id);\n  }\n\n  // UI state mutations\n  setMode(mode: Mode): void {\n    this.mode = mode;\n    if (mode === 'interactive') {\n      this.selectedIndex = 0;\n    } else if (mode === 'errorList') {\n      this.selectedErrorIndex = 0;\n    }\n    this.notify();\n  }\n\n  // Interactive mode navigation\n  selectNext(): void {\n    if (this.processes.length > 0) {\n      this.selectedIndex = (this.selectedIndex + 1) % this.processes.length;\n      this.notify();\n    }\n  }\n\n  selectPrev(): void {\n    if (this.processes.length > 0) {\n      this.selectedIndex = (this.selectedIndex - 1 + this.processes.length) % this.processes.length;\n      this.notify();\n    }\n  }\n\n  getSelectedProcess(): ChildProcess | undefined {\n    return this.processes[this.selectedIndex];\n  }\n\n  selectNextError(): void {\n    const failed = this.getFailedProcesses();\n    if (failed.length > 0) {\n      this.selectedErrorIndex = (this.selectedErrorIndex + 1) % failed.length;\n      this.notify();\n    }\n  }\n\n  selectPrevError(): void {\n    const failed = this.getFailedProcesses();\n    if (failed.length > 0) {\n      this.selectedErrorIndex = (this.selectedErrorIndex - 1 + failed.length) % failed.length;\n      this.notify();\n    }\n  }\n\n  getSelectedError(): ChildProcess | undefined {\n    const failed = this.getFailedProcesses();\n    return failed[this.selectedErrorIndex];\n  }\n\n  // Expansion methods\n  toggleExpand(): void {\n    const selected = this.getSelectedProcess();\n    if (!selected) return;\n\n    if (this.expandedId === selected.id) {\n      // Collapse\n      this.expandedId = null;\n      this.scrollOffset = 0;\n    } else {\n      // Expand\n      this.expandedId = selected.id;\n      this.scrollOffset = 0;\n    }\n    this.notify();\n  }\n\n  collapse(): void {\n    this.expandedId = null;\n    this.scrollOffset = 0;\n    this.notify();\n  }\n\n  scrollDown(maxVisible: number): void {\n    if (!this.expandedId) return;\n    const process = this.getProcess(this.expandedId);\n    if (!process) return;\n\n    const maxOffset = Math.max(0, process.lines.length - maxVisible);\n    if (this.scrollOffset < maxOffset) {\n      this.scrollOffset++;\n      this.notify();\n    }\n  }\n\n  scrollUp(): void {\n    if (!this.expandedId) return;\n    if (this.scrollOffset > 0) {\n      this.scrollOffset--;\n      this.notify();\n    }\n  }\n\n  // Exit signaling\n  signalExit(callback: () => void): void {\n    this.shouldExit = true;\n    this.exitCallback = callback;\n    this.notify();\n  }\n\n  getShouldExit = (): boolean => this.shouldExit;\n  getExitCallback = (): (() => void) | null => this.exitCallback;\n\n  reset(): void {\n    this.processes = [];\n    this.completedIds = [];\n    this.shouldExit = false;\n    this.exitCallback = null;\n    this.mode = 'normal';\n    this.selectedIndex = 0;\n    this.selectedErrorIndex = 0;\n    this.expandedId = null;\n    this.scrollOffset = 0;\n    this.header = undefined;\n  }\n\n  private notify(): void {\n    this.listeners.forEach((l) => {\n      l();\n    });\n  }\n}\n\nexport const processStore = new ProcessStore();\nexport type { ProcessStore };\n"],"names":["DEFAULT_COLUMN_WIDTH","LineType","ProcessStore","addProcess","process","header","undefined","processes","notify","updateProcess","id","update","oldProcess","find","p","wasRunning","state","isNowComplete","map","completedIds","includes","appendLines","newLines","lines","concat","getProcess","setMode","mode","selectedIndex","selectedErrorIndex","selectNext","length","selectPrev","getSelectedProcess","selectNextError","failed","getFailedProcesses","selectPrevError","getSelectedError","toggleExpand","selected","expandedId","scrollOffset","collapse","scrollDown","maxVisible","maxOffset","Math","max","scrollUp","signalExit","callback","shouldExit","exitCallback","reset","listeners","forEach","l","Set","subscribe","listener","add","delete","getSnapshot","getRunningProcesses","filter","getCompletedProcesses","getRunningCount","getMaxGroupLength","group","title","getDoneCount","getErrorCount","getErrorLineCount","reduce","total","type","stderr","getMode","getSelectedIndex","getSelectedErrorIndex","getExpandedId","getScrollOffset","getHeader","getShowStatusBar","some","showStatusBar","getIsInteractive","interactive","isAllComplete","every","getShouldExit","getExitCallback","processStore"],"mappings":"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"}

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/types.ts"],"sourcesContent":["export type { SpawnCallback, SpawnError, SpawnOptions, SpawnResult } from 'cross-spawn-cb';\n\nimport type { SpawnError, SpawnResult } from 'cross-spawn-cb';\n\nexport type TerminalOptions = {\n  group?: string;\n  expanded?: boolean;\n};\n\nexport type TerminalCallback = (error?: SpawnError, result?: SpawnResult) => undefined;\n\nexport const LineType = {\n  stdout: 1,\n  stderr: 2,\n} as const;\n\nexport type Line = {\n  type: (typeof LineType)[keyof typeof LineType];\n  text: string;\n};\n\nexport type State = 'running' | 'error' | 'success';\nexport type ChildProcess = {\n  id: string;\n  group?: string;\n  title: string;\n  state: State;\n  lines: Line[];\n  expanded?: boolean;\n};\n"],"names":["LineType","stdout","stderr"],"mappings":"AAWA,OAAO,MAAMA,WAAW;IACtBC,QAAQ;IACRC,QAAQ;AACV,EAAW"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/types.ts"],"sourcesContent":["export type { SpawnCallback, SpawnError, SpawnOptions, SpawnResult } from 'cross-spawn-cb';\n\nimport type { SpawnError, SpawnResult } from 'cross-spawn-cb';\n\nexport type TerminalOptions = {\n  group?: string;\n  expanded?: boolean;\n  header?: string;\n  showStatusBar?: boolean;\n  interactive?: boolean;\n};\n\nexport type TerminalCallback = (error?: SpawnError, result?: SpawnResult) => undefined;\n\nexport const LineType = {\n  stdout: 1,\n  stderr: 2,\n} as const;\n\nexport type Line = {\n  type: (typeof LineType)[keyof typeof LineType];\n  text: string;\n};\n\nexport type State = 'running' | 'error' | 'success';\nexport type ChildProcess = {\n  id: string;\n  group?: string;\n  title: string;\n  state: State;\n  lines: Line[];\n  expanded?: boolean;\n  header?: string;\n  showStatusBar?: boolean;\n  interactive?: boolean;\n};\n"],"names":["LineType","stdout","stderr"],"mappings":"AAcA,OAAO,MAAMA,WAAW;IACtBC,QAAQ;IACRC,QAAQ;AACV,EAAW"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spawn-term",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Formats spawn with for terminal grouping",
   "keywords": [
     "spawn",