ratatui_ruby 0.4.0 → 0.6.0

data/sig/ratatui_ruby/session.rbs

@@ -0,0 +1,107 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+# !!! DO NOT EDIT THIS FILE BY HAND !!!
+# This file is automatically generated by `rake autodoc:rbs:session`.
+# Any changes will be overwritten.
+
+module RatatuiRuby
+  class Session
+    def self.new: () -> Session
+                | () { (Session) -> void } -> void
+
+    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
+    def experimental_warnings=: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def get_buffer_content: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def get_cell_at: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def get_cursor_position: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def init_terminal: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def init_test_terminal: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def inject_test_event: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def poll_event: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def resize_terminal: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def restore_terminal: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def run: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def warn_experimental_feature: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def axis: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def bar_chart: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def bar_chart_bar: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def bar_chart_bar_group: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def block: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def calendar: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def canvas: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def cell: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def cell_char: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def cell_default: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def cell_empty: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def cell_symbol: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def center: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def chart: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def clear: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def constraint: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def constraint_fill: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def constraint_length: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def constraint_max: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def constraint_min: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def constraint_percentage: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    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
+    def event_key: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def event_mouse: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def event_none: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def event_paste: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def event_resize: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def frame: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def gauge: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def layout: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def layout_split: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    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
+    def ratatui_logo: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    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
+    def shape_map: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def shape_point: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def shape_rectangle: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def sparkline: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    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
+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

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require_relative "name"
+require_relative "member"
+
+module Autodoc
+  class Inventory
+    include Enumerable
+
+    def each(&)
+      delegates.each(&)
+      factories.each(&)
+    end
+
+    def delegates
+      RatatuiRuby.singleton_methods(false).sort.map do |method_name|
+        Member::Delegate.new(name: method_name)
+      end
+    end
+
+    def factories
+      members = []
+      RatatuiRuby.constants.sort.each do |const_name|
+        next if const_name == :Buffer
+
+        const = RatatuiRuby.const_get(const_name)
+        next unless const.is_a?(Module)
+
+        if const.is_a?(Class)
+          snake_name = Name.new(const_name).snake
+          members << Member::Factory.new(name: snake_name, 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|
+          child = const.const_get(child_name)
+          next unless child.is_a?(Class)
+
+          parent_prefix = Name.new(const_name).snake
+          child_suffix = Name.new(child_name).snake
+
+          members << Member::Factory.new(
+            name: "#{parent_prefix}_#{child_suffix}",
+            const_name: "#{const_name}::#{child_name}"
+          )
+        end
+      end
+      members
+    end
+  end
+end

data/tasks/autodoc/member.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module Autodoc
+  module Member
+    class Delegate < Data.define(:name)
+      def rbs
+        "    def #{name}: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped"
+      end
+
+      def rdoc
+        [
+          "    # :method: #{name}",
+          "    # :call-seq: #{name}(*args, **kwargs, &block)",
+          "    #",
+          "    # Delegates to RatatuiRuby.#{name}.",
+          "    #",
+        ]
+      end
+    end
+
+    class Factory < Data.define(:name, :const_name)
+      def rbs
+        "    def #{name}: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped"
+      end
+
+      def rdoc
+        [
+          "    # :method: #{name}",
+          "    # :call-seq: #{name}(*args, **kwargs, &block)",
+          "    #",
+          "    # Factory for RatatuiRuby::#{const_name}.new.",
+          "    #",
+        ]
+      end
+    end
+
+    class Helper < Data.define(:name, :class_method, :const_name)
+      def rbs
+        "    def #{name}: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped"
+      end
+
+      def rdoc
+        [
+          "    # :method: #{name}",
+          "    # :call-seq: #{name}(*args, **kwargs, &block)",
+          "    #",
+          "    # Helper for RatatuiRuby::#{const_name}.#{class_method}.",
+          "    #",
+        ]
+      end
+    end
+  end
+end

data/tasks/autodoc/name.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module Autodoc
+  class Name < Data.define(:string)
+    def snake
+      string.to_s
+        .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+        .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+        .downcase
+    end
+
+    def to_s
+      string.to_s
+    end
+  end
+end

data/tasks/autodoc/notice.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module Autodoc
+  class Notice < Data.define(:task_name)
+    def rbs
+      [
+        "# !!! DO NOT EDIT THIS FILE BY HAND !!!",
+        "# This file is automatically generated by `rake #{task_name}`.",
+        "# Any changes will be overwritten.",
+        "",
+      ]
+    end
+
+    def rdoc
+      [
+        "# !!! DO NOT EDIT THIS FILE BY HAND !!!",
+        "# This file is automatically generated by `rake #{task_name}`.",
+        "# Any changes will be overwritten.",
+        "",
+      ]
+    end
+  end
+end

data/tasks/autodoc/rbs.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module Autodoc
+  class Rbs < Data.define(:path, :notice)
+    def write(inventory)
+      FileUtils.mkdir_p(File.dirname(path))
+
+      # REUSE-IgnoreStart
+      lines = [
+        "# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>",
+        "# SPDX-License-Identifier: AGPL-3.0-or-later",
+        "",
+      ]
+      # REUSE-IgnoreEnd
+      lines += notice.rbs
+      lines += [
+        "module RatatuiRuby",
+        "  class Session",
+        "    def self.new: () -> Session",
+        "                | () { (Session) -> void } -> void",
+        "",
+      ]
+
+      inventory.each do |member|
+        lines << member.rbs
+      end
+
+      lines << "  end"
+      lines << "end"
+
+      File.write(path, "#{lines.join("\n")}\n")
+      puts "Generated #{path}"
+    end
+  end
+end

data/tasks/autodoc/rdoc.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module Autodoc
+  class Rdoc < Data.define(:path, :notice)
+    def write(inventory)
+      FileUtils.mkdir_p(File.dirname(path))
+
+      # REUSE-IgnoreStart
+      lines = [
+        "# frozen_string_literal: true",
+        "",
+        "# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>",
+        "# SPDX-License-Identifier: AGPL-3.0-or-later",
+        "",
+      ]
+      # REUSE-IgnoreEnd
+      lines += notice.rdoc
+      lines += [
+        "module RatatuiRuby",
+        "  class Session",
+      ]
+
+      lines << "    # == RatatuiRuby Delegates"
+      lines << "    #"
+      inventory.delegates.each do |member|
+        lines += member.rdoc
+      end
+
+      lines << "    # == Widget Factories"
+      lines << "    #"
+      inventory.factories.each do |member|
+        lines += member.rdoc
+      end
+
+      lines << "  end"
+      lines << "end"
+
+      File.write(path, "#{lines.join("\n")}\n")
+      puts "Generated #{path}"
+    end
+  end
+end

data/tasks/autodoc.rake

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require_relative "autodoc/inventory"
+require_relative "autodoc/notice"
+require_relative "autodoc/rbs"
+require_relative "autodoc/rdoc"
+require_relative "autodoc/examples"
+
+namespace :autodoc do
+  desc "Update all automatically generated documentation"
+  task all: [:rbs, :rdoc, :examples]
+
+  desc "Update all automatically generated RBS signatures"
+  task rbs: ["rbs:session"]
+
+  desc "Update all automatically generated RDoc files"
+  task rdoc: ["rdoc:session"]
+
+  namespace :rbs do
+    desc "Generate RBS for RatatuiRuby::Session"
+    task :session do
+      require_relative "../lib/ratatui_ruby"
+
+      Autodoc::Rbs.new(
+        path: File.expand_path("../sig/ratatui_ruby/session.rbs", __dir__),
+        notice: Autodoc::Notice.new("autodoc:rbs:session")
+      ).write(Autodoc::Inventory.new)
+    end
+  end
+
+  namespace :rdoc do
+    desc "Generate RDoc autodoc for RatatuiRuby::Session"
+    task :session do
+      require_relative "../lib/ratatui_ruby"
+
+      Autodoc::Rdoc.new(
+        path: File.expand_path("../lib/ratatui_ruby/session/autodoc.rb", __dir__),
+        notice: Autodoc::Notice.new("autodoc:rdoc:session")
+      ).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 "Update all automatically generated documentation"
+task autodoc: "autodoc:all"