Refresh GUI documentation and profile synchronization

doc/05_action_dialog.md

@@ -39,8 +39,9 @@ LED-Panels (`_colorPanel`, `_animPanel`) erscheinen zusätzlich wenn `showColor=
 //   Index 2: "Profil 2"                   → Data = 1
 //   Index 3: "Profil 3"                   → Data = 2
 
-// Initialbelegung:
-_profileCombo.SelectedIndex = action.Data == 0xFFFF ? 0 : action.Data + 1;
+// Initialbelegung: beide von der Firmware akzeptierten Zykluswerte erkennen
+_profileCombo.SelectedIndex =
+    action.Data is 0x00FF or 0xFFFF ? 0 : action.Data + 1;
 
 // In OnOk():
 data = _profileCombo.SelectedIndex == 0
@@ -48,7 +49,9 @@ data = _profileCombo.SelectedIndex == 0
     : (ushort)(_profileCombo.SelectedIndex - 1);
 ```
 
-Im Board wird `0xFFFF` als `(uint8_t)0xFF` gespeichert und in der Firmware als "nächstes Profil" interpretiert.
+`SAction.data` ist ein 16-Bit-Feld. Die GUI schreibt für „nächstes Profil“
+kanonisch `0xFFFF`; Firmware und Deserialisierung akzeptieren zusätzlich den
+älteren Wert `0x00FF`.
 
 ## Tasten-Capture (HID-Modus)
 
@@ -62,7 +65,10 @@ WinForms behandelt Pfeil- und Enter-Tasten als "Dialog Keys" in `ProcessDialogKe
 
 ## Makro-Capture
 
-Jeder der 8 Steps hat einen eigenen Capture-Button. `_captureStep` (0–7, -1 = inaktiv) zeigt welcher Step gerade aufnimmt. Capture-Logik identisch mit HID-Modus, schreibt in `_stepKeycodes[captureStep]`.
+Jeder der 8 Steps hat einen eigenen Capture-Button. `_captureStep` (0–7,
+-1 = inaktiv) zeigt, welcher Step gerade aufnimmt. Capture-Logik identisch mit
+HID-Modus, schreibt in `_stepKeycodes[captureStep]`. Der erste leere Step
+beendet die Makrosequenz; deshalb dürfen belegte Steps keine Lücke enthalten.
 
 ## Schlüssellookup (layout-unabhängig)
 
@@ -107,6 +113,14 @@ Scan-Code → HID Usage via s_scanToHid[sc]
 Nur wenn `showColor=true` (MX-Buttons). Enthält:
 - **Farbpicker**: `ColorDialog` → `_colorBtn.BackColor`
 - **Animations-Dropdown**: Statisch / Blinken / Pulsieren / Regenbogen
-- **Periode-Dropdown**: Presets von "Sehr langsam (8 s)" bis "Sehr schnell (250 ms)"
+- **Periode-Dropdown**: 500 ms, 1 s, 2 s oder 4 s
 
 Bei "Regenbogen" wird der Farbpicker ausgeblendet (Farbe irrelevant).
+
+Das Binärmodell kennt außerdem `FadeIn`, `FadeOut` und `ColorFade`; diese drei
+Werte sind im Dialog noch nicht auswählbar. Per-LED-Helligkeit wird im
+Binärformat und JSON erhalten, besitzt hier aber ebenfalls kein Bedienelement.
+Beim Öffnen einer nicht angebotenen Animation fällt die Auswahl derzeit auf
+`Static` zurück. Unbekannte, aber formal gültige Consumer-Usages fallen auf
+„Play / Pause“ zurück. Details stehen in
+[`07_known_limitations.md`](07_known_limitations.md).