canon 0.2.11 → 0.3.0

data/lib/canon/diff_formatter/diff_detail_formatter/dimension_formatter.rb

@@ -53,9 +53,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to use colors
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_namespace_uri_details(diff, use_color)
-          require_relative "color_helper"
-          require_relative "node_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -87,10 +84,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to use colors
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_namespace_declarations_details(diff, use_color)
-          require_relative "color_helper"
-          require_relative "node_utils"
-          require_relative "text_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -174,9 +167,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to use colors
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_element_structure_details(diff, use_color)
-          require_relative "color_helper"
-          require_relative "node_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -236,9 +226,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to use colors
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_attribute_presence_details(diff, use_color)
-          require_relative "color_helper"
-          require_relative "node_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -291,9 +278,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to use colors
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_attribute_values_details(diff, use_color)
-          require_relative "color_helper"
-          require_relative "node_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -330,9 +314,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to use colors
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_attribute_order_details(diff, use_color)
-          require_relative "color_helper"
-          require_relative "node_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -361,10 +342,6 @@ expand_difference: false)
         # @param compact [Boolean] Whether to serialize element nodes as compact XML
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_text_content_details(diff, use_color, compact: false)
-          require_relative "color_helper"
-          require_relative "node_utils"
-          require_relative "text_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -465,10 +442,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to apply ANSI colours
         # @return [Array<String>] Tuple of [detail1, detail2, changes]
         def self.format_text_content_one_sided(node1, node2, use_color)
-          require_relative "color_helper"
-          require_relative "node_utils"
-          require_relative "text_utils"
-
           present = node1 || node2
 
           # Defensive: if a one-sided text-content diff carries an
@@ -515,10 +488,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to use colors
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_whitespace_adjacency_details(diff, use_color)
-          require_relative "color_helper"
-          require_relative "node_utils"
-          require_relative "text_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -568,10 +537,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to use colors
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_structural_whitespace_details(diff, use_color)
-          require_relative "color_helper"
-          require_relative "node_utils"
-          require_relative "text_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -594,9 +559,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to use colors
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_comments_details(diff, use_color)
-          require_relative "color_helper"
-          require_relative "node_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -619,8 +581,6 @@ expand_difference: false)
         # @param use_color [Boolean] Whether to use colors
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_hash_diff_details(diff, use_color)
-          require_relative "color_helper"
-
           detail1 = if diff.is_a?(Hash) && diff[:value1]
                       ColorHelper.colorize(format_json_value(diff[:value1]),
                                            :red, use_color)
@@ -653,9 +613,6 @@ expand_difference: false)
         # @param compact [Boolean] Whether to serialize element nodes as compact XML
         # @return [Array] Tuple of [detail1, detail2, changes]
         def self.format_fallback_details(diff, use_color, compact: false)
-          require_relative "color_helper"
-          require_relative "node_utils"
-
           node1 = extract_node1(diff)
           node2 = extract_node2(diff)
 
@@ -749,8 +706,7 @@ expand_difference: false)
 
           declarations = {}
 
-          # Handle Canon::Xml::Node (uses namespace_nodes)
-          if node.respond_to?(:namespace_nodes)
+          if node.is_a?(Canon::Xml::Node)
             node.namespace_nodes.each do |ns|
               next if ns.prefix == "xml" && ns.uri == "http://www.w3.org/XML/1998/namespace"
 
@@ -760,30 +716,28 @@ expand_difference: false)
             return declarations
           end
 
-          # Handle Nokogiri/Moxml nodes (use attributes)
-          raw_attrs = node.respond_to?(:attribute_nodes) ? node.attribute_nodes : node.attributes
+          # Handle Nokogiri/Moxml nodes (use attribute_nodes or attributes).
+          raw_attrs = if node.is_a?(Nokogiri::XML::Node)
+                        node.attribute_nodes
+                      else
+                        node.attributes
+                      end
 
           if raw_attrs.is_a?(Array)
             raw_attrs.each do |attr|
-              name = attr.respond_to?(:name) ? attr.name : attr.to_s
-              value = attr.respond_to?(:value) ? attr.value : attr.to_s
+              name = attr.is_a?(Nokogiri::XML::Attr) ? attr.name : attr.to_s
+              value = attr.is_a?(Nokogiri::XML::Attr) ? attr.value : attr.to_s
 
               if namespace_declaration?(name)
                 prefix = name == "xmlns" ? "" : name.split(":", 2)[1]
                 declarations[prefix] = value
               end
             end
-          elsif raw_attrs.respond_to?(:each)
+          elsif raw_attrs.is_a?(Hash)
             raw_attrs.each do |key, val|
-              name = if key.is_a?(String)
-                       key
-                     else
-                       (key.respond_to?(:name) ? key.name : key.to_s)
-                     end
-              value = if val.respond_to?(:value)
+              name = hash_key_to_name(key)
+              value = if val.is_a?(Nokogiri::XML::Attr)
                         val.value
-                      elsif val.respond_to?(:content)
-                        val.content
                       else
                         val.to_s
                       end
@@ -805,6 +759,18 @@ expand_difference: false)
         def self.namespace_declaration?(name)
           name == "xmlns" || name.to_s.start_with?("xmlns:")
         end
+
+        # Coerce a hash key (from a backend-supplied attribute hash) into a
+        # plain String attribute name.
+        #
+        # @param key [String, Nokogiri::XML::Attr, Object]
+        # @return [String]
+        def self.hash_key_to_name(key)
+          return key if key.is_a?(String)
+          return key.name if key.is_a?(Nokogiri::XML::Attr)
+
+          key.to_s
+        end
       end
     end
   end

data/lib/canon/diff_formatter/diff_detail_formatter/location_extractor.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../../xml/namespace_helper"
-
 module Canon
   class DiffFormatter
     module DiffDetailFormatterHelpers

data/lib/canon/diff_formatter/diff_detail_formatter/node_utils.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "cgi"
-require_relative "../../xml/namespace_helper"
 
 module Canon
   class DiffFormatter
@@ -94,7 +93,7 @@ module Canon
         def self.get_namespace_uri_for_display(node)
           return "" unless node
 
-          Canon::Comparison::Canon::Comparison::NodeInspector.namespace_uri(node).to_s
+          Canon::Comparison::NodeInspector.namespace_uri(node).to_s
         end
 
         # --- Display helpers ---
@@ -227,7 +226,7 @@ module Canon
           end
 
           def serialize_backend_node_compact(node)
-            if XmlBackend.nokogiri? && node.is_a?(Nokogiri::XML::Node)
+            if defined?(Nokogiri) && node.is_a?(Nokogiri::XML::Node)
               serialize_nokogiri_node_compact(node)
             elsif node.is_a?(Canon::Xml::Node)
               serialize_node_compact(node)
@@ -257,7 +256,7 @@ module Canon
           end
 
           def serialize_backend_open_tag(node)
-            if XmlBackend.nokogiri? && node.is_a?(Nokogiri::XML::Element)
+            if defined?(Nokogiri) && node.is_a?(Nokogiri::XML::Element)
               tag = node.name.to_s
               attrs = node.attribute_nodes.map do |a|
                 " #{a.name}=\"#{CGI.escapeHTML(a.value.to_s)}\""

data/lib/canon/diff_formatter/diff_detail_formatter/text_utils.rb

@@ -45,13 +45,7 @@ module Canon
         def self.extract_content_preview(node, max_length = 50)
           return "" unless node
 
-          text = if node.respond_to?(:text)
-                   node.text
-                 elsif node.respond_to?(:content)
-                   node.content
-                 else
-                   node.to_s
-                 end
+          text = Canon::Comparison::NodeInspector.text_content(node).to_s
 
           return "" if text.nil? || text.empty?
 

data/lib/canon/diff_formatter/diff_detail_formatter.rb

@@ -1,13 +1,6 @@
 # frozen_string_literal: true
 
 require "rainbow" unless RUBY_ENGINE == "opal"
-require_relative "../xml/namespace_helper"
-# DiffDetailFormatter helper modules
-require_relative "diff_detail_formatter/text_utils"
-require_relative "diff_detail_formatter/color_helper"
-require_relative "diff_detail_formatter/location_extractor"
-require_relative "diff_detail_formatter/node_utils"
-require_relative "diff_detail_formatter/dimension_formatter"
 
 module Canon
   class DiffFormatter

data/lib/canon/diff_formatter/diff_detail_formatter_helpers.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Canon
+  class DiffFormatter
+    # Helper modules consumed by {DiffDetailFormatter} to format per-dimension
+    # difference details. Files live under `diff_detail_formatter/` but the
+    # constants live under this namespace.
+    #
+    # Children are autoloaded — never `require_relative` them.
+    module DiffDetailFormatterHelpers
+      autoload :ColorHelper,
+               "canon/diff_formatter/diff_detail_formatter/color_helper"
+      autoload :DimensionFormatter,
+               "canon/diff_formatter/diff_detail_formatter/dimension_formatter"
+      autoload :LocationExtractor,
+               "canon/diff_formatter/diff_detail_formatter/location_extractor"
+      autoload :NodeUtils,
+               "canon/diff_formatter/diff_detail_formatter/node_utils"
+      autoload :TextUtils,
+               "canon/diff_formatter/diff_detail_formatter/text_utils"
+    end
+  end
+end

data/lib/canon/diff_formatter/theme.rb

@@ -125,11 +125,11 @@ module Canon
           },
           added: {
             marker: { color: :green, bg: nil, bold: false },
-            content: { color: :green,       bg: nil, bold: false,
+            content: { color: :green, bg: nil, bold: false,
                        underline: false, strikethrough: false },
           },
           changed: {
-            marker: { color: :yellow,       bg: nil, bold: true },
+            marker: { color: :yellow, bg: nil, bold: true },
             content_old: { color: :bright_red,   bg: nil, bold: false,
                            underline: false, strikethrough: true },
             content_new: { color: :bright_green, bg: nil, bold: false,

data/lib/canon/diff_formatter.rb

@@ -2,14 +2,6 @@
 
 require "paint" unless RUBY_ENGINE == "opal"
 require "yaml" unless RUBY_ENGINE == "opal"
-require_relative "comparison"
-require_relative "diff/diff_block"
-require_relative "diff/diff_context"
-require_relative "diff/diff_report"
-require_relative "diff_formatter/debug_output"
-require_relative "diff_formatter/by_line_formatter"
-require_relative "diff_formatter/by_object_formatter"
-require_relative "diff_formatter/pretty_diff_formatter"
 
 module Canon
   # Formatter for displaying semantic differences with color support
@@ -65,6 +57,16 @@ module Canon
   #   )
   #
   class DiffFormatter
+    autoload :ByLineFormatter, "canon/diff_formatter/by_line_formatter"
+    autoload :ByObjectFormatter, "canon/diff_formatter/by_object_formatter"
+    autoload :DebugOutput, "canon/diff_formatter/debug_output"
+    autoload :DiffDetailFormatter, "canon/diff_formatter/diff_detail_formatter"
+    autoload :DiffDetailFormatterHelpers,
+             "canon/diff_formatter/diff_detail_formatter_helpers"
+    autoload :Legend, "canon/diff_formatter/legend"
+    autoload :PrettyDiffFormatter, "canon/diff_formatter/pretty_diff_formatter"
+    autoload :Theme, "canon/diff_formatter/theme"
+
     # Namespace for by-object mode formatters
     module ByObject
       autoload :BaseFormatter, "canon/diff_formatter/by_object/base_formatter"
@@ -76,6 +78,7 @@ module Canon
     # Namespace for by-line mode formatters
     module ByLine
       autoload :BaseFormatter, "canon/diff_formatter/by_line/base_formatter"
+      autoload :HtmlFormatter, "canon/diff_formatter/by_line/html_formatter"
       autoload :SimpleFormatter, "canon/diff_formatter/by_line/simple_formatter"
       autoload :XmlFormatter, "canon/diff_formatter/by_line/xml_formatter"
       autoload :JsonFormatter, "canon/diff_formatter/by_line/json_formatter"
@@ -308,11 +311,10 @@ module Canon
       # In by-line mode with both docs present, always use by-line diff
       if @mode == :by_line && doc1 && doc2
         doc1, doc2 = apply_display_preprocessing(doc1, doc2, format)
-        # rubocop:disable Layout/HashAlignment
+        # rubocop:disable-next Layout/HashAlignment
         return by_line_formatter.format(doc1, doc2, format: format,
                                                   html_version: html_version,
                                                   differences: differences)
-        # rubocop:enable Layout/HashAlignment
       end
 
       # In pretty_diff mode, always use text-LCS diff (bypasses DiffNodeMapper).
@@ -340,11 +342,10 @@ module Canon
           doc1, doc2 = apply_display_preprocessing(doc1, doc2,
                                                    format)
         end
-        # rubocop:disable Layout/HashAlignment
+        # rubocop:disable-next Layout/HashAlignment
         by_line_formatter.format(doc1, doc2, format: format,
                                                html_version: html_version,
                                                differences: differences)
-        # rubocop:enable Layout/HashAlignment
       when :pretty_diff
         d1, d2 = if doc1 && doc2
                    apply_display_preprocessing(doc1, doc2,
@@ -420,7 +421,6 @@ module Canon
       # 2. Semantic Diff Report (ALWAYS if diffs exist)
       if comparison_result.is_a?(Canon::Comparison::ComparisonResult) &&
           comparison_result.differences.any?
-        require_relative "diff_formatter/diff_detail_formatter"
         output << DiffDetailFormatter.format_report(
           comparison_result.differences,
           use_color: @use_color,

data/lib/canon/formatters/html4_formatter.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "html_formatter_base"
-
 module Canon
   module Formatters
     # HTML4 formatter using Nokogiri::HTML parser

data/lib/canon/formatters/html5_formatter.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "html_formatter_base"
-
 module Canon
   module Formatters
     # HTML5 formatter using Nokogiri::HTML5 parser

data/lib/canon/formatters/html_formatter.rb

@@ -1,9 +1,6 @@
 # frozen_string_literal: true
 
 require "nokogiri" unless RUBY_ENGINE == "opal"
-require_relative "html_formatter_base"
-require_relative "../pretty_printer/html"
-require_relative "../validators/html_validator"
 
 module Canon
   module Formatters

data/lib/canon/formatters/json_formatter.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "json"
-require_relative "../validators/json_validator"
 
 module Canon
   module Formatters

data/lib/canon/formatters/xml_formatter.rb

@@ -1,10 +1,6 @@
 # frozen_string_literal: true
 
 require "nokogiri" unless RUBY_ENGINE == "opal"
-require_relative "../xml_backend"
-require_relative "../xml/c14n"
-require_relative "../pretty_printer/xml"
-require_relative "../validators/xml_validator"
 
 module Canon
   module Formatters

data/lib/canon/formatters/yaml_formatter.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "yaml"
-require_relative "../validators/yaml_validator"
 
 module Canon
   module Formatters

data/lib/canon/formatters.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Canon
+  # Format-specific canonicalizers and parsers for the top-level
+  # `Canon.format` / `Canon.parse` API. Distinct from {DiffFormatter},
+  # which renders comparison output.
+  module Formatters
+    autoload :Html4Formatter, "canon/formatters/html4_formatter"
+    autoload :Html5Formatter, "canon/formatters/html5_formatter"
+    autoload :HtmlFormatter, "canon/formatters/html_formatter"
+    autoload :HtmlFormatterBase, "canon/formatters/html_formatter_base"
+    autoload :JsonFormatter, "canon/formatters/json_formatter"
+    autoload :XmlFormatter, "canon/formatters/xml_formatter"
+    autoload :YamlFormatter, "canon/formatters/yaml_formatter"
+  end
+end

data/lib/canon/html/data_model.rb

@@ -1,14 +1,6 @@
 # frozen_string_literal: true
 
 require "nokogiri" unless RUBY_ENGINE == "opal"
-require_relative "../data_model"
-require_relative "../xml/nodes/root_node"
-require_relative "../xml/nodes/element_node"
-require_relative "../xml/nodes/namespace_node"
-require_relative "../xml/nodes/attribute_node"
-require_relative "../xml/nodes/text_node"
-require_relative "../xml/nodes/comment_node"
-require_relative "../xml/nodes/processing_instruction_node"
 
 module Canon
   module Html
@@ -81,7 +73,6 @@ module Canon
       def self.serialize(node)
         # HTML nodes use the same serialization as XML
         # Delegate to XML serialization implementation
-        require_relative "../xml/data_model"
         Canon::Xml::DataModel.serialize(node)
       end
 
@@ -222,7 +213,6 @@ module Canon
           whitespace_sensitive_tags = %w[pre code textarea script style]
 
           # Check if whitespace is between inline siblings
-          require_relative "../comparison/whitespace_sensitivity"
           unless whitespace_sensitive_tags.include?(parent_name) ||
               Canon::Comparison::WhitespaceSensitivity.inline_whitespace_significant?(nokogiri_text)
             return nil

data/lib/canon/html/nokogiri_support.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Canon
+  module Html
+    # Nokogiri node utilities for the HTML pipeline.
+    #
+    # HTML parsing is Nokogiri's job on every CRuby runtime regardless of
+    # the XML engine (XmlBackend): moxml has no HTML adapter and leptris no
+    # HTML parser. Under Opal Nokogiri is unavailable and these helpers
+    # degrade the same way the moxml backend always did (false / nil /
+    # raise), which keeps HTML comparison unsupported there.
+    module NokogiriSupport
+      class << self
+        # Whether the node is a document fragment (any variant).
+        def document_fragment?(node)
+          return false unless defined?(Nokogiri)
+
+          node.is_a?(Nokogiri::XML::DocumentFragment) ||
+            node.is_a?(Nokogiri::HTML4::DocumentFragment) ||
+            node.is_a?(Nokogiri::HTML5::DocumentFragment)
+        end
+
+        # Whether the node is an HTML document (any variant).
+        def html_document?(node)
+          return false unless defined?(Nokogiri)
+
+          node.is_a?(Nokogiri::HTML::Document) ||
+            node.is_a?(Nokogiri::HTML4::Document) ||
+            node.is_a?(Nokogiri::HTML5::Document)
+        end
+
+        # Detect HTML version from a Nokogiri node.
+        # Returns :html5 or :html4. Defaults to :html5 for non-Nokogiri nodes.
+        def html_version_from_node(node)
+          return :html5 unless defined?(Nokogiri)
+
+          if node.is_a?(Nokogiri::HTML5::Document) ||
+              node.is_a?(Nokogiri::HTML5::DocumentFragment)
+            :html5
+          elsif node.is_a?(Nokogiri::HTML4::Document) ||
+              node.is_a?(Nokogiri::HTML4::DocumentFragment)
+            :html4
+          else
+            :html5
+          end
+        end
+
+        # Parse an HTML string into an XML fragment for the XML comparator.
+        def xml_fragment(html_string)
+          unless defined?(Nokogiri)
+            raise Canon::Error,
+                  "HTML fragment parsing requires Nokogiri"
+          end
+
+          Nokogiri::XML.fragment(html_string)
+        end
+      end
+    end
+  end
+end

data/lib/canon/html.rb

@@ -1,9 +1,11 @@
 # frozen_string_literal: true
 
-require_relative "html/data_model"
-
 module Canon
-  # HTML-specific functionality for Canon
+  # HTML-specific functionality for Canon.
+  #
+  # Children are autoloaded — never `require_relative` them.
   module Html
+    autoload :DataModel, "canon/html/data_model"
+    autoload :NokogiriSupport, "canon/html/nokogiri_support"
   end
 end

data/lib/canon/options/cli_generator.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "registry"
-
 module Canon
   module Options
     # Generates Thor CLI options from the Options Registry

data/lib/canon/options/registry.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../comparison/match_options"
-
 module Canon
   module Options
     # Centralized registry for all Canon options

data/lib/canon/options.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Canon
+  # CLI option definitions and the option registry.
+  module Options
+    autoload :CliGenerator, "canon/options/cli_generator"
+    autoload :Registry, "canon/options/registry"
+  end
+end

data/lib/canon/pretty_printer/html.rb

@@ -2,7 +2,6 @@
 
 require "nokogiri" unless RUBY_ENGINE == "opal"
 require "stringio"
-require_relative "html_void_elements"
 
 module Canon
   module PrettyPrinter

data/lib/canon/pretty_printer/xml.rb

@@ -11,7 +11,12 @@ module Canon
       end
 
       def format(xml_string)
-        if Canon::XmlBackend.nokogiri?
+        # Output parity: pretty-printed bytes are canon's product. The
+        # moxml serializer cannot yet match Nokogiri's output (empty
+        # element expansion, declaration placement, tab indent), so the
+        # Nokogiri pipeline is used whenever available — the moxml branch
+        # is the Opal fallback.
+        if defined?(Nokogiri)
           nokogiri_format(xml_string)
         else
           moxml_format(xml_string)

data/lib/canon/pretty_printer/xml_normalized.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "nokogiri" unless RUBY_ENGINE == "opal"
-require_relative "html_void_elements"
 
 module Canon
   module PrettyPrinter
@@ -154,12 +153,12 @@ module Canon
       # @return [String] Serialized XML, one node per line, with content
       #   whitespace visualized at line boundaries
       def format(xml_string)
-        doc = if Canon::XmlBackend.moxml?
-                Canon::XmlParsing.parse(xml_string)
-              elsif @html_mode
-                Nokogiri::HTML5(xml_string)
+        # Output parity: see PrettyPrinter::Xml — the Nokogiri pipeline
+        # produces canon's byte-stable output; moxml is the Opal fallback.
+        doc = if defined?(Nokogiri)
+                @html_mode ? Nokogiri::HTML5(xml_string) : Nokogiri::XML(xml_string)
               else
-                Nokogiri::XML(xml_string)
+                Canon::XmlParsing.parse(xml_string)
               end
         lines = []
 
@@ -398,7 +397,6 @@ module Canon
 
       # Load the default visualization map from DiffFormatter constants.
       def default_vis_map
-        require_relative "../diff_formatter"
         Canon::DiffFormatter::DEFAULT_VISUALIZATION_MAP
       rescue LoadError, NameError
         { " " => "░", "\t" => "⇥", "\n" => "↵", "\r" => "⏎", "\u00A0" => "␣" }