browserctl 0.13.0 → 0.13.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 41aa6c550f8a9a6403781639ebbd381c653aedb03cfa95f732b74de3ee0a931d
-  data.tar.gz: 3feea758e797eca81e1ab269ca5d9011f82778510dab1ee45e31b80b9aa38048
+  metadata.gz: a09c4e2ffdede17be7f5d14108d72ef30ea75c82bbae924b753474e77c5778c2
+  data.tar.gz: 27dbcdbf87b1e2460ebfc7913dbeecf9780e218f7824e5e9292668db5a0fb59e
 SHA512:
-  metadata.gz: e100a2bce4a66b7ccd1cfaebfd5e5acb3b0f9c32aafec8427efe0f8d2b613ae954d9043a8d4da536284b7739508d4b318dab5e2abe16a83113938a23fb000796
-  data.tar.gz: b2171d7d6043c5c89084a21f50a5c53bbaa0ce1e891babeb30b4beb66ede7e41e8f87e7382980bb9f9229e453121cc99bd252aa4d54c48598d01bdbc7fbdadab
+  metadata.gz: 4bb8d31d716febfc0a3ffa593d7d1141dfdf1ad6d548d5d2b8e4ed53a8d04adb9f5861728e3864f65b7a296cc58c93c2e3d66b4f632988508fc699cb841837d0
+  data.tar.gz: 8791f86942d5447fec3dc1aec3391c106a8553f7ef9e99ab372750a7ac18a278e824940a09cca5492bdc8a87e90dcd09ad7e1d04a47c9258e4783c2573bc36e6

data/CHANGELOG.md

@@ -10,6 +10,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.13.1](https://github.com/patrick204nqh/browserctl/compare/v0.13.0...v0.13.1) (2026-05-11)
+
+
+### Bug Fixes
+
+* **daemon:** sweep orphaned Ferrum chromes on browserd startup ([#177](https://github.com/patrick204nqh/browserctl/issues/177)) ([0f6f9ab](https://github.com/patrick204nqh/browserctl/commit/0f6f9aba9165fc1c03c3ccb0e0e32e32b6a19efb)), closes [#176](https://github.com/patrick204nqh/browserctl/issues/176)
+* **test:** raise daemon start timeout to 30s for snap Chromium ([#172](https://github.com/patrick204nqh/browserctl/issues/172)) ([107fcdb](https://github.com/patrick204nqh/browserctl/commit/107fcdb67f4e34b18e228fb2d5ef7837ec509526))
+
 ## [0.13.0](https://github.com/patrick204nqh/browserctl/compare/v0.12.0...v0.13.0) (2026-05-10)
 
 

data/lib/browserctl/orphan_sweeper.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Browserctl
+  # Terminates orphaned Ferrum-spawned browser processes left behind by previous
+  # daemon or rspec runs that did not shut down cleanly (SIGKILL, OOM, crash).
+  #
+  # Only targets processes whose argv contains the Ferrum temp user-data-dir marker
+  # AND whose PPID is 1 — so children of any live daemon are never touched.
+  module OrphanSweeper
+    USER_DATA_DIR_MARKER = "ferrum_user_data_dir_"
+
+    module_function
+
+    def sweep(logger: Browserctl.logger, lister: method(:list_processes), killer: method(:kill_process))
+      return unless supported_platform?
+
+      orphans = find_orphans(lister.call)
+      return if orphans.empty?
+
+      logger&.info("orphan sweep: found #{orphans.size} stale browser process(es) from previous run")
+      orphans.each { |pid| killer.call(pid, logger) }
+    end
+
+    def find_orphans(processes)
+      processes.filter_map do |p|
+        next unless p[:ppid] == 1 && p[:command].to_s.include?(USER_DATA_DIR_MARKER)
+
+        p[:pid]
+      end
+    end
+
+    def list_processes
+      output = `ps -eo pid=,ppid=,command= 2>/dev/null`
+      return [] if output.empty?
+
+      output.lines.filter_map do |line|
+        pid, ppid, command = line.strip.split(" ", 3)
+        next unless pid && ppid && command
+
+        { pid: pid.to_i, ppid: ppid.to_i, command: command }
+      end
+    end
+
+    def kill_process(pid, logger)
+      Process.kill("TERM", pid)
+      logger&.info("orphan sweep: terminated PID #{pid}")
+    rescue Errno::ESRCH
+      # already gone
+    rescue Errno::EPERM
+      logger&.debug("orphan sweep: no permission to kill PID #{pid}")
+    end
+
+    def supported_platform?
+      !RUBY_PLATFORM.match?(/mingw|mswin|windows/)
+    end
+  end
+end

data/lib/browserctl/server.rb

@@ -6,6 +6,7 @@ require "fileutils"
 require "timeout"
 require_relative "constants"
 require_relative "logger"
+require_relative "orphan_sweeper"
 require_relative "driver/cdp_page"
 require_relative "driver/cdp"
 require_relative "server/command_dispatcher"
@@ -23,6 +24,7 @@ module Browserctl
 
     def run
       guard_already_running!
+      OrphanSweeper.sweep
       write_pid
       server, idle = setup_server
       serve(server)

data/lib/browserctl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Browserctl
-  VERSION = "0.13.0"
+  VERSION = "0.13.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: browserctl
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.13.1
 platform: ruby
 authors:
 - Patrick
@@ -138,25 +138,11 @@ files:
 - bin/browserd
 - bin/setup
 - examples/cloudflare_hitl.rb
-- examples/test_automation_practices/advanced/ab_testing.rb
-- examples/test_automation_practices/advanced/broken_images.rb
-- examples/test_automation_practices/advanced/file_download.rb
-- examples/test_automation_practices/advanced/iframes.rb
-- examples/test_automation_practices/advanced/shadow_dom.rb
 - examples/test_automation_practices/auth/login.rb
 - examples/test_automation_practices/auth/login_negative.rb
-- examples/test_automation_practices/dialogs/alerts.rb
 - examples/test_automation_practices/dialogs/notifications.rb
 - examples/test_automation_practices/dynamic/dynamic_elements.rb
-- examples/test_automation_practices/dynamic/tables.rb
 - examples/test_automation_practices/forms/checkboxes.rb
-- examples/test_automation_practices/forms/file_upload.rb
-- examples/test_automation_practices/forms/forms.rb
-- examples/test_automation_practices/forms/slider.rb
-- examples/test_automation_practices/interactions/context_menu.rb
-- examples/test_automation_practices/interactions/drag_drop.rb
-- examples/test_automation_practices/interactions/exit_intent.rb
-- examples/test_automation_practices/interactions/hover.rb
 - examples/test_automation_practices/interactions/key_press.rb
 - examples/the_internet/add_remove_elements.rb
 - examples/the_internet/checkboxes.rb
@@ -209,6 +195,7 @@ files:
 - lib/browserctl/format_version.rb
 - lib/browserctl/logger.rb
 - lib/browserctl/migrations.rb
+- lib/browserctl/orphan_sweeper.rb
 - lib/browserctl/policy.rb
 - lib/browserctl/recording.rb
 - lib/browserctl/recording/log_writer.rb

data/examples/test_automation_practices/advanced/ab_testing.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/advanced/ab_testing" do
-  desc "A/B testing page: verify one variant renders, click counter increments"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_advanced_ab_testing.png")
-
-  step "open A/B testing page and detect variant" do
-    open_page(:main, url: "#{base_url}/#/ab-testing")
-    page(:main).wait("[data-test='ab-testing-page']", timeout: 10)
-    title = page(:main).evaluate(
-      "document.querySelector('[data-test=\"variant-title\"]')?.textContent?.trim()"
-    )
-    assert title&.length&.positive?, "expected variant title to be present, got: #{title.inspect}"
-    store(:variant_title, title)
-  end
-
-  step "variant title contains A or B" do
-    title = fetch(:variant_title)
-    assert title.include?("A") || title.include?("B"),
-           "expected variant A or B in title, got: #{title.inspect}"
-  end
-
-  step "click button — counter increments" do
-    initial_text = page(:main).evaluate(
-      "document.querySelector('[data-test=\"variant-button\"]')?.textContent?.trim()"
-    )
-    page(:main).click("[data-test='variant-button']")
-    sleep 0.5
-    updated_text = page(:main).evaluate(
-      "document.querySelector('[data-test=\"variant-button\"]')?.textContent?.trim()"
-    )
-    assert initial_text != updated_text,
-           "expected button text to change after click (counter), still: #{updated_text.inspect}"
-    page(:main).screenshot(path: screenshot_path)
-  end
-end

data/examples/test_automation_practices/advanced/broken_images.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/advanced/broken_images" do
-  desc "Broken images page: verify one image loads successfully and two are broken (naturalWidth == 0)"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_advanced_broken_images.png")
-
-  step "open broken images page" do
-    open_page(:main, url: "#{base_url}/#/broken-images")
-    page(:main).wait("[data-test='image-container-0']", timeout: 10)
-    sleep 1
-  end
-
-  step "check which images loaded and which are broken" do
-    widths = page(:main).evaluate(
-      "[0,1,2].map(i => document.querySelector(`[data-test=\"image-${i}\"]`)?.naturalWidth ?? -1)"
-    )
-    loaded  = widths.count(&:positive?)
-    broken  = widths.count(&:zero?)
-    assert loaded == 1, "expected exactly 1 valid image, got #{loaded} (widths: #{widths.inspect})"
-    assert broken == 2, "expected exactly 2 broken images, got #{broken} (widths: #{widths.inspect})"
-    page(:main).screenshot(path: screenshot_path)
-  end
-end

data/examples/test_automation_practices/advanced/file_download.rb

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/advanced/file_download" do
-  desc "File download page: trigger each download, verify button enters disabled state, verify no error shown"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_advanced_file_download.png")
-
-  step "open file download page" do
-    open_page(:main, url: "#{base_url}/#/file-download")
-    page(:main).wait("[data-test='download-card-0']", timeout: 10)
-  end
-
-  step "click TXT download — button becomes disabled during download" do
-    page(:main).click("[data-test='download-button-0']")
-    page(:main).wait("[data-test='download-button-0'][disabled]", timeout: 5)
-    disabled = page(:main).evaluate(
-      "document.querySelector('[data-test=\"download-button-0\"]')?.disabled"
-    )
-    assert disabled, "expected download-button-0 to be disabled while downloading"
-    page(:main).wait("[data-test='download-button-0']:not([disabled])", timeout: 10)
-    no_error = page(:main).evaluate("!document.querySelector('[data-test=\"error-message\"]')")
-    assert no_error, "expected no error-message after TXT download"
-  end
-
-  step "click CSV download — completes without error" do
-    page(:main).click("[data-test='download-button-1']")
-    page(:main).wait("[data-test='download-button-1']:not([disabled])", timeout: 10)
-    no_error = page(:main).evaluate("!document.querySelector('[data-test=\"error-message\"]')")
-    assert no_error, "expected no error-message after CSV download"
-  end
-
-  step "click PDF download — completes without error" do
-    page(:main).click("[data-test='download-button-2']")
-    page(:main).wait("[data-test='download-button-2']:not([disabled])", timeout: 10)
-    no_error = page(:main).evaluate("!document.querySelector('[data-test=\"error-message\"]')")
-    assert no_error, "expected no error-message after PDF download"
-    page(:main).screenshot(path: screenshot_path)
-  end
-end

data/examples/test_automation_practices/advanced/iframes.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/advanced/iframes" do
-  desc "Iframes page: click inside sandboxed iframes, verify postMessage received in parent"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_advanced_iframes.png")
-
-  step "open iframes page" do
-    open_page(:main, url: "#{base_url}/#/iframes")
-    page(:main).wait("[data-test='iframe-container']", timeout: 10)
-    sleep 0.5
-  end
-
-  step "click button inside iframe1 — message appears in parent" do
-    page(:main).evaluate(
-      "document.querySelector('[data-test=\"iframe-iframe1\"]').contentDocument.querySelector('button').click()"
-    )
-    page(:main).wait("[data-test='iframe-message-0']", timeout: 5)
-    msg = page(:main).evaluate(
-      "document.querySelector('[data-test=\"iframe-message-0\"]')?.textContent?.trim()"
-    )
-    assert msg&.length&.positive?, "expected a message after clicking iframe1 button, got: #{msg.inspect}"
-    page(:main).screenshot(path: screenshot_path)
-  end
-
-  step "click button inside iframe2 — second message appears" do
-    page(:main).evaluate(
-      "document.querySelector('[data-test=\"iframe-iframe2\"]').contentDocument.querySelector('button').click()"
-    )
-    page(:main).wait("[data-test='iframe-message-1']", timeout: 5)
-    count = page(:main).evaluate(
-      "document.querySelectorAll('[data-test^=\"iframe-message-\"]').length"
-    )
-    assert count >= 2, "expected at least 2 messages after both iframe clicks, got: #{count}"
-  end
-end

data/examples/test_automation_practices/advanced/shadow_dom.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/advanced/shadow_dom" do
-  desc "Shadow DOM page: query inside shadow root, click shadow-button, accept its alert"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_advanced_shadow_dom.png")
-
-  step "open shadow DOM page" do
-    open_page(:main, url: "#{base_url}/#/shadow-dom")
-    page(:main).wait("[data-test='shadow-host']", timeout: 10)
-  end
-
-  step "verify shadow content is accessible via shadowRoot" do
-    text = page(:main).evaluate(
-      "document.querySelector('[data-test=\"shadow-host\"]').shadowRoot" \
-      "?.querySelector('[data-test=\"shadow-content\"]')?.textContent?.trim()"
-    )
-    assert text&.length&.positive?, "expected shadow-content text via shadowRoot, got: #{text.inspect}"
-    page(:main).screenshot(path: screenshot_path)
-  end
-
-  step "click shadow-button — accept the alert — page stays responsive" do
-    page(:main).dialog_accept
-    page(:main).evaluate(
-      "document.querySelector('[data-test=\"shadow-host\"]').shadowRoot" \
-      ".querySelector('[data-test=\"shadow-button\"]').click()"
-    )
-    sleep 0.3
-    still_present = page(:main).evaluate(
-      "!!document.querySelector('[data-test=\"shadow-host\"]')"
-    )
-    assert still_present, "expected shadow-host to remain in DOM after alert was accepted"
-  end
-end

data/examples/test_automation_practices/dialogs/alerts.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/dialogs/alerts" do
-  desc "Alerts page: pre-register accept/dismiss handlers before triggering each JS dialog type"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_dialogs_alerts.png")
-
-  step "open alerts page" do
-    open_page(:main, url: "#{base_url}/#/alerts")
-  end
-
-  step "accept an alert — result-container shows confirmation" do
-    page(:main).dialog_accept
-    page(:main).click("[data-test='alert-button']")
-    page(:main).wait("[data-test='result-container']", timeout: 5)
-    result = page(:main).evaluate("document.querySelector('[data-test=\"result-container\"]')?.textContent?.trim()")
-    assert result == "Last action: Alert shown", "expected alert result, got: #{result.inspect}"
-  end
-
-  step "accept a confirm — result-container shows true" do
-    page(:main).dialog_accept
-    page(:main).click("[data-test='confirm-button']")
-    page(:main).wait("[data-test='result-container']", timeout: 5)
-    result = page(:main).evaluate("document.querySelector('[data-test=\"result-container\"]')?.textContent?.trim()")
-    assert result == "Last action: Confirm dialog: true", "expected confirm true result, got: #{result.inspect}"
-  end
-
-  step "dismiss a confirm — result-container shows false" do
-    page(:main).dialog_dismiss
-    page(:main).click("[data-test='confirm-button']")
-    page(:main).wait("[data-test='result-container']", timeout: 5)
-    result = page(:main).evaluate("document.querySelector('[data-test=\"result-container\"]')?.textContent?.trim()")
-    assert result == "Last action: Confirm dialog: false", "expected confirm false result, got: #{result.inspect}"
-  end
-
-  step "accept a prompt with text — result-container shows entered text" do
-    page(:main).dialog_accept(text: "browserctl")
-    page(:main).click("[data-test='prompt-button']")
-    page(:main).wait("[data-test='result-container']", timeout: 5)
-    result = page(:main).evaluate("document.querySelector('[data-test=\"result-container\"]')?.textContent?.trim()")
-    assert result&.include?("browserctl"), "expected prompt text in result, got: #{result.inspect}"
-    page(:main).screenshot(path: screenshot_path)
-  end
-end

data/examples/test_automation_practices/dynamic/tables.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/dynamic/tables" do
-  desc "Tables page: verify initial data, sort by column ascending and descending"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_dynamic_tables.png")
-
-  step "open tables page and verify initial rows" do
-    open_page(:main, url: "#{base_url}/#/tables")
-    page(:main).wait("[data-test='dynamic-table']", timeout: 10)
-    rows = page(:main).evaluate(
-      "Array.from(document.querySelectorAll('[data-test^=\"table-row-\"]')).map(r => r.dataset.test)"
-    )
-    assert rows.length == 3, "expected 3 rows, got: #{rows.length}"
-  end
-
-  step "sort by name ascending — alphabetical order" do
-    page(:main).click("[data-test='table-header-name']")
-    sleep 0.2
-    names = page(:main).evaluate(
-      "Array.from(document.querySelectorAll('[data-test^=\"table-cell-name-\"]')).map(el => el.textContent?.trim())"
-    )
-    sorted = names.sort
-    assert names == sorted, "expected names sorted ascending, got: #{names.inspect}"
-    page(:main).screenshot(path: screenshot_path)
-  end
-
-  step "sort by name descending — click header again" do
-    page(:main).click("[data-test='table-header-name']")
-    sleep 0.2
-    names = page(:main).evaluate(
-      "Array.from(document.querySelectorAll('[data-test^=\"table-cell-name-\"]')).map(el => el.textContent?.trim())"
-    )
-    sorted_desc = names.sort.reverse
-    assert names == sorted_desc, "expected names sorted descending, got: #{names.inspect}"
-  end
-
-  step "sort by status — Active/Inactive grouping" do
-    page(:main).click("[data-test='table-header-status']")
-    sleep 0.2
-    statuses = page(:main).evaluate(
-      "Array.from(document.querySelectorAll('[data-test^=\"table-cell-status-\"]')).map(el => el.textContent?.trim())"
-    )
-    assert statuses == statuses.sort, "expected statuses sorted ascending, got: #{statuses.inspect}"
-  end
-end

data/examples/test_automation_practices/forms/file_upload.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/forms/file_upload" do
-  desc "File upload page: attach a local file via the hidden file input, verify the file is selected"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path,
-        default: File.expand_path(".browserctl/screenshots/tap_forms_file_upload.png")
-
-  step "open file upload page" do
-    open_page(:main, url: "#{base_url}/#/file-upload")
-    page(:main).wait("[data-test='file-uploader']", timeout: 10)
-  end
-
-  step "upload a file and verify it is selected" do
-    Dir.mktmpdir do |dir|
-      path = File.join(dir, "browserctl_test.txt")
-      File.write(path, "browserctl v0.7 upload test")
-
-      page(:main).upload("[data-test='file-input']", path)
-      page(:main).wait("[data-test='uploaded-file-0']", timeout: 10)
-
-      filename = page(:main).evaluate(
-        "document.querySelector('[data-test=\"uploaded-file-0\"]')?.querySelector('span.truncate')?.textContent?.trim()"
-      )
-      assert filename == "browserctl_test.txt", "expected filename in list, got: #{filename.inspect}"
-    end
-    page(:main).screenshot(path: screenshot_path)
-  end
-end

data/examples/test_automation_practices/forms/forms.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/forms/forms" do
-  desc "Forms page: trigger inline validation errors, then submit a valid form"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_forms_forms.png")
-
-  step "open forms page" do
-    open_page(:main, url: "#{base_url}/#/forms")
-    page(:main).wait("[data-test='login-form']", timeout: 10)
-  end
-
-  step "submit empty form — all three fields show errors" do
-    page(:main).click("[data-test='submit-button']")
-    page(:main).wait("[data-test='username-error']", timeout: 5)
-    username_err = page(:main).evaluate("document.querySelector('[data-test=\"username-error\"]')?.textContent?.trim()")
-    email_err    = page(:main).evaluate("document.querySelector('[data-test=\"email-error\"]')?.textContent?.trim()")
-    password_err = page(:main).evaluate("document.querySelector('[data-test=\"password-error\"]')?.textContent?.trim()")
-    assert username_err&.length&.positive?, "expected username error, got: #{username_err.inspect}"
-    assert email_err&.length&.positive?,    "expected email error, got: #{email_err.inspect}"
-    assert password_err&.length&.positive?, "expected password error, got: #{password_err.inspect}"
-  end
-
-  step "fill invalid email — email error shown" do
-    page(:main).fill("[data-test='email-input']", "not-an-email")
-    page(:main).click("[data-test='submit-button']")
-    page(:main).wait("[data-test='email-error']", timeout: 5)
-    email_err = page(:main).evaluate("document.querySelector('[data-test=\"email-error\"]')?.textContent?.trim()")
-    assert email_err&.length&.positive?, "expected email format error, got: #{email_err.inspect}"
-  end
-
-  step "fill valid credentials and submit — no errors shown" do
-    page(:main).fill("[data-test='username-input']", "testuser")
-    page(:main).fill("[data-test='email-input']", "test@example.com")
-    page(:main).fill("[data-test='password-input']", "password123")
-    page(:main).click("[data-test='submit-button']")
-    sleep 0.5
-    username_err = page(:main).evaluate("!!document.querySelector('[data-test=\"username-error\"]')")
-    email_err    = page(:main).evaluate("!!document.querySelector('[data-test=\"email-error\"]')")
-    password_err = page(:main).evaluate("!!document.querySelector('[data-test=\"password-error\"]')")
-    assert !username_err, "expected no username error on valid submit"
-    assert !email_err,    "expected no email error on valid submit"
-    assert !password_err, "expected no password error on valid submit"
-    page(:main).screenshot(path: screenshot_path)
-  end
-end

data/examples/test_automation_practices/forms/slider.rb

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-SET_SLIDER_JS = <<~JS
-  (function(val) {
-    const el = document.querySelector('[data-test="slider"]');
-    Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value')
-          .set.call(el, val);
-    el.dispatchEvent(new Event('input', { bubbles: true }));
-    el.dispatchEvent(new Event('change', { bubbles: true }));
-  })(%<value>d)
-JS
-
-Browserctl.workflow "test_automation_practices/forms/slider" do
-  desc "Slider page: set slider to specific values via evaluate, verify displayed value updates"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_forms_slider.png")
-
-  step "open slider page" do
-    open_page(:main, url: "#{base_url}/#/slider")
-    page(:main).wait("[data-test='slider-container']", timeout: 10)
-  end
-
-  step "set slider to 75 and verify display" do
-    page(:main).evaluate(format(SET_SLIDER_JS, value: 75))
-    sleep 0.1
-    displayed = page(:main).evaluate(
-      "document.querySelector('[data-test=\"slider-value\"]')?.textContent?.trim()"
-    )
-    assert displayed&.include?("75"), "expected slider-value to show 75, got: #{displayed.inspect}"
-  end
-
-  step "set slider to minimum (0) and verify" do
-    page(:main).evaluate(format(SET_SLIDER_JS, value: 0))
-    sleep 0.1
-    displayed = page(:main).evaluate(
-      "document.querySelector('[data-test=\"slider-value\"]')?.textContent?.trim()"
-    )
-    assert displayed&.include?("0"), "expected slider-value to show 0, got: #{displayed.inspect}"
-  end
-
-  step "set slider to maximum (100) and screenshot" do
-    page(:main).evaluate(format(SET_SLIDER_JS, value: 100))
-    sleep 0.1
-    displayed = page(:main).evaluate(
-      "document.querySelector('[data-test=\"slider-value\"]')?.textContent?.trim()"
-    )
-    assert displayed&.include?("100"), "expected slider-value to show 100, got: #{displayed.inspect}"
-    page(:main).screenshot(path: screenshot_path)
-  end
-end

data/examples/test_automation_practices/interactions/context_menu.rb

@@ -1,54 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/interactions/context_menu" do
-  desc "Context menu page: trigger via dispatched contextmenu event, click each action, dismiss"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_interactions_context_menu.png")
-
-  step "open context menu page" do
-    open_page(:main, url: "#{base_url}/#/context-menu")
-    page(:main).wait("[data-test='context-menu-trigger']", timeout: 10)
-  end
-
-  step "trigger context menu via dispatched event — menu appears" do
-    page(:main).evaluate(<<~JS)
-      document.querySelector('[data-test="context-menu-trigger"]').dispatchEvent(
-        new MouseEvent('contextmenu', { bubbles: true, cancelable: true, clientX: 200, clientY: 300 })
-      )
-    JS
-    page(:main).wait("[data-test='context-menu']", timeout: 5)
-    visible = page(:main).evaluate("!!document.querySelector('[data-test=\"context-menu\"]')")
-    assert visible, "expected context-menu to appear after right-click event"
-  end
-
-  step "all three menu items are present" do
-    has_edit       = page(:main).evaluate("!!document.querySelector('[data-test=\"context-menu-edit\"]')")
-    has_delete     = page(:main).evaluate("!!document.querySelector('[data-test=\"context-menu-delete\"]')")
-    has_properties = page(:main).evaluate("!!document.querySelector('[data-test=\"context-menu-properties\"]')")
-    assert has_edit,       "expected context-menu-edit to be present"
-    assert has_delete,     "expected context-menu-delete to be present"
-    assert has_properties, "expected context-menu-properties to be present"
-    page(:main).screenshot(path: screenshot_path)
-  end
-
-  step "click Edit — menu closes" do
-    page(:main).click("[data-test='context-menu-edit']")
-    sleep 0.2
-    gone = page(:main).evaluate("!document.querySelector('[data-test=\"context-menu\"]')")
-    assert gone, "expected context-menu to close after clicking Edit"
-  end
-
-  step "re-open and dismiss by clicking outside" do
-    page(:main).evaluate(<<~JS)
-      document.querySelector('[data-test="context-menu-trigger"]').dispatchEvent(
-        new MouseEvent('contextmenu', { bubbles: true, cancelable: true, clientX: 200, clientY: 300 })
-      )
-    JS
-    page(:main).wait("[data-test='context-menu']", timeout: 5)
-    page(:main).evaluate("document.querySelector('[data-test=\"context-menu-area\"]').click()")
-    sleep 0.2
-    gone = page(:main).evaluate("!document.querySelector('[data-test=\"context-menu\"]')")
-    assert gone, "expected context-menu to close after clicking outside"
-  end
-end

data/examples/test_automation_practices/interactions/drag_drop.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/interactions/drag_drop" do
-  desc "Drag-drop page: reorder items via keyboard (Space to pick up, Arrow to move, Space to drop)"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_interactions_drag_drop.png")
-
-  step "open drag-drop page and read initial order" do
-    open_page(:main, url: "#{base_url}/#/drag-drop")
-    page(:main).wait("[data-test='drag-drop-list']", timeout: 10)
-    items = page(:main).evaluate(
-      "Array.from(document.querySelectorAll('[data-test=\"drag-drop-list\"] li')).map(el => el.textContent?.trim())"
-    )
-    store(:initial_order, items)
-    assert items.length == 5, "expected 5 items in drag-drop list, got: #{items.length}"
-  end
-
-  step "focus first item and move it down one position via keyboard" do
-    page(:main).evaluate(
-      "document.querySelectorAll('[data-test=\"drag-drop-list\"] li')[0].focus()"
-    )
-    sleep 0.1
-    page(:main).press("Space")
-    sleep 0.1
-    page(:main).press("ArrowDown")
-    sleep 0.1
-    page(:main).press("Space")
-    sleep 0.2
-  end
-
-  step "verify first item moved to second position" do
-    initial = fetch(:initial_order)
-    current = page(:main).evaluate(
-      "Array.from(document.querySelectorAll('[data-test=\"drag-drop-list\"] li')).map(el => el.textContent?.trim())"
-    )
-    assert current[1] == initial[0],
-           "expected '#{initial[0]}' at index 1 after move down, got order: #{current.inspect}"
-    page(:main).screenshot(path: screenshot_path)
-  end
-end

data/examples/test_automation_practices/interactions/exit_intent.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/interactions/exit_intent" do
-  desc "Exit intent page: trigger modal by dispatching mouseleave at viewport top, test all dismiss paths"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_interactions_exit_intent.png")
-
-  step "open exit intent page" do
-    open_page(:main, url: "#{base_url}/#/exit-intent")
-    sleep 0.5
-  end
-
-  step "trigger exit intent — modal appears" do
-    page(:main).evaluate(<<~JS)
-      document.dispatchEvent(
-        new MouseEvent('mouseleave', { bubbles: true, cancelable: true, clientY: -1 })
-      )
-    JS
-    page(:main).wait("[data-test='exit-modal']", timeout: 5)
-    visible = page(:main).evaluate("!!document.querySelector('[data-test=\"exit-modal\"]')")
-    assert visible, "expected exit-modal to appear after mouseleave event"
-    page(:main).screenshot(path: screenshot_path)
-  end
-
-  step "dismiss via X close button — modal disappears" do
-    page(:main).click("[data-test='close-modal']")
-    sleep 0.2
-    gone = page(:main).evaluate("!document.querySelector('[data-test=\"exit-modal\"]')")
-    assert gone, "expected exit-modal to close after clicking X"
-  end
-
-  step "re-trigger and dismiss via No thanks" do
-    page(:main).navigate("#{base_url}/#/exit-intent")
-    sleep 0.5
-    page(:main).evaluate(<<~JS)
-      document.dispatchEvent(
-        new MouseEvent('mouseleave', { bubbles: true, cancelable: true, clientY: -1 })
-      )
-    JS
-    page(:main).wait("[data-test='exit-modal']", timeout: 5)
-    page(:main).click("[data-test='modal-no']")
-    sleep 0.2
-    gone = page(:main).evaluate("!document.querySelector('[data-test=\"exit-modal\"]')")
-    assert gone, "expected exit-modal to close after clicking No thanks"
-  end
-end

data/examples/test_automation_practices/interactions/hover.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-Browserctl.workflow "test_automation_practices/interactions/hover" do
-  desc "Hover states page: move mouse over each figure, verify overlay content appears on each"
-
-  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
-  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_interactions_hover.png")
-
-  step "open hover states page" do
-    open_page(:main, url: "#{base_url}/#/hover")
-    page(:main).wait("[data-test='hover-example']", timeout: 10)
-  end
-
-  step "hover over each figure and verify caption appears" do
-    [1, 2, 3].each do |i|
-      page(:main).hover("[data-test='hover-figure-#{i}']")
-      sleep 0.2
-      caption = page(:main).evaluate(
-        "!!document.querySelector('[data-test=\"hover-caption-#{i}\"]')"
-      )
-      assert caption, "expected caption to appear on figure #{i} after hover"
-    end
-  end
-
-  step "screenshot the hovered state" do
-    page(:main).hover("[data-test='hover-figure-2']")
-    sleep 0.2
-    page(:main).screenshot(path: screenshot_path)
-  end
-end