moxml 0.5.149 → 0.5.150

data/spec/moxml/xpath_capabilities_spec.rb

@@ -81,9 +81,7 @@ RSpec.describe "XPath Capabilities" do
         it "supports attribute value matching ([@attr='value'])" do
           doc = Moxml.new.parse(simple_xml)
           programming = doc.xpath("//book[@category='programming']")
-          expect(programming.length).to be >= 0 # May not work on all
-        rescue Moxml::XPathError
-          skip "D-12: Attribute value predicates not supported on #{adapter_name}"
+          expect(programming.length).to eq(1)
         end
       end
 
@@ -96,9 +94,7 @@ RSpec.describe "XPath Capabilities" do
           }
 
           items = doc.xpath("//book:item", namespaces)
-          expect(items.length).to be >= 0
-        rescue Moxml::XPathError, NoMethodError
-          skip "D-12: Namespace XPath not supported on #{adapter_name}"
+          expect(items.length).to eq(2)
         end
 
         it "handles default namespaces" do
@@ -106,9 +102,7 @@ RSpec.describe "XPath Capabilities" do
           namespaces = { "lib" => "http://library.org" }
 
           library = doc.xpath("//lib:library", namespaces)
-          expect(library.length).to be >= 0
-        rescue Moxml::XPathError, NoMethodError
-          skip "D-12: Default namespace XPath not supported on #{adapter_name}"
+          expect(library.length).to eq(1)
         end
       end
 
@@ -116,17 +110,13 @@ RSpec.describe "XPath Capabilities" do
         it "supports numeric positions ([1])" do
           doc = Moxml.new.parse(simple_xml)
           first_book = doc.xpath("//book[1]")
-          expect(first_book.length).to be >= 0
-        rescue Moxml::XPathError
-          skip "D-12: Position predicates not supported on #{adapter_name}"
+          expect(first_book.length).to eq(1)
         end
 
         it "supports position() function" do
           doc = Moxml.new.parse(simple_xml)
           first_books = doc.xpath("//book[position()=1]")
-          expect(first_books.length).to be >= 0
-        rescue Moxml::XPathError
-          skip "D-12: position() function not supported on #{adapter_name}"
+          expect(first_books.length).to eq(1)
         end
       end
 
@@ -134,20 +124,13 @@ RSpec.describe "XPath Capabilities" do
         it "supports count() function, returning the scalar unwrapped" 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 "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 "D-12: count() function not supported on #{adapter_name}"
         end
 
         it "supports text() node selection" do
           doc = Moxml.new.parse(simple_xml)
           texts = doc.xpath("//title/text()")
-          expect(texts.length).to be >= 0
-        rescue Moxml::XPathError
-          skip "D-12: text() not supported on #{adapter_name}"
+          expect(texts.length).to eq(3)
         end
       end
 
@@ -155,17 +138,13 @@ RSpec.describe "XPath Capabilities" do
         it "supports numeric comparisons ([@attr < value])" do
           doc = Moxml.new.parse(simple_xml)
           cheap_books = doc.xpath("//book[@id < 2]")
-          expect(cheap_books.length).to be >= 0
-        rescue Moxml::XPathError
-          skip "D-12: Numeric predicates not supported on #{adapter_name}"
+          expect(cheap_books.length).to eq(1)
         end
 
         it "supports boolean expressions ([cond1 and cond2])" do
           doc = Moxml.new.parse(simple_xml)
           result = doc.xpath("//book[@id and @category]")
-          expect(result.length).to be >= 0
-        rescue Moxml::XPathError
-          skip "D-12: Boolean expressions not supported on #{adapter_name}"
+          expect(result.length).to eq(2)
         end
       end
 
@@ -173,17 +152,13 @@ RSpec.describe "XPath Capabilities" do
         it "supports child axis" do
           doc = Moxml.new.parse(simple_xml)
           children = doc.xpath("/library/child::book")
-          expect(children.length).to be >= 0
-        rescue Moxml::XPathError
-          skip "D-12: child:: axis not supported on #{adapter_name}"
+          expect(children.length).to eq(2)
         end
 
         it "supports descendant axis" do
           doc = Moxml.new.parse(simple_xml)
           descendants = doc.xpath("//library/descendant::title")
-          expect(descendants.length).to be >= 0
-        rescue Moxml::XPathError
-          skip "D-12: descendant:: axis not supported on #{adapter_name}"
+          expect(descendants.length).to eq(3)
         end
       end
 
@@ -191,9 +166,7 @@ RSpec.describe "XPath Capabilities" do
         it "supports union (|)" do
           doc = Moxml.new.parse(simple_xml)
           items = doc.xpath("//book | //magazine")
-          expect(items.length).to be >= 0
-        rescue Moxml::XPathError
-          skip "D-12: Union operator not supported on #{adapter_name}"
+          expect(items.length).to eq(3)
         end
       end
     end

data/spec/support/input_taxonomy.rb

@@ -67,6 +67,10 @@ module InputTaxonomy
       text: { oga: "D-14" },
       pi_content: { ox: "D-05", headed_ox: "D-05" },
     },
+    "pi/comment/cdata: pi trailing whitespace" => {
+      text: { oga: "D-14" },
+      pi_content: { ox: "D-05", headed_ox: "D-05", rexml: "D-20" },
+    },
     "huge text with entities" => {
       text: { rexml: "D-16" },
       serialize: { rexml: "D-16" },
@@ -191,6 +195,9 @@ module InputTaxonomy
       Input.new("pi/comment/cdata: pi multi-space separator", "pi/comment/cdata edges",
                 "<r><?pi   data?></r>", true,
                 "separator whitespace is not PI content (uniform)"),
+      Input.new("pi/comment/cdata: pi trailing whitespace", "pi/comment/cdata edges",
+                "<r><?pi data   ?></r>", true,
+                "trailing whitespace is PI data (D-20 on rexml)"),
       Input.new("pi/comment/cdata: empty pi", "pi/comment/cdata edges",
                 "<r><?pi?></r>", true, nil),
 

data/spec/support/model_coverage.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+# The model-coverage matrix (TODO.sota/01, TODO.sota/07): every face
+# family of the processing model mapped to the normative section it
+# cites, the pin that enforces it, and per-adapter dispositions
+# (registered divergence or named loud error). One source of truth for
+# the audit, the model-document pin lists, and the published coverage
+# page.
+module ModelCoverage
+  MODEL_COVERAGE_MATRIX = {
+    "document order and children listing" => {
+      section: "Document order and traversal",
+      pin: "spec/consistency/adapter_parity_spec.rb",
+    },
+    "name resolution" => {
+      section: "Names and namespaces",
+      pin: "spec/consistency/xpath_idioms_spec.rb",
+    },
+    "namespace resolution and bindings normalization" => {
+      section: "Names and namespaces",
+      pin: "spec/consistency/xpath_idioms_spec.rb",
+    },
+    "attribute access" => {
+      section: "Access semantics",
+      pin: "spec/moxml/attribute_resolver_spec.rb",
+    },
+    "text/content/raw_content" => {
+      section: "Access semantics",
+      pin: "spec/moxml/text_spec.rb",
+    },
+    "parsing modes and diagnostics" => {
+      section: "Parsing",
+      pin: "spec/moxml/document_parse_diagnostics_spec.rb",
+    },
+    "EOL normalization" => {
+      section: "Parsing",
+      pin: "spec/consistency/eol_normalization_spec.rb",
+      exempt: { oga: "D-02", ox: "D-03" },
+    },
+    "entity modes" => {
+      section: "Parsing",
+      pin: "spec/moxml/entity_spec.rb",
+    },
+    "XPath evaluation and declared idioms" => {
+      section: "XPath evaluation",
+      pin: "spec/consistency/xpath_idioms_spec.rb",
+    },
+    "serialization shapes (xml/html/xhtml)" => {
+      section: "Serialization",
+      pin: "spec/moxml/xhtml_output_spec.rb",
+    },
+    "indentation knobs" => {
+      section: "Serialization",
+      pin: "spec/moxml/to_html_spec.rb",
+      exempt: { oga: "D-09", ox: "D-09", headed_ox: "D-09",
+                libxml: "D-09", leptris: "D-09" },
+    },
+    "canonicalization" => {
+      section: "Canonicalization",
+      pin: "spec/moxml/c14n/adapter_delegation_spec.rb",
+      exempt: { ox: "D-05", headed_ox: "D-05" },
+    },
+    "XSLT" => {
+      section: "XSLT",
+      pin: "spec/consistency/xslt_spec.rb",
+      loud: { oga: "Moxml::NotImplementedError",
+              ox: "Moxml::NotImplementedError",
+              headed_ox: "Moxml::NotImplementedError",
+              rexml: "Moxml::NotImplementedError",
+              libxml: "Moxml::NotImplementedError" },
+    },
+    "SAX" => {
+      section: "SAX",
+      pin: "spec/moxml/sax_spec.rb",
+    },
+    "materialization" => {
+      section: "Materialization",
+      pin: "spec/moxml/plan_conformance_spec.rb",
+    },
+    "loud capability contracts" => {
+      section: "Errors and loud degradation",
+      pin: "spec/consistency/loud_degradation_spec.rb",
+    },
+  }.freeze
+
+  # Normative sections that are not face families (meta/apparatus).
+  MODEL_COVERAGE_NON_FACE = [
+    "Status and precedence",
+    "Mission and invariant",
+    "Object model",
+    "Performance: a declared, non-semantic channel",
+  ].freeze
+
+  MODEL_COVERAGE_ADAPTERS = %i[nokogiri oga rexml ox headed_ox libxml leptris].freeze
+
+  module_function
+
+  def families
+    MODEL_COVERAGE_MATRIX.keys
+  end
+
+  def sections
+    MODEL_COVERAGE_MATRIX.values.map { |cell| cell[:section] }.uniq
+  end
+
+  def pins_for(section)
+    MODEL_COVERAGE_MATRIX.values.select { |cell| cell[:section] == section }
+      .filter_map { |cell| cell[:pin] }.uniq.sort
+  end
+
+  def disposition(family, adapter)
+    cell = MODEL_COVERAGE_MATRIX.fetch(family)
+    if (id = (cell[:exempt] || {})[adapter])
+      [:specd, id]
+    elsif (error = (cell[:loud] || {})[adapter])
+      [:loud, error]
+    else
+      [:equivalent, nil]
+    end
+  end
+
+  def cell_text(family, adapter)
+    kind, detail = disposition(family, adapter)
+    case kind
+    when :specd then detail
+    when :loud then "loud (#{detail.split('::').last})"
+    else "equivalent"
+    end
+  end
+
+  # The published page block, deterministic (no clock, no engine
+  # versions): the page is a view of the committed matrix and register,
+  # so a data change without regeneration fails CI.
+  def render_page_block
+    lines = []
+    lines << "Generated by `bundle exec rake docs:coverage` from the " \
+             "coverage matrix and the divergence register. Do not edit " \
+             "by hand: `spec/consistency/published_docs_spec.rb` fails " \
+             "when this block is stale."
+    lines << ""
+    lines << %([cols="4#{',1' * MODEL_COVERAGE_ADAPTERS.size}",options="header"])
+    lines << "|==="
+    lines << "| Face family | " \
+             "#{MODEL_COVERAGE_ADAPTERS.map { |adapter| adapter.to_s.tr('_', ' ') }.join(' | ')}"
+    families.each do |family|
+      lines << "| #{family} | " \
+               "#{MODEL_COVERAGE_ADAPTERS.map { |adapter| cell_text(family, adapter) }.join(' | ')}"
+    end
+    lines << "|==="
+    lines << ""
+    lines << "*equivalent* — all adapters answer the same observable " \
+             "result. *loud (...)* — the adapter raises the named error " \
+             "for that face. *D-NN* — a registered divergence in " \
+             "link:divergences.html[the register], with its rationale. " \
+             "Every cell cites a pin; see the processing model's " \
+             "`Pins::` line for the enforcing specs."
+    lines.join("\n")
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: moxml
 version: !ruby/object:Gem::Version
-  version: 0.5.149
+  version: 0.5.150
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-20 00:00:00.000000000 Z
+date: 2026-10-21 00:00:00.000000000 Z
 dependencies: []
 description: |
   Moxml is a unified XML manipulation library that provides a common API
@@ -26,6 +26,8 @@ files:
 - ".github/workflows/docs.yml"
 - ".github/workflows/nightly-fuzz.yml"
 - ".github/workflows/opal.yml"
+- ".github/workflows/performance-release.yml"
+- ".github/workflows/performance.yml"
 - ".github/workflows/rake.yml"
 - ".github/workflows/release.yml"
 - ".github/workflows/round-trip.yml"
@@ -40,12 +42,16 @@ files:
 - LICENSE.md
 - README.adoc
 - Rakefile
+- benchmark/README.md
 - benchmark/pipeline_bench.rb
 - benchmark/plan_bench.rb
 - benchmark/sax_bench.rb
+- benchmark/scoreboard.json
+- benchmark/scoreboard.rb
 - benchmarks/.gitignore
 - benchmarks/generate_report.rb
 - bin/console
+- bin/generate-model-coverage
 - bin/setup
 - data/w3c_entities.json
 - docs/ENTITY_SUPPORT_FOR_LUTAML_MODEL.md
@@ -75,15 +81,18 @@ files:
 - docs/_pages/configuration.adoc
 - docs/_pages/conversion-apis.adoc
 - docs/_pages/divergences.adoc
+- docs/_pages/ecosystem.adoc
 - docs/_pages/error-handling.adoc
 - docs/_pages/headed-ox-limitations.adoc
 - docs/_pages/headed-ox.adoc
 - docs/_pages/index.adoc
 - docs/_pages/installation.adoc
+- docs/_pages/model-coverage.adoc
 - docs/_pages/node-api-reference.adoc
 - docs/_pages/performance.adoc
 - docs/_pages/quick-start.adoc
 - docs/_pages/thread-safety.adoc
+- docs/_pages/why-moxml.adoc
 - docs/_references/document-api.adoc
 - docs/_references/index.adoc
 - docs/_references/processing-model.adoc
@@ -232,6 +241,7 @@ files:
 - lib/moxml/reference/normalizer.rb
 - lib/moxml/reference/parser.rb
 - lib/moxml/reference/writer.rb
+- lib/moxml/relaxng.rb
 - lib/moxml/sax.rb
 - lib/moxml/sax/block_handler.rb
 - lib/moxml/sax/element_handler.rb
@@ -318,6 +328,7 @@ files:
 - sig/moxml.rbs
 - spec/consistency/README.md
 - spec/consistency/adapter_parity_spec.rb
+- spec/consistency/citation_hygiene_spec.rb
 - spec/consistency/differential_taxonomy_spec.rb
 - spec/consistency/divergence_register_spec.rb
 - spec/consistency/document_text_spec.rb
@@ -327,6 +338,7 @@ files:
 - spec/consistency/metamorphic_properties_spec.rb
 - spec/consistency/metamorphic_spec.rb
 - spec/consistency/model_coverage_audit_spec.rb
+- spec/consistency/published_docs_spec.rb
 - spec/consistency/reference_differential_spec.rb
 - spec/consistency/round_trip_spec.rb
 - spec/consistency/spec_constant_uniqueness_spec.rb
@@ -526,6 +538,7 @@ files:
 - spec/moxml/document_spec.rb
 - spec/moxml/element_add_element_spec.rb
 - spec/moxml/element_attribute_pairs_spec.rb
+- spec/moxml/element_indent_spec.rb
 - spec/moxml/element_spec.rb
 - spec/moxml/entity_preservation_spec.rb
 - spec/moxml/entity_reference_spec.rb
@@ -560,6 +573,7 @@ files:
 - spec/moxml/recover_mode_spec.rb
 - spec/moxml/reference_opal_spec.rb
 - spec/moxml/reference_spec.rb
+- spec/moxml/relax_ng_spec.rb
 - spec/moxml/sax/namespace_splitter_spec.rb
 - spec/moxml/sax_entity_parity_spec.rb
 - spec/moxml/sax_spec.rb
@@ -623,6 +637,7 @@ files:
 - spec/support/allocation_helper.rb
 - spec/support/input_generator.rb
 - spec/support/input_taxonomy.rb
+- spec/support/model_coverage.rb
 - spec/support/opal.rb
 - spec/support/w3c_namespace_helpers.rb
 - spec/support/xml_generator.rb