mangrove 0.31.0 → 0.34.0

data/sorbet/rbi/gems/{json@2.7.2.rbi → json@2.9.1.rbi}

@@ -7,7 +7,7 @@
 
 # Extends any Class to include _json_creatable?_ method.
 #
-# source://json//lib/json/common.rb#690
+# source://json//lib/json/common.rb#888
 class Class < ::Module
   # Returns true if this class can be used to create an instance
   # from a serialised JSON string. The class has to implement a class
@@ -16,7 +16,7 @@ class Class < ::Module
   #
   # @return [Boolean]
   #
-  # source://json//lib/json/common.rb#695
+  # source://json//lib/json/common.rb#893
   def json_creatable?; end
 end
 
@@ -396,13 +396,13 @@ end
 #   json1 = JSON.generate(ruby)
 #   ruby1 = JSON.parse(json1, create_additions: true)
 #   # Make a nice display.
-#   display = <<EOT
-#   Generated JSON:
-#     Without addition:  #{json0} (#{json0.class})
-#     With addition:     #{json1} (#{json1.class})
-#   Parsed JSON:
-#     Without addition:  #{ruby0.inspect} (#{ruby0.class})
-#     With addition:     #{ruby1.inspect} (#{ruby1.class})
+#   display = <<~EOT
+#     Generated JSON:
+#       Without addition:  #{json0} (#{json0.class})
+#       With addition:     #{json1} (#{json1.class})
+#     Parsed JSON:
+#       Without addition:  #{ruby0.inspect} (#{ruby0.class})
+#       With addition:     #{ruby1.inspect} (#{ruby1.class})
 #   EOT
 #   puts display
 #
@@ -580,13 +580,13 @@ end
 #   json1 = JSON.generate(foo1)
 #   obj1 = JSON.parse(json1, create_additions: true)
 #   #   Make a nice display.
-#   display = <<EOT
-#   Generated JSON:
-#     Without custom addition:  #{json0} (#{json0.class})
-#     With custom addition:     #{json1} (#{json1.class})
-#   Parsed JSON:
-#     Without custom addition:  #{obj0.inspect} (#{obj0.class})
-#     With custom addition:     #{obj1.inspect} (#{obj1.class})
+#   display = <<~EOT
+#     Generated JSON:
+#       Without custom addition:  #{json0} (#{json0.class})
+#       With custom addition:     #{json1} (#{json1.class})
+#     Parsed JSON:
+#       Without custom addition:  #{obj0.inspect} (#{obj0.class})
+#       With custom addition:     #{obj1.inspect} (#{obj1.class})
 #   EOT
 #   puts display
 #
@@ -599,7 +599,7 @@ end
 #     Without custom addition:  "#<Foo:0x0000000006534e80>" (String)
 #     With custom addition:     #<Foo:0x0000000006473bb8 @bar=0, @baz=1> (Foo)
 #
-# source://json//lib/json/version.rb#2
+# source://json//lib/json/version.rb#3
 module JSON
   private
 
@@ -631,7 +631,7 @@ module JSON
   # Output:
   #   {"foo":[0,1],"bar":{"baz":2,"bat":3},"bam":"bad"}
   #
-  # source://json//lib/json/common.rb#615
+  # source://json//lib/json/common.rb#795
   def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil), kwargs = T.unsafe(nil)); end
 
   # :call-seq:
@@ -693,7 +693,7 @@ module JSON
   #   # Raises JSON::NestingError (nesting of 100 is too deep):
   #   JSON.generate(a)
   #
-  # source://json//lib/json/common.rb#300
+  # source://json//lib/json/common.rb#301
   def generate(obj, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -701,6 +701,16 @@ module JSON
   #
   # Returns the Ruby objects created by parsing the given +source+.
   #
+  # BEWARE: This method is meant to serialise data from trusted user input,
+  # like from your own database server or clients under your control, it could
+  # be dangerous to allow untrusted users to pass JSON sources into it.
+  # If you must use it, use JSON.unsafe_load instead to make it clear.
+  #
+  # Since JSON version 2.8.0, `load` emits a deprecation warning when a
+  # non native type is deserialized, without `create_additions` being explicitly
+  # enabled, and in JSON version 3.0, `load` will have `create_additions` disabled
+  # by default.
+  #
   # - Argument +source+ must be, or be convertible to, a \String:
   #   - If +source+ responds to instance method +to_str+,
   #     <tt>source.to_str</tt> becomes the source.
@@ -715,9 +725,6 @@ module JSON
   # - Argument +proc+, if given, must be a \Proc that accepts one argument.
   #   It will be called recursively with each result (depth-first order).
   #   See details below.
-  #   BEWARE: This method is meant to serialise data from trusted user input,
-  #   like from your own database server or clients under your control, it could
-  #   be dangerous to allow untrusted users to pass JSON sources into it.
   # - Argument +opts+, if given, contains a \Hash of options for the parsing.
   #   See {Parsing Options}[#module-JSON-label-Parsing+Options].
   #   The default options can be changed via method JSON.load_default_options=.
@@ -728,17 +735,17 @@ module JSON
   # <tt>parse(source, opts)</tt>;  see #parse.
   #
   # Source for following examples:
-  #   source = <<-EOT
-  #   {
-  #   "name": "Dave",
-  #     "age" :40,
-  #     "hats": [
-  #       "Cattleman's",
-  #       "Panama",
-  #       "Tophat"
-  #     ]
-  #   }
-  #   EOT
+  #   source = <<~JSON
+  #     {
+  #       "name": "Dave",
+  #       "age" :40,
+  #       "hats": [
+  #         "Cattleman's",
+  #         "Panama",
+  #         "Tophat"
+  #       ]
+  #     }
+  #   JSON
   #
   # Load a \String:
   #   ruby = JSON.load(source)
@@ -824,7 +831,7 @@ module JSON
   #      #<Admin:0x00000000064c41f8
   #      @attributes={"type"=>"Admin", "password"=>"0wn3d"}>}
   #
-  # source://json//lib/json/common.rb#541
+  # source://json//lib/json/common.rb#714
   def load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
   # :call-seq:
@@ -835,7 +842,7 @@ module JSON
   #
   # See method #parse.
   #
-  # source://json//lib/json/common.rb#249
+  # source://json//lib/json/common.rb#250
   def load_file(filespec, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -846,10 +853,10 @@ module JSON
   #
   # See method #parse!
   #
-  # source://json//lib/json/common.rb#260
+  # source://json//lib/json/common.rb#261
   def load_file!(filespec, opts = T.unsafe(nil)); end
 
-  # source://json//lib/json/common.rb#643
+  # source://json//lib/json/common.rb#836
   def merge_dump_options(opts, strict: T.unsafe(nil)); end
 
   # :call-seq:
@@ -880,17 +887,17 @@ module JSON
   # {Parsing \JSON}[#module-JSON-label-Parsing+JSON].
   #
   # Parses nested JSON objects:
-  #   source = <<-EOT
-  #   {
-  #   "name": "Dave",
-  #     "age" :40,
-  #     "hats": [
-  #       "Cattleman's",
-  #       "Panama",
-  #       "Tophat"
-  #     ]
-  #   }
-  #   EOT
+  #   source = <<~JSON
+  #     {
+  #     "name": "Dave",
+  #       "age" :40,
+  #       "hats": [
+  #         "Cattleman's",
+  #         "Panama",
+  #         "Tophat"
+  #       ]
+  #     }
+  #   JSON
   #   ruby = JSON.parse(source)
   #   ruby # => {"name"=>"Dave", "age"=>40, "hats"=>["Cattleman's", "Panama", "Tophat"]}
   #
@@ -900,7 +907,7 @@ module JSON
   #   # Raises JSON::ParserError (783: unexpected token at ''):
   #   JSON.parse('')
   #
-  # source://json//lib/json/common.rb#219
+  # source://json//lib/json/common.rb#220
   def parse(source, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -915,7 +922,7 @@ module JSON
   #   which disables checking for nesting depth.
   # - Option +allow_nan+, if not provided, defaults to +true+.
   #
-  # source://json//lib/json/common.rb#234
+  # source://json//lib/json/common.rb#235
   def parse!(source, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -959,19 +966,151 @@ module JSON
 
   # Recursively calls passed _Proc_ if the parsed data structure is an _Array_ or _Hash_
   #
-  # source://json//lib/json/common.rb#559
+  # source://json//lib/json/common.rb#740
   def recurse_proc(result, &proc); end
 
-  # source://json//lib/json/common.rb#541
+  # source://json//lib/json/common.rb#714
   def restore(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
   # :stopdoc:
   # I want to deprecate these later, so I'll first be silent about them, and
   # later delete them.
   #
-  # source://json//lib/json/common.rb#300
+  # source://json//lib/json/common.rb#301
   def unparse(obj, opts = T.unsafe(nil)); end
 
+  # :call-seq:
+  #   JSON.unsafe_load(source, proc = nil, options = {}) -> object
+  #
+  # Returns the Ruby objects created by parsing the given +source+.
+  #
+  # BEWARE: This method is meant to serialise data from trusted user input,
+  # like from your own database server or clients under your control, it could
+  # be dangerous to allow untrusted users to pass JSON sources into it.
+  #
+  # - Argument +source+ must be, or be convertible to, a \String:
+  #   - If +source+ responds to instance method +to_str+,
+  #     <tt>source.to_str</tt> becomes the source.
+  #   - If +source+ responds to instance method +to_io+,
+  #     <tt>source.to_io.read</tt> becomes the source.
+  #   - If +source+ responds to instance method +read+,
+  #     <tt>source.read</tt> becomes the source.
+  #   - If both of the following are true, source becomes the \String <tt>'null'</tt>:
+  #     - Option +allow_blank+ specifies a truthy value.
+  #     - The source, as defined above, is +nil+ or the empty \String <tt>''</tt>.
+  #   - Otherwise, +source+ remains the source.
+  # - Argument +proc+, if given, must be a \Proc that accepts one argument.
+  #   It will be called recursively with each result (depth-first order).
+  #   See details below.
+  # - Argument +opts+, if given, contains a \Hash of options for the parsing.
+  #   See {Parsing Options}[#module-JSON-label-Parsing+Options].
+  #   The default options can be changed via method JSON.unsafe_load_default_options=.
+  #
+  # ---
+  #
+  # When no +proc+ is given, modifies +source+ as above and returns the result of
+  # <tt>parse(source, opts)</tt>;  see #parse.
+  #
+  # Source for following examples:
+  #   source = <<~JSON
+  #     {
+  #       "name": "Dave",
+  #       "age" :40,
+  #       "hats": [
+  #         "Cattleman's",
+  #         "Panama",
+  #         "Tophat"
+  #       ]
+  #     }
+  #   JSON
+  #
+  # Load a \String:
+  #   ruby = JSON.unsafe_load(source)
+  #   ruby # => {"name"=>"Dave", "age"=>40, "hats"=>["Cattleman's", "Panama", "Tophat"]}
+  #
+  # Load an \IO object:
+  #   require 'stringio'
+  #   object = JSON.unsafe_load(StringIO.new(source))
+  #   object # => {"name"=>"Dave", "age"=>40, "hats"=>["Cattleman's", "Panama", "Tophat"]}
+  #
+  # Load a \File object:
+  #   path = 't.json'
+  #   File.write(path, source)
+  #   File.open(path) do |file|
+  #     JSON.unsafe_load(file)
+  #   end # => {"name"=>"Dave", "age"=>40, "hats"=>["Cattleman's", "Panama", "Tophat"]}
+  #
+  # ---
+  #
+  # When +proc+ is given:
+  # - Modifies +source+ as above.
+  # - Gets the +result+ from calling <tt>parse(source, opts)</tt>.
+  # - Recursively calls <tt>proc(result)</tt>.
+  # - Returns the final result.
+  #
+  # Example:
+  #   require 'json'
+  #
+  #   # Some classes for the example.
+  #   class Base
+  #     def initialize(attributes)
+  #       @attributes = attributes
+  #     end
+  #   end
+  #   class User    < Base; end
+  #   class Account < Base; end
+  #   class Admin   < Base; end
+  #   # The JSON source.
+  #   json = <<-EOF
+  #   {
+  #     "users": [
+  #         {"type": "User", "username": "jane", "email": "jane@example.com"},
+  #         {"type": "User", "username": "john", "email": "john@example.com"}
+  #     ],
+  #     "accounts": [
+  #         {"account": {"type": "Account", "paid": true, "account_id": "1234"}},
+  #         {"account": {"type": "Account", "paid": false, "account_id": "1235"}}
+  #     ],
+  #     "admins": {"type": "Admin", "password": "0wn3d"}
+  #   }
+  #   EOF
+  #   # Deserializer method.
+  #   def deserialize_obj(obj, safe_types = %w(User Account Admin))
+  #     type = obj.is_a?(Hash) && obj["type"]
+  #     safe_types.include?(type) ? Object.const_get(type).new(obj) : obj
+  #   end
+  #   # Call to JSON.unsafe_load
+  #   ruby = JSON.unsafe_load(json, proc {|obj|
+  #     case obj
+  #     when Hash
+  #       obj.each {|k, v| obj[k] = deserialize_obj v }
+  #     when Array
+  #       obj.map! {|v| deserialize_obj v }
+  #     end
+  #   })
+  #   pp ruby
+  # Output:
+  #   {"users"=>
+  #      [#<User:0x00000000064c4c98
+  #        @attributes=
+  #          {"type"=>"User", "username"=>"jane", "email"=>"jane@example.com"}>,
+  #        #<User:0x00000000064c4bd0
+  #        @attributes=
+  #          {"type"=>"User", "username"=>"john", "email"=>"john@example.com"}>],
+  #    "accounts"=>
+  #      [{"account"=>
+  #          #<Account:0x00000000064c4928
+  #          @attributes={"type"=>"Account", "paid"=>true, "account_id"=>"1234"}>},
+  #       {"account"=>
+  #          #<Account:0x00000000064c4680
+  #          @attributes={"type"=>"Account", "paid"=>false, "account_id"=>"1235"}>}],
+  #    "admins"=>
+  #      #<Admin:0x00000000064c41f8
+  #      @attributes={"type"=>"Admin", "password"=>"0wn3d"}>}
+  #
+  # source://json//lib/json/common.rb#554
+  def unsafe_load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
+
   class << self
     # :call-seq:
     #   JSON[object] -> new_array or new_string
@@ -985,26 +1124,26 @@ module JSON
     #   ruby = [0, 1, nil]
     #   JSON[ruby] # => '[0,1,null]'
     #
-    # source://json//lib/json/common.rb#22
+    # source://json//lib/json/common.rb#23
     def [](object, opts = T.unsafe(nil)); end
 
-    # source://json//lib/json/common.rb#85
+    # source://json//lib/json/common.rb#80
     def create_fast_state; end
 
     # Returns the current create identifier.
     # See also JSON.create_id=.
     #
-    # source://json//lib/json/common.rb#130
+    # source://json//lib/json/common.rb#115
     def create_id; end
 
     # Sets create identifier, which is used to decide if the _json_create_
     # hook of a class should be called; initial value is +json_class+:
     #   JSON.create_id # => 'json_class'
     #
-    # source://json//lib/json/common.rb#124
+    # source://json//lib/json/common.rb#109
     def create_id=(new_value); end
 
-    # source://json//lib/json/common.rb#95
+    # source://json//lib/json/common.rb#90
     def create_pretty_state; end
 
     # Return the constant located at _path_. The format of _path_ has to be
@@ -1012,7 +1151,7 @@ module JSON
     # level (absolute namespace path?). If there doesn't exist a constant at
     # the given path, an ArgumentError is raised.
     #
-    # source://json//lib/json/common.rb#46
+    # source://json//lib/json/common.rb#50
     def deep_const_get(path); end
 
     # :call-seq:
@@ -1043,23 +1182,23 @@ module JSON
     # Output:
     #   {"foo":[0,1],"bar":{"baz":2,"bat":3},"bam":"bad"}
     #
-    # source://json//lib/json/common.rb#615
+    # source://json//lib/json/common.rb#795
     def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil), kwargs = T.unsafe(nil)); end
 
     # Sets or returns the default options for the JSON.dump method.
     # Initially:
     #   opts = JSON.dump_default_options
-    #   opts # => {:max_nesting=>false, :allow_nan=>true, :script_safe=>false}
+    #   opts # => {:max_nesting=>false, :allow_nan=>true}
     #
-    # source://json//lib/json/common.rb#580
+    # source://json//lib/json/common.rb#761
     def dump_default_options; end
 
     # Sets or returns the default options for the JSON.dump method.
     # Initially:
     #   opts = JSON.dump_default_options
-    #   opts # => {:max_nesting=>false, :allow_nan=>true, :script_safe=>false}
+    #   opts # => {:max_nesting=>false, :allow_nan=>true}
     #
-    # source://json//lib/json/common.rb#580
+    # source://json//lib/json/common.rb#761
     def dump_default_options=(_arg0); end
 
     # :call-seq:
@@ -1121,24 +1260,22 @@ module JSON
     #   # Raises JSON::NestingError (nesting of 100 is too deep):
     #   JSON.generate(a)
     #
-    # source://json//lib/json/common.rb#300
+    # source://json//lib/json/common.rb#301
     def generate(obj, opts = T.unsafe(nil)); end
 
-    # Returns the JSON generator module that is used by JSON. This is
-    # either JSON::Ext::Generator or JSON::Pure::Generator:
-    #   JSON.generator # => JSON::Ext::Generator
+    # Returns the JSON generator module that is used by JSON.
     #
-    # source://json//lib/json/common.rb#107
+    # source://json//lib/json/common.rb#100
     def generator; end
 
     # Set the module _generator_ to be used by JSON.
     #
-    # source://json//lib/json/common.rb#62
+    # source://json//lib/json/common.rb#57
     def generator=(generator); end
 
     # Encodes string using String.encode.
     #
-    # source://json//lib/json/common.rb#639
+    # source://json//lib/json/common.rb#832
     def iconv(to, from, string); end
 
     # :call-seq:
@@ -1146,6 +1283,16 @@ module JSON
     #
     # Returns the Ruby objects created by parsing the given +source+.
     #
+    # BEWARE: This method is meant to serialise data from trusted user input,
+    # like from your own database server or clients under your control, it could
+    # be dangerous to allow untrusted users to pass JSON sources into it.
+    # If you must use it, use JSON.unsafe_load instead to make it clear.
+    #
+    # Since JSON version 2.8.0, `load` emits a deprecation warning when a
+    # non native type is deserialized, without `create_additions` being explicitly
+    # enabled, and in JSON version 3.0, `load` will have `create_additions` disabled
+    # by default.
+    #
     # - Argument +source+ must be, or be convertible to, a \String:
     #   - If +source+ responds to instance method +to_str+,
     #     <tt>source.to_str</tt> becomes the source.
@@ -1160,9 +1307,6 @@ module JSON
     # - Argument +proc+, if given, must be a \Proc that accepts one argument.
     #   It will be called recursively with each result (depth-first order).
     #   See details below.
-    #   BEWARE: This method is meant to serialise data from trusted user input,
-    #   like from your own database server or clients under your control, it could
-    #   be dangerous to allow untrusted users to pass JSON sources into it.
     # - Argument +opts+, if given, contains a \Hash of options for the parsing.
     #   See {Parsing Options}[#module-JSON-label-Parsing+Options].
     #   The default options can be changed via method JSON.load_default_options=.
@@ -1173,17 +1317,17 @@ module JSON
     # <tt>parse(source, opts)</tt>;  see #parse.
     #
     # Source for following examples:
-    #   source = <<-EOT
-    #   {
-    #   "name": "Dave",
-    #     "age" :40,
-    #     "hats": [
-    #       "Cattleman's",
-    #       "Panama",
-    #       "Tophat"
-    #     ]
-    #   }
-    #   EOT
+    #   source = <<~JSON
+    #     {
+    #       "name": "Dave",
+    #       "age" :40,
+    #       "hats": [
+    #         "Cattleman's",
+    #         "Panama",
+    #         "Tophat"
+    #       ]
+    #     }
+    #   JSON
     #
     # Load a \String:
     #   ruby = JSON.load(source)
@@ -1269,7 +1413,7 @@ module JSON
     #      #<Admin:0x00000000064c41f8
     #      @attributes={"type"=>"Admin", "password"=>"0wn3d"}>}
     #
-    # source://json//lib/json/common.rb#541
+    # source://json//lib/json/common.rb#714
     def load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
     # Sets or returns default options for the JSON.load method.
@@ -1277,7 +1421,7 @@ module JSON
     #   opts = JSON.load_default_options
     #   opts # => {:max_nesting=>false, :allow_nan=>true, :allow_blank=>true, :create_additions=>true}
     #
-    # source://json//lib/json/common.rb#404
+    # source://json//lib/json/common.rb#418
     def load_default_options; end
 
     # Sets or returns default options for the JSON.load method.
@@ -1285,7 +1429,7 @@ module JSON
     #   opts = JSON.load_default_options
     #   opts # => {:max_nesting=>false, :allow_nan=>true, :allow_blank=>true, :create_additions=>true}
     #
-    # source://json//lib/json/common.rb#404
+    # source://json//lib/json/common.rb#418
     def load_default_options=(_arg0); end
 
     # :call-seq:
@@ -1296,7 +1440,7 @@ module JSON
     #
     # See method #parse.
     #
-    # source://json//lib/json/common.rb#249
+    # source://json//lib/json/common.rb#250
     def load_file(filespec, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1307,7 +1451,7 @@ module JSON
     #
     # See method #parse!
     #
-    # source://json//lib/json/common.rb#260
+    # source://json//lib/json/common.rb#261
     def load_file!(filespec, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1338,17 +1482,17 @@ module JSON
     # {Parsing \JSON}[#module-JSON-label-Parsing+JSON].
     #
     # Parses nested JSON objects:
-    #   source = <<-EOT
-    #   {
-    #   "name": "Dave",
-    #     "age" :40,
-    #     "hats": [
-    #       "Cattleman's",
-    #       "Panama",
-    #       "Tophat"
-    #     ]
-    #   }
-    #   EOT
+    #   source = <<~JSON
+    #     {
+    #     "name": "Dave",
+    #       "age" :40,
+    #       "hats": [
+    #         "Cattleman's",
+    #         "Panama",
+    #         "Tophat"
+    #       ]
+    #     }
+    #   JSON
     #   ruby = JSON.parse(source)
     #   ruby # => {"name"=>"Dave", "age"=>40, "hats"=>["Cattleman's", "Panama", "Tophat"]}
     #
@@ -1358,7 +1502,7 @@ module JSON
     #   # Raises JSON::ParserError (783: unexpected token at ''):
     #   JSON.parse('')
     #
-    # source://json//lib/json/common.rb#219
+    # source://json//lib/json/common.rb#220
     def parse(source, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1373,19 +1517,17 @@ module JSON
     #   which disables checking for nesting depth.
     # - Option +allow_nan+, if not provided, defaults to +true+.
     #
-    # source://json//lib/json/common.rb#234
+    # source://json//lib/json/common.rb#235
     def parse!(source, opts = T.unsafe(nil)); end
 
-    # Returns the JSON parser class that is used by JSON. This is either
-    # JSON::Ext::Parser or JSON::Pure::Parser:
-    #   JSON.parser # => JSON::Ext::Parser
+    # Returns the JSON parser class that is used by JSON.
     #
-    # source://json//lib/json/common.rb#33
+    # source://json//lib/json/common.rb#37
     def parser; end
 
     # Set the JSON parser class _parser_ to be used by JSON.
     #
-    # source://json//lib/json/common.rb#36
+    # source://json//lib/json/common.rb#40
     def parser=(parser); end
 
     # :call-seq:
@@ -1429,45 +1571,285 @@ module JSON
 
     # Recursively calls passed _Proc_ if the parsed data structure is an _Array_ or _Hash_
     #
-    # source://json//lib/json/common.rb#559
+    # source://json//lib/json/common.rb#740
     def recurse_proc(result, &proc); end
 
-    # source://json//lib/json/common.rb#541
+    # source://json//lib/json/common.rb#714
     def restore(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
-    # Sets or Returns the JSON generator state class that is used by JSON. This is
-    # either JSON::Ext::Generator::State or JSON::Pure::Generator::State:
-    #   JSON.state # => JSON::Ext::Generator::State
+    # Sets or Returns the JSON generator state class that is used by JSON.
     #
-    # source://json//lib/json/common.rb#112
+    # source://json//lib/json/common.rb#103
     def state; end
 
-    # Sets or Returns the JSON generator state class that is used by JSON. This is
-    # either JSON::Ext::Generator::State or JSON::Pure::Generator::State:
-    #   JSON.state # => JSON::Ext::Generator::State
+    # Sets or Returns the JSON generator state class that is used by JSON.
     #
-    # source://json//lib/json/common.rb#112
+    # source://json//lib/json/common.rb#103
     def state=(_arg0); end
 
     # :stopdoc:
     # I want to deprecate these later, so I'll first be silent about them, and
     # later delete them.
     #
-    # source://json//lib/json/common.rb#300
+    # source://json//lib/json/common.rb#301
     def unparse(obj, opts = T.unsafe(nil)); end
 
+    # :call-seq:
+    #   JSON.unsafe_load(source, proc = nil, options = {}) -> object
+    #
+    # Returns the Ruby objects created by parsing the given +source+.
+    #
+    # BEWARE: This method is meant to serialise data from trusted user input,
+    # like from your own database server or clients under your control, it could
+    # be dangerous to allow untrusted users to pass JSON sources into it.
+    #
+    # - Argument +source+ must be, or be convertible to, a \String:
+    #   - If +source+ responds to instance method +to_str+,
+    #     <tt>source.to_str</tt> becomes the source.
+    #   - If +source+ responds to instance method +to_io+,
+    #     <tt>source.to_io.read</tt> becomes the source.
+    #   - If +source+ responds to instance method +read+,
+    #     <tt>source.read</tt> becomes the source.
+    #   - If both of the following are true, source becomes the \String <tt>'null'</tt>:
+    #     - Option +allow_blank+ specifies a truthy value.
+    #     - The source, as defined above, is +nil+ or the empty \String <tt>''</tt>.
+    #   - Otherwise, +source+ remains the source.
+    # - Argument +proc+, if given, must be a \Proc that accepts one argument.
+    #   It will be called recursively with each result (depth-first order).
+    #   See details below.
+    # - Argument +opts+, if given, contains a \Hash of options for the parsing.
+    #   See {Parsing Options}[#module-JSON-label-Parsing+Options].
+    #   The default options can be changed via method JSON.unsafe_load_default_options=.
+    #
+    # ---
+    #
+    # When no +proc+ is given, modifies +source+ as above and returns the result of
+    # <tt>parse(source, opts)</tt>;  see #parse.
+    #
+    # Source for following examples:
+    #   source = <<~JSON
+    #     {
+    #       "name": "Dave",
+    #       "age" :40,
+    #       "hats": [
+    #         "Cattleman's",
+    #         "Panama",
+    #         "Tophat"
+    #       ]
+    #     }
+    #   JSON
+    #
+    # Load a \String:
+    #   ruby = JSON.unsafe_load(source)
+    #   ruby # => {"name"=>"Dave", "age"=>40, "hats"=>["Cattleman's", "Panama", "Tophat"]}
+    #
+    # Load an \IO object:
+    #   require 'stringio'
+    #   object = JSON.unsafe_load(StringIO.new(source))
+    #   object # => {"name"=>"Dave", "age"=>40, "hats"=>["Cattleman's", "Panama", "Tophat"]}
+    #
+    # Load a \File object:
+    #   path = 't.json'
+    #   File.write(path, source)
+    #   File.open(path) do |file|
+    #     JSON.unsafe_load(file)
+    #   end # => {"name"=>"Dave", "age"=>40, "hats"=>["Cattleman's", "Panama", "Tophat"]}
+    #
+    # ---
+    #
+    # When +proc+ is given:
+    # - Modifies +source+ as above.
+    # - Gets the +result+ from calling <tt>parse(source, opts)</tt>.
+    # - Recursively calls <tt>proc(result)</tt>.
+    # - Returns the final result.
+    #
+    # Example:
+    #   require 'json'
+    #
+    #   # Some classes for the example.
+    #   class Base
+    #     def initialize(attributes)
+    #       @attributes = attributes
+    #     end
+    #   end
+    #   class User    < Base; end
+    #   class Account < Base; end
+    #   class Admin   < Base; end
+    #   # The JSON source.
+    #   json = <<-EOF
+    #   {
+    #     "users": [
+    #         {"type": "User", "username": "jane", "email": "jane@example.com"},
+    #         {"type": "User", "username": "john", "email": "john@example.com"}
+    #     ],
+    #     "accounts": [
+    #         {"account": {"type": "Account", "paid": true, "account_id": "1234"}},
+    #         {"account": {"type": "Account", "paid": false, "account_id": "1235"}}
+    #     ],
+    #     "admins": {"type": "Admin", "password": "0wn3d"}
+    #   }
+    #   EOF
+    #   # Deserializer method.
+    #   def deserialize_obj(obj, safe_types = %w(User Account Admin))
+    #     type = obj.is_a?(Hash) && obj["type"]
+    #     safe_types.include?(type) ? Object.const_get(type).new(obj) : obj
+    #   end
+    #   # Call to JSON.unsafe_load
+    #   ruby = JSON.unsafe_load(json, proc {|obj|
+    #     case obj
+    #     when Hash
+    #       obj.each {|k, v| obj[k] = deserialize_obj v }
+    #     when Array
+    #       obj.map! {|v| deserialize_obj v }
+    #     end
+    #   })
+    #   pp ruby
+    # Output:
+    #   {"users"=>
+    #      [#<User:0x00000000064c4c98
+    #        @attributes=
+    #          {"type"=>"User", "username"=>"jane", "email"=>"jane@example.com"}>,
+    #        #<User:0x00000000064c4bd0
+    #        @attributes=
+    #          {"type"=>"User", "username"=>"john", "email"=>"john@example.com"}>],
+    #    "accounts"=>
+    #      [{"account"=>
+    #          #<Account:0x00000000064c4928
+    #          @attributes={"type"=>"Account", "paid"=>true, "account_id"=>"1234"}>},
+    #       {"account"=>
+    #          #<Account:0x00000000064c4680
+    #          @attributes={"type"=>"Account", "paid"=>false, "account_id"=>"1235"}>}],
+    #    "admins"=>
+    #      #<Admin:0x00000000064c41f8
+    #      @attributes={"type"=>"Admin", "password"=>"0wn3d"}>}
+    #
+    # source://json//lib/json/common.rb#554
+    def unsafe_load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
+
+    # Sets or returns default options for the JSON.unsafe_load method.
+    # Initially:
+    #   opts = JSON.load_default_options
+    #   opts # => {:max_nesting=>false, :allow_nan=>true, :allow_blank=>true, :create_additions=>true}
+    #
+    # source://json//lib/json/common.rb#404
+    def unsafe_load_default_options; end
+
+    # Sets or returns default options for the JSON.unsafe_load method.
+    # Initially:
+    #   opts = JSON.load_default_options
+    #   opts # => {:max_nesting=>false, :allow_nan=>true, :allow_blank=>true, :create_additions=>true}
+    #
+    # source://json//lib/json/common.rb#404
+    def unsafe_load_default_options=(_arg0); end
+
     private
 
-    # source://json//lib/json/common.rb#643
+    # source://json//lib/json/common.rb#836
     def merge_dump_options(opts, strict: T.unsafe(nil)); end
   end
 end
 
-# source://json//lib/json/common.rb#118
-JSON::CREATE_ID_TLS_KEY = T.let(T.unsafe(nil), String)
+# source://json//lib/json/ext/generator/state.rb#6
+class JSON::Ext::Generator::State
+  # call-seq: new(opts = {})
+  #
+  # Instantiates a new State object, configured by _opts_.
+  #
+  # _opts_ can have the following keys:
+  #
+  # * *indent*: a string used to indent levels (default: ''),
+  # * *space*: a string that is put after, a : or , delimiter (default: ''),
+  # * *space_before*: a string that is put before a : pair delimiter (default: ''),
+  # * *object_nl*: a string that is put at the end of a JSON object (default: ''),
+  # * *array_nl*: a string that is put at the end of a JSON array (default: ''),
+  # * *allow_nan*: true if NaN, Infinity, and -Infinity should be
+  #   generated, otherwise an exception is thrown, if these values are
+  #   encountered. This options defaults to false.
+  # * *ascii_only*: true if only ASCII characters should be generated. This
+  #   option defaults to false.
+  # * *buffer_initial_length*: sets the initial length of the generator's
+  #   internal buffer.
+  #
+  # @return [State] a new instance of State
+  #
+  # source://json//lib/json/ext/generator/state.rb#25
+  def initialize(opts = T.unsafe(nil)); end
+
+  # call-seq: [](name)
+  #
+  # Returns the value returned by method +name+.
+  #
+  # source://json//lib/json/ext/generator/state.rb#94
+  def [](name); end
+
+  # call-seq: []=(name, value)
+  #
+  # Sets the attribute name to value.
+  #
+  # source://json//lib/json/ext/generator/state.rb#106
+  def []=(name, value); end
+
+  # call-seq: configure(opts)
+  #
+  # Configure this State instance with the Hash _opts_, and return
+  # itself.
+  #
+  # source://json//lib/json/ext/generator/state.rb#35
+  def configure(opts); end
+
+  # call-seq:
+  #   generate(obj) -> String
+  #   generate(obj, anIO) -> anIO
+  #
+  # Generates a valid JSON document from object +obj+ and returns the
+  # result. If no valid JSON document can be created this method raises a
+  # GeneratorError exception.
+  #
+  # source://json//lib/json/ext/generator/state.rb#57
+  def generate(obj, io = T.unsafe(nil)); end
+
+  # call-seq: configure(opts)
+  #
+  # Configure this State instance with the Hash _opts_, and return
+  # itself.
+  #
+  # source://json//lib/json/ext/generator/state.rb#35
+  def merge(opts); end
+
+  # call-seq: to_h
+  #
+  # Returns the configuration instance variables as a hash, that can be
+  # passed to the configure method.
+  #
+  # source://json//lib/json/ext/generator/state.rb#65
+  def to_h; end
+
+  # call-seq: to_h
+  #
+  # Returns the configuration instance variables as a hash, that can be
+  # passed to the configure method.
+  #
+  # source://json//lib/json/ext/generator/state.rb#65
+  def to_hash; end
+end
+
+# This exception is raised if a generator or unparser error occurs.
+#
+# source://json//lib/json/common.rb#146
+class JSON::GeneratorError < ::JSON::JSONError
+  # @return [GeneratorError] a new instance of GeneratorError
+  #
+  # source://json//lib/json/common.rb#149
+  def initialize(message, invalid_object = T.unsafe(nil)); end
+
+  # source://json//lib/json/common.rb#154
+  def detailed_message(*_arg0, **_arg1, &_arg2); end
 
-# source://json//lib/json/common.rb#115
-JSON::DEFAULT_CREATE_ID = T.let(T.unsafe(nil), String)
+  # Returns the value of attribute invalid_object.
+  #
+  # source://json//lib/json/common.rb#147
+  def invalid_object; end
+end
 
 # source://json//lib/json/generic_object.rb#9
 class JSON::GenericObject < ::OpenStruct
@@ -1512,29 +1894,29 @@ end
 
 # The base exception for JSON errors.
 #
-# source://json//lib/json/common.rb#141
+# source://json//lib/json/common.rb#126
 class JSON::JSONError < ::StandardError
   class << self
-    # source://json//lib/json/common.rb#142
+    # source://json//lib/json/common.rb#127
     def wrap(exception); end
   end
 end
 
-# source://json//lib/json/common.rb#7
+# source://json//lib/json/common.rb#8
 JSON::NOT_SET = T.let(T.unsafe(nil), Object)
 
-# source://json//lib/json/common.rb#39
+# source://json//lib/json/common.rb#43
 JSON::Parser = JSON::Ext::Parser
 
-# source://json//lib/json/common.rb#77
+# source://json//lib/json/common.rb#72
 JSON::State = JSON::Ext::Generator::State
 
 # For backwards compatibility
 #
-# source://json//lib/json/common.rb#163
+# source://json//lib/json/common.rb#164
 JSON::UnparserError = JSON::GeneratorError
 
-# source://json//lib/json/common.rb#653
+# source://json//lib/json/common.rb#846
 module Kernel
   private
 
@@ -1545,18 +1927,18 @@ module Kernel
   # The _opts_ argument is passed through to generate/parse respectively. See
   # generate and parse for their documentation.
   #
-  # source://json//lib/json/common.rb#680
+  # source://json//lib/json/common.rb#873
   def JSON(object, *args); end
 
   # Outputs _objs_ to STDOUT as JSON strings in the shortest form, that is in
   # one line.
   #
-  # source://json//lib/json/common.rb#658
+  # source://json//lib/json/common.rb#851
   def j(*objs); end
 
   # Outputs _objs_ to STDOUT as JSON strings in a pretty format, with
   # indentation and over many lines.
   #
-  # source://json//lib/json/common.rb#667
+  # source://json//lib/json/common.rb#860
   def jj(*objs); end
 end