@valyrianjs/terminal 0.1.2 → 0.2.1

package/dist/session.js

@@ -1,10 +1,10 @@
-import { ANSI_ENTER_ALTERNATE_SCREEN, ANSI_EXIT_ALTERNATE_SCREEN, ANSI_HIDE_CURSOR, ANSI_SHOW_CURSOR, createAnsiDiffWriter, formatPlainFrame, toAnsiFrame } from "./ansi.js";
+import { ANSI_DISABLE_MOUSE_REPORTING, ANSI_ENABLE_MOUSE_REPORTING, ANSI_ENTER_ALTERNATE_SCREEN, ANSI_EXIT_ALTERNATE_SCREEN, ANSI_HIDE_CURSOR, ANSI_SHOW_CURSOR, createAnsiDiffWriter, formatPlainFrame, toAnsiFrame } from "./ansi.js";
 import { createSystemClipboardAdapter } from "./clipboard.js";
 import { createEditorState, insertEditorText, moveEditorCursor, removeEditorBackward, removeEditorForward } from "./editor-state.js";
 import { copySelection, hasSelection, insertText, moveCursorEnd, moveCursorHome, moveCursorLeft, moveCursorRight, moveCursorWordLeft, moveCursorWordRight, normalizeInputState, parseTerminalKey, removeBackward, removeForward, selectAll } from "./events.js";
 import { createResolvedTerminalKeymap, resolveTerminalKeyBinding } from "./keymap.js";
 import { mergeVertical } from "./layout.js";
-import { cursorFromHitbox, parseTerminalInput, resolvePointerTarget } from "./mouse.js";
+import { cursorFromHitbox, parseTerminalInput, parseTerminalMousePrefix, resolvePointerTarget } from "./mouse.js";
 import { createOutputWriter } from "./output-writer.js";
 import { parseBracketedPaste } from "./paste.js";
 import { renderTerminalFrame } from "./render.js";
@@ -25,6 +25,10 @@ const KNOWN_TERMINAL_KEY_SEQUENCES = [
     "\u001b[1;3C",
     "\u001b[1;3D",
     "\u001b[3~",
+    "\u001b[5~",
+    "\u001b[6~",
+    "\u001b[1~",
+    "\u001b[4~",
     "\u001b[Z",
     "\u001b[A",
     "\u001b[B",
@@ -37,6 +41,7 @@ const KNOWN_TERMINAL_KEY_SEQUENCES = [
 ];
 const ESCAPE = "\u001b";
 const CSI_PREFIX = "\u001b[";
+const DOUBLE_PRESS_INTERVAL_MS = 500;
 function isBracketedPasteStartPrefix(value) {
     return value.length > 0 && value.length < BRACKETED_PASTE_START.length && BRACKETED_PASTE_START.startsWith(value);
 }
@@ -83,6 +88,7 @@ function resolveRuntimeOptions(options) {
         stdout,
         alternateScreen: options.alternateScreen ?? ownsInteractiveTTY,
         hideCursor: options.hideCursor ?? ownsInteractiveTTY,
+        mouseReporting: ownsInteractiveTTY,
         writesAnsi: runtime === "app" && Boolean(stdout)
     };
 }
@@ -94,7 +100,7 @@ function resolveTerminalSize(options, stdout) {
         rows: validateTerminalDimension("rows", rows)
     };
 }
-function applyInteractiveState(nodes, focusedId, inputStateById, editorStateById, listIndexById, scrollOffsetById, listHoverById, scrollHoverRowById) {
+function applyInteractiveState(nodes, focusedId, inputStateById, editorStateById, listIndexById, listSelectedIndexById, listViewportOffsetById, scrollOffsetById, listHoverById, scrollHoverRowById) {
     for (let i = 0; i < nodes.length; i += 1) {
         const node = nodes[i];
         if (node.type !== "element") {
@@ -116,7 +122,23 @@ function applyInteractiveState(nodes, focusedId, inputStateById, editorStateById
             node.props.__editorState = current;
         }
         if (node.tag === "terminal-list" && id) {
-            node.props.__selectedIndex = listIndexById.get(id) || 0;
+            const items = Array.isArray(node.props.items) ? node.props.items : [];
+            const activeIndex = listIndexById.get(id) || 0;
+            const clampedActiveIndex = Math.max(0, Math.min(Math.max(0, items.length - 1), activeIndex));
+            if (!listIndexById.has(id)) {
+                listIndexById.set(id, clampedActiveIndex);
+            }
+            const selectedIndex = node.props.showActive === false
+                ? null
+                : listSelectedIndexById.has(id)
+                    ? listSelectedIndexById.get(id)
+                    : clampedActiveIndex;
+            if (!listSelectedIndexById.has(id)) {
+                listSelectedIndexById.set(id, selectedIndex === null ? null : Math.max(0, Math.min(Math.max(0, items.length - 1), selectedIndex)));
+            }
+            node.props.__activeIndex = clampedActiveIndex;
+            node.props.__selectedIndex = selectedIndex === null ? null : Math.max(0, Math.min(Math.max(0, items.length - 1), selectedIndex));
+            node.props.__scrollOffset = listViewportOffsetById.get(id) || 0;
             if (listHoverById.has(id)) {
                 node.props.__hoveredIndex = listHoverById.get(id);
             }
@@ -127,7 +149,7 @@ function applyInteractiveState(nodes, focusedId, inputStateById, editorStateById
                 node.props.__hoveredRow = scrollHoverRowById.get(id);
             }
         }
-        applyInteractiveState(node.children, focusedId, inputStateById, editorStateById, listIndexById, scrollOffsetById, listHoverById, scrollHoverRowById);
+        applyInteractiveState(node.children, focusedId, inputStateById, editorStateById, listIndexById, listSelectedIndexById, listViewportOffsetById, scrollOffsetById, listHoverById, scrollHoverRowById);
     }
 }
 export function mountTerminal(input, options = {}) {
@@ -139,6 +161,7 @@ export function mountTerminal(input, options = {}) {
     let pendingPasteChunk = "";
     let pendingKeyChunk = "";
     let pendingEscapeFlush = null;
+    let lastPrimaryPress = null;
     let destroyed = false;
     let autoProjectionEnabled = false;
     let suppressAutoProjection = false;
@@ -146,6 +169,8 @@ export function mountTerminal(input, options = {}) {
     const inputStateById = new Map();
     const editorStateById = new Map();
     const listIndexById = new Map();
+    const listSelectedIndexById = new Map();
+    const listViewportOffsetById = new Map();
     const scrollOffsetById = new Map();
     const listHoverById = new Map();
     const scrollHoverRowById = new Map();
@@ -159,7 +184,7 @@ export function mountTerminal(input, options = {}) {
         renderNow();
     });
     let currentTree = terminalRuntime.project();
-    applyInteractiveState(currentTree, focusedId, inputStateById, editorStateById, listIndexById, scrollOffsetById, listHoverById, scrollHoverRowById);
+    applyInteractiveState(currentTree, focusedId, inputStateById, editorStateById, listIndexById, listSelectedIndexById, listViewportOffsetById, scrollOffsetById, listHoverById, scrollHoverRowById);
     let currentFrame = renderTreeFrame(currentTree);
     let currentOutput = formatPlainFrame(currentFrame, { theme: options.theme }).trimEnd();
     let currentHitboxes = currentFrame.hitboxes;
@@ -184,6 +209,9 @@ export function mountTerminal(input, options = {}) {
         if (runtimeOptions.hideCursor) {
             writes.push(ANSI_HIDE_CURSOR);
         }
+        if (runtimeOptions.mouseReporting) {
+            writes.push(ANSI_ENABLE_MOUSE_REPORTING);
+        }
         if (writes.length > 0) {
             outputWriter.write(writes.join(""), { force: true });
         }
@@ -193,6 +221,9 @@ export function mountTerminal(input, options = {}) {
             return;
         }
         const writes = [];
+        if (runtimeOptions.mouseReporting) {
+            writes.push(ANSI_DISABLE_MOUSE_REPORTING);
+        }
         if (runtimeOptions.hideCursor) {
             writes.push(ANSI_SHOW_CURSOR);
         }
@@ -221,7 +252,7 @@ export function mountTerminal(input, options = {}) {
             focusedId = activeFocusables[0]?.props.id || null;
         }
         skipFocusContainmentOnce = false;
-        applyInteractiveState(currentTree, focusedId, inputStateById, editorStateById, listIndexById, scrollOffsetById, listHoverById, scrollHoverRowById);
+        applyInteractiveState(currentTree, focusedId, inputStateById, editorStateById, listIndexById, listSelectedIndexById, listViewportOffsetById, scrollOffsetById, listHoverById, scrollHoverRowById);
         currentFrame = renderTreeFrame(currentTree);
         currentOutput = formatPlainFrame(currentFrame, { theme: options.theme }).trimEnd();
         currentHitboxes = currentFrame.hitboxes;
@@ -360,10 +391,18 @@ export function mountTerminal(input, options = {}) {
         return 1;
     }
     function sourceRowFromHitbox(node, hitbox, y) {
-        const visibleRow = Math.max(1, y - hitbox.y1 + 1);
+        if (node.tag === "terminal-list" && typeof hitbox.__listItemIndex === "number" && y >= hitbox.y1 && y <= hitbox.y2) {
+            return Math.max(1, Math.min(rowCountForNode(node), hitbox.__listItemIndex + 1));
+        }
+        const sourceY = hitbox.contentY ?? hitbox.y1;
+        const visibleRow = Math.max(1, y - sourceY + 1);
         if (node.tag !== "terminal-list") {
             return Math.max(1, Math.min(rowCountForNode(node), visibleRow));
         }
+        const mappedIndex = hitbox.itemIndexes?.[visibleRow - 1];
+        if (typeof mappedIndex === "number") {
+            return Math.max(1, Math.min(rowCountForNode(node), mappedIndex + 1));
+        }
         return Math.max(1, Math.min(rowCountForNode(node), visibleRow + (hitbox.itemOffset || 0)));
     }
     function shouldPointerCapture(node) {
@@ -404,6 +443,155 @@ export function mountTerminal(input, options = {}) {
             emitCaptureEvent(next, "capturestart", source, row ?? hoveredRowForNode(next), x, y);
         }
     }
+    function listItemKey(node, index) {
+        const items = Array.isArray(node.props.items) ? node.props.items : [];
+        const item = items[index];
+        if (typeof node.props.itemKey === "function" && typeof item !== "undefined") {
+            const key = node.props.itemKey(item, index);
+            if (typeof key === "string" || typeof key === "number") {
+                return String(key);
+            }
+        }
+        return undefined;
+    }
+    function listViewportRows(node) {
+        const context = renderContext();
+        const items = Array.isArray(node.props.items) ? node.props.items : [];
+        const hitbox = node.props.id ? currentHitboxes.find((box) => box.id === node.props.id) : null;
+        const overscan = typeof node.props.overscan === "number" ? Math.max(0, Math.floor(node.props.overscan)) : 0;
+        const renderedRows = hitbox ? Math.max(1, hitbox.y2 - hitbox.y1 + 1 - overscan * 2) : null;
+        const sourceRows = Number(node.props.height || renderedRows || context.rows || items.length || 1);
+        if (!Number.isFinite(sourceRows) || !Number.isInteger(sourceRows) || sourceRows <= 0) {
+            return Math.max(1, items.length || 1);
+        }
+        return Math.max(1, Math.min(items.length || 1, sourceRows));
+    }
+    function clampListIndex(node, index) {
+        const items = Array.isArray(node.props.items) ? node.props.items : [];
+        if (items.length === 0) {
+            return 0;
+        }
+        return Math.max(0, Math.min(items.length - 1, index));
+    }
+    function currentListActiveIndex(node) {
+        return clampListIndex(node, listIndexById.get(node.props.id || "") || 0);
+    }
+    function currentListSelectedIndex(node) {
+        const id = node.props.id || "";
+        if (node.props.showActive === false) {
+            return null;
+        }
+        if (listSelectedIndexById.has(id)) {
+            const selectedIndex = listSelectedIndexById.get(id);
+            return typeof selectedIndex === "number" ? clampListIndex(node, selectedIndex) : null;
+        }
+        return currentListActiveIndex(node);
+    }
+    function currentListViewportOffset(node) {
+        const id = node.props.id || "";
+        return Math.max(0, Math.min(listMaxViewportOffset(node), listViewportOffsetById.get(id) || 0));
+    }
+    function listStatePayload(node) {
+        return {
+            activeIndex: currentListActiveIndex(node),
+            selectedIndex: currentListSelectedIndex(node),
+            viewportOffset: currentListViewportOffset(node),
+            viewportRows: listViewportRows(node)
+        };
+    }
+    function listMaxViewportOffset(node) {
+        const items = Array.isArray(node.props.items) ? node.props.items : [];
+        return Math.max(0, items.length - listViewportRows(node));
+    }
+    function setListViewportOffset(node, offset, emit = true) {
+        const id = node.props.id;
+        if (!id) {
+            return;
+        }
+        const nextOffset = Math.max(0, Math.min(listMaxViewportOffset(node), offset));
+        const previous = listViewportOffsetById.get(id) || 0;
+        listViewportOffsetById.set(id, nextOffset);
+        if (emit && nextOffset !== previous) {
+            const payload = {
+                type: "viewportchange",
+                id,
+                offset: nextOffset,
+                rows: listViewportRows(node),
+                ...listStatePayload(node)
+            };
+            dispatchNodeEvent(node, "viewportchange", payload);
+        }
+    }
+    function ensureListActiveVisible(node, activeIndex) {
+        const id = node.props.id;
+        if (!id || !node.props.virtualized) {
+            return;
+        }
+        const currentOffset = listViewportOffsetById.get(id) || 0;
+        const rows = listViewportRows(node);
+        if (activeIndex < currentOffset) {
+            setListViewportOffset(node, activeIndex);
+            return;
+        }
+        if (activeIndex >= currentOffset + rows) {
+            setListViewportOffset(node, activeIndex - rows + 1);
+        }
+    }
+    function dispatchListPressEvent(node, type, index) {
+        const id = node.props.id;
+        if (!id) {
+            return false;
+        }
+        const items = Array.isArray(node.props.items) ? node.props.items : [];
+        if (typeof items[index] === "undefined") {
+            return false;
+        }
+        const key = listItemKey(node, index);
+        const payload = typeof key === "undefined"
+            ? { type, id, index, value: items[index], ...listStatePayload(node) }
+            : { type, id, index, key, value: items[index], ...listStatePayload(node) };
+        return dispatchNodeEvent(node, type, payload);
+    }
+    function dispatchButtonPressEvent(node, type) {
+        const id = String(node.props.id || "");
+        if (!id) {
+            return false;
+        }
+        return dispatchNodeEvent(node, type, { type, id });
+    }
+    function dispatchHitboxButtonPressEvent(hitbox, type) {
+        if (type !== "press" || typeof hitbox.__pressHandler !== "function") {
+            return false;
+        }
+        hitbox.__pressHandler({ type, id: hitbox.id });
+        return true;
+    }
+    function dispatchListPointerPressEvent(node, type, row) {
+        const items = Array.isArray(node.props.items) ? node.props.items : [];
+        const index = Math.max(0, Math.min(items.length - 1, row - 1));
+        return dispatchListPressEvent(node, type, index);
+    }
+    function dispatchInputContextPressEvent(node, hitbox, x, y) {
+        const id = String(node.props.id || "");
+        if (!id) {
+            return false;
+        }
+        const value = stripTerminalControls(node.props.value ?? "");
+        const current = normalizeInputState(inputStateById.get(id), value.length);
+        const cursor = typeof x === "number" ? cursorFromHitbox(hitbox, x) : current.cursor;
+        return dispatchNodeEvent(node, "contextpress", { type: "contextpress", id, value, cursor, x, y });
+    }
+    function dispatchScrollContextPressEvent(node, row, x, y) {
+        if (!node.props.id) {
+            return false;
+        }
+        const lines = visibleScrollLines(node);
+        const index = Math.max(0, Math.min(lines.length - 1, row - 1));
+        if (typeof lines[index] === "undefined") {
+            return false;
+        }
+        return dispatchNodeEvent(node, "contextpress", { type: "contextpress", id: node.props.id, row: index + 1, value: lines[index], x, y });
+    }
     function emitMouseRowEvent(node, type, row, x = null, y = null) {
         if (!node.props.id) {
             return;
@@ -414,7 +602,10 @@ export function mountTerminal(input, options = {}) {
             if (typeof items[index] === "undefined") {
                 return;
             }
-            const payload = { type, id: node.props.id, row: index + 1, index, value: items[index], x, y };
+            const key = listItemKey(node, index);
+            const payload = typeof key === "undefined"
+                ? { type, id: node.props.id, row: index + 1, index, value: items[index], x, y }
+                : { type, id: node.props.id, row: index + 1, index, key, value: items[index], x, y };
             dispatchNodeEvent(node, type, payload);
             return;
         }
@@ -504,28 +695,72 @@ export function mountTerminal(input, options = {}) {
         setSemanticHoverFromHitbox(hitbox.id, x, y);
         return rerender();
     }
-    function changeListSelection(node, direction) {
+    function moveListActiveTo(node, nextIndex) {
         const id = node.props.id;
         if (!id) {
             return currentOutput;
         }
         const items = Array.isArray(node.props.items) ? node.props.items : [];
-        const currentIndex = listIndexById.get(id) || 0;
-        const nextIndex = direction < 0 ? Math.max(0, currentIndex - 1) : Math.min(items.length - 1, currentIndex + 1);
+        const clampedIndex = clampListIndex(node, nextIndex);
+        listIndexById.set(id, clampedIndex);
+        ensureListActiveVisible(node, clampedIndex);
+        const key = listItemKey(node, clampedIndex);
+        const payload = typeof key === "undefined"
+            ? { type: "change", id, index: clampedIndex, value: items[clampedIndex], ...listStatePayload(node) }
+            : { type: "change", id, index: clampedIndex, key, value: items[clampedIndex], ...listStatePayload(node) };
+        dispatchNodeEvent(node, "change", payload);
+        return rerender();
+    }
+    function changeListSelection(node, direction) {
+        return moveListActiveTo(node, currentListActiveIndex(node) + direction);
+    }
+    function pageListSelection(node, direction) {
+        const id = node.props.id;
+        if (!id) {
+            return currentOutput;
+        }
+        const nextIndex = clampListIndex(node, currentListActiveIndex(node) + direction * listViewportRows(node));
         listIndexById.set(id, nextIndex);
-        const payload = { type: "change", id, index: nextIndex, value: items[nextIndex] };
+        setListViewportOffset(node, nextIndex);
+        const items = Array.isArray(node.props.items) ? node.props.items : [];
+        const key = listItemKey(node, nextIndex);
+        const payload = typeof key === "undefined"
+            ? { type: "change", id, index: nextIndex, value: items[nextIndex], ...listStatePayload(node) }
+            : { type: "change", id, index: nextIndex, key, value: items[nextIndex], ...listStatePayload(node) };
         dispatchNodeEvent(node, "change", payload);
         return rerender();
     }
+    function moveListSelectionToBoundary(node, boundary) {
+        const items = Array.isArray(node.props.items) ? node.props.items : [];
+        return moveListActiveTo(node, boundary === "start" ? 0 : Math.max(0, items.length - 1));
+    }
     function pressListSelection(node) {
+        const id = node.props.id;
+        if (!id) {
+            return currentOutput;
+        }
+        const currentIndex = currentListActiveIndex(node);
+        if (node.props.showActive !== false) {
+            listSelectedIndexById.set(id, currentIndex);
+        }
+        dispatchListPressEvent(node, "press", currentIndex);
+        return rerender();
+    }
+    function pressListPointerSelection(node, row) {
         const id = node.props.id;
         if (!id) {
             return currentOutput;
         }
         const items = Array.isArray(node.props.items) ? node.props.items : [];
-        const currentIndex = listIndexById.get(id) || 0;
-        const payload = { type: "press", id, index: currentIndex, value: items[currentIndex] };
-        dispatchNodeEvent(node, "press", payload);
+        const index = Math.max(0, Math.min(items.length - 1, row - 1));
+        if (typeof items[index] === "undefined") {
+            return currentOutput;
+        }
+        listIndexById.set(id, index);
+        if (node.props.showActive !== false) {
+            listSelectedIndexById.set(id, index);
+        }
+        dispatchListPressEvent(node, "press", index);
         return rerender();
     }
     function scrollFocusedNode(node, direction) {
@@ -552,7 +787,9 @@ export function mountTerminal(input, options = {}) {
             return scrollFocusedNode(node, direction);
         }
         if (node?.tag === "terminal-list" && node.props.virtualized) {
-            return changeListSelection(node, direction);
+            const currentOffset = listViewportOffsetById.get(node.props.id || "") || 0;
+            setListViewportOffset(node, currentOffset + direction);
+            return rerender();
         }
         return rerender();
     }
@@ -710,8 +947,7 @@ export function mountTerminal(input, options = {}) {
                 return currentOutput;
             case "button.press":
                 if (node?.tag === "terminal-button") {
-                    const id = String(node.props.id || "");
-                    dispatchNodeEvent(node, "press", { type: "press", id });
+                    dispatchButtonPressEvent(node, "press");
                     return rerender();
                 }
                 return currentOutput;
@@ -719,6 +955,14 @@ export function mountTerminal(input, options = {}) {
                 return node?.tag === "terminal-list" ? changeListSelection(node, -1) : currentOutput;
             case "list.next":
                 return node?.tag === "terminal-list" ? changeListSelection(node, 1) : currentOutput;
+            case "list.pageUp":
+                return node?.tag === "terminal-list" ? pageListSelection(node, -1) : currentOutput;
+            case "list.pageDown":
+                return node?.tag === "terminal-list" ? pageListSelection(node, 1) : currentOutput;
+            case "list.home":
+                return node?.tag === "terminal-list" ? moveListSelectionToBoundary(node, "start") : currentOutput;
+            case "list.end":
+                return node?.tag === "terminal-list" ? moveListSelectionToBoundary(node, "end") : currentOutput;
             case "list.press":
                 return node?.tag === "terminal-list" ? pressListSelection(node) : currentOutput;
             case "scroll.up":
@@ -754,6 +998,19 @@ export function mountTerminal(input, options = {}) {
                 return;
             }
             terminalSize = nextSize;
+            const focusedNode = findFocused(currentTree, focusedId);
+            if (focusedNode?.tag === "terminal-list" && focusedNode.props.id && focusedNode.props.virtualized) {
+                const items = Array.isArray(focusedNode.props.items) ? focusedNode.props.items : [];
+                const rows = Math.max(1, Math.min(items.length || 1, Number(focusedNode.props.height || terminalSize.rows || items.length || 1)));
+                const activeIndex = currentListActiveIndex(focusedNode);
+                const currentOffset = listViewportOffsetById.get(focusedNode.props.id) || 0;
+                if (activeIndex < currentOffset) {
+                    listViewportOffsetById.set(focusedNode.props.id, activeIndex);
+                }
+                else if (activeIndex >= currentOffset + rows) {
+                    listViewportOffsetById.set(focusedNode.props.id, Math.max(0, activeIndex - rows + 1));
+                }
+            }
             rerender();
         },
         update() {
@@ -834,7 +1091,7 @@ export function mountTerminal(input, options = {}) {
             if (id) {
                 focusedId = node.props.id || focusedId;
             }
-            dispatchNodeEvent(node, "press", { type: "press", id: String(node.props.id || "") });
+            dispatchButtonPressEvent(node, "press");
             return rerender();
         },
         clickAt(x, y) {
@@ -844,7 +1101,14 @@ export function mountTerminal(input, options = {}) {
                 return currentOutput;
             }
             if (hitbox.tag === "terminal-button") {
-                return this.click(hitbox.id);
+                const node = findFocusableById(currentTree, hitbox.id);
+                if (node?.tag === "terminal-button") {
+                    return this.click(hitbox.id);
+                }
+                if (dispatchHitboxButtonPressEvent(hitbox, "press")) {
+                    return rerender();
+                }
+                return currentOutput;
             }
             setSemanticHoverFromHitbox(hitbox.id, x, y);
             focusedId = hitbox.id;
@@ -852,6 +1116,12 @@ export function mountTerminal(input, options = {}) {
                 mouseSelectionId = hitbox.id;
                 return setCursorFromHitbox(hitbox.id, x, false);
             }
+            if (hitbox.tag === "terminal-list") {
+                const node = findFocusableById(currentTree, hitbox.id);
+                if (node?.tag === "terminal-list") {
+                    return pressListPointerSelection(node, sourceRowFromHitbox(node, hitbox, y));
+                }
+            }
             rerender();
             return currentOutput;
         },
@@ -975,6 +1245,142 @@ export function mountTerminal(input, options = {}) {
             session.dispatchKey(parseTerminalKey(char));
         }
     }
+    function isPrimaryMouseButton(button) {
+        return button < 64 && (button & 3) === 0;
+    }
+    function isContextMouseButton(button) {
+        return button < 64 && (button & 3) === 2;
+    }
+    function isDoublePrimaryPress(hitbox, row) {
+        const now = Date.now();
+        const isDouble = Boolean(lastPrimaryPress
+            && lastPrimaryPress.id === hitbox.id
+            && lastPrimaryPress.tag === hitbox.tag
+            && lastPrimaryPress.row === row
+            && now - lastPrimaryPress.at <= DOUBLE_PRESS_INTERVAL_MS);
+        lastPrimaryPress = { id: hitbox.id, tag: hitbox.tag, row, at: now };
+        return isDouble;
+    }
+    function doublePressAt(hitbox, x, y) {
+        const node = findFocusableById(currentTree, hitbox.id);
+        if (!node) {
+            return currentOutput;
+        }
+        focusedId = hitbox.id;
+        setSemanticHoverFromHitbox(hitbox.id, x, y);
+        if (node.tag === "terminal-button") {
+            dispatchButtonPressEvent(node, "doublepress");
+            return rerender();
+        }
+        if (node.tag === "terminal-list") {
+            dispatchListPointerPressEvent(node, "doublepress", sourceRowFromHitbox(node, hitbox, y));
+            return rerender();
+        }
+        return currentOutput;
+    }
+    function contextPressAt(x, y) {
+        const hitbox = resolvePointerTarget(currentHitboxes, x, y);
+        if (!hitbox) {
+            clearSemanticHover(undefined, x, y);
+            return currentOutput;
+        }
+        const node = findFocusableById(currentTree, hitbox.id);
+        if (!node) {
+            return currentOutput;
+        }
+        focusedId = hitbox.id;
+        setSemanticHoverFromHitbox(hitbox.id, x, y);
+        if (node.tag === "terminal-button") {
+            dispatchButtonPressEvent(node, "contextpress");
+            return rerender();
+        }
+        if (node.tag === "terminal-list") {
+            dispatchListPointerPressEvent(node, "contextpress", sourceRowFromHitbox(node, hitbox, y));
+            return rerender();
+        }
+        if (node.tag === "terminal-input") {
+            dispatchInputContextPressEvent(node, hitbox, x, y);
+            return rerender();
+        }
+        if (node.tag === "terminal-scroll") {
+            dispatchScrollContextPressEvent(node, sourceRowFromHitbox(node, hitbox, y), x, y);
+            return rerender();
+        }
+        return currentOutput;
+    }
+    function processParsedMouseInput(parsed) {
+        if (parsed.action === "press") {
+            const hitbox = resolvePointerTarget(currentHitboxes, parsed.x, parsed.y);
+            if (isContextMouseButton(parsed.button)) {
+                lastPrimaryPress = null;
+                contextPressAt(parsed.x, parsed.y);
+                return;
+            }
+            if (hitbox?.tag === "terminal-input") {
+                mouseSelectionId = hitbox.id;
+            }
+            const node = hitbox ? findFocusableById(currentTree, hitbox.id) : null;
+            if (hitbox && node && shouldPointerCapture(node)) {
+                setPointerCapture(hitbox.id, "press", sourceRowFromHitbox(node, hitbox, parsed.y), parsed.x, parsed.y);
+            }
+            const isPrimaryPress = isPrimaryMouseButton(parsed.button);
+            const isDoublePressEligible = Boolean(hitbox
+                && node
+                && (hitbox.tag === "terminal-button" || hitbox.tag === "terminal-list"));
+            const primaryPressRow = hitbox && node && hitbox.tag === "terminal-list"
+                ? sourceRowFromHitbox(node, hitbox, parsed.y)
+                : null;
+            const shouldDispatchDoublePress = Boolean(isPrimaryPress
+                && isDoublePressEligible
+                && hitbox
+                && isDoublePrimaryPress(hitbox, primaryPressRow));
+            if (isPrimaryPress && !isDoublePressEligible) {
+                lastPrimaryPress = null;
+            }
+            if (hitbox && shouldDispatchDoublePress && hitbox.tag === "terminal-list") {
+                doublePressAt(hitbox, parsed.x, parsed.y);
+            }
+            else {
+                session.clickAt(parsed.x, parsed.y);
+                if (hitbox && shouldDispatchDoublePress) {
+                    doublePressAt(hitbox, parsed.x, parsed.y);
+                }
+            }
+        }
+        else if (parsed.action === "drag") {
+            if (mouseSelectionId) {
+                setCursorFromHitbox(mouseSelectionId, parsed.x, true);
+            }
+            else {
+                hoverAt(parsed.x, parsed.y);
+            }
+        }
+        else if (parsed.action === "release") {
+            mouseSelectionId = null;
+            const capturedId = pointerCaptureId;
+            const releaseHitbox = resolvePointerTarget(currentHitboxes, parsed.x, parsed.y);
+            const releaseNode = releaseHitbox ? findFocusableById(currentTree, releaseHitbox.id) : null;
+            const releaseRow = releaseHitbox && releaseNode
+                ? sourceRowFromHitbox(releaseNode, releaseHitbox, parsed.y)
+                : null;
+            setPointerCapture(null, "release", capturedId && releaseHitbox?.id === capturedId ? releaseRow : null, parsed.x, parsed.y);
+            const hitbox = resolvePointerTarget(currentHitboxes, parsed.x, parsed.y);
+            if (capturedId && hitbox && hitbox.id === capturedId && (hitbox.tag === "terminal-list" || hitbox.tag === "terminal-scroll")) {
+                setSemanticHoverFromHitbox(hitbox.id, parsed.x, parsed.y);
+                rerender();
+            }
+            else {
+                clearSemanticHover(undefined, parsed.x, parsed.y);
+                rerender();
+            }
+        }
+        else if (parsed.action === "wheel-up") {
+            wheelAt(parsed.x, parsed.y, -1);
+        }
+        else if (parsed.action === "wheel-down") {
+            wheelAt(parsed.x, parsed.y, 1);
+        }
+    }
     function processInputStream(value) {
         if (!value) {
             return;
@@ -1026,52 +1432,15 @@ export function mountTerminal(input, options = {}) {
             processInputStream(paste.rest);
             return;
         }
+        const parsedMouse = parseTerminalMousePrefix(value);
+        if (parsedMouse) {
+            processParsedMouseInput(parsedMouse.input);
+            processInputStream(parsedMouse.rest);
+            return;
+        }
         const parsed = parseTerminalInput(value);
         if (parsed.type === "mouse") {
-            if (parsed.action === "press") {
-                const hitbox = resolvePointerTarget(currentHitboxes, parsed.x, parsed.y);
-                if (hitbox?.tag === "terminal-input") {
-                    mouseSelectionId = hitbox.id;
-                }
-                const node = hitbox ? findFocusableById(currentTree, hitbox.id) : null;
-                if (hitbox && node && shouldPointerCapture(node)) {
-                    setPointerCapture(hitbox.id, "press", sourceRowFromHitbox(node, hitbox, parsed.y), parsed.x, parsed.y);
-                }
-                session.clickAt(parsed.x, parsed.y);
-            }
-            else if (parsed.action === "drag") {
-                if (mouseSelectionId) {
-                    setCursorFromHitbox(mouseSelectionId, parsed.x, true);
-                }
-                else {
-                    hoverAt(parsed.x, parsed.y);
-                }
-            }
-            else if (parsed.action === "release") {
-                mouseSelectionId = null;
-                const capturedId = pointerCaptureId;
-                const releaseHitbox = resolvePointerTarget(currentHitboxes, parsed.x, parsed.y);
-                const releaseNode = releaseHitbox ? findFocusableById(currentTree, releaseHitbox.id) : null;
-                const releaseRow = releaseHitbox && releaseNode
-                    ? sourceRowFromHitbox(releaseNode, releaseHitbox, parsed.y)
-                    : null;
-                setPointerCapture(null, "release", capturedId && releaseHitbox?.id === capturedId ? releaseRow : null, parsed.x, parsed.y);
-                const hitbox = resolvePointerTarget(currentHitboxes, parsed.x, parsed.y);
-                if (capturedId && hitbox && hitbox.id === capturedId && (hitbox.tag === "terminal-list" || hitbox.tag === "terminal-scroll")) {
-                    setSemanticHoverFromHitbox(hitbox.id, parsed.x, parsed.y);
-                    rerender();
-                }
-                else {
-                    clearSemanticHover(undefined, parsed.x, parsed.y);
-                    rerender();
-                }
-            }
-            else if (parsed.action === "wheel-up") {
-                wheelAt(parsed.x, parsed.y, -1);
-            }
-            else if (parsed.action === "wheel-down") {
-                wheelAt(parsed.x, parsed.y, 1);
-            }
+            processParsedMouseInput(parsed);
             return;
         }
         processKeyStream(value);