ratatui_ruby 1.3.0 → 1.4.0

data/tasks/bump/patch_release.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require_relative "bump_workflow"
-
-# PatchRelease performs a patch release on the current release branch.
-class PatchRelease < BumpWorkflow
-  private def prepare(segment)
-    puts "Bumping #{segment}: #{@gem.version} -> #{target}"
-  end
-
-  private def finalize
-    puts "\nCommitted. Push and run: bundle exec rake release"
-  end
-end

data/tasks/bump/release_branch.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-# ReleaseBranch represents a release/X.Y branch for a version series.
-class ReleaseBranch < Data.define(:major, :minor)
-  def self.for_version(semver)
-    new(semver.major, semver.minor)
-  end
-
-  def name
-    "release/#{major}.#{minor}"
-  end
-end

data/tasks/bump/release_from_trunk.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 "bump_workflow"
-require_relative "release_branch"
-
-# ReleaseFromTrunk creates a release branch, releases there, syncs trunk, returns to release branch.
-class ReleaseFromTrunk < BumpWorkflow
-  private def prepare(segment)
-    @branch = ReleaseBranch.for_version(target)
-
-    puts "Creating release branch: #{@branch.name}"
-    puts "Bumping #{segment}: #{@gem.version} -> #{target}"
-
-    @repository.create_branch(@branch.name)
-  end
-
-  private def release_on_branch
-    super
-    puts "\nCommitted on #{@branch.name}."
-
-    # Capture for trunk import
-    @released_changelog_content = File.read("CHANGELOG.md")
-  end
-
-  private def finalize
-    sync_trunk
-    return_to_release_branch
-  end
-
-  private def sync_trunk
-    @repository.checkout("trunk")
-    trunk_changelog = Changelog.new
-    trunk_changelog.import_release(target, @released_changelog_content)
-    @gem.update_version(target)
-    generate_ci_manifests
-    @repository.commit_all("chore: import v#{target} to trunk")
-    puts "Committed on trunk."
-  end
-
-  private def return_to_release_branch
-    @repository.checkout(@branch.name)
-    puts "\nBack on #{@branch.name}. Review, push both branches, then: bundle exec rake release"
-  end
-end

data/tasks/bump/repository.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
-#++
-
-require "shellwords"
-require "tmpdir"
-
-class Repository
-  TRUNK = "trunk"
-
-  def on_trunk? = current_branch == TRUNK
-
-  def current_branch
-    `git branch --show-current`.strip
-  end
-
-  def create_branch(name)
-    system("git checkout -b #{name}", exception: true)
-  end
-
-  def checkout(name)
-    system("git checkout #{name}", exception: true)
-  end
-
-  def assert_can_bump!(segment)
-    assert_pristine!
-
-    if on_trunk? && segment == :patch
-      raise ArgumentError, "Cannot bump:patch from trunk. Use a release branch."
-    end
-
-    if !on_trunk? && [:minor, :major].include?(segment)
-      raise ArgumentError, "Cannot bump:#{segment} from #{current_branch}. Switch to trunk first."
-    end
-  end
-
-  def assert_pristine!
-    return if `git status --porcelain`.strip.empty?
-
-    raise ArgumentError, "Working tree is not clean. Commit or stash changes first."
-  end
-
-  def commit_all(message)
-    msg_file = File.join(Dir.tmpdir, "ratatui_ruby_commit_msg_#{$$}.txt")
-    system("git add -A", exception: true)
-    File.write(msg_file, message)
-    system("git commit -F #{msg_file.shellescape}", exception: true)
-  ensure
-    File.delete(msg_file) if msg_file && File.exist?(msg_file)
-  end
-end

data/tasks/bump/ruby_gem.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-# RubyGem knows how to update its version: manifests, lockfiles.
-class RubyGem
-  def initialize(manifests:, lockfile:)
-    raise ArgumentError, "Must have exactly one primary manifest" unless manifests.count(&:primary) == 1
-    @manifests = manifests
-    @lockfile = lockfile
-  end
-
-  def version
-    @manifests.find(&:primary).version
-  end
-
-  def update_version(target)
-    @manifests.each { |manifest| manifest.write(target) }
-    @lockfile.refresh
-    refresh_bundler_lockfile
-  end
-
-  private def refresh_bundler_lockfile
-    system("bundle install", exception: true)
-  end
-end

data/tasks/bump/sem_ver.rb

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-# See https://semver.org/spec/v2.0.0.html
-class SemVer
-  SEGMENTS = [:major, :minor, :patch].freeze
-
-  def self.parse(string)
-    require "rubygems"
-    # Extract prerelease suffix (e.g., "-beta.1", "-alpha.2", "-rc.1")
-    base, prerelease = string.split("-", 2)
-    segments = Gem::Version.new(base).segments.fill(0, 3).first(3)
-    new(segments, prerelease:)
-  end
-
-  def initialize(segments, prerelease: nil)
-    @segments = segments
-    @prerelease = prerelease
-  end
-
-  def major = @segments[0]
-  def minor = @segments[1]
-  def patch = @segments[2]
-
-  def next(segment)
-    index = SEGMENTS.index(segment)
-    raise ArgumentError, "Invalid segment: #{segment}" unless index
-
-    new_segments = @segments.dup
-    new_segments[index] += 1
-    new_segments.fill(0, (index + 1)..2)
-
-    SemVer.new(new_segments)
-  end
-
-  def to_s
-    base = @segments.join(".")
-    @prerelease ? "#{base}-#{@prerelease}" : base
-  end
-end

data/tasks/bump/unreleased_section.rb

@@ -1,73 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "date"
-require "rdoc"
-
-# UnreleasedSection manages the [Unreleased] section of the changelog.
-class UnreleasedSection
-  PATTERN = /^(## \[Unreleased\].*?)(?=## \[\d)/m
-
-  # Extracts the unreleased section from the given content.
-  def self.parse(content)
-    match = content.match(PATTERN)
-    new(match[1].strip) if match
-  end
-
-  # Creates a new UnreleasedSection from the given unreleased content.
-  def initialize(content)
-    @content = content.dup
-  end
-
-  # Returns the unreleased content as a versioned section.
-  def as_version(new_version)
-    date = Date.today.iso8601
-    @content.sub(/^## \[Unreleased\]/, "## [#{new_version}] - #{date}")
-  end
-
-  # Returns a fresh unreleased section.
-  def self.fresh
-    new("## [Unreleased]\n\n### Added\n\n### Changed\n\n### Fixed\n\n### Removed")
-  end
-
-  # Returns the current state of the section as a string.
-  def to_s
-    @content
-  end
-
-  def commit_body
-    formatter = Class.new { include RDoc::Text }.new
-    @content
-      .sub(/^## \[Unreleased\].*$/, "")
-      .gsub(/^### (Added|Changed|Fixed|Removed)\n*$/, "")
-      .gsub(/^- \*\*([^*]+)\*\*:/, '\1:')
-      .gsub(/`([^`]+)`/, '\1')
-      .strip
-      .lines
-      .map { |line| line.gsub(/^- /, "").strip }
-      .reject(&:empty?)
-      .map { |line| formatter.wrap(line, 72) }
-      .join("\n\n")
-  end
-
-  # Returns all changelog entry lines (lines starting with "- ")
-  def entries
-    @content.lines.select { |line| line.strip.start_with?("- ") }.map(&:strip)
-  end
-
-  # Returns a new UnreleasedSection with entries removed that appear in the given list.
-  def without_entries(entries_to_remove)
-    return self if entries_to_remove.empty?
-
-    new_lines = @content.lines.reject do |line|
-      stripped = line.strip
-      entries_to_remove.include?(stripped)
-    end
-
-    self.class.new(new_lines.join)
-  end
-end

data/tasks/bump.rake

@@ -1,61 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "rubygems"
-
-require_relative "bump/sem_ver"
-require_relative "bump/manifest"
-require_relative "bump/cargo_lockfile"
-require_relative "bump/ruby_gem"
-require_relative "bump/release_from_trunk"
-require_relative "bump/patch_release"
-
-namespace :bump do
-  gem = RubyGem.new(
-    manifests: [
-      Manifest.new(
-        path: "lib/ratatui_ruby/version.rb",
-        pattern: /(?<=VERSION = ")[^"]+(?=")/,
-        primary: true
-      ),
-      Manifest.new(
-        path: "ext/ratatui_ruby/Cargo.toml",
-        pattern: /(?<=^version = ")[^"]+(?=")/,
-        primary: false
-      ),
-    ],
-    lockfile: CargoLockfile.new(
-      path: "ext/ratatui_ruby/Cargo.lock",
-      dir: "ext/ratatui_ruby",
-      name: "ratatui_ruby"
-    )
-  )
-
-  desc "Bump major version"
-  task :major do
-    ReleaseFromTrunk.new(gem:).call(:major)
-  end
-
-  desc "Bump minor version"
-  task :minor do
-    ReleaseFromTrunk.new(gem:).call(:minor)
-  end
-
-  desc "Bump patch version"
-  task :patch do
-    PatchRelease.new(gem:).call(:patch)
-  end
-
-  desc "Set exact version (e.g. rake bump:exact[0.1.0])"
-  task :exact, [:version] do |_, args|
-    target = SemVer.parse(args[:version])
-    changelog = Changelog.new
-    changelog.release(target)
-    gem.update_version(target)
-    Rake::Task["sourcehut"].invoke
-  end
-end

data/tasks/doc/documentation.rb

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "pathname"
-require_relative "source_file"
-
-# All documentation files in the project.
-#
-# Projects contain many files. Only some are documentation: Ruby source with
-# RDoc, Markdown guides, RDoc text files. Finding them manually is tedious.
-# Missing files means missing broken links.
-#
-# Documentation enumerates all relevant files. It excludes vendor and temp
-# directories. It wraps each path in a SourceFile for link extraction.
-#
-# === Example
-#
-#   docs = Documentation.new("/project/root")
-#   docs.each do |file|
-#     file.links.each { |link| puts link.raw }
-#   end
-#   docs.count  # => 392
-#
-class Documentation
-  include Enumerable
-
-  # File extensions to scan for links.
-  EXTENSIONS = %w[rb md rdoc].freeze
-
-  # Directories to skip.
-  EXCLUDES = %w[/vendor/ /tmp/].freeze
-
-  # Creates a new Documentation collection.
-  #
-  # [root] Project root directory to scan.
-  def initialize(root)
-    @root = Pathname.new(root)
-  end
-
-  # Yields each SourceFile in the project.
-  def each(&)
-    files.each(&)
-  end
-
-  private def files # :nodoc:
-    @files ||= EXTENSIONS.flat_map { |ext| glob(ext) }
-  end
-
-  private def glob(extension) # :nodoc:
-    Dir.glob(@root.join("**/*.#{extension}")).filter_map do |path|
-      next if EXCLUDES.any? { |exclude| path.include?(exclude) }
-      SourceFile.new(path, @root)
-    end
-  end
-end

data/tasks/doc/link/file_url.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_relative "../problem"
-
-# A <tt>file://</tt> URL in documentation.
-#
-# IDEs generate these links for local file access. They work on your machine.
-# They break for everyone else. Published docs cannot contain local paths.
-#
-# FileUrl always returns a Problem. There is no valid use case for
-# <tt>file://</tt> URLs in published documentation.
-#
-# === Example
-#
-#   link = FileUrl.new("file:///path/to/file.rb", 10, source_file)
-#   link.problem(root)  # => Problem (always)
-#
-class FileUrl < Link
-  # Returns a Problem. <tt>file://</tt> URLs never work in published docs.
-  #
-  # [_root] Unused. Present for interface compatibility.
-  def problem(_root)
-    Problem.new(self, "file:// URLs won't work when published")
-  end
-end

data/tasks/doc/link/relative_path.rb

@@ -1,61 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "pathname"
-
-require_relative "../problem"
-
-# A relative path to a local file.
-#
-# Documentation references sibling files: images, other docs, source code.
-# Files get renamed. Directories restructure. These paths silently break.
-#
-# RelativePath resolves the path against the project root and checks if the
-# target exists. It also handles RDoc's HTML naming convention (converting
-# <tt>foo_rb.html</tt> back to <tt>foo.rb</tt> for validation).
-#
-# === Example
-#
-#   link = RelativePath.new("../images/diagram.png", 20, source_file)
-#   link.problem(root)  # => nil (file exists) or Problem (missing)
-#
-class RelativePath < Link
-  # Returns a Problem if the target file does not exist. Returns <tt>nil</tt>
-  # if the path resolves to an existing file or directory.
-  #
-  # [root] Project root directory for resolving absolute paths.
-  def problem(root)
-    root = Pathname.new(root)
-    resolved = resolve(root)
-    return nil unless resolved
-
-    Problem.new(self, "File not found: #{resolved.relative_path_from(root)}") unless exists?(resolved)
-  end
-
-  private def exists?(resolved) # :nodoc:
-    return true if resolved.exist?
-
-    # RDoc generates foo_rb.html from foo.rb
-    if raw.end_with?("_rb.html")
-      source = Pathname.new(resolved.to_s.sub(/_rb\.html$/, ".rb"))
-      return true if source.exist?
-    end
-
-    resolved.directory? if raw.end_with?("/")
-  end
-
-  private def resolve(root) # :nodoc:
-    path = raw.split("#").first&.split("?")&.first
-    return nil if path.nil? || path.empty? || path.length < 4
-
-    if path.start_with?("/")
-      root.join(path.delete_prefix("/"))
-    else
-      source_file.path.dirname.join(path)
-    end
-  end
-end

data/tasks/doc/link/web_url.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-require "net/http"
-require "uri"
-
-require_relative "../problem"
-
-# An HTTP or HTTPS URL in documentation.
-#
-# External links rot. Servers go offline. Pages move. A link that worked last
-# year may 404 today. Manual verification is slow and error-prone.
-#
-# WebUrl checks reachability by making a HEAD request. It returns a Problem if
-# the server responds with an error or is unreachable.
-#
-# === Example
-#
-#   link = WebUrl.new("https://example.com", 15, source_file)
-#   link.web?           # => true
-#   link.problem(root)  # => nil (site is up) or Problem (site is down)
-#
-class WebUrl < Link
-  # Whether this link points to a web URL. Always <tt>true</tt> for WebUrl.
-  def web?
-    true
-  end
-
-  # Returns a Problem if the URL is unreachable. Returns <tt>nil</tt> if the
-  # server responds with a 2xx or 3xx status.
-  #
-  # [_root] Unused. Present for interface compatibility.
-  def problem(_root)
-    Problem.new(self, "URL returned error or is unreachable") unless reachable?
-  end
-
-  private def reachable? # :nodoc:
-    uri = URI.parse(raw)
-    return false unless uri.is_a?(URI::HTTP) || uri.is_a?(URI::HTTPS)
-
-    http = Net::HTTP.new(uri.host, uri.port)
-    http.use_ssl = uri.scheme == "https"
-    http.open_timeout = 5
-    http.read_timeout = 5
-
-    response = http.request_head(uri.request_uri)
-    response.code.to_i < 400
-  rescue
-    false
-  end
-end

data/tasks/doc/link.rb

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-#--
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-#++
-
-# Base class for links found in documentation.
-#
-# Documentation contains links: URLs, file paths, images. These links break.
-# Pages move. Files get renamed. Servers go offline. Manual checking is tedious.
-#
-# Link is the base type. It holds the raw text, line number, and source file.
-# Subclasses (FileUrl, WebUrl, RelativePath) implement <tt>problem</tt> to
-# detect specific breakage.
-#
-# Use <tt>Link.build</tt> to create the correct subclass based on the raw text.
-#
-# === Example
-#
-#   link = Link.build("https://example.com", 42, source_file)
-#   link.web?      # => true
-#   link.problem(root)  # => nil or Problem
-#
-class Link < Data.define(:raw, :line, :source_file)
-  # Creates the appropriate Link subclass based on the raw text.
-  #
-  # [raw] The raw link text extracted from the file.
-  # [line] Line number where the link appears.
-  # [source_file] The SourceFile containing this link.
-  def self.build(raw, line, source_file)
-    if raw.start_with?("file://")
-      FileUrl.new(raw, line, source_file)
-    elsif raw.start_with?("https://", "http://")
-      WebUrl.new(raw, line, source_file)
-    else
-      RelativePath.new(raw, line, source_file)
-    end
-  end
-
-  # Whether this link points to a web URL.
-  #
-  # WebUrl overrides this to return <tt>true</tt>. Other link types return
-  # <tt>false</tt>. The audit uses this to decide whether to skip verification.
-  def web?
-    false
-  end
-end
-
-require_relative "link/file_url"
-require_relative "link/web_url"
-require_relative "link/relative_path"