ruby_raider 3.0.1 → 3.2.0

data/lib/scaffolding/url_analyzer.rb

@@ -1,179 +0,0 @@
-# frozen_string_literal: true
-
-require 'uri'
-require 'net/http'
-
-class UrlAnalyzer
-  INTERACTIVE_TAGS = %w[input select textarea button].freeze
-
-  attr_reader :url, :page_name, :elements
-
-  def initialize(url, name_override: nil, ai: false) # rubocop:disable Naming/MethodParameterName
-    @url = url
-    @uri = URI.parse(url)
-    @page_name = name_override || derive_page_name
-    @elements = []
-    @ai = ai
-  end
-
-  def analyze
-    html = fetch_html
-    if @ai
-      ai_elements = analyze_with_llm(html)
-      @elements = ai_elements if ai_elements
-    end
-    parse_elements(html) if @elements.empty?
-    self
-  end
-
-  def to_h
-    { page_name: @page_name, url: @url, url_path: @uri.path, elements: @elements }
-  end
-
-  private
-
-  def fetch_html
-    response = Net::HTTP.get_response(@uri)
-    response.body
-  rescue StandardError => e
-    raise "Failed to fetch #{@url}: #{e.message}"
-  end
-
-  def parse_elements(html)
-    # Simple regex-based HTML parsing (no external dependency needed)
-    parse_inputs(html)
-    parse_selects(html)
-    parse_textareas(html)
-    parse_buttons(html)
-    parse_links(html)
-  end
-
-  def parse_inputs(html)
-    html.scan(/<input\s+([^>]*)>/i).each do |match|
-      attrs = parse_attributes(match[0])
-      next if %w[hidden submit].include?(attrs['type'])
-
-      @elements << build_element(
-        name: attrs['name'] || attrs['id'] || attrs['placeholder'] || 'input',
-        type: :input,
-        input_type: attrs['type'] || 'text',
-        locator: best_locator(attrs)
-      )
-    end
-  end
-
-  def parse_selects(html)
-    html.scan(/<select\s+([^>]*)>/i).each do |match|
-      attrs = parse_attributes(match[0])
-      @elements << build_element(
-        name: attrs['name'] || attrs['id'] || 'select',
-        type: :select,
-        locator: best_locator(attrs)
-      )
-    end
-  end
-
-  def parse_textareas(html)
-    html.scan(/<textarea\s+([^>]*)>/i).each do |match|
-      attrs = parse_attributes(match[0])
-      @elements << build_element(
-        name: attrs['name'] || attrs['id'] || 'textarea',
-        type: :textarea,
-        locator: best_locator(attrs)
-      )
-    end
-  end
-
-  def parse_buttons(html)
-    html.scan(%r{<button\s+([^>]*)>([^<]*)</button>}i).each do |match|
-      attrs = parse_attributes(match[0])
-      text = match[1].strip
-      @elements << build_element(
-        name: attrs['id'] || attrs['name'] || text.downcase.gsub(/\s+/, '_') || 'button',
-        type: :button,
-        text:,
-        locator: best_locator(attrs, text:)
-      )
-    end
-
-    html.scan(/<input\s+([^>]*type=["']submit["'][^>]*)>/i).each do |match|
-      attrs = parse_attributes(match[0])
-      @elements << build_element(
-        name: attrs['id'] || attrs['name'] || attrs['value']&.downcase&.gsub(/\s+/, '_') || 'submit',
-        type: :submit,
-        text: attrs['value'] || 'Submit',
-        locator: best_locator(attrs)
-      )
-    end
-  end
-
-  def parse_links(html)
-    html.scan(%r{<a\s+([^>]*)>([^<]*)</a>}i).first(5)&.each do |match|
-      attrs = parse_attributes(match[0])
-      text = match[1].strip
-      next if text.empty?
-
-      @elements << build_element(
-        name: text.downcase.gsub(/\s+/, '_'),
-        type: :link,
-        text:,
-        locator: best_locator(attrs, text:)
-      )
-    end
-  end
-
-  def parse_attributes(attr_string)
-    attrs = {}
-    attr_string.scan(/([\w-]+)=["']([^"']*)["']/).each do |key, value|
-      attrs[key] = value
-    end
-    attrs
-  end
-
-  def best_locator(attrs, text: nil)
-    if attrs['id']
-      { type: :id, value: attrs['id'] }
-    elsif attrs['name']
-      { type: :name, value: attrs['name'] }
-    elsif attrs['class'] && !attrs['class'].empty?
-      { type: :css, value: ".#{attrs['class'].split.first}" }
-    elsif text && !text.empty?
-      { type: :xpath, value: "//#{infer_tag(attrs)}[contains(text(), '#{text}')]" }
-    else
-      { type: :css, value: attrs.first&.last || 'unknown' }
-    end
-  end
-
-  def infer_tag(attrs)
-    return 'button' if attrs['type'] == 'button' || attrs['type'] == 'submit'
-    return 'a' if attrs['href']
-
-    '*'
-  end
-
-  def build_element(name:, type:, locator:, **extra)
-    clean_name = name.to_s.gsub(/[^a-z0-9_]/i, '_').gsub(/_+/, '_').downcase.delete_prefix('_').delete_suffix('_')
-    { name: clean_name, type:, locator: }.merge(extra)
-  end
-
-  def analyze_with_llm(html)
-    require_relative '../llm/client'
-    require_relative '../llm/prompts'
-    require_relative '../llm/response_parser'
-
-    return nil unless Llm::Client.available?
-
-    response = Llm::Client.complete(
-      Llm::Prompts.analyze_page(html, @url),
-      system_prompt: Llm::Prompts.system_prompt
-    )
-    Llm::ResponseParser.extract_elements(response)
-  end
-
-  def derive_page_name
-    path = @uri.path.to_s.gsub(%r{^/|/$}, '')
-    return 'home' if path.empty?
-
-    path.split('/').last.gsub(/[^a-z0-9]/i, '_').downcase
-  end
-end

data/sig/adopter/adopt_menu.rbs

@@ -1,25 +0,0 @@
-# Type definitions for Adopter::AdoptMenu
-module Adopter
-  class AdoptMenu
-    WEB_AUTOMATIONS: Array[String]
-    TEST_FRAMEWORKS: Array[String]
-    CI_PLATFORMS: Array[String]
-
-    def initialize: () -> void
-    def run: () -> void
-
-    def self.adopt: (Hash[Symbol, untyped] params) -> Hash[Symbol, untyped]
-    def self.validate_params!: (Hash[Symbol, untyped] params) -> void
-
-    private
-
-    def ask_source_path: () -> String
-    def preview_detection: (String source_path) -> Hash[Symbol, untyped]
-    def ask_target_automation: (String? detected) -> String
-    def ask_target_framework: (String? detected) -> String
-    def ask_output_path: () -> String?
-    def ask_ci_platform: (String? detected) -> String?
-    def execute_adoption: (Hash[Symbol, untyped] params) -> void
-    def print_results: (MigrationPlan plan, Hash[Symbol, untyped] results) -> void
-  end
-end

data/sig/adopter/converters/base_converter.rbs

@@ -1,23 +0,0 @@
-# Type definitions for Adopter::Converters::BaseConverter
-module Adopter
-  module Converters
-    class BaseConverter
-      RAIDER_BASE_CLASSES: Array[String]
-
-      def convert_page: (String content, untyped _page_info) -> String
-      def convert_test: (String content, untyped _test_info) -> String
-
-      private
-
-      def ensure_frozen_string_literal: (String content) -> String
-      def update_base_class: (String content, String target_base) -> String
-      def raider_compatible_base?: (String base_class) -> bool
-      def update_require_paths: (String content, String target_automation) -> String
-      def update_page_requires: (String content) -> String
-      def update_helper_requires: (String content, String target_automation) -> String
-      def remove_driver_arg: (String content) -> String
-      def swap_driver_arg: (String content, String target_arg) -> String
-      def driver_arg_for: (String target_automation) -> String?
-    end
-  end
-end

data/sig/adopter/converters/identity_converter.rbs

@@ -1,16 +0,0 @@
-# Type definitions for Adopter::Converters::IdentityConverter
-module Adopter
-  module Converters
-    class IdentityConverter < BaseConverter
-      def initialize: (String target_automation) -> void
-      def convert_page: (String content, untyped _page_info) -> String
-      def convert_test: (String content, untyped _test_info) -> String
-      def convert_step: (String content) -> String
-
-      private
-
-      def add_page_require: (String content) -> String
-      def update_page_instantiation: (String content) -> String
-    end
-  end
-end

data/sig/adopter/migration_plan.rbs

@@ -1,34 +0,0 @@
-# Type definitions for Adopter::MigrationPlan and ConvertedFile
-module Adopter
-  class MigrationPlan
-    attr_reader source_path: String
-    attr_reader output_path: String
-    attr_reader target_automation: String
-    attr_reader target_framework: String
-    attr_reader ci_platform: String?
-    attr_reader skeleton_structure: Hash[Symbol, untyped]
-    attr_reader converted_pages: Array[ConvertedFile]
-    attr_reader converted_tests: Array[ConvertedFile]
-    attr_reader converted_features: Array[ConvertedFile]
-    attr_reader converted_steps: Array[ConvertedFile]
-    attr_reader gemfile_additions: Array[String]
-    attr_reader config_overrides: Hash[String, untyped]
-    attr_reader warnings: Array[String]
-    attr_reader manual_actions: Array[String]
-
-    def initialize: (?Hash[Symbol, untyped]? attrs) -> void
-    def to_h: () -> Hash[Symbol, untyped]
-    def to_json: (*untyped args) -> String
-    def summary: () -> Hash[Symbol, untyped]
-  end
-
-  class ConvertedFile
-    attr_accessor output_path: String
-    attr_accessor content: String
-    attr_accessor source_file: String?
-    attr_accessor conversion_notes: String?
-
-    def initialize: (?output_path: String, ?content: String, ?source_file: String?, ?conversion_notes: String?) -> void
-    def to_h: () -> Hash[Symbol, untyped]
-  end
-end

data/sig/adopter/migrator.rbs

@@ -1,21 +0,0 @@
-# Type definitions for Adopter::Migrator
-module Adopter
-  class Migrator
-    attr_reader plan: MigrationPlan
-    attr_reader results: Hash[Symbol, untyped]
-
-    def initialize: (MigrationPlan plan) -> void
-    def execute: () -> Hash[Symbol, untyped]
-
-    private
-
-    def generate_skeleton: () -> void
-    def write_converted_pages: () -> void
-    def write_converted_tests: () -> void
-    def write_converted_features: () -> void
-    def write_converted_steps: () -> void
-    def write_file: (ConvertedFile converted_file) -> void
-    def merge_gemfile: () -> void
-    def apply_config_overrides: () -> void
-  end
-end

data/sig/adopter/plan_builder.rbs

@@ -1,38 +0,0 @@
-# Type definitions for Adopter::PlanBuilder
-module Adopter
-  class PlanBuilder
-    def initialize: (Hash[Symbol, untyped] analysis, Hash[Symbol, untyped] params) -> void
-    def build: () -> MigrationPlan
-
-    private
-
-    def build_skeleton_structure: () -> Hash[Symbol, untyped]
-    def plan_page_conversions: () -> Array[ConvertedFile]
-    def plan_test_conversions: () -> Array[ConvertedFile]
-    def plan_feature_conversions: () -> Array[ConvertedFile]
-    def plan_step_conversions: () -> Array[ConvertedFile]
-    def convert_page: (String content, Hash[Symbol, untyped] page) -> String
-    def convert_page_dsl: (String content, Hash[Symbol, untyped] page, Symbol source_dsl, String target) -> String
-    def find_page_converter: (Symbol source_dsl, String target) -> (^(String, Hash[Symbol, untyped]) -> String)?
-    def page_converters: () -> Hash[Symbol, ^(String, Hash[Symbol, untyped]) -> String]
-    def convert_test: (String content, Hash[Symbol, untyped] test) -> String
-    def convert_test_framework: (String content, Hash[Symbol, untyped] test, Symbol source_framework, String target) -> String
-    def find_test_converter: (Symbol source_framework, String target) -> (^(String, Hash[Symbol, untyped]) -> String)?
-    def test_converters: () -> Hash[Symbol, ^(String, Hash[Symbol, untyped]) -> String]
-    def identity_converter: () -> Converters::IdentityConverter
-    def restructure_page: (String content) -> String
-    def restructure_test: (String content) -> String
-    def convert_step_page_references: (String content) -> String
-    def raider_page_path: (String class_name) -> String
-    def raider_test_path: (Hash[Symbol, untyped] test) -> String
-    def raider_feature_path: (String source_path) -> String
-    def raider_step_path: (String source_path) -> String
-    def extract_config_overrides: () -> Hash[String, untyped]
-    def same_automation_dsl?: (Symbol source_dsl, String target) -> bool
-    def normalize_dsl: (Symbol dsl) -> String
-    def target_cucumber?: () -> bool
-    def page_conversion_notes: () -> String
-    def test_conversion_notes: (Symbol source_type) -> String
-    def add_warning: (String message) -> void
-  end
-end

data/sig/adopter/project_analyzer.rbs

@@ -1,39 +0,0 @@
-# Type definitions for Adopter::ProjectAnalyzer
-module Adopter
-  class MobileProjectError < StandardError
-  end
-
-  class ProjectAnalyzer
-    KNOWN_FRAMEWORK_GEMS: Array[String]
-    PAGE_DSL_PATTERNS: Hash[Symbol, Regexp]
-    PAGE_CLASS_PATTERNS: Array[Regexp]
-    TEST_FILE_PATTERNS: Hash[Symbol, Hash[Symbol, untyped]]
-    HELPER_ROLES: Hash[Symbol, Regexp]
-
-    def initialize: (String source_path, ?Hash[Symbol, untyped]? overrides) -> void
-    def analyze: () -> Hash[Symbol, untyped]
-
-    private
-
-    def validate_web_only!: (Hash[Symbol, untyped] detection) -> void
-    def discover_pages: () -> Array[Hash[Symbol, untyped]]
-    def discover_tests: () -> Array[Hash[Symbol, untyped]]
-    def discover_helpers: () -> Array[Hash[Symbol, untyped]]
-    def discover_features: () -> Array[Hash[Symbol, untyped]]
-    def discover_step_definitions: () -> Array[Hash[Symbol, untyped]]
-    def discover_custom_gems: () -> Array[String]
-    def detect_page_dsl: () -> Symbol
-    def detect_page_dir: () -> String?
-    def ruby_files_in: (String dir) -> Array[String]
-    def relative_path: (String absolute) -> String
-    def page_like?: (String content) -> bool
-    def extract_class_name: (String content) -> String?
-    def extract_base_class: (String content) -> String?
-    def extract_public_methods: (String content) -> Array[String]
-    def extract_test_methods: (String content, Symbol type) -> Array[String]
-    def extract_modules: (String content) -> Array[String]
-    def detect_helper_role: (String content) -> Symbol
-    def count_scenarios: (String content) -> Integer
-    def count_steps: (String content) -> Integer
-  end
-end

data/sig/adopter/project_detector.rbs

@@ -1,26 +0,0 @@
-# Type definitions for Adopter::ProjectDetector
-module Adopter
-  module ProjectDetector
-    GEM_AUTOMATION_MAP: Hash[String, String]
-    GEM_FRAMEWORK_MAP: Hash[String, String]
-    BROWSERS: Array[String]
-
-    def self?.detect: (String path) -> Hash[Symbol, String?]
-    def self?.detect_automation: (String path) -> String?
-    def self?.detect_framework: (String path) -> String?
-    def self?.detect_page_path: (String path) -> String?
-    def self?.detect_spec_path: (String path) -> String?
-    def self?.detect_feature_path: (String path) -> String?
-    def self?.detect_helper_path: (String path) -> String?
-    def self?.detect_browser: (String path) -> String?
-    def self?.detect_url: (String path) -> String?
-    def self?.detect_ci_platform: (String path) -> String?
-    def self?.parse_gemfile: (String path) -> Array[String]
-
-    private
-
-    def self?.detect_automation_from_requires: (String path) -> String?
-    def self?.find_existing_dir: (String path, Array[String] candidates) -> String?
-    def self?.helper_and_config_files: (String path) -> Array[String]
-  end
-end

data/sig/generators/infrastructure/gitlab_generator.rbs

@@ -1,4 +0,0 @@
-# Type definitions for GitlabGenerator
-class GitlabGenerator < Generator
-  def generate_gitlab_file: () -> void
-end

data/sig/generators/minitest/minitest_generator.rbs

@@ -1,8 +0,0 @@
-# Type definitions for MinitestGenerator
-class MinitestGenerator < Generator
-  def generate_login_test: () -> void
-  def generate_pdp_test: () -> void
-  def generate_visual_test: () -> void
-  def generate_accessibility_test: () -> void
-  def generate_performance_test: () -> void
-end

data/sig/llm/client.rbs

@@ -1,15 +0,0 @@
-# Type definitions for Llm::Client
-module Llm
-  module Client
-    MAX_RETRIES: Integer
-    BASE_DELAY: Integer
-
-    def self?.complete: (String prompt, ?String? system_prompt) -> String?
-    def self?.available?: () -> bool
-    def self?.status: () -> Hash[Symbol, untyped]
-
-    private
-
-    def self?.build_provider: () -> Llm::Provider?
-  end
-end

data/sig/llm/config.rbs

@@ -1,20 +0,0 @@
-# Type definitions for Llm::Config
-module Llm
-  class Config
-    PROVIDERS: Array[String]
-
-    attr_reader provider_name: String?
-    attr_reader api_key: String?
-    attr_reader model: String?
-    attr_reader url: String?
-
-    def initialize: () -> void
-    def configured?: () -> bool
-    def build_provider: () -> Provider?
-
-    private
-
-    def env: (String key) -> String?
-    def config_value: (String key) -> String?
-  end
-end

data/sig/llm/prompts.rbs

@@ -1,8 +0,0 @@
-# Type definitions for Llm::Prompts
-module Llm
-  module Prompts
-    def self?.analyze_page: (String html, String url) -> String
-    def self?.generate_test_scenarios: (String class_name, Array[Hash[Symbol, untyped]] methods, String automation, String framework) -> String
-    def self?.system_prompt: () -> String
-  end
-end

data/sig/llm/provider.rbs

@@ -1,12 +0,0 @@
-# Type definitions for Llm::Provider
-module Llm
-  class Provider
-    def complete: (String prompt, ?system_prompt: String?) -> String?
-    def available?: () -> bool
-    def name: () -> String
-
-    private
-
-    def build_messages: (String prompt, String? system_prompt) -> Array[Hash[String, String]]
-  end
-end

data/sig/llm/providers/anthropic_provider.rbs

@@ -1,16 +0,0 @@
-# Type definitions for Anthropic provider
-module Llm
-  module Providers
-    class AnthropicProvider < Provider
-      DEFAULT_MODEL: String
-
-      def initialize: (api_key: String, ?model: String?) -> void
-      def complete: (String prompt, ?system_prompt: String?) -> String?
-      def available?: () -> bool
-
-      private
-
-      def build_client: () -> untyped
-    end
-  end
-end

data/sig/llm/providers/ollama_provider.rbs

@@ -1,18 +0,0 @@
-# Type definitions for Ollama provider
-module Llm
-  module Providers
-    class OllamaProvider < Provider
-      DEFAULT_MODEL: String
-      DEFAULT_URL: String
-      TIMEOUT: Integer
-
-      def initialize: (?model: String?, ?url: String?) -> void
-      def complete: (String prompt, ?system_prompt: String?) -> String?
-      def available?: () -> bool
-
-      private
-
-      def post_request: (URI::Generic uri, Hash[Symbol, untyped] body) -> Net::HTTPResponse
-    end
-  end
-end

data/sig/llm/providers/openai_provider.rbs

@@ -1,16 +0,0 @@
-# Type definitions for OpenAI provider
-module Llm
-  module Providers
-    class OpenaiProvider < Provider
-      DEFAULT_MODEL: String
-
-      def initialize: (api_key: String, ?model: String?) -> void
-      def complete: (String prompt, ?system_prompt: String?) -> String?
-      def available?: () -> bool
-
-      private
-
-      def build_client: () -> untyped
-    end
-  end
-end

data/sig/llm/response_parser.rbs

@@ -1,13 +0,0 @@
-# Type definitions for Llm::ResponseParser
-module Llm
-  module ResponseParser
-    def self?.parse_json: (String? response) -> Hash[Symbol, untyped]?
-    def self?.extract_elements: (String? response) -> Array[Hash[Symbol, untyped]]?
-    def self?.extract_scenarios: (String? response) -> Array[Hash[Symbol, untyped]]?
-
-    private
-
-    def self?.normalize_element: (Hash[Symbol, untyped] element) -> Hash[Symbol, untyped]?
-    def self?.extract_json: (String text) -> String?
-  end
-end

data/sig/plugin/plugin.rbs

@@ -1,24 +0,0 @@
-# Type definitions for Plugin
-module RubyRaider
-  module Plugin
-    def self?.add_plugin: (String plugin_name) -> void
-    def self?.delete_plugin: (String plugin_name) -> String?
-    def self?.installed_plugins: () -> Array[String]
-    def self?.installed?: (String plugin_name) -> bool
-    def self?.available?: (String plugin_name) -> bool
-    def self?.camelize: (String str) -> String
-    def self?.plugins: () -> Array[String]
-
-    private
-
-    def self?.add_plugin_to_gemfile: (String plugin_name) -> void
-    def self?.remove_plugin_from_gemfile: (String plugin_name) -> void
-    def self?.last_plugin?: () -> bool
-    def self?.read_gemfile: () -> Array[String]
-    def self?.comment_present?: () -> bool
-    def self?.plugin_present?: (String plugin_name) -> bool
-    def self?.remove_plugins_and_comments: (String plugin_name) -> Array[String]
-    def self?.update_gemfile: (Array[String] output_lines) -> void
-    def self?.gemfile_guard: () -> untyped
-  end
-end

data/sig/plugin/plugin_exposer.rbs

@@ -1,20 +0,0 @@
-# Type definitions for PluginExposer
-module RubyRaider
-  module PluginExposer
-    FILE_PATH: String
-
-    def self?.expose_commands: (String plugin_name) -> void
-    def self?.remove_command: (String plugin_name) -> void
-
-    private
-
-    def self?.any_commands?: () -> bool
-    def self?.read_loaded_commands: () -> Array[String]
-    def self?.formatted_command_without_space: (String plugin_name) -> String
-    def self?.formatted_command_with_space: (String plugin_name) -> String
-    def self?.plugin_present?: (String plugin_name) -> bool
-    def self?.select_command_formatting: (String plugin_name, String line) -> String?
-    def self?.require_plugin: (String plugin_name, String line) -> String?
-    def self?.delete_plugin_command: (String plugin_name) -> void
-  end
-end

data/sig/scaffolding/crud_generator.rbs

@@ -1,16 +0,0 @@
-# Type definitions for CrudGenerator
-class CrudGenerator
-  ACTIONS: Array[String]
-
-  def initialize: (String base_name, Class scaffolding_class, ^(String) -> String? config_loader) -> void
-  def generate: () -> Array[String]
-  def planned_files: () -> Array[String]
-
-  private
-
-  def generate_page: (String name) -> void
-  def generate_test: (String name) -> void
-  def generate_model: () -> void
-  def model_content: () -> String
-  def test_path: (String name) -> String
-end

data/sig/scaffolding/dry_run_presenter.rbs

@@ -1,4 +0,0 @@
-# Type definitions for DryRunPresenter
-module DryRunPresenter
-  def self?.preview: (Array[String] planned_files) -> Array[String]
-end

data/sig/scaffolding/page_introspector.rbs

@@ -1,14 +0,0 @@
-# Type definitions for PageIntrospector
-class PageIntrospector
-  SKIP_METHODS: Array[String]
-
-  attr_reader class_name: String
-  attr_reader methods: Array[Hash[Symbol, untyped]]
-
-  def initialize: (String file_path) -> void
-
-  private
-
-  def extract_class_name: () -> String
-  def extract_public_methods: () -> Array[Hash[Symbol, untyped]]
-end

data/sig/scaffolding/scaffold_menu.rbs

@@ -1,18 +0,0 @@
-# Type definitions for ScaffoldMenu
-class ScaffoldMenu
-  COMPONENTS: Hash[String, Symbol]
-
-  def initialize: () -> void
-  def run: () -> Hash[Symbol, untyped]?
-  def self.build_options: (names: Array[String] | String, components: Array[Symbol] | Symbol, ?uses: Array[String] | String) -> Hash[Symbol, untyped]
-
-  private
-
-  def ask_names: () -> Array[String]
-  def ask_components: () -> Array[Symbol]
-  def ask_relationships: () -> Array[String]
-  def preview_and_confirm: (Array[String] names, Array[Symbol] components, Array[String] uses) -> Hash[Symbol, untyped]?
-  def planned_files: (Array[String] names, Array[Symbol] components) -> Array[String]
-  def file_for: (String name, Symbol component) -> String?
-  def default_components: (Hash[Symbol, untyped] project) -> Array[String]
-end