ratatui_ruby 0.8.0 → 0.9.0

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.8.0"
+  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

data/lib/ratatui_ruby/widgets/bar_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
@@ -21,6 +21,11 @@ module RatatuiRuby
     #
     # Run the interactive demo from the terminal:
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   ruby examples/widget_barchart/app.rb
     #
     #   # Grouped Bar Chart
@@ -32,6 +37,9 @@ module RatatuiRuby
     #     bar_width: 5,
     #     group_gap: 3
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class BarChart < Data.define(:data, :bar_width, :bar_gap, :group_gap, :max, :style, :block, :direction, :label_style, :value_style, :bar_set)
       ##
       ##
@@ -46,23 +54,55 @@ module RatatuiRuby
       # [<tt>Array</tt> of tuples]
       #   Ordered list of <tt>["Label", Value]</tt> or <tt>["Label", Value, Style]</tt> pairs.
       # [<tt>Array</tt> of <tt>BarChart::BarGroup</tt>]
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   List of <tt>BarChart::BarGroup</tt> objects for grouped charts.
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # === Examples
       #
       # Hash (Simple):
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   { "Apples" => 10, :Oranges => 15 }
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # Array of Tuples (Ordered):
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   [["Mon", 20], ["Tue", 30], ["Wed", 25]]
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # BarGroup (Grouped):
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   [
       #     RatatuiRuby::BarChart::BarGroup.new(label: "Q1", bars: [
       #       RatatuiRuby::BarChart::Bar.new(value: 50, label: "Rev"),
       #       RatatuiRuby::BarChart::Bar.new(value: 30, label: "Cost")
       #     ])
       #   ]
+      #--
+      # SPDX-SnippetEnd
+      #++
 
       ##
       # :attr_reader: bar_width
@@ -111,6 +151,11 @@ module RatatuiRuby
       #
       # === Examples
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   bar_set: {
       #     empty: " ",
       #     one_eighth: " ",
@@ -130,6 +175,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
 
@@ -156,8 +204,16 @@ module RatatuiRuby
       # [value_style]
       #   Style object for values (optional).
       # [bar_set]
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   Symbol, Hash, or Array: Custom characters for bars.
       #   Symbols: <tt>:nine_levels</tt> (default gradient), <tt>:three_levels</tt> (simplified).
+      #--
+      # SPDX-SnippetEnd
+      #++
       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 && !bar_set.is_a?(Symbol)
           if bar_set.is_a?(Array) && bar_set.size == 9

data/lib/ratatui_ruby/widgets/block.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
@@ -22,7 +22,7 @@ module RatatuiRuby
     # Run the interactive demo from the terminal:
     #
     #   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)
+    class Block < Data.define(:title, :titles, :title_alignment, :title_style, :borders, :border_style, :border_type, :border_set, :style, :padding, :children)
       ##
       # :attr_reader: title
       # The main title displayed on the top border.
@@ -69,19 +69,12 @@ module RatatuiRuby
       #
       #   Block.new(borders: [:left, :right]).borders # => [:left, :right]
 
-      ##
-      # :attr_reader: border_color
-      # Color of the border lines.
-      #
-      # Deprecated: Use <tt>border_style:</tt> instead for full style support.
-
       ##
       # :attr_reader: border_style
       # Full style (colors/modifiers) for the border lines.
       #
       # A Style object or Hash with <tt>:fg</tt>, <tt>:bg</tt>, and <tt>:modifiers</tt>.
-      # This allows borders to be bold, italic, colored, etc. If both <tt>border_color</tt>
-      # and <tt>border_style</tt> are provided, <tt>border_style</tt> takes precedence.
+      # This allows borders to be bold, italic, colored, etc.
 
       ##
       # :attr_reader: border_type
@@ -116,8 +109,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   Block.new(padding: 2).padding # => 2
       #   Block.new(padding: [1, 1, 0, 0]).padding # => [1, 1, 0, 0]
+      #--
+      # SPDX-SnippetEnd
+      #++
 
       ##
       # :attr_reader: children
@@ -127,11 +128,19 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   Block.new(
       #     title: "Content",
       #     borders: [:all],
       #     children: [Paragraph.new(text: "Hello")]
       #   )
+      #--
+      # SPDX-SnippetEnd
+      #++
 
       # Creates a new Block.
       #
@@ -145,8 +154,6 @@ module RatatuiRuby
       #   Base style for all titles (optional).
       # [borders]
       #   Array of borders to show: <tt>:top</tt>, <tt>:bottom</tt>, <tt>:left</tt>, <tt>:right</tt>, or <tt>:all</tt> (default).
-      # [border_color]
-      #   Color string or symbol (e.g., <tt>:red</tt>). Deprecated: use <tt>border_style</tt> instead.
       # [border_style]
       #   Style object or Hash for the border lines.
       # [border_type]
@@ -159,7 +166,7 @@ module RatatuiRuby
       #   Integer (uniform) or Array[4] (left, right, top, bottom).
       # [children]
       #   Array of widgets to render inside the block (optional).
-      def initialize(title: nil, titles: [], title_alignment: nil, title_style: nil, borders: [:all], border_color: nil, border_style: nil, border_type: nil, border_set: nil, style: nil, padding: 0, children: [])
+      def initialize(title: nil, titles: [], title_alignment: nil, title_style: nil, borders: [:all], border_style: nil, border_type: nil, border_set: nil, style: nil, padding: 0, children: [])
         if border_set
           border_set = border_set.dup
           %i[top_left top_right bottom_left bottom_right vertical_left vertical_right horizontal_top horizontal_bottom].each do |long_key|
@@ -180,7 +187,6 @@ module RatatuiRuby
           title_alignment:,
           title_style:,
           borders:,
-          border_color:,
           border_style:,
           border_type:,
           border_set:,
@@ -198,14 +204,30 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   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)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [area]
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   The outer Rect to compute the inner area for.
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # Returns a new Rect representing the inner content area.
       def inner(area)
         # Calculate border offsets

data/lib/ratatui_ruby/widgets/calendar.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/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]