ratatui_ruby 0.7.1 → 0.7.3

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.1"
+  VERSION = "0.7.3"
 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(
@@ -154,9 +156,10 @@ module RatatuiRuby
       # [value_style]
       #   Style object for values (optional).
       # [bar_set]
-      #   Hash or Array: Custom characters for the bars.
+      #   Symbol, Hash, or Array: Custom characters for bars.
+      #   Symbols: <tt>:nine_levels</tt> (default gradient), <tt>:three_levels</tt> (simplified).
       def initialize(data:, bar_width: 3, bar_gap: 1, group_gap: 0, max: nil, style: nil, block: nil, direction: :vertical, label_style: nil, value_style: nil, bar_set: nil)
-        if bar_set
+        if bar_set && !bar_set.is_a?(Symbol)
           if bar_set.is_a?(Array) && bar_set.size == 9
             # Convert Array to Hash using BAR_KEYS order
             bar_set = BAR_KEYS.zip(bar_set).to_h

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
@@ -187,6 +189,48 @@ module RatatuiRuby
           children:
         )
       end
+
+      # Computes the inner content area given an outer area.
+      #
+      # This method calculates where content should be placed within a block,
+      # accounting for borders and padding. Essential for layout calculations
+      # when you need to know the usable space inside a block.
+      #
+      # === Example
+      #
+      #   block = Block.new(borders: [:all], padding: 1)
+      #   outer = Layout::Rect.new(x: 0, y: 0, width: 20, height: 10)
+      #   inner = block.inner(outer)
+      #   # => Rect(x: 2, y: 2, width: 16, height: 6)
+      #
+      # [area]
+      #   The outer Rect to compute the inner area for.
+      #
+      # Returns a new Rect representing the inner content area.
+      def inner(area)
+        # Calculate border offsets
+        has_border = -> (side) { borders.include?(:all) || borders.include?(side) }
+        left_border = has_border.call(:left) ? 1 : 0
+        right_border = has_border.call(:right) ? 1 : 0
+        top_border = has_border.call(:top) ? 1 : 0
+        bottom_border = has_border.call(:bottom) ? 1 : 0
+
+        # Calculate padding offsets
+        if padding.is_a?(Array)
+          # [left, right, top, bottom]
+          pad_left, pad_right, pad_top, pad_bottom = padding
+        else
+          pad_left = pad_right = pad_top = pad_bottom = padding
+        end
+
+        # Compute inner area
+        new_x = area.x + left_border + pad_left
+        new_y = area.y + top_border + pad_top
+        new_width = [area.width - left_border - right_border - pad_left - pad_right, 0].max
+        new_height = [area.height - top_border - bottom_border - pad_top - pad_bottom, 0].max
+
+        Layout::Rect.new(x: new_x, y: new_y, width: new_width, height: new_height)
+      end
     end
   end
 end

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
@@ -54,7 +56,7 @@ module RatatuiRuby
     # [name] The name of the dataset.
     # [data] Array of arrays [[x, y], [x, y]] (Floats).
     # [style] The style of the line.
-    # [marker] Symbol (<tt>:dot</tt>, <tt>:braille</tt>, <tt>:block</tt>, <tt>:bar</tt>)
+    # [marker] Symbol (<tt>:dot</tt>, <tt>:braille</tt>, <tt>:block</tt>, <tt>:bar</tt>, <tt>:half_block</tt>)
     # [graph_type] Symbol (<tt>:line</tt>, <tt>:scatter</tt>)
     class Dataset < Data.define(:name, :data, :style, :marker, :graph_type)
       ##
@@ -79,7 +81,9 @@ module RatatuiRuby
 
       ##
       # :attr_reader: marker
-      # Marker type (<tt>:dot</tt>, <tt>:braille</tt>).
+      # Marker type (<tt>:dot</tt>, <tt>:braille</tt>, <tt>:block</tt>, <tt>:bar</tt>, <tt>:half_block</tt>).
+      #
+      # <tt>:half_block</tt> uses ▀ and ▄ characters for higher resolution than <tt>:dot</tt>.
 
       ##
       # :attr_reader: graph_type
@@ -106,13 +110,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
@@ -136,7 +140,10 @@ module RatatuiRuby
 
       ##
       # :attr_reader: legend_position
-      # Position of the legend (<tt>:top_left</tt>, <tt>:top_right</tt>, <tt>:bottom_left</tt>, <tt>:bottom_right</tt>).
+      # Position of the legend.
+      #
+      # Corners: <tt>:top_left</tt>, <tt>:top_right</tt>, <tt>:bottom_left</tt>, <tt>:bottom_right</tt>.
+      # Edges: <tt>:top</tt>, <tt>:bottom</tt>, <tt>:left</tt>, <tt>:right</tt>.
 
       ##
       # :attr_reader: hidden_legend_constraints
@@ -149,7 +156,7 @@ module RatatuiRuby
       # [y_axis] Y Axis config.
       # [block] Wrapper (optional).
       # [style] Base style (optional).
-      # [legend_position] Symbol (<tt>:top_left</tt>, <tt>:top_right</tt>, <tt>:bottom_left</tt>, <tt>:bottom_right</tt>).
+      # [legend_position] Symbol — corners: <tt>:top_left</tt>, <tt>:top_right</tt>, <tt>:bottom_left</tt>, <tt>:bottom_right</tt>; edges: <tt>:top</tt>, <tt>:bottom</tt>, <tt>:left</tt>, <tt>:right</tt>.
       # [hidden_legend_constraints] Array of two Constraints [width, height] (optional).
       def initialize(datasets:, x_axis:, y_axis:, block: nil, style: nil, legend_position: nil, hidden_legend_constraints: [])
         super

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
@@ -101,9 +103,10 @@ module RatatuiRuby
       # [direction] +:left_to_right+ or +:right_to_left+ (default: +:left_to_right+).
       # [absent_value_symbol] Character for absent (nil) values (optional).
       # [absent_value_style] Style for absent (nil) values (optional).
-      # [bar_set] Hash or Array of custom characters (optional).
+      # [bar_set] Symbol, Hash, or Array of custom characters (optional).
+      #   Symbols: <tt>:nine_levels</tt> (default gradient), <tt>:three_levels</tt> (simplified).
       def initialize(data:, max: nil, style: nil, block: nil, direction: :left_to_right, absent_value_symbol: nil, absent_value_style: nil, bar_set: nil)
-        if bar_set
+        if bar_set && !bar_set.is_a?(Symbol)
           if bar_set.is_a?(Array) && bar_set.size == 9
             # Convert Array to Hash using BAR_KEYS order
             bar_set = BAR_KEYS.zip(bar_set).to_h

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.