lutaml-model 0.8.12 → 0.8.13

data/RELEASE_NOTES.adoc

@@ -26,7 +26,7 @@ The `namespace_scope` directive allows you to control WHERE namespace declaratio
 ----
 class Vcard < Lutaml::Model::Serializable
   xml do
-    root "vCard"
+    element "vCard"
     namespace VcardNamespace
 
     # Consolidate namespaces at root
@@ -145,7 +145,7 @@ class SomeModel < Lutaml::Model::Serializable
   attribute :coll, :string, collection: true
 
   xml do
-    root "some-model"
+    element "some-model"
     map_element 'collection', to: :coll
   end
 end
@@ -209,7 +209,7 @@ class SomeModel < Lutaml::Model::Serializable
   attribute :coll, :string, collection: true
 
   xml do
-    root "some-model"
+    element "some-model"
     map_element 'collection', to: :coll, render_nil: :omit
   end
 

data/benchmark/quick_benchmark.rb

@@ -30,7 +30,7 @@ class Item < Lutaml::Model::Serializable
   attribute :value, :float
 
   xml do
-    root "item"
+    element "item"
     map_attribute "id", to: :id
     map_element "name", to: :name
     map_element "value", to: :value
@@ -47,7 +47,7 @@ class Container < Lutaml::Model::Serializable
   attribute :items, Item, collection: true
 
   xml do
-    root "container"
+    element "container"
     map_element "item", to: :items
   end
 

data/benchmark/serialization_benchmark.rb

@@ -49,7 +49,7 @@ class SimpleModel < Lutaml::Model::Serializable
   attribute :created_at, :date_time
 
   xml do
-    root "simple"
+    element "simple"
     map_attribute "id", to: :id
     map_element "name", to: :name
     map_element "active", to: :active
@@ -79,7 +79,7 @@ class AddressModel < Lutaml::Model::Serializable
   attribute :postal_code, :string
 
   xml do
-    root "address"
+    element "address"
     map_element "street", to: :street
     map_element "city", to: :city
     map_element "country", to: :country
@@ -106,7 +106,7 @@ class PersonModel < Lutaml::Model::Serializable
   attribute :tags, :string, collection: true
 
   xml do
-    root "person"
+    element "person"
     map_attribute "id", to: :id
     map_element "first_name", to: :first_name
     map_element "last_name", to: :last_name
@@ -136,7 +136,7 @@ class DepartmentModel < Lutaml::Model::Serializable
   attribute :employees, PersonModel, collection: true
 
   xml do
-    root "department"
+    element "department"
     map_element "name", to: :name
     map_element "code", to: :code
     map_element "employee", to: :employees

data/docs/_guides/advanced-mapping.adoc

@@ -47,7 +47,7 @@ class CustomModel < Lutaml::Model::Serializable
   end
 
   xml do
-    root "CustomModel"
+    element "CustomModel"
     map_element ["name", "custom-name"], with: { to: :name_to_xml, from: :name_from_xml }
     map_element ["color", "shade"], with: { to: :color_to_xml, from: :color_from_xml }
     map_attribute ["id", "identifier"], to: :id

data/docs/_guides/character-encoding.adoc

@@ -79,7 +79,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
@@ -140,7 +140,7 @@ class Ceramic < Lutaml::Model::Serializable
   attribute :temperature, :integer
 
   xml do
-    root 'ceramic'
+    element "ceramic"
     map_element 'potter', to: :potter
     map_content to: :description
   end
@@ -191,7 +191,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/_guides/missing-values-handling.adoc

@@ -1246,7 +1246,7 @@ class SomeModel < Lutaml::Model::Serializable
   attribute :coll, :string, collection: true
 
   xml do
-    root "some-model"
+    element "some-model"
     map_element 'collection', to: :coll, render_nil: :omit
   end
 
@@ -1285,7 +1285,7 @@ class SomeModel < Lutaml::Model::Serializable
   attribute :coll, :string, collection: true
 
   xml do
-    root "some-model"
+    element "some-model"
     map_element 'collection', to: :coll, render_nil: :as_nil
   end
 
@@ -1327,7 +1327,7 @@ class SomeModel < Lutaml::Model::Serializable
   attribute :coll, :string, collection: true
 
   xml do
-    root "some-model"
+    element "some-model"
     map_element 'collection', to: :coll, render_nil: :as_blank # <1>
   end
 
@@ -1424,7 +1424,7 @@ class SomeModel < Lutaml::Model::Serializable
   attribute :coll, :string, collection: true
 
   xml do
-    root "some-model"
+    element "some-model"
     map_element 'collection', to: :coll, render_empty: :omit
   end
 
@@ -1461,7 +1461,7 @@ class SomeModel < Lutaml::Model::Serializable
   attribute :coll, :string, collection: true
 
   xml do
-    root "some-model"
+    element "some-model"
     map_element 'collection', to: :coll, render_empty: :as_nil
   end
 
@@ -1503,7 +1503,7 @@ class SomeModel < Lutaml::Model::Serializable
   attribute :coll, :string, collection: true
 
   xml do
-    root "some-model"
+    element "some-model"
     map_element 'collection', to: :coll, render_empty: :as_blank # <1>
   end
 

data/docs/_guides/ooxml-examples.adoc

@@ -101,7 +101,7 @@ class PersonName < Lutaml::Model::Serializable
   attribute :suffix, :string
 
   xml do
-    root "personName"
+    element "personName"
     map_element "givenName", to: :given_name
     map_element "surname", to: :surname
     map_attribute "prefix", to: :prefix
@@ -114,7 +114,7 @@ class Contact < Lutaml::Model::Serializable
   attribute :person_name, PersonName
 
   xml do
-    root "ContactInfo"
+    element "ContactInfo"
     map_element "personName", to: :person_name
   end
 end
@@ -233,7 +233,7 @@ class DctermsCreated < Lutaml::Model::Serializable
   attribute :type, XsiTypeType
 
   xml do
-    root "created"
+    element "created"
     namespace DctermsNamespace
     map_attribute "type", to: :type
     map_content to: :value
@@ -246,7 +246,7 @@ class DctermsModified < Lutaml::Model::Serializable
   attribute :type, XsiTypeType
 
   xml do
-    root "modified"
+    element "modified"
     namespace DctermsNamespace
     map_attribute "type", to: :type
     map_content to: :value
@@ -263,7 +263,7 @@ class CoreProperties < Lutaml::Model::Serializable
   attribute :modified, DctermsModified
 
   xml do
-    root "coreProperties"
+    element "coreProperties"
     map_element "title", to: :title
     map_element "creator", to: :creator
     map_element "lastModifiedBy", to: :last_modified_by
@@ -420,7 +420,7 @@ class Settings < Lutaml::Model::Serializable
   attribute :chart_tracking, :boolean
 
   xml do
-    root "settings"
+    element "settings"
     namespace WNamespace
     namespace_scope [W14Namespace, W15Namespace]
 
@@ -655,7 +655,7 @@ class Settings < Lutaml::Model::Serializable
   attribute :w15_doc_id, W15DocId
 
   xml do
-    root "settings"
+    element "settings"
     namespace WNamespace
     namespace_scope [W14Namespace, W15Namespace]
 

data/docs/_guides/opal.adoc

@@ -172,7 +172,7 @@ class Person
   attribute :age, :integer
 
   xml do
-    root "person"
+    element "person"
     map_element "name", to: :name
     map_element "age", to: :age
   end

data/docs/_guides/value-transformations.adoc

@@ -275,7 +275,7 @@ class Event < Lutaml::Model::Serializable
   attribute :event_date, MultiFormatDate
 
   xml do
-    root "event"
+    element "event"
     map_element "eventDate", to: :event_date
   end
 
@@ -402,7 +402,7 @@ class Document < Lutaml::Model::Serializable
   }
 
   xml do
-    root "document"
+    element "document"
     map_element "pubDate", to: :publication_date
   end
 
@@ -505,7 +505,7 @@ class Document < Lutaml::Model::Serializable
 
   # XML wants YYYYMMDD
   xml do
-    root "document"
+    element "document"
     map_element "pubDate", to: :publication_date, transform: {
       export: ->(date) { date&.strftime("%Y%m%d") },
       import: ->(str) {
@@ -749,7 +749,7 @@ class Product < Lutaml::Model::Serializable
   end
 
   xml do
-    root "product"
+    element "product"
     map_element "name", to: :name, transform: {
       export: ->(value) { "XML:#{value}" },
       import: ->(value) { value.gsub("XML:", "") }
@@ -898,7 +898,7 @@ class Event < Lutaml::Model::Serializable
   attribute :name, :string
 
   xml do
-    root "event"
+    element "event"
     map_element "eventDate", to: :event_date
     map_element "name", to: :name
   end
@@ -1029,7 +1029,7 @@ class Schedule < Lutaml::Model::Serializable
   attribute :activity, :string
 
   xml do
-    root "schedule"
+    element "schedule"
     map_element "date", to: :week_date
     map_element "activity", to: :activity
   end
@@ -1100,7 +1100,7 @@ class BlogPost < Lutaml::Model::Serializable
 
   # XML API requires YYYYMMDD
   xml do
-    root "post"
+    element "post"
     map_element "publishDate", to: :published_on, transform: {
       export: ->(date) { date&.strftime("%Y%m%d") },
       import: ->(str) {

data/docs/_guides/xml/namespace-presentation.adoc

@@ -185,7 +185,7 @@ class NamespacedItem < Lutaml::Model::Serializable
   attribute :alt_name, SecondNamespacedName # SecondNamespace
 
   xml do
-    root "item"
+    element "item"
     namespace SecondNamespace  # Root uses SecondNamespace
     map_element "name", to: :name
     map_element "alt_name", to: :alt_name

data/docs/_guides/xml/namespace-semantics.adoc

@@ -43,7 +43,7 @@ class NativeItem < Lutaml::Model::Serializable
   attribute :name, :string  # Native type with no inherent namespace
 
   xml do
-    root "first_item"
+    element "first_item"
     namespace FirstItemNamespace
     map_element "name", to: :name
   end
@@ -97,7 +97,7 @@ class NamespacedItem < Lutaml::Model::Serializable
   attribute :alt_name, SecondNamespacedName # Has SecondNamespace
 
   xml do
-    root "second_item"
+    element "second_item"
     namespace SecondNamespace
     map_element "name", to: :name
     map_element "alt_name", to: :alt_name
@@ -127,7 +127,7 @@ class NestedItem < Lutaml::Model::Serializable
   attribute :value, :string
 
   xml do
-    root "nested"
+    element "nested"
     namespace FirstNamespace
     map_element "value", to: :value
   end
@@ -137,7 +137,7 @@ class Container < Lutaml::Model::Serializable
   attribute :item, NestedItem
 
   xml do
-    root "container"
+    element "container"
     namespace SecondNamespace
     map_element "item", to: :item
   end
@@ -162,7 +162,7 @@ end
 [source,ruby]
 ----
 xml do
-  root "item"
+  element "item"
   namespace MyNamespace
   map_attribute "id", to: :id          # Unqualified (no namespace)
   map_element "name", to: :name         # Qualified (uses MyNamespace)
@@ -200,7 +200,7 @@ class Item < Lutaml::Model::Serializable
   attribute :value, :integer
 
   xml do
-    root "item"
+    element "item"
     namespace MyNamespace
     map_attribute "id", to: :id
     map_attribute "value", to: :value
@@ -280,7 +280,7 @@ class Spacing < Lutaml::Model::Serializable
   attribute :before, :integer
 
   xml do
-    root "spacing"
+    element "spacing"
     namespace WordProcessingML
     map_attribute "val", to: :val
     map_attribute "after", to: :after
@@ -330,7 +330,7 @@ class Item < Lutaml::Model::Serializable
   attribute :explicit, :string
 
   xml do
-    root "item"
+    element "item"
     namespace Namespace1
     map_attribute "normal", to: :normal           # Uses form_default (unqualified)
     map_attribute "explicit", to: :explicit, namespace: Namespace2  # Explicit wins
@@ -397,7 +397,7 @@ class NativeItemNames < Lutaml::Model::Serializable
   attribute :name, :string, collection: true
 
   xml do
-    root "item_names"
+    element "item_names"
     namespace FirstItemNamespace
     map_element "name", to: :name
   end
@@ -422,7 +422,7 @@ class NativeItemCollection < Lutaml::Model::Serializable
   attribute :items, NativeItem, collection: true
 
   xml do
-    root "items"
+    element "items"
     namespace FirstItemNamespace
     map_element "item", to: :items
   end
@@ -441,7 +441,7 @@ class Container < Lutaml::Model::Serializable
   attribute :items, BaseItem, collection: true, polymorphic: [TypeA, TypeB]
 
   xml do
-    root "container"
+    element "container"
     map_element "item", to: :items
   end
 end
@@ -557,7 +557,7 @@ class Child < Lutaml::Model::Serializable
   attribute :value, :string
 
   xml do
-    root "child"
+    element "child"
     # No namespace declared - will inherit from parent
     map_element "value", to: :value
   end
@@ -567,7 +567,7 @@ class Parent < Lutaml::Model::Serializable
   attribute :child, Child
 
   xml do
-    root "parent"
+    element "parent"
     namespace ParentNamespace
     map_element "child", to: :child
   end
@@ -594,7 +594,7 @@ class Wrapper < Lutaml::Model::Serializable
   attribute :items, NamespacedItem, collection: true
 
   xml do
-    root "wrapper"
+    element "wrapper"
     namespace WrapperNamespace
     map_element "item", to: :items
   end
@@ -635,7 +635,7 @@ class PlainItem < Lutaml::Model::Serializable
   attribute :name, :string
 
   xml do
-    root "item"
+    element "item"
     # No namespace declared
     map_element "name", to: :name
   end

data/docs/_guides/xml/type-namespaces.adoc

@@ -52,7 +52,7 @@ class Article < Lutaml::Model::Serializable
   attribute :creator, DcCreatorType
 
   xml do
-    root "article"
+    element "article"
     namespace ArticleNamespace
 
     map_element "title", to: :title
@@ -89,7 +89,7 @@ class Article < Lutaml::Model::Serializable
   attribute :title, DcTitleType
 
   xml do
-    root "article"
+    element "article"
     namespace ArticleNamespace
     map_element "title", to: :title
   end
@@ -145,7 +145,7 @@ class Article < Lutaml::Model::Serializable
   attribute :creator, DcCreatorType
 
   xml do
-    root "article"
+    element "article"
     namespace ArticleNamespace
     namespace_scope [ArticleNamespace, DublinCoreNamespace]  # <1>
 
@@ -247,7 +247,7 @@ class CoreProperties < Lutaml::Model::Serializable
   attribute :created, DctermsCreatedType
 
   xml do
-    root 'coreProperties'
+    element "coreProperties"
     namespace CorePropertiesNamespace
     namespace_scope [
       CorePropertiesNamespace,
@@ -303,7 +303,7 @@ class Product < Lutaml::Model::Serializable
   attribute :schema_type, XsiTypeType
 
   xml do
-    root 'product'
+    element "product"
     map_attribute 'type', to: :schema_type  # <1>
   end
 end
@@ -559,7 +559,7 @@ class BookMetadata < Lutaml::Model::Serializable
   attribute :date, DcDateType
 
   xml do
-    root "metadata"
+    element "metadata"
     namespace_scope [DublinCoreNamespace]
 
     map_element "title", to: :title
@@ -646,7 +646,7 @@ class Vcard < Lutaml::Model::Serializable
   attribute :version, :string
 
   xml do
-    root "vCard"
+    element "vCard"
     namespace VcardNamespace
     namespace_scope [
       VcardNamespace,
@@ -716,7 +716,7 @@ class Article < Lutaml::Model::Serializable
   attribute :title, CustomTitle  # Uses CustomTitle's namespace
 
   xml do
-    root "article"
+    element "article"
     map_element "title", to: :title
   end
 end
@@ -784,7 +784,7 @@ class Article < Lutaml::Model::Serializable
   attribute :keywords, :string, collection: true  # No namespace
 
   xml do
-    root "article"
+    element "article"
     namespace ArticleNamespace
     namespace_scope [ArticleNamespace, DublinCoreNamespace]