ratatui_ruby 0.8.0 → 0.9.1

data/ext/ratatui_ruby/src/widgets/list_state.rs

@@ -78,6 +78,35 @@ impl RubyListState {
         self.inner.borrow_mut().scroll_up_by(amount);
     }
 
+    /// Selects the next item or the first one if no item is selected.
+    ///
+    /// Note: until the list is rendered, the number of items is not known, so the index
+    /// is set to 0 and will be corrected when the list is rendered.
+    pub fn select_next(&self) {
+        self.inner.borrow_mut().select_next();
+    }
+
+    /// Selects the previous item or the last one if no item is selected.
+    ///
+    /// Note: until the list is rendered, the number of items is not known, so the index
+    /// is set to `usize::MAX` and will be corrected when the list is rendered.
+    pub fn select_previous(&self) {
+        self.inner.borrow_mut().select_previous();
+    }
+
+    /// Selects the first item.
+    pub fn select_first(&self) {
+        self.inner.borrow_mut().select_first();
+    }
+
+    /// Selects the last item.
+    ///
+    /// Note: until the list is rendered, the number of items is not known, so the index
+    /// is set to `usize::MAX` and will be corrected when the list is rendered.
+    pub fn select_last(&self) {
+        self.inner.borrow_mut().select_last();
+    }
+
     /// Borrows the inner `ListState` mutably for rendering.
     ///
     /// # Safety
@@ -98,6 +127,13 @@ pub fn register(ruby: &Ruby, module: magnus::RModule) -> Result<(), Error> {
     class.define_method("offset", method!(RubyListState::offset, 0))?;
     class.define_method("scroll_down_by", method!(RubyListState::scroll_down_by, 1))?;
     class.define_method("scroll_up_by", method!(RubyListState::scroll_up_by, 1))?;
+    class.define_method("select_next", method!(RubyListState::select_next, 0))?;
+    class.define_method(
+        "select_previous",
+        method!(RubyListState::select_previous, 0),
+    )?;
+    class.define_method("select_first", method!(RubyListState::select_first, 0))?;
+    class.define_method("select_last", method!(RubyListState::select_last, 0))?;
     Ok(())
 }
 

data/lib/ratatui_ruby/buffer/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
@@ -18,11 +18,19 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   cell = RatatuiRuby.get_cell_at(0, 0)
     #   cell.char   # => "H"
     #   cell.fg     # => :red
     #   cell.bold?  # => true
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Cell
       # The character displayed in the cell.
       #
@@ -45,8 +53,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   Buffer::Cell.empty # => #<RatatuiRuby::Buffer::Cell char=" ">
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       def self.empty
         new(symbol: " ", fg: nil, bg: nil, modifiers: [])
       end
@@ -55,8 +71,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   Buffer::Cell.default # => #<RatatuiRuby::Buffer::Cell char=" ">
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       def self.default
         empty
       end
@@ -67,8 +91,16 @@ module RatatuiRuby
       #
       # === Example
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   Buffer::Cell.symbol("X") # => #<RatatuiRuby::Buffer::Cell symbol="X">
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       def self.symbol(symbol)
         new(symbol:, fg: nil, bg: nil, modifiers: [])
       end

data/lib/ratatui_ruby/buffer.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/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,11 +17,19 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   cell = RatatuiRuby.get_cell_at(0, 0)
   #   cell.char   # => "H"
   #   cell.fg     # => :red
   #   cell.bold?  # => true
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   class Cell
     # The character displayed in the cell.
     #
@@ -44,8 +52,16 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Cell.empty # => #<RatatuiRuby::Cell char=" ">
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     def self.empty
       new(symbol: " ", fg: nil, bg: nil, modifiers: [])
     end
@@ -54,8 +70,16 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Cell.default # => #<RatatuiRuby::Cell char=" ">
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     def self.default
       empty
     end
@@ -66,8 +90,16 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Cell.symbol("X") # => #<RatatuiRuby::Cell symbol="X">
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     def self.symbol(symbol)
       new(symbol:, fg: nil, bg: nil, modifiers: [])
     end

data/lib/ratatui_ruby/event/focus_gained.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,24 +19,48 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   if event.focus_gained?
     #     puts "Focus gained"
     #   end
+    #--
+    # SPDX-SnippetEnd
+    #++
     class FocusGained < Event
       # Returns true for FocusGained events.
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2025 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   event.focus_gained? # => true
       #   event.key?          # => false
+      #--
+      # SPDX-SnippetEnd
+      #++
       def focus_gained?
         true
       end
 
       # Deconstructs the event for pattern matching.
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2025 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   case event
       #   in type: :focus_gained
       #     puts "Application gained focus"
       #   end
+      #--
+      # SPDX-SnippetEnd
+      #++
       def deconstruct_keys(keys)
         { type: :focus_gained }
       end

data/lib/ratatui_ruby/event/focus_lost.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,24 +20,48 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   if event.focus_lost?
     #     puts "Focus lost"
     #   end
+    #--
+    # SPDX-SnippetEnd
+    #++
     class FocusLost < Event
       # Returns true for FocusLost events.
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2025 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   event.focus_lost? # => true
       #   event.key?        # => false
+      #--
+      # SPDX-SnippetEnd
+      #++
       def focus_lost?
         true
       end
 
       # Deconstructs the event for pattern matching.
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2025 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   case event
       #   in type: :focus_lost
       #     puts "Application lost focus"
       #   end
+      #--
+      # SPDX-SnippetEnd
+      #++
       def deconstruct_keys(keys)
         { type: :focus_lost }
       end

data/lib/ratatui_ruby/event/key/character.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
@@ -12,9 +12,17 @@ module RatatuiRuby
       module Character
         # Returns true if the key represents a single printable character.
         #
+        #--
+        # SPDX-SnippetBegin
+        # SPDX-FileCopyrightText: 2026 Kerrick Long
+        # SPDX-License-Identifier: MIT-0
+        #++
         #   RatatuiRuby::Event::Key.new(code: "a").text?       # => true
         #   RatatuiRuby::Event::Key.new(code: "enter").text?   # => false
         #   RatatuiRuby::Event::Key.new(code: "space").text?   # => false ("space" is not 1 char, " " is)
+        #--
+        # SPDX-SnippetEnd
+        #++
         def text?
           @code.length == 1
         end
@@ -24,10 +32,18 @@ module RatatuiRuby
         # [Printable Characters]
         #   Returns the character itself (e.g., <tt>"a"</tt>, <tt>"1"</tt>, <tt>" "</tt>).
         # [Special Keys]
+        #--
+        # SPDX-SnippetBegin
+        # SPDX-FileCopyrightText: 2026 Kerrick Long
+        # SPDX-License-Identifier: MIT-0
+        #++
         #   Returns <tt>nil</tt> (e.g., <tt>"enter"</tt>, <tt>"up"</tt>, <tt>"f1"</tt>).
         #
         #   RatatuiRuby::Event::Key.new(code: "a").char      # => "a"
         #   RatatuiRuby::Event::Key.new(code: "enter").char  # => nil
+        #--
+        # SPDX-SnippetEnd
+        #++
         def char
           text? ? @code : nil
         end

data/lib/ratatui_ruby/event/key/media.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/event/key/modifier.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
@@ -66,9 +66,17 @@ module RatatuiRuby
         #
         # === Example
         #
+        #--
+        # SPDX-SnippetBegin
+        # SPDX-FileCopyrightText: 2026 Kerrick Long
+        # SPDX-License-Identifier: MIT-0
+        #++
         #   if event.modifier?
         #     # Handle solo modifier key press
         #   end
+        #--
+        # SPDX-SnippetEnd
+        #++
         def modifier?
           @kind == :modifier
         end

data/lib/ratatui_ruby/event/key/navigation.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/event/key/system.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/event/key.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 "key/character"
@@ -27,21 +27,45 @@ module RatatuiRuby
     # === Examples
     #
     # Using predicates:
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   if event.key? && event.ctrl? && event.code == "c"
     #     exit
     #   end
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # Using symbol comparison:
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   if event == :ctrl_c
     #     exit
     #   end
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # Using pattern matching:
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   case event
     #   in type: :key, code: "c", modifiers: ["ctrl"]
     #     exit
     #   end
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # === Terminal Compatibility
     #
     # Some key combinations never reach your application. Terminal emulators intercept them for
@@ -90,9 +114,17 @@ module RatatuiRuby
 
       # Returns true for Key events.
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2025 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   event.key?    # => true
       #   event.mouse?  # => false
       #   event.resize? # => false
+      #--
+      # SPDX-SnippetEnd
+      #++
       def key?
         true
       end
@@ -104,8 +136,16 @@ module RatatuiRuby
       # [modifiers]
       #   List of modifiers (Array<String>).
       # [kind]
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   The key category (Symbol). One of: <tt>:standard</tt>, <tt>:function</tt>,
       #   <tt>:media</tt>, <tt>:modifier</tt>, <tt>:system</tt>. Defaults to <tt>:standard</tt>.
+      #--
+      # SPDX-SnippetEnd
+      #++
       def initialize(code:, modifiers: [], kind: :standard)
         @code = code.freeze
         @modifiers = modifiers.map(&:freeze).sort.freeze
@@ -141,8 +181,16 @@ module RatatuiRuby
       # [Standard]
       #   <tt>:enter</tt>, <tt>:backspace</tt>, <tt>:tab</tt>, <tt>:back_tab</tt>, <tt>:esc</tt>, <tt>:null</tt>
       # [Navigation]
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   <tt>:up</tt>, <tt>:down</tt>, <tt>:left</tt>, <tt>:right</tt>, <tt>:home</tt>, <tt>:end</tt>,
       #   <tt>:page_up</tt>, <tt>:page_down</tt>, <tt>:insert</tt>, <tt>:delete</tt>
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [Function Keys]
       #   <tt>:f1</tt> through <tt>:f12</tt> (and beyond, e.g. <tt>:f24</tt>)
       # [Lock Keys]
@@ -150,17 +198,41 @@ module RatatuiRuby
       # [System Keys]
       #   <tt>:print_screen</tt>, <tt>:pause</tt>, <tt>:menu</tt>, <tt>:keypad_begin</tt>
       # [Media Keys]
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   <tt>:play</tt>, <tt>:media_pause</tt>, <tt>:play_pause</tt>, <tt>:reverse</tt>, <tt>:stop</tt>,
       #   <tt>:fast_forward</tt>, <tt>:rewind</tt>, <tt>:track_next</tt>, <tt>:track_previous</tt>,
       #   <tt>:record</tt>, <tt>:lower_volume</tt>, <tt>:raise_volume</tt>, <tt>:mute_volume</tt>
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [Modifier Keys]
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   <tt>:left_shift</tt>, <tt>:left_control</tt>, <tt>:left_alt</tt>, <tt>:left_super</tt>,
       #   <tt>:left_hyper</tt>, <tt>:left_meta</tt>, <tt>:right_shift</tt>, <tt>:right_control</tt>,
       #   <tt>:right_alt</tt>, <tt>:right_super</tt>, <tt>:right_hyper</tt>, <tt>:right_meta</tt>,
       #   <tt>:iso_level3_shift</tt>, <tt>:iso_level5_shift</tt>
+      #--
+      # SPDX-SnippetEnd
+      #++
       # [Characters]
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2025 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   <tt>:a</tt>, <tt>:b</tt>, <tt>:1</tt>, <tt>:space</tt>, etc.
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # === Modifier Examples
       #
       # * <tt>:ctrl_c</tt>
@@ -183,8 +255,16 @@ module RatatuiRuby
       # [Special Keys]
       #   Returns an empty string (e.g., <tt>"enter"</tt>, <tt>"up"</tt>, <tt>"f1"</tt> all return <tt>""</tt>).
       # [Modifiers]
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2025 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   Returns the character if printable, ignoring modifiers unless they alter the character code itself.
       #   Note that <tt>ctrl+c</tt> typically returns <tt>"c"</tt> as the code, so +to_s+ will return <tt>"c"</tt>.
+      #--
+      # SPDX-SnippetEnd
+      #++
       def to_s
         if text?
           @code
@@ -202,11 +282,19 @@ module RatatuiRuby
       #
       # Allows convenient checking for specific keys or key combinations:
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2025 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   event.ctrl_c?     # => true if Ctrl+C
       #   event.enter?      # => true if Enter
       #   event.shift_up?   # => true if Shift+Up
       #   event.q?          # => true if "q"
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # The method name is converted to a symbol and compared against the event.
       # This works for any key code or modifier+key combination.
       #
@@ -214,18 +302,34 @@ module RatatuiRuby
       #
       # For convenience, generic predicates match both system and media variants:
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   event.pause?      # => true for BOTH system "pause" AND "media_pause"
       #   event.play?       # => true for "media_play"
       #   event.stop?       # => true for "media_stop"
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # This "Do What I Mean" behavior reduces boilerplate when you just want to
       # respond to a conceptual action (e.g., "pause the playback") regardless of
       # whether the user pressed a keyboard key or a media button.
       #
       # For strict matching, use the full predicate or compare the code directly:
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   event.media_pause?  # => true ONLY for media pause
       #   event.code == "pause"  # => true ONLY for system pause
+      #--
+      # SPDX-SnippetEnd
+      #++
       def method_missing(name, *args, &block)
         if name.to_s.end_with?("?")
           key_name = name.to_s[0...-1]
@@ -259,12 +363,20 @@ module RatatuiRuby
 
       # Deconstructs the event for pattern matching.
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   case event
       #   in type: :key, code: "c", modifiers: ["ctrl"]
       #     puts "Ctrl+C pressed"
       #   in type: :key, kind: :media
       #     puts "Media key pressed"
       #   end
+      #--
+      # SPDX-SnippetEnd
+      #++
       def deconstruct_keys(keys)
         { type: :key, code: @code, modifiers: @modifiers, kind: @kind }
       end