@travisennis/acai 0.0.8 → 0.0.10

package/dist/tui/terminal.js

@@ -1,5 +1,10 @@
+import fs from "node:fs";
+import tty from "node:tty";
 /**
  * Real terminal using process.stdin/stdout
+ *
+ * When useTty is true (for piped stdin scenarios), input is read from /dev/tty
+ * instead of process.stdin, allowing interactive input after piped content.
  */
 export class ProcessTerminal {
     wasRaw = false;
@@ -7,19 +12,47 @@ export class ProcessTerminal {
     boundInputListener;
     boundResizeListener;
     stopped = false;
+    inExternalMode = false;
+    resumeCallback;
+    inputStream;
+    ttyFd;
+    useTty;
+    constructor(options = {}) {
+        this.useTty = options.useTty ?? false;
+        this.inputStream = process.stdin;
+    }
+    handleSigCont = () => {
+        if (this.inExternalMode) {
+            this.exitExternalMode();
+        }
+    };
     start(onInput, onResize) {
-        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        if (this.useTty) {
+            try {
+                this.ttyFd = fs.openSync("/dev/tty", "r");
+                this.inputStream = new tty.ReadStream(this.ttyFd);
+            }
+            catch {
+                throw new Error("Cannot open /dev/tty for interactive input");
+            }
+        }
+        else {
+            this.inputStream = process.stdin;
+        }
+        if (!this.inputStream.isTTY || !process.stdout.isTTY) {
             throw new Error("Terminal requires TTY environment");
         }
-        // Save previous state and enable raw mode
-        this.wasRaw = process.stdin.isRaw ?? false;
-        if (process.stdin.setRawMode) {
-            process.stdin.setRawMode(true);
+        this.wasRaw = this.inputStream.isRaw ?? false;
+        if (this.inputStream.setRawMode) {
+            this.inputStream.setRawMode(true);
         }
-        process.stdin.setEncoding("utf8");
-        process.stdin.resume();
+        this.inputStream.setEncoding("utf8");
+        this.inputStream.resume();
         // Enable bracketed paste mode - terminal will wrap pastes in \x1b[200~ ... \x1b[201~
         process.stdout.write("\x1b[?2004h");
+        // Enable mouse tracking (SGR mode) so trackpad scroll sends mouse events
+        // instead of being translated into arrow key sequences
+        process.stdout.write("\x1b[?1000h\x1b[?1006h");
         // Create bound listeners so we can properly remove them later
         this.boundInputListener = (data) => {
             onInput(typeof data === "string" ? data : data.toString("utf8"));
@@ -27,13 +60,66 @@ export class ProcessTerminal {
         this.boundResizeListener = () => {
             onResize();
         };
-        process.stdin.on("data", this.boundInputListener);
-        process.stdout.on("resize", this.boundResizeListener);
+        this.attachListeners();
         this.sigintHandler = () => {
-            // Let the custom editor.onCtrlC handler in NewRepl handle Ctrl+C
+            // Let the custom editor.onCtrlC handler in Repl handle Ctrl+C
             // This prevents a race condition where stop() gets called without the exit message
         };
         process.on("SIGINT", this.sigintHandler);
+        process.on("SIGCONT", this.handleSigCont);
+        process.on("SIGTERM", () => this.stop());
+        process.on("SIGHUP", () => this.stop());
+        this.setupCrashCleanup();
+    }
+    attachListeners() {
+        if (this.boundInputListener) {
+            this.inputStream.on("data", this.boundInputListener);
+        }
+        if (this.boundResizeListener) {
+            process.stdout.on("resize", this.boundResizeListener);
+        }
+    }
+    detachListeners() {
+        if (this.boundInputListener) {
+            this.inputStream.removeListener("data", this.boundInputListener);
+        }
+        if (this.boundResizeListener) {
+            process.stdout.removeListener("resize", this.boundResizeListener);
+        }
+    }
+    setupCrashCleanup() {
+        process.on("exit", () => {
+            process.stdout.write("\x1b[?25h");
+            process.stdout.write("\x1b[?2004l");
+            process.stdout.write("\x1b[?1000l\x1b[?1006l");
+            process.stdout.write("\x1b[0m");
+            if (this.inputStream.setRawMode) {
+                this.inputStream.setRawMode(this.wasRaw);
+            }
+            this.closeTtyFd();
+        });
+        process.on("uncaughtException", (error) => {
+            process.stdout.write("\x1b[?25h");
+            process.stdout.write("\x1b[?2004l");
+            process.stdout.write("\x1b[?1000l\x1b[?1006l");
+            process.stdout.write("\x1b[0m");
+            if (this.inputStream.setRawMode) {
+                this.inputStream.setRawMode(this.wasRaw);
+            }
+            this.closeTtyFd();
+            throw error;
+        });
+    }
+    closeTtyFd() {
+        if (this.ttyFd !== undefined) {
+            try {
+                fs.closeSync(this.ttyFd);
+            }
+            catch {
+                // Ignore close errors
+            }
+            this.ttyFd = undefined;
+        }
     }
     stop() {
         if (this.stopped)
@@ -43,22 +129,24 @@ export class ProcessTerminal {
             process.off("SIGINT", this.sigintHandler);
             this.sigintHandler = undefined;
         }
-        // Disable bracketed paste mode
+        // Disable bracketed paste mode and mouse tracking
         process.stdout.write("\x1b[?2004l");
+        process.stdout.write("\x1b[?1000l\x1b[?1006l");
         // Remove event handlers using the exact references that were added
         if (this.boundInputListener) {
-            process.stdin.removeListener("data", this.boundInputListener);
+            this.inputStream.removeListener("data", this.boundInputListener);
             this.boundInputListener = undefined;
         }
         if (this.boundResizeListener) {
             process.stdout.removeListener("resize", this.boundResizeListener);
             this.boundResizeListener = undefined;
         }
-        process.stdin.pause();
+        this.inputStream.pause();
         // Restore raw mode state
-        if (process.stdin.setRawMode) {
-            process.stdin.setRawMode(this.wasRaw);
+        if (this.inputStream.setRawMode) {
+            this.inputStream.setRawMode(this.wasRaw);
         }
+        this.closeTtyFd();
     }
     write(data) {
         process.stdout.write(data);
@@ -95,4 +183,45 @@ export class ProcessTerminal {
     clearScreen() {
         process.stdout.write("\x1b[2J\x1b[H"); // Clear screen and move to home (1,1)
     }
+    enterExternalMode() {
+        if (this.inExternalMode || this.stopped)
+            return;
+        this.inExternalMode = true;
+        this.detachListeners();
+        this.inputStream.pause();
+        if (this.inputStream.setRawMode) {
+            this.inputStream.setRawMode(false);
+        }
+        process.stdout.write("\x1b[0m");
+        process.stdout.write("\x1b[?25h");
+        process.stdout.write("\x1b[?2004l");
+        process.stdout.write("\x1b[?1000l\x1b[?1006l");
+    }
+    exitExternalMode() {
+        if (!this.inExternalMode || this.stopped)
+            return;
+        this.inExternalMode = false;
+        if (this.inputStream.setRawMode) {
+            this.inputStream.setRawMode(true);
+        }
+        this.inputStream.setEncoding("utf8");
+        this.inputStream.resume();
+        process.stdout.write("\x1b[?2004h");
+        process.stdout.write("\x1b[?1000h\x1b[?1006h");
+        process.stdout.write("\x1b[?25l");
+        this.attachListeners();
+        if (this.resumeCallback) {
+            this.resumeCallback();
+        }
+    }
+    background() {
+        this.enterExternalMode();
+        process.kill(process.pid, "SIGSTOP");
+    }
+    isInExternalMode() {
+        return this.inExternalMode;
+    }
+    onResume(callback) {
+        this.resumeCallback = callback;
+    }
 }

package/dist/tui/tui.d.ts

@@ -24,6 +24,11 @@ export interface Component {
      * and col is 0-indexed column position
      */
     getCursorPosition?(): [number, number] | null;
+    /**
+     * Optional method to indicate the component wants to handle Tab/Shift+Tab
+     * navigation keys itself, preventing the TUI from intercepting them.
+     */
+    wantsNavigationKeys?(): boolean;
 }
 export { visibleWidth };
 /**
@@ -38,6 +43,14 @@ export declare class Container implements Component {
 }
 /**
  * TUI - Main class for managing terminal UI with differential rendering
+ *
+ * The TUI splits its children into two regions:
+ * - Scrollable content: children added before setFixedFooterStart()
+ * - Fixed footer: children added after setFixedFooterStart()
+ *
+ * The scrollable content region supports virtual scrolling via trackpad/mouse
+ * wheel. The fixed footer (editor, footer bar, notifications) is always
+ * pinned to the bottom of the terminal.
  */
 export declare class TUI extends Container {
     private terminal;
@@ -46,13 +59,43 @@ export declare class TUI extends Container {
     private isRendering;
     private renderAgain;
     private activeModal;
+    private scrollOffset;
+    private lastScrollableHeight;
+    private fixedFooterIndex;
+    private isUserScrolledUp;
     onCtrlC?: () => void;
+    onCtrlD?: () => void;
+    onReconstructSession?: () => void;
+    onCtrlN?: () => void;
+    onCtrlO?: () => void;
+    /** Callback invoked when Ctrl+M is pressed - opens model selector. */
+    onCtrlM?: () => void;
+    onCtrlR?: () => void;
+    onShiftTab?: () => void;
     constructor(terminal: Terminal);
+    /**
+     * Mark the boundary between scrollable content and fixed footer.
+     * All children added after this call will be rendered as fixed
+     * footer content pinned to the bottom of the terminal.
+     */
+    setFixedFooterStart(): void;
     setFocus(component: Component | null): void;
+    /**
+     * Get the underlying terminal instance for external mode operations.
+     * Used primarily for spawning external editors.
+     */
+    getTerminal(): Terminal;
     start(): void;
     stop(): void;
     requestRender(): void;
+    private inBracketedPaste;
+    private focusedComponentWantsNavigation;
     private handleInput;
+    private handleMouseEvent;
+    scrollToBottom(): void;
+    private getFixedFooterHeight;
+    private renderScrollableContent;
+    private renderFixedFooter;
     private doRender;
     /**
      * Show a modal dialog

package/dist/tui/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../source/tui/tui.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC/C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;GAEG;AACH,qBAAa,SAAU,YAAW,SAAS;IACzC,QAAQ,EAAE,SAAS,EAAE,CAAM;IAE3B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIpC,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAOvC,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAGhC;AAED;;GAEG;AAGH,qBAAa,GAAI,SAAQ,SAAS;IAChC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAsB;IAElC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;gBAEhB,QAAQ,EAAE,QAAQ;IAK9B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAI3C,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI;IAKZ,aAAa,IAAI,IAAI;IAarB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,QAAQ;IA0FhB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK7B;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../source/tui/tui.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAE9C;;;OAGG;IACH,mBAAmB,CAAC,IAAI,OAAO,CAAC;CACjC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;GAEG;AACH,qBAAa,SAAU,YAAW,SAAS;IACzC,QAAQ,EAAE,SAAS,EAAE,CAAM;IAE3B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIpC,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAOvC,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAGhC;AAED;;;;;;;;;;GAUG;AAGH,qBAAa,GAAI,SAAQ,SAAS;IAChC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,gBAAgB,CAAS;IAE1B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,sEAAsE;IAC/D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;gBAEnB,QAAQ,EAAE,QAAQ;IAK9B;;;;OAIG;IACH,mBAAmB,IAAI,IAAI;IAI3B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAI3C;;;OAGG;IACH,WAAW,IAAI,QAAQ;IAIvB,KAAK,IAAI,IAAI;IAUb,IAAI,IAAI,IAAI;IAKZ,aAAa,IAAI,IAAI;IAarB,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,+BAA+B;IAIvC,OAAO,CAAC,WAAW;IAyFnB,OAAO,CAAC,gBAAgB;IAiCxB,cAAc,IAAI,IAAI;IAWtB,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,QAAQ;IAoFhB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK7B;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB"}

package/dist/tui/tui.js

@@ -1,7 +1,8 @@
 /**
  * Minimal TUI implementation with differential rendering
  */
-import { getTerminalSize, isCtrlC, isEscape } from "../terminal/control.js";
+import { getTerminalSize, isCtrlC, isCtrlD, isCtrlM, isCtrlN, isCtrlO, isCtrlR, isCtrlZ, isEscape, } from "../terminal/control.js";
+import { isShiftTab } from "../terminal/keys.js";
 import style from "../terminal/style.js";
 import { visibleWidth } from "./utils.js";
 export { visibleWidth };
@@ -28,6 +29,14 @@ export class Container {
 }
 /**
  * TUI - Main class for managing terminal UI with differential rendering
+ *
+ * The TUI splits its children into two regions:
+ * - Scrollable content: children added before setFixedFooterStart()
+ * - Fixed footer: children added after setFixedFooterStart()
+ *
+ * The scrollable content region supports virtual scrolling via trackpad/mouse
+ * wheel. The fixed footer (editor, footer bar, notifications) is always
+ * pinned to the bottom of the terminal.
  */
 // biome-ignore lint/style/useNamingConvention: override
 export class TUI extends Container {
@@ -37,16 +46,44 @@ export class TUI extends Container {
     isRendering = false;
     renderAgain = false;
     activeModal = null;
+    scrollOffset = 0;
+    lastScrollableHeight = 0;
+    fixedFooterIndex = -1;
+    isUserScrolledUp = false;
     onCtrlC;
+    onCtrlD;
+    onReconstructSession;
+    onCtrlN;
+    onCtrlO;
+    /** Callback invoked when Ctrl+M is pressed - opens model selector. */
+    onCtrlM;
+    onCtrlR;
+    onShiftTab;
     constructor(terminal) {
         super();
         this.terminal = terminal;
     }
+    /**
+     * Mark the boundary between scrollable content and fixed footer.
+     * All children added after this call will be rendered as fixed
+     * footer content pinned to the bottom of the terminal.
+     */
+    setFixedFooterStart() {
+        this.fixedFooterIndex = this.children.length;
+    }
     setFocus(component) {
         this.focusedComponent = component;
     }
+    /**
+     * Get the underlying terminal instance for external mode operations.
+     * Used primarily for spawning external editors.
+     */
+    getTerminal() {
+        return this.terminal;
+    }
     start() {
         this.terminal.start((data) => this.handleInput(data), () => this.requestRender());
+        this.terminal.onResume(() => this.requestRender());
         this.terminal.hideCursor();
         this.requestRender();
     }
@@ -67,7 +104,29 @@ export class TUI extends Container {
             this.doRender();
         });
     }
+    inBracketedPaste = false;
+    focusedComponentWantsNavigation() {
+        return this.focusedComponent?.wantsNavigationKeys?.() ?? false;
+    }
     handleInput(data) {
+        // Handle mouse tracking events (SGR format: \x1b[<button;x;yM)
+        if (data.startsWith("\x1b[<")) {
+            this.handleMouseEvent(data);
+            return;
+        }
+        if (data.includes("\x1b[200~")) {
+            this.inBracketedPaste = true;
+        }
+        if (data.includes("\x1b[201~")) {
+            this.inBracketedPaste = false;
+        }
+        // Handle Ctrl+Z - background the process (POSIX only)
+        if (isCtrlZ(data) &&
+            !this.inBracketedPaste &&
+            process.platform !== "win32") {
+            this.terminal.background();
+            return;
+        }
         // Handle Ctrl+C globally - exit the application
         if (isCtrlC(data)) {
             console.info("\nCtrl+C pressed - exiting...");
@@ -79,6 +138,36 @@ export class TUI extends Container {
                 process.exit(0);
             }
         }
+        // Handle Ctrl+D - exit only if editor is empty (handled by Repl)
+        if (isCtrlD(data)) {
+            if (this.onCtrlD) {
+                this.onCtrlD();
+            }
+            return;
+        }
+        const keyBindings = [
+            { check: isCtrlO, handler: this.onCtrlO },
+            { check: isCtrlR, handler: this.onCtrlR },
+            { check: isCtrlN, handler: this.onCtrlN },
+            { check: isCtrlM, handler: this.onCtrlM },
+        ];
+        for (const binding of keyBindings) {
+            if (binding.check(data)) {
+                binding.handler?.();
+                return;
+            }
+        }
+        // Handle Shift+Tab - cycle mode only when no modal is active,
+        // the focused component won't handle navigation (e.g., model selector),
+        // and the editor isn't showing autocomplete
+        if (isShiftTab(data) && !this.inBracketedPaste) {
+            if (!this.activeModal && !this.focusedComponentWantsNavigation()) {
+                if (this.onShiftTab) {
+                    this.onShiftTab();
+                }
+                return;
+            }
+        }
         // Handle Escape key to close modal if one is active
         if (isEscape(data) && this.activeModal) {
             this.hideModal();
@@ -91,9 +180,69 @@ export class TUI extends Container {
         }
         else if (this.focusedComponent?.handleInput) {
             this.focusedComponent.handleInput(data);
+            this.scrollToBottom();
+            this.requestRender();
+        }
+    }
+    handleMouseEvent(data) {
+        // SGR mouse format: \x1b[<button;x;yM (press) or \x1b[<button;x;ym (release)
+        // Extract button code between "<" and first ";"
+        const start = data.indexOf("<");
+        const semi = data.indexOf(";", start);
+        if (start === -1 || semi === -1)
+            return;
+        const button = Number.parseInt(data.slice(start + 1, semi), 10);
+        const scrollLines = 3;
+        const { rows } = getTerminalSize();
+        const fixedHeight = this.getFixedFooterHeight(this.terminal.columns);
+        const scrollableViewport = rows - fixedHeight;
+        // Button 64 = scroll up, button 65 = scroll down
+        if (button === 64) {
+            this.scrollOffset = Math.max(0, this.scrollOffset - scrollLines);
+            const maxOffset = Math.max(0, this.lastScrollableHeight - scrollableViewport);
+            this.isUserScrolledUp = this.scrollOffset < maxOffset;
+            this.requestRender();
+        }
+        else if (button === 65) {
+            const maxOffset = Math.max(0, this.lastScrollableHeight - scrollableViewport);
+            this.scrollOffset = Math.min(maxOffset, this.scrollOffset + scrollLines);
+            this.isUserScrolledUp = this.scrollOffset < maxOffset;
             this.requestRender();
         }
     }
+    scrollToBottom() {
+        const { rows } = getTerminalSize();
+        const fixedHeight = this.getFixedFooterHeight(this.terminal.columns);
+        const scrollableViewport = rows - fixedHeight;
+        this.scrollOffset = Math.max(0, this.lastScrollableHeight - scrollableViewport);
+        this.isUserScrolledUp = false;
+    }
+    getFixedFooterHeight(width) {
+        if (this.fixedFooterIndex < 0)
+            return 0;
+        let height = 0;
+        for (let i = this.fixedFooterIndex; i < this.children.length; i++) {
+            height += this.children[i].render(width).length;
+        }
+        return height;
+    }
+    renderScrollableContent(width) {
+        const end = this.fixedFooterIndex >= 0 ? this.fixedFooterIndex : this.children.length;
+        const lines = [];
+        for (let i = 0; i < end; i++) {
+            lines.push(...this.children[i].render(width));
+        }
+        return lines;
+    }
+    renderFixedFooter(width) {
+        if (this.fixedFooterIndex < 0)
+            return [];
+        const lines = [];
+        for (let i = this.fixedFooterIndex; i < this.children.length; i++) {
+            lines.push(...this.children[i].render(width));
+        }
+        return lines;
+    }
     doRender() {
         if (this.isRendering) {
             this.renderAgain = true;
@@ -102,13 +251,32 @@ export class TUI extends Container {
         this.isRendering = true;
         try {
             const width = this.terminal.columns;
-            // Render all components to get new lines
-            const newLines = this.render(width);
+            const { rows } = getTerminalSize();
+            // Render fixed footer and scrollable content separately
+            const fixedLines = this.renderFixedFooter(width);
+            const scrollableLines = this.renderScrollableContent(width);
+            this.lastScrollableHeight = scrollableLines.length;
+            const fixedHeight = fixedLines.length;
+            const scrollableViewport = rows - fixedHeight;
+            // Auto-scroll to bottom when new content arrives,
+            // unless the user has explicitly scrolled up
+            if (!this.isUserScrolledUp) {
+                this.scrollOffset = Math.max(0, scrollableLines.length - scrollableViewport);
+            }
+            // Clamp scroll offset
+            const maxOffset = Math.max(0, scrollableLines.length - scrollableViewport);
+            if (this.scrollOffset > maxOffset) {
+                this.scrollOffset = maxOffset;
+            }
+            // Apply scroll offset to get visible scrollable lines
+            const visibleScrollable = scrollableLines.slice(this.scrollOffset, this.scrollOffset + scrollableViewport);
+            // Combine visible scrollable content with fixed footer
+            const visibleLines = [...visibleScrollable, ...fixedLines];
             // Build output buffer using array join (more efficient than string concat)
             const bufferParts = [
                 "\x1b[?2026h", // Begin synchronized output
                 "\x1b[3J\x1b[2J\x1b[H", // Clear scrollback, screen, and home
-                newLines.join("\r\n"),
+                visibleLines.join("\r\n"),
             ];
             // Render modal on top if active
             if (this.activeModal) {
@@ -139,43 +307,6 @@ export class TUI extends Container {
             }
         }
     }
-    // private positionCursor(
-    //   componentCursorPos: [number, number] | null,
-    // ): void {
-    //   if (!componentCursorPos) {
-    //     // No cursor position from component, hide cursor
-    //     this.terminal.hideCursor();
-    //     return;
-    //   }
-    //   const [cursorRow, cursorCol] = componentCursorPos;
-    //
-    //   // Calculate absolute cursor position in the terminal
-    //   // We need to find which line in newLines corresponds to the component's cursor row
-    //   // and then position the cursor at that line and column
-    //
-    //   // Find the line offset for the focused component
-    //   let componentStartLine = 0;
-    //   if (this.focusedComponent) {
-    //     // Find the line where this component starts by summing heights of previous components
-    //     for (const child of this.children) {
-    //       if (child === this.focusedComponent) {
-    //         break;
-    //       }
-    //       // Use the already-rendered lines to calculate height, not re-render
-    //       const childLines = child.render(this.terminal.columns);
-    //       componentStartLine += childLines.length;
-    //     }
-    //   }
-    //
-    //   const absoluteRow = componentStartLine + cursorRow;
-    //   const absoluteCol = cursorCol;
-    //
-    //   // Position cursor using absolute positioning
-    //   // Move to home position first, then move down to row, then right to column
-    //   // Note: terminal rows/columns are 1-indexed, so we add 1
-    //   this.terminal.write(`\x1b[H\x1b[${absoluteRow + 1}B\x1b[${absoluteCol + 1}G`);
-    //   this.terminal.showCursor();
-    // }
     /**
      * Show a modal dialog
      */

package/dist/utils/bash/parse.d.ts

@@ -0,0 +1,19 @@
+interface ControlOperator {
+    op: "||" | "&&" | ";;" | "|&" | "<(" | "<<<" | ">>" | ">&" | "&" | ";" | "(" | ")" | "|" | "<" | ">";
+}
+interface GlobOperator {
+    op: "glob";
+    pattern: string;
+}
+interface CommentOperator {
+    comment: string;
+}
+type ParseEntry = string | ControlOperator | GlobOperator | CommentOperator;
+interface ParseOptions {
+    escape?: string;
+}
+type EnvFunction = (key: string) => unknown;
+export declare function parse(s: string, env?: Record<string, string | undefined> | EnvFunction, opts?: ParseOptions): ParseEntry[];
+export declare function parse<T extends object | string>(s: string, env: (key: string) => T | undefined, opts?: ParseOptions): (ParseEntry | T)[];
+export {};
+//# sourceMappingURL=parse.d.ts.map

package/dist/utils/bash/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../source/utils/bash/parse.ts"],"names":[],"mappings":"AA+BA,UAAU,eAAe;IACvB,EAAE,EACE,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,CAAC;CACT;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,UAAU,GAAG,MAAM,GAAG,eAAe,GAAG,YAAY,GAAG,eAAe,CAAC;AAE5E,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;AA8L5C,wBAAgB,KAAK,CACnB,CAAC,EAAE,MAAM,EACT,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,WAAW,EACtD,IAAI,CAAC,EAAE,YAAY,GAClB,UAAU,EAAE,CAAC;AAChB,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC7C,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,EACnC,IAAI,CAAC,EAAE,YAAY,GAClB,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC"}