puppeteer-bidi 0.0.1.beta1 → 0.0.1.beta3

data/sig/puppeteer/bidi/page.rbs

@@ -13,124 +13,124 @@ module Puppeteer
 
       attr_reader timeout_settings: TimeoutSettings
 
-      # @rbs browser_context: BrowserContext
-      # @rbs browsing_context: Core::BrowsingContext
+      # @rbs browser_context: BrowserContext -- Parent browser context
+      # @rbs browsing_context: Core::BrowsingContext -- Associated browsing context
       # @rbs return: void
       def initialize: (BrowserContext browser_context, Core::BrowsingContext browsing_context) -> void
 
       # Register an event listener
-      # @rbs event: Symbol | String
-      # @rbs &block: (untyped) -> void
+      # @rbs event: Symbol | String -- Event name
+      # @rbs &block: (untyped) -> void -- Event handler
       # @rbs return: void
       def on: (Symbol | String event) { (untyped) -> void } -> void
 
       # Register a one-time event listener
-      # @rbs event: Symbol | String
-      # @rbs &block: (untyped) -> void
+      # @rbs event: Symbol | String -- Event name
+      # @rbs &block: (untyped) -> void -- Event handler
       # @rbs return: void
       def once: (Symbol | String event) { (untyped) -> void } -> void
 
       # Remove an event listener
-      # @rbs event: Symbol | String
-      # @rbs &block: (untyped) -> void
+      # @rbs event: Symbol | String -- Event name
+      # @rbs &block: (untyped) -> void -- Event handler to remove
       # @rbs return: void
       def off: (Symbol | String event) { (untyped) -> void } -> void
 
       # Emit an event to all registered listeners
-      # @rbs event: Symbol | String
-      # @rbs data: untyped
+      # @rbs event: Symbol | String -- Event name
+      # @rbs data: untyped -- Event data
       # @rbs return: void
       def emit: (Symbol | String event, ?untyped data) -> void
 
       # Navigate to a URL
-      # @rbs url: String
-      # @rbs wait_until: String
-      # @rbs return: HTTPResponse?
+      # @rbs url: String -- URL to navigate to
+      # @rbs wait_until: String -- When to consider navigation complete ('load', 'domcontentloaded')
+      # @rbs return: HTTPResponse? -- Main response
       def goto: (String url, ?wait_until: String) -> HTTPResponse?
 
       # Set page content
-      # @rbs html: String
-      # @rbs wait_until: String
+      # @rbs html: String -- HTML content to set
+      # @rbs wait_until: String -- When to consider content set ('load', 'domcontentloaded')
       # @rbs return: void
       def set_content: (String html, ?wait_until: String) -> void
 
       # Take a screenshot
-      # @rbs path: String?
-      # @rbs type: String
-      # @rbs full_page: bool
-      # @rbs clip: Hash[Symbol, Numeric]?
-      # @rbs capture_beyond_viewport: bool
-      # @rbs return: String
+      # @rbs path: String? -- File path to save screenshot
+      # @rbs type: String -- Image type ('png' or 'jpeg')
+      # @rbs full_page: bool -- Capture full page
+      # @rbs clip: Hash[Symbol, Numeric]? -- Clip region
+      # @rbs capture_beyond_viewport: bool -- Capture beyond viewport
+      # @rbs return: String -- Base64-encoded image data
       def screenshot: (?path: String?, ?type: String, ?full_page: bool, ?clip: Hash[Symbol, Numeric]?, ?capture_beyond_viewport: bool) -> String
 
       # Evaluate JavaScript in the page context
-      # @rbs script: String
-      # @rbs *args: untyped
-      # @rbs return: untyped
+      # @rbs script: String -- JavaScript code to evaluate
+      # @rbs *args: untyped -- Arguments to pass to the script
+      # @rbs return: untyped -- Result of evaluation
       def evaluate: (String script, *untyped args) -> untyped
 
       # Evaluate JavaScript and return a handle to the result
-      # @rbs script: String
-      # @rbs *args: untyped
-      # @rbs return: JSHandle
+      # @rbs script: String -- JavaScript code to evaluate
+      # @rbs *args: untyped -- Arguments to pass to the script
+      # @rbs return: JSHandle -- Handle to the result
       def evaluate_handle: (String script, *untyped args) -> JSHandle
 
       # Query for an element matching the selector
-      # @rbs selector: String
-      # @rbs return: ElementHandle?
+      # @rbs selector: String -- Selector to query
+      # @rbs return: ElementHandle? -- Matching element or nil
       def query_selector: (String selector) -> ElementHandle?
 
       # Query for all elements matching the selector
-      # @rbs selector: String
-      # @rbs return: Array[ElementHandle]
+      # @rbs selector: String -- Selector to query
+      # @rbs return: Array[ElementHandle] -- All matching elements
       def query_selector_all: (String selector) -> Array[ElementHandle]
 
       # Evaluate a function on the first element matching the selector
-      # @rbs selector: String
-      # @rbs page_function: String
-      # @rbs *args: untyped
-      # @rbs return: untyped
+      # @rbs selector: String -- Selector to query
+      # @rbs page_function: String -- JavaScript function to evaluate
+      # @rbs *args: untyped -- Arguments to pass to the function
+      # @rbs return: untyped -- Evaluation result
       def eval_on_selector: (String selector, String page_function, *untyped args) -> untyped
 
       # Evaluate a function on all elements matching the selector
-      # @rbs selector: String
-      # @rbs page_function: String
-      # @rbs *args: untyped
-      # @rbs return: untyped
+      # @rbs selector: String -- Selector to query
+      # @rbs page_function: String -- JavaScript function to evaluate
+      # @rbs *args: untyped -- Arguments to pass to the function
+      # @rbs return: untyped -- Evaluation result
       def eval_on_selector_all: (String selector, String page_function, *untyped args) -> untyped
 
       # Click an element matching the selector
-      # @rbs selector: String
-      # @rbs button: String
-      # @rbs count: Integer
-      # @rbs delay: Numeric?
-      # @rbs offset: Hash[Symbol, Numeric]?
+      # @rbs selector: String -- Selector to click
+      # @rbs button: String -- Mouse button ('left', 'right', 'middle')
+      # @rbs count: Integer -- Number of clicks
+      # @rbs delay: Numeric? -- Delay between clicks in ms
+      # @rbs offset: Hash[Symbol, Numeric]? -- Click offset from element center
       # @rbs return: void
       def click: (String selector, ?button: String, ?count: Integer, ?delay: Numeric?, ?offset: Hash[Symbol, Numeric]?) -> void
 
       # Type text into an element matching the selector
-      # @rbs selector: String
-      # @rbs text: String
-      # @rbs delay: Numeric
+      # @rbs selector: String -- Selector to type into
+      # @rbs text: String -- Text to type
+      # @rbs delay: Numeric -- Delay between key presses in ms
       # @rbs return: void
       def type: (String selector, String text, ?delay: Numeric) -> void
 
       # Hover over an element matching the selector
-      # @rbs selector: String
+      # @rbs selector: String -- Selector to hover
       # @rbs return: void
       def hover: (String selector) -> void
 
       # Focus an element matching the selector
-      # @rbs selector: String
+      # @rbs selector: String -- Selector to focus
       # @rbs return: void
       def focus: (String selector) -> void
 
       # Get the page title
-      # @rbs return: String
+      # @rbs return: String -- Page title
       def title: () -> String
 
       # Get the page URL
-      # @rbs return: String
+      # @rbs return: String -- Page URL
       def url: () -> String
 
       # Close the page
@@ -138,85 +138,85 @@ module Puppeteer
       def close: () -> void
 
       # Check if page is closed
-      # @rbs return: bool
+      # @rbs return: bool -- Whether page is closed
       def closed?: () -> bool
 
       # Get the main frame
-      # @rbs return: Frame
+      # @rbs return: Frame -- Main frame
       def main_frame: () -> Frame
 
       # Get the focused frame
-      # @rbs return: Frame
+      # @rbs return: Frame -- Focused frame
       def focused_frame: () -> Frame
 
       # Get all frames (main frame + all nested child frames)
       # Following Puppeteer's pattern of returning all frames recursively
-      # @rbs return: Array[Frame]
+      # @rbs return: Array[Frame] -- All frames
       def frames: () -> Array[Frame]
 
       # Get the mouse instance
-      # @rbs return: Mouse
+      # @rbs return: Mouse -- Mouse instance
       def mouse: () -> Mouse
 
       # Get the keyboard instance
-      # @rbs return: Keyboard
+      # @rbs return: Keyboard -- Keyboard instance
       def keyboard: () -> Keyboard
 
       # Wait for a function to return a truthy value
-      # @rbs page_function: String
-      # @rbs options: Hash[Symbol, untyped]
-      # @rbs *args: untyped
-      # @rbs &block: ((JSHandle) -> void)?
-      # @rbs return: JSHandle
+      # @rbs page_function: String -- JavaScript function to evaluate
+      # @rbs options: Hash[Symbol, untyped] -- Wait options (timeout, polling)
+      # @rbs *args: untyped -- Arguments to pass to the function
+      # @rbs &block: ((JSHandle) -> void)? -- Optional block called with result
+      # @rbs return: JSHandle -- Handle to the truthy result
       def wait_for_function: (String page_function, ?Hash[Symbol, untyped] options, *untyped args) ?{ (?) -> untyped } -> JSHandle
 
       # Wait for an element matching the selector to appear in the page
-      # @rbs selector: String
-      # @rbs visible: bool?
-      # @rbs hidden: bool?
-      # @rbs timeout: Numeric?
-      # @rbs &block: ((ElementHandle?) -> void)?
-      # @rbs return: ElementHandle?
+      # @rbs selector: String -- Selector to wait for
+      # @rbs visible: bool? -- Wait for element to be visible
+      # @rbs hidden: bool? -- Wait for element to be hidden
+      # @rbs timeout: Numeric? -- Wait timeout in ms
+      # @rbs &block: ((ElementHandle?) -> void)? -- Optional block called with element
+      # @rbs return: ElementHandle? -- Element or nil if hidden
       def wait_for_selector: (String selector, ?visible: bool?, ?hidden: bool?, ?timeout: Numeric?) ?{ (?) -> untyped } -> ElementHandle?
 
       # Set the default timeout for waiting operations (e.g., waitForFunction).
-      # @rbs timeout: Numeric
+      # @rbs timeout: Numeric -- Timeout in ms
       # @rbs return: void
       def set_default_timeout: (Numeric timeout) -> void
 
       # Get the current default timeout in milliseconds.
-      # @rbs return: Numeric
+      # @rbs return: Numeric -- Timeout in ms
       def default_timeout: () -> Numeric
 
       # Wait for navigation to complete
-      # @rbs timeout: Numeric
-      # @rbs wait_until: String
-      # @rbs &block: (-> void)?
-      # @rbs return: HTTPResponse?
+      # @rbs timeout: Numeric -- Navigation timeout in ms
+      # @rbs wait_until: String -- When to consider navigation complete
+      # @rbs &block: (-> void)? -- Optional block to trigger navigation
+      # @rbs return: HTTPResponse? -- Response or nil
       def wait_for_navigation: (?timeout: Numeric, ?wait_until: String) ?{ (?) -> untyped } -> HTTPResponse?
 
       # Wait for a file chooser to be opened
-      # @rbs timeout: Numeric?
-      # @rbs &block: (-> void)?
-      # @rbs return: FileChooser
+      # @rbs timeout: Numeric? -- Wait timeout in ms
+      # @rbs &block: (-> void)? -- Optional block to trigger file chooser
+      # @rbs return: FileChooser -- File chooser instance
       def wait_for_file_chooser: (?timeout: Numeric?) ?{ (?) -> untyped } -> FileChooser
 
       # Wait for network to be idle (no more than concurrency connections for idle_time)
       # Based on Puppeteer's waitForNetworkIdle implementation
-      # @rbs idle_time: Numeric
-      # @rbs timeout: Numeric
-      # @rbs concurrency: Integer
+      # @rbs idle_time: Numeric -- Time to wait for idle in ms
+      # @rbs timeout: Numeric -- Wait timeout in ms
+      # @rbs concurrency: Integer -- Max allowed inflight requests
       # @rbs return: void
       def wait_for_network_idle: (?idle_time: Numeric, ?timeout: Numeric, ?concurrency: Integer) -> void
 
       # Set viewport size
-      # @rbs width: Integer
-      # @rbs height: Integer
+      # @rbs width: Integer -- Viewport width in pixels
+      # @rbs height: Integer -- Viewport height in pixels
       # @rbs return: void
       def set_viewport: (width: Integer, height: Integer) -> void
 
       # Get current viewport size
-      # @rbs return: Hash[Symbol, Integer]?
+      # @rbs return: Hash[Symbol, Integer]? -- Viewport dimensions
       def viewport: () -> Hash[Symbol, Integer]?
 
       alias viewport= set_viewport
@@ -224,19 +224,19 @@ module Puppeteer
       alias default_timeout= set_default_timeout
 
       # Set JavaScript enabled state
-      # @rbs enabled: bool
+      # @rbs enabled: bool -- Whether JavaScript is enabled
       # @rbs return: void
       def set_javascript_enabled: (bool enabled) -> void
 
       # Check if JavaScript is enabled
-      # @rbs return: bool
+      # @rbs return: bool -- Whether JavaScript is enabled
       def javascript_enabled?: () -> bool
 
       private
 
       # Recursively collect all frames starting from the given frame
-      # @rbs frame: Frame
-      # @rbs return: Array[Frame]
+      # @rbs frame: Frame -- Starting frame
+      # @rbs return: Array[Frame] -- All frames in subtree
       def collect_frames: (Frame frame) -> Array[Frame]
 
       # Check if this page is closed and raise error if so

data/sig/puppeteer/bidi/query_handler.rbs

@@ -0,0 +1,113 @@
+# Generated from lib/puppeteer/bidi/query_handler.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    # @api private
+    class QueryHandler
+      include Singleton
+
+      QUERY_SEPARATORS: untyped
+
+      BUILTIN_QUERY_HANDLERS: untyped
+
+      class Result < Data
+        attr_reader updated_selector(): untyped
+
+        attr_reader polling(): untyped
+
+        attr_reader query_handler(): untyped
+
+        def self.new: (untyped updated_selector, untyped polling, untyped query_handler) -> instance
+                    | (updated_selector: untyped, polling: untyped, query_handler: untyped) -> instance
+
+        def self.members: () -> [ :updated_selector, :polling, :query_handler ]
+
+        def members: () -> [ :updated_selector, :polling, :query_handler ]
+      end
+
+      def get_query_handler_and_selector: (untyped selector) -> untyped
+
+      private
+
+      class SelectorAnalysis
+        attr_reader selector: untyped
+
+        def initialize: (untyped selector) -> untyped
+
+        def requires_raf_polling?: () -> untyped
+
+        private
+
+        def pseudo_class_present?: () -> untyped
+      end
+
+      def builtin_query_handler_entries: () -> untyped
+
+      def detect_handler_from_selector: (untyped name, untyped handler, untyped selector) -> untyped
+
+      def analyze_default_query_handler: (untyped selector) -> untyped
+
+      def default_query_handler_result: (untyped selector) -> untyped
+
+      def resolve_handler_constant: (untyped const_name) -> untyped
+
+      def build_query_handler_result: (untyped handler, untyped selector, untyped handler_name) -> untyped
+    end
+
+    class BaseQueryHandler
+      # Query for a single element matching the selector
+      # @param element [ElementHandle] Element to query from
+      # @param selector [String] Selector to match
+      # @return [ElementHandle, nil] Found element or nil
+      def run_query_one: (untyped element, untyped selector) -> untyped
+
+      # Query for all elements matching the selector
+      # @param element [ElementHandle] Element to query from
+      # @param selector [String] Selector to match
+      # @return [Array<ElementHandle>] Array of found elements
+      def run_query_all: (untyped element, untyped selector) -> untyped
+
+      def wait_for: (untyped element_or_frame, untyped selector, ?visible: untyped, ?hidden: untyped, ?timeout: untyped, ?polling: untyped) ?{ (?) -> untyped } -> untyped
+
+      private
+
+      def query_one_script: () -> untyped
+
+      def query_all_script: () -> untyped
+
+      def wait_for_selector_script: () -> untyped
+
+      def wait_for_in_frame: (untyped frame, untyped root, untyped selector, visible: untyped, hidden: untyped, timeout: untyped, polling: untyped) ?{ (?) -> untyped } -> untyped
+    end
+
+    class CSSQueryHandler < BaseQueryHandler
+      private
+
+      def query_one_script: () -> untyped
+
+      def query_all_script: () -> untyped
+
+      def wait_for_selector_script: () -> untyped
+    end
+
+    class XPathQueryHandler < BaseQueryHandler
+      private
+
+      def query_one_script: () -> untyped
+
+      def query_all_script: () -> untyped
+
+      def wait_for_selector_script: () -> untyped
+    end
+
+    class TextQueryHandler < BaseQueryHandler
+      private
+
+      def query_one_script: () -> untyped
+
+      def query_all_script: () -> untyped
+
+      def wait_for_selector_script: () -> untyped
+    end
+  end
+end

data/sig/puppeteer/bidi/realm.rbs

@@ -0,0 +1,141 @@
+# Generated from lib/puppeteer/bidi/realm.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    # Base realm abstraction that mirrors Puppeteer's Realm class hierarchy.
+    # Provides shared lifecycle management for WaitTask instances.
+    # https://github.com/puppeteer/puppeteer/blob/main/packages/puppeteer-core/src/api/Realm.ts
+    class Realm
+      attr_reader task_manager: Puppeteer::Bidi::TaskManager
+
+      # @rbs timeout_settings: TimeoutSettings -- Timeout settings
+      # @rbs return: void
+      def initialize: (TimeoutSettings timeout_settings) -> void
+
+      # Get the environment object (must be implemented by subclass)
+      # @rbs return: untyped -- Environment object
+      def environment: () -> untyped
+
+      # Get the page for this realm
+      # @rbs return: Page -- Page instance
+      def page: () -> Page
+
+      # Get the default timeout
+      # @rbs return: Numeric -- Default timeout in ms
+      def default_timeout: () -> Numeric
+
+      # Wait for a function to return a truthy value
+      # @rbs page_function: String -- JavaScript function to evaluate
+      # @rbs options: Hash[Symbol, untyped] -- Wait options (timeout, polling, root)
+      # @rbs *args: untyped -- Arguments to pass to the function
+      # @rbs &block: ((JSHandle) -> void)? -- Optional block called with result
+      # @rbs return: JSHandle -- Handle to the truthy result
+      def wait_for_function: (String page_function, ?Hash[Symbol, untyped] options, *untyped args) ?{ (?) -> untyped } -> JSHandle
+
+      # Dispose this realm
+      # @rbs return: void
+      def dispose: () -> void
+
+      # Check if this realm is disposed
+      # @rbs return: bool -- Whether realm is disposed
+      def disposed?: () -> bool
+
+      # Adopt a handle from another realm into this realm.
+      # Mirrors Puppeteer's BidiRealm#adoptHandle implementation.
+      # @rbs handle: JSHandle -- The handle to adopt
+      # @rbs return: JSHandle -- Handle that belongs to this realm
+      def adopt_handle: (JSHandle handle) -> JSHandle
+
+      # Transfer a handle into this realm, disposing of the original.
+      # Mirrors Puppeteer's BidiRealm#transferHandle implementation.
+      # @rbs handle: JSHandle -- Handle that may belong to another realm
+      # @rbs return: JSHandle -- Handle adopted into this realm
+      def transfer_handle: (JSHandle handle) -> JSHandle
+
+      private
+
+      # Ensure the environment is still active
+      # @rbs return: void
+      def ensure_environment_active!: () -> void
+    end
+
+    # Concrete realm that wraps the default window realm for a Frame.
+    # https://github.com/puppeteer/puppeteer/blob/main/packages/puppeteer-core/src/bidi/Realm.ts
+    class FrameRealm < Realm
+      attr_reader core_realm: Core::WindowRealm
+
+      # @rbs frame: Frame -- Frame instance
+      # @rbs core_realm: Core::WindowRealm -- Core window realm
+      # @rbs return: void
+      def initialize: (Frame frame, Core::WindowRealm core_realm) -> void
+
+      # Get the frame environment
+      # @rbs return: Frame -- Frame instance
+      def environment: () -> Frame
+
+      # Get the page
+      # @rbs return: Page -- Page instance
+      def page: () -> Page
+
+      # Evaluate JavaScript in this realm
+      # @rbs script: String -- JavaScript code to evaluate
+      # @rbs *args: untyped -- Arguments to pass to the script
+      # @rbs return: untyped -- Evaluation result
+      def evaluate: (String script, *untyped args) -> untyped
+
+      # Evaluate JavaScript and return a handle to the result
+      # @rbs script: String -- JavaScript code to evaluate
+      # @rbs *args: untyped -- Arguments to pass to the script
+      # @rbs return: JSHandle -- Handle to the result
+      def evaluate_handle: (String script, *untyped args) -> JSHandle
+
+      # Call a function in the realm
+      # @rbs function_declaration: String -- Function source code
+      # @rbs await_promise: bool -- Whether to await promise results
+      # @rbs **options: untyped -- Additional options
+      # @rbs return: Hash[String, untyped] -- Evaluation result
+      def call_function: (String function_declaration, bool await_promise, **untyped options) -> Hash[String, untyped]
+
+      # Get the Puppeteer utility handle
+      # @rbs return: JSHandle -- Puppeteer utility handle
+      def puppeteer_util: () -> JSHandle
+
+      # Get or create lazy arg for Puppeteer utility
+      # @rbs return: LazyArg -- Lazy argument for Puppeteer utility
+      def puppeteer_util_lazy_arg: () -> LazyArg
+
+      # Reset the Puppeteer utility handle
+      # @rbs return: void
+      def reset_puppeteer_util_handle!: () -> void
+
+      # Wait for a function to return a truthy value
+      # @rbs page_function: String -- JavaScript function to evaluate
+      # @rbs options: Hash[Symbol, untyped] -- Wait options
+      # @rbs *args: untyped -- Arguments to pass to the function
+      # @rbs &block: ((JSHandle) -> void)? -- Optional block called with result
+      # @rbs return: JSHandle -- Handle to the truthy result
+      def wait_for_function: (String page_function, ?Hash[Symbol, untyped] options, *untyped args) ?{ (?) -> untyped } -> JSHandle
+
+      # Dispose this realm
+      # @rbs return: void
+      def dispose: () -> void
+
+      private
+
+      # Execute script with core realm
+      # @rbs script: String -- JavaScript code
+      # @rbs args: Array[untyped] -- Arguments
+      # @rbs return: Async::Task[Hash[String, untyped]] -- Evaluation result
+      def execute_with_core: (String script, Array[untyped] args) -> Async::Task[Hash[String, untyped]]
+
+      # Handle evaluation exception from result
+      # @rbs result: Hash[String, untyped] -- Evaluation result containing exception
+      # @rbs return: void
+      def handle_evaluation_exception: (Hash[String, untyped] result) -> void
+
+      # Set up core realm event callbacks
+      # @rbs return: void
+      def setup_core_realm_callbacks: () -> void
+    end
+  end
+end

data/sig/puppeteer/bidi/serializer.rbs

@@ -0,0 +1,31 @@
+# Generated from lib/puppeteer/bidi/serializer.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    # Serializer converts Ruby values to BiDi Script.LocalValue format
+    # Based on Puppeteer's Serializer.ts
+    class Serializer
+      # Serialize a Ruby value to BiDi LocalValue format
+      # @param value [Object] Ruby value to serialize
+      # @return [Hash] BiDi LocalValue
+      # @raise [ArgumentError] for unsupported types or circular references
+      def self.serialize: (untyped value) -> untyped
+
+      # Check if value is a complex object that might have circular references
+      private def self.complex_object?: (untyped value) -> untyped
+
+      # Check for circular references using JSON encoding
+      # This matches Puppeteer's approach
+      private def self.check_circular_reference: (untyped value) -> untyped
+
+      # Serialize a JSHandle to a BiDi reference
+      private def self.serialize_handle: (untyped handle) -> untyped
+
+      # Serialize a Float to BiDi number format, handling special values
+      private def self.serialize_number: (untyped num) -> untyped
+
+      # Extract regexp flags from Ruby Regexp
+      private def self.regexp_flags: (untyped regexp) -> untyped
+    end
+  end
+end

data/sig/puppeteer/bidi/target.rbs

@@ -0,0 +1,68 @@
+# Generated from lib/puppeteer/bidi/target.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    class BrowserTarget
+      # @rbs browser: Browser
+      # @rbs return: void
+      def initialize: (Browser browser) -> void
+
+      # @rbs return: nil
+      def page: () -> nil
+
+      # @rbs return: String
+      def url: () -> String
+
+      # @rbs return: String
+      def type: () -> String
+
+      # @rbs return: Browser
+      def browser: () -> Browser
+
+      # @rbs return: BrowserContext
+      def browser_context: () -> BrowserContext
+    end
+
+    class PageTarget
+      # @rbs page: Page
+      # @rbs return: void
+      def initialize: (Page page) -> void
+
+      # @rbs return: Page
+      def page: () -> Page
+
+      # @rbs return: String
+      def url: () -> String
+
+      # @rbs return: String
+      def type: () -> String
+
+      # @rbs return: Browser
+      def browser: () -> Browser
+
+      # @rbs return: BrowserContext
+      def browser_context: () -> BrowserContext
+    end
+
+    class FrameTarget
+      # @rbs frame: Frame
+      # @rbs return: void
+      def initialize: (Frame frame) -> void
+
+      # @rbs return: Page
+      def page: () -> Page
+
+      # @rbs return: String
+      def url: () -> String
+
+      # @rbs return: String
+      def type: () -> String
+
+      # @rbs return: Browser
+      def browser: () -> Browser
+
+      # @rbs return: BrowserContext
+      def browser_context: () -> BrowserContext
+    end
+  end
+end