ratatui_ruby 0.8.0 → 0.9.0

data/lib/ratatui_ruby/schema/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
@@ -18,6 +18,11 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   Overlay.new(
   #     layers: [
   #       BackgroundMap.new,
@@ -25,6 +30,9 @@ module RatatuiRuby
   #       ModalDialog.new  # Draws over everything
   #     ]
   #   )
+  #--
+  # SPDX-SnippetEnd
+  #++
   class Overlay < Data.define(:layers)
     ##
     # :attr_reader: layers

data/lib/ratatui_ruby/schema/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
@@ -16,6 +16,11 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   # Basic Text
   #   Paragraph.new(text: "Hello, World!")
   #
@@ -29,6 +34,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/schema/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/schema/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/schema/rect.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,8 +18,16 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   area = Rect.new(x: 0, y: 0, width: 80, height: 24)
   #   puts area.width # => 80
+  #--
+  # SPDX-SnippetEnd
+  #++
   class Rect < Data.define(:x, :y, :width, :height)
     ##
     # :attr_reader: x
@@ -58,15 +66,31 @@ module RatatuiRuby
     #
     # Essential for hit testing mouse clicks against layout regions.
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   area = Rect.new(x: 10, y: 5, width: 20, height: 10)
     #   area.contains?(15, 8) # => true
     #   area.contains?(5, 8)  # => false
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # [px]
     #   X coordinate to test (column).
     # [py]
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Y coordinate to test (row).
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # Returns true if the point (px, py) is within the rectangle bounds.
     def contains?(px, py)
       px >= x && px < x + width && py >= y && py < y + height
@@ -76,13 +100,29 @@ module RatatuiRuby
     #
     # Essential for determining if a widget is visible within a viewport or clipping area.
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   viewport = Rect.new(x: 0, y: 0, width: 80, height: 24)
     #   widget = Rect.new(x: 70, y: 20, width: 20, height: 10)
     #   viewport.intersects?(widget) # => true (partial overlap)
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # [other]
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Another Rect to test against.
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # Returns true if the rectangles overlap.
     def intersects?(other)
       x < other.x + other.width &&
@@ -95,14 +135,30 @@ module RatatuiRuby
     #
     # Essential for calculating visible portions of widgets inside scroll views.
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   viewport = Rect.new(x: 0, y: 0, width: 80, height: 24)
     #   widget = Rect.new(x: 70, y: 20, width: 20, height: 10)
     #   visible = viewport.intersection(widget)
     #   # => Rect(x: 70, y: 20, width: 10, height: 4)
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # [other]
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Another Rect to intersect with.
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # Returns a new Rect representing the intersection, or +nil+ if no overlap.
     def intersection(other)
       return nil unless intersects?(other)

data/lib/ratatui_ruby/schema/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
@@ -16,6 +16,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))
   #
@@ -27,6 +32,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/schema/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/schema/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
@@ -19,6 +19,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   # Simple label
     #   Shape::Label.new(x: 0, y: 0, text: "Origin")
     #
@@ -37,6 +42,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/schema/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
@@ -71,6 +71,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   bar_set: {
     #     empty: " ",
     #     one_eighth: " ",
@@ -90,6 +95,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/schema/style.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,12 +17,20 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   # Standard colors
   #   Style.new(fg: :red, bg: :white, modifiers: [:bold])
   #
   #   # Hex colors
   #   Style.new(fg: "#ff00ff")
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   # === Supported Colors
   #
   # ==== Integer
@@ -36,9 +44,17 @@ module RatatuiRuby
   # * <tt>:black</tt>, <tt>:red</tt>, <tt>:green</tt>, <tt>:yellow</tt>,
   #   <tt>:blue</tt>, <tt>:magenta</tt>, <tt>:cyan</tt>, <tt>:gray</tt>
   # * <tt>:dark_gray</tt>, <tt>:light_red</tt>, <tt>:light_green</tt>,
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   <tt>:light_yellow</tt>, <tt>:light_blue</tt>, <tt>:light_magenta</tt>,
   #   <tt>:light_cyan</tt>, <tt>:white</tt>
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   # ==== String
   # Represents a specific RGB color using a Hex code (<tt>"#RRGGBB"</tt>).
   # Requires a terminal emulator with "True Color" (24-bit color) support.

data/lib/ratatui_ruby/schema/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

data/lib/ratatui_ruby/schema/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/schema/text.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
@@ -31,6 +31,11 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   # Simple ASCII text
   #   RatatuiRuby::Text.width("Hello")        # => 5
   #
@@ -42,6 +47,9 @@ module RatatuiRuby
   #
   #   # Mixed content
   #   RatatuiRuby::Text.width("Hi 你好 👍")   # => 11 (2 + space + 4 + space + 2)
+  #--
+  # SPDX-SnippetEnd
+  #++
   module Text
     # A styled string fragment.
     #
@@ -90,12 +98,20 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Text::Line.new(
     #     spans: [
     #       Text::Span.styled("User: ", Style.new(modifiers: [:bold])),
     #       Text::Span.styled("kerrick", Style.new(fg: :blue))
     #     ]
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Line < Data.define(:spans, :alignment, :style)
       ##
       # :attr_reader: spans
@@ -136,12 +152,20 @@ module RatatuiRuby
       #
       # === Examples
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   line = Text::Line.new(spans: [
       #     Text::Span.new(content: "Hello "),
       #     Text::Span.new(content: "世界")
       #   ])
       #   line.width  # => 10 (6 ASCII + 4 CJK)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # Returns: Integer (number of terminal cells)
       def width
         RatatuiRuby::Text.width(spans.map { |s| s.content.to_s }.join)
@@ -162,6 +186,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   RatatuiRuby::Text.width("Hello")        # => 5 (5 ASCII chars × 1 cell)
     #
     #   RatatuiRuby::Text.width("你好")         # => 4 (2 CJK chars × 2 cells)
@@ -173,6 +202,9 @@ module RatatuiRuby
     #     width = tui.text_width("Hello 👍")
     #   end
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # [string] String to measure (String or object convertible to String)
     # Returns: Integer (number of terminal cells the string occupies)
     # Raises: TypeError if the argument is not a String

data/lib/ratatui_ruby/scrollbar_state.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
@@ -14,6 +14,11 @@ module RatatuiRuby
   #
   # == Example
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   @scrollbar_state = RatatuiRuby::ScrollbarState.new(100)
   #   @scrollbar_state.position = 25
   #
@@ -22,6 +27,9 @@ module RatatuiRuby
   #     frame.render_stateful_widget(scrollbar, frame.area, @scrollbar_state)
   #   end
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   class ScrollbarState
     ##
     # :method: new

data/lib/ratatui_ruby/style/style.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
+    #++
     #   # Standard colors
     #   Style::Style.new(fg: :red, bg: :white, modifiers: [:bold])
     #
     #   # Hex colors
     #   Style::Style.new(fg: "#ff00ff")
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # === Supported Colors
     #
     # ==== Integer
@@ -37,8 +45,16 @@ module RatatuiRuby
     # * <tt>:black</tt>, <tt>:red</tt>, <tt>:green</tt>, <tt>:yellow</tt>,
     #   <tt>:blue</tt>, <tt>:magenta</tt>, <tt>:cyan</tt>, <tt>:gray</tt>
     # * <tt>:dark_gray</tt>, <tt>:light_red</tt>, <tt>:light_green</tt>,
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   <tt>:light_yellow</tt>, <tt>:light_blue</tt>, <tt>:light_magenta</tt>,
     #   <tt>:light_cyan</tt>, <tt>:white</tt>
+    #--
+    # SPDX-SnippetEnd
+    #++
     # * <tt>:reset</tt> — Restores the terminal's default color.
     #
     # ==== String

data/lib/ratatui_ruby/style.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/table_state.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
@@ -15,6 +15,11 @@ module RatatuiRuby
   #
   # == Example
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   @table_state = RatatuiRuby::TableState.new
   #   @table_state.select(1)        # Select second row
   #   @table_state.select_column(0) # Select first column
@@ -24,6 +29,9 @@ module RatatuiRuby
   #     frame.render_stateful_widget(table, frame.area, @table_state)
   #   end
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   class TableState
     ##
     # :method: new

data/lib/ratatui_ruby/terminal_lifecycle.rb

@@ -1,9 +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
@@ -27,6 +26,11 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   def log(message)
     #     if RatatuiRuby.terminal_active?
     #       @deferred_logs << message
@@ -34,6 +38,9 @@ module RatatuiRuby
     #       puts message
     #     end
     #   end
+    #--
+    # SPDX-SnippetEnd
+    #++
     def terminal_active?
       @tui_session_active
     end
@@ -112,11 +119,19 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   RatatuiRuby.run(focus_events: false) do |tui|
     #     tui.draw(tui.paragraph(text: "Hi"))
     #     sleep 1
     #   end
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # @raise [Error::Invariant] if headless mode is enabled
     # @see headless!
     def run(focus_events: true, bracketed_paste: true)