ratatui_ruby 0.8.0 → 0.9.1

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/synthetic_events.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  ##
+  # Ruby-only event queue for synthetic events.
+  #
+  # Native events flow through the Rust backend. Synthetic events bypass it.
+  # Runtimes (Tea, Kit) check this queue and handle events like
+  # <tt>Event::Sync</tt> specially.
+  #
+  # *For runtime authors:* Check <tt>pending?</tt> each loop iteration after
+  # polling native events. When true, pop the event and handle it. For
+  # <tt>Event::Sync</tt>, wait for pending threads and process background
+  # results before continuing.
+  #
+  # *For app developers:* Push <tt>Event::Sync</tt> when you need async
+  # results before continuing. The runtime will block until all pending
+  # work completes. Use this for "ensure saves complete before quit."
+  #
+  # *For test authors:* Use <tt>inject_sync</tt> between events to create
+  # synchronization points. This enables deterministic testing of async
+  # behavior.
+  #
+  # === Example
+  #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
+  #   # Production: ensure async saves finish before exiting
+  #   RatatuiRuby::SyntheticEvents.push(RatatuiRuby::Event::Sync.new)
+  #
+  #   # Runtime authors: check in your event loop
+  #   if RatatuiRuby::SyntheticEvents.pending?
+  #     event = RatatuiRuby::SyntheticEvents.pop
+  #     handle_sync if event.sync?
+  #   end
+  #
+  #--
+  # SPDX-SnippetEnd
+  #++
+  module SyntheticEvents
+    @queue = []
+    @mutex = Mutex.new
+
+    class << self
+      ##
+      # Pushes an event to the synthetic queue.
+      #
+      # [event] An <tt>Event</tt> object (typically <tt>Event::Sync</tt>).
+      def push(event)
+        @mutex.synchronize { @queue << event }
+      end
+
+      ##
+      # Pops an event from the synthetic queue.
+      #
+      # Returns the oldest pending event, or <tt>nil</tt> if empty.
+      def pop
+        @mutex.synchronize { @queue.shift }
+      end
+
+      ##
+      # Clears all pending synthetic events.
+      #
+      # Test helpers call this during teardown to reset state between tests.
+      def clear
+        @mutex.synchronize { @queue.clear }
+      end
+
+      ##
+      # Checks for pending synthetic events.
+      #
+      # Returns <tt>true</tt> if the queue has events waiting.
+      def pending?
+        @mutex.synchronize { !@queue.empty? }
+      end
+    end
+  end
+end