capybara-lightpanda 0.2.2 → 0.4.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: capybara-lightpanda
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Navid Emad
@@ -71,6 +71,7 @@ files:
 - NOTICE.md
 - README.md
 - lib/capybara-lightpanda.rb
+- lib/capybara/lightpanda/auto_scripts.rb
 - lib/capybara/lightpanda/binary.rb
 - lib/capybara/lightpanda/browser.rb
 - lib/capybara/lightpanda/client.rb
@@ -78,20 +79,21 @@ files:
 - lib/capybara/lightpanda/client/web_socket.rb
 - lib/capybara/lightpanda/cookies.rb
 - lib/capybara/lightpanda/driver.rb
+- lib/capybara/lightpanda/element_extension.rb
 - lib/capybara/lightpanda/errors.rb
-- lib/capybara/lightpanda/frame.rb
+- lib/capybara/lightpanda/headers.rb
 - lib/capybara/lightpanda/javascripts/index.js
-- lib/capybara/lightpanda/javascripts/polyfills.js
 - lib/capybara/lightpanda/keyboard.rb
 - lib/capybara/lightpanda/logger.rb
 - lib/capybara/lightpanda/network.rb
 - lib/capybara/lightpanda/node.rb
 - lib/capybara/lightpanda/options.rb
 - lib/capybara/lightpanda/process.rb
+- lib/capybara/lightpanda/tasks/binary.rake
 - lib/capybara/lightpanda/utils/attempt.rb
 - lib/capybara/lightpanda/utils/event.rb
+- lib/capybara/lightpanda/utils/wait.rb
 - lib/capybara/lightpanda/version.rb
-- lib/capybara/lightpanda/xpath_polyfill.rb
 homepage: https://navidemad.github.io/capybara-lightpanda
 licenses:
 - MIT
@@ -115,7 +117,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Capybara driver for the Lightpanda headless browser
 test_files: []

data/lib/capybara/lightpanda/frame.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module Capybara
-  module Lightpanda
-    # Lightweight metadata view of a CDP frame, populated from
-    # Page.frameAttached / Page.frameNavigated / Page.frame{Started,Stopped}Loading
-    # events. Mirrors a subset of ferrum's Frame.
-    #
-    # NOTE: this is purely introspection — Lightpanda's frame loading events
-    # are not reliable enough to drive `wait_for_navigation` (#1801, #1832),
-    # so the gem still drives navigation waits via Page.loadEventFired with
-    # readyState polling. The frame map is useful for diagnostics, listing
-    # iframes, and resolving frame metadata (name/URL) without callFunctionOn.
-    class Frame
-      STATES = %i[started_loading navigated stopped_loading detached].freeze
-
-      attr_reader :id, :parent_id
-      attr_accessor :name, :url, :state
-
-      def initialize(id, parent_id = nil, name: nil, url: nil)
-        @id = id
-        @parent_id = parent_id
-        @name = name
-        @url = url
-        @state = nil
-      end
-
-      def main?
-        @parent_id.nil?
-      end
-    end
-  end
-end

data/lib/capybara/lightpanda/javascripts/polyfills.js

@@ -1,212 +0,0 @@
-// Polyfills compensant des limitations du binaire Lightpanda.
-// Chaque section est gardée par un test de feature : dès qu'upstream implémente
-// l'API native, le polyfill devient un no-op et peut être retiré.
-// Voir UPSTREAM_BUGS.md à la racine du gem pour les repros et liens d'issues.
-(function () {
-  "use strict";
-
-  // ── Bug #7 — HTMLFormElement / HTMLButtonElement / HTMLInputElement form-* IDL gaps ──
-  // Lightpanda doesn't expose `form.enctype`, `form.method`, `form.action`,
-  // `form.target`, nor the submitter-side `formEnctype` / `formMethod` /
-  // `formAction` / `formTarget` overrides. Per WHATWG HTML these must always
-  // return a string (with the spec's missing-value default) so consumers can
-  // call `.toLowerCase()` etc. directly. Turbo's `FormSubmission` constructor
-  // does exactly that and crashes with `Cannot read properties of undefined
-  // (reading 'toLowerCase')` when it touches enctype.
-  //
-  // Polyfill strategy: only define the IDL getter when it's missing on the
-  // prototype, so a future Lightpanda nightly that adds native support wins
-  // automatically. Each getter falls back to the underlying attribute, with
-  // the spec's default if the attribute is absent. For submitter overrides
-  // (formEnctype, formMethod, etc.) we return the empty string when the
-  // override attribute is unset — Turbo and Hotwire all use the
-  // `submitter.formX || form.X` idiom, which resolves correctly when the
-  // submitter side returns "".
-  (function patchFormIDL() {
-    var ENCTYPE_VALUES = ["application/x-www-form-urlencoded", "multipart/form-data", "text/plain"];
-    function normEnctype(v) {
-      if (!v) return "application/x-www-form-urlencoded";
-      v = String(v).toLowerCase();
-      return ENCTYPE_VALUES.indexOf(v) >= 0 ? v : "application/x-www-form-urlencoded";
-    }
-    function normMethod(v) {
-      if (!v) return "get";
-      v = String(v).toLowerCase();
-      return (v === "post" || v === "dialog") ? v : "get";
-    }
-    function defineIfMissing(proto, name, getter) {
-      if (!proto || name in proto) return;
-      try { Object.defineProperty(proto, name, { configurable: true, enumerable: true, get: getter }); } catch (_) {}
-    }
-    if (typeof HTMLFormElement !== "undefined") {
-      var fp = HTMLFormElement.prototype;
-      defineIfMissing(fp, "enctype", function () { return normEnctype(this.getAttribute("enctype")); });
-      defineIfMissing(fp, "method",  function () { return normMethod(this.getAttribute("method")); });
-      defineIfMissing(fp, "action",  function () {
-        var a = this.getAttribute("action");
-        if (a == null || a === "") return (this.ownerDocument && this.ownerDocument.URL) || "";
-        try { return new URL(a, (this.ownerDocument && this.ownerDocument.URL) || undefined).href; }
-        catch (_) { return a; }
-      });
-      defineIfMissing(fp, "target",  function () { return this.getAttribute("target") || ""; });
-    }
-    function patchSubmitter(Ctor) {
-      if (typeof Ctor === "undefined") return;
-      var p = Ctor.prototype;
-      // Empty string is the spec's missing-value default for the submitter-side
-      // IDL attrs — keep Turbo's `submitter.formX || form.X` idiom flowing
-      // through to the form's value.
-      defineIfMissing(p, "formEnctype", function () {
-        var v = this.getAttribute("formenctype");
-        return v == null ? "" : normEnctype(v);
-      });
-      defineIfMissing(p, "formMethod", function () {
-        var v = this.getAttribute("formmethod");
-        return v == null ? "" : normMethod(v);
-      });
-      defineIfMissing(p, "formAction", function () {
-        var a = this.getAttribute("formaction");
-        if (a == null || a === "") return "";
-        try { return new URL(a, (this.ownerDocument && this.ownerDocument.URL) || undefined).href; }
-        catch (_) { return a; }
-      });
-      defineIfMissing(p, "formTarget", function () { return this.getAttribute("formtarget") || ""; });
-      defineIfMissing(p, "formNoValidate", function () { return this.hasAttribute("formnovalidate"); });
-    }
-    patchSubmitter(typeof HTMLButtonElement !== "undefined" ? HTMLButtonElement : null);
-    patchSubmitter(typeof HTMLInputElement  !== "undefined" ? HTMLInputElement  : null);
-  })();
-
-  // ── Bug #4 — HTMLDialogElement.{showModal, show, close} non implémentés ──
-  // https://html.spec.whatwg.org/multipage/interactive-elements.html#the-dialog-element
-  if (typeof HTMLDialogElement !== "undefined") {
-    var dproto = HTMLDialogElement.prototype;
-    if (typeof dproto.showModal !== "function") {
-      dproto.showModal = function () {
-        if (this.hasAttribute("open")) {
-          throw new (window.DOMException || Error)(
-            "The element already has an 'open' attribute, and therefore cannot be opened modally.",
-            "InvalidStateError"
-          );
-        }
-        this.setAttribute("open", "");
-      };
-    }
-    if (typeof dproto.show !== "function") {
-      dproto.show = function () {
-        if (!this.hasAttribute("open")) this.setAttribute("open", "");
-      };
-    }
-    if (typeof dproto.close !== "function") {
-      dproto.close = function (returnValue) {
-        if (!this.hasAttribute("open")) return;
-        this.removeAttribute("open");
-        if (returnValue !== undefined) this.returnValue = String(returnValue);
-        this.dispatchEvent(new Event("close"));
-      };
-    }
-  }
-
-  // ── Bug #8 (added 2026-05-05) — sync remove + re-add lost across dispatch phases ──
-  // WHATWG DOM specifies that each phase of a dispatch snapshots `currentTarget`'s
-  // listener list AT THAT PHASE. Listeners removed and re-added during the capture
-  // phase correctly appear in the bubble-phase snapshot in Chrome/Cuprite. Lightpanda
-  // takes the snapshot once at dispatch start, so a remove+add during capture loses
-  // the listener for the in-flight bubble. This breaks Turbo's `FormSubmitObserver`
-  // pattern, where `submitCaptured` does `remove+add` on its own `submitBubbled` to
-  // ensure that handler runs LAST in bubble — under Lightpanda, `submitBubbled` is
-  // dropped entirely and Turbo never intercepts form submissions.
-  //
-  // Native form submission via `requestSubmit()` doesn't route through JS-exposed
-  // `dispatchEvent`, so we can't detect "in-flight dispatch" by patching that. The
-  // workaround instead targets the remove+add idiom directly: defer every
-  // `removeEventListener` to a microtask. When `addEventListener` runs in the same
-  // synchronous turn with the SAME (target, type, fn, capture), we cancel the
-  // pending remove — the listener was never actually unregistered, so the in-flight
-  // bubble snapshot still contains it. Genuine removes (no matching add follows)
-  // happen at end-of-tick, indistinguishable from the unpatched behavior modulo
-  // tick boundary.
-  //
-  // Scope: only capture-phase `submit` listeners, the exact tuple Turbo Drive
-  // uses. This avoids changing observable DOM semantics for arbitrary
-  // remove/dispatch sequences elsewhere on the page — synchronous remove +
-  // dispatch outside this narrow tuple still fires the native `removeEventListener`
-  // path immediately.
-  //
-  // Trade-offs (within the narrowed scope):
-  //   • Code that removes a capture-phase submit listener and then reads
-  //     listener state synchronously before the microtask flush will see it
-  //     as still-attached. No known framework does this on `submit`.
-  //   • If something removes capture-phase submit listener X then adds Y of
-  //     the same type/capture before the flush, the add happens immediately
-  //     but the deferred remove fires after, removing X *after* Y is
-  //     registered. Y persists, X is gone. Same end state as without the
-  //     polyfill, just reordered in time.
-  (function patchListenerLifecycle() {
-    if (!window.EventTarget || !EventTarget.prototype.addEventListener) return;
-    if (typeof Promise === "undefined") return; // need microtasks
-    var origAdd    = EventTarget.prototype.addEventListener;
-    var origRemove = EventTarget.prototype.removeEventListener;
-
-    function captureFlag(opts) {
-      return opts === true || (opts && typeof opts === "object" && opts.capture === true);
-    }
-
-    function inScope(type, capture) {
-      return type === "submit" && capture === true;
-    }
-
-    var pending = [];      // [{ target, type, fn, capture, cancelled }]
-    var flushScheduled = false;
-
-    function scheduleFlush() {
-      if (flushScheduled) return;
-      flushScheduled = true;
-      Promise.resolve().then(function () {
-        flushScheduled = false;
-        var queue = pending;
-        pending = [];
-        for (var i = 0; i < queue.length; i++) {
-          var r = queue[i];
-          if (r.cancelled) continue;
-          try {
-            origRemove.call(r.target, r.type, r.fn, r.capture);
-          } catch (_) {}
-        }
-      });
-    }
-
-    EventTarget.prototype.removeEventListener = function (type, fn, opts) {
-      var capture = captureFlag(opts);
-      if (!fn || !inScope(type, capture)) return origRemove.call(this, type, fn, opts);
-      pending.push({
-        target:    this,
-        type:      type,
-        fn:        fn,
-        capture:   capture,
-        cancelled: false,
-      });
-      scheduleFlush();
-    };
-
-    EventTarget.prototype.addEventListener = function (type, fn, opts) {
-      if (!fn) return origAdd.call(this, type, fn, opts);
-      var capture = captureFlag(opts);
-      if (inScope(type, capture)) {
-        // Cancel a pending remove for the same tuple (LIFO so the most recent
-        // pending remove wins for the remove-then-add idiom). Always call
-        // native add too: addEventListener is idempotent per DOM spec, and
-        // skipping risks losing the listener on a later unmatched remove.
-        for (var i = pending.length - 1; i >= 0; i--) {
-          var r = pending[i];
-          if (r.cancelled) continue;
-          if (r.target === this && r.type === type && r.fn === fn && r.capture === capture) {
-            r.cancelled = true;
-            break;
-          }
-        }
-      }
-      return origAdd.call(this, type, fn, opts);
-    };
-  })();
-})();

data/lib/capybara/lightpanda/xpath_polyfill.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Capybara
-  module Lightpanda
-    module XPathPolyfill
-      JS_PATH = File.expand_path("javascripts/index.js", __dir__).freeze
-      JS = File.read(JS_PATH).freeze
-
-      # Polyfills pour les APIs DOM manquantes du binaire Lightpanda.
-      # Voir UPSTREAM_BUGS.md à la racine du gem.
-      POLYFILLS_PATH = File.expand_path("javascripts/polyfills.js", __dir__).freeze
-      POLYFILLS_JS = File.read(POLYFILLS_PATH).freeze
-    end
-  end
-end