rcurses 4.9.4 → 5.0.0

data/lib/rcurses.rb

@@ -0,0 +1,61 @@
+# INFORMATION
+# Name:       rcurses - Ruby CURSES
+# Language:   Pure Ruby
+# Author:     Geir Isene <g@isene.com>
+# Web_site:   http://isene.com/
+# Github:     https://github.com/isene/rcurses
+# License:    Public domain
+# Version:    4.9.3: Reverted to stable 4.8.3 codebase after 4.9.0-4.9.2 color issues
+
+require 'io/console' # Basic gem for rcurses
+require 'io/wait'    # stdin handling
+require 'timeout'
+
+require_relative 'string_extensions'
+require_relative 'rcurses/general'
+require_relative 'rcurses/cursor'
+require_relative 'rcurses/input'
+require_relative 'rcurses/pane'
+
+module Rcurses
+  class << self
+    # Public: Initialize Rcurses. Switches terminal into raw/no-echo
+    # and registers cleanup handlers. Idempotent.
+    def init!
+      return if @initialized
+      return unless $stdin.tty?
+
+      # enter raw mode, disable echo
+      $stdin.raw!
+      $stdin.echo = false
+
+      # ensure cleanup on normal exit
+      at_exit { cleanup! }
+
+      # ensure cleanup on signals
+      %w[INT TERM].each do |sig|
+        trap(sig) { cleanup!; exit }
+      end
+
+      @initialized = true
+    end
+
+    # Public: Restore terminal to normal mode, clear screen, show cursor.
+    # Idempotent: subsequent calls do nothing.
+    def cleanup!
+      return if @cleaned_up
+
+      $stdin.cooked!
+      $stdin.echo = true
+      Rcurses.clear_screen
+      Cursor.show
+
+      @cleaned_up = true
+    end
+  end
+
+  # Kick off initialization as soon as the library is required.
+  init!
+end
+
+# vim: set sw=2 sts=2 et filetype=ruby fdn=2 fcs=fold\:\ :

data/lib/string_extensions.rb

@@ -0,0 +1,160 @@
+# string_extensions.rb
+
+class String
+  # 256-color or truecolor RGB foregroundb
reset only the fg (SGR 39)
+  def fg(color)
+    sp, ep = if color.to_s =~ /\A[0-9A-Fa-f]{6}\z/
+      r, g, b = color.scan(/../).map { |c| c.to_i(16) }
+      ["\e[38;2;#{r};#{g};#{b}m", "\e[39m"]
+    else
+      ["\e[38;5;#{color}m", "\e[39m"]
+    end
+    color(self, sp, ep)
+  end
+
+  # 256-color or truecolor RGB backgroundb
reset only the bg (SGR 49)
+  def bg(color)
+    sp, ep = if color.to_s =~ /\A[0-9A-Fa-f]{6}\z/
+      r, g, b = color.scan(/../).map { |c| c.to_i(16) }
+      ["\e[48;2;#{r};#{g};#{b}m", "\e[49m"]
+    else
+      ["\e[48;5;#{color}m", "\e[49m"]
+    end
+    color(self, sp, ep)
+  end
+
+  # Both fg and bg in one go
+  def fb(fg_color, bg_color)
+    parts = []
+    if fg_color.to_s =~ /\A[0-9A-Fa-f]{6}\z/
+      r, g, b = fg_color.scan(/../).map { |c| c.to_i(16) }
+      parts << "38;2;#{r};#{g};#{b}"
+    else
+      parts << "38;5;#{fg_color}"
+    end
+
+    if bg_color.to_s =~ /\A[0-9A-Fa-f]{6}\z/
+      r, g, b = bg_color.scan(/../).map { |c| c.to_i(16) }
+      parts << "48;2;#{r};#{g};#{b}"
+    else
+      parts << "48;5;#{bg_color}"
+    end
+
+    sp = "\e[#{parts.join(';')}m"
+    color(self, sp, "\e[39;49m")
+  end
+
+  # bold, italic, underline, blink, reverse
+  def b; color(self, "\e[1m",   "\e[22m"); end
+  def i; color(self, "\e[3m",   "\e[23m"); end
+  def u; color(self, "\e[4m",   "\e[24m"); end
+  def l; color(self, "\e[5m",   "\e[25m"); end
+  def r; color(self, "\e[7m",   "\e[27m"); end
+
+  # Internal helper - wraps +text+ in start/end sequences,
+  # and re-applies start on every newline.
+  def color(text, sp, ep = "\e[0m")
+    t = text.gsub("\n", "#{ep}\n#{sp}")
+    "#{sp}#{t}#{ep}"
+  end
+
+  # Combined code:  "foo".c("FF0000,00FF00,bui")
+  # — 6-hex or decimal for fg, then for bg, then letters b/i/u/l/r
+  def c(code)
+    parts = code.split(',')
+    seq   = []
+
+    fg = parts.shift
+    if fg =~ /\A[0-9A-Fa-f]{6}\z/
+      r,g,b = fg.scan(/../).map{|c|c.to_i(16)}
+      seq << "38;2;#{r};#{g};#{b}"
+    elsif fg =~ /\A\d+\z/
+      seq << "38;5;#{fg}"
+    end
+
+    if parts.any?
+      bg = parts.shift
+      if bg =~ /\A[0-9A-Fa-f]{6}\z/
+        r,g,b = bg.scan(/../).map{|c|c.to_i(16)}
+        seq << "48;2;#{r};#{g};#{b}"
+      elsif bg =~ /\A\d+\z/
+        seq << "48;5;#{bg}"
+      end
+    end
+
+    seq << '1' if code.include?('b')
+    seq << '3' if code.include?('i')
+    seq << '4' if code.include?('u')
+    seq << '5' if code.include?('l')
+    seq << '7' if code.include?('r')
+
+    "\e[#{seq.join(';')}m#{self}\e[0m"
+  end
+
+  # Strip all ANSI SGR sequences
+  def pure
+    gsub(/\e\[\d+(?:;\d+)*m/, '')
+  end
+
+  # Remove stray leading/trailing reset if the string has no other styling
+  def clean_ansi
+    gsub(/\A(?:\e\[0m)+/, '').gsub(/\e\[0m\z/, '')
+  end
+
+  # Truncate the *visible* length to n, but preserve embedded ANSI
+  def shorten(n)
+    count = 0
+    out   = ''
+    i     = 0
+
+    while i < length && count < n
+      if self[i] == "\e" && (m = self[i..-1].match(/\A(\e\[\d+(?:;\d+)*m)/))
+        out << m[1]
+        i   += m[1].length
+      else
+        out << self[i]
+        i   += 1
+        count += 1
+      end
+    end
+
+    out
+  end
+
+  # Insert +insertion+ at visible position +pos+ (negative → end),
+  # respecting and re-inserting existing ANSI sequences.
+  def inject(insertion, pos)
+    pure_txt      = pure
+    visible_len   = pure_txt.length
+    pos           = visible_len if pos < 0
+
+    count, out, i, injected = 0, '', 0, false
+
+    while i < length
+      if self[i] == "\e" && (m = self[i..-1].match(/\A(\e\[\d+(?:;\d+)*m)/))
+        out << m[1]
+        i   += m[1].length
+      else
+        if count == pos && !injected
+          out << insertion
+          injected = true
+        end
+        out << self[i]
+        count  += 1
+        i      += 1
+      end
+    end
+
+    unless injected
+      if out =~ /(\e\[\d+(?:;\d+)*m)\z/
+        trailing = $1
+        out      = out[0...-trailing.length] + insertion + trailing
+      else
+        out << insertion
+      end
+    end
+
+    out
+  end
+end
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rcurses
 version: !ruby/object:Gem::Version
-  version: 4.9.4
+  version: 5.0.0
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-02 00:00:00.000000000 Z
+date: 2025-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: clipboard
@@ -29,8 +29,9 @@ 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. 4.9.4: Stable release with proper
-  color handling restored.'
+  in panes. Cursor movement around the terminal. 5.0.0: Major improvements - memory
+  leak fixes, terminal state protection, Unicode support, and enhanced error handling
+  while maintaining full backward compatibility and 4.8.3 performance.'
 email: g@isene.com
 executables: []
 extensions: []
@@ -38,6 +39,14 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- examples/basic_panes.rb
+- examples/focus_panes.rb
+- lib/rcurses.rb
+- lib/rcurses/cursor.rb
+- lib/rcurses/general.rb
+- lib/rcurses/input.rb
+- lib/rcurses/pane.rb
+- lib/string_extensions.rb
 homepage: https://isene.com/
 licenses:
 - Unlicense