bubbletea 0.0.1 → 0.1.0

data/lib/bubbletea/runner.rb

@@ -0,0 +1,376 @@
+# frozen_string_literal: true
+
+module Bubbletea
+  # Runner manages the event loop and coordinates between the model and the terminal
+  class Runner
+    attr_reader :options
+
+    DEFAULT_OPTIONS = {
+      alt_screen: false,
+      mouse_cell_motion: false,
+      mouse_all_motion: false,
+      bracketed_paste: false,
+      report_focus: false,
+      fps: 60,
+      input_timeout: 10,
+      without_renderer: false,
+    }.freeze
+
+    def initialize(model, **options)
+      @model = model
+      @options = DEFAULT_OPTIONS.merge(options)
+      @program = Program.new
+      @renderer_id = nil
+      @running = false
+      @pending_ticks = []
+      @width = 80
+      @height = 24
+      @resize_pending = false
+      @previous_winch_handler = nil
+      @in_alt_screen = false
+    end
+
+    def run
+      setup_terminal
+      @renderer_id = @program.create_renderer unless @options[:without_renderer]
+
+      update_terminal_size
+      @running = true
+
+      new_model, command = @model.init
+      @model = new_model if new_model
+      process_command(command)
+
+      return unless @running
+
+      handle_message(WindowSizeMessage.new(width: @width, height: @height))
+
+      render
+      run_loop
+      render
+    ensure
+      cleanup_terminal
+    end
+
+    def send(message)
+      @pending_messages ||= []
+      @pending_messages << message
+    end
+
+    private
+
+    def setup_terminal
+      @program.enter_raw_mode
+      @program.hide_cursor
+      @program.start_input_reader
+
+      if @options[:alt_screen]
+        @program.enter_alt_screen
+        @program.renderer_set_alt_screen(@renderer_id, true) if @renderer_id
+        @in_alt_screen = true
+      end
+
+      @program.enable_mouse_cell_motion if @options[:mouse_cell_motion]
+      @program.enable_mouse_all_motion if @options[:mouse_all_motion]
+      @program.enable_bracketed_paste if @options[:bracketed_paste]
+      @program.enable_report_focus if @options[:report_focus]
+
+      setup_resize_handler
+    end
+
+    def cleanup_terminal
+      restore_resize_handler
+
+      @program.disable_mouse if @options[:mouse_cell_motion] || @options[:mouse_all_motion]
+      @program.disable_bracketed_paste if @options[:bracketed_paste]
+      @program.disable_report_focus if @options[:report_focus]
+
+      if @in_alt_screen
+        @program.exit_alt_screen
+      else
+        print "\r\n"
+      end
+
+      @program.show_cursor
+      @program.stop_input_reader
+      @program.exit_raw_mode
+    end
+
+    def setup_resize_handler
+      @previous_winch_handler = Signal.trap("WINCH") do
+        @resize_pending = true
+        @previous_winch_handler.call if @previous_winch_handler.is_a?(Proc)
+      end
+    rescue ArgumentError
+      # SIGWINCH not supported on this platform
+      @previous_winch_handler = nil
+    end
+
+    def restore_resize_handler
+      if @previous_winch_handler
+        Signal.trap("WINCH", @previous_winch_handler)
+      else
+        Signal.trap("WINCH", "DEFAULT")
+      end
+    rescue ArgumentError
+      # SIGWINCH not supported on this platform
+    end
+
+    def update_terminal_size
+      size = @program.terminal_size
+      return unless size
+
+      @width, @height = size
+      @program.renderer_set_size(@renderer_id, @width, @height) if @renderer_id
+    end
+
+    def run_loop
+      frame_duration = 1.0 / @options[:fps]
+      last_frame = Time.now
+
+      while @running
+        check_resize
+        process_pending_messages
+
+        event = @program.poll_event(@options[:input_timeout])
+
+        if event
+          message = Bubbletea.parse_event(event)
+          handle_message(message) if message
+        end
+
+        process_ticks
+
+        now = Time.now
+
+        if now - last_frame >= frame_duration
+          render
+          last_frame = now
+        end
+      end
+    end
+
+    def check_resize
+      return unless @resize_pending
+
+      @resize_pending = false
+
+      size = @program.terminal_size
+      return unless size
+
+      new_width, new_height = size
+
+      return if new_width == @width && new_height == @height
+
+      @width = new_width
+      @height = new_height
+
+      @program.renderer_set_size(@renderer_id, @width, @height) if @renderer_id
+
+      handle_message(WindowSizeMessage.new(width: @width, height: @height))
+    end
+
+    def process_pending_messages
+      return unless @pending_messages&.any?
+
+      messages = @pending_messages
+      @pending_messages = []
+
+      messages.each { |message| handle_message(message) }
+    end
+
+    def handle_message(message)
+      return unless @running
+
+      new_model, command = @model.update(message)
+      @model = new_model if new_model
+      process_command(command)
+    end
+
+    def process_command(command)
+      return if command.nil?
+
+      case command
+      when QuitCommand
+        @running = false
+
+      when BatchCommand
+        Thread.new do
+          execute_batch_sync(command.commands)
+        end
+
+      when SequenceCommand
+        Thread.new do
+          execute_sequence_sync(command.commands)
+        end
+
+      when TickCommand
+        schedule_tick(command)
+
+      when SendMessage
+        if command.delay.positive?
+          schedule_delayed_message(command)
+        else
+          handle_message(command.message)
+        end
+
+      when EnterAltScreenCommand
+        @program.enter_alt_screen
+        @program.renderer_set_alt_screen(@renderer_id, true) if @renderer_id
+        @in_alt_screen = true
+
+      when ExitAltScreenCommand
+        @program.exit_alt_screen
+        @program.renderer_set_alt_screen(@renderer_id, false) if @renderer_id
+        @in_alt_screen = false
+
+      when SetWindowTitleCommand
+        Bubbletea._set_window_title(command.title)
+
+      when PutsCommand
+        warn "\r#{command.text}\r"
+
+      when SuspendCommand
+        suspend_process
+
+      when Proc
+        Thread.new do
+          result = command.call
+          next unless result
+
+          if result.is_a?(Message)
+            send(result)
+          else
+            process_command(result)
+          end
+        end
+      end
+    end
+
+    def execute_command_sync(command)
+      return if command.nil?
+
+      case command
+      when QuitCommand
+        @running = false
+
+      when BatchCommand
+        execute_batch_sync(command.commands)
+
+      when SequenceCommand
+        execute_sequence_sync(command.commands)
+
+      when TickCommand
+        schedule_tick(command)
+
+      when SendMessage
+        sleep(command.delay) if command.delay.positive?
+        handle_message(command.message)
+
+      when EnterAltScreenCommand
+        @program.enter_alt_screen
+        @program.renderer_set_alt_screen(@renderer_id, true) if @renderer_id
+        @in_alt_screen = true
+
+      when ExitAltScreenCommand
+        @program.exit_alt_screen
+        @program.renderer_set_alt_screen(@renderer_id, false) if @renderer_id
+        @in_alt_screen = false
+
+      when SetWindowTitleCommand
+        Bubbletea._set_window_title(command.title)
+
+      when PutsCommand
+        warn "\r#{command.text}\r"
+
+      when SuspendCommand
+        suspend_process
+
+      when Proc
+        result = command.call
+        return unless result
+
+        if result.is_a?(Message)
+          send(result)
+        else
+          execute_command_sync(result)
+        end
+      end
+    end
+
+    def execute_sequence_sync(commands)
+      commands.each do |cmd|
+        break unless @running
+
+        execute_command_sync(cmd)
+      end
+    end
+
+    def execute_batch_sync(commands)
+      threads = commands.map do |cmd|
+        Thread.new { execute_command_sync(cmd) }
+      end
+
+      threads.each(&:join)
+    end
+
+    def schedule_tick(tick_command)
+      @pending_ticks << {
+        at: Time.now + tick_command.duration,
+        callback: tick_command.callback,
+      }
+    end
+
+    def schedule_delayed_message(send_command)
+      @pending_ticks << {
+        at: Time.now + send_command.delay,
+        message: send_command.message,
+      }
+    end
+
+    def process_ticks
+      now = Time.now
+      ready, @pending_ticks = @pending_ticks.partition { |tick| tick[:at] <= now }
+
+      ready.each do |tick|
+        if tick[:callback]
+          result = tick[:callback].call
+          handle_message(result) if result
+        elsif tick[:message]
+          handle_message(tick[:message])
+        end
+      end
+    end
+
+    def suspend_process
+      @program.disable_mouse if @options[:mouse_cell_motion] || @options[:mouse_all_motion]
+      @program.show_cursor
+      @program.stop_input_reader
+      @program.exit_raw_mode
+
+      Process.kill("TSTP", Process.pid)
+
+      # When we get here, we've been resumed (SIGCONT was received)
+      @program.enter_raw_mode
+      @program.hide_cursor
+      @program.start_input_reader
+      @program.enable_mouse_cell_motion if @options[:mouse_cell_motion]
+      @program.enable_mouse_all_motion if @options[:mouse_all_motion]
+
+      handle_message(ResumeMessage.new)
+    end
+
+    def render
+      return if @options[:without_renderer]
+      return unless @renderer_id
+
+      view = @model.view
+      @program.render(@renderer_id, view)
+    end
+  end
+
+  def self.run(model, **options)
+    runner = Runner.new(model, **options)
+    runner.run
+  end
+end

data/lib/bubbletea/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bubbletea
-  VERSION = "0.0.1"
+  VERSION = "0.1.0"
 end

data/lib/bubbletea.rb

@@ -2,7 +2,18 @@
 
 require_relative "bubbletea/version"
 
+begin
+  major, minor, _patch = RUBY_VERSION.split(".") #: [String, String, String]
+  require_relative "bubbletea/#{major}.#{minor}/bubbletea"
+rescue LoadError
+  require_relative "bubbletea/bubbletea"
+end
+
+require_relative "bubbletea/messages"
+require_relative "bubbletea/commands"
+require_relative "bubbletea/model"
+require_relative "bubbletea/runner"
+
 module Bubbletea
   class Error < StandardError; end
-  # Your code goes here...
 end

metadata

@@ -1,36 +1,64 @@
 --- !ruby/object:Gem::Specification
 name: bubbletea
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Marco Roth
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
-description: A powerful little TUI framework. Integrate Charm's Bubble Tea with the
-  RubyGems infrastructure.
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lipgloss
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: Build beautiful, interactive terminal applications using the Elm Architecture
+  in Ruby.
 email:
 - marco.roth@intergga.ch
 executables: []
-extensions: []
+extensions:
+- ext/bubbletea/extconf.rb
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
-- CODE_OF_CONDUCT.md
+- LICENSE.txt
 - README.md
-- Rakefile
+- bubbletea.gemspec
+- ext/bubbletea/extconf.rb
+- ext/bubbletea/extension.c
+- ext/bubbletea/extension.h
+- ext/bubbletea/program.c
+- go/bubbletea.go
+- go/go.mod
+- go/go.sum
+- go/input.go
+- go/keys.go
+- go/renderer.go
+- go/terminal.go
 - lib/bubbletea.rb
+- lib/bubbletea/commands.rb
+- lib/bubbletea/messages.rb
+- lib/bubbletea/model.rb
+- lib/bubbletea/runner.rb
 - lib/bubbletea/version.rb
-- sig/bubbletea.rbs
-homepage: https://github.com/marcoroth/bubbletea
+homepage: https://github.com/marcoroth/bubbletea-ruby
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/marcoroth/bubbletea
-  source_code_uri: https://github.com/marcoroth/bubbletea
-  changelog_uri: https://github.com/marcoroth/bubbletea/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/marcoroth/bubbletea-ruby
+  source_code_uri: https://github.com/marcoroth/bubbletea-ruby
+  changelog_uri: https://github.com/marcoroth/bubbletea-ruby/releases
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
@@ -46,7 +74,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
-summary: Ruby wrapper for Charm's bubbletea CLI tool.
+summary: Ruby wrapper for Charm's bubbletea. A powerful TUI framework.
 test_files: []

data/CHANGELOG.md

@@ -1,5 +0,0 @@
-## [Unreleased]
-
-## [0.1.0] - 2025-12-07
-
-- Initial release

data/CODE_OF_CONDUCT.md

@@ -1,132 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, caste, color, religion, or sexual
-identity and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the overall
-  community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or advances of
-  any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email address,
-  without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, and will communicate reasons for moderation
-decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-Examples of representing our community include using an official email address,
-posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
-[INSERT CONTACT METHOD].
-All complaints will be reviewed and investigated promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the
-reporter of any incident.
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining
-the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing
-clarity around the nature of the violation and an explanation of why the
-behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact**: A violation through a single incident or series of
-actions.
-
-**Consequence**: A warning with consequences for continued behavior. No
-interaction with the people involved, including unsolicited interaction with
-those enforcing the Code of Conduct, for a specified period of time. This
-includes avoiding interactions in community spaces as well as external channels
-like social media. Violating these terms may lead to a temporary or permanent
-ban.
-
-### 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including
-sustained inappropriate behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time. No public or
-private interaction with the people involved, including unsolicited interaction
-with those enforcing the Code of Conduct, is allowed during this period.
-Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior, harassment of an
-individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within the
-community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.1, available at
-[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
-
-Community Impact Guidelines were inspired by
-[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
-
-For answers to common questions about this code of conduct, see the FAQ at
-[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
-[https://www.contributor-covenant.org/translations][translations].
-
-[homepage]: https://www.contributor-covenant.org
-[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
-[Mozilla CoC]: https://github.com/mozilla/diversity
-[FAQ]: https://www.contributor-covenant.org/faq
-[translations]: https://www.contributor-covenant.org/translations

data/Rakefile

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "minitest/test_task"
-
-Minitest::TestTask.create
-
-require "rubocop/rake_task"
-
-RuboCop::RakeTask.new
-
-task default: %i[test rubocop]

data/sig/bubbletea.rbs

@@ -1,4 +0,0 @@
-module Bubbletea
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end