legion-tty 0.5.0 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20065c242e16ca4262309393cdad733b473f139c1efd288512ffe9d704fb5b69
-  data.tar.gz: 1159cc15d4545b6dbda4d9a69087a9f9a929c6579fd477c1ae0a27d12dbf95c5
+  metadata.gz: 7e484905e47a82bedca53b308ff66880c8b64bcb320d9af6a1130fe4ad50a056
+  data.tar.gz: f5c49491e1227c5984e99f161662eef56a5d5924903666aa2ea9dcaecccf098f
 SHA512:
-  metadata.gz: 77d12618eb36e18a62e3c0fbfa973f645155a4611771982d596b03803a1c98e3e4b592f3b40699842cd23f977ecb86518c1cdd3a26a4e58db936f0f45ba6137c
-  data.tar.gz: 4b8f2551be051f7140c851f9cac8a632430a102eda8f0ca78a5b1750fb0f2c266fc903fafd6e01606c5a2222986ab1cab3539003d41120bfac8a2762957de329
+  metadata.gz: f2eb92406a0f61f109213eec5858122038e270052cdca8c9c4f3bfcfba7d64d0ead54a1f40b53dd356aa08dc172f920a09f47c46dd108c15a708e2a680ffe474
+  data.tar.gz: e107d25bbb2ce75ce886329f8ef02f2fb5991278c5a4d140cc809d940adf34aba9f14a9c4269309be847ae78c78d48ee4d33540d03bfc71712d4b4261ae7a080

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.5.2] - 2026-04-20
+
+### Fixed
+- **Bracketed paste support** — `App#run_loop` now enables bracketed paste mode (`\e[?2004h`) on startup and disables (`\e[?2004l`) on shutdown; `read_csi_sequence` detects `\e[200~` / `\e[201~` paste markers and buffers the full pasted text into a `{ paste: text }` event (closes #22)
+- **InputBar paste handling** — `handle_key` recognizes paste Hash events and inserts the full pasted text at the cursor position, replacing newlines with spaces, without triggering submit (closes #22)
+- **Non-symbol key guard** — `dispatch_key` checks `key.is_a?(Symbol)` before the scroll-event include check, preventing `NoMethodError` on Hash paste events (closes #22)
+- **`normalize_key` paste passthrough** — Hash events (paste) pass through without KEY_MAP lookup (closes #22)
+
+## [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,20 @@ 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"
+      ENABLE_BRACKETED_PASTE = "\e[?2004h"
+      DISABLE_BRACKETED_PASTE = "\e[?2004l"
+      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 = [])
@@ -151,12 +160,15 @@ module Legion
 
       # --- Event Loop ---
 
-      # rubocop:disable Metrics/AbcSize
+      # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
       def run_loop
         require 'io/console'
 
         @running = true
         @raw_mode = true
+        $stdout.print ENABLE_ALT_SCREEN
+        $stdout.print ENABLE_MOUSE
+        $stdout.print ENABLE_BRACKETED_PASTE
         $stdout.print cursor.hide
         $stdout.print cursor.clear_screen
 
@@ -169,30 +181,47 @@ module Legion
 
             key = normalize_key(raw_key)
             dispatch_key(key)
+            drain_burst_keys(raw_in)
           end
         end
       rescue Interrupt
         nil
       ensure
         @raw_mode = false
+        $stdout.print DISABLE_BRACKETED_PASTE
+        $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
+      # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
 
       def needs_refresh?
         active = @screen_manager.active_screen
         active.respond_to?(:streaming?) && active.streaming?
       end
 
+      def drain_burst_keys(raw_in)
+        while @running && raw_in.wait_readable(0)
+          burst_key = read_raw_key(raw_in, timeout: 0)
+          break unless burst_key
+
+          dispatch_key(normalize_key(burst_key))
+        end
+      end
+
       def normalize_key(raw)
+        return raw if raw.is_a?(Hash)
+
+        mouse = parse_sgr_mouse(raw)
+        return mouse if mouse
+
         KEY_MAP[raw] || raw
       end
 
       # --- Key Dispatch ---
 
+      # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
       def dispatch_key(key)
         if key == :ctrl_c
           @running = false
@@ -213,12 +242,18 @@ module Legion
         active = @screen_manager.active_screen
         return unless active
 
+        if key.is_a?(Symbol) && %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
           dispatch_to_screen(active, key)
         end
       end
+      # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity
 
       def dispatch_to_input_screen(screen, key)
         result = @input_bar.handle_key(key)
@@ -294,9 +329,39 @@ module Legion
           seq << c
           break if c.ord.between?(0x40, 0x7E)
         end
+
+        return read_paste_content(io) if seq == "\e[200~"
+
         seq
       end
 
+      def read_paste_content(io)
+        buf = +''
+        end_marker = "\e[201~"
+        loop do
+          break unless io.wait_readable(1)
+
+          c = io.getc
+          break unless c
+
+          buf << c
+          break if buf.end_with?(end_marker)
+        end
+        buf.delete_suffix!(end_marker)
+        { paste: buf }
+      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

@@ -32,6 +32,8 @@ module Legion
 
         # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
         def handle_key(key)
+          return handle_paste(key[:paste]) if key.is_a?(Hash) && key.key?(:paste)
+
           case key
           when :enter
             submit_line
@@ -49,10 +51,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
@@ -192,6 +204,14 @@ module Legion
           :handled
         end
 
+        def handle_paste(text)
+          sanitized = text.to_s.gsub(/\r\n?/, "\n").gsub("\n", ' ')
+          @buffer.insert(@cursor_pos, sanitized)
+          @cursor_pos += sanitized.length
+          @tab_matches = []
+          :handled
+        end
+
         def insert_char(key)
           return :pass unless key.is_a?(String) && key.length == 1 && key.ord >= 32
 

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.2'
   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.2
 platform: ruby
 authors:
 - Esity