repeatable 1.2.0 → 1.2.1

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

@@ -4,19 +4,27 @@
 # This is an autogenerated file for types exported from the `json` gem.
 # Please instead update this file by running `bin/tapioca gem json`.
 
-# Extends any Class to include _json_creatable?_ method.
-#
-# source://json//lib/json/common.rb#690
-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
-  # method _json_create_ that expects a hash as first parameter. The hash
-  # should include the required data.
-  #
-  # @return [Boolean]
-  #
-  # source://json//lib/json/common.rb#695
-  def json_creatable?; end
+
+class Array
+  include ::Enumerable
+  include ::JSON::Ext::Generator::GeneratorMethods::Array
+end
+
+class FalseClass
+  include ::JSON::Ext::Generator::GeneratorMethods::FalseClass
+end
+
+class Float < ::Numeric
+  include ::JSON::Ext::Generator::GeneratorMethods::Float
+end
+
+class Hash
+  include ::Enumerable
+  include ::JSON::Ext::Generator::GeneratorMethods::Hash
+end
+
+class Integer < ::Numeric
+  include ::JSON::Ext::Generator::GeneratorMethods::Integer
 end
 
 # = JavaScript \Object Notation (\JSON)
@@ -144,6 +152,24 @@ end
 #
 # ---
 #
+# Option +allow_duplicate_key+ specifies whether duplicate keys in objects
+# should be ignored or cause an error to be raised:
+#
+# When not specified:
+#   # The last value is used and a deprecation warning emitted.
+#   JSON.parse('{"a": 1, "a":2}') => {"a" => 2}
+#   # waring: detected duplicate keys in JSON object.
+#   # This will raise an error in json 3.0 unless enabled via `allow_duplicate_key: true`
+#
+# When set to `+true+`
+#   # The last value is used.
+#   JSON.parse('{"a": 1, "a":2}') => {"a" => 2}
+#
+# When set to `+false+`, the future default:
+#   JSON.parse('{"a": 1, "a":2}') => duplicate key at line 1 column 1 (JSON::ParserError)
+#
+# ---
+#
 # Option +allow_nan+ (boolean) specifies whether to allow
 # NaN, Infinity, and MinusInfinity in +source+;
 # defaults to +false+.
@@ -160,8 +186,23 @@ end
 #   ruby = JSON.parse(source, {allow_nan: true})
 #   ruby # => [NaN, Infinity, -Infinity]
 #
+# ---
+#
+# Option +allow_trailing_comma+ (boolean) specifies whether to allow
+# trailing commas in objects and arrays;
+# defaults to +false+.
+#
+# With the default, +false+:
+#   JSON.parse('[1,]') # unexpected character: ']' at line 1 column 4 (JSON::ParserError)
+#
+# When enabled:
+#   JSON.parse('[1,]', allow_trailing_comma: true) # => [1]
+#
 # ====== Output Options
 #
+# Option +freeze+ (boolean) specifies whether the returned objects will be frozen;
+# defaults to +false+.
+#
 # Option +symbolize_names+ (boolean) specifies whether returned \Hash keys
 # should be Symbols;
 # defaults to +false+ (use Strings).
@@ -395,13 +436,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
 #
@@ -579,13 +620,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
 #
@@ -598,7 +639,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
 
@@ -630,7 +671,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#893
   def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil), kwargs = T.unsafe(nil)); end
 
   # :call-seq:
@@ -647,14 +688,11 @@ module JSON
   #   # Raises SystemStackError (stack level too deep):
   #   JSON.fast_generate(a)
   #
-  # source://json//lib/json/common.rb#329
+  # source://json//lib/json/common.rb#446
   def fast_generate(obj, opts = 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#329
-  def fast_unparse(obj, opts = T.unsafe(nil)); end
+  # source://json//lib/json/common.rb#938
+  def fast_unparse(*_arg0, **_arg1, &_arg2); end
 
   # :call-seq:
   #   JSON.generate(obj, opts = nil) -> new_string
@@ -692,7 +730,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#425
   def generate(obj, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -700,6 +738,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.
@@ -714,9 +762,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=.
@@ -727,17 +772,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)
@@ -823,7 +868,7 @@ module JSON
   #      #<Admin:0x00000000064c41f8
   #      @attributes={"type"=>"Admin", "password"=>"0wn3d"}>}
   #
-  # source://json//lib/json/common.rb#541
+  # source://json//lib/json/common.rb#827
   def load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
   # :call-seq:
@@ -834,7 +879,7 @@ module JSON
   #
   # See method #parse.
   #
-  # source://json//lib/json/common.rb#249
+  # source://json//lib/json/common.rb#374
   def load_file(filespec, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -845,12 +890,9 @@ module JSON
   #
   # See method #parse!
   #
-  # source://json//lib/json/common.rb#260
+  # source://json//lib/json/common.rb#385
   def load_file!(filespec, opts = T.unsafe(nil)); end
 
-  # source://json//lib/json/common.rb#643
-  def merge_dump_options(opts, strict: T.unsafe(nil)); end
-
   # :call-seq:
   #   JSON.parse(source, opts) -> object
   #
@@ -879,17 +921,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"]}
   #
@@ -899,7 +941,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#337
   def parse(source, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -914,7 +956,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#359
   def parse!(source, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -947,29 +989,153 @@ module JSON
   #     }
   #   }
   #
-  # source://json//lib/json/common.rb#374
+  # source://json//lib/json/common.rb#493
   def pretty_generate(obj, opts = T.unsafe(nil)); end
 
+  # source://json//lib/json/common.rb#948
+  def pretty_unparse(*_arg0, **_arg1, &_arg2); end
+
+  # source://json//lib/json/common.rb#958
+  def restore(*_arg0, **_arg1, &_arg2); end
+
   # :stopdoc:
-  # I want to deprecate these later, so I'll first be silent about them, and later delete them.
+  # All these were meant to be deprecated circa 2009, but were just set as undocumented
+  # so usage still exist in the wild.
   #
-  # source://json//lib/json/common.rb#374
-  def pretty_unparse(obj, opts = T.unsafe(nil)); end
+  # source://json//lib/json/common.rb#928
+  def unparse(*_arg0, **_arg1, &_arg2); end
 
-  # Recursively calls passed _Proc_ if the parsed data structure is an _Array_ or _Hash_
+  # :call-seq:
+  #   JSON.unsafe_load(source, proc = nil, options = {}) -> object
   #
-  # source://json//lib/json/common.rb#559
-  def recurse_proc(result, &proc); end
-
-  # source://json//lib/json/common.rb#541
-  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.
+  # Returns the Ruby objects created by parsing the given +source+.
   #
-  # source://json//lib/json/common.rb#300
-  def unparse(obj, opts = T.unsafe(nil)); end
+  # 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#667
+  def unsafe_load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
   class << self
     # :call-seq:
@@ -984,36 +1150,33 @@ module JSON
     #   ruby = [0, 1, nil]
     #   JSON[ruby] # => '[0,1,null]'
     #
-    # source://json//lib/json/common.rb#22
+    # source://json//lib/json/common.rb#127
     def [](object, opts = T.unsafe(nil)); end
 
-    # source://json//lib/json/common.rb#85
-    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#220
     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#214
     def create_id=(new_value); end
 
-    # source://json//lib/json/common.rb#95
-    def create_pretty_state; end
-
     # Return the constant located at _path_. The format of _path_ has to be
     # either ::A::B::C or A::B::C. In any case, A has to be located at the top
     # 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#154
     def deep_const_get(path); end
 
+    # source://json//lib/json/common.rb#99
+    def deprecation_warning(message, uplevel = T.unsafe(nil)); end
+
     # :call-seq:
     #   JSON.dump(obj, io = nil, limit = nil)
     #
@@ -1042,25 +1205,9 @@ 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#893
     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}
-    #
-    # source://json//lib/json/common.rb#580
-    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}
-    #
-    # source://json//lib/json/common.rb#580
-    def dump_default_options=(_arg0); end
-
     # :call-seq:
     #   JSON.fast_generate(obj, opts) -> new_string
     #
@@ -1075,14 +1222,11 @@ module JSON
     #   # Raises SystemStackError (stack level too deep):
     #   JSON.fast_generate(a)
     #
-    # source://json//lib/json/common.rb#329
+    # source://json//lib/json/common.rb#446
     def fast_generate(obj, opts = 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#329
-    def fast_unparse(obj, opts = T.unsafe(nil)); end
+    # source://json//lib/json/common.rb#938
+    def fast_unparse(*_arg0, **_arg1, &_arg2); end
 
     # :call-seq:
     #   JSON.generate(obj, opts = nil) -> new_string
@@ -1120,31 +1264,34 @@ 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#425
     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#182
     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#161
     def generator=(generator); end
 
-    # Encodes string using String.encode.
-    #
-    # source://json//lib/json/common.rb#639
-    def iconv(to, from, string); end
-
     # :call-seq:
     #   JSON.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.
+    # 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.
@@ -1159,9 +1306,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=.
@@ -1172,17 +1316,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)
@@ -1268,25 +1412,9 @@ module JSON
     #      #<Admin:0x00000000064c41f8
     #      @attributes={"type"=>"Admin", "password"=>"0wn3d"}>}
     #
-    # source://json//lib/json/common.rb#541
+    # source://json//lib/json/common.rb#827
     def load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
-    # Sets or returns default options for the JSON.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 load_default_options; end
-
-    # Sets or returns default options for the JSON.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 load_default_options=(_arg0); end
-
     # :call-seq:
     #   JSON.load_file(path, opts={}) -> object
     #
@@ -1295,7 +1423,7 @@ module JSON
     #
     # See method #parse.
     #
-    # source://json//lib/json/common.rb#249
+    # source://json//lib/json/common.rb#374
     def load_file(filespec, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1306,7 +1434,7 @@ module JSON
     #
     # See method #parse!
     #
-    # source://json//lib/json/common.rb#260
+    # source://json//lib/json/common.rb#385
     def load_file!(filespec, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1337,17 +1465,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"]}
     #
@@ -1357,7 +1485,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#337
     def parse(source, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1372,19 +1500,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#359
     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#141
     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#144
     def parser=(parser); end
 
     # :call-seq:
@@ -1417,56 +1543,409 @@ module JSON
     #     }
     #   }
     #
-    # source://json//lib/json/common.rb#374
+    # source://json//lib/json/common.rb#493
     def pretty_generate(obj, opts = 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#374
-    def pretty_unparse(obj, opts = T.unsafe(nil)); end
+    # source://json//lib/json/common.rb#948
+    def pretty_unparse(*_arg0, **_arg1, &_arg2); end
 
-    # Recursively calls passed _Proc_ if the parsed data structure is an _Array_ or _Hash_
-    #
-    # source://json//lib/json/common.rb#559
-    def recurse_proc(result, &proc); end
+    # source://json//lib/json/common.rb#958
+    def restore(*_arg0, **_arg1, &_arg2); end
 
-    # source://json//lib/json/common.rb#541
-    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#185
     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#185
     def state=(_arg0); end
 
     # :stopdoc:
-    # I want to deprecate these later, so I'll first be silent about them, and
-    # later delete them.
+    # All these were meant to be deprecated circa 2009, but were just set as undocumented
+    # so usage still exist in the wild.
+    #
+    # source://json//lib/json/common.rb#928
+    def unparse(*_arg0, **_arg1, &_arg2); 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"]}
+    #
+    # ---
     #
-    # source://json//lib/json/common.rb#300
-    def unparse(obj, opts = T.unsafe(nil)); end
+    # 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#667
+    def unsafe_load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
     private
 
-    # source://json//lib/json/common.rb#643
-    def merge_dump_options(opts, strict: T.unsafe(nil)); end
+    # source://json//lib/json/common.rb#971
+    def const_missing(const_name); end
+
+    # source://json//lib/json/common.rb#189
+    def deprecated_singleton_attr_accessor(*attrs); end
   end
 end
 
-# source://json//lib/json/common.rb#118
-JSON::CREATE_ID_TLS_KEY = T.let(T.unsafe(nil), String)
+# JSON::Coder holds a parser and generator configuration.
+#
+#   module MyApp
+#     JSONC_CODER = JSON::Coder.new(
+#       allow_trailing_comma: true
+#     )
+#   end
+#
+#   MyApp::JSONC_CODER.load(document)
+#
+# source://json//lib/json/common.rb#997
+class JSON::Coder
+  # :call-seq:
+  #   JSON.new(options = nil, &block)
+  #
+  # Argument +options+, if given, contains a \Hash of options for both parsing and generating.
+  # See {Parsing Options}[#module-JSON-label-Parsing+Options], and {Generating Options}[#module-JSON-label-Generating+Options].
+  #
+  # For generation, the <tt>strict: true</tt> option is always set. When a Ruby object with no native \JSON counterpart is
+  # encoutered, the block provided to the initialize method is invoked, and must return a Ruby object that has a native
+  # \JSON counterpart:
+  #
+  #  module MyApp
+  #    API_JSON_CODER = JSON::Coder.new do |object|
+  #      case object
+  #      when Time
+  #        object.iso8601(3)
+  #      else
+  #        object # Unknown type, will raise
+  #      end
+  #    end
+  #  end
+  #
+  #  puts MyApp::API_JSON_CODER.dump(Time.now.utc) # => "2025-01-21T08:41:44.286Z"
+  #
+  # @return [Coder] a new instance of Coder
+  #
+  # source://json//lib/json/common.rb#1021
+  def initialize(options = T.unsafe(nil), &as_json); end
+
+  # call-seq:
+  #   dump(object) -> String
+  #   dump(object, io) -> io
+  #
+  # Serialize the given object into a \JSON document.
+  #
+  # source://json//lib/json/common.rb#1039
+  def dump(object, io = T.unsafe(nil)); end
+
+  # call-seq:
+  #   dump(object) -> String
+  #   dump(object, io) -> io
+  #
+  # Serialize the given object into a \JSON document.
+  #
+  # source://json//lib/json/common.rb#1039
+  def generate(object, io = T.unsafe(nil)); end
+
+  # call-seq:
+  #   load(string) -> Object
+  #
+  # Parse the given \JSON document and return an equivalent Ruby object.
+  #
+  # source://json//lib/json/common.rb#1048
+  def load(source); end
+
+  # call-seq:
+  #   load(path) -> Object
+  #
+  # Parse the given \JSON document and return an equivalent Ruby object.
+  #
+  # source://json//lib/json/common.rb#1057
+  def load_file(path); end
+
+  # call-seq:
+  #   load(string) -> Object
+  #
+  # Parse the given \JSON document and return an equivalent Ruby object.
+  #
+  # source://json//lib/json/common.rb#1048
+  def parse(source); end
+end
+
+module JSON::Ext::Generator::GeneratorMethods::String
+  mixes_in_class_methods ::JSON::Ext::Generator::GeneratorMethods::String::Extend
+end
+
+# 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#84
+  def [](name); end
+
+  # call-seq: []=(name, value)
+  #
+  # Sets the attribute name to value.
+  #
+  # source://json//lib/json/ext/generator/state.rb#96
+  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: 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#54
+  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#54
+  def to_hash; end
+end
+
+# source://json//lib/json/ext.rb#9
+class JSON::Ext::Parser
+  # @return [Parser] a new instance of Parser
+  #
+  # source://json//lib/json/ext.rb#17
+  def initialize(source, opts = T.unsafe(nil)); end
+
+  # source://json//lib/json/ext.rb#26
+  def parse; end
+
+  # source://json//lib/json/ext.rb#22
+  def source; end
+end
 
-# source://json//lib/json/common.rb#115
-JSON::DEFAULT_CREATE_ID = T.let(T.unsafe(nil), String)
+# source://json//lib/json/ext.rb#32
+JSON::Ext::Parser::Config = JSON::Ext::ParserConfig
+
+# Fragment of JSON document that is to be included as is:
+#   fragment = JSON::Fragment.new("[1, 2, 3]")
+#   JSON.generate({ count: 3, items: fragments })
+#
+# This allows to easily assemble multiple JSON fragments that have
+# been persisted somewhere without having to parse them nor resorting
+# to string interpolation.
+#
+# Note: no validation is performed on the provided string. It is the
+# responsibility of the caller to ensure the string contains valid JSON.
+#
+# source://json//lib/json/common.rb#273
+class JSON::Fragment < ::Struct
+  # @return [Fragment] a new instance of Fragment
+  #
+  # source://json//lib/json/common.rb#274
+  def initialize(json); end
+
+  # Returns the value of attribute json
+  #
+  # @return [Object] the current value of json
+  def json; end
+
+  # Sets the attribute json
+  #
+  # @param value [Object] the value to set the attribute json to.
+  # @return [Object] the newly set value
+  def json=(_); end
+
+  # source://json//lib/json/common.rb#282
+  def to_json(state = T.unsafe(nil), *_arg1); end
+
+  class << self
+    def [](*_arg0); end
+    def inspect; end
+    def keyword_init?; end
+    def members; end
+    def new(*_arg0); end
+  end
+end
+
+# This exception is raised if a generator or unparser error occurs.
+#
+# source://json//lib/json/common.rb#243
+class JSON::GeneratorError < ::JSON::JSONError
+  # @return [GeneratorError] a new instance of GeneratorError
+  #
+  # source://json//lib/json/common.rb#246
+  def initialize(message, invalid_object = T.unsafe(nil)); end
+
+  # source://json//lib/json/common.rb#251
+  def detailed_message(*_arg0, **_arg1, &_arg2); end
+
+  # Returns the value of attribute invalid_object.
+  #
+  # source://json//lib/json/common.rb#244
+  def invalid_object; end
+end
 
 # source://json//lib/json/generic_object.rb#9
 class JSON::GenericObject < ::OpenStruct
@@ -1509,31 +1988,58 @@ class JSON::GenericObject < ::OpenStruct
   end
 end
 
-# The base exception for JSON errors.
+# source://json//lib/json/common.rb#342
+JSON::PARSE_L_OPTIONS = T.let(T.unsafe(nil), Hash)
+
+# source://json//lib/json/common.rb#455
+JSON::PRETTY_GENERATE_OPTIONS = T.let(T.unsafe(nil), Hash)
+
+# source://json//lib/json/common.rb#147
+JSON::Parser = JSON::Ext::Parser
+
+# This exception is raised if a parser error occurs.
 #
-# source://json//lib/json/common.rb#141
-class JSON::JSONError < ::StandardError
-  class << self
-    # source://json//lib/json/common.rb#142
-    def wrap(exception); end
-  end
+# source://json//lib/json/common.rb#234
+class JSON::ParserError < ::JSON::JSONError
+  # Returns the value of attribute column.
+  #
+  # source://json//lib/json/common.rb#235
+  def column; end
+
+  # Returns the value of attribute line.
+  #
+  # source://json//lib/json/common.rb#235
+  def line; end
 end
 
-# source://json//lib/json/common.rb#7
-JSON::NOT_SET = T.let(T.unsafe(nil), Object)
+# source://json//lib/json/common.rb#8
+module JSON::ParserOptions
+  class << self
+    # source://json//lib/json/common.rb#10
+    def prepare(opts); end
 
-# source://json//lib/json/common.rb#39
-JSON::Parser = JSON::Ext::Parser
+    private
 
-# source://json//lib/json/common.rb#77
-JSON::State = JSON::Ext::Generator::State
+    # source://json//lib/json/common.rb#40
+    def array_class_proc(array_class, on_load); end
 
-# For backwards compatibility
-#
-# source://json//lib/json/common.rb#163
-JSON::UnparserError = JSON::GeneratorError
+    # TODO: extract :create_additions support to another gem for version 3.0
+    #
+    # source://json//lib/json/common.rb#52
+    def create_additions_proc(opts); end
 
-# source://json//lib/json/common.rb#653
+    # source://json//lib/json/common.rb#90
+    def create_additions_warning; end
+
+    # source://json//lib/json/common.rb#29
+    def object_class_proc(object_class, on_load); end
+  end
+end
+
+# source://json//lib/json/common.rb#176
+JSON::State = JSON::Ext::Generator::State
+
+# source://json//lib/json/common.rb#1063
 module Kernel
   private
 
@@ -1544,18 +2050,38 @@ 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
-  def JSON(object, *args); end
+  # source://json//lib/json/common.rb#1102
+  def JSON(object, opts = T.unsafe(nil)); 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#1068
   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#1083
   def jj(*objs); end
 end
+
+class NilClass
+  include ::JSON::Ext::Generator::GeneratorMethods::NilClass
+end
+
+class Object < ::BasicObject
+  include ::Kernel
+  include ::PP::ObjectMixin
+  include ::JSON::Ext::Generator::GeneratorMethods::Object
+end
+
+class String
+  include ::Comparable
+  include ::JSON::Ext::Generator::GeneratorMethods::String
+  extend ::JSON::Ext::Generator::GeneratorMethods::String::Extend
+end
+
+class TrueClass
+  include ::JSON::Ext::Generator::GeneratorMethods::TrueClass
+end