ratatui_ruby 0.3.1 → 0.5.0

data/examples/readme_usage.rb

@@ -1,21 +0,0 @@
-# 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"
-RatatuiRuby.main_loop do |tui|
-  tui.draw \
-    tui.paragraph \
-      text: "Hello, Ratatui! Press 'q' to quit.",
-      align: :center,
-      block: tui.block(
-        title: "My Ruby TUI App",
-        borders: [:all],
-        border_color: "cyan"
-      )
-  event = tui.poll_event
-  break if event && event[:type] == :key && event[:code] == "q"
-end

data/examples/scroll_text.rb

@@ -1,74 +0,0 @@
-#!/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/scrollbar_demo.rb

@@ -1,75 +0,0 @@
-# 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"
-
-# Simple Scrollbar Demo
-class ScrollbarDemo
-  def initialize
-    @scroll_position = 0
-    @content_length = 50
-    @lines = (1..@content_length).map { |i| "Line #{i}" }
-  end
-
-  def run
-    RatatuiRuby.init_terminal
-    begin
-      loop do
-        draw
-        event = RatatuiRuby.poll_event
-        break if event && event[:type] == :key && event[:code] == "q"
-
-        handle_event(event)
-      end
-    ensure
-      RatatuiRuby.restore_terminal
-    end
-  end
-
-  private def handle_event(event)
-    return unless event && event[:type] == :mouse
-
-    case event[:kind]
-    when :scroll_up
-      @scroll_position = [@scroll_position - 1, 0].max
-    when :scroll_down
-      @scroll_position = [@scroll_position + 1, @content_length].min
-    end
-  end
-
-  private def draw
-    # Calculate visible lines based on scroll position
-    # In a real app, you'd want to know the height of the available area.
-    # For this demo, we'll just show all lines but offset the text.
-    visible_lines = @lines[@scroll_position..-1] || []
-
-    # Paragraph with content
-    p = RatatuiRuby::Paragraph.new(
-      text: visible_lines.join("\n"),
-      block: RatatuiRuby::Block.new(title: "Scroll with Mouse Wheel", borders: [:all])
-    )
-
-    # Scrollbar on the right
-    s = RatatuiRuby::Scrollbar.new(
-      content_length: @content_length,
-      position: @scroll_position
-    )
-
-    # Use a Layout to place scrollbar on the right
-    layout = RatatuiRuby::Layout.new(
-      direction: :horizontal,
-      constraints: [
-        RatatuiRuby::Constraint.percentage(95),
-        RatatuiRuby::Constraint.percentage(5),
-      ],
-      children: [p, s]
-    )
-
-    RatatuiRuby.draw(layout)
-  end
-end
-
-ScrollbarDemo.new.run if __FILE__ == $PROGRAM_NAME

data/examples/stock_ticker.rb

@@ -1,93 +0,0 @@
-# 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"
-
-# Simulate a stock ticker
-class StockTickerApp
-  def initialize
-    @network_data = Array.new(50) { rand(0..10) }
-    @ruby_stock = []
-    @rust_stock = []
-    @counter = 0
-  end
-
-  def run
-    RatatuiRuby.init_terminal
-    begin
-      loop do
-        render
-        break if handle_input == :quit
-        sleep 0.1
-      end
-    ensure
-      RatatuiRuby.restore_terminal
-    end
-  end
-
-  def render
-    # Update data
-    @counter += 1
-    @network_data.shift
-    @network_data << rand(0..10)
-
-    ruby_val = 50.0 + (Math.sin(@counter * 0.1) * 20.0) + (rand * 5.0)
-    rust_val = 40.0 + (Math.cos(@counter * 0.2) * 15.0) + (rand * 10.0)
-
-    @ruby_stock << [@counter.to_f, ruby_val]
-    @rust_stock << [@counter.to_f, rust_val]
-
-    # Keep only last 100 points
-    if @ruby_stock.length > 100
-      @ruby_stock.shift
-      @rust_stock.shift
-    end
-
-    # Define UI
-    ui = RatatuiRuby::Layout.new(
-      direction: :vertical,
-      constraints: [
-        RatatuiRuby::Constraint.new(type: :percentage, value: 20),
-        RatatuiRuby::Constraint.new(type: :percentage, value: 80),
-      ],
-      children: [
-        RatatuiRuby::Sparkline.new(
-          data: @network_data,
-          style: RatatuiRuby::Style.new(fg: :cyan),
-          block: RatatuiRuby::Block.new(title: "Network Activity", borders: :all)
-        ),
-        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_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),
-        ),
-      ]
-    )
-
-    RatatuiRuby.draw(ui)
-  end
-
-  def handle_input
-    event = RatatuiRuby.poll_event
-    if event && event[:code] == "q"
-      :quit
-    end
-  end
-end
-
-StockTickerApp.new.run if __FILE__ == $0

data/examples/system_monitor.rb

@@ -1,94 +0,0 @@
-# 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"
-
-class SystemMonitorApp
-  def initialize
-    @percentage = 50
-  end
-
-  def run
-    RatatuiRuby.init_terminal
-    begin
-      loop do
-        render
-        break if handle_input == :quit
-      end
-    ensure
-      RatatuiRuby.restore_terminal
-    end
-  end
-
-  def render
-    # System Monitor Layout
-    # Top: Table (50%)
-    # Bottom: Gauge (50%)
-
-    header_style = RatatuiRuby::Style.new(fg: :blue, modifiers: [:bold])
-
-    header = [
-      RatatuiRuby::Paragraph.new(text: "PID", style: header_style),
-      RatatuiRuby::Paragraph.new(text: "Name", style: header_style),
-      RatatuiRuby::Paragraph.new(text: "CPU%", style: header_style),
-      RatatuiRuby::Paragraph.new(text: "Mem%", style: header_style),
-    ]
-
-    rows = [
-      ["1234", "ruby", "0.5", "1.2"],
-      ["5678", "rust", "10.2", "4.5"],
-      ["9012", "system", "1.1", "0.8"],
-    ]
-
-    widths = [
-      RatatuiRuby::Constraint.length(10),
-      RatatuiRuby::Constraint.min(20),
-      RatatuiRuby::Constraint.length(10),
-      RatatuiRuby::Constraint.length(10),
-    ]
-
-    table = RatatuiRuby::Table.new(
-      header:,
-      rows:,
-      widths:,
-      block: RatatuiRuby::Block.new(title: "Processes", borders: [:all])
-    )
-
-    gauge = RatatuiRuby::Gauge.new(
-      ratio: @percentage / 100.0,
-      label: "#{@percentage}%",
-      style: RatatuiRuby::Style.new(fg: :green),
-      block: RatatuiRuby::Block.new(title: "Memory Usage", borders: [:all])
-    )
-
-    layout = RatatuiRuby::Layout.new(
-      direction: :vertical,
-      children: [table, gauge],
-      constraints: [
-        RatatuiRuby::Constraint.percentage(50),
-        RatatuiRuby::Constraint.percentage(50),
-      ]
-    )
-
-    RatatuiRuby.draw(layout)
-  end
-
-  def handle_input
-    event = RatatuiRuby.poll_event
-    if event
-      case event[:code]
-      when "q"
-        :quit
-      when "up"
-        @percentage = [@percentage + 5, 100].min
-      when "down"
-        @percentage = [@percentage - 5, 0].max
-      end
-    end
-  end
-end
-
-SystemMonitorApp.new.run if __FILE__ == $0

data/examples/table_select.rb

@@ -1,70 +0,0 @@
-#!/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_analytics.rb

@@ -1,65 +0,0 @@
-# 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 "analytics"
-
-class Minitest::Test
-  include RatatuiRuby::TestHelper
-end
-
-class TestAnalytics < Minitest::Test
-  def setup
-    @app = AnalyticsApp.new
-  end
-
-  def test_render_initial_state
-    with_test_terminal(50, 20) do
-      @app.render
-
-      # Check Tabs
-      assert buffer_content.any? { |line| line.include?("Revenue") }
-      assert buffer_content.any? { |line| line.include?("Traffic") }
-      assert buffer_content.any? { |line| line.include?("Errors") }
-
-      # Check initial selected tab content
-      assert buffer_content.any? { |line| line.include?("Analytics: Revenue") }
-    end
-  end
-
-  def test_navigation_right
-    inject_event("key", { code: "right" })
-    @app.handle_input
-
-    with_test_terminal(50, 20) do
-      @app.render
-      assert buffer_content.any? { |line| line.include?("Analytics: Traffic") }
-    end
-  end
-
-  def test_navigation_left
-    # Move right to Traffic
-    inject_event("key", { code: "right" })
-    @app.handle_input
-
-    # Move left back to Revenue
-    inject_event("key", { code: "left" })
-    @app.handle_input
-
-    with_test_terminal(50, 20) do
-      @app.render
-      assert buffer_content.any? { |line| line.include?("Analytics: Revenue") }
-    end
-  end
-
-  def test_quit
-    inject_event("key", { code: "q" })
-    status = @app.handle_input
-    assert_equal :quit, status
-  end
-end

data/examples/test_box_demo.rb

@@ -1,38 +0,0 @@
-# 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 "box_demo"
-
-class Minitest::Test
-  include RatatuiRuby::TestHelper
-end
-
-class TestBoxDemo < Minitest::Test
-  def setup
-    @app = BoxDemoApp.new
-  end
-
-  def test_render_initial_state
-    with_test_terminal(40, 10) do
-      @app.render
-      assert buffer_content.any? { |line| line.include?("Box Demo") }
-      assert buffer_content.any? { |line| line.include?("Press Arrow Keys") }
-    end
-  end
-
-  def test_interaction
-    inject_event("key", { code: "up" })
-    @app.handle_input
-
-    with_test_terminal(40, 10) do
-      @app.render
-      assert buffer_content.any? { |line| line.include?("Up Pressed!") }
-    end
-  end
-end

data/examples/test_calendar_demo.rb

@@ -1,66 +0,0 @@
-# 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_dashboard.rb

@@ -1,38 +0,0 @@
-# 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 "dashboard"
-
-class Minitest::Test
-  include RatatuiRuby::TestHelper
-end
-
-class TestDashboard < Minitest::Test
-  def setup
-    @app = DashboardApp.new
-  end
-
-  def test_render_initial_state
-    with_test_terminal(60, 20) do
-      @app.render
-      assert buffer_content.any? { |line| line.include?("Item 1") }
-      assert buffer_content.any? { |line| line.include?("You selected: Item 1") }
-    end
-  end
-
-  def test_navigation
-    inject_event("key", { code: "down" })
-    @app.handle_input
-
-    with_test_terminal(60, 20) do
-      @app.render
-      assert buffer_content.any? { |line| line.include?("You selected: Item 2") }
-    end
-  end
-end

data/examples/test_list_styles.rb

@@ -1,61 +0,0 @@
-# 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