ratatui_ruby 0.5.0 → 0.6.0

data/sig/ratatui_ruby/event.rbs

@@ -11,11 +11,14 @@ module RatatuiRuby
     def focus_lost?: () -> bool
     def deconstruct_keys: (Array[Symbol]?) -> Hash[Symbol, untyped]
 
+    type key_kind = :standard | :function | :media | :modifier | :system
+
     class Key < Event
       attr_reader code: String
       attr_reader modifiers: Array[String]
+      attr_reader kind: key_kind
 
-      def initialize: (code: String, modifiers: Array[String]) -> void
+      def initialize: (code: String, ?modifiers: Array[String], ?kind: key_kind) -> void
       def ==: (untyped other) -> bool
       def to_sym: () -> Symbol
       def to_s: () -> String
@@ -24,6 +27,13 @@ module RatatuiRuby
       def alt?: () -> bool
       def shift?: () -> bool
       def text?: () -> bool
+      def char: () -> String
+      def media?: () -> bool
+      def system?: () -> bool
+      def function?: () -> bool
+      def modifier?: () -> bool
+      def standard?: () -> bool
+      def unmodified?: () -> bool
       def deconstruct_keys: (Array[Symbol]?) -> Hash[Symbol, untyped]
     end
 

data/sig/ratatui_ruby/frame.rbs

@@ -5,5 +5,7 @@ module RatatuiRuby
   class Frame
     def area: () -> Rect
     def render_widget: (widget widget, Rect area) -> nil
+    def render_stateful_widget: (widget widget, Rect area, (ListState | TableState | ScrollbarState) state) -> nil
+    def set_cursor_position: (Integer x, Integer y) -> nil
   end
 end

data/sig/ratatui_ruby/list_state.rbs

@@ -0,0 +1,13 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class ListState
+    def self.new: (?Integer? selected) -> ListState
+    def select: (Integer? index) -> nil
+    def selected: () -> Integer?
+    def offset: () -> Integer
+    def scroll_down_by: (Integer n) -> nil
+    def scroll_up_by: (Integer n) -> nil
+  end
+end

data/sig/ratatui_ruby/ratatui_ruby.rbs

@@ -12,7 +12,7 @@ module RatatuiRuby
   def self.restore_terminal: () -> void
   def self.draw: (widget tree) -> void
                | () { (Frame) -> void } -> void
-  def self._poll_event: () -> Hash[Symbol, untyped]?
-  def self.poll_event: () -> Event?
+  def self._poll_event: (Float?) -> Hash[Symbol, untyped]?
+  def self.poll_event: (?timeout: Float?) -> Event?
   def self.inject_test_event: (String, Hash[Symbol, untyped]) -> void
 end

data/sig/ratatui_ruby/schema/bar_chart/bar.rbs

@@ -5,12 +5,12 @@ module RatatuiRuby
   class BarChart
     class Bar < Data
       attr_reader value: Integer
-      attr_reader label: String?
+      attr_reader label: (String | Text::Span | Text::Line)?
       attr_reader style: Style?
       attr_reader value_style: Style?
-      attr_reader text_value: String?
+      attr_reader text_value: (String | Text::Span | Text::Line)?
 
-      def self.new: (value: Numeric, ?label: String?, ?style: Style?, ?value_style: Style?, ?text_value: String?) -> Bar
+      def self.new: (value: Numeric, ?label: String | Text::Span | Text::Line | nil, ?style: Style?, ?value_style: Style?, ?text_value: String | Text::Span | Text::Line | nil) -> Bar
     end
   end
 end

data/sig/ratatui_ruby/schema/gauge.rbs

@@ -4,12 +4,12 @@
 module RatatuiRuby
   class Gauge < Data
     attr_reader ratio: Float
-    attr_reader label: String?
+    attr_reader label: (String | Text::Span)?
     attr_reader style: Style?
     attr_reader gauge_style: Style?
     attr_reader block: Block?
 
     attr_reader use_unicode: bool
-    def self.new: (?ratio: Numeric?, ?percent: Numeric?, ?label: String?, ?style: Style?, ?gauge_style: Style?, ?block: Block?, ?use_unicode: bool) -> Gauge
+    def self.new: (?ratio: Numeric?, ?percent: Numeric?, ?label: String | Text::Span | nil, ?style: Style?, ?gauge_style: Style?, ?block: Block?, ?use_unicode: bool) -> Gauge
   end
 end

data/sig/ratatui_ruby/schema/line_gauge.rbs

@@ -4,13 +4,13 @@
 module RatatuiRuby
   class LineGauge < Data
     attr_reader ratio: Float
-    attr_reader label: String?
+    attr_reader label: (String | Text::Span)?
     attr_reader filled_style: Style?
     attr_reader unfilled_style: Style?
     attr_reader block: Block?
     attr_reader filled_symbol: String
     attr_reader unfilled_symbol: String
 
-    def self.new: (?ratio: Numeric, ?label: String?, ?style: Style?, ?filled_style: Style?, ?unfilled_style: Style?, ?block: Block?, ?filled_symbol: String, ?unfilled_symbol: String) -> LineGauge
+    def self.new: (?ratio: Numeric, ?label: String | Text::Span | nil, ?style: Style?, ?filled_style: Style?, ?unfilled_style: Style?, ?block: Block?, ?filled_symbol: String, ?unfilled_symbol: String) -> LineGauge
   end
 end

data/sig/ratatui_ruby/schema/list.rbs

@@ -3,8 +3,9 @@
 
 module RatatuiRuby
   class List < Data
-    attr_reader items: Array[String]
+    attr_reader items: Array[String | Text::Span | Text::Line | ListItem]
     attr_reader selected_index: Integer?
+    attr_reader offset: Integer?
     attr_reader style: Style?
     attr_reader highlight_style: Style?
     attr_reader highlight_symbol: String?
@@ -13,6 +14,7 @@ module RatatuiRuby
     attr_reader direction: Symbol
     attr_reader scroll_padding: Integer?
     attr_reader block: Block?
-    def self.new: (?items: Array[String], ?selected_index: Numeric?, ?style: Style?, ?highlight_style: Style?, ?highlight_symbol: String?, ?repeat_highlight_symbol: bool, ?highlight_spacing: Symbol, ?direction: Symbol, ?scroll_padding: Numeric?, ?block: Block?) -> List
+    def self.new: (?items: Array[String | Text::Span | Text::Line | ListItem], ?selected_index: Numeric?, ?offset: Numeric?, ?style: Style?, ?highlight_style: Style?, ?highlight_symbol: String?, ?repeat_highlight_symbol: bool, ?highlight_spacing: Symbol, ?direction: Symbol, ?scroll_padding: Numeric?, ?block: Block?) -> List
   end
 end
+

data/sig/ratatui_ruby/schema/list_item.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class ListItem < Data
+    attr_reader content: String | Text::Span | Text::Line
+    attr_reader style: Style?
+    def self.new: (content: String | Text::Span | Text::Line, ?style: Style?) -> ListItem
+  end
+end

data/sig/ratatui_ruby/schema/rect.rbs

@@ -11,5 +11,8 @@ module RatatuiRuby
     attr_reader height: Integer
     def self.new: (?x: Numeric, ?y: Numeric, ?width: Numeric, ?height: Numeric) -> instance
     def contains?: (Integer px, Integer py) -> bool
+    def intersects?: (Rect other) -> bool
+    def intersection: (Rect other) -> Rect?
   end
 end
+

data/sig/ratatui_ruby/schema/style.rbs

@@ -3,11 +3,11 @@
 
 module RatatuiRuby
   class Style < Data
-    attr_reader fg: (String | Symbol)?
-    attr_reader bg: (String | Symbol)?
+    attr_reader fg: (String | Symbol | Integer)?
+    attr_reader bg: (String | Symbol | Integer)?
     attr_reader modifiers: Array[Symbol]
 
-    def self.new: (?fg: (String | Symbol)?, ?bg: (String | Symbol)?, ?modifiers: Array[Symbol]) -> Style
+    def self.new: (?fg: (String | Symbol | Integer)?, ?bg: (String | Symbol | Integer)?, ?modifiers: Array[Symbol]) -> Style
     def self.default: () -> Style
   end
 end

data/sig/ratatui_ruby/schema/table.rbs

@@ -14,7 +14,9 @@ module RatatuiRuby
     attr_reader highlight_spacing: Symbol
     attr_reader column_highlight_style: Style?
     attr_reader selected_column: Integer?
+    attr_reader offset: Integer?
 
-    def self.new: (?header: Array[String | Paragraph]?, ?rows: Array[Array[String | Paragraph | Style | _ToS]], ?widths: Array[Constraint], ?highlight_style: Style?, ?highlight_symbol: String, ?highlight_spacing: Symbol, ?column_highlight_style: Style?, ?cell_highlight_style: Style?, ?selected_row: Numeric?, ?selected_column: Numeric?, ?block: Block?, ?footer: Array[String | Paragraph]?, ?flex: Symbol, ?style: (Style | Hash[Symbol, untyped])?, ?column_spacing: Numeric) -> Table
+    def self.new: (?header: Array[String | Paragraph]?, ?rows: Array[Array[String | Paragraph | Style | _ToS]], ?widths: Array[Constraint], ?highlight_style: Style?, ?highlight_symbol: String, ?highlight_spacing: Symbol, ?column_highlight_style: Style?, ?cell_highlight_style: Style?, ?selected_row: Numeric?, ?selected_column: Numeric?, ?offset: Numeric?, ?block: Block?, ?footer: Array[String | Paragraph]?, ?flex: Symbol, ?style: (Style | Hash[Symbol, untyped])?, ?column_spacing: Numeric) -> Table
   end
 end
+

data/sig/ratatui_ruby/schema/text.rbs

@@ -5,18 +5,20 @@ module RatatuiRuby
   module Text
     class Span < Data
       attr_reader content: String
-      attr_reader style: Style?
+      attr_reader style: Style | nil
 
-      def self.new: (content: String, ?style: Style?) -> Span
-      def self.styled: (String, ?Style?) -> Span
+      def initialize: (content: String, style: Style | nil) -> void
+      def self.styled: (String, Style | nil) -> Span
     end
 
     class Line < Data
       attr_reader spans: Array[Span]
-      attr_reader alignment: (:left | :center | :right)?
+      attr_reader alignment: Symbol | nil
 
-      def self.new: (?spans: Array[Span], ?alignment: (:left | :center | :right)?) -> Line
-      def self.from_string: (String, ?alignment: (:left | :center | :right)?) -> Line
+      def initialize: (spans: Array[Span], alignment: Symbol | nil) -> void
+      def self.from_string: (String, alignment: Symbol | nil) -> Line
     end
+
+    def self.width: (String) -> Integer
   end
 end

data/sig/ratatui_ruby/scrollbar_state.rbs

@@ -0,0 +1,18 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class ScrollbarState
+    def self.new: (Integer content_length) -> ScrollbarState
+    def position: () -> Integer
+    def position=: (Integer value) -> Integer
+    def content_length: () -> Integer
+    def content_length=: (Integer value) -> Integer
+    def viewport_content_length: () -> Integer
+    def viewport_content_length=: (Integer value) -> Integer
+    def first: () -> nil
+    def last: () -> nil
+    def next: () -> nil
+    def prev: () -> nil
+  end
+end

data/sig/ratatui_ruby/session.rbs

@@ -13,6 +13,7 @@ module RatatuiRuby
     def _paragraph_line_count: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def _paragraph_line_width: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def _tabs_width: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def _text_width: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def clear_events: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def draw: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def experimental_warnings: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
@@ -52,9 +53,13 @@ module RatatuiRuby
     def constraint_ratio: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def cursor: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def dataset: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def draw_cell: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def draw_string: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def draw_cell_cmd: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def draw_string_cmd: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def error: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def error_safety: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def error_terminal: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def event: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def event_focus_gained: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def event_focus_lost: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
@@ -70,6 +75,9 @@ module RatatuiRuby
     def line_chart: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def line_gauge: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def list: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def list_item: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def list_state: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def list_state_new: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def overlay: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def paragraph: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def paragraph_new: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
@@ -77,6 +85,8 @@ module RatatuiRuby
     def ratatui_mascot: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def rect: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def scrollbar: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def scrollbar_state: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def scrollbar_state_new: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def shape_circle: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def shape_label: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def shape_line: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
@@ -87,7 +97,10 @@ module RatatuiRuby
     def style: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def style_default: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def table: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def table_state: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def table_state_new: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def tabs: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def text_width: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def text_line: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def text_span: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
   end

data/sig/ratatui_ruby/table_state.rbs

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TableState
+    def self.new: (?Integer? selected) -> TableState
+    def select: (Integer? index) -> nil
+    def selected: () -> Integer?
+    def select_column: (Integer? index) -> nil
+    def selected_column: () -> Integer?
+    def offset: () -> Integer
+    def scroll_down_by: (Integer n) -> nil
+    def scroll_up_by: (Integer n) -> nil
+  end
+end

data/sig/ratatui_ruby/test_helper/event_injection.rbs

@@ -0,0 +1,16 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module EventInjection
+      def inject_event: (Event::Base event) -> void
+      def inject_mouse: (x: Integer, y: Integer, ?kind: Symbol, ?modifiers: Array[String], ?button: Symbol) -> void
+      def inject_click: (x: Integer, y: Integer, ?modifiers: Array[String]) -> void
+      def inject_right_click: (x: Integer, y: Integer, ?modifiers: Array[String]) -> void
+      def inject_drag: (x: Integer, y: Integer, ?modifiers: Array[String], ?button: Symbol) -> void
+      def inject_keys: (*(String | Symbol | (Hash[Symbol, untyped]) | Event::Key) args) -> void
+      alias inject_key inject_keys
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper/snapshot.rbs

@@ -0,0 +1,12 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module Snapshot
+      def assert_snapshot: (String name, ?String? msg) ?{ (Array[String]) -> Array[String] } -> void
+      def assert_screen_matches: (String | Array[String] expected, ?String? msg) ?{ (Array[String]) -> Array[String] } -> void
+      def assert_rich_snapshot: (String name, ?String? msg) ?{ (Array[String]) -> Array[String] } -> void
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper/style_assertions.rbs

@@ -0,0 +1,64 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module StyleAssertions
+      def assert_cell_style: (Integer x, Integer y, **untyped expected_attributes) -> void
+      def assert_color: (Symbol | Integer | String expected, x: Integer, y: Integer, ?layer: Symbol) -> void
+      def assert_area_style: (Rect | Hash[Symbol, Integer] area, **untyped attributes) -> void
+      def assert_fg_color: (Symbol | Integer | String expected, Integer x, Integer y) -> void
+      alias assert_fg assert_fg_color
+      def assert_bg_color: (Symbol | Integer | String expected, Integer x, Integer y) -> void
+      alias assert_bg assert_bg_color
+      def assert_bold: (Integer x, Integer y) -> void
+      def assert_italic: (Integer x, Integer y) -> void
+      def assert_underlined: (Integer x, Integer y) -> void
+      alias assert_underline assert_underlined
+      def assert_dim: (Integer x, Integer y) -> void
+      def assert_reversed: (Integer x, Integer y) -> void
+      alias assert_inverse assert_reversed
+      alias assert_inverse_video assert_reversed
+      def assert_crossed_out: (Integer x, Integer y) -> void
+      alias assert_strikethrough assert_crossed_out
+      alias assert_strike assert_crossed_out
+      def assert_hidden: (Integer x, Integer y) -> void
+      def assert_slow_blink: (Integer x, Integer y) -> void
+      alias assert_blink assert_slow_blink
+      def assert_rapid_blink: (Integer x, Integer y) -> void
+
+      def assert_black: (Integer x, Integer y) -> void
+      def assert_bg_black: (Integer x, Integer y) -> void
+      def assert_red: (Integer x, Integer y) -> void
+      def assert_bg_red: (Integer x, Integer y) -> void
+      def assert_green: (Integer x, Integer y) -> void
+      def assert_bg_green: (Integer x, Integer y) -> void
+      def assert_yellow: (Integer x, Integer y) -> void
+      def assert_bg_yellow: (Integer x, Integer y) -> void
+      def assert_blue: (Integer x, Integer y) -> void
+      def assert_bg_blue: (Integer x, Integer y) -> void
+      def assert_magenta: (Integer x, Integer y) -> void
+      def assert_bg_magenta: (Integer x, Integer y) -> void
+      def assert_cyan: (Integer x, Integer y) -> void
+      def assert_bg_cyan: (Integer x, Integer y) -> void
+      def assert_gray: (Integer x, Integer y) -> void
+      def assert_bg_gray: (Integer x, Integer y) -> void
+      def assert_dark_gray: (Integer x, Integer y) -> void
+      def assert_bg_dark_gray: (Integer x, Integer y) -> void
+      def assert_light_red: (Integer x, Integer y) -> void
+      def assert_bg_light_red: (Integer x, Integer y) -> void
+      def assert_light_green: (Integer x, Integer y) -> void
+      def assert_bg_light_green: (Integer x, Integer y) -> void
+      def assert_light_yellow: (Integer x, Integer y) -> void
+      def assert_bg_light_yellow: (Integer x, Integer y) -> void
+      def assert_light_blue: (Integer x, Integer y) -> void
+      def assert_bg_light_blue: (Integer x, Integer y) -> void
+      def assert_light_magenta: (Integer x, Integer y) -> void
+      def assert_bg_light_magenta: (Integer x, Integer y) -> void
+      def assert_light_cyan: (Integer x, Integer y) -> void
+      def assert_bg_light_cyan: (Integer x, Integer y) -> void
+      def assert_white: (Integer x, Integer y) -> void
+      def assert_bg_white: (Integer x, Integer y) -> void
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper/terminal.rbs

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module Terminal
+      def with_test_terminal: (?Integer width, ?Integer height, ?timeout: Integer?) ?{ () -> void } -> void
+      def buffer_content: () -> Array[String]
+      def cursor_position: () -> { x: Integer, y: Integer }
+      def get_cell: (Integer x, Integer y) -> Cell
+      def print_buffer: () -> void
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper/test_doubles.rbs

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module TestDoubles
+      class MockFrame < Data
+        attr_accessor rendered_widgets: Array[{ widget: untyped, area: Rect }]
+        def self.new: (?rendered_widgets: Array[{ widget: untyped, area: Rect }]) -> MockFrame
+        def render_widget: (untyped widget, Rect area) -> void
+      end
+
+      class StubRect < Data
+        attr_accessor x: Integer
+        attr_accessor y: Integer
+        attr_accessor width: Integer
+        attr_accessor height: Integer
+        def self.new: (?x: Integer, ?y: Integer, ?width: Integer, ?height: Integer) -> StubRect
+      end
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper.rbs

@@ -3,9 +3,10 @@
 
 module RatatuiRuby
   module TestHelper
-    def with_test_terminal: (?Integer width, ?Integer height) { () -> void } -> void
-    def buffer_content: () -> Array[String]
-    def cursor_position: () -> { x: Integer, y: Integer }
-    def inject_event: (String event_type, Hash[Symbol, untyped] data) -> void
+    include Terminal
+    include Snapshot
+    include EventInjection
+    include StyleAssertions
+    include TestDoubles
   end
 end

data/tasks/autodoc/examples.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module Autodoc
+  class Examples
+    def self.sync
+      new.sync
+    end
+
+    def sync
+      Dir.glob("{README.md,doc/*.md,examples/*/README.md}").each do |readme_path|
+        sync_readme(readme_path)
+      end
+    end
+
+    private def sync_readme(readme_path)
+      content = File.read(readme_path)
+      dir = File.dirname(readme_path)
+
+      new_content = content.gsub(/<!-- SYNC:START:([^ ]+) -->.*?<!-- SYNC:END -->/m) do
+        marker_info = $1
+        source_rel_path, segment_id = marker_info.split(":")
+        source_path = File.join(dir, source_rel_path)
+
+        unless File.exist?(source_path)
+          warn "Warning: Source file not found: #{source_path}"
+          next $&
+        end
+
+        source_content = File.read(source_path)
+        extracted_content = if segment_id
+          extract_segment(source_content, segment_id, source_path)
+        else
+          source_content
+        end
+
+        # Detect language from extension
+        ext = File.extname(source_path).delete(".")
+        lang = (ext == "rb") ? "ruby" : ext
+
+        # Build replacement
+        "<!-- SYNC:START:#{marker_info} -->\n```#{lang}\n#{extracted_content}```\n<!-- SYNC:END -->"
+      end
+
+      if new_content != content
+        puts "Syncing #{readme_path}..."
+        File.write(readme_path, new_content)
+      end
+    end
+
+    def extract_segment(content, segment_id, source_path)
+      start_marker = /#\s*\[SYNC:START:#{segment_id}\]/
+      end_marker = /#\s*\[SYNC:END:#{segment_id}\]/
+
+      lines = content.lines
+      start_idx = lines.find_index { |l| l =~ start_marker }
+      end_idx = lines.find_index { |l| l =~ end_marker }
+
+      if start_idx && end_idx
+        "#{unindent(lines[(start_idx + 1)...end_idx].join).strip}\n"
+      else
+        warn "Warning: Segment '#{segment_id}' not found in #{source_path}"
+        content # Fallback to full content or error? Let's fallback to original for now.
+      end
+    end
+
+    def unindent(text)
+      lines = text.lines
+      # Don't unindent if empty or just one line
+      return text if lines.empty?
+
+      # Find common leading whitespace
+      indentation = lines.grep(/\S/).map { |l| l[/^\s*/].length }.min || 0
+      lines.map { |l| (l.length > indentation) ? l[indentation..-1] : "#{l.strip}\n" }.join
+    end
+  end
+end

data/tasks/autodoc/inventory.rb

@@ -32,14 +32,16 @@ module Autodoc
         if const.is_a?(Class)
           snake_name = Name.new(const_name).snake
           members << Member::Factory.new(name: snake_name, const_name:)
+        end
 
-          const.singleton_methods(false).sort.each do |class_method|
-            members << Member::Helper.new(
-              name: "#{snake_name}_#{class_method}",
-              class_method:,
-              const_name:
-            )
-          end
+        # Singleton methods (for both Classes and Modules)
+        parent_prefix = Name.new(const_name).snake
+        const.singleton_methods(false).sort.each do |class_method|
+          members << Member::Helper.new(
+            name: "#{parent_prefix}_#{class_method}",
+            class_method:,
+            const_name:
+          )
         end
 
         const.constants.sort.each do |child_name|

data/tasks/autodoc.rake

@@ -7,15 +7,16 @@ require_relative "autodoc/inventory"
 require_relative "autodoc/notice"
 require_relative "autodoc/rbs"
 require_relative "autodoc/rdoc"
+require_relative "autodoc/examples"
 
 namespace :autodoc do
-  desc "Generate all autodoc findings"
-  task all: [:rbs, :rdoc]
+  desc "Update all automatically generated documentation"
+  task all: [:rbs, :rdoc, :examples]
 
-  desc "Generate all RBS findings"
+  desc "Update all automatically generated RBS signatures"
   task rbs: ["rbs:session"]
 
-  desc "Generate all RDoc findings"
+  desc "Update all automatically generated RDoc files"
   task rdoc: ["rdoc:session"]
 
   namespace :rbs do
@@ -41,7 +42,12 @@ namespace :autodoc do
       ).write(Autodoc::Inventory.new)
     end
   end
+
+  desc "Sync code snippets in example READMEs with source files"
+  task :examples do
+    Autodoc::Examples.sync
+  end
 end
 
-desc "Generate all autodoc findings"
+desc "Update all automatically generated documentation"
 task autodoc: "autodoc:all"

data/tasks/bump/changelog.rb

@@ -3,7 +3,7 @@
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-require_relative "comparison_links"
+require_relative "links"
 require_relative "unreleased_section"
 require_relative "history"
 require_relative "header"
@@ -22,13 +22,13 @@ class Changelog
 
     header = Header.parse(content)
     unreleased = UnreleasedSection.parse(content)
-    links = ComparisonLinks.parse(content)
+    links = Links.from_markdown(content)
 
     raise "Could not parse CHANGELOG.md" unless header && unreleased && links
 
     history = History.parse(content, header.length, unreleased.to_s.length, links.to_s)
 
-    links.update(new_version)
+    links.release(new_version)
     history.add(unreleased.as_version(new_version))
 
     File.write(@path, "#{header}#{UnreleasedSection.fresh}\n\n#{history}\n#{links}")