[1525] Add support for the management of the appearance of custom nodes

Bug: #1525
Signed-off-by: Axel RICHARD <axel.richard@obeo.fr>

Author: AxelRICHARD

CHANGELOG.adoc

@@ -82,6 +82,12 @@ Consumers may override this by providing an implementation of `org.eclipse.syson
 
 - https://github.com/eclipse-syson/syson/issues/1314[#1314] [diagrams] (Almost) All node descriptions are now synchronized (based on the exposed elements of ViewUsages).
 This contribution allows to switch from one _ViewDefinition_ to another one in a _ViewUsage_ without having to re-create the diagram.
+- https://github.com/eclipse-syson/syson/issues/1525[#1525] [diagrams] Add support for the management of the appearance of custom nodes (`Package`, `ImportedPackage`, `Note` and `ViewFrame`) with the extension point `PaletteAppearanceSectionContribution`.
+* `DiagramImporterSysMLPackageNodeStyleAppearanceChangeHandler implements IDiagramImporterNodeStyleAppearanceChangeHandler` allows the importation of diagram with `Package` nodes that have custom appearance.
+* `EditSysMLPackageNodeAppearanceEventHandler implements IDiagramEventHandler` adds the needed `appearanceChanges` to the `diagramContext` after receiving the mutation.
+* `SysMLPackageNodeAppearanceHandler implements INodeAppearanceHandler` handles how the node is updated from the `appearanceChanges`.
+* A GraphQL mutation is also added through `editSysMLPackageNodeAppearance`.
+* Same mechanism is applied to `ImportedPackage`, `Note` and `ViewFrame` nodes.
 
 == v2025.8.0
 

backend/application/syson-application-configuration/src/main/java/org/eclipse/syson/application/nodes/SysMLImportedPackageNodeStyle.java

@@ -46,6 +46,10 @@ public static Builder newSysMLImportedPackageNodeStyle() {
         return new Builder();
     }
 
+    public static Builder newSysMLImportedPackageNodeStyle(SysMLImportedPackageNodeStyle nodeStyle) {
+        return new Builder(nodeStyle);
+    }
+
     public String getBackground() {
         return this.background;
     }
@@ -95,6 +99,14 @@ private Builder() {
             // Prevent instantiation
         }
 
+        private Builder(SysMLImportedPackageNodeStyle nodeStyle) {
+            this.background = nodeStyle.getBackground();
+            this.borderColor = nodeStyle.getBorderColor();
+            this.borderSize = nodeStyle.getBorderSize();
+            this.borderStyle = nodeStyle.getBorderStyle();
+            this.childrenLayoutStrategy = nodeStyle.getChildrenLayoutStrategy();
+        }
+
         public Builder background(String background) {
             this.background = Objects.requireNonNull(background);
             return this;

backend/application/syson-application-configuration/src/main/java/org/eclipse/syson/application/nodes/SysMLNoteNodeStyle.java

@@ -47,6 +47,10 @@ public static Builder newSysMLNoteNodeStyle() {
         return new Builder();
     }
 
+    public static Builder newSysMLNoteNodeStyle(SysMLNoteNodeStyle nodeStyle) {
+        return new Builder(nodeStyle);
+    }
+
     public String getBackground() {
         return this.background;
     }
@@ -96,6 +100,14 @@ private Builder() {
             // Prevent instantiation
         }
 
+        private Builder(SysMLNoteNodeStyle nodeStyle) {
+            this.background = nodeStyle.getBackground();
+            this.borderColor = nodeStyle.getBorderColor();
+            this.borderSize = nodeStyle.getBorderSize();
+            this.borderStyle = nodeStyle.getBorderStyle();
+            this.childrenLayoutStrategy = nodeStyle.getChildrenLayoutStrategy();
+        }
+
         public Builder background(String background) {
             this.background = Objects.requireNonNull(background);
             return this;

backend/application/syson-application-configuration/src/main/java/org/eclipse/syson/application/nodes/SysMLPackageNodeStyle.java

@@ -47,6 +47,10 @@ public static Builder newSysMLPackageNodeStyle() {
         return new Builder();
     }
 
+    public static Builder newSysMLPackageNodeStyle(SysMLPackageNodeStyle nodeStyle) {
+        return new Builder(nodeStyle);
+    }
+
     public String getBackground() {
         return this.background;
     }
@@ -96,6 +100,14 @@ private Builder() {
             // Prevent instantiation
         }
 
+        private Builder(SysMLPackageNodeStyle nodeStyle) {
+            this.background = nodeStyle.getBackground();
+            this.borderColor = nodeStyle.getBorderColor();
+            this.borderSize = nodeStyle.getBorderSize();
+            this.borderStyle = nodeStyle.getBorderStyle();
+            this.childrenLayoutStrategy = nodeStyle.getChildrenLayoutStrategy();
+        }
+
         public Builder background(String background) {
             this.background = Objects.requireNonNull(background);
             return this;

backend/application/syson-application-configuration/src/main/java/org/eclipse/syson/application/nodes/SysMLViewFrameNodeStyle.java

@@ -48,6 +48,10 @@ public static Builder newSysMLViewFrameNodeStyle() {
         return new Builder();
     }
 
+    public static Builder newSysMLViewFrameNodeStyle(SysMLViewFrameNodeStyle nodeStyle) {
+        return new Builder(nodeStyle);
+    }
+
     public String getBackground() {
         return this.background;
     }
@@ -103,6 +107,15 @@ private Builder() {
             // Prevent instantiation
         }
 
+        private Builder(SysMLViewFrameNodeStyle nodeStyle) {
+            this.background = nodeStyle.getBackground();
+            this.borderColor = nodeStyle.getBorderColor();
+            this.borderSize = nodeStyle.getBorderSize();
+            this.borderStyle = nodeStyle.getBorderStyle();
+            this.borderRadius = nodeStyle.getBorderRadius();
+            this.childrenLayoutStrategy = nodeStyle.getChildrenLayoutStrategy();
+        }
+
         public Builder background(String background) {
             this.background = Objects.requireNonNull(background);
             return this;

backend/application/syson-application-configuration/src/main/java/org/eclipse/syson/application/nodes/dto/EditSysMLImportedPackageNodeAppearanceInput.java

@@ -0,0 +1,26 @@
+/*******************************************************************************
+ * Copyright (c) 2025 Obeo.
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v2.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *     Obeo - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.syson.application.nodes.dto;
+
+import java.util.UUID;
+
+import org.eclipse.sirius.components.collaborative.diagrams.api.IDiagramInput;
+
+/**
+ * Input for the edition of a SysMLImportedPackage node's appearance.
+ *
+ * @author arichard
+ */
+public record EditSysMLImportedPackageNodeAppearanceInput(UUID id, String editingContextId, String representationId, String nodeId, SysMLImportedPackageNodeAppearanceInput appearance)
+        implements IDiagramInput {
+}

backend/application/syson-application-configuration/src/main/java/org/eclipse/syson/application/nodes/dto/EditSysMLNoteNodeAppearanceInput.java

@@ -0,0 +1,25 @@
+/*******************************************************************************
+ * Copyright (c) 2025 Obeo.
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v2.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *     Obeo - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.syson.application.nodes.dto;
+
+import java.util.UUID;
+
+import org.eclipse.sirius.components.collaborative.diagrams.api.IDiagramInput;
+
+/**
+ * Input for the edition of a SysMLPackage node's appearance.
+ *
+ * @author arichard
+ */
+public record EditSysMLNoteNodeAppearanceInput(UUID id, String editingContextId, String representationId, String nodeId, SysMLNoteNodeAppearanceInput appearance) implements IDiagramInput {
+}

backend/application/syson-application-configuration/src/main/java/org/eclipse/syson/application/nodes/dto/EditSysMLPackageNodeAppearanceInput.java

@@ -0,0 +1,25 @@
+/*******************************************************************************
+ * Copyright (c) 2025 Obeo.
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v2.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *     Obeo - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.syson.application.nodes.dto;
+
+import java.util.UUID;
+
+import org.eclipse.sirius.components.collaborative.diagrams.api.IDiagramInput;
+
+/**
+ * Input for the edition of a SysMLPackage node's appearance.
+ *
+ * @author arichard
+ */
+public record EditSysMLPackageNodeAppearanceInput(UUID id, String editingContextId, String representationId, String nodeId, SysMLPackageNodeAppearanceInput appearance) implements IDiagramInput {
+}

backend/application/syson-application-configuration/src/main/java/org/eclipse/syson/application/nodes/dto/EditSysMLViewFrameNodeAppearanceInput.java

@@ -0,0 +1,25 @@
+/*******************************************************************************
+ * Copyright (c) 2025 Obeo.
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v2.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *     Obeo - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.syson.application.nodes.dto;
+
+import java.util.UUID;
+
+import org.eclipse.sirius.components.collaborative.diagrams.api.IDiagramInput;
+
+/**
+ * Input for the edition of a SysMLViewFrame node's appearance.
+ *
+ * @author arichard
+ */
+public record EditSysMLViewFrameNodeAppearanceInput(UUID id, String editingContextId, String representationId, String nodeId, SysMLViewFrameNodeAppearanceInput appearance) implements IDiagramInput {
+}

backend/application/syson-application-configuration/src/main/java/org/eclipse/syson/application/nodes/dto/SysMLImportedPackageNodeAppearanceInput.java

@@ -0,0 +1,23 @@
+/*******************************************************************************
+ * Copyright (c) 2025 Obeo.
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v2.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *     Obeo - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.syson.application.nodes.dto;
+
+import org.eclipse.sirius.components.diagrams.LineStyle;
+
+/**
+ * Input for the edition of a SysMLImportedPackage node's appearance.
+ *
+ * @author arichard
+ */
+public record SysMLImportedPackageNodeAppearanceInput(String background, String borderColor, Integer borderSize, LineStyle borderStyle) {
+}