lutaml-model 0.8.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c756e06ffeedb744a2c6dc3168e678770e105d856c0373340bfb91999a3e0d0d
-  data.tar.gz: b73daf9b28bc1e6920975a51cb55cdd15255421249e2b130f648e4989d8c7f92
+  metadata.gz: 7e243cd9c18fd7a9e9d16c246265f18a5088096093527bb78c860198621040c1
+  data.tar.gz: 2eb85ccf7aac11cb6fe202291db84d43c5e32485f1cc32e28679f559e996943e
 SHA512:
-  metadata.gz: 05d5cb08e286dac1099ff9c591e62358609059dc42e4f97b5b7b41f5e638fc1d27b81437729980d8477a946fa4eac43f895da316dfc3ae7916af12e3a70b9074
-  data.tar.gz: 39d87718bc1687710b447618c547e567c6d324f05759000439343a450c3ce4cf7e327250654776066547dee768b9cf9dc0a7992a02969627930046f2bf95b815
+  metadata.gz: 541667a09503edffcc498190f7d845c362168e375928b4f0b9341568e057fd8eab4e00c33cb9d495ee6e853caa935d46e3fb0e9f4985758019bc4ab319350171
+  data.tar.gz: 342dc3142ac6e68c1bff66956ccdd5a23978253abcab734ffe503534b4205fb7a02f7b2e18603c53f1cc976eb4e907636326acde7653563ff3e000dbc12c40a0

data/.github/workflows/dependent-repos.json

@@ -4,22 +4,31 @@
     "glossarist/iev",
     "glossarist/termium",
     "lutaml/genericode",
+    "lutaml/hyperlang",
+    "lutaml/lutaml-hal",
     "lutaml/lutaml-xsd",
     "lutaml/metaschema",
     "lutaml/ogc-gml",
+    "lutaml/reqif",
+    "lutaml/rng",
+    "lutaml/unibuf",
     "lutaml/xmi",
     "metanorma/atmospheric",
+    "metanorma/docbook",
     "metanorma/metanorma-cli",
     "metanorma/modspec-ruby",
     "metanorma/niso-jats",
+    "metanorma/prosereflect",
     "metanorma/revix",
     "metanorma/rfcxml",
     "metanorma/sts-ruby",
+    "metanorma/uniword",
     "plurimath/mml",
     "plurimath/plurimath",
     "relaton/ieee-idams",
     "relaton/loc_mods",
     "relaton/w3c_api",
+    "ukiryu/ukiryu",
     "unitsml/unitsml-ruby"
   ]
 }

data/.github/workflows/downstream-performance.yml

@@ -38,9 +38,6 @@ jobs:
           - downstream: unitsml
             repo: unitsml/unitsml-ruby
             env_key: UNITSML_DIR
-          - downstream: uniword
-            repo: lutaml/uniword
-            env_key: UNIWORD_DIR
     steps:
       - uses: actions/checkout@v6
         with:

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-01 09:59:35 UTC using RuboCop version 1.86.0.
+# on 2026-05-03 14:18:01 UTC using RuboCop version 1.86.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -11,149 +11,13 @@ Gemspec/RequiredRubyVersion:
   Exclude:
     - 'lutaml-model.gemspec'
 
-# Offense count: 15
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: with_first_argument, with_fixed_indentation
-Layout/ArgumentAlignment:
-  Exclude:
-    - 'lib/lutaml/model/configuration.rb'
-    - 'lib/lutaml/model/instrumentation.rb'
-    - 'lib/lutaml/xml/schema/xsd/schema.rb'
-    - 'lib/lutaml/xml/schema/xsd/schema_path.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/complex_type_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/containers_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/element_spec.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: with_first_element, with_fixed_indentation
-Layout/ArrayAlignment:
-  Exclude:
-    - 'lib/lutaml/xml/schema/xsd/base.rb'
-
-# Offense count: 40
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleAlignWith.
-# SupportedStylesAlignWith: either, start_of_block, start_of_line
-Layout/BlockAlignment:
-  Exclude:
-    - 'lib/lutaml/xml/schema/xsd/complex_type.rb'
-    - 'lib/lutaml/xml/schema/xsd/element.rb'
-    - 'lib/lutaml/xml/schema/xsd/schema.rb'
-    - 'spec/lutaml/key_value/transformation_spec.rb'
-    - 'spec/lutaml/model/cached_type_resolver_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/attribute_and_group_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/complex_type_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/containers_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/element_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/simple_content_spec.rb'
-
-# Offense count: 32
-# This cop supports safe autocorrection (--autocorrect).
-Layout/BlockEndNewline:
-  Exclude:
-    - 'lib/lutaml/xml/schema/xsd/complex_type.rb'
-    - 'lib/lutaml/xml/schema/xsd/element.rb'
-    - 'lib/lutaml/xml/schema/xsd/schema.rb'
-    - 'spec/lutaml/key_value/transformation_spec.rb'
-    - 'spec/lutaml/model/cached_type_resolver_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/attribute_and_group_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/complex_type_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/containers_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/element_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/simple_content_spec.rb'
-
-# Offense count: 3
-# This cop supports safe autocorrection (--autocorrect).
-Layout/ClosingParenthesisIndentation:
-  Exclude:
-    - 'spec/lutaml/model/cached_type_resolver_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/simple_content_spec.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Layout/ElseAlignment:
-  Exclude:
-    - 'lib/lutaml/xml/schema/xsd/schema_path.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleAlignWith.
-# SupportedStylesAlignWith: keyword, variable, start_of_line
-Layout/EndAlignment:
-  Exclude:
-    - 'lib/lutaml/xml/schema/xsd/schema_path.rb'
-
-# Offense count: 3
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: consistent, consistent_relative_to_receiver, special_for_inner_method_call, special_for_inner_method_call_in_parentheses
-Layout/FirstArgumentIndentation:
-  Exclude:
-    - 'spec/lutaml/model/cached_type_resolver_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/simple_content_spec.rb'
-
-# Offense count: 58
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
-# SupportedStylesAlignWith: start_of_line, relative_to_receiver
-Layout/IndentationWidth:
-  Exclude:
-    - 'lib/lutaml/xml/schema/xsd/complex_type.rb'
-    - 'lib/lutaml/xml/schema/xsd/element.rb'
-    - 'lib/lutaml/xml/schema/xsd/schema.rb'
-    - 'lib/lutaml/xml/schema/xsd/schema_path.rb'
-    - 'spec/lutaml/key_value/transformation_spec.rb'
-    - 'spec/lutaml/model/cached_type_resolver_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/attribute_and_group_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/complex_type_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/containers_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/element_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/simple_content_spec.rb'
-
-# Offense count: 3236
+# Offense count: 3210
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
-# Offense count: 8
-# This cop supports safe autocorrection (--autocorrect).
-Layout/MultilineBlockLayout:
-  Exclude:
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/attribute_and_group_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/complex_type_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/containers_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/element_spec.rb'
-
-# Offense count: 3
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: symmetrical, new_line, same_line
-Layout/MultilineMethodCallBraceLayout:
-  Exclude:
-    - 'spec/lutaml/model/cached_type_resolver_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/simple_content_spec.rb'
-
-# Offense count: 24
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowInHeredoc.
-Layout/TrailingWhitespace:
-  Exclude:
-    - 'lib/lutaml/model/configuration.rb'
-    - 'lib/lutaml/model/instrumentation.rb'
-    - 'lib/lutaml/xml/schema/xsd/base.rb'
-    - 'lib/lutaml/xml/schema/xsd/complex_type.rb'
-    - 'lib/lutaml/xml/schema/xsd/schema.rb'
-    - 'lib/lutaml/xml/schema/xsd/schema_path.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/attribute_and_group_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/complex_type_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/containers_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/element_spec.rb'
-
 # Offense count: 21
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: enums
@@ -170,15 +34,10 @@ Lint/ConstantDefinitionInBlock:
 Lint/DuplicateBranch:
   Enabled: false
 
-# Offense count: 21
+# Offense count: 3
 Lint/DuplicateMethods:
   Exclude:
     - 'lib/lutaml/xml/mapping.rb'
-    - 'spec/lutaml/xml/namespace_no_hoisting_spec.rb'
-    - 'spec/lutaml/xml/namespace_scope_declare_spec.rb'
-    - 'spec/lutaml/xml/namespace_scope_vcard_spec.rb'
-    - 'spec/lutaml/xml/prefix_control_spec.rb'
-    - 'spec/lutaml/xml/type_namespace_examples_spec.rb'
 
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
@@ -251,7 +110,7 @@ Lint/UselessConstantScoping:
     - 'lib/lutaml/xml/adapter/nokogiri_adapter.rb'
     - 'lib/lutaml/xml/mapping_rule.rb'
 
-# Offense count: 336
+# Offense count: 340
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Enabled: false
@@ -267,12 +126,12 @@ Metrics/BlockLength:
 Metrics/BlockNesting:
   Max: 6
 
-# Offense count: 297
+# Offense count: 301
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 543
+# Offense count: 551
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 514
@@ -283,7 +142,7 @@ Metrics/ParameterLists:
   Max: 24
   MaxOptionalParameters: 5
 
-# Offense count: 251
+# Offense count: 255
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Enabled: false
@@ -295,12 +154,11 @@ Naming/ClassAndModuleCamelCase:
   Exclude:
     - 'spec/support/xml_mapping_namespaces.rb'
 
-# Offense count: 8
+# Offense count: 6
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
 # AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
 Naming/MethodParameterName:
   Exclude:
-    - 'lib/lutaml/model/configuration.rb'
     - 'lib/lutaml/model/error/invalid_attribute_type_error.rb'
     - 'lib/lutaml/model/error/unknown_adapter_type_error.rb'
     - 'lib/lutaml/model/type_context.rb'
@@ -376,7 +234,7 @@ RSpec/BeforeAfterAll:
 RSpec/ContextWording:
   Enabled: false
 
-# Offense count: 79
+# Offense count: 81
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Enabled: false
@@ -387,7 +245,7 @@ RSpec/DescribeMethod:
     - 'spec/lutaml/xml/schema/xsd/schema_helper_methods_spec.rb'
     - 'spec/lutaml/xml/serializable_namespace_spec.rb'
 
-# Offense count: 1155
+# Offense count: 1164
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 68
@@ -462,7 +320,7 @@ RSpec/MultipleDescribes:
     - 'spec/lutaml/xml/namespace_resolution_strategy_spec.rb'
     - 'spec/lutaml/xml/xml_space_type_spec.rb'
 
-# Offense count: 1300
+# Offense count: 1336
 RSpec/MultipleExpectations:
   Max: 21
 
@@ -534,25 +392,15 @@ Security/MarshalLoad:
   Exclude:
     - 'scripts-xmi-profile/profile_xmi.rb'
 
-# Offense count: 46
+# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
-# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
-# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
-# FunctionalMethods: let, let!, subject, watch
-# AllowedMethods: lambda, proc, it
-Style/BlockDelimiters:
-  Exclude:
-    - 'lib/lutaml/xml/schema/xsd/complex_type.rb'
-    - 'lib/lutaml/xml/schema/xsd/element.rb'
-    - 'lib/lutaml/xml/schema/xsd/schema.rb'
-    - 'spec/lutaml/key_value/transformation_spec.rb'
-    - 'spec/lutaml/model/cached_type_resolver_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/attribute_and_group_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/complex_type_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/containers_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/element_spec.rb'
-    - 'spec/lutaml/xml/schema/xsd/liquid_methods/simple_content_spec.rb'
+# Configuration parameters: AllowOnlyRestArgument, UseAnonymousForwarding, RedundantRestArgumentNames, RedundantKeywordRestArgumentNames, RedundantBlockArgumentNames.
+# RedundantRestArgumentNames: args, arguments
+# RedundantKeywordRestArgumentNames: kwargs, options, opts
+# RedundantBlockArgumentNames: blk, block, proc
+Style/ArgumentsForwarding:
+  Exclude:
+    - 'lib/lutaml/model/serialize.rb'
 
 # Offense count: 1
 # This cop supports unsafe autocorrection (--autocorrect-all).
@@ -577,7 +425,7 @@ Style/EmptyElse:
     - 'lib/lutaml/xml/declaration_planner.rb'
     - 'lib/lutaml/xml/model_transform.rb'
 
-# Offense count: 48
+# Offense count: 46
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, MaxUnannotatedPlaceholdersAllowed, Mode, AllowedMethods, AllowedPatterns.
 # SupportedStyles: annotated, template, unannotated
@@ -588,33 +436,19 @@ Style/FormatStringToken:
     - 'bench/bench_mml.rb'
     - 'bench/bench_niso.rb'
     - 'bench/bench_sts.rb'
-    - 'bench/bench_uniword.rb'
     - 'bench/bench_xmi.rb'
     - 'benchmark/quick_benchmark.rb'
     - 'benchmark/serialization_benchmark.rb'
 
-# Offense count: 6
+# Offense count: 5
 Style/MixinUsage:
   Exclude:
     - 'bench/bench_mml.rb'
     - 'bench/bench_niso.rb'
     - 'bench/bench_sts.rb'
     - 'bench/bench_unitsml.rb'
-    - 'bench/bench_uniword.rb'
     - 'bench/bench_xmi.rb'
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Style/MultilineIfModifier:
-  Exclude:
-    - 'lib/lutaml/xml/schema/xsd/schema_path.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Style/MultilineTernaryOperator:
-  Exclude:
-    - 'lib/lutaml/xml/schema/xsd/schema_path.rb'
-
 # Offense count: 12
 # Configuration parameters: AllowedClasses.
 Style/OneClassPerFile:

data/README.adoc

@@ -11523,6 +11523,147 @@ yamls = Directory.from_yamls(yamls)
 ====
 
 
+==== Heterogeneous YAML Stream (YAMLS Sequence)
+
+In many real-world datasets, a YAML Stream contains documents of *different*
+types at specific positions.  For example, Geolexica glossary files use
+document 0 as a concept index and documents 1+ as localized concept entries.
+
+This is analogous to XML Schema's `<sequence>` element, where child elements
+appear in a fixed order and each position maps to a different type.
+
+Lutaml::Model supports this pattern through the `sequence` block inside the
+`yamls` mapping DSL.
+
+===== Usage
+
+The `sequence` block contains `map_document` calls that bind a document
+position to a model attribute:
+
+* `position` — an `Integer` (exact document index) or a `Range` (e.g. `1..`
+  meaning "from document 1 onwards").
+* `to` — the attribute name on the parent model.
+* `type` — the model class for deserialization.
+* `collection` — set to `true` if multiple documents map to this attribute.
+
+[source,ruby]
+----
+class ConceptIndex < Lutaml::Model::Serializable
+  attribute :data, ConceptIndexData
+  attribute :id, :string
+
+  yaml do
+    map "data", to: :data
+    map "id", to: :id
+  end
+end
+
+class LocalizedConcept < Lutaml::Model::Serializable
+  attribute :data, LocalizedConceptData
+  attribute :id, :string
+
+  yaml do
+    map "data", to: :data
+    map "id", to: :id
+  end
+end
+
+class ManagedConcept < Lutaml::Model::Serializable
+  attribute :index, ConceptIndex
+  attribute :localized, LocalizedConcept, collection: true
+
+  yamls do
+    sequence do
+      map_document 0, to: :index, type: ConceptIndex
+      map_document 1.., to: :localized, type: LocalizedConcept, collection: true
+    end
+  end
+end
+----
+
+Given a YAML stream with two documents:
+
+[source,yaml]
+----
+---
+data:
+  identifier: 3.5.8.8
+  localized_concepts:
+    eng: fbe1444a-7c11-555e-bb1b-680a4e6f2502
+id: 0171b198-d068-53d9-8741-fb87e6755d62
+
+---
+data:
+  definition:
+  - content: characteristic of a financial model
+  terms:
+  - type: expression
+    normative_status: preferred
+    designation: membership-based
+  language_code: eng
+id: fbe1444a-7c11-555e-bb1b-680a4e6f2502
+----
+
+[source,ruby]
+----
+managed = ManagedConcept.from_yamls(yamls)
+
+managed.index.data.identifier   #=> "3.5.8.8"
+managed.localized.first.data.language_code  #=> "eng"
+managed.localized.first.data.terms.first.designation  #=> "membership-based"
+
+# Round-trip back to a YAML stream
+managed.to_yamls  #=> "---\ndata:\n  identifier: 3.5.8.8\n..."
+----
+
+===== Position semantics
+
+[cols="1,4"]
+|===
+| Position | Meaning
+
+| `0` (Integer)
+| Document at index 0 only. Used with `collection: false` (default).
+
+| `-1` (negative Integer)
+| Last document in the stream.
+
+| `-2` (negative Integer)
+| Second-to-last document.
+
+| `1..` (open Range)
+| All documents from index 1 onwards. Used with `collection: true`.
+
+| `0..1` (bounded Range)
+| Documents at indices 0 and 1.
+
+| `2..4` (bounded Range)
+| Documents at indices 2, 3, 4.
+
+| `-2..-1` (negative Range)
+| Last 2 documents in the stream.
+
+| `1..-1` (mixed Range)
+| Documents from index 1 to the end.
+
+| `2..-1` (mixed Range)
+| Documents from index 2 to the end.
+|===
+
+===== Loading a directory of sequence-based files
+
+Each file is a complete YAML stream (one `ManagedConcept`).  Load them
+individually and assemble into a collection:
+
+[source,ruby]
+----
+concepts = Dir["glossary/*.yaml"].map do |f|
+  ManagedConcept.from_yamls(File.read(f))
+end
+collection = ManagedConceptCollection.new(concepts)
+----
+
+
 == Serialization: Instance serialization (`to_{format}`)
 
 === General
@@ -15580,13 +15721,13 @@ There are two ways to specify a configuration:
 * by providing a predefined symbol (preferred)
 * by providing the actual adapter classes
 
-There is a default configuration for adapters for commonly used formats:
+Adapters are auto-detected on first use. The defaults when gems are available:
 
-* YAML: `yaml_adapter_type` is set to `:standard_yaml`
-* JSON: `json_adapter_type` is set to `:standard_json`
-* Hash: `hash_adapter_type` is set to `:standard_hash`
-* XML: not defined
-* TOML: not defined
+* XML: `:nokogiri` (auto-detected: `:nokogiri` → `:ox` → `:oga` → `:rexml`)
+* YAML: `:standard` (alias: `:standard_yaml`)
+* JSON: `:standard` (alias: `:standard_json`)
+* Hash: `:standard` (alias: `:standard_hash`)
+* TOML: `:tomlib` on non-Windows, `:toml_rb` on Windows
 
 
 ==== Configure adapters through symbol choices
@@ -15606,10 +15747,10 @@ require 'lutaml/model'
 
 Lutaml::Model::Config.configure do |config|
   config.xml_adapter_type = :nokogiri # can be one of [:nokogiri, :ox, :oga, :rexml]
-  config.hash_adapter_type = :standard_hash
-  config.yaml_adapter_type = :standard_yaml
-  config.json_adapter_type = :standard_json # can be one of [:standard_json, :multi_json, :oj]
-  config.toml_adapter_type = :toml_rb # can be one of [:toml_rb, :tomlib]
+  config.hash_adapter = :standard
+  config.yaml_adapter = :standard
+  config.json_adapter = :standard # can be one of [:standard, :multi_json, :oj]
+  config.toml_adapter = :toml_rb # can be one of [:toml_rb, :tomlib]
 end
 ----
 
@@ -15708,7 +15849,7 @@ Included in the Ruby standard library.
 require 'lutaml/model'
 
 Lutaml::Model::Config.configure do |config|
-  config.yaml_adapter = :standard_yaml
+  config.yaml_adapter = :standard
 end
 ----
 
@@ -15738,11 +15879,11 @@ Requires the `oj` gem.
 require 'lutaml/model'
 
 Lutaml::Model::Config.configure do |config|
-  config.json_adapter = :standard_json
+  config.json_adapter = :standard
   # or
-  config.json_adapter = :multi_json
+  config.json_adapter_type = :multi_json
   # or
-  config.json_adapter = :oj
+  config.json_adapter_type = :oj
 end
 ----
 
@@ -15782,6 +15923,62 @@ end
 ----
 
 
+=== Per-operation adapter override
+
+Override the adapter for a single serialization/deserialization call using the `adapter:` option:
+
+[source,ruby]
+----
+# Parse with Ox for this call only
+model = MyClass.from_xml(xml_string, adapter: :ox)
+
+# Serialize with REXML for this call only
+output = model.to_xml(adapter: :rexml)
+----
+
+This is useful for testing with a specific adapter without changing global configuration,
+or for cross-adapter workflows.
+
+=== Scoped adapter context
+
+Use `Config.with_adapter` for thread-safe, block-scoped adapter overrides:
+
+[source,ruby]
+----
+# All XML operations in this block use Ox
+Lutaml::Model::Config.with_adapter(xml: :ox) do
+  model = MyClass.from_xml(data)
+  model.to_xml  # also uses Ox
+end
+# Outside the block, reverts to the configured default
+----
+
+TIP: `with_adapter` is thread-safe and nestable. Use it in tests instead of
+manual save/restore patterns.
+
+=== Library stacking
+
+When multiple libraries depend on lutaml-model, each can set its preferred adapter
+within a scoped context without affecting the end-user's configuration:
+
+[source,ruby]
+----
+# In gem "my_xml_library"
+module MyXmlLibrary
+  def self.parse(data)
+    Config.with_adapter(xml: :nokogiri) do
+      MyModel.from_xml(data)
+    end
+  end
+end
+
+# End-user's choice is not affected
+Config.xml_adapter_type = :ox
+result = MyXmlLibrary.parse(data)  # uses Nokogiri inside
+my_model.to_xml  # uses Ox (user's choice)
+----
+
+
 [[opal-compatibility]]
 === Opal compatibility
 
@@ -15790,7 +15987,7 @@ JavaScript). The runtime is detected automatically and adapter selection is
 adjusted accordingly.
 
 * *XML*: Only the `:oga` adapter is available (auto-selected).
-* *JSON*: Only the `:standard_json` adapter is available.
+* *JSON*: Only the `:standard` adapter is available.
 * *TOML*: Not available on Opal.
 * *Schema generation*: `to_xsd`, `to_relaxng`, and `from_xml` (XML schema
   compilation) raise `NotImplementedError` on Opal.