ratatui_ruby 0.3.1 → 0.4.0

data/examples/table_select/test_app.rb

@@ -0,0 +1,180 @@
+#!/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"
+require "ratatui_ruby/test_helper"
+require "minitest/autorun"
+require_relative "app"
+
+# Tests for the table_select example
+class TestTableSelectApp < Minitest::Test
+  include RatatuiRuby::TestHelper
+
+  def setup
+    @app = TableSelectApp.new
+  end
+
+  def test_initial_render_no_selection
+    with_test_terminal do
+      # By default, selection is at index 1 and highlights are on.
+      inject_key(:q)
+      @app.run
+
+      content = buffer_content.join("\n")
+      # Row 1 (postgres) should be selected.
+      # Default style is Cyan.
+      # "Toggle Row (1)" should be visible in footer.
+      assert_includes content, "Toggle Row (1)"
+      assert_includes content, "Cyan"
+      assert_includes content, "PID"
+    end
+  end
+
+  def test_style_switching
+    second_style_name = TableSelectApp::STYLES[1][:name]
+
+    with_test_terminal do
+      inject_keys(:s, :q)
+      @app.run
+
+      content = buffer_content
+      assert content.any? { |line| line.include?(second_style_name) }
+    end
+  end
+
+  def test_toggle_selection_on
+    with_test_terminal do
+      # Default is ON (1 selected).
+      # Press x to toggle off (none), then quit
+      inject_keys(:x, :q)
+      @app.run
+
+      content = buffer_content.join("\n")
+      # "Toggle Row (none)" should be visible.
+      assert_includes content, "Toggle Row (none)"
+    end
+  end
+
+  def test_toggle_selection_off
+    with_test_terminal do
+      # Default is ON.
+      # Press x to toggle off, x again to toggle on (0 selected now because toggle logic resets to 0 if nil?), then quit
+      # Wait, app logic: @selected_index = @selected_index.nil? ? 0 : nil
+      # If default is 1, toggling off makes it nil. Toggling on makes it 0.
+      inject_keys(:x, :x, :q)
+      @app.run
+
+      content = buffer_content.join("\n")
+      assert_includes content, "Toggle Row (0)"
+    end
+  end
+
+  def test_navigation_selects_and_moves
+    with_test_terminal do
+      # Default is 1. Down -> 2.
+      inject_keys(:down, :q)
+      @app.run
+
+      content = buffer_content.join("\n")
+      assert_includes content, "Toggle Row (2)"
+    end
+  end
+
+  def test_navigation_wrapping
+    with_test_terminal do
+      # Start 1, down->2... wrap around logic needs check.
+      # Logic: (@selected_index + 1) % length.
+      # To test wrap, need to go to end. Length is 7.
+      # From 1, need 6 downs to wrap? No, just up from 0 wraps to last.
+      # So: up (1->0), up (0->6).
+      inject_keys(:up, :up, :q)
+      @app.run
+
+      content = buffer_content.join("\n")
+      last_index = PROCESSES.length - 1
+      assert_includes content, "Toggle Row (#{last_index})"
+    end
+  end
+
+  def test_column_navigation
+    with_test_terminal do
+      # Default col 1. Right -> 2.
+      inject_keys(:right, :q)
+      @app.run
+
+      content = buffer_content.join("\n")
+      assert_includes content, "Nav Col"
+      # We don't have a label for selected column in the footer anymore?
+      # Wait, I added it in app.rb but removed it in previous step?
+      # In Step 115 I added `col_label` but I didn't verify if I used it in the UI.
+      # Let me check app.rb again. I might have missed adding it to the UI in Step 87 layout fix or Step 115.
+      # Step 115 added `col_label = ...` but did NOT add it to the Paragraph text.
+      # I need to check app.rb to see if `col_label` is rendered.
+    end
+  end
+
+  def test_quit
+    with_test_terminal do
+      inject_key(:q)
+      @app.run
+    end
+  end
+
+  def test_highlight_spacing_cycles_to_next
+    with_test_terminal do
+      # Mode order: [:when_selected, :always, :never]
+      # 'p' goes to :always
+      inject_keys(:p, :q)
+      @app.run
+
+      content = buffer_content
+      assert content.any? { |line| line.include?("Always") }
+    end
+  end
+
+  def test_highlight_spacing_cycles_to_never
+    with_test_terminal do
+      # 'p' goes: when_selected -> always -> never
+      inject_keys(:p, :p, :q)
+      @app.run
+
+      content = buffer_content
+      assert content.any? { |line| line.include?("Never") }
+    end
+  end
+
+  def test_highlight_spacing_cycles_back_to_when_selected
+    with_test_terminal do
+      # 'p' goes: when_selected -> always -> never -> when_selected
+      inject_keys(:p, :p, :p, :q)
+      @app.run
+
+      content = buffer_content
+      assert content.any? { |line| line.include?("When Selected") }
+    end
+  end
+
+  def test_column_spacing_increases
+    with_test_terminal do
+      inject_keys("+", :q)
+      @app.run
+
+      content = buffer_content
+      assert content.any? { |line| line.include?("Col Space (2)") }
+    end
+  end
+
+  def test_column_spacing_decreases
+    with_test_terminal do
+      inject_keys("+", "-", :q)
+      @app.run
+
+      content = buffer_content
+      assert content.any? { |line| line.include?("Col Space (1)") }
+    end
+  end
+end

data/examples/widget_style_colors/app.rb

@@ -0,0 +1,104 @@
+# 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 ColorGradientDemo
+  def initialize
+    @width = 80
+    @height = 24
+  end
+
+  def run
+    RatatuiRuby.run do |tui|
+      loop do
+        render(tui)
+        event = tui.poll_event
+        break if event&.key? && (event.ctrl_c? || event == :q)
+      end
+    end
+  end
+
+  private
+
+  def render(tui)
+    lines = []
+
+    (0...@height).each do |row|
+      spans = []
+      (0...@width).each do |col|
+        hue = (col.to_f / @width) * 360.0
+        lightness = 50.0 - ((row.to_f / @height) * 50.0)
+
+        rgb = hsl_to_rgb(hue, 100.0, lightness)
+        hex = rgb_to_hex(rgb)
+
+        span = tui.text_span(
+          content: " ",
+          style: tui.style(bg: hex)
+        )
+        spans << span
+      end
+
+      lines << tui.text_line(spans: spans)
+    end
+
+    paragraph = tui.paragraph(
+      text: lines,
+      block: tui.block(
+        title: "Hex Color Gradient (Press 'q' or Ctrl+C to exit)",
+        borders: [:all],
+        border_type: :rounded
+      )
+    )
+
+    tui.draw(paragraph)
+  end
+
+  def hsl_to_rgb(hue, saturation, lightness)
+    h = hue / 360.0
+    s = saturation / 100.0
+    l = lightness / 100.0
+
+    if s == 0
+      r = g = b = l
+    else
+      q = l < 0.5 ? l * (1 + s) : l + s - (l * s)
+      p = 2 * l - q
+
+      r = hue_to_rgb(p, q, h + 1.0 / 3.0)
+      g = hue_to_rgb(p, q, h)
+      b = hue_to_rgb(p, q, h - 1.0 / 3.0)
+    end
+
+    [
+      (r * 255).round,
+      (g * 255).round,
+      (b * 255).round
+    ]
+  end
+
+  def hue_to_rgb(p, q, t)
+    t += 1 while t < 0
+    t -= 1 while t > 1
+
+    if t < 1.0 / 6.0
+      p + (q - p) * 6 * t
+    elsif t < 1.0 / 2.0
+      q
+    elsif t < 2.0 / 3.0
+      p + (q - p) * (2.0 / 3.0 - t) * 6
+    else
+      p
+    end
+  end
+
+  def rgb_to_hex(rgb)
+    "##{rgb.map { |c| c.to_s(16).upcase.rjust(2, '0') }.join}"
+  end
+end
+
+ColorGradientDemo.new.run if __FILE__ == $PROGRAM_NAME

data/examples/widget_style_colors/app.rbs

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class ColorGradientDemo
+  def initialize: () -> void
+  def run: () -> void
+
+  private
+
+  def render: (RatatuiRuby::TUI) -> void
+  def hsl_to_rgb: (Float, Float, Float) -> [Integer, Integer, Integer]
+  def hue_to_rgb: (Float, Float, Float) -> Float
+  def rgb_to_hex: ([Integer, Integer, Integer]) -> String
+end

data/examples/widget_style_colors/test_app.rb

@@ -0,0 +1,48 @@
+# 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 TestColorGradientDemo < Minitest::Test
+  include RatatuiRuby::TestHelper
+
+  def setup
+    @app = ColorGradientDemo.new
+  end
+
+  def test_renders_with_title
+    with_test_terminal do
+      inject_key(:q)
+      @app.run
+
+      content = buffer_content.join("\n")
+      assert_includes content, "Hex Color Gradient"
+    end
+  end
+
+  def test_renders_gradient_cells
+    with_test_terminal do
+      inject_key(:q)
+      @app.run
+
+      content = buffer_content.join("\n")
+      # Should have many spaces (gradient cells)
+      assert content.length > 500
+    end
+  end
+
+  def test_exit_on_q
+    with_test_terminal do
+      inject_key(:q)
+      @app.run
+      # If we get here without hanging, exit worked
+      assert true
+    end
+  end
+end