ratatui_ruby 0.4.0 → 0.5.0

data/sig/examples/widget_box_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetBoxDemo
+  # @public
+  def self.new: () -> WidgetBoxDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_calendar_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetCalendarDemo
+  # @public
+  def self.new: () -> WidgetCalendarDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_cell_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetCellDemo
+  # @public
+  def self.new: () -> WidgetCellDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_chart_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetChartDemo
+  # @public
+  def self.new: () -> WidgetChartDemo
+
+  # @public
+  def run: () -> void
+end

data/{examples/gauge_demo → sig/examples/widget_gauge_demo}/app.rbs

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
 class SystemMonitorApp
   # @public
   def self.new: () -> SystemMonitorApp

data/sig/examples/widget_layout_split/app.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetLayoutSplit
+  # @public
+  def self.new: () -> WidgetLayoutSplit
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_line_gauge_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetLineGaugeDemo
+  # @public
+  def self.new: () -> WidgetLineGaugeDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_list_demo/app.rbs

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetListDemo
+  # @public
+  def self.new: () -> WidgetListDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_list_styles/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetListStyles
+  # @public
+  def self.new: () -> WidgetListStyles
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_popup_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetPopupDemo
+  # @public
+  def self.new: () -> WidgetPopupDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_ratatui_logo_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetRatatuiLogoDemo
+  # @public
+  def self.new: () -> WidgetRatatuiLogoDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_ratatui_mascot_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetRatatuiMascotDemo
+  # @public
+  def self.new: () -> WidgetRatatuiMascotDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_rect/app.rbs

@@ -0,0 +1,12 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetRect
+  MENU_ITEMS: Array[String]
+
+  # @public
+  def self.new: () -> WidgetRect
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_render/app.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetRender
+  # @public
+  def self.new: () -> WidgetRender
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_rich_text/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetRichText
+  # @public
+  def self.new: () -> WidgetRichText
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_scroll_text/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetScrollText
+  # @public
+  def self.new: () -> WidgetScrollText
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_scrollbar_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetScrollbarDemo
+  # @public
+  def self.new: () -> WidgetScrollbarDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_sparkline_demo/app.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetSparklineDemo
+  # @public
+  def self.new: () -> WidgetSparklineDemo
+
+  # @public
+  def run: () -> void
+end

data/{examples → sig/examples}/widget_style_colors/app.rbs

@@ -1,7 +1,7 @@
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-class ColorGradientDemo
+class WidgetStyleColors
   def initialize: () -> void
   def run: () -> void
 

data/sig/examples/widget_table_flex/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetTableFlex
+  # @public
+  def self.new: () -> WidgetTableFlex
+
+  # @public
+  def run: () -> void
+end

data/sig/ratatui_ruby/frame.rbs

@@ -0,0 +1,9 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class Frame
+    def area: () -> Rect
+    def render_widget: (widget widget, Rect area) -> nil
+  end
+end

data/sig/ratatui_ruby/ratatui_ruby.rbs

@@ -8,9 +8,10 @@ module RatatuiRuby
     def to_s: () -> String
   end
 
-  def self.init_terminal: () -> void
+  def self.init_terminal: (focus_events: bool, bracketed_paste: bool) -> void
   def self.restore_terminal: () -> void
-  def self.draw: (widget) -> void
+  def self.draw: (widget tree) -> void
+               | () { (Frame) -> void } -> void
   def self._poll_event: () -> Hash[Symbol, untyped]?
   def self.poll_event: () -> Event?
   def self.inject_test_event: (String, Hash[Symbol, untyped]) -> void

data/sig/ratatui_ruby/schema/draw.rbs

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
 module RatatuiRuby
   module Draw
     class StringCmd < Data

data/sig/ratatui_ruby/schema/layout.rbs

@@ -16,6 +16,6 @@ module RatatuiRuby
 
     private
 
-    def self._split: (Rect | Hash[Symbol, Integer], Symbol, Array[Constraint], Symbol) -> Array[Hash[Symbol, Integer]]
+    def self._split: (Rect, Symbol, Array[Constraint], Symbol) -> Array[Hash[Symbol, Integer]]
   end
 end

data/sig/ratatui_ruby/session.rbs

@@ -0,0 +1,94 @@
+# 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 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_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 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 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 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 tabs: (*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/tasks/autodoc/inventory.rb

@@ -0,0 +1,61 @@
+# 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:)
+
+          const.singleton_methods(false).sort.each do |class_method|
+            members << Member::Helper.new(
+              name: "#{snake_name}_#{class_method}",
+              class_method:,
+              const_name:
+            )
+          end
+        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