moxml 0.5.171 → 0.5.173

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd5e790791e306829e87770a45424b006c9a535c95c825adfc7d0800816ceb7d
-  data.tar.gz: c3348f9fb7c6c0ccf00ab4bc16bba51b0812331d12d8478d2a77e09b8a600e58
+  metadata.gz: be4403ff94123c6d65bf53402d99fee7462bd4d3e9c3ae34f87ff43170fddc29
+  data.tar.gz: 642a836819599fc943103d87d0148cf34e40544d94cf376b4d2d74e5d65bc25e
 SHA512:
-  metadata.gz: 2972a94dc0bf75896d29432c1856b949090cbd8547b60c402376f2d715c743c8e029af2181531fbd327d6615a3a6aef5cb83144c5ff2b6389f35bd3ab6dfea59
-  data.tar.gz: c89e1be189130b17f0a7f61c67c9caba0624f589c29a2407effba7fb50da72304d33db77001185cb7b079729a7a29140d32e8a492269a58cf748a8e99f0276a2
+  metadata.gz: 0ac3bb7ae1148c02ed3c9812c448c8a20e521854f201c20ef22a22dbbc4cd9c12f01d0d1ea4d19f29d4f35f6781d83ace0d4db88957877a8758a621c4b720ecb
+  data.tar.gz: 2513f3da33f3b1836276b51428e9db7e814416db761bcaa3813bf0fd326851359e5a3cc6bb2e62401f0bbbf0aaa44b44dc7992dbb58a4bc475849cc659dd720d

data/Rakefile

@@ -350,4 +350,27 @@ namespace :docs do
   end
 end
 
+namespace :conformance do
+  desc "Export the cross-language conformance dataset to JSON (#496)"
+  task :export do
+    require "json"
+    require_relative "lib/moxml"
+    dataset = Moxml::XSD::BuiltinLexical::CONFORMANCE_CASES
+    payload = {
+      schema: 1,
+      generator: "moxml #{Moxml::VERSION}",
+      cases: {
+        "builtin_lexical" => dataset.map do |type, lexical, expected|
+          { "type" => type, "lexical" => lexical, "valid" => expected }
+        end,
+      },
+    }
+    dir = File.expand_path("conformance", __dir__)
+    FileUtils.mkdir_p(dir)
+    target = File.join(dir, "moxml-conformance.json")
+    File.write(target, "#{JSON.pretty_generate(payload)}\n")
+    puts "conformance: exported #{dataset.size} cases to #{target}"
+  end
+end
+
 task default: :spec

data/conformance/moxml-conformance.json

@@ -0,0 +1,413 @@
+{
+  "schema": 1,
+  "generator": "moxml 0.5.171",
+  "cases": {
+    "builtin_lexical": [
+      {
+        "type": "xs:token",
+        "lexical": "a  b",
+        "valid": true
+      },
+      {
+        "type": "xs:ID",
+        "lexical": " id ",
+        "valid": true
+      },
+      {
+        "type": "xs:NMTOKEN",
+        "lexical": "\tx ",
+        "valid": true
+      },
+      {
+        "type": "xs:ID",
+        "lexical": "1d",
+        "valid": false
+      },
+      {
+        "type": "xs:integer",
+        "lexical": "11111111111111111111111111111",
+        "valid": true
+      },
+      {
+        "type": "xs:positiveInteger",
+        "lexical": "11111111111111111111111111111",
+        "valid": true
+      },
+      {
+        "type": "xs:nonNegativeInteger",
+        "lexical": "11111111111111111111111111111",
+        "valid": true
+      },
+      {
+        "type": "xs:negativeInteger",
+        "lexical": "-100000000000000000000",
+        "valid": true
+      },
+      {
+        "type": "xs:nonPositiveInteger",
+        "lexical": "0",
+        "valid": true
+      },
+      {
+        "type": "xs:nonPositiveInteger",
+        "lexical": "-0",
+        "valid": true
+      },
+      {
+        "type": "xs:long",
+        "lexical": "9223372036854775807",
+        "valid": true
+      },
+      {
+        "type": "xs:long",
+        "lexical": "9223372036854775808",
+        "valid": false
+      },
+      {
+        "type": "xs:unsignedLong",
+        "lexical": "18446744073709551615",
+        "valid": true
+      },
+      {
+        "type": "xs:unsignedLong",
+        "lexical": "18446744073709551616",
+        "valid": false
+      },
+      {
+        "type": "xs:byte",
+        "lexical": "128",
+        "valid": false
+      },
+      {
+        "type": "xs:unsignedByte",
+        "lexical": "256",
+        "valid": false
+      },
+      {
+        "type": "xs:float",
+        "lexical": "+INF",
+        "valid": true
+      },
+      {
+        "type": "xs:double",
+        "lexical": "-INF",
+        "valid": true
+      },
+      {
+        "type": "xs:float",
+        "lexical": "NaN",
+        "valid": true
+      },
+      {
+        "type": "xs:float",
+        "lexical": "1.5E-3",
+        "valid": true
+      },
+      {
+        "type": "xs:decimal",
+        "lexical": "5.",
+        "valid": true
+      },
+      {
+        "type": "xs:decimal",
+        "lexical": ".5",
+        "valid": true
+      },
+      {
+        "type": "xs:decimal",
+        "lexical": "1e3",
+        "valid": false
+      },
+      {
+        "type": "xs:date",
+        "lexical": "2024-02-29",
+        "valid": true
+      },
+      {
+        "type": "xs:date",
+        "lexical": "1999-02-29",
+        "valid": false
+      },
+      {
+        "type": "xs:date",
+        "lexical": "2024-04-31",
+        "valid": false
+      },
+      {
+        "type": "xs:date",
+        "lexical": "2024-13-01",
+        "valid": false
+      },
+      {
+        "type": "xs:date",
+        "lexical": "not-a-date",
+        "valid": false
+      },
+      {
+        "type": "xs:dateTime",
+        "lexical": "2024-02-29T23:59:59Z",
+        "valid": true
+      },
+      {
+        "type": "xs:dateTime",
+        "lexical": "1999-02-29T00:00:00",
+        "valid": false
+      },
+      {
+        "type": "xs:dateTime",
+        "lexical": "not-a-date",
+        "valid": false
+      },
+      {
+        "type": "xs:dateTimeStamp",
+        "lexical": "2024-02-29T00:00:00Z",
+        "valid": true
+      },
+      {
+        "type": "xs:dateTimeStamp",
+        "lexical": "2024-02-29T00:00:00",
+        "valid": false
+      },
+      {
+        "type": "xs:time",
+        "lexical": "23:59:59.999+05:30",
+        "valid": true
+      },
+      {
+        "type": "xs:time",
+        "lexical": "24:00:00",
+        "valid": false
+      },
+      {
+        "type": "xs:time",
+        "lexical": "25:20:00",
+        "valid": false
+      },
+      {
+        "type": "xs:time",
+        "lexical": "13:20:60",
+        "valid": false
+      },
+      {
+        "type": "xs:gYearMonth",
+        "lexical": "2024-02Z",
+        "valid": true
+      },
+      {
+        "type": "xs:gYearMonth",
+        "lexical": "2024-13",
+        "valid": false
+      },
+      {
+        "type": "xs:gMonthDay",
+        "lexical": "--02-29",
+        "valid": true
+      },
+      {
+        "type": "xs:gMonthDay",
+        "lexical": "--02-30",
+        "valid": false
+      },
+      {
+        "type": "xs:gDay",
+        "lexical": "---31",
+        "valid": true
+      },
+      {
+        "type": "xs:gDay",
+        "lexical": "---32",
+        "valid": false
+      },
+      {
+        "type": "xs:duration",
+        "lexical": "P1Y2M3DT4H5M6.5S",
+        "valid": true
+      },
+      {
+        "type": "xs:duration",
+        "lexical": "PT0S",
+        "valid": true
+      },
+      {
+        "type": "xs:duration",
+        "lexical": "-P1D",
+        "valid": true
+      },
+      {
+        "type": "xs:duration",
+        "lexical": "P",
+        "valid": false
+      },
+      {
+        "type": "xs:duration",
+        "lexical": "PT",
+        "valid": false
+      },
+      {
+        "type": "xs:duration",
+        "lexical": "P1Y2MT",
+        "valid": false
+      },
+      {
+        "type": "xs:duration",
+        "lexical": "P200.5Y",
+        "valid": false
+      },
+      {
+        "type": "xs:dayTimeDuration",
+        "lexical": "P1DT2H",
+        "valid": true
+      },
+      {
+        "type": "xs:dayTimeDuration",
+        "lexical": "P1Y",
+        "valid": false
+      },
+      {
+        "type": "xs:yearMonthDuration",
+        "lexical": "P1Y2M",
+        "valid": true
+      },
+      {
+        "type": "xs:yearMonthDuration",
+        "lexical": "P1D",
+        "valid": false
+      },
+      {
+        "type": "xs:yearMonthDuration",
+        "lexical": "P1YT1H",
+        "valid": false
+      },
+      {
+        "type": "xs:base64Binary",
+        "lexical": "aGVsbG8=",
+        "valid": true
+      },
+      {
+        "type": "xs:base64Binary",
+        "lexical": "abcd",
+        "valid": true
+      },
+      {
+        "type": "xs:base64Binary",
+        "lexical": "abcde",
+        "valid": false
+      },
+      {
+        "type": "xs:base64Binary",
+        "lexical": "a b",
+        "valid": false
+      },
+      {
+        "type": "xs:hexBinary",
+        "lexical": "0A",
+        "valid": true
+      },
+      {
+        "type": "xs:hexBinary",
+        "lexical": "0AB",
+        "valid": false
+      },
+      {
+        "type": "xs:QName",
+        "lexical": "foo",
+        "valid": true
+      },
+      {
+        "type": "xs:QName",
+        "lexical": "ns:foo",
+        "valid": true
+      },
+      {
+        "type": "xs:QName",
+        "lexical": "xmlns:xsi",
+        "valid": false
+      },
+      {
+        "type": "xs:QName",
+        "lexical": ":foo",
+        "valid": false
+      },
+      {
+        "type": "xs:QName",
+        "lexical": "a:b:c",
+        "valid": false
+      },
+      {
+        "type": "xs:NOTATION",
+        "lexical": "foo",
+        "valid": true
+      },
+      {
+        "type": "xs:IDREFS",
+        "lexical": "a b",
+        "valid": true
+      },
+      {
+        "type": "xs:IDREFS",
+        "lexical": "a",
+        "valid": true
+      },
+      {
+        "type": "xs:IDREFS",
+        "lexical": "",
+        "valid": false
+      },
+      {
+        "type": "xs:NMTOKENS",
+        "lexical": "a.b-c:d e",
+        "valid": true
+      },
+      {
+        "type": "xs:ENTITIES",
+        "lexical": "a 1",
+        "valid": false
+      },
+      {
+        "type": "xs:string",
+        "lexical": "anything <>&",
+        "valid": true
+      },
+      {
+        "type": "xs:anyURI",
+        "lexical": "http://example.com/a b",
+        "valid": true
+      },
+      {
+        "type": "xs:boolean",
+        "lexical": "true",
+        "valid": true
+      },
+      {
+        "type": "xs:boolean",
+        "lexical": "0",
+        "valid": true
+      },
+      {
+        "type": "xs:boolean",
+        "lexical": "TRUE",
+        "valid": false
+      },
+      {
+        "type": "xs:language",
+        "lexical": "en-US",
+        "valid": true
+      },
+      {
+        "type": "xs:language",
+        "lexical": "en_US",
+        "valid": false
+      },
+      {
+        "type": "xs:Name",
+        "lexical": "a:b",
+        "valid": true
+      },
+      {
+        "type": "xs:NCName",
+        "lexical": "a:b",
+        "valid": false
+      }
+    ]
+  }
+}

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/customized_leptris/declaration.rb

@@ -1,5 +1,14 @@
 # frozen_string_literal: true
 
+# Wrapper for an XML declaration.
+#
+# Lifecycle record: libleptris models the declaration as document-state
+# flags — setters shipped (leptris#1094) and clear shipped
+# (leptris#1229, binding 1.9.204.0) — but there is still no first-class
+# declaration NODE, so the facade keeps this mutable, removable value
+# object as the node stand-in. Dissolves when libleptris exposes
+# declaration node identity (leptris#1904's successor surface).
+
 module Moxml
   module Adapter
     module CustomizedLeptris

data/lib/moxml/adapter/customized_leptris/doctype.rb

@@ -1,5 +1,13 @@
 # frozen_string_literal: true
 
+# Wrapper for a programmatic DOCTYPE.
+#
+# Lifecycle record: set shipped (leptris#212, binding 1.9.176) and unset
+# shipped (leptris#1229, binding 1.9.204.0 remove_doctype), but there is
+# still no first-class DOCTYPE NODE — the facade keeps this value object
+# as the node stand-in in the document's attachments. Dissolves with
+# declaration node identity (see customized_leptris/declaration.rb).
+
 module Moxml
   module Adapter
     module CustomizedLeptris

data/lib/moxml/adapter/customized_leptris/entity_reference.rb

@@ -1,5 +1,13 @@
 # frozen_string_literal: true
 
+# Parse-path face: libleptris expands the five built-in entities at
+# parse time and has no custom ones, so parsed references are carried
+# as Moxml::Entity::Reference values over marker-bearing text.
+# Programmatic creation is native (NATIVE_ENTITY_REFS, binding >= 1.9.177).
+#
+# Lifecycle record: dissolves when parse-time entity reference retention
+# ships — leptris#1904 (references as nodes or bulk positions).
+
 module Moxml
   module Adapter
     module CustomizedLeptris

data/lib/moxml/adapter/customized_leptris/text_segment.rb

@@ -1,5 +1,13 @@
 # frozen_string_literal: true
 
+# A text run split out of a native text node that carried entity
+# markers. Value object: the moxml contract exposes text nodes as
+# separate children around entity references, while libleptris stores
+# them as one marker-bearing text node.
+#
+# Lifecycle record: dissolves with entity reference retention —
+# leptris#1904 (see customized_leptris/entity_reference.rb).
+
 module Moxml
   module Adapter
     module CustomizedLeptris

data/lib/moxml/adapter/customized_leptris.rb

@@ -7,6 +7,11 @@ module Moxml
     # and document-level processing instructions.
     # The adapter stores them via NativeAttachment and serializes them
     # from #to_xml.
+    #
+    # Lifecycle record (#495): a tracked shim, not an adapter-fate
+    # case — the parse-time entity-retention gap is the last engine
+    # ask of the #275 mutation-completion round; when the engine ships
+    # native retention these classes dissolve into Base.
     module CustomizedLeptris
       autoload :Declaration, "moxml/adapter/customized_leptris/declaration"
       autoload :Doctype, "moxml/adapter/customized_leptris/doctype"

data/lib/moxml/adapter/customized_libxml/cdata.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# Lifecycle record: the :libxml adapter is deprecated (#491); this wrapper dies with it.
+
 module Moxml
   module Adapter
     module CustomizedLibxml

data/lib/moxml/adapter/customized_libxml/comment.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# Lifecycle record: the :libxml adapter is deprecated (#491); this wrapper dies with it.
+
 module Moxml
   module Adapter
     module CustomizedLibxml

data/lib/moxml/adapter/customized_libxml/declaration.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# Lifecycle record: the :libxml adapter is deprecated (#491); this wrapper dies with it.
+
 module Moxml
   module Adapter
     module CustomizedLibxml

data/lib/moxml/adapter/customized_libxml/element.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# Lifecycle record: the :libxml adapter is deprecated (#491); this wrapper dies with it.
+
 module Moxml
   module Adapter
     module CustomizedLibxml

data/lib/moxml/adapter/customized_libxml/entity_reference.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# Lifecycle record: the :libxml adapter is deprecated (#491); this wrapper dies with it.
+
 module Moxml
   module Adapter
     module CustomizedLibxml

data/lib/moxml/adapter/customized_libxml/node.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# Lifecycle record: the :libxml adapter is deprecated (#491); this wrapper dies with it.
+
 module Moxml
   module Adapter
     module CustomizedLibxml

data/lib/moxml/adapter/customized_libxml/processing_instruction.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# Lifecycle record: the :libxml adapter is deprecated (#491); this wrapper dies with it.
+
 module Moxml
   module Adapter
     module CustomizedLibxml

data/lib/moxml/adapter/customized_libxml/text.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# Lifecycle record: the :libxml adapter is deprecated (#491); this wrapper dies with it.
+
 module Moxml
   module Adapter
     module CustomizedLibxml

data/lib/moxml/adapter/customized_libxml.rb

@@ -2,6 +2,9 @@
 
 module Moxml
   module Adapter
+    # Lifecycle record (#495): engine-gap shims for the :libxml
+    # adapter, deprecated in moxml#491 -- removed with it after the
+    # cycle. No separate upstream ask; the adapter's fate governs.
     module CustomizedLibxml
       autoload :Cdata, "moxml/adapter/customized_libxml/cdata"
       autoload :Comment, "moxml/adapter/customized_libxml/comment"

data/lib/moxml/adapter/customized_oga/entity_decoder.rb

@@ -1,5 +1,13 @@
 # frozen_string_literal: true
 
+# Override Oga::EntityDecoder.decode for XML inputs.
+#
+# Engine gap (upstream oga): Oga 3.4's stock Oga::XML::Entities.decode
+# runs multiple passes, turning the well-formed "&" into "&"
+# rather than the correct "&". Upstream tracker:
+# https://github.com/yorickpeterse/oga — the override stays until oga
+# fixes the decoder or the adapter is retired.
+
 require "oga"
 
 module Moxml

data/lib/moxml/adapter/customized_oga/raw_value_override.rb

@@ -1,5 +1,13 @@
 # frozen_string_literal: true
 
+# Bypass Oga's lazy decoder for user-authored values.
+#
+# Engine gap (upstream oga): Oga::XML::Attribute#value and
+# Oga::XML::Text#text decode @value/@text on first read via
+# Oga::EntityDecoder; EntityDecoderOverride (this directory) must hold
+# user-authored raw values. Upstream tracker:
+# https://github.com/yorickpeterse/oga
+
 require "oga"
 
 module Moxml