ratatui_ruby 0.7.1 → 0.7.2

data/examples/{widget_popup_demo → widget_popup}/README.md

@@ -3,9 +3,9 @@ SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
 SPDX-License-Identifier: CC-BY-SA-4.0
 -->
 
-# Popup (Clear) Widget Example
+# Clear (Popup, Modal) Example
 
-[![widget_popup_demo](../../doc/images/widget_popup_demo.png)](app.rb)
+[![widget_popup](../../doc/images/widget_popup.png)](app.rb)
 
 Demonstrates how to render opaque overlays on top of content.
 
@@ -25,12 +25,15 @@ Terminal renders are additive. If you draw a new widget over an old one, the bac
 ## Usage
 
 ```bash
-ruby examples/widget_popup_demo/app.rb
+ruby examples/widget_popup/app.rb
 ```
 
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Create a modal dialog (Confirm, Alert, Form).
 - Implement a dropdown menu that overlays other content.
-- Fix visual artifacts where old text shows through new widgets.
+- Fix visual artifacts where old text shows through new widgets.
+
+[Read the source code →](app.rb)

data/examples/{widget_popup_demo → widget_popup}/app.rb

@@ -1,15 +1,17 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"
 
-# Popup Demo Example
+# Popup Example
 # Demonstrates the Clear widget for creating opaque popups.
 
-class WidgetPopupDemo
+class WidgetPopup
   def initialize
     @clear_enabled = false
   end
@@ -75,7 +77,7 @@ class WidgetPopupDemo
       text: popup_text,
       alignment: :center,
       block: tui.block(
-        title: "Popup Demo (q to quit, space to toggle)",
+        title: "Popup (q to quit, space to toggle)",
         borders: [:all]
       )
     )
@@ -101,4 +103,4 @@ class WidgetPopupDemo
   end
 end
 
-WidgetPopupDemo.new.run if __FILE__ == $0
+WidgetPopup.new.run if __FILE__ == $0

data/examples/{widget_ratatui_logo_demo → widget_ratatui_logo}/README.md

@@ -5,7 +5,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0
 
 # Ratatui Logo Example
 
-[![widget_ratatui_logo_demo](../../doc/images/widget_ratatui_logo_demo.png)](app.rb)
+[![widget_ratatui_logo](../../doc/images/widget_ratatui_logo.png)](app.rb)
 
 Demonstrates branding with the official logo widget.
 
@@ -23,12 +23,15 @@ A polished application often needs an "About" screen or a splash screen. This wi
 ## Usage
 
 ```bash
-ruby examples/widget_ratatui_logo_demo/app.rb
+ruby examples/widget_ratatui_logo/app.rb
 ```
 
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Create a splash screen.
 - Add an "About" modal to your application.
-- See how to center a widget both vertically and horizontally.
+- See how to center a widget both vertically and horizontally.
+
+[Read the source code →](app.rb)

data/examples/{widget_ratatui_logo_demo → widget_ratatui_logo}/app.rb

@@ -1,8 +1,10 @@
+# frozen_string_literal: true
+
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 #
 # SPDX-License-Identifier: AGPL-3.0-or-later
-
-# frozen_string_literal: true
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"
@@ -19,10 +21,10 @@ require "ratatui_ruby"
 #
 # Run the demo from the terminal:
 #
-#   ruby examples/widget_ratatui_logo_demo/app.rb
+#   ruby examples/widget_ratatui_logo/app.rb
 #
-# rdoc-image:/doc/images/widget_ratatui_logo_demo.png
-class WidgetRatatuiLogoDemo
+# rdoc-image:/doc/images/widget_ratatui_logo.png
+class WidgetRatatuiLogo
   def run
     RatatuiRuby.run do |tui|
       loop do
@@ -100,4 +102,4 @@ class WidgetRatatuiLogoDemo
   end
 end
 
-WidgetRatatuiLogoDemo.new.run if __FILE__ == $0
+WidgetRatatuiLogo.new.run if __FILE__ == $0

data/examples/{widget_ratatui_mascot_demo → widget_ratatui_mascot}/README.md

@@ -5,7 +5,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0
 
 # Ratatui Mascot Example
 
-[![widget_ratatui_mascot_demo](../../doc/images/widget_ratatui_mascot_demo.png)](app.rb)
+[![widget_ratatui_mascot](../../doc/images/widget_ratatui_mascot.png)](app.rb)
 
 Demonstrates the project mascot widget for adding personality.
 
@@ -24,11 +24,14 @@ Interfaces can feel clinical. A friendly mascot adds charm and brand identity to
 ## Usage
 
 ```bash
-ruby examples/widget_ratatui_mascot_demo/app.rb
+ruby examples/widget_ratatui_mascot/app.rb
 ```
 
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Add visual flair to your UI.
-- Create a friendly empty state or success screen.
+- Create a friendly empty state or success screen.
+
+[Read the source code →](app.rb)

data/examples/{widget_ratatui_mascot_demo → widget_ratatui_mascot}/app.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: CC-BY-SA-4.0
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"
@@ -18,10 +20,10 @@ require "ratatui_ruby"
 #
 # Run the demo from the terminal:
 #
-#   ruby examples/widget_ratatui_mascot_demo/app.rb
+#   ruby examples/widget_ratatui_mascot/app.rb
 #
-# rdoc-image:/doc/images/widget_ratatui_mascot_demo.png
-class WidgetRatatuiMascotDemo
+# rdoc-image:/doc/images/widget_ratatui_mascot.png
+class WidgetRatatuiMascot
   def initialize
     @show_block = true
   end
@@ -90,4 +92,4 @@ class WidgetRatatuiMascotDemo
   end
 end
 
-WidgetRatatuiMascotDemo.new.run if __FILE__ == $PROGRAM_NAME
+WidgetRatatuiMascot.new.run if __FILE__ == $PROGRAM_NAME

data/examples/widget_rect/README.md

@@ -3,7 +3,7 @@ SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
 SPDX-License-Identifier: CC-BY-SA-4.0
 -->
 
-# Rect (Geometry) Widget Example
+# Rect (Area, Rectangle) Example
 
 [![widget_rect](../../doc/images/widget_rect.png)](app.rb)
 
@@ -33,6 +33,9 @@ ruby examples/widget_rect/app.rb
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Handle mouse clicks on specific buttons or areas.
 - Create resizable panes (like a split pane in an IDE).
-- Debug layout issues by inspecting Rect coordinates.
+- Debug layout issues by inspecting Rect coordinates.
+
+[Read the source code →](app.rb)

data/examples/widget_rect/app.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"

data/examples/widget_render/README.md

@@ -32,6 +32,9 @@ ruby examples/widget_render/app.rb
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Build a game (Snake, Tetris) inside the terminal.
 - Create a specialized visualization (Network topology graph).
-- Draw custom UI elements not provided by the library.
+- Draw custom UI elements not provided by the library.
+
+[Read the source code →](app.rb)

data/examples/widget_render/app.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"

data/examples/widget_rich_text/README.md

@@ -30,6 +30,9 @@ ruby examples/widget_rich_text/app.rb
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Highlight keywords in code (Syntax highlighting).
 - Create status lines with icons (e.g., "✔ Success" where the checkmark is green).
-- Emphasize specific data points in a paragraph.
+- Emphasize specific data points in a paragraph.
+
+[Read the source code →](app.rb)

data/examples/widget_rich_text/app.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"

data/examples/widget_scroll_text/README.md

@@ -32,6 +32,9 @@ ruby examples/widget_scroll_text/app.rb
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Build a log viewer.
 - Create a "terms and conditions" scrollbox.
-- Display code snippets that might be wider than the terminal.
+- Display code snippets that might be wider than the terminal.
+
+[Read the source code →](app.rb)

data/examples/widget_scroll_text/app.rb

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"
 
-# Demo: Scrollable Paragraph
+# Scrollable Paragraph
 # Shows how to scroll through long text content using arrow keys
 #
 # Helper: Disable experimental warnings since we use line_count/line_width

data/examples/{widget_scrollbar_demo → widget_scrollbar}/README.md

@@ -3,9 +3,9 @@ SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
 SPDX-License-Identifier: CC-BY-SA-4.0
 -->
 
-# Scrollbar Widget Example
+# Scrollbar (Scroll) Example
 
-[![widget_scrollbar_demo](../../doc/images/widget_scrollbar_demo.png)](app.rb)
+[![widget_scrollbar](../../doc/images/widget_scrollbar.png)](app.rb)
 
 Demonstrates explicit scrollbars for navigation feedback.
 
@@ -27,11 +27,14 @@ Content overflows. Users get lost in long lists. Scrollbars provide essential sp
 ## Usage
 
 ```bash
-ruby examples/widget_scrollbar_demo/app.rb
+ruby examples/widget_scrollbar/app.rb
 ```
 
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Add visual scroll indicators to Lists or Tables.
-- Implement specialized inputs like sliders or volume controls.
+- Implement specialized inputs like sliders or volume controls.
+
+[Read the source code →](app.rb)

data/examples/{widget_scrollbar_demo → widget_scrollbar}/app.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"
@@ -18,10 +20,10 @@ require "ratatui_ruby"
 #
 # Run the demo from the terminal:
 #
-#   ruby examples/widget_scrollbar_demo/app.rb
+#   ruby examples/widget_scrollbar/app.rb
 #
-# rdoc-image:/doc/images/widget_scrollbar_demo.png
-class WidgetScrollbarDemo
+# rdoc-image:/doc/images/widget_scrollbar.png
+class WidgetScrollbar
   def initialize
     @scroll_position = 0
     @content_length = 50
@@ -150,4 +152,4 @@ class WidgetScrollbarDemo
   end
 end
 
-WidgetScrollbarDemo.new.run if __FILE__ == $PROGRAM_NAME
+WidgetScrollbar.new.run if __FILE__ == $PROGRAM_NAME

data/examples/{widget_sparkline_demo → widget_sparkline}/README.md

@@ -5,7 +5,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0
 
 # Sparkline Widget Example
 
-[![widget_sparkline_demo](../../doc/images/widget_sparkline_demo.png)](app.rb)
+[![widget_sparkline](../../doc/images/widget_sparkline.png)](app.rb)
 
 Demonstrates high-density data visualization in a condensed footprint.
 
@@ -31,12 +31,15 @@ Users need context. A single number ("90% CPU") tells you status, but not the tr
 ## Usage
 
 ```bash
-ruby examples/widget_sparkline_demo/app.rb
+ruby examples/widget_sparkline/app.rb
 ```
 
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Add a "CPU Load" graph to your header.
 - Visualize stock price trends in a list row.
-- Monitor memory usage over the last 60 seconds.
+- Monitor memory usage over the last 60 seconds.
+
+[Read the source code →](app.rb)

data/examples/{widget_sparkline_demo → widget_sparkline}/app.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"
@@ -18,10 +20,10 @@ require "ratatui_ruby"
 #
 # Run the demo from the terminal:
 #
-#   ruby examples/widget_sparkline_demo/app.rb
+#   ruby examples/widget_sparkline/app.rb
 #
-# rdoc-image:/doc/images/widget_sparkline_demo.png
-class WidgetSparklineDemo
+# rdoc-image:/doc/images/widget_sparkline.png
+class WidgetSparkline
   def run
     RatatuiRuby.run do |tui|
       @tui = tui
@@ -144,7 +146,7 @@ class WidgetSparklineDemo
       )
 
       frame.render_widget(
-        @tui.paragraph(text: "Sparkline Widget Demo - Cycle attributes with hotkeys"),
+        @tui.paragraph(text: "Sparkline Widget - Cycle attributes with hotkeys"),
         main_layout[0]
       )
 
@@ -272,4 +274,4 @@ class WidgetSparklineDemo
   end
 end
 
-WidgetSparklineDemo.new.run if __FILE__ == $PROGRAM_NAME
+WidgetSparkline.new.run if __FILE__ == $PROGRAM_NAME

data/examples/widget_style_colors/README.md

@@ -29,6 +29,9 @@ ruby examples/widget_style_colors/app.rb
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Create meaningful heatmaps.
 - Generate color palettes dynamically.
-- Test your terminal's color support capabilities.
+- Test your terminal's color support capabilities.
+
+[Read the source code →](app.rb)

data/examples/widget_style_colors/app.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"

data/examples/{widget_table_demo → widget_table}/README.md

@@ -3,9 +3,9 @@ SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 SPDX-License-Identifier: CC-BY-SA-4.0
 -->
 
-# Table Widget Example
+# Table (Row, Cell) Example
 
-[![widget_table_demo](../../doc/images/widget_table_demo.png)](app.rb)
+[![widget_table](../../doc/images/widget_table.png)](app.rb)
 
 Demonstrates advanced options for the `Table` widget, including selection, row-level highlighting, and column-level highlighting.
 
@@ -37,12 +37,15 @@ Data grids are complex. Users expect to navigate them with keys, select rows, an
 ## Usage
 
 ```bash
-ruby examples/widget_table_demo/app.rb
+ruby examples/widget_table/app.rb
 ```
 
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Build a file explorer or process list.
 - Create a data-heavy dashboard.
-- Handle conflicting style requirements (e.g., "Highlight this row, but make this error cell red").
+- Handle conflicting style requirements (e.g., "Highlight this row, but make this error cell red").
+
+[Read the source code →](app.rb)

data/examples/{widget_table_demo → widget_table}/app.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "bundler/setup"
@@ -18,7 +20,7 @@ PROCESSES = [
   { pid: 6789, name: "node", cpu: 18.9 },
 ].freeze
 
-class WidgetTableDemo
+class WidgetTable
   attr_reader :selected_index, :selected_col, :current_style_index, :column_spacing, :highlight_spacing, :column_highlight_style, :cell_highlight_style
 
   HIGHLIGHT_SPACINGS = [
@@ -250,5 +252,5 @@ class WidgetTableDemo
 end
 
 if __FILE__ == $0
-  WidgetTableDemo.new.run
+  WidgetTable.new.run
 end

data/examples/{widget_tabs_demo → widget_tabs}/README.md

@@ -5,7 +5,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0
 
 # Tabs Widget Example
 
-[![widget_tabs_demo](../../doc/images/widget_tabs_demo.png)](app.rb)
+[![widget_tabs](../../doc/images/widget_tabs.png)](app.rb)
 
 Demonstrates view segregation with interactive navigation.
 
@@ -30,12 +30,15 @@ Screen real estate is limited. You cannot show everything at once. Tabs segregat
 ## Usage
 
 ```bash
-ruby examples/widget_tabs_demo/app.rb
+ruby examples/widget_tabs/app.rb
 ```
 
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Build a multi-pane dashboard.
 - Create a "Settings" screen with different categories.
-- Implement a "wizard" interface with steps.
+- Implement a "wizard" interface with steps.
+
+[Read the source code →](app.rb)

data/examples/{widget_tabs_demo → widget_tabs}/app.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"
@@ -19,10 +21,10 @@ require "faker"
 #
 # Run the demo from the terminal:
 #
-#   ruby examples/widget_tabs_demo/app.rb
+#   ruby examples/widget_tabs/app.rb
 #
-# rdoc-image:/doc/images/widget_tabs_demo.png
-class WidgetTabsDemo
+# rdoc-image:/doc/images/widget_tabs.png
+class WidgetTabs
   def initialize
     @selected_tab = 0
     @tabs = ["Revenue", "Traffic", "Errors", "Quarterly"]
@@ -93,7 +95,7 @@ class WidgetTabsDemo
       tabs = @tui.tabs(
         titles: @tabs,
         selected_index: @selected_tab,
-        block: @tui.block(title: "Tabs Demo", borders: [:all]),
+        block: @tui.block(title: "Tabs", borders: [:all]),
         divider: @dividers[@divider_index],
         highlight_style: @highlight_styles[@highlight_style_index][:style],
         style: @base_styles[@base_style_index][:style],
@@ -178,4 +180,4 @@ class WidgetTabsDemo
   end
 end
 
-WidgetTabsDemo.new.run if __FILE__ == $0
+WidgetTabs.new.run if __FILE__ == $0

data/examples/widget_text_width/README.md

@@ -3,7 +3,7 @@ SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
 SPDX-License-Identifier: CC-BY-SA-4.0
 -->
 
-# Text Width Calculator
+# Text Width (Unicode Width) Calculator
 
 [![widget_text_width](../../doc/images/widget_text_width.png)](app.rb)
 
@@ -30,6 +30,9 @@ ruby examples/widget_text_width/app.rb
 ## Learning Outcomes
 
 Use this example if you need to...
+
 - Align text correctly in columns.
 - Truncate strings that are too long for a widget.
-- Build your own custom layout engine.
+- Build your own custom layout engine.
+
+[Read the source code →](app.rb)

data/examples/widget_text_width/app.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
 require "ratatui_ruby"

data/ext/ratatui_ruby/Cargo.lock

@@ -1012,7 +1012,7 @@ dependencies = [
 
 [[package]]
 name = "ratatui_ruby"
-version = "0.7.1"
+version = "0.7.2"
 dependencies = [
  "bumpalo",
  "lazy_static",

data/ext/ratatui_ruby/Cargo.toml

@@ -3,7 +3,7 @@
 
 [package]
 name = "ratatui_ruby"
-version = "0.7.1"
+version = "0.7.2"
 edition = "2021"
 
 [lib]

data/ext/ratatui_ruby/extconf.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 require "mkmf"
 require "rb_sys/mkmf"

data/ext/ratatui_ruby/src/widgets/barchart.rs

@@ -48,12 +48,14 @@ pub fn render(frame: &mut Frame, area: Rect, node: Value) -> Result<(), Error> {
             let group_obj: Value = array.entry(index)?;
 
             let label_val: Value = group_obj.funcall("label", ())?;
-            let label_str: String = if label_val.is_nil() {
-                String::new()
+            let group_label: Line = if label_val.is_nil() {
+                Line::from("")
+            } else if let Ok(line) = parse_line(label_val) {
+                line
             } else {
-                label_val.funcall("to_s", ())?
+                let label_str: String = label_val.funcall("to_s", ())?;
+                Line::from(label_str)
             };
-            let label_ref = bump.alloc_str(&label_str) as &str;
 
             let bars_array: RArray = group_obj.funcall("bars", ())?;
             let mut bars: Vec<Bar> = Vec::new();
@@ -110,8 +112,8 @@ pub fn render(frame: &mut Frame, area: Rect, node: Value) -> Result<(), Error> {
             }
 
             let mut group = BarGroup::new(bars);
-            if !label_ref.is_empty() {
-                group = group.label(Line::from(label_ref));
+            if !group_label.spans.is_empty() {
+                group = group.label(group_label);
             }
             bar_chart = bar_chart.data(group);
         }