moxml 0.5.172 → 0.5.174

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8719e57bb76ceb63baa171d151028d8aff538fc351be7397b6ec5a492c8bdf1
-  data.tar.gz: 8fa85d23570f0588da0eb5d4ce5f83d59fb28e325d587f7210d3380a8afd5e33
+  metadata.gz: b5f92e477a3f081f711febd54ab9425573ead518fd44ff6341744ce5e421a485
+  data.tar.gz: 1c7f9d77b19a460b90dc6f8ca0cb1af76c3d1a95f36e484d4a56bf2cd7be03c5
 SHA512:
-  metadata.gz: b93fc457a9d7435e2a55cb4fb5e3320d37b5949e77b184c640dd65a8b21954aab9987f204c8916411d9bfe6e11f7f0e358faa78f1ee9cfe3477f52b2d209e857
-  data.tar.gz: 78c66d6b3bdbb800b8cf23dde851235ab3a621bbb30fd0c413db06f9f856ba245b56f9a2c4a4d8220ca313b3bb2ef447d5737733387052bd82f2151cfd7bcdc5
+  metadata.gz: 654e595f1b8e8e847761e670a73565b8ef7b783a09942586bb93ae6199951d192c267359cd6f8c4f7968ed125d593119f5a47b92a04a907505bb7f1b9e1da6d0
+  data.tar.gz: 04f8045e8e42310697de9a141e163a41e1bde33f9a3f9451a463c5f68683e21928cac81770112cd9c30b8c2c0acaaa04a913a7ff212d4a38f660a778eb7b35bb

data/Gemfile

@@ -9,7 +9,7 @@ gemspec
 gem "benchmark"
 gem "benchmark-ips"
 gem "get_process_mem"
-gem "leptris", "~> 1.9.382"
+gem "leptris", "~> 1.9.386"
 gem "libxml-ruby", ">= 5.0"
 gem "nokogiri", "~> 1.18"
 gem "openssl", "~> 3.0"

data/README.adoc

@@ -72,7 +72,7 @@ https://github.com/leptris/leptris-ruby[leptris-ruby] FFI binding
 every measured bulk operation — parse, XPath, serialization, SAX, and
 the compiled Moxml::Plan / Moxml::StructPlan materialization paths
 (StructPlan runs 2.3-2.6x raw Nokogiri on the benchmark shape);
-requires leptris >= 1.9.32 (see version table below).
+requires leptris >= 1.9.386.0 (see version table below).
 
 === Underlying library versions
 
@@ -111,32 +111,18 @@ same libxml2 engine, governed by the consistency suite). Removal
 after the deprecation cycle.
 
 |Leptris (leptris-ruby)
-|>= 1.9.194.1
-|Hard floor — `MINIMUM_BINDING_VERSION`; older bindings do not load.
-Raised from 1.9.32 (2026-09-20): every known consumer resolves a
-modern binding, and the sub-1.9.194 accommodation paths are deleted.
-Newer bindings unlock more native surface automatically:
-1.9.194.1+ hot-read aliases, 1.9.201.1+ the C struct
-executor (`Moxml::StructPlan`; the floor is the varargs-mint fix),
-1.9.204+ native document-level parts (created DOCTYPEs as native
-nodes, document-PI removal, declaration clear), 1.9.240+ the bulk
-SAX record drain (`Handler#on_sax_records`) — and 1.9.242+ is
-REQUIRED for that drain to be CORRECT: 1.9.240/241 drain documents
-containing duplicate attributes without surfacing the fatal error
-(moxml#281), so the drain arms only on 1.9.242+, where such
-documents fall back to the callback path and the error fires.
-1.9.255.2+ C-minted walk/build wrappers (construction identity
-without the Ruby mint); 1.9.273.1+ opt-in parse-skip flags
-(`skip_dup_detection`, `skip_source_positions`); 1.9.290.0+ XSLT
-top-level params threading and the bulk child-list append
-(one crossing for N children); 1.9.292.0+ native cross-document
-root adoption (the engine deep-copies a foreign root in C).
-Current recommendation: 1.9.292+ (the native-adoption train;
-carries the plan-ABI surface, the 1.9.290 XSLT-params and
-bulk-append faces, and the 1.9.292 engine deep-copy root install).
+|>= 1.9.386.0
+|ENFORCED hard floor — `MINIMUM_BINDING_VERSION`; the adapter refuses
+to load below it. Raised 1.9.32 → 1.9.194.1 (2026-09-20) → 1.9.386.0
+(2026-10-30, the tested pair): every accommodation path below it is
+deleted and all native faces through the 1.9.385 parent-axis train
+are unconditional. The capability report
+(`Moxml::Adapter::Leptris.capabilities`) answers what the installed
+pair serves; cross-import schema sets (`Context#xsd_set`) ride the
+compile_set face (1.9.386.0 ✓).
 |===
 
-NOTE: moxml's dev Gemfile pins `leptris ~> 1.9.321` (the tested pair; the gemspec itself has zero runtime dependencies). Consumers of the leptris adapter should run leptris 1.9.320+ — earlier engines carry silent wrong-answer plan-path defects (moxml#344); moxml gates degrade to the always-correct slower paths below it.
+NOTE: moxml's dev Gemfile pins `leptris ~> 1.9.386` (the tested pair; the gemspec itself has zero runtime dependencies). The adapter enforces the floor at load.
 `ox ~> 2.14`, `libxml-ruby >= 5.0`, and the vendored oga fork — the CI
 matrix tests exactly those floors.
 
@@ -147,7 +133,7 @@ the runtime environment:
 
 . If running on Opal (`RUBY_ENGINE == "opal"`), Oga is used (pure Ruby, no C extensions)
 . Otherwise, if the installed leptris gem supports programmatic document
-  construction (`Leptris::XML::Document.create`, leptris >= 1.9.32), Leptris is used
+  construction (`Leptris::XML::Document.create`, leptris >= 1.9.386.0), Leptris is used
 . Otherwise, Moxml detects already-loaded XML libraries in this order:
   .. Nokogiri
   .. Ox
@@ -158,7 +144,7 @@ the runtime environment:
 ----
 # Automatic detection — picks the best available adapter
 ctx = Moxml.new
-ctx.config.adapter_name  # => :leptris (leptris >= 1.9.32), :nokogiri otherwise, :oga on Opal
+ctx.config.adapter_name  # => :leptris (leptris >= 1.9.386.0), :nokogiri otherwise, :oga on Opal
 
 # Explicit override — always takes precedence
 ctx = Moxml.new(:ox)

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

@@ -29,7 +29,22 @@ module Moxml
       # Raised 1.9.32 -> 1.9.194.1 (2026-09-20): every known consumer
       # resolves a modern binding (canon itself pins ~> 1.9.193), and
       # the sub-1.9.194 accommodation paths are deleted.
-      MINIMUM_BINDING_VERSION = "1.9.194.1"
+      # Raised 1.9.194.1 -> 1.9.386.0 (2026-10-30, owner directive
+      # "raise all floors"): the tested pair — every gate below it
+      # unwound, and the floor is ENFORCED (the load refuses below it;
+      # the README's "older bindings do not load" claim is now true).
+      MINIMUM_BINDING_VERSION = "1.9.386.0"
+
+      if Gem::Version.new(::Leptris::VERSION.to_s) <
+          Gem::Version.new(MINIMUM_BINDING_VERSION)
+        raise Moxml::AdapterError.new(
+          "the leptris binding is #{::Leptris::VERSION}; moxml requires " \
+          ">= #{MINIMUM_BINDING_VERSION} (the tested floor — older " \
+          "bindings are untested and their accommodation paths are deleted)",
+          adapter: :leptris,
+          operation: "load",
+        )
+      end
 
       # leptris_parse_html_string shipped in bindings 1.9.80
       # (libleptris 1.9.75, engine #659) as Leptris::XML.parse_html.
@@ -193,8 +208,7 @@ module Moxml
       # so the gate names the first release where the drain is
       # CORRECT, not merely present. Dev floor pins ~> 1.9.238;
       # older bindings take the callback Parser below.
-      NATIVE_SAX_RECORDS =
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.242")
+      NATIVE_SAX_RECORDS = true
 
       # Document#absorb (engine #1548): one call transfers a source
       # document's pool ownership into the destination, so
@@ -208,8 +222,7 @@ module Moxml
       # lesson).
       NATIVE_DOC_ABSORB =
         defined?(::Leptris::XML::Document) &&
-        ::Leptris::XML::Document.method_defined?(:absorb) &&
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.311.3")
+        ::Leptris::XML::Document.method_defined?(:absorb)
 
       # Document#to_html indent kwargs (issue #354, engine
       # leptris#1637 via leptris-ruby#421): the nested HTML layout
@@ -218,7 +231,6 @@ module Moxml
       # to_html takes no kwargs and would raise ArgumentError from
       # the pass-through.
       HTML_SERIALIZE_INDENT =
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.338.0") &&
         defined?(::Leptris::XML::Document) &&
         ::Leptris::XML::Document.method_defined?(:to_html) &&
         ::Leptris::XML::Document.instance_method(:to_html)
@@ -240,7 +252,6 @@ module Moxml
       # the rescue-to-empty fallback. The kwarg probe pairs the
       # floor (a binding without the kwarg cannot arm).
       RECOVER_MODE =
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.344.0") &&
         ::Leptris::XML::ParseOptions.instance_method(:initialize)
           .parameters.any? { |_, key| key == :recover }
 
@@ -250,7 +261,6 @@ module Moxml
       # per-attribute reads behind ::Leptris::XML::Element
       # #attribute_pairs.
       ELEMENT_ATTR_SNAPSHOT =
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.353.0") &&
         ::Leptris::XML::Element.method_defined?(:attributes_snapshot)
 
       # Markup-accumulating builder face (leptris-ruby#374 lever 2,
@@ -263,7 +273,6 @@ module Moxml
       # pairs the gate (misrelease races — NATIVE_PLAN_STRUCTS
       # lesson).
       NATIVE_XSD =
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.321.0") &&
         defined?(::Leptris::XML::XSD) &&
         ::Leptris::XML::FFI.respond_to?(:leptris_xsd_validate)
 
@@ -284,15 +293,13 @@ module Moxml
       # finalizer and frees now. Face-probed with the version
       # floor (the NATIVE_DOC_ABSORB pairing).
       XSD_RELEASE =
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.342.0") &&
         defined?(::Leptris::XML::XSD::Schema) &&
         ::Leptris::XML::XSD::Schema.method_defined?(:release)
 
       NATIVE_BUILDER =
         defined?(::Leptris::XML::Builder) &&
         defined?(::Leptris::XML::Document) &&
-        ::Leptris::XML::Document.method_defined?(:build) &&
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.313.0")
+        ::Leptris::XML::Document.method_defined?(:build)
 
       # XSLT 1.0/2.0/3.0 through the engine's compiled-stylesheet
       # faces (Moxml::XSLT contract). Top-level parameters are not
@@ -320,6 +327,34 @@ 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_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
@@ -546,9 +581,7 @@ module Moxml
         # there.
         NATIVE_IDENTITY = NATIVE_MUTATIONS_COHERENT
 
-        NATIVE_C_MINT =
-          NATIVE_IDENTITY &&
-          Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.255.2")
+        NATIVE_C_MINT = NATIVE_IDENTITY
 
         NATIVE_KLASS_CHILDREN = NATIVE_IDENTITY
       end
@@ -1007,7 +1040,6 @@ module Moxml
       # of NoMethodError-ing — the 1.9.199.0 lesson).
       NATIVE_XSLT_PARAMS =
         NATIVE_READ_LAYER &&
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.290.0") &&
         ::Leptris::XML::XSLT::Stylesheet.instance_method(:apply_to)
           .parameters.size > 1
 
@@ -1177,8 +1209,7 @@ module Moxml
       # SILENT wrong answers, so the gate names the fixed engine:
       # below 1.9.320.0 the plan faces degrade to the
       # always-correct generic wrapper walk.
-      NATIVE_PLAN_ROWS =
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.320.0")
+      NATIVE_PLAN_ROWS = true
 
       # leptris-ruby#272 (binding 1.9.201.1): Native.plan_structs —
       # the C struct executor behind Moxml::StructPlan. The floor
@@ -1193,9 +1224,8 @@ module Moxml
       # captures) — the struct executor degrades to the Ruby Plan
       # fallback below the fix, same as the varargs-mint floor.
       NATIVE_PLAN_STRUCTS =
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.320.0") &&
-        (!defined?(::Leptris::XML::Native) ||
-         ::Leptris::XML::Native.respond_to?(:plan_structs))
+        !defined?(::Leptris::XML::Native) ||
+        ::Leptris::XML::Native.respond_to?(:plan_structs)
 
       # leptris-ruby#275 (binding 1.9.204, the remove half of the
       # document-level surfaces): remove_pi, clear_declaration,
@@ -1211,7 +1241,6 @@ module Moxml
         ::Leptris::XML::Native.respond_to?(:plan_structs_typed?)
 
       NATIVE_DOC_PARTS =
-        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.204.0") &&
         ::Leptris::XML::Document.method_defined?(:remove_doctype) &&
         ::Leptris::XML::Document.method_defined?(:clear_declaration)
 
@@ -2259,9 +2288,7 @@ module Moxml
           end
         end
 
-        NATIVE_ROOT_ADOPT =
-          NATIVE_READ_LAYER &&
-          Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.292.0")
+        NATIVE_ROOT_ADOPT = NATIVE_READ_LAYER
 
         # The engine deep-copies the foreign subtree into the target
         # document's pool (leptris#1495) and the binding memoizes the
@@ -3406,9 +3433,7 @@ module Moxml
           end
         end
 
-        NATIVE_APPEND_CHILDREN =
-          NATIVE_READ_LAYER &&
-          Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.290.0")
+        NATIVE_APPEND_CHILDREN = NATIVE_READ_LAYER
 
         def replace_children(node, new_children)
           # Cross-pool children: the binding's bulk face adopts per
@@ -3862,8 +3887,7 @@ module Moxml
         # (parent-of-attribute names the OWNER element) plus the
         # cross-doc adopt attribute-chain fix, and standoc's svg
         # id cleanup rides `./@id/..` hot (moxml#474).
-        PARENT_AXIS_NATIVE =
-          Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.385")
+        PARENT_AXIS_NATIVE = true
         NON_PARENT_REVERSE_AXES = %w[ancestor ancestor-or-self
                                      preceding preceding-sibling].freeze
         REVERSE_AXIS_CACHE = XPath::Cache.new(200)

data/lib/moxml/version.rb

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

data/spec/moxml/adapter/platform_spec.rb

@@ -93,11 +93,11 @@ RSpec.describe Moxml::Adapter do
       end
     end
 
-    it "pins the leptris binding floor at 1.9.194.1 (issue #149; raised 2026-09-20)" do
+    it "pins the leptris binding floor at 1.9.386.0 (raised 2026-09-20, raised again 2026-10-30; enforced at load)" do
       skip "leptris not installed" unless described_class.available?(:leptris)
 
       adapter = described_class.load(:leptris)
-      expect(adapter::MINIMUM_BINDING_VERSION).to eq("1.9.194.1")
+      expect(adapter::MINIMUM_BINDING_VERSION).to eq("1.9.386.0")
       expect(Gem::Version.new(Leptris::VERSION))
         .to be >= Gem::Version.new(adapter::MINIMUM_BINDING_VERSION)
     end

data/spec/moxml/adapter_capabilities_spec.rb

@@ -0,0 +1,49 @@
+# 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_plan_typed,
+      :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,
+      :native_bulk_sax_records, :native_document_parts, :native_plan_rows
+    )
+    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.174
 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