puppeteer-bidi 0.0.1.beta1

data/sig/puppeteer/bidi/page.rbs

@@ -0,0 +1,247 @@
+# Generated from lib/puppeteer/bidi/page.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    # Page represents a single page/tab in the browser
+    # This is a high-level wrapper around Core::BrowsingContext
+    class Page
+      DEFAULT_TIMEOUT: Integer
+
+      attr_reader browsing_context: Core::BrowsingContext
+
+      attr_reader browser_context: BrowserContext
+
+      attr_reader timeout_settings: TimeoutSettings
+
+      # @rbs browser_context: BrowserContext
+      # @rbs browsing_context: Core::BrowsingContext
+      # @rbs return: void
+      def initialize: (BrowserContext browser_context, Core::BrowsingContext browsing_context) -> void
+
+      # Register an event listener
+      # @rbs event: Symbol | String
+      # @rbs &block: (untyped) -> void
+      # @rbs return: void
+      def on: (Symbol | String event) { (untyped) -> void } -> void
+
+      # Register a one-time event listener
+      # @rbs event: Symbol | String
+      # @rbs &block: (untyped) -> void
+      # @rbs return: void
+      def once: (Symbol | String event) { (untyped) -> void } -> void
+
+      # Remove an event listener
+      # @rbs event: Symbol | String
+      # @rbs &block: (untyped) -> void
+      # @rbs return: void
+      def off: (Symbol | String event) { (untyped) -> void } -> void
+
+      # Emit an event to all registered listeners
+      # @rbs event: Symbol | String
+      # @rbs data: untyped
+      # @rbs return: void
+      def emit: (Symbol | String event, ?untyped data) -> void
+
+      # Navigate to a URL
+      # @rbs url: String
+      # @rbs wait_until: String
+      # @rbs return: HTTPResponse?
+      def goto: (String url, ?wait_until: String) -> HTTPResponse?
+
+      # Set page content
+      # @rbs html: String
+      # @rbs wait_until: String
+      # @rbs return: void
+      def set_content: (String html, ?wait_until: String) -> void
+
+      # Take a screenshot
+      # @rbs path: String?
+      # @rbs type: String
+      # @rbs full_page: bool
+      # @rbs clip: Hash[Symbol, Numeric]?
+      # @rbs capture_beyond_viewport: bool
+      # @rbs return: String
+      def screenshot: (?path: String?, ?type: String, ?full_page: bool, ?clip: Hash[Symbol, Numeric]?, ?capture_beyond_viewport: bool) -> String
+
+      # Evaluate JavaScript in the page context
+      # @rbs script: String
+      # @rbs *args: untyped
+      # @rbs return: untyped
+      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
+      def evaluate_handle: (String script, *untyped args) -> JSHandle
+
+      # Query for an element matching the selector
+      # @rbs selector: String
+      # @rbs return: ElementHandle?
+      def query_selector: (String selector) -> ElementHandle?
+
+      # Query for all elements matching the selector
+      # @rbs selector: String
+      # @rbs return: Array[ElementHandle]
+      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
+      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
+      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 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 return: void
+      def type: (String selector, String text, ?delay: Numeric) -> void
+
+      # Hover over an element matching the selector
+      # @rbs selector: String
+      # @rbs return: void
+      def hover: (String selector) -> void
+
+      # Focus an element matching the selector
+      # @rbs selector: String
+      # @rbs return: void
+      def focus: (String selector) -> void
+
+      # Get the page title
+      # @rbs return: String
+      def title: () -> String
+
+      # Get the page URL
+      # @rbs return: String
+      def url: () -> String
+
+      # Close the page
+      # @rbs return: void
+      def close: () -> void
+
+      # Check if page is closed
+      # @rbs return: bool
+      def closed?: () -> bool
+
+      # Get the main frame
+      # @rbs return: Frame
+      def main_frame: () -> Frame
+
+      # Get the focused frame
+      # @rbs return: Frame
+      def focused_frame: () -> Frame
+
+      # Get all frames (main frame + all nested child frames)
+      # Following Puppeteer's pattern of returning all frames recursively
+      # @rbs return: Array[Frame]
+      def frames: () -> Array[Frame]
+
+      # Get the mouse instance
+      # @rbs return: Mouse
+      def mouse: () -> Mouse
+
+      # Get the keyboard instance
+      # @rbs return: Keyboard
+      def keyboard: () -> Keyboard
+
+      # Wait for a function to return a truthy value
+      # @rbs page_function: String
+      # @rbs options: Hash[Symbol, untyped]
+      # @rbs *args: untyped
+      # @rbs &block: ((JSHandle) -> void)?
+      # @rbs return: JSHandle
+      def wait_for_function: (String page_function, ?Hash[Symbol, untyped] options, *untyped args) ?{ (?) -> untyped } -> JSHandle
+
+      # Wait for an element matching the selector to appear in the page
+      # @rbs selector: String
+      # @rbs visible: bool?
+      # @rbs hidden: bool?
+      # @rbs timeout: Numeric?
+      # @rbs &block: ((ElementHandle?) -> void)?
+      # @rbs return: ElementHandle?
+      def wait_for_selector: (String selector, ?visible: bool?, ?hidden: bool?, ?timeout: Numeric?) ?{ (?) -> untyped } -> ElementHandle?
+
+      # Set the default timeout for waiting operations (e.g., waitForFunction).
+      # @rbs timeout: Numeric
+      # @rbs return: void
+      def set_default_timeout: (Numeric timeout) -> void
+
+      # Get the current default timeout in milliseconds.
+      # @rbs return: Numeric
+      def default_timeout: () -> Numeric
+
+      # Wait for navigation to complete
+      # @rbs timeout: Numeric
+      # @rbs wait_until: String
+      # @rbs &block: (-> void)?
+      # @rbs return: HTTPResponse?
+      def wait_for_navigation: (?timeout: Numeric, ?wait_until: String) ?{ (?) -> untyped } -> HTTPResponse?
+
+      # Wait for a file chooser to be opened
+      # @rbs timeout: Numeric?
+      # @rbs &block: (-> void)?
+      # @rbs return: FileChooser
+      def wait_for_file_chooser: (?timeout: Numeric?) ?{ (?) -> untyped } -> FileChooser
+
+      # Wait for network to be idle (no more than concurrency connections for idle_time)
+      # Based on Puppeteer's waitForNetworkIdle implementation
+      # @rbs idle_time: Numeric
+      # @rbs timeout: Numeric
+      # @rbs concurrency: Integer
+      # @rbs return: void
+      def wait_for_network_idle: (?idle_time: Numeric, ?timeout: Numeric, ?concurrency: Integer) -> void
+
+      # Set viewport size
+      # @rbs width: Integer
+      # @rbs height: Integer
+      # @rbs return: void
+      def set_viewport: (width: Integer, height: Integer) -> void
+
+      # Get current viewport size
+      # @rbs return: Hash[Symbol, Integer]?
+      def viewport: () -> Hash[Symbol, Integer]?
+
+      alias viewport= set_viewport
+
+      alias default_timeout= set_default_timeout
+
+      # Set JavaScript enabled state
+      # @rbs enabled: bool
+      # @rbs return: void
+      def set_javascript_enabled: (bool enabled) -> void
+
+      # Check if JavaScript is enabled
+      # @rbs return: bool
+      def javascript_enabled?: () -> bool
+
+      private
+
+      # Recursively collect all frames starting from the given frame
+      # @rbs frame: Frame
+      # @rbs return: Array[Frame]
+      def collect_frames: (Frame frame) -> Array[Frame]
+
+      # Check if this page is closed and raise error if so
+      # @rbs return: void
+      def assert_not_closed: () -> void
+    end
+  end
+end

data/sig/puppeteer/bidi.rbs

@@ -0,0 +1,15 @@
+# Generated from lib/puppeteer/bidi.rb with RBS::Inline
+
+module Puppeteer
+  module Bidi
+    # Launch a new browser instance
+    # @rbs **options: untyped
+    # @rbs return: Browser
+    def self.launch: (**untyped options) -> Browser
+
+    # Connect to an existing browser instance
+    # @rbs ws_endpoint: String
+    # @rbs return: Browser
+    def self.connect: (String ws_endpoint) -> Browser
+  end
+end

metadata

@@ -0,0 +1,176 @@
+--- !ruby/object:Gem::Specification
+name: puppeteer-bidi
+version: !ruby/object:Gem::Version
+  version: 0.0.1.beta1
+platform: ruby
+authors:
+- YusukeIwaki
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: async-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.26'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.26'
+- !ruby/object:Gem::Dependency
+  name: async-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.66'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.66'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: Puppeteer-BiDi is a Ruby implementation of Puppeteer that uses the WebDriver
+  BiDi protocol to automate Firefox browsers. Unlike puppeteer-ruby which uses Chrome
+  DevTools Protocol (CDP), this gem focuses on BiDi protocol support for cross-browser
+  automation, particularly targeting Firefox.
+email:
+- iwaki@i3-systems.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CLAUDE.md
+- CLAUDE/README.md
+- CLAUDE/async_programming.md
+- CLAUDE/click_implementation.md
+- CLAUDE/core_layer_gotchas.md
+- CLAUDE/error_handling.md
+- CLAUDE/file_chooser.md
+- CLAUDE/frame_architecture.md
+- CLAUDE/javascript_evaluation.md
+- CLAUDE/jshandle_implementation.md
+- CLAUDE/keyboard_implementation.md
+- CLAUDE/mouse_implementation.md
+- CLAUDE/navigation_waiting.md
+- CLAUDE/porting_puppeteer.md
+- CLAUDE/query_handler.md
+- CLAUDE/rspec_pending_vs_skip.md
+- CLAUDE/selector_evaluation.md
+- CLAUDE/test_server_routes.md
+- CLAUDE/testing_strategy.md
+- CLAUDE/two_layer_architecture.md
+- CLAUDE/wrapped_element_click.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/puppeteer/bidi.rb
+- lib/puppeteer/bidi/async_utils.rb
+- lib/puppeteer/bidi/browser.rb
+- lib/puppeteer/bidi/browser_context.rb
+- lib/puppeteer/bidi/browser_launcher.rb
+- lib/puppeteer/bidi/connection.rb
+- lib/puppeteer/bidi/core.rb
+- lib/puppeteer/bidi/core/README.md
+- lib/puppeteer/bidi/core/browser.rb
+- lib/puppeteer/bidi/core/browsing_context.rb
+- lib/puppeteer/bidi/core/disposable.rb
+- lib/puppeteer/bidi/core/errors.rb
+- lib/puppeteer/bidi/core/event_emitter.rb
+- lib/puppeteer/bidi/core/navigation.rb
+- lib/puppeteer/bidi/core/realm.rb
+- lib/puppeteer/bidi/core/request.rb
+- lib/puppeteer/bidi/core/session.rb
+- lib/puppeteer/bidi/core/user_context.rb
+- lib/puppeteer/bidi/core/user_prompt.rb
+- lib/puppeteer/bidi/deserializer.rb
+- lib/puppeteer/bidi/element_handle.rb
+- lib/puppeteer/bidi/errors.rb
+- lib/puppeteer/bidi/file_chooser.rb
+- lib/puppeteer/bidi/frame.rb
+- lib/puppeteer/bidi/http_response.rb
+- lib/puppeteer/bidi/injected.js
+- lib/puppeteer/bidi/injected_source.rb
+- lib/puppeteer/bidi/js_handle.rb
+- lib/puppeteer/bidi/keyboard.rb
+- lib/puppeteer/bidi/lazy_arg.rb
+- lib/puppeteer/bidi/mouse.rb
+- lib/puppeteer/bidi/page.rb
+- lib/puppeteer/bidi/query_handler.rb
+- lib/puppeteer/bidi/realm.rb
+- lib/puppeteer/bidi/serializer.rb
+- lib/puppeteer/bidi/target.rb
+- lib/puppeteer/bidi/task_manager.rb
+- lib/puppeteer/bidi/timeout_settings.rb
+- lib/puppeteer/bidi/transport.rb
+- lib/puppeteer/bidi/version.rb
+- lib/puppeteer/bidi/wait_task.rb
+- scripts/update_injected_source.rb
+- sig/puppeteer/bidi.rbs
+- sig/puppeteer/bidi/browser.rbs
+- sig/puppeteer/bidi/element_handle.rbs
+- sig/puppeteer/bidi/frame.rbs
+- sig/puppeteer/bidi/js_handle.rbs
+- sig/puppeteer/bidi/page.rbs
+homepage: https://github.com/YusukeIwaki/puppeteer-bidi
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/YusukeIwaki/puppeteer-bidi
+  source_code_uri: https://github.com/YusukeIwaki/puppeteer-bidi
+  changelog_uri: https://github.com/YusukeIwaki/puppeteer-bidi/blob/master/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: A Ruby port of Puppeteer using WebDriver BiDi protocol for Firefox automation
+test_files: []