rooibos 0.6.2 → 0.7.0

data/examples/app_fractal_dashboard/fragments/disk_usage.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: MIT-0
-#++
-
-require "rooibos"
-# Fetches and displays disk usage via +df -h+.
-# A fragment for fetching and displaying disk usage.
-module DiskUsage
-  Command = Rooibos::Command
-
-  Model = Data.define(:output, :loading)
-
-  Init = -> do
-    Model.new(output: "Press 'd' for disk usage", loading: false)
-  end
-
-  View = -> (model, tui, disabled: false) do
-    text_style = if disabled && model.output == Init.().output
-      tui.style(fg: :dark_gray)
-    else
-      nil
-    end
-
-    tui.paragraph(
-      text: tui.text_span(content: model.output, style: text_style),
-      block: tui.block(title: "Disk Usage", borders: [:all], border_style: { fg: :cyan })
-    )
-  end
-
-  Update = -> (message, model) do
-    case message
-    in { type: :system, envelope: :disk_usage, status: 0, stdout: }
-      [model.with(output: Ractor.make_shareable(stdout.strip), loading: false), nil]
-    in { type: :system, envelope: :disk_usage, stderr: }
-      [model.with(output: Ractor.make_shareable("Error: #{stderr.strip}"), loading: false), nil]
-    else
-      [model, nil]
-    end
-  end
-
-  def self.fetch_command
-    Command.system("df -h /", :disk_usage)
-  end
-end

data/examples/app_fractal_dashboard/fragments/network_panel.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: MIT-0
-#++
-
-require "rooibos"
-require_relative "ping"
-require_relative "uptime"
-
-# Composes Ping and Uptime in a horizontal layout.
-module NetworkPanel
-  Model = Data.define(:ping, :uptime)
-
-  Init = -> do
-    ping, = Rooibos.normalize_init(Ping::Init.())
-    uptime, = Rooibos.normalize_init(Uptime::Init.())
-    Model.new(ping:, uptime:)
-  end
-
-  View = -> (model, tui, disabled: false) do
-    tui.layout(
-      direction: :horizontal,
-      constraints: [tui.constraint_percentage(50), tui.constraint_percentage(50)],
-      children: [
-        Ping::View.call(model.ping, tui, disabled:),
-        Uptime::View.call(model.uptime, tui, disabled:),
-      ]
-    )
-  end
-
-  Update = -> (message, model) do
-    case message
-    in { envelope: :ping, ** }
-      new_child, command = Ping::Update.call(message, model.ping)
-      [model.with(ping: new_child), command]
-    in { envelope: :uptime, ** }
-      new_child, command = Uptime::Update.call(message, model.uptime)
-      [model.with(uptime: new_child), command]
-    else
-      [model, nil]
-    end
-  end
-end

data/examples/app_fractal_dashboard/fragments/ping.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: MIT-0
-#++
-
-require "rooibos"
-# Pings localhost to check network connectivity.
-# A fragment for pinging localhost.
-module Ping
-  Command = Rooibos::Command
-
-  Model = Data.define(:output, :loading)
-
-  Init = -> do
-    Model.new(output: "Press 'p' for ping", loading: false)
-  end
-
-  View = -> (model, tui, disabled: false) do
-    text_style = if disabled && model.output == Init.().output
-      tui.style(fg: :dark_gray)
-    else
-      nil
-    end
-
-    tui.paragraph(
-      text: tui.text_span(content: model.output, style: text_style),
-      block: tui.block(title: "Ping", borders: [:all], border_style: { fg: :magenta })
-    )
-  end
-
-  Update = -> (message, model) do
-    case message
-    in { type: :system, envelope: :ping, status: 0, stdout: }
-      [model.with(output: Ractor.make_shareable(stdout.strip), loading: false), nil]
-    in { type: :system, envelope: :ping, stderr: }
-      [model.with(output: Ractor.make_shareable("Error: #{stderr.strip}"), loading: false), nil]
-    else
-      [model, nil]
-    end
-  end
-
-  def self.fetch_command
-    Command.system("ping -c 3 8.8.8.8", :ping)
-  end
-end

data/examples/app_fractal_dashboard/fragments/stats_panel.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: MIT-0
-#++
-
-require "rooibos"
-require_relative "system_info"
-require_relative "disk_usage"
-
-# Composes SystemInfo and DiskUsage in a horizontal layout.
-module StatsPanel
-  Model = Data.define(:system_info, :disk_usage)
-
-  Init = -> do
-    system_info, = Rooibos.normalize_init(SystemInfo::Init.())
-    disk_usage, = Rooibos.normalize_init(DiskUsage::Init.())
-    Model.new(system_info:, disk_usage:)
-  end
-
-  View = -> (model, tui, disabled: false) do
-    tui.layout(
-      direction: :horizontal,
-      constraints: [tui.constraint_percentage(50), tui.constraint_percentage(50)],
-      children: [
-        SystemInfo::View.call(model.system_info, tui, disabled:),
-        DiskUsage::View.call(model.disk_usage, tui, disabled:),
-      ]
-    )
-  end
-
-  Update = -> (message, model) do
-    case message
-    in { envelope: :system_info, ** }
-      new_child, command = SystemInfo::Update.call(message, model.system_info)
-      [model.with(system_info: new_child), command]
-    in { envelope: :disk_usage, ** }
-      new_child, command = DiskUsage::Update.call(message, model.disk_usage)
-      [model.with(disk_usage: new_child), command]
-    else
-      [model, nil]
-    end
-  end
-end

data/examples/app_fractal_dashboard/fragments/system_info.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: MIT-0
-#++
-
-require "rooibos"
-# Fetches and displays system information via +uname -a+.
-# A fragment for fetching and displaying system information.
-module SystemInfo
-  Command = Rooibos::Command
-
-  Model = Data.define(:output, :loading)
-
-  Init = -> do
-    Model.new(output: "Press 's' for system info", loading: false)
-  end
-
-  View = -> (model, tui, disabled: false) do
-    text_style = if disabled && model.output == Init.().output
-      tui.style(fg: :dark_gray)
-    else
-      nil
-    end
-
-    tui.paragraph(
-      text: tui.text_span(content: model.output, style: text_style),
-      block: tui.block(title: "System Info", borders: [:all], border_style: { fg: :cyan })
-    )
-  end
-
-  Update = -> (message, model) do
-    case message
-    in { type: :system, envelope: :system_info, status: 0, stdout: }
-      [model.with(output: Ractor.make_shareable(stdout.strip), loading: false), nil]
-    in { type: :system, envelope: :system_info, stderr: }
-      [model.with(output: Ractor.make_shareable("Error: #{stderr.strip}"), loading: false), nil]
-    else
-      [model, nil]
-    end
-  end
-
-  def self.fetch_command
-    Command.system("uname -a", :system_info)
-  end
-end

data/examples/app_fractal_dashboard/fragments/uptime.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: MIT-0
-#++
-
-require "rooibos"
-# Displays system uptime.
-# A fragment for displaying system uptime.
-module Uptime
-  Command = Rooibos::Command
-
-  Model = Data.define(:output, :loading)
-
-  Init = -> do
-    Model.new(output: "Press 'u' for uptime", loading: false)
-  end
-
-  View = -> (model, tui, disabled: false) do
-    text_style = if disabled && model.output == Init.().output
-      tui.style(fg: :dark_gray)
-    else
-      nil
-    end
-
-    tui.paragraph(
-      text: tui.text_span(content: model.output, style: text_style),
-      block: tui.block(title: "Uptime", borders: [:all], border_style: { fg: :magenta })
-    )
-  end
-
-  Update = -> (message, model) do
-    case message
-    in { type: :system, envelope: :uptime, status: 0, stdout: }
-      [model.with(output: Ractor.make_shareable(stdout.strip), loading: false), nil]
-    in { type: :system, envelope: :uptime, stderr: }
-      [model.with(output: Ractor.make_shareable("Error: #{stderr.strip}"), loading: false), nil]
-    else
-      [model, nil]
-    end
-  end
-
-  def self.fetch_command
-    Command.system("uptime", :uptime)
-  end
-end

data/examples/tutorial/01/app.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "rooibos"
-
-module Tutorial01
-  module FileBrowser
-    Entry = Data.define(:name, :directory?)
-
-    Model = Data.define(:current_directory, :entries)
-
-    View = -> (model, tui) {
-      items = model.entries.map { |e| e.directory? ? "#{e.name}/" : e.name }
-      tui.layout(children: [
-        tui.paragraph(text: model.current_directory),
-        tui.list(items:),
-      ])
-    }
-
-    Update = -> (message, model) {
-      if message.ctrl_c? or message.q?
-        Rooibos::Command.exit
-      else
-        model
-      end
-    }
-
-    ReadEntries = -> (path) {
-      Dir.children(path).map { |name|
-        full_path = File.join(path, name)
-        Entry.new(name:, directory?: File.directory?(full_path))
-      }.sort_by { |e| [e.directory? ? 0 : 1, e.name.downcase] }
-    }
-
-    Init = -> {
-      current_directory = Dir.pwd
-      entries = ReadEntries.call(current_directory)
-      Ractor.make_shareable Model.new(current_directory, entries)
-    }
-  end
-end
-
-if __FILE__ == $0
-  Rooibos.run(Tutorial01::FileBrowser)
-end

data/examples/tutorial/02/app.rb

@@ -1,64 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "rooibos"
-
-module Tutorial02
-  module FileBrowser
-    Entry = Data.define(:name, :directory?)
-
-    Model = Data.define(:current_directory, :entries, :selected_index)
-
-    View = -> (model, tui) {
-      items = model.entries.map { |e| e.directory? ? "#{e.name}/" : e.name }
-      tui.layout(children: [
-        tui.paragraph(text: model.current_directory),
-        tui.list(
-          items:,
-          selected_index: model.selected_index,
-          highlight_style: tui.style(modifiers: [:reversed])
-        ),
-      ])
-    }
-
-    Update = -> (message, model) {
-      if message.ctrl_c? or message.q?
-        Rooibos::Command.exit
-      elsif message.down_arrow? or message.j?
-        new_index = (model.selected_index + 1) % model.entries.length
-        model.with(selected_index: new_index)
-      elsif message.up_arrow? or message.k?
-        new_index = (model.selected_index - 1) % model.entries.length
-        model.with(selected_index: new_index)
-      elsif message.home? or message.g?
-        model.with(selected_index: 0)
-      elsif message.end? or message.G?
-        model.with(selected_index: model.entries.length - 1)
-      else
-        model
-      end
-    }
-
-    ReadEntries = -> (path) {
-      Dir.children(path).map { |name|
-        full_path = File.join(path, name)
-        Entry.new(name:, directory?: File.directory?(full_path))
-      }.sort_by { |e| [e.directory? ? 0 : 1, e.name.downcase] }
-    }
-
-    Init = -> {
-      current_directory = Dir.pwd
-      entries = ReadEntries.call(current_directory)
-      Ractor.make_shareable Model.new(current_directory, entries, 0)
-    }
-  end
-end
-
-if __FILE__ == $0
-  Rooibos.run(Tutorial02::FileBrowser)
-end

data/examples/tutorial/03/app.rb

@@ -1,91 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "rooibos"
-
-module Tutorial03
-  module FileBrowser
-    Entry = Data.define(:name, :directory?)
-
-    Model = Data.define(:current_directory, :entries, :selected_index)
-
-    View = -> (model, tui) {
-      items = model.entries.map { |e| e.directory? ? "#{e.name}/" : e.name }
-      tui.layout(children: [
-        tui.paragraph(text: model.current_directory),
-        tui.list(
-          items:,
-          selected_index: model.selected_index,
-          highlight_style: tui.style(modifiers: [:reversed])
-        ),
-      ])
-    }
-
-    Update = -> (message, model) {
-      if message.ctrl_c? or message.q?
-        Rooibos::Command.exit
-      elsif message.down_arrow? or message.j?
-        new_index = (model.selected_index + 1) % model.entries.length
-        model.with(selected_index: new_index)
-      elsif message.up_arrow? or message.k?
-        new_index = (model.selected_index - 1) % model.entries.length
-        model.with(selected_index: new_index)
-      elsif message.home? or message.g?
-        model.with(selected_index: 0)
-      elsif message.end? or message.G?
-        model.with(selected_index: model.entries.length - 1)
-      elsif message.enter? or message.right_arrow? or message.l?
-        selected_entry = model.entries[model.selected_index]
-        if selected_entry.directory?
-          new_dir = File.join(model.current_directory, selected_entry.name)
-          new_entries = read_entries(new_dir)
-          model.with(current_directory: new_dir, entries: new_entries, selected_index: 0)
-        else
-          model
-        end
-      elsif message.backspace? or message.left_arrow? or message.h?
-        parent_dir = File.dirname(model.current_directory)
-        new_entries = read_entries(parent_dir)
-        model.with(current_directory: parent_dir, entries: new_entries, selected_index: 0)
-      elsif message.tilde?
-        home_dir = Dir.home
-        new_entries = read_entries(home_dir)
-        model.with(current_directory: home_dir, entries: new_entries, selected_index: 0)
-      elsif message.slash?
-        new_entries = read_entries("/")
-        model.with(current_directory: "/", entries: new_entries, selected_index: 0)
-      elsif message.R?
-        new_entries = read_entries(model.current_directory)
-        model.with(entries: new_entries)
-      else
-        model
-      end
-    }
-
-    ReadEntries = -> (path) {
-      Dir.children(path).map { |name|
-        full_path = File.join(path, name)
-        Entry.new(name:, directory?: File.directory?(full_path))
-      }.sort_by { |e| [e.directory? ? 0 : 1, e.name.downcase] }
-    }
-
-    Init = -> {
-      current_directory = Dir.pwd
-      entries = ReadEntries.call(current_directory)
-      Ractor.make_shareable Model.new(current_directory, entries, 0)
-    }
-
-    private_class_method def self.read_entries(path)
-      ReadEntries.call(path)
-    end
-  end
-end
-
-if __FILE__ == $0
-  Rooibos.run(Tutorial03::FileBrowser)
-end

data/examples/tutorial/06_safe_refactoring/app.rb

@@ -1,124 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "rooibos"
-
-module Tutorial06
-  # A Fragment is a module with Model, Init, Update, View.
-  # This FileList fragment handles the list of files and navigation.
-  module FileList
-    Entry = Data.define(:name, :directory?)
-
-    Model = Data.define(:current_directory, :entries, :selected_index)
-
-    View = -> (model, tui) {
-      items = model.entries.map { |e| e.directory? ? "#{e.name}/" : e.name }
-      tui.layout(children: [
-        tui.paragraph(text: model.current_directory),
-        tui.list(
-          items:,
-          selected_index: model.selected_index,
-          highlight_style: tui.style(modifiers: [:reversed])
-        ),
-      ])
-    }
-
-    Update = -> (message, model) {
-      if message.move_down?
-        new_index = (model.selected_index + 1) % model.entries.length
-        model.with(selected_index: new_index)
-      elsif message.move_up?
-        new_index = (model.selected_index - 1) % model.entries.length
-        model.with(selected_index: new_index)
-      elsif message.jump_to_first?
-        model.with(selected_index: 0)
-      elsif message.jump_to_last?
-        model.with(selected_index: model.entries.length - 1)
-      elsif message.enter?
-        selected_entry = model.entries[model.selected_index]
-        if selected_entry.directory?
-          new_dir = File.join(model.current_directory, selected_entry.name)
-          new_entries = read_entries(new_dir)
-          model.with(current_directory: new_dir, entries: new_entries, selected_index: 0)
-        else
-          nil
-        end
-      elsif message.go_back?
-        parent_dir = File.dirname(model.current_directory)
-        new_entries = read_entries(parent_dir)
-        model.with(current_directory: parent_dir, entries: new_entries, selected_index: 0)
-      elsif message.go_home?
-        home_dir = Dir.home
-        new_entries = read_entries(home_dir)
-        model.with(current_directory: home_dir, entries: new_entries, selected_index: 0)
-      elsif message.go_root?
-        root = File.expand_path("/")
-        new_entries = read_entries(root)
-        model.with(current_directory: root, entries: new_entries, selected_index: 0)
-      elsif message.refresh?
-        new_entries = read_entries(model.current_directory)
-        model.with(entries: new_entries)
-      end
-    }
-
-    ReadEntries = -> (path) {
-      Dir.children(path).map { |name|
-        full_path = File.join(path, name)
-        Entry.new(name:, directory?: File.directory?(full_path))
-      }.sort_by { |e| [e.directory? ? 0 : 1, e.name.downcase] }
-    }
-
-    Init = -> {
-      current_directory = Dir.pwd
-      entries = ReadEntries.call(current_directory)
-      Ractor.make_shareable Model.new(current_directory, entries, 0)
-    }
-
-    private_class_method def self.read_entries(path)
-      ReadEntries.call(path)
-    end
-  end
-
-  # The main FileBrowser delegates to the FileList fragment via Router.
-  module FileBrowser
-    include Rooibos::Router
-
-    Command = Rooibos::Command
-
-    # Parent model wraps child fragment
-    Model = Data.define(:file_list)
-
-    route :file_list, to: FileList
-
-    action go_back: FileList, keys: %i[backspace left h]
-    action go_home: FileList, key: :~
-    action go_root: FileList, key: :/
-    action refresh: FileList, key: :R
-    action enter: FileList, keys: %i[enter right l]
-    action move_down: FileList, keys: %i[down j]
-    action move_up: FileList, keys: %i[up k]
-    action jump_to_first: FileList, keys: %i[home g]
-    action jump_to_last: FileList, keys: %i[end G]
-    action -> { Command.exit }, keys: %i[ctrl_c q]
-
-    View = -> (model, tui) {
-      FileList::View.call(model.file_list, tui)
-    }
-
-    Update = from_router
-
-    Init = -> {
-      file_list = FileList::Init.()
-      Ractor.make_shareable Model.new(file_list:)
-    }
-  end
-end
-
-if __FILE__ == $0
-  Rooibos.run(Tutorial06::FileBrowser)
-end

data/examples/verify_readme_usage/README.md

@@ -1,54 +0,0 @@
-<!--
-SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
-# README Usage Verification
-
-Verifies the primary usage example for the Rooibos gem.
-
-This example exists as a documentation regression test. It ensures that the very first MVU pattern a user sees actually works.
-
-## Usage
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-<!-- SYNC:START:./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 -->
-
-[![verify_readme_usage](../../doc/images/verify_readme_usage.png)](../../README.md#usage)