ratatui_ruby 0.4.0 → 0.6.0

data/examples/cell_demo/app.rb

@@ -1,108 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
-require "ratatui_ruby"
-
-# A custom widget that fills its area with a checkered pattern using Cell objects.
-class CheckeredBackground
-  def render(area)
-    cell = RatatuiRuby::Cell.new(char: "░", fg: :dark_gray)
-    commands = []
-    area.height.times do |y|
-      area.width.times do |x|
-        # Checkerboard logic
-        if (x + y).even?
-          # Use a dim cell for the background pattern
-          commands << RatatuiRuby::Draw.cell(area.x + x, area.y + y, cell)
-        end
-      end
-    end
-    commands
-  end
-end
-
-class CellDemoApp
-  def main
-    RatatuiRuby.run do |tui|
-      # Define some reusable cells for our table
-      ok_cell = RatatuiRuby::Cell.new(char: "OK", fg: :green)
-      fail_cell = RatatuiRuby::Cell.new(char: "FAIL", fg: :red, modifiers: ["bold"])
-      pending_cell = RatatuiRuby::Cell.new(char: "...", fg: :yellow, modifiers: ["dim"])
-
-      # A mix of Strings and Cells in rows
-      rows = [
-        ["Database", ok_cell],
-        ["Cache", ok_cell],
-        ["Worker", fail_cell],
-        ["Analytics", pending_cell],
-        ["Web Server", RatatuiRuby::Cell.new(char: "RESTARTING", fg: :blue, modifiers: ["rapid_blink"])]
-      ]
-
-      table = RatatuiRuby::Table.new(
-        header: ["Service", RatatuiRuby::Cell.new(char: "Status", modifiers: ["underlined"])],
-        rows: rows,
-        widths: [
-          RatatuiRuby::Constraint.percentage(70),
-          RatatuiRuby::Constraint.percentage(30)
-        ],
-        block: RatatuiRuby::Block.new(title: "System Status", borders: :all),
-        column_spacing: 1
-      )
-
-      # Main loop
-      loop do
-        # Create a layout that holds both widgets
-        # We use a vertical layout:
-        # Top: Custom CheckeredBackground with specific height
-        # Bottom: Table using remaining space
-        
-        # Note: CheckeredBackground renders to the area implicitly if passed as a child.
-        # However, to overlay the paragraph, we might need a more complex structure or 
-        # wrapper. RatatuiRuby::Layout handles non-overlapping children.
-        # To get the "Overlay" effect from my previous code (Paragraph over Background),
-        # we would need to composite them. For now, let's just show them stacked or
-        # using 'Overlay' widget if it exists.
-        
-        # Checking schema: Overlay exists? Yes: require_relative "ratatui_ruby/schema/overlay" in lib/ratatui_ruby.rb
-        
-        layout = RatatuiRuby::Layout.new(
-          direction: :vertical,
-          constraints: [
-            RatatuiRuby::Constraint.length(10), # Top section
-            RatatuiRuby::Constraint.min(0)      # Bottom section
-          ],
-          children: [
-            # Top Child: An Overlay of Paragraph on top of CheckeredBackground
-            RatatuiRuby::Overlay.new(
-              layers: [
-                CheckeredBackground.new,
-                RatatuiRuby::Center.new(
-                  width_percent: 50,
-                  height_percent: 50,
-                  child: RatatuiRuby::Paragraph.new(
-                    text: "Custom Widget Demo\n(CheckeredBackground)",
-                    alignment: :center,
-                    block: RatatuiRuby::Block.new(borders: :all, title: "Overlay")
-                  )
-                )
-              ]
-            ),
-            # Bottom Child: The Table
-            table
-          ]
-        )
-
-        tui.draw(layout)
-
-        event = RatatuiRuby.poll_event
-        if event.is_a?(RatatuiRuby::Event::Key)
-          break if event.code == "q" || (event.code == "c" && event.modifiers.include?("ctrl"))
-        end
-      end
-    end
-  end
-end
-
-if __FILE__ == $0
-  CellDemoApp.new.main
-end

data/examples/cell_demo/app.rbs

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

data/examples/cell_demo/test_app.rb

@@ -1,36 +0,0 @@
-require "minitest/autorun"
-require "ratatui_ruby"
-require "ratatui_ruby/test_helper"
-require_relative "app"
-
-class TestCellDemoApp < Minitest::Test
-  include RatatuiRuby::TestHelper
-
-  include RatatuiRuby::TestHelper
-
-  def test_cell_demo_output
-    # Run the demo in a test terminal
-    # We'll inject a 'q' key to exit the loop immediately after the first draw
-    with_test_terminal(timeout: 5) do
-      inject_key("q")
-      CellDemoApp.new.main
-
-      # Verify Custom Widget Output
-      # Check for "░" character from CheckeredBackground
-      # It should be visible around the centered widget
-      assert_includes buffer_content.join("\n"), "░"
-
-      # Verify Table Output
-      # Content strings
-      assert_includes buffer_content.join("\n"), "System Status"
-      assert_includes buffer_content.join("\n"), "Database"
-      assert_includes buffer_content.join("\n"), "Worker"
-      
-      # We can't easily grep for "FAIL" with color in simple string content check,
-      # but we can check the text presence.
-      assert_includes buffer_content.join("\n"), "FAIL"
-      assert_includes buffer_content.join("\n"), "OK"
-      assert_includes buffer_content.join("\n"), "RESTARTING"
-    end
-  end
-end

data/examples/chart_demo/app.rb

@@ -1,203 +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 Chart widget with interactive attribute cycling.
-class ChartDemoApp
-  def initialize
-    @markers = [
-      { name: "Dot (·)", marker: :dot },
-      { name: "Braille", marker: :braille },
-      { name: "Block (█)", marker: :block },
-      { name: "Bar", marker: :bar }
-    ]
-    @marker_index = 0
-
-    @dataset_styles = [
-      { name: "Yellow", style: RatatuiRuby::Style.new(fg: :yellow) },
-      { name: "Green", style: RatatuiRuby::Style.new(fg: :green) },
-      { name: "Cyan", style: RatatuiRuby::Style.new(fg: :cyan) },
-      { name: "Red", style: RatatuiRuby::Style.new(fg: :red) },
-      { name: "Magenta", style: RatatuiRuby::Style.new(fg: :magenta) },
-      { name: "Bold Blue", style: RatatuiRuby::Style.new(fg: :blue, modifiers: [:bold]) },
-      { name: "Dim White", style: RatatuiRuby::Style.new(fg: :white, modifiers: [:dim]) },
-      { name: "Italic Green", style: RatatuiRuby::Style.new(fg: :green, modifiers: [:italic]) },
-      { name: "Alert (Red/White/Bar)", style: RatatuiRuby::Style.new(fg: :white, bg: :red, modifiers: [:bold]) }
-    ]
-    @dataset_style_index = 0
-
-    @x_alignments = [
-      { name: "Left", alignment: :left },
-      { name: "Center", alignment: :center },
-      { name: "Right", alignment: :right }
-    ]
-    @x_alignment_index = 1
-
-    @y_alignments = [
-      { name: "Left", alignment: :left },
-      { name: "Center", alignment: :center },
-      { name: "Right", alignment: :right }
-    ]
-    @y_alignment_index = 2
-
-    @legend_positions = [
-      { name: "Top Right", position: :top_right },
-      { name: "Top Left", position: :top_left },
-      { name: "Bottom Right", position: :bottom_right },
-      { name: "Bottom Left", position: :bottom_left }
-    ]
-    @legend_position_index = 0
-
-    @hotkey_style = RatatuiRuby::Style.new(modifiers: [:bold, :underlined])
-  end
-
-  def run
-    RatatuiRuby.run do
-      loop do
-        render
-        break if handle_input == :quit
-        sleep 0.05
-      end
-    end
-  end
-
-  private
-
-  def render
-    # Static sample data: sine wave with wider range for better visibility
-    line_data = (0..50).map do |i|
-      x = i / 5.0
-      [x, Math.sin(x)]
-    end
-
-    # Scatter: Random points
-    scatter_data = (0..20).map do |_|
-      [rand(0.0..10.0), rand(-1.0..1.0)]
-    end
-
-    style = @dataset_styles[@dataset_style_index][:style]
-    # Ensure the second dataset has a different style
-    scatter_style = @dataset_styles[(@dataset_style_index + 2) % @dataset_styles.length][:style]
-
-    datasets = [
-      RatatuiRuby::Dataset.new(
-        name: "Line",
-        data: line_data,
-        style:,
-        marker: style.modifiers.include?(:bold) && style.bg ? :bar : @markers[@marker_index][:marker],
-        graph_type: :line
-      ),
-      RatatuiRuby::Dataset.new(
-        name: "Scatter",
-        data: scatter_data,
-        style: scatter_style,
-        marker: scatter_style.modifiers.include?(:bold) && scatter_style.bg ? :bar : @markers[@marker_index][:marker],
-        graph_type: :scatter
-      )
-    ]
-
-    x_alignment = @x_alignments[@x_alignment_index][:alignment]
-    y_alignment = @y_alignments[@y_alignment_index][:alignment]
-    legend_position = @legend_positions[@legend_position_index][:position]
-
-    chart = RatatuiRuby::Chart.new(
-      datasets:,
-      x_axis: RatatuiRuby::Axis.new(
-        title: "Time",
-        bounds: [0.0, 10.0],
-        labels: %w[0 5 10],
-        style: RatatuiRuby::Style.new(fg: :yellow),
-        labels_alignment: x_alignment
-      ),
-      y_axis: RatatuiRuby::Axis.new(
-        title: "Amplitude",
-        bounds: [-1.0, 1.0],
-        labels: %w[-1 0 1],
-        style: RatatuiRuby::Style.new(fg: :cyan),
-        labels_alignment: y_alignment
-      ),
-      block: RatatuiRuby::Block.new(
-        title: "Chart Widget Demo",
-        borders: [:all]
-      ),
-      legend_position:,
-      hidden_legend_constraints: [
-        RatatuiRuby::Constraint.min(20),
-        RatatuiRuby::Constraint.min(10)
-      ]
-    )
-
-    layout = RatatuiRuby::Layout.new(
-      direction: :vertical,
-      constraints: [
-        RatatuiRuby::Constraint.fill(1),
-        RatatuiRuby::Constraint.length(5)
-      ],
-      children: [
-        chart,
-        # Bottom control panel
-        RatatuiRuby::Block.new(
-          title: "Controls",
-          borders: [:all],
-          children: [
-            RatatuiRuby::Paragraph.new(
-              text: [
-                # Line 1: Markers & Colors
-                RatatuiRuby::Text::Line.new(spans: [
-                  RatatuiRuby::Text::Span.new(content: "m", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Marker (#{@markers[@marker_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "s", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Style (#{@dataset_styles[@dataset_style_index][:name]})")
-                ]),
-                # Line 2: Axis alignments
-                RatatuiRuby::Text::Line.new(spans: [
-                  RatatuiRuby::Text::Span.new(content: "x", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": X Align (#{@x_alignments[@x_alignment_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "y", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Y Align (#{@y_alignments[@y_alignment_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "l", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Legend (#{@legend_positions[@legend_position_index][:name]})")
-                ]),
-                # Line 3: Quit
-                RatatuiRuby::Text::Line.new(spans: [
-                  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: "m"
-      @marker_index = (@marker_index + 1) % @markers.length
-    in type: :key, code: "s"
-      @dataset_style_index = (@dataset_style_index + 1) % @dataset_styles.length
-    in type: :key, code: "x"
-      @x_alignment_index = (@x_alignment_index + 1) % @x_alignments.length
-    in type: :key, code: "y"
-      @y_alignment_index = (@y_alignment_index + 1) % @y_alignments.length
-    in type: :key, code: "l"
-      @legend_position_index = (@legend_position_index + 1) % @legend_positions.length
-    else
-      nil
-    end
-  end
-end
-
-ChartDemoApp.new.run if __FILE__ == $PROGRAM_NAME

data/examples/chart_demo/app.rbs

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

data/examples/chart_demo/test_app.rb

@@ -1,102 +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 TestChartDemo < Minitest::Test
-  include RatatuiRuby::TestHelper
-
-  def setup
-    @app = ChartDemoApp.new
-  end
-
-  def test_initial_render
-    with_test_terminal do
-      inject_key(:q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Chart Widget Demo"
-      assert_includes content, "Time"
-      assert_includes content, "Amplitude"
-      assert_includes content, "Line"
-      assert_includes content, "Scatter"
-      assert_includes content, "Controls"
-      # Verify controls are visible
-      assert_includes content, "Marker"
-      assert_includes content, "Style"
-      assert_includes content, "Align"
-    end
-  end
-
-  def test_marker_cycling
-    with_test_terminal do
-      inject_key("m")  # Cycle marker
-      inject_key(:q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      # Should show the chart still renders
-      assert_includes content, "Chart Widget Demo"
-      assert_includes content, "Time"
-    end
-  end
-
-  def test_style_cycling
-    with_test_terminal do
-      inject_key("s")  # Cycle style
-      inject_key(:q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Chart Widget Demo"
-      assert_includes content, "Time"
-    end
-  end
-
-  def test_x_alignment_cycling
-    with_test_terminal do
-      inject_key("x")  # Cycle X-axis label alignment
-      inject_key(:q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Chart Widget Demo"
-      assert_includes content, "Time"
-    end
-  end
-
-  def test_y_alignment_cycling
-    with_test_terminal do
-      inject_key("y")  # Cycle Y-axis label alignment
-      inject_key(:q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Chart Widget Demo"
-      assert_includes content, "Amplitude"
-    end
-  end
-
-  def test_multiple_cycles
-    with_test_terminal do
-      inject_key("m")
-      inject_key("s")
-      inject_key("x")
-      inject_key("y")
-      inject_key(:q)
-      @app.run
-
-      content = buffer_content.join("\n")
-      assert_includes content, "Chart Widget Demo"
-      # Chart and controls should all render
-      assert_includes content, "Controls"
-    end
-  end
-end

data/examples/custom_widget/app.rb

@@ -1,51 +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"
-
-# A custom widget that draws a diagonal line.
-class DiagonalWidget
-  def render(area)
-    # Draw a diagonal line within the area
-    (0..10).filter_map do |i|
-      next if area.x + i >= area.x + area.width || area.y + i >= area.y + area.height
-
-      RatatuiRuby::Draw.string(
-        area.x + i,
-        area.y + i,
-        "\\",
-        { fg: :red, modifiers: [:bold] }
-      )
-    end
-  end
-end
-
-class CustomWidgetApp
-  def run
-    RatatuiRuby.run do |tui|
-      loop do
-        tui.draw(
-          RatatuiRuby::Layout.new(
-            direction: :vertical,
-            constraints: [
-              RatatuiRuby::Constraint.percentage(50),
-              RatatuiRuby::Constraint.percentage(50),
-            ],
-            children: [
-              RatatuiRuby::Paragraph.new(text: "Above custom widget"),
-              DiagonalWidget.new,
-            ]
-          )
-        )
-
-        event = RatatuiRuby.poll_event
-        break if event == "q" || event == :ctrl_c
-      end
-    end
-  end
-end
-
-CustomWidgetApp.new.run if __FILE__ == $PROGRAM_NAME

data/examples/custom_widget/app.rbs

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

data/examples/custom_widget/test_app.rb

@@ -1,30 +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 TestCustomWidget < Minitest::Test
-  include RatatuiRuby::TestHelper
-
-  def setup
-    @app = CustomWidgetApp.new
-  end
-
-  def test_render
-    with_test_terminal do
-      inject_key(:q)
-      @app.run
-      
-      content = buffer_content.join("\n")
-      assert_includes content, "Above custom widget"
-      # The custom widget draws backslashes
-      assert_includes content, "\\"
-    end
-  end
-end