xmi 0.5.11 → 0.6.0

data/lib/xmi/uml/profile_application.rb

@@ -2,32 +2,14 @@
 
 module Xmi
   module Uml
-    class ProfileApplicationAppliedProfile < Lutaml::Model::Serializable
-      skip_reference_registration
-      attribute :type, ::Xmi::Type::XmiType
-      attribute :href, :string
-
-      xml do
-        root "appliedProfile"
-        namespace ::Xmi::Namespace::Omg::Uml
-
-        map_attribute "type", to: :type
-        map_attribute "href", to: :href
-      end
-    end
-
-    class ProfileApplication < Lutaml::Model::Serializable
-      attribute :type, ::Xmi::Type::XmiType
-      attribute :id, ::Xmi::Type::XmiId
+    # UML `<profileApplication>` element — records that a Profile has
+    # been applied to the containing Package. Carries a single
+    # `<appliedProfile>` child holding the href reference.
+    class ProfileApplication < Base
       attribute :applied_profile, ProfileApplicationAppliedProfile
 
       xml do
         root "profileApplication"
-        namespace ::Xmi::Namespace::Omg::Uml
-
-        map_attribute "type", to: :type
-        map_attribute "id", to: :id
-
         map_element "appliedProfile", to: :applied_profile
       end
     end

data/lib/xmi/uml/profile_application_applied_profile.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Xmi
+  module Uml
+    # UML `<appliedProfile>` element — href reference to a Profile
+    # that has been applied to a Package. Child of `<profileApplication>`.
+    class ProfileApplicationAppliedProfile < Lutaml::Model::Serializable
+      skip_reference_registration
+      attribute :type, ::Xmi::Type::XmiType
+      attribute :href, :string
+
+      xml do
+        root "appliedProfile"
+        namespace ::Xmi::Namespace::Omg::Uml
+
+        map_attribute "type", to: :type
+        map_attribute "href", to: :href
+      end
+    end
+  end
+end

data/lib/xmi/uml/realization.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Xmi
+  module Uml
+    # UML `<packagedElement xmi:type="uml:Realization">`. Generic
+    # realization relationship. Note Sparx EA collapses strict
+    # `<interfaceRealization>` into this generic form; see
+    # InterfaceRealization for the strict-OMG form.
+    class Realization < PackagedElement
+    end
+  end
+end

data/lib/xmi/uml/signal.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Xmi
+  module Uml
+    # UML `<packagedElement xmi:type="uml:Signal">`. A signal is a
+    # classifier that communicates the sending of a message instance
+    # (UML 2.5 §17.4).
+    #
+    # Phase A of TODO.next/01: subclass is a type tag on
+    # PackagedElement. The union-bag attribute set is inherited
+    # unchanged so existing consumers keep working. Phase B
+    # (narrowing attrs to the subclass) is future work.
+    class Signal < PackagedElement
+    end
+  end
+end

data/lib/xmi/uml/slot.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Xmi
+  module Uml
+    class Slot < Base
+      attribute :defining_feature, :string
+      attribute :value, ValueSpecification, collection: true, polymorphic: true
+
+      xml do
+        root "slot"
+        map_attribute "definingFeature", to: :defining_feature
+
+        map_element "value", to: :value,
+                             polymorphic: VALUE_SPECIFICATION_POLYMORPHIC_MAP
+      end
+    end
+  end
+end

data/lib/xmi/uml/specification.rb

@@ -2,19 +2,14 @@
 
 module Xmi
   module Uml
-    class Specification < Lutaml::Model::Serializable
-      skip_reference_registration
-      attribute :id, ::Xmi::Type::XmiId
-      attribute :type, ::Xmi::Type::XmiType
+    class Specification < Base
       attribute :language, :string
+      attribute :content, :string
 
       xml do
         root "specification"
-        namespace ::Xmi::Namespace::Omg::Uml
-
-        map_attribute "id", to: :id
-        map_attribute "type", to: :type
         map_attribute "language", to: :language
+        map_content to: :content
       end
     end
   end

data/lib/xmi/uml/stereotype.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Xmi
+  module Uml
+    # UML `<packagedElement xmi:type="uml:Stereotype">. A stereotype
+    # is a kind of class defined to extend the UML metamodel
+    # (UML 2.5 §22.3).
+    #
+    # Phase A of TODO.next/01: subclass is a type tag on
+    # PackagedElement. The union-bag attribute set is inherited
+    # unchanged so existing consumers keep working. Phase B
+    # (narrowing attrs to the subclass) is future work.
+    class Stereotype < PackagedElement
+    end
+  end
+end

data/lib/xmi/uml/uml_class.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Xmi
+  module Uml
+    # UML `<packagedElement xmi:type="uml:Class">`. Classifier with
+    # attributes, operations, and structural relationships.
+    #
+    # Phase A of TODO.next/01: subclass is a type tag on
+    # PackagedElement. The union-bag attribute set is inherited
+    # unchanged so existing consumers keep working. Phase B
+    # (narrowing attrs to the subclass) is future work.
+    class UmlClass < PackagedElement
+    end
+  end
+end

data/lib/xmi/uml/uml_model.rb

@@ -2,27 +2,21 @@
 
 module Xmi
   module Uml
-    class UmlModel < Lutaml::Model::Serializable
-      skip_reference_registration
-      attribute :id, ::Xmi::Type::XmiId
-      attribute :type, ::Xmi::Type::XmiType
+    class UmlModel < Base
       attribute :name, :string
       attribute :profile_application, ProfileApplication, collection: true
-      attribute :packaged_element, PackagedElement, collection: true
+      attribute :packaged_element, PackagedElement, collection: true,
+                                                    polymorphic: true
       attribute :package_import, PackageImport, collection: true
       attribute :diagram, Diagram
 
       xml do
         root "Model"
-        namespace ::Xmi::Namespace::Omg::Uml
-
-        map_attribute "id", to: :id
-        map_attribute "type", to: :type
         map_attribute "name", to: :name
 
         map_element "packageImport", to: :package_import, value_map: VALUE_MAP
         map_element "packagedElement", to: :packaged_element,
-                                       value_map: VALUE_MAP
+                                       polymorphic: PACKAGED_ELEMENT_POLYMORPHIC_MAP
         map_element "Diagram", to: :diagram, form: :qualified
         map_element "profileApplication", to: :profile_application,
                                           value_map: VALUE_MAP

data/lib/xmi/uml/upper_value.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Xmi
+  module Uml
+    class UpperValue < DefaultValue
+      xml do
+        root "upperValue"
+      end
+    end
+  end
+end

data/lib/xmi/uml/usage.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Xmi
+  module Uml
+    # UML `<packagedElement xmi:type="uml:Usage">. A Dependency
+    # subtype indicating that a client requires a supplier for its
+    # proper functioning (UML 2.5 §19.3).
+    #
+    # Phase A of TODO.next/01: subclass is a type tag on
+    # PackagedElement. The union-bag attribute set is inherited
+    # unchanged so existing consumers keep working. Phase B
+    # (narrowing attrs to the subclass) is future work.
+    class Usage < PackagedElement
+    end
+  end
+end

data/lib/xmi/uml/value_specification.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Xmi
+  module Uml
+    # Abstract UML ValueSpecification. UML 2.5 §9.8 — the abstract
+    # parent of OpaqueExpression, LiteralString, LiteralInteger,
+    # LiteralBoolean, LiteralUnlimitedNatural, LiteralNull, etc.
+    #
+    # Used as the type of `Slot#value` and other polymorphic value
+    # attributes so the parser can dispatch on `xmi:type` to the
+    # right concrete subclass.
+    #
+    # Concrete subclasses live in their own files (literal_string.rb,
+    # opaque_expression.rb, etc.). Add new literals as a new file plus
+    # an entry in POLYMORPHIC_MAP below — OCP-friendly, no edits to
+    # callers.
+    class ValueSpecification < Base
+      attribute :type, ::Xmi::Type::XmiType, polymorphic_class: true
+
+      xml do
+        root "valueSpecification"
+        map_attribute "type", to: :type
+      end
+    end
+
+    # Shared polymorphic dispatch map for any attribute whose value
+    # is a ValueSpecification dispatched on `xmi:type`. Consumers:
+    # Slot#value, OwnedAttribute#upper_value/#lower_value/#default_value,
+    # OwnedEnd#upper_value/#lower_value/#default_value,
+    # OwnedParameter#upper_value/#lower_value/#default_value.
+    #
+    # The literal class names are string form because lutaml-model's
+    # resolve_polymorphic_class calls Object.const_get on the value.
+    VALUE_SPECIFICATION_POLYMORPHIC_MAP = {
+      attribute: "xmi:type",
+      class_map: {
+        "uml:OpaqueExpression" => "Xmi::Uml::OpaqueExpression",
+        "uml:LiteralString" => "Xmi::Uml::LiteralString",
+        "uml:LiteralInteger" => "Xmi::Uml::LiteralInteger",
+        "uml:LiteralBoolean" => "Xmi::Uml::LiteralBoolean",
+        "uml:LiteralUnlimitedNatural" => "Xmi::Uml::LiteralUnlimitedNatural",
+        "uml:LiteralNull" => "Xmi::Uml::LiteralNull",
+      },
+    }.freeze
+  end
+end

data/lib/xmi/uml/waypoint.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Xmi
+  module Uml
+    # UMLDI `<waypoint>` element — a point on a connector path.
+    class Waypoint < ::Xmi::UmlDi::Base
+      attribute :x, :integer
+      attribute :y, :integer
+
+      xml do
+        root "waypoint"
+        map_attribute "x", to: :x
+        map_attribute "y", to: :y
+      end
+    end
+  end
+end

data/lib/xmi/uml.rb

@@ -2,12 +2,22 @@
 
 module Xmi
   module Uml
+    autoload :Base, "xmi/uml/base"
     autoload :AnnotatedElement, "xmi/uml/annotated_element"
     autoload :Type, "xmi/uml/type"
     autoload :MemberEnd, "xmi/uml/member_end"
     autoload :DefaultValue, "xmi/uml/default_value"
-    autoload :UpperValue, "xmi/uml/default_value"
-    autoload :LowerValue, "xmi/uml/default_value"
+    autoload :UpperValue, "xmi/uml/upper_value"
+    autoload :LowerValue, "xmi/uml/lower_value"
+    autoload :ValueSpecification, "xmi/uml/value_specification"
+    autoload :LiteralString, "xmi/uml/literal_string"
+    autoload :LiteralInteger, "xmi/uml/literal_integer"
+    autoload :LiteralBoolean, "xmi/uml/literal_boolean"
+    autoload :LiteralUnlimitedNatural, "xmi/uml/literal_unlimited_natural"
+    autoload :LiteralNull, "xmi/uml/literal_null"
+    autoload :OpaqueExpression, "xmi/uml/opaque_expression"
+    autoload :Slot, "xmi/uml/slot"
+    autoload :InterfaceRealization, "xmi/uml/interface_realization"
     autoload :OwnedEnd, "xmi/uml/owned_end"
     autoload :OwnedLiteral, "xmi/uml/owned_literal"
     autoload :OwnedAttribute, "xmi/uml/owned_attribute"
@@ -18,16 +28,31 @@ module Xmi
     autoload :OwnedComment, "xmi/uml/owned_comment"
     autoload :AssociationGeneralization, "xmi/uml/association_generalization"
     autoload :PackagedElement, "xmi/uml/packaged_element"
+    autoload :UmlClass, "xmi/uml/uml_class"
+    autoload :Association, "xmi/uml/association"
+    autoload :Interface, "xmi/uml/interface"
+    autoload :InstanceSpecification, "xmi/uml/instance_specification"
+    autoload :DataType, "xmi/uml/data_type"
+    autoload :PrimitiveType, "xmi/uml/primitive_type"
+    autoload :Enumeration, "xmi/uml/enumeration"
+    autoload :Package, "xmi/uml/package"
+    autoload :Realization, "xmi/uml/realization"
+    autoload :Dependency, "xmi/uml/dependency"
+    autoload :Signal, "xmi/uml/signal"
+    autoload :AssociationClass, "xmi/uml/association_class"
+    autoload :Extension, "xmi/uml/extension"
+    autoload :Stereotype, "xmi/uml/stereotype"
+    autoload :Usage, "xmi/uml/usage"
     autoload :Bounds, "xmi/uml/bounds"
-    autoload :Waypoint, "xmi/uml/bounds"
+    autoload :Waypoint, "xmi/uml/waypoint"
     autoload :OwnedElement, "xmi/uml/owned_element"
     autoload :Diagram, "xmi/uml/diagram"
-    autoload :ProfileApplicationAppliedProfile, "xmi/uml/profile_application"
+    autoload :ProfileApplicationAppliedProfile,
+             "xmi/uml/profile_application_applied_profile"
     autoload :ProfileApplication, "xmi/uml/profile_application"
-    autoload :ImportedPackage, "xmi/uml/package_import"
+    autoload :ImportedPackage, "xmi/uml/imported_package"
     autoload :PackageImport, "xmi/uml/package_import"
     autoload :UmlModel, "xmi/uml/uml_model"
-    autoload :ProfileAttributes, "xmi/uml/profile"
     autoload :Profile, "xmi/uml/profile"
   end
 end

data/lib/xmi/uml_di/base.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Xmi
+  module UmlDi
+    # Common base for concrete UMLDI element classes. Parallel to
+    # Xmi::Uml::Base but in the UMLDI namespace (diagram interchange).
+    #
+    # Subclasses declare only their unique attributes + root element.
+    class Base < Lutaml::Model::Serializable
+      skip_reference_registration
+      attribute :type, ::Xmi::Type::XmiType
+      attribute :id, ::Xmi::Type::XmiId
+
+      xml do
+        namespace ::Xmi::Namespace::Omg::UmlDi
+
+        map_attribute "type", to: :type
+        map_attribute "id", to: :id
+      end
+    end
+  end
+end

data/lib/xmi/uml_di.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Xmi
+  # UML Diagram Interchange (UMLDI) classes. Parallel to Xmi::Uml
+  # but in the UMLDI namespace (http://www.omg.org/spec/UML/20131001/UMLDI).
+  # Used for diagram elements: Bounds, Waypoint, Diagram, OwnedElement.
+  module UmlDi
+    autoload :Base, "xmi/uml_di/base"
+  end
+end

data/lib/xmi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Xmi
-  VERSION = "0.5.11"
+  VERSION = "0.6.0"
 end

data/lib/xmi.rb

@@ -16,44 +16,55 @@ module Lutaml
   end
 end
 
-require_relative "xmi/version"
-require_relative "xmi/namespace"
-require_relative "xmi/namespace/dynamic"
-require_relative "xmi/type"
-require_relative "xmi/namespace_detector"
-require_relative "xmi/namespace_registry"
-require_relative "xmi/xmi_identity"
-
 module Xmi
+  autoload :VERSION, "xmi/version"
+  autoload :Namespace, "xmi/namespace"
+  autoload :Type, "xmi/type"
+  autoload :NamespaceDetector, "xmi/namespace_detector"
+  autoload :NamespaceRegistry, "xmi/namespace_registry"
+  autoload :XmiIdentity, "xmi/xmi_identity"
+  autoload :Versioned, "xmi/versioned"
+  autoload :VersionRegistry, "xmi/version_registry"
+  autoload :V20110701, "xmi/v20110701"
+  autoload :V20131001, "xmi/v20131001"
+  autoload :V20161101, "xmi/v20161101"
+  autoload :Add, "xmi/add"
+  autoload :Delete, "xmi/delete"
+  autoload :Difference, "xmi/difference"
+  autoload :Documentation, "xmi/documentation"
+  autoload :Extension, "xmi/extension"
+  autoload :Replace, "xmi/replace"
+  autoload :EaRoot, "xmi/ea_root"
+  autoload :Uml, "xmi/uml"
+  autoload :UmlDi, "xmi/uml_di"
+
   class Error < StandardError; end
 
-  # Shared value_map for XMI elements
-  # Used to handle nil, empty, and omitted values consistently
+  # Shared value_map for XMI elements.
+  #
+  # Parsing (`from:`) stays flexible: nil / empty / omitted all map
+  # to the symbol `:empty`, which the parser uses to materialise an
+  # empty model on the attribute. This preserves absence-vs-empty
+  # distinctions on the way IN.
+  #
+  # Serialization (`to:`) is generation-friendly: nil / empty /
+  # omitted all map to `:omitted`, which means "do not emit the
+  # element". This eliminates the post-processing step the ea gem
+  # previously needed (XmlSanitizer) to strip truly-empty elements
+  # that real Sparx XMI never carries.
+  #
+  # This is a breaking change from the previous symmetric VALUE_MAP
+  # (which emitted `<child/>` for empty collections). Consumers that
+  # relied on empty-element round-trip must update.
   VALUE_MAP = {
     from: { nil: :empty, empty: :empty, omitted: :empty },
-    to: { nil: :empty, empty: :empty, omitted: :empty },
+    to: { nil: :omitted, empty: :omitted, omitted: :omitted },
   }.freeze
 end
 
 # Bootstrap the namespace registry
 Xmi::NamespaceRegistry.bootstrap!
 
-# Version infrastructure
-require_relative "xmi/versioned"
-require_relative "xmi/version_registry"
-require_relative "xmi/v20110701"
-require_relative "xmi/v20131001"
-require_relative "xmi/v20161101"
-
-require_relative "xmi/add"
-require_relative "xmi/delete"
-require_relative "xmi/difference"
-require_relative "xmi/documentation"
-require_relative "xmi/extension"
-require_relative "xmi/replace"
-require_relative "xmi/ea_root"
-require_relative "xmi/uml"
-
 module Xmi
   # Lazy-loaded top-level modules — autoload avoids loading these
   # until their constants are actually referenced at runtime.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: xmi
 version: !ruby/object:Gem::Version
-  version: 0.5.11
+  version: 0.6.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-29 00:00:00.000000000 Z
+date: 2026-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -159,11 +159,29 @@ files:
 - lib/xmi/type.rb
 - lib/xmi/uml.rb
 - lib/xmi/uml/annotated_element.rb
+- lib/xmi/uml/association.rb
+- lib/xmi/uml/association_class.rb
 - lib/xmi/uml/association_generalization.rb
+- lib/xmi/uml/base.rb
 - lib/xmi/uml/bounds.rb
+- lib/xmi/uml/data_type.rb
 - lib/xmi/uml/default_value.rb
+- lib/xmi/uml/dependency.rb
 - lib/xmi/uml/diagram.rb
+- lib/xmi/uml/enumeration.rb
+- lib/xmi/uml/extension.rb
+- lib/xmi/uml/imported_package.rb
+- lib/xmi/uml/instance_specification.rb
+- lib/xmi/uml/interface.rb
+- lib/xmi/uml/interface_realization.rb
+- lib/xmi/uml/literal_boolean.rb
+- lib/xmi/uml/literal_integer.rb
+- lib/xmi/uml/literal_null.rb
+- lib/xmi/uml/literal_string.rb
+- lib/xmi/uml/literal_unlimited_natural.rb
+- lib/xmi/uml/lower_value.rb
 - lib/xmi/uml/member_end.rb
+- lib/xmi/uml/opaque_expression.rb
 - lib/xmi/uml/owned_attribute.rb
 - lib/xmi/uml/owned_comment.rb
 - lib/xmi/uml/owned_element.rb
@@ -171,14 +189,28 @@ files:
 - lib/xmi/uml/owned_literal.rb
 - lib/xmi/uml/owned_operation.rb
 - lib/xmi/uml/owned_parameter.rb
+- lib/xmi/uml/package.rb
 - lib/xmi/uml/package_import.rb
 - lib/xmi/uml/packaged_element.rb
 - lib/xmi/uml/precondition.rb
+- lib/xmi/uml/primitive_type.rb
 - lib/xmi/uml/profile.rb
 - lib/xmi/uml/profile_application.rb
+- lib/xmi/uml/profile_application_applied_profile.rb
+- lib/xmi/uml/realization.rb
+- lib/xmi/uml/signal.rb
+- lib/xmi/uml/slot.rb
 - lib/xmi/uml/specification.rb
+- lib/xmi/uml/stereotype.rb
 - lib/xmi/uml/type.rb
+- lib/xmi/uml/uml_class.rb
 - lib/xmi/uml/uml_model.rb
+- lib/xmi/uml/upper_value.rb
+- lib/xmi/uml/usage.rb
+- lib/xmi/uml/value_specification.rb
+- lib/xmi/uml/waypoint.rb
+- lib/xmi/uml_di.rb
+- lib/xmi/uml_di/base.rb
 - lib/xmi/v20110701.rb
 - lib/xmi/v20131001.rb
 - lib/xmi/v20161101.rb