moxml 0.5.146 → 0.5.148

data/spec/moxml/element_add_element_spec.rb

@@ -9,7 +9,7 @@ require "spec_helper"
 # the contract: a missing base default NoMethodErrors on non-face
 # adapters, a broken fallback loses attributes or the attach.
 RSpec.describe Moxml::Element do
-  ADAPTERS = %i[leptris nokogiri ox oga rexml libxml].freeze # rubocop:disable Lint/ConstantDefinitionInBlock, RSpec/LeakyConstantDeclaration
+  ELEMENT_ADD_ELEMENT_ADAPTERS = %i[leptris nokogiri ox oga rexml libxml].freeze # rubocop:disable Lint/ConstantDefinitionInBlock, RSpec/LeakyConstantDeclaration
 
   def with_adapter(name)
     ctx = Moxml.new(name)
@@ -19,7 +19,7 @@ RSpec.describe Moxml::Element do
   end
 
   it "attaches a child with all attributes on every available adapter" do
-    ADAPTERS.each do |name|
+    ELEMENT_ADD_ELEMENT_ADAPTERS.each do |name|
       with_adapter(name) do |ctx|
         doc = ctx.parse("<catalog/>")
         root = doc.root
@@ -35,7 +35,7 @@ RSpec.describe Moxml::Element do
   end
 
   it "nests under a non-root element with empty attrs" do
-    ADAPTERS.each do |name|
+    ELEMENT_ADD_ELEMENT_ADAPTERS.each do |name|
       with_adapter(name) do |ctx|
         doc = ctx.parse("<catalog><record/></catalog>")
         record = doc.root.children.first

data/spec/moxml/element_attribute_pairs_spec.rb

@@ -12,7 +12,7 @@ RSpec.describe Moxml::Element do
     '<catalog><record id="r0" kind="k0"><field name="f0" unit="u0">v</field></record></catalog>'
   end
 
-  ADAPTERS = %i[leptris nokogiri ox oga rexml libxml].freeze # rubocop:disable Lint/ConstantDefinitionInBlock, RSpec/LeakyConstantDeclaration
+  ELEMENT_ATTRIBUTE_PAIRS_ADAPTERS = %i[leptris nokogiri ox oga rexml libxml].freeze # rubocop:disable Lint/ConstantDefinitionInBlock, RSpec/LeakyConstantDeclaration
 
   def with_adapter(name)
     ctx = Moxml.new(name)
@@ -22,7 +22,7 @@ RSpec.describe Moxml::Element do
   end
 
   it "matches the node path on every available adapter" do
-    results = ADAPTERS.filter_map do |name|
+    results = ELEMENT_ATTRIBUTE_PAIRS_ADAPTERS.filter_map do |name|
       with_adapter(name) do |ctx|
         root = ctx.parse(xml).root
         [name, root.attribute_pairs]

data/spec/moxml/node_spec.rb

@@ -157,7 +157,7 @@ RSpec.describe Moxml::Node do
 
         it "locates the node via its path" do
           # Ox translates only a limited XPath subset (no positional predicates)
-          skip "ox xpath translation does not support positional predicates" if adapter_name == :ox
+          skip "D-12: ox xpath translation does not support positional predicates" if adapter_name == :ox
 
           expect(doc.at_xpath(title.path)).to eq(title)
         end

data/spec/moxml/plan_conformance_spec.rb

@@ -27,10 +27,10 @@ RSpec.describe "Moxml::Plan adapter conformance" do
     end
   end
 
-  ADAPTERS = %i[leptris nokogiri ox oga rexml libxml].freeze # rubocop:disable Lint/ConstantDefinitionInBlock, RSpec/LeakyConstantDeclaration
+  PLAN_CONFORMANCE_ADAPTERS = %i[leptris nokogiri ox oga rexml libxml].freeze # rubocop:disable Lint/ConstantDefinitionInBlock, RSpec/LeakyConstantDeclaration
 
   it "executes on every available adapter" do
-    available = ADAPTERS.select do |a|
+    available = PLAN_CONFORMANCE_ADAPTERS.select do |a|
       ctx = Moxml.new(a)
       ctx.parse(xml)
       true
@@ -63,7 +63,7 @@ RSpec.describe "Moxml::Plan adapter conformance" do
       on("field") { |attrs, text, _| [attrs["name"], text] }
     end
 
-    ADAPTERS.each do |a|
+    PLAN_CONFORMANCE_ADAPTERS.each do |a|
       begin
         ctx = Moxml.new(a)
         ctx.parse(xml)

data/spec/moxml/sax_entity_parity_spec.rb

@@ -32,7 +32,7 @@ module SaxEntityParityFixtures
     end
   end
 
-  ADAPTERS = %i[nokogiri ox oga rexml libxml headed_ox].freeze
+  SAX_ENTITY_PARITY_ADAPTERS = %i[nokogiri ox oga rexml libxml headed_ox].freeze
 
   # Each row: [input XML, decoded attribute value, expected attribute
   # value as it appears in the serialized XML]. The serialized form
@@ -85,7 +85,7 @@ module SaxEntityParityFixtures
 end
 
 RSpec.describe "SAX/DOM entity parity" do
-  SaxEntityParityFixtures::ADAPTERS.each do |adapter|
+  SaxEntityParityFixtures::SAX_ENTITY_PARITY_ADAPTERS.each do |adapter|
     context "with #{adapter} adapter" do
       let(:ctx) { Moxml.new(adapter) }
 
@@ -349,7 +349,7 @@ RSpec.describe "SAX/DOM entity parity" do
 
     SaxEntityParityFixtures::ATTRIBUTE_CASES.each do |label, (xml, _expected, expected_serialized)|
       it "every adapter emits the same attribute form: #{label}" do
-        results = SaxEntityParityFixtures::ADAPTERS.to_h { |a| [a, serialize_via(a, xml)] }
+        results = SaxEntityParityFixtures::SAX_ENTITY_PARITY_ADAPTERS.to_h { |a| [a, serialize_via(a, xml)] }
         results.each do |a, out|
           expect(out).to(
             include(%(x="#{expected_serialized}")),

data/spec/moxml/sax_spec.rb

@@ -413,7 +413,7 @@ RSpec.describe Moxml::SAX do
     it "documents CDATA limitation" do
       # Ox SAX does not have separate CDATA events
       # All CDATA content is delivered as text() events
-      skip "Ox SAX does not support separate CDATA events"
+      skip "D-10: Ox SAX does not support separate CDATA events"
 
       xml_with_cdata = "<root><![CDATA[special content]]></root>"
 
@@ -428,7 +428,7 @@ RSpec.describe Moxml::SAX do
 
     it "documents comment limitation" do
       # Ox SAX does not have separate comment events
-      skip "Ox SAX does not support separate comment events"
+      skip "D-10: Ox SAX does not support separate comment events"
 
       xml_with_comment = "<root><!-- comment --><data>content</data></root>"
 
@@ -443,7 +443,7 @@ RSpec.describe Moxml::SAX do
 
     it "documents processing instruction limitation" do
       # Ox SAX does not have separate PI events
-      skip "Ox SAX does not support separate processing instruction events"
+      skip "D-10: Ox SAX does not support separate processing instruction events"
 
       xml_with_pi = '<?xml-stylesheet type="text/xsl" href="style.xsl"?><root/>'
 
@@ -714,7 +714,7 @@ RSpec.describe Moxml::SAX do
     end
 
     it "handles errors gracefully" do
-      skip "Oga SAX parser may be more lenient with malformed XML"
+      skip "D-11: Oga SAX parser may be more lenient with malformed XML"
 
       invalid_xml = "<book><title>Unclosed"
 
@@ -1024,7 +1024,7 @@ RSpec.describe Moxml::SAX do
 
     it "documents CDATA limitation (inherited from Ox)" do
       # HeadedOx inherits Ox's SAX implementation, which does not have separate CDATA events
-      skip "HeadedOx SAX (inherited from Ox) does not support separate CDATA events"
+      skip "D-10: HeadedOx SAX (inherited from Ox) does not support separate CDATA events"
 
       xml_with_cdata = "<root><![CDATA[special content]]></root>"
 
@@ -1038,7 +1038,7 @@ RSpec.describe Moxml::SAX do
 
     it "documents comment limitation (inherited from Ox)" do
       # HeadedOx inherits Ox's SAX implementation, which does not have separate comment events
-      skip "HeadedOx SAX (inherited from Ox) does not support separate comment events"
+      skip "D-10: HeadedOx SAX (inherited from Ox) does not support separate comment events"
 
       xml_with_comment = "<root><!-- comment --><data>content</data></root>"
 
@@ -1052,7 +1052,7 @@ RSpec.describe Moxml::SAX do
 
     it "documents processing instruction limitation (inherited from Ox)" do
       # HeadedOx inherits Ox's SAX implementation, which does not have separate PI events
-      skip "HeadedOx SAX (inherited from Ox) does not support separate processing instruction events"
+      skip "D-10: HeadedOx SAX (inherited from Ox) does not support separate processing instruction events"
 
       xml_with_pi = '<?xml-stylesheet type="text/xsl" href="style.xsl"?><root/>'
 

data/spec/moxml/struct_plan_spec.rb

@@ -28,7 +28,7 @@ RSpec.describe Moxml::StructPlan do
     end
   end
 
-  ADAPTERS = %i[leptris nokogiri ox oga rexml libxml].freeze # rubocop:disable Lint/ConstantDefinitionInBlock, RSpec/LeakyConstantDeclaration
+  STRUCT_PLAN_ADAPTERS = %i[leptris nokogiri ox oga rexml libxml].freeze # rubocop:disable Lint/ConstantDefinitionInBlock, RSpec/LeakyConstantDeclaration
 
   def with_adapter(name)
     yield Moxml.new(name)
@@ -36,7 +36,7 @@ RSpec.describe Moxml::StructPlan do
     skip "#{name} unavailable"
   end
 
-  ADAPTERS.each do |adapter_name|
+  STRUCT_PLAN_ADAPTERS.each do |adapter_name|
     describe "on #{adapter_name}" do
       it "materializes the same structs as Moxml::Plan" do
         with_adapter(adapter_name) do |ctx|

data/spec/moxml/xpath_capabilities_spec.rb

@@ -83,7 +83,7 @@ RSpec.describe "XPath Capabilities" do
           programming = doc.xpath("//book[@category='programming']")
           expect(programming.length).to be >= 0 # May not work on all
         rescue Moxml::XPathError
-          skip "Attribute value predicates not supported on #{adapter_name}"
+          skip "D-12: Attribute value predicates not supported on #{adapter_name}"
         end
       end
 
@@ -98,7 +98,7 @@ RSpec.describe "XPath Capabilities" do
           items = doc.xpath("//book:item", namespaces)
           expect(items.length).to be >= 0
         rescue Moxml::XPathError, NoMethodError
-          skip "Namespace XPath not supported on #{adapter_name}"
+          skip "D-12: Namespace XPath not supported on #{adapter_name}"
         end
 
         it "handles default namespaces" do
@@ -108,7 +108,7 @@ RSpec.describe "XPath Capabilities" do
           library = doc.xpath("//lib:library", namespaces)
           expect(library.length).to be >= 0
         rescue Moxml::XPathError, NoMethodError
-          skip "Default namespace XPath not supported on #{adapter_name}"
+          skip "D-12: Default namespace XPath not supported on #{adapter_name}"
         end
       end
 
@@ -118,7 +118,7 @@ RSpec.describe "XPath Capabilities" do
           first_book = doc.xpath("//book[1]")
           expect(first_book.length).to be >= 0
         rescue Moxml::XPathError
-          skip "Position predicates not supported on #{adapter_name}"
+          skip "D-12: Position predicates not supported on #{adapter_name}"
         end
 
         it "supports position() function" do
@@ -126,7 +126,7 @@ RSpec.describe "XPath Capabilities" do
           first_books = doc.xpath("//book[position()=1]")
           expect(first_books.length).to be >= 0
         rescue Moxml::XPathError
-          skip "position() function not supported on #{adapter_name}"
+          skip "D-12: position() function not supported on #{adapter_name}"
         end
       end
 
@@ -135,11 +135,11 @@ RSpec.describe "XPath Capabilities" do
           doc = Moxml.new.parse(simple_xml)
           result = doc.xpath("count(//book)")
           # REXML's XPath has no function support and yields an empty set
-          skip "count() function not supported on #{adapter_name}" if result.is_a?(Moxml::NodeSet)
+          skip "D-12: count() function not supported on #{adapter_name}" if result.is_a?(Moxml::NodeSet)
 
           expect(result).to eq(2)
         rescue Moxml::XPathError, NoMethodError
-          skip "count() function not supported on #{adapter_name}"
+          skip "D-12: count() function not supported on #{adapter_name}"
         end
 
         it "supports text() node selection" do
@@ -147,7 +147,7 @@ RSpec.describe "XPath Capabilities" do
           texts = doc.xpath("//title/text()")
           expect(texts.length).to be >= 0
         rescue Moxml::XPathError
-          skip "text() not supported on #{adapter_name}"
+          skip "D-12: text() not supported on #{adapter_name}"
         end
       end
 
@@ -157,7 +157,7 @@ RSpec.describe "XPath Capabilities" do
           cheap_books = doc.xpath("//book[@id < 2]")
           expect(cheap_books.length).to be >= 0
         rescue Moxml::XPathError
-          skip "Numeric predicates not supported on #{adapter_name}"
+          skip "D-12: Numeric predicates not supported on #{adapter_name}"
         end
 
         it "supports boolean expressions ([cond1 and cond2])" do
@@ -165,7 +165,7 @@ RSpec.describe "XPath Capabilities" do
           result = doc.xpath("//book[@id and @category]")
           expect(result.length).to be >= 0
         rescue Moxml::XPathError
-          skip "Boolean expressions not supported on #{adapter_name}"
+          skip "D-12: Boolean expressions not supported on #{adapter_name}"
         end
       end
 
@@ -175,7 +175,7 @@ RSpec.describe "XPath Capabilities" do
           children = doc.xpath("/library/child::book")
           expect(children.length).to be >= 0
         rescue Moxml::XPathError
-          skip "child:: axis not supported on #{adapter_name}"
+          skip "D-12: child:: axis not supported on #{adapter_name}"
         end
 
         it "supports descendant axis" do
@@ -183,7 +183,7 @@ RSpec.describe "XPath Capabilities" do
           descendants = doc.xpath("//library/descendant::title")
           expect(descendants.length).to be >= 0
         rescue Moxml::XPathError
-          skip "descendant:: axis not supported on #{adapter_name}"
+          skip "D-12: descendant:: axis not supported on #{adapter_name}"
         end
       end
 
@@ -193,7 +193,7 @@ RSpec.describe "XPath Capabilities" do
           items = doc.xpath("//book | //magazine")
           expect(items.length).to be >= 0
         rescue Moxml::XPathError
-          skip "Union operator not supported on #{adapter_name}"
+          skip "D-12: Union operator not supported on #{adapter_name}"
         end
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: moxml
 version: !ruby/object:Gem::Version
-  version: 0.5.146
+  version: 0.5.148
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-19 00:00:00.000000000 Z
+date: 2026-10-20 00:00:00.000000000 Z
 dependencies: []
 description: |
   Moxml is a unified XML manipulation library that provides a common API
@@ -73,6 +73,7 @@ files:
 - docs/_pages/compatibility.adoc
 - docs/_pages/configuration.adoc
 - docs/_pages/conversion-apis.adoc
+- docs/_pages/divergences.adoc
 - docs/_pages/error-handling.adoc
 - docs/_pages/headed-ox-limitations.adoc
 - docs/_pages/headed-ox.adoc
@@ -84,6 +85,7 @@ files:
 - docs/_pages/thread-safety.adoc
 - docs/_references/document-api.adoc
 - docs/_references/index.adoc
+- docs/_references/processing-model.adoc
 - docs/_tutorials/basic-usage.adoc
 - docs/_tutorials/builder-pattern.adoc
 - docs/_tutorials/index.adoc
@@ -310,9 +312,14 @@ files:
 - sig/moxml.rbs
 - spec/consistency/README.md
 - spec/consistency/adapter_parity_spec.rb
+- spec/consistency/divergence_register_spec.rb
+- spec/consistency/document_text_spec.rb
 - spec/consistency/eol_normalization_spec.rb
 - spec/consistency/html_doctype_spec.rb
+- spec/consistency/loud_degradation_spec.rb
+- spec/consistency/model_coverage_audit_spec.rb
 - spec/consistency/round_trip_spec.rb
+- spec/consistency/spec_constant_uniqueness_spec.rb
 - spec/consistency/xpath_idioms_spec.rb
 - spec/consistency/xslt_spec.rb
 - spec/examples/README.md
@@ -453,9 +460,11 @@ files:
 - spec/moxml/adapter/leptris_attribute_snapshot_spec.rb
 - spec/moxml/adapter/leptris_binding_cap_spec.rb
 - spec/moxml/adapter/leptris_contract_reads_spec.rb
+- spec/moxml/adapter/leptris_detached_text_spec.rb
 - spec/moxml/adapter/leptris_doc_parts_spec.rb
 - spec/moxml/adapter/leptris_document_declaration_spec.rb
 - spec/moxml/adapter/leptris_inbody_comment_spec.rb
+- spec/moxml/adapter/leptris_parse_lint_spec.rb
 - spec/moxml/adapter/leptris_parse_skips_spec.rb
 - spec/moxml/adapter/leptris_record_driver_spec.rb
 - spec/moxml/adapter/leptris_sax_dup_attr_spec.rb