chore(internal): minor type annotation improvements

Author: stainless-app[bot]

Steepfile

@@ -2,7 +2,7 @@
 
 require "yaml"
 
-target :lib do
+target(:lib) do
   configure_code_diagnostics(Steep::Diagnostic::Ruby.strict)
 
   signature("sig")

lib/orb/internal/page.rb

@@ -28,7 +28,7 @@ def next_page?
       end
 
       # @raise [Orb::HTTP::Error]
-      # @return [Orb::Internal::Page]
+      # @return [self]
       def next_page
         unless next_page?
           message = "No more pages available. Please check #next_page? before calling ##{__method__}"

lib/orb/internal/transport/base_client.rb

@@ -216,9 +216,9 @@ def initialize(
         #
         #   @option req [Symbol, nil] :unwrap
         #
-        #   @option req [Class, nil] :page
+        #   @option req [Class<Orb::Internal::Type::BasePage>, nil] :page
         #
-        #   @option req [Class, nil] :stream
+        #   @option req [Class<Orb::Internal::Type::BaseStream>, nil] :stream
         #
         #   @option req [Orb::Internal::Type::Converter, Class, nil] :model
         #
@@ -417,9 +417,9 @@ def initialize(
         #
         # @param unwrap [Symbol, nil]
         #
-        # @param page [Class, nil]
+        # @param page [Class<Orb::Internal::Type::BasePage>, nil]
         #
-        # @param stream [Class, nil]
+        # @param stream [Class<Orb::Internal::Type::BaseStream>, nil]
         #
         # @param model [Orb::Internal::Type::Converter, Class, nil]
         #

lib/orb/internal/type/array_of.rb

@@ -28,6 +28,8 @@ class ArrayOf
         #   @option spec [Proc] :union
         #
         #   @option spec [Boolean] :"nil?"
+        #
+        # @return [Orb::Internal::Type::ArrayOf]
         def self.[](...) = new(...)
 
         # @api public

lib/orb/internal/type/base_model.rb

@@ -389,7 +389,7 @@ def to_yaml(*a) = Orb::Internal::Type::Converter.dump(self.class, self).to_yaml(
 
         # Create a new instance of a model.
         #
-        # @param data [Hash{Symbol=>Object}, Orb::Internal::Type::BaseModel]
+        # @param data [Hash{Symbol=>Object}, self]
         def initialize(data = {})
           case Orb::Internal::Util.coerce_hash(data)
           in Hash => coerced

lib/orb/internal/type/base_page.rb

@@ -19,7 +19,7 @@ def next_page? = (raise NotImplementedError)
         # @api public
         #
         # @raise [Orb::Errors::APIError]
-        # @return [Orb::Internal::Type::BasePage]
+        # @return [self]
         def next_page = (raise NotImplementedError)
 
         # @api public

lib/orb/internal/type/hash_of.rb

@@ -28,6 +28,8 @@ class HashOf
         #   @option spec [Proc] :union
         #
         #   @option spec [Boolean] :"nil?"
+        #
+        # @return [Orb::Internal::Type::HashOf]
         def self.[](...) = new(...)
 
         # @api public