# This file is generated by the templates/template.rb script and should not be
# modified manually. See templates/sig/prism.rbs.erb
# if you are looking to modify the template

module Prism
  BACKEND: :CEXT | :FFI
  VERSION: String

  # Methods taking a Ruby source code string:

  def self.parse: (
    String source,
    ?filepath: String,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> ParseResult[ProgramNode]

  def self.lex: (
    String source,
    ?filepath: String,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> ParseResult[Array[[Token, Integer]]]

  def self.lex_compat: (
    String source,
    ?filepath: String,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> ParseResult[Array[[[Integer, Integer], Symbol, String, untyped]]]

  def self.parse_lex: (
    String source,
    ?filepath: String,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> ParseResult[[ProgramNode, Array[[Token, Integer]]]]

  def self.dump: (
    String source,
    ?filepath: String,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> String

  def self.parse_comments: (
    String source,
    ?filepath: String,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> Array[comment]

  def self.parse_success?: (
    String source,
    ?filepath: String,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> bool

  def self.parse_failure?: (
    String source,
    ?filepath: String,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> bool

  def self.load: (
    String source,
    String serialized
  ) -> ParseResult[ProgramNode]

  def self.lex_ripper: (
    String source
  ) -> Array[[[Integer, Integer], Symbol, String, untyped]]

  # Methods taking a path to a Ruby file:

  def self.parse_file: (
    String filepath,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> ParseResult[ProgramNode]

  def self.lex_file: (
    String filepath,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> ParseResult[Array[[Token, Integer]]]

  def self.parse_lex_file: (
    String filepath,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> ParseResult[[ProgramNode, Array[[Token, Integer]]]]

  def self.dump_file: (
    String filepath,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> String

  def self.parse_file_comments: (
    String filepath,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> Array[comment]

  def self.parse_file_success?: (
    String filepath,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> bool

  def self.parse_file_failure?: (
    String filepath,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> bool

  interface _Stream
    def gets: (?Integer integer) -> (String | nil)
  end

  def self.parse_stream: (
    _Stream stream,
    ?filepath: String,
    ?line: Integer,
    ?offset: Integer,
    ?encoding: Encoding,
    ?frozen_string_literal: bool,
    ?verbose: bool,
    ?scopes: Array[Array[Symbol]]
  ) -> ParseResult[ProgramNode]
end