lutaml-model 0.8.11 → 0.8.13

data/docs/_references/format-independent-features.adoc

@@ -126,7 +126,7 @@ class Ceramic < Lutaml::Model::Serializable
 
   # Mapping-level transformation in XML format
   xml do
-    root "Ceramic"
+    element "Ceramic"
     map_attribute "glaze-type", to: :glaze_type, transform: {
       export: ->(value) { "Traditional #{value}" },
       import: ->(value) { value.gsub("Traditional ", "") }
@@ -234,7 +234,7 @@ class Ceramic < Lutaml::Model::Serializable
 
   # Mapping-level transformation in XML format
   xml do
-    root "Ceramic"
+    element "Ceramic"
     map_attribute "glaze-type", to: :glaze_type, transform: {
       export: ->(value) { "Traditional #{value}" },
       import: ->(value) { value.gsub("Traditional ", "") }
@@ -454,7 +454,7 @@ class CombinedTransformModel < Lutaml::Model::Serializable
   end
 
   xml do
-    root "CombinedTransformModel"
+    element "CombinedTransformModel"
     map_element "title", to: :title, transform: SuffixTransformer
   end
 end
@@ -662,7 +662,7 @@ class Glaze < Lutaml::Model::Serializable
   attribute :firing_time, :integer, default: -> { 60 }
 
   xml do
-    root "glaze"
+    element "glaze"
     map_element 'color', to: :color
     map_element 'opacity', to: :opacity, render_default: true
     map_attribute 'temperature', to: :temperature

data/docs/_references/instance-serialization.adoc

@@ -31,7 +31,7 @@ class JapaneseCeramic < Lutaml::Model::Serializable
   attribute :description, :string
 
   xml do
-    root 'JapaneseCeramic'
+    element "JapaneseCeramic"
     map_attribute 'glazeType', to: :glaze_type
     map_element 'description', to: :description
   end

data/docs/_references/parent-root-context.adoc

@@ -34,7 +34,7 @@ class Tag < Lutaml::Model::Serializable
   attribute :text, :string
 
   xml do
-    root "Tag"
+    element "Tag"
 
     map_content to: :text
   end
@@ -48,7 +48,7 @@ class Tags < Lutaml::Model::Serializable
   attribute :tag, Tag, collection: true
 
   xml do
-    root "Tags"
+    element "Tags"
 
     map_element "Tag", to: :tag
   end
@@ -62,7 +62,7 @@ class Post < Lutaml::Model::Serializable
   attribute :tags, Tags, collection: true
 
   xml do
-    root "Post"
+    element "Post"
     map_element "Tags", to: :tags
   end
 

data/docs/_tutorials/basic-model-definition.adoc

@@ -121,7 +121,7 @@ class Kiln < Lutaml::Model::Serializable
   attribute :temperature, :integer
 
   xml do
-    root 'kiln'
+    element "kiln"
     map_element 'brand', to: :brand
     map_element 'capacity', to: :capacity
     map_element 'temperature', to: :temperature

data/docs/_tutorials/first-xml-serialization.adoc

@@ -74,7 +74,7 @@ class Example < Lutaml::Model::Serializable
   attribute :name, :string
 
   xml do
-    root 'example'
+    element "example"
     map_element 'name', to: :name
   end
 end
@@ -116,7 +116,7 @@ class Example < Lutaml::Model::Serializable
   attribute :value, :integer
 
   xml do
-    root 'example'
+    element "example"
     map_attribute 'value', to: :value
   end
 end
@@ -158,7 +158,7 @@ class Example < Lutaml::Model::Serializable
   attribute :description, :string
 
   xml do
-    root 'example'
+    element "example"
     map_content to: :description
   end
 end
@@ -192,7 +192,7 @@ class Ceramic < Lutaml::Model::Serializable
   attribute :temperature, :integer
 
   xml do
-    root 'ceramic'
+    element "ceramic"
     map_element 'name', to: :name
     map_attribute 'temperature', to: :temperature
     map_content to: :description

data/docs/_tutorials/lutaml-xml-architecture.adoc

@@ -576,7 +576,7 @@ end
 ```ruby
 class PurchaseOrder < Lutaml::Model::Serializable
   xml do
-    root "purchaseOrder"                    # Root element name
+    element "purchaseOrder"                    # Root element name
     namespace PoNamespace                    # Model namespace
 
     map_element "shipTo", to: :ship_to       # Map element
@@ -654,7 +654,7 @@ class Book < Lutaml::Model::Serializable
   attribute :author, Person
 
   xml do
-    root "Book"
+    element "Book"
     namespace BookNamespace
     map_element "title", to: :title
     map_element "author", to: :author
@@ -979,7 +979,7 @@ class PurchaseOrder < Lutaml::Model::Serializable
   attribute :comment, :string
 
   xml do
-    root "purchaseOrder"
+    element "purchaseOrder"
     namespace PoNamespace
     map_element "comment", to: :comment
   end
@@ -1062,7 +1062,7 @@ class Document < Lutaml::Model::Serializable
   attribute :title, DcTitleType
 
   xml do
-    root "document"
+    element "document"
     map_element "title", to: :title
   end
 end

data/docs/_tutorials/validation-basics.adoc

@@ -152,7 +152,7 @@ class Contact < Lutaml::Model::Serializable
   end
 
   xml do
-    root "contact"
+    element "contact"
     map_element "email", to: :email
     map_element "phone", to: :phone
   end

data/docs/_tutorials/working-with-collections.adoc

@@ -39,7 +39,7 @@ class Studio < Lutaml::Model::Serializable
   attribute :potters, :string, collection: true
 
   xml do
-    root 'studio'
+    element "studio"
     map_element 'name', to: :name
     map_element 'potter', to: :potters
   end
@@ -142,7 +142,7 @@ class PotterCollection < Lutaml::Model::Collection
   instances :potters, Potter
 
   json do
-    root "potters"
+    key "potters"
     map_instances to: :potters
   end
 end

data/docs/_tutorials/xml-namespaces-basics.adoc

@@ -70,7 +70,7 @@ class Ceramic < Lutaml::Model::Serializable
   attribute :glaze, :string
 
   xml do
-    root 'Ceramic'
+    element "Ceramic"
     namespace CeramicNamespace
 
     map_element 'Type', to: :type

data/docs/_tutorials/xml-schema-primer-style-guide.adoc

@@ -46,7 +46,7 @@ class UsAddress < Lutaml::Model::Serializable
   attribute :zip, :decimal
 
   xml do
-    root "USAddress"
+    element "USAddress"
     map_element "name", to: :name
     map_element "street", to: :street
     map_element "city", to: :city
@@ -81,7 +81,7 @@ class PurchaseOrder < Lutaml::Model::Serializable
   attribute :comment, :string
 
   xml do
-    root "purchaseOrder"
+    element "purchaseOrder"
     map_element "shipTo", to: :ship_to
     map_element "billTo", to: :bill_to
     map_element "comment", to: :comment
@@ -123,7 +123,7 @@ class PurchaseOrder < Lutaml::Model::Serializable
   attribute :ship_to, UsAddress
 
   xml do
-    root "purchaseOrder"
+    element "purchaseOrder"
     map_attribute "orderDate", to: :order_date
     map_element "shipTo", to: :ship_to
   end
@@ -157,7 +157,7 @@ class Item < Lutaml::Model::Serializable
   attribute :us_price, :decimal
 
   xml do
-    root "Item"
+    element "Item"
     map_element "productName", to: :product_name
     map_element "quantity", to: :quantity
     map_element "USPrice", to: :us_price
@@ -168,7 +168,7 @@ class PurchaseOrder < Lutaml::Model::Serializable
   attribute :items, Item, collection: true
 
   xml do
-    root "purchaseOrder"
+    element "purchaseOrder"
     map_element "items", to: :items
   end
 end
@@ -239,7 +239,7 @@ class PurchaseOrder < Lutaml::Model::Serializable
   attribute :bill_to, UsAddress
 
   xml do
-    root "purchaseOrder"
+    element "purchaseOrder"
     namespace PoNamespace
 
     map_element "shipTo", to: :ship_to
@@ -288,7 +288,7 @@ class PurchaseOrder < Lutaml::Model::Serializable
   attribute :ship_to, UsAddress
 
   xml do
-    root "purchaseOrder"
+    element "purchaseOrder"
     namespace PoNamespace
 
     map_element "shipTo", to: :ship_to
@@ -350,7 +350,7 @@ class PurchaseOrder < Lutaml::Model::Serializable
   attribute :order_date, :string
 
   xml do
-    root "purchaseOrder"
+    element "purchaseOrder"
     namespace PoNamespace
 
     map_attribute "orderDate", to: :order_date
@@ -418,7 +418,7 @@ class PurchaseOrder < Lutaml::Model::Serializable
   attribute :comment, :string  # This one will be unqualified
 
   xml do
-    root "purchaseOrder"
+    element "purchaseOrder"
     namespace PoNamespace
 
     map_element "shipTo", to: :ship_to
@@ -489,7 +489,7 @@ class Document < Lutaml::Model::Serializable
   attribute :title, DcTitleType  # Automatically uses DcNamespace
 
   xml do
-    root "document"
+    element "document"
     map_element "title", to: :title
   end
 end
@@ -542,7 +542,7 @@ class Metadata < Lutaml::Model::Serializable
   attribute :created, DctermsCreatedType
 
   xml do
-    root "metadata"
+    element "metadata"
     map_element "title", to: :title
     map_element "created", to: :created
   end
@@ -586,7 +586,7 @@ class Document < Lutaml::Model::Serializable
   attribute :title, DcTitleType
 
   xml do
-    root "document"
+    element "document"
     namespace ModelNamespace  # Model namespace
     map_element "title", to: :title  # Uses Type namespace (DcNamespace)
   end
@@ -620,7 +620,7 @@ class Document < Lutaml::Model::Serializable
   attribute :title, DcTitleType
 
   xml do
-    root "document"
+    element "document"
     map_element "title", to: :title, namespace: OverrideNamespace
   end
 end
@@ -659,7 +659,7 @@ class Document < Lutaml::Model::Serializable
   attribute :schema_type, XsiTypeType
 
   xml do
-    root "document"
+    element "document"
     map_attribute "name", to: :name
     map_attribute "type", to: :schema_type
   end
@@ -701,7 +701,7 @@ class PurchaseOrder < Lutaml::Model::Serializable
   attribute :ship_to, UsAddress
 
   xml do
-    root "purchaseOrder"
+    element "purchaseOrder"
     namespace PoNamespace
     map_element "shipTo", to: :ship_to
   end
@@ -749,7 +749,7 @@ The `namespace_scope` directive consolidates multiple namespace declarations at
 ----
 class Document < Lutaml::Model::Serializable
   xml do
-    root "document"
+    element "document"
     namespace RootNamespace
 
     # Hoist multiple namespaces to root
@@ -794,7 +794,7 @@ class Vcard < Lutaml::Model::Serializable
   attribute :title, DcTitleType
 
   xml do
-    root "vCard"
+    element "vCard"
     namespace VcardNamespace
 
     # Hoist DcNamespace to root
@@ -882,7 +882,7 @@ class Address < Lutaml::Model::Serializable
   attribute :city, :string
 
   xml do
-    root "Address"
+    element "Address"
     map_element "street", to: :street
     map_element "city", to: :city
   end
@@ -893,7 +893,7 @@ class Person < Lutaml::Model::Serializable
   attribute :address, Address
 
   xml do
-    root "Person"
+    element "Person"
     map_element "name", to: :name
     map_element "address", to: :address
   end
@@ -934,7 +934,7 @@ class Person < Lutaml::Model::Serializable
   attribute :work_address, AddressType
 
   xml do
-    root "Person"
+    element "Person"
     map_element "homeAddress", to: :home_address
     map_element "workAddress", to: :work_address
   end
@@ -975,7 +975,7 @@ class Item < Lutaml::Model::Serializable
   attribute :price, Price
 
   xml do
-    root "Item"
+    element "Item"
     map_element "name", to: :name
     map_attribute "price", to: :price
   end
@@ -1017,7 +1017,7 @@ class Product < Lutaml::Model::Serializable
   attribute :release_date, :date
 
   xml do
-    root "Product"
+    element "Product"
     map_element "name", to: :name
     map_element "price", to: :price
     map_element "quantity", to: :quantity
@@ -1055,7 +1055,7 @@ class Item < Lutaml::Model::Serializable
   attribute :price, UsPriceType
 
   xml do
-    root "Item"
+    element "Item"
     map_element "USPrice", to: :price
   end
 end
@@ -1106,7 +1106,7 @@ class Address < Lutaml::Model::Serializable
   attribute :city, :string
 
   xml do
-    root "Address"
+    element "Address"
     map_element "name", to: :name
     map_element "street", to: :street
     map_element "city", to: :city
@@ -1118,7 +1118,7 @@ class InternationalAddress < Address
   attribute :country, :string
 
   xml do
-    root "InternationalAddress"
+    element "InternationalAddress"
     map_element *Address.mappings  # Inherit mappings
     map_element "country", to: :country
   end
@@ -1140,7 +1140,7 @@ class Shipment < Lutaml::Model::Serializable
   attribute :address, Address
 
   xml do
-    root "Shipment"
+    element "Shipment"
     namespace_scope [XsiNamespace]
     map_element "address", to: :address
   end
@@ -1231,7 +1231,7 @@ class UsAddress < Lutaml::Model::Serializable
   attribute :zip, :decimal
 
   xml do
-    root "USAddress"
+    element "USAddress"
     map_element "name", to: :name
     map_element "street", to: :street
     map_element "city", to: :city
@@ -1247,7 +1247,7 @@ class Item < Lutaml::Model::Serializable
   attribute :comment, :string
 
   xml do
-    root "Item"
+    element "Item"
     map_element "productName", to: :product_name
     map_element "quantity", to: :quantity
     map_element "USPrice", to: :us_price
@@ -1264,7 +1264,7 @@ class PurchaseOrder < Lutaml::Model::Serializable
   attribute :created, DctermsCreatedType
 
   xml do
-    root "purchaseOrder"
+    element "purchaseOrder"
     namespace PoNamespace
 
     namespace_scope [

data/docs/cli_compare.adoc

@@ -69,7 +69,7 @@ class TermiumExtract < Lutaml::Model::Serializable
   attribute :extract_language, ExtractLanguage, collection: true
 
   xml do
-    root "termium_extract"
+    element "termium_extract"
     namespace "http://termium.tpsgc-pwgsc.gc.ca/schemas/2012/06/Termium", "ns2"
 
     map_attribute "language", to: :language

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
@@ -55,7 +56,7 @@ class Person < Lutaml::Model::Serializable
   attribute :age, :integer
 
   xml do
-    root "person"
+    element "person"
     map_element "name", to: :name
     map_element "age", to: :age
   end

data/docs/namespace-management.adoc

@@ -110,10 +110,10 @@ IMPORTANT: `namespace_scope` grants **ELIGIBILITY** to hoist namespaces to the r
 ----
 xml do
   namespace RootNamespace
-  
+
   # Simple list (all use :auto mode)
   namespace_scope [Namespace1, Namespace2, Namespace3]
-  
+
   # Per-namespace control with hash format
   namespace_scope [
     { namespace: Namespace1, declare: :always },
@@ -169,7 +169,7 @@ class Vcard < Lutaml::Model::Serializable
   attribute :email, :string
 
   xml do
-    root "vCard"
+    element "vCard"
     namespace VcardNamespace
 
     map_element "version", to: :version
@@ -244,7 +244,7 @@ class Contact < Lutaml::Model::Serializable
   attribute :note, DcTitleType
 
   xml do
-    root "contact"
+    element "contact"
 
     map_element "title", to: :title
     map_element "note", to: :note
@@ -255,7 +255,7 @@ class Vcard < Lutaml::Model::Serializable
   attribute :contact, Contact
 
   xml do
-    root "vCard"
+    element "vCard"
     namespace VcardNamespace
 
     map_element "contact", to: :contact
@@ -300,7 +300,7 @@ class Vcard < Lutaml::Model::Serializable
   attribute :contact, Contact
 
   xml do
-    root "vCard"
+    element "vCard"
     namespace VcardNamespace
 
     # Hoist DcNamespace to root
@@ -395,7 +395,7 @@ class Metadata < Lutaml::Model::Serializable
   attribute :format, XsiTypeType
 
   xml do
-    root "metadata"
+    element "metadata"
 
     map_element "title", to: :title
     map_element "creator", to: :creator
@@ -411,7 +411,7 @@ class Vcard < Lutaml::Model::Serializable
   attribute :metadata, Metadata
 
   xml do
-    root "vCard"
+    element "vCard"
     namespace VcardNamespace
 
     # Consolidate all namespaces at root
@@ -483,7 +483,7 @@ class Vcard < Lutaml::Model::Serializable
   # No DcTitleType attributes used
 
   xml do
-    root "vCard"
+    element "vCard"
     namespace VcardNamespace
 
     # Try to hoist unused DcNamespace
@@ -630,7 +630,7 @@ class Parent < Lutaml::Model::Serializable
   attribute :child_value, :string
 
   xml do
-    root "parent"
+    element "parent"
     namespace ParentNamespace
 
     map_element "child", to: :child_value
@@ -826,7 +826,7 @@ class Document < Lutaml::Model::Serializable
   attribute :title, DcTitleType  # Automatically uses DcNamespace
 
   xml do
-    root "document"
+    element "document"
     namespace DocumentNamespace
 
     map_element "title", to: :title  # Becomes <dc:title>
@@ -845,7 +845,7 @@ Simplest case—all elements in one namespace:
 ----
 class Document < Lutaml::Model::Serializable
   xml do
-    root "document"
+    element "document"
     namespace DocumentNamespace
     # No namespace_scope needed
   end
@@ -863,7 +863,7 @@ class Document < Lutaml::Model::Serializable
   attribute :created, DctermsCreatedType  # DctermsNamespace
 
   xml do
-    root "document"
+    element "document"
     namespace DocumentNamespace
     # No namespace_scope - Type namespaces hoist locally
   end
@@ -881,7 +881,7 @@ class Document < Lutaml::Model::Serializable
   attribute :created, DctermsCreatedType
 
   xml do
-    root "document"
+    element "document"
     namespace DocumentNamespace
 
     # Hoist all Type namespaces to root

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