ratatui_ruby 1.4.0-x86_64-linux

data/sig/ratatui_ruby/symbols.rbs

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  module Symbols
+    module Shade
+      EMPTY: String
+      LIGHT: String
+      MEDIUM: String
+      DARK: String
+      FULL: String
+    end
+
+    # Type alias for line set hashes
+    type line_set = {
+      vertical: String,
+      horizontal: String,
+      top_right: String,
+      top_left: String,
+      bottom_right: String,
+      bottom_left: String,
+      vertical_left: String,
+      vertical_right: String,
+      horizontal_down: String,
+      horizontal_up: String,
+      cross: String
+    }
+
+    module Line
+      # Individual character constants
+      VERTICAL: String
+      DOUBLE_VERTICAL: String
+      THICK_VERTICAL: String
+      HORIZONTAL: String
+      DOUBLE_HORIZONTAL: String
+      THICK_HORIZONTAL: String
+      TOP_RIGHT: String
+      ROUNDED_TOP_RIGHT: String
+      DOUBLE_TOP_RIGHT: String
+      THICK_TOP_RIGHT: String
+      TOP_LEFT: String
+      ROUNDED_TOP_LEFT: String
+      DOUBLE_TOP_LEFT: String
+      THICK_TOP_LEFT: String
+      BOTTOM_RIGHT: String
+      ROUNDED_BOTTOM_RIGHT: String
+      DOUBLE_BOTTOM_RIGHT: String
+      THICK_BOTTOM_RIGHT: String
+      BOTTOM_LEFT: String
+      ROUNDED_BOTTOM_LEFT: String
+      DOUBLE_BOTTOM_LEFT: String
+      THICK_BOTTOM_LEFT: String
+      VERTICAL_LEFT: String
+      DOUBLE_VERTICAL_LEFT: String
+      THICK_VERTICAL_LEFT: String
+      VERTICAL_RIGHT: String
+      DOUBLE_VERTICAL_RIGHT: String
+      THICK_VERTICAL_RIGHT: String
+      HORIZONTAL_DOWN: String
+      DOUBLE_HORIZONTAL_DOWN: String
+      THICK_HORIZONTAL_DOWN: String
+      HORIZONTAL_UP: String
+      DOUBLE_HORIZONTAL_UP: String
+      THICK_HORIZONTAL_UP: String
+      CROSS: String
+      DOUBLE_CROSS: String
+      THICK_CROSS: String
+
+      # Predefined sets
+      NORMAL: line_set
+      ROUNDED: line_set
+      DOUBLE: line_set
+      THICK: line_set
+    end
+
+    # Type alias for bar set hashes
+    type bar_set = {
+      full: String,
+      seven_eighths: String,
+      three_quarters: String,
+      five_eighths: String,
+      half: String,
+      three_eighths: String,
+      one_quarter: String,
+      one_eighth: String,
+      empty: String
+    }
+
+    module Bar
+      # Individual character constants
+      FULL: String
+      SEVEN_EIGHTHS: String
+      THREE_QUARTERS: String
+      FIVE_EIGHTHS: String
+      HALF: String
+      THREE_EIGHTHS: String
+      ONE_QUARTER: String
+      ONE_EIGHTH: String
+
+      # Predefined sets
+      NINE_LEVELS: bar_set
+      THREE_LEVELS: bar_set
+    end
+
+    module Block
+      # Individual character constants
+      FULL: String
+      SEVEN_EIGHTHS: String
+      THREE_QUARTERS: String
+      FIVE_EIGHTHS: String
+      HALF: String
+      THREE_EIGHTHS: String
+      ONE_QUARTER: String
+      ONE_EIGHTH: String
+
+      # Predefined sets (same structure as bar_set)
+      NINE_LEVELS: bar_set
+      THREE_LEVELS: bar_set
+    end
+
+    # Type alias for scrollbar set hashes
+    type scrollbar_set = {
+      track: String,
+      thumb: String,
+      begin_char: String,
+      end_char: String
+    }
+
+    module Scrollbar
+      # Predefined sets
+      DOUBLE_VERTICAL: scrollbar_set
+      DOUBLE_HORIZONTAL: scrollbar_set
+      VERTICAL: scrollbar_set
+      HORIZONTAL: scrollbar_set
+    end
+  end
+end

data/sig/ratatui_ruby/synthetic_events.rbs

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # Synthetic event queue for injecting events into the event loop.
+  # Used primarily for testing and the andThen-like integration pattern.
+  module SyntheticEvents
+    @queue: Array[Event]
+    @inline_sync: bool
+
+    def self.inline_sync!: () -> void
+    def self.inline_sync?: () -> bool
+    def self.push: (Event event) -> void
+    def self.pop: () -> Event?
+    def self.clear: () -> void
+    def self.pending?: () -> bool
+  end
+end

data/sig/ratatui_ruby/table_state.rbs

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TableState
+    def self.new: (?Integer? selected) -> TableState
+    def self.with_selected_cell: ([Integer, Integer]? cell) -> TableState
+    def select: (Integer? index) -> nil
+    def selected: () -> Integer?
+    def select_column: (Integer? index) -> nil
+    def selected_column: () -> Integer?
+    def selected_cell: () -> [Integer, Integer]?
+    def select_next_column: () -> nil
+    def select_previous_column: () -> nil
+    def select_first_column: () -> nil
+    def select_last_column: () -> nil
+    def offset: () -> Integer
+    def scroll_down_by: (Integer n) -> nil
+    def scroll_up_by: (Integer n) -> nil
+  end
+end

data/sig/ratatui_ruby/terminal/capabilities.rbs

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  class Terminal
+    # Environment-based terminal capability detection.
+    # Provides class methods for detecting terminal capabilities.
+    module Capabilities
+      def tty?: () -> bool
+      def dumb?: () -> bool
+      def no_color?: () -> bool
+      def force_color?: () -> bool
+      def interactive?: () -> bool
+      def available_color_count: () -> Integer
+      def color_support: () -> (:none | :basic | :ansi256 | :truecolor)
+      def supports_keyboard_enhancement?: () -> bool
+      def force_color_output: (bool enable) -> void
+
+      private
+
+      # FFI methods (defined in Rust, exposed on Terminal singleton)
+      def _available_color_count: () -> Integer
+      def _supports_keyboard_enhancement: () -> bool
+      def _force_color_output: (bool enable) -> void
+    end
+
+    extend Capabilities
+
+    private
+
+    # FFI singleton method for Backend.window_size
+    def self._terminal_window_size: () -> [Integer, Integer, Integer, Integer]?
+  end
+end

data/sig/ratatui_ruby/terminal/viewport.rbs

@@ -0,0 +1,33 @@
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+
+module RatatuiRuby
+  class Terminal
+    @viewport: Terminal::Viewport
+    @terminal_id: Integer
+
+    attr_reader terminal_id: Integer
+
+    def initialize: (?viewport: (Terminal::Viewport | :fullscreen | :inline)?, ?height: Integer?) -> void
+    def size: () -> Layout::Rect
+
+    # Private native methods (defined in Rust)
+    def self._init_test_terminal_instance: (Integer width, Integer height, String viewport_type, Integer? viewport_height) -> Integer
+    def self._get_terminal_size_instance: (Integer terminal_id) -> Layout::Rect
+
+    private def resolve_viewport: ((Terminal::Viewport | :fullscreen | :inline)? viewport, Integer? height) -> Terminal::Viewport
+
+    class Viewport < Data
+      attr_reader type: Symbol
+      attr_reader height: Integer?
+
+      def self.fullscreen: () -> Viewport
+      def self.inline: (Integer height) -> Viewport
+
+      def initialize: (type: Symbol, ?height: Integer?) -> void
+
+      def fullscreen?: () -> bool
+      def inline?: () -> bool
+    end
+  end
+end

data/sig/ratatui_ruby/terminal_lifecycle.rbs

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # Terminal lifecycle management for TUI sessions.
+  # Provides methods to initialize and restore the terminal state.
+  module TerminalLifecycle
+    @tui_session_active: bool?
+    @headless_mode: bool?
+
+    def init_terminal: (?focus_events: bool, ?bracketed_paste: bool, ?viewport: (Terminal::Viewport | :fullscreen | :inline)?, ?height: Integer?) -> void
+    def restore_terminal: () -> void
+    def terminal_active?: () -> (bool | nil)
+    def init_test_terminal: (Integer width, Integer height, ?String viewport_type, ?Integer? viewport_height) -> void
+    def run: (?focus_events: bool, ?bracketed_paste: bool, ?viewport: (Terminal::Viewport | :fullscreen | :inline)?, ?height: Integer?) { (TUI) -> void } -> void
+    def insert_before: (Integer height, ?widget? widget) ?{ () -> widget } -> void
+    def cursor_position=: (Layout::Position | [Integer, Integer] position) -> void
+    def cursor_position: () -> Layout::Position
+    def set_cursor_position: (Integer x, Integer y) -> void
+    def get_cursor_position: () -> [Integer, Integer]
+
+    # Private native methods
+    def _init_terminal: (bool focus_events, bool bracketed_paste, String viewport_type, Integer? viewport_height) -> void
+    def _init_test_terminal: (Integer width, Integer height, String viewport_type, Integer? viewport_height) -> void
+    def _restore_terminal: () -> void
+    def _get_viewport_type: () -> String
+    def _insert_before: (Integer height, widget? content) -> void
+    def resolve_viewport: ((Terminal::Viewport | :fullscreen | :inline)? viewport, Integer? height) -> Terminal::Viewport
+    def flush_warnings: () -> void
+    def flush_panic_info: () -> void
+  end
+end
+

data/sig/ratatui_ruby/test_helper/event_injection.rbs

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module EventInjection
+      def inject_event: (Event 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 | { code: String, ?modifiers: Array[String] } | Event::Key) args) -> void
+      alias inject_key inject_keys
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper/snapshot.rbs

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module Snapshot
+      include ::Minitest::Assertions
+
+      # Public assertions
+      def assert_plain_snapshot: (String name, ?String? msg, ?snapshot_dir: String?) ?{ (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, ?snapshot_dir: String?) ?{ (Array[String]) -> Array[String] } -> void
+      def assert_snapshots: (String name, ?String? msg) ?{ (Array[String]) -> Array[String] } -> void
+      def render_rich_buffer: () -> String
+
+      # Methods available via mixin context (from Minitest::Assertions)
+      # untyped: assert_equal from Minitest compares any two values
+      def assert_equal: (untyped expected, untyped actual, ?String? msg) -> void
+
+      # Methods available via mixin context (from Terminal)
+      def buffer_content: () -> Array[String]
+
+      private
+
+      def _render_buffer_with_ansi: () -> String
+      def _ansi_for_color: ((Symbol | String)?, Symbol layer) -> String
+      def _ansi_named_color: (Symbol name, bool is_fg) -> String
+      def _ansi_for_modifiers: (Array[Symbol]?) -> String
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper/style_assertions.rbs

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+# untyped: **untyped splat - assertions accept any attribute combination (fg, bg, bold, etc.)
+
+module RatatuiRuby
+  module TestHelper
+    module StyleAssertions
+      include ::Minitest::Assertions
+
+      # From Terminal module
+      def get_cell: (Integer x, Integer y) -> Hash[Symbol, untyped]
+
+      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: (Layout::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,20 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# 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,32 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+# untyped: widget parameter/storage - test mocks accept any widget type for flexibility
+
+module RatatuiRuby
+  module TestHelper
+    module TestDoubles
+      class MockFrame < Data
+        attr_accessor rendered_widgets: Array[{ widget: untyped, area: Layout::Rect }]
+        def self.new: (?rendered_widgets: Array[{ widget: untyped, area: Layout::Rect }]) -> MockFrame
+        def initialize: (?rendered_widgets: Array[{ widget: untyped, area: Layout::Rect }]) -> void
+        def render_widget: (untyped widget, Layout::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
+        def initialize: (?x: Integer, ?y: Integer, ?width: Integer, ?height: Integer) -> void
+      end
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper.rbs

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    include Terminal
+    include Snapshot
+    include EventInjection
+    include StyleAssertions
+    include TestDoubles
+  end
+end

data/sig/ratatui_ruby/text/line.rbs

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  module Text
+    class Line < Data
+      attr_reader spans: Array[Span]
+      attr_reader alignment: Symbol?
+      attr_reader style: Style::Style?
+
+      def self.new: (?spans: Array[Span], ?alignment: Symbol?, ?style: Style::Style?) -> Line
+      def initialize: (?spans: Array[Span], ?alignment: Symbol?, ?style: Style::Style?) -> void
+      def self.from_string: (String, ?alignment: Symbol?) -> Line
+      def width: () -> Integer
+      def left_aligned: () -> Line
+      def centered: () -> Line
+      def right_aligned: () -> Line
+      def push_span: (Span) -> Line
+      def patch_style: (Style::Style?) -> Line
+      def reset_style: () -> Line
+    end
+  end
+end

data/sig/ratatui_ruby/text/span.rbs

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  module Text
+    class Span < Data
+      attr_reader content: String
+      attr_reader style: Style::Style?
+
+      def self.new: (content: String, ?style: Style::Style?) -> Span
+      def initialize: (content: String, ?style: Style::Style?) -> void
+      def self.styled: (String, ?Style?) -> Span
+      def width: () -> Integer
+      def self.raw: (String) -> Span
+      def patch_style: (Style::Style?) -> Span
+      def reset_style: () -> Span
+    end
+  end
+end

data/sig/ratatui_ruby/text.rbs

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  module Text
+    def self.width: (String) -> Integer
+  end
+end

data/sig/ratatui_ruby/tui/buffer_factories.rbs

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module BufferFactories
+      def cell: (?symbol: String?, ?char: String?, ?fg: (Symbol | String | nil), ?bg: (Symbol | String | nil), ?modifiers: Array[String]) -> Buffer::Cell
+    end
+  end
+end

data/sig/ratatui_ruby/tui/canvas_factories.rbs

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module CanvasFactories
+      # Core shape methods
+      def shape_map: (?color: (String | Symbol), ?resolution: Symbol) -> Widgets::Shape::Map
+      def shape_line: (x1: _ToF, y1: _ToF, x2: _ToF, y2: _ToF, color: (String | Symbol)) -> Widgets::Shape::Line
+      def shape_point: (x: _ToF, y: _ToF) -> Widgets::Shape::Point
+      def shape_circle: (x: _ToF, y: _ToF, radius: _ToF, color: (String | Symbol)) -> Widgets::Shape::Circle
+      def shape_rectangle: (x: _ToF, y: _ToF, width: _ToF, height: _ToF, color: (String | Symbol)) -> Widgets::Shape::Rectangle
+      def shape_label: (x: _ToF, y: _ToF, ?text: String?, ?line: Text::Line?) -> Widgets::Shape::Label
+
+      # Terse aliases (DWIM) - no rectangle to avoid confusion with Layout::Rect
+      alias circle shape_circle
+      alias point shape_point
+      alias map shape_map
+      def label: (?untyped first, **untyped kwargs) -> Widgets::Shape::Label
+
+      # Bidirectional aliases (*_shape)
+      alias circle_shape shape_circle
+      alias point_shape shape_point
+      alias rectangle_shape shape_rectangle
+      alias map_shape shape_map
+      alias label_shape label
+
+      # Shape dispatcher (TIMTOWTDI pattern)
+      def shape: (Symbol, **untyped) -> untyped
+    end
+  end
+end

data/sig/ratatui_ruby/tui/core.rbs

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module Core
+      def draw: (?widget? tree) -> void
+              | () { (Frame) -> void } -> void
+      def poll_event: (?timeout: Float) -> Event
+      def get_cell_at: (Integer x, Integer y) -> Buffer::Cell
+      def draw_cell: (Integer x, Integer y, Buffer::Cell cell) -> Draw::CellCmd
+      def insert_before: (Integer height, ?widget? widget) ?{ () -> widget } -> void
+      def terminal_area: () -> RatatuiRuby::Layout::Rect
+      def viewport_area: () -> RatatuiRuby::Layout::Rect
+    end
+  end
+end