ratatui_ruby 0.4.0 → 0.5.0

data/examples/scroll_text/test_app.rb

@@ -1,110 +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 "minitest/autorun"
-require "ratatui_ruby/test_helper"
-
-require_relative "app"
-
-class TestScrollTextApp < Minitest::Test
-  include RatatuiRuby::TestHelper
-
-  def setup
-    @app = ScrollTextApp.new
-  end
-
-  def test_demo_initialization
-    assert_instance_of ScrollTextApp, @app
-  end
-
-  def test_initial_rendering
-    with_test_terminal do
-      # Queue quit
-      inject_key(:q)
-      
-      @app.run
-
-      content = buffer_content
-      
-      # Should show Line 1 somewhere in the output
-      assert content.any? { |line| line.include?("Line 1") }
-      # Should show controls
-      assert content.any? { |line| line.include?("Controls") }
-      assert content.any? { |line| line.include?("Vert Scroll (0/102)") }
-    end
-  end
-
-  def test_scroll_down
-    with_test_terminal do
-      # Scroll down then quit
-      inject_keys(:down, :q)
-
-      @app.run
-
-      content = buffer_content
-      
-      # Should show controls with updated Y position
-      assert content.any? { |line| line.include?("Vert Scroll (1/102)") }
-    end
-  end
-
-  def test_scroll_right
-    with_test_terminal do
-      # Scroll right then quit
-      inject_keys(:right, :q)
-
-      @app.run
-
-      content = buffer_content
-      
-      # Should render without error
-      assert content.any? { |line| line.include?("Controls") }
-    end
-  end
-
-  def test_scroll_left_at_edge
-    with_test_terminal do
-      # Scroll left then quit (boundary test)
-      inject_keys(:left, :q)
-
-      @app.run
-
-      content = buffer_content
-      
-      # Should still show the controls
-      assert content.any? { |line| line.include?("Vert Scroll") }
-    end
-  end
-
-  def test_scroll_up_at_top
-    with_test_terminal do
-      # Scroll up then quit (boundary test)
-      inject_keys(:up, :q)
-
-      @app.run
-
-      content = buffer_content
-      
-      # Should still show the controls
-      assert content.any? { |line| line.include?("Controls") }
-    end
-  end
-
-  def test_multiple_scrolls
-    with_test_terminal do
-      # Scroll down and right multiple times
-      inject_keys(:down, :down, :right, :right, :right, :q)
-
-      @app.run
-
-      content = buffer_content
-      
-      # Should render without error
-      assert content.any? { |line| line.include?("Scrollable Text") }
-    end
-  end
-end

data/examples/scrollbar_demo/app.rb

@@ -1,143 +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 ScrollbarDemoApp
-  def initialize
-    @scroll_position = 0
-    @content_length = 50
-    @lines = (1..@content_length).map { |i| "Line #{i}" }
-    @orientation_index = 0
-    @orientations = [
-      :vertical,
-      :vertical_right,
-      :vertical_left,
-      :horizontal,
-      :horizontal_bottom,
-      :horizontal_top
-    ]
-    @theme_index = 0
-    @themes = [
-      {
-        name: "Standard",
-        track_symbol: nil,
-        thumb_symbol: "█",
-        track_style: nil,
-        thumb_style: nil,
-        begin_symbol: nil,
-        end_symbol: nil
-      },
-      {
-        name: "Rounded",
-        track_symbol: "│",
-        thumb_symbol: "┃",
-        track_style: { fg: "dark_gray" },
-        thumb_style: { fg: "cyan" },
-        begin_symbol: "▲",
-        end_symbol: "▼"
-      },
-      {
-        name: "ASCII",
-        track_symbol: "|",
-        thumb_symbol: "#",
-        track_style: { fg: "white" },
-        thumb_style: { fg: "red" },
-        begin_symbol: "^",
-        end_symbol: "v"
-      },
-      {
-        name: "Minimal",
-        track_symbol: " ",
-        thumb_symbol: "▐",
-        track_style: nil,
-        thumb_style: { fg: "yellow" },
-        begin_symbol: nil,
-        end_symbol: nil
-      }
-    ]
-  end
-
-  def run
-    RatatuiRuby.run do
-      loop do
-        draw
-        event = RatatuiRuby.poll_event
-        break if event == "q" || event == :ctrl_c
-
-        handle_event(event)
-      end
-    end
-  end
-
-  private def handle_event(event)
-    return unless event
-
-    if event.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
-
-    if event.key? && event.to_s == "s"
-      @theme_index = (@theme_index + 1) % @themes.length
-    end
-
-    if event.key? && event.to_s == "o"
-      @orientation_index = (@orientation_index + 1) % @orientations.length
-    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
-    theme = @themes[@theme_index]
-    orientation = @orientations[@orientation_index]
-
-    p = RatatuiRuby::Paragraph.new(
-      text: visible_lines.join("\n"),
-      block: RatatuiRuby::Block.new(
-        titles: [
-          { content: "Scroll with Mouse Wheel | Theme: #{theme[:name]} | Orientation: #{orientation}" },
-          { content: "Press 's' to cycle theme, 'o' to cycle orientation", position: :bottom, alignment: :center }
-        ],
-        borders: [:all]
-      )
-    )
-
-    # Scrollbar
-    s = RatatuiRuby::Scrollbar.new(
-      content_length: @content_length,
-      position: @scroll_position,
-      orientation: orientation,
-      track_symbol: theme[:track_symbol],
-      thumb_symbol: theme[:thumb_symbol],
-      track_style: theme[:track_style],
-      thumb_style: theme[:thumb_style],
-      begin_symbol: theme[:begin_symbol],
-      end_symbol: theme[:end_symbol]
-    )
-
-    # Use Overlay to stack Scrollbar on top of Paragraph.
-    # The Scrollbar will position itself on the correct edge (top/bottom/left/right)
-    # based on its orientation, demonstrating that the property works independently of layout.
-    overlay = RatatuiRuby::Overlay.new(
-      layers: [p, s]
-    )
-
-    RatatuiRuby.draw(overlay)
-  end
-end
-
-ScrollbarDemoApp.new.run if __FILE__ == $PROGRAM_NAME

data/examples/scrollbar_demo/app.rbs

@@ -1,7 +0,0 @@
-class ScrollbarDemoApp
-  # @public
-  def self.new: () -> ScrollbarDemoApp
-
-  # @public
-  def run: () -> void
-end

data/examples/scrollbar_demo/test_app.rb

@@ -1,77 +0,0 @@
-# frozen_string_literal: true
-
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-
-require "test_helper"
-require_relative "app"
-
-class TestScrollbarDemoApp < Minitest::Test
-  include RatatuiRuby::TestHelper
-
-  def setup
-    @app = ScrollbarDemoApp.new
-  end
-
-  def test_initial_render
-    with_test_terminal do
-      # Queue quit event to exit loop immediately
-      inject_key(:q)
-
-      # Stub init_terminal/restore_terminal to use test terminal
-      @app.run
-
-      content = buffer_content
-
-      # Top border with title (truncated due to small width)
-      assert_includes content[0], "Scroll"
-      # First line of content
-      assert_includes content[1], "Line 1"
-      # Scrollbar area (far right)
-      assert_equal "█", content[1][-1]
-    end
-  end
-
-  def test_scroll_down
-    with_test_terminal do
-      # Queue scroll down + quit
-      inject_event(RatatuiRuby::Event::Mouse.new(kind: "scroll_down", x: 0, y: 0, button: "none"))
-      inject_key(:q)
-
-      @app.run
-
-      content = buffer_content
-
-      # Now it should start from Line 2
-      assert_includes content[1], "Line 2"
-      refute_includes content[1], "Line 1"
-    end
-  end
-
-  def test_scroll_up
-    with_test_terminal do
-      # Queue scroll down + scroll up + quit
-      inject_event(RatatuiRuby::Event::Mouse.new(kind: "scroll_down", x: 0, y: 0, button: "none"))
-      inject_event(RatatuiRuby::Event::Mouse.new(kind: "scroll_up", x: 0, y: 0, button: "none"))
-      inject_key(:q)
-
-      @app.run
-
-      content = buffer_content
-
-      assert_includes content[1], "Line 1"
-    end
-  end
-
-  def test_theme_cycling
-    with_test_terminal do
-      # Queue 's' + quit
-      inject_keys(:s, :q)
-
-      @app.run
-
-      content = buffer_content
-      assert_match(/Theme: Rounded/, content[0])
-    end
-  end
-end

data/examples/sparkline_demo/app.rb

@@ -1,240 +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"
-
-# Demonstrates Sparkline widget with interactive attribute cycling.
-class SparklineDemoApp
-  def initialize
-    # Data sets with different characteristics
-    @data_sets = [
-      {
-        name: "Steady Growth",
-        data: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
-      },
-      {
-        name: "With Gaps",
-        data: [5, nil, 8, nil, 6, nil, 9, nil, 7, nil, 10, nil]
-      },
-      {
-        name: "Random",
-        data: [3, 1, 4, 1, 5, 9, 2, 6, 5, 3, 5, 8]
-      },
-      {
-        name: "Sawtooth",
-        data: [1, 2, 3, 4, 5, 4, 3, 2, 1, 2, 3, 4]
-      },
-      {
-        name: "Peaks",
-        data: [1, 5, 1, 8, 1, 6, 1, 9, 1, 7, 1, 10]
-      }
-    ]
-    @data_index = 0
-
-    @directions = [
-      { name: "Left to Right", direction: :left_to_right },
-      { name: "Right to Left", direction: :right_to_left }
-    ]
-    @direction_index = 0
-
-    @styles = [
-      { name: "Green", style: RatatuiRuby::Style.new(fg: :green) },
-      { name: "Yellow", style: RatatuiRuby::Style.new(fg: :yellow) },
-      { name: "Red", style: RatatuiRuby::Style.new(fg: :red) },
-      { name: "Cyan", style: RatatuiRuby::Style.new(fg: :cyan) },
-      { name: "Magenta", style: RatatuiRuby::Style.new(fg: :magenta) }
-    ]
-    @style_index = 0
-
-    @absent_symbols = [
-      { name: "None", symbol: nil },
-      { name: "Dot (·)", symbol: "·" },
-      { name: "Square (▫)", symbol: "▫" },
-      { name: "Dash (-)", symbol: "-" },
-      { name: "Underscore (_)", symbol: "_" }
-    ]
-    @absent_symbol_index = 1
-
-    @absent_styles = [
-      { name: "Default", style: nil },
-      { name: "Dark Gray", style: RatatuiRuby::Style.new(fg: :dark_gray) },
-      { name: "Dim Red", style: RatatuiRuby::Style.new(fg: :red, modifiers: [:dim]) },
-      { name: "Dim Yellow", style: RatatuiRuby::Style.new(fg: :yellow, modifiers: [:dim]) }
-    ]
-    @absent_style_index = 0
-
-    @bar_sets = [
-      { name: "Default (Block)", set: nil },
-      { name: "Numbers (0-8)", set: {
-        0 => "0", 1 => "1", 2 => "2", 3 => "3", 4 => "4", 5 => "5", 6 => "6", 7 => "7", 8 => "8"
-      }},
-      { name: "ASCII (Heights)", set: [" ", "_", ".", "-", "=", "+", "*", "#", "@"] }
-    ]
-    @bar_set_index = 0
-
-    @counter = 0
-    @hotkey_style = RatatuiRuby::Style.new(modifiers: [:bold, :underlined])
-  end
-
-  def run
-    RatatuiRuby.run do
-      loop do
-        render
-        break if handle_input == :quit
-      end
-    end
-  end
-
-  private
-
-  def render
-    @counter += 1
-
-    data_set = @data_sets[@data_index]
-    direction = @directions[@direction_index][:direction]
-    style = @styles[@style_index][:style]
-    absent_symbol = @absent_symbols[@absent_symbol_index][:symbol]
-    absent_value_style = @absent_styles[@absent_style_index][:style]
-    bar_set = @bar_sets[@bar_set_index][:set]
-
-    # Use static data for clarity when cycling options
-    current_data = data_set[:data]
-
-    layout = RatatuiRuby::Layout.new(
-      direction: :vertical,
-      constraints: [
-        RatatuiRuby::Constraint.fill(1),
-        RatatuiRuby::Constraint.length(6),
-      ],
-      children: [
-        # Main content area with multiple sparkline examples
-        RatatuiRuby::Layout.new(
-          direction: :vertical,
-          constraints: [
-            RatatuiRuby::Constraint.length(1),
-            RatatuiRuby::Constraint.length(3),
-            RatatuiRuby::Constraint.length(3),
-            RatatuiRuby::Constraint.length(3),
-            RatatuiRuby::Constraint.length(3),
-            RatatuiRuby::Constraint.fill(1)
-          ],
-          children: [
-            RatatuiRuby::Paragraph.new(
-              text: "Sparkline Widget Demo - Cycle attributes with hotkeys"
-            ),
-            # Sparkline 1: Main interactive sparkline
-            RatatuiRuby::Sparkline.new(
-              data: current_data,
-              direction:,
-              style:,
-              absent_value_symbol: absent_symbol,
-              absent_value_style:,
-              bar_set:,
-              block: RatatuiRuby::Block.new(title: "Interactive Sparkline")
-            ),
-            # Sparkline 2: Same data, opposite direction
-            RatatuiRuby::Sparkline.new(
-              data: current_data.reverse,
-              direction:,
-              style:,
-              absent_value_symbol: absent_symbol,
-              absent_value_style:,
-              bar_set:,
-              block: RatatuiRuby::Block.new(title: "Reversed Data")
-            ),
-            # Sparkline 3: Without absent value symbol (for comparison)
-            RatatuiRuby::Sparkline.new(
-              data: current_data,
-              direction:,
-              style:,
-              bar_set:,
-              block: RatatuiRuby::Block.new(title: "Without Absent Marker")
-            ),
-            # Sparkline 4: Gap pattern responsive to absent marker controls
-            RatatuiRuby::Sparkline.new(
-              data: [5, nil, 8, nil, 6, nil, 9, nil, 7, nil, 10, nil],
-              direction:,
-              style: RatatuiRuby::Style.new(fg: :blue),
-              absent_value_symbol: absent_symbol,
-              absent_value_style:,
-              bar_set:,
-              block: RatatuiRuby::Block.new(title: "Gap Pattern (Responsive)")
-            ),
-            RatatuiRuby::Paragraph.new(text: "")
-          ]
-        ),
-        # Bottom control panel
-        RatatuiRuby::Block.new(
-          title: "Controls",
-          borders: [:all],
-          children: [
-            RatatuiRuby::Paragraph.new(
-              text: [
-                # Line 1: Data
-                RatatuiRuby::Text::Line.new(spans: [
-                  RatatuiRuby::Text::Span.new(content: "↑/↓", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Data (#{@data_sets[@data_index][:name]})")
-                ]),
-                # Line 2: View
-                RatatuiRuby::Text::Line.new(spans: [
-                  RatatuiRuby::Text::Span.new(content: "d", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Direction (#{@directions[@direction_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "c", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Color (#{@styles[@style_index][:name]})")
-                ]),
-                # Line 3: Markers
-                RatatuiRuby::Text::Line.new(spans: [
-                  RatatuiRuby::Text::Span.new(content: "m", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Absent Value Symbol (#{@absent_symbols[@absent_symbol_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "s", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Absent Value Style (#{@absent_styles[@absent_style_index][:name]})")
-                ]),
-                # Line 4: General
-                RatatuiRuby::Text::Line.new(spans: [
-                  RatatuiRuby::Text::Span.new(content: "b", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Bar Set (#{@bar_sets[@bar_set_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "q", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Quit")
-                ])
-              ]
-            )
-          ]
-        )
-      ]
-    )
-
-
-    RatatuiRuby.draw(layout)
-  end
-
-  def handle_input
-    event = RatatuiRuby.poll_event
-    return unless event
-
-    case event
-    in {type: :key, code: "q"} | {type: :key, code: "c", modifiers: ["ctrl"]}
-      :quit
-    in type: :key, code: "up"
-      @data_index = (@data_index - 1) % @data_sets.length
-    in type: :key, code: "down"
-      @data_index = (@data_index + 1) % @data_sets.length
-    in type: :key, code: "d"
-      @direction_index = (@direction_index + 1) % @directions.length
-    in type: :key, code: "c"
-      @style_index = (@style_index + 1) % @styles.length
-    in type: :key, code: "m"
-      @absent_symbol_index = (@absent_symbol_index + 1) % @absent_symbols.length
-    in type: :key, code: "s"
-      @absent_style_index = (@absent_style_index + 1) % @absent_styles.length
-    in type: :key, code: "b"
-      @bar_set_index = (@bar_set_index + 1) % @bar_sets.length
-    else
-      nil
-    end
-  end
-end
-
-SparklineDemoApp.new.run if __FILE__ == $PROGRAM_NAME

data/examples/sparkline_demo/test_app.rb

@@ -1,107 +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 "app"
-
-class TestSparklineDemoApp < Minitest::Test
-  include RatatuiRuby::TestHelper
-
-  def setup
-    @app = SparklineDemoApp.new
-  end
-
-  def test_initial_render
-    with_test_terminal do
-      inject_key(:q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Sparkline Widget Demo"
-      assert_includes content, "Interactive Sparkline"
-      assert_includes content, "Reversed Data"
-    end
-  end
-
-  def test_cycle_data_set_up
-    with_test_terminal do
-      inject_keys(:up, :q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      # Should still render after cycling
-      assert_includes content, "Sparkline Widget Demo"
-    end
-  end
-
-  def test_cycle_data_set_down
-    with_test_terminal do
-      inject_keys(:down, :down, :q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Sparkline Widget Demo"
-    end
-  end
-
-  def test_cycle_direction
-    with_test_terminal do
-      inject_keys(:d, :q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Sparkline Widget Demo"
-    end
-  end
-
-  def test_cycle_color
-    with_test_terminal do
-      inject_keys(:c, :c, :q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Sparkline Widget Demo"
-    end
-  end
-
-  def test_cycle_absent_marker
-    with_test_terminal do
-      inject_keys(:m, :m, :m, :q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Sparkline Widget Demo"
-    end
-  end
-
-  def test_cycle_absent_style
-    with_test_terminal do
-      inject_keys(:s, :s, :q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Sparkline Widget Demo"
-    end
-  end
-
-  def test_cycle_bar_set
-    with_test_terminal do
-      inject_keys(:b, :q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Sparkline Widget Demo"
-      # Verify render with Numbers set (one_eighth="1", etc.)
-      # Input data [1..12] with implicit max 12. 
-      # With Numbers set, we expect digits 1-8 to appear.
-      # Just asserting no crash is a start, but let's check for the label update if possible
-      # The controls footer should update.
-      # assert_includes content, ": Bar Set" # Included in controls
-    end
-  end
-end