ratatui_ruby 0.7.4 → 0.9.0

data/lib/ratatui_ruby/test_helper/style_assertions.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
@@ -21,6 +21,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   # Single cell
     #   assert_cell_style(0, 0, fg: :red, modifiers: [:bold])
     #
@@ -30,14 +35,25 @@ module RatatuiRuby
     #   # Entire header region
     #   assert_area_style({ x: 0, y: 0, w: 80, h: 1 }, bg: :blue)
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     module StyleAssertions
       ##
       # Asserts that a cell has the expected style attributes.
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   assert_cell_style(0, 0, char: "H", fg: :red)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [x] Integer x-coordinate.
       # [y] Integer y-coordinate.
       # [expected_attributes] Hash of attribute names to expected values.
@@ -60,10 +76,18 @@ module RatatuiRuby
       #
       # === Examples
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   assert_color(:red, x: 10, y: 5)
       #   assert_color(5, x: 10, y: 5, layer: :bg)
       #   assert_color("#ff00ff", x: 10, y: 5)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [expected] Symbol, Integer, or String (hex).
       # [x] Integer x-coordinate.
       # [y] Integer y-coordinate.
@@ -88,11 +112,19 @@ module RatatuiRuby
       #
       # === Examples
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   header = RatatuiRuby::Layout::Rect.new(x: 0, y: 0, width: 80, height: 1)
       #   assert_area_style(header, bg: :blue, modifiers: [:bold])
       #
       #   assert_area_style({ x: 0, y: 0, w: 10, h: 1 }, fg: :red)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [area] Rect-like object or Hash with x, y, width/w, height/h.
       # [attributes] Style attributes to verify.
       def assert_area_style(area, **attributes)
@@ -122,8 +154,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   assert_fg_color(:yellow, 0, 2)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [expected] Symbol, Integer, or String (hex).
       # [x] Integer x-coordinate.
       # [y] Integer y-coordinate.
@@ -139,8 +179,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   assert_bg_color(:blue, 0, 2)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [expected] Symbol, Integer, or String (hex).
       # [x] Integer x-coordinate.
       # [y] Integer y-coordinate.
@@ -154,8 +202,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   assert_bold(0, 2)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [x] Integer x-coordinate.
       # [y] Integer y-coordinate.
       def assert_bold(x, y)
@@ -170,8 +226,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   assert_italic(0, 2)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [x] Integer x-coordinate.
       # [y] Integer y-coordinate.
       def assert_italic(x, y)
@@ -186,8 +250,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   assert_underlined(0, 2)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [x] Integer x-coordinate.
       # [y] Integer y-coordinate.
       def assert_underlined(x, y)
@@ -203,8 +275,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   assert_dim(0, 2)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [x] Integer x-coordinate.
       # [y] Integer y-coordinate.
       def assert_dim(x, y)
@@ -219,8 +299,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   assert_reversed(0, 2)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [x] Integer x-coordinate.
       # [y] Integer y-coordinate.
       def assert_reversed(x, y)
@@ -237,8 +325,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   assert_crossed_out(0, 2)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [x] Integer x-coordinate.
       # [y] Integer y-coordinate.
       def assert_crossed_out(x, y)

data/lib/ratatui_ruby/test_helper/terminal.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
 #++
 
 require "timeout"
@@ -23,6 +23,11 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   class MyTest < Minitest::Test
     #     include RatatuiRuby::TestHelper
     #
@@ -33,6 +38,9 @@ module RatatuiRuby
     #       end
     #     end
     #   end
+    #--
+    # SPDX-SnippetEnd
+    #++
     module Terminal
       ##
       # Initializes a test terminal context with specified dimensions.
@@ -44,9 +52,17 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   with_test_terminal(120, 40) do
       #     # render and test your app
       #   end
+      #--
+      # SPDX-SnippetEnd
+      #++
       def with_test_terminal(width = 80, height = 24, **opts)
         # Defensive cleanup: reset any stale session state from previous test failures
         RatatuiRuby.instance_variable_set(:@tui_session_active, false)
@@ -80,8 +96,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   buffer_content
       #   # => ["Row 1 text", "Row 2 text", ...]
+      #--
+      # SPDX-SnippetEnd
+      #++
       def buffer_content
         RatatuiRuby.get_buffer_content.split("\n")
       end
@@ -91,8 +115,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   cursor_position
       #   # => { x: 0, y: 0 }
+      #--
+      # SPDX-SnippetEnd
+      #++
       def cursor_position
         x, y = RatatuiRuby.get_cursor_position
         { x:, y: }
@@ -108,8 +140,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   get_cell(0, 0)
       #   # => { "symbol" => "H", "fg" => :red, "bg" => nil }
+      #--
+      # SPDX-SnippetEnd
+      #++
       def get_cell(x, y)
         RatatuiRuby.get_cell_at(x, y)
       end
@@ -120,10 +160,18 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   with_test_terminal do
       #     MyApp.new.render
       #     print_buffer  # see exactly what would display
       #   end
+      #--
+      # SPDX-SnippetEnd
+      #++
       def print_buffer
         puts _render_buffer_with_ansi
       end

data/lib/ratatui_ruby/test_helper/test_doubles.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
@@ -21,12 +21,20 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   frame = MockFrame.new
     #   area = StubRect.new(width: 60, height: 20)
     #   MyView.new.call(state, tui, frame, area)
     #
     #   widget = frame.rendered_widgets.first[:widget]
     #   assert_equal "Dashboard", widget.block.title
+    #--
+    # SPDX-SnippetEnd
+    #++
     module TestDoubles
       ##
       # Mock frame for view tests.
@@ -35,10 +43,18 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   frame = MockFrame.new
       #   View::Log.new.call(state, tui, frame, area)
       #   widget = frame.rendered_widgets.first[:widget]
       #   assert_equal "Event Log", widget.block.title
+      #--
+      # SPDX-SnippetEnd
+      #++
       MockFrame = Data.define(:rendered_widgets) do
         def initialize(rendered_widgets: [])
           super

data/lib/ratatui_ruby/test_helper.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
 #++
 
 require "fileutils"
@@ -33,6 +33,11 @@ module RatatuiRuby
   #
   # == Example
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   require "ratatui_ruby/test_helper"
   #
   #   class TestMyApp < Minitest::Test
@@ -83,6 +88,9 @@ module RatatuiRuby
   #       assert_equal "Dashboard", widget.block.title
   #     end
   #   end
+  #--
+  # SPDX-SnippetEnd
+  #++
   module TestHelper
     include Terminal
     include Snapshot

data/lib/ratatui_ruby/tui/buffer_factories.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/tui/canvas_factories.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/tui/core.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/tui/layout_factories.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
@@ -71,6 +71,36 @@ module RatatuiRuby
       def layout_split(area, direction: :vertical, constraints:, flex: :legacy)
         Layout::Layout.split(area, direction:, constraints:, flex:)
       end
+
+      # Alias for {#layout_split} — shorter, more ergonomic.
+      # @return [Array<Layout::Rect>]
+      def split(area, direction: :vertical, constraints:, flex: :legacy)
+        layout_split(area, direction:, constraints:, flex:)
+      end
+
+      # Alias for {#constraint_length} — CSS-inspired "fixed" sizing.
+      # @return [Layout::Constraint]
+      def fixed(n)
+        constraint_length(n)
+      end
+
+      # Alias for {#constraint_percentage} — CSS-inspired percent sizing.
+      # @return [Layout::Constraint]
+      def percent(n)
+        constraint_percentage(n)
+      end
+
+      # Alias for {#constraint_fill} — CSS Flexbox-inspired flexible sizing.
+      # @return [Layout::Constraint]
+      def flex(n = 1)
+        constraint_fill(n)
+      end
+
+      # Alias for {#constraint_fill} — CSS Grid-inspired "fr" (fraction) unit.
+      # @return [Layout::Constraint]
+      def fr(n = 1)
+        constraint_fill(n)
+      end
     end
   end
 end

data/lib/ratatui_ruby/tui/state_factories.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/tui/style_factories.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/tui/text_factories.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/tui/widget_factories.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/tui.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
 #++
 
 require_relative "tui/core"
@@ -49,6 +49,11 @@ module RatatuiRuby
   #
   # ==== Basic Usage (Recommended)
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   RatatuiRuby.run do |tui|
   #     loop do
   #       tui.draw \
@@ -58,12 +63,15 @@ module RatatuiRuby
   #             block: tui.block(
   #               title: "My Ruby TUI App",
   #               borders: [:all],
-  #               border_color: "cyan"
+  #               border_style: { fg: \"cyan\" }
   #             )
   #       event = tui.poll_event
   #       break if event == "q" || event == :ctrl_c
   #     end
   #   end
+  #--
+  # SPDX-SnippetEnd
+  #++
   class TUI
     include Core
     include LayoutFactories

data/lib/ratatui_ruby/version.rb

@@ -1,12 +1,12 @@
 # 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
   # The version of the ratatui_ruby gem.
   # See https://semver.org/spec/v2.0.0.html
-  VERSION = "0.7.4"
+  VERSION = "0.9.0"
 end

data/lib/ratatui_ruby/widgets/bar_chart/bar.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/bar_chart/bar_group.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