class Solargraph::Pin::Parameter

# File lib/solargraph/pin/parameter.rb, line 18
def initialize decl: :arg, asgn_code: nil, **splat
  super(**splat)
  @asgn_code = asgn_code
  @decl = decl
end

# File lib/solargraph/pin/parameter.rb, line 75
def arg?
  decl == :arg
end

# File lib/solargraph/pin/parameter.rb, line 54
def arity_decl
  name = (self.name || '(anon)')
  type = (return_type&.to_rbs || 'untyped')
  case decl
  when :arg
    ""
  when :optarg
    "?"
  when :kwarg
    "#{name}:"
  when :kwoptarg
    "?#{name}:"
  when :restarg
    "*"
  when :kwrestarg
    "**"
  else
    "(unknown decl: #{decl})"
  end
end

# File lib/solargraph/pin/parameter.rb, line 87
def block?
  [:block, :blockarg].include?(decl)
end

# File lib/solargraph/pin/parameter.rb, line 32
def combine_with(other, attrs={})
  new_attrs = {
    decl: assert_same(other, :decl),
    presence: choose(other, :presence),
    asgn_code: choose(other, :asgn_code),
  }.merge(attrs)
  super(other, new_attrs)
end

# File lib/solargraph/pin/parameter.rb, line 175
def compatible_arg?(atype, api_map)
  # make sure we get types from up the method
  # inheritance chain if we don't have them on this pin
  ptype = typify api_map
  ptype.undefined? || ptype.can_assign?(api_map, atype) || ptype.generic?
end

# File lib/solargraph/pin/parameter.rb, line 182
def documentation
  tag = param_tag
  return '' if tag.nil? || tag.text.nil?
  tag.text
end

# File lib/solargraph/pin/parameter.rb, line 127
def full
  full_name + case decl
              when :optarg
                " = #{asgn_code || '?'}"
              when :kwoptarg
                " #{asgn_code || '?'}"
              else
                ''
              end
end

# File lib/solargraph/pin/parameter.rb, line 111
def full_name
  case decl
  when :kwarg, :kwoptarg
    "#{name}:"
  when :restarg
    "*#{name}"
  when :kwrestarg
    "**#{name}"
  when :block, :blockarg
    "&#{name}"
  else
    name
  end
end

# File lib/solargraph/pin/parameter.rb, line 161
def index
  # @type [Method, Block]
  method_pin = closure
  method_pin.parameter_names.index(name)
end

# File lib/solargraph/pin/parameter.rb, line 41
def keyword?
  [:kwarg, :kwoptarg].include?(decl)
end

# File lib/solargraph/pin/parameter.rb, line 45
def kwrestarg?
  decl == :kwrestarg || (assignment && [:HASH, :hash].include?(assignment.type))
end

# File lib/solargraph/pin/parameter.rb, line 28
def location
  super || closure&.type_location
end

# File lib/solargraph/pin/parameter.rb, line 49
def needs_consistent_name?
  keyword?
end

# File lib/solargraph/pin/parameter.rb, line 83
def rest?
  decl == :restarg || decl == :kwrestarg
end

# File lib/solargraph/pin/parameter.rb, line 79
def restarg?
  decl == :restarg
end

# File lib/solargraph/pin/parameter.rb, line 139
def return_type
  if @return_type.nil?
    @return_type = ComplexType::UNDEFINED
    found = param_tag
    @return_type = ComplexType.try_parse(*found.types) unless found.nil? or found.types.nil?
    if @return_type.undefined?
      if decl == :restarg
        @return_type = ComplexType.try_parse('::Array')
      elsif decl == :kwrestarg
        @return_type = ComplexType.try_parse('::Hash')
      elsif decl == :blockarg
        @return_type = ComplexType.try_parse('::Proc')
      end
    end
  end
  super
  @return_type
end

# File lib/solargraph/pin/parameter.rb, line 91
def to_rbs
  case decl
  when :optarg
    "?#{super}"
  when :kwarg
    "#{name}: #{return_type.to_rbs}"
  when :kwoptarg
    "?#{name}: #{return_type.to_rbs}"
  when :restarg
    "*#{super}"
  when :kwrestarg
    "**#{super}"
  else
    super
  end
end

# File lib/solargraph/pin/parameter.rb, line 24
def type_location
  super || closure&.type_location
end

# File lib/solargraph/pin/parameter.rb, line 168
def typify api_map
  return return_type.qualify(api_map, *closure.gates) unless return_type.undefined?
  closure.is_a?(Pin::Block) ? typify_block_param(api_map) : typify_method_param(api_map)
end

# File lib/solargraph/pin/parameter.rb, line 191
def param_tag
  params = closure.docstring.tags(:param)
  params.each do |p|
    return p if p.name == name
  end
  params[index] if index && params[index] && (params[index].name.nil? || params[index].name.empty?)
end

# File lib/solargraph/pin/parameter.rb, line 251
def resolve_reference ref, api_map, skip
  return nil if skip.include?(ref)
  skip.push ref
  parts = ref.split(/[.#]/)
  if parts.first.empty?
    path = "#{namespace}#{ref}"
  else
    fqns = api_map.qualify(parts.first, namespace)
    return nil if fqns.nil?
    path = fqns + ref[parts.first.length] + parts.last
  end
  pins = api_map.get_path_pins(path)
  pins.each do |pin|
    params = pin.docstring.tags(:param)
    return params unless params.empty?
  end
  pins.each do |pin|
    params = see_reference(pin.docstring, api_map, skip)
    return params unless params.empty?
  end
  nil
end

# File lib/solargraph/pin/parameter.rb, line 234
def see_reference heredoc, api_map, skip = []
  # This should actually be an intersection type
  # @param ref [YARD::Tags::Tag, Solargraph::Yard::Tags::RefTag]
  heredoc.ref_tags.each do |ref|
    # @sg-ignore ref should actually be an intersection type
    next unless ref.tag_name == 'param' && ref.owner
    # @sg-ignore ref should actually be an intersection type
    result = resolve_reference(ref.owner.to_s, api_map, skip)
    return result unless result.nil?
  end
  []
end

# File lib/solargraph/pin/parameter.rb, line 201
def typify_block_param api_map
  block_pin = closure
  if block_pin.is_a?(Pin::Block) && block_pin.receiver
    return block_pin.typify_parameters(api_map)[index]
  end
  ComplexType::UNDEFINED
end

# File lib/solargraph/pin/parameter.rb, line 211
def typify_method_param api_map
  meths = api_map.get_method_stack(closure.full_context.tag, closure.name, scope: closure.scope)
  # meths.shift # Ignore the first one
  meths.each do |meth|
    found = nil
    params = meth.docstring.tags(:param) + see_reference(docstring, api_map)
    params.each do |p|
      next unless p.name == name
      found = p
      break
    end
    if found.nil? and !index.nil?
      found = params[index] if params[index] && (params[index].name.nil? || params[index].name.empty?)
    end
    return ComplexType.try_parse(*found.types).qualify(api_map, *meth.closure.gates) unless found.nil? || found.types.nil?
  end
  ComplexType::UNDEFINED
end