ratatui_ruby 1.0.0 → 1.0.1

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

data/tasks/test.rake

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "minitest/test_task"
-
-namespace :cargo do
-  desc "Run cargo tests"
-  task :test do
-    sh "cd ext/ratatui_ruby && cargo test"
-  end
-end
-
-# Clear the default test task created by Minitest::TestTask if it exists
-Rake::Task["test"].clear if Rake::Task.task_defined?("test")
-
-desc "Run all tests (Ruby and Rust)"
-task test: %w[compile test:ruby test:rust]
-
-namespace :test do
-  desc "Run Rust tests"
-  task :rust do
-    Rake::Task["cargo:test"].invoke
-  end
-
-  # Create a specific Minitest task for Ruby tests
-  Minitest::TestTask.create(:ruby) do |t|
-    t.test_globs = ["test/**/*.rb", "examples/**/test_*.rb"]
-  end
-end

data/tasks/website/index_page.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "erb"
-
-class IndexPage
-  def initialize(versions)
-    @versions = versions
-
-    latest_version = @versions.find { |v| v.is_a?(Tagged) }
-    latest_version.is_latest = true if latest_version
-  end
-
-  def publish_to(path, project_name:)
-    puts "Generating index page..."
-
-    template_path = File.expand_path("../resources/index.html.erb", __dir__)
-    template = File.read(template_path)
-
-    versions = @versions
-    # project_name is used in the ERB
-    html_content = ERB.new(template).result(binding)
-
-    File.write(path, html_content)
-  end
-end

data/tasks/website/version.rb

@@ -1,127 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "rubygems"
-require "fileutils"
-
-class Version
-  def self.all
-    tags = `git tag`.split.grep(/^v\d/)
-    sorted_versions = tags.map { |t| Tagged.new(t) }
-      .sort_by(&:semver)
-      .reverse
-
-    # Keep only the latest patch for each minor version
-    # e.g., if we have v0.6.0, v0.6.1, v0.6.2, only keep v0.6.2
-    latest_per_minor = sorted_versions
-      .group_by { |v| v.semver.segments[0..1] } # group by [major, minor]
-      .values
-      .map(&:first) # take the first (highest patch) from each group
-
-    [Edge.new] + latest_per_minor
-  end
-
-  def slug
-    raise NotImplementedError
-  end
-
-  def name
-    raise NotImplementedError
-  end
-
-  def type
-    raise NotImplementedError
-  end
-
-  def checkout(globs:, &block)
-    raise NotImplementedError
-  end
-
-  def latest?
-    false
-  end
-
-  def edge?
-    false
-  end
-end
-
-class Edge < Version
-  def slug
-    "trunk"
-  end
-
-  def name
-    "trunk"
-  end
-
-  def type
-    :edge
-  end
-
-  def edge?
-    true
-  end
-
-  def checkout(globs:, &block)
-    Dir.mktmpdir do |path|
-      # Use git ls-files for accurate source list
-      files = `git ls-files`.split("\n").select do |f|
-        globs.any? { |glob| File.fnmatch(glob, f, File::FNM_PATHNAME) }
-      end
-
-      files.each do |file|
-        dest = File.join(path, file)
-        next unless File.exist?(file) # Skip files that are in the index but deleted in the working tree
-        FileUtils.mkdir_p(File.dirname(dest))
-        FileUtils.cp(file, dest)
-      end
-
-      yield path
-    end
-  end
-end
-
-class Tagged < Version
-  attr_reader :tag
-
-  def initialize(tag)
-    @tag = tag
-  end
-
-  def slug
-    segments = semver.segments
-    "v#{segments[0]}.#{segments[1]}"
-  end
-
-  def name
-    @tag
-  end
-
-  def type
-    :version
-  end
-
-  def semver
-    Gem::Version.new(@tag.sub(/^v/, ""))
-  end
-
-  attr_accessor :is_latest
-
-  def latest?
-    @is_latest
-  end
-
-  def checkout(globs:, &block)
-    Dir.mktmpdir do |path|
-      system("git archive #{@tag} | tar -x -C #{path}")
-      # We could enforce globs here too, but git archive is usually sufficient.
-      FileUtils.rm_rf("#{path}/ext")
-      yield path
-    end
-  end
-end