ratatui_ruby 1.1.0 → 1.1.1

data/tasks/sourcehut.rake

@@ -1,110 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-desc "Generate SourceHut build manifests from template"
-task sourcehut: "sourcehut:build"
-
-namespace :sourcehut do
-  desc "Build SourceHut manifests"
-  task build: "sourcehut:build:manifest"
-
-  namespace :build do
-    desc "Generate SourceHut build manifests from template"
-    task :manifest do
-      require "erb"
-      require "yaml"
-
-      spec = Gem::Specification.load("ratatui_ruby.gemspec")
-
-      # Read version directly from file to ensure we get the latest version
-      # even if it was just bumped in the same Rake execution
-      version_content = File.read("lib/ratatui_ruby/version.rb")
-      version = version_content.match(/VERSION = "(.+?)"/)[1]
-
-      # Normalize version using Gem::Version - RubyGems converts hyphens
-      # (e.g., "1.0.0-beta.1" -> "1.0.0.pre.beta.1")
-      normalized_version = Gem::Version.new(version).to_s
-
-      gem_filename = "#{spec.name}-#{normalized_version}.gem"
-
-      rubies = YAML.load_file("tasks/resources/rubies.yml")
-
-      bundler_version = File.read("Gemfile.lock").match(/BUNDLED WITH\n\s+([\d.]+)/)[1]
-
-      template = File.read("tasks/resources/build.yml.erb")
-      erb = ERB.new(template, trim_mode: "-")
-
-      FileUtils.mkdir_p ".builds"
-
-      # Remove old generated files to ensure a clean state
-      Dir.glob(".builds/*.yml").each { |f| File.delete(f) }
-
-      rubies.each do |ruby_version|
-        filename = ".builds/ruby-#{ruby_version}.yml"
-        puts "Generating #{filename}..."
-        gem_name = spec.name
-        has_rust = File.exist?("ext/#{gem_name}/Cargo.toml")
-        content = erb.result_with_hash(ruby_version:, gem_name:, gem_filename:, bundler_version:, has_rust:)
-        File.write(filename, content)
-      end
-    end
-  end
-
-  desc "Update stable branch to match release and set as default"
-  task :update_stable do
-    # Read version to determine tag
-    version_content = File.read("lib/ratatui_ruby/version.rb")
-    version = version_content.match(/VERSION = "(.+?)"/)[1]
-    tag_name = "v#{version}"
-
-    # Verify that the version file matches the actual git tag
-    # This prevents updating stable to the wrong version if the release failed
-    latest_tag = `git describe --tags --abbrev=0`.strip
-    if latest_tag != tag_name
-      abort "Fatal: Version mismatch! 'lib/ratatui_ruby/version.rb' says #{tag_name}, but the latest git tag is #{latest_tag}."
-    end
-
-    puts "Updating stable branch to point to #{tag_name}..."
-    # Resolve the tag to a commit hash (peel annotated tags)
-    # This renders a commit SHA that can be pushed to a branch head
-    commit_sha = `git rev-parse #{tag_name}^{}`.strip
-
-    # Update local stable branch to match
-    sh "git branch -f stable #{commit_sha}"
-
-    # Push the commit to remote stable branch
-    # This creates 'stable' if it doesn't exist, or fast-forwards it.
-    sh "git push origin #{commit_sha}:stable"
-  end
-end
-
-if Rake::Task.task_defined?("release")
-  Rake::Task["release"].enhance do
-    # Replace Bundler's normalized tag with semver-style for prerelease versions.
-    # Bundler creates tags using normalized Gem::Version (e.g., v1.0.0.pre.beta.1).
-    # Semver uses hyphens (e.g., v1.0.0-beta.1). We want only the semver tag.
-    version_content = File.read("lib/ratatui_ruby/version.rb")
-    version = version_content.match(/VERSION = "(.+?)"/)[1]
-
-    if version.include?("-")
-      normalized_tag = "v#{Gem::Version.new(version)}"
-      semver_tag = "v#{version}"
-
-      if normalized_tag != semver_tag
-        puts "Replacing normalized tag #{normalized_tag} with semver tag #{semver_tag}..."
-        # Delete the normalized tag locally and remotely
-        sh "git tag -d #{normalized_tag}"
-        sh "git push origin :refs/tags/#{normalized_tag}"
-        # Create the semver tag pointing to the same commit
-        sh "git tag #{semver_tag} HEAD"
-        sh "git push origin #{semver_tag}"
-      end
-    end
-
-    Rake::Task["sourcehut:update_stable"].invoke
-  end
-end

data/tasks/steep.rake

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-desc "Run Steep type checker"
-task :steep do
-  sh "bundle exec steep check"
-end

data/tasks/terminal_preview/app_screenshot.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "tmpdir"
-require_relative "launcher_script"
-require_relative "terminal_window"
-require_relative "crash_report"
-
-class AppScreenshot < Data.define(:app, :output_path)
-  def capture
-    print "  📸 #{app}..."
-
-    LauncherScript.new(app.app_path, Dir.pwd).run do |launcher|
-      TerminalWindow.new(launcher.path, launcher.pid_file).open do |window|
-        take_snapshot(window.window_id)
-
-        if File.size?(output_path)
-          puts " done."
-          true
-        else
-          FileUtils.rm_f(output_path)
-          puts " FAILED"
-          puts
-          puts "  Window rendered nothing (app may have crashed before drawing)"
-          puts
-          false
-        end
-      end
-    end
-  rescue => e
-    puts " FAILED"
-    puts
-    puts CrashReport.new(app, e, "Program crashed before screenshot could be taken:")
-    puts
-    false
-  end
-
-  private def take_snapshot(window_id)
-    system("screencapture", "-l", window_id.to_s, "-o", "-x", output_path)
-  end
-end

data/tasks/terminal_preview/crash_report.rb

@@ -1,54 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-class CrashReport < Data.define(:app, :error, :preamble)
-  def self.new(app, error, preamble = nil)
-    # Allow preamble to be optional while Data.define requires all fields
-    super(app:, error:, preamble:)
-  end
-
-  def to_s
-    output = error.message.strip
-    formatted_error = output.split("\n").map { |line| format_line(line) }.join("\n")
-    preamble_section = preamble ? <<~PREAMBLE.chomp : ""
-      #{box_top}
-      #{format_line(preamble)}
-      #{box_bottom}
-    PREAMBLE
-
-    <<~TEXT
-      #{preamble_section}
-      #{border_top(app.to_s)}
-      #{formatted_error}
-      #{box_bottom}
-    TEXT
-  end
-
-  private def box_top
-    "┌#{'─' * (width - 2)}┐"
-  end
-
-  private def box_bottom
-    "└#{'─' * (width - 2)}┘"
-  end
-
-  private def border_top(title)
-    left = "┌─ #{title} "
-    right = "┐"
-    dashes = "─" * (width - left.length - right.length)
-    left + dashes + right
-  end
-
-  private def format_line(line)
-    truncated = line[0...(width - 4)]
-    "│ #{truncated.ljust(width - 4)} │"
-  end
-
-  private def width
-    80
-  end
-end

data/tasks/terminal_preview/example_app.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-class ExampleApp < Data.define(:directory)
-  def self.all
-    examples_dir = File.expand_path("../../examples", __dir__)
-    Dir.glob("#{examples_dir}/*/app.rb").map do |path|
-      new(File.basename(File.dirname(path)))
-    end.sort_by(&:directory)
-  end
-
-  def app_path
-    "examples/#{directory}/app.rb"
-  end
-
-  def screenshot_filename
-    "#{directory}.png"
-  end
-
-  def to_s
-    directory
-  end
-end

data/tasks/terminal_preview/launcher_script.rb

@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "fileutils"
-require "tmpdir"
-
-class LauncherScript < Data.define(:app_path, :repo_root)
-  def initialize(app_path:, repo_root:)
-    super
-    write
-  end
-
-  def run
-    yield self
-  ensure
-    cleanup
-  end
-
-  def path
-    File.join(Dir.tmpdir, "preview_launcher.sh")
-  end
-
-  def pid_file
-    File.join(Dir.tmpdir, "preview_launcher.pid")
-  end
-
-  private def cleanup
-    FileUtils.rm_f(path)
-    FileUtils.rm_f(pid_file)
-  rescue Errno::ENOENT
-    # Already deleted
-  end
-
-  private def write
-    File.open(path, "w") do |f|
-      f.puts "#!/bin/zsh"
-      f.puts "cd '#{repo_root}'"
-      f.puts "clear"
-      f.puts "echo $$ > '#{pid_file}'"
-      f.puts "exec bundle exec ruby '#{app_path}'"
-    end
-    FileUtils.chmod(0o755, path)
-  end
-end

data/tasks/terminal_preview/preview_collection.rb

@@ -1,60 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "fileutils"
-require_relative "example_app"
-require_relative "app_screenshot"
-require_relative "crash_report"
-require_relative "preview_timing"
-require_relative "safety_confirmation"
-require_relative "saved_screenshot"
-
-class PreviewCollection
-  def initialize(output_dir)
-    @output_dir = output_dir
-  end
-
-  def generate
-    abort "Error: This task requires macOS." unless RUBY_PLATFORM.match?(/darwin/)
-
-    apps = ExampleApp.all
-    stale_count = count_stale_apps(apps)
-
-    if stale_count.zero?
-      puts "\n✨ All #{apps.count} screenshots are up to date."
-      return
-    end
-
-    SafetyConfirmation.new(stale_count, apps.count).request
-
-    puts "\nHere we go!"
-    failures = apps.count { |app| !capture_app(app) }
-
-    if failures.zero?
-      puts "\n✨ All captures complete. Check doc/images/."
-    else
-      abort "\n❌ #{failures} capture(s) failed."
-    end
-  end
-
-  private def count_stale_apps(apps)
-    apps.count { |app| SavedScreenshot.for(app, @output_dir).stale? }
-  end
-
-  private def capture_app(app)
-    saved = SavedScreenshot.for(app, @output_dir)
-
-    if saved.stale?
-      success = AppScreenshot.new(app, saved.path).capture
-      sleep PreviewTiming.between_captures
-      success
-    else
-      puts "  ⏭️  #{app} (unchanged)"
-      true
-    end
-  end
-end

data/tasks/terminal_preview/preview_timing.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-class PreviewTiming
-  def self.window_startup
-    1.5
-  end
-
-  def self.between_captures
-    0.2
-  end
-
-  def self.close_delay
-    1.0
-  end
-
-  def self.total
-    window_startup + close_delay + between_captures
-  end
-end

data/tasks/terminal_preview/safety_confirmation.rb

@@ -1,58 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require_relative "preview_timing"
-require_relative "system_appearance"
-
-class SafetyConfirmation
-  def initialize(stale_count, total_count)
-    @stale_count = stale_count
-    @total_count = total_count
-  end
-
-  def request
-    print_warning
-    wait_for_user
-  end
-
-  private def print_warning
-    unchanged_count = @total_count - @stale_count
-    puts "\n#{'=' * 60}"
-    puts "  📸  NATIVE TERMINAL CAPTURE  📸"
-    puts "=" * 60
-    puts "This task will:"
-    puts "  1. Take control of your mouse/keyboard focus"
-    puts "  2. Rapidly open and close Terminal windows"
-    puts "  3. Capture #{@stale_count} screenshots (#{unchanged_count} unchanged)"
-    puts
-    puts "Before starting, be sure Terminal.app has the following permissions"
-    puts "in System Settings.app -> Privacy & Security:"
-    puts "  - Screen & System Audio Recording"
-    puts "  - Automation -> System Events"
-    puts
-    puts "⚠️  PLEASE DO NOT TOUCH YOUR COMPUTER WHILE THIS RUNS."
-    min_time = (@stale_count * PreviewTiming.total).to_i
-    max_time = (@stale_count * (PreviewTiming.total + PreviewTiming.close_delay)).to_i
-    puts "   (Estimated time: #{min_time}-#{max_time} seconds)"
-    puts
-  end
-
-  private def wait_for_user
-    loop do
-      print "Continue? [Y/n]: "
-      response = $stdin.gets.strip.downcase
-
-      if response.empty? || response == "y"
-        return if SystemAppearance.dark?
-        puts "⚠️  Dark Mode is not enabled. Please enable it in System Settings or Control Center before proceeding."
-        puts
-      elsif response == "n"
-        abort "Cancelled."
-      end
-    end
-  end
-end

data/tasks/terminal_preview/saved_screenshot.rb

@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "time"
-
-class SavedScreenshot < Data.define(:app, :path)
-  def self.for(app, output_dir)
-    new(app, File.join(output_dir, app.screenshot_filename))
-  end
-
-  def stale?
-    return true unless valid?
-
-    app_last_modified > screenshot_last_commit_time
-  end
-
-  private def valid?
-    # File must exist and have content (not 0 bytes)
-    File.size?(path) || false
-  end
-
-  private def app_last_modified
-    # If the file has staged or unstaged changes, it's definitely stale
-    return Time.now.to_i if changed?
-
-    # Otherwise, compare against the last git commit time
-    app_last_commit_time
-  end
-
-  private def changed?
-    system("git diff HEAD --quiet #{app.app_path} 2>/dev/null")
-    !$?.success?
-  end
-
-  private def app_last_commit_time
-    output = `git log -1 --format=%cI "#{app.app_path}" 2>/dev/null`.strip
-    return 0 if output.empty?
-
-    Time.iso8601(output).to_i
-  rescue
-    0
-  end
-
-  private def screenshot_last_commit_time
-    output = `git log -1 --format=%cI "#{path}" 2>/dev/null`.strip
-    return Time.now.to_i if output.empty?
-
-    Time.iso8601(output).to_i
-  rescue
-    Time.now.to_i
-  end
-end

data/tasks/terminal_preview/system_appearance.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-class SystemAppearance
-  def self.dark?
-    result = `osascript -e 'tell application "System Events" to tell appearance preferences to get dark mode'`.strip
-    result == "true"
-  end
-end

data/tasks/terminal_preview/terminal_window.rb

@@ -1,138 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require_relative "window_id"
-require_relative "preview_timing"
-
-class TerminalWindow
-  CTRL_C = "ASCII character 3"
-
-  def initialize(launcher_script_path, pid_file)
-    @launcher_script_path = launcher_script_path
-    @pid_file = pid_file
-    @window_id = nil
-  end
-
-  def open
-    setup_script = <<~APPLESCRIPT
-      tell application "Terminal"
-        set newTab to do script "#{@launcher_script_path}"
-        set currentWindow to window 1
-        
-        set number of rows of currentWindow to 24
-        set number of columns of currentWindow to 80
-        set position of currentWindow to {100, 100}
-        set frontmost of currentWindow to true
-        
-        return id of currentWindow
-      end tell
-    APPLESCRIPT
-
-    @window_id = WindowID.new(`osascript -e '#{setup_script}'`.strip)
-    wait_for_startup
-    yield self
-  ensure
-    close if @window_id
-  end
-
-  def window_id
-    @window_id
-  end
-
-  private def close
-    try_graceful_shutdown
-    kill_process if process_still_alive?
-
-    delay_script = <<~APPLESCRIPT
-      tell application "Terminal"
-        delay #{PreviewTiming.close_delay}
-        
-        try
-          close window id #{@window_id}
-        end try
-      end tell
-    APPLESCRIPT
-
-    system("osascript", "-e", delay_script, out: File::NULL, err: File::NULL)
-  end
-
-  private def wait_for_startup
-    sleep PreviewTiming.window_startup
-
-    unless @window_id.valid?
-      raise "Failed to open terminal window"
-    end
-
-    unless process_running?
-      error_output = contents
-      raise error_output
-    end
-  end
-
-  private def try_graceful_shutdown
-    shutdown_script = <<~APPLESCRIPT
-      tell application "Terminal"
-        try
-          do script (#{CTRL_C}) in window id #{@window_id}
-        end try
-      end tell
-    APPLESCRIPT
-
-    system("osascript", "-e", shutdown_script, out: File::NULL, err: File::NULL)
-    sleep 0.2
-  end
-
-  private def process_still_alive?
-    return false unless @pid_file && File.exist?(@pid_file)
-
-    pid = File.read(@pid_file).strip.to_i
-    Process.kill(0, pid)
-    true
-  rescue Errno::ESRCH, Errno::ENOENT
-    false
-  end
-
-  private def kill_process
-    return unless @pid_file && File.exist?(@pid_file)
-
-    pid = File.read(@pid_file).strip.to_i
-    Process.kill("TERM", pid)
-  rescue Errno::ESRCH, Errno::ENOENT
-    # Process already gone or PID file doesn't exist
-  end
-
-  private def process_running?
-    check_script = <<~APPLESCRIPT
-      tell application "Terminal"
-        try
-          set theWindow to window id #{@window_id}
-          return busy of theWindow
-        on error
-          return false
-        end try
-      end tell
-    APPLESCRIPT
-
-    result = `osascript -e '#{check_script}'`.strip
-    result == "true"
-  end
-
-  private def contents
-    read_script = <<~APPLESCRIPT
-      tell application "Terminal"
-        try
-          set theWindow to window id #{@window_id}
-          return contents of selected tab of theWindow
-        on error
-          return ""
-        end try
-      end tell
-    APPLESCRIPT
-
-    `osascript -e '#{read_script}'`
-  end
-end

data/tasks/terminal_preview/window_id.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-class WindowID < Data.define(:value)
-  def valid?
-    !value.empty? && value.match?(/^\d+$/)
-  end
-
-  def to_s
-    value
-  end
-end

data/tasks/terminal_preview.rake

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "fileutils"
-require_relative "terminal_preview/preview_collection"
-require_relative "terminal_preview/example_app"
-
-namespace :terminal_preview do
-  desc "Generate native PNG screenshots using Terminal.app"
-  task :generate do
-    img_dir = File.expand_path("../doc/images", __dir__)
-    FileUtils.mkdir_p(img_dir)
-
-    # Create empty placeholder files for any missing images that compile depends on.
-    # This prevents Rake from trying to build them as dependencies.
-    ExampleApp.all.each do |app|
-      image_path = File.join(img_dir, "#{app}.png")
-      FileUtils.touch(image_path) unless File.exist?(image_path)
-    end
-
-    Rake::Task["compile"].invoke
-
-    collection = PreviewCollection.new(img_dir)
-    collection.generate
-  end
-end