Ship RBS signatures for downstream consumers

Previously only sig/http.rbs was packaged, but it references
`LLHttp::Parser` and `LLHttp::Delegate` (via HTTP::Response::Parser),
which were defined only in the unshipped sig/deps.rbs. Consumers using
`library "http"` in Steep hit `Cannot find type LLHttp::Delegate` errors
when loading http.rbs.

* Extract public LLHttp stubs from sig/deps.rbs into sig/llhttp.rbs.
  These belong in the shipped signatures because they appear in the
  public API surface.
* Add sig/manifest.yaml declaring stdlib dependencies (base64, digest,
  forwardable, openssl, pathname, securerandom, singleton, tempfile,
  time, timeout, uri, zlib) so consumers don't need to re-list them.
* Include sig/llhttp.rbs and sig/manifest.yaml in gemspec extras.
* Keep sig/deps.rbs (Addressable, stdlib overrides, Numeric/IO
  supplements) as dev-only.

Author: sferik

Gemfile

@@ -33,7 +33,8 @@ group :test do
 end
 
 group :sig do
-  gem "steep"
+  gem "rbs",   ">= 4"
+  gem "steep", ">= 2"
 end
 
 group :doc do

http.gemspec

@@ -26,7 +26,7 @@ Gem::Specification.new do |spec|
   spec.metadata["rubygems_mfa_required"] = "true"
 
   spec.files = IO.popen(%w[git ls-files -z], chdir: __dir__, err: IO::NULL) do |ls|
-    extras = %w[LICENSE.txt README.md sig/http.rbs] << File.basename(__FILE__)
+    extras = %w[LICENSE.txt README.md sig/http.rbs sig/llhttp.rbs sig/manifest.yaml] << File.basename(__FILE__)
 
     ls.readlines("\x0", chomp: true).select do |f|
       f.start_with?("lib/") || extras.include?(f)

lib/http/connection.rb

@@ -254,7 +254,7 @@ def check_premature_eof(eof)
     # @return [void]
     # @api private
     def connect_socket(req, options)
-      @socket = options.timeout_class.new(**options.timeout_options) # steep:ignore
+      @socket = options.timeout_class.new(**options.timeout_options)
       @socket.connect(options.socket_class, req.socket_host, req.socket_port, nodelay: options.nodelay)
 
       send_proxy_connect_request(req)

lib/http/features/logging.rb

@@ -158,7 +158,7 @@ def logged_response_options(response)
       # @return [HTTP::Response::Body]
       # @api private
       def logged_body(body)
-        formatter = (method(:format_binary) unless body.loggable?) # steep:ignore
+        formatter = (method(:format_binary) unless body.loggable?)
         stream = BodyLogger.new(body.instance_variable_get(:@stream), logger, formatter: formatter) # steep:ignore
         Response::Body.new(stream, encoding: body.encoding)
       end

lib/http/uri/parsing.rb

@@ -171,11 +171,11 @@ def normalize_host(host)
     # @return [Hash] URI components
     private_class_method def self.parse_with_addressable(uri_string)
       require_addressable
-      parsed = Addressable::URI.parse(uri_string) # steep:ignore
+      parsed = Addressable::URI.parse(uri_string)
       { scheme: parsed.scheme, user: parsed.user, password: parsed.password,
         host: parsed.host, port: parsed.port, path: parsed.path,
         query: parsed.query, fragment: parsed.fragment }
-    rescue Addressable::URI::InvalidURIError # steep:ignore
+    rescue Addressable::URI::InvalidURIError
       raise InvalidError, "invalid URI: #{uri_string.inspect}"
     end
   end

sig/deps.rbs

@@ -78,24 +78,6 @@ module Zlib
   end
 end
 
-module LLHttp
-  class Error < StandardError
-  end
-
-  class Parser
-    def initialize: (untyped, ?type: Symbol) -> void
-    def reset: () -> void
-    def <<: (String) -> void
-    def status_code: () -> Integer
-    def http_major: () -> Integer
-    def http_minor: () -> Integer
-  end
-
-  class Delegate
-    def initialize: () -> void
-  end
-end
-
 # Supplement: Numeric#to_i and #to_f are not in the stdlib RBS
 class Numeric
   def to_i: () -> Integer

sig/llhttp.rbs

@@ -0,0 +1,20 @@
+# Stubs for llhttp / llhttp-ffi, which do not ship their own RBS signatures.
+# Referenced by `HTTP::Response::Parser`, which is part of the public API.
+
+module LLHttp
+  class Error < StandardError
+  end
+
+  class Parser
+    def initialize: (untyped, ?type: Symbol) -> void
+    def reset: () -> void
+    def <<: (String) -> void
+    def status_code: () -> Integer
+    def http_major: () -> Integer
+    def http_minor: () -> Integer
+  end
+
+  class Delegate
+    def initialize: () -> void
+  end
+end

sig/manifest.yaml

@@ -0,0 +1,13 @@
+dependencies:
+  - name: base64
+  - name: digest
+  - name: forwardable
+  - name: openssl
+  - name: pathname
+  - name: securerandom
+  - name: singleton
+  - name: tempfile
+  - name: time
+  - name: timeout
+  - name: uri
+  - name: zlib