ratatui_ruby 1.3.0 → 1.3.3

data/README.md

@@ -1,187 +0,0 @@
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-  SPDX-License-Identifier: CC-BY-SA-4.0
--->
-# ratatui_ruby
-
-[![
-builds.sr.ht status](https://builds.sr.ht/~kerrick/ratatui_ruby.svg)](https://builds.sr.ht/~kerrick/ratatui_ruby?) [![
-License](https://img.shields.io/badge/dynamic/regex?url=https%3A%2F%2Fgit.sr.ht%2F~kerrick%2Fratatui_ruby%2Fblob%2Fstable%2Fratatui_ruby.gemspec&search=spec%5C.license%20%3D%20%22(.*)%22&replace=%241&label=License&color=a2c93e)](https://spdx.org/licenses/AGPL-3.0-or-later.html) [![
-Gem Total Downloads](https://img.shields.io/gem/dt/ratatui_ruby)](https://rubygems.org/gems/ratatui_ruby) [![
-Gem Version](https://img.shields.io/gem/v/ratatui_ruby)](https://rubygems.org/gems/ratatui_ruby) [![
-Ratatui Version](https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fgit.sr.ht%2F~kerrick%2Fratatui_ruby%2Fblob%2Fstable%2Fext%2Fratatui_ruby%2FCargo.toml&query=%24.dependencies.ratatui.version&prefix=v&logo=ratatui&label=Ratatui)](https://crates.io/crates/ratatui/0.30) [![
-Mailing List: Discussion](https://img.shields.io/badge/mailing_list-discussion-5865F2.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIiBjbGFzcz0iaWNvbiBpY29uLXRhYmxlciBpY29ucy10YWJsZXItb3V0bGluZSBpY29uLXRhYmxlci1tYWlsIj48cGF0aCBzdHJva2U9Im5vbmUiIGQ9Ik0wIDBoMjR2MjRIMHoiIGZpbGw9Im5vbmUiLz48cGF0aCBkPSJNMyA3YTIgMiAwIDAgMSAyIC0yaDE0YTIgMiAwIDAgMSAyIDJ2MTBhMiAyIDAgMCAxIC0yIDJoLTE0YTIgMiAwIDAgMSAtMiAtMnYtMTB6IiAvPjxwYXRoIGQ9Ik0zIDdsOSA2bDkgLTYiIC8+PC9zdmc+Cg==)](https://lists.sr.ht/~kerrick/ratatui_ruby-discuss) [![
-Mailing List: Development](https://img.shields.io/badge/mailing_list-development-4954d5.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIiBjbGFzcz0iaWNvbiBpY29uLXRhYmxlciBpY29ucy10YWJsZXItb3V0bGluZSBpY29uLXRhYmxlci1tYWlsIj48cGF0aCBzdHJva2U9Im5vbmUiIGQ9Ik0wIDBoMjR2MjRIMHoiIGZpbGw9Im5vbmUiLz48cGF0aCBkPSJNMyA3YTIgMiAwIDAgMSAyIC0yaDE0YTIgMiAwIDAgMSAyIDJ2MTBhMiAyIDAgMCAxIC0yIDJoLTE0YTIgMiAwIDAgMSAtMiAtMnYtMTB6IiAvPjxwYXRoIGQ9Ik0zIDdsOSA2bDkgLTYiIC8+PC9zdmc+Cg==)](https://lists.sr.ht/~kerrick/ratatui_ruby-devel) [![
-Mailing List: Announcements](https://img.shields.io/badge/mailing_list-announcements-3b44ac.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIiBjbGFzcz0iaWNvbiBpY29uLXRhYmxlciBpY29ucy10YWJsZXItb3V0bGluZSBpY29uLXRhYmxlci1tYWlsIj48cGF0aCBzdHJva2U9Im5vbmUiIGQ9Ik0wIDBoMjR2MjRIMHoiIGZpbGw9Im5vbmUiLz48cGF0aCBkPSJNMyA3YTIgMiAwIDAgMSAyIC0yaDE0YTIgMiAwIDAgMSAyIDJ2MTBhMiAyIDAgMCAxIC0yIDJoLTE0YTIgMiAwIDAgMSAtMiAtMnYtMTB6IiAvPjxwYXRoIGQ9Ik0zIDdsOSA2bDkgLTYiIC8+PC9zdmc+Cg==)](https://lists.sr.ht/~kerrick/ratatui_ruby-announce)
-
-
-## Introduction
-
-**ratatui_ruby** is a Ruby wrapper for [Ratatui](https://ratatui.rs). It allows you to cook up Terminal User Interfaces in Ruby.
-**ratatui_ruby** is a community wrapper that is not affiliated with [the Ratatui team](https://github.com/orgs/ratatui/people).
-
-**[Why RatatuiRuby?](./doc/getting_started/why.md)** — Native Rust performance, zero runtime overhead, and Ruby's expressiveness. [See how we compare](./doc/getting_started/why.md) to CharmRuby, raw Rust, and Go.
-
-Please join the **announce** mailing list at https://lists.sr.ht/~kerrick/ratatui_ruby-announce to stay up-to-date on new releases and announcements. See the [`trunk` branch](https://git.sr.ht/~kerrick/ratatui_ruby/tree/trunk) for pre-release updates.
-
----
-
-## Quick Links
-
-### The Ecosystem
-
-**RatatuiRuby:** [Core engine](https://git.sr.ht/~kerrick/ratatui_ruby) • **Tea:** [MVU architecture](https://git.sr.ht/~kerrick/ratatui_ruby-tea) • **Kit:** [Component architecture](https://git.sr.ht/~kerrick/ratatui_ruby-kit) (Planned) • **DSL:** [Glimmer syntax](https://sr.ht/~kerrick/ratatui_ruby/#chapter-4-the-syntax) (Planned) • **Framework:** [Omakase framework](https://git.sr.ht/~kerrick/ratatui_ruby-framework) (Planned) • **UI:** [Polished widgets](https://git.sr.ht/~kerrick/ratatui_ruby-ui) (Planned) • **UI Pro:** [More polished widgets](https://sr.ht/~kerrick/ratatui_ruby#chapter-6-licensing) (Planned)
-
-### For App Developers
-
-**Get Started:** [Quickstart](https://git.sr.ht/~kerrick/ratatui_ruby/tree/stable/item/doc/getting_started/quickstart.md) • [Examples](https://git.sr.ht/~kerrick/ratatui_ruby/tree/stable/item/examples) ⸺ **Stay Informed:** [Announce List](https://lists.sr.ht/~kerrick/ratatui_ruby-announce) • [FAQ](https://man.sr.ht/~kerrick/ratatui_ruby/troubleshooting.md) ⸺ **Reach Out:** [Discuss List](https://lists.sr.ht/~kerrick/ratatui_ruby-discuss) • [Bug Tracker](https://todo.sr.ht/~kerrick/ratatui_ruby)
-
-### For Contributors
-
-**Get Started:** [Contributing Guide](https://man.sr.ht/~kerrick/ratatui_ruby/contributing.md) • [Code of Conduct](https://man.sr.ht/~kerrick/ratatui_ruby/code_of_conduct.md) ⸺ **Stay Informed:** [Announce List](https://lists.sr.ht/~kerrick/ratatui_ruby-announce) • [Project History](https://man.sr.ht/~kerrick/ratatui_ruby/history/index.md) ⸺ **Reach Out:** [Development List](https://lists.sr.ht/~kerrick/ratatui_ruby-devel) • [Bug Tracker](https://todo.sr.ht/~kerrick/ratatui_ruby)
-
----
-
-## Compatibility
-
-**ratatui_ruby** is designed to run on [everything Ruby does](https://www.ruby-lang.org/en/documentation/installation/), including:
-
-- GNU/Linux, macOS, Windows, OpenBSD, and FreeBSD; and
-- x86_64 (AMD, Intel) and ARM (Apple Silicon, Raspberry Pi).
-
-We support the latest minor version of every
-[non-eol Ruby version](https://www.ruby-lang.org/en/downloads/branches/),
-including Ruby 4.
-
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2025 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```ruby
-gem "ratatui_ruby"
-```
-<!-- SPDX-SnippetEnd -->
-
-And then execute:
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2025 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```bash
-bundle install
-```
-<!-- SPDX-SnippetEnd -->
-
-Or install it yourself with:
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2025 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```bash
-gem install ratatui_ruby
-```
-<!-- SPDX-SnippetEnd -->
-
-
-## Usage
-
-**ratatui_ruby** uses an immediate-mode API. You describe your UI using Ruby objects and call `draw` in a loop.
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-<!-- SYNC:START:examples/verify_readme_usage/app.rb:main -->
-```ruby
-RatatuiRuby.run do |tui|
-  loop do
-    tui.draw do |frame|
-      frame.render_widget(
-        tui.paragraph(
-          text: "Hello, Ratatui! Press 'q' to quit.",
-          alignment: :center,
-          block: tui.block(
-            title: "My Ruby TUI App",
-            borders: [:all],
-            border_style: { fg: "cyan" }
-          )
-        ),
-        frame.area
-      )
-    end
-    case tui.poll_event
-    in { type: :key, code: "q" } | { type: :key, code: "c", modifiers: ["ctrl"] }
-      break
-    else
-      nil
-    end
-  end
-end
-```
-<!-- SYNC:END -->
-<!-- SPDX-SnippetEnd -->
-
-![Hello Ratatui](./doc/images/verify_readme_usage.png)
-
-For a full tutorial, see [the Quickstart](./doc/getting_started/quickstart.md). For an explanation of the application architecture, see [Application Architecture](./doc/concepts/application_architecture.md).
-
-
-## Features
-
-**ratatui_ruby** gives you 20+ widgets out of the box:
-
-| Category | Widgets |
-|----------|---------|
-| **Data Display** | Table, List, Chart, Bar Chart, Sparkline, Calendar |
-| **Layout** | Block, Tabs, Scrollbar, Center, Overlay, Clear |
-| **Input** | Gauge, Line Gauge |
-| **Text** | Paragraph, Rich Text (Spans + Lines), Cursor |
-| **Canvas** | Shapes (Line, Circle, Rectangle, Map), Custom Drawing |
-
-Plus: flexible layouts with constraints, full keyboard/mouse/paste/resize events, snapshot testing, and hex/RGB/256-color support.
-
-
-## Documentation
-
-| Resource | Description |
-|----------|-------------|
-| [Quickstart](./doc/getting_started/quickstart.md) | Get running in 5 minutes |
-| [Widget Gallery](./doc/getting_started/quickstart.md#widget-demos) | Every widget with examples |
-| [Application Architecture](./doc/concepts/application_architecture.md) | Patterns for scaling your app |
-| [API Reference](./doc/index.md) | Full RDoc documentation |
-| [Wiki](https://man.sr.ht/~kerrick/ratatui_ruby) | Guides and community resources |
-
-
-## Contributing
-
-Bug reports and pull requests are welcome on [sourcehut](https://sourcehut.org) at https://sr.ht/~kerrick/ratatui_ruby/. This project is intended to be a safe, productive collaboration, and contributors are expected to adhere to the [Code of Conduct](https://man.sr.ht/~kerrick/ratatui_ruby/code_of_conduct.md).
-
-Issues for the underlying Rust library should be filed at [ratatui/ratatui](https://github.com/ratatui/ratatui).
-
-Want to help develop **ratatui_ruby**? Check out the [contribution guide on the wiki](https://man.sr.ht/~kerrick/ratatui_ruby/contributing.md).
-
-**Note**: Active development happens on the `trunk` branch. Use `trunk` if you are a contributor or want the latest cutting-edge features. `stable` is for stable releases only.
-
-
-## Copyright & License
-
-**ratatui_ruby** is copyright 2025, Kerrick Long.
-
-The library is [LGPL-3.0-or-later](./LICENSES/LGPL-3.0-or-later.txt): you can use it in proprietary applications, but you must share changes you make to **ratatui_ruby** itself. Documentation snippets and widget examples are [MIT-0](./LICENSES/MIT-0.txt): copy and use them without attribution.
-
-Documentation is [CC-BY-SA-4.0](./LICENSES/CC-BY-SA-4.0.txt). Build tooling and full app examples are [AGPL-3.0-or-later](./LICENSES/AGPL-3.0-or-later.txt). See each file's SPDX comment for specifics.
-
-Some parts of this program are copied from other sources under appropriate reuse licenses, and the copyright belongs to their respective owners. See the [REUSE Specification – Version 3.3](https://reuse.software/spec-3.3/) for details.
-
-This program was created with significant assistance from multiple LLMs. The process was human-controlled through creative prompts, with human contributions to each commit. See commit footers for model attribution. [declare-ai.org](https://declare-ai.org/1.0.0/creative.html)

data/README.rdoc

@@ -1,302 +0,0 @@
-
-== Terminal UIs, the Ruby Way
-
-RatatuiRuby[https://rubygems.org/gems/ratatui_ruby] is a RubyGem built on
-Ratatui[https://ratatui.rs], a leading TUI library written in
-Rust[https://rust-lang.org]. You get native performance with the joy of Ruby.
-
-  gem install ratatui_ruby
-
-{rdoc-image:https://ratatui-ruby.dev/hero.gif}[https://www.ratatui-ruby.dev/docs/v0.10/examples/app_cli_rich_moments/README_md.html]
-
-=== Rich Moments
-
-Add a spinner, a progress bar, or an inline menu to your CLI script. No
-full-screen takeover. Your terminal history stays intact.
-
-==== Inline Viewports
-
-Standard TUIs erase themselves on exit. Your carefully formatted CLI output
-disappears. Users lose their scrollback.
-
-<b>Inline viewports</b> solve this. They occupy a fixed number of lines, render
-rich UI, then leave the output in place when done.
-
-Perfect for spinners, menus, progress indicators—any brief moment of richness.
-
-  require "ratatui_ruby"
-
-  RatatuiRuby.run(viewport: :inline, height: 1) do |tui|
-    until connected?
-      status = tui.paragraph(text: "\#{spin} Connecting...")
-      tui.draw { |frame| frame.render_widget(status, frame.area) }
-    end
-  end
-
-=== Build Something Real
-
-Full-screen applications with {keyboard and mouse input}[https://www.ratatui-ruby.dev/docs/v0.10/examples/app_all_events/README_md.html]. The managed loop
-sets up the terminal and restores it on exit, even after crashes.
-
-  RatatuiRuby.run do |tui|
-    loop do
-      tui.draw do |frame|
-        frame.render_widget(
-          tui.paragraph(text: "Hello, RatatuiRuby!", alignment: :center),
-          frame.area
-        )
-      end
-
-      case tui.poll_event
-      in { type: :key, code: "q" } then break
-      else nil
-      end
-    end
-  end
-
-==== Widgets included:
-
-[Layout]
-  {Block}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_block/README_md.html],
-  {Center}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_center/README_md.html],
-  {Clear (Popup, Modal)}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_popup/README_md.html],
-  {Layout (Split, Grid)}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_layout_split/README_md.html],
-  {Overlay}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_overlay/README_md.html]
-[Data]
-  {Bar Chart}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_barchart/README_md.html],
-  {Chart}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_chart/README_md.html],
-  {Gauge}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_gauge/README_md.html],
-  {Line Gauge}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_line_gauge/README_md.html],
-  {Sparkline}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_sparkline/README_md.html],
-  {Table}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_table/README_md.html]
-[Text]
-  {Cell}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_cell/README_md.html],
-  {List}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_list/README_md.html],
-  {Rich Text (Line, Span)}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_rich_text/README_md.html],
-  {Scrollbar (Scroll)}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_scrollbar/README_md.html],
-  {Tabs}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_tabs/README_md.html]
-[Graphics]
-  {Calendar}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_calendar/README_md.html],
-  {Canvas}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_canvas/README_md.html],
-  {Map (World Map)}[https://www.ratatui-ruby.dev/docs/v0.10/examples/widget_map/README_md.html]
-
-Need something else? {Build custom widgets}[https://www.ratatui-ruby.dev/docs/v0.10/doc/concepts/custom_widgets_md.html] in Ruby!
-
-
----
-
-=== Testing Built In
-
-TUI testing is tedious. You need a headless terminal, event injection,
-snapshot comparisons, and style assertions. RatatuiRuby bundles all of it.
-
-  require "ratatui_ruby/test_helper"
-
-  class TestColorPicker < Minitest::Test
-    include RatatuiRuby::TestHelper
-
-    def test_swatch_widget
-      with_test_terminal(10, 3) do
-        RatatuiRuby.draw do |frame|
-          frame.render_widget(Swatch.new(:red), frame.area)
-        end
-        assert_cell_style 2, 1, char: "█", bg: :red
-      end
-    end
-  end
-
-==== What's inside:
-
-- <b>Headless terminal</b> — No real TTY needed
-- <b>Snapshots</b> — Plain text and rich (ANSI colors)
-- <b>Event injection</b> — Keys, mouse, paste, resize
-- <b>Style assertions</b> — Color, bold, underline at any cell
-- <b>Test doubles</b> — Mock frames and stub rects
-- <b>UPDATE_SNAPSHOTS=1</b> — Regenerate baselines in one command
-
-
----
-
-==== Inline Menu Example
-
-  require "ratatui_ruby"
-
-  # This example renders an inline menu. Arrow keys select, enter confirms.
-  # The menu appears in-place, preserving scrollback. When the user chooses,
-  # the TUI closes and the script continues with the selected value.
-  class RadioMenu
-    CHOICES = ["Production", "Staging", "Development"]         # ASCII strings are universally supported.
-    PREFIXES = { active: "●", inactive: "○" }                  # Some terminals may not support Unicode.
-    CONTROLS = "↑/↓: Select | Enter: Choose | Ctrl+C: Cancel"  # Let users know what keys you handle.
-    TITLES = ["Select Environment",                            # The default title position is top left.
-              { content: CONTROLS,                             # Multiple titles can save space.
-                position: :bottom,                             # Titles go on the top or bottom,
-                alignment: :right }]                           # aligned left, right, or center
-
-    def call                                                   # This method blocks until a choice is made.
-      RatatuiRuby.run(viewport: :inline, height: 5) do |tui|   # RatauiRuby.run manages the terminal.
-        @tui = tui                                             # The TUI instance is safe to store.
-        show_menu until chosen?                                # You can use any loop keyword you like.
-      end                                                      # `run` won't return until your block does,
-      RadioMenu::CHOICES[@choice]                              # so you can use it synchronously.
-    end
-                                                               # Classes like RadioMenu are convenient for
-    private                                                    # CLI authors to offer "rich moments."
-
-    def show_menu = @tui.draw do |frame|                       # RatatuiRuby gives you low-level access.
-      widget = @tui.paragraph(                                 # But the TUI facade makes it easy to use.
-        text: menu_items,                                      # Text can be spans, lines, or paragraphs.
-        block: @tui.block(borders: :all, titles: TITLES)       # Blocks give you boxes and titles, and hold
-      )                                                        # one or more widgets. We only use one here,
-      frame.render_widget(widget, frame.area)                  # but "area" lets you compose sub-views.
-    end
-
-    def chosen?                                                # You are responsible for handling input.
-      interaction = @tui.poll_event                            # Every frame, you receive an event object:
-      return choose if interaction.enter?                      # Key, Mouse, Resize, Paste, FocusGained,
-                                                               # FocusLost, or None objects. They come with
-      move_by(-1) if interaction.up?                           # predicates, support pattern matching, and
-      move_by(1) if interaction.down?                          # can be inspected for properties directly.
-      quit! if interaction.ctrl_c?                             # Your application must handle every input,
-      false                                                    # even interrupts and other exit patterns.
-    end
-
-    def choose                                                 # Here, the loop is about to exit, and the
-      prepare_next_line                                        # block will return. The inline viewport
-      @choice                                                  # will be torn down and the terminal will
-    end                                                        # be restored, but you are responsible for
-                                                               # positioning the cursor.
-    def prepare_next_line                                      # To ensure the next output is on a new
-      area = @tui.viewport_area                                # line, query the viewport area and move
-      RatatuiRuby.cursor_position = [0, area.y + area.height]  # the cursor to the start of the last line.
-      puts                                                     # Then print a newline.
-    end
-
-    def quit!                                                  # All of your familiar Ruby control flow
-      prepare_next_line                                        # keywords work as expected, so we can
-      exit 0                                                   # use them to leave the TUI.
-    end
-
-    def move_by(line_count)                                    # You are in full control of your UX, so
-      @choice = (@choice + line_count) % CHOICES.size          # you can implement any logic you need:
-    end                                                        # Would you "wrap around" here, or not?
-                                                               #
-    def menu_items = CHOICES.map.with_index do |choice, i|     # Notably, RatatuiRuby has no concept of
-      "\#{prefix_for(i)} \#{choice}"                             # "menus" or "radio buttons". You are in
-    end                                                        # full control, but it also means you must
-    def prefix_for(choice_index)                               # implement the logic yourself. For larger
-      return PREFIXES[:active] if choice_index == @choice      # applications, consider using Rooibos,
-      PREFIXES[:inactive]                                      # an MVU framework built with RatatuiRuby.
-    end                                                        # Or, use the upcoming ratatui-ruby-kit,
-                                                               # our object-oriented component library.
-    def initialize = @choice = 0                               # However, those are both optional, and
-  end                                                          # designed for full-screen Terminal UIs.
-                                                               # RatatuiRuby will always give you the most
-  choice = RadioMenu.new.call                                  # control, and is enough for "rich CLI
-  puts "You chose \#{choice}!"                                  # moments" like this one.
-
----
-
-=== Full App Solutions
-
-RatatuiRuby renders. For complex applications, add a framework that manages
-state and composition.
-
-==== Rooibos[https://git.sr.ht/~kerrick/rooibos] (Framework)
-
-Model-View-Update architecture. Inspired by Elm, Bubble Tea, and React +
-Redux. Your UI is a pure function of state.
-
-- Functional programming with MVU
-- Commands work off the main thread
-- Messages, not callbacks, drive updates
-
-==== {Kit}[https://sr.ht/~kerrick/ratatui_ruby/#chapter-3-the-object-path--kit] (Coming Soon)
-
-Component-based architecture. Encapsulate state, input handling, and
-rendering in reusable pieces.
-
-- OOP with stateful components
-- Separate UI state from domain logic
-- Built-in focus management & click handling
-
-Both use the same widget library and rendering engine. Pick the paradigm
-that fits your brain.
-
-
----
-
-=== Why RatatuiRuby?
-
-Ruby deserves world-class terminal user interfaces. TUI developers deserve
-a world-class language.
-
-RatatuiRuby wraps Rust's Ratatui via native extension. The Rust library
-handles rendering. Your Ruby code handles design.
-
->>>
-  "Text UIs are seeing a renaissance with many new TUI libraries popping up.
-  The Ratatui bindings have proven to be full featured and stable."
-
-  — {Mike Perham}[https://www.mikeperham.com/], creator of
-  Sidekiq[https://sidekiq.org/] and Faktory[https://contribsys.com/faktory/]
-
-==== Why Rust? Why Ruby?
-
-Rust excels at low-level rendering. Ruby excels at expressing domain logic
-and UI. RatatuiRuby puts each language where it performs best.
-
-==== Versus CharmRuby
-
-CharmRuby[https://charm-ruby.dev/] wraps Charm's Go libraries. Both projects
-give Ruby developers TUI options.
-
-[Integration]
-  CharmRuby: Two runtimes, one process.
-  RatatuiRuby: Native extension in Rust.
-[Runtime]
-  CharmRuby: Go + Ruby (competing).
-  RatatuiRuby: Ruby (Rust has no runtime).
-[Memory]
-  CharmRuby: Two uncoordinated GCs.
-  RatatuiRuby: One Garbage Collector.
-[Style]
-  CharmRuby: The Elm Architecture (TEA).
-  RatatuiRuby: TEA, OOP, or Imperative.
-
-
----
-
-=== Links
-
-[Get Started]
-  {Quickstart}[https://www.ratatui-ruby.dev/docs/v0.10/doc/getting_started/quickstart_md.html],
-  {Examples}[https://www.ratatui-ruby.dev/docs/v0.10/examples/app_cli_rich_moments/README_md.html],
-  {API Reference}[https://www.ratatui-ruby.dev/docs/v0.10/],
-  {Guides}[https://www.ratatui-ruby.dev/docs/v0.10/doc/index_md.html]
-[Ecosystem]
-  Rooibos[https://git.sr.ht/~kerrick/rooibos],
-  {Kit}[https://sr.ht/~kerrick/ratatui_ruby/#chapter-3-the-object-path--kit] (Planned),
-  {Framework}[https://sr.ht/~kerrick/ratatui_ruby/#chapter-5-the-framework] (Planned),
-  {UI Widgets}[https://sr.ht/~kerrick/ratatui_ruby/#chapter-6-licensing] (Planned)
-[Community]
-  {Discuss and Chat}[https://lists.sr.ht/~kerrick/ratatui_ruby-discuss],
-  {Announcements}[https://lists.sr.ht/~kerrick/ratatui_ruby-announce],
-  {Development}[https://lists.sr.ht/~kerrick/ratatui_ruby-devel],
-  {Bug Tracker}[https://todo.sr.ht/~kerrick/ratatui_ruby]
-[Contribute]
-  {Contributing Guide}[https://man.sr.ht/~kerrick/ratatui_ruby/contributing.md],
-  {Code of Conduct}[https://man.sr.ht/~kerrick/ratatui_ruby/code_of_conduct.md],
-  {Project History}[https://man.sr.ht/~kerrick/ratatui_ruby/history/index.md],
-  {Pull Requests}[https://lists.sr.ht/~kerrick/ratatui_ruby-devel/patches]
-
-
----
-
-[Website] https://www.ratatui-ruby.dev
-[Source] https://git.sr.ht/~kerrick/ratatui_ruby
-[RubyGems] https://rubygems.org/gems/ratatui_ruby
-[Upstream] https://ratatui.rs
-[Build Status] https://builds.sr.ht/~kerrick/ratatui_ruby
-
-© 2026 Kerrick Long · Library: LGPL-3.0-or-later · Website: CC-BY-NC-ND-4.0 · Snippets: MIT-0

data/Rakefile

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-
-require "bundler/gem_tasks"
-
-# Import all tasks from the tasks/ directory
-Dir.glob("tasks/*.rake").each { |r| import r }
-
-task default: %w[lint:fix sourcehut test lint license:new steep]

data/Steepfile

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-
-target :lib do
-  signature "sig"
-  check "lib"
-
-  # Legacy schema/ files pending migration - exclude from checking
-  # Only schema/text.rb and schema/draw.rb are loaded by the main gem
-  # See doc/contributors/v1.0.0_blockers.md
-  ignore "lib/ratatui_ruby/schema/bar_chart.rb"
-  ignore "lib/ratatui_ruby/schema/bar_chart/"
-  ignore "lib/ratatui_ruby/schema/block.rb"
-  ignore "lib/ratatui_ruby/schema/calendar.rb"
-  ignore "lib/ratatui_ruby/schema/canvas.rb"
-  ignore "lib/ratatui_ruby/schema/center.rb"
-  ignore "lib/ratatui_ruby/schema/chart.rb"
-  ignore "lib/ratatui_ruby/schema/clear.rb"
-  ignore "lib/ratatui_ruby/schema/constraint.rb"
-  ignore "lib/ratatui_ruby/schema/cursor.rb"
-  ignore "lib/ratatui_ruby/schema/gauge.rb"
-  ignore "lib/ratatui_ruby/schema/layout.rb"
-  ignore "lib/ratatui_ruby/schema/line_gauge.rb"
-  ignore "lib/ratatui_ruby/schema/list.rb"
-  ignore "lib/ratatui_ruby/schema/list_item.rb"
-  ignore "lib/ratatui_ruby/schema/overlay.rb"
-  ignore "lib/ratatui_ruby/schema/paragraph.rb"
-  ignore "lib/ratatui_ruby/schema/ratatui_logo.rb"
-  ignore "lib/ratatui_ruby/schema/ratatui_mascot.rb"
-  ignore "lib/ratatui_ruby/schema/rect.rb"
-  ignore "lib/ratatui_ruby/schema/row.rb"
-  ignore "lib/ratatui_ruby/schema/scrollbar.rb"
-  ignore "lib/ratatui_ruby/schema/shape/"
-  ignore "lib/ratatui_ruby/schema/sparkline.rb"
-  ignore "lib/ratatui_ruby/schema/style.rb"
-  ignore "lib/ratatui_ruby/schema/table.rb"
-  ignore "lib/ratatui_ruby/schema/tabs.rb"
-
-  # ClassMethods mixin pattern cannot be typed in RBS
-  # (self in ClassMethods refers to the including Class)
-  ignore "lib/ratatui_ruby/widgets/coerceable_widget.rb"
-
-  library "pathname"
-  library "fileutils"
-  library "minitest"
-  library "date"
-  library "timeout"
-end