puppeteer-ruby 0.52.1 → 0.53.0

data/sig/puppeteer/page.rbs

@@ -22,6 +22,16 @@ class Puppeteer::Page
   # @rbs return: void -- No return value
   def initialize: (Puppeteer::CDPSession client, Puppeteer::Target target, bool ignore_https_errors, ?network_enabled: bool) -> void
 
+  private def setup_primary_target_listeners: (untyped client) -> untyped
+
+  private def handle_activation: (untyped session) -> untyped
+
+  private def handle_secondary_target: (untyped session) -> untyped
+
+  private def mark_closed: () -> untyped
+
+  private def cleanup_page_listeners: () -> untyped
+
   private def handle_detached_from_target: (untyped target) -> untyped
 
   private def handle_attached_to_session: (untyped session) -> untyped
@@ -83,7 +93,10 @@ class Puppeteer::Page
   def browser_context: () -> Puppeteer::BrowserContext
 
   # @rbs return: bool -- Whether DevTools is attached to this page
-  def has_devtools: () -> bool
+  def has_dev_tools: () -> bool
+
+  # @rbs return: Puppeteer::Page -- Existing or newly opened DevTools page
+  def open_dev_tools: () -> Puppeteer::Page
 
   # @rbs extension: Puppeteer::Extension -- Extension to trigger
   # @rbs return: void -- No return value
@@ -108,7 +121,10 @@ class Puppeteer::Page
 
   attr_reader tracing: untyped
 
-  attr_reader accessibility: untyped
+  attr_reader webmcp: untyped
+
+  # @rbs return: Puppeteer::Accessibility -- Main-frame accessibility tree
+  def accessibility: () -> Puppeteer::Accessibility
 
   # @rbs block: Proc? -- Optional block for instance_eval
   # @rbs return: Puppeteer::Keyboard -- Keyboard instance
@@ -389,6 +405,10 @@ class Puppeteer::Page
   # @rbs return: void -- No return value
   def emulate_timezone: (String? timezone_id) -> void
 
+  # @rbs locale: String? -- Locale to emulate, or nil to disable emulation
+  # @rbs return: void -- No return value
+  def emulate_locale: (?String? locale) -> void
+
   VISION_DEFICIENCY_TYPES: untyped
 
   # @rbs vision_deficiency_type: String? -- Vision deficiency type
@@ -406,6 +426,31 @@ class Puppeteer::Page
 
   attr_reader viewport: untyped
 
+  # @rbs path: String? -- Output file path
+  # @rbs overwrite: bool -- Overwrite an existing output file
+  # @rbs format: String? -- webm, gif, or mp4
+  # @rbs crop: Hash[Symbol, Numeric]? -- Viewport crop rectangle
+  # @rbs scale: Numeric? -- Output scale
+  # @rbs speed: Numeric? -- Playback speed
+  # @rbs fps: Numeric? -- Output frame rate
+  # @rbs loop: Numeric? -- GIF loop count
+  # @rbs delay: Numeric? -- GIF loop delay
+  # @rbs quality: Numeric? -- VP9 CRF value
+  # @rbs colors: Numeric? -- GIF palette size
+  # @rbs ffmpeg_path: String? -- FFmpeg executable path
+  # @rbs return: Puppeteer::ScreenRecorder -- Active recorder
+  def screencast: (?path: String?, ?overwrite: bool, ?format: String?, ?crop: Hash[Symbol, Numeric]?, ?scale: Numeric?, ?speed: Numeric?, ?fps: Numeric?, ?loop: Numeric?, ?delay: Numeric?, ?quality: Numeric?, ?colors: Numeric?, ?ffmpeg_path: String?) -> Puppeteer::ScreenRecorder
+
+  # @rbs return: void -- Start a shared CDP screencast session
+  def _start_screencast: () -> void
+
+  # @rbs return: void -- Stop a shared CDP screencast session
+  def _stop_screencast: () -> void
+
+  private def native_pixel_dimensions: () -> untyped
+
+  private def normalize_screencast_crop: (untyped crop, untyped width, untyped height, untyped device_pixel_ratio) -> untyped
+
   # @rbs page_function: String -- page_function parameter
   # @rbs args: Array[untyped] -- args parameter
   # @rbs return: untyped -- Result
@@ -486,10 +531,9 @@ class Puppeteer::Page
   # @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/puppeteer.rbs

@@ -30,6 +30,7 @@ class Puppeteer::Puppeteer
   # @rbs network_enabled: bool? -- Enable network domain
   # @rbs issues_enabled: bool? -- Enable issues domain
   # @rbs block_list: Array[String]? -- URL block list patterns
+  # @rbs allow_list: Array[String]? -- URL allow list patterns
   # @rbs enable_extensions: (bool | Array[String])? -- Enable extensions or load unpacked extensions
   # @rbs default_viewport: Puppeteer::Viewport? -- Default viewport
   # @rbs slow_mo: Integer? -- Delay between operations (ms)
@@ -37,7 +38,7 @@ class Puppeteer::Puppeteer
   # @rbs wait_for_initial_page: bool? -- Wait for initial page to load
   # @rbs block: Proc? -- Optional block receiving the browser
   # @rbs return: Puppeteer::Browser -- Browser instance
-  def launch: (?product: String?, ?channel: (String | Symbol)?, ?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?, ?args: Array[String]?, ?user_data_dir: String?, ?devtools: bool?, ?debugging_port: Integer?, ?headless: bool?, ?ignore_https_errors: bool?, ?network_enabled: bool?, ?issues_enabled: bool?, ?block_list: Array[String]?, ?enable_extensions: (bool | Array[String])?, ?default_viewport: Puppeteer::Viewport?, ?slow_mo: Integer?, ?protocol_timeout: Integer?, ?wait_for_initial_page: bool?) ?{ (?) -> untyped } -> Puppeteer::Browser
+  def launch: (?product: String?, ?channel: (String | Symbol)?, ?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?, ?args: Array[String]?, ?user_data_dir: String?, ?devtools: bool?, ?debugging_port: Integer?, ?headless: bool?, ?ignore_https_errors: bool?, ?network_enabled: bool?, ?issues_enabled: bool?, ?block_list: Array[String]?, ?allow_list: Array[String]?, ?enable_extensions: (bool | Array[String])?, ?default_viewport: Puppeteer::Viewport?, ?slow_mo: Integer?, ?protocol_timeout: Integer?, ?wait_for_initial_page: bool?) ?{ (?) -> untyped } -> Puppeteer::Browser
 
   # @rbs browser_ws_endpoint: String? -- Browser WebSocket endpoint
   # @rbs browser_url: String? -- Browser HTTP URL for WebSocket discovery
@@ -47,12 +48,13 @@ class Puppeteer::Puppeteer
   # @rbs network_enabled: bool? -- Enable network domain
   # @rbs issues_enabled: bool? -- Enable issues domain
   # @rbs block_list: Array[String]? -- URL block list patterns
+  # @rbs allow_list: Array[String]? -- URL allow list patterns
   # @rbs default_viewport: Puppeteer::Viewport? -- Default viewport
   # @rbs slow_mo: Integer? -- Delay between operations (ms)
   # @rbs protocol_timeout: Integer? -- CDP protocol timeout in milliseconds
   # @rbs block: Proc? -- Optional block receiving the browser
   # @rbs return: Puppeteer::Browser -- Browser instance
-  def connect: (?browser_ws_endpoint: String?, ?browser_url: String?, ?transport: Puppeteer::WebSocketTransport?, ?channel: (String | Symbol)?, ?ignore_https_errors: bool?, ?network_enabled: bool?, ?issues_enabled: bool?, ?block_list: Array[String]?, ?default_viewport: Puppeteer::Viewport?, ?slow_mo: Integer?, ?protocol_timeout: Integer?) ?{ (?) -> untyped } -> Puppeteer::Browser
+  def connect: (?browser_ws_endpoint: String?, ?browser_url: String?, ?transport: Puppeteer::WebSocketTransport?, ?channel: (String | Symbol)?, ?ignore_https_errors: bool?, ?network_enabled: bool?, ?issues_enabled: bool?, ?block_list: Array[String]?, ?allow_list: Array[String]?, ?default_viewport: Puppeteer::Viewport?, ?slow_mo: Integer?, ?protocol_timeout: Integer?) ?{ (?) -> untyped } -> Puppeteer::Browser
 
   # @rbs channel: String? -- Browser channel
   # @rbs return: String -- Executable path
@@ -60,9 +62,6 @@ class Puppeteer::Puppeteer
 
   private def launcher: () -> untyped
 
-  # @rbs return: String -- Product name
-  def product: () -> String
-
   private def async_context?: () -> untyped
 
   # @rbs name: String -- Custom query handler name

data/sig/puppeteer/screen_recorder.rbs

@@ -0,0 +1,48 @@
+# Generated from lib/puppeteer/screen_recorder.rb with RBS::Inline
+
+class Puppeteer::ScreenRecorder
+  DEFAULT_FPS: ::Integer
+
+  DEFAULT_QUALITY: ::Integer
+
+  STOP: untyped
+
+  # @rbs start_timestamp: Numeric -- First CDP frame timestamp
+  # @rbs previous_timestamp: Numeric -- Previous CDP frame timestamp
+  # @rbs timestamp: Numeric -- Current CDP frame timestamp
+  # @rbs fps: Numeric -- Output frame rate
+  # @rbs return: Integer -- Frames to emit for this interval
+  def self.count_frames: (Numeric start_timestamp, Numeric previous_timestamp, Numeric timestamp, Numeric fps) -> Integer
+
+  # @rbs page: Puppeteer::Page -- Recorded page
+  # @rbs width: Numeric -- Native viewport width
+  # @rbs height: Numeric -- Native viewport height
+  # @rbs options: Hash[Symbol, untyped] -- Recorder options
+  def initialize: (Puppeteer::Page page, Numeric width, Numeric height, ?Hash[Symbol, untyped] options) -> untyped
+
+  # @rbs return: String -- Encoded bytes produced so far
+  def data: () -> String
+
+  # @rbs return: void -- Stop recording and flush FFmpeg
+  def stop: () -> void
+
+  private def ensure_output_directory: () -> untyped
+
+  private def build_command: (untyped width, untyped height, untyped options) -> untyped
+
+  private def format_args: (untyped format, untyped fps, untyped loop_count, untyped delay, untyped quality, untyped colors) -> untyped
+
+  private def handle_frame: (untyped event) -> untyped
+
+  private def enqueue_last_frame: () -> untyped
+
+  private def finish_process: () -> untyped
+
+  private def write_frames: () -> untyped
+
+  private def read_output: () -> untyped
+
+  private def read_stderr: () -> untyped
+
+  private def monotonic_time: () -> untyped
+end

data/sig/puppeteer/touch_screen.rbs

@@ -6,6 +6,10 @@ class Puppeteer::TouchScreen
   # @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 x: Numeric -- X coordinate
   # @rbs y: Numeric -- Y coordinate
   # @rbs return: void -- No return value

data/sig/puppeteer/web_mcp.rbs

@@ -0,0 +1,112 @@
+# Generated from lib/puppeteer/web_mcp.rb with RBS::Inline
+
+class Puppeteer::WebMCPTool
+  include Puppeteer::EventCallbackable
+
+  # @rbs web_mcp: Puppeteer::WebMCP -- Owning WebMCP instance
+  # @rbs tool: Hash[String, untyped] -- CDP tool payload
+  # @rbs frame: Puppeteer::Frame -- Defining frame
+  def initialize: (Puppeteer::WebMCP web_mcp, Hash[String, untyped] tool, Puppeteer::Frame frame) -> untyped
+
+  attr_reader name: untyped
+
+  attr_reader description: untyped
+
+  attr_reader input_schema: untyped
+
+  attr_reader annotations: untyped
+
+  attr_reader frame: untyped
+
+  attr_reader location: untyped
+
+  attr_reader raw_stack_trace: untyped
+
+  # @rbs return: Puppeteer::ElementHandle? -- Declarative form element
+  def form_element: () -> Puppeteer::ElementHandle?
+
+  # @rbs input: Hash[untyped, untyped] -- Tool input
+  # @rbs return: Puppeteer::WebMCPToolCallResult -- Invocation result
+  def execute: (?Hash[untyped, untyped] input) -> Puppeteer::WebMCPToolCallResult
+end
+
+class Puppeteer::WebMCPToolCall
+  # @rbs id: String -- Invocation id
+  # @rbs tool: Puppeteer::WebMCPTool -- Invoked tool
+  # @rbs input: String -- JSON-encoded input
+  def initialize: (String id, Puppeteer::WebMCPTool tool, String input) -> untyped
+
+  attr_reader id: untyped
+
+  attr_reader tool: untyped
+
+  attr_reader input: untyped
+end
+
+class Puppeteer::WebMCPToolCallResult
+  # @rbs id: String -- Invocation id
+  # @rbs call: Puppeteer::WebMCPToolCall? -- Corresponding call
+  # @rbs status: String -- Invocation status
+  # @rbs output: untyped -- Invocation output
+  # @rbs error_text: String? -- Error text
+  # @rbs exception: Hash[String, untyped]? -- Remote exception
+  def initialize: (id: String, call: Puppeteer::WebMCPToolCall?, status: String, output: untyped, error_text: String?, exception: Hash[String, untyped]?) -> untyped
+
+  attr_reader id: untyped
+
+  attr_reader call: untyped
+
+  attr_reader status: untyped
+
+  attr_reader output: untyped
+
+  attr_reader error_text: untyped
+
+  attr_reader exception: untyped
+end
+
+class Puppeteer::WebMCP
+  include Puppeteer::EventCallbackable
+
+  include Puppeteer::DebugPrint
+
+  class ToolsEvent < Struct[untyped]
+    attr_accessor tools(): untyped
+
+    def self.new: (?tools: untyped) -> instance
+                | ({ ?tools: untyped }) -> instance
+  end
+
+  # @rbs client: Puppeteer::CDPSession -- Primary page session
+  # @rbs frame_manager: Puppeteer::FrameManager -- Page frame manager
+  def initialize: (Puppeteer::CDPSession client, Puppeteer::FrameManager frame_manager) -> untyped
+
+  # @rbs return: void -- Enable the WebMCP CDP domain when available
+  def initialize_domain: () -> void
+
+  # @rbs tool: Puppeteer::WebMCPTool -- Tool to invoke
+  # @rbs input: Hash[untyped, untyped] -- Invocation input
+  # @rbs return: Hash[String, untyped] -- Invocation metadata
+  def invoke_tool: (Puppeteer::WebMCPTool tool, Hash[untyped, untyped] input) -> Hash[String, untyped]
+
+  # @rbs return: Array[Puppeteer::WebMCPTool] -- Registered tools
+  def tools: () -> Array[Puppeteer::WebMCPTool]
+
+  # @rbs client: Puppeteer::CDPSession -- Replacement primary session
+  # @rbs return: void -- No return value
+  def update_client: (Puppeteer::CDPSession client) -> void
+
+  private def bind_listeners: () -> untyped
+
+  private def handle_tools_added: (untyped event) -> untyped
+
+  private def handle_tools_removed: (untyped event) -> untyped
+
+  private def handle_tool_invoked: (untyped event) -> untyped
+
+  private def handle_tool_responded: (untyped event) -> untyped
+
+  private def listen_to_context_destroyed: (untyped frame) -> untyped
+
+  private def handle_context_disposed: (untyped frame) -> untyped
+end

data/sig/puppeteer/web_worker.rbs

@@ -4,6 +4,8 @@ class Puppeteer::WorkerWorld
   # @rbs client: Puppeteer::CDPSession -- CDP session
   def initialize: (Puppeteer::CDPSession client) -> untyped
 
+  attr_reader task_manager: untyped
+
   # @rbs context: Puppeteer::ExecutionContext -- Execution context to bind
   # @rbs return: void -- No return value
   def set_context: (Puppeteer::ExecutionContext context) -> void
@@ -21,11 +23,20 @@ class Puppeteer::WorkerWorld
   # @rbs return: Puppeteer::JSHandle -- Handle to evaluation result
   def evaluate_handle: (String page_function, *untyped args) -> Puppeteer::JSHandle
 
+  # @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: (String page_function, ?args: Array[untyped], ?polling: (Integer | String)?, ?timeout: Integer?) -> Puppeteer::JSHandle
+
   # @rbs return: nil -- Workers do not have frames
   def frame: () -> nil
 
   # @rbs return: void -- Dispose world resources
   def dispose: () -> void
+
+  def detached?: () -> untyped
 end
 
 class Puppeteer::WebWorker
@@ -56,6 +67,13 @@ class Puppeteer::WebWorker
   # @rbs return: Puppeteer::JSHandle -- Handle to evaluation result
   def evaluate_handle: (String page_function, *untyped args) -> Puppeteer::JSHandle
 
+  # @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: (String page_function, ?args: Array[untyped], ?polling: (Integer | String)?, ?timeout: Integer?) -> Puppeteer::JSHandle
+
   # @rbs return: void -- Not supported
   def close: () -> void
 end
@@ -78,6 +96,27 @@ class Puppeteer::CdpWebWorker < Puppeteer::WebWorker
   # @rbs return: Puppeteer::CDPSession -- Worker CDP session
   def client: () -> Puppeteer::CDPSession
 
+  # @rbs page_function: String -- Function or expression to evaluate
+  # @rbs args: Array[untyped] -- Arguments for evaluation
+  # @rbs return: untyped -- Evaluation result
+  def evaluate: (String page_function, *untyped args) -> untyped
+
+  # @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: (String page_function, *untyped args) -> Puppeteer::JSHandle
+
+  # @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: (String page_function, ?args: Array[untyped], ?polling: (Integer | String)?, ?timeout: Integer?) -> Puppeteer::JSHandle
+
+  private def console_value_from_js_handle: (untyped handle) -> untyped
+
+  private def console_message_locations: (untyped stack_trace) -> untyped
+
   # @rbs return: void -- Close the worker
   def close: () -> void
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: puppeteer-ruby
 version: !ruby/object:Gem::Version
-  version: 0.52.1
+  version: 0.53.0
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-01 00:00:00.000000000 Z
+date: 2026-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -98,6 +98,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: urlpattern
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -309,6 +323,7 @@ files:
 - docs/api_coverage.md
 - lib/puppeteer-ruby.rb
 - lib/puppeteer.rb
+- lib/puppeteer/accessibility.rb
 - lib/puppeteer/aria_query_handler.rb
 - lib/puppeteer/async_utils.rb
 - lib/puppeteer/browser.rb
@@ -381,6 +396,7 @@ files:
 - lib/puppeteer/query_handler_manager.rb
 - lib/puppeteer/reactor_runner.rb
 - lib/puppeteer/remote_object.rb
+- lib/puppeteer/screen_recorder.rb
 - lib/puppeteer/target.rb
 - lib/puppeteer/task_manager.rb
 - lib/puppeteer/timeout_helper.rb
@@ -391,6 +407,7 @@ files:
 - lib/puppeteer/version.rb
 - lib/puppeteer/viewport.rb
 - lib/puppeteer/wait_task.rb
+- lib/puppeteer/web_mcp.rb
 - lib/puppeteer/web_socket.rb
 - lib/puppeteer/web_socket_transport.rb
 - lib/puppeteer/web_worker.rb
@@ -398,6 +415,7 @@ files:
 - puppeteer-ruby.png
 - sig/_external.rbs
 - sig/_supplementary.rbs
+- sig/puppeteer/accessibility.rbs
 - sig/puppeteer/browser.rbs
 - sig/puppeteer/cdp_session.rbs
 - sig/puppeteer/chrome_user_data_dir.rbs
@@ -418,8 +436,10 @@ files:
 - sig/puppeteer/page.rbs
 - sig/puppeteer/puppeteer.rbs
 - sig/puppeteer/remote_object.rbs
+- sig/puppeteer/screen_recorder.rbs
 - sig/puppeteer/touch_handle.rbs
 - sig/puppeteer/touch_screen.rbs
+- sig/puppeteer/web_mcp.rbs
 - sig/puppeteer/web_worker.rbs
 homepage: https://github.com/YusukeIwaki/puppeteer-ruby
 licenses: []