@travisennis/acai 0.0.9 → 0.0.10

package/dist/tui/tui.js

@@ -1,7 +1,8 @@
 /**
  * Minimal TUI implementation with differential rendering
  */
-import { getTerminalSize, isCtrlC, isCtrlZ, 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,14 +46,41 @@ 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());
@@ -69,7 +105,15 @@ export class TUI extends Container {
         });
     }
     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;
         }
@@ -94,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();
@@ -106,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;
@@ -117,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) {
@@ -154,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"}

package/dist/utils/bash/parse.js

@@ -0,0 +1,223 @@
+// '<(' is process substitution operator and
+// can be parsed the same as control operator
+const CONTROL = `(?:${[
+    "\\|\\|",
+    "\\&\\&",
+    ";;",
+    "\\|\\&",
+    "\\<\\(",
+    "\\<\\<\\<",
+    ">>",
+    ">\\&",
+    "<\\&",
+    "[&;()|<>]",
+].join("|")})`;
+const controlRe = new RegExp(`^${CONTROL}$`);
+const META = "|&;()<> \t";
+const SINGLE_QUOTE = '"((\\\\"|[^"])*?)"';
+const DOUBLE_QUOTE = "'((\\\\'|[^'])*?)'";
+const hash = /^#$/;
+const SQ = "'";
+const DQ = '"';
+const DS = "$";
+let Token = "";
+const mult = 0x100000000; // Math.pow(16, 8);
+for (let i = 0; i < 4; i++) {
+    Token += (mult * Math.random()).toString(16);
+}
+const startsWithToken = new RegExp(`^${Token}`);
+function matchAll(s, r) {
+    const origIndex = r.lastIndex;
+    const matches = [];
+    let matchObj = r.exec(s);
+    while (matchObj !== null) {
+        matches.push(matchObj);
+        if (r.lastIndex === matchObj.index) {
+            r.lastIndex += 1;
+        }
+        matchObj = r.exec(s);
+    }
+    r.lastIndex = origIndex;
+    return matches;
+}
+function getVar(env, pre, key) {
+    let r = typeof env === "function" ? env(key) : env[key];
+    if (typeof r === "undefined" && key !== "") {
+        r = "";
+    }
+    else if (typeof r === "undefined") {
+        r = "$";
+    }
+    if (typeof r === "object") {
+        return pre + Token + JSON.stringify(r) + Token;
+    }
+    return pre + String(r);
+}
+function parseInternal(string, env, opts = {}) {
+    const Bs = opts.escape || "\\";
+    const Bareword = `(\\${Bs}["'${META}]|[^\\s'""${META}])+`;
+    const chunker = new RegExp([
+        `(${CONTROL})`, // control chars
+        `(${Bareword}|${SINGLE_QUOTE}|${DOUBLE_QUOTE})+`,
+    ].join("|"), "g");
+    const matches = matchAll(string, chunker);
+    if (matches.length === 0) {
+        return [];
+    }
+    const envToUse = env ?? {};
+    let commented = false;
+    return matches
+        .map(
+    // biome-ignore lint:noExcessiveCognitiveComplexity
+    (match) => {
+        const s = match[0];
+        if (!s || commented) {
+            return undefined;
+        }
+        if (controlRe.test(s)) {
+            return { op: s };
+        }
+        // Hand-written scanner/parser for Bash quoting rules:
+        //
+        // 1. inside single quotes, all characters are printed literally.
+        // 2. inside double quotes, all characters are printed literally
+        //    except variables prefixed by '$' and backslashes followed by
+        //    either a double quote or another backslash.
+        // 3. outside of any quotes, backslashes are treated as escape
+        //    characters and not printed (unless they are themselves escaped)
+        // 4. quote context can switch mid-token if there is no whitespace
+        //     between the two quote contexts (e.g. all'one'"token" parses as
+        //     "allonetoken")
+        let quote = false;
+        let esc = false;
+        let out = "";
+        let isGlob = false;
+        let i = 0;
+        function parseEnvVar() {
+            i += 1;
+            let varend;
+            let varname;
+            const char = s.charAt(i);
+            if (char === "{") {
+                i += 1;
+                if (s.charAt(i) === "}") {
+                    throw new Error(`Bad substitution: ${s.slice(i - 2, i + 1)}`);
+                }
+                varend = s.indexOf("}", i);
+                if (varend < 0) {
+                    throw new Error(`Bad substitution: ${s.slice(i)}`);
+                }
+                varname = s.slice(i, varend);
+                i = varend;
+            }
+            else if (/[*@#?$!_-]/.test(char)) {
+                varname = char;
+                i += 1;
+            }
+            else {
+                const slicedFromI = s.slice(i);
+                const varendMatch = slicedFromI.match(/[^\w\d_]/);
+                if (!varendMatch) {
+                    varname = slicedFromI;
+                    i = s.length;
+                }
+                else {
+                    varname = slicedFromI.slice(0, varendMatch.index);
+                    i += (varendMatch.index ?? 0) - 1;
+                }
+            }
+            return getVar(envToUse, "", varname);
+        }
+        for (i = 0; i < s.length; i++) {
+            const c = s.charAt(i);
+            isGlob = isGlob || (!quote && (c === "*" || c === "?"));
+            if (esc) {
+                out += c;
+                esc = false;
+            }
+            else if (quote) {
+                if (c === quote) {
+                    quote = false;
+                }
+                else if (quote === SQ) {
+                    out += c;
+                }
+                else {
+                    // Double quote
+                    if (c === Bs) {
+                        i += 1;
+                        const charAtI = s.charAt(i);
+                        if (charAtI === DQ || charAtI === Bs || charAtI === DS) {
+                            out += charAtI;
+                        }
+                        else {
+                            out += Bs + charAtI;
+                        }
+                    }
+                    else if (c === DS) {
+                        out += parseEnvVar();
+                    }
+                    else {
+                        out += c;
+                    }
+                }
+            }
+            else if (c === DQ || c === SQ) {
+                quote = c;
+            }
+            else if (controlRe.test(c)) {
+                return { op: s };
+            }
+            else if (hash.test(c)) {
+                commented = true;
+                const matchIndex = match.index;
+                const commentObj = {
+                    comment: string.slice((matchIndex ?? 0) + i + 1),
+                };
+                if (out.length) {
+                    return [out, commentObj];
+                }
+                return [commentObj];
+            }
+            else if (c === Bs) {
+                esc = true;
+            }
+            else if (c === DS) {
+                out += parseEnvVar();
+            }
+            else {
+                out += c;
+            }
+        }
+        if (isGlob) {
+            return { op: "glob", pattern: out };
+        }
+        return out;
+    })
+        .reduce((prev, arg) => {
+        // TODO: replace this whole reduce with a concat
+        return typeof arg === "undefined" ? prev : prev.concat(arg);
+    }, []);
+}
+export function parse(s, env = {}, opts) {
+    const mapped = parseInternal(s, env, opts);
+    if (typeof env !== "function") {
+        return mapped;
+    }
+    return mapped.reduce((acc, s) => {
+        if (typeof s === "object") {
+            return acc.concat(s);
+        }
+        const xs = s.split(RegExp(`(${Token}.*?${Token})`, "g"));
+        if (xs.length === 1) {
+            return acc.concat(xs[0]);
+        }
+        return acc.concat(xs.filter(Boolean).map((x) => {
+            if (startsWithToken.test(x)) {
+                const parts = x.split(Token);
+                return JSON.parse(parts[1]);
+            }
+            return x;
+        }));
+    }, []);
+}

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

@@ -0,0 +1,6 @@
+type QuoteArg = string | number | boolean | {
+    op: string;
+} | null | undefined;
+export declare function quote(xs: readonly QuoteArg[]): string;
+export {};
+//# sourceMappingURL=quote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../../../source/utils/bash/quote.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAE9E,wBAAgB,KAAK,CAAC,EAAE,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAyBrD"}

package/dist/utils/bash/quote.js

@@ -0,0 +1,23 @@
+export function quote(xs) {
+    return xs
+        .map((s) => {
+        if (s === null || s === undefined) {
+            return String(s);
+        }
+        const str = String(s);
+        if (str === "") {
+            return "''";
+        }
+        if (s && typeof s === "object") {
+            return s.op.replace(/(.)/g, "\\$1");
+        }
+        if (/["\s\\]/.test(str) && !/'/.test(str)) {
+            return `'${str.replace(/(['])/g, "\\$1")}'`;
+        }
+        if (/["'\s]/.test(str)) {
+            return `"${str.replace(/(["\\$`!])/g, "\\$1")}"`;
+        }
+        return str.replace(/([A-Za-z]:)?([#!"$&'()*,:;<=>?@[\\\]^`{|}])/g, "$1\\$2");
+    })
+        .join(" ");
+}

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

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../source/utils/bash.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,GAAG,EAAE,MAAM,GACV;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA0EtC;AAED,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,YAAY,MAAM,EAClB,cAAc,MAAM,EAAE,KACrB,MAkEF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,OAmHtD,CAAC"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../source/utils/bash.ts"],"names":[],"mappings":"AAuJA,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,GAAG,EAAE,MAAM,GACV;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAiDtC;AAED,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,YAAY,MAAM,EAClB,cAAc,MAAM,EAAE,KACrB,MAkEF,CAAC;AA6FF,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,OAetD,CAAC"}