Type signatures for bash-merge gem

Smart merge for Bash scripts using tree-sitter AST analysis

module Bash
module Merge
VERSION: String

# Base error class for bash-merge errors
class Error < StandardError
end

# Error raised when template Bash file has syntax errors
class TemplateParseError < Error
  attr_reader errors: Array[untyped]
  attr_reader content: String?

  def initialize: (?String? message, ?errors: Array[untyped], ?content: String?) -> void
end

# Error raised when destination Bash file has syntax errors
class DestinationParseError < Error
  attr_reader errors: Array[untyped]
  attr_reader content: String?

  def initialize: (?String? message, ?errors: Array[untyped], ?content: String?) -> void
end

# Debug logging utility for Bash::Merge
module DebugLogger
  extend Ast::Merge::DebugLogger

  def self.env_var_name: () -> String
  def self.env_var_name=: (String name) -> String
  def self.log_prefix: () -> String
  def self.log_prefix=: (String prefix) -> String
  def self.enabled?: () -> bool
  def self.debug: (String message, ?Hash[Symbol, untyped] context) -> void
  def self.info: (String message) -> void
  def self.warning: (String message) -> void
  def self.time: [T] (String operation) { () -> T } -> T
  def self.extract_node_info: (untyped node) -> Hash[Symbol, untyped]
end

# Freeze block node for Bash scripts
class FreezeNode < Ast::Merge::FreezeNode
  InvalidStructureError: singleton(Ast::Merge::FreezeNode::InvalidStructureError)
  Location: singleton(Ast::Merge::FreezeNode::Location)

  attr_reader lines: Array[String]

  def initialize: (
    start_line: Integer,
    end_line: Integer,
    lines: Array[String],
    ?start_marker: String?,
    ?end_marker: String?,
    ?pattern_type: Symbol
  ) -> void

  def signature: () -> Array[Symbol | String]
  def function_definition?: () -> bool
  def variable_assignment?: () -> bool
  def command?: () -> bool
  def slice: () -> String?
  def inspect: () -> String

  private

  def validate_structure!: () -> void
end

# Wrapper for tree-sitter Bash nodes
class NodeWrapper
  attr_reader node: untyped
  attr_reader start_line: Integer
  attr_reader end_line: Integer
  attr_reader source: String
  attr_reader analysis: FileAnalysis?

  def initialize: (
    untyped node,
    String source,
    ?analysis: FileAnalysis?
  ) -> void

  def location: () -> Ast::Merge::FreezeNode::Location
  def signature: () -> Array[untyped]
  def freeze_node?: () -> bool
  def function_definition?: () -> bool
  def variable_assignment?: () -> bool
  def command?: () -> bool
  def comment?: () -> bool
  def name: () -> String?
  def value: () -> String?
  def slice: () -> String?
  def text: () -> String
  def type: () -> Symbol
  def inspect: () -> String
end

# Comment tracker for Bash files
class CommentTracker
  attr_reader comments: Array[Hash[Symbol, untyped]]
  attr_reader source: String
  attr_reader lines: Array[String]

  def initialize: (String source) -> void

  def extract_comments: () -> Array[Hash[Symbol, untyped]]
  def comments_for_line: (Integer line) -> Array[Hash[Symbol, untyped]]
  def leading_comments_for: (Integer line) -> Array[Hash[Symbol, untyped]]
  def trailing_comment_for: (Integer line) -> Hash[Symbol, untyped]?
  def shebang?: (String line) -> bool
end

# File analysis for Bash scripts
class FileAnalysis
  include Ast::Merge::FileAnalysisBase

  DEFAULT_FREEZE_TOKEN: String
  PARSER_SEARCH_PATHS: Array[String]

  attr_reader source: String
  attr_reader lines: Array[String]
  attr_reader ast: untyped
  attr_reader statements: Array[NodeWrapper | FreezeNode]
  attr_reader freeze_blocks: Array[FreezeNode]
  attr_reader freeze_token: String
  attr_reader signature_generator: (^(untyped) -> Array[untyped]?)?
  attr_reader comment_tracker: CommentTracker
  attr_reader errors: Array[untyped]

  def self.find_parser_path: () -> String?

  def initialize: (
    String source,
    ?freeze_token: String,
    ?signature_generator: (^(untyped) -> Array[untyped]?)?,
    ?parser_path: String?
  ) -> void

  def valid?: () -> bool
  def nodes: () -> Array[NodeWrapper | FreezeNode]
  def line_at: (Integer line_num) -> String?
  def normalized_line: (Integer line_num) -> String?
  def in_freeze_block?: (Integer line_num) -> bool
  def freeze_block_at: (Integer line_num) -> FreezeNode?
  def signature_at: (Integer index) -> Array[untyped]?
  def generate_signature: (untyped node) -> Array[untyped]?
  def compute_node_signature: (untyped node) -> Array[untyped]?

  private

  def parse_bash: () -> void
  def extract_nodes: (untyped tree_node) -> Array[NodeWrapper]
  def extract_freeze_blocks: () -> Array[FreezeNode]
  def integrate_nodes_and_freeze_blocks: () -> Array[NodeWrapper | FreezeNode]
end

# Result of a Bash merge operation
class MergeResult < Ast::Merge::MergeResult
  DECISION_KEPT_TEMPLATE: Symbol
  DECISION_KEPT_DEST: Symbol
  DECISION_MERGED: Symbol
  DECISION_ADDED: Symbol
  DECISION_FREEZE_BLOCK: Symbol

  attr_reader lines: Array[Hash[Symbol, untyped]]
  attr_reader decisions: Array[Hash[Symbol, untyped]]
  attr_reader statistics: Hash[Symbol, Integer]

  def initialize: (
    ?template_analysis: FileAnalysis?,
    ?dest_analysis: FileAnalysis?,
    ?conflicts: Array[Hash[Symbol, untyped]],
    ?frozen_blocks: Array[FreezeNode],
    ?stats: Hash[Symbol, untyped]
  ) -> void

  def add_line: (
    String line,
    decision: Symbol,
    source: Symbol,
    ?original_line: Integer?
  ) -> void

  def add_lines: (
    Array[String] lines,
    decision: Symbol,
    source: Symbol,
    ?start_line: Integer?
  ) -> void

  def add_blank_line: (?decision: Symbol, ?source: Symbol) -> void
  def add_freeze_block: (FreezeNode freeze_node) -> void
  def to_bash: () -> String
  def content: () -> Array[Hash[Symbol, untyped]]
  def content_string: () -> String
  def empty?: () -> bool

  private

  def track_statistics: (Symbol decision, Symbol source) -> void
end

# Smart merger for Bash scripts
class SmartMerger
  include Ast::Merge::MergerConfig

  attr_reader template_analysis: FileAnalysis
  attr_reader dest_analysis: FileAnalysis
  attr_reader signature_match_preference: (Symbol | Hash[Symbol, Symbol])
  attr_reader add_template_only_nodes: bool

  def initialize: (
    String template_content,
    String dest_content,
    ?signature_match_preference: (Symbol | Hash[Symbol, Symbol]),
    ?add_template_only_nodes: bool,
    ?freeze_token: String,
    ?signature_generator: (^(untyped) -> Array[untyped]?)?,
    ?node_splitter: Hash[Symbol, untyped]?,
    ?parser_path: String?
  ) -> void

  def merge: () -> MergeResult

  private

  def perform_merge: () -> MergeResult
  def merge_nodes: (MergeResult result) -> void
end

# Conflict resolver for Bash merges
class ConflictResolver
  attr_reader template_analysis: FileAnalysis
  attr_reader dest_analysis: FileAnalysis
  attr_reader signature_match_preference: (Symbol | Hash[Symbol, Symbol])
  attr_reader add_template_only_nodes: bool

  def initialize: (
    FileAnalysis template_analysis,
    FileAnalysis dest_analysis,
    ?signature_match_preference: (Symbol | Hash[Symbol, Symbol]),
    ?add_template_only_nodes: bool
  ) -> void

  def resolve: (untyped boundary, MergeResult result) -> void
end

# Emitter for reconstructing Bash output
class Emitter
  attr_reader result: MergeResult

  def initialize: (MergeResult result) -> void

  def emit: () -> String
end   end end