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

dommy 0.5.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 (65) hide show

checksums.yaml +4 -4
data/README.md +31 -13
data/lib/dommy/animation.rb +288 -0
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 +147 -0
data/lib/dommy/cookie_store.rb +128 -0
data/lib/dommy/crypto.rb +396 -0
data/lib/dommy/css.rb +7 -7
data/lib/dommy/custom_elements.rb +6 -6
data/lib/dommy/document.rb +190 -32
data/lib/dommy/dom_parser.rb +5 -4
data/lib/dommy/element.rb +356 -53
data/lib/dommy/event.rb +431 -25
data/lib/dommy/event_source.rb +131 -0
data/lib/dommy/fetch.rb +76 -6
data/lib/dommy/file_reader.rb +176 -0
data/lib/dommy/form_data.rb +1 -3
data/lib/dommy/history.rb +82 -0
data/lib/dommy/html_collection.rb +4 -4
data/lib/dommy/html_elements.rb +130 -67
data/lib/dommy/internal/cookie_jar.rb +2 -0
data/lib/dommy/internal/css_pseudo_handlers.rb +28 -0
data/lib/dommy/internal/dom_matching.rb +4 -4
data/lib/dommy/internal/idna.rb +443 -0
data/lib/dommy/internal/idna_data.rb +10379 -0
data/lib/dommy/internal/ipv4_parser.rb +78 -0
data/lib/dommy/internal/node_traversal.rb +1 -1
data/lib/dommy/internal/node_wrapper_cache.rb +23 -12
data/lib/dommy/internal/observable_callback.rb +25 -0
data/lib/dommy/internal/punycode.rb +202 -0
data/lib/dommy/internal/range_text_serializer.rb +72 -0
data/lib/dommy/internal/reflected_attributes.rb +45 -0
data/lib/dommy/internal/template_content_registry.rb +6 -6
data/lib/dommy/intersection_observer.rb +82 -0
data/lib/dommy/{router.rb → location.rb} +8 -142
data/lib/dommy/media_query_list.rb +118 -0
data/lib/dommy/message_channel.rb +249 -0
data/lib/dommy/{observer.rb → mutation_observer.rb} +21 -11
data/lib/dommy/navigator.rb +365 -5
data/lib/dommy/node.rb +12 -0
data/lib/dommy/notification.rb +89 -0
data/lib/dommy/parser.rb +13 -13
data/lib/dommy/performance.rb +146 -0
data/lib/dommy/performance_observer.rb +55 -0
data/lib/dommy/range.rb +597 -0
data/lib/dommy/resize_observer.rb +53 -0
data/lib/dommy/shadow_root.rb +10 -8
data/lib/dommy/streams.rb +386 -0
data/lib/dommy/svg_elements.rb +3863 -0
data/lib/dommy/text_codec.rb +175 -0
data/lib/dommy/tree_walker.rb +21 -21
data/lib/dommy/url.rb +274 -29
data/lib/dommy/url_pattern.rb +144 -0
data/lib/dommy/version.rb +1 -1
data/lib/dommy/web_socket.rb +209 -0
data/lib/dommy/window.rb +369 -0
data/lib/dommy/worker.rb +143 -0
data/lib/dommy/xml_http_request.rb +438 -0
data/lib/dommy.rb +43 -5
metadata +44 -29
data/lib/dommy/world.rb +0 -209

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
@@ -256,9 +299,36 @@ module Dommy
     alias has_focus has_focus?
     def get_selection
-      nil
+      @__selection ||= Selection.new(self)
+    end
+    def create_range
+      Range.new(self)
     end
+    # Fullscreen API — no actual fullscreen mode, just track which
+    # element claimed it. `element.requestFullscreen()` sets it; this
+    # is the read side.
+    attr_reader :fullscreen_element
+    def __internal_set_fullscreen_element__(element)
+      previous = @fullscreen_element
+      @fullscreen_element = element
+      return if previous == element
+      dispatch_event(Event.new("fullscreenchange"))
+    end
+    def exit_fullscreen
+      return PromiseValue.resolve(@default_view, nil) if @fullscreen_element.nil?
+      @fullscreen_element = nil
+      dispatch_event(Event.new("fullscreenchange"))
+      PromiseValue.resolve(@default_view, nil)
+    end
+    alias exitFullscreen exit_fullscreen
     def element_from_point(_x, _y)
       nil
     end
@@ -312,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
@@ -359,6 +429,12 @@ module Dommy
         doctype
       when "defaultView"
         @default_view
+      when "fullscreenElement"
+        @fullscreen_element
+      when "fullscreenEnabled"
+        true
+      when "scrollingElement"
+        wrap_node(@nokogiri_doc.at_css("html"))
       when "documentElement"
         wrap_node(@nokogiri_doc.at_css("html"))
       when "title"
@@ -375,6 +451,10 @@ module Dommy
         base_uri
       when "domain"
         domain
+      when "origin"
+        origin
+      when "contentType"
+        content_type
       when "referrer"
         referrer
       when "links"
@@ -411,8 +491,35 @@ 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"
+        exit_fullscreen
+      when "startViewTransition"
+        # View Transitions API stub. Spec: invoke the callback
+        # synchronously; return a ViewTransition with already-resolved
+        # `finished` / `ready` / `updateCallbackDone` promises.
+        callback = args[0]
+        if callback.respond_to?(:__js_call__)
+          callback.__js_call__("call", [])
+        elsif callback.respond_to?(:call)
+          callback.call
+        end
+        ViewTransition.new(@default_view)
       when "createElement"
         create_element(args[0])
       when "createElementNS"
@@ -474,7 +581,7 @@ module Dommy
       end
     end
-    def __event_parent__
+    def __internal_event_parent__
       @default_view
     end
@@ -486,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
@@ -496,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
@@ -513,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
@@ -628,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)
@@ -662,13 +769,64 @@ 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
+  # `ViewTransition` — return value of `document.startViewTransition()`.
+  # All three Promises (`finished` / `ready` / `updateCallbackDone`)
+  # resolve immediately since dommy has no actual paint phase.
+  #
+  # Spec: https://drafts.csswg.org/css-view-transitions/
+  class ViewTransition
+    def initialize(window)
+      @finished = PromiseValue.resolve(window, nil)
+      @ready = PromiseValue.resolve(window, nil)
+      @update_callback_done = PromiseValue.resolve(window, nil)
+    end
+    attr_reader :finished, :ready
+    def update_callback_done
+      @update_callback_done
+    end
+    alias updateCallbackDone update_callback_done
+    def skip_transition
+      nil
     end
+    alias skipTransition skip_transition
+    def __js_get__(key)
+      case key
+      when "finished"
+        @finished
+      when "ready"
+        @ready
+      when "updateCallbackDone"
+        @update_callback_done
+      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"
+        skip_transition
+      end
+    end
   end
 end

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