RubyGems - dommy - Versions diffs - 0.6.0 → 0.7.0 - Mend

dommy 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (53) hide show

checksums.yaml +4 -4
data/README.md +30 -38
data/lib/dommy/animation.rb +1 -1
data/lib/dommy/attr.rb +23 -11
data/lib/dommy/backend/nokogiri_adapter.rb +51 -0
data/lib/dommy/backend/nokolexbor_adapter.rb +80 -0
data/lib/dommy/backend.rb +129 -0
data/lib/dommy/blob.rb +2 -2
data/lib/dommy/compression_streams.rb +4 -4
data/lib/dommy/cookie_store.rb +1 -1
data/lib/dommy/crypto.rb +9 -8
data/lib/dommy/css.rb +7 -7
data/lib/dommy/custom_elements.rb +6 -6
data/lib/dommy/document.rb +98 -32
data/lib/dommy/dom_parser.rb +5 -4
data/lib/dommy/element.rb +231 -50
data/lib/dommy/event.rb +61 -25
data/lib/dommy/event_source.rb +8 -8
data/lib/dommy/fetch.rb +14 -6
data/lib/dommy/file_reader.rb +3 -3
data/lib/dommy/form_data.rb +1 -3
data/lib/dommy/history.rb +7 -4
data/lib/dommy/html_collection.rb +4 -4
data/lib/dommy/html_elements.rb +110 -42
data/lib/dommy/internal/css_pseudo_handlers.rb +28 -0
data/lib/dommy/internal/dom_matching.rb +3 -3
data/lib/dommy/internal/node_traversal.rb +1 -1
data/lib/dommy/internal/node_wrapper_cache.rb +23 -12
data/lib/dommy/internal/template_content_registry.rb +6 -6
data/lib/dommy/intersection_observer.rb +2 -2
data/lib/dommy/location.rb +8 -4
data/lib/dommy/media_query_list.rb +3 -3
data/lib/dommy/message_channel.rb +9 -9
data/lib/dommy/mutation_observer.rb +21 -11
data/lib/dommy/navigator.rb +12 -12
data/lib/dommy/node.rb +12 -0
data/lib/dommy/notification.rb +3 -3
data/lib/dommy/parser.rb +13 -13
data/lib/dommy/performance_observer.rb +2 -2
data/lib/dommy/range.rb +2 -2
data/lib/dommy/resize_observer.rb +2 -2
data/lib/dommy/shadow_root.rb +10 -8
data/lib/dommy/streams.rb +22 -22
data/lib/dommy/text_codec.rb +4 -4
data/lib/dommy/tree_walker.rb +21 -21
data/lib/dommy/url.rb +25 -8
data/lib/dommy/version.rb +1 -1
data/lib/dommy/web_socket.rb +13 -13
data/lib/dommy/window.rb +14 -1
data/lib/dommy/worker.rb +5 -5
data/lib/dommy/xml_http_request.rb +19 -4
data/lib/dommy.rb +12 -2
metadata +12 -26

data/lib/dommy/custom_elements.rb CHANGED Viewed

@@ -64,16 +64,16 @@ module Dommy
     # registered; fires `connectedCallback` for each upgraded node
     # that's currently attached to a document tree.
     def upgrade(root)
-      return nil unless root.respond_to?(:__node__)
+      return nil unless root.respond_to?(:__dommy_backend_node__)
-      walk_descendants(root.__node__) do |nk|
+      walk_descendants(root.__dommy_backend_node__) do |nk|
         next unless nk.element?
         next unless @definitions.key?(nk.name)
         # Force re-wrap by clearing the document's cached wrapper.
-        @window.document.__reset_wrapper__(nk)
+        @window.document.__internal_reset_wrapper__(nk)
         wrapped = @window.document.wrap_node(nk)
-        @window.document.__notify_connected__(wrapped) if wrapped
+        @window.document.__internal_notify_connected__(wrapped) if wrapped
       end
       nil
@@ -109,9 +109,9 @@ module Dommy
     def upgrade_existing(name)
       doc = @window.document
       doc.nokogiri_doc.css(name).each do |nk|
-        doc.__reset_wrapper__(nk)
+        doc.__internal_reset_wrapper__(nk)
         wrapped = doc.wrap_node(nk)
-        doc.__notify_connected__(wrapped) if wrapped
+        doc.__internal_notify_connected__(wrapped) if wrapped
       end
     end

data/lib/dommy/document.rb CHANGED Viewed

@@ -46,6 +46,9 @@ module Dommy
     attr_reader :body, :nokogiri_doc
     attr_accessor :default_view
+    # content_type defaults to "text/html"; settable so an integration layer
+    # can reflect the response Content-Type. Read-only over the JS bridge.
+    attr_accessor :content_type
     def initialize(host = nil, nokogiri_doc: nil, default_view: nil)
       @host = host
@@ -56,9 +59,10 @@ module Dommy
       @cookie_jar = Internal::CookieJar.new
       @template_content_registry = Internal::TemplateContentRegistry.new(self)
       @mutation_coordinator = Internal::MutationCoordinator.new(self, @observer_manager)
-      @nokogiri_doc = nokogiri_doc || Nokogiri::HTML5("<!doctype html><html><head></head><body></body></html>")
+      @nokogiri_doc = nokogiri_doc || Backend.parse("<!doctype html><html><head></head><body></body></html>")
       body_node = @nokogiri_doc.at_css("body")
       @body = wrap_node(body_node) if body_node
+      @content_type = "text/html"
     end
     # ----- Public Ruby API (snake_case) -----
@@ -79,6 +83,21 @@ module Dommy
       wrap_node(@nokogiri_doc.at_css("head"))
     end
+    # Serialize the whole document to HTML (including the doctype).
+    def to_html
+      @nokogiri_doc.to_html
+    end
+    # XPath queries returning wrapped nodes (Element / TextNode / etc).
+    def at_xpath(expression)
+      node = @nokogiri_doc.at_xpath(expression)
+      node && wrap_node(node)
+    end
+    def xpath(expression)
+      @nokogiri_doc.xpath(expression).map { |node| wrap_node(node) }
+    end
     # `document.URL` / `documentURI` — both return location.href in
     # real browsers (legacy aliases of the same field).
     def url
@@ -116,6 +135,15 @@ module Dommy
       view.location.__js_get__("hostname").to_s
     end
+    # `document.origin` — serialized origin of the document URL, mirroring
+    # `window.location.origin`. Empty when there is no associated window.
+    def origin
+      view = @default_view
+      return "" unless view&.location
+      view.location.__js_get__("origin").to_s
+    end
     # `document.referrer` — Dommy never has a referring page, so this
     # is always empty.
     def referrer
@@ -175,7 +203,7 @@ module Dommy
       @active_element || @body
     end
-    def __set_active_element__(el)
+    def __internal_set_active_element__(el)
       @active_element = el
     end
@@ -202,9 +230,9 @@ module Dommy
     # wrapper is owned by `this`. Per spec, the source node is left
     # in place. `deep: true` copies the entire subtree.
     def import_node(node, deep = false)
-      return nil unless node.respond_to?(:__node__)
+      return nil unless node.respond_to?(:__dommy_backend_node__)
-      copy = clone_into_doc(node.__node__, deep)
+      copy = clone_into_doc(node.__dommy_backend_node__, deep)
       wrap_node(copy)
     end
@@ -212,17 +240,32 @@ module Dommy
     # node is detached from its previous owner and its ownerDocument
     # becomes this. Returns the (possibly re-wrapped) node.
     def adopt_node(node)
-      return nil unless node.respond_to?(:__node__)
+      return nil unless node.respond_to?(:__dommy_backend_node__)
-      src = node.__node__
+      src = node.__dommy_backend_node__
       src.unlink if src.parent
-      moved = if src.document == @nokogiri_doc
-        src
-      else
-        clone_into_doc(src, true)
-      end
-      wrap_node(moved)
+      # Same document: just return the wrapper after the detach above.
+      return wrap_node(src) if src.document == @nokogiri_doc
+      # Cross-document: Nokogiri reassigns `src.document` when src is
+      # added under a node owned by another document. We transiently
+      # attach to our root, then unlink so src ends up free-floating
+      # but now belongs to @nokogiri_doc. The underlying Ruby object
+      # identity is preserved.
+      src_doc_wrapper = node.instance_variable_get(:@document)
+      @nokogiri_doc.root.add_child(src)
+      src.unlink
+      # Move the caller's Dommy wrapper from the source document's
+      # wrapper cache into ours, and re-point its @document. This
+      # keeps `adopt_node(x).equal?(x)` true across documents.
+      node.instance_variable_set(:@document, self)
+      if src_doc_wrapper.respond_to?(:__internal_reset_wrapper__)
+        src_doc_wrapper.__internal_reset_wrapper__(src)
+      end
+      @node_wrapper_cache.register(src, node)
+      node
     end
     # Legacy `document.createEvent("EventName")` factory. Returns an
@@ -268,7 +311,7 @@ module Dommy
     # is the read side.
     attr_reader :fullscreen_element
-    def __set_fullscreen_element__(element)
+    def __internal_set_fullscreen_element__(element)
       previous = @fullscreen_element
       @fullscreen_element = element
       return if previous == element
@@ -339,8 +382,8 @@ module Dommy
       fragment = Parser.fragment(html, owner_doc: @nokogiri_doc)
       removed = []
       added = fragment.children.to_a
-      added.each { |node| @body.__node__.add_child(node) }
-      notify_child_list_mutation(target_node: @body.__node__, added_nodes: added, removed_nodes: removed)
+      added.each { |node| @body.__dommy_backend_node__.add_child(node) }
+      notify_child_list_mutation(target_node: @body.__dommy_backend_node__, added_nodes: added, removed_nodes: removed)
       nil
     end
@@ -408,6 +451,10 @@ module Dommy
         base_uri
       when "domain"
         domain
+      when "origin"
+        origin
+      when "contentType"
+        content_type
       when "referrer"
         referrer
       when "links"
@@ -444,6 +491,19 @@ module Dommy
       nil
     end
+    # Methods routed through __js_call__ (keep in sync with its when-arms).
+    JS_METHOD_NAMES = %w[
+      exitFullscreen startViewTransition createElement createElementNS createTextNode
+      createComment createDocumentFragment querySelector querySelectorAll getElementById
+      getElementsByClassName getElementsByTagName getElementsByName createAttribute
+      createAttributeNS createTreeWalker createNodeIterator createEvent importNode adoptNode
+      hasFocus getSelection elementFromPoint queryCommandSupported addEventListener
+      removeEventListener dispatchEvent write open close
+    ].freeze
+    def __js_method_names__
+      JS_METHOD_NAMES
+    end
     def __js_call__(method, args)
       case method
       when "exitFullscreen"
@@ -521,7 +581,7 @@ module Dommy
       end
     end
-    def __event_parent__
+    def __internal_event_parent__
       @default_view
     end
@@ -533,7 +593,7 @@ module Dommy
     # Clear the cached wrapper so the next `wrap_node` creates a new
     # one. Used by `customElements.define` to upgrade nodes that were
     # constructed before the registration landed.
-    def __reset_wrapper__(nokogiri_node)
+    def __internal_reset_wrapper__(nokogiri_node)
       @node_wrapper_cache.reset_wrapper(nokogiri_node)
     end
@@ -543,15 +603,15 @@ module Dommy
     # node back to its shadow boundary.
     # Delegate to ShadowRootRegistry
-    def __register_shadow_fragment__(fragment_node, shadow_root)
+    def __internal_register_shadow_fragment__(fragment_node, shadow_root)
       @shadow_registry.register(fragment_node, shadow_root)
     end
-    def __shadow_root_for_fragment__(fragment_node)
+    def __internal_shadow_root_for_fragment__(fragment_node)
       @shadow_registry.find_for_fragment(fragment_node)
     end
-    def __shadow_root_containing__(node)
+    def __internal_shadow_root_containing__(node)
       @shadow_registry.find_enclosing(node)
     end
@@ -560,23 +620,23 @@ module Dommy
     # break the whole mutation pipeline.
     # Delegate to MutationCoordinator
-    def __notify_connected__(element)
+    def __internal_notify_connected__(element)
       @mutation_coordinator.notify_connected(element)
     end
-    def __notify_disconnected__(element)
+    def __internal_notify_disconnected__(element)
       @mutation_coordinator.notify_disconnected(element)
     end
-    def __notify_connected_subtree__(nk)
+    def __internal_notify_connected_subtree__(nk)
       @mutation_coordinator.notify_connected_subtree(nk)
     end
-    def __notify_disconnected_subtree__(nk)
+    def __internal_notify_disconnected_subtree__(nk)
       @mutation_coordinator.notify_disconnected_subtree(nk)
     end
-    def __notify_attribute_changed__(element, name, old_value, new_value)
+    def __internal_notify_attribute_changed__(element, name, old_value, new_value)
       @mutation_coordinator.notify_attribute_changed(element, name, old_value, new_value)
     end
@@ -675,17 +735,17 @@ module Dommy
     # adoptNode for cross-document transfer.
     def clone_into_doc(source, deep)
       copy = if source.element?
-        new_el = Nokogiri::XML::Node.new(source.name, @nokogiri_doc)
+        new_el = Backend.create_element(source.name, @nokogiri_doc)
         source.attribute_nodes.each { |a| new_el[a.name] = a.value }
         new_el
       elsif source.text?
-        Nokogiri::XML::Text.new(source.content, @nokogiri_doc)
-      elsif source.is_a?(Nokogiri::XML::Comment)
-        Nokogiri::XML::Comment.new(@nokogiri_doc, source.content)
+        Backend.create_text(source.content, @nokogiri_doc)
+      elsif source.is_a?(Backend.comment_class)
+        Backend.create_comment(source.content, @nokogiri_doc)
       else
         # Fallback: serialize + reparse via fragment for unusual types.
         fragment = Parser.fragment(source.to_html, owner_doc: @nokogiri_doc)
-        fragment.children.first || Nokogiri::XML::Text.new("", @nokogiri_doc)
+        fragment.children.first || Backend.create_text("", @nokogiri_doc)
       end
       if deep && source.respond_to?(:children)
@@ -709,12 +769,12 @@ module Dommy
       title = head.at_css("title")
       unless title
-        title = Nokogiri::XML::Node.new("title", @nokogiri_doc)
+        title = Backend.create_element("title", @nokogiri_doc)
         head.add_child(title)
       end
       title.children.each(&:unlink)
-      title.add_child(Nokogiri::XML::Text.new(value, @nokogiri_doc))
+      title.add_child(Backend.create_text(value, @nokogiri_doc))
     end
   end
@@ -756,6 +816,12 @@ module Dommy
       end
     end
+    # Methods routed through __js_call__ (keep in sync with its when-arms).
+    JS_METHOD_NAMES = %w[skipTransition].freeze
+    def __js_method_names__
+      JS_METHOD_NAMES
+    end
     def __js_call__(method, _args)
       case method
       when "skipTransition"

data/lib/dommy/dom_parser.rb CHANGED Viewed

@@ -44,12 +44,13 @@ module Dommy
     private
     def parse_html(str)
-      nokogiri_doc = Nokogiri::HTML5(str.empty? ? "<html><body></body></html>" : str, max_errors: 0)
+      nokogiri_doc = Backend.parse(str.empty? ? "<html><body></body></html>" : str)
       Document.new(nil, nokogiri_doc: nokogiri_doc)
     end
     def parse_xml(str)
-      nokogiri_doc = Nokogiri::XML(str)
+      # Backends are HTML-only; parse XML input as HTML for now.
+      nokogiri_doc = Backend.parse(str.empty? ? "<html><body></body></html>" : str)
       Document.new(nil, nokogiri_doc: nokogiri_doc)
     end
   end
@@ -63,8 +64,8 @@ module Dommy
       if node.respond_to?(:outer_html)
         node.outer_html
-      elsif node.respond_to?(:__node__)
-        node.__node__.to_xml
+      elsif node.respond_to?(:__dommy_backend_node__)
+        node.__dommy_backend_node__.to_xml
       elsif node.respond_to?(:to_xml)
         node.to_xml
       else