moxml 0.5.172 → 0.5.173

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8719e57bb76ceb63baa171d151028d8aff538fc351be7397b6ec5a492c8bdf1
-  data.tar.gz: 8fa85d23570f0588da0eb5d4ce5f83d59fb28e325d587f7210d3380a8afd5e33
+  metadata.gz: be4403ff94123c6d65bf53402d99fee7462bd4d3e9c3ae34f87ff43170fddc29
+  data.tar.gz: 642a836819599fc943103d87d0148cf34e40544d94cf376b4d2d74e5d65bc25e
 SHA512:
-  metadata.gz: b93fc457a9d7435e2a55cb4fb5e3320d37b5949e77b184c640dd65a8b21954aab9987f204c8916411d9bfe6e11f7f0e358faa78f1ee9cfe3477f52b2d209e857
-  data.tar.gz: 78c66d6b3bdbb800b8cf23dde851235ab3a621bbb30fd0c413db06f9f856ba245b56f9a2c4a4d8220ca313b3bb2ef447d5737733387052bd82f2151cfd7bcdc5
+  metadata.gz: 0ac3bb7ae1148c02ed3c9812c448c8a20e521854f201c20ef22a22dbbc4cd9c12f01d0d1ea4d19f29d4f35f6781d83ace0d4db88957877a8758a621c4b720ecb
+  data.tar.gz: 2513f3da33f3b1836276b51428e9db7e814416db761bcaa3813bf0fd326851359e5a3cc6bb2e62401f0bbbf0aaa44b44dc7992dbb58a4bc475849cc659dd720d

data/docs/_pages/model-coverage.adoc

@@ -48,6 +48,7 @@ Generated by `bundle exec rake docs:coverage` from the coverage matrix and the d
 | validation schema sets | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent
 | validation substitution dismissal | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent
 | loud capability contracts | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent
+| engine capability report | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent
 |===
 
 *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.

data/docs/_references/processing-model.adoc

@@ -314,7 +314,7 @@ answers without raising. RELAX NG rides engines with an RNG face
 
 === Errors and loud degradation
 
-Pins:: `spec/consistency/loud_degradation_spec.rb`
+Pins:: `spec/consistency/loud_degradation_spec.rb`, `spec/moxml/adapter_capabilities_spec.rb`
 
 * `Moxml::Error` hierarchy; `Moxml::XPathError`, `Moxml::XsltError`,
   `Moxml::AdapterError` (e.g. schema-handle/adapter misroute),
@@ -324,6 +324,12 @@ Pins:: `spec/consistency/loud_degradation_spec.rb`
 * Adapter degradation is loud: a present-but-unusable preferred adapter
   warns at configuration and misroutes fail at the wrap, not deep in
   a call.
+* Engines with a capability story answer `Adapter.capabilities` — one
+  frozen report of the runtime-variable faces they serve plus their
+  engine version, queried once at attach. The support faces (xsd,
+  relaxng, xslt, digest) answer even when unconditional; internal
+  routing gates the floor made constant are absent by design.
+  Adapters without a capability story answer nil.
 
 === Performance: a declared, non-semantic channel
 

data/lib/moxml/adapter/base.rb

@@ -698,6 +698,15 @@ namespace_validation_mode: :strict)
           nil
         end
 
+        # The engine capability report (#493): a frozen hash of the
+        # runtime-variable faces this adapter serves, plus its engine
+        # version — queried once at attach, never version-gate
+        # constants. Adapters without a capability story answer nil
+        # (documented last resort, plan_rows-style).
+        def capabilities
+          nil
+        end
+
         # Struct-plan executor (Moxml::StructPlan): +spec+ compiles
         # the consumer's shape as {name => [Struct class, attrs
         # Hash (name => slot Symbol), text slot, children slot]}.

data/lib/moxml/adapter/leptris.rb

@@ -320,6 +320,37 @@ module Moxml
       BINDING_OF_CAP = 8_192
 
       class << self
+        # The engine capability report (#493): one structured face
+        # answering what THIS installed binding+engine serves, queried
+        # once at attach — the replacement for the version-gate-
+        # constant class. The support faces (xsd, relaxng, xslt,
+        # digest) answer even when the floor makes them unconditional —
+        # consumers ask for them by name; the internal routing gates
+        # the floor made constant are absent by design. Frozen; the
+        # keys are the model's capability names.
+        def capabilities
+          @capabilities ||= {
+            engine_version: ::Leptris::VERSION,
+            native_read_layer: !NATIVE_READ_LAYER.nil?,
+            native_xpath_seams: !NATIVE_XPATH_SEAMS.nil?,
+            bulk_xpath_rows: BULK_XPATH_ROWS,
+            add_element_full: ADD_ELEMENT_FULL,
+            native_strings_utf8: !NATIVE_STRINGS_UTF8.nil?,
+            native_mutations_coherent: !NATIVE_MUTATIONS_COHERENT.nil?,
+            native_entity_refs: !NATIVE_ENTITY_REFS.nil?,
+            native_bulk_fixed: !NATIVE_BULK_FIXED.nil?,
+            native_bulk_sax_records: NATIVE_SAX_RECORDS,
+            native_document_parts: NATIVE_DOC_PARTS,
+            native_plan_rows: NATIVE_PLAN_ROWS,
+            native_plan_structs: NATIVE_PLAN_STRUCTS,
+            native_plan_typed: NATIVE_PLAN_TYPED,
+            digest: DIGEST_SUPPORTED,
+            xsd: XSD_SUPPORTED,
+            relaxng: RELAXNG_SUPPORTED,
+            xslt: XSLT_SUPPORTED,
+          }.freeze
+        end
+
         # WeakMap has no #clear — 0.5.100's valve crashed every parse
         # crossing the cap on 3.4+ (NoMethodError). Replace the
         # registry wholesale, type-preserving: the WeakMap flavor

data/lib/moxml/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Moxml
-  VERSION = "0.5.172"
+  VERSION = "0.5.173"
 end

data/spec/moxml/adapter_capabilities_spec.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Processing model §Errors and loud degradation (normative): pinned here.
+
+require "spec_helper"
+
+# The engine capability report (#493): one structured face answering
+# what the installed binding+engine serves — queried once at attach,
+# the replacement for the version-gate-constant class. Only
+# runtime-variable faces appear; anything the floor makes
+# unconditional is absent by design.
+RSpec.describe "engine capability report" do
+  it "answers for leptris with the engine version and known faces" do
+    caps = Moxml::Adapter::Leptris.capabilities
+    expect(caps).to be_frozen
+    expect(caps[:engine_version]).to match(/\A1\.\d+\.\d+/)
+    expect(caps.keys).to include(
+      :native_read_layer, :native_plan_structs, :native_bulk_sax_records,
+      :native_document_parts, :xsd, :relaxng, :xslt, :digest
+    )
+  end
+
+  it "reports only booleans beyond the version" do
+    caps = Moxml::Adapter::Leptris.capabilities
+    caps.except(:engine_version).each_value do |value|
+      expect(value).to eql(true).or eql(false)
+    end
+  end
+
+  it "keeps the unwound internal gates out of the report" do
+    caps = Moxml::Adapter::Leptris.capabilities
+    expect(caps.keys).not_to include(
+      :prefixed_attr_predicates_native, :libxml2_layout_parity,
+      :indent_unit_supported, :element_unit_comments
+    )
+    expect(caps[:xsd]).to be(true)
+    expect(caps[:xslt]).to be(true)
+  end
+
+  it "is memoized — repeated queries answer the same frozen object" do
+    expect(Moxml::Adapter::Leptris.capabilities)
+      .to equal(Moxml::Adapter::Leptris.capabilities)
+  end
+
+  it "answers nil on adapters without a capability story" do
+    expect(Moxml::Adapter::Base.capabilities).to be_nil
+  end
+end

data/spec/support/model_coverage.rb

@@ -113,6 +113,10 @@ module ModelCoverage
       section: "Errors and loud degradation",
       pin: "spec/consistency/loud_degradation_spec.rb",
     },
+    "engine capability report" => {
+      section: "Errors and loud degradation",
+      pin: "spec/moxml/adapter_capabilities_spec.rb",
+    },
   }.freeze
 
   # Normative sections that are not face families (meta/apparatus).

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: moxml
 version: !ruby/object:Gem::Version
-  version: 0.5.172
+  version: 0.5.173
 platform: ruby
 authors:
 - Ribose Inc.
@@ -514,6 +514,7 @@ files:
 - spec/moxml/adapter/rexml_spec.rb
 - spec/moxml/adapter/shared_examples/.gitkeep
 - spec/moxml/adapter/shared_examples/adapter_contract.rb
+- spec/moxml/adapter_capabilities_spec.rb
 - spec/moxml/adapter_deprecation_spec.rb
 - spec/moxml/adapter_registry_spec.rb
 - spec/moxml/adapter_spec.rb