rooibos 0.6.2 → 0.7.0

data/README.md

@@ -1,183 +0,0 @@
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-  SPDX-License-Identifier: CC-BY-SA-4.0
--->
-# rooibos
-
-[![
-builds.sr.ht status](https://builds.sr.ht/~kerrick/rooibos.svg)](https://builds.sr.ht/~kerrick/rooibos?) [![
-License](https://img.shields.io/badge/dynamic/regex?url=https%3A%2F%2Fgit.sr.ht%2F~kerrick%2Frooibos%2Fblob%2Fstable%2Frooibos.gemspec&search=spec%5C.license%20%3D%20%22(.*)%22&replace=%241&label=License&color=a2c93e)](https://spdx.org/licenses/LGPL-3.0-or-later.html) [![
-Gem Total Downloads](https://img.shields.io/gem/dt/rooibos)](https://rubygems.org/gems/rooibos) [![
-Gem Version](https://img.shields.io/gem/v/rooibos)](https://rubygems.org/gems/rooibos) [![
-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
-
-**rooibos** is a gem in the [RatatuiRuby ecosystem](https://sr.ht/~kerrick/ratatui_ruby/).
-**ratatui_ruby** is a community wrapper that is not affiliated with [the Ratatui team](https://github.com/orgs/ratatui/people).
-
-> [!WARNING]
-> **rooibos** is currently in **BETA**. The API may change with minor versions.
-
-**[Why RatatuiRuby?](https://man.sr.ht/~kerrick/ratatui_ruby/why.md)** — Native Rust performance, zero runtime overhead, and Ruby's expressiveness. [See how we compare](https://man.sr.ht/~kerrick/ratatui_ruby/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/rooibos/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/rooibos) • **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
-
-**rooibos** 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: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```ruby
-gem "rooibos"
-```
-<!-- SPDX-SnippetEnd -->
-
-And then execute:
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```bash
-bundle install
-```
-<!-- SPDX-SnippetEnd -->
-
-Or install it yourself with:
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```bash
-gem install rooibos
-```
-<!-- SPDX-SnippetEnd -->
-
-
-## Usage
-
-**rooibos** uses the Model-View-Update (MVU) pattern. You provide an immutable model, a view function, and an update function.
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-<!-- SYNC:START:examples/verify_readme_usage/app.rb:mvu -->
-```ruby
-Model = Data.define(:text)
-
-Init = -> do
-  Model.new(text: "Hello, Ratatui! Press 'q' to quit.")
-end
-
-View = -> (model, tui) do
-  tui.paragraph(
-    text: model.text,
-    alignment: :center,
-    block: tui.block(
-      title: "My Ruby TUI App",
-      borders: [:all],
-      border_style: { fg: "cyan" }
-    )
-  )
-end
-
-Update = -> (msg, model) do
-  if msg.q? || msg.ctrl_c?
-    Rooibos::Command.exit
-  else
-    model
-  end
-end
-
-def run
-  Rooibos.run(VerifyReadmeUsage)
-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
-
-_Because this gem is in alpha, it lacks documentation. Please check the source files._
-
-
-## Documentation
-
-| Resource | Description |
-|----------|-------------|
-| [Quickstart](./doc/getting_started/quickstart.md) | Get running in 5 minutes |
-| [Application Architecture](./doc/concepts/application_architecture.md) | Patterns for scaling your app |
-| [Guides](./doc/index.md) | Tutorials, examples, and more |
-| API Reference | To generate full RDoc documentation, run `bundle exec rake rdoc` |
-| [Wiki](https://man.sr.ht/~kerrick/ratatui_ruby) | Learn more about the RatatuiRuby ecosystem |
-
-
-## 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).
-
-
-Want to help develop **rooibos**? 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
-
-**rooibos** is copyright 2026, 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 **rooibos** 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 [LGPL-3.0-or-later](./LICENSES/LGPL-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,374 +0,0 @@
-== Confidently Build Terminal Apps
-
-Rooibos[https://rooibos.run] helps you build interactive terminal applications.
-Keep your code understandable and testable as it scales. Rooibos handles
-keyboard, mouse, and async work so you can focus on behavior and user experience.
-
-  gem install rooibos
-
-<i>Currently in beta. APIs may change before 1.0.</i>
-
-=== Get Started in Seconds
-
-  rooibos new my_app
-  cd my_app
-  rooibos run
-
-That's it. You have a working app with keyboard navigation, mouse support,
-and clickable buttons. Open <tt>lib/my_app.rb</tt> to make it your own.
-
-
----
-
-=== The Pattern
-
-\Rooibos uses Model-View-Update, the architecture behind
-Elm[https://guide.elm-lang.org/architecture/],
-Redux[https://redux.js.org/], and {Bubble
-Tea}[https://github.com/charmbracelet/bubbletea].
-State lives in one place. Updates flow in one direction. The runtime handles
-rendering and runs background work for you.
-
----
-
-=== Hello, MVU
-
-The simplest \Rooibos app. Press any key to increment the counter. Press
-<tt>Ctrl</tt>+<tt>C</tt> to quit.
-
-  require "rooibos"
-
-  module Counter
-    # Init: How do you create the initial model?
-    Init = -> { 0 }
- 
-    # View: What does the user see?
-    View = -> (model, tui) { tui.paragraph(text: <<~END) }
-      Current count: #{model}.
-      Press any key to increment.
-      Press Ctrl+C to quit.
-    END
- 
-    # Update: What happens when things change?
-    Update = -> (message, model) {
-      if message.ctrl_c?
-        Rooibos::Command.exit
-      elsif message.key?
-        model + 1
-      end
-    }
-  end
-
-  Rooibos.run(Counter)
-
-That's the whole pattern: Model holds state, Init creates it, View renders it,
-and Update changes it. The runtime handles everything else.
-
-
----
-
-=== Your First Real Application
-
-A file browser in sixty lines. It opens files, navigates directories, handles
-errors, styles directories and hidden files differently, and supports vim-style
-keyboard shortcuts. If you can do this much with this little code, imagine how
-easy _your_ app will be to build.
-
-  require "rooibos"
-  
-  module FileBrowser
-    # Model: What state does your app need?
-    Model = Data.define(:path, :entries, :selected, :error)
-  
-    Init = -> {
-      path    = Dir.pwd
-      entries = Entries[path]
-      Ractor.make_shareable( # Ensures thread safety
-        Model.new(path:, entries:, selected: entries.first, error: nil))
-    }
-  
-    View = -> (model, tui) {
-      tui.block(
-        titles: [model.error || model.path,
-                 { content: KEYS, position: :bottom, alignment: :right}],
-        borders: [:all],
-        border_style: if model.error then tui.style(fg: :red) else nil end,
-        children: [tui.list(items: model.entries.map(&ListItem[model, tui]),
-                            selected_index: model.entries.index(model.selected),
-                            highlight_symbol: "",
-                            highlight_style: tui.style(modifiers: [:reversed]))]
-      )
-    }
-  
-    Update = -> (message, model) {
-      return model.with(error: ERROR) if message.error?
-      model = model.with(error: nil) if model.error && message.key?
-  
-      if message.ctrl_c? || message.q? then Rooibos::Command.exit
-      elsif message.home? || message.g? then model.with(selected: model.entries.first)
-      elsif message.end? || message.G? then model.with(selected: model.entries.last)
-      elsif message.up_arrow? || message.k? then Select[:-, model]
-      elsif message.down_arrow? || message.j? then Select[:+, model]
-      elsif message.enter? then Open[model]
-      elsif message.escape? then Navigate[File.dirname(model.path), model]
-      end
-    }
-  
-    private # Lines below this are implementation details
-  
-    KEYS  = "↑/↓/Home/End: Select | Enter: Open | Esc: Navigate Up | q: Quit"
-    ERROR = "Sorry, opening the selected file failed."
-  
-    ListItem = -> (model, tui) { -> (name) {
-      modifiers = name.start_with?(".") ? [:dim] : []
-      fg        = :blue if name.end_with?("/")
-      tui.list_item(content: name, style: tui.style(fg:, modifiers:))
-    } }
-  
-    Select = -> (operator, model) {
-      new_index = model.entries.index(model.selected).public_send(operator, 1)
-      model.with(selected: model.entries[new_index.clamp(0, model.entries.length - 1)])
-    }
-  
-    Open = -> (model) {
-      full = File.join(model.path, model.selected.delete_suffix("/"))
-      model.selected.end_with?("/") ? Navigate[full, model] : Rooibos::Command.open(full)
-    }
-  
-    Navigate = -> (path, model) {
-      entries = Entries[path]
-      model.with(path:, entries:, selected: entries.first, error: nil)
-    }
-  
-    Entries = -> (path) {
-      Dir.children(path).map { |name|
-        File.directory?(File.join(path, name)) ? "#{name}/" : name
-      }.sort_by { |name| [name.end_with?("/") ? 0 : 1, name.downcase] }
-    }
-  end
-
-  Rooibos.run(FileBrowser)
-
-
----
-
-=== Batteries Included
-
-==== Commands
-
-Applications fetch data, run shell commands, and set timers. \Rooibos Commands
-run off the main thread and send results back as messages.
-
-<b>HTTP requests:</b>
-
-  Update = -> (message, model) {
-    case message
-    in :fetch_users
-      [model.with(loading: true), Rooibos::Command.http(:get, "/api/users", :got_users)]
-    in { type: :http, envelope: :got_users, status: 200, body: }
-      model.with(loading: false, users: JSON.parse(body))
-    in { type: :http, envelope: :got_users, status: }
-      model.with(error: "HTTP #{status}")
-    end
-  }
-
-<b>Shell commands:</b>
-
-  Update = -> (message, model) {
-    case message
-    in :list_files
-      Rooibos::Command.system("ls -la", :listed_files)
-    in { type: :system, envelope: :listed_files, stdout:, status: 0 }
-      model.with(files: stdout.lines.map(&:chomp))
-    in { type: :system, envelope: :listed_files, stderr:, status: }
-      model.with(error: stderr)
-    end
-  }
-
-<b>Timers:</b>
-
-  Update = -> (message, model) {
-    case message
-    in { type: :timer, envelope: :tick, elapsed: }
-      [model.with(frame: model.frame + 1), Rooibos::Command.wait(1.0 / 24, :tick)]
-    end
-  }
-
-<b>And more!</b> \Rooibos includes <tt>all</tt>, <tt>batch</tt>, <tt>cancel</tt>,
-<tt>custom</tt>, <tt>exit</tt>, <tt>http</tt>, <tt>map</tt>, <tt>open</tt>,
-<tt>system</tt>, <tt>tick</tt>, and <tt>wait</tt> commands.  You can also define
-your own custom commands for complex orchestration. 
-
-Every command produces a message, and Update handles it the same way.
-
-==== Testing
-
-\Rooibos makes TUIs so easy to test, you'll save more time by writing tests than
-by not testing.
-
-<b>Unit test Update, View, and Init.</b> No terminal needed. Test helpers included.
-
-  def test_moves_selection_down_with_j
-    model = Ractor.make_shareable(FileBrowser::Model.new(
-      path: "/", entries: %w[bin exe lib], selected: "bin", error: nil))
-    message = RatatuiRuby::Event::Key.new(code: "j")
-
-    result = FileBrowser::Update.call(message, model)
-
-    assert_equal "exe", result.selected
-  end
-
-<b>Style assertions.</b> Draw to a headless terminal, verify colors and modifiers.
-
-  def test_directories_are_blue
-    with_test_terminal(60, 10) do
-      model = Ractor.make_shareable(FileBrowser::Model.new(
-        path: "/", entries: %w[file.txt subdir/], selected: "file.txt", error: nil))
-      widget = FileBrowser::View.call(model, RatatuiRuby::TUI.new)
-
-      RatatuiRuby.draw { |frame| frame.render_widget(widget, frame.area) }
-
-      assert_blue(1, 2) # "subdir/" at column 1, row 2
-    end
-  end
-
-<b>System tests.</b> Inject events, run the full app, snapshot the result.
-
-  def test_selection_moves_down
-    with_test_terminal(120, 30) do
-      Dir.mktmpdir do |dir|
-        FileUtils.touch(File.join(dir, "a"))
-        FileUtils.touch(File.join(dir, "b"))
-        FileUtils.touch(File.join(dir, "c"))
-
-        inject_key(:down)
-        inject_key(:ctrl_c)
-
-        # Tests use explicit params to inject deterministic initial state.
-        Rooibos.run(
-          model: Ractor.make_shareable(FileBrowser::Model.new(
-            path: dir, entries: %w[a b c], selected: "a", error: nil)),
-          view: FileBrowser::View,
-          update: FileBrowser::Update
-        )
-
-        assert_snapshots("selection_moved_down") do |lines|
-          title = "┌/tmp/test#{'─' * 107}┐"
-          lines.map do |l|
-            l.gsub(/┌#{Regexp.escape(dir)}[^┐]*┐/, title)
-          end
-        end
-      end
-    end
-  end
-
-Snapshots record both plain text and ANSI colors. Normalization blocks mask
-dynamic content (timestamps, temp paths) for cross-platform reproducibility.
-Run <tt>UPDATE_SNAPSHOTS=1 rake test</tt> to regenerate baselines.
-
-==== Scale Up
-
-Large applications decompose into fragments. Each fragment has its own Model,
-View, Update, and Init. Parents compose children. The pattern scales.
-
-The Router DSL eliminates boilerplate:
-
-  module Dashboard
-    include Rooibos::Router
-
-    route :stats, to: StatsPanel
-    route :network, to: NetworkPanel
-
-    keymap do
-      key :ctrl_c, -> { Rooibos::Command.exit }
-      only when: -> (model) { !model.modal_open } do
-        key :q, -> { Rooibos::Command.exit }
-        key :s, -> { StatsPanel.fetch_command }
-        key :p, -> { NetworkPanel.ping_command }
-      end
-    end
-
-    Update = from_router
-
-    # ... Model, Init, View below
-  end
-
-Declare routes and keymaps. The router generates Update for you. Use guards to
-ignore keys when needed.
-
-==== CLI
-
-The <tt>rooibos</tt> command scaffolds projects and runs applications.
-
-  rooibos new my_app    # Generate project structure
-  rooibos run           # Run the app in current directory
-
-Generated apps include tests, type signatures, and a working welcome
-screen with keyboard and mouse support.
-
-
----
-
-=== The Ecosystem
-
-\Rooibos builds on RatatuiRuby[https://www.ratatui-ruby.dev], a Rubygem built on
-Ratatui[https://ratatui.rs]. You get native performance with the joy of Ruby.
-\Rooibos is one way to manage state and composition. Kit is another.
-
-==== Rooibos[https://git.sr.ht/~kerrick/rooibos]
-
-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.
-
-
----
-
-=== Links
-
-[Get Started]
-  {Getting Started}[https://git.sr.ht/~kerrick/rooibos/tree/trunk/item/doc/getting_started/index.md],
-  {Tutorial}[https://git.sr.ht/~kerrick/rooibos/tree/trunk/item/doc/tutorial/index.md],
-  {Examples}[https://git.sr.ht/~kerrick/rooibos/tree/trunk/item/examples]
-
-[Coming From...]
-  {React/Redux}[https://git.sr.ht/~kerrick/rooibos/tree/trunk/item/doc/getting_started/for_react_developers.md],
-  {BubbleTea}[https://git.sr.ht/~kerrick/rooibos/tree/trunk/item/doc/getting_started/for_go_developers.md],
-  {Textual}[https://git.sr.ht/~kerrick/rooibos/tree/trunk/item/doc/getting_started/for_python_developers.md]
-
-[Learn More]
-  {Essentials}[https://git.sr.ht/~kerrick/rooibos/tree/trunk/item/doc/essentials/index.md],
-  {Scaling Up}[https://git.sr.ht/~kerrick/rooibos/tree/trunk/item/doc/scaling_up/index.md],
-  {Best Practices}[https://git.sr.ht/~kerrick/rooibos/tree/trunk/item/doc/best_practices/index.md],
-  {Troubleshooting}[https://git.sr.ht/~kerrick/rooibos/tree/trunk/item/doc/troubleshooting/index.md]
-
-[Community]
-  {Discuss}[https://lists.sr.ht/~kerrick/ratatui_ruby-discuss],
-  {Announcements}[https://lists.sr.ht/~kerrick/ratatui_ruby-announce],
-  {Bug Tracker}[https://todo.sr.ht/~kerrick/ratatui_ruby],
-  {Contribution Guide}[https://man.sr.ht/~kerrick/ratatui_ruby/contributing.md],
-  {Code of Conduct}[https://man.sr.ht/~kerrick/ratatui_ruby/code_of_conduct.md]
-
-
----
-
-[Website] https://rooibos.run
-[Source] https://git.sr.ht/~kerrick/rooibos
-[RubyGems] https://rubygems.org/gems/rooibos
-
-© 2026 Kerrick Long · Library: LGPL-3.0-or-later · Website: CC-BY-NC-ND-4.0 · Snippets: MIT-0

data/Rakefile

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: LGPL-3.0-or-later
-#++
-
-require "bundler/gem_tasks"
-require "ratatui_ruby/devtools"
-
-RatatuiRuby::Devtools.install!
-
-# Import project-specific tasks
-Dir.glob("tasks/*.rake").each { |r| import r }
-
-task default: %w[lint:fix install:force test lint reuse steep]

data/Steepfile

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: LGPL-3.0-or-later
-
-target :lib do
-  signature "sig"
-  check "lib"
-
-  library "open3"
-
-  collection_config "rbs_collection.yaml"
-end

data/doc/best_practices/forms_and_validation.md

@@ -1,20 +0,0 @@
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-  SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
-# Forms and Validation
-
-
-By the end of this guide, you will:
-
-- Collect multi-field user input in your Model
-- Validate input and store error messages
-- Display inline validation feedback
-- Submit form data via Commands
-
-> ⚠️ **This page is a stub.** Help us write it! See the [Documentation Plan](../contributors/documentation_plan.md) and [Style Guide](../contributors/documentation_style.md).
-
----
-
-**Best Practices:** [Modal Dialogs](./modal_dialogs.md) | [Lists and Tables](./lists_and_tables.md) | [HTTP Workflows](./http_workflows.md) | [Streaming Data](./streaming_data.md) | [Orchestration](./orchestration.md)

data/doc/best_practices/http_workflows.md

@@ -1,20 +0,0 @@
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-  SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
-# HTTP Workflows
-
-
-By the end of this guide, you will:
-
-- Model loading/success/error states for HTTP requests
-- Implement retry logic with exponential backoff
-- Cache responses to avoid redundant fetches
-- Handle offline/error states gracefully
-
-> ⚠️ **This page is a stub.** Help us write it! See the [Documentation Plan](../contributors/documentation_plan.md) and [Style Guide](../contributors/documentation_style.md).
-
----
-
-**Best Practices:** [Modal Dialogs](./modal_dialogs.md) | [Forms and Validation](./forms_and_validation.md) | [Lists and Tables](./lists_and_tables.md) | [Streaming Data](./streaming_data.md) | [Orchestration](./orchestration.md)

data/doc/best_practices/index.md

@@ -1,26 +0,0 @@
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-  SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
-# Best Practices
-
-Common UI patterns and recipes for Rooibos applications.
-
----
-
-## UI Patterns
-
-- [**Modal Dialogs**](./modal_dialogs.md) — Overlays, focus capture, result routing
-- [**Forms and Validation**](./forms_and_validation.md) — Multi-field input, error display
-- [**Lists and Tables**](./lists_and_tables.md) — Scrolling, selection, pagination
-
-## Data Patterns
-
-- [**HTTP Workflows**](./http_workflows.md) — Loading states, retries, caching
-- [**Streaming Data**](./streaming_data.md) — SSE, websockets, incremental updates
-- [**Orchestration**](./orchestration.md) — Parallel commands, sequential flows
-
----
-
-**Having trouble?** Check out [Troubleshooting](../troubleshooting/common_errors.md).

data/doc/best_practices/lists_and_tables.md

@@ -1,20 +0,0 @@
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-  SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
-# Lists and Tables
-
-
-By the end of this guide, you will:
-
-- Implement keyboard-navigable scrolling lists
-- Track selection state in your Model
-- Support pagination for large datasets
-- Link to RatatuiRuby List and Table widgets
-
-> ⚠️ **This page is a stub.** Help us write it! See the [Documentation Plan](../contributors/documentation_plan.md) and [Style Guide](../contributors/documentation_style.md).
-
----
-
-**Best Practices:** [Modal Dialogs](./modal_dialogs.md) | [Forms and Validation](./forms_and_validation.md) | [HTTP Workflows](./http_workflows.md) | [Streaming Data](./streaming_data.md) | [Orchestration](./orchestration.md)