rcurses 6.1.8 → 6.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72260982576477690897f35d9b879ec6ebe2ce96d8ed9890eb17f4a450a3761a
-  data.tar.gz: ede3452eb593c4a15d86a1305aa58f672fc60a8247f31788d6cc406c93cfa73c
+  metadata.gz: 83520fbe28d15e3132827b2487cf90c386bd94362bcd77561a6361bf34a155fc
+  data.tar.gz: 22be19a0d1625c0e264372dbfa9fd9031016400a3859119158a783a620e3c412
 SHA512:
-  metadata.gz: '0686e0adcbe24f0ad7a5c3d0a5655e0edacb93aa7b6f46e71bc5665000379d8a7529d5d15ed79c1d3afb7e0d2e567c93c235fe116b1dcfadc4fb397bfb7b0360'
-  data.tar.gz: 1657bc094efdef6af6665aec14a77d98b9b56b02eb4a6bcbdd10cfb816dfaacfc9a4b8c57f77eba0208c6df5c30909e589a52df0eeb03bff34beb3d7324bd748
+  metadata.gz: 523564a95aaf527d1df0f03056d6f2776f66e5d2aacb7bf70f81381d1f7cee5fc2f575cb6196126dcf990d6fde4db11d357f60dfb85112ef3f1e8fee038e9bee
+  data.tar.gz: 670f44738dab604557da61576ec048634efbef7d3a6adbac84bba5ace294fe2a246c7c25a438798e70012a45ab4263a311ee6abb8026943be9b4e746c068ce4a

data/README.md

@@ -10,24 +10,20 @@ Here's a somewhat simple example of a TUI program using rcurses: The [T-REX](htt
 
 And here's a much more involved example: The [RTFM](https://github.com/isene/RTFM) terminal file manager.
 
-# NOTE: Version 6.1.1 adds optional error logging!
-- **Error logging** - Set `RCURSES_ERROR_LOG=1` to log crashes to `/tmp/rcurses_errors_PID.log`
-- **Race-condition free** - Uses process-specific filenames to avoid conflicts
-- **Stack trace preservation** - Full backtraces logged even when screen is cleared
-- **Completely opt-in** - Zero impact unless explicitly enabled
-- **Full backward compatibility** - All existing applications work unchanged
+# What's new in 6.2.0
 
-Previous improvements in 6.1.0:
-- **Safe regex substitution** - New `safe_gsub` methods prevent ANSI code corruption
-- **ANSI detection** - Check if strings contain ANSI codes with `has_ansi?`
-- **Visible length calculation** - Get true text length with `visible_length`
-- **Conditional coloring** - Apply colors only when needed with `safe_fg`/`safe_bg`
+- **Popup widget** - New `Rcurses::Popup` class for modal dialogs with auto-centering, border, scrolling, and built-in key handling (see Popup section below)
+- **Built-in emoji picker** - Panes with `emoji = true` get a `Ctrl-E` shortcut in editline that opens an emoji overlay with category tabs, search, and cursor-positioned grid rendering
+- **Pane color cache invalidation** - Changing `fg` or `bg` on a Pane now forces a full repaint automatically (no more stale diff-rendering artifacts)
+- **Startup stdin flush** - `Rcurses.init!` now flushes pending stdin data (cursor position responses) to prevent first-keypress blocking
+- **Pane update flag** - Set `pane.update = false` to skip rendering during batch operations
+- **Wider ESC timeout** - Escape sequence detection timeout increased from 50ms to 150ms for better terminal compatibility
+- **Unicode display_width fixes** - Improved handling of FE0F variation selectors, ZWJ sequences, and dingbat characters
+- **Editline improvements** - Unicode-aware padding, content truncation, multiline paste joins all lines
 
-Previous major improvements in 5.0.0:
-- Memory leak fixes, terminal state protection, enhanced Unicode support
-- Error handling improvements and performance optimizations
+<img src="img/rcurses-emoji.png" width="400">
 
-Version 4.5 gave full RGB support in addition to 256-colors. Just write a color as a string - e.g. `"d533e0"` for a hexadecimal RGB color (or use the terminal 256 colors by supplying an integer in the range 0-255)
+Previous notable versions: 6.1.1 (error logging), 6.1.0 (safe ANSI methods), 6.0.0 (explicit init!), 5.0.0 (memory fixes), 4.5 (RGB colors)
 
 # Why?
 Having struggled with the venerable curses library and the ruby interface to it for many years, I finally got around to write an alternative - in pure Ruby.
@@ -96,6 +92,9 @@ align          | Text alignment in the Pane: "l" = lefts aligned, "c" = center,
 prompt         | The prompt to print at the beginning of a one-liner Pane used as an input box
 moreup         | Set to true when there is more text above what is shown (top scroll bar i showing)
 moredown       | Set to true when there is more text below what is shown (bottom scroll bar i showing)
+update         | When false, refresh is a no-op (default: true). Useful during batch operations
+emoji          | When true, Ctrl-E in editline opens the built-in emoji picker (default: false)
+emoji_refresh  | Optional lambda/proc called after emoji picker closes, to redraw the UI
 
 The methods for Pane:
 
@@ -119,6 +118,57 @@ lineup         | Scroll up one line in the text
 bottom         | Scroll to the bottom of the text in the pane
 top            | Scroll to the top of the text in the pane
 
+# class Popup
+
+A reusable popup overlay widget for modal dialogs, selection menus, and informational displays. Extends `Pane` with auto-centering, built-in scrolling, and keyboard handling.
+
+```ruby
+# Auto-centered popup with default size
+popup = Rcurses::Popup.new(w: 50, h: 20)
+
+# Explicit position
+popup = Rcurses::Popup.new(x: 10, y: 5, w: 50, h: 20, fg: 255, bg: 236)
+```
+
+**Modal usage** (blocks until ESC or ENTER):
+```ruby
+result = popup.modal(content_string)
+# Returns selected line index on ENTER, or nil on ESC
+# Built-in: UP/DOWN/PgUP/PgDN/HOME/END for scrolling
+```
+
+**Custom key handling**:
+```ruby
+result = popup.modal(content) do |chr, index|
+  case chr
+  when 'd'
+    delete_item(index)
+    :dismiss        # Close popup
+  when 'e'
+    "edit:#{index}" # Return custom value
+  end
+end
+```
+
+**Manual control** (non-blocking):
+```ruby
+popup.show(content_string)
+# ... your own input loop ...
+popup.dismiss(refresh_panes: [pane1, pane2])  # Clears area, refreshes underlying panes
+```
+
+# Emoji Picker
+
+Panes can opt in to a built-in emoji picker that opens with `Ctrl-E` during editline:
+
+```ruby
+pane.emoji = true                   # Enable Ctrl-E shortcut
+pane.emoji_refresh = -> { render }  # Optional: redraw UI after picker closes
+pane.editline                       # Ctrl-E now opens emoji overlay
+```
+
+The picker features category tabs (Tab/Shift-Tab), arrow navigation, search-by-keyword, and cursor-positioned grid rendering for pixel-perfect alignment regardless of Unicode width variations.
+
 # class String extensions
 Method extensions provided for the class String.
 
@@ -366,7 +416,12 @@ end
 **Problem:** `wait_readable` method not found.  
 **Solution:** Always include `require 'io/wait'` for stdin flush.
 
-### 5. Border Changes Not Visible
+### 5. `String#b` Overrides Ruby's Built-in Binary Method
+**Problem:** rcurses defines `String#b` for bold formatting, but Ruby's built-in `String#b` returns a binary-encoded copy of the string. Any code using `''.b` or `str.b` for binary I/O will silently get ANSI bold codes instead.
+**Impact:** Binary protocol parsers, socket readers, and encoding-sensitive code will break when rcurses is loaded.
+**Workaround:** Use `String.new(encoding: 'ASCII-8BIT')` instead of `''.b` when you need binary strings in code that coexists with rcurses.
+
+### 6. Border Changes Not Visible
 **Problem:** Changing pane border property doesn't show visual changes.  
 **Cause:** Border changes require explicit refresh to be displayed.  
 **Solution:** Use `border_refresh` method after changing border property.
@@ -405,6 +460,16 @@ And - try running the example file `rcurses_example.rb`.
 
 # Version History
 
+## v6.2.0
+- New `Popup` class for modal dialogs with auto-centering, border, scrolling, and key handling
+- Built-in emoji picker with category tabs, search, and cursor-positioned grid rendering
+- Pane `fg`/`bg` setters now invalidate diff-rendering cache (fixes color change artifacts)
+- `Rcurses.init!` flushes pending stdin data to prevent startup keypress blocking
+- New pane attributes: `update` (skip rendering), `emoji` (enable Ctrl-E picker), `emoji_refresh`
+- ESC sequence timeout widened from 50ms to 150ms for better terminal compatibility
+- Unicode `display_width` fixes: FE0F/FE0E treated as zero-width, improved ZWJ promotion
+- Editline: Unicode-aware padding, content truncation, multiline paste joins all lines
+
 ## v6.1.8
 - Added `scroll_fg` pane attribute for custom scroll indicator (∆/∇) color
 - When set, scroll markers use this color instead of the pane's foreground color

data/lib/rcurses/emoji.rb

@@ -0,0 +1,293 @@
+module Rcurses
+  module EmojiPicker
+    extend Rcurses::Input
+
+    CATEGORIES = {
+      "Smileys" => [
+        ["😀","grin"],["😃","smiley"],["😄","smile"],["😁","beaming"],["😆","laughing"],
+        ["😅","sweat smile"],["🤣","rofl"],["😂","joy"],["🙂","slight smile"],["😉","wink"],
+        ["😊","blush"],["😇","innocent"],["🥰","love face"],["😍","heart eyes"],["🤩","starstruck"],
+        ["😘","kiss"],["😗","kissing"],["😚","kiss closed"],["😙","kiss smile"],["🥲","happy tear"],
+        ["😋","yum"],["😛","tongue"],["😜","tongue wink"],["🤪","zany"],["😝","tongue closed"],
+        ["🤑","money"],["🤗","hug"],["🤭","hand mouth"],["🤫","shush"],["🤔","thinking"],
+        ["🫡","salute"],["🤐","zipper"],["🤨","raised brow"],["😐","neutral"],["😑","expressionless"],
+        ["😶","no mouth"],["🫥","dotted face"],["😏","smirk"],["😒","unamused"],["🙄","roll eyes"],
+        ["😬","grimace"],["😮‍💨","exhale"],["🤥","liar"],["😌","relieved"],["😔","pensive"],
+        ["😪","sleepy"],["🤤","drool"],["😴","sleep"],["😷","mask"],["🤒","sick"],
+        ["🤕","bandage"],["🤢","nausea"],["🤮","vomit"],["🥵","hot"],["🥶","cold"],
+        ["🥴","woozy"],["😵","dizzy"],["🤯","exploding"],["🤠","cowboy"],["🥳","party"],
+        ["🥸","disguise"],["😎","cool"],["🤓","nerd"],["🧐","monocle"],["😕","confused"],
+        ["🫤","diagonal mouth"],["😟","worried"],["🙁","frown"],["😮","open mouth"],["😯","hushed"],
+        ["😲","astonished"],["😳","flushed"],["🥺","pleading"],["🥹","holding tears"],["😦","frowning"],
+        ["😧","anguished"],["😨","fearful"],["😰","anxious"],["😥","sad relief"],["😢","cry"],
+        ["😭","sob"],["😱","scream"],["😖","confounded"],["😣","persevere"],["😞","disappointed"],
+        ["😓","downcast"],["😩","weary"],["😫","tired"],["🥱","yawn"],["😤","triumph"],
+        ["😡","rage"],["😠","angry"],["🤬","swearing"],["😈","devil smile"],["👿","devil"],
+        ["💀","skull"],["☠️","crossbones"],["💩","poop"],["🤡","clown"],["👹","ogre"],
+        ["👻","ghost"],["👽","alien"],["🤖","robot"],["💋","kiss mark"],["❤️","heart"],
+        ["🧡","orange heart"],["💛","yellow heart"],["💚","green heart"],["💙","blue heart"],
+        ["💜","purple heart"],["🖤","black heart"],["🤍","white heart"],["🤎","brown heart"],
+        ["💔","broken heart"],["❤️‍🔥","fire heart"],["💕","two hearts"],["💞","revolving hearts"],
+        ["💓","heartbeat"],["💗","growing heart"],["💖","sparkling heart"],["💘","cupid"],
+        ["💝","ribbon heart"],["💟","heart decoration"],["🫶","heart hands"]
+      ],
+      "People" => [
+        ["👋","wave"],["🤚","raised back"],["🖐️","splayed hand"],["✋","raised hand"],
+        ["🖖","vulcan"],["🫱","right hand"],["🫲","left hand"],["🫳","palm down"],["🫴","palm up"],
+        ["👌","ok"],["🤌","pinched"],["🤏","pinch"],["✌️","peace"],["🤞","crossed fingers"],
+        ["🫰","index thumb"],["🤟","love you"],["🤘","rock"],["🤙","call me"],
+        ["👈","left point"],["👉","right point"],["👆","up point"],["🖕","middle finger"],
+        ["👇","down point"],["☝️","index up"],["🫵","point at viewer"],["👍","thumbsup"],
+        ["👎","thumbsdown"],["✊","fist"],["👊","punch"],["🤛","left fist"],["🤜","right fist"],
+        ["👏","clap"],["🙌","raised hands"],["🫶","heart hands"],["👐","open hands"],
+        ["🤲","palms up"],["🤝","handshake"],["🙏","pray"],["✍️","writing"],["💪","muscle"],
+        ["🦾","mechanical arm"],["🧠","brain"],["👀","eyes"],["👁️","eye"],["👅","tongue"],
+        ["👄","lips"],["🫦","biting lip"],["👶","baby"],["🧒","child"],["👦","boy"],
+        ["👧","girl"],["🧑","person"],["👱","blond"],["👨","man"],["🧔","beard"],
+        ["👩","woman"],["🧓","older person"],["👴","old man"],["👵","old woman"]
+      ],
+      "Animals" => [
+        ["🐶","dog"],["🐱","cat"],["🐭","mouse"],["🐹","hamster"],["🐰","rabbit"],
+        ["🦊","fox"],["🐻","bear"],["🐼","panda"],["🐻‍❄️","polar bear"],["🐨","koala"],
+        ["🐯","tiger"],["🦁","lion"],["🐮","cow"],["🐷","pig"],["🐸","frog"],
+        ["🐵","monkey"],["🐔","chicken"],["🐧","penguin"],["🐦","bird"],["🐤","chick"],
+        ["🦆","duck"],["🦅","eagle"],["🦉","owl"],["🦇","bat"],["🐺","wolf"],
+        ["🐗","boar"],["🐴","horse"],["🦄","unicorn"],["🐝","bee"],["🐛","bug"],
+        ["🦋","butterfly"],["🐌","snail"],["🐞","ladybug"],["🐜","ant"],["🪲","beetle"],
+        ["🐢","turtle"],["🐍","snake"],["🦎","lizard"],["🦂","scorpion"],["🐙","octopus"],
+        ["🦑","squid"],["🐠","fish"],["🐟","tropical fish"],["🐡","blowfish"],["🐬","dolphin"],
+        ["🐳","whale"],["🐋","humpback"],["🦈","shark"],["🐊","crocodile"],["🐅","tiger2"],
+        ["🐆","leopard"],["🦓","zebra"],["🦍","gorilla"],["🦧","orangutan"],["🐘","elephant"],
+        ["🦛","hippo"],["🦏","rhino"],["🐪","camel"],["🐫","two hump camel"],["🦒","giraffe"],
+        ["🦘","kangaroo"],["🦬","bison"],["🐃","water buffalo"],["🐂","ox"],["🐄","dairy cow"]
+      ],
+      "Food" => [
+        ["🍎","apple"],["🍐","pear"],["🍊","orange"],["🍋","lemon"],["🍌","banana"],
+        ["🍉","watermelon"],["🍇","grapes"],["🍓","strawberry"],["🫐","blueberry"],["🍈","melon"],
+        ["🍒","cherry"],["🍑","peach"],["🥭","mango"],["🍍","pineapple"],["🥥","coconut"],
+        ["🥝","kiwi"],["🍅","tomato"],["🥑","avocado"],["🌽","corn"],["🌶️","pepper"],
+        ["🥒","cucumber"],["🥕","carrot"],["🧄","garlic"],["🧅","onion"],["🥔","potato"],
+        ["🍞","bread"],["🥐","croissant"],["🥖","baguette"],["🧀","cheese"],["🥚","egg"],
+        ["🍳","cooking"],["🥞","pancakes"],["🧇","waffle"],["🥓","bacon"],["🍔","burger"],
+        ["🍟","fries"],["🍕","pizza"],["🌭","hotdog"],["🥪","sandwich"],["🌮","taco"],
+        ["🌯","burrito"],["🫔","tamale"],["🥗","salad"],["🍝","spaghetti"],["🍜","ramen"],
+        ["🍲","stew"],["🍛","curry"],["🍣","sushi"],["🍱","bento"],["🥟","dumpling"],
+        ["🍩","donut"],["🍪","cookie"],["🎂","cake"],["🍰","shortcake"],["🧁","cupcake"],
+        ["🍫","chocolate"],["🍬","candy"],["🍭","lollipop"],["🍮","custard"],["🍯","honey"],
+        ["☕","coffee"],["🍵","tea"],["🧃","juice box"],["🍺","beer"],["🍻","cheers"],
+        ["🥂","champagne"],["🍷","wine"],["🍸","cocktail"],["🍹","tropical drink"],["🧊","ice"]
+      ],
+      "Travel" => [
+        ["🏠","house"],["🏡","garden house"],["🏢","office"],["🏥","hospital"],["🏦","bank"],
+        ["🏨","hotel"],["🏪","store"],["🏫","school"],["🏬","department store"],["🏛️","classical"],
+        ["⛪","church"],["🕌","mosque"],["🕍","synagogue"],["⛩️","shinto"],["🕋","kaaba"],
+        ["⛲","fountain"],["🏕️","camping"],["🏖️","beach"],["🏜️","desert"],["🏝️","island"],
+        ["🏔️","mountain"],["⛰️","mountain2"],["🌋","volcano"],["🗻","fuji"],["🗼","tokyo tower"],
+        ["🗽","statue liberty"],["✈️","airplane"],["🛩️","small plane"],["🚀","rocket"],
+        ["🛸","ufo"],["🚁","helicopter"],["🚂","train"],["🚗","car"],["🚕","taxi"],
+        ["🚌","bus"],["🚲","bike"],["🛵","scooter"],["🚤","speedboat"],["⛵","sailboat"],
+        ["🚢","ship"],["⚓","anchor"],["🗺️","world map"],["🧭","compass"],["🌍","earth"],
+        ["🌎","earth americas"],["🌏","earth asia"],["🌙","moon"],["⭐","star"],["🌟","glowing star"],
+        ["☀️","sun"],["🌤️","partly sunny"],["⛅","cloudy"],["🌧️","rain"],["⛈️","storm"],
+        ["🌈","rainbow"],["☔","umbrella rain"],["❄️","snowflake"],["⛄","snowman"],["🔥","fire"],
+        ["💧","drop"],["🌊","wave"]
+      ],
+      "Objects" => [
+        ["⌚","watch"],["📱","phone"],["💻","laptop"],["⌨️","keyboard"],["🖥️","desktop"],
+        ["🖨️","printer"],["🖱️","mouse"],["💾","floppy"],["💿","cd"],["📷","camera"],
+        ["🎥","movie camera"],["📺","tv"],["📻","radio"],["🔔","bell"],["🔕","no bell"],
+        ["📢","megaphone"],["📣","horn"],["⏰","alarm"],["⏳","hourglass"],["🔋","battery"],
+        ["🔌","plug"],["💡","bulb"],["🔦","flashlight"],["🕯️","candle"],["🗑️","trash"],
+        ["🔑","key"],["🗝️","old key"],["🔒","lock"],["🔓","unlock"],["🔨","hammer"],
+        ["🪓","axe"],["⛏️","pick"],["🔧","wrench"],["🔩","nut bolt"],["⚙️","gear"],
+        ["📎","paperclip"],["✂️","scissors"],["📌","pin"],["📍","round pin"],["🖊️","pen"],
+        ["✏️","pencil"],["📝","memo"],["📁","folder"],["📂","open folder"],["📅","calendar"],
+        ["📊","chart"],["📈","chart up"],["📉","chart down"],["🗂️","card index"],
+        ["💰","money bag"],["💵","dollar"],["💴","yen"],["💶","euro"],["💷","pound"],
+        ["💎","gem"],["⚖️","scales"],["🧰","toolbox"],["🧲","magnet"],["🔗","link"],
+        ["📦","package"],["📫","mailbox"],["📬","mailbox flag"],["📧","email"],["📩","envelope arrow"],
+        ["🎁","gift"],["🎀","ribbon"],["🏷️","label"],["🔖","bookmark"]
+      ],
+      "Symbols" => [
+        ["✅","check"],["❌","cross"],["❓","question"],["❗","exclamation"],["‼️","double excl"],
+        ["⭕","circle"],["🚫","prohibited"],["🔴","red circle"],["🟠","orange circle"],
+        ["🟡","yellow circle"],["🟢","green circle"],["🔵","blue circle"],["🟣","purple circle"],
+        ["⚫","black circle"],["⚪","white circle"],["🟥","red square"],["🟧","orange square"],
+        ["🟨","yellow square"],["🟩","green square"],["🟦","blue square"],["🟪","purple square"],
+        ["⬛","black square"],["⬜","white square"],["🔶","orange diamond"],["🔷","blue diamond"],
+        ["🔺","red triangle"],["🔻","red triangle down"],["💠","diamond dot"],["🔘","radio button"],
+        ["✨","sparkles"],["⚡","zap"],["💥","boom"],["🎵","music"],["🎶","notes"],
+        ["➡️","right arrow"],["⬅️","left arrow"],["⬆️","up arrow"],["⬇️","down arrow"],
+        ["↗️","upper right"],["↘️","lower right"],["↙️","lower left"],["↖️","upper left"],
+        ["🔀","shuffle"],["🔁","repeat"],["🔂","repeat one"],["▶️","play"],["⏸️","pause"],
+        ["⏹️","stop"],["⏺️","record"],["⏭️","next track"],["⏮️","prev track"],
+        ["🔊","loud"],["🔇","mute"],["🔔","bell2"],["📌","pushpin"],
+        ["♻️","recycle"],["🏁","checkered flag"],["🚩","flag"],["🏳️","white flag"],
+        ["🏴","black flag"],["⚠️","warning"],["🛑","stop sign"],["⛔","no entry"],
+        ["♾️","infinity"],["💯","hundred"],["🆗","ok button"],["🆕","new"],["🆓","free"],
+        ["ℹ️","info"],["🔤","abc"],["🔢","numbers"],["#️⃣","hash"],["*️⃣","asterisk"],
+        ["0️⃣","zero"],["1️⃣","one"],["2️⃣","two"],["3️⃣","three"],["©️","copyright"],
+        ["®️","registered"],["™️","trademark"]
+      ],
+      "Flags" => [
+        ["🇳🇴","norway"],["🇸🇪","sweden"],["🇩🇰","denmark"],["🇫🇮","finland"],["🇮🇸","iceland"],
+        ["🇬🇧","uk"],["🇺🇸","usa"],["🇨🇦","canada"],["🇦🇺","australia"],["🇳🇿","new zealand"],
+        ["🇩🇪","germany"],["🇫🇷","france"],["🇪🇸","spain"],["🇮🇹","italy"],["🇵🇹","portugal"],
+        ["🇳🇱","netherlands"],["🇧🇪","belgium"],["🇨🇭","switzerland"],["🇦🇹","austria"],
+        ["🇵🇱","poland"],["🇨🇿","czech"],["🇬🇷","greece"],["🇹🇷","turkey"],["🇷🇺","russia"],
+        ["🇺🇦","ukraine"],["🇯🇵","japan"],["🇰🇷","south korea"],["🇨🇳","china"],["🇮🇳","india"],
+        ["🇧🇷","brazil"],["🇲🇽","mexico"],["🇦🇷","argentina"],["🇿🇦","south africa"],
+        ["🇪🇬","egypt"],["🇮🇱","israel"],["🇸🇦","saudi"],["🇦🇪","uae"],["🇹🇭","thailand"],
+        ["🇻🇳","vietnam"],["🇮🇩","indonesia"],["🇵🇭","philippines"],["🇲🇾","malaysia"],
+        ["🇸🇬","singapore"],["🇭🇰","hong kong"],["🇹🇼","taiwan"],["🏳️‍🌈","rainbow flag"],
+        ["🏴‍☠️","pirate flag"],["🎌","crossed flags"],["🏁","checkered"]
+      ]
+    }.freeze
+
+    CELL_W = 4  # Each emoji cell = 4 terminal columns (space + emoji + space)
+
+    # Main entry point: opens picker overlay, returns emoji string or nil
+    def self.pick(parent_pane)
+      max_h, max_w = IO.console ? IO.console.winsize : [24, 80]
+
+      cols = 11
+      ow = cols * CELL_W + 4
+      oh = [max_h - 4, 22].min
+      return nil if oh < 8
+
+      ox = (max_w - ow) / 2 + 1
+      oy = (max_h - oh) / 2 + 1
+
+      overlay = Rcurses::Popup.new(x: ox, y: oy, w: ow, h: oh, fg: 255, bg: 236)
+      overlay.scroll = false
+
+      categories = CATEGORIES.keys
+      cat_idx = 0
+      sel_idx = 0
+      search = ""
+
+      fmt = "255,236"
+
+      begin
+        loop do
+          # Determine items for current category or search
+          if search.empty?
+            items = CATEGORIES[categories[cat_idx]]
+          else
+            items = CATEGORIES.values.flatten(1).select { |_e, k|
+              k.include?(search.downcase)
+            }
+          end
+
+          total = items.size
+          sel_idx = sel_idx.clamp(0, [total - 1, 0].max)
+
+          # === Build pane text (header + blank grid area + footer) ===
+          lines = []
+
+          # Header: category tabs (wrapped to fit)
+          header_lines = 0
+          if search.empty?
+            tab_rows = [[]]
+            row_w = 0
+            categories.each_with_index do |c, i|
+              tab = " #{c} "
+              tw = tab.length
+              if row_w + tw > ow && !tab_rows.last.empty?
+                tab_rows << []
+                row_w = 0
+              end
+              tab_rows.last << (i == cat_idx ? tab.b.r : tab)
+              row_w += tw
+            end
+            tab_rows.each { |tr| lines << tr.join("") }
+            header_lines = tab_rows.size
+          else
+            lines << " Search: #{search}".b
+            header_lines = 1
+          end
+          lines << ""
+          header_lines += 1  # blank separator
+
+          # Blank lines for grid area (pane fills bg color)
+          grid_rows = (total + cols - 1) / cols
+          grid_rows.times { lines << "" }
+
+          # Pad remaining space
+          while lines.size < oh - 3
+            lines << ""
+          end
+
+          # Footer
+          lines << ""
+          if total > 0 && items[sel_idx]
+            lines << " :#{items[sel_idx][1]}:".fg(245)
+          else
+            lines << ""
+          end
+
+          overlay.text = lines.join("\n")
+          overlay.ix = 0
+          overlay.full_refresh
+          overlay.border_refresh
+
+          # === Render emoji grid at explicit cursor positions ===
+          # This bypasses display_width entirely for grid alignment
+          flat_i = 0
+          items.each_slice(cols) do |row|
+            grid_row = flat_i / cols
+            abs_row = oy + header_lines + grid_row
+            row.each_with_index do |(emoji, _keyword), col_i|
+              abs_col = ox + col_i * CELL_W
+              STDOUT.print "\e[#{abs_row};#{abs_col}H"
+              if flat_i == sel_idx
+                STDOUT.print " #{emoji} ".c("236,255")  # Inverted colors
+              else
+                STDOUT.print " #{emoji} ".c(fmt)
+              end
+              flat_i += 1
+            end
+          end
+          STDOUT.flush
+
+          # Input
+          chr = getchr(flush: false)
+          case chr
+          when 'ESC'
+            return nil
+          when 'ENTER'
+            return (total > 0 && items[sel_idx]) ? items[sel_idx][0] : nil
+          when 'RIGHT'
+            sel_idx = [sel_idx + 1, total - 1].min if total > 0
+          when 'LEFT'
+            sel_idx = [sel_idx - 1, 0].max
+          when 'UP'
+            sel_idx = [sel_idx - cols, 0].max
+          when 'DOWN'
+            sel_idx = [sel_idx + cols, total - 1].min if total > 0
+          when 'TAB'
+            if search.empty?
+              cat_idx = (cat_idx + 1) % categories.size
+              sel_idx = 0
+            end
+          when 'S-TAB'
+            if search.empty?
+              cat_idx = (cat_idx - 1) % categories.size
+              sel_idx = 0
+            end
+          when 'BACK'
+            if search.length > 0
+              search = search[0..-2]
+              sel_idx = 0
+            end
+          when /^.$/
+            search << chr
+            sel_idx = 0
+          end
+        end
+      ensure
+        overlay.cleanup if overlay.respond_to?(:cleanup)
+      end
+    end
+  end
+end

data/lib/rcurses/general.rb

@@ -58,32 +58,109 @@ module Rcurses
     end
   end
   
-  # Simple, fast display_width function (like original 4.8.3)
+  # Simple, fast display_width function
   def self.display_width(str)
     return 0 if str.nil? || str.empty?
-    
+
     width = 0
+    prev_regional = false
+    after_zwj = false       # Next visible char is joined (zero-width)
+    last_was_narrow = false # Previous visible char was 1-wide (for ZWJ promotion)
     str.each_char do |char|
       cp = char.ord
-      if cp == 0
-        # NUL – no width
-      elsif cp < 32 || (cp >= 0x7F && cp < 0xA0)
-        # Control characters: no width
-        width += 0
-      # Approximate common wide ranges:
+
+      # Variation selectors: always zero-width
+      # FE0F/FE0E behavior is terminal-dependent; treating as zero-width
+      # matches libc wcwidth and avoids grid misalignment.
+      next if cp == 0xFE0F || cp == 0xFE0E
+
+      # Zero-width: skin tones, tags, combining marks, keycaps
+      if (cp >= 0x1F3FB && cp <= 0x1F3FF) ||       # Skin tone modifiers
+         (cp >= 0xE0020 && cp <= 0xE007F) ||       # Tag characters (flag subdivisions)
+         cp == 0xE0001 || cp == 0x200C ||           # Other zero-width
+         (cp >= 0x20D0 && cp <= 0x20FF) ||         # Combining diacritical marks for symbols
+         cp == 0x20E3                               # Combining enclosing keycap
+        next
+      end
+
+      # ZWJ: next visible character merges into current glyph
+      if cp == 0x200D
+        # ZWJ sequences always render as 2-wide emoji.
+        # If the base character was narrow (e.g. ❤ in ❤️‍🔥), promote to 2.
+        if last_was_narrow
+          width += 1
+          last_was_narrow = false
+        end
+        after_zwj = true
+        next
+      end
+
+      if cp == 0 || cp < 32 || (cp >= 0x7F && cp < 0xA0)
+        # NUL and control characters: no width
+        last_was_narrow = false
+      # Regional indicator symbols (flags): pair = one 2-wide glyph
+      elsif cp >= 0x1F1E6 && cp <= 0x1F1FF
+        if prev_regional
+          prev_regional = false
+          after_zwj = false
+          next
+        else
+          prev_regional = true
+          width += 2 unless after_zwj
+          after_zwj = false
+          next
+        end
+      # Wide character ranges (CJK, emoji, etc):
       elsif (cp >= 0x1100 && cp <= 0x115F) ||
             cp == 0x2329 || cp == 0x232A ||
+            (cp >= 0x231A && cp <= 0x231B) ||   # Watch, hourglass
+            (cp >= 0x23E9 && cp <= 0x23F3) ||   # Various symbols
+            (cp >= 0x23F8 && cp <= 0x23FA) ||   # Play/pause symbols
+            (cp >= 0x25FD && cp <= 0x25FE) ||   # Medium squares
+            (cp >= 0x2614 && cp <= 0x2615) ||   # Umbrella, hot beverage
+            (cp >= 0x2648 && cp <= 0x2653) ||   # Zodiac signs
+            cp == 0x267F || cp == 0x2693 ||     # Wheelchair, anchor
+            cp == 0x26A1 || cp == 0x26AA ||     # High voltage, circles
+            cp == 0x26AB || cp == 0x26BD ||
+            cp == 0x26BE || cp == 0x26C4 ||
+            cp == 0x26C5 || cp == 0x26CE ||
+            cp == 0x26D4 || cp == 0x26EA ||
+            (cp >= 0x26F2 && cp <= 0x26F3) ||
+            cp == 0x26F5 || cp == 0x26FA ||
+            cp == 0x26FD ||
+            cp == 0x2705 ||                            # ✅
+            (cp >= 0x270A && cp <= 0x270B) ||          # ✊✋
+            cp == 0x2728 ||                            # ✨
+            cp == 0x274C || cp == 0x274E ||            # ❌❎
+            (cp >= 0x2753 && cp <= 0x2755) ||          # ❓❔❕
+            cp == 0x2757 ||                            # ❗
+            (cp >= 0x2795 && cp <= 0x2797) ||          # ➕➖➗
+            cp == 0x27B0 || cp == 0x27BF ||            # ➰➿
+            (cp >= 0x2B1B && cp <= 0x2B1C) ||          # ⬛⬜
+            cp == 0x2B50 || cp == 0x2B55 ||            # ⭐⭕
+            cp == 0x3030 || cp == 0x303D ||
+            cp == 0x3297 || cp == 0x3299 ||
             (cp >= 0x2E80 && cp <= 0xA4CF) ||
             (cp >= 0xAC00 && cp <= 0xD7A3) ||
             (cp >= 0xF900 && cp <= 0xFAFF) ||
             (cp >= 0xFE10 && cp <= 0xFE19) ||
             (cp >= 0xFE30 && cp <= 0xFE6F) ||
             (cp >= 0xFF00 && cp <= 0xFF60) ||
-            (cp >= 0xFFE0 && cp <= 0xFFE6)
-        width += 2
+            (cp >= 0xFFE0 && cp <= 0xFFE6) ||
+            (cp >= 0x1F000 && cp <= 0x1FFFF) ||  # All emoji blocks
+            (cp >= 0x20000 && cp <= 0x2FFFF)     # CJK Extension B+
+        width += 2 unless after_zwj
+        last_was_narrow = false
       else
-        width += 1
+        unless after_zwj
+          width += 1
+          last_was_narrow = true
+        else
+          last_was_narrow = false
+        end
       end
+      prev_regional = false
+      after_zwj = false
     end
     width
   end

data/lib/rcurses/input.rb

@@ -13,7 +13,7 @@ module Rcurses
         # 2) If it's ESC, grab any quick trailing bytes
         seq = c
         if c == "\e"
-          if IO.select([$stdin], nil, nil, 0.05)
+          if IO.select([$stdin], nil, nil, 0.15)
             begin
               seq << $stdin.read_nonblock(16)
             rescue IO::WaitReadable, EOFError

data/lib/rcurses/pane.rb

@@ -3,11 +3,15 @@ module Rcurses
     require 'clipboard'  # Ensure the 'clipboard' gem is installed
     include Cursor
     include Input
-    attr_accessor :x, :y, :w, :h, :fg, :bg, :scroll_fg
+    attr_accessor :x, :y, :w, :h, :scroll_fg
+    attr_reader :fg, :bg
     attr_accessor :border, :scroll, :text, :ix, :index, :align, :prompt
     attr_accessor :moreup, :moredown
     attr_accessor :record, :history
     attr_accessor :multiline_buffer
+    attr_accessor :update
+    attr_accessor :emoji
+    attr_accessor :emoji_refresh  # Optional callback to redraw UI after emoji picker closes
 
     def initialize(x = 1, y = 1, w = 1, h = 1, fg = nil, bg = nil)
       @max_h, @max_w = IO.console ? IO.console.winsize : [24, 80]
@@ -29,10 +33,27 @@ module Rcurses
       @max_history_size = 100  # Limit history to prevent memory leaks
       @scroll_fg  = nil    # Scroll indicator color (defaults to @fg)
       @multiline_buffer = []   # Buffer to store lines from multi-line paste
+      @update     = true   # When false, refresh is a no-op
+      @emoji      = false  # Opt-in: C-E opens emoji picker in editline
+      @emoji_refresh = nil  # Optional lambda to redraw UI after emoji picker
 
       ObjectSpace.define_finalizer(self, self.class.finalizer_proc)
     end
 
+    def fg=(value)
+      if @fg != value
+        @fg = value
+        @prev_frame = nil  # Force full repaint on color change
+      end
+    end
+
+    def bg=(value)
+      if @bg != value
+        @bg = value
+        @prev_frame = nil  # Force full repaint on color change
+      end
+    end
+
     def text=(new_text)
       if @record && @text
         @history << @text
@@ -176,6 +197,7 @@ module Rcurses
     # Diff-based refresh that minimizes flicker.
     # In this updated version we lazily process only the raw lines required to fill the pane.
     def refresh(cont = @text)
+      return @prev_frame&.join("\n") || "" unless @update
       begin
         @max_h, @max_w = IO.console.winsize
       rescue => e
@@ -253,7 +275,7 @@ module Rcurses
         
         raw_line = @raw_txt[@lazy_index]
         # If the raw line is short, no wrapping is needed.
-        if raw_line.respond_to?(:pure) && Rcurses.display_width(raw_line.pure) < @w
+        if raw_line.respond_to?(:pure) && Rcurses.display_width(raw_line.pure) <= @w
           processed = [raw_line]
         else
           processed = split_line_with_ansi(raw_line, @w)
@@ -344,19 +366,8 @@ module Rcurses
       # restore wrap, then also reset SGR and scroll-region one more time
       diff_buf << "\e[#{o_row};#{o_col}H\e[?7h\e[0m\e[r"
       begin
-        # Debug: check what's actually being printed
-        if diff_buf.include?("Purpose") && diff_buf.include?("[38;5;")
-          File.open("/tmp/rcurses_debug.log", "a") do |f|
-            f.puts "=== PRINT DEBUG ==="
-            f.puts "diff_buf sample: #{diff_buf[0..200].inspect}"
-            f.puts "Has escape byte 27: #{diff_buf.bytes.include?(27)}"
-            f.puts "Escape count: #{diff_buf.bytes.count(27)}"
-          end
-        end
-        
         print diff_buf
       rescue => e
-        # If printing fails, at least try to restore terminal state
         begin
           print "\e[0m\e[?25h\e[?7h"
         rescue
@@ -618,6 +629,7 @@ module Rcurses
         print @prompt.c(fmt)
         prompt_len = @prompt.pure.length
         content_len = @w - prompt_len
+        return nil if content_len < 1
         cont = @text.pure.slice(0, content_len)
         @pos = cont.length
         chr = ''
@@ -626,15 +638,31 @@ module Rcurses
 
         while chr != 'ESC'
           col(@x + prompt_len)
-          cont = cont.slice(0, content_len)
+          # Truncate content to fit display width
+          disp_w = Rcurses.display_width(cont)
+          while disp_w > content_len && cont.length > 0
+            cont = cont[0..-2]
+            disp_w = Rcurses.display_width(cont)
+          end
+          @pos = cont.length if @pos > cont.length
           # Show indicator if multiline content detected
           display_cont = cont
           if @multiline_buffer && !@multiline_buffer.empty?
             lines_indicator = " [+#{@multiline_buffer.size} lines]"
-            available = content_len - lines_indicator.length
-            display_cont = cont.slice(0, [available, 0].max) + lines_indicator if available > 0
+            available = content_len - Rcurses.display_width(lines_indicator)
+            if available > 0
+              # Truncate cont to fit indicator
+              trunc = cont
+              while Rcurses.display_width(trunc) > available && trunc.length > 0
+                trunc = trunc[0..-2]
+              end
+              display_cont = trunc + lines_indicator
+            end
           end
-          print display_cont.ljust(content_len).c(fmt)
+          # Pad to full width using spaces (each space = 1 column)
+          pad_needed = content_len - Rcurses.display_width(display_cont)
+          padded = display_cont + (" " * [pad_needed, 0].max)
+          print padded.c(fmt)
           # Calculate display width up to cursor position
           display_pos = @pos > 0 ? Rcurses.display_width(cont[0...@pos]) : 0
           col(@x + prompt_len + display_pos)
@@ -664,11 +692,10 @@ module Rcurses
             cont = ''
             @pos = 0
           when 'ENTER'
-            # If there are lines in multiline_buffer, handle multiline paste
+            # If there are lines in multiline_buffer, join all pasted lines
             if @multiline_buffer && !@multiline_buffer.empty?
-              # Add current line if it's not empty
               @multiline_buffer << cont.dup unless cont.empty?
-              @text = @multiline_buffer.shift # Return first line as @text
+              @text = @multiline_buffer.join("\n")
             else
               @text = cont
             end
@@ -689,6 +716,21 @@ module Rcurses
               cont = ""
               @pos = 0
             end
+          when 'C-E'
+            if @emoji
+              require_relative 'emoji' unless defined?(Rcurses::EmojiPicker)
+              picked = Rcurses::EmojiPicker.pick(self)
+              if picked
+                cont.insert(@pos, picked)
+                @pos += picked.length
+              end
+              # Redraw UI behind the overlay (full refresh to clear overlay artifacts)
+              @emoji_refresh.call if @emoji_refresh
+              # Redraw prompt line
+              row(@y)
+              col(@x)
+              print @prompt.c(fmt)
+            end
           when /^.$/
             if @pos < content_len
               cont.insert(@pos, chr)
@@ -696,9 +738,16 @@ module Rcurses
             end
           end
 
+          last_was_cr = false
           while IO.select([$stdin], nil, nil, 0)
             chr = $stdin.read_nonblock(1) rescue nil
             break unless chr
+            # Normalize \r\n to a single newline: skip \n after \r
+            if chr == "\n" && last_was_cr
+              last_was_cr = false
+              next
+            end
+            last_was_cr = (chr == "\r")
             # Handle newlines in multi-line paste (\n or \r)
             if chr == "\n" || chr == "\r"
               @multiline_buffer << cont.dup unless cont.empty?

data/lib/rcurses/popup.rb

@@ -0,0 +1,115 @@
+module Rcurses
+  class Popup < Pane
+    # Creates a popup overlay. Defaults to centered, bordered, dark background.
+    #
+    # Usage:
+    #   popup = Rcurses::Popup.new(w: 50, h: 20)          # auto-centered
+    #   popup = Rcurses::Popup.new(x: 10, y: 5, w: 50, h: 20)  # explicit position
+    #
+    #   # Simple modal (blocks until ESC/ENTER, returns selected line index or nil)
+    #   result = popup.modal(content_string)
+    #
+    #   # Manual control
+    #   popup.show(content_string)
+    #   # ... your own input loop ...
+    #   popup.dismiss(refresh_panes: [pane1, pane2])
+    #
+    def initialize(x: nil, y: nil, w: 40, h: 15, fg: 255, bg: 236)
+      max_h, max_w = IO.console ? IO.console.winsize : [24, 80]
+      # Auto-center if position not specified
+      px = x || ((max_w - w) / 2 + 1)
+      py = y || ((max_h - h) / 2 + 1)
+      super(px, py, w, h, fg, bg)
+      @border = true
+      @scroll = true
+    end
+
+    # Show content in the popup (non-blocking, just renders)
+    def show(content)
+      @text = content
+      @ix = 0
+      full_refresh
+    end
+
+    # Modal: show content, handle scroll/navigation, return on ESC or ENTER.
+    # Returns the selected line index on ENTER, or nil on ESC.
+    # Optional block receives each keypress for custom handling;
+    # return :dismiss from the block to close, or a String to return that value.
+    def modal(content, &on_key)
+      @text = content
+      @ix = 0
+      @index = 0
+
+      loop do
+        full_refresh
+
+        chr = getchr(flush: false)
+        case chr
+        when 'ESC'
+          return nil
+        when 'ENTER'
+          return @index
+        when 'UP', 'k'
+          @index = [@index - 1, 0].max
+          scroll_to_index
+        when 'DOWN', 'j'
+          total = (@text || "").split("\n").size
+          @index = [@index + 1, total - 1].min
+          scroll_to_index
+        when 'PgUP'
+          @index = [@index - @h + 1, 0].max
+          scroll_to_index
+        when 'PgDOWN'
+          total = (@text || "").split("\n").size
+          @index = [@index + @h - 1, total - 1].min
+          scroll_to_index
+        when 'HOME'
+          @index = 0
+          @ix = 0
+        when 'END'
+          total = (@text || "").split("\n").size
+          @index = [total - 1, 0].max
+          scroll_to_index
+        end
+
+        # Custom key handler
+        if block_given?
+          result = on_key.call(chr, @index)
+          return nil if result == :dismiss
+          return result if result.is_a?(String)
+        end
+      end
+    end
+
+    # Clear the popup area and optionally refresh underlying panes
+    def dismiss(refresh_panes: [])
+      clear_area
+      refresh_panes.each do |p|
+        p.full_refresh if p.respond_to?(:full_refresh)
+      end
+    end
+
+    # Blank the screen region occupied by this popup (including border)
+    def clear_area
+      top = @y - (@border ? 1 : 0)
+      bot = @y + @h - 1 + (@border ? 1 : 0)
+      left = @x - (@border ? 1 : 0)
+      width = @w + (@border ? 2 : 0)
+      (top..bot).each do |row|
+        STDOUT.print "\e[#{row};#{left}H\e[0m#{' ' * width}"
+      end
+      STDOUT.flush
+    end
+
+    private
+
+    def scroll_to_index
+      # Keep selected index visible in the pane
+      if @index < @ix
+        @ix = @index
+      elsif @index >= @ix + @h
+        @ix = @index - @h + 1
+      end
+    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:    6.1.1: Added optional error logging with RCURSES_ERROR_LOG=1
+# Version:    6.2.0: Popup widget, emoji picker, pane color cache, stdin flush
 
 require 'io/console' # Basic gem for rcurses
 require 'io/wait'    # stdin handling
@@ -16,6 +16,7 @@ require_relative 'rcurses/general'
 require_relative 'rcurses/cursor'
 require_relative 'rcurses/input'
 require_relative 'rcurses/pane'
+require_relative 'rcurses/popup'
 
 module Rcurses
   class << self
@@ -68,6 +69,10 @@ module Rcurses
         trap(sig) { cleanup!; exit }
       end
 
+      # Flush any pending stdin data (terminal position responses, etc.)
+      # This prevents cursor query responses from blocking the first getchr
+      $stdin.getc while $stdin.wait_readable(0)
+
       @initialized = true
     end
 
@@ -171,7 +176,7 @@ module Rcurses
           f.puts "Program: #{$0}"
           f.puts "Working Directory: #{Dir.pwd}"
           f.puts "Ruby Version: #{RUBY_VERSION}"
-          f.puts "Rcurses Version: 6.1.1"
+          f.puts "Rcurses Version: 6.2.0"
           f.puts "=" * 60
           f.puts "Error Class: #{error.class}"
           f.puts "Error Message: #{error.message}"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rcurses
 version: !ruby/object:Gem::Version
-  version: 6.1.8
+  version: 6.2.0
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-03 00:00:00.000000000 Z
+date: 2026-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: clipboard
@@ -29,9 +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. VERSION 6.0.0 BREAKING CHANGE: Apps
-  must now explicitly call Rcurses.init! - auto-initialization has been removed for
-  Ruby 3.4+ compatibility.'
+  in panes. Cursor movement around the terminal. 6.2.0: Popup widget, emoji picker,
+  pane color cache invalidation, stdin flush, Unicode display_width fixes.'
 email: g@isene.com
 executables: []
 extensions: []
@@ -41,11 +40,15 @@ files:
 - README.md
 - examples/basic_panes.rb
 - examples/focus_panes.rb
+- img/rcurses-emoji.png
+- img/rcurses-logo.png
 - lib/rcurses.rb
 - lib/rcurses/cursor.rb
+- lib/rcurses/emoji.rb
 - lib/rcurses/general.rb
 - lib/rcurses/input.rb
 - lib/rcurses/pane.rb
+- lib/rcurses/popup.rb
 - lib/string_extensions.rb
 homepage: https://isene.com/
 licenses: