m2m_keygen 0.4.9 → 0.5.0

data/sorbet/rbi/gems/zeitwerk@2.8.2.rbi

@@ -0,0 +1,1178 @@
+# typed: true
+
+# DO NOT EDIT MANUALLY
+# This is an autogenerated file for types exported from the `zeitwerk` gem.
+# Please instead update this file by running `bin/tapioca gem zeitwerk`.
+
+
+# pkg:gem/zeitwerk#lib/zeitwerk/core_ext/kernel.rb:3
+module Kernel
+  private
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/core_ext/kernel.rb:23
+  def require(path); end
+
+  # Zeitwerk's main idea is to define autoloads for project constants, and then
+  # intercept them when triggered in this thin `Kernel#require` wrapper.
+  #
+  # That allows us to complete the circle, invoke callbacks, autovivify modules,
+  # define autoloads for just autoloaded namespaces, update internal state, etc.
+  #
+  # On the other hand, if you publish a new version of a gem that is now managed
+  # by Zeitwerk, client code can reference directly your classes and modules and
+  # should not require anything. But if someone has legacy require calls around,
+  # they will work as expected, and in a compatible way. This feature is by now
+  # EXPERIMENTAL and UNDOCUMENTED.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/core_ext/kernel.rb:17
+  def zeitwerk_original_require(name); end
+
+  class << self
+    # pkg:gem/zeitwerk#lib/zeitwerk/core_ext/kernel.rb:23
+    def require(path); end
+
+    # pkg:gem/zeitwerk#lib/zeitwerk/core_ext/kernel.rb:19
+    def zeitwerk_original_require(name); end
+  end
+end
+
+class Module
+  include ::Zeitwerk::ConstAdded
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk.rb:3
+module Zeitwerk
+  class << self
+    # This is a dangerous method.
+    #
+    # @experimental
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk.rb:23
+    def with_loader; end
+  end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/error.rb:24
+class Zeitwerk::ConflictingNamespaceDefinitionError < ::Zeitwerk::Error
+  # pkg:gem/zeitwerk#lib/zeitwerk/error.rb:26
+  def initialize(cpath, location:, conflicting_file:); end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/core_ext/module.rb:3
+module Zeitwerk::ConstAdded
+  # pkg:gem/zeitwerk#lib/zeitwerk/core_ext/module.rb:5
+  def const_added(cname); end
+end
+
+# This private class encapsulates pairs (mod, cname).
+#
+# Objects represent the constant `cname` in the class or module object `mod`,
+# and have API to manage them. Examples:
+#
+#   cref.path
+#   cref.set(value)
+#   cref.get
+#
+# The constant may or may not exist in `mod`.
+#
+# pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:13
+class Zeitwerk::Cref
+  include ::Zeitwerk::RealModName
+
+  # The type of the first argument is Module because Class < Module, class
+  # objects are also valid.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:28
+  def initialize(mod, cname); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:46
+  def autoload(abspath); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:41
+  def autoload?; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:22
+  def cname; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:51
+  def defined?; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:61
+  def get; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:71
+  def location; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:19
+  def mod; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:35
+  def path; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:66
+  def remove; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:56
+  def set(value); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref.rb:38
+  def to_s; end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:73
+class Zeitwerk::Cref::Map
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:75
+  def initialize; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:90
+  def [](cref); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:82
+  def []=(cref, value); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:147
+  def clear; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:105
+  def delete(cref); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:124
+  def delete_by_value(value); end
+
+  # Ad-hoc for loader_for, called from const_added. That is a hot path, I prefer
+  # to not create a cref in every call, since that is global.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:113
+  def delete_mod_cname(mod, cname); end
+
+  # Order of yielded crefs is undefined.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:136
+  def each_key; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:154
+  def empty?; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/cref/map.rb:97
+  def get_or_set(cref, &block); end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/error.rb:4
+class Zeitwerk::Error < ::StandardError; end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/gem_inflector.rb:4
+class Zeitwerk::GemInflector < ::Zeitwerk::Inflector
+  # pkg:gem/zeitwerk#lib/zeitwerk/gem_inflector.rb:6
+  def initialize(root_file); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/gem_inflector.rb:13
+  def camelize(basename, abspath); end
+end
+
+# @private
+#
+# pkg:gem/zeitwerk#lib/zeitwerk/gem_loader.rb:5
+class Zeitwerk::GemLoader < ::Zeitwerk::Loader
+  # pkg:gem/zeitwerk#lib/zeitwerk/gem_loader.rb:19
+  def initialize(root_file, namespace:, warn_on_extra_files:); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/gem_loader.rb:34
+  def setup; end
+
+  private
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/gem_loader.rb:42
+  def warn_on_extra_files; end
+
+  class << self
+    # @private
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/gem_loader.rb:14
+    def __new(root_file, namespace:, warn_on_extra_files:); end
+
+    private
+
+    # pkg:gem/zeitwerk#lib/zeitwerk/gem_loader.rb:10
+    def new(*_arg0); end
+  end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/inflector.rb:4
+class Zeitwerk::Inflector
+  # Very basic snake case -> camel case conversion.
+  #
+  #   inflector = Zeitwerk::Inflector.new
+  #   inflector.camelize('post', ...)             # => 'Post'
+  #   inflector.camelize('users_controller', ...) # => 'UsersController'
+  #   inflector.camelize('api', ...)              # => 'Api'
+  #
+  # Takes into account hard-coded mappings configured with `inflect`.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/inflector.rb:15
+  def camelize(basename, _abspath); end
+
+  # Configures hard-coded inflections:
+  #
+  #   inflector = Zeitwerk::Inflector.new
+  #   inflector.inflect(
+  #     'html_parser'   => 'HTMLParser',
+  #     'mysql_adapter' => 'MySQLAdapter'
+  #   )
+  #
+  #   inflector.camelize('html_parser', abspath)      # => 'HTMLParser'
+  #   inflector.camelize('mysql_adapter', abspath)    # => 'MySQLAdapter'
+  #   inflector.camelize('users_controller', abspath) # => 'UsersController'
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/inflector.rb:32
+  def inflect(inflections); end
+
+  private
+
+  # Hard-coded basename to constant name user maps that override the default
+  # inflection logic.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/inflector.rb:42
+  def overrides; end
+end
+
+# This is a private module.
+#
+# pkg:gem/zeitwerk#lib/zeitwerk/internal.rb:4
+module Zeitwerk::Internal
+  # pkg:gem/zeitwerk#lib/zeitwerk/internal.rb:6
+  def internal(method_name); end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:7
+class Zeitwerk::Loader
+  include ::Zeitwerk::RealModName
+  include ::Zeitwerk::Loader::Callbacks
+  include ::Zeitwerk::Loader::Helpers
+  include ::Zeitwerk::Loader::Config
+  include ::Zeitwerk::Loader::EagerLoad
+  extend ::Zeitwerk::Internal
+  extend ::Zeitwerk::RealModName
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:107
+  def initialize; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:66
+  def __autoloaded_dirs; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:32
+  def __autoloads; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:56
+  def __inceptions; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:382
+  def __log; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:85
+  def __namespace_dirs; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:377
+  def __shadowed_file?(file); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:96
+  def __shadowed_files; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:76
+  def __to_unload; end
+
+  # This is an internal method.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:166
+  def __unload; end
+
+  # Returns a hash that maps the absolute paths of the managed files and
+  # directories to their respective expected constant paths.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:258
+  def all_expected_cpaths; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:290
+  def cpath_expected_at(path); end
+
+  # Unloads all loaded code, and calls setup again so that the loader is able
+  # to pick any changes in the file system.
+  #
+  # This method is not thread-safe, please see how this can be achieved by
+  # client code in the README of the project.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:241
+  def reload; end
+
+  # Sets autoloads in the root namespaces.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:130
+  def setup; end
+
+  # Removes loaded constants and configured autoloads.
+  #
+  # The objects the constants stored are no longer reachable through them. In
+  # addition, since said objects are normally not referenced from anywhere
+  # else, they are eligible for garbage collection, which would effectively
+  # unload them.
+  #
+  # This method is public but undocumented. Main interface is `reload`, which
+  # means `unload` + `setup`. This one is available to be used together with
+  # `unregister`, which is undocumented too.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:156
+  def unload; end
+
+  # Says if the given constant path would be unloaded on reload. This
+  # predicate returns `false` if reloading is disabled.
+  #
+  # This is an undocumented method that I wrote to help transition from the
+  # classic autoloader in Rails. Its usage was removed from Rails in 7.0.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:346
+  def unloadable_cpath?(cpath); end
+
+  # Returns an array with the constant paths that would be unloaded on reload.
+  # This predicate returns an empty array if reloading is disabled.
+  #
+  # This is an undocumented method that I wrote to help transition from the
+  # classic autoloader in Rails. Its usage was removed from Rails in 7.0.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:357
+  def unloadable_cpaths; end
+
+  # This is a dangerous method.
+  #
+  # @experimental
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:365
+  def unregister; end
+
+  private
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:616
+  def autoload_path_set_by_me_for?(cref); end
+
+  # We keep track of autoloaded directories to remove them from the registry
+  # at the end of eager loading.
+  #
+  # Files are removed as they are autoloaded, but directories need to wait due
+  # to concurrency (see why in Zeitwerk::Loader::Callbacks#on_dir_autoloaded).
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:65
+  def autoloaded_dirs; end
+
+  # Maps absolute paths for which an autoload has been set ---and not
+  # executed--- to their corresponding Zeitwerk::Cref object.
+  #
+  #   '/Users/fxn/blog/app/models/user.rb'          => #<Zeitwerk::Cref:... @mod=Object, @cname=:User, ...>,
+  #   '/Users/fxn/blog/app/models/hotel/pricing.rb' => #<Zeitwerk::Cref:... @mod=Hotel, @cname=:Pricing, ...>,
+  #   ...
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:31
+  def autoloads; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:598
+  def define_autoload(cref, abspath); end
+
+  # Scans `dir` and sets autoloads in `mod` for the constants its contents are
+  # expected to define.
+  #
+  # The `external` flag indicates whether `mod` has been externally defined,
+  # as is the case with root namespaces or reopened third-party namespaces.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:497
+  def define_autoloads_for_dir(dir, mod, external:); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:103
+  def dirs_autoload_monitor; end
+
+  # When the path passed to Module#autoload is in the stack of features being
+  # loaded at the moment, Ruby passes. For example, Module#autoload? returns
+  # `nil` even if the autoload has not been attempted. See
+  #
+  #     https://bugs.ruby-lang.org/issues/21035
+  #
+  # We call these "inceptions".
+  #
+  # A common case is the entry point of gems managed by Zeitwerk. Their main
+  # file is normally required and, while doing so, the loader sets an autoload
+  # on the gem namespace. That autoload hits this edge case.
+  #
+  # There is some logic that needs to know if an autoload for a given constant
+  # already exists. We check Module#autoload? first, and fallback to the
+  # inceptions just in case.
+  #
+  # This map keeps track of pairs (cref, autoload_path) found by the loader.
+  # The object Zeitwerk::Registry.inceptions, on the other hand, acts as a
+  # global registry for them.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:55
+  def inceptions; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:382
+  def log; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:99
+  def mutex; end
+
+  # Maps namespace crefs to the directories that conform the namespace.
+  #
+  # When these crefs get defined we know their children are spread over those
+  # directories. We'll visit them to set up the corresponding autoloads.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:84
+  def namespace_dirs; end
+
+  # `dir` is the directory that would have autovivified a namespace. `file` is
+  # the file where we've found the namespace is explicitly defined.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:585
+  def promote_namespace_from_implicit_to_explicit(dir:, file:, cref:); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:649
+  def raise_if_conflicting_root_dir(root_dir); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:625
+  def register_explicit_namespace(cref); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:635
+  def register_inception(cref, abspath); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:659
+  def run_on_unload_callbacks(cref, value, abspath); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:377
+  def shadowed_file?(file); end
+
+  # A shadowed file is a file managed by this loader that is ignored when
+  # setting autoloads because its matching constant is already taken.
+  #
+  # This private set is populated lazily, as we descend. For example, if the
+  # loader has only scanned the top-level, `shadowed_files` does not have the
+  # shadowed files that may exist deep in the project tree.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:95
+  def shadowed_files; end
+
+  # If reloading is enabled, this collection maps autoload paths to their
+  # autoloaded crefs.
+  #
+  # On unload, the autoload paths are passed to callbacks, files deleted from
+  # $LOADED_FEATURES, and the crefs are deleted.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:75
+  def to_unload; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:666
+  def unload_autoload(cref); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:672
+  def unload_cref(cref); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:630
+  def unregister_explicit_namespaces; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:641
+  def unregister_inceptions; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:521
+  def visit_file(cref, file); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:545
+  def visit_subdir(cref, subdir, external:); end
+
+  class << self
+    # Returns an array with the absolute paths of the root directories of all
+    # registered loaders. This is a read-only collection.
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:481
+    def all_dirs; end
+
+    # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:397
+    def default_logger; end
+
+    # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:397
+    def default_logger=(_arg0); end
+
+    # Broadcasts `eager_load` to all loaders. Those that have not been setup
+    # are skipped.
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:453
+    def eager_load_all; end
+
+    # Broadcasts `eager_load_namespace` to all loaders. Those that have not
+    # been setup are skipped.
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:467
+    def eager_load_namespace(mod); end
+
+    # This is a shortcut for
+    #
+    #   require 'zeitwerk'
+    #
+    #   loader = Zeitwerk::Loader.new
+    #   loader.tag = File.basename(__FILE__, '.rb')
+    #   loader.inflector = Zeitwerk::GemInflector.new(__FILE__)
+    #   loader.push_dir(__dir__)
+    #
+    # except that this method returns the same object in subsequent calls from
+    # the same file, in the unlikely case the gem wants to be able to reload.
+    #
+    # This method returns a subclass of Zeitwerk::Loader, but the exact type
+    # is private, client code can only rely on the interface.
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:415
+    def for_gem(warn_on_extra_files: T.unsafe(nil)); end
+
+    # This is a shortcut for
+    #
+    #   require 'zeitwerk'
+    #
+    #   loader = Zeitwerk::Loader.new
+    #   loader.tag = namespace.name + '-' + File.basename(__FILE__, '.rb')
+    #   loader.inflector = Zeitwerk::GemInflector.new(__FILE__)
+    #   loader.push_dir(__dir__, namespace: namespace)
+    #
+    # except that this method returns the same object in subsequent calls from
+    # the same file, in the unlikely case the gem wants to be able to reload.
+    #
+    # This method returns a subclass of Zeitwerk::Loader, but the exact type
+    # is private, client code can only rely on the interface.
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/loader.rb:436
+    def for_gem_extension(namespace); end
+  end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/loader/callbacks.rb:3
+module Zeitwerk::Loader::Callbacks
+  extend ::Zeitwerk::Internal
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/callbacks.rb:39
+  def __on_dir_autoloaded(dir); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/callbacks.rb:9
+  def __on_file_autoloaded(file); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/callbacks.rb:77
+  def __on_namespace_loaded(cref, namespace); end
+
+  private
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/callbacks.rb:39
+  def on_dir_autoloaded(dir); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/callbacks.rb:9
+  def on_file_autoloaded(file); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/callbacks.rb:77
+  def on_namespace_loaded(cref, namespace); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/callbacks.rb:88
+  def run_on_load_callbacks(cpath, value, abspath); end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:6
+module Zeitwerk::Loader::Config
+  include ::Zeitwerk::RealModName
+  extend ::Zeitwerk::Internal
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:103
+  def initialize; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:369
+  def __collapse?(dir); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:374
+  def __collapse_parent?(dir); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:352
+  def __ignored_path?(abspath); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:339
+  def __ignores?(abspath); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:364
+  def __root_dir?(dir); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:33
+  def __roots; end
+
+  # Configure directories or glob patterns to be collapsed.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:245
+  def collapse(*glob_patterns); end
+
+  # If `namespaces` is falsey (default), returns an array with the absolute
+  # paths of the root directories as strings. If truthy, returns a hash table
+  # instead. Keys are the absolute paths of the root directories as strings,
+  # values are their corresponding namespaces, class or module objects.
+  #
+  # If `ignored` is falsey (default), ignored root directories are filtered out.
+  #
+  # These are read-only collections, please add to them with `push_dir`.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:186
+  def dirs(namespaces: T.unsafe(nil), ignored: T.unsafe(nil)); end
+
+  # Let eager load ignore the given files or directories. The constants defined
+  # in those files are still autoloadable.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:227
+  def do_not_eager_load(*paths); end
+
+  # You need to call this method before setup in order to be able to reload.
+  # There is no way to undo this, either you want to reload or you don't.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:206
+  def enable_reloading; end
+
+  # Configure files, directories, or glob patterns to be totally ignored.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:234
+  def ignore(*glob_patterns); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:14
+  def inflector; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:14
+  def inflector=(_arg0); end
+
+  # Logs to `$stdout`, handy shortcut for debugging.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:331
+  def log!; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:17
+  def logger; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:17
+  def logger=(_arg0); end
+
+  # Basename of files that define namespaces. For example, if `nsfile` is
+  # 'ns.rb', then `foo/ns.rb` defines the `Foo` namespace.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:39
+  def nsfile; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:165
+  def nsfile=(nsfile); end
+
+  # Configure a block to be invoked once a certain constant path is loaded.
+  # Supports multiple callbacks, and if there are many, they are executed in
+  # the order in which they were defined.
+  #
+  #   loader.on_load('SomeApiClient') do |klass, _abspath|
+  #     klass.endpoint = 'https://api.dev'
+  #   end
+  #
+  # Can also be configured for any constant loaded:
+  #
+  #   loader.on_load do |cpath, value, abspath|
+  #     # ...
+  #   end
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:284
+  def on_load(cpath = T.unsafe(nil), &block); end
+
+  # Configure a block to be called after setup and on each reload.
+  # If setup was already done, the block runs immediately.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:261
+  def on_setup(&block); end
+
+  # Configure a block to be invoked right before a certain constant is removed.
+  # Supports multiple callbacks, and if there are many, they are executed in the
+  # order in which they were defined.
+  #
+  #   loader.on_unload('Country') do |klass, _abspath|
+  #     klass.clear_cache
+  #   end
+  #
+  # Can also be configured for any removed constant:
+  #
+  #   loader.on_unload do |cpath, value, abspath|
+  #     # ...
+  #   end
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:314
+  def on_unload(cpath = T.unsafe(nil), &block); end
+
+  # Pushes `path` to the list of root directories.
+  #
+  # Raises `Zeitwerk::Error` if `path` does not exist, or if another loader in
+  # the same process already manages that directory or one of its ascendants or
+  # descendants.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:129
+  def push_dir(path, namespace: T.unsafe(nil)); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:219
+  def reloading_enabled?; end
+
+  # Returns the loader's tag.
+  #
+  # Implemented as a method instead of via attr_reader for symmetry with the
+  # writer below.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:153
+  def tag; end
+
+  # Sets a tag for the loader, useful for logging.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:160
+  def tag=(tag); end
+
+  private
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:357
+  def actual_roots; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:369
+  def collapse?(dir); end
+
+  # The actual collection of absolute directory names at the time the collapse
+  # glob patterns were expanded. Computed on setup and recomputed on reload.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:65
+  def collapse_dirs; end
+
+  # Absolute paths of directories or glob patterns to be collapsed.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:58
+  def collapse_glob_patterns; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:374
+  def collapse_parent?(dir); end
+
+  # Absolute paths of directories that are parents of collapsed directories.
+  # This is a cache to optimize some tree walks. Computed on setup and
+  # recomputed on reload.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:73
+  def collapse_parents; end
+
+  # Absolute paths of files or directories not to be eager loaded.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:79
+  def eager_load_exclusions; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:379
+  def excluded_from_eager_load?(abspath); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:397
+  def expand_glob_patterns(glob_patterns); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:392
+  def expand_paths(paths); end
+
+  # Absolute paths of files, directories, or glob patterns to be ignored.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:44
+  def ignored_glob_patterns; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:352
+  def ignored_path?(abspath); end
+
+  # The actual collection of absolute file and directory names at the time the
+  # ignored glob patterns were expanded. Computed on setup, and recomputed on
+  # reload.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:52
+  def ignored_paths; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:339
+  def ignores?(abspath); end
+
+  # User-oriented callbacks to be fired when a constant is loaded.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:92
+  def on_load_callbacks; end
+
+  # User-oriented callbacks to be fired on setup and on reload.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:85
+  def on_setup_callbacks; end
+
+  # User-oriented callbacks to be fired before constants are removed.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:99
+  def on_unload_callbacks; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:409
+  def recompute_collapse_dirs; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:414
+  def recompute_collapse_parents; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:404
+  def recompute_ignored_paths; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:364
+  def root_dir?(dir); end
+
+  # Absolute paths of the root directories, mapped to their respective root namespaces:
+  #
+  #   '/Users/fxn/blog/app/channels' => Object,
+  #   '/Users/fxn/blog/app/adapters' => ActiveJob::QueueAdapters,
+  #   ...
+  #
+  # Stored in a hash to preserve order, easily handle duplicates, and have a
+  # fast lookup by directory.
+  #
+  # This is a private collection maintained by the loader. The public
+  # interface for it is `push_dir` and `dirs`.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:32
+  def roots; end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/loader/config.rb:10
+Zeitwerk::Loader::Config::UNDEFINED = T.let(T.unsafe(nil), Object)
+
+# @private
+#
+# pkg:gem/zeitwerk#lib/zeitwerk/loader/constant_path_validator.rb:2
+class Zeitwerk::Loader::ConstantPathValidator
+  # Technically, this validation works with symbols, but API boundary restricts
+  # input to strings, so we assume strings, and we test strings.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/constant_path_validator.rb:10
+  def validate!(possible_cpath); end
+end
+
+# :nodoc
+#
+# pkg:gem/zeitwerk#lib/zeitwerk/loader/constant_path_validator.rb:3
+module Zeitwerk::Loader::ConstantPathValidator::CNAME_VALIDATOR; end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/loader/eager_load.rb:1
+module Zeitwerk::Loader::EagerLoad
+  # Eager loads all files in the root directories, recursively. Files do not
+  # need to be in `$LOAD_PATH`, absolute file names are used.
+  #
+  # Ignored files are not eager loaded. You can opt-out specifically in specific
+  # files and directories with `do_not_eager_load`, and that can be overridden
+  # passing `force: true`.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/eager_load.rb:10
+  def eager_load(force: T.unsafe(nil)); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/eager_load.rb:33
+  def eager_load_dir(path); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/eager_load.rb:74
+  def eager_load_namespace(mod); end
+
+  # Loads the given Ruby file.
+  #
+  # Raises if the argument is ignored, shadowed, or not managed by the receiver.
+  #
+  # The method is implemented as `constantize` for files, in a sense, to be able
+  # to descend orderly and make sure the file is loadable.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/eager_load.rb:116
+  def load_file(path); end
+
+  private
+
+  # The caller is responsible for making sure `namespace` is the namespace that
+  # corresponds to `dir`.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/eager_load.rb:162
+  def actual_eager_load_dir(dir, namespace, force: T.unsafe(nil)); end
+
+  # In order to invoke this method, the caller has to ensure `child` is a
+  # strict namespace descendant of `root_namespace`.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/eager_load.rb:191
+  def eager_load_child_namespace(child, child_name, root_dir, root_namespace); end
+end
+
+# This private class encapsulates interactions with the file system.
+#
+# It is used to list directories and check file types, and it encodes the
+# conventions documented in the README.
+#
+# @private
+#
+# pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:9
+class Zeitwerk::Loader::FileSystem
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:11
+  def initialize(loader); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:120
+  def dir?(path); end
+
+  # Returns the absolute path to an nsfile in `dir`, if there is exactly one. If
+  # there is none, it returns `nil`.
+  #
+  # This method accounts for collapsed directories, which conceptually allow for
+  # multiple nsfiles. If two are found, Zeitwerk::ConflictingNamespaceDefinitionError is raised.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:71
+  def has_exactly_one_nsfile?(cref, dir); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:125
+  def hidden?(basename); end
+
+  # This method lists directories, filtering out the following:
+  #
+  # - Hidden entries.
+  # - Ignored entries.
+  # - Files whose extension is not `.rb`.
+  # - Nested root directories, since they represent separate trees.
+  # - Subdirectories that (recursively) contain no Ruby files.
+  #
+  # If `collapse` is true, collapsed directories are not yielded, instead, the
+  # method recurses so that the caller gets a conceptually flat listing.
+  #
+  # For every entry that is not excluded, `ls` yields its basename, absolute
+  # path, and file type, which can only be :file or :directory.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:30
+  def ls(dir, collapse: T.unsafe(nil), &block); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:115
+  def rb_extension?(path); end
+
+  # Encodes the documented conventions.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:106
+  def supported_ftype?(abspath); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:56
+  def walk_up(abspath); end
+
+  private
+
+  # Available in Ruby 4.1.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:198
+  def each_ruby_file_or_directory(dir); end
+
+  # Looks for a Ruby file using breadth-first search. This type of search is
+  # important to list as less directories as possible and return fast in the
+  # common case in which there are Ruby files in the passed directory.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:136
+  def has_at_least_one_ruby_file?(dir); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/file_system.rb:151
+  def relevant_dir_entries(dir); end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/loader/helpers.rb:3
+module Zeitwerk::Loader::Helpers
+  private
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/loader/helpers.rb:5
+  def cname_for(basename, abspath); end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/error.rb:14
+class Zeitwerk::NameError < ::NameError; end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/null_inflector.rb:1
+class Zeitwerk::NullInflector
+  # pkg:gem/zeitwerk#lib/zeitwerk/null_inflector.rb:3
+  def camelize(basename, _abspath); end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/real_mod_name.rb:3
+module Zeitwerk::RealModName
+  # Returns the real name of the class or module.
+  #
+  # We need this indirection because the `name` method can be overridden, and
+  # because in practice what we really need is the constant paths of modules
+  # with a permanent name, not so much what the user considers to be the name of
+  # a certain class or module of theirs.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/real_mod_name.rb:16
+  def real_mod_name(mod); end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/real_mod_name.rb:5
+Zeitwerk::RealModName::UNBOUND_METHOD_MODULE_NAME = T.let(T.unsafe(nil), UnboundMethod)
+
+# pkg:gem/zeitwerk#lib/zeitwerk/registry.rb:4
+module Zeitwerk::Registry
+  class << self
+    # Maps absolute paths to the loaders responsible for them.
+    #
+    # This information is used by our decorated `Kernel#require` to be able to
+    # invoke callbacks and autovivify modules.
+    #
+    # @private
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/registry.rb:31
+    def autoloads; end
+
+    # pkg:gem/zeitwerk#lib/zeitwerk/registry.rb:48
+    def conflicting_root_dir?(loader, new_root_dir); end
+
+    # @private
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/registry.rb:35
+    def explicit_namespaces; end
+
+    # Registers gem loaders to let `for_gem` be idempotent in case of reload.
+    #
+    # @private
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/registry.rb:22
+    def gem_loaders_by_root_file; end
+
+    # @private
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/registry.rb:39
+    def inceptions; end
+
+    # This method returns always a loader, the same instance for the same root
+    # file. That is how Zeitwerk::Loader.for_gem is idempotent.
+    #
+    # @private
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/registry.rb:77
+    def loader_for_gem(root_file, namespace:, warn_on_extra_files:); end
+
+    # Keeps track of all loaders. Useful to broadcast messages and to prevent
+    # them from being garbage collected.
+    #
+    # @private
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/registry.rb:16
+    def loaders; end
+
+    # @private
+    #
+    # pkg:gem/zeitwerk#lib/zeitwerk/registry.rb:43
+    def unregister_loader(loader); end
+  end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/registry/autoloads.rb:2
+class Zeitwerk::Registry::Autoloads
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/autoloads.rb:4
+  def initialize; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/autoloads.rb:34
+  def clear; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/autoloads.rb:29
+  def empty?; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/autoloads.rb:9
+  def register(abspath, loader); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/autoloads.rb:14
+  def registered?(path); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/autoloads.rb:19
+  def unregister(abspath); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/autoloads.rb:24
+  def unregister_loader(loader); end
+end
+
+# A registry for explicit namespaces.
+#
+# When a loader determines that a certain file should define an explicit
+# namespace, it registers it here, associating its cref with itself.
+#
+# If the namespace is autoloaded, our const_added callback retrieves its
+# loader by calling loader_for. That way, the loader is able to scan the
+# subdirectories that conform the namespace and set autoloads for their
+# expected constants just in time.
+#
+# Once autoloaded, the namespace is unregistered.
+#
+# The implementation assumes an explicit namespace is managed by one loader.
+# Loaders that reopen namespaces owned by other projects are responsible for
+# loading their constant before setup. This is documented.
+#
+# **This is a private module.**
+#
+# pkg:gem/zeitwerk#lib/zeitwerk/registry/explicit_namespaces.rb:21
+class Zeitwerk::Registry::ExplicitNamespaces
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/explicit_namespaces.rb:23
+  def initialize; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/explicit_namespaces.rb:57
+  def clear; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/explicit_namespaces.rb:40
+  def loader_for(mod, cname); end
+
+  # Registers `cref` as being the constant path of an explicit namespace
+  # managed by `loader`.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/explicit_namespaces.rb:35
+  def register(cref, loader); end
+
+  # This is an internal method only used by the test suite.
+  #
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/explicit_namespaces.rb:52
+  def registered?(cref); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/explicit_namespaces.rb:45
+  def unregister_loader(loader); end
+end
+
+# Loaders know their own inceptions, but there is a use case in which we need
+# to know if a given cpath is an inception globally. This is what this
+# registry is for.
+#
+# pkg:gem/zeitwerk#lib/zeitwerk/registry/inceptions.rb:5
+class Zeitwerk::Registry::Inceptions
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/inceptions.rb:7
+  def initialize; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/inceptions.rb:27
+  def clear; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/inceptions.rb:12
+  def register(cref, abspath); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/inceptions.rb:17
+  def registered?(cref); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/inceptions.rb:22
+  def unregister(cref); end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/registry/loaders.rb:2
+class Zeitwerk::Registry::Loaders
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/loaders.rb:4
+  def initialize; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/loaders.rb:29
+  def clear; end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/loaders.rb:9
+  def each(&block); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/loaders.rb:14
+  def register(loader); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/loaders.rb:24
+  def registered?(loader); end
+
+  # pkg:gem/zeitwerk#lib/zeitwerk/registry/loaders.rb:19
+  def unregister(loader); end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/error.rb:7
+class Zeitwerk::ReloadingDisabledError < ::Zeitwerk::Error
+  # pkg:gem/zeitwerk#lib/zeitwerk/error.rb:9
+  def initialize; end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/error.rb:17
+class Zeitwerk::SetupRequired < ::Zeitwerk::Error
+  # pkg:gem/zeitwerk#lib/zeitwerk/error.rb:19
+  def initialize; end
+end
+
+# pkg:gem/zeitwerk#lib/zeitwerk/version.rb:5
+Zeitwerk::VERSION = T.let(T.unsafe(nil), String)