prism 0.29.0 → 1.3.0

data/sig/prism/parse_result.rbs

@@ -1,4 +1,8 @@
 module Prism
+  interface _CodeUnitsCache
+    def []: (Integer byte_offset) -> Integer
+  end
+
   class Source
     attr_reader source: String
     attr_reader start_line: Integer
@@ -16,13 +20,22 @@ module Prism
     def character_offset: (Integer byte_offset) -> Integer
     def character_column: (Integer byte_offset) -> Integer
     def code_units_offset: (Integer byte_offset, Encoding encoding) -> Integer
+    def code_units_cache: (Encoding encoding) -> _CodeUnitsCache
     def code_units_column: (Integer byte_offset, Encoding encoding) -> Integer
+
+    def self.for: (String source) -> Source
+  end
+
+  class CodeUnitsCache
+    def initialize: (String source, Encoding encoding) -> void
+    def []: (Integer byte_offset) -> Integer
   end
 
   class ASCIISource < Source
     def character_offset: (Integer byte_offset) -> Integer
     def character_column: (Integer byte_offset) -> Integer
     def code_units_offset: (Integer byte_offset, Encoding encoding) -> Integer
+    def code_units_cache: (Encoding encoding) -> _CodeUnitsCache
     def code_units_column: (Integer byte_offset, Encoding encoding) -> Integer
   end
 
@@ -43,15 +56,23 @@ module Prism
     def slice: () -> String
     def slice_lines: () -> String
     def start_character_offset: () -> Integer
+    def start_code_units_offset: (Encoding encoding) -> Integer
+    def cached_start_code_units_offset: (_CodeUnitsCache cache) -> Integer
     def end_offset: () -> Integer
     def end_character_offset: () -> Integer
+    def end_code_units_offset: (Encoding encoding) -> Integer
+    def cached_end_code_units_offset: (_CodeUnitsCache cache) -> Integer
     def start_line: () -> Integer
     def start_line_slice: () -> String
     def end_line: () -> Integer
     def start_column: () -> Integer
     def start_character_column: () -> Integer
+    def start_code_units_column: (Encoding encoding) -> Integer
+    def cached_start_code_units_column: (_CodeUnitsCache cache) -> Integer
     def end_column: () -> Integer
     def end_character_column: () -> Integer
+    def end_code_units_column: (Encoding encoding) -> Integer
+    def cached_end_code_units_column: (_CodeUnitsCache cache) -> Integer
     def deconstruct_keys: (Array[Symbol]? keys) -> Hash[Symbol, untyped]
     def pretty_print: (untyped q) -> untyped
     def join: (Location other) -> Location
@@ -123,6 +144,7 @@ module Prism
     def deconstruct_keys: (Array[Symbol]? keys) -> Hash[Symbol, untyped]
     def success?: () -> bool
     def failure?: () -> bool
+    def code_units_cache: (Encoding encoding) -> _CodeUnitsCache
   end
 
   class ParseResult < Result

data/sig/prism/relocation.rbs

@@ -0,0 +1,185 @@
+module Prism
+  module Relocation
+    interface _Value
+      def start_line: () -> Integer
+      def end_line: () -> Integer
+      def start_offset: () -> Integer
+      def end_offset: () -> Integer
+      def start_character_offset: () -> Integer
+      def end_character_offset: () -> Integer
+      def cached_start_code_units_offset: (_CodeUnitsCache cache) -> Integer
+      def cached_end_code_units_offset: (_CodeUnitsCache cache) -> Integer
+      def start_column: () -> Integer
+      def end_column: () -> Integer
+      def start_character_column: () -> Integer
+      def end_character_column: () -> Integer
+      def cached_start_code_units_column: (_CodeUnitsCache cache) -> Integer
+      def cached_end_code_units_column: (_CodeUnitsCache cache) -> Integer
+      def leading_comments: () -> Array[Comment]
+      def trailing_comments: () -> Array[Comment]
+    end
+
+    interface _Field
+      def fields: (_Value value) -> entry_values
+    end
+
+    type entry_value = untyped
+    type entry_values = Hash[Symbol, entry_value]
+
+    class Entry
+      class MissingValueError < StandardError
+      end
+
+      def initialize: (Repository repository) -> void
+
+      def filepath: () -> String
+
+      def start_line: () -> Integer
+      def end_line: () -> Integer
+
+      def start_offset: () -> Integer
+      def end_offset: () -> Integer
+      def start_character_offset: () -> Integer
+      def end_character_offset: () -> Integer
+      def start_code_units_offset: () -> Integer
+      def end_code_units_offset: () -> Integer
+
+      def start_column: () -> Integer
+      def end_column: () -> Integer
+      def start_character_column: () -> Integer
+      def end_character_column: () -> Integer
+      def start_code_units_column: () -> Integer
+      def end_code_units_column: () -> Integer
+
+      def leading_comments: () -> Array[CommentsField::Comment]
+      def trailing_comments: () -> Array[CommentsField::Comment]
+      def comments: () -> Array[CommentsField::Comment]
+
+      private
+
+      def fetch_value: (Symbol name) -> entry_value
+      def values: () -> entry_values
+    end
+
+    class Source
+      attr_reader value: untyped
+
+      def initialize: (untyped value) -> void
+
+      def result: () -> ParseResult
+      def code_units_cache: (Encoding encoding) -> _CodeUnitsCache
+    end
+
+    class SourceFilepath < Source
+      def result: () -> ParseResult
+    end
+
+    class SourceString < Source
+      def result: () -> ParseResult
+    end
+
+    class FilepathField
+      attr_reader value: String
+
+      def initialize: (String value) -> void
+
+      def fields: (_Value value) -> entry_values
+    end
+
+    class LinesField
+      def fields: (_Value value) -> entry_values
+    end
+
+    class OffsetsField
+      def fields: (_Value value) -> entry_values
+    end
+
+    class CharacterOffsetsField
+      def fields: (_Value value) -> entry_values
+    end
+
+    class CodeUnitOffsetsField
+      attr_reader repository: Repository
+      attr_reader encoding: Encoding
+
+      def initialize: (Repository repository, Encoding encoding) -> void
+      def fields: (_Value value) -> entry_values
+
+      private
+
+      def cache: () -> _CodeUnitsCache
+    end
+
+    class ColumnsField
+      def fields: (_Value value) -> entry_values
+    end
+
+    class CharacterColumnsField
+      def fields: (_Value value) -> entry_values
+    end
+
+    class CodeUnitColumnsField
+      attr_reader repository: Repository
+      attr_reader encoding: Encoding
+
+      def initialize: (Repository repository, Encoding encoding) -> void
+      def fields: (_Value value) -> entry_values
+
+      private
+
+      def cache: () -> _CodeUnitsCache
+    end
+
+    class CommentsField
+      class Comment
+        attr_reader slice: String
+
+        def initialize: (String slice) -> void
+      end
+
+      private
+
+      def comments: (entry_value value) -> Array[Comment]
+    end
+
+    class LeadingCommentsField < CommentsField
+      def fields: (_Value value) -> entry_values
+    end
+
+    class TrailingCommentsField < CommentsField
+      def fields: (_Value value) -> entry_values
+    end
+
+    class Repository
+      class ConfigurationError < StandardError
+      end
+
+      attr_reader source: Source
+      attr_reader fields: Hash[Symbol, _Field]
+      attr_reader entries: Hash[Integer, Hash[Symbol, Entry]]
+
+      def initialize: (Source source) -> void
+
+      def code_units_cache: (Encoding encoding) -> _CodeUnitsCache
+
+      def filepath: () -> self
+      def lines: () -> self
+      def offsets: () -> self
+      def character_offsets: () -> self
+      def code_unit_offsets: (Encoding encoding) -> self
+      def columns: () -> self
+      def character_columns: () -> self
+      def code_unit_columns: (Encoding encoding) -> self
+      def leading_comments: () -> self
+      def trailing_comments: () -> self
+      def comments: () -> self
+
+      private
+
+      def field: (Symbol name, _Field) -> self
+    end
+
+    def self.filepath: (String value) -> Repository
+    def self.string: (String value) -> Repository
+  end
+end

data/sig/prism/string_query.rbs

@@ -0,0 +1,11 @@
+module Prism
+  class StringQuery
+    attr_reader string: String
+
+    def initialize: (String string) -> void
+
+    def local?: () -> bool
+    def constant?: () -> bool
+    def method_name?: () -> bool
+  end
+end

data/sig/prism/visitor.rbs

@@ -97,6 +97,7 @@ module Prism
     def visit_interpolated_string_node: (InterpolatedStringNode) -> void
     def visit_interpolated_symbol_node: (InterpolatedSymbolNode) -> void
     def visit_interpolated_x_string_node: (InterpolatedXStringNode) -> void
+    def visit_it_local_variable_read_node: (ItLocalVariableReadNode) -> void
     def visit_it_parameters_node: (ItParametersNode) -> void
     def visit_keyword_hash_node: (KeywordHashNode) -> void
     def visit_keyword_rest_parameter_node: (KeywordRestParameterNode) -> void

data/sig/prism.rbs

@@ -10,90 +10,110 @@ module Prism
 
   def self.parse: (
     String source,
+    ?encoding: Encoding | false,
     ?filepath: String,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> ParseResult
 
-  def self.lex: (
+  def self.profile: (
     String source,
+    ?encoding: Encoding | false,
     ?filepath: String,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
+  ) -> nil
+
+  def self.lex: (
+    String source,
+    ?encoding: Encoding | false,
+    ?filepath: String,
     ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?line: Integer,
+    ?main_script: bool,
+    ?offset: Integer,
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> LexResult
 
   def self.lex_compat: (
     String source,
+    ?encoding: Encoding | false,
     ?filepath: String,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> LexCompat::Result
 
   def self.parse_lex: (
     String source,
+    ?encoding: Encoding | false,
     ?filepath: String,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> ParseLexResult
 
   def self.dump: (
     String source,
+    ?encoding: Encoding | false,
     ?filepath: String,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> String
 
   def self.parse_comments: (
     String source,
+    ?encoding: Encoding | false,
     ?filepath: String,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> Array[comment]
 
   def self.parse_success?: (
     String source,
+    ?encoding: Encoding | false,
     ?filepath: String,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> bool
 
   def self.parse_failure?: (
     String source,
+    ?encoding: Encoding | false,
     ?filepath: String,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> bool
 
   def self.load: (
@@ -109,72 +129,90 @@ module Prism
 
   def self.parse_file: (
     String filepath,
+    ?encoding: Encoding | false,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> ParseResult
 
-  def self.lex_file: (
+  def self.profile_file: (
     String filepath,
+    ?encoding: Encoding | false,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
+  ) -> nil
+
+  def self.lex_file: (
+    String filepath,
+    ?encoding: Encoding | false,
     ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?line: Integer,
+    ?main_script: bool,
+    ?offset: Integer,
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> LexResult
 
   def self.parse_lex_file: (
     String filepath,
+    ?encoding: Encoding | false,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> ParseLexResult
 
   def self.dump_file: (
     String filepath,
+    ?encoding: Encoding | false,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> String
 
   def self.parse_file_comments: (
     String filepath,
+    ?encoding: Encoding | false,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> Array[comment]
 
   def self.parse_file_success?: (
     String filepath,
+    ?encoding: Encoding | false,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> bool
 
   def self.parse_file_failure?: (
     String filepath,
+    ?encoding: Encoding | false,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> bool
 
   interface _Stream
@@ -183,12 +221,13 @@ module Prism
 
   def self.parse_stream: (
     _Stream stream,
+    ?encoding: Encoding | false,
     ?filepath: String,
+    ?frozen_string_literal: bool,
     ?line: Integer,
+    ?main_script: bool,
     ?offset: Integer,
-    ?encoding: Encoding,
-    ?frozen_string_literal: bool,
-    ?verbose: bool,
-    ?scopes: Array[Array[Symbol]]
+    ?scopes: Array[Array[Symbol]],
+    ?verbose: bool
   ) -> ParseResult
 end