@teammates/consolonia 0.6.3 → 0.7.1

package/dist/ansi/terminal-env.js

@@ -0,0 +1,206 @@
+/**
+ * Terminal environment detection.
+ *
+ * Probes environment variables and process state to determine which
+ * terminal capabilities are available. Used by App to send only the
+ * escape sequences the host terminal actually supports.
+ */
+// ── Detection ───────────────────────────────────────────────────────
+/**
+ * Detect terminal capabilities from the current environment.
+ *
+ * On Windows the main differentiator is whether we're running under
+ * Windows Terminal / ConPTY (full VT support) or legacy conhost
+ * (very limited escape handling). On Unix the TERM variable and
+ * TERM_PROGRAM give us enough signal.
+ */
+export function detectTerminal() {
+    const env = process.env;
+    const isTTY = !!process.stdout.isTTY;
+    if (!isTTY) {
+        return {
+            isTTY: false,
+            alternateScreen: false,
+            bracketedPaste: false,
+            mouse: false,
+            sgrMouse: false,
+            truecolor: false,
+            color256: false,
+            name: "pipe",
+        };
+    }
+    // ── Windows ─────────────────────────────────────────────────────
+    if (process.platform === "win32") {
+        // Windows Terminal sets WT_SESSION
+        if (env.WT_SESSION) {
+            return {
+                isTTY: true,
+                alternateScreen: true,
+                bracketedPaste: true,
+                mouse: true,
+                sgrMouse: true,
+                truecolor: true,
+                color256: true,
+                name: "windows-terminal",
+            };
+        }
+        // VS Code's integrated terminal (xterm.js)
+        if (env.TERM_PROGRAM === "vscode") {
+            return {
+                isTTY: true,
+                alternateScreen: true,
+                bracketedPaste: true,
+                mouse: true,
+                sgrMouse: true,
+                truecolor: true,
+                color256: true,
+                name: "vscode",
+            };
+        }
+        // ConEmu / Cmder
+        if (env.ConEmuPID) {
+            return {
+                isTTY: true,
+                alternateScreen: true,
+                bracketedPaste: true,
+                mouse: true,
+                sgrMouse: true,
+                truecolor: true,
+                color256: true,
+                name: "conemu",
+            };
+        }
+        // Mintty (Git Bash) — sets TERM=xterm*
+        if (env.TERM?.startsWith("xterm") && env.MSYSTEM) {
+            return {
+                isTTY: true,
+                alternateScreen: true,
+                bracketedPaste: true,
+                mouse: true,
+                sgrMouse: true,
+                truecolor: true,
+                color256: true,
+                name: "mintty",
+            };
+        }
+        // Fallback: modern Windows 10+ conhost with ConPTY has decent VT
+        // support, but mouse tracking can be unreliable. Enable everything
+        // and let the terminal silently ignore what it doesn't support.
+        return {
+            isTTY: true,
+            alternateScreen: true,
+            bracketedPaste: true,
+            mouse: true,
+            sgrMouse: true,
+            truecolor: true,
+            color256: true,
+            name: "conhost",
+        };
+    }
+    // ── Unix / macOS ────────────────────────────────────────────────
+    const term = env.TERM ?? "";
+    const termProgram = env.TERM_PROGRAM ?? "";
+    // tmux — full VT support, passes through SGR mouse
+    if (env.TMUX || term.startsWith("tmux") || term === "screen-256color") {
+        return {
+            isTTY: true,
+            alternateScreen: true,
+            bracketedPaste: true,
+            mouse: true,
+            sgrMouse: true,
+            truecolor: !!env.COLORTERM || term.includes("256color"),
+            color256: true,
+            name: "tmux",
+        };
+    }
+    // GNU screen — limited mouse support, no SGR
+    if (term === "screen" && !env.TMUX) {
+        return {
+            isTTY: true,
+            alternateScreen: true,
+            bracketedPaste: false,
+            mouse: true,
+            sgrMouse: false,
+            truecolor: false,
+            color256: false,
+            name: "screen",
+        };
+    }
+    // iTerm2
+    if (termProgram === "iTerm.app" || env.ITERM_SESSION_ID) {
+        return {
+            isTTY: true,
+            alternateScreen: true,
+            bracketedPaste: true,
+            mouse: true,
+            sgrMouse: true,
+            truecolor: true,
+            color256: true,
+            name: "iterm2",
+        };
+    }
+    // VS Code integrated terminal (macOS/Linux)
+    if (termProgram === "vscode") {
+        return {
+            isTTY: true,
+            alternateScreen: true,
+            bracketedPaste: true,
+            mouse: true,
+            sgrMouse: true,
+            truecolor: true,
+            color256: true,
+            name: "vscode",
+        };
+    }
+    // Alacritty
+    if (termProgram === "Alacritty" || term === "alacritty") {
+        return {
+            isTTY: true,
+            alternateScreen: true,
+            bracketedPaste: true,
+            mouse: true,
+            sgrMouse: true,
+            truecolor: true,
+            color256: true,
+            name: "alacritty",
+        };
+    }
+    // xterm-compatible (most Linux/macOS terminals)
+    if (term.startsWith("xterm") || term.includes("256color")) {
+        const hasTruecolor = env.COLORTERM === "truecolor" || env.COLORTERM === "24bit";
+        return {
+            isTTY: true,
+            alternateScreen: true,
+            bracketedPaste: true,
+            mouse: true,
+            sgrMouse: true,
+            truecolor: hasTruecolor,
+            color256: true,
+            name: term,
+        };
+    }
+    // Dumb terminal — absolute minimum
+    if (term === "dumb" || !term) {
+        return {
+            isTTY: true,
+            alternateScreen: false,
+            bracketedPaste: false,
+            mouse: false,
+            sgrMouse: false,
+            truecolor: false,
+            color256: false,
+            name: term || "unknown",
+        };
+    }
+    // Unknown but it is a TTY — enable common capabilities
+    return {
+        isTTY: true,
+        alternateScreen: true,
+        bracketedPaste: true,
+        mouse: true,
+        sgrMouse: false,
+        truecolor: false,
+        color256: true,
+        name: term,
+    };
+}

package/dist/app.d.ts

@@ -5,6 +5,7 @@
  * RenderTarget, DrawingContext, InputProcessor) and drives the
  * measure → arrange → render loop in response to input and resize events.
  */
+import { type TerminalCaps } from "./ansi/terminal-env.js";
 import type { Control } from "./layout/control.js";
 export interface AppOptions {
     /** Root control to render. */
@@ -21,6 +22,7 @@ export declare class App {
     private readonly _alternateScreen;
     private readonly _mouse;
     private readonly _title;
+    private readonly _caps;
     private _output;
     private _buffer;
     private _dirtyRegions;
@@ -34,6 +36,8 @@ export declare class App {
     private _resizeListener;
     private _sigintListener;
     private _renderScheduled;
+    /** Detected terminal capabilities (read-only, for diagnostics). */
+    get caps(): Readonly<TerminalCaps>;
     constructor(options: AppOptions);
     /**
      * Start the app — enters raw mode, sets up terminal, runs the event

package/dist/app.js

@@ -7,6 +7,7 @@
  */
 import * as esc from "./ansi/esc.js";
 import { AnsiOutput } from "./ansi/output.js";
+import { detectTerminal, } from "./ansi/terminal-env.js";
 import { DrawingContext } from "./drawing/context.js";
 import { createInputProcessor } from "./input/processor.js";
 import { disableRawMode, enableRawMode } from "./input/raw-mode.js";
@@ -19,6 +20,7 @@ export class App {
     _alternateScreen;
     _mouse;
     _title;
+    _caps;
     // Subsystems — created during run()
     _output;
     _buffer;
@@ -34,11 +36,16 @@ export class App {
     _resizeListener = null;
     _sigintListener = null;
     _renderScheduled = false;
+    /** Detected terminal capabilities (read-only, for diagnostics). */
+    get caps() {
+        return this._caps;
+    }
     constructor(options) {
         this.root = options.root;
         this._alternateScreen = options.alternateScreen ?? true;
         this._mouse = options.mouse ?? false;
         this._title = options.title;
+        this._caps = detectTerminal();
     }
     // ── Public API ───────────────────────────────────────────────────
     /**
@@ -114,30 +121,21 @@ export class App {
     }
     _prepareTerminal() {
         const stream = process.stdout;
-        let seq = "";
-        if (this._alternateScreen) {
-            seq += esc.alternateScreenOn;
-        }
-        seq += esc.hideCursor;
-        seq += esc.bracketedPasteOn;
-        if (this._mouse) {
-            seq += esc.mouseTrackingOn;
-        }
-        seq += esc.clearScreen;
-        stream.write(seq);
+        const seq = esc.initSequence(this._caps, {
+            alternateScreen: this._alternateScreen,
+            mouse: this._mouse,
+        });
+        if (seq)
+            stream.write(seq);
     }
     _restoreTerminal() {
         const stream = process.stdout;
-        let seq = esc.reset;
-        if (this._mouse) {
-            seq += esc.mouseTrackingOff;
-        }
-        seq += esc.bracketedPasteOff;
-        seq += esc.showCursor;
-        if (this._alternateScreen) {
-            seq += esc.alternateScreenOff;
-        }
-        stream.write(seq);
+        const seq = esc.restoreSequence(this._caps, {
+            alternateScreen: this._alternateScreen,
+            mouse: this._mouse,
+        });
+        if (seq)
+            stream.write(seq);
     }
     _createRenderPipeline(cols, rows) {
         this._buffer = new PixelBuffer(cols, rows);

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export type { Constraint, Point, Rect, Size, } from "./layout/types.js";
 export * as esc from "./ansi/esc.js";
 export { AnsiOutput } from "./ansi/output.js";
 export { stripAnsi, truncateAnsi, visibleLength, } from "./ansi/strip.js";
+export { type TerminalCaps, detectTerminal, } from "./ansi/terminal-env.js";
 export { DirtyRegions, DirtySnapshot } from "./render/regions.js";
 export { RenderTarget } from "./render/render-target.js";
 export { EscapeMatcher } from "./input/escape-matcher.js";
@@ -35,13 +36,15 @@ export { Control } from "./layout/control.js";
 export { Row, type RowOptions } from "./layout/row.js";
 export { Stack, type StackOptions } from "./layout/stack.js";
 export { Border, type BorderOptions } from "./widgets/border.js";
-export { ChatView, type ChatViewOptions, type DropdownItem, type FeedActionItem, } from "./widgets/chat-view.js";
+export { ChatView, type ChatViewOptions, type DropdownItem, type FeedActionEntry, type FeedActionItem, type FeedItem, } from "./widgets/chat-view.js";
+export { FeedStore } from "./widgets/feed-store.js";
 export { Interview, type InterviewOptions, type InterviewQuestion, } from "./widgets/interview.js";
 export { Panel, type PanelOptions } from "./widgets/panel.js";
 export { ScrollView, type ScrollViewOptions } from "./widgets/scroll-view.js";
 export { type StyledLine, StyledText, type StyledTextOptions, } from "./widgets/styled-text.js";
 export { Text, type TextOptions } from "./widgets/text.js";
 export { type DeleteSizer, type InputColorizer, TextInput, type TextInputOptions, } from "./widgets/text-input.js";
+export { VirtualList, type VirtualListItem, type VirtualListOptions, } from "./widgets/virtual-list.js";
 export { type MarkdownOptions, type MarkdownTheme, renderMarkdown, } from "./widgets/markdown.js";
 export { DEFAULT_SYNTAX_THEME, getHighlighter, highlightLine, registerHighlighter, type SyntaxHighlighter, type SyntaxTheme, type SyntaxToken, type SyntaxTokenType, } from "./widgets/syntax.js";
 export { concat, isStyledSpan, pen, type StyledSegment, type StyledSpan, spanLength, spanText, } from "./styled.js";

package/dist/index.js

@@ -23,6 +23,7 @@ export { charWidth, EMPTY_SYMBOL, isZeroWidth, stringDisplayWidth, sym, } from "
 export * as esc from "./ansi/esc.js";
 export { AnsiOutput } from "./ansi/output.js";
 export { stripAnsi, truncateAnsi, visibleLength, } from "./ansi/strip.js";
+export { detectTerminal, } from "./ansi/terminal-env.js";
 // ── Render pipeline ─────────────────────────────────────────────────
 export { DirtyRegions, DirtySnapshot } from "./render/regions.js";
 export { RenderTarget } from "./render/render-target.js";
@@ -47,12 +48,14 @@ export { Stack } from "./layout/stack.js";
 // ── Widgets ─────────────────────────────────────────────────────────
 export { Border } from "./widgets/border.js";
 export { ChatView, } from "./widgets/chat-view.js";
+export { FeedStore } from "./widgets/feed-store.js";
 export { Interview, } from "./widgets/interview.js";
 export { Panel } from "./widgets/panel.js";
 export { ScrollView } from "./widgets/scroll-view.js";
 export { StyledText, } from "./widgets/styled-text.js";
 export { Text } from "./widgets/text.js";
 export { TextInput, } from "./widgets/text-input.js";
+export { VirtualList, } from "./widgets/virtual-list.js";
 // ── Markdown ─────────────────────────────────────────────────────────
 export { renderMarkdown, } from "./widgets/markdown.js";
 // ── Syntax highlighting ──────────────────────────────────────────────

package/dist/input/mouse-matcher.d.ts

@@ -1,8 +1,14 @@
 /**
- * Parses SGR extended mouse tracking sequences.
+ * Parses terminal mouse tracking sequences.
  *
- * Format: \x1b[<Cb;Cx;CyM  (press/motion)
- *         \x1b[<Cb;Cx;Cym  (release)
+ * Supported formats:
+ *   SGR:        \x1b[<Cb;Cx;CyM  (press/motion)
+ *               \x1b[<Cb;Cx;Cym  (release)
+ *   SGR-Pixels: \x1b[<Cb;Cx;CyM  (same wire format as SGR, pixel coords)
+ *               \x1b[<Cb;Cx;Cym
+ *   X10:        \x1b[M Cb Cx Cy  (classic xterm byte encoding)
+ *   UTF-8:      \x1b[M Cb Cx Cy  (same prefix as X10, UTF-8 encoded coords)
+ *   URXVT:      \x1b[Cb;Cx;CyM   (decimal params, no < prefix)
  *
  * Cb encodes button and modifiers:
  *   bits 0-1: 0=left, 1=middle, 2=right
@@ -13,15 +19,27 @@
  *   bit 4 (+16): ctrl
  *
  * Cx, Cy are 1-based coordinates.
+ *
+ * Note: UTF-8 mode uses the same \x1b[M prefix as X10 but encodes
+ * coordinates as UTF-8 characters for values > 127. Node.js decodes
+ * UTF-8 stdin automatically, so the X10 parser handles both formats.
+ *
+ * Note: SGR-Pixels mode uses the same wire format as SGR but reports
+ * pixel coordinates instead of cell coordinates. These are passed
+ * through as-is (the caller must convert to cells if needed).
  */
 import { type InputEvent } from "./events.js";
 import { type IMatcher, MatchResult } from "./matcher.js";
 export declare class MouseMatcher implements IMatcher {
     private state;
     private params;
+    private x10Bytes;
+    private urxvtParams;
     private result;
     append(char: string): MatchResult;
     flush(): InputEvent | null;
     reset(): void;
     private finalize;
+    private finalizeUrxvt;
+    private finalizeX10;
 }

package/dist/input/mouse-matcher.js

@@ -1,8 +1,14 @@
 /**
- * Parses SGR extended mouse tracking sequences.
+ * Parses terminal mouse tracking sequences.
  *
- * Format: \x1b[<Cb;Cx;CyM  (press/motion)
- *         \x1b[<Cb;Cx;Cym  (release)
+ * Supported formats:
+ *   SGR:        \x1b[<Cb;Cx;CyM  (press/motion)
+ *               \x1b[<Cb;Cx;Cym  (release)
+ *   SGR-Pixels: \x1b[<Cb;Cx;CyM  (same wire format as SGR, pixel coords)
+ *               \x1b[<Cb;Cx;Cym
+ *   X10:        \x1b[M Cb Cx Cy  (classic xterm byte encoding)
+ *   UTF-8:      \x1b[M Cb Cx Cy  (same prefix as X10, UTF-8 encoded coords)
+ *   URXVT:      \x1b[Cb;Cx;CyM   (decimal params, no < prefix)
  *
  * Cb encodes button and modifiers:
  *   bits 0-1: 0=left, 1=middle, 2=right
@@ -13,6 +19,14 @@
  *   bit 4 (+16): ctrl
  *
  * Cx, Cy are 1-based coordinates.
+ *
+ * Note: UTF-8 mode uses the same \x1b[M prefix as X10 but encodes
+ * coordinates as UTF-8 characters for values > 127. Node.js decodes
+ * UTF-8 stdin automatically, so the X10 parser handles both formats.
+ *
+ * Note: SGR-Pixels mode uses the same wire format as SGR but reports
+ * pixel coordinates instead of cell coordinates. These are passed
+ * through as-is (the caller must convert to cells if needed).
  */
 import { mouseEvent } from "./events.js";
 import { MatchResult } from "./matcher.js";
@@ -24,12 +38,18 @@ var State;
     State[State["GotEsc"] = 1] = "GotEsc";
     /** Got \x1b[ */
     State[State["GotBracket"] = 2] = "GotBracket";
-    /** Got \x1b[< — now reading params until M or m */
+    /** Got \x1b[< — now reading SGR/SGR-Pixels params until M or m */
     State[State["Reading"] = 3] = "Reading";
+    /** Got \x1b[M — now reading three encoded bytes (X10 or UTF-8) */
+    State[State["ReadingX10"] = 4] = "ReadingX10";
+    /** Got \x1b[ followed by a digit — reading URXVT decimal params until M */
+    State[State["ReadingUrxvt"] = 5] = "ReadingUrxvt";
 })(State || (State = {}));
 export class MouseMatcher {
     state = State.Idle;
     params = "";
+    x10Bytes = [];
+    urxvtParams = "";
     result = null;
     append(char) {
         switch (this.state) {
@@ -52,6 +72,17 @@ export class MouseMatcher {
                     this.params = "";
                     return MatchResult.Partial;
                 }
+                if (char === "M") {
+                    this.state = State.ReadingX10;
+                    this.x10Bytes = [];
+                    return MatchResult.Partial;
+                }
+                // URXVT: \x1b[ followed by a digit starts decimal param reading
+                if (char >= "0" && char <= "9") {
+                    this.state = State.ReadingUrxvt;
+                    this.urxvtParams = char;
+                    return MatchResult.Partial;
+                }
                 this.state = State.Idle;
                 return MatchResult.NoMatch;
             case State.Reading: {
@@ -69,6 +100,26 @@ export class MouseMatcher {
                 this.params = "";
                 return MatchResult.NoMatch;
             }
+            case State.ReadingX10:
+                this.x10Bytes.push(char);
+                if (this.x10Bytes.length < 3) {
+                    return MatchResult.Partial;
+                }
+                return this.finalizeX10();
+            case State.ReadingUrxvt: {
+                if (char === "M") {
+                    return this.finalizeUrxvt();
+                }
+                const c = char.charCodeAt(0);
+                if ((c >= 0x30 && c <= 0x39) || char === ";") {
+                    this.urxvtParams += char;
+                    return MatchResult.Partial;
+                }
+                // Not a valid URXVT sequence — bail out
+                this.state = State.Idle;
+                this.urxvtParams = "";
+                return MatchResult.NoMatch;
+            }
             default:
                 return MatchResult.NoMatch;
         }
@@ -81,6 +132,8 @@ export class MouseMatcher {
     reset() {
         this.state = State.Idle;
         this.params = "";
+        this.x10Bytes = [];
+        this.urxvtParams = "";
         this.result = null;
     }
     finalize(isRelease) {
@@ -96,37 +149,77 @@ export class MouseMatcher {
         if (Number.isNaN(cb) || Number.isNaN(cx) || Number.isNaN(cy)) {
             return MatchResult.NoMatch;
         }
-        // Decode modifiers from cb
-        const shift = (cb & 4) !== 0;
-        const alt = (cb & 8) !== 0;
-        const ctrl = (cb & 16) !== 0;
-        const isMotion = (cb & 32) !== 0;
-        // Decode button from low bits (masking out modifier/motion bits)
-        const buttonBits = cb & 3;
-        const highBits = cb & (64 | 128);
-        let button;
-        let type;
-        if (highBits === 64) {
-            // Wheel events
-            button = "none";
-            type = buttonBits === 0 ? "wheelup" : "wheeldown";
+        if (isRelease) {
+            const shift = (cb & 4) !== 0;
+            const alt = (cb & 8) !== 0;
+            const ctrl = (cb & 16) !== 0;
+            this.result = mouseEvent(cx - 1, cy - 1, decodeButton(cb & 3), "release", shift, ctrl, alt);
+            return MatchResult.Complete;
         }
-        else if (isRelease) {
-            button = decodeButton(buttonBits);
-            type = "release";
+        this.result = decodeMouseEvent(cb, cx, cy, true);
+        return this.result ? MatchResult.Complete : MatchResult.NoMatch;
+    }
+    finalizeUrxvt() {
+        this.state = State.Idle;
+        const parts = this.urxvtParams.split(";");
+        this.urxvtParams = "";
+        if (parts.length !== 3) {
+            return MatchResult.NoMatch;
+        }
+        const cb = parseInt(parts[0], 10);
+        const cx = parseInt(parts[1], 10);
+        const cy = parseInt(parts[2], 10);
+        if (Number.isNaN(cb) || Number.isNaN(cx) || Number.isNaN(cy)) {
+            return MatchResult.NoMatch;
         }
-        else if (isMotion) {
-            button = buttonBits === 3 ? "none" : decodeButton(buttonBits);
-            type = "move";
+        // URXVT uses the same button encoding as X10 (button 3 = release)
+        this.result = decodeMouseEvent(cb, cx, cy, true);
+        return this.result ? MatchResult.Complete : MatchResult.NoMatch;
+    }
+    finalizeX10() {
+        this.state = State.Idle;
+        if (this.x10Bytes.length !== 3) {
+            this.x10Bytes = [];
+            return MatchResult.NoMatch;
         }
-        else {
-            button = decodeButton(buttonBits);
-            type = "press";
+        const [cbChar, cxChar, cyChar] = this.x10Bytes;
+        this.x10Bytes = [];
+        const cb = cbChar.charCodeAt(0) - 32;
+        const cx = cxChar.charCodeAt(0) - 32;
+        const cy = cyChar.charCodeAt(0) - 32;
+        if (cb < 0 || cx <= 0 || cy <= 0) {
+            return MatchResult.NoMatch;
         }
-        // Convert from 1-based to 0-based coordinates
-        this.result = mouseEvent(cx - 1, cy - 1, button, type, shift, ctrl, alt);
-        return MatchResult.Complete;
+        this.result = decodeMouseEvent(cb, cx, cy, true);
+        return this.result ? MatchResult.Complete : MatchResult.NoMatch;
+    }
+}
+function decodeMouseEvent(cb, cx, cy, x10ReleaseUsesButton3) {
+    const shift = (cb & 4) !== 0;
+    const alt = (cb & 8) !== 0;
+    const ctrl = (cb & 16) !== 0;
+    const isMotion = (cb & 32) !== 0;
+    const buttonBits = cb & 3;
+    const highBits = cb & (64 | 128);
+    let button;
+    let type;
+    if (highBits === 64) {
+        button = "none";
+        type = buttonBits === 0 ? "wheelup" : "wheeldown";
+    }
+    else if (x10ReleaseUsesButton3 && !isMotion && buttonBits === 3) {
+        button = "none";
+        type = "release";
+    }
+    else if (isMotion) {
+        button = buttonBits === 3 ? "none" : decodeButton(buttonBits);
+        type = "move";
+    }
+    else {
+        button = decodeButton(buttonBits);
+        type = "press";
     }
+    return mouseEvent(cx - 1, cy - 1, button, type, shift, ctrl, alt);
 }
 function decodeButton(bits) {
     switch (bits) {