puppeteer-bidi 0.0.1.beta10 → 0.0.1

data/lib/puppeteer/bidi/query_handler.rb

@@ -257,7 +257,7 @@ module Puppeteer
 
         options = {}
         options[:polling] = resolved_polling if resolved_polling
-        options[:timeout] = timeout if timeout
+        options[:timeout] = timeout unless timeout.nil?
 
         begin
           handle = frame.isolated_realm.wait_for_function(

data/lib/puppeteer/bidi/version.rb

@@ -2,6 +2,6 @@
 
 module Puppeteer
   module Bidi
-    VERSION = "0.0.1.beta10"
+    VERSION = "0.0.1"
   end
 end

data/lib/puppeteer/bidi.rb

@@ -11,11 +11,14 @@ require "puppeteer/bidi/serializer"
 require "puppeteer/bidi/deserializer"
 require "puppeteer/bidi/injected_source"
 require "puppeteer/bidi/lazy_arg"
+require "puppeteer/bidi/cookie_utils"
 require "puppeteer/bidi/js_handle"
 require "puppeteer/bidi/keyboard"
 require "puppeteer/bidi/mouse"
+require "puppeteer/bidi/http_request"
 require "puppeteer/bidi/http_response"
 require "puppeteer/bidi/element_handle"
+require "puppeteer/bidi/locator"
 require "puppeteer/bidi/query_handler"
 require "puppeteer/bidi/wait_task"
 require "puppeteer/bidi/realm"
@@ -38,9 +41,11 @@ module Puppeteer
     # @rbs headless: bool -- Run browser in headless mode
     # @rbs args: Array[String]? -- Additional browser arguments
     # @rbs timeout: Numeric? -- Launch timeout in seconds
+    # @rbs accept_insecure_certs: bool -- Accept insecure certificates
     # @rbs &block: (Browser) -> untyped -- Block to execute with the browser instance
     # @rbs return: untyped
-    def self.launch(executable_path: nil, user_data_dir: nil, headless: true, args: nil, timeout: nil, &block)
+    def self.launch(executable_path: nil, user_data_dir: nil, headless: true, args: nil, timeout: nil,
+                    accept_insecure_certs: false, &block)
       unless block
         raise ArgumentError, 'Block is required for launch_with_sync'
       end
@@ -52,7 +57,8 @@ module Puppeteer
             user_data_dir: user_data_dir,
             headless: headless,
             args: args,
-            timeout: timeout
+            timeout: timeout,
+            accept_insecure_certs: accept_insecure_certs
           )
           block.call(browser)
         ensure
@@ -67,22 +73,49 @@ module Puppeteer
     # @rbs headless: bool -- Run browser in headless mode
     # @rbs args: Array[String]? -- Additional browser arguments
     # @rbs timeout: Numeric? -- Launch timeout in seconds
+    # @rbs accept_insecure_certs: bool -- Accept insecure certificates
     # @rbs return: Browser -- Browser instance (if no block given)
-    def self.launch_browser_instance(executable_path: nil, user_data_dir: nil, headless: true, args: nil, timeout: nil)
+    def self.launch_browser_instance(executable_path: nil, user_data_dir: nil, headless: true, args: nil, timeout: nil,
+                                     accept_insecure_certs: false)
       Browser.launch(
         executable_path: executable_path,
         user_data_dir: user_data_dir,
         headless: headless,
         args: args,
-        timeout: timeout
+        timeout: timeout,
+        accept_insecure_certs: accept_insecure_certs
       )
     end
 
     # Connect to an existing browser instance
     # @rbs ws_endpoint: String -- WebSocket endpoint URL
+    # @rbs timeout: Numeric? -- Connect timeout in seconds
+    # @rbs accept_insecure_certs: bool -- Accept insecure certificates
+    # @rbs &block: (Browser) -> untyped -- Block to execute with the browser instance
+    # @rbs return: untyped
+    def self.connect(ws_endpoint, timeout: nil, accept_insecure_certs: false, &block)
+      unless block
+        raise ArgumentError, 'Block is required for connect_with_sync'
+      end
+
+      Sync do
+        begin
+          browser = connect_to_browser_instance(ws_endpoint, timeout: timeout,
+                                                accept_insecure_certs: accept_insecure_certs)
+          block.call(browser)
+        ensure
+          browser&.close
+        end
+      end
+    end
+
+    # Connect to an existing browser instance
+    # @rbs ws_endpoint: String -- WebSocket endpoint URL
+    # @rbs timeout: Numeric? -- Connect timeout in seconds
+    # @rbs accept_insecure_certs: bool -- Accept insecure certificates
     # @rbs return: Browser -- Browser instance
-    def self.connect(ws_endpoint)
-      Browser.connect(ws_endpoint)
+    def self.connect_to_browser_instance(ws_endpoint, timeout: nil, accept_insecure_certs: false)
+      Browser.connect(ws_endpoint, timeout: timeout, accept_insecure_certs: accept_insecure_certs)
     end
   end
 end

data/sig/puppeteer/bidi/browser.rbs

@@ -10,17 +10,22 @@ module Puppeteer
 
       attr_reader default_browser_context: BrowserContext
 
+      attr_reader ws_endpoint: String?
+
       # @rbs connection: Connection -- BiDi connection
       # @rbs launcher: BrowserLauncher? -- Browser launcher instance
+      # @rbs ws_endpoint: String? -- WebSocket endpoint URL
+      # @rbs accept_insecure_certs: bool -- Accept insecure certificates
       # @rbs return: Browser -- Browser instance
-      def self.create: (connection: Connection, ?launcher: BrowserLauncher?) -> Browser
+      def self.create: (connection: Connection, ?launcher: BrowserLauncher?, ?ws_endpoint: String?, ?accept_insecure_certs: bool) -> Browser
 
       # @rbs connection: Connection -- BiDi connection
       # @rbs launcher: BrowserLauncher? -- Browser launcher instance
       # @rbs core_browser: Core::Browser -- Core browser instance
       # @rbs session: Core::Session -- BiDi session
+      # @rbs ws_endpoint: String? -- WebSocket endpoint URL
       # @rbs return: void
-      def initialize: (connection: Connection, launcher: BrowserLauncher?, core_browser: Core::Browser, session: Core::Session) -> void
+      def initialize: (connection: Connection, launcher: BrowserLauncher?, core_browser: Core::Browser, session: Core::Session, ws_endpoint: String?) -> void
 
       # Launch a new Firefox browser instance
       # @rbs executable_path: String? -- Path to browser executable
@@ -28,26 +33,59 @@ module Puppeteer
       # @rbs headless: bool -- Run browser in headless mode
       # @rbs args: Array[String]? -- Additional browser arguments
       # @rbs timeout: Numeric? -- Launch timeout in seconds
+      # @rbs accept_insecure_certs: bool -- Accept insecure certificates
       # @rbs return: Browser -- Browser instance
-      def self.launch: (?executable_path: String?, ?user_data_dir: String?, ?headless: bool, ?args: Array[String]?, ?timeout: Numeric?) -> Browser
+      def self.launch: (?executable_path: String?, ?user_data_dir: String?, ?headless: bool, ?args: Array[String]?, ?timeout: Numeric?, ?accept_insecure_certs: bool) -> Browser
 
       # Connect to an existing Firefox browser instance
       # @rbs ws_endpoint: String -- WebSocket endpoint URL
+      # @rbs timeout: Numeric? -- Connect timeout in seconds
+      # @rbs accept_insecure_certs: bool -- Accept insecure certificates
       # @rbs return: Browser -- Browser instance
-      def self.connect: (String ws_endpoint) -> Browser
+      def self.connect: (String ws_endpoint, ?timeout: Numeric?, ?accept_insecure_certs: bool) -> Browser
 
       # Get BiDi session status
       # @rbs return: untyped -- Session status
       def status: () -> untyped
 
+      # Get the browser's original user agent
+      # @rbs return: String -- User agent string
+      def user_agent: () -> String
+
       # Create a new page (Puppeteer-like API)
       # @rbs return: Page -- New page instance
       def new_page: () -> Page
 
+      # Create a new browser context
+      # @rbs return: BrowserContext -- New browser context
+      def create_browser_context: () -> BrowserContext
+
       # Get all pages
       # @rbs return: Array[Page] -- All pages
       def pages: () -> Array[Page]
 
+      # Get all cookies in the default browser context.
+      # @rbs return: Array[Hash[String, untyped]] -- Cookies
+      def cookies: () -> Array[Hash[String, untyped]]
+
+      # Set cookies in the default browser context.
+      # @rbs *cookies: Array[Hash[String, untyped]] -- Cookie data
+      # @rbs **cookie: untyped -- Single cookie via keyword arguments
+      # @rbs return: void
+      def set_cookie: (*Array[Hash[String, untyped]] cookies, **untyped cookie) -> void
+
+      # Delete cookies in the default browser context.
+      # @rbs *cookies: Array[Hash[String, untyped]] -- Cookies to delete
+      # @rbs **cookie: untyped -- Single cookie via keyword arguments
+      # @rbs return: void
+      def delete_cookie: (*Array[Hash[String, untyped]] cookies, **untyped cookie) -> void
+
+      # Delete cookies matching the provided filters in the default browser context.
+      # @rbs *filters: Array[Hash[String, untyped]] -- Cookie filters
+      # @rbs **filter: untyped -- Single filter via keyword arguments
+      # @rbs return: void
+      def delete_matching_cookies: (*Array[Hash[String, untyped]] filters, **untyped filter) -> void
+
       # Register event handler
       # @rbs event: String | Symbol -- Event name
       # @rbs &block: (untyped) -> void -- Event handler
@@ -58,9 +96,16 @@ module Puppeteer
       # @rbs return: void
       def close: () -> void
 
+      # Disconnect from the browser (does not close the browser process).
+      # @rbs return: void
+      def disconnect: () -> void
+
       # @rbs return: bool
       def closed?: () -> bool
 
+      # @rbs return: bool
+      def disconnected?: () -> bool
+
       # Wait until a target (top-level browsing context) satisfies the predicate.
       # @rbs timeout: Integer? -- Timeout in milliseconds (default: 30000)
       # @rbs &predicate: (BrowserTarget | PageTarget | FrameTarget) -> boolish -- Predicate evaluated against each Target
@@ -73,6 +118,8 @@ module Puppeteer
 
       private
 
+      def debug_error: (untyped error) -> untyped
+
       # @rbs &block: (BrowserTarget | PageTarget | FrameTarget) -> void -- Block to yield each target to
       # @rbs return: Enumerator[BrowserTarget | PageTarget | FrameTarget, void] -- Enumerator of targets
       def each_target: () { (BrowserTarget | PageTarget | FrameTarget) -> void } -> Enumerator[BrowserTarget | PageTarget | FrameTarget, void]
@@ -82,8 +129,8 @@ module Puppeteer
       def find_target: (^(BrowserTarget | PageTarget | FrameTarget) -> boolish predicate) -> (BrowserTarget | PageTarget | FrameTarget)?
 
       # @rbs user_context: Core::UserContext -- User context to get browser context for
-      # @rbs return: BrowserContext? -- Browser context or nil
-      def browser_context_for: (Core::UserContext user_context) -> BrowserContext?
+      # @rbs return: BrowserContext -- Browser context
+      def browser_context_for: (Core::UserContext user_context) -> BrowserContext
     end
   end
 end

data/sig/puppeteer/bidi/browser_context.rbs

@@ -5,6 +5,10 @@ module Puppeteer
     # BrowserContext represents an isolated browsing session
     # This is a high-level wrapper around Core::UserContext
     class BrowserContext
+      # Maps web permission names to protocol permission names
+      # Based on Puppeteer's WEB_PERMISSION_TO_PROTOCOL_PERMISSION
+      WEB_PERMISSION_TO_PROTOCOL_PERMISSION: untyped
+
       attr_reader user_context: Core::UserContext
 
       attr_reader browser: Browser
@@ -22,11 +26,39 @@ module Puppeteer
       # @rbs return: Array[Page] -- All pages
       def pages: () -> Array[Page]
 
+      # Get all cookies in this context.
+      # @rbs return: Array[Hash[String, untyped]] -- Cookies
+      def cookies: () -> Array[Hash[String, untyped]]
+
+      # Set cookies in this context.
+      # @rbs *cookies: Array[Hash[String, untyped]] -- Cookie data
+      # @rbs **cookie: untyped -- Single cookie via keyword arguments
+      # @rbs return: void
+      def set_cookie: (*Array[Hash[String, untyped]] cookies, **untyped cookie) -> void
+
+      # Delete cookies in this context.
+      # @rbs *cookies: Array[Hash[String, untyped]] -- Cookies to delete
+      # @rbs **cookie: untyped -- Single cookie via keyword arguments
+      # @rbs return: void
+      def delete_cookie: (*Array[Hash[String, untyped]] cookies, **untyped cookie) -> void
+
+      # Delete cookies matching the provided filters.
+      # @rbs *filters: Array[Hash[String, untyped]] -- Cookie filters
+      # @rbs **filter: untyped -- Single cookie filter via keyword arguments
+      # @rbs return: void
+      def delete_matching_cookies: (*Array[Hash[String, untyped]] filters, **untyped filter) -> void
+
       # Get or create a Page for the given browsing context
       # @rbs browsing_context: Core::BrowsingContext -- Browsing context
       # @rbs return: Page -- Page instance
       def page_for: (Core::BrowsingContext browsing_context) -> Page
 
+      # Override permissions for an origin
+      # @rbs origin: String -- Origin URL
+      # @rbs permissions: Array[String] -- Permissions to grant
+      # @rbs return: void
+      def override_permissions: (String origin, Array[String] permissions) -> void
+
       # Close the browser context
       # @rbs return: void
       def close: () -> void
@@ -34,6 +66,10 @@ module Puppeteer
       # Check if context is closed
       # @rbs return: bool -- Whether the context is closed
       def closed?: () -> bool
+
+      private
+
+      def cookie_matches_filter?: (untyped cookie, untyped raw_filter) -> untyped
     end
   end
 end

data/sig/puppeteer/bidi/cookie_utils.rbs

@@ -0,0 +1,64 @@
+# Generated from lib/puppeteer/bidi/cookie_utils.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    module CookieUtils
+      CDP_SPECIFIC_PREFIX: ::String
+
+      # @rbs cookie: Hash[untyped, untyped] -- Cookie with symbol or string keys
+      # @rbs return: Hash[String, untyped] -- Cookie with string keys
+      def self.normalize_cookie_input: (Hash[untyped, untyped] cookie) -> Hash[String, untyped]
+
+      # @rbs bidi_cookie: Hash[String, untyped] -- BiDi cookie
+      # @rbs return_composite_partition_key: bool -- Whether to return composite partition key
+      # @rbs return: Hash[String, untyped] -- Puppeteer cookie
+      def self.bidi_to_puppeteer_cookie: (Hash[String, untyped] bidi_cookie, ?return_composite_partition_key: bool) -> Hash[String, untyped]
+
+      # @rbs same_site: String? -- BiDi SameSite value
+      # @rbs return: String -- Puppeteer SameSite
+      def self.convert_cookies_same_site_bidi_to_cdp: (String? same_site) -> String
+
+      # @rbs same_site: String? -- Puppeteer SameSite
+      # @rbs return: String? -- BiDi SameSite
+      def self.convert_cookies_same_site_cdp_to_bidi: (String? same_site) -> String?
+
+      # @rbs expiry: Numeric? -- Cookie expiry
+      # @rbs return: Numeric? -- BiDi expiry
+      def self.convert_cookies_expiry_cdp_to_bidi: (Numeric? expiry) -> Numeric?
+
+      # @rbs partition_key: String | Hash[String, untyped] | Hash[Symbol, untyped] | nil -- Partition key
+      # @rbs return: String? -- BiDi partition key
+      def self.convert_cookies_partition_key_from_puppeteer_to_bidi: (String | Hash[String, untyped] | Hash[Symbol, untyped] | nil partition_key) -> String?
+
+      # @rbs cookie: Hash[String, untyped] -- Cookie data
+      # @rbs *property_names: Array[String] -- Cookie property names
+      # @rbs return: Hash[String, untyped] -- CDP-specific properties with goog: prefix
+      def self.cdp_specific_cookie_properties_from_puppeteer_to_bidi: (Hash[String, untyped] cookie, *Array[String] property_names) -> Hash[String, untyped]
+
+      # @rbs cookie: Hash[String, untyped] -- BiDi cookie data
+      # @rbs *property_names: Array[String] -- Cookie property names
+      # @rbs return: Hash[String, untyped] -- CDP-specific properties
+      def self.cdp_specific_cookie_properties_from_bidi: (Hash[String, untyped] cookie, *Array[String] property_names) -> Hash[String, untyped]
+
+      # @rbs cookie: Hash[String, untyped] -- Puppeteer cookie
+      # @rbs normalized_url: URI::Generic -- URL to match
+      # @rbs return: bool -- Whether cookie matches URL
+      def self.test_url_match_cookie: (Hash[String, untyped] cookie, URI::Generic normalized_url) -> bool
+
+      # @rbs cookie: Hash[String, untyped] -- Puppeteer cookie
+      # @rbs normalized_url: URI::Generic -- URL to match
+      # @rbs return: bool -- Whether hostname matches
+      def self.test_url_match_cookie_hostname: (Hash[String, untyped] cookie, URI::Generic normalized_url) -> bool
+
+      # @rbs cookie: Hash[String, untyped] -- Puppeteer cookie
+      # @rbs normalized_url: URI::Generic -- URL to match
+      # @rbs return: bool -- Whether path matches
+      def self.test_url_match_cookie_path: (Hash[String, untyped] cookie, URI::Generic normalized_url) -> bool
+
+      # @rbs partition_key: untyped -- BiDi partition key
+      # @rbs return_composite_partition_key: bool -- Whether to return composite partition key
+      # @rbs return: Hash[String, untyped] -- Partition key info
+      def self.partition_key_from_bidi: (untyped partition_key, bool return_composite_partition_key) -> Hash[String, untyped]
+    end
+  end
+end

data/sig/puppeteer/bidi/core/browsing_context.rbs

@@ -128,13 +128,18 @@ module Puppeteer
 
         # Add network intercept
         # @rbs **options: untyped -- Intercept options
-        # @rbs return: String -- Intercept ID
-        def add_intercept: (**untyped options) -> String
+        # @rbs return: Async::Task[String] -- Intercept ID
+        def add_intercept: (**untyped options) -> Async::Task[String]
+
+        # Set extra HTTP headers for this context
+        # @rbs headers: Hash[String, String] -- Extra headers
+        # @rbs return: Async::Task[untyped]
+        def set_extra_http_headers: (Hash[String, String] headers) -> Async::Task[untyped]
 
         # Get cookies
         # @rbs **options: untyped -- Cookie filter options
-        # @rbs return: Array[Hash[String, untyped]] -- Cookies
-        def get_cookies: (**untyped options) -> Array[Hash[String, untyped]]
+        # @rbs return: Async::Task[Array[Hash[String, untyped]]] -- Cookies
+        def get_cookies: (**untyped options) -> Async::Task[Array[Hash[String, untyped]]]
 
         # Set a cookie
         # @rbs cookie: Hash[String, untyped] -- Cookie data
@@ -143,14 +148,19 @@ module Puppeteer
 
         # Delete cookies
         # @rbs *cookie_filters: Hash[String, untyped] -- Cookie filters
-        # @rbs return: void
-        def delete_cookie: (*Hash[String, untyped] cookie_filters) -> void
+        # @rbs return: Async::Task[untyped]
+        def delete_cookie: (*Hash[String, untyped] cookie_filters) -> Async::Task[untyped]
 
         # Set geolocation override
         # @rbs **options: untyped -- Geolocation options
         # @rbs return: Async::Task[untyped]
         def set_geolocation_override: (**untyped options) -> Async::Task[untyped]
 
+        # Set user agent override
+        # @rbs user_agent: String? -- User agent string or nil to restore original
+        # @rbs return: Async::Task[void]
+        def set_user_agent: (String? user_agent) -> Async::Task[void]
+
         # Set timezone override
         # @rbs timezone_id: String? -- Timezone ID
         # @rbs return: Async::Task[untyped]

data/sig/puppeteer/bidi/core/request.rbs

@@ -5,6 +5,8 @@ module Puppeteer
     module Core
       # Request represents a network request
       class Request < EventEmitter
+        DESTINATION_RESOURCE_TYPES: untyped
+
         include Disposable::DisposableMixin
 
         # Create a request instance from a beforeRequestSent event
@@ -79,33 +81,34 @@ module Puppeteer
         # @rbs headers: Array[Hash[String, untyped]]? -- Modified headers
         # @rbs cookies: Array[Hash[String, untyped]]? -- Modified cookies
         # @rbs body: Hash[String, untyped]? -- Modified body
-        # @rbs return: untyped
-        def continue_request: (?url: String?, ?method: String?, ?headers: Array[Hash[String, untyped]]?, ?cookies: Array[Hash[String, untyped]]?, ?body: Hash[String, untyped]?) -> untyped
+        # @rbs return: Async::Task[untyped]
+        def continue_request: (?url: String?, ?method: String?, ?headers: Array[Hash[String, untyped]]?, ?cookies: Array[Hash[String, untyped]]?, ?body: Hash[String, untyped]?) -> Async::Task[untyped]
 
         # Fail the request
-        def fail_request: () -> untyped
+        # @rbs return: Async::Task[untyped]
+        def fail_request: () -> Async::Task[untyped]
 
         # Provide a response for the request
         # @rbs status_code: Integer? -- Response status code
         # @rbs reason_phrase: String? -- Response reason phrase
         # @rbs headers: Array[Hash[String, untyped]]? -- Response headers
         # @rbs body: Hash[String, untyped]? -- Response body
-        # @rbs return: untyped
-        def provide_response: (?status_code: Integer?, ?reason_phrase: String?, ?headers: Array[Hash[String, untyped]]?, ?body: Hash[String, untyped]?) -> untyped
+        # @rbs return: Async::Task[untyped]
+        def provide_response: (?status_code: Integer?, ?reason_phrase: String?, ?headers: Array[Hash[String, untyped]]?, ?body: Hash[String, untyped]?) -> Async::Task[untyped]
 
         # Fetch POST data for the request
-        # @rbs return: String? -- POST data
-        def fetch_post_data: () -> String?
+        # @rbs return: Async::Task[String?] -- POST data
+        def fetch_post_data: () -> Async::Task[String?]
 
         # Get response content
-        # @rbs return: String -- Response content as binary string
-        def response_content: () -> String
+        # @rbs return: Async::Task[String] -- Response content as binary string
+        def response_content: () -> Async::Task[String]
 
         # Continue with authentication
         # @rbs action: String -- 'provideCredentials', 'default', or 'cancel'
         # @rbs credentials: Hash[String, untyped]? -- Credentials hash with username and password
-        # @rbs return: untyped
-        def continue_with_auth: (action: String, ?credentials: Hash[String, untyped]?) -> untyped
+        # @rbs return: Async::Task[untyped]
+        def continue_with_auth: (action: String, ?credentials: Hash[String, untyped]?) -> Async::Task[untyped]
 
         def perform_dispose: () -> untyped
 

data/sig/puppeteer/bidi/core/user_context.rbs

@@ -41,8 +41,8 @@ module Puppeteer
 
         # Get cookies for this user context
         # @rbs source_origin: String? -- Source origin
-        # @rbs return: Array[Hash[String, untyped]] -- Cookies
-        def get_cookies: (**untyped options) -> Array[Hash[String, untyped]]
+        # @rbs return: Async::Task[Array[Hash[String, untyped]]] -- Cookies
+        def get_cookies: (**untyped options) -> Async::Task[Array[Hash[String, untyped]]]
 
         # Set a cookie in this user context
         # @rbs cookie: Hash[String, untyped] -- Cookie data

data/sig/puppeteer/bidi/element_handle.rbs

@@ -160,6 +160,13 @@ module Puppeteer
       # @rbs return: void
       def focus: () -> void
 
+      # Select options on a <select> element
+      # Triggers 'change' and 'input' events once all options are selected.
+      # If not a select element, throws an error.
+      # @rbs *values: String -- Option values to select
+      # @rbs return: Array[String] -- Actually selected option values
+      def select: (*String values) -> Array[String]
+
       # Hover over the element
       # Scrolls element into view if needed and moves mouse to element center
       # @rbs return: void
@@ -183,6 +190,19 @@ module Puppeteer
       # @rbs return: void
       def scroll_into_view: () -> void
 
+      # Create a locator based on this element handle.
+      # @rbs return: Locator -- Locator instance
+      def as_locator: () -> Locator
+
+      # Take a screenshot of the element.
+      # Following Puppeteer's implementation: ElementHandle.screenshot
+      # @rbs path: String? -- File path to save screenshot
+      # @rbs type: String -- Image type ('png' or 'jpeg')
+      # @rbs clip: Hash[Symbol, Numeric]? -- Clip region relative to element
+      # @rbs scroll_into_view: bool -- Scroll element into view before screenshot
+      # @rbs return: String -- Base64-encoded image data
+      def screenshot: (?path: String?, ?type: String, ?clip: Hash[Symbol, Numeric]?, ?scroll_into_view: bool) -> String
+
       # Check if element is intersecting the viewport
       # @rbs threshold: Numeric -- Intersection ratio threshold
       # @rbs return: bool -- Whether element intersects viewport
@@ -230,6 +250,14 @@ module Puppeteer
       # @rbs return: bool -- Whether element matches visibility state
       def check_visibility: (bool visible) -> bool
 
+      # Get bounding box ensuring it's non-empty and visible
+      # @rbs return: BoundingBox -- Non-empty bounding box
+      def non_empty_visible_bounding_box: () -> BoundingBox
+
+      # Get top-left corner offset of the element's frame relative to the main frame
+      # @rbs return: Hash[Symbol, Numeric]? -- Offset hash or nil if not visible
+      def top_left_corner_of_frame: () -> Hash[Symbol, Numeric]?
+
       # String representation includes element type
       # @rbs return: String -- String representation
       def to_s: () -> String

data/sig/puppeteer/bidi/errors.rbs

@@ -30,5 +30,9 @@ module Puppeteer
     # Raised when a timeout occurs (e.g., navigation timeout)
     class TimeoutError < Error
     end
+
+    # Raised when an operation is unsupported in this environment
+    class UnsupportedOperationError < Error
+    end
   end
 end

data/sig/puppeteer/bidi/frame.rbs

@@ -64,6 +64,12 @@ module Puppeteer
       # @rbs return: Array[ElementHandle] -- All matching elements
       def query_selector_all: (String selector) -> Array[ElementHandle]
 
+      # Create a locator for a selector or function.
+      # @rbs selector: String? -- Selector to locate
+      # @rbs function: String? -- JavaScript function for function locator
+      # @rbs return: Locator -- Locator instance
+      def locator: (?String? selector, ?function: String?) -> Locator
+
       # Evaluate a function on the first element matching the selector
       # @rbs selector: String -- Selector to query
       # @rbs page_function: String -- JavaScript function to evaluate
@@ -99,6 +105,13 @@ module Puppeteer
       # @rbs return: void
       def hover: (String selector) -> void
 
+      # Select options on a <select> element matching the selector
+      # Triggers 'change' and 'input' events once all options are selected.
+      # @rbs selector: String -- Selector for <select> element
+      # @rbs *values: String -- Option values to select
+      # @rbs return: Array[String] -- Actually selected option values
+      def select: (String selector, *String values) -> Array[String]
+
       # Get the frame URL
       # @rbs return: String -- Current URL
       def url: () -> String
@@ -200,6 +213,10 @@ module Puppeteer
       # Check if this frame is detached and raise error if so
       # @rbs return: void
       def assert_not_detached: () -> void
+
+      def navigation_response_for: (untyped navigation) -> untyped
+
+      def wait_for_request_completion: (untyped request) -> untyped
     end
   end
 end