ratatui_ruby 0.7.0 → 0.7.2

data/lib/ratatui_ruby/test_helper/terminal.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 require "timeout"
 require "minitest/mock"

data/lib/ratatui_ruby/test_helper/test_doubles.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module TestHelper

data/lib/ratatui_ruby/test_helper.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+#--
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
 require "fileutils"
 require_relative "test_helper/terminal"
 require_relative "test_helper/snapshot"
@@ -7,9 +12,6 @@ require_relative "test_helper/event_injection"
 require_relative "test_helper/style_assertions"
 require_relative "test_helper/test_doubles"
 
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-
 module RatatuiRuby
   ##
   # Helpers for testing RatatuiRuby applications.

data/lib/ratatui_ruby/tui/buffer_factories.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   class TUI

data/lib/ratatui_ruby/tui/canvas_factories.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   class TUI

data/lib/ratatui_ruby/tui/core.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   class TUI

data/lib/ratatui_ruby/tui/layout_factories.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   class TUI

data/lib/ratatui_ruby/tui/state_factories.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   class TUI

data/lib/ratatui_ruby/tui/style_factories.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   class TUI

data/lib/ratatui_ruby/tui/text_factories.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   class TUI

data/lib/ratatui_ruby/tui/widget_factories.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   class TUI

data/lib/ratatui_ruby/tui.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 require_relative "tui/core"
 require_relative "tui/layout_factories"

data/lib/ratatui_ruby/version.rb

@@ -1,10 +1,12 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   # The version of the ratatui_ruby gem.
   # See https://semver.org/spec/v2.0.0.html
-  VERSION = "0.7.0"
+  VERSION = "0.7.2"
 end

data/lib/ratatui_ruby/widgets/bar_chart/bar.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/bar_chart/bar_group.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/bar_chart.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -13,13 +15,13 @@ module RatatuiRuby
     #
     # Use it to compare server loads, sales figures, or any discrete datasets.
     #
-    # {rdoc-image:/doc/images/widget_barchart_demo.png}[link:/examples/widget_barchart_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_barchart.png}[link:/examples/widget_barchart/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_barchart_demo/app.rb
+    #   ruby examples/widget_barchart/app.rb
     #
     #   # Grouped Bar Chart
     #   BarChart.new(

data/lib/ratatui_ruby/widgets/block.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -13,13 +15,13 @@ module RatatuiRuby
     #
     # Use blocks to define distinct areas. Group related information. Create a visual hierarchy that guides the user's eye.
     #
-    # {rdoc-image:/doc/images/widget_box_demo.png}[link:/examples/widget_box_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_box.png}[link:/examples/widget_box/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_box_demo/app.rb
+    #   ruby examples/widget_box/app.rb
     class Block < Data.define(:title, :titles, :title_alignment, :title_style, :borders, :border_color, :border_style, :border_type, :border_set, :style, :padding, :children)
       ##
       # :attr_reader: title

data/lib/ratatui_ruby/widgets/calendar.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -14,13 +16,13 @@ module RatatuiRuby
     #
     # Use it for date pickers, schedulers, or logs.
     #
-    # {rdoc-image:/doc/images/widget_calendar_demo.png}[link:/examples/widget_calendar_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_calendar.png}[link:/examples/widget_calendar/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_calendar_demo/app.rb
+    #   ruby examples/widget_calendar/app.rb
     class Calendar < Data.define(:year, :month, :events, :default_style, :header_style, :block, :show_weekdays_header, :show_surrounding, :show_month_header)
       ##
       # :attr_reader: year

data/lib/ratatui_ruby/widgets/canvas.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/cell.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/center.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/chart.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -106,13 +108,13 @@ module RatatuiRuby
     #
     # Use it for analytics, scientific data, or monitoring metrics over time.
     #
-    # {rdoc-image:/doc/images/widget_chart_demo.png}[link:/examples/widget_chart_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_chart.png}[link:/examples/widget_chart/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_chart_demo/app.rb
+    #   ruby examples/widget_chart/app.rb
     class Chart < Data.define(:datasets, :x_axis, :y_axis, :block, :style, :legend_position, :hidden_legend_constraints)
       ##
       # :attr_reader: datasets

data/lib/ratatui_ruby/widgets/clear.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/cursor.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/gauge.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -13,13 +15,13 @@ module RatatuiRuby
     #
     # Use it for downloads, installations, or processing jobs.
     #
-    # {rdoc-image:/doc/images/widget_gauge_demo.png}[link:/examples/widget_gauge_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_gauge.png}[link:/examples/widget_gauge/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_gauge_demo/app.rb
+    #   ruby examples/widget_gauge/app.rb
     class Gauge < Data.define(:ratio, :label, :style, :gauge_style, :block, :use_unicode)
       ##
       # :attr_reader: ratio

data/lib/ratatui_ruby/widgets/line_gauge.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -13,13 +15,13 @@ module RatatuiRuby
     #
     # Use it when you need to show status without stealing focus or space.
     #
-    # {rdoc-image:/doc/images/widget_line_gauge_demo.png}[link:/examples/widget_line_gauge_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_line_gauge.png}[link:/examples/widget_line_gauge/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_line_gauge_demo/app.rb
+    #   ruby examples/widget_line_gauge/app.rb
     class LineGauge < Data.define(:ratio, :label, :style, :filled_style, :unfilled_style, :block, :filled_symbol, :unfilled_symbol)
       ##
       # :attr_reader: ratio

data/lib/ratatui_ruby/widgets/list.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -14,7 +16,7 @@ module RatatuiRuby
     #
     # Use it to build main menus, navigation sidebars, or logs.
     #
-    # {rdoc-image:/doc/images/widget_list_demo.png}[link:/examples/widget_list_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_list.png}[link:/examples/widget_list/app_rb.html]
     #
     # === Examples
     #

data/lib/ratatui_ruby/widgets/list_item.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/overlay.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/paragraph.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/ratatui_logo.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -13,13 +15,13 @@ module RatatuiRuby
     #
     # Use it for splash screens, about sections, or terminal dashboards.
     #
-    # {rdoc-image:/doc/images/widget_ratatui_logo_demo.png}[link:/examples/widget_ratatui_logo_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_ratatui_logo.png}[link:/examples/widget_ratatui_logo/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_ratatui_logo_demo/app.rb
+    #   ruby examples/widget_ratatui_logo/app.rb
     class RatatuiLogo < Data.define
       ##
       # :method: new

data/lib/ratatui_ruby/widgets/ratatui_mascot.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -13,13 +15,13 @@ module RatatuiRuby
     #
     # Use it to add charm to your application, greet users on startup, or as a decorative element in sidebars.
     #
-    # {rdoc-image:/doc/images/widget_ratatui_mascot_demo.png}[link:/examples/widget_ratatui_mascot_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_ratatui_mascot.png}[link:/examples/widget_ratatui_mascot/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_ratatui_mascot_demo/app.rb
+    #   ruby examples/widget_ratatui_mascot/app.rb
     class RatatuiMascot < Data.define(:block)
       ##
       # :method: new

data/lib/ratatui_ruby/widgets/row.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/scrollbar.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -13,13 +15,13 @@ module RatatuiRuby
     #
     # Overlay it on top of lists, paragraphs, or tables to provide spatial awareness.
     #
-    # {rdoc-image:/doc/images/widget_scrollbar_demo.png}[link:/examples/widget_scrollbar_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_scrollbar.png}[link:/examples/widget_scrollbar/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_scrollbar_demo/app.rb
+    #   ruby examples/widget_scrollbar/app.rb
     class Scrollbar < Data.define(
       :content_length,
       :position,

data/lib/ratatui_ruby/widgets/shape/label.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/sparkline.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -14,13 +16,13 @@ module RatatuiRuby
     #
     # Use it in dashboards, headers, or list items to providing trending data at a glance.
     #
-    # {rdoc-image:/doc/images/widget_sparkline_demo.png}[link:/examples/widget_sparkline_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_sparkline.png}[link:/examples/widget_sparkline/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_sparkline_demo/app.rb
+    #   ruby examples/widget_sparkline/app.rb
     class Sparkline < Data.define(:data, :max, :style, :block, :direction, :absent_value_symbol, :absent_value_style, :bar_set)
       ##
       # :attr_reader: data

data/lib/ratatui_ruby/widgets/table.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets

data/lib/ratatui_ruby/widgets/tabs.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   module Widgets
@@ -13,13 +15,13 @@ module RatatuiRuby
     #
     # Use it at the top of your interface to switch between major modes or contexts.
     #
-    # {rdoc-image:/doc/images/widget_tabs_demo.png}[link:/examples/widget_tabs_demo/app_rb.html]
+    # {rdoc-image:/doc/images/widget_tabs.png}[link:/examples/widget_tabs/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_tabs_demo/app.rb
+    #   ruby examples/widget_tabs/app.rb
     class Tabs < Data.define(:titles, :selected_index, :block, :divider, :highlight_style, :style, :padding_left, :padding_right)
       ##
       # :attr_reader: titles
@@ -47,11 +49,13 @@ module RatatuiRuby
 
       ##
       # :attr_reader: padding_left
-      # Left padding for the tabs area (Integer, default: 0).
+      # Left padding for the tabs area.
+      # Accepts Integer (number of spaces), String, or Line for styled content.
 
       ##
       # :attr_reader: padding_right
-      # Right padding for the tabs area (Integer, default: 0).
+      # Right padding for the tabs area.
+      # Accepts Integer (number of spaces), String, or Line for styled content.
 
       # Creates a new Tabs widget.
       #
@@ -61,8 +65,8 @@ module RatatuiRuby
       # [divider] String (optional).
       # [highlight_style] Style (optional).
       # [style] Style (optional).
-      # [padding_left] Integer (default: 0).
-      # [padding_right] Integer (default: 0).
+      # [padding_left] Integer, String, or Line (default: 0).
+      # [padding_right] Integer, String, or Line (default: 0).
       def initialize(titles: [], selected_index: 0, block: nil, divider: nil, highlight_style: nil, style: nil, padding_left: 0, padding_right: 0)
         super(
           titles:,
@@ -71,8 +75,8 @@ module RatatuiRuby
           divider:,
           highlight_style:,
           style:,
-          padding_left: Integer(padding_left),
-          padding_right: Integer(padding_right)
+          padding_left:,
+          padding_right:
         )
       end
 

data/lib/ratatui_ruby/widgets.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+#--
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
+#++
 
 module RatatuiRuby
   # Widget classes for building terminal UIs.