lutaml-model 0.8.113 → 0.8.115

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: be72639a2ee2fd3c23219f19141d43386c4126fbef9fa79fdff322f90bb58660
-  data.tar.gz: 8c88a30cdda640eba02043ba87859a3cda864dcc23addf6a60aeccda63600dff
+  metadata.gz: b924b08953808c53f7f6db9f9832ffa870b11a5d2c7fe450b1340d8b2f289562
+  data.tar.gz: 3ba1f1afe7b2a95e83f137f8d3944e56e0ba516962b261665c4c3b91de74824f
 SHA512:
-  metadata.gz: c5bfd563e53d7664d038da01d677152f3143c510cb1fa2cc56e13d20d5f6f9009251c618091258d58f7b25c45b70ab7c53e6a1fdafdb3a91213da871e3fde875
-  data.tar.gz: a29144bc6c8cc8a3cf466e911b766df00718db916ddd3fc7127de00679f009ebe322407b9b74b509bf8fd4362005c7d85ce6076497d4b1676ab06648ab2a8213
+  metadata.gz: 2d956aca0be2bdbae7e513391962490429057f04ca4371be1477d4bbc29e79f8ad942beffbb40debf27db64f7be7e7c301110832439a3ece8eb4ece5e6c673d9
+  data.tar.gz: 7a384e7b06e927f9b78a129914de369c2befa23b14e84c6a9c2ba24e769c145dd0b0814fa3f92483516132020ced34c885c71872c251d41a8bdc6dff995b41db

data/lib/lutaml/key_value/transform.rb

@@ -687,6 +687,10 @@ partition = nil)
         # attribute is not a collection, so this guard defers exactly that case
         # to `.validate` while leaving declared ranges checked at parse. A mapped
         # PORO has no `.validate` to defer into, so it keeps the eager check.
+        # singular_tolerance: :first on the KV lane (#971): collapse an
+        # over-ingested collection before the writer stores it whole.
+        value = value.first if attr.tolerates_singular_overflow?(value)
+
         if attr.collection? || !instance.is_a?(Lutaml::Model::Serialize)
           attr.valid_collection!(value, context)
         end

data/lib/lutaml/key_value/transformation.rb

@@ -1031,6 +1031,16 @@ child_mappings, options)
                               rule.attribute_type < Lutaml::Model::Serialize
                           end
 
+        if is_nested_model && !value.is_a?(Lutaml::Model::Serialize)
+          # The KV mirror of the XML lane's #971 collapse: a tolerated
+          # singular attribute holding an over-assigned collection
+          # serializes its leading value instead of raising.
+          attr = if model_class.respond_to?(:attributes)
+                   model_class.attributes[rule.attribute_name.to_sym]
+                 end
+          value = value.first if attr&.tolerates_singular_overflow?(value)
+        end
+
         if is_nested_model
           # Validate that value matches the expected type
           # There are three valid cases:

data/lib/lutaml/model/version.rb

@@ -2,6 +2,6 @@
 
 module Lutaml
   module Model
-    VERSION = "0.8.113"
+    VERSION = "0.8.115"
   end
 end

data/lib/lutaml/xml/leptris/plan_serializer.rb

@@ -62,7 +62,12 @@ module Lutaml
             # (namespaced spellings are instance-dependent; ordered,
             # wildcard, raw, and callback shapes are not
             # ops-expressible).
-            return NativeEmission.emit(instance, plan, register) if NativeEmission.compatible?(plan)
+            # element_order is the order contract: a model carrying it —
+            # parse-captured or programmatically tracked (#977) — must
+            # serialize through the ordered walk, not the flat
+            # schema-order native ops layout.
+            return NativeEmission.emit(instance, plan, register) if
+              NativeEmission.compatible?(plan) && instance.element_order.nil?
 
             doc = ::Leptris::XML::Document.create
             ns_ctx = Namespaces.new(instance, plan, register)
@@ -85,7 +90,7 @@ module Lutaml
               root.set_attribute("xsi:schemaLocation",
                                  instance.raw_schema_location)
             end
-            built = if plan[:ordered]
+            built = if plan[:ordered] || !instance.element_order.nil?
                       build_ordered(root, instance, plan, doc, register, ns_ctx)
                     else
                       build(root, instance, plan, doc, register, ns_ctx)
@@ -310,7 +315,7 @@ module Lutaml
                     ns_ctx ? ns_ctx.spell(row_name(rule, spelling), child_ns) : row_name(rule, spelling),
                   )
                   ns_ctx&.collect(child_plan[:tree])
-                  if child_plan[:ordered]
+                  if child_plan[:ordered] || !item.element_order.nil?
                     build_ordered(child, item, child_plan,
                                   doc, reg, ns_ctx, child_ns) || return
                   else
@@ -522,7 +527,7 @@ module Lutaml
                   child = element.create_child(
                     ns_ctx ? ns_ctx.spell(object.name, child_ns) : object.name,
                   )
-                  if child_plan[:ordered]
+                  if child_plan[:ordered] || !item.element_order.nil?
                     return nil unless build_ordered(child, item, child_plan,
                                                     doc, reg, ns_ctx, child_ns)
                   else
@@ -580,7 +585,7 @@ module Lutaml
                   child = element.create_child(
                     ns_ctx ? ns_ctx.spell(name, child_ns) : name,
                   )
-                  if child_plan[:ordered]
+                  if child_plan[:ordered] || !item.element_order.nil?
                     return nil unless build_ordered(child, item, child_plan,
                                                     doc, reg, ns_ctx, child_ns)
                   else

data/lutaml-model.gemspec

@@ -41,7 +41,7 @@ Gem::Specification.new do |spec|
   # 0.5.84 always passes XML_PARSE_HUGE to libxml2: very large documents
   # parse completely instead of being silently truncated at the 10 MB
   # input-buffer cap (lutaml-model#871).
-  spec.add_dependency "moxml", "~> 0.5.84"
+  spec.add_dependency "moxml", "~> 0.5.139"
   spec.add_dependency "ostruct"
   spec.add_dependency "rubyzip", "~> 3.7"
   spec.add_dependency "thor", "~> 1.4"

data/spec/lutaml/model/singular_tolerance_spec.rb

@@ -91,4 +91,69 @@ RSpec.describe "singular_tolerance attribute option" do
       expect(reduced).to eq(value.first)
     end
   end
+
+  describe "on the KeyValue lane" do
+    let(:marked_class) do
+      Class.new(Lutaml::Model::Serializable) do
+        attribute :content, :string
+
+        key_value do
+          map "content", to: :content
+        end
+      end
+    end
+
+    let(:relation_class) do
+      Class.new(Lutaml::Model::Serializable) do
+        attribute :rel_type, :string
+        attribute :description, "ToleranceMarked", singular_tolerance: :first
+
+        key_value do
+          map "type", to: :rel_type
+          map "description", to: :description
+        end
+      end
+    end
+
+    before do
+      stub_const("ToleranceMarked", marked_class)
+      stub_const("ToleranceRelation", relation_class)
+    end
+
+    it "keeps the leading value on ingest instead of the whole array" do
+      model = ToleranceRelation.from_yaml(
+        "---\ntype: cites\ndescription:\n  - content: First\n  - content: Second\n",
+      )
+
+      expect(model.description).to be_a(ToleranceMarked)
+      expect(model.description.content).to eq("First")
+    end
+
+    it "round-trips the collapsed singular through to_yaml" do
+      model = ToleranceRelation.from_yaml(
+        "---\ntype: cites\ndescription:\n  - content: First\n  - content: Second\n",
+      )
+
+      yaml = model.to_yaml
+      expect(yaml).to include("First")
+      expect(yaml).not_to include("Second")
+      expect(ToleranceRelation.from_yaml(yaml).description.content).to eq("First")
+    end
+
+    it "collapses an over-assigned collection at serialization" do
+      model = ToleranceRelation.new(
+        rel_type: "cites",
+        description: [ToleranceMarked.new(content: "One"),
+                      ToleranceMarked.new(content: "Two")],
+      )
+
+      yaml = model.to_yaml
+      expect(yaml).to include("One")
+      expect(yaml).not_to include("Two")
+    end
+  end
 end
+
+# The KV mirror of the XML-lane cases: the YAML lane never consulted
+# the tolerance — ingest stored the whole array and re-serialization
+# raised the mapped-PORO type check.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lutaml-model
 version: !ruby/object:Gem::Version
-  version: 0.8.113
+  version: 0.8.115
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-18 00:00:00.000000000 Z
+date: 2026-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -92,14 +92,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.84
+        version: 0.5.139
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.84
+        version: 0.5.139
 - !ruby/object:Gem::Dependency
   name: ostruct
   requirement: !ruby/object:Gem::Requirement