puppeteer-bidi 0.0.1.beta1 → 0.0.1.beta2

data/sig/puppeteer/bidi/frame.rbs

@@ -9,171 +9,171 @@ module Puppeteer
       attr_reader browsing_context: Core::BrowsingContext
 
       # Factory method following Puppeteer's BidiFrame.from pattern
-      # @rbs parent: Page | Frame
-      # @rbs browsing_context: Core::BrowsingContext
-      # @rbs return: Frame
+      # @rbs parent: Page | Frame -- Parent page or frame
+      # @rbs browsing_context: Core::BrowsingContext -- Associated browsing context
+      # @rbs return: Frame -- New frame instance
       def self.from: (Page | Frame parent, Core::BrowsingContext browsing_context) -> Frame
 
-      # @rbs parent: Page | Frame
-      # @rbs browsing_context: Core::BrowsingContext
+      # @rbs parent: Page | Frame -- Parent page or frame
+      # @rbs browsing_context: Core::BrowsingContext -- Associated browsing context
       # @rbs return: void
       def initialize: (Page | Frame parent, Core::BrowsingContext browsing_context) -> void
 
-      # @rbs return: FrameRealm
+      # @rbs return: FrameRealm -- Main execution realm
       def main_realm: () -> FrameRealm
 
-      # @rbs return: FrameRealm
+      # @rbs return: FrameRealm -- Isolated execution realm
       def isolated_realm: () -> FrameRealm
 
       # Backwards compatibility for call sites that previously accessed Frame#realm.
-      # @rbs return: FrameRealm
+      # @rbs return: FrameRealm -- Main execution realm
       def realm: () -> FrameRealm
 
       # Get the page that owns this frame
       # Traverses up the parent chain until reaching a Page
-      # @rbs return: Page
+      # @rbs return: Page -- Owning page
       def page: () -> Page
 
       # Get the parent frame
-      # @rbs return: Frame?
+      # @rbs return: Frame? -- Parent frame or nil for main frame
       def parent_frame: () -> Frame?
 
       # Evaluate JavaScript in the frame 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 -- Evaluation result
       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
 
       # Get the document element handle
-      # @rbs return: ElementHandle
+      # @rbs return: ElementHandle -- Document element handle
       def document: () -> ElementHandle
 
       # 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
 
       # Get the frame URL
-      # @rbs return: String
+      # @rbs return: String -- Current URL
       def url: () -> String
 
       # Navigate to a URL
-      # @rbs url: String
-      # @rbs wait_until: String
-      # @rbs timeout: Numeric
-      # @rbs return: HTTPResponse?
+      # @rbs url: String -- URL to navigate to
+      # @rbs wait_until: String -- When to consider navigation complete ('load', 'domcontentloaded')
+      # @rbs timeout: Numeric -- Navigation timeout in ms
+      # @rbs return: HTTPResponse? -- Response or nil
       def goto: (String url, ?wait_until: String, ?timeout: Numeric) -> HTTPResponse?
 
       # Set frame 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
 
       # Set frame content using document.open/write/close
       # This is a low-level method that doesn't wait for load events
-      # @rbs content: String
+      # @rbs content: String -- HTML content to set
       # @rbs return: void
       def set_frame_content: (String content) -> void
 
       # Get the frame name
-      # @rbs return: String
+      # @rbs return: String -- Frame name
       def name: () -> String
 
       # Check if frame is detached
-      # @rbs return: bool
+      # @rbs return: bool -- Whether frame is detached
       def detached?: () -> bool
 
       # Get child frames
       # Returns cached frame instances following Puppeteer's pattern
-      # @rbs return: Array[Frame]
+      # @rbs return: Array[Frame] -- Child frames
       def child_frames: () -> Array[Frame]
 
       # Get the frame element (iframe/frame DOM element) for this frame
       # Returns nil for the main frame
       # Following Puppeteer's Frame.frameElement() implementation exactly
-      # @rbs return: ElementHandle?
+      # @rbs return: ElementHandle? -- Frame element or nil for main frame
       def frame_element: () -> ElementHandle?
 
       # Wait for navigation to complete
-      # @rbs timeout: Numeric
-      # @rbs wait_until: String | Array[String]
-      # @rbs &block: (-> void)?
-      # @rbs return: HTTPResponse?
+      # @rbs timeout: Numeric -- Navigation timeout in ms
+      # @rbs wait_until: String | Array[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 | Array[String]) ?{ (?) -> untyped } -> HTTPResponse?
 
       # 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 frame
-      # @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 files on an input element
-      # @rbs element: ElementHandle
-      # @rbs files: Array[String]
+      # @rbs element: ElementHandle -- Input element
+      # @rbs files: Array[String] -- File paths to set
       # @rbs return: void
       def set_files: (ElementHandle element, Array[String] files) -> void
 
       # Get the frame ID (browsing context ID)
       # Following Puppeteer's _id pattern
-      # @rbs return: String
+      # @rbs return: String -- Frame ID
       def _id: () -> String
 
       private
@@ -193,8 +193,8 @@ module Puppeteer
       #   });
       # Note: FrameDetached is NOT emitted here - it's emitted in #initialize
       # when the frame's own browsing context closes
-      # @rbs browsing_context: Core::BrowsingContext
-      # @rbs return: Frame
+      # @rbs browsing_context: Core::BrowsingContext -- Child browsing context
+      # @rbs return: Frame -- New child frame
       def create_frame_target: (Core::BrowsingContext browsing_context) -> Frame
 
       # Check if this frame is detached and raise error if so

data/sig/puppeteer/bidi/http_response.rbs

@@ -0,0 +1,18 @@
+# Generated from lib/puppeteer/bidi/http_response.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    # HTTPResponse represents a response to an HTTP request
+    class HTTPResponse
+      attr_reader url: untyped
+
+      # @param url [String] Response URL
+      # @param status [Integer] HTTP status code
+      def initialize: (url: untyped, ?status: untyped) -> untyped
+
+      # Check if the response was successful (status code 200-299)
+      # @return [Boolean] True if status code is in 2xx range
+      def ok?: () -> untyped
+    end
+  end
+end

data/sig/puppeteer/bidi/injected_source.rbs

@@ -0,0 +1,21 @@
+# Generated from lib/puppeteer/bidi/injected_source.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    # Puppeteer's injected utilities (Poller classes, Deferred, etc.)
+    # Source: https://unpkg.com/puppeteer-core@24.31.0/lib/esm/puppeteer/generated/injected.js
+    # Version: puppeteer-core@24.31.0
+    #
+    # To update this file, run:
+    #   bundle exec ruby scripts/update_injected_source.rb
+    #
+    # This script provides:
+    # - RAFPoller: requestAnimationFrame-based polling
+    # - MutationPoller: MutationObserver-based polling
+    # - IntervalPoller: setInterval-based polling
+    # - Deferred: Promise wrapper
+    # - createFunction: Creates function from string
+    # - Various query selector utilities
+    PUPPETEER_INJECTED_SOURCE: untyped
+  end
+end

data/sig/puppeteer/bidi/js_handle.rbs

@@ -7,27 +7,27 @@ module Puppeteer
     class JSHandle
       attr_reader realm: Core::Realm
 
-      # @rbs remote_value: Hash[String, untyped]
-      # @rbs realm: Core::Realm
+      # @rbs remote_value: Hash[String, untyped] -- BiDi RemoteValue
+      # @rbs realm: Core::Realm -- Associated realm
       # @rbs return: void
       def initialize: (Core::Realm realm, Hash[String, untyped] remote_value) -> void
 
       # Factory method to create JSHandle from remote value
-      # @rbs remote_value: Hash[String, untyped]
-      # @rbs realm: Core::Realm
-      # @rbs return: JSHandle | ElementHandle
+      # @rbs remote_value: Hash[String, untyped] -- BiDi RemoteValue
+      # @rbs realm: Core::Realm -- Associated realm
+      # @rbs return: JSHandle | ElementHandle -- JSHandle or ElementHandle instance
       def self.from: (Hash[String, untyped] remote_value, Core::Realm realm) -> (JSHandle | ElementHandle)
 
       # Get the remote value (BiDi Script.RemoteValue)
-      # @rbs return: Hash[String, untyped]
+      # @rbs return: Hash[String, untyped] -- BiDi RemoteValue
       def remote_value: () -> Hash[String, untyped]
 
       # Get the remote object (alias for remote_value)
-      # @rbs return: Hash[String, untyped]
+      # @rbs return: Hash[String, untyped] -- BiDi RemoteValue
       def remote_object: () -> Hash[String, untyped]
 
       # Check if handle has been disposed
-      # @rbs return: bool
+      # @rbs return: bool -- Whether handle is disposed
       def disposed?: () -> bool
 
       # Dispose this handle by releasing the remote object
@@ -35,44 +35,44 @@ module Puppeteer
       def dispose: () -> void
 
       # Get the handle ID (handle or sharedId)
-      # @rbs return: String?
+      # @rbs return: String? -- Handle ID or nil
       def id: () -> String?
 
       # Evaluate JavaScript function with this handle as the first argument
-      # @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 -- Evaluation result
       def evaluate: (String script, *untyped args) -> untyped
 
       # Evaluate JavaScript function 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
 
       # Get a property of the object
-      # @rbs property_name: String
-      # @rbs return: JSHandle
+      # @rbs property_name: String -- Property name to get
+      # @rbs return: JSHandle -- Handle to the property value
       def get_property: (String property_name) -> JSHandle
 
       # Get all properties of the object
-      # @rbs return: Hash[String, JSHandle]
+      # @rbs return: Hash[String, JSHandle] -- Map of property names to handles
       def get_properties: () -> Hash[String, JSHandle]
 
       # Convert this handle to a JSON-serializable value
-      # @rbs return: untyped
+      # @rbs return: untyped -- JSON-serializable value
       def json_value: () -> untyped
 
       # Convert to ElementHandle if this is an element
-      # @rbs return: ElementHandle?
+      # @rbs return: ElementHandle? -- ElementHandle or nil if not an element
       def as_element: () -> ElementHandle?
 
       # Check if this is a primitive value
-      # @rbs return: bool
+      # @rbs return: bool -- Whether this is a primitive value
       def primitive_value?: () -> bool
 
       # String representation of this handle
-      # @rbs return: String
+      # @rbs return: String -- String representation
       def to_s: () -> String
 
       private
@@ -82,7 +82,7 @@ module Puppeteer
       def assert_not_disposed: () -> void
 
       # Handle evaluation exceptions
-      # @rbs result: Hash[String, untyped]
+      # @rbs result: Hash[String, untyped] -- Evaluation result containing exception
       # @rbs return: void
       def handle_evaluation_exception: (Hash[String, untyped] result) -> void
     end

data/sig/puppeteer/bidi/keyboard.rbs

@@ -0,0 +1,57 @@
+# Generated from lib/puppeteer/bidi/keyboard.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    # Keyboard class for keyboard input operations
+    # Based on Puppeteer's BidiKeyboard implementation
+    class Keyboard
+      # @rbs page: Page -- Page instance
+      # @rbs browsing_context: Core::BrowsingContext -- Browsing context
+      # @rbs return: void
+      def initialize: (Page page, Core::BrowsingContext browsing_context) -> void
+
+      # Press key down
+      # @rbs key: String -- Key name (e.g., 'a', 'Enter', 'ArrowLeft')
+      # @rbs text: String? -- Text to insert (for CDP compatibility, not used in BiDi)
+      # @rbs commands: Array[String]? -- Commands to trigger (for CDP compatibility, not used in BiDi)
+      # @rbs return: void
+      def down: (String key, ?text: String?, ?commands: Array[String]?) -> void
+
+      # Release key
+      # @rbs key: String -- Key name
+      # @rbs return: void
+      def up: (String key) -> void
+
+      # Press and release a key
+      # @rbs key: String -- Key name
+      # @rbs delay: Numeric? -- Delay between keydown and keyup in milliseconds
+      # @rbs text: String? -- Text to insert (for CDP compatibility, not used in BiDi)
+      # @rbs commands: Array[String]? -- Commands to trigger (for CDP compatibility, not used in BiDi)
+      # @rbs return: void
+      def press: (String key, ?delay: Numeric?, ?text: String?, ?commands: Array[String]?) -> void
+
+      # Type text (types each character with keydown/keyup events)
+      # @rbs text: String -- Text to type
+      # @rbs delay: Numeric -- Delay between each character in milliseconds
+      # @rbs return: void
+      def type: (String text, ?delay: Numeric) -> void
+
+      # Send character directly (bypasses keyboard events, uses execCommand)
+      # @rbs char: String -- Character to send
+      # @rbs return: void
+      def send_character: (String char) -> void
+
+      private
+
+      # Convert key name to BiDi protocol value
+      # @rbs key: String -- Key name
+      # @rbs return: String -- BiDi key value (Unicode character or escape sequence)
+      def get_bidi_key_value: (String key) -> String
+
+      # Perform input actions via BiDi
+      # @rbs action_list: Array[Hash[Symbol, untyped]] -- List of key actions
+      # @rbs return: void
+      def perform_actions: (Array[Hash[Symbol, untyped]] action_list) -> void
+    end
+  end
+end

data/sig/puppeteer/bidi/lazy_arg.rbs

@@ -0,0 +1,15 @@
+# Generated from lib/puppeteer/bidi/lazy_arg.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    # LazyArg defers evaluation of expensive arguments (e.g., handles) until
+    # serialization time. Mirrors Puppeteer's LazyArg helper.
+    class LazyArg
+      def self.create: () ?{ (?) -> untyped } -> untyped
+
+      def initialize: () ?{ (?) -> untyped } -> untyped
+
+      def resolve: () -> untyped
+    end
+  end
+end

data/sig/puppeteer/bidi/mouse.rbs

@@ -0,0 +1,73 @@
+# Generated from lib/puppeteer/bidi/mouse.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    # Mouse class for mouse input operations
+    # Based on Puppeteer's BidiMouse implementation
+    class Mouse
+      # Mouse button constants
+      LEFT: String
+
+      RIGHT: String
+
+      MIDDLE: String
+
+      BACK: String
+
+      FORWARD: String
+
+      # @rbs browsing_context: Core::BrowsingContext -- Browsing context
+      # @rbs return: void
+      def initialize: (Core::BrowsingContext browsing_context) -> void
+
+      # Move mouse to coordinates
+      # @rbs x: Numeric -- X coordinate
+      # @rbs y: Numeric -- Y coordinate
+      # @rbs steps: Integer -- Number of intermediate steps (for smooth movement)
+      # @rbs return: void
+      def move: (Numeric x, Numeric y, ?steps: Integer) -> void
+
+      # Press mouse button down
+      # @rbs button: String -- Mouse button ('left', 'right', 'middle', 'back', 'forward')
+      # @rbs return: void
+      def down: (?button: String) -> void
+
+      # Release mouse button
+      # @rbs button: String -- Mouse button
+      # @rbs return: void
+      def up: (?button: String) -> void
+
+      # Click at coordinates
+      # @rbs x: Numeric -- X coordinate
+      # @rbs y: Numeric -- Y coordinate
+      # @rbs button: String -- Mouse button
+      # @rbs count: Integer -- Number of clicks (1 for single, 2 for double, 3 for triple)
+      # @rbs delay: Numeric? -- Delay between down and up in milliseconds
+      # @rbs return: void
+      def click: (Numeric x, Numeric y, ?button: String, ?count: Integer, ?delay: Numeric?) -> void
+
+      # Scroll using mouse wheel
+      # @rbs delta_x: Numeric -- Horizontal scroll amount
+      # @rbs delta_y: Numeric -- Vertical scroll amount
+      # @rbs return: void
+      def wheel: (?delta_x: Numeric, ?delta_y: Numeric) -> void
+
+      # Reset mouse state
+      # Resets position to origin and releases all pressed buttons
+      # @rbs return: void
+      def reset: () -> void
+
+      private
+
+      # Convert mouse button name to BiDi button number
+      # @rbs button: String -- Mouse button name
+      # @rbs return: Integer -- BiDi button number
+      def button_to_bidi: (String button) -> Integer
+
+      # Perform input actions via BiDi
+      # @rbs action_list: Array[Hash[Symbol, untyped]] -- List of pointer actions
+      # @rbs return: void
+      def perform_actions: (Array[Hash[Symbol, untyped]] action_list) -> void
+    end
+  end
+end