ratatui_ruby 0.5.0 → 0.7.0

data/examples/widget_block_titles/app.rb

@@ -1,69 +0,0 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later
-
-# frozen_string_literal: true
-
-$LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
-require "ratatui_ruby"
-
-# Initialize the terminal
-class WidgetBlockTitles
-  def run
-    RatatuiRuby.run do |tui|
-      loop do
-        # Create a layout with multiple blocks demonstrating titles
-        blocks = [
-          tui.block(
-            titles: [
-              { content: "Top Left", alignment: :left, position: :top },
-              { content: "Top Right", alignment: :right, position: :top },
-            ],
-            borders: [:all],
-            border_color: "cyan"
-          ),
-          tui.block(
-            titles: [
-              { content: "Bottom Left", alignment: :left, position: :bottom },
-              { content: "Bottom Center", alignment: :center, position: :bottom },
-              { content: "Bottom Right", alignment: :right, position: :bottom },
-            ],
-            borders: [:all],
-            border_color: "magenta"
-          ),
-          tui.block(
-            titles: [
-              "Simple String Title (Top Left Default)",
-              { content: "Mixed Title", alignment: :center, position: :bottom },
-            ],
-            borders: [:all],
-            border_color: "green"
-          ),
-        ]
-
-        tui.draw do |frame|
-          layout = tui.layout_split(
-            frame.area,
-            direction: :vertical,
-            constraints: [
-              tui.constraint(:length, 10),
-              tui.constraint(:length, 10),
-              tui.constraint(:length, 10),
-            ]
-          )
-
-          layout.each_with_index do |area, i|
-            frame.render_widget(blocks[i], area) if blocks[i]
-          end
-        end
-
-        event = tui.poll_event
-        break if event == "q" || event == :ctrl_c
-      end
-    end
-  end
-end
-
-if __FILE__ == $0
-  WidgetBlockTitles.new.run
-end

data/examples/widget_list_styles/app.rb

@@ -1,141 +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"
-
-# Styled List Example
-# Demonstrates advanced styling options for the List widget.
-class WidgetListStyles
-  attr_reader :selected_index, :highlight_spacing
-
-  def initialize
-    @items = ["Item 1", "Item 2", "Item 3"]
-    @selected_index = nil
-
-    @directions = [
-      { name: "Top to Bottom", direction: :top_to_bottom },
-      { name: "Bottom to Top", direction: :bottom_to_top },
-    ]
-    @direction_index = 0
-
-    @highlight_spacings = [
-      { name: "When Selected", spacing: :when_selected },
-      { name: "Always", spacing: :always },
-      { name: "Never", spacing: :never },
-    ]
-    @highlight_spacing_index = 0
-
-    @repeat_modes = [
-      { name: "Off", repeat: false },
-      { name: "On", repeat: true },
-    ]
-    @repeat_index = 0
-  end
-
-  def run
-    RatatuiRuby.run do |tui|
-      @tui = tui
-      @hotkey_style = @tui.style(modifiers: [:bold, :underlined])
-
-      loop do
-        render
-        break if handle_input == :quit
-        sleep 0.05
-      end
-    end
-  end
-
-  private def render
-    selection_label = @selected_index.nil? ? "none" : @selected_index.to_s
-    direction_config = @directions[@direction_index]
-    spacing_config = @highlight_spacings[@highlight_spacing_index]
-    repeat_config = @repeat_modes[@repeat_index]
-
-    @tui.draw do |frame|
-      # Split into main content and control panel
-      main_area, control_area = @tui.layout_split(
-        frame.area,
-        direction: :vertical,
-        constraints: [
-          @tui.constraint_fill(1),
-          @tui.constraint_length(5),
-        ]
-      )
-
-      # Render list
-      main_list = @tui.list(
-        items: @items,
-        selected_index: @selected_index,
-        style: @tui.style(fg: :white, bg: :black),
-        highlight_style: @tui.style(fg: :blue, bg: :white, modifiers: [:bold]),
-        highlight_symbol: ">> ",
-        repeat_highlight_symbol: repeat_config[:repeat],
-        highlight_spacing: spacing_config[:spacing],
-        direction: direction_config[:direction],
-        block: @tui.block(
-          title: "Items",
-          borders: [:all]
-        )
-      )
-      frame.render_widget(main_list, main_area)
-
-      # Render control panel
-      control_panel = @tui.block(
-        title: "Controls",
-        borders: [:all],
-        children: [
-          @tui.paragraph(
-            text: [
-              @tui.text_line(spans: [
-                @tui.text_span(content: "↑/↓", style: @hotkey_style),
-                @tui.text_span(content: ": Select (#{selection_label})  "),
-                @tui.text_span(content: "x", style: @hotkey_style),
-                @tui.text_span(content: ": Toggle Selection  "),
-                @tui.text_span(content: "q", style: @hotkey_style),
-                @tui.text_span(content: ": Quit"),
-              ]),
-              @tui.text_line(spans: [
-                @tui.text_span(content: "d", style: @hotkey_style),
-                @tui.text_span(content: ": Direction (#{direction_config[:name]})  "),
-                @tui.text_span(content: "s", style: @hotkey_style),
-                @tui.text_span(content: ": Spacing (#{spacing_config[:name]})"),
-              ]),
-              @tui.text_line(spans: [
-                @tui.text_span(content: "r", style: @hotkey_style),
-                @tui.text_span(content: ": Repeat Symbol (#{repeat_config[:name]})"),
-              ]),
-            ]
-          ),
-        ]
-      )
-      frame.render_widget(control_panel, control_area)
-    end
-  end
-
-  private def handle_input
-    case @tui.poll_event
-    in { type: :key, code: "q" } | { type: :key, code: "c", modifiers: ["ctrl"] }
-      :quit
-    in type: :key, code: "up"
-      @selected_index = (@selected_index || 0) - 1
-      @selected_index = @items.size - 1 if @selected_index.negative?
-    in type: :key, code: "down"
-      @selected_index = ((@selected_index || -1) + 1) % @items.size
-    in type: :key, code: "d"
-      @direction_index = (@direction_index + 1) % @directions.size
-    in type: :key, code: "s"
-      @highlight_spacing_index = (@highlight_spacing_index + 1) % @highlight_spacings.size
-    in type: :key, code: "r"
-      @repeat_index = (@repeat_index + 1) % @repeat_modes.size
-    in type: :key, code: "x"
-      @selected_index = @selected_index.nil? ? 0 : nil
-    else
-      nil
-    end
-  end
-end
-
-WidgetListStyles.new.run if __FILE__ == $PROGRAM_NAME

data/examples/widget_table_flex/app.rb

@@ -1,95 +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 structured data layout with flexible column distribution.
-#
-# Data is often multidimensional. You need to show relationships between fields (Name, Age, ID). Aligning columns manually in a monospaced environment is painful and error-prone.
-#
-# This demo showcases the <tt>Table</tt> widget's flex modes. It renders multiple tables demonstrating how data is distributed across the available space using <tt>:legacy</tt>, <tt>:space_between</tt>, and <tt>:space_around</tt> settings.
-#
-# Use it to understand how to build perfectly aligned grids for database records, logs, or file lists.
-#
-# === Example
-#
-# Run the demo from the terminal:
-#
-#   ruby examples/widget_table_flex/app.rb
-#
-# rdoc-image:/doc/images/widget_table_flex.png
-class WidgetTableFlex
-  def run
-    RatatuiRuby.run do |tui|
-      loop do
-        render(tui)
-        break if handle_input(tui) == :quit
-      end
-    end
-  end
-
-  def render(tui)
-    tui.draw do |frame|
-      chunks = tui.layout_split(
-        frame.area,
-        direction: :vertical,
-        constraints: [
-          tui.constraint_length(3),
-          tui.constraint_fill(1),
-          tui.constraint_fill(1),
-          tui.constraint_fill(1),
-        ]
-      )
-
-      frame.render_widget(
-        tui.paragraph(
-          text: "Table Flex Layout (press 'q' to quit)",
-          block: tui.block(title: "Header", borders: [:all])
-        ),
-        chunks[0]
-      )
-
-      frame.render_widget(
-        tui.table(
-          header: ["Legacy (Default)", "Table"],
-          rows: [["Item 1", "Item 2"], ["Item 3", "Item 4"]],
-          widths: [tui.constraint_length(20), tui.constraint_length(20)],
-          block: tui.block(title: "Flex: :legacy (Default)", borders: [:all])
-        ),
-        chunks[1]
-      )
-
-      frame.render_widget(
-        tui.table(
-          header: ["Space", "Between"],
-          rows: [["A", "B"], ["C", "D"]],
-          widths: [tui.constraint_length(20), tui.constraint_length(20)],
-          block: tui.block(title: "Flex: :space_between", borders: [:all]),
-          flex: :space_between
-        ),
-        chunks[2]
-      )
-
-      frame.render_widget(
-        tui.table(
-          header: ["Space", "Around"],
-          rows: [["E", "F"], ["G", "H"]],
-          widths: [tui.constraint_length(20), tui.constraint_length(20)],
-          block: tui.block(title: "Flex: :space_around", borders: [:all]),
-          flex: :space_around
-        ),
-        chunks[3]
-      )
-    end
-  end
-
-  def handle_input(tui)
-    event = tui.poll_event
-    :quit if event == "q" || event == :ctrl_c
-  end
-end
-
-WidgetTableFlex.new.run if __FILE__ == $0