ratatui_ruby 0.8.0 → 0.9.1

data/lib/ratatui_ruby/widgets/canvas.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -172,6 +172,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Canvas.new(
     #     x_bounds: [-180, 180],
     #     y_bounds: [-90, 90],
@@ -181,6 +186,9 @@ module RatatuiRuby
     #       Shape::Label.new(x: -122.4, y: 37.8, text: "San Francisco")
     #     ]
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Canvas < Data.define(:shapes, :x_bounds, :y_bounds, :marker, :block, :background_color)
       ##
       # :attr_reader: shapes

data/lib/ratatui_ruby/widgets/cell.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -17,6 +17,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   # Cell with yellow background
     #   Widgets::Cell.new(content: "Warning", style: Style::Style.new(bg: :yellow))
     #
@@ -28,6 +33,9 @@ module RatatuiRuby
     #     ]),
     #     style: Style::Style.new(bg: :dark_gray)
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Cell < Data.define(:content, :style)
       ##
       # :attr_reader: content

data/lib/ratatui_ruby/widgets/center.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -18,12 +18,20 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   # Center a paragraph using 50% of width and height
     #   Center.new(
     #     child: Paragraph.new(text: "Hello"),
     #     width_percent: 50,
     #     height_percent: 50
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Center < Data.define(:child, :width_percent, :height_percent)
       ##
       # :attr_reader: child

data/lib/ratatui_ruby/widgets/chart.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -162,31 +162,5 @@ module RatatuiRuby
         super
       end
     end
-
-    # A complex chart widget. (Legacy/Alias for Chart)
-    #
-    # [datasets] Array of Dataset objects.
-    # [x_labels] Array of Strings for the X-axis labels.
-    # [y_labels] Array of Strings for the Y-axis labels.
-    # [y_bounds] Array of two Floats [min, max] for the Y-axis.
-    # [block] Optional block widget to wrap the chart.
-    class LineChart < Data.define(:datasets, :x_labels, :y_labels, :y_bounds, :block)
-      # Creates a new LineChart widget.
-      #
-      # [datasets] Array of Dataset objects.
-      # [x_labels] Array of Strings for the X-axis labels.
-      # [y_labels] Array of Strings for the Y-axis labels.
-      # [y_bounds] Array of two Floats [min, max] for the Y-axis.
-      # [block] Optional block widget to wrap the chart.
-      def initialize(datasets:, x_labels: [], y_labels: [], y_bounds: [0.0, 100.0], block: nil)
-        super(
-          datasets:,
-          x_labels:,
-          y_labels:,
-          y_bounds: [Float(y_bounds[0]), Float(y_bounds[1])],
-          block:
-        )
-      end
-    end
   end
 end

data/lib/ratatui_ruby/widgets/clear.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -18,6 +18,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   # Opaque Popup Construction
     #   Overlay.new(
     #     layers: [
@@ -37,6 +42,9 @@ module RatatuiRuby
     #
     #   # Shortcut: rendering a block directly
     #   Clear.new(block: Block.new(title: "Cleared area", borders: [:all]))
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Clear < Data.define(:block)
       ##
       # :attr_reader: block

data/lib/ratatui_ruby/widgets/cursor.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -17,8 +17,16 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Cursor.new(x: 10, y: 5)
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # See also:
     # - {Declarative implementation using Tree API}[link:/examples/app_login_form/app_rb.html]
     # - {Component-based implementation using Frame API}[link:/examples/app_color_picker/app_rb.html]

data/lib/ratatui_ruby/widgets/gauge.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -69,6 +69,20 @@ module RatatuiRuby
         ratio = Float(ratio || 0.0)
         super(ratio:, label:, style:, gauge_style:, block:, use_unicode:)
       end
+
+      # Returns true if the gauge has any fill (ratio > 0).
+      #
+      # @return [Boolean]
+      def filled?
+        ratio > 0
+      end
+
+      # Returns true if the gauge is at 100% or more (ratio >= 1.0).
+      #
+      # @return [Boolean]
+      def complete?
+        ratio >= 1.0
+      end
     end
   end
 end

data/lib/ratatui_ruby/widgets/line_gauge.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -77,6 +77,20 @@ module RatatuiRuby
           unfilled_symbol:
         )
       end
+
+      # Returns true if the gauge has any fill (ratio > 0).
+      #
+      # @return [Boolean]
+      def filled?
+        ratio > 0
+      end
+
+      # Returns true if the gauge is at 100% or more (ratio >= 1.0).
+      #
+      # @return [Boolean]
+      def complete?
+        ratio >= 1.0
+      end
     end
   end
 end

data/lib/ratatui_ruby/widgets/list.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -20,6 +20,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   # Basic List
     #   List.new(items: ["Item 1", "Item 2"])
     #
@@ -30,7 +35,27 @@ module RatatuiRuby
     #     highlight_style: Style.new(bg: :blue),
     #     highlight_symbol: ">> "
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class List < Data.define(:items, :selected_index, :offset, :style, :highlight_style, :highlight_symbol, :repeat_highlight_symbol, :highlight_spacing, :direction, :scroll_padding, :block)
+      ##
+      # Highlight spacing: always show the spacing column.
+      HIGHLIGHT_ALWAYS = :always
+      ##
+      # Highlight spacing: show spacing only when an item is selected (default).
+      HIGHLIGHT_WHEN_SELECTED = :when_selected
+      ##
+      # Highlight spacing: never show the spacing column.
+      HIGHLIGHT_NEVER = :never
+
+      ##
+      # Direction: render items from top to bottom (default).
+      DIRECTION_TOP_TO_BOTTOM = :top_to_bottom
+      ##
+      # Direction: render items from bottom to top.
+      DIRECTION_BOTTOM_TO_TOP = :bottom_to_top
+
       ##
       # :attr_reader: items
       # The items to display.
@@ -124,6 +149,20 @@ module RatatuiRuby
           block:
         )
       end
+
+      # Returns true if an item is selected.
+      #
+      # @return [Boolean]
+      def selected?
+        !selected_index.nil?
+      end
+
+      # Returns true if the list has no items.
+      #
+      # @return [Boolean]
+      def empty?
+        items.empty?
+      end
     end
   end
 end

data/lib/ratatui_ruby/widgets/list_item.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -17,6 +17,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   # Item with red background
     #   ListItem.new(content: "Error", style: Style.new(bg: :red))
     #
@@ -24,6 +29,9 @@ module RatatuiRuby
     #   ListItem.new(
     #     content: Text::Span.new(content: "Status: OK", style: Style.new(fg: :green, modifiers: [:bold]))
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class ListItem < Data.define(:content, :style)
       ##
       # :attr_reader: content

data/lib/ratatui_ruby/widgets/overlay.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -19,6 +19,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Overlay.new(
     #     layers: [
     #       BackgroundMap.new,
@@ -26,6 +31,9 @@ module RatatuiRuby
     #       ModalDialog.new  # Draws over everything
     #     ]
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Overlay < Data.define(:layers)
       ##
       # :attr_reader: layers

data/lib/ratatui_ruby/widgets/paragraph.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -17,6 +17,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   # Basic Text
     #   Paragraph.new(text: "Hello, World!")
     #
@@ -30,6 +35,9 @@ module RatatuiRuby
     #
     #   # Scrolling mechanism
     #   Paragraph.new(text: large_text, scroll: [scroll_y, 0])
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Paragraph < Data.define(:text, :style, :block, :wrap, :alignment, :scroll)
       ##
       # :attr_reader: text

data/lib/ratatui_ruby/widgets/ratatui_logo.rb

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

data/lib/ratatui_ruby/widgets/ratatui_mascot.rb

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

data/lib/ratatui_ruby/widgets/row.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -17,6 +17,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   # Row with red background
     #   Row.new(cells: ["Error", "Something went wrong"], style: Style.new(bg: :red))
     #
@@ -28,6 +33,9 @@ module RatatuiRuby
     #     ],
     #     height: 2
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Row < Data.define(:cells, :style, :height, :top_margin, :bottom_margin)
       ##
       # :attr_reader: cells

data/lib/ratatui_ruby/widgets/scrollbar.rb

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

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

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -20,6 +20,11 @@ module RatatuiRuby
       #
       # === Examples
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   # Simple label
       #   Shape::Label.new(x: 0, y: 0, text: "Origin")
       #
@@ -38,6 +43,9 @@ module RatatuiRuby
       #       Text::Span.new(content: "World", style: Style.new(fg: :blue))
       #     ])
       #   )
+      #--
+      # SPDX-SnippetEnd
+      #++
       class Label < Data.define(:x, :y, :text, :style)
         ##
         # :attr_reader: x

data/lib/ratatui_ruby/widgets/sparkline.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -72,6 +72,11 @@ module RatatuiRuby
       #
       # === Examples
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   bar_set: {
       #     empty: " ",
       #     one_eighth: " ",
@@ -91,6 +96,9 @@ module RatatuiRuby
       #
       #   # Array (9 items)
       #   bar_set: [" ", " ", "▂", "▃", "▄", "▅", "▆", "▇", "█"]
+      #--
+      # SPDX-SnippetEnd
+      #++
 
       BAR_KEYS = %i[empty one_eighth one_quarter three_eighths half five_eighths three_quarters seven_eighths full].freeze
 

data/lib/ratatui_ruby/widgets/table.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -24,6 +24,38 @@ module RatatuiRuby
     #
     #   ruby examples/widget_table_flex/app.rb
     class Table < Data.define(:header, :rows, :widths, :row_highlight_style, :highlight_symbol, :highlight_spacing, :column_highlight_style, :cell_highlight_style, :selected_row, :selected_column, :offset, :block, :footer, :flex, :style, :column_spacing)
+      ##
+      # Highlight spacing: always show the spacing column.
+      HIGHLIGHT_ALWAYS = :always
+      ##
+      # Highlight spacing: show spacing only when a row is selected (default).
+      HIGHLIGHT_WHEN_SELECTED = :when_selected
+      ##
+      # Highlight spacing: never show the spacing column.
+      HIGHLIGHT_NEVER = :never
+
+      ##
+      # Flex: use legacy column sizing.
+      FLEX_LEGACY = :legacy
+      ##
+      # Flex: align columns to start.
+      FLEX_START = :start
+      ##
+      # Flex: center columns.
+      FLEX_CENTER = :center
+      ##
+      # Flex: align columns to end.
+      FLEX_END = :end
+      ##
+      # Flex: space between columns.
+      FLEX_SPACE_BETWEEN = :space_between
+      ##
+      # Flex: space around columns.
+      FLEX_SPACE_AROUND = :space_around
+      ##
+      # Flex: space evenly between columns.
+      FLEX_SPACE_EVENLY = :space_evenly
+
       ##
       # :attr_reader: header
       # Header row content (Array of Strings, Text::Spans, Text::Lines, or Paragraphs).
@@ -138,6 +170,34 @@ module RatatuiRuby
           column_spacing: Integer(column_spacing)
         )
       end
+
+      # Returns true if a row is selected.
+      #
+      # @return [Boolean]
+      def row_selected?
+        !selected_row.nil?
+      end
+
+      # Returns true if a column is selected.
+      #
+      # @return [Boolean]
+      def column_selected?
+        !selected_column.nil?
+      end
+
+      # Returns true if both a row and column are selected (a cell is selected).
+      #
+      # @return [Boolean]
+      def cell_selected?
+        row_selected? && column_selected?
+      end
+
+      # Returns true if the table has no rows.
+      #
+      # @return [Boolean]
+      def empty?
+        rows.empty?
+      end
     end
   end
 end

data/lib/ratatui_ruby/widgets/tabs.rb

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

data/lib/ratatui_ruby/widgets.rb

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