diff --git a/docs/refactor-whiteboard-controller.md b/docs/refactor-whiteboard-controller.md index 5227bb1..c550485 100644 --- a/docs/refactor-whiteboard-controller.md +++ b/docs/refactor-whiteboard-controller.md @@ -4,7 +4,7 @@ Stand: 2026-11-13 Ziel: Der Controller war mit **9.092 Zeilen und 465 Funktionen** der größte Baustein im Projekt; die Roadmap nennt < 1.500 Zeilen pro Datei. Nach den -Etappen 1–10 sind es 8.194 Zeilen. Diese Notiz +Etappen 1–11 sind es 8.154 Zeilen. Diese Notiz hält die Reihenfolge fest, damit der Umbau in Etappen mit grüner Suite passiert und nicht als Big Bang. @@ -37,7 +37,8 @@ passiert und nicht als Big Bang. | `HubPanel` | Kür-Hub (Login, Upload, Downloads) | ~650 | Dialoge, Threads | 8 | | `PlaybackPose` | Position und Blickrichtung zur Zeit | 130 | keine | 8 ✅ | | `PlaybackPanel` | Transportleiste: Play/Pause, Reset, Slider, Tempo | 110 | Szene | 10 ✅ | -| Playback-Rest | Musik, Timeline-Labels, 3D-Anbindung | ~360 | Canvas, Audio | offen | +| `TimelineLabelModel` | Labels der Zeitachse einsammeln | 55 | keine | 11 ✅ | +| Playback-Rest | Musik, Label-Dialog, 3D-Anbindung | ~300 | Canvas, Audio | offen | | `ElementInspector` | Element-Dialog, Features, Level, Kombinationen | ~800 | Dialog, Regeln | 10 | Danach bleibt ein Controller von grob 2.000–2.500 Zeilen: Verdrahtung, @@ -185,6 +186,19 @@ ohne Control-Basis kann in einem HBox nicht sinnvoll Kindknoten aufnehmen. verschmolzen; die Zeitachse (`timeline_label_lane`) bleibt beim Controller, weil sie zu den Timeline-Labels gehört. +### 11. `TimelineLabelModel` ✅ + +Das Einsammeln der Timeline-Labels liegt in +`src/whiteboard/view/timeline_label_model.gd`. Es ist subtiler, als es aussieht: +Es läuft über die Abschnitte (nicht über die Wiedergabe-Einträge), damit +Marken ohne Standzeit sichtbar bleiben, und ein Segment ohne eigenes Label +erbt die Beschriftung seiner Elementgruppe — so wird eine Sequenz einmal +benannt. Abgesichert durch die Wiedergabetests, die die Labels der Zeitachse +prüfen. + +**Offen:** der Label-Dialog (Anlegen/Bearbeiten/Löschen) und die Musik +(Laden, Konvertierung, Synchronisation). + ## Nächster Durchgang: weitere Node-Schnitte Die vier verbleibenden Blöcke (Sync-Orchestrierung, Hub, Playback-Rest, diff --git a/docs/roadmap.md b/docs/roadmap.md index 3801ef9..4be3efd 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -270,10 +270,10 @@ Schritte. - [ ] `WhiteboardController` in Services/Panels zerlegen: Datei-I/O, Sync, Playback, Validierung, Element-Inspector, Section-Liste. Ziel: < 1.500 Zeilen pro Datei, keine 100 `%`-Lookups in einem Skript. In Etappen nach - `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.194 Zeilen; `HelpContent`, `SeasonComparisonText`, + `docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.154 Zeilen; `HelpContent`, `SeasonComparisonText`, `ValidationReportView`, `ExportService`, `RulesContext`, - `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel` und - `PlaybackPanel` (Node-Schnitte) ausgelagert. + `SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel`, + `PlaybackPanel` und `TimelineLabelModel` ausgelagert. - [ ] Gemeinsamer Test-Harness (oder gdUnit4), Timeout pro Testlauf, Coverage; CI auf dem Gitea-/Forgejo-Remote mit `tools/test.sh` und `tools/check_export.sh`. diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index 895c189..59556c2 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -4148,50 +4148,10 @@ func _sort_timeline_labels() -> void: func _refresh_timeline_labels() -> void: if timeline_label_lane == null: return - - # Walk the authored routine like the playback timeline does. Using the - # segments directly (instead of only the timed playback entries) also - # keeps element markers with zero stand time visible. - var element_labels: Array[Dictionary] = [] - var total := 0.0 - if _routine != null: - for section: RoutineSection in _routine.sections: - if section == null: - continue - var group_starts: Dictionary[String, ResolvedElement] = {} - for element: ResolvedElement in section.get_elements(): - if not element.segments.is_empty(): - group_starts[element.segments[0].segment_id] = element - for segment: PathSegment in section.segments: - if segment == null: - continue - var text := segment.label.strip_edges() - if text.is_empty() and group_starts.has(segment.segment_id): - text = group_starts[segment.segment_id].get_caption().strip_edges() - if not text.is_empty(): - element_labels.append({ - "time_seconds": total, - "text": text, - }) - total += maxf( - segment.get_effective_duration_seconds(), - 0.0 - ) - - var custom_labels: Array[Dictionary] = [] - if _routine != null: - for entry: Dictionary in _routine.timeline_labels: - var text := str(entry.get("text", "")).strip_edges() - if text.is_empty(): - continue - custom_labels.append({ - "time_seconds": float(entry.get("time_seconds", 0.0)), - "text": text, - }) - + var labels := TimelineLabelModel.collect(_routine) timeline_label_lane.set_timeline( - element_labels, - custom_labels, + labels["elements"], + labels["custom"], _playback_total_duration ) diff --git a/rinkplanner/src/whiteboard/view/timeline_label_model.gd b/rinkplanner/src/whiteboard/view/timeline_label_model.gd new file mode 100644 index 0000000..efd8d31 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/timeline_label_model.gd @@ -0,0 +1,53 @@ +class_name TimelineLabelModel +extends RefCounted + +## Collects the labels shown on the playback timeline. +## +## Pure: the routine goes in, the two label lists and the total duration come +## out. Walks the authored sections (not the timed playback entries), so +## element markers with zero stand time stay visible. A segment without its own +## label falls back to the caption of its element group, so a sequence group is +## named once. + +## Returns `{"elements": Array, "custom": Array, "duration": float}`. Each +## entry is `{"time_seconds": float, "text": String}`. +static func collect(routine: Routine) -> Dictionary: + var element_labels: Array[Dictionary] = [] + var total := 0.0 + if routine != null: + for section: RoutineSection in routine.sections: + if section == null: + continue + var group_starts: Dictionary[String, ResolvedElement] = {} + for element: ResolvedElement in section.get_elements(): + if not element.segments.is_empty(): + group_starts[element.segments[0].segment_id] = element + for segment: PathSegment in section.segments: + if segment == null: + continue + var text := segment.label.strip_edges() + if text.is_empty() and group_starts.has(segment.segment_id): + text = group_starts[segment.segment_id].get_caption().strip_edges() + if not text.is_empty(): + element_labels.append({ + "time_seconds": total, + "text": text, + }) + total += maxf(segment.get_effective_duration_seconds(), 0.0) + + var custom_labels: Array[Dictionary] = [] + if routine != null: + for entry: Dictionary in routine.timeline_labels: + var text := str(entry.get("text", "")).strip_edges() + if text.is_empty(): + continue + custom_labels.append({ + "time_seconds": float(entry.get("time_seconds", 0.0)), + "text": text, + }) + + return { + "elements": element_labels, + "custom": custom_labels, + "duration": total, + } diff --git a/rinkplanner/src/whiteboard/view/timeline_label_model.gd.uid b/rinkplanner/src/whiteboard/view/timeline_label_model.gd.uid new file mode 100644 index 0000000..6d36ec8 --- /dev/null +++ b/rinkplanner/src/whiteboard/view/timeline_label_model.gd.uid @@ -0,0 +1 @@ +uid://bi7a47b46qnej