release: VisuStruct 1.2.0

Add Kotlin simulation engine and UI (play/step/stop, variables, I/O,
diagram spotlight). Bump Maven artifact to 1.2.0, extend i18n, palette
Lucide icons for simulation/code/about, macOS packaging tweaks, and tests.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: code4teaching

README.md

@@ -22,6 +22,12 @@ git clone https://github.com/code4teaching/VisuStruct.git
 
 ---
 
+## Changes in 1.2.0 (summary)
+
+- **Simulation (prep):** **Kotlin** in the Maven build; **`SimulationDocument`** and related types plus **XML decode** aligned with the existing diagram file format; **`Struktogramm.toSimulationDocument()`** exports the current editor state for a future **`step()`** engine (no simulation UI yet).
+
+Full notes: [`release-notes/v1.2.0.md`](release-notes/v1.2.0.md).
+
 ## Changes in 1.1.4 (summary)
 
 - **Diagram:** canvas **view zoom** with **⌘+ / ⌘−** (macOS) or **Ctrl+ / Ctrl−** (Windows/Linux); **no** block resize via mouse wheel anymore.
@@ -127,7 +133,7 @@ This release aligns **branding and technical identity** with **VisuStruct**. **`
 - **Java 17** target (build and run with JDK 17+).
 - **FlatLaf** light/dark themes; **JDOM2**; no legacy AppleJavaExtensions.
 - **Motif** look-and-feel removed; **Metal** and FlatLaf available.
-- Current fat JAR name follows **`pom.xml`** **`version`** (e.g. **`visustruct-1.1.4.jar`**).
+- Current fat JAR name follows **`pom.xml`** **`version`** (e.g. **`visustruct-1.2.0.jar`**).
 
 ---
 
@@ -202,13 +208,13 @@ chmod +x mvnw
 Output (version from `pom.xml`):
 
 ```text
-target/visustruct-1.1.4.jar
+target/visustruct-1.2.0.jar
 ```
 
 ## Run
 
 ```bash
-java -jar target/visustruct-1.1.4.jar
+java -jar target/visustruct-1.2.0.jar
 ```
 
 Double-click may work if `.jar` is associated with Java.

packaging/macos/build-lightweight-app.sh

@@ -4,7 +4,7 @@
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-VER="${PROJECT_VERSION:-1.1.4}"
+VER="${PROJECT_VERSION:-1.2.0}"
 JAR_NAME="visustruct-${VER}.jar"
 OUT="${ROOT}/dist/macos-app-light"
 APP="${OUT}/VisuStruct.app"

packaging/macos/build-macos-app.sh

@@ -4,7 +4,7 @@
 # Voraussetzung: JDK 17+ mit jpackage (im PATH oder JAVA_HOME).
 set -euo pipefail
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-VER="${PROJECT_VERSION:-1.1.4}"
+VER="${PROJECT_VERSION:-1.2.0}"
 JAR="visustruct-${VER}.jar"
 INPUT="${ROOT}/target"
 OUT="${ROOT}/dist/macos-app"

pom.xml

@@ -4,12 +4,13 @@
 	<modelVersion>4.0.0</modelVersion>
 	<groupId>de.visustruct</groupId>
 	<artifactId>visustruct</artifactId>
-	<version>1.1.4</version>
+	<version>1.2.0</version>
 	<name>VisuStruct</name>
 
 	<properties>
 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 		<maven.compiler.release>17</maven.compiler.release>
+		<kotlin.version>2.0.21</kotlin.version>
 	</properties>
 
 	<scm>
@@ -34,6 +35,17 @@
 			<artifactId>flatlaf-extras</artifactId>
 			<version>3.7.1</version>
 		</dependency>
+		<dependency>
+			<groupId>org.jetbrains.kotlin</groupId>
+			<artifactId>kotlin-stdlib</artifactId>
+			<version>${kotlin.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>org.junit.jupiter</groupId>
+			<artifactId>junit-jupiter</artifactId>
+			<version>5.10.2</version>
+			<scope>test</scope>
+		</dependency>
 	</dependencies>
 
 	<build>
@@ -57,6 +69,38 @@
 			</resource>
 		</resources>
 		<plugins>
+			<!-- Kotlin vor Java kompilieren (Java darf Kotlin-APIs nutzen). -->
+			<plugin>
+				<groupId>org.jetbrains.kotlin</groupId>
+				<artifactId>kotlin-maven-plugin</artifactId>
+				<version>${kotlin.version}</version>
+				<executions>
+					<execution>
+						<id>compile</id>
+						<goals>
+							<goal>compile</goal>
+						</goals>
+						<phase>process-sources</phase>
+					</execution>
+					<execution>
+						<id>test-compile</id>
+						<goals>
+							<goal>test-compile</goal>
+						</goals>
+						<phase>test-compile</phase>
+					</execution>
+				</executions>
+				<configuration>
+					<jvmTarget>17</jvmTarget>
+					<!-- Explizite Pfade: Default-Erkennung lieferte in diesem Projekt „No sources“ (z. B. # im Pfad). -->
+					<sourceDirs>
+						<sourceDir>src/main/kotlin</sourceDir>
+					</sourceDirs>
+					<testSourceDirs>
+						<testSourceDir>src/test/kotlin</testSourceDir>
+					</testSourceDirs>
+				</configuration>
+			</plugin>
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-compiler-plugin</artifactId>

release-notes/v1.2.0.md

@@ -0,0 +1,15 @@
+# VisuStruct 1.2.0
+
+Release **after** **1.1.4** (GitHub `master`).
+
+## Simulation (Kotlin)
+
+- **Kotlin** im Maven-Build (`kotlin-stdlib`, explizite Quellpfade für stabile Kompilierung).
+- **Modell** `SimulationDocument` / `SimulationElement` / … und **XML-Decoder** (`StructogramXml`), kompatibel zum bestehenden **`.visustruct` / `<struktogramm>`**-Format (Swift/Java-Parität).
+- **Editor-Brücke:** `Struktogramm.toSimulationDocument()` — gleiche XML-Quelle wie Speichern / Rückgängig (`xmlErstellen()`).
+- **Laufzeit:** `SimulationEngine` mit schrittweiser Ausführung, **Simulations-Ansicht** (Transport, Variablen, Ausgabe, Eingabe), Diagramm-Hervorhebung (letzter/nächster Schritt).
+
+## Build
+
+- Maven: **`de.visustruct:visustruct:1.2.0`**
+- Fat JAR: **`visustruct-1.2.0.jar`** (`./mvnw package` → `target/`)

src/main/java/de/visustruct/control/CanvasStyle.java

@@ -32,6 +32,7 @@ public final class CanvasStyle {
 	private static Color dropPreview;
 	private static Color dragFrame;
 	private static Color elementFill;
+	private static Color simulationStepHighlightFill;
 
 	private CanvasStyle() {
 	}
@@ -54,6 +55,7 @@ private static void applyLightPalette() {
 		dropPreview = new Color(0x803B82F6, true);
 		dragFrame = new Color(0x3B82F6);
 		elementFill = Color.WHITE;
+		simulationStepHighlightFill = new Color(0xBFDBFE);
 	}
 
 	/** Zeichenfläche spürbar dunkler; Blöcke bleiben hell genug für Lesbarkeit. */
@@ -69,6 +71,7 @@ private static void applyDarkPalette() {
 		dropPreview = new Color(0x805B9FFF, true);
 		dragFrame = new Color(0x5B9FFF);
 		elementFill = new Color(0xECECF0);
+		simulationStepHighlightFill = new Color(0x1E3A5F);
 	}
 
 	private static boolean isFlatDarkTheme() {
@@ -128,4 +131,9 @@ public static Color getDragFrame() {
 	public static Color getElementFill() {
 		return elementFill;
 	}
+
+	/** Hintergrund für den aktuellen Simulations-Schritt im Diagramm. */
+	public static Color getSimulationStepHighlightFill() {
+		return simulationStepHighlightFill;
+	}
 }

src/main/java/de/visustruct/control/Controlling.java

@@ -48,6 +48,9 @@
 import de.visustruct.i18n.I18n;
 import de.visustruct.other.Helpers;
 import de.visustruct.other.XActionCommands;
+import de.visustruct.simulation.SimulationEngine;
+import de.visustruct.simulation.codec.XmlDecodeException;
+import de.visustruct.simulation.model.SimulationDocument;
 import de.visustruct.struktogrammelemente.StruktogrammElement;
 import de.visustruct.view.AuswahlPanel;
 import de.visustruct.view.CodeErzeuger;
@@ -61,6 +64,7 @@ public class Controlling implements Konstanten, ActionListener, WindowListener,
 	private static final Logger LOG = Logger.getLogger(Controlling.class.getName());
 
 	private GUI gui;
+	private boolean simulationMode;
 	private enum Betriebssysteme {Windows, Mac, Linux};
 
 	public Controlling(String[] params){
@@ -181,6 +185,9 @@ private static Betriebssysteme getOS(){
 
 
 	public Struktogramm gibAktuellesStruktogramm(){
+		if (gui == null) {
+			return null;
+		}
 		return gui.gibTabbedpane().gibAktuellesStruktogramm();
 	}
 
@@ -275,15 +282,6 @@ public void bildSpeichern(){
 		}
 	}
 
-	public void bildSpeichernNurPng(){
-		Struktogramm str = gibAktuellesStruktogramm();
-
-		if(str != null){
-			GlobalSettings.setzeBildSpeicherpfad(str.alsBilddateiSpeichernNurPng(GlobalSettings.getZuletztGenutzterPfadFuerBild()));
-			GlobalSettings.saveSettings();
-		}
-	}
-
 	public void bildDrucken(){
 		Struktogramm str = gibAktuellesStruktogramm();
 		if (str == null) {
@@ -460,6 +458,10 @@ public void actionPerformed(ActionEvent e) {
 			addStruktogrammbeschriftung();
 			break;
 
+		case simulationToggle:
+			onSimulationToggle();
+			break;
+
 		}
 
 	}
@@ -586,12 +588,78 @@ public GUI getGUI(){
 		return gui;
 	}
 
+	/** Wechsel des Diagramm-Tabs beendet die Simulation (analog iOS-Moduswechsel). */
+	public void onStruktogrammTabChanged() {
+		if (simulationMode) {
+			endSimulationInternal();
+		}
+	}
+
+	/** Beendet die Simulation (Menü, Tab-Wechsel, Panel-Button „Zurück“). */
+	public void leaveSimulationMode() {
+		if (simulationMode) {
+			endSimulationInternal();
+		}
+	}
+
+	public boolean isSimulationMode() {
+		return simulationMode;
+	}
+
+	/** Gleiche Aktion wie Bearbeiten → Simulation… / Diagramm bearbeiten… (Paletten-Button). */
+	public void toggleSimulationFromUi() {
+		onSimulationToggle();
+	}
+
+	private void onSimulationToggle() {
+		if (simulationMode) {
+			endSimulationInternal();
+		} else {
+			enterSimulation();
+		}
+	}
+
+	private void enterSimulation() {
+		if (gui.gibTabbedpane().getTabCount() <= 0) {
+			return;
+		}
+		gui.gibElementEditorPanel().applyPendingTextToDiagram();
+		Struktogramm str = gibAktuellesStruktogramm();
+		if (str == null) {
+			return;
+		}
+		try {
+			SimulationDocument doc = str.toSimulationDocument();
+			SimulationEngine eng = new SimulationEngine(doc);
+			simulationMode = true;
+			gui.getSimulationPanel().setEngine(eng);
+			gui.showSimulationCard();
+			gui.setEditSimulationMenuText(I18n.tr("menu.edit.diagramMode"));
+			aktualisierePalettenBeschriftungen();
+		} catch (XmlDecodeException ex) {
+			JOptionPane.showMessageDialog(gui, ex.getMessage(), I18n.tr("simulation.error.title"), JOptionPane.ERROR_MESSAGE);
+		}
+	}
+
+	private void endSimulationInternal() {
+		simulationMode = false;
+		gui.showEditorCard();
+		gui.getSimulationPanel().clearEngine();
+		gui.setEditSimulationMenuText(I18n.tr("menu.edit.simulation"));
+		Struktogramm str = gibAktuellesStruktogramm();
+		if (str != null) {
+			str.setzeSimulationSpotlightPfad(null);
+		}
+		aktualisierePalettenBeschriftungen();
+	}
+
 
 
 
 
 
 	public boolean programmBeendenGeklickt(){
+		leaveSimulationMode();
 		if(gui.gibTabbedpane().einOderMehrereStruktogrammeNichtGespeichert()){                  
 			Object[] options = { I18n.tr("dialog.exitUnsaved.quit"), I18n.tr("dialog.exitUnsaved.stay") };
 			int r = JOptionPane.showOptionDialog(gui, I18n.tr("dialog.exitUnsaved.message"),