puppeteer-bidi 0.0.1.beta1 → 0.0.1.beta3

data/lib/puppeteer/bidi/core/browsing_context.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# rbs_inline: enabled
 
 module Puppeteer
   module Bidi
@@ -8,12 +9,12 @@ module Puppeteer
         include Disposable::DisposableMixin
 
         # Create a browsing context
-        # @param user_context [UserContext] Parent user context
-        # @param parent [BrowsingContext, nil] Parent browsing context
-        # @param id [String] Context ID
-        # @param url [String] Initial URL
-        # @param original_opener [String, nil] Original opener context ID
-        # @return [BrowsingContext] New browsing context
+        # @rbs user_context: UserContext -- Parent user context
+        # @rbs parent: BrowsingContext? -- Parent browsing context
+        # @rbs id: String -- Context ID
+        # @rbs url: String -- Initial URL
+        # @rbs original_opener: String? -- Original opener context ID
+        # @rbs return: BrowsingContext -- New browsing context
         def self.from(user_context, parent, id, url, original_opener)
           context = new(user_context, parent, id, url, original_opener)
           context.send(:initialize_context)
@@ -50,25 +51,25 @@ module Puppeteer
         alias disposed? closed?
 
         # Get the current URL
-        # @return [String] Current URL
+        # @rbs return: String -- Current URL
         def url
           @url
         end
 
         # Get child browsing contexts
-        # @return [Array<BrowsingContext>] Child contexts
+        # @rbs return: Array[BrowsingContext] -- Child contexts
         def children
           @children.values
         end
 
         # Get all realms in this context
-        # @return [Array<WindowRealm>] All realms
+        # @rbs return: Array[WindowRealm] -- All realms
         def realms
           [@default_realm] + @realms.values
         end
 
         # Get the top-level browsing context
-        # @return [BrowsingContext] Top-level context
+        # @rbs return: BrowsingContext -- Top-level context
         def top
           context = self
           while context.parent
@@ -84,8 +85,9 @@ module Puppeteer
         end
 
         # Navigate to a URL
-        # @param url [String] URL to navigate to
-        # @param wait [String, nil] Wait condition ('none', 'interactive', 'complete')
+        # @rbs url: String -- URL to navigate to
+        # @rbs wait: String? -- Wait condition ('none', 'interactive', 'complete')
+        # @rbs return: Async::Task[untyped]
         def navigate(url, wait: nil)
           Async do
             raise BrowsingContextClosedError, @reason if closed?
@@ -98,15 +100,16 @@ module Puppeteer
         end
 
         # Reload the page
-        # @param options [Hash] Reload options
+        # @rbs **options: untyped -- Reload options
+        # @rbs return: Async::Task[untyped]
         def reload(**options)
           raise BrowsingContextClosedError, @reason if closed?
           session.async_send_command('browsingContext.reload', options.merge(context: @id))
         end
 
         # Capture a screenshot
-        # @param options [Hash] Screenshot options
-        # @return [Async::Task<String>] Base64-encoded image data
+        # @rbs **options: untyped -- Screenshot options
+        # @rbs return: Async::Task[String] -- Base64-encoded image data
         def capture_screenshot(**options)
           raise BrowsingContextClosedError, @reason if closed?
           Async do
@@ -116,8 +119,8 @@ module Puppeteer
         end
 
         # Print to PDF
-        # @param options [Hash] Print options
-        # @return [Async::Task<String>] Base64-encoded PDF data
+        # @rbs **options: untyped -- Print options
+        # @rbs return: Async::Task[String] -- Base64-encoded PDF data
         def print(**options)
           raise BrowsingContextClosedError, @reason if closed?
           Async do
@@ -127,7 +130,8 @@ module Puppeteer
         end
 
         # Close this browsing context
-        # @param prompt_unload [Boolean] Whether to prompt before unload
+        # @rbs prompt_unload: bool -- Whether to prompt before unload
+        # @rbs return: Async::Task[void]
         def close(prompt_unload: false)
           raise BrowsingContextClosedError, @reason if closed?
 
@@ -163,7 +167,8 @@ module Puppeteer
         end
 
         # Traverse history
-        # @param delta [Integer] Number of steps to go back (negative) or forward (positive)
+        # @rbs delta: Integer -- Number of steps to go back (negative) or forward (positive)
+        # @rbs return: Async::Task[untyped]
         def traverse_history(delta)
           raise BrowsingContextClosedError, @reason if closed?
           session.async_send_command('browsingContext.traverseHistory', {
@@ -173,21 +178,24 @@ module Puppeteer
         end
 
         # Handle a user prompt
-        # @param options [Hash] Prompt handling options
+        # @rbs **options: untyped -- Prompt handling options
+        # @rbs return: Async::Task[untyped]
         def handle_user_prompt(**options)
           raise BrowsingContextClosedError, @reason if closed?
           session.async_send_command('browsingContext.handleUserPrompt', options.merge(context: @id))
         end
 
         # Set viewport
-        # @param options [Hash] Viewport options
+        # @rbs **options: untyped -- Viewport options
+        # @rbs return: Async::Task[untyped]
         def set_viewport(**options)
           raise BrowsingContextClosedError, @reason if closed?
           session.async_send_command('browsingContext.setViewport', options.merge(context: @id))
         end
 
         # Perform input actions
-        # @param actions [Array<Hash>] Input actions
+        # @rbs actions: Array[Hash[String, untyped]] -- Input actions
+        # @rbs return: Async::Task[untyped]
         def perform_actions(actions)
           raise BrowsingContextClosedError, @reason if closed?
           session.async_send_command('input.performActions', {
@@ -203,7 +211,8 @@ module Puppeteer
         end
 
         # Set cache behavior
-        # @param cache_behavior [String] 'default' or 'bypass'
+        # @rbs cache_behavior: String -- 'default' or 'bypass'
+        # @rbs return: Async::Task[untyped]
         def set_cache_behavior(cache_behavior)
           raise BrowsingContextClosedError, @reason if closed?
           session.async_send_command('network.setCacheBehavior', {
@@ -213,8 +222,8 @@ module Puppeteer
         end
 
         # Create a sandboxed window realm
-        # @param sandbox [String] Sandbox name
-        # @return [WindowRealm] New realm
+        # @rbs sandbox: String -- Sandbox name
+        # @rbs return: WindowRealm -- New realm
         def create_window_realm(sandbox)
           raise BrowsingContextClosedError, @reason if closed?
           realm = WindowRealm.from(self, sandbox)
@@ -225,9 +234,9 @@ module Puppeteer
         end
 
         # Add a preload script to this context
-        # @param function_declaration [String] JavaScript function
-        # @param options [Hash] Script options
-        # @return [String] Script ID
+        # @rbs function_declaration: String -- JavaScript function
+        # @rbs **options: untyped -- Script options
+        # @rbs return: Async::Task[String] -- Script ID
         def add_preload_script(function_declaration, **options)
           raise BrowsingContextClosedError, @reason if closed?
           user_context.browser.add_preload_script(
@@ -237,15 +246,16 @@ module Puppeteer
         end
 
         # Remove a preload script
-        # @param script [String] Script ID
+        # @rbs script: String -- Script ID
+        # @rbs return: Async::Task[untyped]
         def remove_preload_script(script)
           raise BrowsingContextClosedError, @reason if closed?
           user_context.browser.remove_preload_script(script)
         end
 
         # Add network intercept
-        # @param options [Hash] Intercept options
-        # @return [String] Intercept ID
+        # @rbs **options: untyped -- Intercept options
+        # @rbs return: String -- Intercept ID
         def add_intercept(**options)
           raise BrowsingContextClosedError, @reason if closed?
           result = session.async_send_command('network.addIntercept', options.merge(contexts: [@id]))
@@ -253,8 +263,8 @@ module Puppeteer
         end
 
         # Get cookies
-        # @param options [Hash] Cookie filter options
-        # @return [Array<Hash>] Cookies
+        # @rbs **options: untyped -- Cookie filter options
+        # @rbs return: Array[Hash[String, untyped]] -- Cookies
         def get_cookies(**options)
           raise BrowsingContextClosedError, @reason if closed?
           params = options.dup
@@ -267,7 +277,8 @@ module Puppeteer
         end
 
         # Set a cookie
-        # @param cookie [Hash] Cookie data
+        # @rbs cookie: Hash[String, untyped] -- Cookie data
+        # @rbs return: Async::Task[untyped]
         def set_cookie(cookie)
           raise BrowsingContextClosedError, @reason if closed?
           session.async_send_command('storage.setCookie', {
@@ -280,7 +291,8 @@ module Puppeteer
         end
 
         # Delete cookies
-        # @param cookie_filters [Array<Hash>] Cookie filters
+        # @rbs *cookie_filters: Hash[String, untyped] -- Cookie filters
+        # @rbs return: void
         def delete_cookie(*cookie_filters)
           raise BrowsingContextClosedError, @reason if closed?
           cookie_filters.each do |filter|
@@ -295,7 +307,8 @@ module Puppeteer
         end
 
         # Set geolocation override
-        # @param options [Hash] Geolocation options
+        # @rbs **options: untyped -- Geolocation options
+        # @rbs return: Async::Task[untyped]
         def set_geolocation_override(**options)
           raise BrowsingContextClosedError, @reason if closed?
           raise 'Missing coordinates' unless options[:coordinates]
@@ -307,7 +320,8 @@ module Puppeteer
         end
 
         # Set timezone override
-        # @param timezone_id [String, nil] Timezone ID
+        # @rbs timezone_id: String? -- Timezone ID
+        # @rbs return: Async::Task[untyped]
         def set_timezone_override(timezone_id = nil)
           raise BrowsingContextClosedError, @reason if closed?
 
@@ -321,8 +335,9 @@ module Puppeteer
         end
 
         # Set files on an input element
-        # @param element [Hash] Element reference
-        # @param files [Array<String>] File paths
+        # @rbs element: Hash[String, untyped] -- Element reference
+        # @rbs files: Array[String] -- File paths
+        # @rbs return: Async::Task[untyped]
         def set_files(element, files)
           raise BrowsingContextClosedError, @reason if closed?
           session.async_send_command('input.setFiles', {
@@ -333,9 +348,9 @@ module Puppeteer
         end
 
         # Locate nodes in the context
-        # @param locator [Hash] Node locator
-        # @param start_nodes [Array<Hash>] Starting nodes
-        # @return [Array<Hash>] Located nodes
+        # @rbs locator: Hash[String, untyped] -- Node locator
+        # @rbs start_nodes: Array[Hash[String, untyped]] -- Starting nodes
+        # @rbs return: Array[Hash[String, untyped]] -- Located nodes
         def locate_nodes(locator, start_nodes = [])
           raise BrowsingContextClosedError, @reason if closed?
           params = {
@@ -349,7 +364,8 @@ module Puppeteer
         end
 
         # Set JavaScript enabled state
-        # @param enabled [Boolean] Whether JavaScript is enabled
+        # @rbs enabled: bool -- Whether JavaScript is enabled
+        # @rbs return: Async::Task[void]
         def set_javascript_enabled(enabled)
           Async do
             raise BrowsingContextClosedError, @reason if closed?
@@ -362,20 +378,22 @@ module Puppeteer
         end
 
         # Check if JavaScript is enabled
-        # @return [Boolean] Whether JavaScript is enabled
+        # @rbs return: bool -- Whether JavaScript is enabled
         def javascript_enabled?
           @emulation_state[:javascript_enabled]
         end
 
         # Subscribe to events for this context
-        # @param events [Array<String>] Event names
+        # @rbs events: Array[String] -- Event names
+        # @rbs return: void
         def subscribe(events)
           raise BrowsingContextClosedError, @reason if closed?
           session.subscribe(events, [@id])
         end
 
         # Add interception for this context
-        # @param events [Array<String>] Event names
+        # @rbs events: Array[String] -- Event names
+        # @rbs return: void
         def add_interception(events)
           raise BrowsingContextClosedError, @reason if closed?
           session.subscribe(events, [@id])

data/lib/puppeteer/bidi/core/disposable.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# rbs_inline: enabled
 
 module Puppeteer
   module Bidi
@@ -8,14 +9,15 @@ module Puppeteer
       module Disposable
         # DisposableStack manages multiple disposable resources
         class DisposableStack
+          # @rbs return: void
           def initialize
             @disposed = false
-            @resources = []
+            @resources = [] #: Array[untyped]
           end
 
           # Add a disposable resource to the stack
-          # @param resource [Object] Resource that responds to #dispose
-          # @return [Object] The resource itself for convenience
+          # @rbs resource: untyped -- Resource that responds to #dispose
+          # @rbs return: untyped -- The resource itself for convenience
           def use(resource)
             raise 'DisposableStack already disposed' if @disposed
             @resources << resource
@@ -23,6 +25,7 @@ module Puppeteer
           end
 
           # Dispose all resources in reverse order (LIFO)
+          # @rbs return: void
           def dispose
             return if @disposed
             @disposed = true
@@ -39,6 +42,7 @@ module Puppeteer
             @resources.clear
           end
 
+          # @rbs return: bool
           def disposed?
             @disposed
           end
@@ -46,12 +50,14 @@ module Puppeteer
 
         # Module to be included in classes that need disposal
         module DisposableMixin
+          # @rbs return: void
           def dispose
             return if @disposed
             @disposed = true
             perform_dispose
           end
 
+          # @rbs return: bool
           def disposed?
             @disposed ||= false
           end
@@ -59,6 +65,7 @@ module Puppeteer
           protected
 
           # Override this method to perform cleanup
+          # @rbs return: void
           def perform_dispose
             # Default implementation does nothing
           end

data/lib/puppeteer/bidi/core/errors.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# rbs_inline: enabled
 
 module Puppeteer
   module Bidi
@@ -9,8 +10,12 @@ module Puppeteer
 
       # Raised when attempting to use a disposed resource
       class DisposedError < Error
-        attr_reader :resource_type, :reason
+        attr_reader :resource_type #: String
+        attr_reader :reason #: String
 
+        # @rbs resource_type: String
+        # @rbs reason: String
+        # @rbs return: void
         def initialize(resource_type, reason)
           @resource_type = resource_type
           @reason = reason
@@ -20,6 +25,8 @@ module Puppeteer
 
       # Raised when a realm has been destroyed
       class RealmDestroyedError < DisposedError
+        # @rbs reason: String
+        # @rbs return: void
         def initialize(reason)
           super('Realm', reason)
         end
@@ -27,6 +34,8 @@ module Puppeteer
 
       # Raised when a browsing context has been closed
       class BrowsingContextClosedError < DisposedError
+        # @rbs reason: String
+        # @rbs return: void
         def initialize(reason)
           super('Browsing context', reason)
         end
@@ -34,6 +43,8 @@ module Puppeteer
 
       # Raised when a user context has been closed
       class UserContextClosedError < DisposedError
+        # @rbs reason: String
+        # @rbs return: void
         def initialize(reason)
           super('User context', reason)
         end
@@ -41,6 +52,8 @@ module Puppeteer
 
       # Raised when a user prompt has been closed
       class UserPromptClosedError < DisposedError
+        # @rbs reason: String
+        # @rbs return: void
         def initialize(reason)
           super('User prompt', reason)
         end
@@ -48,6 +61,8 @@ module Puppeteer
 
       # Raised when a session has ended
       class SessionEndedError < DisposedError
+        # @rbs reason: String
+        # @rbs return: void
         def initialize(reason)
           super('Session', reason)
         end
@@ -55,6 +70,8 @@ module Puppeteer
 
       # Raised when a browser has been disconnected
       class BrowserDisconnectedError < DisposedError
+        # @rbs reason: String
+        # @rbs return: void
         def initialize(reason)
           super('Browser', reason)
         end

data/lib/puppeteer/bidi/core/event_emitter.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# rbs_inline: enabled
 
 module Puppeteer
   module Bidi
@@ -6,22 +7,25 @@ module Puppeteer
       # EventEmitter provides event subscription and emission capabilities
       # Similar to Node.js EventEmitter but simpler
       class EventEmitter
+        # @rbs return: void
         def initialize
           @listeners = Hash.new { |h, k| h[k] = [] }
           @disposed = false
         end
 
         # Register an event listener
-        # @param event [Symbol, String] Event name
-        # @param block [Proc] Event handler
+        # @rbs event: Symbol | String -- Event name
+        # @rbs &block: (untyped) -> void -- Event handler
+        # @rbs return: void
         def on(event, &block)
           return if @disposed
           @listeners[event.to_sym] << block
         end
 
         # Register a one-time event listener
-        # @param event [Symbol, String] Event name
-        # @param block [Proc] Event handler
+        # @rbs event: Symbol | String -- Event name
+        # @rbs &block: (untyped) -> void -- Event handler
+        # @rbs return: void
         def once(event, &block)
           return if @disposed
           wrapper = lambda do |*args|
@@ -32,8 +36,9 @@ module Puppeteer
         end
 
         # Remove an event listener
-        # @param event [Symbol, String] Event name
-        # @param block [Proc] Event handler to remove (optional)
+        # @rbs event: Symbol | String -- Event name
+        # @rbs &block: ((untyped) -> void)? -- Event handler to remove
+        # @rbs return: void
         def off(event, &block)
           event_sym = event.to_sym
           if block
@@ -44,7 +49,8 @@ module Puppeteer
         end
 
         # Remove all listeners for an event or all events
-        # @param event [Symbol, String, nil] Event name (optional)
+        # @rbs event: (Symbol | String)? -- Event name
+        # @rbs return: void
         def remove_all_listeners(event = nil)
           if event
             @listeners.delete(event.to_sym)
@@ -54,8 +60,9 @@ module Puppeteer
         end
 
         # Emit an event to all registered listeners
-        # @param event [Symbol, String] Event name
-        # @param data [Object] Event data
+        # @rbs event: Symbol | String -- Event name
+        # @rbs data: untyped -- Event data
+        # @rbs return: void
         def emit(event, data = nil)
           return if @disposed
           listeners = @listeners[event.to_sym].dup
@@ -69,11 +76,13 @@ module Puppeteer
         end
 
         # Dispose the event emitter
+        # @rbs return: void
         def dispose
           @disposed = true
           @listeners.clear
         end
 
+        # @rbs return: bool
         def disposed?
           @disposed
         end

data/lib/puppeteer/bidi/core/navigation.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# rbs_inline: enabled
 
 module Puppeteer
   module Bidi
@@ -8,8 +9,8 @@ module Puppeteer
         include Disposable::DisposableMixin
 
         # Create a navigation instance
-        # @param browsing_context [BrowsingContext] The browsing context
-        # @return [Navigation] New navigation instance
+        # @rbs browsing_context: BrowsingContext -- The browsing context
+        # @rbs return: Navigation -- New navigation instance
         def self.from(browsing_context)
           navigation = new(browsing_context)
           navigation.send(:initialize_navigation)
@@ -28,7 +29,7 @@ module Puppeteer
         end
 
         # Get the nested navigation if any
-        # @return [Navigation, nil] Nested navigation
+        # @rbs return: Navigation? -- Nested navigation
         def navigation
           @navigation
         end