puppeteer-ruby 0.52.1 → 0.53.0

data/lib/puppeteer/web_worker.rb

@@ -8,8 +8,12 @@ class Puppeteer::WorkerWorld
   def initialize(client)
     @client = client
     @context_promise = Async::Promise.new
+    @task_manager = Puppeteer::TaskManager.new
+    @disposed = false
   end
 
+  attr_reader :task_manager
+
   # @rbs context: Puppeteer::ExecutionContext -- Execution context to bind
   # @rbs return: void -- No return value
   def set_context(context)
@@ -18,6 +22,11 @@ class Puppeteer::WorkerWorld
 
   # @rbs return: Puppeteer::ExecutionContext -- Worker execution context
   def execution_context
+    if @disposed
+      raise Puppeteer::WaitTask::TerminatedError.new(
+        'waitForFunction failed: worker got detached.',
+      )
+    end
     @context_promise.wait
   end
 
@@ -39,6 +48,30 @@ class Puppeteer::WorkerWorld
 
   define_async_method :async_evaluate_handle
 
+  # @rbs page_function: String -- Function or expression to evaluate
+  # @rbs args: Array[untyped] -- Arguments for evaluation
+  # @rbs polling: (Integer | String)? -- Polling interval or mode
+  # @rbs timeout: Integer? -- Maximum wait time in milliseconds
+  # @rbs return: Puppeteer::JSHandle -- Handle to the truthy evaluation result
+  def wait_for_function(page_function, args: [], polling: nil, timeout: nil)
+    runner = lambda do
+      wait_task = Puppeteer::WaitTask.new(
+        dom_world: self,
+        predicate_body: page_function,
+        title: 'function',
+        polling: polling || 100,
+        timeout: timeout.nil? ? 30_000 : timeout,
+        args: args,
+      )
+      wait_task.await_promise
+    end
+    return runner.call if Async::Task.current?
+
+    Sync { runner.call }
+  end
+
+  define_async_method :async_wait_for_function
+
   # @rbs return: nil -- Workers do not have frames
   def frame
     nil
@@ -46,7 +79,18 @@ class Puppeteer::WorkerWorld
 
   # @rbs return: void -- Dispose world resources
   def dispose
-    @context_promise = Async::Promise.new
+    return if @disposed
+
+    @disposed = true
+    error = Puppeteer::WaitTask::TerminatedError.new(
+      'waitForFunction failed: worker got detached.',
+    )
+    @context_promise.reject(error) unless @context_promise.resolved?
+    @task_manager.terminate_all(error)
+  end
+
+  def detached?
+    @disposed
   end
 end
 
@@ -96,6 +140,22 @@ class Puppeteer::WebWorker
 
   define_async_method :async_evaluate_handle
 
+  # @rbs page_function: String -- Function or expression to evaluate
+  # @rbs args: Array[untyped] -- Arguments for evaluation
+  # @rbs polling: (Integer | String)? -- Polling interval or mode
+  # @rbs timeout: Integer? -- Maximum wait time in milliseconds
+  # @rbs return: Puppeteer::JSHandle -- Handle to the truthy evaluation result
+  def wait_for_function(page_function, args: [], polling: nil, timeout: nil)
+    main_realm.wait_for_function(
+      page_function,
+      args: args,
+      polling: polling || 100,
+      timeout: timeout.nil? ? @timeout_settings.timeout : timeout,
+    )
+  end
+
+  define_async_method :async_wait_for_function
+
   # @rbs return: void -- Not supported
   def close
     raise Puppeteer::Error.new('WebWorker.close() is not supported')
@@ -118,14 +178,29 @@ class Puppeteer::CdpWebWorker < Puppeteer::WebWorker
     @target_id = target_id
     @target_type = target_type
     @world = Puppeteer::WorkerWorld.new(@client)
+    @worker_loaded_promise = Async::Promise.new
 
     @client.once('Runtime.executionContextCreated') do |event|
       @world.set_context(Puppeteer::ExecutionContext.new(@client, event['context'], @world))
     end
-    if console_api_called
-      @client.on_event('Runtime.consoleAPICalled') do |event|
-        console_api_called.call(@world, event)
+    @client.once('Inspector.workerScriptLoaded') do
+      @worker_loaded_promise.resolve(nil) unless @worker_loaded_promise.resolved?
+    end
+    @client.on_event('Runtime.consoleAPICalled') do |event|
+      values = event['args'].map do |arg|
+        remote_object = Puppeteer::RemoteObject.new(arg)
+        Puppeteer::JSHandle.create(context: @world.execution_context, remote_object: remote_object)
       end
+      console_api_called&.call(@world, event)
+      emit_event(
+        'console',
+        Puppeteer::ConsoleMessage.new(
+          event['type'],
+          values.map { |value| console_value_from_js_handle(value) }.join(' '),
+          values,
+          console_message_locations(event['stackTrace']),
+        ),
+      )
     end
     if exception_thrown
       @client.on_event('Runtime.exceptionThrown') do |event|
@@ -138,11 +213,9 @@ class Puppeteer::CdpWebWorker < Puppeteer::WebWorker
 
     if network_manager
       Async do
-        begin
-          network_manager.add_client(@client)
-        rescue => err
-          debug_puts(err)
-        end
+        network_manager.add_client(@client)
+      rescue => err
+        debug_puts(err)
       end
     end
 
@@ -159,6 +232,59 @@ class Puppeteer::CdpWebWorker < Puppeteer::WebWorker
     @client
   end
 
+  # @rbs page_function: String -- Function or expression to evaluate
+  # @rbs args: Array[untyped] -- Arguments for evaluation
+  # @rbs return: untyped -- Evaluation result
+  def evaluate(page_function, *args)
+    @worker_loaded_promise.wait
+    super
+  end
+
+  # @rbs page_function: String -- Function or expression to evaluate
+  # @rbs args: Array[untyped] -- Arguments for evaluation
+  # @rbs return: Puppeteer::JSHandle -- Handle to evaluation result
+  def evaluate_handle(page_function, *args)
+    @worker_loaded_promise.wait
+    super
+  end
+
+  # @rbs page_function: String -- Function or expression to evaluate
+  # @rbs args: Array[untyped] -- Arguments for evaluation
+  # @rbs polling: (Integer | String)? -- Polling interval or mode
+  # @rbs timeout: Integer? -- Maximum wait time in milliseconds
+  # @rbs return: Puppeteer::JSHandle -- Handle to the truthy evaluation result
+  def wait_for_function(page_function, args: [], polling: nil, timeout: nil)
+    @worker_loaded_promise.wait
+    super
+  end
+
+  private def console_value_from_js_handle(handle)
+    remote_object = handle.remote_object
+    return remote_object.value unless remote_object.object_id?
+
+    description = remote_object.description.to_s
+    if remote_object.sub_type == 'error' && !description.empty?
+      newline_index = description.index("\n")
+      return newline_index ? description[0...newline_index] : description
+    end
+
+    type = remote_object.sub_type || remote_object.type
+    class_name = remote_object.class_name || remote_object.description || 'Object'
+    "[#{type} #{class_name}]"
+  end
+
+  private def console_message_locations(stack_trace)
+    return [] unless stack_trace && stack_trace['callFrames']
+
+    stack_trace['callFrames'].map do |call_frame|
+      Puppeteer::ConsoleMessage::Location.new(
+        url: call_frame['url'],
+        line_number: call_frame['lineNumber'],
+        column_number: call_frame['columnNumber'],
+      )
+    end
+  end
+
   # @rbs return: void -- Close the worker
   def close
     connection = @client.connection

data/lib/puppeteer.rb

@@ -1,4 +1,11 @@
-require "async"
+require 'async'
+begin
+  require 'urlpattern'
+rescue LoadError
+  # urlpattern 0.1.1's precompiled gems do not load their versioned extension
+  # through the public entrypoint. Source-built gems use the public entrypoint.
+  require "urlpattern/#{RUBY_VERSION[/\A\d+\.\d+/]}/urlpattern"
+end
 require 'puppeteer/console_patch'
 
 # Check for Ruby versions affected by https://bugs.ruby-lang.org/issues/20907
@@ -36,6 +43,7 @@ require "puppeteer/reactor_runner"
 
 # Classes & values.
 require 'puppeteer/aria_query_handler'
+require 'puppeteer/accessibility'
 require 'puppeteer/browser'
 require 'puppeteer/browser_context'
 require 'puppeteer/browser_runner'
@@ -76,6 +84,7 @@ require 'puppeteer/p_selector_parser'
 require 'puppeteer/p_query_handler'
 require 'puppeteer/query_handler_manager'
 require 'puppeteer/remote_object'
+require 'puppeteer/screen_recorder'
 require 'puppeteer/target'
 require 'puppeteer/task_manager'
 require 'puppeteer/tracing'
@@ -85,6 +94,7 @@ require 'puppeteer/touch_handle'
 require 'puppeteer/touch_screen'
 require 'puppeteer/version'
 require 'puppeteer/wait_task'
+require 'puppeteer/web_mcp'
 require 'puppeteer/web_worker'
 require 'puppeteer/web_socket_transport'
 

data/puppeteer-ruby.gemspec

@@ -28,6 +28,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "async-websocket", ">= 0.27", "< 1.0"
   spec.add_dependency 'base64'
   spec.add_dependency 'mime-types', '>= 3.0'
+  spec.add_dependency 'urlpattern', '~> 0.1.1'
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'chunky_png'
   spec.add_development_dependency 'dry-inflector'

data/sig/_supplementary.rbs

@@ -175,10 +175,14 @@ class Puppeteer::FrameManager
   def handle_execution_context_destroyed: (Integer execution_context_id, Puppeteer::CDPSession session) -> void
   def handle_execution_contexts_cleared: (Puppeteer::CDPSession session) -> void
   def execution_context_by_id: (Integer context_id, Puppeteer::CDPSession session) -> Puppeteer::ExecutionContext
+  def swap_frame_tree: (Puppeteer::CDPSession client) -> void
+  def register_speculative_session: (Puppeteer::CDPSession client) -> void
 
   private
 
   def setup_listeners: (Puppeteer::CDPSession client) -> void
+  def setup_client_disconnect_listener: (Puppeteer::CDPSession client) -> void
+  def handle_client_disconnect: (Puppeteer::CDPSession client) -> void
   def init: (String target_id, ?Puppeteer::CDPSession cdp_session) -> void
   def with_frame_tree_handled: () { () -> void } -> void
   def prepare_frame_tree_handling: () -> void
@@ -191,7 +195,6 @@ class Puppeteer::FrameManager
   def assert_no_legacy_navigation_options: (wait_until: (String | Array[String] | nil)) -> void
   def extension_origin?: (untyped origin) -> bool
   def extract_extension_id: (untyped origin) -> String?
-  def maybe_setup_block_list: (Puppeteer::CDPSession client) -> void
   def blocked_url?: (String? url) -> bool
 end
 
@@ -219,6 +222,7 @@ class Puppeteer::Target
   def closed_callback: () -> void
   def ignore_initialize_callback_promise: () -> void
   def initialized?: () -> bool
+  def exposed?: () -> bool
   def session: () -> Puppeteer::CDPSession?
   def create_cdp_session: () -> Puppeteer::CDPSession
   def target_manager: () -> untyped
@@ -277,6 +281,10 @@ class Puppeteer::Connection
   include Puppeteer::DebugPrint
   include Puppeteer::EventCallbackable
 
+  class ProtocolError < Puppeteer::Error
+    def initialize: (method: String, error_message: String, ?error_data: untyped) -> void
+  end
+
   def initialize: (String url, Puppeteer::WebSocketTransport transport, ?Numeric delay, ?protocol_timeout: Numeric?) -> void
   def closed?: () -> bool
   def self.from_session: (Puppeteer::CDPSession session) -> Puppeteer::Connection?
@@ -291,6 +299,7 @@ class Puppeteer::Connection
   def dispose: () -> void
   def auto_attached?: (String target_id) -> bool
   def create_session: (untyped target_info, ?auto_attach_emulated: bool) -> Puppeteer::CDPSession
+  def ensure_command_allowed!: (String method) -> void
 
   private
 
@@ -305,6 +314,29 @@ class Puppeteer::Connection
   def handle_close: () -> void
 end
 
+class Puppeteer::TargetCloseError < Puppeteer::Connection::ProtocolError
+end
+
+module Puppeteer::Launcher
+  def new: (project_root: untyped, preferred_revision: untyped, is_puppeteer_core: untyped, product: untyped) -> Puppeteer::Launcher::Chrome
+  def self.new: (project_root: untyped, preferred_revision: untyped, is_puppeteer_core: untyped, product: untyped) -> Puppeteer::Launcher::Chrome
+end
+
+class Puppeteer::Launcher::Chrome
+  def self.get_features: (String flag, ?Array[String] options) -> Array[String]
+  def self.remove_matching_flags: (Array[String] array, String flag) -> Array[String]
+  def initialize: (project_root: untyped, preferred_revision: untyped, is_puppeteer_core: untyped) -> void
+  def launch: (?Hash[Symbol, untyped] options) -> Puppeteer::Browser
+  def default_args: (?Hash[Symbol, untyped]? options) -> untyped
+  def executable_path: (?channel: (String | Symbol)?) -> String
+  def product: () -> String
+
+  private
+
+  def fallback_executable_path: () -> String
+  def executable_path_for_channel: (String channel) -> String
+end
+
 class Puppeteer::BrowserRunner
   def initialize: (String executable_path, Array[String] process_arguments, String user_data_dir, bool using_temp_user_data_dir) -> void
   def start: (?executable_path: String?, ?ignore_default_args: Array[String]?, ?handle_SIGINT: bool?, ?handle_SIGTERM: bool?, ?handle_SIGHUP: bool?, ?timeout: Integer?, ?dumpio: bool?, ?env: Hash[String, String]?, ?pipe: bool?) -> void

data/sig/puppeteer/accessibility.rbs

@@ -0,0 +1,73 @@
+# Generated from lib/puppeteer/accessibility.rb with RBS::Inline
+
+class Puppeteer::Accessibility
+  class SerializedAXNode < Hash[String, untyped]
+    # @rbs values: Hash[String, untyped] -- Serialized node values
+    # @rbs element_handle_resolver: Proc -- Resolver for the backing element
+    def initialize: (Hash[String, untyped] values, Proc element_handle_resolver) -> untyped
+
+    # @rbs return: Puppeteer::ElementHandle? -- Backing element, if available
+    def element_handle: () -> Puppeteer::ElementHandle?
+  end
+
+  # @rbs frame: Puppeteer::Frame -- Frame whose accessibility tree is inspected
+  def initialize: (Puppeteer::Frame frame) -> untyped
+
+  # @rbs interesting_only: bool -- Prune uninteresting nodes
+  # @rbs include_iframes: bool -- Include descendant iframe trees
+  # @rbs root: Puppeteer::ElementHandle? -- Optional root node
+  # @rbs return: SerializedAXNode? -- Accessibility snapshot
+  def snapshot: (?interesting_only: bool, ?include_iframes: bool, ?root: Puppeteer::ElementHandle?) -> SerializedAXNode?
+
+  private def describe_backend_node: (untyped root) -> untyped
+
+  private def populate_iframes: (untyped root, interesting_only: untyped) -> untyped
+
+  private def serialize_tree: (untyped node, ?untyped interesting_nodes) -> untyped
+
+  private def collect_interesting_nodes: (untyped collection, untyped node, untyped inside_control) -> untyped
+
+  class AXNode
+    CONTROL_ROLES: untyped
+
+    LANDMARK_ROLES: untyped
+
+    LEAF_ROLES: untyped
+
+    TEXT_ROLES: untyped
+
+    # @rbs frame: Puppeteer::Frame -- Owning frame
+    # @rbs payload: Hash[String, untyped] -- CDP AX node payload
+    def initialize: (Puppeteer::Frame frame, Hash[String, untyped] payload) -> untyped
+
+    attr_reader payload: untyped
+
+    attr_reader children: untyped
+
+    attr_reader role: untyped
+
+    attr_accessor iframe_snapshot: untyped
+
+    def find: () ?{ (?) -> untyped } -> untyped
+
+    def leaf_node?: () -> untyped
+
+    def control?: () -> untyped
+
+    def landmark?: () -> untyped
+
+    def interesting?: (untyped inside_control) -> untyped
+
+    def serialize: () -> untyped
+
+    def self.create_tree: (untyped frame, untyped payloads) -> untyped
+
+    private def read_properties: () -> untyped
+
+    private def plain_text_field?: () -> untyped
+
+    private def has_focusable_child?: () -> untyped
+
+    private def element_handle: () -> untyped
+  end
+end

data/sig/puppeteer/browser.rbs

@@ -15,12 +15,13 @@ class Puppeteer::Browser
   # @rbs network_enabled: bool -- Whether network events are enabled
   # @rbs issues_enabled: bool -- Whether issues events are enabled
   # @rbs block_list: Array[String]? -- URL block list patterns
+  # @rbs allow_list: Array[String]? -- URL allow list patterns
   # @rbs process: Puppeteer::BrowserRunner::BrowserProcess? -- Browser process handle
   # @rbs close_callback: Proc -- Close callback
   # @rbs target_filter_callback: Proc? -- Target filter callback
   # @rbs is_page_target_callback: Proc? -- Page target predicate
   # @rbs return: Puppeteer::Browser -- Browser instance
-  def self.create: (product: String?, connection: Puppeteer::Connection, context_ids: Array[String], ignore_https_errors: bool, default_viewport: Puppeteer::Viewport?, process: Puppeteer::BrowserRunner::BrowserProcess?, close_callback: Proc, target_filter_callback: Proc?, is_page_target_callback: Proc?, ?network_enabled: bool, ?issues_enabled: bool, ?block_list: Array[String]?) -> Puppeteer::Browser
+  def self.create: (product: String?, connection: Puppeteer::Connection, context_ids: Array[String], ignore_https_errors: bool, default_viewport: Puppeteer::Viewport?, process: Puppeteer::BrowserRunner::BrowserProcess?, close_callback: Proc, target_filter_callback: Proc?, is_page_target_callback: Proc?, ?network_enabled: bool, ?issues_enabled: bool, ?block_list: Array[String]?, ?allow_list: Array[String]?) -> Puppeteer::Browser
 
   # @rbs product: String? -- Browser product (chrome only)
   # @rbs connection: Puppeteer::Connection -- CDP connection
@@ -30,15 +31,18 @@ class Puppeteer::Browser
   # @rbs network_enabled: bool -- Whether network events are enabled
   # @rbs issues_enabled: bool -- Whether issues events are enabled
   # @rbs block_list: Array[String]? -- URL block list patterns
+  # @rbs allow_list: Array[String]? -- URL allow list patterns
   # @rbs process: Puppeteer::BrowserRunner::BrowserProcess? -- Browser process handle
   # @rbs close_callback: Proc -- Close callback
   # @rbs target_filter_callback: Proc? -- Target filter callback
   # @rbs is_page_target_callback: Proc? -- Page target predicate
   # @rbs return: void -- No return value
-  def initialize: (product: String?, connection: Puppeteer::Connection, context_ids: Array[String], ignore_https_errors: bool, default_viewport: Puppeteer::Viewport?, process: Puppeteer::BrowserRunner::BrowserProcess?, close_callback: Proc, target_filter_callback: Proc?, is_page_target_callback: Proc?, ?network_enabled: bool, ?issues_enabled: bool, ?block_list: Array[String]?) -> void
+  def initialize: (product: String?, connection: Puppeteer::Connection, context_ids: Array[String], ignore_https_errors: bool, default_viewport: Puppeteer::Viewport?, process: Puppeteer::BrowserRunner::BrowserProcess?, close_callback: Proc, target_filter_callback: Proc?, is_page_target_callback: Proc?, ?network_enabled: bool, ?issues_enabled: bool, ?block_list: Array[String]?, ?allow_list: Array[String]?) -> void
 
   private def default_target_filter_callback: (untyped target_info) -> untyped
 
+  private def validate_allow_list_version: () -> untyped
+
   private def default_is_page_target_callback: (untyped target_info) -> untyped
 
   attr_reader is_page_target_callback: untyped
@@ -120,6 +124,8 @@ class Puppeteer::Browser
   # @rbs return: Puppeteer::Page -- Created page
   def create_page_in_context: (String? context_id) -> Puppeteer::Page
 
+  private def wait_for_available_target: (untyped target_id) -> untyped
+
   # All active targets inside the Browser. In case of multiple browser contexts, returns
   # an array with all the targets in all browser contexts.
   # @rbs return: Array[Puppeteer::Target] -- Active targets
@@ -146,13 +152,24 @@ class Puppeteer::Browser
   # @rbs return: String -- Browser user agent string
   def user_agent: () -> String
 
+  private def version_info: () -> untyped
+
   # @rbs page_target_id: String -- Page target id
   # @rbs return: String? -- DevTools target id for page
   def _has_devtools_target: (String page_target_id) -> String?
 
+  # @rbs page_target_id: String -- Inspected page target id
+  # @rbs return: Puppeteer::Page -- DevTools page
+  def _create_devtools_page: (String page_target_id) -> Puppeteer::Page
+
+  # @rbs devtools_target_id: String -- DevTools target id
+  # @rbs return: Puppeteer::Page -- DevTools page
+  def _get_devtools_target_page: (String devtools_target_id) -> Puppeteer::Page
+
   # @rbs path: String -- Extension path
+  # @rbs enabled_in_incognito: bool -- Enable in Incognito and OTR profiles
   # @rbs return: String -- Installed extension id
-  def install_extension: (String path) -> String
+  def install_extension: (String path, ?enabled_in_incognito: bool) -> String
 
   # @rbs extension_id: String -- Extension id
   # @rbs return: void -- No return value
@@ -167,6 +184,13 @@ class Puppeteer::Browser
   # @rbs return: Array[String]? -- URL block list patterns
   def block_list: () -> Array[String]?
 
+  # @rbs return: Array[String]? -- URL allow list patterns
+  def allow_list: () -> Array[String]?
+
+  # @rbs url: String -- URL to validate against network restriction rules
+  # @rbs return: bool -- Whether the URL is allowed
+  def url_allowed?: (String url) -> bool
+
   # @rbs return: void -- No return value
   def close: () -> void
 

data/sig/puppeteer/cdp_session.rbs

@@ -40,6 +40,10 @@ class Puppeteer::CDPSession
   # @rbs return: Async::Promise[Hash[String, untyped]] -- Async CDP response
   def async_send_message: (String method, ?Hash[String, untyped] params) -> Async::Promise[Hash[String, untyped]]
 
+  # @rbs id: Integer -- CDP command id
+  # @rbs return: bool -- True when the session owns the callback
+  def callback?: (Integer id) -> bool
+
   # @rbs message: Hash[String, untyped] -- Raw CDP message
   # @rbs return: void -- No return value
   def handle_message: (Hash[String, untyped] message) -> void

data/sig/puppeteer/dialog.rbs

@@ -13,6 +13,9 @@ class Puppeteer::Dialog
 
   attr_reader default_value: String
 
+  # @rbs return: bool -- Whether the dialog has already been handled
+  def handled?: () -> bool
+
   # @rbs prompt_text: String? -- Text entered into the prompt
   # @rbs return: void -- No return value
   def accept: (?String? prompt_text) -> void

data/sig/puppeteer/element_handle.rbs

@@ -166,11 +166,10 @@ class Puppeteer::ElementHandle < Puppeteer::JSHandle
 
   # @rbs delay: Numeric? -- Delay between down and up (ms)
   # @rbs button: String? -- Mouse button
-  # @rbs click_count: Integer? -- Deprecated: use count (click_count only sets clickCount)
   # @rbs count: Integer? -- Number of clicks to perform
   # @rbs offset: Puppeteer::ElementHandle::Offset | Hash[Symbol, Numeric] | nil -- Click offset
   # @rbs return: void -- No return value
-  def click: (?delay: Numeric?, ?button: String?, ?click_count: Integer?, ?count: Integer?, ?offset: Puppeteer::ElementHandle::Offset | Hash[Symbol, Numeric] | nil) -> void
+  def click: (?delay: Numeric?, ?button: String?, ?count: Integer?, ?offset: Puppeteer::ElementHandle::Offset | Hash[Symbol, Numeric] | nil) -> void
 
   # @rbs return: Puppeteer::TouchHandle -- Touch handle
   def touch_start: () -> Puppeteer::TouchHandle

data/sig/puppeteer/execution_context.rbs

@@ -3,6 +3,8 @@
 class Puppeteer::ExecutionContext
   include Puppeteer::IfPresent
 
+  include Puppeteer::EventCallbackable
+
   EVALUATION_SCRIPT_URL: ::String
 
   SOURCE_URL_REGEX: ::Regexp
@@ -16,6 +18,9 @@ class Puppeteer::ExecutionContext
 
   attr_reader world: untyped
 
+  # @rbs return: void -- Notify consumers that this context was destroyed
+  def dispose: () -> void
+
   # only used in IsolaatedWorld
   private def _context_id: () -> untyped
 

data/sig/puppeteer/extension.rbs

@@ -31,6 +31,10 @@ class Puppeteer::Extension
   # @rbs return: Array[Puppeteer::Page] -- Extension pages
   def pages: () -> Array[Puppeteer::Page]
 
+  # @rbs error: StandardError -- Error raised while resolving an extension target
+  # @rbs return: bool -- Whether the target resolution error can be ignored
+  private def can_ignore_error?: (StandardError error) -> bool
+
   # @rbs page: Puppeteer::Page -- Target page
   # @rbs return: void -- No return value
   def trigger_action: (Puppeteer::Page page) -> void

data/sig/puppeteer/frame.rbs

@@ -19,6 +19,9 @@ class Puppeteer::Frame
   # @rbs return: Puppeteer::Page -- Owning page
   def page: () -> Puppeteer::Page
 
+  # @rbs return: Puppeteer::Accessibility -- Accessibility tree for this frame
+  def accessibility: () -> Puppeteer::Accessibility
+
   # @rbs return: Numeric -- Default timeout in milliseconds
   def default_timeout: () -> Numeric
 
@@ -158,10 +161,9 @@ class Puppeteer::Frame
   # @rbs selector: String -- CSS selector
   # @rbs delay: Numeric? -- Delay between down and up (ms)
   # @rbs button: String? -- Mouse button
-  # @rbs click_count: Integer? -- Deprecated: use count (click_count only sets clickCount)
   # @rbs count: Integer? -- Number of clicks to perform
   # @rbs return: void -- No return value
-  def click: (String selector, ?delay: Numeric?, ?button: String?, ?click_count: Integer?, ?count: Integer?) -> void
+  def click: (String selector, ?delay: Numeric?, ?button: String?, ?count: Integer?) -> void
 
   # @rbs selector: String -- CSS selector
   # @rbs return: void -- No return value

data/sig/puppeteer/http_response.rbs

@@ -46,6 +46,10 @@ class Puppeteer::HTTPResponse
 
   attr_reader timing: untyped
 
+  # Multiline values represent duplicate fields in CDP. RFC 9110 allows
+  # comma-combining fields except Set-Cookie, whose lines must stay separate.
+  private def normalize_header_value: (untyped name, untyped value) -> untyped
+
   def inspect: () -> untyped
 
   private def parse_status_text_from_extra_info: (untyped extra_info) -> untyped

data/sig/puppeteer/keyboard.rbs

@@ -7,6 +7,10 @@ class Puppeteer::Keyboard
 
   attr_reader modifiers: untyped
 
+  # @rbs client: Puppeteer::CDPSession -- Replacement CDP session
+  # @rbs return: void -- No return value
+  def update_client: (Puppeteer::CDPSession client) -> void
+
   # @rbs key: String -- Key name
   # @rbs text: String? -- Text to input
   # @rbs commands: Array[String]? -- Editing commands

data/sig/puppeteer/locators.rbs

@@ -87,16 +87,15 @@ class Puppeteer::Locator
 
   # @rbs delay: Numeric? -- Delay between down and up (ms)
   # @rbs button: String? -- Mouse button
-  # @rbs click_count: Integer? -- Deprecated click count
   # @rbs count: Integer? -- Number of clicks
   # @rbs offset: Hash[Symbol, Numeric]? -- Click offset
   # @rbs return: void -- No return value
-  def click: (?delay: Numeric?, ?button: String?, ?click_count: Integer?, ?count: Integer?, ?offset: Hash[Symbol, Numeric]?) -> void
+  def click: (?delay: Numeric?, ?button: String?, ?count: Integer?, ?offset: Hash[Symbol, Numeric]?) -> void
 
-  # @rbs value: String -- Value to fill
+  # @rbs value: String | bool -- Value to fill
   # @rbs typing_threshold: Integer -- Minimum length to switch to direct assignment
   # @rbs return: void -- No return value
-  def fill: (String value, ?typing_threshold: Integer) -> void
+  def fill: (String | bool value, ?typing_threshold: Integer) -> void
 
   # @rbs return: void -- No return value
   def hover: () -> void

data/sig/puppeteer/mouse.rbs

@@ -34,6 +34,10 @@ class Puppeteer::Mouse
   # @rbs return: void -- No return value
   def initialize: (Puppeteer::CDPSession client, Puppeteer::Keyboard keyboard) -> void
 
+  # @rbs client: Puppeteer::CDPSession -- Replacement CDP session
+  # @rbs return: void -- No return value
+  def update_client: (Puppeteer::CDPSession client) -> void
+
   # @rbs return: void -- No return value
   def reset: () -> void
 
@@ -47,14 +51,9 @@ class Puppeteer::Mouse
   # @rbs y: Numeric -- Y coordinate
   # @rbs delay: Numeric? -- Delay between down and up (ms)
   # @rbs button: String? -- Mouse button
-  # @rbs click_count: Integer? -- Deprecated: use count (click_count only sets clickCount)
   # @rbs count: Integer? -- Number of click repetitions
   # @rbs return: void -- No return value
-  def click: (Numeric x, Numeric y, ?delay: Numeric?, ?button: String?, ?click_count: Integer?, ?count: Integer?) -> void
-
-  private def warn_deprecated_click_count: () -> untyped
-
-  attr_accessor deprecated_click_count_warned: untyped
+  def click: (Numeric x, Numeric y, ?delay: Numeric?, ?button: String?, ?count: Integer?) -> void
 
   # @rbs button: String? -- Mouse button
   # @rbs click_count: Integer? -- Click count to report