sergeant 1.0.10 → 1.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 41cc1fef750cecd3e0a9a530976e8818955bc0db86a434319420dbe250496405
-  data.tar.gz: 60db0f330203e559828d1cc87f701af503d174a6577bc351bfcc2fce2dc88752
+  metadata.gz: 37a2b99f4864cf2d4d4b4cffc4eb62a3c89a28216833084ad587bafd8b49c773
+  data.tar.gz: 2ddb28f7922812df52333b8bd49eef9dbec5c1e91c6d2523a72b3857fd7f9c4c
 SHA512:
-  metadata.gz: 1b14250ce188e25a4c709b94ffcf16a88d57f4ceb715c737feaab66d1628fcbc041993ffc9e71c2e6496670e1f78846464932a804f392619608896f059aaf62f
-  data.tar.gz: 696600fa8dbf40b884949ca2cd1bb4ab16c21b5f1ec947fa77acb7593274638cbb54fb41be80a40ec820981e164ac9eeddf0643c6e9f52e0335b91ccd1c84b60
+  metadata.gz: b659a1fc589acc4ee89eadbae2c3095643e494ce8e5402fd4a7f118ba79fe132d17a44002187428ea5951dd5c9b2e5355868ae86947d38416b0e3d40e29d634e
+  data.tar.gz: 1145c08b4d59cb1a47da1e8e6b42d1802a74b9ade0c6918b2fd0e43754300a4dee4db43e19e866fa939a8bf59166d44a32b641263cf6adcb6dd0aba6a1638dc2

data/CHANGELOG.md

@@ -6,6 +6,15 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [1.0.11] - 2026-08-24
+
+### Added
+- **Resizable side preview panel** - `[` / `]` shrink/grow the preview panel in 5% steps (clamped 15%-60% of terminal width), instead of a fixed 35% ratio
+
+### Changed
+- **Help modal (`m`) now scrolls** - if the key mapping list doesn't fit the terminal height, it scrolls with `j`/`k`/arrows and shows a scrollbar, instead of silently cutting off the bottom of the list
+- Removed the `v` key - it was bound to the exact same "preview file" action as `Enter`/`→`/`l` on a file, so it was a pure duplicate with no functionality behind it
+
 ## [1.0.10] - 2026-08-24
 
 ### Fixed

data/README.md

@@ -231,7 +231,6 @@ cd $(sgt --pwd /usr/local)
 | `u` | Unmark all items |
 | `n` | Create new file or directory |
 | `e` | Edit file with $EDITOR (or nano/nvim/vim) |
-| `v` | Preview file or archive contents |
 
 ### Other Commands
 
@@ -246,6 +245,7 @@ cd $(sgt --pwd /usr/local)
 | `:` | Execute terminal command in current directory |
 | `o` | Toggle ownership/permissions display |
 | `P` | Toggle side preview panel |
+| `[` / `]` | Shrink / grow side preview panel |
 | `b` | Go to bookmark |
 | `H` | Show recent directories history |
 | `R` | Force refresh and clear cache |

data/lib/sergeant/modals/help.rb

@@ -5,113 +5,138 @@
 module Sergeant
   module Modals
     module Help
+      HELP_LINES = [
+        'Navigation:',
+        '  ↑/k               - Move up',
+        '  ↓/j               - Move down',
+        '  Enter / →/l       - Open directory or preview file',
+        '  ←/h               - Go back to parent directory',
+        '',
+        'File Operations:',
+        '  Space             - Mark/unmark item',
+        '  c                 - Copy marked items',
+        '  x                 - Cut marked items',
+        '  p                 - Paste copied/cut items',
+        '  d                 - Delete marked items',
+        '  r                 - Rename current item',
+        '  u                 - Unmark all items',
+        '  n                 - Create new file or directory',
+        '',
+        'View & Search:',
+        '  e                 - Edit file ($EDITOR, nano, nvim, vim)',
+        '  f                 - Filter current directory view',
+        '  /                 - Search files (with fzf if available)',
+        '',
+        'Other:',
+        '  :                 - Execute terminal command',
+        '  o                 - Toggle ownership display',
+        '  P                 - Toggle side preview panel',
+        '  [ / ]             - Shrink/grow side preview panel',
+        '  b                 - Go to bookmark',
+        '  H                 - Show recent directories history',
+        '  R                 - Force refresh and clear cache',
+        '  q / ESC           - Quit and cd to current directory'
+      ].freeze
+
+      HELP_SECTION_HEADERS = ['Navigation:', 'File Operations:', 'View & Search:', 'Other:'].freeze
+
       def show_help_modal
         max_y = lines
         max_x = cols
 
-        help_lines = [
-          'Navigation:',
-          '  ↑/k               - Move up',
-          '  ↓/j               - Move down',
-          '  Enter / →/l       - Open directory or preview file',
-          '  ←/h               - Go back to parent directory',
-          '',
-          'File Operations:',
-          '  Space             - Mark/unmark item',
-          '  c                 - Copy marked items',
-          '  x                 - Cut marked items',
-          '  p                 - Paste copied/cut items',
-          '  d                 - Delete marked items',
-          '  r                 - Rename current item',
-          '  u                 - Unmark all items',
-          '  n                 - Create new file or directory',
-          '',
-          'View & Search:',
-          '  e                 - Edit file ($EDITOR, nano, nvim, vim)',
-          '  v                 - Preview file or archive contents',
-          '  f                 - Filter current directory view',
-          '  /                 - Search files (with fzf if available)',
-          '',
-          'Other:',
-          '  :                 - Execute terminal command',
-          '  o                 - Toggle ownership display',
-          '  P                 - Toggle side preview panel',
-          '  b                 - Go to bookmark',
-          '  H                 - Show recent directories history',
-          '  R                 - Force refresh and clear cache',
-          '  q / ESC           - Quit and cd to current directory'
-        ]
-
-        # Height must track the number of help lines - a fixed cap silently
-        # truncates the bottom of the list (including "quit"!) every time a
-        # new key mapping is added without also bumping the cap by hand.
-        modal_height = [help_lines.length + 4, max_y - 4].min
-        modal_width = [70, max_x - 4].min   # Adaptive width
-        modal_y = (max_y - modal_height) / 2
-        modal_x = (max_x - modal_width) / 2
-
-        (modal_y..(modal_y + modal_height)).each do |y|
-          setpos(y, modal_x)
-          attron(color_pair(3)) do
-            addstr(' ' * modal_width)
+        modal_height = [HELP_LINES.length + 4, max_y - 4].min
+        modal_width = [70, max_x - 4].min
+        geometry = {
+          y: (max_y - modal_height) / 2,
+          x: (max_x - modal_width) / 2,
+          width: modal_width,
+          height: modal_height
+        }
+        visible_rows = modal_height - 4
+        max_scroll = [HELP_LINES.length - visible_rows, 0].max
+        scroll_offset = 0
+
+        loop do
+          draw_help_frame(geometry)
+          draw_help_lines(geometry, visible_rows, scroll_offset)
+          draw_help_scrollbar(geometry, visible_rows, scroll_offset, max_scroll)
+
+          refresh
+
+          case getch
+          when Curses::Key::DOWN, 'j'
+            scroll_offset = [scroll_offset + 1, max_scroll].min
+          when Curses::Key::UP, 'k'
+            scroll_offset = [scroll_offset - 1, 0].max
+          else
+            break
           end
         end
+      end
 
-        setpos(modal_y, modal_x)
-        attron(color_pair(4) | Curses::A_BOLD) do
-          addstr("\u250C#{'─' * (modal_width - 2)}\u2510")
-        end
+      def draw_help_frame(geometry)
+        y = geometry[:y]
+        x = geometry[:x]
+        width = geometry[:width]
+        height = geometry[:height]
 
-        setpos(modal_y + 1, modal_x)
-        attron(color_pair(4) | Curses::A_BOLD) do
-          addstr('│')
-        end
-        attron(color_pair(5) | Curses::A_BOLD) do
-          addstr(' Key Mappings '.center(modal_width - 2))
-        end
-        attron(color_pair(4) | Curses::A_BOLD) do
-          addstr('│')
+        (y..(y + height)).each do |row|
+          setpos(row, x)
+          attron(color_pair(3)) { addstr(' ' * width) }
         end
 
-        setpos(modal_y + 2, modal_x)
-        attron(color_pair(4)) do
-          addstr("\u251C#{'─' * (modal_width - 2)}\u2524")
-        end
+        setpos(y, x)
+        attron(color_pair(4) | Curses::A_BOLD) { addstr("┌#{'─' * (width - 2)}┐") }
 
-        help_lines.each_with_index do |line, idx|
-          break if idx >= modal_height - 4  # Stop if we run out of vertical space
+        setpos(y + 1, x)
+        attron(color_pair(4) | Curses::A_BOLD) { addstr('│') }
+        attron(color_pair(5) | Curses::A_BOLD) { addstr(' Key Mappings '.center(width - 2)) }
+        attron(color_pair(4) | Curses::A_BOLD) { addstr('│') }
 
-          setpos(modal_y + 3 + idx, modal_x)
-          attron(color_pair(4)) do
-            addstr('│ ')
-          end
+        setpos(y + 2, x)
+        attron(color_pair(4)) { addstr("├#{'─' * (width - 2)}┤") }
 
-          # Truncate line if it's too long for the modal width
-          display_line = if line.length > modal_width - 4
-                          "#{line[0...(modal_width - 7)]}..."
-                         else
-                          line.ljust(modal_width - 4)
-                         end
-
-          if line.start_with?('Navigation:', 'File Operations:', 'Other:')
-            attron(color_pair(1) | Curses::A_BOLD) do
-              addstr(display_line)
-            end
-          else
-            addstr(display_line)
-          end
-          attron(color_pair(4)) do
-            addstr(' │')
-          end
+        setpos(y + height - 1, x)
+        attron(color_pair(4) | Curses::A_BOLD) { addstr("└#{'─' * (width - 2)}┘") }
+      end
+
+      def draw_help_lines(geometry, visible_rows, scroll_offset)
+        visible_rows.times do |row|
+          line = HELP_LINES[scroll_offset + row]
+
+          setpos(geometry[:y] + 3 + row, geometry[:x])
+          attron(color_pair(4)) { addstr('│ ') }
+          draw_help_line_text(line, geometry[:width])
+          attron(color_pair(4)) { addstr(' │') }
+        end
+      end
+
+      def draw_help_line_text(line, width)
+        unless line
+          addstr(''.ljust(width - 4))
+          return
         end
 
-        setpos(modal_y + modal_height - 1, modal_x)
-        attron(color_pair(4) | Curses::A_BOLD) do
-          addstr("\u2514#{'─' * (modal_width - 2)}\u2518")
+        display_line = if line.length > width - 4
+                         "#{line[0...(width - 7)]}..."
+                       else
+                         line.ljust(width - 4)
+                       end
+
+        if HELP_SECTION_HEADERS.include?(line)
+          attron(color_pair(1) | Curses::A_BOLD) { addstr(display_line) }
+        else
+          addstr(display_line)
         end
+      end
+
+      def draw_help_scrollbar(geometry, visible_rows, scroll_offset, max_scroll)
+        return unless max_scroll.positive?
+
+        scroll_pos = ((scroll_offset.to_f / max_scroll) * (visible_rows - 1)).round.clamp(0, visible_rows - 1)
 
-        refresh
-        getch
+        setpos(geometry[:y] + 3 + scroll_pos, geometry[:x] + geometry[:width] - 2)
+        attron(color_pair(4) | Curses::A_BOLD) { addstr('█') }
       end
     end
   end

data/lib/sergeant/rendering.rb

@@ -15,7 +15,10 @@ module Sergeant
     # both panes stay readable; below that it just doesn't fit.
     MIN_PREVIEW_TOTAL_WIDTH = 100
     MIN_PREVIEW_WIDTH = 24
-    PREVIEW_WIDTH_RATIO = 0.35
+    PREVIEW_WIDTH_RATIO_DEFAULT = 0.35
+    PREVIEW_WIDTH_RATIO_MIN = 0.15
+    PREVIEW_WIDTH_RATIO_MAX = 0.6
+    PREVIEW_WIDTH_RATIO_STEP = 0.05
 
     # Maps file_category (Sergeant::Utils) to the color pair set up in
     # Sergeant#apply_color_theme (pairs 7-10).
@@ -50,7 +53,7 @@ module Sergeant
 
       preview_enabled = @show_preview && max_x >= MIN_PREVIEW_TOTAL_WIDTH
       if preview_enabled
-        preview_width = [(max_x * PREVIEW_WIDTH_RATIO).to_i, MIN_PREVIEW_WIDTH].max
+        preview_width = [(max_x * @preview_width_ratio).to_i, MIN_PREVIEW_WIDTH].max
         list_width = max_x - preview_width - 1
       else
         preview_width = 0

data/lib/sergeant/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sergeant
-  VERSION = '1.0.10'
+  VERSION = '1.0.11'
 end

data/lib/sergeant.rb

@@ -46,6 +46,7 @@ class SergeantApp
 
     # Side preview panel
     @show_preview = true
+    @preview_width_ratio = Sergeant::Rendering::PREVIEW_WIDTH_RATIO_DEFAULT
     @last_preview_path = :unset
     @preview_kind = :empty
     @preview_item = nil
@@ -111,10 +112,14 @@ class SergeantApp
         when 'P'
           @show_preview = !@show_preview
           @last_preview_path = :unset
+        when '['
+          step = Sergeant::Rendering::PREVIEW_WIDTH_RATIO_STEP
+          @preview_width_ratio = [@preview_width_ratio - step, Sergeant::Rendering::PREVIEW_WIDTH_RATIO_MIN].max
+        when ']'
+          step = Sergeant::Rendering::PREVIEW_WIDTH_RATIO_STEP
+          @preview_width_ratio = [@preview_width_ratio + step, Sergeant::Rendering::PREVIEW_WIDTH_RATIO_MAX].min
         when 'e'
           edit_file
-        when 'v'
-          preview_file
         when 32, ' '
           toggle_mark
         when 'c'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sergeant
 version: !ruby/object:Gem::Version
-  version: 1.0.10
+  version: 1.0.11
 platform: ruby
 authors:
 - Mateusz Grotha