RubyGems - rbs - Versions diffs - 3.2.2 → 3.3.0.pre.1 - Mend

rbs 3.2.2 → 3.3.0.pre.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (125) hide show

checksums.yaml +4 -4
data/.github/workflows/comments.yml +1 -1
data/.github/workflows/ruby.yml +7 -2
data/CHANGELOG.md +85 -0
data/Gemfile.lock +14 -14
data/README.md +11 -2
data/Rakefile +10 -7
data/Steepfile +7 -7
data/core/basic_object.rbs +7 -7
data/core/binding.rbs +3 -3
data/core/builtin.rbs +171 -5
data/core/constants.rbs +17 -17
data/core/dir.rbs +3 -3
data/core/encoding.rbs +434 -628
data/core/enumerator.rbs +37 -0
data/core/exception.rbs +11 -11
data/core/false_class.rbs +5 -11
data/core/fiber.rbs +3 -3
data/core/file_test.rbs +28 -26
data/core/kernel.rbs +900 -21
data/core/marshal.rbs +24 -14
data/core/match_data.rbs +8 -8
data/core/math.rbs +57 -53
data/core/method.rbs +3 -1
data/core/module.rbs +38 -36
data/core/nil_class.rbs +7 -13
data/core/object.rbs +3 -966
data/core/process.rbs +3 -3
data/core/ractor.rbs +2 -2
data/core/rb_config.rbs +64 -43
data/core/regexp.rbs +3 -3
data/core/signal.rbs +10 -4
data/core/struct.rbs +1 -1
data/core/thread.rbs +7 -7
data/core/thread_group.rbs +9 -9
data/core/true_class.rbs +5 -11
data/core/unbound_method.rbs +56 -7
data/core/warning.rbs +33 -0
data/docs/collection.md +56 -6
data/docs/data_and_struct.md +57 -0
data/docs/stdlib.md +61 -2
data/docs/syntax.md +123 -2
data/ext/rbs_extension/lexer.c +624 -569
data/ext/rbs_extension/lexer.h +1 -0
data/ext/rbs_extension/lexer.re +1 -0
data/ext/rbs_extension/lexstate.c +1 -0
data/ext/rbs_extension/parser.c +6 -0
data/goodcheck.yml +2 -2
data/lib/rbs/annotate/formatter.rb +13 -3
data/lib/rbs/annotate/rdoc_source.rb +10 -1
data/lib/rbs/cli/colored_io.rb +48 -0
data/lib/rbs/cli/diff.rb +80 -0
data/lib/rbs/cli.rb +151 -16
data/lib/rbs/collection/config/lockfile.rb +0 -25
data/lib/rbs/collection/config/lockfile_generator.rb +0 -6
data/lib/rbs/collection/installer.rb +1 -1
data/lib/rbs/collection/sources/git.rb +6 -4
data/lib/rbs/collection/sources/local.rb +7 -5
data/lib/rbs/diff.rb +104 -0
data/lib/rbs/environment.rb +1 -1
data/lib/rbs/method_type.rb +23 -0
data/lib/rbs/prototype/rb.rb +2 -9
data/lib/rbs/prototype/runtime/helpers.rb +59 -0
data/lib/rbs/prototype/runtime/value_object_generator.rb +236 -0
data/lib/rbs/prototype/runtime.rb +234 -150
data/lib/rbs/sorter.rb +144 -117
data/lib/rbs/test/guaranteed.rb +31 -0
data/lib/rbs/test/type_check.rb +4 -4
data/lib/rbs/test.rb +3 -0
data/lib/rbs/types.rb +184 -3
data/lib/rbs/version.rb +1 -1
data/lib/rbs/writer.rb +4 -4
data/lib/rbs.rb +1 -0
data/rbs.gemspec +1 -0
data/sig/annotate/formatter.rbs +2 -2
data/sig/annotate/rdoc_annotater.rbs +1 -1
data/sig/cli/colored_io.rbs +15 -0
data/sig/cli/diff.rbs +21 -0
data/sig/cli.rbs +2 -0
data/sig/collection/config/lockfile.rbs +0 -6
data/sig/diff.rbs +23 -0
data/sig/errors.rbs +1 -5
data/sig/method_types.rbs +6 -0
data/sig/prototype/runtime.rbs +108 -0
data/sig/rdoc/rbs.rbs +4 -0
data/sig/shims/bundler.rbs +5 -0
data/sig/sorter.rbs +23 -5
data/sig/types.rbs +29 -0
data/stdlib/benchmark/0/benchmark.rbs +1 -1
data/stdlib/cgi/0/core.rbs +2 -2
data/stdlib/did_you_mean/0/did_you_mean.rbs +2 -2
data/stdlib/digest/0/digest.rbs +1 -1
data/stdlib/fileutils/0/fileutils.rbs +1 -1
data/stdlib/forwardable/0/forwardable.rbs +4 -4
data/stdlib/io-console/0/io-console.rbs +1 -1
data/stdlib/json/0/json.rbs +37 -0
data/stdlib/logger/0/logger.rbs +2 -2
data/stdlib/net-http/0/manifest.yaml +1 -1
data/stdlib/net-http/0/net-http.rbs +16 -63
data/stdlib/net-protocol/0/manifest.yaml +2 -0
data/stdlib/net-protocol/0/net-protocol.rbs +56 -0
data/stdlib/openssl/0/openssl.rbs +1 -1
data/stdlib/pp/0/manifest.yaml +2 -0
data/stdlib/pp/0/pp.rbs +301 -0
data/stdlib/{yaml → psych}/0/dbm.rbs +3 -3
data/stdlib/psych/0/manifest.yaml +3 -0
data/stdlib/psych/0/psych.rbs +391 -0
data/stdlib/{yaml → psych}/0/store.rbs +2 -2
data/stdlib/rdoc/0/code_object.rbs +55 -0
data/stdlib/rdoc/0/comment.rbs +60 -0
data/stdlib/rdoc/0/context.rbs +153 -0
data/stdlib/rdoc/0/markup.rbs +119 -0
data/stdlib/rdoc/0/parser.rbs +56 -0
data/stdlib/rdoc/0/rdoc.rbs +0 -372
data/stdlib/rdoc/0/ri.rbs +17 -0
data/stdlib/rdoc/0/store.rbs +48 -0
data/stdlib/rdoc/0/top_level.rbs +97 -0
data/stdlib/socket/0/basic_socket.rbs +1 -1
data/stdlib/socket/0/socket.rbs +1 -1
data/stdlib/uri/0/common.rbs +1 -1
data/stdlib/yaml/0/manifest.yaml +1 -2
data/stdlib/yaml/0/yaml.rbs +1 -199
metadata +46 -9
data/sig/shims/pp.rbs +0 -3
data/sig/shims.rbs +0 -47

data/stdlib/rdoc/0/markup.rbs ADDED Viewed

@@ -0,0 +1,119 @@
+%a{annotate:rdoc:skip}
+module RDoc
+  # <!-- rdoc-file=lib/rdoc/markup.rb -->
+  # RDoc::Markup parses plain text documents and attempts to decompose them into
+  # their constituent parts.  Some of these parts are high-level: paragraphs,
+  # chunks of verbatim text, list entries and the like.  Other parts happen at the
+  # character level: a piece of bold text, a word in code font.  This markup is
+  # similar in spirit to that used on WikiWiki webs, where folks create web pages
+  # using a simple set of formatting rules.
+  #
+  # RDoc::Markup and other markup formats do no output formatting, this is handled
+  # by the RDoc::Markup::Formatter subclasses.
+  #
+  # # Supported Formats
+  #
+  # Besides the RDoc::Markup format, the following formats are built in to RDoc:
+  #
+  # markdown
+  # :   The markdown format as described by
+  #     http://daringfireball.net/projects/markdown/.  See RDoc::Markdown for
+  #     details on the parser and supported extensions.
+  # rd
+  # :   The rdtool format.  See RDoc::RD for details on the parser and format.
+  # tomdoc
+  # :   The TomDoc format as described by http://tomdoc.org/.  See RDoc::TomDoc
+  #     for details on the parser and supported extensions.
+  #
+  #
+  # You can choose a markup format using the following methods:
+  #
+  # per project
+  # :   If you build your documentation with rake use RDoc::Task#markup.
+  #
+  #     If you build your documentation by hand run:
+  #
+  #         rdoc --markup your_favorite_format --write-options
+  #
+  #     and commit `.rdoc_options` and ship it with your packaged gem.
+  # per file
+  # :   At the top of the file use the `:markup:` directive to set the default
+  #     format for the rest of the file.
+  # per comment
+  # :   Use the `:markup:` directive at the top of a comment you want to write in
+  #     a different format.
+  #
+  #
+  # # RDoc::Markup
+  #
+  # RDoc::Markup is extensible at runtime: you can add new markup elements to be
+  # recognized in the documents that RDoc::Markup parses.
+  #
+  # RDoc::Markup is intended to be the basis for a family of tools which share the
+  # common requirement that simple, plain-text should be rendered in a variety of
+  # different output formats and media.  It is envisaged that RDoc::Markup could
+  # be the basis for formatting RDoc style comment blocks, Wiki entries, and
+  # online FAQs.
+  #
+  # ## Synopsis
+  #
+  # This code converts `input_string` to HTML.  The conversion takes place in the
+  # `convert` method, so you can use the same RDoc::Markup converter to convert
+  # multiple input strings.
+  #
+  #     require 'rdoc'
+  #
+  #     h = RDoc::Markup::ToHtml.new(RDoc::Options.new)
+  #
+  #     puts h.convert(input_string)
+  #
+  # You can extend the RDoc::Markup parser to recognize new markup sequences, and
+  # to add regexp handling. Here we make WikiWords significant to the parser, and
+  # also make the sequences {word} and <no>text...</no> signify strike-through
+  # text.  We then subclass the HTML output class to deal with these:
+  #
+  #     require 'rdoc'
+  #
+  #     class WikiHtml < RDoc::Markup::ToHtml
+  #       def handle_regexp_WIKIWORD(target)
+  #         "<font color=red>" + target.text + "</font>"
+  #       end
+  #     end
+  #
+  #     markup = RDoc::Markup.new
+  #     markup.add_word_pair("{", "}", :STRIKE)
+  #     markup.add_html("no", :STRIKE)
+  #
+  #     markup.add_regexp_handling(/\b([A-Z][a-z]+[A-Z]\w+)/, :WIKIWORD)
+  #
+  #     wh = WikiHtml.new RDoc::Options.new, markup
+  #     wh.add_tag(:STRIKE, "<strike>", "</strike>")
+  #
+  #     puts "<body>#{wh.convert ARGF.read}</body>"
+  #
+  # ## Encoding
+  #
+  # Where Encoding support is available, RDoc will automatically convert all
+  # documents to the same output encoding.  The output encoding can be set via
+  # RDoc::Options#encoding and defaults to Encoding.default_external.
+  #
+  # # RDoc Markup Reference
+  #
+  # See RDoc::MarkupReference.
+  #
+  class Markup
+    class Document
+      include Enumerable[Document]
+      def each: () { (Document) -> void } -> void
+              | () -> Enumerator[Document, void]
+      def file: () -> String?
+      def accept: (untyped) -> String
+    end
+    class ToMarkdown
+    end
+  end
+end

data/stdlib/rdoc/0/parser.rbs ADDED Viewed

@@ -0,0 +1,56 @@
+%a{annotate:rdoc:skip}
+module RDoc
+  # <!-- rdoc-file=lib/rdoc/parser.rb -->
+  # A parser is simple a class that subclasses RDoc::Parser and implements #scan
+  # to fill in an RDoc::TopLevel with parsed data.
+  #
+  # The initialize method takes an RDoc::TopLevel to fill with parsed content, the
+  # name of the file to be parsed, the content of the file, an RDoc::Options
+  # object and an RDoc::Stats object to inform the user of parsed items.  The scan
+  # method is then called to parse the file and must return the RDoc::TopLevel
+  # object.  By calling super these items will be set for you.
+  #
+  # In order to be used by RDoc the parser needs to register the file extensions
+  # it can parse.  Use ::parse_files_matching to register extensions.
+  #
+  #     require 'rdoc'
+  #
+  #     class RDoc::Parser::Xyz < RDoc::Parser
+  #       parse_files_matching /\.xyz$/
+  #
+  #       def initialize top_level, file_name, content, options, stats
+  #         super
+  #
+  #         # extra initialization if needed
+  #       end
+  #
+  #       def scan
+  #         # parse file and fill in @top_level
+  #       end
+  #     end
+  #
+  class Parser
+    # <!--
+    #   rdoc-file=lib/rdoc/parser.rb
+    #   - parse_files_matching(regexp)
+    # -->
+    # Record which file types this parser can understand.
+    #
+    # It is ok to call this multiple times.
+    #
+    def self?.parse_files_matching: (Regexp path) -> void
+    # <!--
+    #   rdoc-file=lib/rdoc/parser.rb
+    #   - new(top_level, file_name, content, options, stats)
+    # -->
+    # Creates a new Parser storing `top_level`, `file_name`, `content`, `options`
+    # and `stats` in instance variables.  In +@preprocess+ an
+    # RDoc::Markup::PreProcess object is created which allows processing of
+    # directives.
+    #
+    def initialize: (RDoc::TopLevel top_level, String filename, String content, Hash[untyped, untyped] options, RDoc::Stats stats) -> void
+    def scan: () -> RDoc::TopLevel
+  end
+end

data/stdlib/rdoc/0/rdoc.rbs CHANGED Viewed

@@ -57,339 +57,6 @@
 #     for irb and the rtags package.
 #
 module RDoc
-  # <!-- rdoc-file=lib/rdoc/parser.rb -->
-  # A parser is simple a class that subclasses RDoc::Parser and implements #scan
-  # to fill in an RDoc::TopLevel with parsed data.
-  #
-  # The initialize method takes an RDoc::TopLevel to fill with parsed content, the
-  # name of the file to be parsed, the content of the file, an RDoc::Options
-  # object and an RDoc::Stats object to inform the user of parsed items.  The scan
-  # method is then called to parse the file and must return the RDoc::TopLevel
-  # object.  By calling super these items will be set for you.
-  #
-  # In order to be used by RDoc the parser needs to register the file extensions
-  # it can parse.  Use ::parse_files_matching to register extensions.
-  #
-  #     require 'rdoc'
-  #
-  #     class RDoc::Parser::Xyz < RDoc::Parser
-  #       parse_files_matching /\.xyz$/
-  #
-  #       def initialize top_level, file_name, content, options, stats
-  #         super
-  #
-  #         # extra initialization if needed
-  #       end
-  #
-  #       def scan
-  #         # parse file and fill in @top_level
-  #       end
-  #     end
-  #
-  class Parser
-    # <!--
-    #   rdoc-file=lib/rdoc/parser.rb
-    #   - parse_files_matching(regexp)
-    # -->
-    # Record which file types this parser can understand.
-    #
-    # It is ok to call this multiple times.
-    #
-    def self?.parse_files_matching: (Regexp path) -> void
-    # <!--
-    #   rdoc-file=lib/rdoc/parser.rb
-    #   - new(top_level, file_name, content, options, stats)
-    # -->
-    # Creates a new Parser storing `top_level`, `file_name`, `content`, `options`
-    # and `stats` in instance variables.  In +@preprocess+ an
-    # RDoc::Markup::PreProcess object is created which allows processing of
-    # directives.
-    #
-    def initialize: (RDoc::TopLevel top_level, String filename, String content, Hash[untyped, untyped] options, RDoc::Stats stats) -> void
-    def scan: () -> RDoc::TopLevel
-  end
-  # <!-- rdoc-file=lib/rdoc/code_object.rb -->
-  # Base class for the RDoc code tree.
-  #
-  # We contain the common stuff for contexts (which are containers) and other
-  # elements (methods, attributes and so on)
-  #
-  # Here's the tree of the CodeObject subclasses:
-  #
-  # *   RDoc::Context
-  #     *   RDoc::TopLevel
-  #     *   RDoc::ClassModule
-  #         *   RDoc::AnonClass (never used so far)
-  #         *   RDoc::NormalClass
-  #         *   RDoc::NormalModule
-  #         *   RDoc::SingleClass
-  #
-  #
-  # *   RDoc::MethodAttr
-  #     *   RDoc::Attr
-  #     *   RDoc::AnyMethod
-  #         *   RDoc::GhostMethod
-  #         *   RDoc::MetaMethod
-  #
-  #
-  # *   RDoc::Alias
-  # *   RDoc::Constant
-  # *   RDoc::Mixin
-  #     *   RDoc::Require
-  #     *   RDoc::Include
-  #
-  class CodeObject
-    # <!-- rdoc-file=lib/rdoc/code_object.rb -->
-    # Our comment
-    #
-    attr_reader comment: RDoc::Comment
-    # <!--
-    #   rdoc-file=lib/rdoc/code_object.rb
-    #   - new()
-    # -->
-    # Creates a new CodeObject that will document itself and its children
-    #
-    def initialize: () -> void
-    # <!--
-    #   rdoc-file=lib/rdoc/code_object.rb
-    #   - comment=(comment)
-    # -->
-    # Replaces our comment with `comment`, unless it is empty.
-    #
-    def comment=: (RDoc::Comment | String) -> RDoc::Comment
-  end
-  # <!-- rdoc-file=lib/rdoc/context.rb -->
-  # A Context is something that can hold modules, classes, methods, attributes,
-  # aliases, requires, and includes. Classes, modules, and files are all Contexts.
-  #
-  class Context < CodeObject
-    include Comparable
-    # <!-- rdoc-file=lib/rdoc/context.rb -->
-    # Types of methods
-    #
-    TYPES: ::Array["class" | "instance"]
-    TOMDOC_TITLES: ::Array[nil | "Public" | "Internal" | "Deprecated"]
-    type class_types = singleton(RDoc::NormalClass) | singleton(RDoc::SingleClass)
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - new()
-    # -->
-    # Creates an unnamed empty context with public current visibility
-    #
-    def initialize: () -> void
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_alias(an_alias)
-    # -->
-    # Adds `an_alias` that is automatically resolved
-    #
-    def add_alias: (RDoc::Alias an_alias) -> RDoc::Alias
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_attribute(attribute)
-    # -->
-    # Adds `attribute` if not already there. If it is (as method(s) or attribute),
-    # updates the comment if it was empty.
-    #
-    # The attribute is registered only if it defines a new method. For instance,
-    # `attr_reader :foo` will not be registered if method `foo` exists, but
-    # `attr_accessor :foo` will be registered if method `foo` exists, but `foo=`
-    # does not.
-    #
-    def add_attribute: (RDoc::Attr attribute) -> RDoc::Attr
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_class(class_type, given_name, superclass = '::Object')
-    # -->
-    # Adds a class named `given_name` with `superclass`.
-    #
-    # Both `given_name` and `superclass` may contain '::', and are interpreted
-    # relative to the `self` context. This allows handling correctly examples like
-    # these:
-    #     class RDoc::Gauntlet < Gauntlet
-    #     module Mod
-    #       class Object   # implies < ::Object
-    #       class SubObject < Object  # this is _not_ ::Object
-    #
-    # Given `class Container::Item` RDoc assumes `Container` is a module unless it
-    # later sees `class Container`.  `add_class` automatically upgrades `given_name`
-    # to a class in this case.
-    #
-    def add_class: (class_types class_type, ::String given_name, ?::String superclass) -> (RDoc::NormalClass | RDoc::SingleClass)
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_constant(constant)
-    # -->
-    # Adds `constant` if not already there. If it is, updates the comment, value
-    # and/or is_alias_for of the known constant if they were empty/nil.
-    #
-    def add_constant: (RDoc::Constant constant) -> RDoc::Constant
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_include(include)
-    # -->
-    # Adds included module `include` which should be an RDoc::Include
-    #
-    def add_include: (RDoc::Include `include`) -> RDoc::Include
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_extend(ext)
-    # -->
-    # Adds extension module `ext` which should be an RDoc::Extend
-    #
-    def add_extend: (RDoc::Extend ext) -> RDoc::Extend
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_method(method)
-    # -->
-    # Adds `method` if not already there. If it is (as method or attribute), updates
-    # the comment if it was empty.
-    #
-    def add_method: (RDoc::AnyMethod method) -> RDoc::AnyMethod
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - add_module(class_type, name)
-    # -->
-    # Adds a module named `name`.  If RDoc already knows `name` is a class then that
-    # class is returned instead.  See also #add_class.
-    #
-    def add_module: (singleton(RDoc::NormalModule) class_type, String name) -> RDoc::NormalModule
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - find_module_named(name)
-    # -->
-    # Find a module with `name` using ruby's scoping rules
-    #
-    def find_module_named: (untyped name) -> (untyped | self)
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - full_name()
-    # -->
-    # The full name for this context.  This method is overridden by subclasses.
-    #
-    def full_name: () -> "(unknown)"
-    def to_s: () -> ::String
-    # <!--
-    #   rdoc-file=lib/rdoc/context.rb
-    #   - top_level()
-    # -->
-    # Return the TopLevel that owns us
-    #
-    def top_level: () -> RDoc::TopLevel
-  end
-  # <!-- rdoc-file=lib/rdoc/top_level.rb -->
-  # A TopLevel context is a representation of the contents of a single file
-  #
-  class TopLevel < Context
-    MARSHAL_VERSION: 0
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - new(absolute_name, relative_name = absolute_name)
-    # -->
-    # Creates a new TopLevel for the file at `absolute_name`.  If documentation is
-    # being generated outside the source dir `relative_name` is relative to the
-    # source directory.
-    #
-    def initialize: (String absolute_name, ?String relative_name) -> void
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - ==(other)
-    # -->
-    # An RDoc::TopLevel is equal to another with the same relative_name
-    #
-    def ==: (untyped other) -> bool
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - eql?(other)
-    # -->
-    #
-    alias eql? ==
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - add_alias(an_alias)
-    # -->
-    # Adds `an_alias` to `Object` instead of `self`.
-    #
-    def add_alias: (RDoc::Alias an_alias) -> RDoc::Alias
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - add_constant(constant)
-    # -->
-    # Adds `constant` to `Object` instead of `self`.
-    #
-    def add_constant: (RDoc::Constant constant) -> RDoc::Constant
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - add_include(include)
-    # -->
-    # Adds `include` to `Object` instead of `self`.
-    #
-    def add_include: (RDoc::Include `include`) -> RDoc::Include
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - add_method(method)
-    # -->
-    # Adds `method` to `Object` instead of `self`.
-    #
-    def add_method: (RDoc::AnyMethod method) -> RDoc::AnyMethod
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - find_class_or_module(name)
-    # -->
-    # See RDoc::TopLevel::find_class_or_module
-    #
-    def find_class_or_module: (::String name) -> RDoc::Context
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - find_module_named(name)
-    # -->
-    # Finds a module or class with `name`
-    #
-    def find_module_named: (String name) -> RDoc::Context
-    # <!--
-    #   rdoc-file=lib/rdoc/top_level.rb
-    #   - full_name()
-    # -->
-    # Returns the relative name of this file
-    #
-    def full_name: () -> String
-    def to_s: () -> ::String
-  end
   # <!-- rdoc-file=lib/rdoc/token_stream.rb -->
   # A TokenStream is a list of tokens, gathered during the parse of some entity
   # (say a method). Entities populate these streams by being registered with the
@@ -422,45 +89,6 @@ module RDoc
     alias start_collecting_tokens collect_tokens
   end
-  # <!-- rdoc-file=lib/rdoc/comment.rb -->
-  # A comment holds the text comment for a RDoc::CodeObject and provides a unified
-  # way of cleaning it up and parsing it into an RDoc::Markup::Document.
-  #
-  # Each comment may have a different markup format set by #format=.  By default
-  # 'rdoc' is used.  The :markup: directive tells RDoc which format to use.
-  #
-  # See RDoc::Markup@Other+directives for instructions on adding an alternate
-  # format.
-  #
-  class Comment
-    # <!-- rdoc-file=lib/rdoc/comment.rb -->
-    # The format of this comment.  Defaults to RDoc::Markup
-    #
-    attr_reader format: String
-    # <!-- rdoc-file=lib/rdoc/comment.rb -->
-    # The RDoc::TopLevel this comment was found in
-    #
-    attr_accessor location: String
-    # <!--
-    #   rdoc-file=lib/rdoc/comment.rb
-    #   - new(text = nil, location = nil, language = nil)
-    # -->
-    # Creates a new comment with `text` that is found in the RDoc::TopLevel
-    # `location`.
-    #
-    def initialize: (?String? text, ?RDoc::Context? location, ?String? language) -> void
-    # <!--
-    #   rdoc-file=lib/rdoc/comment.rb
-    #   - format=(format)
-    # -->
-    # Sets the format of this comment and resets any parsed document
-    #
-    def format=: (String format) -> void
-  end
   # <!-- rdoc-file=lib/rdoc/class_module.rb -->
   # ClassModule is the base class for objects representing either a class or a
   # module.

data/stdlib/rdoc/0/ri.rbs ADDED Viewed

@@ -0,0 +1,17 @@
+%a{annotate:rdoc:skip}
+module RDoc
+  # <!-- rdoc-file=lib/rdoc/ri.rb -->
+  # Namespace for the ri command line tool's implementation.
+  #
+  # See `ri --help` for details.
+  #
+  module RI
+    module Paths
+      type path_type = :system | :site | :home | :gem | :extra
+      type gem_filter = :latest | :all
+      def self.each: (?bool system, ?bool site, ?bool home, ?gem_filter | false gems, *String extra_dirs) { (String, path_type) -> void } -> void
+    end
+  end
+end

data/stdlib/rdoc/0/store.rbs ADDED Viewed

@@ -0,0 +1,48 @@
+%a{annotate:rdoc:skip}
+module RDoc
+  # <!-- rdoc-file=lib/rdoc/store.rb -->
+  # A set of rdoc data for a single project (gem, path, etc.).
+  #
+  # The store manages reading and writing ri data for a project and maintains a
+  # cache of methods, classes and ancestors in the store.
+  #
+  # The store maintains a #cache of its contents for faster lookup.  After adding
+  # items to the store it must be flushed using #save_cache.  The cache contains
+  # the following structures:
+  #
+  #     @cache = {
+  #       :ancestors        => {}, # class name => ancestor names
+  #       :attributes       => {}, # class name => attributes
+  #       :class_methods    => {}, # class name => class methods
+  #       :instance_methods => {}, # class name => instance methods
+  #       :modules          => [], # classes and modules in this store
+  #       :pages            => [], # page names
+  #     }
+  #
+  class Store
+    # <!--
+    #   rdoc-file=lib/rdoc/store.rb
+    #   - new(path = nil, type = nil)
+    # -->
+    # Creates a new Store of `type` that will load or save to `path`
+    #
+    def initialize: (?String? path, ?Symbol? type) -> void
+    # <!--
+    #   rdoc-file=lib/rdoc/store.rb
+    #   - find_class_or_module(name)
+    # -->
+    # Finds the class or module with `name`
+    #
+    def find_class_or_module: (String) -> ClassModule?
+    # <!--
+    #   rdoc-file=lib/rdoc/store.rb
+    #   - load_all()
+    # -->
+    # Loads all items from this store into memory.  This recreates a documentation
+    # tree for use by a generator
+    #
+    def load_all: () -> void
+  end
+end