prism 0.27.0 → 0.28.0

data/rbi/prism/parse_result.rbi

@@ -16,6 +16,9 @@ class Prism::Source
   sig { returns(Encoding) }
   def encoding; end
 
+  sig { returns(T::Array[Integer]) }
+  def lines; end
+
   sig { params(byte_offset: Integer, length: Integer).returns(String) }
   def slice(byte_offset, length); end
 
@@ -41,6 +44,20 @@ class Prism::Source
   def code_units_column(byte_offset, encoding); end
 end
 
+class Prism::ASCIISource < Prism::Source
+  sig { params(byte_offset: Integer).returns(Integer) }
+  def character_offset(byte_offset); end
+
+  sig { params(byte_offset: Integer).returns(Integer) }
+  def character_column(byte_offset); end
+
+  sig { params(byte_offset: Integer, encoding: Encoding).returns(Integer) }
+  def code_units_offset(byte_offset, encoding); end
+
+  sig { params(byte_offset: Integer, encoding: Encoding).returns(Integer) }
+  def code_units_column(byte_offset, encoding); end
+end
+
 class Prism::Location
   sig { returns(Prism::Source) }
   def source; end
@@ -78,6 +95,9 @@ class Prism::Location
   sig { returns(String) }
   def inspect; end
 
+  sig { returns(T::Array[String]) }
+  def source_lines; end
+
   sig { returns(String) }
   def slice; end
 
@@ -134,6 +154,9 @@ class Prism::Location
 
   sig { params(other: Prism::Location).returns(Prism::Location) }
   def join(other); end
+
+  sig { params(string: String).returns(Prism::Location) }
+  def adjoin(string); end
 end
 
 class Prism::Comment

data/rbi/prism/translation/ripper.rbi

@@ -1,12 +1,10 @@
 # typed: strict
 
 class Prism::Translation::Ripper < Prism::Compiler
-  Result = type_member
-
   sig { returns(T::Boolean) }
   def error?; end
 
-  sig { returns(T.nilable(Result)) }
+  sig { returns(T.untyped) }
   def parse; end
 
   sig { params(source: String, filename: String, lineno: Integer, raise_errors: T.untyped).returns(T.untyped) }
@@ -15,11 +13,3 @@ class Prism::Translation::Ripper < Prism::Compiler
   sig { params(source: String, filename: String, lineno: Integer, raise_errors: T.untyped).returns(T.untyped) }
   def self.sexp(source, filename = "-", lineno = 1, raise_errors: false); end
 end
-
-class Prism::Translation::Ripper::SexpBuilder < Prism::Translation::Ripper
-  Result = type_member { { fixed: T::Array[T.untyped] } }
-end
-
-class Prism::Translation::Ripper::SexpBuilderPP < Prism::Translation::Ripper::SexpBuilder
-  Result = type_member { { fixed: T::Array[T.untyped] } }
-end

data/sig/prism/dsl.rbs

@@ -118,7 +118,7 @@ module Prism
     def ConstantPathAndWriteNode: (ConstantPathNode target, Location operator_loc, Prism::node value, ?Source source, ?Location location) -> ConstantPathAndWriteNode
 
     # Create a new ConstantPathNode node
-    def ConstantPathNode: (Prism::node? parent, ConstantReadNode | MissingNode child, Location delimiter_loc, ?Source source, ?Location location) -> ConstantPathNode
+    def ConstantPathNode: (Prism::node? parent, Symbol? name, Location delimiter_loc, Location name_loc, ?Source source, ?Location location) -> ConstantPathNode
 
     # Create a new ConstantPathOperatorWriteNode node
     def ConstantPathOperatorWriteNode: (ConstantPathNode target, Location operator_loc, Prism::node value, Symbol operator, ?Source source, ?Location location) -> ConstantPathOperatorWriteNode
@@ -127,7 +127,7 @@ module Prism
     def ConstantPathOrWriteNode: (ConstantPathNode target, Location operator_loc, Prism::node value, ?Source source, ?Location location) -> ConstantPathOrWriteNode
 
     # Create a new ConstantPathTargetNode node
-    def ConstantPathTargetNode: (Prism::node? parent, ConstantReadNode | MissingNode child, Location delimiter_loc, ?Source source, ?Location location) -> ConstantPathTargetNode
+    def ConstantPathTargetNode: (Prism::node? parent, Symbol? name, Location delimiter_loc, Location name_loc, ?Source source, ?Location location) -> ConstantPathTargetNode
 
     # Create a new ConstantPathWriteNode node
     def ConstantPathWriteNode: (ConstantPathNode target, Location operator_loc, Prism::node value, ?Source source, ?Location location) -> ConstantPathWriteNode
@@ -400,7 +400,7 @@ module Prism
     def RetryNode: (?Source source, ?Location location) -> RetryNode
 
     # Create a new ReturnNode node
-    def ReturnNode: (Location keyword_loc, ArgumentsNode? arguments, ?Source source, ?Location location) -> ReturnNode
+    def ReturnNode: (Integer flags, Location keyword_loc, ArgumentsNode? arguments, ?Source source, ?Location location) -> ReturnNode
 
     # Create a new SelfNode node
     def SelfNode: (?Source source, ?Location location) -> SelfNode

data/sig/prism/inspect_visitor.rbs

@@ -0,0 +1,22 @@
+module Prism
+  class InspectVisitor < Visitor
+    class Replace
+      attr_reader value: String
+
+      def initialize: (String value) -> void
+    end
+
+    attr_reader indent: String
+    attr_reader commands: Array[[String | node | Replace, String]]
+
+    def initialize: (?String indent) -> void
+    def compose: () -> String
+
+    def self.compose: (node node) -> String
+
+    private
+
+    def inspect_node: (String name, node node) -> String
+    def inspect_location: (Location? location) -> String
+  end
+end

data/sig/prism/node.rbs

@@ -16,9 +16,13 @@ module Prism
 
     def start_offset: () -> Integer
     def end_offset: () -> Integer
+    def source_lines: () -> Array[String]
+    alias script_lines source_lines
     def slice: () -> String
+    def slice_lines: () -> String
     def pretty_print: (untyped q) -> untyped
     def to_dot: () -> String
+    def tunnel: (Integer line, Integer column) -> Array[Prism::node]
   end
 
   type node_singleton = singleton(Node) & _NodeSingleton
@@ -31,7 +35,7 @@ module Prism
     def compact_child_nodes: () -> Array[Prism::node]
     def comment_targets: () -> Array[Prism::node | Location]
     def fields: () -> Array[Prism::Reflection::Field]
-    def inspect: (?untyped) -> String
+    def inspect: () -> String
     def type: () -> Symbol
   end
 
@@ -125,12 +129,13 @@ module Prism
   class ArgumentsNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader arguments: Array[Prism::node]
 
     def initialize: (Source source, Integer flags, Array[Prism::node] arguments, Location location) -> void
     def copy: (?flags: Integer, ?arguments: Array[Prism::node], ?location: Location) -> ArgumentsNode
     def deconstruct_keys: (Array[Symbol] keys) -> { flags: Integer, arguments: Array[Prism::node], location: Location }
+    def contains_keywords?: () -> bool
     def contains_keyword_splat?: () -> bool
     def type: () -> :arguments_node
             | ...
@@ -144,7 +149,7 @@ module Prism
   class ArrayNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader elements: Array[Prism::node]
     attr_reader opening_loc: Location?
     attr_reader closing_loc: Location?
@@ -304,7 +309,7 @@ module Prism
   class BlockLocalVariableNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader name: Symbol
 
     def initialize: (Source source, Integer flags, Symbol name, Location location) -> void
@@ -347,7 +352,7 @@ module Prism
   class BlockParameterNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader name: Symbol?
     attr_reader name_loc: Location?
     attr_reader operator_loc: Location
@@ -414,7 +419,7 @@ module Prism
   class CallAndWriteNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader receiver: Prism::node?
     attr_reader call_operator_loc: Location?
     attr_reader message_loc: Location?
@@ -460,7 +465,7 @@ module Prism
   class CallNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader receiver: Prism::node?
     attr_reader call_operator_loc: Location?
     attr_reader name: Symbol
@@ -493,7 +498,7 @@ module Prism
   class CallOperatorWriteNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader receiver: Prism::node?
     attr_reader call_operator_loc: Location?
     attr_reader message_loc: Location?
@@ -524,7 +529,7 @@ module Prism
   class CallOrWriteNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader receiver: Prism::node?
     attr_reader call_operator_loc: Location?
     attr_reader message_loc: Location?
@@ -563,7 +568,7 @@ module Prism
   class CallTargetNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader receiver: Prism::node
     attr_reader call_operator_loc: Location
     attr_reader name: Symbol
@@ -889,12 +894,13 @@ module Prism
     include _Node
 
     attr_reader parent: Prism::node?
-    attr_reader child: ConstantReadNode | MissingNode
+    attr_reader name: Symbol?
     attr_reader delimiter_loc: Location
+    attr_reader name_loc: Location
 
-    def initialize: (Source source, Prism::node? parent, ConstantReadNode | MissingNode child, Location delimiter_loc, Location location) -> void
-    def copy: (?parent: Prism::node?, ?child: ConstantReadNode | MissingNode, ?delimiter_loc: Location, ?location: Location) -> ConstantPathNode
-    def deconstruct_keys: (Array[Symbol] keys) -> { parent: Prism::node?, child: ConstantReadNode | MissingNode, delimiter_loc: Location, location: Location }
+    def initialize: (Source source, Prism::node? parent, Symbol? name, Location delimiter_loc, Location name_loc, Location location) -> void
+    def copy: (?parent: Prism::node?, ?name: Symbol?, ?delimiter_loc: Location, ?name_loc: Location, ?location: Location) -> ConstantPathNode
+    def deconstruct_keys: (Array[Symbol] keys) -> { parent: Prism::node?, name: Symbol?, delimiter_loc: Location, name_loc: Location, location: Location }
     def delimiter: () -> String
     def type: () -> :constant_path_node
             | ...
@@ -949,12 +955,13 @@ module Prism
     include _Node
 
     attr_reader parent: Prism::node?
-    attr_reader child: ConstantReadNode | MissingNode
+    attr_reader name: Symbol?
     attr_reader delimiter_loc: Location
+    attr_reader name_loc: Location
 
-    def initialize: (Source source, Prism::node? parent, ConstantReadNode | MissingNode child, Location delimiter_loc, Location location) -> void
-    def copy: (?parent: Prism::node?, ?child: ConstantReadNode | MissingNode, ?delimiter_loc: Location, ?location: Location) -> ConstantPathTargetNode
-    def deconstruct_keys: (Array[Symbol] keys) -> { parent: Prism::node?, child: ConstantReadNode | MissingNode, delimiter_loc: Location, location: Location }
+    def initialize: (Source source, Prism::node? parent, Symbol? name, Location delimiter_loc, Location name_loc, Location location) -> void
+    def copy: (?parent: Prism::node?, ?name: Symbol?, ?delimiter_loc: Location, ?name_loc: Location, ?location: Location) -> ConstantPathTargetNode
+    def deconstruct_keys: (Array[Symbol] keys) -> { parent: Prism::node?, name: Symbol?, delimiter_loc: Location, name_loc: Location, location: Location }
     def delimiter: () -> String
     def type: () -> :constant_path_target_node
             | ...
@@ -1239,7 +1246,7 @@ module Prism
   class FlipFlopNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader left: Prism::node?
     attr_reader right: Prism::node?
     attr_reader operator_loc: Location
@@ -1640,7 +1647,7 @@ module Prism
   class IndexAndWriteNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader receiver: Prism::node?
     attr_reader call_operator_loc: Location?
     attr_reader opening_loc: Location
@@ -1673,7 +1680,7 @@ module Prism
   class IndexOperatorWriteNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader receiver: Prism::node?
     attr_reader call_operator_loc: Location?
     attr_reader opening_loc: Location
@@ -1706,7 +1713,7 @@ module Prism
   class IndexOrWriteNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader receiver: Prism::node?
     attr_reader call_operator_loc: Location?
     attr_reader opening_loc: Location
@@ -1747,7 +1754,7 @@ module Prism
   class IndexTargetNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader receiver: Prism::node
     attr_reader opening_loc: Location
     attr_reader arguments: ArgumentsNode?
@@ -1893,7 +1900,7 @@ module Prism
   class IntegerNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader value: Integer
 
     def initialize: (Source source, Integer flags, Integer value, Location location) -> void
@@ -1915,7 +1922,7 @@ module Prism
   class InterpolatedMatchLastLineNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader opening_loc: Location
     attr_reader parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode]
     attr_reader closing_loc: Location
@@ -1948,7 +1955,7 @@ module Prism
   class InterpolatedRegularExpressionNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader opening_loc: Location
     attr_reader parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode]
     attr_reader closing_loc: Location
@@ -1981,7 +1988,7 @@ module Prism
   class InterpolatedStringNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader opening_loc: Location?
     attr_reader parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode | InterpolatedStringNode]
     attr_reader closing_loc: Location?
@@ -2063,7 +2070,7 @@ module Prism
   class KeywordHashNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader elements: Array[AssocNode | AssocSplatNode]
 
     def initialize: (Source source, Integer flags, Array[AssocNode | AssocSplatNode] elements, Location location) -> void
@@ -2083,7 +2090,7 @@ module Prism
   class KeywordRestParameterNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader name: Symbol?
     attr_reader name_loc: Location?
     attr_reader operator_loc: Location
@@ -2254,7 +2261,7 @@ module Prism
   class MatchLastLineNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader opening_loc: Location
     attr_reader content_loc: Location
     attr_reader closing_loc: Location
@@ -2524,7 +2531,7 @@ module Prism
   class OptionalKeywordParameterNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader name: Symbol
     attr_reader name_loc: Location
     attr_reader value: Prism::node
@@ -2546,7 +2553,7 @@ module Prism
   class OptionalParameterNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader name: Symbol
     attr_reader name_loc: Location
     attr_reader operator_loc: Location
@@ -2740,7 +2747,7 @@ module Prism
   class RangeNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader left: Prism::node?
     attr_reader right: Prism::node?
     attr_reader operator_loc: Location
@@ -2795,7 +2802,7 @@ module Prism
   class RegularExpressionNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader opening_loc: Location
     attr_reader content_loc: Location
     attr_reader closing_loc: Location
@@ -2831,7 +2838,7 @@ module Prism
   class RequiredKeywordParameterNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader name: Symbol
     attr_reader name_loc: Location
 
@@ -2852,7 +2859,7 @@ module Prism
   class RequiredParameterNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader name: Symbol
 
     def initialize: (Source source, Integer flags, Symbol name, Location location) -> void
@@ -2921,7 +2928,7 @@ module Prism
   class RestParameterNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader name: Symbol?
     attr_reader name_loc: Location?
     attr_reader operator_loc: Location
@@ -2959,12 +2966,14 @@ module Prism
   class ReturnNode < Node
     include _Node
 
+    attr_reader flags: Integer
     attr_reader keyword_loc: Location
     attr_reader arguments: ArgumentsNode?
 
-    def initialize: (Source source, Location keyword_loc, ArgumentsNode? arguments, Location location) -> void
-    def copy: (?keyword_loc: Location, ?arguments: ArgumentsNode?, ?location: Location) -> ReturnNode
-    def deconstruct_keys: (Array[Symbol] keys) -> { keyword_loc: Location, arguments: ArgumentsNode?, location: Location }
+    def initialize: (Source source, Integer flags, Location keyword_loc, ArgumentsNode? arguments, Location location) -> void
+    def copy: (?flags: Integer, ?keyword_loc: Location, ?arguments: ArgumentsNode?, ?location: Location) -> ReturnNode
+    def deconstruct_keys: (Array[Symbol] keys) -> { flags: Integer, keyword_loc: Location, arguments: ArgumentsNode?, location: Location }
+    def redundant?: () -> bool
     def keyword: () -> String
     def type: () -> :return_node
             | ...
@@ -2995,7 +3004,7 @@ module Prism
   class ShareableConstantNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader write: ConstantWriteNode | ConstantAndWriteNode | ConstantOrWriteNode | ConstantOperatorWriteNode | ConstantPathWriteNode | ConstantPathAndWriteNode | ConstantPathOrWriteNode | ConstantPathOperatorWriteNode
 
     def initialize: (Source source, Integer flags, ConstantWriteNode | ConstantAndWriteNode | ConstantOrWriteNode | ConstantOperatorWriteNode | ConstantPathWriteNode | ConstantPathAndWriteNode | ConstantPathOrWriteNode | ConstantPathOperatorWriteNode write, Location location) -> void
@@ -3057,7 +3066,7 @@ module Prism
   class SourceFileNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader filepath: String
 
     def initialize: (Source source, Integer flags, String filepath, Location location) -> void
@@ -3137,7 +3146,7 @@ module Prism
   class StringNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader opening_loc: Location?
     attr_reader content_loc: Location
     attr_reader closing_loc: Location?
@@ -3195,7 +3204,7 @@ module Prism
   class SymbolNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader opening_loc: Location?
     attr_reader value_loc: Location?
     attr_reader closing_loc: Location?
@@ -3288,7 +3297,7 @@ module Prism
   class UntilNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader keyword_loc: Location
     attr_reader closing_loc: Location?
     attr_reader predicate: Prism::node
@@ -3339,7 +3348,7 @@ module Prism
   class WhileNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader keyword_loc: Location
     attr_reader closing_loc: Location?
     attr_reader predicate: Prism::node
@@ -3363,7 +3372,7 @@ module Prism
   class XStringNode < Node
     include _Node
 
-    private attr_reader flags: Integer
+    attr_reader flags: Integer
     attr_reader opening_loc: Location
     attr_reader content_loc: Location
     attr_reader closing_loc: Location
@@ -3407,6 +3416,8 @@ module Prism
 
   # Flags for arguments nodes.
   module ArgumentsNodeFlags
+    # if arguments contain keywords
+    CONTAINS_KEYWORDS: Integer
     # if arguments contain keyword splat
     CONTAINS_KEYWORD_SPLAT: Integer
   end
@@ -3507,6 +3518,12 @@ module Prism
     FORCED_US_ASCII_ENCODING: Integer
   end
 
+  # Flags for return nodes.
+  module ReturnNodeFlags
+    # a return statement that is redundant because it is the last statement in a method
+    REDUNDANT: Integer
+  end
+
   # Flags for shareable constant nodes.
   module ShareableConstantNodeFlags
     # constant writes that should be modified with shareable constant value literal

data/sig/prism/parse_result.rbs

@@ -6,9 +6,11 @@ module Prism
 
     def initialize: (String source, ?Integer start_line, ?Array[Integer] offsets) -> void
     def encoding: () -> Encoding
+    def lines: () -> Array[String]
     def slice: (Integer byte_offset, Integer length) -> String
     def line: (Integer byte_offset) -> Integer
     def line_start: (Integer byte_offset) -> Integer
+    def line_end: (Integer byte_offset) -> Integer
     def line_offset: (Integer byte_offset) -> Integer
     def column: (Integer byte_offset) -> Integer
     def character_offset: (Integer byte_offset) -> Integer
@@ -17,6 +19,13 @@ module Prism
     def code_units_column: (Integer byte_offset, Encoding encoding) -> 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_column: (Integer byte_offset, Encoding encoding) -> Integer
+  end
+
   class Location
     attr_reader source: Source
     attr_reader start_offset: Integer
@@ -30,7 +39,9 @@ module Prism
     def comments: () -> Array[comment]
     def copy: (?source: Source, ?start_offset: Integer, ?length: Integer) -> Location
     def chop: () -> Location
+    def source_lines: () -> Array[String]
     def slice: () -> String
+    def slice_lines: () -> String
     def start_character_offset: () -> Integer
     def end_offset: () -> Integer
     def end_character_offset: () -> Integer
@@ -44,6 +55,7 @@ module Prism
     def deconstruct_keys: (Array[Symbol]? keys) -> Hash[Symbol, untyped]
     def pretty_print: (untyped q) -> untyped
     def join: (Location other) -> Location
+    def adjoin: (String string) -> Location
   end
 
   class Comment