feat: schema changes: support moved_to and moved_from

sources/express-changes/document.adoc

@@ -38,8 +38,8 @@ include::sections/05-schema-change.adoc[]
 
 include::sections/06-mapping-change.adoc[]
 
-include::sections/aa-examples.adoc[]
+include::sections/aa-schemas.adoc[]
 
-include::sections/ab-schemas.adoc[]
+include::sections/ab-examples.adoc[]
 
 include::sections/az-bibliography.adoc[]

sources/express-changes/examples/arm.changes.moved.yaml

@@ -0,0 +1,47 @@
+# yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/schema_changes.yaml
+---
+schema: Extended_basic_geometry_arm
+versions:
+- version: 2
+  modifications:
+  - type: SUBTYPE_CONSTRAINT
+    name: alternate_extended_geometry_item
+  deletions:
+  - type: SUBTYPE_CONSTRAINT
+    name: axis_placement_subtype
+  - type: ENTITY
+    name: Axis_placement_2d
+    moved_to:
+      schema: Elemental_geometric_shape_arm
+  - type: ENTITY
+    name: Axis_placement_3d
+    moved_to:
+      schema: Elemental_geometric_shape_arm
+- version: 3
+  additions:
+  - type: USE_FROM
+    name: Geometric_model_relationship_arm
+  modifications:
+  - type: REFERENCE_FROM
+    name: alternate_extended_geometry_item
+  deletions:
+  - type: SUBTYPE_CONSTRAINT
+    name: Characterizable_object_arm
+    interfaced_items:
+    - bag_to_set
+  - type: ENTITY
+    name: Definitional_representation_relationship
+    moved_to:
+      schema: Geometric_model_relationship_arm
+  - type: ENTITY
+    name: Geometric_model_relationship
+    moved_to:
+      schema: Geometric_model_relationship
+  - type: FUNCTION
+    name: acyclic_representation_relationship
+    moved_to:
+      schema: Geometric_model_relationship
+- version: 4
+  modifications:
+  - type: SUBTYPE_CONSTRAINT
+    name: alternate_extended_geometry_item

sources/express-changes/examples/mim.changes.moved.yaml

@@ -0,0 +1,86 @@
+# yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/schema_changes.yaml
+---
+schema: Associative_draughting_elements_mim
+versions:
+- version: 3
+  additions:
+  - type: TYPE
+    name: draughting_model_item_definition
+  modifications:
+  - type: ENTITY
+    name: draughting_model_item_association
+- version: 4
+  additions:
+  - type: USE_FROM
+    name: geometric_model_schema
+    interfaced_items:
+    - geometric_set
+  - type: USE_FROM
+    name: draughting_element_schema
+    interfaced_items:
+    - annotation_plane
+  - type: USE_FROM
+    name: draughting_element_schema
+    interfaced_items:
+    - des_annotation_representation_select
+  - type: USE_FROM
+    name: draughting_element_schema
+    interfaced_items:
+    - draughting_model_item_association
+  - type: USE_FROM
+    name: draughting_element_schema
+    interfaced_items:
+    - draughting_model_item_definition
+  - type: USE_FROM
+    name: draughting_element_schema
+    interfaced_items:
+    - tessellated_annotation_occurence
+  - type: USE_FROM
+    name: presentation_definition_schema
+    interfaced_items:
+    - annotation_curve_occurrence
+  - type: USE_FROM
+    name: presentation_definition_schema
+    interfaced_items:
+    - annotation_fill_area_occurrence
+  - type: USE_FROM
+    name: presentation_definition_schema
+    interfaced_items:
+    - annotation_point_occurrence
+  - type: USE_FROM
+    name: presentation_definition_schema
+    interfaced_items:
+    - annotation_symbol_occurrence
+  - type: USE_FROM
+    name: presentation_definition_schema
+    interfaced_items:
+    - annotation_text_occurrence
+  - type: USE_FROM
+    name: product_property_definitin_schema
+    interfaced_items:
+    - product_definition_shape
+  - type: USE_FROM
+    name: product_property_definitin_schema
+    interfaced_items:
+    - property_definition
+  - type: USE_FROM
+    name: product_property_definitin_schema
+    interfaced_items:
+    - shape_aspect
+  - type: USE_FROM
+    name: product_property_definitin_schema
+    interfaced_items:
+    - shape_aspect_relationship
+  deletions:
+  - type: TYPE
+    name: draughting_model_item_association_select
+    moved_to:
+      schema: draughting_element_schema
+  - type: TYPE
+    name: draughting_model_item_definition
+    moved_to:
+      schema: draughting_element_schema
+  - type: ENTITY
+    name: draughting_model_item_assocation
+    moved_to:
+      schema: draughting_element_schema

sources/express-changes/schemas/schema_changes.yaml

@@ -1,4 +1,4 @@
-$schema: http://json-schema.org/draft-07/schema#
+$schema: http://json-schema.org/draft-04/schema#
 title: EXPRESS Schema Changes
 description: Records modifications to EXPRESS schema structure across versions
 type: object
@@ -33,23 +33,22 @@ definitions:
           Provides comprehensive overview of what changed and why.
       additions:
         type: array
-        description: Array of added elements
+        description: Array of addition changes representing added elements
         items:
-          $ref: '#/definitions/item_change'
+          $ref: '#/definitions/addition_change'
       modifications:
         type: array
-        description: Array of modified elements
+        description: Array of modification changes representing modifications
         items:
-          $ref: '#/definitions/item_change'
+          $ref: '#/definitions/modification_change'
       deletions:
         type: array
-        description: Array of deleted elements
+        description: Array of deletion changes representing removed elements
         items:
-          $ref: '#/definitions/item_change'
+          $ref: '#/definitions/deletion_change'
   item_change:
     type: object
     description: Represents a specific schema element change
-    additionalProperties: false
     required:
       - type
       - name
@@ -84,3 +83,44 @@ definitions:
           or used. Not needed when in deletions.
         items:
           type: string
+  modification_change:
+    description: Represents a modification to the schema
+    $ref: '#/definitions/item_change'
+  addition_change:
+    description: Represents an addition to the schema
+    allOf:
+      - $ref: '#/definitions/item_change'
+      - properties:
+          moved_from:
+            type: object
+            description: >-
+              If the addition was due to a move from another schema, provides
+              the resource and module where it was moved from.
+            required:
+              - schema
+            properties:
+              schema:
+                type: string
+                description: Name of the schema where the item was moved from
+              version:
+                type: integer
+                description: Version number in the source schema
+  deletion_change:
+    description: Represents a deletion from the schema
+    allOf:
+      - $ref: '#/definitions/item_change'
+      - properties:
+          moved_to:
+            type: object
+            description: >-
+              If the deletion was due to a move to another schema, provides
+              the resource and module where it was moved to.
+            required:
+              - schema
+            properties:
+              schema:
+                type: string
+                description: Name of the schema where the item was moved to
+              version:
+                type: integer
+                description: Version number in the target schema

sources/express-changes/sections/04-structure.adoc

@@ -16,7 +16,7 @@ specification.
 schema: String (required)
   # Name of the EXPRESS schema
 versions:
-  - version: String (required)
+  - version: Integer (required)
     # Version number for this change version
     description: String (optional)
     # Description of changes in this version