xmi 0.5.12 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4268a73b32cabe65fa9a63dc4e87588941df98e4480697e704e19d33be0d4d2f
-  data.tar.gz: b92789685eee2191f08b81537f1a4c6740ae5bdba96a48060992174ee7a2b58a
+  metadata.gz: db371f76bfe7fa3b6f16392f150e7bdd4a70b390053317de58ae11ea4d469fa8
+  data.tar.gz: b5d0ac779b25967ba94abaa37ec726414a296680c313d451dbc7f3ec230ab4f1
 SHA512:
-  metadata.gz: abcee32a264c8519d7e7a5110cc89e6327e20dce2ded8999266aa928c67e59daf0f993f3b8577d6c628137345b10367e9fbb23b8d832c1d49bafbbeda83ec43d
-  data.tar.gz: 2d46d5677820d183a9d33418ead0ff9cf4ffe8d887aa16e629c27d782e282baa4a94ca08d8bc1cb531728e781d4613e09f371e7454b3fc94bb306271807ddadf
+  metadata.gz: 6caff8c35f558fb0394b45cea65f04094ffc546b69844f2a7d8ce1fa946a1e961ece15e5569ae170a82e33b57dd007ea313e0f3d6c966251ef18d4dcefe8d94b
+  data.tar.gz: e3f580a640f314257ecd3a0c8d387dbb4e2136c7845b17dbaa99e79ab3b3bda00eb4291c77dcb3e9089bdb3bafdd8396a501b64c5b1faab291eb0f703bc1aa46

data/.gitignore

@@ -14,3 +14,11 @@
 Gemfile.lock
 .DS_Store
 /old-docs
+
+# Editor / sed transient files
+*.bak
+*.swp
+*~
+
+# Local TODO scratchpads (track work in issues/PRs instead)
+TODO*

data/CLAUDE.md

@@ -102,24 +102,39 @@ end
 
 ### Model Definition Pattern
 
-Models use lutaml-model syntax with explicit namespace declarations:
-```ruby
-class MyModel < Lutaml::Model::Serializable
-  attribute :id, ::Xmi::Type::XmiId
+Concrete UML classes inherit from `Xmi::Uml::Base`, which carries
+the shared boilerplate (`skip_reference_registration`, `type` and
+`id` attrs, UML namespace, and their `map_attribute` lines).
+Subclasses declare only their unique attributes and the `root`
+element name. Verified via spike: lutaml-model inherits `xml do`
+block contents (namespace + map_attribute) from the parent class.
 
-  xml do
-    root "Model"
-    namespace ::Xmi::Namespace::Omg::Uml
-    namespace_scope [::Xmi::Namespace::Omg::Xmi, ::Xmi::Namespace::Omg::Uml]
-
-    # Attributes with XMI namespace require explicit declaration
-    map_attribute "id", to: :id,
-                       namespace: "http://www.omg.org/spec/XMI/20131001",
-                       prefix: "xmi"
+UML Diagram Interchange elements (Bounds, Waypoint, Diagram,
+OwnedElement) inherit from `Xmi::UmlDi::Base` instead — same
+pattern, different namespace.
+
+```ruby
+# lib/xmi/uml/my_element.rb
+module Xmi
+  module Uml
+    class MyElement < Base
+      attribute :name, :string
+
+      xml do
+        root "myElement"
+        map_attribute "name", to: :name
+      end
+    end
   end
 end
 ```
 
+For backward compatibility, raw `Lutaml::Model::Serializable`
+inheritance still works but is discouraged for new UML classes.
+The small reference-holder classes (AnnotatedElement, MemberEnd,
+Type, ImportedPackage) intentionally stay direct from Serializable
+because they don't carry the type+id pair that Base provides.
+
 ### Dynamic Extension Loading
 
 `Xmi::EaRoot.load_extension(xml_path)` dynamically generates Ruby classes from EA MDG extension XML files. This creates stereotype classes under `Xmi::EaRoot::{ModuleName}::{ClassName}` and updates `Root` mappings.
@@ -128,6 +143,15 @@ Extensions use `NamespaceRegistry` to look up or create namespace classes dynami
 - Existing namespace URIs resolve to predefined classes
 - New URIs create dynamic classes under `Xmi::Namespace::Dynamic::{ModuleName}`
 
+### Polymorphic Dispatch
+
+Two attributes use lutaml-model's polymorphic dispatch on `xmi:type`:
+
+- `PackagedElement.packaged_element` (and `UmlModel.packaged_element`) — dispatches to typed subclasses (`UmlClass`, `Association`, `Interface`, `InstanceSpecification`, etc.). Map: `Xmi::Uml::PACKAGED_ELEMENT_POLYMORPHIC_MAP` in `lib/xmi/uml/packaged_element.rb`.
+- `Slot.value`, `OwnedAttribute.upper_value`/`lower_value`/`default_value`, `OwnedEnd.upper_value`/`lower_value`/`default_value`, `OwnedParameter.upper_value`/`lower_value`/`default_value` — dispatch to ValueSpecification subclasses (`OpaqueExpression`, `LiteralString`, `LiteralInteger`, etc.). Map: `Xmi::Uml::VALUE_SPECIFICATION_POLYMORPHIC_MAP` in `lib/xmi/uml/value_specification.rb`.
+
+**Known limitation:** polymorphic dispatch crashes with `TypeError` if the discriminator is missing or unrecognized. This is a lutaml-model upstream issue (it calls `Object.const_get(nil)`); the failure mode is locked in by `spec/xmi/uml/polymorphic_robustness_spec.rb`. Fix lives upstream, not here.
+
 ### Key Files
 
 | File | Purpose |
@@ -136,7 +160,12 @@ Extensions use `NamespaceRegistry` to look up or create namespace classes dynami
 | `lib/xmi/sparx.rb` | Module with autoload declarations for Sparx components |
 | `lib/xmi/sparx/root.rb` | Main `Root` class with parsing and namespace normalization |
 | `lib/xmi/root.rb` | Base `Root` class with common XMI attributes |
-| `lib/xmi/uml.rb` | UML model classes (UmlModel, PackagedElement, etc.) |
+| `lib/xmi/uml.rb` | UML model autoload entries |
+| `lib/xmi/uml/base.rb` | `Xmi::Uml::Base` — common boilerplate for UML classes |
+| `lib/xmi/uml_di.rb` | UML Diagram Interchange autoload entries |
+| `lib/xmi/uml_di/base.rb` | `Xmi::UmlDi::Base` — common boilerplate for UMLDI classes |
+| `lib/xmi/uml/packaged_element.rb` | `PackagedElement` + `PACKAGED_ELEMENT_POLYMORPHIC_MAP` |
+| `lib/xmi/uml/value_specification.rb` | `ValueSpecification` abstract base + `VALUE_SPECIFICATION_POLYMORPHIC_MAP` |
 | `lib/xmi/ea_root.rb` | Dynamic extension loading from MDG XML |
 | `lib/xmi/type.rb` | Custom types with namespace declarations (XmiId, XmiType, etc.) |
 | `lib/xmi/namespace/omg.rb` | OMG namespace classes (XMI, UML, UmlDi, UmlDc) |

data/lib/xmi/add.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "difference"
-require_relative "extension"
-
 module Xmi
   class Add < Lutaml::Model::Serializable
     skip_reference_registration

data/lib/xmi/delete.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "difference"
-require_relative "extension"
-
 module Xmi
   class Delete < Lutaml::Model::Serializable
     skip_reference_registration

data/lib/xmi/difference.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "extension"
-
 module Xmi
   class Difference < Lutaml::Model::Serializable
     skip_reference_registration

data/lib/xmi/documentation.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "extension"
-
 module Xmi
   class Documentation < Lutaml::Model::Serializable
     skip_reference_registration

data/lib/xmi/ea_root.rb

@@ -1,13 +1,14 @@
 # frozen_string_literal: true
 
 require "nokogiri"
-require_relative "ea_root/xml_parsing"
-require_relative "ea_root/code_generation"
-require_relative "ea_root/extension_lifecycle"
-require_relative "ea_root/namespace_handling"
 
 module Xmi
   class EaRoot
+    autoload :XmlParsing, "xmi/ea_root/xml_parsing"
+    autoload :CodeGeneration, "xmi/ea_root/code_generation"
+    autoload :ExtensionLifecycle, "xmi/ea_root/extension_lifecycle"
+    autoload :NamespaceHandling, "xmi/ea_root/namespace_handling"
+
     extend XmlParsing
     extend CodeGeneration
     extend ExtensionLifecycle

data/lib/xmi/namespace.rb

@@ -2,8 +2,8 @@
 
 module Xmi
   module Namespace
+    autoload :Omg, "xmi/namespace/omg"
+    autoload :Sparx, "xmi/namespace/sparx"
+    autoload :Dynamic, "xmi/namespace/dynamic"
   end
 end
-
-require_relative "namespace/omg"
-require_relative "namespace/sparx"

data/lib/xmi/replace.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "difference"
-require_relative "extension"
-
 module Xmi
   class Replace < Lutaml::Model::Serializable
     skip_reference_registration

data/lib/xmi/root.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "documentation"
-require_relative "uml"
-
 module Xmi
   class Root < Lutaml::Model::Serializable
     skip_reference_registration

data/lib/xmi/type.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "namespace"
-
 module Xmi
   module Type
     class XmiIdRef < Lutaml::Model::Type::String

data/lib/xmi/uml/association.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Association">`. Binary

data/lib/xmi/uml/association_class.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:AssociationClass">`. An

data/lib/xmi/uml/bounds.rb

@@ -2,10 +2,8 @@
 
 module Xmi
   module Uml
-    class Bounds < Lutaml::Model::Serializable
-      skip_reference_registration
-      attribute :type, ::Xmi::Type::XmiType
-      attribute :id, ::Xmi::Type::XmiId
+    # UMLDI `<bounds>` element — a rectangle in diagram coordinates.
+    class Bounds < ::Xmi::UmlDi::Base
       attribute :x, :integer
       attribute :y, :integer
       attribute :height, :integer
@@ -13,10 +11,6 @@ module Xmi
 
       xml do
         root "bounds"
-        namespace ::Xmi::Namespace::Omg::UmlDi
-
-        map_attribute "type", to: :type
-        map_attribute "id", to: :id
         map_attribute "x", to: :x
         map_attribute "y", to: :y
         map_attribute "height", to: :height

data/lib/xmi/uml/data_type.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:DataType">`. Classifier

data/lib/xmi/uml/default_value.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "value_specification"
-
 module Xmi
   module Uml
     # Default value wrapper. Semantically a ValueSpecification

data/lib/xmi/uml/dependency.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Dependency">`. A relationship

data/lib/xmi/uml/diagram.rb

@@ -2,20 +2,14 @@
 
 module Xmi
   module Uml
-    class Diagram < Lutaml::Model::Serializable
-      skip_reference_registration
-      attribute :type, ::Xmi::Type::XmiType
-      attribute :id, ::Xmi::Type::XmiId
+    # UMLDI `<Diagram>` element — root of a diagram's interchange view.
+    class Diagram < ::Xmi::UmlDi::Base
       attribute :is_frame, :boolean
       attribute :model_element, :string
       attribute :owned_element, OwnedElement, collection: true
 
       xml do
         root "Diagram"
-        namespace ::Xmi::Namespace::Omg::UmlDi
-
-        map_attribute "type", to: :type
-        map_attribute "id", to: :id
         map_attribute "isFrame", to: :is_frame
         map_attribute "modelElement", to: :model_element
 

data/lib/xmi/uml/enumeration.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Enumeration">`. Named

data/lib/xmi/uml/extension.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Extension">`. An extension

data/lib/xmi/uml/instance_specification.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:InstanceSpecification">`.

data/lib/xmi/uml/interface.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Interface">`. Contract

data/lib/xmi/uml/lower_value.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "default_value"
-
 module Xmi
   module Uml
     class LowerValue < DefaultValue

data/lib/xmi/uml/owned_element.rb

@@ -2,10 +2,10 @@
 
 module Xmi
   module Uml
-    class OwnedElement < Lutaml::Model::Serializable
-      skip_reference_registration
-      attribute :type, ::Xmi::Type::XmiType
-      attribute :id, ::Xmi::Type::XmiId
+    # UMLDI `<ownedElement>` — a diagram element (shape, label, etc.).
+    # Carries text, optional nested ownedElement children, bounds,
+    # and source/target/waypoint for connectors.
+    class OwnedElement < ::Xmi::UmlDi::Base
       attribute :text, :string
       attribute :model_element, :string
       attribute :owned_element, OwnedElement, collection: true
@@ -16,10 +16,6 @@ module Xmi
 
       xml do
         root "ownedElement"
-        namespace ::Xmi::Namespace::Omg::UmlDi
-
-        map_attribute "type", to: :type
-        map_attribute "id", to: :id
         map_attribute "text", to: :text
         map_attribute "modelElement", to: :model_element
 

data/lib/xmi/uml/package.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Package">`. Container for

data/lib/xmi/uml/package_import.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "imported_package"
-
 module Xmi
   module Uml
     class PackageImport < Lutaml::Model::Serializable

data/lib/xmi/uml/primitive_type.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:PrimitiveType">`.

data/lib/xmi/uml/profile.rb

@@ -1,23 +1,24 @@
 # frozen_string_literal: true
 
-require_relative "profile_attributes"
-
 module Xmi
   module Uml
-    class Profile < Lutaml::Model::Serializable
-      skip_reference_registration
-      include ProfileAttributes
-
+    # UML `<Profile>` element (UML 2.5 §22.3). A stereotyped package
+    # that extends the UML metamodel. Carries owned comments, package
+    # imports, nested packaged elements, and profile-specific metadata
+    # (nsPrefix, metamodelReference).
+    class Profile < Base
+      attribute :name, :string
+      attribute :ns_prefix, :string
+      attribute :metamodel_reference, :string
+      attribute :packaged_element, PackagedElement, collection: true
+      attribute :package_import, PackageImport, collection: true
       attribute :owned_comment, OwnedComment, collection: true
 
       xml do
         root "Profile"
-        namespace ::Xmi::Namespace::Omg::Uml
-
-        map_attribute "id", to: :id
         map_attribute "name", to: :name
-        map_attribute "metamodelReference", to: :metamodel_reference
         map_attribute "nsPrefix", to: :ns_prefix
+        map_attribute "metamodelReference", to: :metamodel_reference
 
         map_element "ownedComment", to: :owned_comment, value_map: VALUE_MAP
         map_element "packageImport", to: :package_import, value_map: VALUE_MAP

data/lib/xmi/uml/profile_application.rb

@@ -1,21 +1,15 @@
 # frozen_string_literal: true
 
-require_relative "profile_application_applied_profile"
-
 module Xmi
   module Uml
-    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/realization.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Realization">`. Generic

data/lib/xmi/uml/signal.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Signal">`. A signal is a

data/lib/xmi/uml/stereotype.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Stereotype">. A stereotype

data/lib/xmi/uml/uml_class.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Class">`. Classifier with

data/lib/xmi/uml/uml_model.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     class UmlModel < Base

data/lib/xmi/uml/upper_value.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "default_value"
-
 module Xmi
   module Uml
     class UpperValue < DefaultValue

data/lib/xmi/uml/usage.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "packaged_element"
-
 module Xmi
   module Uml
     # UML `<packagedElement xmi:type="uml:Usage">. A Dependency

data/lib/xmi/uml/waypoint.rb

@@ -2,19 +2,13 @@
 
 module Xmi
   module Uml
-    class Waypoint < Lutaml::Model::Serializable
-      skip_reference_registration
-      attribute :type, ::Xmi::Type::XmiType
-      attribute :id, ::Xmi::Type::XmiId
+    # UMLDI `<waypoint>` element — a point on a connector path.
+    class Waypoint < ::Xmi::UmlDi::Base
       attribute :x, :integer
       attribute :y, :integer
 
       xml do
         root "waypoint"
-        namespace ::Xmi::Namespace::Omg::UmlDi
-
-        map_attribute "type", to: :type
-        map_attribute "id", to: :id
         map_attribute "x", to: :x
         map_attribute "y", to: :y
       end

data/lib/xmi/uml.rb

@@ -53,7 +53,6 @@ module Xmi
     autoload :ImportedPackage, "xmi/uml/imported_package"
     autoload :PackageImport, "xmi/uml/package_import"
     autoload :UmlModel, "xmi/uml/uml_model"
-    autoload :ProfileAttributes, "xmi/uml/profile_attributes"
     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.12"
+  VERSION = "0.6.0"
 end

data/lib/xmi.rb

@@ -16,15 +16,28 @@ 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.
@@ -52,22 +65,6 @@ 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.12
+  version: 0.6.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-02 00:00:00.000000000 Z
+date: 2026-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -57,9 +57,6 @@ files:
 - Gemfile
 - README.adoc
 - Rakefile
-- TODO.next/01-packaged-element-typed-subclasses.md
-- TODO.next/03-real-sparx-instancespec-fixture.md
-- TODO.next/README.md
 - bin/console
 - bin/setup
 - docs/migration.md
@@ -200,7 +197,6 @@ files:
 - lib/xmi/uml/profile.rb
 - lib/xmi/uml/profile_application.rb
 - lib/xmi/uml/profile_application_applied_profile.rb
-- lib/xmi/uml/profile_attributes.rb
 - lib/xmi/uml/realization.rb
 - lib/xmi/uml/signal.rb
 - lib/xmi/uml/slot.rb
@@ -213,6 +209,8 @@ files:
 - 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

data/TODO.next/01-packaged-element-typed-subclasses.md

@@ -1,94 +0,0 @@
-# 01 — PackagedElement typed subclasses (Phase B remaining)
-
-**Status: PARTIAL — Phase A landed (2026-07-03); Phase B (narrowing
-attrs to subclasses) deferred.**
-
-## What landed (Phase A)
-
-Polymorphic dispatch on `PackagedElement.packaged_element` and
-`UmlModel.packaged_element`. Each `<packagedElement xmi:type="uml:X">`
-now parses to a corresponding `Xmi::Uml::X` subclass:
-
-| xmi:type | Ruby class |
-|---|---|
-| uml:Class | `Xmi::Uml::UmlClass` |
-| uml:Association | `Xmi::Uml::Association` |
-| uml:Interface | `Xmi::Uml::Interface` |
-| uml:InstanceSpecification | `Xmi::Uml::InstanceSpecification` |
-| uml:DataType | `Xmi::Uml::DataType` |
-| uml:PrimitiveType | `Xmi::Uml::PrimitiveType` |
-| uml:Enumeration | `Xmi::Uml::Enumeration` |
-| uml:Package | `Xmi::Uml::Package` |
-| uml:Realization | `Xmi::Uml::Realization` |
-
-Dispatch map: `Xmi::Uml::PACKAGED_ELEMENT_POLYMORPHIC_MAP` in
-`lib/xmi/uml/packaged_element.rb`. Spec coverage:
-`spec/xmi/uml/packaged_element_dispatch_spec.rb` (17 examples).
-
-Subclasses currently inherit the **full union-bag attribute set**
-from `PackagedElement`. Consumers can dispatch on `is_a?(Xmi::Uml::X)`
-for type-specific behavior, but accessing the wrong attr on the wrong
-type still returns nil/empty rather than raising.
-
-## What's deferred (Phase B)
-
-Narrow each subclass's attribute set to its UML-2.5-conformant subset.
-Examples:
-
-| Class | Valid attrs (today, all inherited) |
-|---|---|
-| UmlClass | owned_attribute, owned_operation, owned_comment, generalization, interface_realization, nested packaged_element |
-| Association | owned_end, member_end, member_ends |
-| InstanceSpecification | classifier, slot, specification |
-| Interface | owned_operation, generalization |
-| Enumeration | owned_literal |
-| DataType | owned_attribute, owned_operation |
-| PrimitiveType | (none) |
-| Realization | supplier, client |
-| Package | nested packaged_element |
-
-After Phase B, `instance.owned_attribute` raises NoMethodError on an
-InstanceSpecification — the type system catches the misuse at runtime.
-
-## Why Phase B is deferred
-
-- **Breaking change.** Every consumer that accesses attrs via the
-  base `PackagedElement` type breaks. The `lutaml/ea` transformer
-  walks packaged_element generically; it would need type-specific
-  dispatch added.
-- **Test churn.** Every Sparx fixture regression test that accesses
-  `pe.owned_attribute` (etc.) on a generic PackagedElement needs
-  updating.
-- **Limited semantic gain.** Phase A already gives consumers the
-  type tag. Phase B catches programming errors but doesn't enable
-  new functionality.
-- The original TODO.next/01 design doc proposed Phase A as
-  "risk-free" and Phase B as the "breaking change." That framing
-  holds.
-
-## Rollout strategy for Phase B
-
-1. Survey every consumer of `PackagedElement` attrs in `lutaml/ea`,
-   `lutaml/lutaml-uml`, and downstream.
-2. For each consumer, change to type-specific dispatch:
-   ```ruby
-   case pe
-   when Xmi::Uml::UmlClass then pe.owned_attribute ...
-   when Xmi::Uml::Association then pe.owned_end ...
-   end
-   ```
-3. Once consumers are type-aware, narrow subclass attrs.
-4. Remove the narrowed attrs from `PackagedElement`.
-
-This is a multi-PR change. Each step should land separately so
-bisect works.
-
-## Open questions
-
-- Should `Generalization` move from `packagedElement` to its own
-  child element shape to match OMG XMI? Sparx uses both. Defer.
-- How to handle EA's `uml:ExtensionEnd` and other Sparx-isms? Treat
-  as subclasses of the closest OMG type.
-- The polymorphic dispatch failure mode (unknown xmi:type raises
-  TypeError) is locked in by `polymorphic_robustness_spec.rb`. Phase B
-  doesn't fix this; it's a separate concern.

data/TODO.next/03-real-sparx-instancespec-fixture.md

@@ -1,56 +0,0 @@
-# 03 — Real Sparx InstanceSpecification fixture (FUTURE)
-
-**Status: FUTURE — requires Sparx EA access to acquire the fixture.
-Migrated from `TODO.refactor/16` (2026-07-02).**
-
-## Problem
-
-The fixture added in TODO.refactor/08
-(`spec/fixtures/sparx-instance-specification.xmi`) is hand-authored
-to match Sparx EA's mixed-prefix style. It is structurally faithful
-but not byte-identical to real EA output.
-
-Several details can drift between synthetic and real:
-
-- Whitespace and indentation (tabs vs spaces, blank lines).
-- Attribute ordering within an element.
-- Presence of EA-specific boilerplate (`xmi:Documentation exporter="Enterprise Architect" exporterVersion="..."`).
-- Sparx's `EAID_` GUID format (uppercase hex with underscores, vs.
-  the synthetic lowercase).
-- Inclusion of `<xrefs>` elements on slot values (Sparx adds
-  cross-references for tracked links).
-- The `<extensions>` element with EA-specific `<elements>` and
-  `<connectors>` sections.
-
-## Goal
-
-Acquire a real Sparx EA export that contains at least one:
-
-- `<packagedElement xmi:type="uml:InstanceSpecification">` with
-  `<slot>` children carrying `<value>` of various `xmi:type`.
-- `<interfaceRealization>` (strict OMG form, even though current
-  Sparx collapses to `uml:Realization`).
-
-Replace `sparx-instance-specification.xmi` with the real fixture,
-or add it as a sibling file. Update parity specs to use the real
-fixture.
-
-## Acquisition
-
-Requires Sparx EA access. Suggested steps:
-
-1. In EA, create a small model with one Class, one
-   InstanceSpecification, and one InterfaceRealization.
-2. Publish to XMI (EA's "Publish to File" or "Export to XMI").
-3. Trim sensitive content if any.
-4. Commit the fixture with a `<!-- Exported from Sparx EA vX.Y on
-   YYYY-MM-DD, trimmed for the lutaml/xmi test suite. -->` header.
-
-## Verification
-
-- Real fixture parses without error.
-- All existing parity specs continue to pass (or are updated to
-  match real content).
-- Coverage of `<value>` `xmi:type` variants matches what real EA
-  emits (OpaqueExpression is the common case; LiteralString for
-  default values).

data/TODO.next/README.md

@@ -1,17 +0,0 @@
-# TODO.next — xmi gem follow-ups
-
-Open design items after the OwnedEnd schema migration and
-ValueSpecification polymorphic dispatch landed. Each file has a
-Status header:
-
-- **DONE** — completed; kept for context
-- **DESIGN-ONLY** — design document, not implemented; awaiting user direction
-- **FUTURE** — needs resources (real Sparx EA access, etc.) to unblock
-- **PARTIAL** — some paths landed, others deferred; see file for breakdown
-
-## Index
-
-| # | Title | Status |
-|---|---|---|
-| 01 | [PackagedElement typed subclasses](01-packaged-element-typed-subclasses.md) | PARTIAL (Phase A done, Phase B deferred) |
-| 03 | [Real Sparx InstanceSpecification fixture](03-real-sparx-instancespec-fixture.md) | FUTURE |

data/lib/xmi/uml/profile_attributes.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-# Shared attribute declarations for Profile-like classes.
-# Mixed into Profile via `include ProfileAttributes`.
-module Xmi
-  module Uml
-    module ProfileAttributes
-      def self.included(klass)
-        klass.class_eval do
-          attribute :packaged_element, PackagedElement, collection: true
-          attribute :package_import, PackageImport, collection: true
-          attribute :id, ::Xmi::Type::XmiId
-          attribute :name, :string
-          attribute :ns_prefix, :string
-          attribute :metamodel_reference, :string
-        end
-      end
-    end
-  end
-end