release: VisuStruct 1.2.2 with 21 UI languages (Swift sync)

Align desktop UI locales with VisuStruct-swift via sync_java_messages_from_swift.py
and new Messages_* bundles. Split Settings: Languages menu, dedicated block-text
preset dialog, and Simulation dialog to avoid duplicate language selection.

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

Author: code4teaching

README.md

@@ -10,7 +10,7 @@
 
 **VisuStruct** is a **structure-chart editor** for **Nassi–Shneiderman** diagrams (desktop, Java / Swing).
 
-Under **Settings → Languages** the **user interface** can be set to **English**, **German**, or **European Portuguese (Portugal)** (`uilanguage`: `en`, `de`, `pt_PT` in `visustruct.properties`). A few auxiliary dialogs may still show English-only labels.
+Under **Settings → Languages** the **user interface** can be set to any of **21 languages** aligned with **VisuStruct-swift** (English, German, Spanish, French, Italian, Polish, Turkish, Korean, Japanese, Greek, Ukrainian, Arabic, Russian, Hebrew, Dutch, Swedish, Danish, Norwegian Bokmål, Chinese Simplified/Traditional, European Portuguese). Stored as `uilanguage` in `visustruct.properties` (e.g. `zh_Hans`, `pt_PT`). UI strings are synced from the Swift app where keys overlap: `python3 tools/sync_java_messages_from_swift.py` (map: `VisuStruct-swift/tools/java_swift_i18n_map.json`). Desktop-only labels may still fall back to English.
 
 *Lineage:* Based on the open-source project [kekru/struktogrammeditor](https://github.com/kekru/struktogrammeditor) (Kevin Krummenauer, MIT). Copyright and terms: [LICENSE](LICENSE).
 
@@ -22,6 +22,13 @@ git clone https://github.com/code4teaching/VisuStruct.git
 
 ---
 
+## Changes in 1.2.2 (summary)
+
+- **Languages:** **21 UI languages** (VisuStruct-swift); `tools/sync_java_messages_from_swift.py`.
+- **CI:** GitHub Actions build passes again (headless-safe drag-and-drop init for tests).
+
+Full notes: [`release-notes/v1.2.2.md`](release-notes/v1.2.2.md).
+
 ## Changes in 1.2.1 (summary)
 
 - **Simulation:** **true/false** branch selection by case name; **reset (Stop)** for new input on rerun; highlight mode and play speed in Settings; sidebar layout (input always visible, current block shows instruction text).
@@ -98,7 +105,7 @@ Full notes: [`release-notes/v1.0.7.md`](release-notes/v1.0.7.md).
 ## Changes in 1.0.6 (summary)
 
 - **UI & theme:** cleaner menus; **light / dark** FlatLaf **without restart**; improved dark-mode readability.
-- **Languages:** **Settings → Languages** lists **English**, **German**, **Portuguese**; stored in **`visustruct.properties`** (`uilanguage`). If unset, default follows **JVM locale**.
+- **Languages:** **Settings → Languages** lists **21 languages** (same set as VisuStruct-swift, except the Java-keyword pseudo-locale); stored in **`visustruct.properties`** (`uilanguage`). If unset, default follows **JVM locale**. Regenerate bundles: `python3 tools/sync_java_messages_from_swift.py`.
 - **I18n:** menu, core confirmation dialogs, `JFileChooser` labels, context menu, palette (PNG, about, trash, etc.); **English** is no longer overridden by the OS default locale.
 - **Structure-chart labels:** preset **“Java (default)”** (and localized equivalents); **preview** in the settings dialog; **palette** shows Java keywords on buttons when the Java preset is active.
 - **Tabs:** new diagram tab uses a localized **“Untitled”**-style title instead of a hard-coded English string.
@@ -141,7 +148,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.2.1.jar`**).
+- Current fat JAR name follows **`pom.xml`** **`version`** (e.g. **`visustruct-1.2.2.jar`**).
 
 ---
 
@@ -216,13 +223,13 @@ chmod +x mvnw
 Output (version from `pom.xml`):
 
 ```text
-target/visustruct-1.2.1.jar
+target/visustruct-1.2.2.jar
 ```
 
 ## Run
 
 ```bash
-java -jar target/visustruct-1.2.1.jar
+java -jar target/visustruct-1.2.2.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.2.1}"
+VER="${PROJECT_VERSION:-1.2.2}"
 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.2.1}"
+VER="${PROJECT_VERSION:-1.2.2}"
 JAR="visustruct-${VER}.jar"
 INPUT="${ROOT}/target"
 OUT="${ROOT}/dist/macos-app"

pom.xml

@@ -4,7 +4,7 @@
 	<modelVersion>4.0.0</modelVersion>
 	<groupId>de.visustruct</groupId>
 	<artifactId>visustruct</artifactId>
-	<version>1.2.1</version>
+	<version>1.2.2</version>
 	<name>VisuStruct</name>
 
 	<properties>

release-notes/v1.2.2.md

@@ -0,0 +1,17 @@
+# VisuStruct 1.2.2
+
+Patch release **after** **1.2.1**.
+
+## Languages
+
+- **21 UI languages** (aligned with VisuStruct-swift): Settings → Languages and the settings dialog; `uilanguage` in `visustruct.properties`.
+- Bundles synced from the Swift app where keys overlap: `python3 tools/sync_java_messages_from_swift.py`.
+
+## Build / CI
+
+- **GitHub Actions:** unit tests no longer fail with `java.awt.HeadlessException` on CI runners without a display. Drag-and-drop is initialized only when not in headless mode (`GraphicsEnvironment.isHeadless()`).
+
+## Build
+
+- Maven: **`de.visustruct:visustruct:1.2.2`**
+- Fat JAR: **`visustruct-1.2.2.jar`** (`./mvnw package` → `target/`)

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

@@ -55,6 +55,7 @@
 import de.visustruct.view.AuswahlPanel;
 import de.visustruct.view.CodeErzeuger;
 import de.visustruct.view.EinstellungsDialog;
+import de.visustruct.view.SimulationEinstellungenDialog;
 import de.visustruct.view.FontChooser;
 import de.visustruct.view.GUI;
 import de.visustruct.view.ZoomEinstellungen;
@@ -418,6 +419,10 @@ public void actionPerformed(ActionEvent e) {
 			new EinstellungsDialog(gui, true);
 			break;
 
+		case simulationEinstellen:
+			new SimulationEinstellungenDialog(gui, true);
+			break;
+
 		case schriftartAendern:
 			new FontChooser(this,true);
 			break;
@@ -483,6 +488,11 @@ public void actionPerformed(ActionEvent e) {
 	}
 
 
+	/** UI-Sprache wechseln (Menü oder Einstellungsdialog). */
+	public void applyUiLanguageChange(String tag) {
+		changeUiLanguageIfNeeded(tag);
+	}
+
 	private void changeUiLanguageIfNeeded(String tag) {
 		String next = GlobalSettings.normalizeUiLanguageTag(tag);
 		if (next.equals(GlobalSettings.getUiLanguageTag())) {

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

@@ -59,9 +59,35 @@ public class GlobalSettings implements Konstanten{
 	 */
 	private static int lookAndFeelAktuell = 4;
 
-	/** UI-Sprache: {@code en}, {@code de} oder {@code pt_PT} (Portugal; Menüleiste, I18n). */
+	/** UI-Sprache (Menüleiste, I18n); siehe {@link #UI_LANGUAGE_OPTIONS}. */
 	private static String uiLanguageTag = "en";
 
+	/** Tag und Menü-Label-Key für „Einstellungen → Sprachen“ (wie VisuStruct-swift). */
+	public record UiLanguageOption(String tag, String menuLabelKey) {}
+
+	public static final List<UiLanguageOption> UI_LANGUAGE_OPTIONS = List.of(
+			new UiLanguageOption("en", "menu.settings.language.en"),
+			new UiLanguageOption("de", "menu.settings.language.de"),
+			new UiLanguageOption("es", "menu.settings.language.es"),
+			new UiLanguageOption("fr", "menu.settings.language.fr"),
+			new UiLanguageOption("it", "menu.settings.language.it"),
+			new UiLanguageOption("pl", "menu.settings.language.pl"),
+			new UiLanguageOption("tr", "menu.settings.language.tr"),
+			new UiLanguageOption("ko", "menu.settings.language.ko"),
+			new UiLanguageOption("ja", "menu.settings.language.ja"),
+			new UiLanguageOption("el", "menu.settings.language.el"),
+			new UiLanguageOption("uk", "menu.settings.language.uk"),
+			new UiLanguageOption("ar", "menu.settings.language.ar"),
+			new UiLanguageOption("ru", "menu.settings.language.ru"),
+			new UiLanguageOption("he", "menu.settings.language.he"),
+			new UiLanguageOption("nl", "menu.settings.language.nl"),
+			new UiLanguageOption("sv", "menu.settings.language.sv"),
+			new UiLanguageOption("da", "menu.settings.language.da"),
+			new UiLanguageOption("nb", "menu.settings.language.nb"),
+			new UiLanguageOption("zh_Hans", "menu.settings.language.zh_Hans"),
+			new UiLanguageOption("zh_Hant", "menu.settings.language.zh_Hant"),
+			new UiLanguageOption("pt_PT", "menu.settings.language.pt"));
+
 	/** {@code true}, wenn {@code uilanguage} in der geladenen Properties-Datei stand (sonst JVM-Locale als Vorgabe). */
 	private static boolean uiLanguageFromPropertiesFile = false;
 
@@ -398,6 +424,79 @@ private static void applyDefaultUiLanguageFromRuntimeLocale() {
 			setUiLanguageTag("pt_PT");
 			return;
 		}
+		if ("es".equals(lang)) {
+			setUiLanguageTag("es");
+			return;
+		}
+		if ("fr".equals(lang)) {
+			setUiLanguageTag("fr");
+			return;
+		}
+		if ("it".equals(lang)) {
+			setUiLanguageTag("it");
+			return;
+		}
+		if ("nl".equals(lang)) {
+			setUiLanguageTag("nl");
+			return;
+		}
+		if ("pl".equals(lang)) {
+			setUiLanguageTag("pl");
+			return;
+		}
+		if ("tr".equals(lang)) {
+			setUiLanguageTag("tr");
+			return;
+		}
+		if ("ru".equals(lang)) {
+			setUiLanguageTag("ru");
+			return;
+		}
+		if ("ko".equals(lang)) {
+			setUiLanguageTag("ko");
+			return;
+		}
+		if ("ja".equals(lang)) {
+			setUiLanguageTag("ja");
+			return;
+		}
+		if ("el".equals(lang)) {
+			setUiLanguageTag("el");
+			return;
+		}
+		if ("uk".equals(lang)) {
+			setUiLanguageTag("uk");
+			return;
+		}
+		if ("ar".equals(lang)) {
+			setUiLanguageTag("ar");
+			return;
+		}
+		if ("he".equals(lang)) {
+			setUiLanguageTag("he");
+			return;
+		}
+		if ("sv".equals(lang)) {
+			setUiLanguageTag("sv");
+			return;
+		}
+		if ("da".equals(lang)) {
+			setUiLanguageTag("da");
+			return;
+		}
+		if ("nb".equals(lang)) {
+			setUiLanguageTag("nb");
+			return;
+		}
+		if ("zh".equals(lang)) {
+			String country = def.getCountry();
+			if ("TW".equalsIgnoreCase(country) || "HK".equalsIgnoreCase(country) || "MO".equalsIgnoreCase(country)) {
+				setUiLanguageTag("zh_Hant");
+			} else {
+				setUiLanguageTag("zh_Hans");
+			}
+			return;
+		}
 		setUiLanguageTag("en");
 	}
 
@@ -650,34 +749,64 @@ public static void setLookAndFeelAktuell(int themeIndex) {
 		GlobalSettings.lookAndFeelAktuell = themeIndex;
 	}
 
-	/** Locale für die UI-Texte: Englisch, Deutsch oder Português (Portugal, {@code pt-PT}). */
+	/** Locale für UI-Texte. */
 	public static Locale getUiLocale() {
-		if ("de".equals(uiLanguageTag)) {
-			return Locale.GERMAN;
-		}
-		if ("pt_PT".equals(uiLanguageTag)) {
-			return Locale.forLanguageTag("pt-PT");
-		}
-		return Locale.ENGLISH;
+		return switch (uiLanguageTag) {
+			case "de" -> Locale.GERMAN;
+			case "pt_PT" -> Locale.forLanguageTag("pt-PT");
+			case "es" -> Locale.forLanguageTag("es");
+			case "fr" -> Locale.FRENCH;
+			case "it" -> Locale.ITALIAN;
+			case "nl" -> Locale.forLanguageTag("nl");
+			case "pl" -> Locale.forLanguageTag("pl");
+			case "tr" -> Locale.forLanguageTag("tr");
+			case "ru" -> Locale.forLanguageTag("ru");
+			case "ko" -> Locale.KOREAN;
+			case "ja" -> Locale.JAPANESE;
+			case "el" -> Locale.forLanguageTag("el");
+			case "uk" -> Locale.forLanguageTag("uk");
+			case "ar" -> Locale.forLanguageTag("ar");
+			case "he" -> Locale.forLanguageTag("he");
+			case "sv" -> Locale.forLanguageTag("sv");
+			case "da" -> Locale.forLanguageTag("da");
+			case "nb" -> Locale.forLanguageTag("nb");
+			case "zh_Hans" -> Locale.forLanguageTag("zh-Hans");
+			case "zh_Hant" -> Locale.forLanguageTag("zh-Hant");
+			default -> Locale.ENGLISH;
+		};
 	}
 
 	public static String getUiLanguageTag() {
 		return uiLanguageTag;
 	}
 
-	/** Kanonische Tags: {@code en}, {@code de}, {@code pt_PT}. */
+	/** Kanonischer Tag aus {@link #UI_LANGUAGE_OPTIONS}; unbekannt → {@code en}. */
 	public static String normalizeUiLanguageTag(String tag) {
 		if (tag == null || tag.isBlank()) {
 			return "en";
 		}
 		String t = tag.trim();
-		if (t.equalsIgnoreCase("de")) {
-			return "de";
+		for (UiLanguageOption opt : UI_LANGUAGE_OPTIONS) {
+			if (opt.tag().equalsIgnoreCase(t)) {
+				return opt.tag();
+			}
 		}
 		String hy = t.replace('_', '-').toLowerCase(Locale.ROOT);
-		if ("pt-pt".equals(hy)) {
+		for (UiLanguageOption opt : UI_LANGUAGE_OPTIONS) {
+			String optHy = opt.tag().replace('_', '-').toLowerCase(Locale.ROOT);
+			if (hy.equals(optHy) || hy.startsWith(optHy + "-")) {
+				return opt.tag();
+			}
+		}
+		if ("pt".equalsIgnoreCase(t) || "pt-pt".equals(hy)) {
 			return "pt_PT";
 		}
+		if ("zh-cn".equals(hy) || "zh-hans".equals(hy)) {
+			return "zh_Hans";
+		}
+		if ("zh-tw".equals(hy) || "zh-hant".equals(hy) || "zh-hk".equals(hy)) {
+			return "zh_Hant";
+		}
 		return "en";
 	}
 
@@ -696,6 +825,34 @@ public static boolean isUiPortuguesePortugal() {
 		return "pt_PT".equals(uiLanguageTag);
 	}
 
+	public static boolean isUiSpanish() {
+		return "es".equals(uiLanguageTag);
+	}
+
+	public static boolean isUiFrench() {
+		return "fr".equals(uiLanguageTag);
+	}
+
+	public static boolean isUiItalian() {
+		return "it".equals(uiLanguageTag);
+	}
+
+	public static boolean isUiDutch() {
+		return "nl".equals(uiLanguageTag);
+	}
+
+	public static boolean isUiPolish() {
+		return "pl".equals(uiLanguageTag);
+	}
+
+	public static boolean isUiTurkish() {
+		return "tr".equals(uiLanguageTag);
+	}
+
+	public static boolean isUiRussian() {
+		return "ru".equals(uiLanguageTag);
+	}
+
 	public static double getSimulationPlayDelaySec() {
 		return simulationPlayDelaySec;
 	}

src/main/java/de/visustruct/i18n/I18n.java

@@ -14,7 +14,7 @@
  * <p>
  * Ohne spezielles {@link ResourceBundle.Control} würde {@link ResourceBundle#getBundle(String, Locale)}
  * bei fehlendem sprachspezifischen Bundle auf die <b>System-Locale</b> zurückfallen und die falsche Sprache laden.
- * Unterstützt {@code en}, {@code de} und {@code pt_PT} ({@code Messages_pt_PT.properties}).
+	 * Unterstützt alle in {@link GlobalSettings#UI_LANGUAGE_OPTIONS} (21 Sprachen, wie VisuStruct-swift).
  */
 public final class I18n {
 

src/main/java/de/visustruct/other/XActionCommands.java

@@ -13,6 +13,8 @@ public enum XActionCommands {
 
 	/** Dialog „Beschriftung (Struktogramm)“ / Textvorlagen für neue Blöcke. */
 	elementBeschriftungEinstellen,
+	/** Dialog Simulations-Einstellungen (Geschwindigkeit, Markierung). */
+	simulationEinstellen,
 
 	info,