moxml 0.5.169 → 0.5.170

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6d162a122e231644310d60b9f27eef7f3fa89728a6c135a9eb855d56952af5d
-  data.tar.gz: 7c3c92e7ffe80f35484e364d75808d1a74f4c62db7c1e2222b0d1d2921d3ccac
+  metadata.gz: 68f6b7acd8107269dc0e15246d3990ef57d3afaa0516896c43fa2db3acfc4cc5
+  data.tar.gz: b6511730c2af6f71b66b1a07b118260fc76c6069bd000be29539beb7462522b5
 SHA512:
-  metadata.gz: 4872ca2eb4456ee02a511196840379610f6c66b590d64ba1a4715b6107c33a912056bd6fe48055d1270c274e9aec62193f88778180f57ebe32da3f27961f871c
-  data.tar.gz: 4811ea416c2ebd77ff2cbedf4f640a755424e5ae67d3590c63220fd182eff8ad2fb0c58335ea82f90bb8b9c5bca9f408cb4989256a9c74bb6af5b568ecfc457b
+  metadata.gz: b3c3f675bc7ecc526414d7cf045e33dbbcd14ff4b52794552a7ccd4d69b6efab0e3bf14cf5d56e05e3b48e7852795a6a9181ac15c98504233dac324c0c54a6ec
+  data.tar.gz: 47fdcc6d4e46766f75bf4927b89ae95931d8920e0fc5f8213a48167b2f5b19ded9f1807bbf13c2351e8735e71e3210f7829f913a7bbb2a82781ca88a68405729

data/docs/_pages/model-coverage.adoc

@@ -45,6 +45,7 @@ Generated by `bundle exec rake docs:coverage` from the coverage matrix and the d
 | validation engine metadata | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent
 | validation regex dismissal | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent
 | validation builtin lexical table | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent | equivalent
+| 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
 |===

data/docs/_references/processing-model.adoc

@@ -255,7 +255,7 @@ semantics.
 
 === Validation
 
-Pins:: `spec/moxml/xsd_builtin_lexical_spec.rb`, `spec/moxml/xsd_engine_meta_spec.rb`, `spec/moxml/xsd_regex_spec.rb`, `spec/moxml/xsd_spec.rb`, `spec/moxml/xsd_substitution_spec.rb`, `spec/moxml/xsd_underdetection_spec.rb`, `spec/moxml/xsd_version_spec.rb`
+Pins:: `spec/moxml/xsd_builtin_lexical_spec.rb`, `spec/moxml/xsd_engine_meta_spec.rb`, `spec/moxml/xsd_regex_spec.rb`, `spec/moxml/xsd_set_spec.rb`, `spec/moxml/xsd_spec.rb`, `spec/moxml/xsd_substitution_spec.rb`, `spec/moxml/xsd_underdetection_spec.rb`, `spec/moxml/xsd_version_spec.rb`
 
 XSD validation through engines that ship a validator (libxml2;
 leptris tier-1: recognized roots, one-level content descent, lexical
@@ -265,7 +265,13 @@ spaces (collapse for the token family, the unbounded integer family
 with bignum bounds, calendar and duration grammars, binary, QName
 with the reserved `xmlns` prefix) from the facade's own table on
 every adapter — an engine table converges to it, never the reverse;
-an unknown name raises `ArgumentError`. `validate` returns
+an unknown name raises `ArgumentError`. Schema-set compilation
+compiles a LIST of documents into one schema (`Context#xsd_set`):
+imports resolve across the whole set, so components declared in
+importing documents — substitution-group members, derived types —
+are visible to the head's content models; the single-document
+faces cannot see them. Adapters without a set-capable engine raise
+`Moxml::NotImplementedError`. `validate` returns
 accumulated `ValidationError` entries —
 message always; line/column/path where the engine reports them, nil
 where it does not; `[]` means valid. Documents outside the engine's

data/lib/moxml/adapter/base.rb

@@ -373,6 +373,12 @@ module Moxml
                 "XSD validation requires an adapter with an XSD engine"
         end
 
+        def xsd_compile_set(_paths)
+          raise Moxml::NotImplementedError,
+                "Schema-set compilation requires an XSD engine with the " \
+                "compile_set face"
+        end
+
         def xsd_declarations(_xsd_handle); end
 
         def xsd_compile_error(_xsd_handle); end

data/lib/moxml/adapter/leptris.rb

@@ -372,6 +372,23 @@ module Moxml
           ::Leptris::XML::XSD.compile_file(path)
         end
 
+        # Schema-set compilation (leptris 1.9.387, moxml#483 item 4):
+        # every document compiles into one schema, so imports resolve
+        # across the set and substitution-group members declared in
+        # importing documents are visible to the head's content
+        # models. Path-sourced only — the engine face reads files.
+        def xsd_compile_set(paths)
+          unless XSD_SUPPORTED &&
+              defined?(::Leptris::XML::XSD::Schema) &&
+              ::Leptris::XML::XSD::Schema.respond_to?(:compile_set)
+            raise Moxml::NotImplementedError,
+                  "Schema-set compilation requires the leptris 1.9.387+ " \
+                  "engine (the compile_set face)"
+          end
+
+          ::Leptris::XML::XSD.compile_set(paths)
+        end
+
         def relaxng_compile(schema_source)
           unless RELAXNG_SUPPORTED
             raise Moxml::NotImplementedError,

data/lib/moxml/context.rb

@@ -222,6 +222,24 @@ module Moxml
       Moxml::XSD::Schema.new(handle, self, source)
     end
 
+    # Compile a SET of schema documents (paths) into one schema:
+    # imports resolve across the whole set, so components declared
+    # in importing documents (substitution-group members, derived
+    # types) are visible to the head's content models — the
+    # single-document faces cannot see them (#483 item 4). The
+    # Schema's #version / SchemaRules index read the HEAD document
+    # (the first path); engine-set semantics cover the rest.
+    # Adapters without a set-capable engine raise
+    # Moxml::NotImplementedError.
+    def xsd_set(*paths)
+      paths = paths.first if paths.size == 1 && paths.first.is_a?(Array)
+      raise ArgumentError, "schema set needs at least one path" if paths.empty?
+
+      handle = config.adapter.xsd_compile_set(paths.map(&:to_s))
+      source = File.read(paths.first.to_s)
+      Moxml::XSD::Schema.new(handle, self, source)
+    end
+
     # Compile a RELAX NG schema from source or from a file path (the
     # engine resolves relative includes against the file's directory).
     # Adapters without an RNG engine raise Moxml::NotImplementedError.

data/lib/moxml/version.rb

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

data/spec/moxml/xsd_set_spec.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+# Processing model §Validation (normative): pinned here.
+
+require "spec_helper"
+
+RSpec.describe "Schema-set compilation" do
+  let(:ctx) { Moxml.new(:leptris) }
+
+  # leptris#1881 / moxml#483 item 4: a head document cannot see
+  # substitution-group members declared in schemas that import it;
+  # the set face merges every document into one compilation.
+  def write_set(dir)
+    File.write(File.join(dir, "f.xsd"), <<~XSD)
+      <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
+                 xmlns="urn:F" xmlns:f="urn:F" targetNamespace="urn:F"
+                 elementFormDefault="qualified">
+        <xs:complexType name="foo">
+          <xs:sequence><xs:any/></xs:sequence>
+        </xs:complexType>
+        <xs:element name="foo" type="foo"/>
+        <xs:element name="bar">
+          <xs:complexType>
+            <xs:choice minOccurs="0" maxOccurs="unbounded">
+              <xs:element ref="f:foo"/>
+              <xs:element ref="f:bar"/>
+            </xs:choice>
+          </xs:complexType>
+        </xs:element>
+      </xs:schema>
+    XSD
+    File.write(File.join(dir, "g.xsd"), <<~XSD)
+      <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
+                 xmlns:g="urn:G" xmlns:f="urn:F" targetNamespace="urn:G"
+                 elementFormDefault="qualified">
+        <xs:import namespace="urn:F" schemaLocation="f.xsd"/>
+        <xs:element name="foo1" substitutionGroup="f:foo">
+          <xs:complexType>
+            <xs:complexContent>
+              <xs:extension base="f:foo">
+                <xs:attribute name="x" type="xs:int"/>
+              </xs:extension>
+            </xs:complexContent>
+          </xs:complexType>
+        </xs:element>
+      </xs:schema>
+    XSD
+    [File.join(dir, "f.xsd"), File.join(dir, "g.xsd")]
+  end
+
+  # The binding carries the face from 1.9.386.0 (engine 1.9.387);
+  # published bindings below it loud-fail by contract, so the live
+  # examples skip until the ride lands.
+  def set_capable?
+    defined?(Leptris::XML::XSD::Schema) &&
+      Leptris::XML::XSD::Schema.respond_to?(:compile_set)
+  end
+
+  it "admits substitution members declared in importing documents" do
+    skip "requires the leptris compile_set face (binding 1.9.386.0+)" unless
+      set_capable?
+
+    Dir.mktmpdir do |dir|
+      paths = write_set(dir)
+      schema = ctx.xsd_set(*paths)
+      doc = ctx.parse(
+        '<f:foo xmlns:f="urn:F" xmlns:g="urn:G">' \
+        '<f:bar><g:foo1 x="1"><f:bar/></g:foo1></f:bar></f:foo>',
+      )
+      expect(schema.validate(doc)).to be_empty
+    end
+  end
+
+  it "accepts the paths as an array or as arguments" do
+    skip "requires the leptris compile_set face (binding 1.9.386.0+)" unless
+      set_capable?
+
+    Dir.mktmpdir do |dir|
+      paths = write_set(dir)
+      expect(ctx.xsd_set(paths)).to be_a(Moxml::XSD::Schema)
+      expect(ctx.xsd_set(*paths)).to be_a(Moxml::XSD::Schema)
+    end
+  end
+
+  it "raises on an empty set" do
+    expect { ctx.xsd_set }.to raise_error(ArgumentError)
+  end
+
+  it "raises the named error on adapters without a set-capable engine" do
+    nk = Moxml.new(:nokogiri)
+    Dir.mktmpdir do |dir|
+      paths = write_set(dir)
+      expect { nk.xsd_set(*paths) }
+        .to raise_error(Moxml::NotImplementedError, /compile_set face/)
+    end
+  end
+end

data/spec/support/model_coverage.rb

@@ -101,6 +101,10 @@ module ModelCoverage
       section: "Validation",
       pin: "spec/moxml/xsd_builtin_lexical_spec.rb",
     },
+    "validation schema sets" => {
+      section: "Validation",
+      pin: "spec/moxml/xsd_set_spec.rb",
+    },
     "validation substitution dismissal" => {
       section: "Validation",
       pin: "spec/moxml/xsd_substitution_spec.rb",

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: moxml
 version: !ruby/object:Gem::Version
-  version: 0.5.169
+  version: 0.5.170
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-28 00:00:00.000000000 Z
+date: 2026-10-29 00:00:00.000000000 Z
 dependencies: []
 description: |
   Moxml is a unified XML manipulation library that provides a common API
@@ -638,6 +638,7 @@ files:
 - spec/moxml/xsd_handle_mismatch_spec.rb
 - spec/moxml/xsd_regex_spec.rb
 - spec/moxml/xsd_release_spec.rb
+- spec/moxml/xsd_set_spec.rb
 - spec/moxml/xsd_spec.rb
 - spec/moxml/xsd_substitution_spec.rb
 - spec/moxml/xsd_underdetection_spec.rb