moxml 0.5.148 → 0.5.150

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

data/spec/support/xml_generator.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# Seeded XML generator (TODO.sota/02): composes random
+# taxonomy-class documents — elements, text, attributes, namespaces,
+# comments, PIs, CDATA — deterministic per seed. The metamorphic
+# suite runs its properties over generated docs; a failing seed is a
+# reproducible regression.
+module XmlGenerator
+  ELEMENT_NAMES = %w[r a b node item entry rec child leaf].freeze
+  ATTR_NAMES = %w[id name kind type ref value flag].freeze
+  TEXT_POOL = [
+    "plain text", "text with spaces  ", "entities & <tags>",
+    "unicode déjà vu", "numbers 12345", "", "  ", "tail  "
+  ].freeze
+  PI_TARGETS = %w[render probe].freeze
+
+  module_function
+
+  # Deterministic RNG: Ruby's Mersenne with an explicit seed.
+  def generate(seed)
+    rng = Random.new(seed)
+    depth = rng.rand(1..5)
+    body = compose(rng, depth)
+    %(<root#{attrs(rng, depth)}>#{body}</root>)
+  end
+
+  def compose(rng, depth)
+    parts = []
+    rng.rand(1..4).times do
+      case rng.rand(depth.zero? ? 5 : 10)
+      when 0..4 then parts << element(rng, depth)
+      when 5 then parts << TEXT_POOL.sample(random: rng)
+      when 6 then parts << "<!-- #{format('%04x', rng.rand(65_536))} -->"
+      when 7 then parts << "<?#{PI_TARGETS.sample(random: rng)} d#{format('%02x', rng.rand(256))}?>"
+      when 8 then parts << "<![CDATA[raw #{format('%04x', rng.rand(65_536))} <stuff>]]>"
+      when 9 then parts << format("<e n=\"%d\"/>", rng.rand(100))
+      end
+    end
+    parts.join
+  end
+
+  def element(rng, depth)
+    name = ELEMENT_NAMES.sample(random: rng)
+    ns = rng.rand(4).zero? ? %( xmlns="urn:g#{rng.rand(3)}") : ""
+    body = depth.positive? ? compose(rng, depth - 1) : TEXT_POOL.sample(random: rng)
+    "<#{name}#{ns}#{attrs(rng, depth)}>#{body}</#{name}>"
+  end
+
+  def attrs(rng, _depth)
+    (0...rng.rand(0..3)).map do |i|
+      %( #{ATTR_NAMES.sample(random: rng)}#{i}="v#{rng.rand(100)}")
+    end.join
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: moxml
 version: !ruby/object:Gem::Version
-  version: 0.5.148
+  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
@@ -24,7 +24,10 @@ files:
 - ".github/workflows/dependent-repos.json"
 - ".github/workflows/dependent-tests.yml"
 - ".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"
@@ -39,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
@@ -74,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
@@ -227,6 +237,11 @@ files:
 - lib/moxml/node_set.rb
 - lib/moxml/plan.rb
 - lib/moxml/processing_instruction.rb
+- lib/moxml/reference.rb
+- 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
@@ -297,6 +312,7 @@ files:
 - lib/moxml/xpath/engine.rb
 - lib/moxml/xpath/errors.rb
 - lib/moxml/xpath/lexer.rb
+- lib/moxml/xpath/ordering.rb
 - lib/moxml/xpath/parser.rb
 - lib/moxml/xpath/ruby/generator.rb
 - lib/moxml/xpath/ruby/node.rb
@@ -312,12 +328,18 @@ 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
 - spec/consistency/eol_normalization_spec.rb
 - spec/consistency/html_doctype_spec.rb
 - spec/consistency/loud_degradation_spec.rb
+- 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
 - spec/consistency/xpath_idioms_spec.rb
@@ -516,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
@@ -548,6 +571,9 @@ files:
 - spec/moxml/processing_instruction_spec.rb
 - spec/moxml/readonly_parse_spec.rb
 - 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
@@ -609,8 +635,12 @@ files:
 - spec/performance/xpath_benchmark_spec.rb
 - spec/spec_helper.rb
 - 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
 - spec/support/xml_matchers.rb
 - spec/unit/rexml_isolated_test.rb
 homepage: https://github.com/lutaml/moxml