rooibos 0.6.2 → 0.7.0

data/examples/verify_readme_usage/app.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: MIT-0
-#++
-
-$LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
-
-require "ratatui_ruby"
-require "rooibos"
-
-class VerifyReadmeUsage
-  # [SYNC:START:mvu]
-  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:mvu]
-end
-
-VerifyReadmeUsage.new.run if __FILE__ == $PROGRAM_NAME

data/examples/verify_website_first_app/app.rb

@@ -1,85 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: MIT-0
-#++
-
-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
-  }
-
-  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) if __FILE__ == $0

data/examples/verify_website_hello_mvu/app.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: MIT-0
-#++
-
-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) if __FILE__ == $0

data/examples/widget_command_system/README.md

@@ -1,70 +0,0 @@
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-  SPDX-License-Identifier: CC-BY-SA-4.0
--->
-# Cmd.exec Example
-
-Demonstrates running shell commands using `Cmd.exec`.
-
-Commands in TEA produce **messages**, not callbacks. When a command completes, the runtime sends a tagged tuple to your `update` function. Pattern match on the tag to handle success and failure.
-
-## Key Concepts
-
-- **Message Tags:** `Cmd.exec(command, tag)` produces `[tag, {stdout:, stderr:, status:}]`.
-- **Non-Blocking:** Commands run in background threads. The UI remains responsive.
-- **Success Handling:** Match on `status: 0` to handle successful execution.
-- **Error Handling:** Match on non-zero status to handle failures.
-- **Ractor-Safe:** No callbacks means no Proc captures. Messages are shareable.
-
-## Hotkeys
-
-- `d`: Run `ls -la` (directory listing)
-- `u`: Run `uname -a` (system info)
-- `f`: Run a command that fails (demonstrates error handling)
-- `q`: **Quit**
-
-## Usage
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```bash
-ruby examples/widget_cmd_exec/app.rb
-```
-<!-- SPDX-SnippetEnd -->
-
-## How It Works
-
-The update function handles both key presses and command results:
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```ruby
-UPDATE = -> (msg, model) do
-  case msg
-  # Handle command results
-  in [:got_output, {stdout:, status: 0}]
-    [model.with(result: stdout.strip, loading: false), nil]
-  in [:got_output, {stderr:, status:}]
-    [model.with(result: "Error (exit #{status}): #{stderr.strip}", loading: false), nil]
-
-  # Handle key presses
-  in _ if msg.d?
-    [model.with(loading: true), Cmd.exec("ls -la", :got_output)]
-  else
-    model
-  end
-end
-```
-<!-- SPDX-SnippetEnd -->
-
-All logic stays in `update`. The command just runs and produces a message.
-
-[Read the source code →](app.rb)
-
-[![widget_cmd_exec](../../doc/images/widget_cmd_exec.png)](app.rb)

data/examples/widget_command_system/app.rb

@@ -1,134 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: MIT-0
-#++
-
-$LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
-
-require "ratatui_ruby"
-require "rooibos"
-
-# Demonstrates the Command.execute command for running shell commands.
-#
-# This example shows how to execute shell commands and handle both success
-# and failure cases using pattern matching in update. The split layout shows
-# command output in the main area with controls at the bottom.
-#
-# === Examples
-#
-# Run the demo from the terminal:
-#
-#   ruby examples/widget_cmd_exec/app.rb
-#
-# rdoc-image:/doc/images/widget_cmd_exec.png
-class WidgetCommandSystem
-  Model = Data.define(:result, :loading, :last_command)
-  Init = -> {
-    Model.new(
-      result: "Press a key to run a command...",
-      loading: false,
-      last_command: nil
-    )
-  }
-
-  View = -> (model, tui) do
-    hotkey_style = tui.style(modifiers: [:bold, :underlined])
-    dim_style = tui.style(fg: :dark_gray)
-
-    # Styles
-    border_color = if model.loading
-      "yellow"
-    elsif model.result.start_with?("Error")
-      "red"
-    else
-      "cyan"
-    end
-
-    title = model.last_command ? "Output: #{model.last_command}" : "Command.execute Demo"
-    content_text = model.loading ? "Running command..." : model.result
-
-    # 1. Main Output Widget
-    output_widget = tui.paragraph(
-      text: content_text,
-      block: tui.block(
-        title:,
-        borders: [:all],
-        border_style: { fg: border_color },
-        padding: 1
-      )
-    )
-
-    # 2. Control Panel Widget
-    control_widget = tui.paragraph(
-      text: [
-        tui.text_line(spans: [
-          tui.text_span(content: "d", style: hotkey_style),
-          tui.text_span(content: ": Directory listing (ls -la)  "),
-          tui.text_span(content: "u", style: hotkey_style),
-          tui.text_span(content: ": System info (uname -a)"),
-        ]),
-        tui.text_line(spans: [
-          tui.text_span(content: "f", style: hotkey_style),
-          tui.text_span(content: ": Force failure  "),
-          tui.text_span(content: "s", style: hotkey_style),
-          tui.text_span(content: ": Sleep (3s)  "),
-          tui.text_span(content: "q", style: hotkey_style),
-          tui.text_span(content: ": Quit"),
-        ]),
-      ],
-      block: tui.block(
-        title: "Controls",
-        borders: [:all],
-        border_style: dim_style
-      )
-    )
-
-    # Return the Root Layout Widget (Blueprint)
-    tui.layout(
-      direction: :vertical,
-      constraints: [
-        tui.constraint_fill(1),
-        tui.constraint_length(6),
-      ],
-      children: [
-        output_widget,
-        control_widget,
-      ]
-    )
-  end
-
-  Update = -> (message, model) do
-    case message
-    # Handle command results (hash-based pattern matching)
-    in { type: :system, envelope: :got_output, stdout:, status: 0 }
-      [model.with(result: stdout.strip.freeze, loading: false), nil]
-    in { type: :system, envelope: :got_output, stderr:, status: }
-      [model.with(result: "Error (exit #{status}): #{stderr.strip}".freeze, loading: false), nil]
-
-    # Handle key presses
-    in _ if message.q? || message.ctrl_c?
-      Rooibos::Command.exit
-    in _ if message.d?
-      [model.with(loading: true, last_command: "ls -la"), Rooibos::Command.system("ls -la", :got_output)]
-    in _ if message.u?
-      [model.with(loading: true, last_command: "uname -a"), Rooibos::Command.system("uname -a", :got_output)]
-    in _ if message.s?
-      cmd = "sleep 3 && echo 'Slept for 3s'"
-      [model.with(loading: true, last_command: cmd.freeze), Rooibos::Command.system(cmd, :got_output)]
-    in _ if message.f?
-      # Intentional failure to demonstrate error handling
-      cmd = "ls /nonexistent_path_12345"
-      [model.with(loading: true, last_command: cmd.freeze), Rooibos::Command.system(cmd, :got_output)]
-    else
-      model
-    end
-  end
-
-  def run
-    Rooibos.run(WidgetCommandSystem)
-  end
-end
-
-WidgetCommandSystem.new.run if __FILE__ == $PROGRAM_NAME

data/generate_tutorial_stubs.rb

@@ -1,126 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "fileutils"
-
-# Parse tutorial structure from documentation_plan.md
-TUTORIAL_FILES = {
-  "index.md" => { title: "Tutorial: Build a File Browser", story: nil },
-  "01_project_setup.md" => { title: "Project Setup", story: "-4" },
-  "02_hello_world.md" => { title: "Hello World", story: "-3" },
-  "03_static_file_list.md" => { title: "Static File List", story: "-2" },
-  "04_arrow_navigation.md" => { title: "Arrow Navigation", story: "-1" },
-  "05_real_files.md" => { title: "Real Files", story: "0" },
-  "06_safe_refactoring.md" => { title: "Safe Refactoring", story: "4a" },
-  "07_red_first_tdd.md" => { title: "Red-First TDD", story: "4b" },
-  "08_file_metadata.md" => { title: "File Metadata", story: "5" },
-  "09_text_preview.md" => { title: "Text Preview", story: "6" },
-  "10_directory_tree.md" => { title: "Directory Tree", story: "7" },
-  "11_pane_focus.md" => { title: "Pane Focus", story: "8" },
-  "12_sorting.md" => { title: "Sorting", story: "9" },
-  "13_filtering.md" => { title: "Filtering", story: "10" },
-  "14_toggle_hidden.md" => { title: "Toggle Hidden Files", story: "11" },
-  "15_text_input_widget.md" => { title: "Text Input Widget", story: "12" },
-  "16_rename_files.md" => { title: "Rename Files", story: "13" },
-  "17_confirmation_dialogs.md" => { title: "Confirmation Dialogs", story: "14" },
-  "18_progress_indicators.md" => { title: "Progress Indicators", story: "15" },
-  "19_atomic_operations.md" => { title: "Atomic Operations", story: "16" },
-  "20_external_editor.md" => { title: "External Editor", story: "17" },
-  "21_modal_overlays.md" => { title: "Modal Overlays", story: "18" },
-  "22_error_handling.md" => { title: "Error Handling", story: "19" },
-  "23_terminal_capabilities.md" => { title: "Terminal Capabilities", story: "23" },
-  "24_mouse_events.md" => { title: "Mouse Events", story: "20" },
-  "25_resize_events.md" => { title: "Resize Events", story: "21" },
-  "26_loading_states.md" => { title: "Loading States", story: "22" },
-  "27_performance.md" => { title: "Performance", story: "24" },
-  "28_color_schemes.md" => { title: "Color Schemes", story: "26" },
-  "29_configuration.md" => { title: "Configuration", story: "27" },
-  "30_going_further.md" => { title: "Going Further", story: nil },
-}
-
-# Parse stories from file_browser_stories.md
-stories_content = File.read("doc/contributors/specs/file_browser_stories.md")
-
-# Extract each story
-stories = {}
-current_story = nil
-current_content = []
-
-stories_content.each_line do |line|
-  if line =~ /^## Story (-?\d+[ab]?): (.+)$/
-    # Save previous story
-    if current_story
-      stories[current_story] = current_content.join
-    end
-
-    current_story = $1
-    current_content = [line]
-  elsif current_story
-    current_content << line
-
-    # Stop at the next story or end of stories section
-    if line =~ /^---$/ && current_content.size > 5
-      # Check if next section is another story or implementation notes
-      peek_ahead = stories_content.lines[stories_content.lines.index(line) + 1]
-      if peek_ahead && !peek_ahead.start_with?("## Story")
-        stories[current_story] = current_content.join
-        break if peek_ahead.start_with?("## Implementation Notes")
-      end
-    end
-  end
-end
-
-# Save last story
-stories[current_story] = current_content.join if current_story
-
-# Create tutorial directory
-FileUtils.mkdir_p("doc/tutorial")
-
-# Generate stub files
-TUTORIAL_FILES.each do |filename, meta|
-  filepath = "doc/tutorial/#{filename}"
-
-  # Determine previous/next files
-  files_list = TUTORIAL_FILES.keys
-  current_index = files_list.index(filename)
-  prev_file = (current_index > 0) ? files_list[current_index - 1] : nil
-  next_file = (current_index < files_list.size - 1) ? files_list[current_index + 1] : nil
-
-  prev_title = prev_file ? TUTORIAL_FILES[prev_file][:title] : nil
-  next_title = next_file ? TUTORIAL_FILES[next_file][:title] : nil
-
-  # Get story content if applicable
-  story_section = ""
-  if meta[:story]
-    story_key = meta[:story]
-    if stories[story_key]
-      story_section = "\n## User Stories\n\n#{stories[story_key]}\n"
-    end
-  end
-
-  # Generate stub content
-  content = <<~MARKDOWN
-    <!--
-      SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-      SPDX-License-Identifier: CC-BY-SA-4.0
-    -->
-
-    # #{meta[:title]}
-
-
-    By the end of this guide, you will:
-
-    - TODO: Write learning objectives
-
-    > ⚠️ **This page is a stub.** Help us write it! See the [Documentation Plan](../contributors/documentation_plan.md) and [Style Guide](../contributors/documentation_style.md).
-    #{story_section}
-    ---
-
-    #{prev_file ? "[**Previous:** #{prev_title}](./#{prev_file})" : ''} | #{next_file ? "[**Next:** #{next_title}](./#{next_file})" : ''}
-  MARKDOWN
-
-  File.write(filepath, content)
-  puts "Created #{filepath}"
-end
-
-puts "\nDone! Created #{TUTORIAL_FILES.size} tutorial stub files."

data/mise.toml

@@ -1,8 +0,0 @@
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: LGPL-3.0-or-later
-
-[tools]
-ruby = "4.0.1"
-rust = "1.91.1"
-python = "3.12"
-pre-commit = "latest"

data/rbs_collection.lock.yaml

@@ -1,108 +0,0 @@
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later
-
----
-path: ".gem_rbs_collection"
-gems:
-- name: base64
-  version: 0.3.0
-  source:
-    type: rubygems
-- name: bigdecimal
-  version: '0'
-  source:
-    type: stdlib
-- name: csv
-  version: '0'
-  source:
-    type: stdlib
-- name: ffi
-  version: 1.17.3
-  source:
-    type: rubygems
-- name: fileutils
-  version: '0'
-  source:
-    type: stdlib
-- name: forwardable
-  version: '0'
-  source:
-    type: stdlib
-- name: io-console
-  version: '0'
-  source:
-    type: stdlib
-- name: json
-  version: '0'
-  source:
-    type: stdlib
-- name: logger
-  version: '0'
-  source:
-    type: stdlib
-- name: minitest
-  version: '0'
-  source:
-    type: stdlib
-- name: monitor
-  version: '0'
-  source:
-    type: stdlib
-- name: mutex_m
-  version: 0.3.0
-  source:
-    type: rubygems
-- name: optparse
-  version: '0'
-  source:
-    type: stdlib
-- name: pp
-  version: '0'
-  source:
-    type: stdlib
-- name: prettyprint
-  version: '0'
-  source:
-    type: stdlib
-- name: prism
-  version: 1.8.0
-  source:
-    type: rubygems
-- name: ratatui_ruby
-  version: 1.1.0
-  source:
-    type: rubygems
-- name: ratatui_ruby-devtools
-  version: 0.1.0
-  source:
-    type: rubygems
-- name: rbs
-  version: 3.10.2
-  source:
-    type: rubygems
-- name: rdoc
-  version: '0'
-  source:
-    type: stdlib
-- name: securerandom
-  version: '0'
-  source:
-    type: stdlib
-- name: stringio
-  version: '0'
-  source:
-    type: stdlib
-- name: strscan
-  version: '0'
-  source:
-    type: stdlib
-- name: tsort
-  version: '0'
-  source:
-    type: stdlib
-- name: uri
-  version: '0'
-  source:
-    type: stdlib
-gemfile_lock_path: Gemfile.lock

data/rbs_collection.yaml

@@ -1,15 +0,0 @@
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later
-
-# RBS collection configuration
-# See: https://github.com/ruby/rbs/blob/master/docs/collection.md
-
-sources:
-  - type: stdlib
-  - type: rubygems
-
-path: .gem_rbs_collection
-
-gems:
-  - name: ratatui_ruby