rbs 4.0.0.dev.4 → 4.0.0.dev.5

data/stdlib/fileutils/0/fileutils.rbs

@@ -184,7 +184,8 @@ module FileUtils
 
   type mode = Integer | String
 
-  type path = string | _ToPath
+  %a{deprecated: Use top-level `path` instead}
+  type path = ::path
 
   type pathlist = path | Array[path]
 
@@ -522,11 +523,13 @@ module FileUtils
   # symbolic links; other file types (FIFO streams, device files, etc.) are not
   # supported.
   #
-  # Keyword arguments:
+  # Optional arguments:
   #
-  # *   `dereference_root: true` - if `src` is a symbolic link, follows the link.
-  # *   `preserve: true` - preserves file times.
-  # *   `remove_destination: true` - removes `dest` before copying files.
+  # *   `dereference_root` - if `src` is a symbolic link, follows the link
+  #     (`false` by default).
+  # *   `preserve` - preserves file times (`false` by default).
+  # *   `remove_destination` - removes `dest` before copying files (`false` by
+  #     default).
   #
   # Related: [methods for copying](rdoc-ref:FileUtils@Copying).
   #
@@ -547,12 +550,13 @@ module FileUtils
   #     FileUtils.copy_file('src0.txt', 'dest0.txt')
   #     File.file?('dest0.txt') # => true
   #
-  # Keyword arguments:
+  # Optional arguments:
   #
-  # *   `dereference: false` - if `src` is a symbolic link, does not follow the
-  #     link.
-  # *   `preserve: true` - preserves file times.
-  # *   `remove_destination: true` - removes `dest` before copying files.
+  # *   `dereference` - if `src` is a symbolic link, follows the link (`true` by
+  #     default).
+  # *   `preserve` - preserves file times (`false` by default).
+  # *   `remove_destination` - removes `dest` before copying files (`false` by
+  #     default).
   #
   # Related: [methods for copying](rdoc-ref:FileUtils@Copying).
   #
@@ -963,13 +967,15 @@ module FileUtils
   #     File.file?('dest1/dir1/t2.txt') # => true
   #     File.file?('dest1/dir1/t3.txt') # => true
   #
-  # Keyword arguments:
+  # Optional arguments:
   #
-  # *   `dereference_root: true` - dereferences `src` if it is a symbolic link.
-  # *   `remove_destination: true` - removes `dest` before creating links.
+  # *   `dereference_root` - dereferences `src` if it is a symbolic link (`false`
+  #     by default).
+  # *   `remove_destination` - removes `dest` before creating links (`false` by
+  #     default).
   #
   # Raises an exception if `dest` is the path to an existing file or directory and
-  # keyword argument `remove_destination: true` is not given.
+  # optional argument `remove_destination` is not given.
   #
   # Related: FileUtils.ln (has different options).
   #

data/stdlib/forwardable/0/forwardable.rbs

@@ -100,6 +100,9 @@ module Forwardable
   #
   VERSION: String
 
+  # <!-- rdoc-file=lib/forwardable.rb -->
+  # Version for backward compatibility
+  #
   FORWARDABLE_VERSION: String
 
   # <!--

data/stdlib/json/0/json.rbs

@@ -1,5 +1,5 @@
 interface _ToJson
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 # <!-- rdoc-file=ext/json/lib/json/common.rb -->
@@ -199,6 +199,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}
+#     # warning: 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`.
 #
@@ -215,8 +233,22 @@ 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).
 #
@@ -345,6 +377,25 @@ end
 #
 # ---
 #
+# Option `allow_duplicate_key` (boolean) specifies whether hashes with duplicate
+# keys should be allowed or produce an error. defaults to emit a deprecation
+# warning.
+#
+# With the default, (not set):
+#     Warning[:deprecated] = true
+#     JSON.generate({ foo: 1, "foo" => 2 })
+#     # warning: detected duplicate key "foo" in {foo: 1, "foo" => 2}.
+#     # This will raise an error in json 3.0 unless enabled via `allow_duplicate_key: true`
+#     # => '{"foo":1,"foo":2}'
+#
+# With `false`
+#     JSON.generate({ foo: 1, "foo" => 2 }, allow_duplicate_key: false)
+#     # detected duplicate key "foo" in {foo: 1, "foo" => 2} (JSON::GeneratorError)
+#
+# In version 3.0, `false` will become the default.
+#
+# ---
+#
 # Option `max_nesting` (Integer) specifies the maximum nesting depth in `obj`;
 # defaults to `100`.
 #
@@ -420,6 +471,9 @@ end
 #
 # ## JSON Additions
 #
+# Note that JSON Additions must only be used with trusted data, and is
+# deprecated.
+#
 # When you "round trip" a non-String object from Ruby to JSON and back, you have
 # a new String, instead of the object you began with:
 #     ruby0 = Range.new(0, 2)
@@ -708,8 +762,6 @@ module JSON
   #
   def self.create_id=: (_ToS create_id) -> _ToS
 
-  def self.deep_const_get: (interned path) -> untyped
-
   # <!--
   #   rdoc-file=ext/json/lib/json/common.rb
   #   - JSON.dump(obj, io = nil, limit = nil)
@@ -786,7 +838,7 @@ module JSON
   # -->
   # Returns a String containing the generated JSON data.
   #
-  # See also JSON.fast_generate, JSON.pretty_generate.
+  # See also JSON.pretty_generate.
   #
   # Argument `obj` is the Ruby object to be converted to JSON.
   #
@@ -828,6 +880,7 @@ module JSON
 
   # <!--
   #   rdoc-file=ext/json/lib/json/common.rb
+  #   - JSON.load(source, options = {}) -> object
   #   - JSON.load(source, proc = nil, options = {}) -> object
   # -->
   # Returns the Ruby objects created by parsing the given `source`.
@@ -940,6 +993,7 @@ module JSON
   #       when Array
   #         obj.map! {|v| deserialize_obj v }
   #       end
+  #       obj
   #     })
   #     pp ruby
   #
@@ -1172,7 +1226,7 @@ module Kernel
 
   # <!--
   #   rdoc-file=ext/json/lib/json/common.rb
-  #   - JSON(object, *args)
+  #   - JSON(object, opts = nil)
   # -->
   # If *object* is string-like, parse the string and return the parsed result as a
   # Ruby data structure. Otherwise, generate a JSON text from the Ruby data
@@ -1191,28 +1245,28 @@ class Object
   # it to a JSON string, and returns the result. This is a fallback, if no
   # special method #to_json was defined for some object.
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
 class NilClass
   # Returns a JSON string for nil: 'null'.
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
 class TrueClass
   # Returns a JSON string for true: 'true'.
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
 class FalseClass
   # Returns a JSON string for false: 'false'.
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1221,21 +1275,21 @@ class String
   # returns a JSON string encoded with UTF16 big endian characters as
   # \u????.
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
 class Integer
   # Returns a JSON string representation for this Integer number.
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
 class Float
   # Returns a JSON string representation for this Float number.
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1245,7 +1299,7 @@ class Hash[unchecked out K, unchecked out V]
   # _state_ is a JSON::State object, that can also be used to configure the
   # produced JSON string output further.
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1255,7 +1309,7 @@ class Array[unchecked out Elem]
   # _state_ is a JSON::State object, that can also be used to configure the
   # produced JSON string output further.
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1309,7 +1363,7 @@ class BigDecimal
   #     {"json_class":"BigDecimal","b":"36:0.2e1"}
   #     {"json_class":"BigDecimal","b":"27:0.2e1"}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1358,7 +1412,7 @@ class Complex
   #     {"json_class":"Complex","r":2,"i":0}
   #     {"json_class":"Complex","r":2.0,"i":4}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1405,7 +1459,7 @@ class Date
   #
   #     {"json_class":"Date","y":2023,"m":11,"d":21,"sg":2299161.0}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1451,7 +1505,7 @@ class DateTime
   #
   #     {"json_class":"DateTime","y":2023,"m":11,"d":21,"sg":2299161.0}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1496,7 +1550,7 @@ class Exception
   #
   #     {"json_class":"Exception","m":"Foo","b":null}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1544,7 +1598,7 @@ class OpenStruct
   #
   #     {"json_class":"OpenStruct","t":{'name':'Rowdy',"age":null}}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1597,7 +1651,7 @@ class Range[out Elem]
   #     {"json_class":"Range","a":[1,4,true]}
   #     {"json_class":"Range","a":["a","d",false]}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1644,7 +1698,7 @@ class Rational
   #
   #     {"json_class":"Rational","n":2,"d":3}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1690,7 +1744,7 @@ class Regexp
   #
   #     {"json_class":"Regexp","o":0,"s":"foo"}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1736,7 +1790,7 @@ class Set[unchecked out A]
   #
   #     {"json_class":"Set","a":["foo","bar","baz"]}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1785,7 +1839,7 @@ class Struct[Elem]
   #
   #     {"json_class":"Struct","t":{'name':'Rowdy',"age":null}}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1820,7 +1874,7 @@ class Symbol
 
   # <!--
   #   rdoc-file=ext/json/lib/json/add/symbol.rb
-  #   - to_json(*a)
+  #   - to_json(state = nil, *a)
   # -->
   # Returns a JSON string representing `self`:
   #
@@ -1831,7 +1885,7 @@ class Symbol
   #
   #     # {"json_class":"Symbol","s":"foo"}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end
 
 %a{annotate:rdoc:skip}
@@ -1878,5 +1932,5 @@ class Time
   #
   #     {"json_class":"Time","s":1700931678,"n":980650786}
   #
-  def to_json: (?JSON::State state) -> String
+  def to_json: (?JSON::State? state) -> String
 end

data/stdlib/net-http/0/net-http.rbs

@@ -4047,6 +4047,9 @@ module Net
     alias entity body
   end
 
+  # <!-- rdoc-file=lib/net/http/responses.rb -->
+  # Unknown HTTP response
+  #
   class HTTPUnknownResponse < HTTPResponse
     HAS_BODY: bool
 

data/stdlib/objspace/0/objspace.rbs

@@ -126,29 +126,6 @@ module ObjectSpace
   #
   def self?.count_imemo_objects: (?Hash[Symbol, Integer] result_hash) -> Hash[Symbol, Integer]
 
-  # <!--
-  #   rdoc-file=ext/objspace/objspace.c
-  #   - ObjectSpace.count_nodes([result_hash]) -> hash
-  # -->
-  # Counts nodes for each node type.
-  #
-  # This method is only for MRI developers interested in performance and memory
-  # usage of Ruby programs.
-  #
-  # It returns a hash as:
-  #
-  #     {:NODE_METHOD=>2027, :NODE_FBODY=>1927, :NODE_CFUNC=>1798, ...}
-  #
-  # If the optional argument, result_hash, is given, it is overwritten and
-  # returned. This is intended to avoid probe effect.
-  #
-  # Note: The contents of the returned hash is implementation defined. It may be
-  # changed in future.
-  #
-  # This method is only expected to work with C Ruby.
-  #
-  def self?.count_nodes: (?Hash[Symbol, Integer] result_hash) -> Hash[Symbol, Integer]
-
   # <!--
   #   rdoc-file=ext/objspace/objspace.c
   #   - ObjectSpace.count_objects_size([result_hash]) -> hash
@@ -332,9 +309,11 @@ module ObjectSpace
   # information as only a **HINT**. Especially, the size of `T_DATA` may not be
   # correct.
   #
-  # This method is only expected to work with C Ruby.
+  # This method is only expected to work with CRuby.
   #
-  # From Ruby 2.2, memsize_of(obj) returns a memory size includes sizeof(RVALUE).
+  # From Ruby 3.2 with Variable Width Allocation, it returns the actual slot size
+  # used plus any additional memory allocated outside the slot (such as external
+  # strings, arrays, or hash tables).
   #
   def self?.memsize_of: (untyped) -> Integer
 
@@ -409,7 +388,7 @@ module ObjectSpace
   #     ObjectSpace.reachable_objects_from(1)
   #     #=> nil # 1 is not markable (heap managed) object
   #
-  def self?.reachable_objects_from: (untyped) -> ([ untyped ] | nil)
+  def self?.reachable_objects_from: (untyped) -> (Array[untyped] | nil)
 
   # <!--
   #   rdoc-file=ext/objspace/objspace.c
@@ -461,8 +440,11 @@ module ObjectSpace
 
   # <!--
   #   rdoc-file=ext/objspace/object_tracing.c
-  #   - trace_object_allocations_debug_start()
+  #   - trace_object_allocations_debug_start
   # -->
+  # Starts tracing object allocations for GC debugging. If you encounter the BUG
+  # "... is T_NONE" (and so on) on your application, please try this method at the
+  # beginning of your app.
   #
   def self?.trace_object_allocations_debug_start: () -> void
 

data/stdlib/open-uri/0/open-uri.rbs

@@ -83,6 +83,46 @@ end
 # :   Tanaka Akira <akr@m17n.org>
 #
 module OpenURI
+  # <!-- rdoc-file=lib/open-uri.rb -->
+  # Raised on HTTP session failure
+  #
+  class HTTPError < StandardError
+    # <!--
+    #   rdoc-file=lib/open-uri.rb
+    #   - new(message, io)
+    # -->
+    #
+    def initialize: (String message, (StringIO & OpenURI::Meta) io) -> void
+
+    # <!-- rdoc-file=lib/open-uri.rb -->
+    # StringIO having the received data
+    #
+    attr_reader io: StringIO & OpenURI::Meta
+  end
+
+  # <!-- rdoc-file=lib/open-uri.rb -->
+  # Raised on redirection, only occurs when `redirect` option for HTTP is `false`.
+  #
+  class HTTPRedirect < HTTPError
+    # <!--
+    #   rdoc-file=lib/open-uri.rb
+    #   - new(message, io, uri)
+    # -->
+    #
+    def initialize: (String message, (StringIO & OpenURI::Meta) io, URI uri) -> void
+
+    # <!-- rdoc-file=lib/open-uri.rb -->
+    # URI to redirect
+    #
+    attr_reader uri: URI
+  end
+
+  # <!-- rdoc-file=lib/open-uri.rb -->
+  # Raised on too many redirection,
+  #
+  class TooManyRedirects < HTTPError
+  end
+
   # <!-- rdoc-file=lib/open-uri.rb -->
   # Mixin for holding meta-information.
   #