Migration Guide
===============

This section documents changes in XGEE that require manual adjustments to existing projects.

ShapeFromResource Attributes Cleanup
------------------------------------

The attributes ``sizeX`` and ``sizeY`` have been removed from the ``ShapeFromResource`` class in the Editor Model (``editorModel.ecore``). These attributes were obsolete and ignored by the XGEE runtime, as the size is controlled by the containing object (e.g., Vertex).

**Action Required:**
You must update your ``.editorModel`` files to remove these attributes from any ``ShapeFromResource`` elements. Failure to do so may prevent the model from loading.

**Example Migration:**

*Old code (Allocations.editorModel):*

.. code-block:: xml

   <shape xsi:type="xgeeDisplayStyles:ShapeFromResource" sizeX="20.0" sizeY="20.0" filepath="shapes/io.svg"/>

*New code:*

.. code-block:: xml

   <shape xsi:type="xgeeDisplayStyles:ShapeFromResource" filepath="shapes/io.svg"/>

**Note:** The effective size of the element continues to be determined by the ``sizeX`` and ``sizeY`` attributes of the parent ``Vertex``, ``SubVertex``, or ``Container``.

ReferringObject Attributes Deprecation
--------------------------------------

The ``refersTo`` containment reference and the attributes ``nsURI`` and ``className`` on ``ReferringObject`` (inherited by ``Vertex``, ``Edge``, ``SubVertex``) have been deprecated. These fields are ignored by the XGEE runtime, which relies on the ``Editor`` configuration and ``queryStr`` for type resolution.

**Runtime Warning:**
XGEE will now issue a console warning if it detects that ``refersTo`` (with content), ``nsURI``, or ``className`` are set in your editor model.

**Action Required:**
Update your ``.editorModel`` files to remove the ``<refersTo>`` block and the ``nsURI`` / ``className`` attributes from ``Vertex`` and ``Edge`` definitions. The metamodel constraint has been relaxed (``lowerBound="0"``) to facilitate this removal.

**Example Migration:**

*Old code:*

.. code-block:: xml

   <displayableObjects xsi:type="xgeeDisplayObjects:Vertex" name="Task" nsURI="http://oaam.de/oaam/model/functions" className="Task">
      <refersTo refNsURI="http://oaam.de/oaam/model/functions" refClassname="Task"/>
      <!-- ... -->
   </displayableObjects>

*New code:*

.. code-block:: xml

   <displayableObjects xsi:type="xgeeDisplayObjects:Vertex" name="Task">
      <!-- refersTo, nsURI, and className removed -->
      <!-- ... -->
   </displayableObjects>