@deepseek-harness-tui/dsh-tui 0.8.8 → 0.9.1

package/lib/types/ink/components/AlternateScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AlternateScreen.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/AlternateScreen.tsx"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,EAAE,KAAA,OA8CjC"}
+{"version":3,"file":"AlternateScreen.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/AlternateScreen.tsx"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,EAAE,KAAA,OAyDjC"}

package/lib/types/ink/components/AlternateScreen.js

@@ -2,6 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { c as _c } from "react/compiler-runtime";
 import { useContext, useInsertionEffect } from 'react';
 import instances from '../instances.js';
+import { logMouseDebug } from '../../utils/debug.js';
 import { DISABLE_MOUSE_TRACKING, ENABLE_MOUSE_TRACKING, ENTER_ALT_SCREEN, EXIT_ALT_SCREEN } from '../termio/dec.js';
 import { TerminalWriteContext } from '../useTerminalNotification.js';
 import Box from './Box.js';
@@ -36,13 +37,24 @@ export function AlternateScreen(t0) {
     let t3;
     if ($[0] !== mouseTracking || $[1] !== writeRaw) {
         t2 = () => {
-            const ink = instances.get(process.stdout);
+            // Same fallback as Chat's reanchor plumbing: embedders and test
+            // harnesses render with a stdout that is not process.stdout, so the
+            // strict key lookup would miss the only live instance and the
+            // alt-screen flag would never flip — silently killing click/hover
+            // dispatch (both are gated on altScreenActive). The "any instance"
+            // fallback is deliberately narrowed to the SINGLE-instance case:
+            // with several live Ink instances (multi-app embedding, tests
+            // running in parallel) guessing the first one would flip the wrong
+            // app's alt-screen state.
+            const ink = instances.get(process.stdout) ?? (instances.size === 1 ? instances.values().next().value : undefined);
+            logMouseDebug('alt-screen enter', { mouseTracking, inkFound: ink !== undefined, writeRaw: !!writeRaw, stack: new Error().stack?.split('\n').slice(2, 5).join(' | ') });
             if (!writeRaw) {
                 return;
             }
             writeRaw(ENTER_ALT_SCREEN + "\x1B[2J\x1B[H" + (mouseTracking ? ENABLE_MOUSE_TRACKING : ""));
             ink?.setAltScreenActive(true, mouseTracking);
             return () => {
+                logMouseDebug('alt-screen exit', { stack: new Error().stack?.split('\n').slice(2, 5).join(' | ') });
                 ink?.setAltScreenActive(false);
                 ink?.clearTextSelection();
                 writeRaw((mouseTracking ? DISABLE_MOUSE_TRACKING : "") + EXIT_ALT_SCREEN);

package/lib/types/ink/components/App.d.ts

@@ -15,13 +15,15 @@ type Props = {
     readonly terminalRows: number;
     readonly selection: SelectionState;
     readonly onSelectionChange: () => void;
-    readonly onClickAt: (col: number, row: number) => boolean;
+    readonly onClickAt: (col: number, row: number, button?: number) => boolean;
     readonly onHoverAt: (col: number, row: number) => void;
+    readonly onWheelAt: (col: number, row: number, deltaY: number, deltaX: number, button?: number) => boolean;
     readonly getHyperlinkAt: (col: number, row: number) => string | undefined;
     readonly onOpenHyperlink: (url: string) => void;
     readonly onMultiClick: (col: number, row: number, count: 2 | 3) => void;
     readonly onSelectionDrag: (col: number, row: number) => void;
     readonly onStdinResume?: () => void;
+    readonly onTerminalFocus?: (focused: boolean) => void;
     readonly onCursorDeclaration?: CursorDeclarationSetter;
     readonly dispatchKeyboardEvent: (parsedKey: ParsedKey) => void;
 };
@@ -51,6 +53,15 @@ export default class App extends PureComponent<Props, State> {
     pendingHyperlinkTimer: ReturnType<typeof setTimeout> | null;
     lastHoverCol: number;
     lastHoverRow: number;
+    /**
+     * Reset all transient pointer state. Called by Ink when the alt screen
+     * is entered/exited and on resize: rects, hover targets, and the click
+     * chain from the previous screen geometry/scene must not leak into the
+     * new one (stale hover sets would suppress the next real onMouseEnter;
+     * a stale clickCount could turn the first click on a fresh screen into
+     * a double-click).
+     */
+    resetPointerState(): void;
     lastStdinTime: number;
     writeRaw: (data: string) => void;
     isRawModeSupported(): boolean;

package/lib/types/ink/components/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/App.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAO7D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAGN,KAAK,SAAS,EACd,KAAK,WAAW,EAEhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAGN,KAAK,cAAc,EAEnB,MAAM,iBAAiB,CAAC;AAWzB,OAAO,EAAE,eAAe,EAAa,MAAM,wBAAwB,CAAC;AAsBpE,OAAiC,EAChC,KAAK,uBAAuB,EAC5B,MAAM,+BAA+B,CAAC;AAgBvC,KAAK,KAAK,GAAG;IACZ,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAK9B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAKvC,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAI1D,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAIvD,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAE1E,QAAQ,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAKhD,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAIxE,QAAQ,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAK7D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAKpC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAGvD,QAAQ,CAAC,qBAAqB,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CAC/D,CAAC;AAMF,KAAK,KAAK,GAAG;IACZ,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACvB,CAAC;AAKF,MAAM,CAAC,OAAO,OAAO,GAAI,SAAQ,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC;IAC3D,MAAM,CAAC,WAAW,SAAiB;IACnC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK;;;IAKnC,KAAK;;MAEZ;IAIF,mBAAmB,SAAK;IACxB,qBAAqB,eAAsB;IAC3C,aAAa,+CAAiB;IAE9B,qBAAqB,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAQ;IAGpD,cAAc,EAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAQ;IAE/C,QAAQ,CAAC,cAAc,MAAM;IAC7B,QAAQ,CAAC,aAAa,OAAO;IAI7B,OAAO,kBAEL;IAKF,aAAa,SAAK;IAClB,YAAY,SAAM;IAClB,YAAY,SAAM;IAClB,UAAU,SAAK;IAKf,qBAAqB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAQ;IAInE,YAAY,SAAM;IAClB,YAAY,SAAM;IAKlB,aAAa,SAAc;IAQ3B,QAAQ,GAAI,MAAM,MAAM,KAAG,IAAI,CAE7B;IAGF,kBAAkB,IAAI,OAAO;IAGpB,MAAM;IA2CN,iBAAiB;IASjB,oBAAoB;IAO7B,4EAA4E;IAC5E,iBAAiB;IAoBR,iBAAiB,CAAC,KAAK,EAAE,KAAK;IAGvC,gBAAgB,GAAI,WAAW,OAAO,KAAG,IAAI,CA8F3C;IAGF,eAAe,QAAO,IAAI,CA0BxB;IAGF,YAAY,GAAI,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,KAAG,IAAI,CAsClD;IACF,cAAc,QAAO,IAAI,CAwCvB;IACF,WAAW,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,IAAI,CAS7C;IACF,UAAU,GAAI,QAAQ,KAAK,KAAG,IAAI,CAKhC;IACF,mBAAmB,GAAI,WAAW,OAAO,KAAG,IAAI,CAI9C;IACF,aAAa,QAAO,IAAI,CAiDtB;CACF;AAsFD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,WAAW,GAAG,IAAI,CAsJ/D"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/App.tsx"],"names":[],"mappings":"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"}

package/lib/types/ink/components/App.js

@@ -5,6 +5,8 @@ import { logForDebugging } from "../../utils/debug.js";
 import { stopCapturingEarlyInput } from "../../utils/earlyInput.js";
 import { isEnvTruthy } from "../../utils/envUtils.js";
 import { isMouseClicksDisabled } from "../../utils/fullscreen.js";
+import { isInputSuppressed } from "../input-suppression.js";
+import { logMouseDebug } from "../../utils/debug.js";
 import { logError } from "../../utils/log.js";
 import { EventEmitter } from "../events/emitter.js";
 import { InputEvent } from "../events/input-event.js";
@@ -83,6 +85,34 @@ export default class App extends PureComponent {
     // repeat events (drag-then-release at same cell, etc.).
     lastHoverCol = -1;
     lastHoverRow = -1;
+    /**
+     * Reset all transient pointer state. Called by Ink when the alt screen
+     * is entered/exited and on resize: rects, hover targets, and the click
+     * chain from the previous screen geometry/scene must not leak into the
+     * new one (stale hover sets would suppress the next real onMouseEnter;
+     * a stale clickCount could turn the first click on a fresh screen into
+     * a double-click).
+     */
+    resetPointerState() {
+        this.clickCount = 0;
+        this.lastClickTime = 0;
+        this.lastClickCol = -1;
+        this.lastClickRow = -1;
+        this.lastHoverCol = -1;
+        this.lastHoverRow = -1;
+        if (this.pendingHyperlinkTimer) {
+            clearTimeout(this.pendingHyperlinkTimer);
+            this.pendingHyperlinkTimer = null;
+        }
+        // A drag interrupted by a screen swap has no release coming — settle
+        // the selection so copy-on-select fires rather than orphaning
+        // isDragging with its drag-to-scroll timer running.
+        const sel = this.props.selection;
+        if (sel.isDragging) {
+            finishSelection(sel);
+            this.props.onSelectionChange();
+        }
+    }
     // Timestamp of last stdin chunk. Used to detect long gaps (tmux attach,
     // ssh reconnect, laptop wake) and trigger terminal mode re-assert.
     // Initialized to now so startup doesn't false-trigger.
@@ -94,6 +124,9 @@ export default class App extends PureComponent {
     // <AlternateScreen>'s insertion effect every frame, flapping the alt
     // screen on/off.
     writeRaw = (data) => {
+        if (data.includes("\x1b[?1049")) {
+            logMouseDebug("stdout:1049", { len: data.length, head: data.slice(0, 60) });
+        }
         this.props.stdout.write(data);
     };
     // Determines if TTY is supported on the provided stdin
@@ -400,6 +433,32 @@ export default class App extends PureComponent {
 // Helper to process all keys within a single discrete update context.
 // discreteUpdates expects (fn, a, b, c, d) -> fn(a, b, c, d)
 function processKeysInBatch(app, items, _unused1, _unused2) {
+    // Mouse-chain diagnostics: the single choke point every parsed mouse and
+    // wheel event passes through. Empty log here = the terminal never sent
+    // the sequences (tracking modes, ConPTY) rather than an in-app loss.
+    if (process.env.DSH_TUI_DEBUG_MOUSE) {
+        for (const item of items) {
+            if (item.kind === "mouse") {
+                logMouseDebug("mouse arrive", {
+                    button: item.button,
+                    action: item.action,
+                    col: item.col,
+                    row: item.row,
+                    clicksDisabled: isMouseClicksDisabled(),
+                });
+            }
+            else if (item.kind === "key" &&
+                (item.name === "wheelup" || item.name === "wheeldown")) {
+                logMouseDebug("wheel arrive", { name: item.name });
+            }
+            else if (item.kind === "key") {
+                logMouseDebug("key arrive", {
+                    name: item.name,
+                    seq: (item.sequence ?? "").slice(0, 10),
+                });
+            }
+        }
+    }
     // Update interaction time for notification timeout tracking.
     // This is called from the central input handler to avoid having multiple
     // stdin listeners that can cause race conditions and dropped input.
@@ -429,6 +488,10 @@ function processKeysInBatch(app, items, _unused1, _unused2) {
         // Handle terminal focus events (DECSET 1004)
         if (sequence === FOCUS_IN) {
             app.handleTerminalFocus(true);
+            // Refocus is the first observable moment after a terminal-side
+            // mode reset (conpty drops 1049/mouse on DPI moves, renderer
+            // restarts, window snapping): probe and self-heal.
+            app.props.onTerminalFocus?.(true);
             const event = new TerminalFocusEvent("terminalfocus");
             app.internal_eventEmitter.emit("terminalfocus", event);
             continue;
@@ -458,6 +521,37 @@ function processKeysInBatch(app, items, _unused1, _unused2) {
             app.handleSuspend();
             continue;
         }
+        // Wheel keys carry the pointer position (SGR/X10 col/row). Route
+        // position-first: if a scroll container sits under the pointer, its
+        // onWheel consumes the event and the legacy global keybinding path
+        // never fires — exactly one layer scrolls. Events without coords
+        // (shouldn't happen for wheel) or over non-scroll areas fall
+        // through to the normal input path (Chat scrolls the transcript).
+        // Skipped during the post-handoff suppression window: a terminal
+        // replay burst can contain mouse-wheel fragments, and use-input's
+        // choke point never sees events consumed here.
+        if ((item.name === "wheelup" ||
+            item.name === "wheeldown" ||
+            item.name === "wheelleft" ||
+            item.name === "wheelright") &&
+            item.mouseCol !== undefined &&
+            item.mouseRow !== undefined &&
+            !isInputSuppressed()) {
+            const step = (item.name === "wheelup" || item.name === "wheelleft") ? -3 : 3;
+            const deltaY = item.name === "wheelup" || item.name === "wheeldown" ? step : 0;
+            const deltaX = item.name === "wheelleft" || item.name === "wheelright" ? step : 0;
+            const consumed = app.props.onWheelAt(item.mouseCol, item.mouseRow, deltaY, deltaX);
+            if (consumed) {
+                logMouseDebug("wheel routed by position", {
+                    col: item.mouseCol,
+                    row: item.mouseRow,
+                    deltaY,
+                    deltaX,
+                    name: item.name,
+                });
+                continue;
+            }
+        }
         app.handleInput(sequence);
         const event = new InputEvent(item);
         app.internal_eventEmitter.emit("input", event);
@@ -472,9 +566,12 @@ export function handleMouseEvent(app, m) {
     if (isMouseClicksDisabled())
         return;
     const sel = app.props.selection;
-    // Terminal coords are 1-indexed; screen buffer is 0-indexed
-    const col = m.col - 1;
-    const row = m.row - 1;
+    // Terminal coords are 1-indexed; screen buffer is 0-indexed. Clamp to
+    // the current frame's dimensions: a resize (or a terminal reporting a
+    // stale position) can deliver coordinates outside the screen buffer,
+    // and selection/hyperlink reads assume in-bounds cells.
+    const col = Math.max(0, Math.min(m.col - 1, app.props.terminalColumns - 1));
+    const row = Math.max(0, Math.min(m.row - 1, app.props.terminalRows - 1));
     const baseButton = m.button & 0x03;
     if (m.action === "press") {
         if ((m.button & 0x20) !== 0 && baseButton === 3) {
@@ -582,7 +679,7 @@ export function handleMouseEvent(app, m) {
         // Single click: dispatch DOM click immediately (cursor repositioning
         // etc. are latency-sensitive). If no DOM handler consumed it, defer
         // the hyperlink check so a second click can cancel it.
-        if (!app.props.onClickAt(col, row)) {
+        if (!app.props.onClickAt(col, row, m.button)) {
             // Resolve the hyperlink URL synchronously while the screen buffer
             // still reflects what the user clicked — deferring only the
             // browser-open so double-click can cancel it.

package/lib/types/ink/components/ClockContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClockContext.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/ClockContext.tsx"],"names":[],"mappings":"AACA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAGlE,MAAM,MAAM,KAAK,GAAG;IAClB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;IACpE,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,CAAC;AACF,wBAAgB,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,CA0DzD;AACD,eAAO,MAAM,YAAY,6BAAoC,CAAC;AAM9D,wBAAgB,aAAa,CAAC,EAAE,KAAA,OAiC/B"}
+{"version":3,"file":"ClockContext.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/ClockContext.tsx"],"names":[],"mappings":"AACA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAIlE,MAAM,MAAM,KAAK,GAAG;IAClB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;IACpE,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,CAAC;AACF,wBAAgB,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,CA2DzD;AACD,eAAO,MAAM,YAAY,6BAAoC,CAAC;AAM9D,wBAAgB,aAAa,CAAC,EAAE,KAAA,OAiC/B"}

package/lib/types/ink/components/ClockContext.js

@@ -2,6 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { c as _c } from "react/compiler-runtime";
 import { createContext, useEffect, useState } from 'react';
 import { FRAME_INTERVAL_MS } from '../constants.js';
+import { noteFrameCause } from '../geometry-trace.js';
 import { useTerminalFocus } from '../hooks/use-terminal-focus.js';
 export function createClock(tickIntervalMs) {
     const subscribers = new Map();
@@ -13,6 +14,7 @@ export function createClock(tickIntervalMs) {
     let tickTime = 0;
     function tick() {
         tickTime = Date.now() - startTime;
+        noteFrameCause('animation');
         for (const onChange of subscribers.keys()) {
             onChange();
         }

package/lib/types/ink/components/ScrollBox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScrollBox.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/ScrollBox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,KAAK,GAAG,EAAyC,MAAM,OAAO,CAAC;AACvG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B;;;;;;OAMG;IACH,eAAe,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,oBAAoB,EAAE,MAAM,MAAM,CAAC;IACnC,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC;;;OAGG;IACH,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB;;;;;OAKG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD;;;;;;;OAOG;IACH,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAC5E,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG;IACjG,GAAG,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,iBAAS,SAAS,CAAC,EACjB,QAAQ,EACR,GAAG,EACH,YAAY,EACZ,GAAG,KAAK,EACT,EAAE,iBAAiB,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,SAAS,CAyJrD;AACD,eAAe,SAAS,CAAC"}
+{"version":3,"file":"ScrollBox.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/ScrollBox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,KAAK,GAAG,EAAsD,MAAM,OAAO,CAAC;AACpH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAK5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B;;;;;;OAMG;IACH,eAAe,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,oBAAoB,EAAE,MAAM,MAAM,CAAC;IACnC,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC;;;OAGG;IACH,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB;;;;;OAKG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD;;;;;;;OAOG;IACH,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAC5E,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG;IACjG,GAAG,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,iBAAS,SAAS,CAAC,EACjB,QAAQ,EACR,GAAG,EACH,YAAY,EACZ,GAAG,KAAK,EACT,EAAE,iBAAiB,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,SAAS,CAqOrD;AACD,eAAe,SAAS,CAAC"}

package/lib/types/ink/components/ScrollBox.js

@@ -1,7 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useImperativeHandle, useRef, useState } from 'react';
+import { useCallback, useImperativeHandle, useRef, useState } from 'react';
+import { FRAME_INTERVAL_MS } from '../constants.js';
 import { markScrollActivity } from '../../bootstrap/state.js';
 import { markDirty, scheduleRenderFrom } from '../dom.js';
+import { noteFrameCause } from '../geometry-trace.js';
 import { markCommitStart } from '../reconciler.js';
 import Box from './Box.js';
 /**
@@ -27,18 +29,56 @@ function ScrollBox({ children, ref, stickyScroll, ...style }) {
     const [, forceRender] = useState(0);
     const listenersRef = useRef(new Set());
     const renderQueuedRef = useRef(false);
+    // The imperative handle, kept in a ref so the onWheel handler below can
+    // call scrollBy through the full public path (clamp bounds, sticky
+    // clearing, subscriber notify) instead of duplicating its logic.
+    const handleRef = useRef(null);
     const notify = () => {
         for (const l of listenersRef.current)
             l();
     };
+    // Input-edge intent coalescing (Qwen Code's 16ms wheel merge, Crush's
+    // pre-queue filter): subscribers drive React state (MessageList's mount
+    // window, Chat's sticky flag, the timeline rail), so notifying per wheel
+    // EVENT runs a full React commit per event — a fast flick is 10-30
+    // events, each re-running the offsets/window/timeline loops on a big
+    // session. The scrollTop mutation and the ink render are already
+    // frame-throttled; this aligns the React commits to the same frame
+    // budget. Both edges defer to a microtask: the remaining input events of
+    // the same stdin batch then land BEFORE any commit, and one commit
+    // covers the whole batch (the sync leading edge used to run a full
+    // commit inside the wheel dispatch itself — pure input latency).
+    const notifyQueuedRef = useRef(false);
+    const lastNotifyAtRef = useRef(-Infinity);
+    const notifyCoalesced = () => {
+        const since = performance.now() - lastNotifyAtRef.current;
+        if (!notifyQueuedRef.current && since >= FRAME_INTERVAL_MS) {
+            notifyQueuedRef.current = true;
+            lastNotifyAtRef.current = performance.now();
+            queueMicrotask(() => {
+                notifyQueuedRef.current = false;
+                notify();
+            });
+            return;
+        }
+        if (notifyQueuedRef.current)
+            return;
+        notifyQueuedRef.current = true;
+        setTimeout(() => {
+            notifyQueuedRef.current = false;
+            lastNotifyAtRef.current = performance.now();
+            notify();
+        }, Math.max(0, FRAME_INTERVAL_MS - since));
+    };
     function scrollMutated(el) {
         // Signal background intervals (IDE poll, LSP poll, GCS fetch, orphan
         // check) to skip their next tick — they compete for the event loop and
         // contributed to 1402ms max frame gaps during scroll drain.
         markScrollActivity();
+        noteFrameCause('scroll');
         markDirty(el);
         markCommitStart();
-        notify();
+        notifyCoalesced();
         if (renderQueuedRef.current)
             return;
         renderQueuedRef.current = true;
@@ -47,99 +87,138 @@ function ScrollBox({ children, ref, stickyScroll, ...style }) {
             scheduleRenderFrom(el);
         });
     }
-    useImperativeHandle(ref, () => ({
-        scrollTo(y) {
-            const el = domRef.current;
-            if (!el)
-                return;
-            // Explicit false overrides the DOM attribute so manual scroll
-            // breaks stickiness. Render code checks ?? precedence.
-            el.stickyScroll = false;
-            el.pendingScrollDelta = undefined;
-            el.scrollAnchor = undefined;
-            el.scrollTop = Math.max(0, Math.floor(y));
-            scrollMutated(el);
-        },
-        scrollToElement(el, offset = 0) {
-            const box = domRef.current;
-            if (!box)
-                return;
-            box.stickyScroll = false;
-            box.pendingScrollDelta = undefined;
-            box.scrollAnchor = {
-                el,
-                offset
-            };
-            scrollMutated(box);
-        },
-        scrollBy(dy) {
-            const el = domRef.current;
-            if (!el)
-                return;
-            el.stickyScroll = false;
-            // Wheel input cancels any in-flight anchor seek — user override.
-            el.scrollAnchor = undefined;
-            // Accumulate in pendingScrollDelta; renderer drains it at a capped
-            // rate so fast flicks show intermediate frames. Pure accumulator:
-            // scroll-up followed by scroll-down naturally cancels.
-            el.pendingScrollDelta = (el.pendingScrollDelta ?? 0) + Math.floor(dy);
-            scrollMutated(el);
-        },
-        scrollToBottom() {
-            const el = domRef.current;
-            if (!el)
-                return;
-            el.pendingScrollDelta = undefined;
-            el.stickyScroll = true;
-            markDirty(el);
-            notify();
-            forceRender(n => n + 1);
-        },
-        getScrollTop() {
-            return domRef.current?.scrollTop ?? 0;
-        },
-        getPendingDelta() {
-            // Accumulated-but-not-yet-drained delta. useVirtualScroll needs
-            // this to mount the union [committed, committed+pending] range —
-            // otherwise intermediate drain frames find no children (blank).
-            return domRef.current?.pendingScrollDelta ?? 0;
-        },
-        getScrollHeight() {
-            return domRef.current?.scrollHeight ?? 0;
-        },
-        getFreshScrollHeight() {
-            const content = domRef.current?.childNodes[0];
-            return content?.yogaNode?.getComputedHeight() ?? domRef.current?.scrollHeight ?? 0;
-        },
-        getViewportHeight() {
-            return domRef.current?.scrollViewportHeight ?? 0;
-        },
-        getViewportTop() {
-            return domRef.current?.scrollViewportTop ?? 0;
-        },
-        isSticky() {
-            const el = domRef.current;
-            if (!el)
-                return false;
-            return el.stickyScroll ?? Boolean(el.attributes['stickyScroll']);
-        },
-        subscribe(listener) {
-            listenersRef.current.add(listener);
-            return () => listenersRef.current.delete(listener);
-        },
-        setClampBounds(min, max) {
-            const el = domRef.current;
-            if (!el)
-                return;
-            el.scrollClampMin = min;
-            el.scrollClampMax = max;
-        }
-    }), 
+    useImperativeHandle(ref, () => {
+        const handle = {
+            scrollTo(y) {
+                const el = domRef.current;
+                if (!el)
+                    return;
+                // Explicit false overrides the DOM attribute so manual scroll
+                // breaks stickiness. Render code checks ?? precedence.
+                el.stickyScroll = false;
+                el.pendingScrollDelta = undefined;
+                el.scrollAnchor = undefined;
+                el.scrollTop = Math.max(0, Math.floor(y));
+                scrollMutated(el);
+            },
+            scrollToElement(el, offset = 0) {
+                const box = domRef.current;
+                if (!box)
+                    return;
+                box.stickyScroll = false;
+                box.pendingScrollDelta = undefined;
+                box.scrollAnchor = {
+                    el,
+                    offset
+                };
+                scrollMutated(box);
+            },
+            scrollBy(dy) {
+                const el = domRef.current;
+                if (!el)
+                    return;
+                el.stickyScroll = false;
+                // Wheel input cancels any in-flight anchor seek — user override.
+                el.scrollAnchor = undefined;
+                // Accumulate in pendingScrollDelta; renderer drains it at a capped
+                // rate so fast flicks show intermediate frames. Pure accumulator:
+                // scroll-up followed by scroll-down naturally cancels.
+                el.pendingScrollDelta = (el.pendingScrollDelta ?? 0) + Math.floor(dy);
+                scrollMutated(el);
+            },
+            scrollToBottom() {
+                const el = domRef.current;
+                if (!el)
+                    return;
+                el.scrollAnchor = undefined;
+                const viewportH = el.scrollViewportHeight ?? 0;
+                const maxScroll = Math.max(0, (el.scrollHeight ?? 0) - viewportH);
+                const distance = maxScroll - (el.scrollTop ?? 0);
+                if (distance > viewportH && viewportH > 0) {
+                    // FAR jump: drain instead of teleport. The viewport would land on
+                    // rows that were never mounted — their spacer heights are
+                    // DEFAULT_ROW_HEIGHT estimates, so the topPad swallows the view
+                    // (blank transcript) AND it is a fixed point: unmounted rows never
+                    // measure, nothing retried until the next wheel event. The drain
+                    // walks the exact wheel path instead: proportional steps, the
+                    // virtualization window follows per commit (it mounts the union of
+                    // committed + pending), the visual clamp pins to the mounted edge
+                    // while rows measure as they enter — no blank at any distance. The
+                    // renderer's at-bottom re-pin restores sticky when it lands
+                    // (stickyScroll=false + pending undefined + scrollTop >= maxScroll).
+                    el.stickyScroll = false;
+                    el.pendingScrollDelta = (el.pendingScrollDelta ?? 0) + distance;
+                    scrollMutated(el);
+                    return;
+                }
+                el.pendingScrollDelta = undefined;
+                el.stickyScroll = true;
+                // DOM-direct pre-write of the target (near jumps only): the notify
+                // below triggers MessageList's window recompute, and its React commit
+                // must read the NEW scrollTop — the old order (notify first, renderer
+                // moves scrollTop later) left the window one commit behind. The
+                // renderer's sticky branch re-pins scrollTop to the exact fresh
+                // maxScroll next frame, so a stale cached height costs one frame.
+                el.scrollTop = maxScroll;
+                scrollMutated(el);
+                forceRender(n => n + 1);
+            },
+            getScrollTop() {
+                return domRef.current?.scrollTop ?? 0;
+            },
+            getPendingDelta() {
+                // Accumulated-but-not-yet-drained delta. useVirtualScroll needs
+                // this to mount the union [committed, committed+pending] range —
+                // otherwise intermediate drain frames find no children (blank).
+                return domRef.current?.pendingScrollDelta ?? 0;
+            },
+            getScrollHeight() {
+                return domRef.current?.scrollHeight ?? 0;
+            },
+            getFreshScrollHeight() {
+                const content = domRef.current?.childNodes[0];
+                return content?.yogaNode?.getComputedHeight() ?? domRef.current?.scrollHeight ?? 0;
+            },
+            getViewportHeight() {
+                return domRef.current?.scrollViewportHeight ?? 0;
+            },
+            getViewportTop() {
+                return domRef.current?.scrollViewportTop ?? 0;
+            },
+            isSticky() {
+                const el = domRef.current;
+                if (!el)
+                    return false;
+                return el.stickyScroll ?? Boolean(el.attributes['stickyScroll']);
+            },
+            subscribe(listener) {
+                listenersRef.current.add(listener);
+                return () => listenersRef.current.delete(listener);
+            },
+            setClampBounds(min, max) {
+                const el = domRef.current;
+                if (!el)
+                    return;
+                el.scrollClampMin = min;
+                el.scrollClampMax = max;
+            }
+        };
+        handleRef.current = handle;
+        return handle;
+    }, 
     // notify/scrollMutated are inline (no useCallback) but only close over
     // refs + imports — stable. Empty deps avoids rebuilding the handle on
     // every render (which re-registers the ref = churn).
     // eslint-disable-next-line react-hooks/exhaustive-deps
     []);
+    // Position-routed wheel events (pointer over this box) scroll THIS box
+    // through the public scrollBy path — clamp bounds, sticky clearing, and
+    // subscriber notify all apply. Horizontal wheel (deltaX) has no renderer
+    // support yet (no scrollLeft in the DOM model) and is ignored.
+    const handleWheel = useCallback((e) => {
+        if (e.deltaY !== 0)
+            handleRef.current?.scrollBy(e.deltaY);
+    }, []);
     // Structure: outer viewport (overflow:scroll, constrained height) >
     // inner content (flexGrow:1, flexShrink:0 — fills at least the viewport
     // but grows beyond it for tall content). flexGrow:1 lets children use
@@ -159,7 +238,7 @@ function ScrollBox({ children, ref, stickyScroll, ...style }) {
                 // must reach React subscribers too — see dom.ts onStickyRestore.
                 el.onStickyRestore = notify;
             }
-        }, style: {
+        }, onWheel: handleWheel, style: {
             flexWrap: 'nowrap',
             flexDirection: style.flexDirection ?? 'row',
             flexGrow: style.flexGrow ?? 0,

package/lib/types/ink/constants.d.ts

@@ -1,3 +1,12 @@
 /** Shared frame interval for render throttling and animations (~60fps). */
 export declare const FRAME_INTERVAL_MS = 16;
+/**
+ * In-flight pty gate threshold (bytes) for scroll-drain frames — Grok
+ * Build's Presenter in_flight gate. While stdout holds more unflushed
+ * output than this, drain frames hold off instead of stacking latency
+ * into a slow ConPTY/ssh link. Sized above one full-screen diff (~4KB at
+ * 100 cols) so the gate only trips on genuine backlog, never on a single
+ * in-transit frame.
+ */
+export declare const PTY_BACKLOG_BYTES = 8192;
 //# sourceMappingURL=constants.d.ts.map

package/lib/types/ink/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/ink/constants.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,KAAK,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/ink/constants.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAA"}

package/lib/types/ink/constants.js

@@ -1,2 +1,11 @@
 /** Shared frame interval for render throttling and animations (~60fps). */
 export const FRAME_INTERVAL_MS = 16;
+/**
+ * In-flight pty gate threshold (bytes) for scroll-drain frames — Grok
+ * Build's Presenter in_flight gate. While stdout holds more unflushed
+ * output than this, drain frames hold off instead of stacking latency
+ * into a slow ConPTY/ssh link. Sized above one full-screen diff (~4KB at
+ * 100 cols) so the gate only trips on genuine backlog, never on a single
+ * in-transit frame.
+ */
+export const PTY_BACKLOG_BYTES = 8192;