parser: add Builders::Default#value, string_value and loc

gems/parser/3.2/_test/test.rb

@@ -76,6 +76,24 @@
   node.loc.end
 end
 
+class TestBuilder < Parser::Builders::Default
+  def token_value(range)
+    value(["foo", range]).upcase
+  end
+
+  def token_string_value(range)
+    string_value(["foo", range]).upcase
+  end
+
+  def token_loc(range)
+    loc(["foo", range])&.source
+    loc(nil)&.source
+  end
+end
+TestBuilder.new.token_value(range)
+TestBuilder.new.token_string_value(range)
+TestBuilder.new.token_loc(range)
+
 parser = Parser::CurrentRuby.new
 parser.version + 1
 parser.diagnostics.all_errors_are_fatal = true

gems/parser/3.2/_test/test.rbs

@@ -0,0 +1,5 @@
+class TestBuilder < Parser::Builders::Default
+  def token_value: (Parser::Source::Range range) -> String
+  def token_string_value: (Parser::Source::Range range) -> String
+  def token_loc: (Parser::Source::Range range) -> String?
+end

gems/parser/3.2/parser.rbs

@@ -88,6 +88,16 @@ module Parser
     end
   end
 
+  module Builders
+    class Default
+      private
+
+      def value: [T] ([T, Source::Range] token) -> T
+      def string_value: ([String, Source::Range] token) -> String
+      def loc: ([top, Source::Range]? token) -> Source::Range?
+    end
+  end
+
   module Source
     class Range
       attr_reader source_buffer: Buffer