@mobius-os/mobius 0.3.14 → 0.3.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobius-os/mobius",
-  "version": "0.3.14",
+  "version": "0.3.15",
   "type": "module",
   "description": "Mobius terminal client. Reuses Mobius frontend TypeScript types and jsonl entry shapes.",
   "bin": {

package/src/components/Chat.tsx

@@ -17,7 +17,7 @@ import type { ReadyState } from './PrepScreen.js'
 import type { AnyEntry } from '../types.js'
 import type { AimuxStatus } from '../aimux.js'
 import { AimuxStatusLine, aimuxStatusText } from './AimuxStatus.js'
-import { isEscapeKeypress } from './primitives.js'
+import { isEscapeKeypress, isMouseInput, useMouseWheel } from './primitives.js'
 
 interface ChatProps {
   client: MobiusClient
@@ -134,6 +134,22 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
     else if (key.pageDown) setScrollBack(value => Math.max(0, value - step))
   })
 
+  // Mouse wheel: up scrolls back through history, down returns toward the
+  // latest, mirroring PageUp/PageDown but in small fixed steps. Handled on the
+  // Ink event emitter (not useInput) so the sequence can be buffered across
+  // read() chunks; the Composer guards against inserting mouse bytes as text.
+  useMouseWheel((delta) => {
+    if (delta === 0) return
+    const step = 3
+    setScrollBack(value => Math.min(dedupedEntries.length, Math.max(0, value + delta * step)))
+  })
+
+  const olderHint = !showWelcome && (fitted.hiddenOlder > 0 || scrollBack > 0)
+    ? fitted.hiddenOlder > 0
+      ? `↑ 还有 ${fitted.hiddenOlder} 条较早记录 · 滚轮/PageUp 向上翻页`
+      : '已到最早记录 · 滚轮/PageDown 向下翻页'
+    : null
+
   return (
     <Box
       flexDirection="column"
@@ -147,16 +163,20 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
           ? <WelcomeCard ready={ready} columns={terminal.columns} resumed={Boolean(resumeSessionId)} modelDisplay={modelDisplay} />
           : <CompactHeader ready={ready} sessionId={chat.sessionId} columns={terminal.columns} />}
 
+        {/* Older-records hint is pinned OUTSIDE the flex-end scroll box so it is
+            always the first line of the transcript, spanning the full width,
+            instead of floating mid-screen when the transcript has spare rows. */}
+        {olderHint !== null
+          ? <Box width="100%" flexShrink={0}><Text dimColor>  {olderHint}</Text></Box>
+          : null}
+
         <Box flexGrow={1} flexShrink={1} flexDirection="column" justifyContent={showWelcome ? 'flex-start' : 'flex-end'} overflowY="hidden">
-          {fitted.hiddenOlder > 0 || scrollBack > 0
-            ? <Text dimColor>  ↑ {fitted.hiddenOlder > 0 ? `还有 ${fitted.hiddenOlder} 条较早记录 · PageUp 向上翻页` : '已到最早记录 · PageDown 向下翻页'}</Text>
-            : null}
           {fitted.entries.map((entry, index) => (
             <EntryAccum key={entry.__id ?? `entry-${fitted.startIndex + index}`} entry={entry} columns={terminal.columns} />
           ))}
           {chat.pendingUser !== null ? <UserLine text={chat.pendingUser} /> : null}
           {fitted.hiddenRecent > 0
-            ? <Text dimColor>  ↓ PageDown 向下翻页 · 较新 {fitted.hiddenRecent} 条</Text>
+            ? <Box width="100%" flexShrink={0}><Text dimColor>  ↓ 滚轮/PageDown 向下翻页 · 较新 {fitted.hiddenRecent} 条</Text></Box>
             : null}
         </Box>
 
@@ -599,6 +619,7 @@ export function Composer({ onSubmit, onStop, onQuit, typing, commands, onHeightC
   useEffect(() => () => resetPasteBurst(), [])
 
   useInput((input, key) => {
+    if (isMouseInput(input)) return // mouse events must never become typed text
     const now = Date.now()
     const escape = isEscapeKeypress(input, key)
     if (typing && escape) { void onStop(); return }

package/src/components/primitives.tsx

@@ -3,13 +3,96 @@
  * Select (single-choice list + multi-choice with checkboxes), and a Spinner.
  */
 import React, { useEffect, useRef, useState } from 'react'
-import { Box, Text, useInput, useStdout } from 'ink'
+import { Box, Text, useInput, useStdout, useStdin } from 'ink'
 
 /** Windows Terminal/ConPTY may expose Esc as a named key, a raw byte, or Ctrl+[. */
 export function isEscapeKeypress(input: string, key: { escape?: boolean; ctrl?: boolean }): boolean {
   return key.escape === true || input === '\x1b' || (key.ctrl === true && input === '[')
 }
 
+// ─── Mouse wheel ─────────────────────────────────────────────────────────────
+// Terminals report wheel events only after DECSET 1000 (button-event) + 1006
+// (SGR coordinates) are enabled. A wheel tick arrives as a mouse sequence:
+//   wheel up   → ESC [ < 64 ; x ; y M   (SGR, the modern encoding)
+//   wheel down → ESC [ < 65 ; x ; y M
+// Legacy X10 (no SGR support) reports ESC [ M Cb Cx Cy with Cb = button + 32,
+// so wheel up is 0x60 (`) and wheel down is 0x61 (a). There is no release event
+// for the wheel in either form. Button 64/65 map to a delta of +1/-1 so the
+// transcript pager can scroll back/forward by a fixed step.
+const SGR_MOUSE_RE = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g
+const LEGACY_MOUSE_RE = /\x1b\[M([\s\S]{3})/g
+
+/**
+ * True when `input` (a chunk Ink forwarded to useInput handlers) begins with a
+ * mouse event. Ink strips a leading ESC before passing `input`, so both the raw
+ * and stripped forms are accepted. Guards must be added to any handler that
+ * would otherwise treat a mouse event as typed text.
+ */
+export function isMouseInput(input: string): boolean {
+  return /^\x1b?\[<\d+;\d+;\d+[Mm]/.test(input) || /^\x1b?\[M/.test(input)
+}
+
+/** Extract the wheel delta from a chunk: +1 wheel-up, -1 wheel-down, else 0. */
+export function mouseWheelDelta(input: string): number {
+  SGR_MOUSE_RE.lastIndex = 0
+  let delta = 0
+  let m: RegExpExecArray | null
+  while ((m = SGR_MOUSE_RE.exec(input)) !== null) {
+    const btn = Number(m[1])
+    if (btn === 64) delta++
+    else if (btn === 65) delta--
+  }
+  LEGACY_MOUSE_RE.lastIndex = 0
+  let lm: RegExpExecArray | null
+  while ((lm = LEGACY_MOUSE_RE.exec(input)) !== null) {
+    const btn = lm[1].charCodeAt(0) - 32 // X10 adds a 32 offset to the button
+    if (btn === 64) delta++
+    else if (btn === 65) delta--
+  }
+  return delta
+}
+
+/**
+ * Enables terminal mouse tracking for the lifetime of the calling component and
+ * forwards wheel deltas to `onWheel`. Mouse events reach the rest of Ink as raw
+ * input chunks, so any text-inserting useInput handler must guard with
+ * `isMouseInput(input)`.
+ *
+ * The DECSET enable/disable sequences are only written when stdout is a TTY
+ * (writing them into a pipe would litter the output). The emitter listener is
+ * attached unconditionally so the harness can simulate wheel events.
+ */
+export function useMouseWheel(onWheel: (delta: number) => void): void {
+  const { internal_eventEmitter } = useStdin()
+  const { stdout } = useStdout()
+  const cbRef = useRef(onWheel)
+  cbRef.current = onWheel
+
+  useEffect(() => {
+    if (!internal_eventEmitter) return
+    const isTTY = Boolean(stdout.isTTY)
+    if (isTTY) stdout.write('\x1b[?1000h\x1b[?1006h')
+    let buf = ''
+    const handler = (chunk: unknown) => {
+      // A single read() chunk may carry several wheel ticks (fast scrolling) and
+      // an SGR sequence may be split across chunks, so accumulate and re-scan.
+      buf += String(chunk)
+      const delta = mouseWheelDelta(buf)
+      // Drop the fully-matched sequences, keeping any trailing partial escape
+      // prefix so a split sequence still matches on the next chunk.
+      buf = buf.replace(SGR_MOUSE_RE, '').replace(LEGACY_MOUSE_RE, '')
+      const esc = buf.lastIndexOf('\x1b')
+      buf = esc >= 0 ? buf.slice(esc) : ''
+      if (delta !== 0) cbRef.current(delta)
+    }
+    internal_eventEmitter.on('input', handler)
+    return () => {
+      internal_eventEmitter.off('input', handler)
+      if (isTTY) stdout.write('\x1b[?1000l\x1b[?1006l')
+    }
+  }, [internal_eventEmitter, stdout])
+}
+
 // ─── TextInput ───────────────────────────────────────────────────────────────
 export interface TextInputProps {
   value: string
@@ -48,6 +131,7 @@ export function TextInput(props: TextInputProps) {
   }
 
   useInput((input, key) => {
+    if (isMouseInput(input)) return
     if (key.return) { props.onSubmit?.(); return }
     if (key.upArrow) { props.onArrowUp?.(); return }
     if (key.downArrow) { props.onArrowDown?.(); return }
@@ -172,6 +256,7 @@ export function Select(props: SelectProps) {
 
   useInput((input, key) => {
     if (!items.length) return
+    if (isMouseInput(input)) return
     if (key.upArrow) { setActive(a => (a - 1 + items.length) % items.length); return }
     if (key.downArrow) { setActive(a => (a + 1) % items.length); return }
     if (mode === 'single') {