ratatui_ruby 0.1.0

data/lib/ratatui_ruby/schema/canvas.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # A point in the canvas coordinate system.
+  # @param x [Float] The x-coordinate.
+  # @param y [Float] The y-coordinate.
+  class Point < Data.define(:x, :y)
+  end
+
+  # A line shape on a canvas.
+  # @param x1 [Float] The starting x-coordinate.
+  # @param y1 [Float] The starting y-coordinate.
+  # @param x2 [Float] The ending x-coordinate.
+  # @param y2 [Float] The ending y-coordinate.
+  # @param color [String, Symbol] The color of the line.
+  class Line < Data.define(:x1, :y1, :x2, :y2, :color)
+  end
+
+  # A rectangle shape on a canvas.
+  # @param x [Float] The x-coordinate of the bottom-left corner.
+  # @param y [Float] The y-coordinate of the bottom-left corner.
+  # @param width [Float] The width of the rectangle.
+  # @param height [Float] The height of the rectangle.
+  # @param color [String, Symbol] The color of the rectangle.
+  class Rectangle < Data.define(:x, :y, :width, :height, :color)
+  end
+
+  # A circle shape on a canvas.
+  # @param x [Float] The x-coordinate of the center.
+  # @param y [Float] The y-coordinate of the center.
+  # @param radius [Float] The radius of the circle.
+  # @param color [String, Symbol] The color of the circle.
+  class Circle < Data.define(:x, :y, :radius, :color)
+  end
+
+  # A world map shape on a canvas.
+  # @param color [String, Symbol] The color of the map.
+  # @param resolution [Symbol] The resolution of the map (:low, :high).
+  class Map < Data.define(:color, :resolution)
+  end
+
+  # The Canvas Widget.
+  # @param shapes [Array] Array of shape objects (Line, Rectangle, Circle, Map).
+  # @param x_bounds [Array<Float>] [min, max] range for the x-axis.
+  # @param y_bounds [Array<Float>] [min, max] range for the y-axis.
+  # @param marker [Symbol] The marker to use for drawing (:braille, :dot, :block, :bar).
+  # @param block [Block, nil] Optional Block widget to wrap the canvas.
+  class Canvas < Data.define(:shapes, :x_bounds, :y_bounds, :marker, :block)
+    # Creates a new Canvas.
+    # @param shapes [Array] Array of shape objects (Line, Rectangle, Circle, Map).
+    # @param x_bounds [Array<Float>] [min, max] range for the x-axis.
+    # @param y_bounds [Array<Float>] [min, max] range for the y-axis.
+    # @param marker [Symbol] The marker to use for drawing (:braille, :dot, :block, :bar).
+    # @param block [Block, nil] Optional Block widget to wrap the canvas.
+    def initialize(shapes: [], x_bounds: [0.0, 100.0], y_bounds: [0.0, 100.0], marker: :braille, block: nil)
+      super
+    end
+  end
+end

data/lib/ratatui_ruby/schema/center.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 RatatuiRuby
+  # Centers a child widget within the current area.
+  #
+  # [child] the widget to center.
+  # [width_percent] the width percentage of the centered area.
+  # [height_percent] the height percentage of the centered area.
+  class Center < Data.define(:child, :width_percent, :height_percent)
+    # Creates a new Center.
+    #
+    # [child] the widget to center.
+    # [width_percent] the width percentage of the centered area.
+    # [height_percent] the height percentage of the centered area.
+  end
+end

data/lib/ratatui_ruby/schema/constraint.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # Defines constraints for layout sections or table columns.
+  #
+  # [type] The type of constraint (:length, :percentage, :min).
+  # [value] The numeric value associated with the constraint.
+  class Constraint < Data.define(:type, :value)
+    # Creates a length constraint (fixed number of cells).
+    #
+    # [v] The length value in cells.
+    def self.length(v)
+      new(type: :length, value: v)
+    end
+
+    # Creates a percentage constraint (portion of available space).
+    #
+    # [v] The percentage value (0-100).
+    def self.percentage(v)
+      new(type: :percentage, value: v)
+    end
+
+    # Creates a minimum size constraint.
+    #
+    # [v] The minimum number of cells.
+    def self.min(v)
+      new(type: :min, value: v)
+    end
+  end
+end

data/lib/ratatui_ruby/schema/cursor.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # Sets the terminal cursor position (ghost widget).
+  #
+  # [x] the x coordinate.
+  # [y] the y coordinate.
+  class Cursor < Data.define(:x, :y)
+    # Creates a new Cursor.
+    #
+    # [x] the x coordinate.
+    # [y] the y coordinate.
+  end
+end

data/lib/ratatui_ruby/schema/gauge.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # A widget that displays a progress bar.
+  #
+  # [ratio] A value between 0.0 and 1.0 representing the progress.
+  # [label] An optional string to display on the gauge.
+  # [style] The Style object to apply to the gauge.
+  # [block] An optional Block widget to wrap the gauge.
+  class Gauge < Data.define(:ratio, :label, :style, :block)
+    # Creates a new Gauge.
+    #
+    # [ratio] A value between 0.0 and 1.0 representing the progress.
+    # [label] An optional string to display on the gauge.
+    # [style] The Style object to apply to the gauge.
+    # [block] An optional Block widget to wrap the gauge.
+    def initialize(ratio: 0.0, label: nil, style: Style.default, block: nil)
+      super
+    end
+  end
+end

data/lib/ratatui_ruby/schema/layout.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # A widget that splits an area into multiple sections based on constraints.
+  #
+  # [direction] The direction of the layout (:vertical or :horizontal).
+  # [constraints] An array of Constraint objects defining the size of each section.
+  # [children] An array of widgets to render within each section.
+  class Layout < Data.define(:direction, :constraints, :children)
+    # Creates a new Layout.
+    #
+    # [direction] The direction of the layout (:vertical or :horizontal).
+    # [constraints] An array of Constraint objects defining the size of each section.
+    # [children] An array of widgets to render within each section.
+    def initialize(direction: :vertical, constraints: [], children: [])
+      super
+    end
+  end
+end

data/lib/ratatui_ruby/schema/line_chart.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # A single line on a chart.
+  #
+  # [name] The name of the dataset.
+  # [data] Array of arrays [[x, y], [x, y]] (Floats).
+  # [color] The color of the line.
+  class Dataset < Data.define(:name, :data, :color)
+    # Creates a new Dataset.
+    # [name] The name of the dataset.
+    # [data] Array of arrays [[x, y], [x, y]] (Floats).
+    # [color] The color of the line.
+    def initialize(name:, data:, color: "white")
+      super
+    end
+  end
+
+  # A complex chart widget.
+  #
+  # [datasets] Array of Dataset objects.
+  # [x_labels] Array of Strings for the X-axis labels.
+  # [y_labels] Array of Strings for the Y-axis labels.
+  # [y_bounds] Array of two Floats [min, max] for the Y-axis.
+  # [block] Optional block widget to wrap the chart.
+  class LineChart < Data.define(:datasets, :x_labels, :y_labels, :y_bounds, :block)
+    # Creates a new LineChart widget.
+    #
+    # [datasets] Array of Dataset objects.
+    # [x_labels] Array of Strings for the X-axis labels.
+    # [y_labels] Array of Strings for the Y-axis labels.
+    # [y_bounds] Array of two Floats [min, max] for the Y-axis.
+    # [block] Optional block widget to wrap the chart.
+    def initialize(datasets:, x_labels: [], y_labels: [], y_bounds: [0.0, 100.0], block: nil)
+      super
+    end
+  end
+end

data/lib/ratatui_ruby/schema/list.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # A widget that displays a list of selectable items.
+  #
+  # [items] An array of strings to display in the list.
+  # [selected_index] The index of the currently selected item, or nil if none.
+  # [block] An optional Block widget to wrap the list.
+  class List < Data.define(:items, :selected_index, :block)
+    # Creates a new List.
+    #
+    # [items] An array of strings to display in the list.
+    # [selected_index] The index of the currently selected item, or nil if none.
+    # [block] An optional Block widget to wrap the list.
+    def initialize(items: [], selected_index: nil, block: nil)
+      super
+    end
+  end
+end

data/lib/ratatui_ruby/schema/overlay.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # Renders children on top of each other (Painter's Algorithm).
+  #
+  # [layers] Array of Widgets.
+  class Overlay < Data.define(:layers)
+    # Creates a new Overlay.
+    #
+    # [layers] Array of Widgets.
+  end
+end

data/lib/ratatui_ruby/schema/paragraph.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # A widget that displays a block of text.
+  #
+  # [text] the text to display.
+  # [style] the style to apply (Style object).
+  # [block] an optional Block widget to wrap the paragraph.
+  class Paragraph < Data.define(:text, :style, :block, :wrap, :align)
+    # Creates a new Paragraph.
+    #
+    # [text] the text to display.
+    # [style] the style to apply.
+    # [block] the block to wrap the paragraph.
+    # [wrap] whether to wrap text at width.
+    # [align] alignment (:left, :center, :right).
+    def initialize(text:, style: Style.default, block: nil, wrap: false, align: :left)
+      super
+    end
+
+    # Support for legacy fg/bg arguments.
+    # [text] the text to display.
+    # [style] the style to apply.
+    # [fg] legacy foreground color.
+    # [bg] legacy background color.
+    # [block] the block to wrap the paragraph.
+    # [wrap] whether to wrap text at width.
+    # [align] alignment (:left, :center, :right).
+    def self.new(text:, style: nil, fg: nil, bg: nil, block: nil, wrap: false, align: :left)
+      style ||= Style.new(fg:, bg:)
+      super(text:, style:, block:, wrap:, align:)
+    end
+  end
+end

data/lib/ratatui_ruby/schema/scrollbar.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  ##
+  # Visual scroll indicator.
+  #
+  # A Scrollbar widget that can be oriented vertically or horizontally.
+  # It displays a track and a thumb to indicate the current scroll position
+  # relative to the total content length.
+  #
+  # == Fields
+  #
+  # [+content_length+] Total length of the content (Integer).
+  # [+position+] Current scroll position (Integer).
+  # [+orientation+] +:vertical+ or +:horizontal+ (Symbol, default: +:vertical+).
+  # [+thumb_symbol+] The character used for the scrollbar thumb (String, default: "█").
+  # [+block+] An optional Block to wrap the scrollbar.
+  class Scrollbar < Data.define(:content_length, :position, :orientation, :thumb_symbol, :block)
+    # Creates a new Scrollbar.
+    #
+    # [+content_length+] Total length of the content (Integer).
+    # [+position+] Current scroll position (Integer).
+    # [+orientation+] +:vertical+ or +:horizontal+ (Symbol, default: +:vertical+).
+    # [+thumb_symbol+] The character used for the scrollbar thumb (String, default: "█").
+    # [+block+] An optional Block to wrap the scrollbar.
+    def initialize(content_length:, position:, orientation: :vertical, thumb_symbol: "█", block: nil)
+      super
+    end
+  end
+end

data/lib/ratatui_ruby/schema/sparkline.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # A widget that displays a compact data row.
+  #
+  # [data] Array of Integers.
+  # [max] Optional maximum value.
+  # [style] Optional style for the sparkline.
+  # [block] Optional block widget to wrap the sparkline.
+  class Sparkline < Data.define(:data, :max, :style, :block)
+    # Creates a new Sparkline widget.
+    #
+    # [data] Array of Integers.
+    # [max] Optional maximum value.
+    # [style] Optional style for the sparkline.
+    # [block] Optional block widget to wrap the sparkline.
+    def initialize(data:, max: nil, style: nil, block: nil)
+      super
+    end
+  end
+end

data/lib/ratatui_ruby/schema/style.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # A value object that defines colors and modifiers for text or widgets.
+  #
+  # [fg] The foreground color (e.g., +:red+, +"#ff0000"+).
+  # [bg] The background color (e.g., +:black+, +"#000000"+).
+  # [modifiers] An array of symbols representing text modifiers:
+  #             [+:bold+, +:italic+, +:dim+, +:reversed+, +:underlined+, +:slow_blink+, +:rapid_blink+, +:crossed_out+, +:hidden+]
+  class Style < Data.define(:fg, :bg, :modifiers)
+    # Creates a new Style.
+    #
+    # [fg] The foreground color (e.g., "red", "#ff0000").
+    # [bg] The background color (e.g., "black", "#000000").
+    # [modifiers] An array of symbols representing text modifiers.
+    def initialize(fg: nil, bg: nil, modifiers: [])
+      super
+    end
+
+    # Returns a default style with no colors or modifiers.
+    #
+    #   Style.default
+    #   # => #<RatatuiRuby::Style fg=nil, bg=nil, modifiers=[]>
+    def self.default
+      new
+    end
+  end
+end

data/lib/ratatui_ruby/schema/table.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # A widget that displays data in a grid with rows and columns.
+  #
+  # [header] An array of strings or Paragraphs representing the header row.
+  # [rows] An array of arrays of strings or Paragraphs representing the data rows.
+  # [widths] An array of Constraint objects defining column widths.
+  # [block] An optional Block widget to wrap the table.
+  class Table < Data.define(:header, :rows, :widths, :block)
+    # Creates a new Table.
+    #
+    # [header] An array of strings or Paragraphs representing the header row.
+    # [rows] An array of arrays of strings or Paragraphs representing the data rows.
+    # [widths] An array of Constraint objects defining column widths.
+    # [block] An optional Block widget to wrap the table.
+    def initialize(header: nil, rows: [], widths: [], block: nil)
+      super
+    end
+  end
+end

data/lib/ratatui_ruby/schema/tabs.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # A widget that displays a set of tabs, one of which is selected.
+  #
+  # [titles] Array of strings or lines to display as tab titles.
+  # [selected_index] The index of the currently selected tab.
+  # [block] Optional block widget to wrap the tabs.
+  class Tabs < Data.define(:titles, :selected_index, :block)
+    # Creates a new Tabs widget.
+    #
+    # [titles] Array of strings or lines to display as tab titles.
+    # [selected_index] The index of the currently selected tab.
+    # [block] Optional block widget to wrap the tabs.
+    def initialize(titles: [], selected_index: 0, block: nil)
+      super
+    end
+  end
+end

data/lib/ratatui_ruby/test_helper.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  ##
+  # Helpers for testing RatatuiRuby applications.
+  #
+  # This module provides methods to set up a test terminal, capture buffer content,
+  # and check cursor position, making it easier to write unit tests for your TUI apps.
+  #
+  # == Usage
+  #
+  #   require "ratatui_ruby/test_helper"
+  #
+  #   class MyTest < Minitest::Test
+  #     include RatatuiRuby::TestHelper
+  #
+  #     def test_rendering
+  #       with_test_terminal(width: 80, height: 24) do
+  #         # ... render your app ...
+  #         assert_includes buffer_content, "Hello World"
+  #       end
+  #     end
+  #   end
+  module TestHelper
+    ##
+    # Initializes a test terminal context with specified dimensions.
+    # Restores the original terminal state after the block executes.
+    #
+    # +width+:: width of the test terminal (default: 20)
+    # +height+:: height of the test terminal (default: 10)
+    #
+    # If a block is given, it is executed within the test terminal context.
+    def with_test_terminal(width = 20, height = 10)
+      RatatuiRuby.init_test_terminal(width, height)
+      yield
+    ensure
+      RatatuiRuby.restore_terminal
+    end
+
+    ##
+    # Returns the current content of the terminal buffer as an array of strings.
+    # Each string represents a row in the terminal.
+    #
+    #   buffer_content
+    #   # => ["Row 1 text", "Row 2 text", ...]
+    def buffer_content
+      RatatuiRuby.get_buffer_content.split("\n")
+    end
+
+    ##
+    # Returns the current cursor position as a hash with +:x+ and +:y+ keys.
+    #
+    #   cursor_position
+    #   # => { x: 0, y: 0 }
+    def cursor_position
+      x, y = RatatuiRuby.get_cursor_position
+      { x:, y: }
+    end
+
+    ##
+    # Injects a mock event into the event queue for testing purposes.
+    #
+    # +event_type+:: "key" or "mouse"
+    # +data+:: a Hash containing event data
+    #
+    #   inject_event("key", { code: "a" })
+    #   inject_event("mouse", { kind: "down", x: 0, y: 0 })
+    def inject_event(event_type, data)
+      RatatuiRuby.inject_test_event(event_type, data)
+    end
+  end
+end

data/lib/ratatui_ruby/version.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # The version of the ratatui_ruby gem.
+  # See https://semver.org/spec/v2.0.0.html
+  VERSION = "0.1.0"
+end

data/lib/ratatui_ruby.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require_relative "ratatui_ruby/version"
+require_relative "ratatui_ruby/schema/paragraph"
+require_relative "ratatui_ruby/schema/layout"
+require_relative "ratatui_ruby/schema/block"
+require_relative "ratatui_ruby/schema/constraint"
+require_relative "ratatui_ruby/schema/list"
+require_relative "ratatui_ruby/schema/style"
+require_relative "ratatui_ruby/schema/gauge"
+require_relative "ratatui_ruby/schema/table"
+require_relative "ratatui_ruby/schema/tabs"
+require_relative "ratatui_ruby/schema/bar_chart"
+require_relative "ratatui_ruby/schema/sparkline"
+require_relative "ratatui_ruby/schema/line_chart"
+require_relative "ratatui_ruby/schema/cursor"
+require_relative "ratatui_ruby/schema/overlay"
+require_relative "ratatui_ruby/schema/center"
+require_relative "ratatui_ruby/schema/scrollbar"
+require_relative "ratatui_ruby/schema/canvas"
+
+begin
+  require "ratatui_ruby/ratatui_ruby"
+rescue LoadError
+  # Fallback for development/CI if the bundle is not in the load path
+  require_relative "ratatui_ruby/ratatui_ruby"
+end
+
+# The RatatuiRuby module acts as a namespace for the entire gem.
+# It provides the main entry points for initializing the terminal and drawing the UI.
+module RatatuiRuby
+  # Generic error class for RatatuiRuby.
+  class Error < StandardError; end
+
+  ##
+  # :method: init_terminal
+  # :call-seq: init_terminal() -> nil
+  #
+  # Initializes the terminal for TUI mode.
+  # Enters alternate screen and enables raw mode.
+  #
+  # (Native method implemented in Rust)
+
+  ##
+  # :method: restore_terminal
+  # :call-seq: restore_terminal() -> nil
+  #
+  # Restores the terminal to its original state.
+  # Leaves alternate screen and disables raw mode.
+  #
+  # (Native method implemented in Rust)
+
+  ##
+  # :method: draw
+  # :call-seq: draw(node) -> nil
+  #
+  # Draws the given UI node tree to the terminal.
+  # [node] the root node of the UI tree (Paragraph, Layout).
+  #
+  # (Native method implemented in Rust)
+
+  ##
+  # :method: poll_event
+  # :call-seq: poll_event() -> Hash, nil
+  #
+  # Polls for a keyboard event.
+  #
+  #   poll_event
+  #   # => { type: "key", code: "char", value: "a", modifiers: [] }
+  #
+  # (Native method implemented in Rust)
+
+  ##
+  # :method: inject_test_event
+  # :call-seq: inject_test_event(event_type, data) -> nil
+  #
+  # Injects a mock event into the event queue for testing purposes.
+  # [event_type] "key" or "mouse"
+  # [data] a Hash containing event data
+  #
+  #   inject_test_event("key", { code: "a" })
+  #
+  # (Native method implemented in Rust)
+end

data/sig/ratatui_ruby/ratatui_ruby.rbs

@@ -0,0 +1,16 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  type widget = Paragraph | Layout | List | Gauge | Table | Tabs | BarChart | Block | Sparkline | LineChart
+
+  interface _ToS
+    def to_s: () -> String
+  end
+
+  def self.init_terminal: () -> void
+  def self.restore_terminal: () -> void
+  def self.draw: (widget) -> void
+  def self.poll_event: () -> Hash[Symbol, untyped]?
+  def self.inject_test_event: (String, Hash[Symbol, untyped]) -> void
+end

data/sig/ratatui_ruby/schema/bar_chart.rbs

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class BarChart < Data
+    attr_reader data: Hash[String | Symbol | _ToS, Integer]
+    attr_reader bar_width: Integer
+    attr_reader bar_gap: Integer
+    attr_reader max: Integer?
+    attr_reader style: Style?
+    attr_reader block: Block?
+    def self.new: (data: Hash[String | Symbol | _ToS, Integer], ?bar_width: Integer, ?bar_gap: Integer, ?max: Integer?, ?style: Style?, ?block: Block?) -> BarChart
+  end
+end

data/sig/ratatui_ruby/schema/block.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class Block < Data
+    attr_reader title: String?
+    attr_reader borders: Array[Symbol]
+    attr_reader border_color: (String | Symbol)?
+    def self.new: (?title: String?, ?borders: Array[Symbol], ?border_color: (String | Symbol)?) -> Block
+  end
+end