legion-tty 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20065c242e16ca4262309393cdad733b473f139c1efd288512ffe9d704fb5b69
-  data.tar.gz: 1159cc15d4545b6dbda4d9a69087a9f9a929c6579fd477c1ae0a27d12dbf95c5
+  metadata.gz: c79bfc84ae3c3bc48ae055db72296b3aec2ab24c9a86dba5d7604e5732a3503e
+  data.tar.gz: 96cb9a58135228887222a4fcc6064209ae1e825fad949c0cbd143c40c5249ed7
 SHA512:
-  metadata.gz: 77d12618eb36e18a62e3c0fbfa973f645155a4611771982d596b03803a1c98e3e4b592f3b40699842cd23f977ecb86518c1cdd3a26a4e58db936f0f45ba6137c
-  data.tar.gz: 4b8f2551be051f7140c851f9cac8a632430a102eda8f0ca78a5b1750fb0f2c266fc903fafd6e01606c5a2222986ab1cab3539003d41120bfac8a2762957de329
+  metadata.gz: ea7ed87c3baffa35d8e02852ce301c532e0aef8deab17a40892db373abd7f82ac49ae60f22a88e4ea66e90f3d56996db0850cef8e8e09ffd743f8e0a924ff0e3
+  data.tar.gz: dd2e68abefc811eface7a9db9c7c2014bccf433d7b859b42068746fc952afdbcc4470ec41e761a0d86df40236bb2aebeb334afddcbe278be06fe9acb78f6715f

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.5.1] - 2026-04-18
+
+### Fixed
+- **Alternate screen buffer** — `App#run_loop` now enables `\e[?1049h` on startup and `\e[?1049l` on shutdown so the TUI no longer pollutes shell scrollback and the prior shell session is restored on exit (closes #20)
+- **Mouse wheel scroll** — enabled SGR mouse tracking (`\e[?1000h` + `\e[?1006h`) and routed wheel-up/wheel-down events to `MessageStream#scroll_up` / `#scroll_down` with 3-line increments (closes #20)
+- **Vim-style scroll bindings** — added `Ctrl+B` (half-page up) and `Ctrl+F` (half-page down) on the Chat screen; wired `Home` / `End` to jump-to-top / jump-to-bottom when the input bar is empty (closes #20)
+- **Scroll hint in status bar** — `scroll_segment` now shows directional arrows (`↑↓ scroll` or `↑ scroll`) alongside the position counter when content overflows the viewport (closes #20)
+- **Help text updated** — added scroll binding reference line to the help overlay
+
 ## [0.5.0] - 2026-04-17
 
 ### Added

data/lib/legion/tty/app.rb

@@ -30,11 +30,18 @@ module Legion
         "\e[1~" => :home, "\e[4~" => :end,
         "\x7f" => :backspace, "\b" => :backspace, "\t" => :tab,
         "\x03" => :ctrl_c, "\x04" => :ctrl_d,
-        "\x01" => :ctrl_a, "\x05" => :ctrl_e,
+        "\x01" => :ctrl_a, "\x02" => :ctrl_b,
+        "\x05" => :ctrl_e, "\x06" => :ctrl_f,
         "\x0B" => :ctrl_k, "\x0C" => :ctrl_l, "\x13" => :ctrl_s,
         "\x15" => :ctrl_u
       }.freeze
 
+      ENABLE_ALT_SCREEN = "\e[?1049h"
+      DISABLE_ALT_SCREEN = "\e[?1049l"
+      ENABLE_MOUSE = "\e[?1000h\e[?1006h"
+      DISABLE_MOUSE = "\e[?1000h\e[?1006l"
+      SGR_MOUSE_RE = /\A\e\[<(\d+);(\d+);(\d+)([Mm])\z/
+
       attr_reader :config, :credentials, :screen_manager, :hotkeys, :llm_chat, :input_bar
 
       def self.run(argv = [])
@@ -157,6 +164,8 @@ module Legion
 
         @running = true
         @raw_mode = true
+        $stdout.print ENABLE_ALT_SCREEN
+        $stdout.print ENABLE_MOUSE
         $stdout.print cursor.hide
         $stdout.print cursor.clear_screen
 
@@ -175,9 +184,9 @@ module Legion
         nil
       ensure
         @raw_mode = false
+        $stdout.print DISABLE_MOUSE
         $stdout.print cursor.show
-        $stdout.print cursor.move_to(0, terminal_height - 1)
-        $stdout.puts
+        $stdout.print DISABLE_ALT_SCREEN
         shutdown
       end
       # rubocop:enable Metrics/AbcSize
@@ -188,6 +197,9 @@ module Legion
       end
 
       def normalize_key(raw)
+        mouse = parse_sgr_mouse(raw)
+        return mouse if mouse
+
         KEY_MAP[raw] || raw
       end
 
@@ -213,6 +225,11 @@ module Legion
         active = @screen_manager.active_screen
         return unless active
 
+        if %i[scroll_up scroll_down].include?(key)
+          dispatch_to_screen(active, key)
+          return
+        end
+
         if active.respond_to?(:needs_input_bar?) && active.needs_input_bar? && @input_bar
           dispatch_to_input_screen(active, key)
         else
@@ -297,6 +314,17 @@ module Legion
         seq
       end
 
+      def parse_sgr_mouse(raw)
+        match = SGR_MOUSE_RE.match(raw)
+        return nil unless match
+
+        button = match[1].to_i
+        return :scroll_up if button == 64
+        return :scroll_down if button == 65
+
+        nil
+      end
+
       # --- Rendering ---
 
       # rubocop:disable Metrics/AbcSize

data/lib/legion/tty/components/input_bar.rb

@@ -49,10 +49,20 @@ module Legion
           when :left
             @cursor_pos = [@cursor_pos - 1, 0].max
             :handled
-          when :home, :ctrl_a
+          when :home
+            return :pass if @buffer.empty?
+
+            @cursor_pos = 0
+            :handled
+          when :ctrl_a
             @cursor_pos = 0
             :handled
-          when :end, :ctrl_e
+          when :end
+            return :pass if @buffer.empty?
+
+            @cursor_pos = @buffer.length
+            :handled
+          when :ctrl_e
             @cursor_pos = @buffer.length
             :handled
           when :ctrl_u

data/lib/legion/tty/components/status_bar.rb

@@ -122,7 +122,8 @@ module Legion
           scroll = @state[:scroll]
           return nil unless scroll.is_a?(Hash) && scroll[:total].to_i > scroll[:visible].to_i
 
-          Theme.c(:muted, "#{scroll[:current]}/#{scroll[:total]}")
+          hint = scroll[:current].to_i.positive? ? "\u2191\u2193 scroll" : "\u2191 scroll"
+          Theme.c(:muted, "#{scroll[:current]}/#{scroll[:total]} #{hint}")
         end
 
         def level_to_priority(level)

data/lib/legion/tty/screens/chat/ui_commands.rb

@@ -36,7 +36,8 @@ module Legion
             'TOOLS   : /tools /export /bookmark /pin /pins /alias /snippet /history',
             'UTILS   : /calc /rand',
             '',
-            'Hotkeys: Ctrl+D=dashboard  Ctrl+K=palette  Ctrl+S=sessions  Esc=back'
+            'Hotkeys: Ctrl+D=dashboard  Ctrl+K=palette  Ctrl+S=sessions  Esc=back',
+            'Scroll : Mouse wheel  PgUp/PgDn  Ctrl+B/F (half-page)  Home/End (top/bottom)'
           ].freeze
 
           CALC_SAFE_PATTERN = %r{\A[\d\s+\-*/.()%]*\z}

data/lib/legion/tty/screens/chat.rb

@@ -200,20 +200,33 @@ module Legion
         end
 
         def handle_input(key)
+          scroll = handle_scroll_key(key)
+          return scroll if scroll
+
+          :pass
+        end
+
+        def handle_scroll_key(key)
           case key
-          when :page_up
-            @message_stream.scroll_up(10)
-            :handled
-          when :page_down
-            @message_stream.scroll_down(10)
-            :handled
-          else
-            :pass
+          when :page_up      then @message_stream.scroll_up(10)
+          when :page_down    then @message_stream.scroll_down(10)
+          when :scroll_up    then @message_stream.scroll_up(3)
+          when :scroll_down  then @message_stream.scroll_down(3)
+          when :ctrl_b       then @message_stream.scroll_up(half_page_lines)
+          when :ctrl_f       then @message_stream.scroll_down(half_page_lines)
+          when :home         then @message_stream.scroll_up(@message_stream.messages.size * 5)
+          when :end          then @message_stream.scroll_down(@message_stream.scroll_offset)
+          else return nil
           end
+          :handled
         end
 
         private
 
+        def half_page_lines
+          [(terminal_height - 3) / 2, 1].max
+        end
+
         def render_focus(width, height)
           stream_lines = @message_stream.render(width: width, height: [height, 1].max)
           @status_bar.update(scroll: @message_stream.scroll_position)

data/lib/legion/tty/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module TTY
-    VERSION = '0.5.0'
+    VERSION = '0.5.1'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-tty
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Esity