ratatui_ruby 1.3.0 → 1.4.0

data/migrate_to_buffer.rb

@@ -1,145 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-# !/usr/bin/env ruby
-
-# Migration script to refactor widget renderers from Frame to Buffer
-
-require "fileutils"
-
-WIDGETS_DIR = "/Users/kerrick/Developer/ratatui_ruby/ext/ratatui_ruby/src/widgets"
-
-# Files to update (excluding block.rs which is already done)
-WIDGET_FILES = %w[
-  barchart.rs
-  calendar.rs
-  canvas.rs
-  center.rs
-  chart.rs
-  clear.rs
-  cursor.rs
-  gauge.rs
-  layout.rs
-  line_gauge.rs
-  list.rs
-  overlay.rs
-  paragraph.rs
-  ratatui_logo.rs
-  ratatui_mascot.rs
-  scrollbar.rs
-  sparkline.rs
-  table.rs
-  tabs.rs
-].freeze
-
-def migrate_file(filepath)
-  puts "Migrating #{File.basename(filepath)}..."
-
-  content = File.read(filepath)
-  original_content = content.dup
-
-  # 1. Update function signature
-  content.gsub!("pub fn render(frame: &mut Frame,", "pub fn render(buffer: &mut Buffer,")
-  content.gsub!("pub fn render_ratatui_mascot(frame: &mut Frame,", "pub fn render_ratatui_mascot(buffer: &mut Buffer,")
-
-  # 2. Update imports - Add Buffer, remove Frame
-  # Handle various import patterns
-  content.gsub!(/use ratatui::\{([^}]*),\s*Frame\s*\};/, 'use ratatui::{\1};')
-  content.gsub!(/use ratatui::\{Frame,\s*([^}]*)\};/, 'use ratatui::{\1};')
-  content.gsub!("use ratatui::Frame;", "")
-
-  # Add Buffer import if not present
-  unless content.match?(/use ratatui::(?:\{[^}]*)?buffer::Buffer/)
-    # Find the ratatui use statement and add buffer::Buffer
-    content.gsub!("use ratatui::{", "use ratatui::{buffer::Buffer, ")
-    content.gsub!("use ratatui::layout::Rect;", "use ratatui::{buffer::Buffer, layout::Rect};")
-  end
-
-  # 3. Update widget.render calls
-  # frame.render_widget(widget, area) → widget.render(area, buffer)
-  content.gsub!(/frame\.render_widget\(([^,]+),\s*([^)]+)\)/, '\1.render(\2, buffer)')
-
-  # 4. Update direct buffer access
-  content.gsub!("frame.buffer_mut()", "buffer")
-
-  # 5. Update recursive render_node calls
-  content.gsub!("render_node(frame,", "render_node(buffer,")
-
-  # 5.5. Update stateful widget rendering
-  # frame.render_stateful_widget(widget, area, state) → StatefulWidget::render(widget, area, buffer, state)
-  content.gsub!(/frame\.render_stateful_widget\(([^,]+),\s*([^,]+),\s*([^)]+)\)/, 'StatefulWidget::render(\1, \2, buffer, \3)')
-
-  # Add StatefulWidget import if stateful widgets are used
-  if content.match?(/StatefulWidget::render/) && !content.match?(/use ratatui::widgets::StatefulWidget/) && content.match?(/use ratatui::/)
-    content.sub!("use ratatui::{", "use ratatui::{widgets::StatefulWidget, ")
-  end
-
-  # 6. Clean up any double-added Buffer imports and duplicate Widget imports
-  content.gsub!(/buffer::Buffer,\s*buffer::Buffer,/, "buffer::Buffer,")
-  content.gsub!(/widgets::Widget,\s*widgets::Widget/, "widgets::Widget")
-  content.gsub!(/(use ratatui::\{[^}]*widgets::Widget[^}]*),\s*widgets::Widget/, '\1')
-
-  # 7. Fix Widget trait usage - make sure Widget is imported where .render is called
-  # Add Widget to imports if calling .render on widgets
-  if content.match?(/\.render\(area,\s*buffer\)/) && !content.match?(/use ratatui::widgets::Widget/) && content.match?(/use ratatui::\{/) && !content.match?(/widgets::Widget/)
-    content.sub!("use ratatui::{", "use ratatui::{widgets::Widget, ")
-  end
-
-  # 8. For files that don't have proper Buffer imports yet, add them
-  if !content.match?(/use ratatui::\{[^}]*buffer::Buffer/) && content.match?(/use ratatui::/)
-    # Try to add to first ratatui import
-    content.sub!("use ratatui::", "use ratatui::{buffer::Buffer};\nuse ratatui::")
-  end
-
-  # 9. Special case: cursor.rs uses frame.set_cursor_position which doesn't exist on Buffer
-  # Cursor widget needs special handling - it can't work with just Buffer
-  if File.basename(filepath) == "cursor.rs"
-    puts "  ⚠ cursor.rs requires special handling - skipping set_cursor_position"
-    # This widget can't be fully migrated as set_cursor_position is Frame-only
-    # Will need manual fix or different approach
-  end
-  # Only write if content changed
-  if content != original_content
-    File.write(filepath, content)
-    puts "  ✓ Updated #{File.basename(filepath)}"
-    true
-  else
-    puts "  - No changes needed for #{File.basename(filepath)}"
-    false
-  end
-end
-
-def main
-  puts "Starting widget renderer migration..."
-  puts "=" * 60
-
-  updated_count = 0
-
-  WIDGET_FILES.each do |filename|
-    filepath = File.join(WIDGETS_DIR, filename)
-
-    unless File.exist?(filepath)
-      puts "  ⚠ File not found: #{filename}"
-      next
-    end
-
-    # Create backup
-    backup_path = "#{filepath}.premigration"
-    FileUtils.cp(filepath, backup_path) unless File.exist?(backup_path)
-
-    updated_count += 1 if migrate_file(filepath)
-  end
-
-  puts "=" * 60
-  puts "Migration complete!"
-  puts "  Files updated: #{updated_count}/#{WIDGET_FILES.length}"
-  puts "\nBackups saved with .premigration extension"
-  puts "Run 'bundle exec rake compile' to verify the changes"
-end
-
-main if __FILE__ == $PROGRAM_NAME

data/mise.toml

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

data/tasks/autodoc/examples.rb

@@ -1,87 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-module Autodoc
-  class Examples
-    def self.sync
-      new.sync
-    end
-
-    def sync
-      Dir.glob("{README.md,doc/**/*.md,examples/*/README.md}").each do |readme_path|
-        sync_readme(readme_path)
-      end
-    end
-
-    private def sync_readme(readme_path)
-      content = File.read(readme_path)
-      dir = File.dirname(readme_path)
-
-      new_content = content.gsub(/<!-- SYNC:START:([^ ]+) -->.*?<!-- SYNC:END -->/m) do
-        marker_info = $1
-        source_rel_path, segment_id = marker_info.split(":")
-
-        # Support both repo-root-relative paths (no leading ./) and file-relative paths
-        source_path = if source_rel_path.start_with?("./", "../")
-          File.join(dir, source_rel_path)
-        else
-          source_rel_path # Already relative to repo root
-        end
-
-        unless File.exist?(source_path)
-          warn "Warning: Source file not found: #{source_path}"
-          next $&
-        end
-
-        source_content = File.read(source_path)
-        extracted_content = if segment_id
-          extract_segment(source_content, segment_id, source_path)
-        else
-          source_content
-        end
-
-        # Detect language from extension
-        ext = File.extname(source_path).delete(".")
-        lang = (ext == "rb") ? "ruby" : ext
-
-        # Build replacement
-        "<!-- SYNC:START:#{marker_info} -->\n```#{lang}\n#{extracted_content}```\n<!-- SYNC:END -->"
-      end
-
-      if new_content != content
-        puts "Syncing #{readme_path}..."
-        File.write(readme_path, new_content)
-      end
-    end
-
-    def extract_segment(content, segment_id, source_path)
-      start_marker = /#\s*\[SYNC:START:#{segment_id}\]/
-      end_marker = /#\s*\[SYNC:END:#{segment_id}\]/
-
-      lines = content.lines
-      start_idx = lines.find_index { |l| l =~ start_marker }
-      end_idx = lines.find_index { |l| l =~ end_marker }
-
-      if start_idx && end_idx
-        "#{unindent(lines[(start_idx + 1)...end_idx].join).strip}\n"
-      else
-        warn "Warning: Segment '#{segment_id}' not found in #{source_path}"
-        content # Fallback to full content or error? Let's fallback to original for now.
-      end
-    end
-
-    def unindent(text)
-      lines = text.lines
-      # Don't unindent if empty or just one line
-      return text if lines.empty?
-
-      # Find common leading whitespace
-      indentation = lines.grep(/\S/).map { |l| l[/^\s*/].length }.min || 0
-      lines.map { |l| (l.length > indentation) ? l[indentation..-1] : "#{l.strip}\n" }.join
-    end
-  end
-end

data/tasks/autodoc/member.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
-#++
-
-module Autodoc
-  module Member
-    class Delegate < Data.define(:name)
-      def rbs
-        "    def #{name}: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped"
-      end
-
-      def rdoc
-        [
-          "    # :method: #{name}",
-          "    # :call-seq: #{name}(*args, **kwargs, &block)",
-          "    #",
-          "    # Delegates to RatatuiRuby.#{name}.",
-          "    #",
-        ]
-      end
-    end
-
-    class Factory < Data.define(:name, :const_name)
-      def rbs
-        "    def #{name}: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped"
-      end
-
-      def rdoc
-        [
-          "    # :method: #{name}",
-          "    # :call-seq: #{name}(*args, **kwargs, &block)",
-          "    #",
-          "    # Factory for RatatuiRuby::#{const_name}.new.",
-          "    #",
-        ]
-      end
-    end
-
-    class Helper < Data.define(:name, :class_method, :const_name)
-      def rbs
-        "    def #{name}: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped"
-      end
-
-      def rdoc
-        [
-          "    # :method: #{name}",
-          "    # :call-seq: #{name}(*args, **kwargs, &block)",
-          "    #",
-          "    # Helper for RatatuiRuby::#{const_name}.#{class_method}.",
-          "    #",
-        ]
-      end
-    end
-  end
-end

data/tasks/autodoc/name.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-module Autodoc
-  class Name < Data.define(:string)
-    def snake
-      string.to_s
-        .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
-        .gsub(/([a-z\d])([A-Z])/, '\1_\2')
-        .downcase
-    end
-
-    def to_s
-      string.to_s
-    end
-  end
-end

data/tasks/autodoc.rake

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require_relative "autodoc/examples"
-
-namespace :autodoc do
-  desc "Update all automatically generated documentation"
-  task all: [:examples]
-
-  desc "Sync code snippets in example READMEs with source files"
-  task :examples do
-    Autodoc::Examples.sync
-  end
-end
-
-desc "Update all automatically generated documentation"
-task autodoc: "autodoc:all"

data/tasks/bump/bump_workflow.rb

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require_relative "repository"
-require_relative "changelog"
-
-# Base class for version bump workflows.
-# Subclasses implement the template methods: prepare, release_on_branch, finalize.
-class BumpWorkflow
-  def initialize(gem:, repository: Repository.new)
-    @gem = gem
-    @repository = repository
-  end
-
-  def call(segment)
-    @repository.assert_can_bump!(segment)
-    @target = @gem.version.next(segment)
-
-    prepare(segment)
-    release_on_branch
-    finalize
-  end
-
-  attr_reader :target
-
-  private def release_on_branch
-    changelog = Changelog.new
-    @commit_message = changelog.commit_message(target)
-    changelog.release(target)
-    @gem.update_version(target)
-    generate_ci_manifests
-    @repository.commit_all(@commit_message)
-  end
-
-  private def generate_ci_manifests
-    Rake::Task["sourcehut:build:manifest"].reenable
-    Rake::Task["sourcehut:build"].reenable
-    Rake::Task["sourcehut"].reenable
-    Rake::Task["sourcehut"].invoke
-  end
-
-  # Template methods for subclasses
-  private def prepare(segment) = nil
-  private def finalize = nil
-end

data/tasks/bump/cargo_lockfile.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-# Lockfiles need to be refreshed by a tool after Manifests are changed.
-class CargoLockfile < Data.define(:path, :dir, :name)
-  def exists?
-    File.exist?(path)
-  end
-
-  def refresh
-    return unless exists?
-
-    Dir.chdir(dir) do
-      system("cargo update -p #{name} --offline")
-    end
-  end
-end

data/tasks/bump/changelog.rb

@@ -1,104 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require_relative "links"
-require_relative "unreleased_section"
-require_relative "history"
-require_relative "header"
-
-# Changelog manages the project's CHANGELOG.md file.
-class Changelog
-  # Creates a new Changelog for the file at the given path.
-  def initialize(path: "CHANGELOG.md")
-    @path = path
-  end
-
-  # Releases a new version in the changelog.
-  # This moves the unreleased changes to a new version heading and resets the unreleased section.
-  def release(new_version)
-    content = File.read(@path)
-
-    header = Header.parse(content)
-    unreleased = UnreleasedSection.parse(content)
-    links = Links.from_markdown(content)
-
-    raise "Could not parse CHANGELOG.md" unless header && unreleased && links
-
-    history = History.parse(content, header.length, unreleased.to_s.length, links.to_s)
-
-    links.release(new_version)
-    history.add(unreleased.as_version(new_version))
-
-    File.write(@path, "#{header}#{UnreleasedSection.fresh}\n\n#{history}\n#{links}")
-    nil
-  end
-
-  # Removes entries from [Unreleased] that were released in the given version.
-  # Used when creating a release branch from trunk.
-  def prune_released_entries(released_entries)
-    content = File.read(@path)
-
-    header = Header.parse(content)
-    unreleased = UnreleasedSection.parse(content)
-    links = Links.from_markdown(content)
-
-    raise "Could not parse CHANGELOG.md" unless header && unreleased && links
-
-    history = History.parse(content, header.length, unreleased.to_s.length, links.to_s)
-
-    pruned = unreleased.without_entries(released_entries)
-
-    File.write(@path, "#{header}#{pruned}\n\n#{history}\n#{links}")
-    nil
-  end
-
-  # Imports a release section from another branch's changelog.
-  # Adds the version section to history and dedupes from [Unreleased].
-  # Uses "first wins" — if entry already deduped, doesn't re-add it.
-  def import_release(version, release_changelog_content)
-    release_section = extract_version_section(release_changelog_content, version)
-    return unless release_section
-
-    content = File.read(@path)
-
-    header = Header.parse(content)
-    unreleased = UnreleasedSection.parse(content)
-    links = Links.from_markdown(content)
-
-    raise "Could not parse CHANGELOG.md" unless header && unreleased && links
-
-    history = History.parse(content, header.length, unreleased.to_s.length, links.to_s)
-
-    # Add the release section to history (inserted in version order)
-    history.add(release_section)
-    links.release(version)
-
-    # Dedupe from [Unreleased] (first-wins: if already gone, no-op)
-    release_entries = release_section.lines.select { |l| l.strip.start_with?("- ") }.map(&:strip)
-    pruned = unreleased.without_entries(release_entries)
-
-    File.write(@path, "#{header}#{pruned}\n\n#{history}\n#{links}")
-    nil
-  end
-
-  def commit_message(version)
-    content = File.read(@path)
-    unreleased = UnreleasedSection.parse(content)
-    return nil unless unreleased
-
-    "chore: release v#{version}\n\n#{unreleased.commit_body}"
-  end
-
-  private def extract_version_section(changelog_content, version)
-    # Match the version heading and capture until the next version heading or links section
-    pattern = /^## \[#{Regexp.escape(version.to_s)}\][^\n]*\n(.*?)(?=^## \[|\n\[Unreleased\]:)/m
-    match = changelog_content.match(pattern)
-    return nil unless match
-
-    "## [#{version}]#{match[0].split("\n", 2).first.split(']', 2).last}\n#{match[1]}"
-  end
-end

data/tasks/bump/header.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-# Header manages the header section of the changelog.
-class Header
-  PATTERN = /^(.*?)(?=## \[Unreleased\])/m
-
-  # Extracts the header section from the given content.
-  def self.parse(content)
-    match = content.match(PATTERN)
-    new(match[1]) if match
-  end
-
-  # Creates a new Header from the given content.
-  def initialize(content)
-    @content = content.dup
-  end
-
-  # Returns the length of the header content.
-  def length
-    @content.length
-  end
-
-  # Returns the current state of the header as a string.
-  def to_s
-    @content
-  end
-end

data/tasks/bump/history.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-# History manages the versioned history of the changelog.
-class History
-  # Extracts the history section from the given content, between unreleased and links.
-  def self.parse(content, header_length, unreleased_length, links_text)
-    start = header_length + unreleased_length
-    text = "#{content[start...(content.index(links_text))].strip}\n"
-    new(text)
-  end
-
-  # Creates a new History from the given content.
-  def initialize(content)
-    @content = content.dup
-  end
-
-  # Adds a new versioned section to the history.
-  def add(section)
-    @content = "#{"#{section}\n\n#{@content}".strip}\n"
-    nil
-  end
-
-  # Returns the current state of the history as a string.
-  def to_s
-    @content
-  end
-end

data/tasks/bump/links.rb

@@ -1,69 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-# Manages the version comparison links at the botton of the changelog.
-#
-# Release automation needs to update links. Manually calculating git diff URLs
-# for every release is tedious and error-prone. SourceHut does not have
-# standard comparison views, complicating matters further.
-#
-# This class manages the collection of links. It parses them from the markdown.
-# It generates the correct tree links for SourceHut. It properly shifts the
-# "Unreleased" pointer.
-#
-# Use it to update the changelog during a release.
-class Links
-  PATTERN = /^(\[Unreleased\]: .*)$/m
-  UNRELEASED_PATTERN = %r{^\[Unreleased\]: (.*?/refs/)HEAD$}
-
-  # Creates a Links object from the full markdown content.
-  #
-  # [content] String. The full text of the changelog.
-  def self.from_markdown(content)
-    match = content.match(PATTERN)
-    return unless match
-
-    new(match[1].strip)
-  end
-
-  # Returns the raw text of the links.
-  attr_reader :text
-
-  # Creates a new Links object.
-  #
-  # [text] String. The raw text of the links section.
-  def initialize(text)
-    @text = text.dup
-  end
-
-  # Releases a new version.
-  #
-  # Updates the "Unreleased" link to point to the new head. Adds a new link for
-  # the just-released version pointing to its specific tag.
-  #
-  # [version] String. The new version number (e.g., <tt>"0.5.0"</tt>).
-  def release(version)
-    return unless base_url
-
-    new_unreleased = "[Unreleased]: #{base_url}HEAD" # .../HEAD
-    new_version_link = "[#{version}]: #{base_url}v#{version}" # .../v1.0.0
-
-    @text.sub!(UNRELEASED_PATTERN, "#{new_unreleased}\n#{new_version_link}")
-    self
-  end
-
-  # Returns the string representation of the links.
-  def to_s
-    @text
-  end
-
-  # The base URL for the repository's references.
-  private def base_url
-    match = @text.match(UNRELEASED_PATTERN)
-    match[1] if match
-  end
-end

data/tasks/bump/manifest.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-# Manifests hold a copy of the version number and should be changed manually.
-# Use Regexp lookarounds in `pattern` to match the version number.
-class Manifest < Data.define(:path, :pattern, :primary)
-  def read
-    File.read(path)
-  end
-
-  def initialize(path:, pattern:, primary: false)
-    super
-  end
-
-  def version
-    content = read
-    match = content.match(pattern)
-    raise "Version missing in manifest #{path}" unless match
-
-    SemVer.parse(match[0])
-  end
-
-  def write(version)
-    return unless File.exist?(path)
-
-    new_content = read.gsub(pattern, version.to_s)
-    File.write(path, new_content)
-  end
-end