ratatui_ruby 0.1.0 → 0.3.0

data/examples/scroll_text.rb

@@ -0,0 +1,74 @@
+#!/usr/bin/env ruby
+# 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
+# Shows how to scroll through long text content using arrow keys
+class ScrollTextDemo
+  def initialize
+    @scroll_x = 0
+    @scroll_y = 0
+    @lines = (1..100).map { |i| "Line #{i}: This is a long line of text that can be scrolled horizontally" }
+  end
+
+  def run
+    RatatuiRuby.init_terminal
+    begin
+      loop do
+        draw
+        break if handle_input == :quit
+      end
+    ensure
+      RatatuiRuby.restore_terminal
+    end
+  end
+
+  def render
+    draw
+  end
+
+  def handle_input
+    event = RatatuiRuby.poll_event
+    return nil unless event
+
+    if event[:type] == :key
+      case event[:code]
+      when "up"
+        @scroll_y = [@scroll_y - 1, 0].max
+      when "down"
+        @scroll_y = [@scroll_y + 1, @lines.length].min
+      when "left"
+        @scroll_x = [@scroll_x - 1, 0].max
+      when "right"
+        @scroll_x = [@scroll_x + 1, 100].min
+      when "q"
+        return :quit
+      end
+    end
+    nil
+  end
+
+  private
+
+  def draw
+    text = @lines.join("\n")
+    
+    paragraph = RatatuiRuby::Paragraph.new(
+      text: text,
+      scroll: [@scroll_y, @scroll_x],
+      block: RatatuiRuby::Block.new(
+        title: "Scrollable Text (X: #{@scroll_x}, Y: #{@scroll_y}) - Arrow keys to scroll, 'q' to quit",
+        borders: [:all]
+      )
+    )
+
+    RatatuiRuby.draw(paragraph)
+  end
+end
+
+ScrollTextDemo.new.run if __FILE__ == $PROGRAM_NAME

data/examples/stock_ticker.rb

@@ -3,7 +3,8 @@
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-require_relative "../lib/ratatui_ruby"
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "ratatui_ruby"
 
 # Simulate a stock ticker
 class StockTickerApp
@@ -58,14 +59,21 @@ class StockTickerApp
           style: RatatuiRuby::Style.new(fg: :cyan),
           block: RatatuiRuby::Block.new(title: "Network Activity", borders: :all)
         ),
-        RatatuiRuby::LineChart.new(
+        RatatuiRuby::Chart.new(
           datasets: [
             RatatuiRuby::Dataset.new(name: "RBY", data: @ruby_stock, color: :green),
             RatatuiRuby::Dataset.new(name: "RST", data: @rust_stock, color: :red),
           ],
-          x_labels: [@counter.to_s],
-          y_labels: %w[0 50 100],
-          y_bounds: [0.0, 100.0],
+          x_axis: RatatuiRuby::Axis.new(
+            title: "Time",
+            bounds: [((@counter > 100) ? @counter - 100.0 : 0.0), @counter.to_f],
+            labels: [@counter.to_s]
+          ),
+          y_axis: RatatuiRuby::Axis.new(
+            title: "Price",
+            bounds: [0.0, 100.0],
+            labels: %w[0 50 100]
+          ),
           block: RatatuiRuby::Block.new(title: "Stock Ticker", borders: :all),
         ),
       ]

data/examples/system_monitor.rb

@@ -3,7 +3,8 @@
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-require_relative "../lib/ratatui_ruby"
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "ratatui_ruby"
 
 class SystemMonitorApp
   def initialize

data/examples/table_select.rb

@@ -0,0 +1,70 @@
+#!/usr/bin/env ruby
+# 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"
+require "ratatui_ruby"
+
+# Sample process data
+PROCESSES = [
+  { pid: 1234, name: "ruby", cpu: 15.2 },
+  { pid: 5678, name: "postgres", cpu: 8.7 },
+  { pid: 9012, name: "nginx", cpu: 3.1 },
+  { pid: 3456, name: "redis", cpu: 12.4 },
+  { pid: 7890, name: "sidekiq", cpu: 22.8 },
+  { pid: 2345, name: "webpack", cpu: 45.3 },
+  { pid: 6789, name: "node", cpu: 18.9 }
+].freeze
+
+selected_index = 0
+
+RatatuiRuby.init_terminal
+
+begin
+  loop do
+    # Create table rows from process data
+    rows = PROCESSES.map { |p| [p[:pid].to_s, p[:name], "#{p[:cpu]}%"] }
+
+    # Define column widths
+    widths = [
+      RatatuiRuby::Constraint.length(8),
+      RatatuiRuby::Constraint.length(15),
+      RatatuiRuby::Constraint.length(10)
+    ]
+
+    # Create highlight style (yellow text)
+    highlight_style = RatatuiRuby::Style.new(fg: :yellow)
+
+    # Create table with selection
+    table = RatatuiRuby::Table.new(
+      header: ["PID", "Name", "CPU"],
+      rows: rows,
+      widths: widths,
+      selected_row: selected_index,
+      highlight_style: highlight_style,
+      highlight_symbol: "> ",
+      block: RatatuiRuby::Block.new(title: "Process Monitor (↑/↓ to select, q to quit)", borders: :all)
+    )
+
+    # Draw the table
+    RatatuiRuby.draw(table)
+
+    # Handle events
+    event = RatatuiRuby.poll_event
+    next unless event
+
+    case event[:code]
+    when "q"
+      break
+    when "down", "j"
+      selected_index = (selected_index + 1) % PROCESSES.length
+    when "up", "k"
+      selected_index = (selected_index - 1) % PROCESSES.length
+    end
+  end
+ensure
+  RatatuiRuby.restore_terminal
+end

data/examples/test_calendar_demo.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require "minitest/autorun"
+require "ratatui_ruby"
+
+module CalendarDemo
+  class TestCalendarDemo < Minitest::Test
+    def setup
+      RatatuiRuby.init_test_terminal(40, 20)
+    end
+
+    def test_demo_renders
+      # We can't easily test the loop in run, but we can test the rendering logic
+      now = Time.now
+      calendar = RatatuiRuby::Calendar.new(
+        year: now.year,
+        month: now.month,
+        header_style: RatatuiRuby::Style.new(fg: "yellow", modifiers: [:bold]),
+        block: RatatuiRuby::Block.new(title: " Calendar (q = quit) ", borders: [:all]),
+      )
+
+      # Constrain the calendar to 24x10 characters
+      view = RatatuiRuby::Layout.new(
+        direction: :vertical,
+        constraints: [
+          RatatuiRuby::Constraint.length(10),
+          RatatuiRuby::Constraint.min(0),
+        ],
+        children: [
+          RatatuiRuby::Layout.new(
+            direction: :horizontal,
+            constraints: [
+              RatatuiRuby::Constraint.length(24),
+              RatatuiRuby::Constraint.min(0),
+            ],
+            children: [calendar, nil],
+          ),
+          nil,
+        ],
+      )
+
+      RatatuiRuby.draw(view)
+      content = RatatuiRuby.get_buffer_content
+
+      assert_match(/Calendar \(q = quit\)/, content)
+      assert_match(/#{now.year}/, content)
+
+      # Verify the size constraint: the terminal is 40x20
+      # But the layout should be constrained to 24x10.
+      lines = content.split("\n")
+
+      # First 10 rows: first 24 chars can have content, 24..39 should be empty
+      10.times do |i|
+        assert_equal " " * 16, lines[i][24..39], "Row #{i} should be empty after column 24"
+      end
+
+      # Rows 10..19 should be completely empty
+      (10..19).each do |i|
+        assert_equal " " * 40, lines[i], "Row #{i} should be completely empty"
+      end
+    end
+  end
+end

data/examples/test_list_styles.rb

@@ -0,0 +1,61 @@
+# 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"
+require "ratatui_ruby/test_helper"
+require "minitest/autorun"
+require_relative "list_styles"
+
+class Minitest::Test
+  include RatatuiRuby::TestHelper
+end
+
+class TestListStyles < Minitest::Test
+  def setup
+    @app = ListStylesApp.new
+  end
+
+  def test_render_initial_state
+    with_test_terminal(50, 20) do
+      @app.render
+
+      assert buffer_content.any? { |line| line.include?(">> Item 1") }
+      assert buffer_content.any? { |line| line.include?("   Item 2") }
+    end
+  end
+
+  def test_navigation_down
+    inject_event("key", { code: "down" })
+    @app.handle_input
+
+    with_test_terminal(50, 20) do
+      @app.render
+      assert buffer_content.any? { |line| line.include?("   Item 1") }
+      assert buffer_content.any? { |line| line.include?(">> Item 2") }
+    end
+  end
+
+  def test_navigation_up
+    # Move down to Item 2
+    inject_event("key", { code: "down" })
+    @app.handle_input
+
+    # Move up back to Item 1
+    inject_event("key", { code: "up" })
+    @app.handle_input
+
+    with_test_terminal(50, 20) do
+      @app.render
+      assert buffer_content.any? { |line| line.include?(">> Item 1") }
+    end
+  end
+
+  def test_quit
+    inject_event("key", { code: "q" })
+    status = @app.handle_input
+    assert_equal :quit, status
+  end
+end

data/examples/test_popup_demo.rb

@@ -0,0 +1,62 @@
+# 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"
+require "ratatui_ruby/test_helper"
+require "minitest/autorun"
+require_relative "popup_demo"
+
+class Minitest::Test
+  include RatatuiRuby::TestHelper
+end
+
+class TestPopupDemo < Minitest::Test
+  def setup
+    @app = PopupDemo.new
+  end
+
+  def test_render_initial_state
+    with_test_terminal(60, 20) do
+      @app.render
+
+      # Should have background text
+      assert buffer_content.any? { |line| line.include?("BACKGROUND RED") }
+
+      # Should have popup with "Clear is DISABLED" message
+      assert buffer_content.any? { |line| line.include?("Clear is DISABLED") }
+      assert buffer_content.any? { |line| line.include?("Style Bleed: Popup is RED!") }
+    end
+  end
+
+  def test_toggle_clear
+    with_test_terminal(60, 20) do
+      # Initial state: Clear disabled
+      @app.render
+      assert buffer_content.any? { |line| line.include?("Clear is DISABLED") }
+
+      # Toggle Clear on
+      inject_event("key", { code: " " })
+      @app.handle_input
+
+      @app.render
+      assert buffer_content.any? { |line| line.include?("Clear is ENABLED") }
+      assert buffer_content.any? { |line| line.include?("Resets background to default") }
+
+      # Toggle Clear off
+      inject_event("key", { code: " " })
+      @app.handle_input
+
+      @app.render
+      assert buffer_content.any? { |line| line.include?("Clear is DISABLED") }
+    end
+  end
+
+  def test_quit
+    inject_event("key", { code: "q" })
+    status = @app.handle_input
+    assert_equal :quit, status
+  end
+end

data/examples/test_scroll_text.rb

@@ -0,0 +1,130 @@
+#!/usr/bin/env ruby
+# 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 "minitest/autorun"
+require "ratatui_ruby/test_helper"
+
+# Load the demo
+require_relative "./scroll_text"
+
+class TestScrollText < Minitest::Test
+  include RatatuiRuby::TestHelper
+
+  def setup
+    @demo = ScrollTextDemo.new
+  end
+
+  def test_demo_initialization
+    assert_instance_of ScrollTextDemo, @demo
+  end
+
+  def test_initial_rendering
+    with_test_terminal(60, 10) do
+      @demo.render
+      content = buffer_content
+      
+      # Should show Line 1 at the top (inside the block border)
+      assert content[1].include?("Line 1")
+      # Should show title with scroll position 0, 0
+      assert content[0].include?("X: 0, Y: 0")
+    end
+  end
+
+  def test_scroll_down
+    inject_event("key", { code: "down" })
+    @demo.handle_input
+    
+    with_test_terminal(60, 10) do
+      @demo.render
+      content = buffer_content
+      
+      # After scrolling down once, Line 2 should be at the top
+      assert content[1].include?("Line 2"), "Expected Line 2 at top, got: #{content[1]}"
+      # Line 1 should not be visible (scrolled off)
+      refute content.any? { |line| line.include?("Line 1") }, "Line 1 should be scrolled off"
+      # Should show Y scroll position 1
+      assert content[0].include?("Y: 1")
+    end
+  end
+
+  def test_scroll_right
+    inject_event("key", { code: "right" })
+    @demo.handle_input
+    
+    with_test_terminal(60, 10) do
+      @demo.render
+      content = buffer_content
+      
+      # After scrolling right once, first character should be cut off
+      # "Line 1:" becomes "ine 1:"
+      assert content[1].include?("ine 1:"), "Expected horizontal scroll, got: #{content[1]}"
+      # Should show X scroll position 1
+      assert content[0].include?("X: 1")
+    end
+  end
+
+  def test_scroll_left_at_edge
+    # Try to scroll left when already at x=0
+    inject_event("key", { code: "left" })
+    @demo.handle_input
+    
+    with_test_terminal(60, 10) do
+      @demo.render
+      content = buffer_content
+      
+      # Should still show full "Line 1:" (can't scroll left past 0)
+      assert content[1].include?("Line 1:")
+      # Should still show X scroll position 0
+      assert content[0].include?("X: 0")
+    end
+  end
+
+  def test_scroll_up_at_top
+    # Try to scroll up when already at top (should stay at 0)
+    inject_event("key", { code: "up" })
+    @demo.handle_input
+    
+    with_test_terminal(60, 10) do
+      @demo.render
+      content = buffer_content
+      
+      # Should still show Line 1 at top (can't scroll above 0)
+      assert content[1].include?("Line 1")
+      # Should still show Y scroll position 0
+      assert content[0].include?("Y: 0")
+    end
+  end
+
+  def test_scroll_both_axes
+    # Scroll down 2 times and right 3 times
+    2.times do
+      inject_event("key", { code: "down" })
+      @demo.handle_input
+    end
+    3.times do
+      inject_event("key", { code: "right" })
+      @demo.handle_input
+    end
+    
+    with_test_terminal(60, 10) do
+      @demo.render
+      content = buffer_content
+      
+      # After scrolling down 2 and right 3, Line 3 should be at top with first 3 chars cut
+      # "Line 3:" becomes " 3:"
+      assert content[1].include?(" 3:"), "Expected Line 3 scrolled right by 3, got: #{content[1]}"
+      # Should show scroll position X: 3, Y: 2
+      assert content[0].include?("X: 3, Y: 2")
+    end
+  end
+
+  def test_quit
+    inject_event("key", { code: "q" })
+    status = @demo.handle_input
+    assert_equal :quit, status
+  end
+end

data/examples/test_table_select.rb

@@ -0,0 +1,37 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require "test_helper"
+
+# Smoke test to ensure the table_select example can be loaded and instantiated
+class TestTableSelect < Minitest::Test
+  def test_table_select_smoke
+    # Verify the example can create a table with selection
+    rows = [["1", "test", "10%"]]
+    widths = [
+      RatatuiRuby::Constraint.length(8),
+      RatatuiRuby::Constraint.length(15),
+      RatatuiRuby::Constraint.length(10)
+    ]
+    
+    table = RatatuiRuby::Table.new(
+      header: ["PID", "Name", "CPU"],
+      rows: rows,
+      widths: widths,
+      selected_row: 0,
+      highlight_style: RatatuiRuby::Style.new(fg: :yellow),
+      highlight_symbol: "> ",
+      block: RatatuiRuby::Block.new(title: "Test", borders: :all)
+    )
+    
+    # Verify it can be drawn
+    with_test_terminal(40, 10) do
+      RatatuiRuby.draw(table)
+      # Just verify it doesn't crash
+      assert true
+    end
+  end
+end

data/ext/ratatui_ruby/.cargo/config.toml

@@ -6,3 +6,8 @@ rustflags = ["-C", "link-arg=-undefined", "-C", "link-arg=dynamic_lookup"]
 
 [target.x86_64-apple-darwin]
 rustflags = ["-C", "link-arg=-undefined", "-C", "link-arg=dynamic_lookup"]
+
+# Force dynamic linking on Alpine (musl) to fix "Dynamic loading not supported"
+# errors when bindgen tries to load libclang.
+[target.'cfg(target_env = "musl")']
+rustflags = ["-C", "target-feature=-crt-static"]