i18n: expand Swift map sync, tidy tools, and update docs

Sync Messages_* from expanded java_swift_i18n_map; add analyze_i18n_gaps.py;
move pre-Swift generators to tools/legacy; gitignore local Python i18n deps;
clarify Contributing and v1.2.1 simulation settings path.

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

Author: code4teaching

.gitignore

@@ -29,4 +29,9 @@ dist/
 com/
 
 # Lokaler Klon des SwiftUI-Repos (nicht ins Java-Projekt einchecken)
-VisuStruct-swift/
+VisuStruct-swift/
+
+# Lokale Python-Umgebung / Pakete für i18n-Skripte (tools/*.py)
+.venv-i18n/
+.pydeps/
+tools/.nl_pl_tr_ru_translations.json

README.md

@@ -31,7 +31,7 @@ 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).
+- **Simulation:** **true/false** branch selection by case name; **reset (Stop)** for new input on rerun; highlight mode and play speed under **Settings → Simulation…**; sidebar layout (input always visible, current block shows instruction text).
 - **Save:** pending **element-editor** text applied before save; more reliable save dialog on **macOS**.
 - **Code generator:** structure chart text as comments **off** by default.
 
@@ -240,8 +240,22 @@ Double-click may work if `.jar` is associated with Java.
 
 Suggestions and **bug reports** are welcome via [**Issues** and **Pull requests**](https://github.com/code4teaching/VisuStruct).
 
-**Commits** and **code comments** may use **English**.  
-New **visible UI strings** belong in **`Messages*.properties`** (and **`structure.*`** where applicable) for **en**, **de**, and **pt_PT**; open an issue first if keys or wording are unclear.
+**Commits** and **code comments** may use **English**.
+
+### UI strings (21 languages)
+
+- Bundles: `src/main/resources/de/visustruct/i18n/Messages_*.properties` (plus **`structure.*`** keys where applicable).
+- **Source of truth for new keys:** add the English string to **`Messages_en.properties`**, then extend the Swift↔Java map in the sibling repo **`VisuStruct-swift/tools/java_swift_i18n_map.json`** (clone next to this project; see `.gitignore`).
+- **Regenerate** all locale files from Swift where mapped (`tools/README.md`):
+
+  ```bash
+  python3 tools/sync_java_messages_from_swift.py
+  python3 tools/analyze_i18n_gaps.py   # optional: unmapped keys
+  ```
+
+  Unmapped keys keep the existing bundle text or fall back to English. Desktop-only dialogs may stay English until mapped.
+- **Menu language** is **Settings → Languages** only (`uilanguage` in `visustruct.properties`); do not duplicate a language list in other settings dialogs.
+- Open an issue first if keys, didactic wording, or Swift parity are unclear.
 
 ---
 

release-notes/v1.2.1.md

@@ -7,7 +7,7 @@ Patch release **after** **1.2.0**.
 - **Branches:** `true` / `false` cases are selected **by name**, not only by XML order (e.g. after swapping branches and saving).
 - **Reset (Stop):** the step list is rebuilt from the diagram; **new input** on rerun (no longer stuck on the first value).
 - **Modulo / comparisons:** numeric `String` values in expressions are handled more robustly.
-- **Diagram highlight** (“Last executed” / “Next up”) and **play speed** under **Settings → Default block texts**, section **Simulation** (`simulationhighlight`, `simulationplaydelay`).
+- **Diagram highlight** (“Last executed” / “Next up”) and **play speed** in the default block-text settings dialog, **Simulation** section (`simulationhighlight`, `simulationplaydelay`). *(Since 1.2.2: **Settings → Simulation…**, separate from **Labels (structure chart)**.)*
 - **Simulation panel:** order is Controls → Input (always visible) → Variables → Current block (instruction text) → Output; back arrow removed (return via menu/palette).
 
 ## Code generator

src/main/resources/de/visustruct/i18n/Messages_ar.properties

@@ -17,7 +17,7 @@ menu.file.about=حول VisuStruct
 menu.file.exit=Exit
 menu.edit.undo=تراجع
 menu.edit.redo=إعادة
-menu.edit.caption=Set Diagram Caption...
+menu.edit.caption=العنوان
 menu.edit.copyDiagram=Copy Entire Diagram
 menu.edit.simulation=Simulation…
 menu.edit.diagramMode=Edit diagram…
@@ -29,7 +29,7 @@ simulation.stop=Stop
 simulation.play.tooltip=Run steps automatically (speed and highlight in Settings; pauses when input is needed)
 simulation.pause.tooltip=Pause automatic stepping
 simulation.stop.tooltip=Restart simulation from the beginning
-simulation.highlight=Highlight
+simulation.highlight=تمييز المخطط
 simulation.highlight.lastStep=آخر تنفيذ
 simulation.highlight.nextStep=الخطوة التالية
 simulation.back=Back to diagram
@@ -72,7 +72,7 @@ menu.settings.language.da=الدنماركية
 menu.settings.language.nb=النرويجية (بوكمول)
 menu.settings.language.zh_Hans=الصينية (مبسطة)
 menu.settings.language.zh_Hant=الصينية (تقليدية)
-menu.settings.labelsStruktogramm=Labels (structure chart)
+menu.settings.labelsStruktogramm=نص العنصر
 menu.settings.simulation=Simulation…
 menu.settings.changeFont=Change Font...
 menu.settings.mouseWheel=Resize blocks with mouse wheel
@@ -85,10 +85,10 @@ dialog.exitUnsaved.title=تغييرات غير محفوظة
 dialog.exitUnsaved.message=يحتوي هذا المخطط على تغييرات غير محفوظة. هل تريد حفظها قبل الإغلاق؟
 dialog.exitUnsaved.quit=تجاهل
 dialog.exitUnsaved.stay=إلغاء
-dialog.saveBeforeClose.title=Close diagram
-dialog.saveBeforeClose.message=Save the current diagram before closing?
-dialog.saveBeforeClose.save=Save
-dialog.saveBeforeClose.dontSave=Close without saving
+dialog.saveBeforeClose.title=تغييرات غير محفوظة
+dialog.saveBeforeClose.message=يحتوي هذا المخطط على تغييرات غير محفوظة. هل تريد حفظها قبل الإغلاق؟
+dialog.saveBeforeClose.save=حفظ
+dialog.saveBeforeClose.dontSave=تجاهل
 dialog.saveBeforeClose.cancel=إلغاء
 
 dialog.common.yes=Yes
@@ -100,8 +100,8 @@ dialog.pasteNeedPosition.title=Paste
 dialog.deleteBlock.title=Delete block
 dialog.deleteBlock.message=Remove this block?
 dialog.deleteBlock.messageNested=Remove this block and all nested blocks?
-dialog.deleteBlock.remove=Delete
-dialog.deleteBlock.cancel=Cancel
+dialog.deleteBlock.remove=حذف التحديد
+dialog.deleteBlock.cancel=إلغاء
 dialog.overwriteFile.title=File exists
 dialog.overwriteFile.message=The file {0} already exists.\nOverwrite?
 dialog.overwriteFile.overwrite=Overwrite
@@ -111,7 +111,7 @@ dialog.saveNoPath.message=There is no file path to save to. Use “Save As…”
 dialog.saveError.title=Save
 dialog.saveError.message=The file could not be saved:\n{0}
 dialog.recentMissing.title=Recent file
-dialog.recentMissing.message=This file is no longer available:\n{0}\nIt has been removed from the recent list.
+dialog.recentMissing.message=لم يعد الملف متاحًا.
 dialog.exportImage.title=Export image
 dialog.exportImage.formatFailed=The image could not be written (format: {0}).
 dialog.exportImage.error=An error occurred while saving:\n{0}
@@ -121,15 +121,15 @@ dialog.caseLabel.renameButton=Rename selected case
 dialog.caseSelectFirst.title=Selection required
 dialog.caseSelectFirst.message=Please select a case in the list first.
 dialog.codeInvalidInput.title=Invalid input
-dialog.codeInvalidInput.message=Please enter whole numbers in the fields.
+dialog.codeInvalidInput.message=يرجى إدخال عدد صحيح.
 
 dialog.codeGen.targetJava=Java
 dialog.codeGen.targetPython=Python
 dialog.codeGen.targetJavaScript=JavaScript
-dialog.codeGen.emitComments=Emit structure chart text as comments
+dialog.codeGen.emitComments=نص المخطط كتعليقات
 dialog.codeGen.indentFirstLine=Indentation of the first line (spaces):
 dialog.codeGen.spacesPerLevel=Spaces per indentation level:
-dialog.codeGen.generate=Generate
+dialog.codeGen.generate=إنشاء الشفرة
 dialog.codeGen.close=Close
 dialog.codeGen.openInBrowser=اختبار في المتصفح
 dialog.codeGen.openInBrowser.tooltip=Opens the generated JavaScript in a temporary HTML file in your default browser.
@@ -150,8 +150,8 @@ dialog.codeGen.jsBrowserConsoleHint=Output from console.log appears in the devel
 
 tab.untitled=Untitled
 tab.close.tooltip=Close this tab
-tab.close.a11y=Close diagram tab
-tab.unsaved.a11y=Unsaved changes
+tab.close.a11y=إغلاق علامة التبويب
+tab.unsaved.a11y=تغييرات غير محفوظة
 fileChooser.openTitle=Open
 fileChooser.saveTitle=Save
 fileChooser.lookIn=Look in:
@@ -198,18 +198,18 @@ structure.palette.call=Call
 structure.palette.empty=Empty block
 structure.multiway.defaultCaseLabel=default
 
-elementPreset.englishJava=Java-like
+elementPreset.englishJava=Java (كلمات مفتاحية)
 elementPreset.didacticUiLanguage=Interface language
 
-dialog.elementText.title=Settings — default block texts
+dialog.elementText.title=الإعدادات
 dialog.elementText.intro=Default text for <b>newly inserted</b> structure-chart blocks.
-dialog.elementText.presetSection=Text preset
-dialog.elementText.previewTitle=Preview of default texts
-dialog.elementText.cancel=Cancel
-dialog.elementText.ok=OK
+dialog.elementText.presetSection=نص العنصر
+dialog.elementText.previewTitle=مولّد الشفرة
+dialog.elementText.cancel=إلغاء
+dialog.elementText.ok=حسنًا
 dialog.elementText.uiLanguageSection=User interface language
 dialog.elementText.simulationSection=محاكاة
-dialog.elementText.simulationSpeedLabel=Pause between steps:
+dialog.elementText.simulationSpeedLabel=توقف بين الخطوات
 dialog.elementText.simulationSpeedUnit=s
 dialog.elementText.simulationHighlightLabel=تمييز المخطط
 dialog.elementText.simulationHighlightLast=آخر تنفيذ
@@ -222,20 +222,20 @@ popup.zoom.wider=Wider
 popup.zoom.narrower=Narrower
 popup.zoom.taller=Taller
 popup.zoom.shorter=Shorter
-popup.editText=Edit text
+popup.editText=تحرير النص
 popup.copy=نسخ
 popup.paste=لصق
 popup.delete=حذف التحديد
 popup.swapBranches=Swap true and false branches
-popup.insertNewCase=Insert new case
+popup.insertNewCase=إضافة حالة
 popup.caseSubmenu=Case: {0}
 popup.moveCaseLeft=Move case {0} left
 popup.moveCaseRight=Move case {0} right
 popup.removeCase=Remove case {0}
 popup.removeCaseConfirm=Delete case {0} and all nested blocks?
-popup.removeCaseTitle=Remove case
+popup.removeCaseTitle=إزالة الحالة
 popup.pasteEmpty=Nothing copied yet. Use Copy first.
-popup.pasteTitle=Paste
+popup.pasteTitle=لصق
 
 palette.aboutVisuStruct=حول VisuStruct
 palette.aboutTooltip=حول VisuStruct

src/main/resources/de/visustruct/i18n/Messages_da.properties

@@ -17,7 +17,7 @@ menu.file.about=Om VisuStruct
 menu.file.exit=Exit
 menu.edit.undo=Fortryd
 menu.edit.redo=Annuller fortryd
-menu.edit.caption=Set Diagram Caption...
+menu.edit.caption=Titel
 menu.edit.copyDiagram=Copy Entire Diagram
 menu.edit.simulation=Simulation…
 menu.edit.diagramMode=Edit diagram…
@@ -29,7 +29,7 @@ simulation.stop=Stop
 simulation.play.tooltip=Run steps automatically (speed and highlight in Settings; pauses when input is needed)
 simulation.pause.tooltip=Pause automatic stepping
 simulation.stop.tooltip=Restart simulation from the beginning
-simulation.highlight=Highlight
+simulation.highlight=Diagramfremhævning
 simulation.highlight.lastStep=Sidst udført
 simulation.highlight.nextStep=Næste trin
 simulation.back=Back to diagram
@@ -72,7 +72,7 @@ menu.settings.language.da=Dansk
 menu.settings.language.nb=Norsk (bokmål)
 menu.settings.language.zh_Hans=Kinesisk (forenklet)
 menu.settings.language.zh_Hant=Kinesisk (traditionel)
-menu.settings.labelsStruktogramm=Labels (structure chart)
+menu.settings.labelsStruktogramm=Elementtekst
 menu.settings.simulation=Simulation…
 menu.settings.changeFont=Change Font...
 menu.settings.mouseWheel=Resize blocks with mouse wheel
@@ -85,10 +85,10 @@ dialog.exitUnsaved.title=Ikke-gemte ændringer
 dialog.exitUnsaved.message=Dette diagram indeholder ikke-gemte ændringer. Vil du gemme dem før lukning?
 dialog.exitUnsaved.quit=Kassér
 dialog.exitUnsaved.stay=Annuller
-dialog.saveBeforeClose.title=Close diagram
-dialog.saveBeforeClose.message=Save the current diagram before closing?
-dialog.saveBeforeClose.save=Save
-dialog.saveBeforeClose.dontSave=Close without saving
+dialog.saveBeforeClose.title=Ikke-gemte ændringer
+dialog.saveBeforeClose.message=Dette diagram indeholder ikke-gemte ændringer. Vil du gemme dem før lukning?
+dialog.saveBeforeClose.save=Gem
+dialog.saveBeforeClose.dontSave=Kassér
 dialog.saveBeforeClose.cancel=Annuller
 
 dialog.common.yes=Yes
@@ -100,8 +100,8 @@ dialog.pasteNeedPosition.title=Paste
 dialog.deleteBlock.title=Delete block
 dialog.deleteBlock.message=Remove this block?
 dialog.deleteBlock.messageNested=Remove this block and all nested blocks?
-dialog.deleteBlock.remove=Delete
-dialog.deleteBlock.cancel=Cancel
+dialog.deleteBlock.remove=Slet markering
+dialog.deleteBlock.cancel=Annuller
 dialog.overwriteFile.title=File exists
 dialog.overwriteFile.message=The file {0} already exists.\nOverwrite?
 dialog.overwriteFile.overwrite=Overwrite
@@ -111,7 +111,7 @@ dialog.saveNoPath.message=There is no file path to save to. Use “Save As…”
 dialog.saveError.title=Save
 dialog.saveError.message=The file could not be saved:\n{0}
 dialog.recentMissing.title=Recent file
-dialog.recentMissing.message=This file is no longer available:\n{0}\nIt has been removed from the recent list.
+dialog.recentMissing.message=Filen er ikke længere tilgængelig.
 dialog.exportImage.title=Export image
 dialog.exportImage.formatFailed=The image could not be written (format: {0}).
 dialog.exportImage.error=An error occurred while saving:\n{0}
@@ -121,12 +121,12 @@ dialog.caseLabel.renameButton=Rename selected case
 dialog.caseSelectFirst.title=Selection required
 dialog.caseSelectFirst.message=Please select a case in the list first.
 dialog.codeInvalidInput.title=Invalid input
-dialog.codeInvalidInput.message=Please enter whole numbers in the fields.
+dialog.codeInvalidInput.message=Indtast et heltal.
 
 dialog.codeGen.targetJava=Java
 dialog.codeGen.targetPython=Python
 dialog.codeGen.targetJavaScript=JavaScript
-dialog.codeGen.emitComments=Emit structure chart text as comments
+dialog.codeGen.emitComments=Diagramtekst som kommentarer
 dialog.codeGen.indentFirstLine=Indentation of the first line (spaces):
 dialog.codeGen.spacesPerLevel=Spaces per indentation level:
 dialog.codeGen.generate=Generate
@@ -201,15 +201,15 @@ structure.multiway.defaultCaseLabel=default
 elementPreset.englishJava=Java-like
 elementPreset.didacticUiLanguage=Interface language
 
-dialog.elementText.title=Settings — default block texts
+dialog.elementText.title=Indstillinger
 dialog.elementText.intro=Default text for <b>newly inserted</b> structure-chart blocks.
-dialog.elementText.presetSection=Text preset
+dialog.elementText.presetSection=Elementtekst
 dialog.elementText.previewTitle=Preview of default texts
-dialog.elementText.cancel=Cancel
+dialog.elementText.cancel=Annuller
 dialog.elementText.ok=OK
 dialog.elementText.uiLanguageSection=User interface language
 dialog.elementText.simulationSection=Simulering
-dialog.elementText.simulationSpeedLabel=Pause between steps:
+dialog.elementText.simulationSpeedLabel=Pause mellem trin
 dialog.elementText.simulationSpeedUnit=s
 dialog.elementText.simulationHighlightLabel=Diagramfremhævning
 dialog.elementText.simulationHighlightLast=Sidst udført
@@ -227,15 +227,15 @@ popup.copy=Kopiér
 popup.paste=Indsæt
 popup.delete=Slet markering
 popup.swapBranches=Swap true and false branches
-popup.insertNewCase=Insert new case
+popup.insertNewCase=Tilføj case
 popup.caseSubmenu=Case: {0}
 popup.moveCaseLeft=Move case {0} left
 popup.moveCaseRight=Move case {0} right
 popup.removeCase=Remove case {0}
 popup.removeCaseConfirm=Delete case {0} and all nested blocks?
-popup.removeCaseTitle=Remove case
+popup.removeCaseTitle=Fjern case
 popup.pasteEmpty=Nothing copied yet. Use Copy first.
-popup.pasteTitle=Paste
+popup.pasteTitle=Indsæt
 
 palette.aboutVisuStruct=Om VisuStruct
 palette.aboutTooltip=Om VisuStruct