@deepseek-harness-tui/dsh-tui 0.8.7 → 0.9.0

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;

package/lib/types/ink/events/click-event.d.ts

@@ -1,25 +1,16 @@
-import { Event } from './event.js';
+import { PointerEvent, type PointerEventInit } from './pointer-event.js';
 /**
  * Mouse click event. Fired on left-button release without drag, only when
  * mouse tracking is enabled (i.e. inside <AlternateScreen>).
  *
  * Bubbles from the deepest hit node up through parentNode. Call
  * stopImmediatePropagation() to prevent ancestors' onClick from firing.
+ *
+ * Extends PointerEvent: `shift`/`alt`/`ctrl` expose the modifiers the
+ * terminal reported on the release, and `localCol`/`localRow` are recomputed
+ * per handler so containers see coordinates relative to themselves.
  */
-export declare class ClickEvent extends Event {
-    /** 0-indexed screen column of the click */
-    readonly col: number;
-    /** 0-indexed screen row of the click */
-    readonly row: number;
-    /**
-     * Click column relative to the current handler's Box (col - box.x).
-     * Recomputed by dispatchClick before each handler fires, so an onClick
-     * on a container sees coords relative to that container, not to any
-     * child the click landed on.
-     */
-    localCol: number;
-    /** Click row relative to the current handler's Box (row - box.y). */
-    localRow: number;
+export declare class ClickEvent extends PointerEvent {
     /**
      * True if the clicked cell has no visible content (unwritten in the
      * screen buffer — both packed words are 0). Handlers can check this to
@@ -27,6 +18,6 @@ export declare class ClickEvent extends Event {
      * clicks on empty terminal space don't toggle state.
      */
     readonly cellIsBlank: boolean;
-    constructor(col: number, row: number, cellIsBlank: boolean);
+    constructor(col: number, row: number, cellIsBlank: boolean, init?: PointerEventInit);
 }
 //# sourceMappingURL=click-event.d.ts.map

package/lib/types/ink/events/click-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"click-event.d.ts","sourceRoot":"","sources":["../../../../src/ink/events/click-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,SAAI;IACZ,qEAAqE;IACrE,QAAQ,SAAI;IACZ;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;gBAEjB,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO;CAM3D"}
+{"version":3,"file":"click-event.d.ts","sourceRoot":"","sources":["../../../../src/ink/events/click-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAExE;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;gBAG3B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,OAAO,EACpB,IAAI,CAAC,EAAE,gBAAgB;CAa1B"}

package/lib/types/ink/events/click-event.js

@@ -1,25 +1,16 @@
-import { Event } from './event.js';
+import { PointerEvent } from './pointer-event.js';
 /**
  * Mouse click event. Fired on left-button release without drag, only when
  * mouse tracking is enabled (i.e. inside <AlternateScreen>).
  *
  * Bubbles from the deepest hit node up through parentNode. Call
  * stopImmediatePropagation() to prevent ancestors' onClick from firing.
+ *
+ * Extends PointerEvent: `shift`/`alt`/`ctrl` expose the modifiers the
+ * terminal reported on the release, and `localCol`/`localRow` are recomputed
+ * per handler so containers see coordinates relative to themselves.
  */
-export class ClickEvent extends Event {
-    /** 0-indexed screen column of the click */
-    col;
-    /** 0-indexed screen row of the click */
-    row;
-    /**
-     * Click column relative to the current handler's Box (col - box.x).
-     * Recomputed by dispatchClick before each handler fires, so an onClick
-     * on a container sees coords relative to that container, not to any
-     * child the click landed on.
-     */
-    localCol = 0;
-    /** Click row relative to the current handler's Box (row - box.y). */
-    localRow = 0;
+export class ClickEvent extends PointerEvent {
     /**
      * True if the clicked cell has no visible content (unwritten in the
      * screen buffer — both packed words are 0). Handlers can check this to
@@ -27,10 +18,16 @@ export class ClickEvent extends Event {
      * clicks on empty terminal space don't toggle state.
      */
     cellIsBlank;
-    constructor(col, row, cellIsBlank) {
-        super();
-        this.col = col;
-        this.row = row;
+    constructor(col, row, cellIsBlank, init) {
+        // A click is by definition a left-button release without drag. Normalize
+        // the low button bits to 0 (left) while preserving modifier bits
+        // (0x04 shift / 0x08 alt / 0x10 ctrl) from the release byte.
+        const button = init?.button ?? 0;
+        super('click', col, row, {
+            ...init,
+            action: 'release',
+            button: button & ~0x03,
+        });
         this.cellIsBlank = cellIsBlank;
     }
 }

package/lib/types/ink/events/event-handlers.d.ts

@@ -2,13 +2,22 @@ import type { ClickEvent } from './click-event.js';
 import type { FocusEvent } from './focus-event.js';
 import type { KeyboardEvent } from './keyboard-event.js';
 import type { PasteEvent } from './paste-event.js';
+import type { PointerEvent } from './pointer-event.js';
 import type { ResizeEvent } from './resize-event.js';
+import type { WheelEvent } from './wheel-event.js';
 type KeyboardEventHandler = (event: KeyboardEvent) => void;
 type FocusEventHandler = (event: FocusEvent) => void;
 type PasteEventHandler = (event: PasteEvent) => void;
 type ResizeEventHandler = (event: ResizeEvent) => void;
 type ClickEventHandler = (event: ClickEvent) => void;
-type HoverEventHandler = () => void;
+/**
+ * Hover handlers receive the pointer position. Existing `() => void`
+ * handlers remain assignable (a function taking fewer parameters is
+ * assignable to one taking more), so this widening is fully backwards
+ * compatible.
+ */
+type HoverEventHandler = (event: PointerEvent) => void;
+type WheelEventHandler = (event: WheelEvent) => void;
 /**
  * Props for event handlers on Box and other host components.
  *
@@ -29,6 +38,7 @@ export type EventHandlerProps = {
     onClick?: ClickEventHandler;
     onMouseEnter?: HoverEventHandler;
     onMouseLeave?: HoverEventHandler;
+    onWheel?: WheelEventHandler;
 };
 /**
  * Reverse lookup: event type string → handler prop names.

package/lib/types/ink/events/event-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-handlers.d.ts","sourceRoot":"","sources":["../../../../src/ink/events/event-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;AAC1D,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;AACpD,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;AACpD,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;AACtD,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;AACpD,KAAK,iBAAiB,GAAG,MAAM,IAAI,CAAA;AAEnC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,oBAAoB,CAAA;IAChC,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;IAEvC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAClC,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,aAAa,CAAC,EAAE,iBAAiB,CAAA;IAEjC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAElC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAE7B,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAChC,YAAY,CAAC,EAAE,iBAAiB,CAAA;CACjC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACpC,MAAM,EACN;IAAE,MAAM,CAAC,EAAE,MAAM,iBAAiB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,iBAAiB,CAAA;CAAE,CAQxE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAa9B,CAAA"}
+{"version":3,"file":"event-handlers.d.ts","sourceRoot":"","sources":["../../../../src/ink/events/event-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;AAC1D,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;AACpD,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;AACpD,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;AACtD,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;AACpD;;;;;GAKG;AACH,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;AACtD,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,oBAAoB,CAAA;IAChC,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;IAEvC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAClC,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,aAAa,CAAC,EAAE,iBAAiB,CAAA;IAEjC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAElC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAE7B,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAChC,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAChC,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACpC,MAAM,EACN;IAAE,MAAM,CAAC,EAAE,MAAM,iBAAiB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,iBAAiB,CAAA;CAAE,CASxE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAc9B,CAAA"}

package/lib/types/ink/events/event-handlers.js

@@ -9,6 +9,7 @@ export const HANDLER_FOR_EVENT = {
     paste: { bubble: 'onPaste', capture: 'onPasteCapture' },
     resize: { bubble: 'onResize' },
     click: { bubble: 'onClick' },
+    wheel: { bubble: 'onWheel' },
 };
 /**
  * Set of all event handler prop names, for the reconciler to detect
@@ -27,4 +28,5 @@ export const EVENT_HANDLER_PROPS = new Set([
     'onClick',
     'onMouseEnter',
     'onMouseLeave',
+    'onWheel',
 ]);

package/lib/types/ink/events/input-event.d.ts

@@ -13,6 +13,8 @@ export type Key = {
     pageUp: boolean;
     wheelUp: boolean;
     wheelDown: boolean;
+    wheelLeft: boolean;
+    wheelRight: boolean;
     home: boolean;
     end: boolean;
     return: boolean;
@@ -25,6 +27,13 @@ export type Key = {
     delete: boolean;
     meta: boolean;
     super: boolean;
+    /**
+     * Pointer column (0-indexed) when the key is a wheel event — the SGR/X10
+     * sequence carries the position. Undefined for non-wheel keys.
+     */
+    mouseCol?: number;
+    /** Pointer row (0-indexed) when the key is a wheel event. See mouseCol. */
+    mouseRow?: number;
 };
 /**
  * Event fired for each input chunk received from stdin (a typed character or

package/lib/types/ink/events/input-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-event.d.ts","sourceRoot":"","sources":["../../../../src/ink/events/input-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC;;;GAGG;AACH,MAAM,MAAM,GAAG,GAAG;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd,EAAE,EAAE,OAAO,CAAA;IACX,GAAG,EAAE,OAAO,CAAA;IACZ,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAuKD;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IAEjB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;wBAGoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;gBAEd,QAAQ,EAAE,SAAS;CAShC"}
+{"version":3,"file":"input-event.d.ts","sourceRoot":"","sources":["../../../../src/ink/events/input-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC;;;GAGG;AACH,MAAM,MAAM,GAAG,GAAG;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd,EAAE,EAAE,OAAO,CAAA;IACX,GAAG,EAAE,OAAO,CAAA;IACZ,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AA2KD;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IAEjB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;wBAGoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;gBAEd,QAAQ,EAAE,SAAS;CAShC"}

package/lib/types/ink/events/input-event.js

@@ -10,6 +10,8 @@ function parseKey(keypress) {
         pageUp: keypress.name === 'pageup',
         wheelUp: keypress.name === 'wheelup',
         wheelDown: keypress.name === 'wheeldown',
+        wheelLeft: keypress.name === 'wheelleft',
+        wheelRight: keypress.name === 'wheelright',
         home: keypress.name === 'home',
         end: keypress.name === 'end',
         return: keypress.name === 'return',
@@ -29,6 +31,8 @@ function parseKey(keypress) {
         // protocol CSI u sequences. Distinct from meta (Alt/Option) so
         // bindings like cmd+c can be expressed separately from opt+c.
         super: keypress.super,
+        mouseCol: keypress.mouseCol,
+        mouseRow: keypress.mouseRow,
     };
     let input = keypress.ctrl ? keypress.name : keypress.sequence;
     // Handle undefined input case

package/lib/types/ink/events/pointer-event.d.ts

@@ -0,0 +1,61 @@
+import { TerminalEvent, type EventTarget } from './terminal-event.js';
+/**
+ * Pointer action reported by the terminal protocol.
+ *
+ * - `press`: a button went down (SGR `M` terminator / X10 press)
+ * - `release`: a button came up (SGR `m` terminator; X10 cannot report this)
+ * - `move`: pointer motion (SGR drag bit or mode-1003 no-button motion)
+ */
+export type PointerAction = 'press' | 'release' | 'move';
+/** Optional state when constructing a {@link PointerEvent}. */
+export type PointerEventInit = {
+    /** Raw protocol button byte (SGR bits: 0x04 shift, 0x08 alt, 0x10 ctrl). */
+    button?: number;
+    action?: PointerAction;
+    bubbles?: boolean;
+    cancelable?: boolean;
+};
+/**
+ * Base class for pointer-derived terminal events (click, wheel, hover).
+ *
+ * Carries the raw SGR/X10 button byte so handlers can read modifier flags
+ * (`shift`/`alt`/`ctrl`) without re-parsing the escape sequence, plus
+ * per-handler local coordinates: `_prepareForTarget` recomputes
+ * `localCol`/`localRow` from the nodeCache rect before each handler fires,
+ * so an onClick on a container sees coordinates relative to that container,
+ * not to the child the pointer actually landed on.
+ *
+ * `meta` is deliberately always false: xterm.js drops metaKey before SGR
+ * encoding (the SGR bit we call "meta" is wired to alt), so no pointer
+ * protocol can distinguish it reliably.
+ */
+export declare class PointerEvent extends TerminalEvent {
+    /** 0-indexed screen column of the pointer. */
+    readonly col: number;
+    /** 0-indexed screen row of the pointer. */
+    readonly row: number;
+    /** Raw protocol button byte (SGR encoding). */
+    readonly button: number;
+    /** Which pointer action produced this event. */
+    readonly action: PointerAction;
+    /** Shift held (SGR button bit 0x04). */
+    readonly shift: boolean;
+    /** Alt/Option held (SGR button bit 0x08). */
+    readonly alt: boolean;
+    /** Ctrl held (SGR button bit 0x10). */
+    readonly ctrl: boolean;
+    /** Always false — see class doc. */
+    readonly meta = false;
+    /** Column relative to the current handler's node (set during dispatch). */
+    localCol: number;
+    /** Row relative to the current handler's node (set during dispatch). */
+    localRow: number;
+    constructor(type: string, col: number, row: number, init?: PointerEventInit);
+    /**
+     * Refresh localCol/localRow for the node whose handler is about to run.
+     * Nodes without a cached rect (not rendered this frame) get 0,0 — handlers
+     * should prefer absolute col/row when that distinction matters.
+     */
+    _prepareForTarget(target: EventTarget): void;
+}
+//# sourceMappingURL=pointer-event.d.ts.map

package/lib/types/ink/events/pointer-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-event.d.ts","sourceRoot":"","sources":["../../../../src/ink/events/pointer-event.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAErE;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAExD,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,SAAQ;IACrB,2EAA2E;IAC3E,QAAQ,SAAI;IACZ,wEAAwE;IACxE,QAAQ,SAAI;gBAEA,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB;IAc3E;;;;OAIG;IACM,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CAKtD"}