rcurses 3.2 → 3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79ceb9c8cca6e61988655c520a5b43f5f2a37b95f9c3064b59cefa962795b751
-  data.tar.gz: 67ad97d3a492318eff06f393eb4366d575b1cf2de2bc471b02b15a12d3505aaf
+  metadata.gz: '089c7b974ce66ffc1afdc8c70d6b5d354f11926894329367c4ac304fc56e7af4'
+  data.tar.gz: 23e9d5853f8977ecc914a4cdbfce0a26570d9e3076415709a150c59b5ddc61df
 SHA512:
-  metadata.gz: b0a668847e6b6f276ed5ee059d3e194184f4313556316ab3c80604d63cc8b99e5a733559b8e6e97da90c6fa2191ecdfc5b15e6639c41caa577f8810b0da87b77
-  data.tar.gz: 95a8a6b48bc7399121b50b3cbeae29631feab2b76a537a93c585bf9e654492e8bebbb30bb881b6b8522ec17866209c657a133511d500cdcdb589d17b2a3585c4
+  metadata.gz: 31a9cf284d90a1ead46acfc3f3f77c0777e6e879481e01203e2bb7219579b6d694d50c08d9af7beedcd7a355244bee5975b4f3d9b037827081430abf08363721
+  data.tar.gz: d0f9ed3cdf1a29c10e1a732f61e62c2054ad549edb04398ea5a273c49730c7bdb567e16e59ee67ebdcc9d420499e1823f2c11b087b558bb7e3bfb71b1293b6b0

data/README.md

@@ -79,6 +79,7 @@ Method         | Description
 new/init       | Initializes a Pane with optional arguments `x, y, w, h, fg and bg`
 move(x,y)      | Move the pane by `x`and `y` (`mypane.move(-4,5)` will move the pane left four characters and five characters down)
 refresh        | Refreshes/redraws the Pane with content
+full_refresh   | Refreshes/redraws the Pane with content completely (without diff rendering)
 edit           | An editor for the Pane. When this is invoked, all existing font dressing is stripped and the user gets to edit the raw text. The user can add font effects similar to Markdown; Use an asterisk before and after text to be drawn in bold, text between forward-slashes become italic, and underline before and after text means the text will be underlined, a hash-sign before and after text makes the text reverse colored. You can also combine a whole set of dressings in this format: `<23,245,biurl|Hello World!>` - this will make "Hello World!" print in the color 23 with the background color 245 (regardless of the Pane's fg/bg setting) in bold, italic, underlined, reversed colored and blinking. Hitting `ESC` while in edit mode will disregard the edits, while `Ctrl-S` will save the edits
 editline       | Used for one-line Panes. It will print the content of the property `prompt` and then the property `text` that can then be edited by the user. Hitting `ESC` will disregard the edits, while `ENTER` will save the edited text
 puts(text)     | Short form for setting panel.text, then doing a refresh of that panel
@@ -105,6 +106,7 @@ l              | Set text to be printed blinking (example: `"TEST".l`)
 r              | Set text to be printed in reverse colors (example: `"TEST".r`)
 c(code)        | Use coded format like "TEST".c("204,45,bui") to print "TEST" in bold, underline italic, fg=204 and bg=45 (the format is `.c("fg,bg,biulr"))
 pure           | Strip text of any "dressing" (example: with `text = "TEST".b`, you will have bold text in the variable `text`, then with `text.pure` it will show "uncoded" or pure text)
+ansi_clean     | Strip seemingly uncolored strings of ansi code (those that are enclosed in "\e[0m"
 shorten(n)     | Shorten the pure version of the string to 'n' characters, preserving any ANSI coding
 inject("chars",pos) | Inject "chars" at position 'pos' in the pure version of the string (if 'pos' is '-1', then append at end). Preserves any ANSI code
 

data/lib/rcurses/pane.rb

@@ -106,10 +106,14 @@ module Rcurses
       refresh
     end
 
+    # full_refresh forces a complete repaint.
+    def full_refresh(cont = @text)
+      @prev_frame = nil
+      refresh(cont)
+    end
+
     # Diff-based refresh that minimizes flicker.
-    # (This is your previously best-working code.)
-    # We have removed scroll marker insertion from within the double-buffered frame.
-    # Instead, after printing the frame we reprint the right border column.
+    # In this updated version we lazily process only the raw lines required to fill the pane.
     def refresh(cont = @text)
       @max_h, @max_w = IO.console.winsize
 
@@ -129,8 +133,32 @@ module Rcurses
       STDOUT.print "\e[?25l"  # Hide cursor
 
       fmt = [@fg, @bg].compact.join(',')
-      @txt = cont.split("\n")
-      @txt = textformat(cont) if @txt.any? { |line| line.pure.length >= @w }
+
+      # Lazy evaluation: If the content or pane width has changed, reinitialize the lazy cache.
+      if !defined?(@cached_text) || @cached_text != cont || @cached_w != @w
+        @raw_txt   = cont.split("\n")
+        @lazy_txt  = []   # This will hold the processed (wrapped) lines as needed.
+        @lazy_index = 0   # Pointer to the next raw line to process.
+        @cached_text = cont
+        @cached_w = @w
+      end
+
+      content_rows = @h
+      # Ensure we have processed enough lines for the current scroll position + visible area.
+      required_lines = @ix + content_rows
+      while @lazy_txt.size < required_lines && @lazy_index < @raw_txt.size
+        raw_line = @raw_txt[@lazy_index]
+        # If the raw line is short, no wrapping is needed.
+        if raw_line.respond_to?(:pure) && raw_line.pure.length < @w
+          processed = [raw_line]
+        else
+          processed = split_line_with_ansi(raw_line, @w)
+        end
+        @lazy_txt.concat(processed)
+        @lazy_index += 1
+      end
+      @txt = @lazy_txt
+
       @ix = @txt.length - 1 if @ix > @txt.length - 1
       @ix = 0 if @ix < 0
 
@@ -140,7 +168,6 @@ module Rcurses
         new_frame << top_border
       end
 
-      content_rows = @h
       content_rows.times do |i|
         line_str = ""
         l = @ix + i
@@ -184,24 +211,21 @@ module Rcurses
 
       diff_buf << "\e[#{o_row};#{o_col}H"
       print diff_buf
-      #STDOUT.print "\e[?25h"  # We leave the cursor hidden unless explicitly shown
       @prev_frame = new_frame
 
-      # Now, after printing the frame, draw the scroll markers separately.
+      # Draw scroll markers after printing the frame.
       if @scroll
-        # Use the same marker column as before.
         marker_col = @border ? (@x + @w - 1) : (@x + @w - 1)
-        # Draw top marker at row = @y + 1 (inside the frame)
         if @ix > 0
           print "\e[#{@y};#{marker_col}H" + "∆".c(fmt)
         end
-        # Draw bottom marker at row = @y + @h - 1 (inside the frame)
-        if (@txt.length - @ix) > @h
+        # If there are more processed lines than fit in the pane
+        # OR there remain raw lines to process, show the down marker.
+        if (@txt.length - @ix) > @h || (@lazy_index < @raw_txt.size)
           print "\e[#{@y + @h - 1};#{marker_col}H" + "∇".c(fmt)
         end
       end
 
-      # Now, reprint the right border column for each content line to fill any holes.
       if @border
         (0...@h).each do |i|
           print "\e[#{@y + i};#{@x + @w}H" + "│".c(fmt)
@@ -212,6 +236,8 @@ module Rcurses
     end
 
     def textformat(cont)
+      # This method is no longer used in refresh since we process lazily,
+      # but is kept here if needed elsewhere.
       lines = cont.split("\n")
       result = []
       lines.each do |line|
@@ -562,3 +588,4 @@ module Rcurses
     end
   end
 end
+

data/lib/rcurses.rb

@@ -5,7 +5,7 @@
 # Web_site:   http://isene.com/
 # Github:     https://github.com/isene/rcurses
 # License:    Public domain
-# Version:    3.2: Fixed scroll markers and UTF-8 double-wide characters breaking borders
+# Version:    3.3: Faster rendering of pane content
 
 require 'io/console' # Basic gem for rcurses
 require 'io/wait'    # stdin handling

data/lib/string_extensions.rb

@@ -34,6 +34,16 @@ class String
     prop
   end
 
+  def clean_ansi
+    # Remove surrounding \e[0m if the string is otherwise unstyled
+    stripped = self.gsub(/\A\e\[0m/, '').gsub(/\e\[0m\z/, '')
+    if stripped.pure == stripped
+      stripped
+    else
+      self
+    end
+  end
+
   def pure
     self.gsub(/\e\[\d+(?:;\d+)*m/, '')
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rcurses
 version: !ruby/object:Gem::Version
-  version: '3.2'
+  version: '3.4'
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-02 00:00:00.000000000 Z
+date: 2025-04-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: clipboard
@@ -29,8 +29,8 @@ description: 'Create curses applications for the terminal easier than ever. Crea
   up text (in panes or anywhere in the terminal) in bold, italic, underline, reverse
   color, blink and in any 256 terminal colors for foreground and background. Use a
   simple editor to let users edit text in panes. Left, right or center align text
-  in panes. Cursor movement around the terminal. New in 3.2: Fixed scroll markers
-  and UTF-8 double-wide characters breaking borders.'
+  in panes. Cursor movement around the terminal. New in 3.4: Added ansi_clean and
+  full_refresh methods.'
 email: g@isene.com
 executables: []
 extensions: []