sight 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05abdb72bec3313b413b826f36a5f5a5590374d7d61640460a41eddd75a57ab6
-  data.tar.gz: 27d5fb5d877eebf0152ffa070201e2bb0755256cb466027bc3f61c26bccd4a16
+  metadata.gz: 24b700f118e81b323388d9dc1413bcb493a8c8625664099fcff2eeb524fbe4e7
+  data.tar.gz: c0b1e78505b39f82909607431c5c7cf27a56545292abb0967887f2a60be04420
 SHA512:
-  metadata.gz: 41a607fda53ab9822d968c8d2af280b71db14bb3edf96752dfd8ce26450277d44e19ad85f1677940506b75f80503f6511201291795d031d42aab10beb598bbe5
-  data.tar.gz: 254d6c49a5abb2ead9130daad53fc874523a282b1b69c50b9df0f015280ea7fb47ff8a099f3b21badd10b074c0b39941749c7b200f913a358a7e6635029954dd
+  metadata.gz: b3e9f75deef46a4da613023322b833f0bbf86c7f2cc5f3ccde44f30fd7bd0cb1712d4925c5ed18a865e4ff6fe488d787eaba38939c52cea2e0a9d1f62fec4a97
+  data.tar.gz: 6530759983f83fed70bab30adb12fa6bae9990f5554e91170e5547cbeb58514759eb649fe322b1857d895ec0051017ab53ee2b9cbc35bb918b66199c9fbfbf51

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.2.0] - 2026-03-04
+
+### Changed
+
+- Navigation is now hunk-based: `j`/`k` jump between hunks
+- Active hunk is highlighted; inactive hunks are dimmed
+- Removed line-scrolling keys (`f`/`b`/`d`/`u`/`g`/`G`) and arrow keys
+
 ## [0.1.0] - 2026-03-04
 
 ### Added

data/README.md

@@ -1,6 +1,6 @@
 # Sight
 
-Terminal UI for browsing git diffs interactively with colors, scrolling, and file navigation.
+Terminal UI for browsing git diffs interactively with colors, hunk navigation, and file navigation.
 
 ## Installation
 
@@ -20,16 +20,10 @@ sight
 
 | Key | Action |
 |-----|--------|
-| `j` / `↓` | Scroll down |
-| `k` / `↑` | Scroll up |
-| `d` | Half page down |
-| `u` | Half page up |
-| `f` | Full page down |
-| `b` | Full page up |
-| `g` | Go to top |
-| `G` | Go to bottom |
-| `n` / `→` | Next file |
-| `p` / `←` | Previous file |
+| `j` | Next hunk |
+| `k` | Previous hunk |
+| `n` | Next file |
+| `p` | Previous file |
 | `?` | Toggle help |
 | `q` / `Esc` | Quit |
 

data/lib/sight/app.rb

@@ -5,13 +5,15 @@ require "curses"
 module Sight
   class App
     attr_reader :files, :file_lines
-    attr_accessor :file_idx, :offset
+    attr_accessor :file_idx, :offset, :hunk_idx
 
     def initialize(files)
       @files = files
       @file_lines = files.map { build_file_lines(it) }
       @file_idx = 0
       @offset = 0
+      @hunk_idx = 0
+      @hunk_offsets_cache = {}
     end
 
     def run
@@ -49,6 +51,7 @@ module Sight
       Curses.init_pair(2, Curses::COLOR_RED, -1)
       Curses.init_pair(3, Curses::COLOR_CYAN, -1)
       Curses.init_pair(4, Curses::COLOR_YELLOW, -1)
+      Curses.init_pair(5, 240, -1)
     end
 
     def lines
@@ -78,20 +81,29 @@ module Sight
       dim = Curses.color_pair(0) | Curses::A_DIM
       content_width = width - gutter - 3
 
+      selected_start = hunk_offsets[hunk_idx]
+      selected_end = if hunk_idx + 1 < hunk_offsets.size
+        hunk_offsets[hunk_idx + 1]
+      else
+        lines.size
+      end
+
       scroll_height.times do |row|
         idx = offset + row
         break if idx >= lines.size
         line = lines[idx]
         win.setpos(row + 2, 0)
-        win.attron(dim) { win.addstr("#{format_gutter(line.type, line.lineno, gutter)} │ ") }
-        win.attron(color_for(line.type)) { win.addstr(line.text[0, content_width]) }
+        active = idx >= selected_start && idx < selected_end
+        win.attron(dim) { win.addstr("#{format_gutter(line.type, line.lineno, gutter)} \u2502 ") }
+        attr = active ? color_for(line.type) : Curses.color_pair(5)
+        win.attron(attr) { win.addstr(line.text[0, content_width]) }
       end
     end
 
     def render_status_bar(win, width)
       win.setpos(Curses.lines - 1, 0)
       win.attron(Curses.color_pair(4) | Curses::A_REVERSE) do
-        status = " File #{file_idx + 1}/#{files.size} | Line #{offset + 1}/#{lines.size} "
+        status = " File #{file_idx + 1}/#{files.size} | Hunk #{hunk_idx + 1}/#{hunk_offsets.size} | Line #{offset + 1}/#{lines.size} "
         win.addstr(status.ljust(width))
       end
     end
@@ -126,41 +138,24 @@ module Sight
       end
     end
 
-    def scroll_to(delta)
-      max = [0, lines.size - scroll_height].max
-      self.offset = (offset + delta).clamp(0, max)
-    end
-
     def handle_input
       key = Curses.getch
       case key
       when "q", 27 then return false
-      when "j", Curses::KEY_DOWN then scroll_to(1)
-      when "k", Curses::KEY_UP then scroll_to(-1)
-      when "f" then scroll_to(scroll_height)
-      when "b" then scroll_to(-scroll_height)
-      when "d" then scroll_to(scroll_height / 2)
-      when "u" then scroll_to(-scroll_height / 2)
-      when "g" then self.offset = 0
-      when "G" then scroll_to(lines.size)
-      when "n", Curses::KEY_RIGHT then jump_file(1)
-      when "p", Curses::KEY_LEFT then jump_file(-1)
+      when "j" then jump_hunk(1)
+      when "k" then jump_hunk(-1)
+      when "n" then jump_file(1)
+      when "p" then jump_file(-1)
       when "?" then show_help
       end
       true
     end
 
     HELP_KEYS = [
-      ["j / ↓", "Scroll down"],
-      ["k / ↑", "Scroll up"],
-      ["d", "Half Page down"],
-      ["u", "Half page up"],
-      ["f", "Full page down"],
-      ["b", "Full page up"],
-      ["g", "Go to top"],
-      ["G", "Go to bottom"],
-      ["n / →", "Next file"],
-      ["p / ←", "Previous file"],
+      ["j", "Next hunk"],
+      ["k", "Previous hunk"],
+      ["n", "Next file"],
+      ["p", "Previous file"],
       ["q / Esc", "Quit"],
       ["?", "Toggle this help"]
     ].freeze
@@ -201,11 +196,33 @@ module Sight
       end
     end
 
+    def hunk_offsets
+      @hunk_offsets_cache[file_idx] ||= begin
+        offsets = []
+        line_idx = 0
+        files[file_idx].hunks.each do |hunk|
+          offsets << line_idx
+          line_idx += hunk.lines.size
+        end
+        offsets
+      end
+    end
+
+    def jump_hunk(delta)
+      return if hunk_offsets.empty?
+      self.hunk_idx = (hunk_idx + delta).clamp(0, hunk_offsets.size - 1)
+      target = hunk_offsets[hunk_idx]
+      margin = [2, scroll_height / 4].min
+      max = [0, lines.size - scroll_height].max
+      self.offset = [target - margin, 0].max.clamp(0, max)
+    end
+
     def jump_file(direction)
       new_idx = (file_idx + direction).clamp(0, files.size - 1)
       return if new_idx == file_idx
       self.file_idx = new_idx
       self.offset = 0
+      self.hunk_idx = 0
     end
   end
 end

data/lib/sight/cli.rb

@@ -9,7 +9,7 @@ module Sight
         puts "Usage: sight"
         puts "Interactive git diff viewer (staged + unstaged)"
         puts
-        puts "Keys: j/k/↑/↓ scroll, f/b page, d/u half-page, g/G top/bottom, n/p/→/← next/prev file, ? help, q quit"
+        puts "Keys: j/k hunks, n/p files, ? help, q quit"
         return
       end
 
@@ -20,7 +20,7 @@ module Sight
 
       raw = Git.diff
       if raw.empty?
-        warn "No diff output."
+        warn "No diff output"
         return
       end
 

data/lib/sight/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sight
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sight
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Ariel Rzezak