chore: Refine RBS type signatures for improved accuracy and consistency across multiple files

Author: route

sig/ferrum/browser.rbs

@@ -26,7 +26,8 @@ module Ferrum
 
     def default_user_agent=: (String) -> String
 
-    def create_page: (?new_context: bool, ?proxy: Hash[Symbol, (String | ::Integer)]?) ?{ (Page) -> void } -> Page
+    def create_page: (?new_context: bool, ?proxy: Hash[Symbol, (String | ::Integer)]?) -> Page
+                   | [T] (?new_context: bool, ?proxy: Hash[Symbol, (String | ::Integer)]?) { (Page) -> T } -> T
 
     def extensions: () -> ::Array[String]
 

sig/ferrum/client.rbs

@@ -10,7 +10,7 @@ module Ferrum
 
     def initialize: (Client client, String session_id) -> void
 
-    def command: (String method, ?async: bool, **untyped params) -> Hash[String, untyped]
+    def command: (String method, ?async: bool, **untyped params) -> (bool | Hash[String, untyped])
 
     def on: (String event) { (Hash[String, untyped]) -> void } -> Integer
 
@@ -48,7 +48,7 @@ module Ferrum
 
     def initialize: ((String | ::Addressable::URI) ws_url, Browser::Options options) -> void
 
-    def command: (String method, ?async: bool, **untyped params) -> Hash[String, untyped]
+    def command: (String method, ?async: bool, **untyped params) -> (bool | Hash[String, untyped])
 
     def send_message: (Hash[Symbol, untyped] message, async: bool) -> (bool | Hash[String, untyped])
 

sig/ferrum/context.rbs

@@ -38,7 +38,7 @@ module Ferrum
 
     def close_targets_connection: () -> void
 
-    def dispose: () -> Hash[String, untyped]
+    def dispose: () -> bool
 
     def target?: (String target_id) -> bool
 

sig/ferrum/network/auth_request.rbs

@@ -13,7 +13,7 @@ module Ferrum
 
       def navigation_request?: () -> bool
 
-      def auth_challenge?: (::String source) -> bool
+      def auth_challenge?: ((::String | ::Symbol) source) -> bool
 
       def match?: (Regexp regexp) -> bool
 

sig/ferrum/page.rbs

@@ -84,9 +84,9 @@ module Ferrum
 
     def subscribed?: (String event) -> bool
 
-    def use_proxy?: () -> bool
+    def use_proxy?: () -> boolish
 
-    def use_authorized_proxy?: () -> bool
+    def use_authorized_proxy?: () -> boolish
 
     def timeout: () -> ::Numeric
 
@@ -104,7 +104,7 @@ module Ferrum
 
     def combine_url!: (String? url) -> String
 
-    def document_node_id: () -> ::Integer
+    def document_node_id: (?async: bool) -> (::Integer | bool)
 
     def proxy=: ({ host: String, port: ::Integer, user: String?, password: String? }? proxy) -> void
   end

sig/ferrum/utils/attempt.rbs

@@ -1,7 +1,7 @@
 module Ferrum
   module Utils
     module Attempt
-      def self?.with_retry: (errors: Array[Exception] | Exception, max: Integer, wait: Integer) { () -> untyped } -> untyped
+      def self?.with_retry: (errors: (Array[Class] | Class), max: Integer, wait: Numeric) { () -> untyped } -> untyped
     end
   end
 end