prism 1.3.0 → 1.5.0

data/lib/prism/node.rb

@@ -1,9 +1,12 @@
 # frozen_string_literal: true
+# :markup: markdown
 
 =begin
+--
 This file is generated by the templates/template.rb script and should not be
 modified manually. See templates/lib/prism/node.rb.erb
 if you are looking to modify the template
+++
 =end
 
 module Prism
@@ -330,7 +333,7 @@ module Prism
       visitor.visit_alias_global_variable_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [new_name, old_name]
     end
@@ -350,7 +353,7 @@ module Prism
       AliasGlobalVariableNode.new(source, node_id, location, flags, new_name, old_name, keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, new_name: GlobalVariableReadNode | BackReferenceReadNode | NumberedReferenceReadNode, old_name: GlobalVariableReadNode | BackReferenceReadNode | NumberedReferenceReadNode | SymbolNode | MissingNode, keyword_loc: Location }
@@ -437,7 +440,7 @@ module Prism
       visitor.visit_alias_method_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [new_name, old_name]
     end
@@ -457,7 +460,7 @@ module Prism
       AliasMethodNode.new(source, node_id, location, flags, new_name, old_name, keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, new_name: SymbolNode | InterpolatedSymbolNode, old_name: SymbolNode | InterpolatedSymbolNode | GlobalVariableReadNode | MissingNode, keyword_loc: Location }
@@ -556,7 +559,7 @@ module Prism
       visitor.visit_alternation_pattern_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [left, right]
     end
@@ -576,7 +579,7 @@ module Prism
       AlternationPatternNode.new(source, node_id, location, flags, left, right, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, left: Prism::node, right: Prism::node, operator_loc: Location }
@@ -663,7 +666,7 @@ module Prism
       visitor.visit_and_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [left, right]
     end
@@ -683,7 +686,7 @@ module Prism
       AndNode.new(source, node_id, location, flags, left, right, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, left: Prism::node, right: Prism::node, operator_loc: Location }
@@ -774,7 +777,7 @@ module Prism
       visitor.visit_arguments_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*arguments]
     end
@@ -794,7 +797,7 @@ module Prism
       ArgumentsNode.new(source, node_id, location, flags, arguments)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, arguments: Array[Prism::node] }
@@ -879,7 +882,7 @@ module Prism
       visitor.visit_array_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*elements]
     end
@@ -899,7 +902,7 @@ module Prism
       ArrayNode.new(source, node_id, location, flags, elements, opening_loc, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, elements: Array[Prism::node], opening_loc: Location?, closing_loc: Location? }
@@ -1036,7 +1039,7 @@ module Prism
       visitor.visit_array_pattern_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [constant, *requireds, rest, *posts]
     end
@@ -1056,20 +1059,29 @@ module Prism
       [*constant, *requireds, *rest, *posts, *opening_loc, *closing_loc] #: Array[Prism::node | Location]
     end
 
-    # def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?constant: ConstantReadNode | ConstantPathNode | nil, ?requireds: Array[Prism::node], ?rest: Prism::node?, ?posts: Array[Prism::node], ?opening_loc: Location?, ?closing_loc: Location?) -> ArrayPatternNode
+    # def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?constant: ConstantPathNode | ConstantReadNode | nil, ?requireds: Array[Prism::node], ?rest: Prism::node?, ?posts: Array[Prism::node], ?opening_loc: Location?, ?closing_loc: Location?) -> ArrayPatternNode
     def copy(node_id: self.node_id, location: self.location, flags: self.flags, constant: self.constant, requireds: self.requireds, rest: self.rest, posts: self.posts, opening_loc: self.opening_loc, closing_loc: self.closing_loc)
       ArrayPatternNode.new(source, node_id, location, flags, constant, requireds, rest, posts, opening_loc, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
-    # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, constant: ConstantReadNode | ConstantPathNode | nil, requireds: Array[Prism::node], rest: Prism::node?, posts: Array[Prism::node], opening_loc: Location?, closing_loc: Location? }
+    # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, constant: ConstantPathNode | ConstantReadNode | nil, requireds: Array[Prism::node], rest: Prism::node?, posts: Array[Prism::node], opening_loc: Location?, closing_loc: Location? }
     def deconstruct_keys(keys)
       { node_id: node_id, location: location, constant: constant, requireds: requireds, rest: rest, posts: posts, opening_loc: opening_loc, closing_loc: closing_loc }
     end
 
-    # attr_reader constant: ConstantReadNode | ConstantPathNode | nil
+    # Represents the optional constant preceding the Array
+    #
+    #     foo in Bar[]
+    #            ^^^
+    #
+    #     foo in Bar[1, 2, 3]
+    #            ^^^
+    #
+    #     foo in Bar::Baz[1, 2, 3]
+    #            ^^^^^^^^
     attr_reader :constant
 
     # Represents the required elements of the array pattern.
@@ -1195,7 +1207,7 @@ module Prism
       visitor.visit_assoc_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [key, value]
     end
@@ -1215,7 +1227,7 @@ module Prism
       AssocNode.new(source, node_id, location, flags, key, value, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, key: Prism::node, value: Prism::node, operator_loc: Location? }
@@ -1316,7 +1328,7 @@ module Prism
       visitor.visit_assoc_splat_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -1338,7 +1350,7 @@ module Prism
       AssocSplatNode.new(source, node_id, location, flags, value, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, value: Prism::node?, operator_loc: Location }
@@ -1416,7 +1428,7 @@ module Prism
       visitor.visit_back_reference_read_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -1436,7 +1448,7 @@ module Prism
       BackReferenceReadNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -1500,7 +1512,7 @@ module Prism
       visitor.visit_begin_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [statements, rescue_clause, else_clause, ensure_clause]
     end
@@ -1525,7 +1537,7 @@ module Prism
       BeginNode.new(source, node_id, location, flags, begin_keyword_loc, statements, rescue_clause, else_clause, ensure_clause, end_keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, begin_keyword_loc: Location?, statements: StatementsNode?, rescue_clause: RescueNode?, else_clause: ElseNode?, ensure_clause: EnsureNode?, end_keyword_loc: Location? }
@@ -1659,7 +1671,7 @@ module Prism
       visitor.visit_block_argument_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [expression]
     end
@@ -1681,7 +1693,7 @@ module Prism
       BlockArgumentNode.new(source, node_id, location, flags, expression, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, expression: Prism::node?, operator_loc: Location }
@@ -1759,7 +1771,7 @@ module Prism
       visitor.visit_block_local_variable_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -1779,7 +1791,7 @@ module Prism
       BlockLocalVariableNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -1845,7 +1857,7 @@ module Prism
       visitor.visit_block_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [parameters, body]
     end
@@ -1868,7 +1880,7 @@ module Prism
       BlockNode.new(source, node_id, location, flags, locals, parameters, body, opening_loc, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, locals: Array[Symbol], parameters: BlockParametersNode | NumberedParametersNode | ItParametersNode | nil, body: StatementsNode | BeginNode | nil, opening_loc: Location, closing_loc: Location }
@@ -1990,7 +2002,7 @@ module Prism
       visitor.visit_block_parameter_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -2010,7 +2022,7 @@ module Prism
       BlockParameterNode.new(source, node_id, location, flags, name, name_loc, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol?, name_loc: Location?, operator_loc: Location }
@@ -2126,7 +2138,7 @@ module Prism
       visitor.visit_block_parameters_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [parameters, *locals]
     end
@@ -2149,7 +2161,7 @@ module Prism
       BlockParametersNode.new(source, node_id, location, flags, parameters, locals, opening_loc, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, parameters: ParametersNode?, locals: Array[BlockLocalVariableNode], opening_loc: Location?, closing_loc: Location? }
@@ -2286,7 +2298,7 @@ module Prism
       visitor.visit_break_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [arguments]
     end
@@ -2308,7 +2320,7 @@ module Prism
       BreakNode.new(source, node_id, location, flags, arguments, keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, arguments: ArgumentsNode?, keyword_loc: Location }
@@ -2392,7 +2404,7 @@ module Prism
       visitor.visit_call_and_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [receiver, value]
     end
@@ -2415,7 +2427,7 @@ module Prism
       CallAndWriteNode.new(source, node_id, location, flags, receiver, call_operator_loc, message_loc, read_name, write_name, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, receiver: Prism::node?, call_operator_loc: Location?, message_loc: Location?, read_name: Symbol, write_name: Symbol, operator_loc: Location, value: Prism::node }
@@ -2613,7 +2625,7 @@ module Prism
       visitor.visit_call_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [receiver, arguments, block]
     end
@@ -2637,7 +2649,7 @@ module Prism
       CallNode.new(source, node_id, location, flags, receiver, call_operator_loc, name, message_loc, opening_loc, arguments, closing_loc, block)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, receiver: Prism::node?, call_operator_loc: Location?, name: Symbol, message_loc: Location?, opening_loc: Location?, arguments: ArgumentsNode?, closing_loc: Location?, block: BlockNode | BlockArgumentNode | nil }
@@ -2862,7 +2874,7 @@ module Prism
       visitor.visit_call_operator_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [receiver, value]
     end
@@ -2885,7 +2897,7 @@ module Prism
       CallOperatorWriteNode.new(source, node_id, location, flags, receiver, call_operator_loc, message_loc, read_name, write_name, binary_operator, binary_operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, receiver: Prism::node?, call_operator_loc: Location?, message_loc: Location?, read_name: Symbol, write_name: Symbol, binary_operator: Symbol, binary_operator_loc: Location, value: Prism::node }
@@ -3069,7 +3081,7 @@ module Prism
       visitor.visit_call_or_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [receiver, value]
     end
@@ -3092,7 +3104,7 @@ module Prism
       CallOrWriteNode.new(source, node_id, location, flags, receiver, call_operator_loc, message_loc, read_name, write_name, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, receiver: Prism::node?, call_operator_loc: Location?, message_loc: Location?, read_name: Symbol, write_name: Symbol, operator_loc: Location, value: Prism::node }
@@ -3279,7 +3291,7 @@ module Prism
       visitor.visit_call_target_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [receiver]
     end
@@ -3299,7 +3311,7 @@ module Prism
       CallTargetNode.new(source, node_id, location, flags, receiver, call_operator_loc, name, message_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, receiver: Prism::node, call_operator_loc: Location, name: Symbol, message_loc: Location }
@@ -3429,7 +3441,7 @@ module Prism
       visitor.visit_capture_pattern_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value, target]
     end
@@ -3449,7 +3461,7 @@ module Prism
       CapturePatternNode.new(source, node_id, location, flags, value, target, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, value: Prism::node, target: LocalVariableTargetNode, operator_loc: Location }
@@ -3540,7 +3552,7 @@ module Prism
       visitor.visit_case_match_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [predicate, *conditions, else_clause]
     end
@@ -3564,7 +3576,7 @@ module Prism
       CaseMatchNode.new(source, node_id, location, flags, predicate, conditions, else_clause, case_keyword_loc, end_keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, predicate: Prism::node?, conditions: Array[InNode], else_clause: ElseNode?, case_keyword_loc: Location, end_keyword_loc: Location }
@@ -3685,7 +3697,7 @@ module Prism
       visitor.visit_case_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [predicate, *conditions, else_clause]
     end
@@ -3709,7 +3721,7 @@ module Prism
       CaseNode.new(source, node_id, location, flags, predicate, conditions, else_clause, case_keyword_loc, end_keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, predicate: Prism::node?, conditions: Array[WhenNode], else_clause: ElseNode?, case_keyword_loc: Location, end_keyword_loc: Location }
@@ -3831,7 +3843,7 @@ module Prism
       visitor.visit_class_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [constant_path, superclass, body]
     end
@@ -3855,7 +3867,7 @@ module Prism
       ClassNode.new(source, node_id, location, flags, locals, class_keyword_loc, constant_path, inheritance_operator_loc, superclass, body, end_keyword_loc, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, locals: Array[Symbol], class_keyword_loc: Location, constant_path: ConstantReadNode | ConstantPathNode | CallNode, inheritance_operator_loc: Location?, superclass: Prism::node?, body: StatementsNode | BeginNode | nil, end_keyword_loc: Location, name: Symbol }
@@ -3866,7 +3878,10 @@ module Prism
     # attr_reader locals: Array[Symbol]
     attr_reader :locals
 
-    # attr_reader class_keyword_loc: Location
+    # Represents the location of the `class` keyword.
+    #
+    #     class Foo end
+    #     ^^^^^
     def class_keyword_loc
       location = @class_keyword_loc
       return location if location.is_a?(Location)
@@ -3882,7 +3897,10 @@ module Prism
     # attr_reader constant_path: ConstantReadNode | ConstantPathNode | CallNode
     attr_reader :constant_path
 
-    # attr_reader inheritance_operator_loc: Location?
+    # Represents the location of the `<` operator.
+    #
+    #     class Foo < Bar
+    #               ^
     def inheritance_operator_loc
       location = @inheritance_operator_loc
       case location
@@ -3901,13 +3919,23 @@ module Prism
       repository.enter(node_id, :inheritance_operator_loc) unless @inheritance_operator_loc.nil?
     end
 
-    # attr_reader superclass: Prism::node?
+    # Represents the superclass of the class.
+    #
+    #     class Foo < Bar
+    #                 ^^^
     attr_reader :superclass
 
-    # attr_reader body: StatementsNode | BeginNode | nil
+    # Represents the body of the class.
+    #
+    #     class Foo
+    #       foo
+    #       ^^^
     attr_reader :body
 
-    # attr_reader end_keyword_loc: Location
+    # Represents the location of the `end` keyword.
+    #
+    #     class Foo end
+    #               ^^^
     def end_keyword_loc
       location = @end_keyword_loc
       return location if location.is_a?(Location)
@@ -3920,7 +3948,9 @@ module Prism
       repository.enter(node_id, :end_keyword_loc)
     end
 
-    # attr_reader name: Symbol
+    # The name of the class.
+    #
+    #     class Foo end # name `:Foo`
     attr_reader :name
 
     # def class_keyword: () -> String
@@ -3991,7 +4021,7 @@ module Prism
       visitor.visit_class_variable_and_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -4011,7 +4041,7 @@ module Prism
       ClassVariableAndWriteNode.new(source, node_id, location, flags, name, name_loc, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, operator_loc: Location, value: Prism::node }
@@ -4117,7 +4147,7 @@ module Prism
       visitor.visit_class_variable_operator_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -4137,7 +4167,7 @@ module Prism
       ClassVariableOperatorWriteNode.new(source, node_id, location, flags, name, name_loc, binary_operator_loc, value, binary_operator)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, binary_operator_loc: Location, value: Prism::node, binary_operator: Symbol }
@@ -4229,7 +4259,7 @@ module Prism
       visitor.visit_class_variable_or_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -4249,7 +4279,7 @@ module Prism
       ClassVariableOrWriteNode.new(source, node_id, location, flags, name, name_loc, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, operator_loc: Location, value: Prism::node }
@@ -4339,7 +4369,7 @@ module Prism
       visitor.visit_class_variable_read_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -4359,7 +4389,7 @@ module Prism
       ClassVariableReadNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -4416,7 +4446,7 @@ module Prism
       visitor.visit_class_variable_target_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -4436,7 +4466,7 @@ module Prism
       ClassVariableTargetNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -4492,7 +4522,7 @@ module Prism
       visitor.visit_class_variable_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -4512,7 +4542,7 @@ module Prism
       ClassVariableWriteNode.new(source, node_id, location, flags, name, name_loc, value, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, value: Prism::node, operator_loc: Location }
@@ -4621,7 +4651,7 @@ module Prism
       visitor.visit_constant_and_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -4641,7 +4671,7 @@ module Prism
       ConstantAndWriteNode.new(source, node_id, location, flags, name, name_loc, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, operator_loc: Location, value: Prism::node }
@@ -4735,7 +4765,7 @@ module Prism
       visitor.visit_constant_operator_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -4755,7 +4785,7 @@ module Prism
       ConstantOperatorWriteNode.new(source, node_id, location, flags, name, name_loc, binary_operator_loc, value, binary_operator)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, binary_operator_loc: Location, value: Prism::node, binary_operator: Symbol }
@@ -4847,7 +4877,7 @@ module Prism
       visitor.visit_constant_or_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -4867,7 +4897,7 @@ module Prism
       ConstantOrWriteNode.new(source, node_id, location, flags, name, name_loc, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, operator_loc: Location, value: Prism::node }
@@ -4959,7 +4989,7 @@ module Prism
       visitor.visit_constant_path_and_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [target, value]
     end
@@ -4979,7 +5009,7 @@ module Prism
       ConstantPathAndWriteNode.new(source, node_id, location, flags, target, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, target: ConstantPathNode, operator_loc: Location, value: Prism::node }
@@ -5058,7 +5088,7 @@ module Prism
       visitor.visit_constant_path_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [parent]
     end
@@ -5080,7 +5110,7 @@ module Prism
       ConstantPathNode.new(source, node_id, location, flags, parent, name, delimiter_loc, name_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, parent: Prism::node?, name: Symbol?, delimiter_loc: Location, name_loc: Location }
@@ -5194,7 +5224,7 @@ module Prism
       visitor.visit_constant_path_operator_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [target, value]
     end
@@ -5214,7 +5244,7 @@ module Prism
       ConstantPathOperatorWriteNode.new(source, node_id, location, flags, target, binary_operator_loc, value, binary_operator)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, target: ConstantPathNode, binary_operator_loc: Location, value: Prism::node, binary_operator: Symbol }
@@ -5291,7 +5321,7 @@ module Prism
       visitor.visit_constant_path_or_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [target, value]
     end
@@ -5311,7 +5341,7 @@ module Prism
       ConstantPathOrWriteNode.new(source, node_id, location, flags, target, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, target: ConstantPathNode, operator_loc: Location, value: Prism::node }
@@ -5390,7 +5420,7 @@ module Prism
       visitor.visit_constant_path_target_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [parent]
     end
@@ -5412,7 +5442,7 @@ module Prism
       ConstantPathTargetNode.new(source, node_id, location, flags, parent, name, delimiter_loc, name_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, parent: Prism::node?, name: Symbol?, delimiter_loc: Location, name_loc: Location }
@@ -5510,7 +5540,7 @@ module Prism
       visitor.visit_constant_path_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [target, value]
     end
@@ -5530,7 +5560,7 @@ module Prism
       ConstantPathWriteNode.new(source, node_id, location, flags, target, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, target: ConstantPathNode, operator_loc: Location, value: Prism::node }
@@ -5618,7 +5648,7 @@ module Prism
       visitor.visit_constant_read_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -5638,7 +5668,7 @@ module Prism
       ConstantReadNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -5695,7 +5725,7 @@ module Prism
       visitor.visit_constant_target_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -5715,7 +5745,7 @@ module Prism
       ConstantTargetNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -5771,7 +5801,7 @@ module Prism
       visitor.visit_constant_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -5791,7 +5821,7 @@ module Prism
       ConstantWriteNode.new(source, node_id, location, flags, name, name_loc, value, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, value: Prism::node, operator_loc: Location }
@@ -5909,7 +5939,7 @@ module Prism
       visitor.visit_def_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [receiver, parameters, body]
     end
@@ -5933,7 +5963,7 @@ module Prism
       DefNode.new(source, node_id, location, flags, name, name_loc, receiver, parameters, body, locals, def_keyword_loc, operator_loc, lparen_loc, rparen_loc, equal_loc, end_keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, receiver: Prism::node?, parameters: ParametersNode?, body: StatementsNode | BeginNode | nil, locals: Array[Symbol], def_keyword_loc: Location, operator_loc: Location?, lparen_loc: Location?, rparen_loc: Location?, equal_loc: Location?, end_keyword_loc: Location? }
@@ -6164,7 +6194,7 @@ module Prism
       visitor.visit_defined_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -6184,7 +6214,7 @@ module Prism
       DefinedNode.new(source, node_id, location, flags, lparen_loc, value, rparen_loc, keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, lparen_loc: Location?, value: Prism::node, rparen_loc: Location?, keyword_loc: Location }
@@ -6308,7 +6338,7 @@ module Prism
       visitor.visit_else_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [statements]
     end
@@ -6330,7 +6360,7 @@ module Prism
       ElseNode.new(source, node_id, location, flags, else_keyword_loc, statements, end_keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, else_keyword_loc: Location, statements: StatementsNode?, end_keyword_loc: Location? }
@@ -6429,7 +6459,7 @@ module Prism
       visitor.visit_embedded_statements_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [statements]
     end
@@ -6451,7 +6481,7 @@ module Prism
       EmbeddedStatementsNode.new(source, node_id, location, flags, opening_loc, statements, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location, statements: StatementsNode?, closing_loc: Location }
@@ -6543,7 +6573,7 @@ module Prism
       visitor.visit_embedded_variable_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [variable]
     end
@@ -6563,7 +6593,7 @@ module Prism
       EmbeddedVariableNode.new(source, node_id, location, flags, operator_loc, variable)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, operator_loc: Location, variable: InstanceVariableReadNode | ClassVariableReadNode | GlobalVariableReadNode | BackReferenceReadNode | NumberedReferenceReadNode }
@@ -6641,7 +6671,7 @@ module Prism
       visitor.visit_ensure_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [statements]
     end
@@ -6663,7 +6693,7 @@ module Prism
       EnsureNode.new(source, node_id, location, flags, ensure_keyword_loc, statements, end_keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, ensure_keyword_loc: Location, statements: StatementsNode?, end_keyword_loc: Location }
@@ -6753,7 +6783,7 @@ module Prism
       visitor.visit_false_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -6773,7 +6803,7 @@ module Prism
       FalseNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -6813,6 +6843,9 @@ module Prism
   #
   #     foo in Foo(*bar, baz, *qux)
   #            ^^^^^^^^^^^^^^^^^^^^
+  #
+  #     foo => *bar, baz, *qux
+  #            ^^^^^^^^^^^^^^^
   class FindPatternNode < Node
     # Initialize a new FindPatternNode node.
     def initialize(source, node_id, location, flags, constant, left, requireds, right, opening_loc, closing_loc)
@@ -6833,7 +6866,7 @@ module Prism
       visitor.visit_find_pattern_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [constant, left, *requireds, right]
     end
@@ -6853,32 +6886,59 @@ module Prism
       [*constant, left, *requireds, right, *opening_loc, *closing_loc] #: Array[Prism::node | Location]
     end
 
-    # def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?constant: ConstantReadNode | ConstantPathNode | nil, ?left: SplatNode, ?requireds: Array[Prism::node], ?right: SplatNode | MissingNode, ?opening_loc: Location?, ?closing_loc: Location?) -> FindPatternNode
+    # def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?constant: ConstantPathNode | ConstantReadNode | nil, ?left: SplatNode, ?requireds: Array[Prism::node], ?right: SplatNode | MissingNode, ?opening_loc: Location?, ?closing_loc: Location?) -> FindPatternNode
     def copy(node_id: self.node_id, location: self.location, flags: self.flags, constant: self.constant, left: self.left, requireds: self.requireds, right: self.right, opening_loc: self.opening_loc, closing_loc: self.closing_loc)
       FindPatternNode.new(source, node_id, location, flags, constant, left, requireds, right, opening_loc, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
-    # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, constant: ConstantReadNode | ConstantPathNode | nil, left: SplatNode, requireds: Array[Prism::node], right: SplatNode | MissingNode, opening_loc: Location?, closing_loc: Location? }
+    # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, constant: ConstantPathNode | ConstantReadNode | nil, left: SplatNode, requireds: Array[Prism::node], right: SplatNode | MissingNode, opening_loc: Location?, closing_loc: Location? }
     def deconstruct_keys(keys)
       { node_id: node_id, location: location, constant: constant, left: left, requireds: requireds, right: right, opening_loc: opening_loc, closing_loc: closing_loc }
     end
 
-    # attr_reader constant: ConstantReadNode | ConstantPathNode | nil
+    # Represents the optional constant preceding the pattern
+    #
+    #     foo in Foo(*bar, baz, *qux)
+    #            ^^^
     attr_reader :constant
 
-    # attr_reader left: SplatNode
+    # Represents the first wildcard node in the pattern.
+    #
+    #     foo in *bar, baz, *qux
+    #            ^^^^
+    #
+    #     foo in Foo(*bar, baz, *qux)
+    #                ^^^^
     attr_reader :left
 
-    # attr_reader requireds: Array[Prism::node]
+    # Represents the nodes in between the wildcards.
+    #
+    #     foo in *bar, baz, *qux
+    #                  ^^^
+    #
+    #     foo in Foo(*bar, baz, 1, *qux)
+    #                      ^^^^^^
     attr_reader :requireds
 
-    # attr_reader right: SplatNode | MissingNode
+    # Represents the second wildcard node in the pattern.
+    #
+    #     foo in *bar, baz, *qux
+    #                       ^^^^
+    #
+    #     foo in Foo(*bar, baz, *qux)
+    #                           ^^^^
     attr_reader :right
 
-    # attr_reader opening_loc: Location?
+    # The location of the opening brace.
+    #
+    #     foo in [*bar, baz, *qux]
+    #            ^
+    #
+    #     foo in Foo(*bar, baz, *qux)
+    #               ^
     def opening_loc
       location = @opening_loc
       case location
@@ -6897,7 +6957,13 @@ module Prism
       repository.enter(node_id, :opening_loc) unless @opening_loc.nil?
     end
 
-    # attr_reader closing_loc: Location?
+    # The location of the closing brace.
+    #
+    #     foo in [*bar, baz, *qux]
+    #                            ^
+    #
+    #     foo in Foo(*bar, baz, *qux)
+    #                               ^
     def closing_loc
       location = @closing_loc
       case location
@@ -6976,7 +7042,7 @@ module Prism
       visitor.visit_flip_flop_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [left, right]
     end
@@ -6999,7 +7065,7 @@ module Prism
       FlipFlopNode.new(source, node_id, location, flags, left, right, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, left: Prism::node?, right: Prism::node?, operator_loc: Location }
@@ -7081,7 +7147,7 @@ module Prism
       visitor.visit_float_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -7101,7 +7167,7 @@ module Prism
       FloatNode.new(source, node_id, location, flags, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, value: Float }
@@ -7160,7 +7226,7 @@ module Prism
       visitor.visit_for_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [index, collection, statements]
     end
@@ -7184,7 +7250,7 @@ module Prism
       ForNode.new(source, node_id, location, flags, index, collection, statements, for_keyword_loc, in_keyword_loc, do_keyword_loc, end_keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, index: LocalVariableTargetNode | InstanceVariableTargetNode | ClassVariableTargetNode | GlobalVariableTargetNode | ConstantTargetNode | ConstantPathTargetNode | CallTargetNode | IndexTargetNode | MultiTargetNode | BackReferenceReadNode | NumberedReferenceReadNode | MissingNode, collection: Prism::node, statements: StatementsNode?, for_keyword_loc: Location, in_keyword_loc: Location, do_keyword_loc: Location?, end_keyword_loc: Location }
@@ -7351,7 +7417,7 @@ module Prism
       visitor.visit_forwarding_arguments_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -7371,7 +7437,7 @@ module Prism
       ForwardingArgumentsNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -7420,7 +7486,7 @@ module Prism
       visitor.visit_forwarding_parameter_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -7440,7 +7506,7 @@ module Prism
       ForwardingParameterNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -7489,7 +7555,7 @@ module Prism
       visitor.visit_forwarding_super_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [block]
     end
@@ -7511,7 +7577,7 @@ module Prism
       ForwardingSuperNode.new(source, node_id, location, flags, block)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, block: BlockNode? }
@@ -7567,7 +7633,7 @@ module Prism
       visitor.visit_global_variable_and_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -7587,7 +7653,7 @@ module Prism
       GlobalVariableAndWriteNode.new(source, node_id, location, flags, name, name_loc, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, operator_loc: Location, value: Prism::node }
@@ -7681,7 +7747,7 @@ module Prism
       visitor.visit_global_variable_operator_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -7701,7 +7767,7 @@ module Prism
       GlobalVariableOperatorWriteNode.new(source, node_id, location, flags, name, name_loc, binary_operator_loc, value, binary_operator)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, binary_operator_loc: Location, value: Prism::node, binary_operator: Symbol }
@@ -7793,7 +7859,7 @@ module Prism
       visitor.visit_global_variable_or_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -7813,7 +7879,7 @@ module Prism
       GlobalVariableOrWriteNode.new(source, node_id, location, flags, name, name_loc, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, operator_loc: Location, value: Prism::node }
@@ -7903,7 +7969,7 @@ module Prism
       visitor.visit_global_variable_read_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -7923,7 +7989,7 @@ module Prism
       GlobalVariableReadNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -7980,7 +8046,7 @@ module Prism
       visitor.visit_global_variable_target_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -8000,7 +8066,7 @@ module Prism
       GlobalVariableTargetNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -8056,7 +8122,7 @@ module Prism
       visitor.visit_global_variable_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -8076,7 +8142,7 @@ module Prism
       GlobalVariableWriteNode.new(source, node_id, location, flags, name, name_loc, value, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, value: Prism::node, operator_loc: Location }
@@ -8184,7 +8250,7 @@ module Prism
       visitor.visit_hash_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*elements]
     end
@@ -8204,7 +8270,7 @@ module Prism
       HashNode.new(source, node_id, location, flags, opening_loc, elements, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location, elements: Array[AssocNode | AssocSplatNode], closing_loc: Location }
@@ -8296,6 +8362,12 @@ module Prism
   #
   #     foo => { a: 1, b: 2, **c }
   #            ^^^^^^^^^^^^^^^^^^^
+  #
+  #     foo => Bar[a: 1, b: 2]
+  #            ^^^^^^^^^^^^^^^
+  #
+  #     foo in { a: 1, b: 2 }
+  #            ^^^^^^^^^^^^^^
   class HashPatternNode < Node
     # Initialize a new HashPatternNode node.
     def initialize(source, node_id, location, flags, constant, elements, rest, opening_loc, closing_loc)
@@ -8315,7 +8387,7 @@ module Prism
       visitor.visit_hash_pattern_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [constant, *elements, rest]
     end
@@ -8334,29 +8406,53 @@ module Prism
       [*constant, *elements, *rest, *opening_loc, *closing_loc] #: Array[Prism::node | Location]
     end
 
-    # def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?constant: ConstantReadNode | ConstantPathNode | nil, ?elements: Array[AssocNode], ?rest: AssocSplatNode | NoKeywordsParameterNode | nil, ?opening_loc: Location?, ?closing_loc: Location?) -> HashPatternNode
+    # def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?constant: ConstantPathNode | ConstantReadNode | nil, ?elements: Array[AssocNode], ?rest: AssocSplatNode | NoKeywordsParameterNode | nil, ?opening_loc: Location?, ?closing_loc: Location?) -> HashPatternNode
     def copy(node_id: self.node_id, location: self.location, flags: self.flags, constant: self.constant, elements: self.elements, rest: self.rest, opening_loc: self.opening_loc, closing_loc: self.closing_loc)
       HashPatternNode.new(source, node_id, location, flags, constant, elements, rest, opening_loc, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
-    # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, constant: ConstantReadNode | ConstantPathNode | nil, elements: Array[AssocNode], rest: AssocSplatNode | NoKeywordsParameterNode | nil, opening_loc: Location?, closing_loc: Location? }
+    # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, constant: ConstantPathNode | ConstantReadNode | nil, elements: Array[AssocNode], rest: AssocSplatNode | NoKeywordsParameterNode | nil, opening_loc: Location?, closing_loc: Location? }
     def deconstruct_keys(keys)
       { node_id: node_id, location: location, constant: constant, elements: elements, rest: rest, opening_loc: opening_loc, closing_loc: closing_loc }
     end
 
-    # attr_reader constant: ConstantReadNode | ConstantPathNode | nil
+    # Represents the optional constant preceding the Hash.
+    #
+    #     foo => Bar[a: 1, b: 2]
+    #          ^^^
+    #
+    #     foo => Bar::Baz[a: 1, b: 2]
+    #          ^^^^^^^^
     attr_reader :constant
 
-    # attr_reader elements: Array[AssocNode]
+    # Represents the explicit named hash keys and values.
+    #
+    #     foo => { a: 1, b:, ** }
+    #              ^^^^^^^^
     attr_reader :elements
 
-    # attr_reader rest: AssocSplatNode | NoKeywordsParameterNode | nil
+    # Represents the rest of the Hash keys and values. This can be named, unnamed, or explicitly forbidden via `**nil`, this last one results in a `NoKeywordsParameterNode`.
+    #
+    #     foo => { a: 1, b:, **c }
+    #                        ^^^
+    #
+    #     foo => { a: 1, b:, ** }
+    #                        ^^
+    #
+    #     foo => { a: 1, b:, **nil }
+    #                        ^^^^^
     attr_reader :rest
 
-    # attr_reader opening_loc: Location?
+    # The location of the opening brace.
+    #
+    #     foo => { a: 1 }
+    #            ^
+    #
+    #     foo => Bar[a: 1]
+    #               ^
     def opening_loc
       location = @opening_loc
       case location
@@ -8375,7 +8471,13 @@ module Prism
       repository.enter(node_id, :opening_loc) unless @opening_loc.nil?
     end
 
-    # attr_reader closing_loc: Location?
+    # The location of the closing brace.
+    #
+    #     foo => { a: 1 }
+    #                   ^
+    #
+    #     foo => Bar[a: 1]
+    #                    ^
     def closing_loc
       location = @closing_loc
       case location
@@ -8462,7 +8564,7 @@ module Prism
       visitor.visit_if_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [predicate, statements, subsequent]
     end
@@ -8486,7 +8588,7 @@ module Prism
       IfNode.new(source, node_id, location, flags, if_keyword_loc, predicate, then_keyword_loc, statements, subsequent, end_keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, if_keyword_loc: Location?, predicate: Prism::node, then_keyword_loc: Location?, statements: StatementsNode?, subsequent: ElseNode | IfNode | nil, end_keyword_loc: Location? }
@@ -8668,7 +8770,7 @@ module Prism
       visitor.visit_imaginary_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [numeric]
     end
@@ -8688,7 +8790,7 @@ module Prism
       ImaginaryNode.new(source, node_id, location, flags, numeric)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, numeric: FloatNode | IntegerNode | RationalNode }
@@ -8747,7 +8849,7 @@ module Prism
       visitor.visit_implicit_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -8767,7 +8869,7 @@ module Prism
       ImplicitNode.new(source, node_id, location, flags, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, value: LocalVariableReadNode | CallNode | ConstantReadNode | LocalVariableTargetNode }
@@ -8828,7 +8930,7 @@ module Prism
       visitor.visit_implicit_rest_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -8848,7 +8950,7 @@ module Prism
       ImplicitRestNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -8900,7 +9002,7 @@ module Prism
       visitor.visit_in_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [pattern, statements]
     end
@@ -8923,7 +9025,7 @@ module Prism
       InNode.new(source, node_id, location, flags, pattern, statements, in_loc, then_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, pattern: Prism::node, statements: StatementsNode?, in_loc: Location, then_loc: Location? }
@@ -9031,7 +9133,7 @@ module Prism
       visitor.visit_index_and_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [receiver, arguments, block, value]
     end
@@ -9056,7 +9158,7 @@ module Prism
       IndexAndWriteNode.new(source, node_id, location, flags, receiver, call_operator_loc, opening_loc, arguments, closing_loc, block, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, receiver: Prism::node?, call_operator_loc: Location?, opening_loc: Location, arguments: ArgumentsNode?, closing_loc: Location, block: BlockArgumentNode?, operator_loc: Location, value: Prism::node }
@@ -9232,7 +9334,7 @@ module Prism
       visitor.visit_index_operator_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [receiver, arguments, block, value]
     end
@@ -9257,7 +9359,7 @@ module Prism
       IndexOperatorWriteNode.new(source, node_id, location, flags, receiver, call_operator_loc, opening_loc, arguments, closing_loc, block, binary_operator, binary_operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, receiver: Prism::node?, call_operator_loc: Location?, opening_loc: Location, arguments: ArgumentsNode?, closing_loc: Location, block: BlockArgumentNode?, binary_operator: Symbol, binary_operator_loc: Location, value: Prism::node }
@@ -9431,7 +9533,7 @@ module Prism
       visitor.visit_index_or_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [receiver, arguments, block, value]
     end
@@ -9456,7 +9558,7 @@ module Prism
       IndexOrWriteNode.new(source, node_id, location, flags, receiver, call_operator_loc, opening_loc, arguments, closing_loc, block, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, receiver: Prism::node?, call_operator_loc: Location?, opening_loc: Location, arguments: ArgumentsNode?, closing_loc: Location, block: BlockArgumentNode?, operator_loc: Location, value: Prism::node }
@@ -9636,7 +9738,7 @@ module Prism
       visitor.visit_index_target_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [receiver, arguments, block]
     end
@@ -9660,7 +9762,7 @@ module Prism
       IndexTargetNode.new(source, node_id, location, flags, receiver, opening_loc, arguments, closing_loc, block)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, receiver: Prism::node, opening_loc: Location, arguments: ArgumentsNode?, closing_loc: Location, block: BlockArgumentNode? }
@@ -9783,7 +9885,7 @@ module Prism
       visitor.visit_instance_variable_and_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -9803,7 +9905,7 @@ module Prism
       InstanceVariableAndWriteNode.new(source, node_id, location, flags, name, name_loc, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, operator_loc: Location, value: Prism::node }
@@ -9897,7 +9999,7 @@ module Prism
       visitor.visit_instance_variable_operator_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -9917,7 +10019,7 @@ module Prism
       InstanceVariableOperatorWriteNode.new(source, node_id, location, flags, name, name_loc, binary_operator_loc, value, binary_operator)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, binary_operator_loc: Location, value: Prism::node, binary_operator: Symbol }
@@ -10009,7 +10111,7 @@ module Prism
       visitor.visit_instance_variable_or_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -10029,7 +10131,7 @@ module Prism
       InstanceVariableOrWriteNode.new(source, node_id, location, flags, name, name_loc, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, operator_loc: Location, value: Prism::node }
@@ -10119,7 +10221,7 @@ module Prism
       visitor.visit_instance_variable_read_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -10139,7 +10241,7 @@ module Prism
       InstanceVariableReadNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -10196,7 +10298,7 @@ module Prism
       visitor.visit_instance_variable_target_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -10216,7 +10318,7 @@ module Prism
       InstanceVariableTargetNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -10272,7 +10374,7 @@ module Prism
       visitor.visit_instance_variable_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -10292,7 +10394,7 @@ module Prism
       InstanceVariableWriteNode.new(source, node_id, location, flags, name, name_loc, value, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, value: Prism::node, operator_loc: Location }
@@ -10398,7 +10500,7 @@ module Prism
       visitor.visit_integer_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -10418,7 +10520,7 @@ module Prism
       IntegerNode.new(source, node_id, location, flags, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, value: Integer }
@@ -10494,7 +10596,7 @@ module Prism
       visitor.visit_interpolated_match_last_line_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*parts]
     end
@@ -10514,7 +10616,7 @@ module Prism
       InterpolatedMatchLastLineNode.new(source, node_id, location, flags, opening_loc, parts, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location, parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode], closing_loc: Location }
@@ -10664,7 +10766,7 @@ module Prism
       visitor.visit_interpolated_regular_expression_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*parts]
     end
@@ -10684,7 +10786,7 @@ module Prism
       InterpolatedRegularExpressionNode.new(source, node_id, location, flags, opening_loc, parts, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location, parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode], closing_loc: Location }
@@ -10834,7 +10936,7 @@ module Prism
       visitor.visit_interpolated_string_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*parts]
     end
@@ -10849,15 +10951,15 @@ module Prism
       [*opening_loc, *parts, *closing_loc] #: Array[Prism::node | Location]
     end
 
-    # def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?opening_loc: Location?, ?parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode | InterpolatedStringNode], ?closing_loc: Location?) -> InterpolatedStringNode
+    # def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?opening_loc: Location?, ?parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode | InterpolatedStringNode | XStringNode], ?closing_loc: Location?) -> InterpolatedStringNode
     def copy(node_id: self.node_id, location: self.location, flags: self.flags, opening_loc: self.opening_loc, parts: self.parts, closing_loc: self.closing_loc)
       InterpolatedStringNode.new(source, node_id, location, flags, opening_loc, parts, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
-    # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location?, parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode | InterpolatedStringNode], closing_loc: Location? }
+    # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location?, parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode | InterpolatedStringNode | XStringNode], closing_loc: Location? }
     def deconstruct_keys(keys)
       { node_id: node_id, location: location, opening_loc: opening_loc, parts: parts, closing_loc: closing_loc }
     end
@@ -10891,7 +10993,7 @@ module Prism
       repository.enter(node_id, :opening_loc) unless @opening_loc.nil?
     end
 
-    # attr_reader parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode | InterpolatedStringNode]
+    # attr_reader parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode | InterpolatedStringNode | XStringNode]
     attr_reader :parts
 
     # attr_reader closing_loc: Location?
@@ -10971,7 +11073,7 @@ module Prism
       visitor.visit_interpolated_symbol_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*parts]
     end
@@ -10991,7 +11093,7 @@ module Prism
       InterpolatedSymbolNode.new(source, node_id, location, flags, opening_loc, parts, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location?, parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode], closing_loc: Location? }
@@ -11097,7 +11199,7 @@ module Prism
       visitor.visit_interpolated_x_string_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*parts]
     end
@@ -11117,7 +11219,7 @@ module Prism
       InterpolatedXStringNode.new(source, node_id, location, flags, opening_loc, parts, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location, parts: Array[StringNode | EmbeddedStatementsNode | EmbeddedVariableNode], closing_loc: Location }
@@ -11208,7 +11310,7 @@ module Prism
       visitor.visit_it_local_variable_read_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -11228,7 +11330,7 @@ module Prism
       ItLocalVariableReadNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -11276,7 +11378,7 @@ module Prism
       visitor.visit_it_parameters_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -11296,7 +11398,7 @@ module Prism
       ItParametersNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -11345,7 +11447,7 @@ module Prism
       visitor.visit_keyword_hash_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*elements]
     end
@@ -11365,7 +11467,7 @@ module Prism
       KeywordHashNode.new(source, node_id, location, flags, elements)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, elements: Array[AssocNode | AssocSplatNode] }
@@ -11428,7 +11530,7 @@ module Prism
       visitor.visit_keyword_rest_parameter_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -11448,7 +11550,7 @@ module Prism
       KeywordRestParameterNode.new(source, node_id, location, flags, name, name_loc, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol?, name_loc: Location?, operator_loc: Location }
@@ -11551,7 +11653,7 @@ module Prism
       visitor.visit_lambda_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [parameters, body]
     end
@@ -11574,7 +11676,7 @@ module Prism
       LambdaNode.new(source, node_id, location, flags, locals, operator_loc, opening_loc, closing_loc, parameters, body)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, locals: Array[Symbol], operator_loc: Location, opening_loc: Location, closing_loc: Location, parameters: BlockParametersNode | NumberedParametersNode | ItParametersNode | nil, body: StatementsNode | BeginNode | nil }
@@ -11697,7 +11799,7 @@ module Prism
       visitor.visit_local_variable_and_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -11717,7 +11819,7 @@ module Prism
       LocalVariableAndWriteNode.new(source, node_id, location, flags, name_loc, operator_loc, value, name, depth)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name_loc: Location, operator_loc: Location, value: Prism::node, name: Symbol, depth: Integer }
@@ -11816,7 +11918,7 @@ module Prism
       visitor.visit_local_variable_operator_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -11836,7 +11938,7 @@ module Prism
       LocalVariableOperatorWriteNode.new(source, node_id, location, flags, name_loc, binary_operator_loc, value, name, binary_operator, depth)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name_loc: Location, binary_operator_loc: Location, value: Prism::node, name: Symbol, binary_operator: Symbol, depth: Integer }
@@ -11933,7 +12035,7 @@ module Prism
       visitor.visit_local_variable_or_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -11953,7 +12055,7 @@ module Prism
       LocalVariableOrWriteNode.new(source, node_id, location, flags, name_loc, operator_loc, value, name, depth)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name_loc: Location, operator_loc: Location, value: Prism::node, name: Symbol, depth: Integer }
@@ -12048,7 +12150,7 @@ module Prism
       visitor.visit_local_variable_read_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -12068,7 +12170,7 @@ module Prism
       LocalVariableReadNode.new(source, node_id, location, flags, name, depth)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, depth: Integer }
@@ -12124,6 +12226,9 @@ module Prism
   #
   #     foo, bar = baz
   #     ^^^  ^^^
+  #
+  #     foo => baz
+  #            ^^^
   class LocalVariableTargetNode < Node
     # Initialize a new LocalVariableTargetNode node.
     def initialize(source, node_id, location, flags, name, depth)
@@ -12140,7 +12245,7 @@ module Prism
       visitor.visit_local_variable_target_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -12160,7 +12265,7 @@ module Prism
       LocalVariableTargetNode.new(source, node_id, location, flags, name, depth)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, depth: Integer }
@@ -12221,7 +12326,7 @@ module Prism
       visitor.visit_local_variable_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -12241,7 +12346,7 @@ module Prism
       LocalVariableWriteNode.new(source, node_id, location, flags, name, depth, name_loc, value, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, depth: Integer, name_loc: Location, value: Prism::node, operator_loc: Location }
@@ -12364,7 +12469,7 @@ module Prism
       visitor.visit_match_last_line_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -12384,7 +12489,7 @@ module Prism
       MatchLastLineNode.new(source, node_id, location, flags, opening_loc, content_loc, closing_loc, unescaped)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location, content_loc: Location, closing_loc: Location, unescaped: String }
@@ -12552,7 +12657,7 @@ module Prism
       visitor.visit_match_predicate_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value, pattern]
     end
@@ -12572,7 +12677,7 @@ module Prism
       MatchPredicateNode.new(source, node_id, location, flags, value, pattern, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, value: Prism::node, pattern: Prism::node, operator_loc: Location }
@@ -12650,7 +12755,7 @@ module Prism
       visitor.visit_match_required_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value, pattern]
     end
@@ -12670,7 +12775,7 @@ module Prism
       MatchRequiredNode.new(source, node_id, location, flags, value, pattern, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, value: Prism::node, pattern: Prism::node, operator_loc: Location }
@@ -12678,13 +12783,61 @@ module Prism
       { node_id: node_id, location: location, value: value, pattern: pattern, operator_loc: operator_loc }
     end
 
-    # attr_reader value: Prism::node
+    # Represents the left-hand side of the operator.
+    #
+    #     foo => bar
+    #     ^^^
     attr_reader :value
 
-    # attr_reader pattern: Prism::node
+    # Represents the right-hand side of the operator. The type of the node depends on the expression.
+    #
+    # Anything that looks like a local variable name (including `_`) will result in a `LocalVariableTargetNode`.
+    #
+    #     foo => a # This is equivalent to writing `a = foo`
+    #            ^
+    #
+    # Using an explicit `Array` or combining expressions with `,` will result in a `ArrayPatternNode`. This can be preceded by a constant.
+    #
+    #     foo => [a]
+    #            ^^^
+    #
+    #     foo => a, b
+    #            ^^^^
+    #
+    #     foo => Bar[a, b]
+    #            ^^^^^^^^^
+    #
+    # If the array pattern contains at least two wildcard matches, a `FindPatternNode` is created instead.
+    #
+    #     foo => *, 1, *a
+    #            ^^^^^
+    #
+    # Using an explicit `Hash` or a constant with square brackets and hash keys in the square brackets will result in a `HashPatternNode`.
+    #
+    #     foo => { a: 1, b: }
+    #
+    #     foo => Bar[a: 1, b:]
+    #
+    #     foo => Bar[**]
+    #
+    # To use any variable that needs run time evaluation, pinning is required. This results in a `PinnedVariableNode`
+    #
+    #     foo => ^a
+    #            ^^
+    #
+    # Similar, any expression can be used with pinning. This results in a `PinnedExpressionNode`.
+    #
+    #     foo => ^(a + 1)
+    #
+    # Anything else will result in the regular node for that expression, for example a `ConstantReadNode`.
+    #
+    #     foo => CONST
     attr_reader :pattern
 
-    # attr_reader operator_loc: Location
+    # The location of the operator.
+    #
+    #     foo => bar
+    #         ^^
     def operator_loc
       location = @operator_loc
       return location if location.is_a?(Location)
@@ -12747,7 +12900,7 @@ module Prism
       visitor.visit_match_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [call, *targets]
     end
@@ -12767,7 +12920,7 @@ module Prism
       MatchWriteNode.new(source, node_id, location, flags, call, targets)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, call: CallNode, targets: Array[LocalVariableTargetNode] }
@@ -12821,7 +12974,7 @@ module Prism
       visitor.visit_missing_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -12841,7 +12994,7 @@ module Prism
       MissingNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -12895,7 +13048,7 @@ module Prism
       visitor.visit_module_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [constant_path, body]
     end
@@ -12918,7 +13071,7 @@ module Prism
       ModuleNode.new(source, node_id, location, flags, locals, module_keyword_loc, constant_path, body, end_keyword_loc, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, locals: Array[Symbol], module_keyword_loc: Location, constant_path: ConstantReadNode | ConstantPathNode | MissingNode, body: StatementsNode | BeginNode | nil, end_keyword_loc: Location, name: Symbol }
@@ -13031,7 +13184,7 @@ module Prism
       visitor.visit_multi_target_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*lefts, rest, *rights]
     end
@@ -13055,7 +13208,7 @@ module Prism
       MultiTargetNode.new(source, node_id, location, flags, lefts, rest, rights, lparen_loc, rparen_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, lefts: Array[LocalVariableTargetNode | InstanceVariableTargetNode | ClassVariableTargetNode | GlobalVariableTargetNode | ConstantTargetNode | ConstantPathTargetNode | CallTargetNode | IndexTargetNode | MultiTargetNode | RequiredParameterNode | BackReferenceReadNode | NumberedReferenceReadNode], rest: ImplicitRestNode | SplatNode | nil, rights: Array[LocalVariableTargetNode | InstanceVariableTargetNode | ClassVariableTargetNode | GlobalVariableTargetNode | ConstantTargetNode | ConstantPathTargetNode | CallTargetNode | IndexTargetNode | MultiTargetNode | RequiredParameterNode | BackReferenceReadNode | NumberedReferenceReadNode], lparen_loc: Location?, rparen_loc: Location? }
@@ -13204,7 +13357,7 @@ module Prism
       visitor.visit_multi_write_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*lefts, rest, *rights, value]
     end
@@ -13229,7 +13382,7 @@ module Prism
       MultiWriteNode.new(source, node_id, location, flags, lefts, rest, rights, lparen_loc, rparen_loc, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, lefts: Array[LocalVariableTargetNode | InstanceVariableTargetNode | ClassVariableTargetNode | GlobalVariableTargetNode | ConstantTargetNode | ConstantPathTargetNode | CallTargetNode | IndexTargetNode | MultiTargetNode | BackReferenceReadNode | NumberedReferenceReadNode], rest: ImplicitRestNode | SplatNode | nil, rights: Array[LocalVariableTargetNode | InstanceVariableTargetNode | ClassVariableTargetNode | GlobalVariableTargetNode | ConstantTargetNode | ConstantPathTargetNode | CallTargetNode | IndexTargetNode | MultiTargetNode | BackReferenceReadNode | NumberedReferenceReadNode], lparen_loc: Location?, rparen_loc: Location?, operator_loc: Location, value: Prism::node }
@@ -13402,7 +13555,7 @@ module Prism
       visitor.visit_next_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [arguments]
     end
@@ -13424,7 +13577,7 @@ module Prism
       NextNode.new(source, node_id, location, flags, arguments, keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, arguments: ArgumentsNode?, keyword_loc: Location }
@@ -13495,7 +13648,7 @@ module Prism
       visitor.visit_nil_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -13515,7 +13668,7 @@ module Prism
       NilNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -13566,7 +13719,7 @@ module Prism
       visitor.visit_no_keywords_parameter_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -13586,7 +13739,7 @@ module Prism
       NoKeywordsParameterNode.new(source, node_id, location, flags, operator_loc, keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, operator_loc: Location, keyword_loc: Location }
@@ -13673,7 +13826,7 @@ module Prism
       visitor.visit_numbered_parameters_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -13693,7 +13846,7 @@ module Prism
       NumberedParametersNode.new(source, node_id, location, flags, maximum)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, maximum: Integer }
@@ -13746,7 +13899,7 @@ module Prism
       visitor.visit_numbered_reference_read_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -13766,7 +13919,7 @@ module Prism
       NumberedReferenceReadNode.new(source, node_id, location, flags, number)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, number: Integer }
@@ -13828,7 +13981,7 @@ module Prism
       visitor.visit_optional_keyword_parameter_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -13848,7 +14001,7 @@ module Prism
       OptionalKeywordParameterNode.new(source, node_id, location, flags, name, name_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, value: Prism::node }
@@ -13929,7 +14082,7 @@ module Prism
       visitor.visit_optional_parameter_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [value]
     end
@@ -13949,7 +14102,7 @@ module Prism
       OptionalParameterNode.new(source, node_id, location, flags, name, name_loc, operator_loc, value)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location, operator_loc: Location, value: Prism::node }
@@ -14047,7 +14200,7 @@ module Prism
       visitor.visit_or_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [left, right]
     end
@@ -14067,7 +14220,7 @@ module Prism
       OrNode.new(source, node_id, location, flags, left, right, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, left: Prism::node, right: Prism::node, operator_loc: Location }
@@ -14165,7 +14318,7 @@ module Prism
       visitor.visit_parameters_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*requireds, *optionals, rest, *posts, *keywords, keyword_rest, block]
     end
@@ -14193,7 +14346,7 @@ module Prism
       ParametersNode.new(source, node_id, location, flags, requireds, optionals, rest, posts, keywords, keyword_rest, block)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, requireds: Array[RequiredParameterNode | MultiTargetNode], optionals: Array[OptionalParameterNode], rest: RestParameterNode | ImplicitRestNode | nil, posts: Array[RequiredParameterNode | MultiTargetNode | KeywordRestParameterNode | NoKeywordsParameterNode | ForwardingParameterNode], keywords: Array[RequiredKeywordParameterNode | OptionalKeywordParameterNode], keyword_rest: KeywordRestParameterNode | ForwardingParameterNode | NoKeywordsParameterNode | nil, block: BlockParameterNode? }
@@ -14276,7 +14429,7 @@ module Prism
       visitor.visit_parentheses_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [body]
     end
@@ -14298,7 +14451,7 @@ module Prism
       ParenthesesNode.new(source, node_id, location, flags, body, opening_loc, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, body: Prism::node?, opening_loc: Location, closing_loc: Location }
@@ -14306,6 +14459,11 @@ module Prism
       { node_id: node_id, location: location, body: body, opening_loc: opening_loc, closing_loc: closing_loc }
     end
 
+    # def multiple_statements?: () -> bool
+    def multiple_statements?
+      flags.anybits?(ParenthesesNodeFlags::MULTIPLE_STATEMENTS)
+    end
+
     # attr_reader body: Prism::node?
     attr_reader :body
 
@@ -14364,6 +14522,7 @@ module Prism
     # comparing the value of locations. Locations are checked only for presence.
     def ===(other)
       other.is_a?(ParenthesesNode) &&
+        (flags === other.flags) &&
         (body === other.body) &&
         (opening_loc.nil? == other.opening_loc.nil?) &&
         (closing_loc.nil? == other.closing_loc.nil?)
@@ -14392,7 +14551,7 @@ module Prism
       visitor.visit_pinned_expression_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [expression]
     end
@@ -14412,7 +14571,7 @@ module Prism
       PinnedExpressionNode.new(source, node_id, location, flags, expression, operator_loc, lparen_loc, rparen_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, expression: Prism::node, operator_loc: Location, lparen_loc: Location, rparen_loc: Location }
@@ -14420,10 +14579,16 @@ module Prism
       { node_id: node_id, location: location, expression: expression, operator_loc: operator_loc, lparen_loc: lparen_loc, rparen_loc: rparen_loc }
     end
 
-    # attr_reader expression: Prism::node
+    # The expression used in the pinned expression
+    #
+    #     foo in ^(bar)
+    #              ^^^
     attr_reader :expression
 
-    # attr_reader operator_loc: Location
+    # The location of the `^` operator
+    #
+    #     foo in ^(bar)
+    #            ^
     def operator_loc
       location = @operator_loc
       return location if location.is_a?(Location)
@@ -14436,7 +14601,10 @@ module Prism
       repository.enter(node_id, :operator_loc)
     end
 
-    # attr_reader lparen_loc: Location
+    # The location of the opening parenthesis.
+    #
+    #     foo in ^(bar)
+    #             ^
     def lparen_loc
       location = @lparen_loc
       return location if location.is_a?(Location)
@@ -14449,7 +14617,10 @@ module Prism
       repository.enter(node_id, :lparen_loc)
     end
 
-    # attr_reader rparen_loc: Location
+    # The location of the closing parenthesis.
+    #
+    #     foo in ^(bar)
+    #                 ^
     def rparen_loc
       location = @rparen_loc
       return location if location.is_a?(Location)
@@ -14523,7 +14694,7 @@ module Prism
       visitor.visit_pinned_variable_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [variable]
     end
@@ -14543,7 +14714,7 @@ module Prism
       PinnedVariableNode.new(source, node_id, location, flags, variable, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, variable: LocalVariableReadNode | InstanceVariableReadNode | ClassVariableReadNode | GlobalVariableReadNode | BackReferenceReadNode | NumberedReferenceReadNode | ItLocalVariableReadNode | MissingNode, operator_loc: Location }
@@ -14551,10 +14722,16 @@ module Prism
       { node_id: node_id, location: location, variable: variable, operator_loc: operator_loc }
     end
 
-    # attr_reader variable: LocalVariableReadNode | InstanceVariableReadNode | ClassVariableReadNode | GlobalVariableReadNode | BackReferenceReadNode | NumberedReferenceReadNode | ItLocalVariableReadNode | MissingNode
+    # The variable used in the pinned expression
+    #
+    #     foo in ^bar
+    #             ^^^
     attr_reader :variable
 
-    # attr_reader operator_loc: Location
+    # The location of the `^` operator
+    #
+    #     foo in ^bar
+    #            ^
     def operator_loc
       location = @operator_loc
       return location if location.is_a?(Location)
@@ -14618,7 +14795,7 @@ module Prism
       visitor.visit_post_execution_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [statements]
     end
@@ -14640,7 +14817,7 @@ module Prism
       PostExecutionNode.new(source, node_id, location, flags, statements, keyword_loc, opening_loc, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, statements: StatementsNode?, keyword_loc: Location, opening_loc: Location, closing_loc: Location }
@@ -14753,7 +14930,7 @@ module Prism
       visitor.visit_pre_execution_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [statements]
     end
@@ -14775,7 +14952,7 @@ module Prism
       PreExecutionNode.new(source, node_id, location, flags, statements, keyword_loc, opening_loc, closing_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, statements: StatementsNode?, keyword_loc: Location, opening_loc: Location, closing_loc: Location }
@@ -14883,7 +15060,7 @@ module Prism
       visitor.visit_program_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [statements]
     end
@@ -14903,7 +15080,7 @@ module Prism
       ProgramNode.new(source, node_id, location, flags, locals, statements)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, locals: Array[Symbol], statements: StatementsNode }
@@ -14966,7 +15143,7 @@ module Prism
       visitor.visit_range_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [left, right]
     end
@@ -14989,7 +15166,7 @@ module Prism
       RangeNode.new(source, node_id, location, flags, left, right, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, left: Prism::node?, right: Prism::node?, operator_loc: Location }
@@ -15085,7 +15262,7 @@ module Prism
       visitor.visit_rational_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -15105,7 +15282,7 @@ module Prism
       RationalNode.new(source, node_id, location, flags, numerator, denominator)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, numerator: Integer, denominator: Integer }
@@ -15186,7 +15363,7 @@ module Prism
       visitor.visit_redo_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -15206,7 +15383,7 @@ module Prism
       RedoNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -15258,7 +15435,7 @@ module Prism
       visitor.visit_regular_expression_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -15278,7 +15455,7 @@ module Prism
       RegularExpressionNode.new(source, node_id, location, flags, opening_loc, content_loc, closing_loc, unescaped)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location, content_loc: Location, closing_loc: Location, unescaped: String }
@@ -15446,7 +15623,7 @@ module Prism
       visitor.visit_required_keyword_parameter_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -15466,7 +15643,7 @@ module Prism
       RequiredKeywordParameterNode.new(source, node_id, location, flags, name, name_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol, name_loc: Location }
@@ -15540,7 +15717,7 @@ module Prism
       visitor.visit_required_parameter_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -15560,7 +15737,7 @@ module Prism
       RequiredParameterNode.new(source, node_id, location, flags, name)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol }
@@ -15621,7 +15798,7 @@ module Prism
       visitor.visit_rescue_modifier_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [expression, rescue_expression]
     end
@@ -15641,7 +15818,7 @@ module Prism
       RescueModifierNode.new(source, node_id, location, flags, expression, keyword_loc, rescue_expression)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, expression: Prism::node, keyword_loc: Location, rescue_expression: Prism::node }
@@ -15709,7 +15886,7 @@ module Prism
   # `Foo, *splat, Bar` are in the `exceptions` field. `ex` is in the `reference` field.
   class RescueNode < Node
     # Initialize a new RescueNode node.
-    def initialize(source, node_id, location, flags, keyword_loc, exceptions, operator_loc, reference, statements, subsequent)
+    def initialize(source, node_id, location, flags, keyword_loc, exceptions, operator_loc, reference, then_keyword_loc, statements, subsequent)
       @source = source
       @node_id = node_id
       @location = location
@@ -15718,6 +15895,7 @@ module Prism
       @exceptions = exceptions
       @operator_loc = operator_loc
       @reference = reference
+      @then_keyword_loc = then_keyword_loc
       @statements = statements
       @subsequent = subsequent
     end
@@ -15727,7 +15905,7 @@ module Prism
       visitor.visit_rescue_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*exceptions, reference, statements, subsequent]
     end
@@ -15744,20 +15922,20 @@ module Prism
 
     # def comment_targets: () -> Array[Node | Location]
     def comment_targets
-      [keyword_loc, *exceptions, *operator_loc, *reference, *statements, *subsequent] #: Array[Prism::node | Location]
+      [keyword_loc, *exceptions, *operator_loc, *reference, *then_keyword_loc, *statements, *subsequent] #: Array[Prism::node | Location]
     end
 
-    # def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?keyword_loc: Location, ?exceptions: Array[Prism::node], ?operator_loc: Location?, ?reference: LocalVariableTargetNode | InstanceVariableTargetNode | ClassVariableTargetNode | GlobalVariableTargetNode | ConstantTargetNode | ConstantPathTargetNode | CallTargetNode | IndexTargetNode | BackReferenceReadNode | NumberedReferenceReadNode | MissingNode | nil, ?statements: StatementsNode?, ?subsequent: RescueNode?) -> RescueNode
-    def copy(node_id: self.node_id, location: self.location, flags: self.flags, keyword_loc: self.keyword_loc, exceptions: self.exceptions, operator_loc: self.operator_loc, reference: self.reference, statements: self.statements, subsequent: self.subsequent)
-      RescueNode.new(source, node_id, location, flags, keyword_loc, exceptions, operator_loc, reference, statements, subsequent)
+    # def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?keyword_loc: Location, ?exceptions: Array[Prism::node], ?operator_loc: Location?, ?reference: LocalVariableTargetNode | InstanceVariableTargetNode | ClassVariableTargetNode | GlobalVariableTargetNode | ConstantTargetNode | ConstantPathTargetNode | CallTargetNode | IndexTargetNode | BackReferenceReadNode | NumberedReferenceReadNode | MissingNode | nil, ?then_keyword_loc: Location?, ?statements: StatementsNode?, ?subsequent: RescueNode?) -> RescueNode
+    def copy(node_id: self.node_id, location: self.location, flags: self.flags, keyword_loc: self.keyword_loc, exceptions: self.exceptions, operator_loc: self.operator_loc, reference: self.reference, then_keyword_loc: self.then_keyword_loc, statements: self.statements, subsequent: self.subsequent)
+      RescueNode.new(source, node_id, location, flags, keyword_loc, exceptions, operator_loc, reference, then_keyword_loc, statements, subsequent)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
-    # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, keyword_loc: Location, exceptions: Array[Prism::node], operator_loc: Location?, reference: LocalVariableTargetNode | InstanceVariableTargetNode | ClassVariableTargetNode | GlobalVariableTargetNode | ConstantTargetNode | ConstantPathTargetNode | CallTargetNode | IndexTargetNode | BackReferenceReadNode | NumberedReferenceReadNode | MissingNode | nil, statements: StatementsNode?, subsequent: RescueNode? }
+    # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, keyword_loc: Location, exceptions: Array[Prism::node], operator_loc: Location?, reference: LocalVariableTargetNode | InstanceVariableTargetNode | ClassVariableTargetNode | GlobalVariableTargetNode | ConstantTargetNode | ConstantPathTargetNode | CallTargetNode | IndexTargetNode | BackReferenceReadNode | NumberedReferenceReadNode | MissingNode | nil, then_keyword_loc: Location?, statements: StatementsNode?, subsequent: RescueNode? }
     def deconstruct_keys(keys)
-      { node_id: node_id, location: location, keyword_loc: keyword_loc, exceptions: exceptions, operator_loc: operator_loc, reference: reference, statements: statements, subsequent: subsequent }
+      { node_id: node_id, location: location, keyword_loc: keyword_loc, exceptions: exceptions, operator_loc: operator_loc, reference: reference, then_keyword_loc: then_keyword_loc, statements: statements, subsequent: subsequent }
     end
 
     # attr_reader keyword_loc: Location
@@ -15798,6 +15976,25 @@ module Prism
     # attr_reader reference: LocalVariableTargetNode | InstanceVariableTargetNode | ClassVariableTargetNode | GlobalVariableTargetNode | ConstantTargetNode | ConstantPathTargetNode | CallTargetNode | IndexTargetNode | BackReferenceReadNode | NumberedReferenceReadNode | MissingNode | nil
     attr_reader :reference
 
+    # attr_reader then_keyword_loc: Location?
+    def then_keyword_loc
+      location = @then_keyword_loc
+      case location
+      when nil
+        nil
+      when Location
+        location
+      else
+        @then_keyword_loc = Location.new(source, location >> 32, location & 0xFFFFFFFF)
+      end
+    end
+
+    # Save the then_keyword_loc location using the given saved source so that
+    # it can be retrieved later.
+    def save_then_keyword_loc(repository)
+      repository.enter(node_id, :then_keyword_loc) unless @then_keyword_loc.nil?
+    end
+
     # attr_reader statements: StatementsNode?
     attr_reader :statements
 
@@ -15814,6 +16011,11 @@ module Prism
       operator_loc&.slice
     end
 
+    # def then_keyword: () -> String?
+    def then_keyword
+      then_keyword_loc&.slice
+    end
+
     # def inspect -> String
     def inspect
       InspectVisitor.compose(self)
@@ -15838,6 +16040,7 @@ module Prism
         exceptions.zip(other.exceptions).all? { |left, right| left === right } &&
         (operator_loc.nil? == other.operator_loc.nil?) &&
         (reference === other.reference) &&
+        (then_keyword_loc.nil? == other.then_keyword_loc.nil?) &&
         (statements === other.statements) &&
         (subsequent === other.subsequent)
     end
@@ -15865,7 +16068,7 @@ module Prism
       visitor.visit_rest_parameter_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -15885,7 +16088,7 @@ module Prism
       RestParameterNode.new(source, node_id, location, flags, name, name_loc, operator_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, name: Symbol?, name_loc: Location?, operator_loc: Location }
@@ -15982,7 +16185,7 @@ module Prism
       visitor.visit_retry_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -16002,7 +16205,7 @@ module Prism
       RetryNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -16052,7 +16255,7 @@ module Prism
       visitor.visit_return_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [arguments]
     end
@@ -16074,7 +16277,7 @@ module Prism
       ReturnNode.new(source, node_id, location, flags, keyword_loc, arguments)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, keyword_loc: Location, arguments: ArgumentsNode? }
@@ -16145,7 +16348,7 @@ module Prism
       visitor.visit_self_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -16165,7 +16368,7 @@ module Prism
       SelfNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -16215,7 +16418,7 @@ module Prism
       visitor.visit_shareable_constant_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [write]
     end
@@ -16235,7 +16438,7 @@ module Prism
       ShareableConstantNode.new(source, node_id, location, flags, write)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, write: ConstantWriteNode | ConstantAndWriteNode | ConstantOrWriteNode | ConstantOperatorWriteNode | ConstantPathWriteNode | ConstantPathAndWriteNode | ConstantPathOrWriteNode | ConstantPathOperatorWriteNode }
@@ -16309,7 +16512,7 @@ module Prism
       visitor.visit_singleton_class_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [expression, body]
     end
@@ -16332,7 +16535,7 @@ module Prism
       SingletonClassNode.new(source, node_id, location, flags, locals, class_keyword_loc, operator_loc, expression, body, end_keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, locals: Array[Symbol], class_keyword_loc: Location, operator_loc: Location, expression: Prism::node, body: StatementsNode | BeginNode | nil, end_keyword_loc: Location }
@@ -16450,7 +16653,7 @@ module Prism
       visitor.visit_source_encoding_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -16470,7 +16673,7 @@ module Prism
       SourceEncodingNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -16519,7 +16722,7 @@ module Prism
       visitor.visit_source_file_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -16539,7 +16742,7 @@ module Prism
       SourceFileNode.new(source, node_id, location, flags, filepath)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, filepath: String }
@@ -16612,7 +16815,7 @@ module Prism
       visitor.visit_source_line_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -16632,7 +16835,7 @@ module Prism
       SourceLineNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -16682,7 +16885,7 @@ module Prism
       visitor.visit_splat_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [expression]
     end
@@ -16704,7 +16907,7 @@ module Prism
       SplatNode.new(source, node_id, location, flags, operator_loc, expression)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, operator_loc: Location, expression: Prism::node? }
@@ -16776,7 +16979,7 @@ module Prism
       visitor.visit_statements_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*body]
     end
@@ -16796,7 +16999,7 @@ module Prism
       StatementsNode.new(source, node_id, location, flags, body)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, body: Array[Prism::node] }
@@ -16859,7 +17062,7 @@ module Prism
       visitor.visit_string_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -16879,7 +17082,7 @@ module Prism
       StringNode.new(source, node_id, location, flags, opening_loc, content_loc, closing_loc, unescaped)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location?, content_loc: Location, closing_loc: Location?, unescaped: String }
@@ -17029,7 +17232,7 @@ module Prism
       visitor.visit_super_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [arguments, block]
     end
@@ -17052,7 +17255,7 @@ module Prism
       SuperNode.new(source, node_id, location, flags, keyword_loc, lparen_loc, arguments, rparen_loc, block)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, keyword_loc: Location, lparen_loc: Location?, arguments: ArgumentsNode?, rparen_loc: Location?, block: BlockNode | BlockArgumentNode | nil }
@@ -17184,7 +17387,7 @@ module Prism
       visitor.visit_symbol_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -17204,7 +17407,7 @@ module Prism
       SymbolNode.new(source, node_id, location, flags, opening_loc, value_loc, closing_loc, unescaped)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location?, value_loc: Location?, closing_loc: Location?, unescaped: String }
@@ -17347,7 +17550,7 @@ module Prism
       visitor.visit_true_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -17367,7 +17570,7 @@ module Prism
       TrueNode.new(source, node_id, location, flags)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location }
@@ -17417,7 +17620,7 @@ module Prism
       visitor.visit_undef_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*names]
     end
@@ -17437,7 +17640,7 @@ module Prism
       UndefNode.new(source, node_id, location, flags, names, keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, names: Array[SymbolNode | InterpolatedSymbolNode], keyword_loc: Location }
@@ -17518,7 +17721,7 @@ module Prism
       visitor.visit_unless_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [predicate, statements, else_clause]
     end
@@ -17542,7 +17745,7 @@ module Prism
       UnlessNode.new(source, node_id, location, flags, keyword_loc, predicate, then_keyword_loc, statements, else_clause, end_keyword_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, keyword_loc: Location, predicate: Prism::node, then_keyword_loc: Location?, statements: StatementsNode?, else_clause: ElseNode?, end_keyword_loc: Location? }
@@ -17704,7 +17907,7 @@ module Prism
       visitor.visit_until_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [predicate, statements]
     end
@@ -17727,7 +17930,7 @@ module Prism
       UntilNode.new(source, node_id, location, flags, keyword_loc, do_keyword_loc, closing_loc, predicate, statements)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, keyword_loc: Location, do_keyword_loc: Location?, closing_loc: Location?, predicate: Prism::node, statements: StatementsNode? }
@@ -17864,7 +18067,7 @@ module Prism
       visitor.visit_when_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [*conditions, statements]
     end
@@ -17887,7 +18090,7 @@ module Prism
       WhenNode.new(source, node_id, location, flags, keyword_loc, conditions, then_keyword_loc, statements)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, keyword_loc: Location, conditions: Array[Prism::node], then_keyword_loc: Location?, statements: StatementsNode? }
@@ -17996,7 +18199,7 @@ module Prism
       visitor.visit_while_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [predicate, statements]
     end
@@ -18019,7 +18222,7 @@ module Prism
       WhileNode.new(source, node_id, location, flags, keyword_loc, do_keyword_loc, closing_loc, predicate, statements)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, keyword_loc: Location, do_keyword_loc: Location?, closing_loc: Location?, predicate: Prism::node, statements: StatementsNode? }
@@ -18154,7 +18357,7 @@ module Prism
       visitor.visit_x_string_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       []
     end
@@ -18174,7 +18377,7 @@ module Prism
       XStringNode.new(source, node_id, location, flags, opening_loc, content_loc, closing_loc, unescaped)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, opening_loc: Location, content_loc: Location, closing_loc: Location, unescaped: String }
@@ -18298,7 +18501,7 @@ module Prism
       visitor.visit_yield_node(self)
     end
 
-    # def child_nodes: () -> Array[nil | Node]
+    # def child_nodes: () -> Array[Node?]
     def child_nodes
       [arguments]
     end
@@ -18320,7 +18523,7 @@ module Prism
       YieldNode.new(source, node_id, location, flags, keyword_loc, lparen_loc, arguments, rparen_loc)
     end
 
-    # def deconstruct: () -> Array[nil | Node]
+    # def deconstruct: () -> Array[Node?]
     alias deconstruct child_nodes
 
     # def deconstruct_keys: (Array[Symbol] keys) -> { node_id: Integer, location: Location, keyword_loc: Location, lparen_loc: Location?, arguments: ArgumentsNode?, rparen_loc: Location? }
@@ -18513,6 +18716,12 @@ module Prism
     REPEATED_PARAMETER = 1 << 2
   end
 
+  # Flags for parentheses nodes.
+  module ParenthesesNodeFlags
+    # parentheses that contain multiple potentially void statements
+    MULTIPLE_STATEMENTS = 1 << 2
+  end
+
   # Flags for range and flip-flop nodes.
   module RangeFlags
     # ... operator