lutaml-model 0.8.11 → 0.8.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 992b8e51bee9c168f1dbb4cac0fcfd75f593f1c40cc29abce7e2163088e6fc48
-  data.tar.gz: 8e3524b5e4336e8cb289c3f31b513727bb2bbb23d3429fcd770425b6f24de489
+  metadata.gz: 86f1ceda6e01c3d47e303f092a24062a0e051faaf8a859bb47d2723670088d61
+  data.tar.gz: 92b43d69b6d49244c4187859e497fdbbce11d913f11425e8dfdfed1493f97e5a
 SHA512:
-  metadata.gz: 61c349cf6a1476a0c8668ea19b45e2989275a00d97ab718613eb80cfdc86a2e71ba0cb344c69a6877c5447a57d715f080470c3b28dce0c046652502182b29408
-  data.tar.gz: b85e8858876efa7b98acec6df1ff36e2ebbbf772c8b8cf035a459374159d2c5d704c13cbcecc99a69561438884d05bc4f52d13e12d6cd1b3f63611761344bd04
+  metadata.gz: 33612bb8b97cc3667b88a5638288155319281de507ca4b8ca6386ea6b9e3a79b747d3b0441d92b4083441310a7962449c511e1445eb3779c2bf872b1d2ebdca1
+  data.tar.gz: f51445ae0f41d649c89e21c43f8cb1738a146457a35fac1fb5f927f6829d7360e3d115b55d7ea24549c33b03074c381028b89fc10e4ef87e703cd7f51bd36bf6

data/.github/workflows/opal.yml

@@ -0,0 +1,31 @@
+name: opal
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: "recursive"
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+
+      - name: Run Opal tests
+        # TODO: Remove continue-on-error once REXML adapter is verified
+        # under actual Opal runtime (REXML compiles to JS via Opal's stdlib)
+        run: bundle exec rake spec:opal
+        continue-on-error: true

data/.rspec-opal

@@ -0,0 +1,5 @@
+--default-path=spec
+--pattern='spec/lutaml/model/opal_smoke_spec.rb,spec/lutaml/xml/opal_xml_spec.rb'
+-I lib
+--require=spec_helper
+--require=support/opal

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-20 09:01:31 UTC using RuboCop version 1.86.0.
+# on 2026-05-27 05:02:01 UTC using RuboCop version 1.86.0.
 # 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
@@ -17,45 +17,53 @@ Gemspec/RequiredRubyVersion:
 # SupportedStyles: with_first_argument, with_fixed_indentation
 Layout/ArgumentAlignment:
   Exclude:
-    - 'lib/lutaml/turtle/transform.rb'
-    - 'spec/lutaml/model/store_spec.rb'
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
 
-# Offense count: 3
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleAlignWith.
-# SupportedStylesAlignWith: either, start_of_block, start_of_line
-Layout/BlockAlignment:
+Layout/ClosingParenthesisIndentation:
   Exclude:
-    - 'spec/lutaml/model/store_spec.rb'
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
 
-# Offense count: 3
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-Layout/BlockEndNewline:
+# 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/store_spec.rb'
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
 
-# Offense count: 6
+# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
-# SupportedStylesAlignWith: start_of_line, relative_to_receiver
-Layout/IndentationWidth:
+# Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
+# SupportedHashRocketStyles: key, separator, table
+# SupportedColonStyles: key, separator, table
+# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
+Layout/HashAlignment:
   Exclude:
-    - 'spec/lutaml/model/store_spec.rb'
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
 
-# Offense count: 3024
+# Offense count: 3022
 # 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: 2
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: symmetrical, new_line, same_line
+Layout/MultilineMethodCallBraceLayout:
+  Exclude:
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
+
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowInHeredoc.
 Layout/TrailingWhitespace:
   Exclude:
-    - 'lib/lutaml/turtle/transform.rb'
-    - 'spec/lutaml/model/store_spec.rb'
+    - 'spec/lutaml/model/opal_smoke_spec.rb'
 
 # Offense count: 21
 # Configuration parameters: AllowedMethods.
@@ -148,6 +156,12 @@ Lint/UnusedMethodArgument:
     - 'lib/lutaml/xml/unqualified_inheritance_strategy.rb'
     - 'spec/support/xml/xsd/code_example_validator.rb'
 
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Lint/UselessAssignment:
+  Exclude:
+    - 'spec/lutaml/xml/opal_xml_spec.rb'
+
 # Offense count: 1
 Lint/UselessConstantScoping:
   Exclude:
@@ -277,7 +291,7 @@ RSpec/BeforeAfterAll:
 RSpec/ContextWording:
   Enabled: false
 
-# Offense count: 96
+# Offense count: 98
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Enabled: false
@@ -288,7 +302,7 @@ RSpec/DescribeMethod:
     - 'spec/lutaml/xml/schema/xsd/schema_helper_methods_spec.rb'
     - 'spec/lutaml/xml/serializable_namespace_spec.rb'
 
-# Offense count: 1285
+# Offense count: 1301
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 68
@@ -363,7 +377,7 @@ RSpec/MultipleDescribes:
     - 'spec/lutaml/xml/namespace_resolution_strategy_spec.rb'
     - 'spec/lutaml/xml/xml_space_type_spec.rb'
 
-# Offense count: 1507
+# Offense count: 1515
 RSpec/MultipleExpectations:
   Max: 21
 
@@ -437,17 +451,6 @@ Security/MarshalLoad:
   Exclude:
     - 'scripts-xmi-profile/profile_xmi.rb'
 
-# Offense count: 5
-# 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:
-    - 'spec/lutaml/model/store_spec.rb'
-
 # Offense count: 2
 # This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: AllowedMethods, AllowedPatterns.
@@ -540,3 +543,11 @@ Style/StringConcatenation:
     - 'lib/lutaml/model/schema/xml_compiler/complex_type.rb'
     - 'lib/lutaml/model/schema/xml_compiler/simple_type.rb'
     - 'lib/lutaml/model/schema/xml_compiler/xml_namespace_class.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInArguments:
+  Exclude:
+    - 'spec/lutaml/model/opal_smoke_spec.rb'

data/README.adoc

@@ -16195,11 +16195,20 @@ Lutaml::Model supports running under https://opalrb.com[Opal] (Ruby compiled to
 JavaScript). The runtime is detected automatically and adapter selection is
 adjusted accordingly.
 
-* *XML*: Only the `:oga` adapter is available (auto-selected).
+* *XML*: Only the `:rexml` adapter is available (auto-selected). Opal
+  reimplements `strscan` and `stringio` in its stdlib, enabling REXML (pure
+  Ruby) to compile cleanly to JavaScript.
 * *JSON*: Only the `:standard` adapter is available.
+* *YAML*: 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.
+* *Liquid templating*: Not available on Opal (Phase 1 — skipped).
+* *XPath*: Not available on Opal (REXML XPath requires features not yet
+  supported by Opal's stdlib).
+
+See the link:docs/_guides/opal.adoc[Opal Usage Guide] for setup instructions
+and limitations.
 
 
 === Error handling

data/docs/_guides/index.adoc

@@ -46,6 +46,10 @@ See link:../references/rdf-namespaces[RDF Namespaces] for namespace classes,
 * link:../consolidation-mapping[Consolidation Mapping] - Group sibling elements into structured models
 * link:../document-validation[Document Validation] - Document-level validation with rules, profiles, and remediation
 
+== Runtime environments
+
+* link:../opal[Opal Usage Guide] - Run Lutaml::Model in the browser via Opal (Ruby to JavaScript)
+
 == By task
 
 === I want to serialize to XML

data/docs/_guides/opal.adoc

@@ -0,0 +1,221 @@
+---
+title: Opal Usage Guide
+parent: Guides
+nav_order: 99
+---
+
+= Opal Usage Guide
+
+:toc:
+:toclevels: 3
+
+== Overview
+
+https://opalrb.com[Opal] is a Ruby-to-JavaScript compiler that allows Ruby code to run in the browser. Lutaml::Model supports running under Opal, enabling XML/JSON/YAML serialization in client-side applications.
+
+The XML parsing layer is provided by the https://github.com/lutaml/moxml[moxml] gem (v0.2+), which detects the Opal runtime and uses the REXML adapter automatically.
+
+== How it works
+
+Opal compiles Ruby source code to JavaScript. Under Opal:
+
+. `RUBY_ENGINE` equals `"opal"`
+. `Lutaml::Model::RuntimeCompatibility.opal?` returns `true`
+. Adapter selection is adjusted automatically
+. Gems with C extensions (Nokogiri, Ox, Oj, tomlib) are not available
+. REXML is used for XML because Opal reimplements `strscan` and `stringio` in its stdlib, enabling REXML (pure Ruby) to compile cleanly to JavaScript
+
+No configuration is needed -- the runtime is detected and adapters are selected automatically.
+
+== Supported features
+
+=== Fully supported
+
+* Model definition with `attribute`, types, collections, defaults
+* XML serialization/deserialization (via REXML adapter)
+** Element and attribute mapping
+** Nested elements and collections
+** Mixed content
+** Namespaces (parsing and serialization)
+** CDATA sections
+** Processing instructions
+** Comments
+** Entity references
+** XML declarations and doctypes
+* JSON serialization/deserialization (via standard adapter)
+* YAML serialization/deserialization (via standard adapter)
+* Hash transformation
+* Custom types
+* Model import (`import_model`)
+* Value transformations
+
+=== Not available
+
+[cols="1,3",options="header"]
+|===
+| Feature | Reason
+| XSD schema generation | Requires Nokogiri
+| RELAX NG generation | Requires Nokogiri
+| XML schema compilation | Requires Nokogiri + native parsing
+| TOML serialization | Both tomlib and toml-rb require native extensions
+| Oj / MultiJson adapters | Require native extensions
+| Ox / Nokogiri / Oga adapters | Require native extensions or C extensions
+| XPath queries | REXML XPath requires features not yet in Opal's stdlib
+| Liquid templating | Uses file-system-based template loading (Phase 1: skipped)
+| Canon XML equivalence | Uses Nokogiri for XML parsing
+|===
+
+== Setup
+
+=== Gemfile
+
+Add Opal gems to your Gemfile:
+
+[source,ruby]
+----
+gem "lutaml-model"
+
+group :opal do
+  gem "opal", "~> 1.8"
+  gem "opal-rspec", "~> 1.0"
+  gem "opal-sprockets"
+end
+----
+
+=== Rake task
+
+Add an Opal RSpec task to your Rakefile:
+
+[source,ruby]
+----
+begin
+  require "opal/rspec/rake_task"
+rescue LoadError
+  # Opal not available
+end
+
+namespace :spec do
+  if defined?(Opal::RSpec::RakeTask)
+    desc "Run Opal (JavaScript) tests"
+    Opal::RSpec::RakeTask.new(:opal) do |server, runner|
+      server.append_path "lib"
+      runner.default_path = "spec"
+      runner.pattern = "spec/**/*_spec.{rb,opal}"
+    end
+  end
+end
+----
+
+=== Test configuration
+
+Create `spec/support/opal.rb` for Opal-specific test patches:
+
+[source,ruby]
+----
+# frozen_string_literal: true
+
+if RUBY_ENGINE == "opal"
+  Lutaml::Model::Config.xml_adapter_type = :rexml
+end
+----
+
+Create `.rspec-opal`:
+
+----
+--default-path=spec
+--pattern='spec/**/*_spec.{rb,opal}'
+-I lib
+--opal-opt=-g,lutaml-model
+-I spec
+--require=spec_helper
+--require=support/opal
+----
+
+=== CI workflow
+
+Add `.github/workflows/opal.yml`:
+
+[source,yaml]
+----
+name: opal
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: "recursive"
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+      - name: Run Opal tests
+        run: bundle exec rake spec:opal
+----
+
+== Example: XML round-trip in the browser
+
+[source,ruby]
+----
+class Person
+  include Lutaml::Model::Serialize
+
+  attribute :name, :string
+  attribute :age, :integer
+
+  xml do
+    root "person"
+    map_element "name", to: :name
+    map_element "age", to: :age
+  end
+end
+
+# Parse XML
+person = Person.from_xml('<person><name>Alice</name><age>30</age></person>')
+person.name  # => "Alice"
+person.age   # => 30
+
+# Serialize to XML
+person.to_xml  # => "<person><name>Alice</name><age>30</age></person>"
+
+# JSON and YAML also work
+person.to_json  # => '{"name":"Alice","age":30}'
+person.to_yaml  # => "---\nname: Alice\nage: 30\n"
+----
+
+== Architecture
+
+Under Opal, the library uses a JRuby-like pattern for dependency management:
+
+. *Dependencies stay in the gemspec.* Gems like Nokogiri, Ox, and Oga remain listed as dependencies -- they are simply not loadable under Opal.
+. *Requires are guarded with `RUBY_ENGINE`.* Code that depends on native gems uses `RUBY_ENGINE == "opal"` checks instead of silent `rescue LoadError`.
+. *No gem splitting.* The same gem works on both MRI and Opal.
+
+Key components:
+* `Lutaml::Model::RuntimeCompatibility` -- detects the runtime (opal, windows, native)
+* `Lutaml::Model::AdapterResolver` -- selects adapters based on runtime capabilities
+* `Moxml::Config::OPAL_DEFAULT_ADAPTER` -- set to `:rexml`
+* `Moxml::Adapter::OPAL_AVAILABLE_ADAPTERS` -- set to `%i[rexml]`
+
+== Dependencies
+
+The following gems in the lutaml ecosystem support Opal:
+
+* **lutaml-model** -- Core model library (this gem)
+* **moxml** (v0.2+) -- XML parsing abstraction with REXML adapter for Opal
+* **canon** -- XML comparison (uses moxml under Opal; comparison features work but Nokogiri-specific features do not)
+
+== Limitations
+
+* **No XPath** -- REXML's XPath module has dependencies not yet reimplemented in Opal's stdlib.
+* **No schema generation** -- XSD, RELAX NG generation, and schema compilation require Nokogiri.
+* **No TOML** -- Both TOML adapters (tomlib, toml-rb) require native extensions.
+* **No Liquid** -- Template rendering via Liquid is skipped in Opal (file-system dependency). May be addressed in a future phase using liquidjs via Opal's JavaScript bridge.

data/docs/_guides/xml_mappings/07_best_practices.adoc

@@ -723,7 +723,8 @@ end
 
 * **Ox**: Fastest, use for performance-critical applications
 * **Nokogiri**: Most compatible, good balance
-* **Oga**: Pure Ruby, works with Opal, use when no native extensions allowed
+* **Oga**: Pure Ruby, use when no native extensions allowed
+* **REXML**: Pure Ruby (bundled with Ruby), Opal-compatible
 
 **Configure once:**
 

data/docs/_pages/configuration.adoc

@@ -74,7 +74,7 @@ When an adapter is needed for a format, `AdapterResolver` follows this chain:
 | Pure Ruby. No compilation needed. Opal-compatible.
 
 | `:rexml`
-| Pure Ruby. Bundled with Ruby (default gem).
+| Pure Ruby. Bundled with Ruby (default gem). Opal-compatible.
 |===
 
 === JSON adapters
@@ -261,8 +261,8 @@ end
 
 * **Nokogiri**: Most projects (default, best compatibility)
 * **Ox**: Performance-critical applications
-* **Oga**: Pure Ruby environments, Opal/JavaScript compilation
-* **REXML**: No extra gems, pure Ruby (bundled with Ruby)
+* **Oga**: Pure Ruby environments
+* **REXML**: No extra gems, pure Ruby (bundled with Ruby). Also used under Opal.
 
 === Choose JSON adapter based on
 
@@ -279,12 +279,14 @@ end
 
 Lutaml::Model supports running under https://opalrb.com[Opal] (Ruby compiled to JavaScript) with some limitations. The library detects the runtime automatically via `Lutaml::Model::RuntimeCompatibility` and adapts its behavior accordingly.
 
+The XML parsing layer is provided by the https://github.com/lutaml/moxml[moxml] gem, which has been updated to support Opal. Under Opal, moxml uses the REXML adapter because Opal reimplements `strscan` and `stringio` in its stdlib, enabling REXML (pure Ruby) to compile cleanly to JavaScript.
+
 === Adapter defaults on Opal
 
 [cols="1,2",options="header"]
 |===
 | Format | Behavior
-| XML | Only `:oga` is available (auto-selected). Nokogiri, Ox, and REXML require native extensions.
+| XML | Only `:rexml` is available (auto-selected). Opal reimplements strscan/stringio in its stdlib, enabling REXML to compile to JavaScript.
 | JSON | Only `:standard` is available. Oj and MultiJson require native extensions.
 | YAML | `:standard` (Psych ships with Opal's stdlib).
 | TOML | **Not available.** Both tomlib and toml-rb depend on native extensions.
@@ -299,6 +301,9 @@ The following features raise `NotImplementedError` when called under Opal:
 * `Lutaml::Model::Schema.to_relaxng` -- RELAX NG generation requires Nokogiri
 * `Lutaml::Model::Schema.from_xml` -- XML schema compilation is not supported
 * `Lutaml::Xml::Schema::Xsd::Base#to_formatted_xml` -- XSD formatted output requires the Canon gem
+* XPath queries -- REXML XPath requires features not yet supported by Opal's stdlib
+
+See the link:../guides/opal[Opal Usage Guide] for complete setup instructions and limitations.
 
 == See also
 

data/docs/_pages/index.adoc

@@ -22,6 +22,7 @@ Fundamental concepts, configuration, and essential features of Lutaml::Model.
 * link:breaking-changes[Breaking Changes] - Version compatibility
 * link:comparison-with-shale[Comparison with Shale] - Migration guide
 * link:xml-conformance[XML Standards Conformance] - W3C spec compliance status
+* link:../guides/opal[Opal Usage] - Run in the browser via Opal
 * link:troubleshooting[Troubleshooting] - Common issues and solutions
 
 == Getting started

data/docs/_pages/serialization_adapters.adoc

@@ -192,8 +192,7 @@ Requires the `nokogiri` gem.
 Oga::
 (optional)
 Pure Ruby XML parser.
-Does not require native extensions and is suitable for
-https://opalrb.com[Opal] (Ruby on JavaScript).
+Does not require native extensions.
 Requires the `oga` gem.
 
 Ox::
@@ -206,6 +205,8 @@ REXML::
 (optional)
 Pure Ruby XML parser, bundled as a default gem with Ruby.
 Moved from standard library to a default gem in Ruby 3.0.
+Opal-compatible: Opal reimplements `strscan` and `stringio` in its stdlib,
+enabling REXML to compile cleanly to JavaScript.
 Requires the `rexml` gem (bundled with Ruby by default).
 
 

data/docs/index.adoc

@@ -19,6 +19,7 @@ Lutaml::Model is a Ruby library for creating information models with attributes
 * **Multi-format serialization** - XML, JSON, YAML, TOML, JSON-LD, Turtle, Hash, YAML Stream
 * **XML namespace support** - Full W3C namespace implementation
 * **Linked Data support** - RDF namespaces, JSON-LD, and Turtle serialization
+* **Opal support** - Run in the browser via Opal (Ruby to JavaScript) with REXML adapter
 * **Validation** - Built-in validation with custom rules
 * **Schema generation** - Generate XSD, JSON Schema, YAML Schema
 * **Polymorphism** - Handle multiple types elegantly

data/lib/lutaml/hash_format/adapter/mapping.rb

@@ -8,10 +8,8 @@ module Lutaml
           super(:hash)
         end
 
-        def deep_dup
-          self.class.new.tap do |new_mapping|
-            new_mapping.mappings = duplicate_mappings
-          end
+        def dup_instance
+          self.class.new
         end
       end
     end

data/lib/lutaml/json/adapter/mapping.rb

@@ -8,10 +8,8 @@ module Lutaml
           super(:json)
         end
 
-        def deep_dup
-          self.class.new.tap do |new_mapping|
-            new_mapping.mappings = duplicate_mappings
-          end
+        def dup_instance
+          self.class.new
         end
       end
     end

data/lib/lutaml/jsonl/adapter/mapping.rb

@@ -8,10 +8,8 @@ module Lutaml
           super(:jsonl)
         end
 
-        def deep_dup
-          self.class.new.tap do |new_mapping|
-            new_mapping.mappings = duplicate_mappings
-          end
+        def dup_instance
+          self.class.new
         end
       end
     end

data/lib/lutaml/key_value/adapter/hash/mapping.rb

@@ -7,10 +7,8 @@ module Lutaml
             super(:hash)
           end
 
-          def deep_dup
-            self.class.new.tap do |new_mapping|
-              new_mapping.mappings = duplicate_mappings
-            end
+          def dup_instance
+            self.class.new
           end
         end
       end

data/lib/lutaml/key_value/adapter/json/mapping.rb

@@ -12,10 +12,8 @@ module Lutaml
             super(:json)
           end
 
-          def deep_dup
-            self.class.new.tap do |new_mapping|
-              new_mapping.mappings = duplicate_mappings
-            end
+          def dup_instance
+            self.class.new
           end
         end
       end

data/lib/lutaml/key_value/adapter/jsonl/mapping.rb

@@ -7,10 +7,8 @@ module Lutaml
             super(:jsonl)
           end
 
-          def deep_dup
-            self.class.new.tap do |new_mapping|
-              new_mapping.mappings = duplicate_mappings
-            end
+          def dup_instance
+            self.class.new
           end
         end
       end

data/lib/lutaml/key_value/adapter/toml/mapping.rb

@@ -7,10 +7,8 @@ module Lutaml
             super(:toml)
           end
 
-          def deep_dup
-            self.class.new.tap do |new_mapping|
-              new_mapping.mappings = duplicate_mappings
-            end
+          def dup_instance
+            self.class.new
           end
 
           def validate!(key, to, with, render_nil, render_empty)

data/lib/lutaml/key_value/adapter/yaml/mapping.rb

@@ -7,10 +7,8 @@ module Lutaml
             super(:yaml)
           end
 
-          def deep_dup
-            self.class.new.tap do |new_mapping|
-              new_mapping.mappings = duplicate_mappings
-            end
+          def dup_instance
+            self.class.new
           end
         end
       end

data/lib/lutaml/key_value/adapter/yamls/mapping.rb

@@ -7,10 +7,8 @@ module Lutaml
             super(:yaml)
           end
 
-          def deep_dup
-            self.class.new.tap do |new_mapping|
-              new_mapping.mappings = duplicate_mappings
-            end
+          def dup_instance
+            self.class.new
           end
         end
       end