e621stream 0.0.0

data/sorbet/rbi/gems/console@1.38.0.rbi

@@ -0,0 +1,1552 @@
+# typed: true
+
+# DO NOT EDIT MANUALLY
+# This is an autogenerated file for types exported from the `console` gem.
+# Please instead update this file by running `bin/tapioca gem console`.
+
+
+# @namespace
+# Released under the MIT License.
+# Copyright, 2023-2024, by Samuel Williams.
+# Released under the MIT License.
+# Copyright, 2021-2025, by Samuel Williams.
+# Copyright, 2026, by William T. Nelson.
+# Released under the MIT License.
+# Copyright, 2019-2025, by Samuel Williams.
+# Released under the MIT License.
+# Copyright, 2019-2025, by Samuel Williams.
+# Copyright, 2019, by Bryan Powell.
+# Copyright, 2020, by Michael Adams.
+# Copyright, 2021, by Robert Schulze.
+# Copyright, 2026, by Copilot.
+# Released under the MIT License.
+# Copyright, 2023-2025, by Samuel Williams.
+# Released under the MIT License.
+# Copyright, 2022-2025, by Samuel Williams.
+# Released under the MIT License.
+# Copyright, 2021-2025, by Samuel Williams.
+# Released under the MIT License.
+# Copyright, 2024-2025, by Samuel Williams.
+# Released under the MIT License.
+# Copyright, 2020-2025, by Samuel Williams.
+# Released under the MIT License.
+# Copyright, 2019-2026, by Samuel Williams.
+#
+# pkg:gem/console#lib/console/version.rb:6
+module Console
+  extend ::Console::Interface
+end
+
+# A simple clock utility for tracking and formatting time.
+#
+# pkg:gem/console#lib/console/clock.rb:9
+module Console::Clock
+  class << self
+    # Format a duration in seconds as a human readable string.
+    #
+    # @parameter duration [Numeric] The duration in seconds.
+    # @returns [String] The formatted duration.
+    #
+    # pkg:gem/console#lib/console/clock.rb:14
+    def formatted_duration(duration); end
+
+    # @returns [Time] The current monotonic time.
+    #
+    # pkg:gem/console#lib/console/clock.rb:44
+    def now; end
+  end
+end
+
+# Represents a configuration for the traces library.
+#
+# pkg:gem/console#lib/console/config.rb:14
+class Console::Config
+  # Set the default log level based on `$DEBUG` and `$VERBOSE`.
+  # You can also specify CONSOLE_LEVEL=debug or CONSOLE_LEVEL=info in environment.
+  # https://mislav.net/2011/06/ruby-verbose-mode/ has more details about how it all fits together.
+  #
+  # @parameter env [Hash] The environment to read the log level from.
+  # @returns [Integer | Symbol] The default log level.
+  #
+  # pkg:gem/console#lib/console/config.rb:42
+  def log_level(env = T.unsafe(nil)); end
+
+  # Create a logger with the given output and options.
+  #
+  # @parameter output [IO] The output to write log messages to.
+  # @parameter env [Hash] The environment to read configuration from.
+  # @parameter options [Hash] Additional options to pass to the logger.
+  # @returns [Logger] The created logger.
+  #
+  # pkg:gem/console#lib/console/config.rb:75
+  def make_logger(io = T.unsafe(nil), env = T.unsafe(nil), **options); end
+
+  # Create an output with the given output and options.
+  #
+  # @parameter output [IO] The output to write log messages to.
+  # @parameter env [Hash] The environment to read configuration from.
+  # @parameter options [Hash] Additional options to pass to the output.
+  # @returns [Output] The created output.
+  #
+  # pkg:gem/console#lib/console/config.rb:57
+  def make_output(io = T.unsafe(nil), env = T.unsafe(nil), **options); end
+
+  # Create a resolver with the given logger.
+  #
+  # @parameter logger [Logger] The logger to set the log levels on.
+  # @returns [Resolver | Nil] The created resolver.
+  #
+  # pkg:gem/console#lib/console/config.rb:65
+  def make_resolver(logger); end
+
+  # Controls verbose output using `$VERBOSE`.
+  #
+  # pkg:gem/console#lib/console/config.rb:47
+  def verbose?(env = T.unsafe(nil)); end
+
+  class << self
+    # Load the default configuration.
+    # @returns [Config] The default configuration.
+    #
+    # pkg:gem/console#lib/console/config.rb:32
+    def default; end
+
+    # Load the configuration from the given path.
+    # @parameter path [String] The path to the configuration file.
+    # @returns [Config] The loaded configuration.
+    #
+    # pkg:gem/console#lib/console/config.rb:20
+    def load(path); end
+  end
+end
+
+# Load the default configuration.
+#
+# pkg:gem/console#lib/console/config.rb:94
+Console::Config::DEFAULT = T.let(T.unsafe(nil), Console::Config)
+
+# pkg:gem/console#lib/console/config.rb:15
+Console::Config::PATH = T.let(T.unsafe(nil), String)
+
+# Structured event logging.
+#
+# pkg:gem/console#lib/console/event/generic.rb:7
+module Console::Event; end
+
+# Represents a failure of some kind, usually with an attached exception.
+#
+# ```ruby
+# begin
+# 	raise "Something went wrong!"
+# rescue => exception
+# 	Console::Event::Failure.log("Something went wrong!", exception)
+# end
+# ```
+#
+# Generally, you should use the {Console.error} method to log failures, as it will automatically create a failure event for you.
+#
+# pkg:gem/console#lib/console/event/failure.rb:23
+class Console::Event::Failure < ::Console::Event::Generic
+  # Create a new failure event for the given exception.
+  #
+  # @parameter exception [Exception] The exception to log.
+  # @parameter root [String] The root directory of the project.
+  #
+  # pkg:gem/console#lib/console/event/failure.rb:56
+  def initialize(exception, root = T.unsafe(nil)); end
+
+  # Log the failure event.
+  #
+  # @parameter arguments [Array] The arguments to log.
+  # @parameter options [Hash] Additional options to pass to the logger output.
+  #
+  # pkg:gem/console#lib/console/event/failure.rb:76
+  def emit(*arguments, **options); end
+
+  # @attribute [Exception] The exception which caused the failure.
+  #
+  # pkg:gem/console#lib/console/event/failure.rb:50
+  def exception; end
+
+  # Convert the failure event to a hash.
+  #
+  # @returns [Hash] The hash representation of the failure event.
+  #
+  # pkg:gem/console#lib/console/event/failure.rb:64
+  def to_hash; end
+
+  private
+
+  # pkg:gem/console#lib/console/event/failure.rb:84
+  def extract(exception, hash); end
+
+  class << self
+    # For the purpose of efficiently formatting backtraces, we need to know the root directory of the project.
+    #
+    # @returns [String | Nil] The root directory of the project, or nil if it could not be determined.
+    #
+    # pkg:gem/console#lib/console/event/failure.rb:27
+    def default_root; end
+
+    # Create a new failure event for the given exception.
+    #
+    # @parameter exception [Exception] The exception to log.
+    #
+    # pkg:gem/console#lib/console/event/failure.rb:36
+    def for(exception); end
+
+    # Log a failure event with the given exception.
+    #
+    # @parameter subject [String] The subject of the log message.
+    # @parameter exception [Exception] The exception to log.
+    # @parameter options [Hash] Additional options pass to the logger output.
+    #
+    # pkg:gem/console#lib/console/event/failure.rb:45
+    def log(subject, exception, **options); end
+  end
+end
+
+# A generic event which can be used to represent structured data.
+#
+# pkg:gem/console#lib/console/event/generic.rb:9
+class Console::Event::Generic
+  # Convert the event to a hash suitable for JSON serialization.
+  #
+  # @returns [Hash] The hash representation of the event.
+  #
+  # pkg:gem/console#lib/console/event/generic.rb:20
+  def as_json(*, **, &); end
+
+  # Log the event using the given output interface.
+  #
+  # @parameter arguments [Array] The arguments to log.
+  # @parameter options [Hash] Additional options to pass to the logger output.
+  #
+  # pkg:gem/console#lib/console/event/generic.rb:42
+  def emit(*arguments, **options); end
+
+  # Convert the event to a hash suitable for JSON serialization.
+  #
+  # @returns [Hash] The hash representation of the event.
+  #
+  # pkg:gem/console#lib/console/event/generic.rb:13
+  def to_hash; end
+
+  # Serialize the event to JSON.
+  #
+  # @returns [String] The JSON representation of the event.
+  #
+  # pkg:gem/console#lib/console/event/generic.rb:27
+  def to_json(*, **, &); end
+
+  # Convert the event to a string (JSON).
+  #
+  # @returns [String] The string representation of the event.
+  #
+  # pkg:gem/console#lib/console/event/generic.rb:34
+  def to_s; end
+end
+
+# Represents a child process spawn event.
+#
+# ```ruby
+# Console.info(self, **Console::Event::Spawn.for("ls", "-l"))
+#
+# event = Console::Event::Spawn.for("ls", "-l")
+# event.status = Process.wait
+# ```
+#
+# pkg:gem/console#lib/console/event/spawn.rb:19
+class Console::Event::Spawn < ::Console::Event::Generic
+  # Create a new spawn event.
+  #
+  # @parameter environment [Hash] The environment to use when running the command.
+  # @parameter arguments [Array] The arguments used for command execution.
+  # @parameter options [Hash] The options to pass to the command, similar to how you would pass them to `Kernel.system` or `Process.spawn`.
+  #
+  # pkg:gem/console#lib/console/event/spawn.rb:40
+  def initialize(environment, arguments, options); end
+
+  # Calculate the duration of the command, if it has completed.
+  #
+  # @returns [Numeric] The duration of the command.
+  #
+  # pkg:gem/console#lib/console/event/spawn.rb:71
+  def duration; end
+
+  # Log the spawn event.
+  #
+  # @parameter arguments [Array] The arguments to log.
+  # @parameter options [Hash] Additional options to pass to the logger output.
+  #
+  # pkg:gem/console#lib/console/event/spawn.rb:99
+  def emit(*arguments, **options); end
+
+  # @attribute [Numeric] The end time of the command.
+  #
+  # pkg:gem/console#lib/console/event/spawn.rb:55
+  def end_time; end
+
+  # @attribute [Numeric] The start time of the command.
+  #
+  # pkg:gem/console#lib/console/event/spawn.rb:52
+  def start_time; end
+
+  # @attribute [Process::Status] The status of the command, if it has completed.
+  #
+  # pkg:gem/console#lib/console/event/spawn.rb:58
+  def status; end
+
+  # Set the status of the command, and record the end time.
+  #
+  # @parameter status [Process::Status] The status of the command.
+  #
+  # pkg:gem/console#lib/console/event/spawn.rb:63
+  def status=(status); end
+
+  # Convert the spawn event to a hash suitable for JSON serialization.
+  #
+  # @returns [Hash] The hash representation of the spawn event.
+  #
+  # pkg:gem/console#lib/console/event/spawn.rb:80
+  def to_hash; end
+
+  private
+
+  # pkg:gem/console#lib/console/event/spawn.rb:106
+  def now; end
+
+  class << self
+    # Create a new spawn event.
+    #
+    # @parameter arguments [Array] The arguments to the command, similar to how you would pass them to `Kernel.system` or `Process.spawn`.
+    # @parameter options [Hash] The options to pass to the command, similar to how you would pass them to `Kernel.system` or `Process.spawn`.
+    # @returns [Spawn] The new spawn event representing the command.
+    #
+    # pkg:gem/console#lib/console/event/spawn.rb:25
+    def for(*arguments, **options); end
+  end
+end
+
+# A log filter which can be used to filter log messages based on severity, subject, and other criteria.
+#
+# pkg:gem/console#lib/console/filter.rb:14
+class Console::Filter
+  # Create a new log filter.
+  #
+  # @parameter output [Console::Output] The output destination.
+  # @parameter verbose [Boolean] Enable verbose output.
+  # @parameter level [Integer] The log level.
+  # @parameter options [Hash] Additional options.
+  #
+  # pkg:gem/console#lib/console/filter.rb:78
+  def initialize(output, verbose: T.unsafe(nil), level: T.unsafe(nil), **options); end
+
+  # Enable all logging.
+  #
+  # pkg:gem/console#lib/console/filter.rb:148
+  def all!; end
+
+  # Log a message with the given severity.
+  #
+  # If the severity is not defined in this filter's LEVELS (e.g., when chaining
+  # filters with different severity levels), the message is passed through to the
+  # output without filtering. This allows custom filters to be composed together.
+  #
+  # @parameter subject [Object] The subject of the log message.
+  # @parameter arguments [Array] The arguments to log.
+  # @parameter options [Hash] Additional options to pass to the output.
+  # @parameter block [Proc] A block passed to the output.
+  # @returns [Nil] Always returns nil.
+  #
+  # pkg:gem/console#lib/console/filter.rb:223
+  def call(subject, *arguments, **options, &block); end
+
+  # Clear any specific filters for the given class.
+  #
+  # @parameter subject [Module] The class to disable.
+  #
+  # pkg:gem/console#lib/console/filter.rb:204
+  def clear(subject); end
+
+  # Disable logging for the given class.
+  #
+  # @parameter name [Module] The class to disable.
+  #
+  # pkg:gem/console#lib/console/filter.rb:196
+  def disable(subject); end
+
+  # Enable specific log level for the given class.
+  #
+  # @parameter name [Module] The class to enable.
+  #
+  # pkg:gem/console#lib/console/filter.rb:188
+  def enable(subject, level = T.unsafe(nil)); end
+
+  # Whether logging is enabled for the given subject and log level.
+  #
+  # You can enable and disable logging for classes. This function checks if logging for a given subject is enabled.
+  #
+  # @parameter subject [Module | Object] The subject to check.
+  # @parameter level [Integer] The log level.
+  # @returns [Boolean] Whether logging is enabled.
+  #
+  # pkg:gem/console#lib/console/filter.rb:173
+  def enabled?(subject, level = T.unsafe(nil)); end
+
+  # Filter log messages based on the subject and log level.
+  #
+  # You must provide the subject's class, not an instance of the class.
+  #
+  # @parameter subject [Module] The subject to filter.
+  # @parameter level [Integer] The log level.
+  #
+  # pkg:gem/console#lib/console/filter.rb:158
+  def filter(subject, level); end
+
+  # @attribute [Integer] The current log level.
+  #
+  # pkg:gem/console#lib/console/filter.rb:115
+  def level; end
+
+  # Set the log level.
+  #
+  # @parameter level [Integer | Symbol] The log level.
+  #
+  # pkg:gem/console#lib/console/filter.rb:126
+  def level=(level); end
+
+  # Disable all logging.
+  #
+  # pkg:gem/console#lib/console/filter.rb:143
+  def off!; end
+
+  # @attribute [Hash] Additional options.
+  #
+  # pkg:gem/console#lib/console/filter.rb:121
+  def options; end
+
+  # @attribute [Hash] Additional options.
+  #
+  # pkg:gem/console#lib/console/filter.rb:121
+  def options=(_arg0); end
+
+  # @attribute [Console::Output] The output destination.
+  #
+  # pkg:gem/console#lib/console/filter.rb:109
+  def output; end
+
+  # @attribute [Console::Output] The output destination.
+  #
+  # pkg:gem/console#lib/console/filter.rb:109
+  def output=(_arg0); end
+
+  # @attribute [Hash(Module, Integer)] The log levels for specific subject (classes).
+  #
+  # pkg:gem/console#lib/console/filter.rb:118
+  def subjects; end
+
+  # @attribute [Boolean] Whether to enable verbose output.
+  #
+  # pkg:gem/console#lib/console/filter.rb:112
+  def verbose; end
+
+  # Set verbose output (enable by default with no arguments).
+  #
+  # @parameter value [Boolean] Enable or disable verbose output.
+  #
+  # pkg:gem/console#lib/console/filter.rb:137
+  def verbose!(value = T.unsafe(nil)); end
+
+  # Create a new log filter with the given options, from an existing log filter.
+  #
+  # @parameter level [Integer] The log level.
+  # @parameter verbose [Boolean] Enable verbose output.
+  # @parameter options [Hash] Additional options.
+  # @returns [Console::Filter] The new log filter.
+  #
+  # pkg:gem/console#lib/console/filter.rb:100
+  def with(level: T.unsafe(nil), verbose: T.unsafe(nil), **options); end
+
+  class << self
+    # Create a new log filter with specific log levels.
+    #
+    # ```ruby
+    # class MyLogger < Console::Filter[debug: 0, okay: 1, bad: 2, terrible: 3]
+    # ```
+    #
+    # @parameter levels [Hash(Symbol, Integer)] A hash of log levels.
+    #
+    # pkg:gem/console#lib/console/filter.rb:35
+    def [](**levels); end
+
+    # Define a method.
+    # Define a method which can be shared between ractors.
+    #
+    # pkg:gem/console#lib/console/filter.rb:17
+    def define_immutable_method(name, &block); end
+  end
+end
+
+# @namespace
+#
+# pkg:gem/console#lib/console/format/safe.rb:10
+module Console::Format
+  class << self
+    # A safe format for converting objects to strings.
+    #
+    # @returns [Console::Format::Safe]
+    #
+    # pkg:gem/console#lib/console/format.rb:14
+    def default; end
+  end
+end
+
+# A safe format for converting objects to strings.
+#
+# Handles issues like circular references, encoding errors, excessive nesting depth, and excessive output size.
+#
+# pkg:gem/console#lib/console/format/safe.rb:14
+class Console::Format::Safe
+  # Create a new safe format.
+  #
+  # @parameter format [JSON] The format to use for serialization.
+  # @parameter depth_limit [Integer] The maximum depth to recurse into objects (the JSON `max_nesting`).
+  # @parameter size_limit [Integer | Nil] The maximum byte size of the serialized output, or `nil` to disable size limiting. Limits below {TRUNCATED} (the minimal marker) cannot be honoured.
+  # @parameter encoding [Encoding] The encoding to use for strings.
+  # @parameter limit [Integer | Nil] Deprecated alias for `depth_limit`.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:25
+  def initialize(format: T.unsafe(nil), depth_limit: T.unsafe(nil), size_limit: T.unsafe(nil), encoding: T.unsafe(nil), limit: T.unsafe(nil)); end
+
+  # @attribute [Integer] The maximum depth to recurse into objects.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:38
+  def depth_limit; end
+
+  # Dump the given object to a string.
+  #
+  # The common case is a single fast serialization. If that fails (e.g. circular
+  # references, excessive nesting, or encoding errors) or its output exceeds
+  # {size_limit}, it falls back to {safe_dump}, which rebuilds the record
+  # field-by-field within the limit.
+  #
+  # @parameter object [Object] The object to dump.
+  # @returns [String] The dumped object.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:52
+  def dump(object); end
+
+  # @attribute [Integer | Nil] The maximum byte size of the serialized output.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:41
+  def size_limit; end
+
+  private
+
+  # Create a new hash with identity comparison.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:227
+  def default_objects; end
+
+  # Serialize a single top-level `"key":value` pair, safely handling values that
+  # cannot be serialized directly.
+  #
+  # @parameter key [Object] The field key.
+  # @parameter value [Object] The field value.
+  # @returns [Array(String, Exception | Nil)] The `"key":value` fragment and the error, if recovery was needed.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:149
+  def dump_pair(key, value); end
+
+  # Serialize a string as a JSON string, encoding it safely first.
+  #
+  # @parameter value [String] The string to serialize.
+  # @returns [String] The serialized (quoted) string.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:169
+  def dump_string(value); end
+
+  # Serialize a single value, falling back to a safe representation on failure.
+  #
+  # @parameter value [Object] The value to serialize.
+  # @returns [Array(String, Exception | Nil)] The serialized value and the error, if recovery was needed.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:159
+  def dump_value(value); end
+
+  # Build a safe, primitive representation of an error for inclusion as an `"error"` field.
+  #
+  # @parameter error [Exception] The error that occurred while dumping the object.
+  # @returns [Hash] The error details (class, message, filtered backtrace).
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:218
+  def error_info(error); end
+
+  # Filter the backtrace to remove duplicate frames and reduce verbosity.
+  #
+  # @parameter error [Exception] The exception to filter.
+  # @returns [Array(String)] The filtered backtrace.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:177
+  def filter_backtrace(error); end
+
+  # Produce a safe, size-limited serialization of the given object. This is the
+  # fallback path, used both when direct serialization fails (an exception) and
+  # when its output exceeds {size_limit}.
+  #
+  # Each top-level value is serialized independently and defensively, so a single
+  # un-serializable or oversized value cannot break or bloat the whole record.
+  # Whenever a field is degraded, the reason is recorded in a trailing `"truncated"`
+  # object that maps the field name to why it was truncated:
+  #
+  # - `"key": true` — the value was dropped because it did not fit the size limit.
+  # - `"key": {error}` — the value could not be serialized directly; a safe
+  #   representation was kept in its place and the triggering error is recorded.
+  #
+  # Fields are kept while they fit, always reserving room for at least a minimal
+  # `"truncated":true` marker. The detailed reason map is then emitted only if it
+  # fits in the remaining space; otherwise it degrades to `"truncated":true`. This
+  # is best-effort — in the worst case the per-field detail is lost — but it keeps
+  # the bookkeeping simple and the size guarantee hard.
+  #
+  # @parameter object [Object] The object to serialize.
+  # @returns [String] The safe, size-limited serialized record.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:87
+  def safe_dump(object); end
+
+  # This will recursively generate a safe version of the object. Nested hashes and arrays will be transformed recursively. Strings will be encoded with the given encoding. Primitive values will be returned as-is. Other values will be converted using `as_json` if available, otherwise `to_s`.
+  #
+  # @parameter object [Object] The object to dump.
+  # @parameter limit [Integer] The maximum depth to recurse into objects.
+  # @parameter objects [Hash] The objects that have already been visited.
+  # @returns [Object] The dumped object as a primitive representation.
+  #
+  # pkg:gem/console#lib/console/format/safe.rb:237
+  def safe_dump_recurse(object, limit = T.unsafe(nil), objects = T.unsafe(nil)); end
+end
+
+# The JSON fragment used as the truncation marker when dropped fields cannot be named.
+#
+# pkg:gem/console#lib/console/format/safe.rb:16
+Console::Format::Safe::TRUNCATED = T.let(T.unsafe(nil), String)
+
+# The public logger interface.
+#
+# pkg:gem/console#lib/console/interface.rb:11
+module Console::Interface
+  extend ::Fiber::Local
+
+  # Emit a log message with arbitrary arguments and options.
+  #
+  # pkg:gem/console#lib/console/interface.rb:57
+  def call(*, **, &); end
+
+  # Emit a debug log message.
+  #
+  # pkg:gem/console#lib/console/interface.rb:32
+  def debug(*, **, &); end
+
+  # Emit an error log message.
+  #
+  # pkg:gem/console#lib/console/interface.rb:47
+  def error(*, **, &); end
+
+  # Emit a fatal log message.
+  #
+  # pkg:gem/console#lib/console/interface.rb:52
+  def fatal(*, **, &); end
+
+  # Emit an informational log message.
+  #
+  # pkg:gem/console#lib/console/interface.rb:37
+  def info(*, **, &); end
+
+  # Get the current logger instance.
+  #
+  # pkg:gem/console#lib/console/interface.rb:20
+  def logger; end
+
+  # Set the current logger instance.
+  #
+  # The current logger instance is assigned per-fiber.
+  #
+  # pkg:gem/console#lib/console/interface.rb:27
+  def logger=(instance); end
+
+  # Emit a warning log message.
+  #
+  # pkg:gem/console#lib/console/interface.rb:42
+  def warn(*, **, &); end
+
+  class << self
+    # pkg:gem/console#lib/console/interface.rb:12
+    def fiber_local_attribute_name; end
+
+    # Create a new (thread local) logger instance.
+    #
+    # pkg:gem/console#lib/console/interface.rb:15
+    def local; end
+  end
+end
+
+# The standard logger interface with support for log levels and verbosity.
+#
+# The log levels are: `debug`, `info`, `warn`, `error`, and `fatal`.
+#
+# pkg:gem/console#lib/console/logger.rb:20
+class Console::Logger < ::Console::Filter
+  # Create a new logger.
+  #
+  # @parameter output [Console::Output] The output destination.
+  # @parameter options [Hash] Additional options.
+  #
+  # pkg:gem/console#lib/console/logger.rb:47
+  def initialize(output, **options); end
+
+  # Create a progress indicator for the given subject.
+  #
+  # @parameter subject [String] The subject of the progress indicator.
+  # @parameter total [Integer] The total number of items to process.
+  # @parameter options [Hash] Additional options passed to {Progress}.
+  # @returns [Progress] The progress indicator.
+  #
+  # pkg:gem/console#lib/console/logger.rb:60
+  def progress(subject, total, **options); end
+
+  class << self
+    # Set the default log level based on `$DEBUG` and `$VERBOSE`.
+    # You can also specify CONSOLE_LEVEL=debug or CONSOLE_LEVEL=info in environment.
+    # https://mislav.net/2011/06/ruby-verbose-mode/ has more details about how it all fits together.
+    #
+    # @parameter env [Hash] The environment to read the log level from.
+    # @parameter verbose [Boolean] The verbose flag.
+    # @parameter debug [Boolean] The debug flag.
+    # @returns [Integer] The default log level.
+    #
+    # pkg:gem/console#lib/console/logger.rb:29
+    def default_log_level(env = T.unsafe(nil), verbose: T.unsafe(nil), debug: T.unsafe(nil)); end
+  end
+end
+
+# pkg:gem/console#lib/console/logger.rb:41
+Console::Logger::DEFAULT_LEVEL = T.let(T.unsafe(nil), Integer)
+
+# Output handling.
+#
+# pkg:gem/console#lib/console/output/terminal.rb:16
+module Console::Output
+  class << self
+    # Create a new output based on the environment.
+    #
+    # The environment variable `CONSOLE_OUTPUT` can be used to specify a list of output classes to wrap around the output. If not specified the {Default} output is used.
+    #
+    # The output argument is deliberately unders-specified but can be an IO object or an instance of {Output}.
+    #
+    # @parameter output [Console::Output] The output to wrap OR an IO object.
+    # @parameter env [Hash] The environment to read configuration from.
+    # @parameter options [Hash] Additional options to customize the output.
+    # @returns [Console::Output] The output instance.
+    #
+    # pkg:gem/console#lib/console/output.rb:24
+    def new(output = T.unsafe(nil), env = T.unsafe(nil), **options); end
+  end
+end
+
+# Default output format selection.
+#
+# pkg:gem/console#lib/console/output/default.rb:13
+module Console::Output::Default
+  class << self
+    # Detect if we're running in GitHub Actions, where human-readable output is preferred.
+    # GitHub Actions sets the GITHUB_ACTIONS environment variable to "true".
+    #
+    # pkg:gem/console#lib/console/output/default.rb:46
+    def github_actions?(env = T.unsafe(nil)); end
+
+    # Detect if we're running in a cron job or mail context where human-readable output is preferred.
+    # Cron jobs often have MAILTO set and lack TERM, or have minimal TERM values.
+    #
+    # pkg:gem/console#lib/console/output/default.rb:40
+    def mail?(env = T.unsafe(nil)); end
+
+    # Create a new output format based on the given stream.
+    #
+    # @parameter io [IO] The output stream.
+    # @parameter env [Hash] Environment variables (defaults to ENV for testing).
+    # @parameter options [Hash] Additional options to customize the output.
+    # @returns [Console::Output::Terminal | Console::Output::Serialized] The output instance, depending on whether the `io` is a terminal or not.
+    #
+    # pkg:gem/console#lib/console/output/default.rb:20
+    def new(stream, env: T.unsafe(nil), **options); end
+  end
+end
+
+# A wrapper for outputting failure messages, which can include exceptions.
+#
+# pkg:gem/console#lib/console/output/failure.rb:12
+class Console::Output::Failure < ::Console::Output::Wrapper
+  # Create a new failure output wrapper.
+  #
+  # pkg:gem/console#lib/console/output/failure.rb:14
+  def initialize(output, **options); end
+
+  # The exception must be either the last argument or passed as an option.
+  #
+  # @parameter subject [String] The subject of the message.
+  # @parameter arguments [Array] The arguments to output.
+  # @parameter exception [Exception] The exception to output.
+  # @parameter options [Hash] Additional options to pass to the output.
+  # @parameter block [Proc] An optional block to pass to the output.
+  #
+  # pkg:gem/console#lib/console/output/failure.rb:25
+  def call(subject = T.unsafe(nil), *arguments, exception: T.unsafe(nil), **options, &block); end
+end
+
+# @deprecated This is a legacy constant, please use `Serialized` instead.
+#
+# pkg:gem/console#lib/console/output/serialized.rb:100
+Console::Output::JSON = Console::Output::Serialized
+
+# A null output that does nothing.
+#
+# pkg:gem/console#lib/console/output/null.rb:9
+class Console::Output::Null
+  # Create a new null output.
+  #
+  # pkg:gem/console#lib/console/output/null.rb:11
+  def initialize(*, **, &); end
+
+  # Do nothing.
+  #
+  # pkg:gem/console#lib/console/output/null.rb:20
+  def call(*, **, &); end
+
+  # The last output is always self.
+  #
+  # pkg:gem/console#lib/console/output/null.rb:15
+  def last_output; end
+end
+
+# Serialize log messages in a structured format.
+#
+# pkg:gem/console#lib/console/output/serialized.rb:13
+class Console::Output::Serialized
+  # Create a new serialized output.
+  #
+  # @parameter io [IO] The output stream.
+  # @parameter format [Console::Format] The format to use for serializing log messages.
+  # @parameter options [Hash] Additional options to customize the output.
+  #
+  # pkg:gem/console#lib/console/output/serialized.rb:19
+  def initialize(stream, format: T.unsafe(nil), **options); end
+
+  # Output the given log message.
+  #
+  # @parameter subject [String] The subject of the log message.
+  # @parameter arguments [Array] The arguments to log.
+  # @parameter severity [Symbol] The severity of the log message.
+  # @parameter options [Hash] Additional options.
+  # @parameter block [Proc] An optional block used to generate the log message.
+  #
+  # pkg:gem/console#lib/console/output/serialized.rb:50
+  def call(subject = T.unsafe(nil), *arguments, severity: T.unsafe(nil), **options, &block); end
+
+  # Serialize the given record.
+  #
+  # @parameter record [Hash] The record to serialize.
+  # @returns [String] The serialized record.
+  #
+  # pkg:gem/console#lib/console/output/serialized.rb:39
+  def dump(record); end
+
+  # @attribute [Console::Format] The format to use for serializing log messages.
+  #
+  # pkg:gem/console#lib/console/output/serialized.rb:33
+  def format; end
+
+  # This a final output that then writes to an IO object.
+  #
+  # pkg:gem/console#lib/console/output/serialized.rb:25
+  def last_output; end
+
+  # @attribute [IO] The output stream.
+  #
+  # pkg:gem/console#lib/console/output/serialized.rb:30
+  def stream; end
+end
+
+# Represents a terminal output, and formats log messages for display.
+#
+# pkg:gem/console#lib/console/output/terminal.rb:18
+class Console::Output::Terminal
+  # Create a new terminal output.
+  #
+  # @parameter stream [IO] The output stream.
+  # @parameter verbose [Boolean] Whether to print verbose output.
+  # @parameter start_at [Time] The start time of the terminal output.
+  # @parameter format [Console::Terminal::Format] The format to use for terminal output.
+  # @parameter options [Hash] Additional options to customize the output.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:72
+  def initialize(stream, verbose: T.unsafe(nil), start_at: T.unsafe(nil), format: T.unsafe(nil), **options); end
+
+  # Log a message with the given severity.
+  #
+  # @parameter subject [String] The subject of the log message.
+  # @parameter arguments [Array] The arguments to log.
+  # @parameter name [String | Nil] The optional name of the log message, used as a prefix, otherwise defaults to the severity name.
+  # @parameter severity [Symbol] The severity of the log message.
+  # @parameter event [Hash] The event to log.
+  # @parameter options [Hash] Additional options.
+  # @yields {|buffer, terminal| ...} An optional block used to generate the log message.
+  # 	@parameter buffer [Console::Output::Terminal::Buffer] The output buffer.
+  # 	@parameter terminal [Console::Terminal] The terminal instance.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:145
+  def call(subject = T.unsafe(nil), *arguments, name: T.unsafe(nil), severity: T.unsafe(nil), event: T.unsafe(nil), **options, &block); end
+
+  # This a final output.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:100
+  def last_output; end
+
+  # Register all formatters in the given namespace.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:124
+  def register_formatters(namespace = T.unsafe(nil)); end
+
+  # @attribute [Time] The start time of the terminal output.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:111
+  def start; end
+
+  # @attribute [IO] The output stream.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:105
+  def stream; end
+
+  # @attribute [Console::Terminal::Format] The format to use for terminal output.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:114
+  def terminal; end
+
+  # @attribute [Boolean] Whether to print verbose output.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:108
+  def verbose; end
+
+  # Set the verbose output.
+  #
+  # @parameter value [Boolean] Whether to print verbose output.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:119
+  def verbose!(value = T.unsafe(nil)); end
+
+  # @attribute [Boolean] Whether to print verbose output.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:108
+  def verbose=(_arg0); end
+
+  protected
+
+  # pkg:gem/console#lib/console/output/terminal.rb:275
+  def build_prefix(name); end
+
+  # pkg:gem/console#lib/console/output/terminal.rb:212
+  def default_suffix(object = T.unsafe(nil)); end
+
+  # pkg:gem/console#lib/console/output/terminal.rb:196
+  def format_argument(argument, output); end
+
+  # pkg:gem/console#lib/console/output/terminal.rb:181
+  def format_event(event, buffer, width); end
+
+  # pkg:gem/console#lib/console/output/terminal.rb:238
+  def format_object_subject(severity, prefix, subject, output); end
+
+  # pkg:gem/console#lib/console/output/terminal.rb:192
+  def format_options(options, output); end
+
+  # pkg:gem/console#lib/console/output/terminal.rb:250
+  def format_string_subject(severity, prefix, subject, output); end
+
+  # pkg:gem/console#lib/console/output/terminal.rb:202
+  def format_subject(severity, prefix, subject, buffer); end
+
+  # pkg:gem/console#lib/console/output/terminal.rb:262
+  def format_value(value, output); end
+
+  # pkg:gem/console#lib/console/output/terminal.rb:271
+  def time_offset_prefix; end
+
+  class << self
+    # Exports CONSOLE_START_AT which can be used to synchronize the start times of all child processes when they log using delta time.
+    #
+    # pkg:gem/console#lib/console/output/terminal.rb:52
+    def start_at!(env = T.unsafe(nil)); end
+  end
+end
+
+# Represents an output buffer that formats lines with a prefix.
+#
+# pkg:gem/console#lib/console/output/terminal.rb:20
+class Console::Output::Terminal::Buffer < ::StringIO
+  # Create a new buffer with the given prefix.
+  #
+  # @parameter prefix [String] The prefix to use for each line.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:24
+  def initialize(prefix = T.unsafe(nil)); end
+
+  # Write a line to the buffer.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:45
+  def <<(*lines, prefix: T.unsafe(nil)); end
+
+  # @attribute [String] The prefix to use for each line.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:31
+  def prefix; end
+
+  # Write lines using the given prefix.
+  #
+  # @parameter lines [Array] The lines to write.
+  # @parameter prefix [String] The prefix to use for each line.
+  #
+  # pkg:gem/console#lib/console/output/terminal.rb:37
+  def puts(*lines, prefix: T.unsafe(nil)); end
+end
+
+# The environment variable used to store the start time of the console terminal output.
+#
+# pkg:gem/console#lib/console/output/terminal.rb:49
+Console::Output::Terminal::CONSOLE_START_AT = T.let(T.unsafe(nil), String)
+
+# The default severity for log messages, if not specified.
+#
+# pkg:gem/console#lib/console/output/terminal.rb:132
+Console::Output::Terminal::UNKNOWN = T.let(T.unsafe(nil), Symbol)
+
+# Terminal text output.
+#
+# pkg:gem/console#lib/console/output/terminal.rb:285
+module Console::Output::Text
+  class << self
+    # Create a new terminal output.
+    #
+    # @parameter output [IO] The output stream.
+    # @parameter options [Hash] Additional options to customize the output.
+    # @returns [Console::Output::Terminal] The terminal output instance.
+    #
+    # pkg:gem/console#lib/console/output/terminal.rb:291
+    def new(output, **options); end
+  end
+end
+
+# A generic wrapper for output handling.
+#
+# pkg:gem/console#lib/console/output/wrapper.rb:9
+class Console::Output::Wrapper
+  # Create a new wrapper output.
+  #
+  # @parameter delegate [Console::Output] The output to delegate to.
+  # @parameter options [Hash] Additional options to customize the output.
+  #
+  # pkg:gem/console#lib/console/output/wrapper.rb:14
+  def initialize(delegate, **options); end
+
+  # Invoke the delegate.
+  #
+  # pkg:gem/console#lib/console/output/wrapper.rb:34
+  def call(*, **, &); end
+
+  # @attribute [Console::Output] The output to delegate to.
+  #
+  # pkg:gem/console#lib/console/output/wrapper.rb:19
+  def delegate; end
+
+  # The last output is the last output of the delegate.
+  #
+  # pkg:gem/console#lib/console/output/wrapper.rb:22
+  def last_output; end
+
+  # Set the verbose flag for the delegate.
+  #
+  # @parameter value [Boolean] The new value.
+  #
+  # pkg:gem/console#lib/console/output/wrapper.rb:29
+  def verbose!(value = T.unsafe(nil)); end
+end
+
+# Terminal XTerm output.
+#
+# pkg:gem/console#lib/console/output/terminal.rb:297
+module Console::Output::XTerm
+  class << self
+    # Create a new terminal output.
+    #
+    # You can use this to force XTerm output on a non-TTY output streams that support XTerm escape codes.
+    #
+    # @parameter output [IO] The output stream.
+    # @parameter options [Hash] Additional options to customize the output.
+    # @returns [Console::Output::Terminal] The terminal output instance.
+    #
+    # pkg:gem/console#lib/console/output/terminal.rb:305
+    def new(output, **options); end
+  end
+end
+
+# A simple progress indicator
+#
+# pkg:gem/console#lib/console/progress.rb:11
+class Console::Progress
+  # Create a new progress indicator.
+  #
+  # @parameter subject [Object] The subject of the progress indicator.
+  # @parameter total [Integer] The total number of steps.
+  # @parameter logger [Console::Logger] The logger to use for output.
+  # @parameter minimum_output_duration [Numeric] The minimum duration between outputs.
+  # @parameter options [Hash] Additional options to customize the output.
+  #
+  # pkg:gem/console#lib/console/progress.rb:24
+  def initialize(subject, total = T.unsafe(nil), logger: T.unsafe(nil), minimum_output_duration: T.unsafe(nil), **options); end
+
+  # @returns [Numeric | Nil] The average duration per step, or `nil` if no steps have been completed.
+  #
+  # pkg:gem/console#lib/console/progress.rb:71
+  def average_duration; end
+
+  # @attribute [Numeric] The current number of steps completed.
+  #
+  # pkg:gem/console#lib/console/progress.rb:48
+  def current; end
+
+  # @returns [Numeric] The duration since the progress indicator was started.
+  #
+  # pkg:gem/console#lib/console/progress.rb:54
+  def duration; end
+
+  # @returns [Numeric | Nil] The estimated remaining time, or `nil` if no steps have been completed.
+  #
+  # pkg:gem/console#lib/console/progress.rb:78
+  def estimated_remaining_time; end
+
+  # Increment the progress indicator by the given amount.
+  #
+  # @parameter amount [Numeric] The amount to increment by.
+  # @returns [Progress] The progress indicator itself.
+  #
+  # pkg:gem/console#lib/console/progress.rb:102
+  def increment(amount = T.unsafe(nil)); end
+
+  # Augment the progress indicator with additional information.
+  #
+  # @parameter *arguments [Array] The arguments to log.
+  # @parameter **options [Hash] Additional options to log.
+  # @parameter &block [Proc] An optional block used to generate the log message.
+  #
+  # pkg:gem/console#lib/console/progress.rb:131
+  def mark(*arguments, **options, &block); end
+
+  # @attribute [Numeric] The minimum duration between outputs.
+  #
+  # pkg:gem/console#lib/console/progress.rb:42
+  def minimum_output_duration; end
+
+  # @returns [Rational] The ratio of steps completed to total steps.
+  #
+  # pkg:gem/console#lib/console/progress.rb:59
+  def ratio; end
+
+  # @returns [Numeric] The number of steps remaining.
+  #
+  # pkg:gem/console#lib/console/progress.rb:66
+  def remaining; end
+
+  # Resize the progress indicator to the given total.
+  #
+  # @parameter total [Numeric] The new total number of steps.
+  # @returns [Progress] The progress indicator itself.
+  #
+  # pkg:gem/console#lib/console/progress.rb:117
+  def resize(total); end
+
+  # @attribute [Time] The time the progress indicator was started.
+  #
+  # pkg:gem/console#lib/console/progress.rb:45
+  def start_time; end
+
+  # @attribute [Object] The subject of the progress indicator.
+  #
+  # pkg:gem/console#lib/console/progress.rb:39
+  def subject; end
+
+  # Generate an appropriate event for the progress indicator.
+  #
+  # @returns [Hash] The progress indicator as a hash.
+  #
+  # pkg:gem/console#lib/console/progress.rb:87
+  def to_hash; end
+
+  # @returns [String] A human-readable representation of the progress indicator.
+  #
+  # pkg:gem/console#lib/console/progress.rb:136
+  def to_s; end
+
+  # @attribute [Numeric] The total number of steps.
+  #
+  # pkg:gem/console#lib/console/progress.rb:51
+  def total; end
+
+  private
+
+  # Compute a time delta since the last output, used for rate limiting the output.
+  #
+  # @returns [Numeric | Nil] The duration since the last output.
+  #
+  # pkg:gem/console#lib/console/progress.rb:149
+  def duration_since_last_output; end
+
+  # Whether an output should be generated at this time, taking into account the remaining steps, and the duration since the last output.
+  #
+  # @returns [Boolean] Whether an output should be generated.
+  #
+  # pkg:gem/console#lib/console/progress.rb:158
+  def output?; end
+
+  class << self
+    # @deprecated Use {Clock.now} instead.
+    #
+    # pkg:gem/console#lib/console/progress.rb:13
+    def now; end
+  end
+end
+
+# Represents a class resolver that can be used to set log levels for different classes as they become available.
+#
+# pkg:gem/console#lib/console/resolver.rb:11
+class Console::Resolver
+  # Create a new class resolver.
+  #
+  # pkg:gem/console#lib/console/resolver.rb:63
+  def initialize; end
+
+  # Bind the given class names to the given block. When the class name is resolved into an actual class, the block will be called with the class as an argument.
+  #
+  # If the class is already defined, the block will be called immediately.
+  #
+  # If the class is not defined, the block will be called when the class is defined, using a trace point.
+  #
+  # @parameter names [Array(String)] The class names to bind.
+  # @parameter block [Proc] The block to call when the class is resolved.
+  #
+  # pkg:gem/console#lib/console/resolver.rb:77
+  def bind(names, &block); end
+
+  # Invoked by the trace point when a class is defined.
+  #
+  # This will call the block associated with the class name, if any, and remove it from the list of names to resolve.
+  #
+  # If the list of names is empty, the trace point will be disabled.
+  #
+  # @parameter trace_point [TracePoint] The trace point that triggered the event.
+  #
+  # pkg:gem/console#lib/console/resolver.rb:105
+  def resolve(trace_point); end
+
+  # @parameter klass [Class] The class that was resolved.
+  #
+  # pkg:gem/console#lib/console/resolver.rb:110
+  def resolve_class(klass); end
+
+  # @returns [Boolean] True if the resolver is waiting for classes to be defined.
+  #
+  # pkg:gem/console#lib/console/resolver.rb:94
+  def waiting?; end
+
+  class << self
+    # You can change the log level for different classes using CONSOLE_$LEVEL env vars.
+    #
+    # e.g. `CONSOLE_WARN=Acorn,Banana CONSOLE_DEBUG=Cat` will set the log level for the classes Acorn and Banana to `warn` and Cat to `debug`. This overrides the default log level.
+    #
+    # You can enable all log levels for a given class by using `CONSOLE_ON=MyClass`. Similarly you can disable all logging using `CONSOLE_OFF=MyClass`.
+    #
+    # @parameter logger [Logger] A logger instance to set the logging levels on.
+    # @parameter env [Hash] The environment to read levels from.
+    # @returns [Nil] If there were no custom logging levels specified in the environment.
+    # @returns [Resolver] If there were custom logging levels, then the created resolver is returned.
+    #
+    # pkg:gem/console#lib/console/resolver.rb:22
+    def default_resolver(logger, env = T.unsafe(nil)); end
+  end
+end
+
+# Styled terminal output.
+#
+# pkg:gem/console#lib/console/terminal/text.rb:11
+module Console::Terminal
+  class << self
+    # Create a new terminal output for the given stream.
+    #
+    # pkg:gem/console#lib/console/terminal.rb:13
+    def for(stream); end
+  end
+end
+
+# Formatters for various types of events.
+#
+# pkg:gem/console#lib/console/terminal/formatter/progress.rb:8
+module Console::Terminal::Formatter; end
+
+# Format a failure event, including the exception message and backtrace.
+#
+# pkg:gem/console#lib/console/terminal/formatter/failure.rb:10
+class Console::Terminal::Formatter::Failure
+  # Create a new failure formatter.
+  #
+  # @param terminal [Terminal::Text] The terminal to use for formatting.
+  #
+  # pkg:gem/console#lib/console/terminal/formatter/failure.rb:17
+  def initialize(terminal); end
+
+  # Format the given event.
+  #
+  # @parameter event [Hash] The event to format.
+  # @parameter stream [IO] The stream to write the formatted event to.
+  # @parameter prefix [String] The prefix to use before the title.
+  # @parameter verbose [Boolean] Whether to include additional information.
+  # @parameter options [Hash] Additional options.
+  #
+  # pkg:gem/console#lib/console/terminal/formatter/failure.rb:34
+  def format(event, stream, prefix: T.unsafe(nil), verbose: T.unsafe(nil), **options); end
+end
+
+# The key used to identify this formatter.
+#
+# pkg:gem/console#lib/console/terminal/formatter/failure.rb:12
+Console::Terminal::Formatter::Failure::KEY = T.let(T.unsafe(nil), Symbol)
+
+# Format a progress event, including the current progress and total.
+#
+# pkg:gem/console#lib/console/terminal/formatter/progress.rb:10
+class Console::Terminal::Formatter::Progress
+  # Create a new progress formatter.
+  #
+  # @param terminal [Terminal::Text] The terminal to use for formatting.
+  #
+  # pkg:gem/console#lib/console/terminal/formatter/progress.rb:30
+  def initialize(terminal); end
+
+  # Format the given event.
+  #
+  # @parameter event [Hash] The event to format.
+  # @parameter stream [IO] The stream to write the formatted event to.
+  # @parameter verbose [Boolean] Whether to include additional information.
+  # @parameter width [Integer] The width of the progress bar.
+  #
+  # pkg:gem/console#lib/console/terminal/formatter/progress.rb:41
+  def format(event, stream, verbose: T.unsafe(nil), width: T.unsafe(nil)); end
+
+  private
+
+  # Render a progress bar with the given value and width.
+  #
+  # pkg:gem/console#lib/console/terminal/formatter/progress.rb:55
+  def bar(value, width); end
+end
+
+# The block characters used to render the progress bar.
+#
+# pkg:gem/console#lib/console/terminal/formatter/progress.rb:15
+Console::Terminal::Formatter::Progress::BLOCK = T.let(T.unsafe(nil), Array)
+
+# The key used to identify this formatter.
+#
+# pkg:gem/console#lib/console/terminal/formatter/progress.rb:12
+Console::Terminal::Formatter::Progress::KEY = T.let(T.unsafe(nil), Symbol)
+
+# Format a spawn event, including the command and arguments.
+#
+# pkg:gem/console#lib/console/terminal/formatter/spawn.rb:10
+class Console::Terminal::Formatter::Spawn
+  # Create a new spawn formatter.
+  #
+  # @param terminal [Terminal::Text] The terminal to use for formatting.
+  #
+  # pkg:gem/console#lib/console/terminal/formatter/spawn.rb:17
+  def initialize(terminal); end
+
+  # Format the given event.
+  #
+  # @parameter event [Hash] The event to format.
+  # @parameter stream [IO] The stream to write the formatted event to.
+  # @parameter verbose [Boolean] Whether to include additional information.
+  # @parameter width [Integer] The width of the progress bar.
+  #
+  # pkg:gem/console#lib/console/terminal/formatter/spawn.rb:28
+  def format(event, stream, verbose: T.unsafe(nil), width: T.unsafe(nil)); end
+
+  private
+
+  # Generate a string to represent the working directory.
+  #
+  # pkg:gem/console#lib/console/terminal/formatter/spawn.rb:45
+  def chdir_string(options); end
+end
+
+# The key used to identify this formatter.
+#
+# pkg:gem/console#lib/console/terminal/formatter/spawn.rb:12
+Console::Terminal::Formatter::Spawn::KEY = T.let(T.unsafe(nil), Symbol)
+
+# A simple text-based terminal output.
+#
+# pkg:gem/console#lib/console/terminal/text.rb:13
+class Console::Terminal::Text
+  # Create a new text terminal output.
+  #
+  # @parameter stream [IO] The stream to write to.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:17
+  def initialize(stream); end
+
+  # Get the style associated with the given key.
+  #
+  # @parameter key [Symbol] The key to look up.
+  # @returns [String] The style associated with the key.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:29
+  def [](key); end
+
+  # Set the style associated with the given key.
+  #
+  # @parameter key [Symbol] The key to associate the style with.
+  # @parameter value [String] The style to associate with the key.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:37
+  def []=(key, value); end
+
+  # @returns [Boolean] Whether the terminal supports colors.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:42
+  def colors?; end
+
+  # Print rich text to the output stream.
+  #
+  # - When the argument is a symbol, look up the style and inject it into the output stream.
+  # - When the argument is a proc/lambda, call it with self as the argument.
+  # - When the argument is anything else, write it directly to the output.
+  #
+  # @parameter arguments [Array] The arguments to print.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:107
+  def print(*arguments); end
+
+  # Print rich text to the output stream, followed by the reset sequence and a newline.
+  #
+  # @parameter arguments [Array] The arguments to print.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:123
+  def print_line(*arguments); end
+
+  # Write the given arguments to the output stream using the given style. The reset sequence is automatically
+  # appended at the end of each line.
+  #
+  # @parameter arguments [Array] The arguments to write, each on a new line.
+  # @parameter style [Symbol] The style to apply.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:87
+  def puts(*arguments, style: T.unsafe(nil)); end
+
+  # Generate a reset sequence.
+  #
+  # @returns [String | Nil] The reset sequence if colors are supported, otherwise nil.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:65
+  def reset; end
+
+  # @returns [Tuple(Integer, Integer)] The size of the terminal, or a default value of [24, 80].
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:47
+  def size; end
+
+  # @attribute [IO] The stream to write to.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:23
+  def stream; end
+
+  # Generate a style string for the given foreground, background, and attributes.
+  #
+  # @returns [String | Nil] The style string if colors are supported, otherwise nil.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:59
+  def style(foreground, background = T.unsafe(nil), *attributes); end
+
+  # @returns [Integer] The width of the terminal.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:52
+  def width; end
+
+  # Write the given arguments to the output stream using the given style. The reset sequence is automatically appended.
+  #
+  # @parameter arguments [Array] The arguments to write.
+  # @parameter style [Symbol] The style to apply.
+  #
+  # pkg:gem/console#lib/console/terminal/text.rb:72
+  def write(*arguments, style: T.unsafe(nil)); end
+end
+
+# XTerm style terminal output.
+#
+# pkg:gem/console#lib/console/terminal/xterm.rb:14
+class Console::Terminal::XTerm < ::Console::Terminal::Text
+  # Whether the terminal supports colors.
+  #
+  # pkg:gem/console#lib/console/terminal/xterm.rb:42
+  def colors?; end
+
+  # Reset the style.
+  #
+  # @returns [String] The reset code.
+  #
+  # pkg:gem/console#lib/console/terminal/xterm.rb:86
+  def reset; end
+
+  # The size of the terminal.
+  #
+  # pkg:gem/console#lib/console/terminal/xterm.rb:47
+  def size; end
+
+  # Apply the given style to the output.
+  #
+  # @parameter foreground [Symbol] The foreground color.
+  # @parameter background [Symbol] The background color.
+  # @parameter attributes [Array(Symbol)] The attributes to apply.
+  # @returns [String] The style code.
+  #
+  # pkg:gem/console#lib/console/terminal/xterm.rb:65
+  def style(foreground, background = T.unsafe(nil), *attributes); end
+
+  # The width of the terminal.
+  #
+  # pkg:gem/console#lib/console/terminal/xterm.rb:55
+  def width; end
+end
+
+# XTerm attribute codes.
+#
+# pkg:gem/console#lib/console/terminal/xterm.rb:29
+Console::Terminal::XTerm::ATTRIBUTES = T.let(T.unsafe(nil), Hash)
+
+# XTerm color codes.
+#
+# pkg:gem/console#lib/console/terminal/xterm.rb:16
+Console::Terminal::XTerm::COLORS = T.let(T.unsafe(nil), Hash)
+
+# pkg:gem/console#lib/console/filter.rb:11
+Console::UNKNOWN = T.let(T.unsafe(nil), Symbol)
+
+# pkg:gem/console#lib/console/version.rb:7
+Console::VERSION = T.let(T.unsafe(nil), String)