Complete Modern desktop widgets and file libraries (by Codex)

This commit is contained in:
Codex committed 2026-10-26 00:08:50 +01:00
1 parent db89d889f7
commit 31bcf93205
43 files changed
+3134 -484

No files matched your search

+9 -8
View File
@@ -1,6 +1,6 @@
# Native Modern UI · erster Umsetzungsstand
Stand: 25. Oktober 2026. **Experimenteller RmlUI-Unterbau und erster
Stand: 26. Oktober 2026. **Experimenteller RmlUI-Unterbau und erster
bedienbarer Durchlauf. Noch keine vollständige Umsetzung des HTML-Mockups.**
Die normale Classic-Konfiguration bleibt unverändert; die neue Oberfläche
wird ausdrücklich mit `OPENBMH_BUILD_MODERN_UI=ON` gebaut.
@@ -21,13 +21,15 @@ wird ausdrücklich mit `OPENBMH_BUILD_MODERN_UI=ON` gebaut.
und Übersicht; in dieser Folge gibt es keinen Schließen-Knopf.
- Desktop mit Statusleiste, Buttons, fixierter Standardanordnung, Raster und
freiem Verschieben, Rechtsklickmenü, gemeinsamer Fixierung, Rückgängig,
Widgetauswahl und den vorgesehenen Widgetgrößen. Kurven-/Statistikinhalte
und die Widgetvorschauen benötigen noch den detaillierten Mockup-Abgleich.
[vollständigem Widgetkatalog](desktop/widgets/README.md), Größenwahl und
echten Vorschauen. Kurven, Form, direkte Duelle und Platz-/Stärkewidgets
verwenden die vorgegebenen HTML-Pseudodaten; Warnlampen lesen gemeinsame UI-Werte.
- Eintrittspreis-Popover: 330 × 196 Punkte, Entwurf, gesonderte Bestätigung,
Abbrechen, Fehler-/Revisionsschutz und Tastaturbedienung.
- Trainingslager: drei Karten, 18 Angebote, eigene GUI-Bilder und lokale
Vormerkung. Speichern/Laden sind als erste native Ansichten vorhanden;
ihr vollständiger Bedienungsabgleich bleibt offen.
Vormerkung. [Speichern/Laden](desktop/save-load/README.md) zeigen tatsächliche
Dateimetadaten, getrennte Ansichts- und Karrierebibliotheken, Import/Export
sowie bestätigtes Umbenennen, Löschen und Überschreiben.
- Separate UI-Demostände und Desktopansichten. Ansichten speichern zusätzlich
einen Screenshot; die Standardansicht kann nicht gelöscht werden.
- [Training](desktop/training/README.md): neun Übungen, vier Arten, Kader mit
@@ -136,8 +138,7 @@ vom HTML-Mockup übertragen. Für fehlende Ports erscheinen keine vereinfachten
Ersatzlayouts. Der Katalog zählt jetzt 34 native und drei noch nicht separat
zugeordnete Routen; diese Zahl bestätigt keine vollständige gestalterische
Abnahme aller früheren Teilimplementierungen.
Die vollständigen Widgetinhalte und der Mod-Importkomfort sind noch nicht
vollständig. Bildschirmkonfiguration und Audioausgabe benötigen noch die
Der Mod-Importkomfort ist noch nicht vollständig. Bildschirmkonfiguration und Audioausgabe benötigen noch die
Plattform-/Engine-Anbindung der nun gespeicherten UI-Voreinstellungen. Übersetzungen, echte Engine-Anbindung und Plattform-Abnahme
unter Windows/macOS folgen später. Dies ist kein freigegebenes Test-Release.
Die [QA-Befundliste](qa-findings.md) hält die noch offenen Abweichungen nach.
@@ -178,7 +179,7 @@ Quellcode verteilt. Ohne externe GUI-Ressourcen kann das Hauptmenü den bereits
mitgelieferten Launcher-Hintergrund verwenden.
Entwicklungsoptionen: `--gui-assets`, `--ui-scene`, `--ui-theme`, `--ui-size`,
`--ui-state`, `--ui-preferences`, `--ui-screenshot` und `--ui-script`. Das zeilenweise JSON-
`--ui-state`, `--ui-userdata`, `--ui-preferences`, `--ui-file-import`, `--ui-file-export`, `--ui-screenshot` und `--ui-script`. Das zeilenweise JSON-
Eingabeskript führt Maus-/Tastaturaktionen durch RmlUI aus; es ersetzt keine
Sessionaktionen durch direkte Zustandsmanipulation. `checkpoint` schreibt einen
wiederherstellbaren Demostand passend zu den Bildschirmaufnahmen.
+2
View File
@@ -14,6 +14,8 @@ Implementierung in der Spiel-Engine.
| QA-Befunde | [Offene Abweichungen zur HTML-Referenz](qa-findings.md) |
| Ressourcen | [GUI-Assets, Weltbilder und spätere Paketbereinigung](assets.md) |
| Desktop | [Statusleiste, Gestaltung und Fenster](desktop/README.md) |
| Widgets | [17 Typen, 48 Größen, Raster, Fixierung und Arbeitsanordnung](desktop/widgets/README.md) |
| Dateiverwaltung | [Spielstände und Desktopansichten mit Vorschauen](desktop/save-load/README.md) |
| Eintrittspreis | [Kompakter Schieberegler im Konto-Widget](desktop/entry-price/README.md) |
| Trainingslager | [Alle 18 Angebote, Qualitätswerte und Bedienung](desktop/trainingcamp/README.md) |
| Training | [Übungen, Kader, Intensität und Demo-Automatik](desktop/training/README.md) |
+7
View File
@@ -80,3 +80,10 @@ Privates Repository `bmh_4k_ui`, Commit `19969d430e38eadae7ff7a9d1fb381ab02c395d
[Transfers: Ablöse-Kasten und Abstand der Positionsfilter](transfers/README.md).
[Eintrittspreis: kompakter Schieberegler mit Bestätigung](entry-price/README.md).
## Native Umsetzung
Die [Widgetdokumentation](widgets/README.md) beschreibt den nativen Katalog,
Raster und Arbeitsanordnung; die [Dateiverwaltung](save-load/README.md) die
getrennten Karriere- und Ansichtsdateien. Beide lesen weiterhin Demodaten und
bestätigen keine Engine-Spielbarkeit.
+138
View File
@@ -0,0 +1,138 @@
<!-- SPDX-License-Identifier: GPL-3.0-only -->
# Speichern, Laden und Desktopansichten
Die native RmlUI-Fassung überträgt den privaten HTML-Goldstand der Dateien
`desktop/save-load-menu.js`, `desktop/save-load-window.css`,
`desktop/modern-dialogs.js` und `desktop/desktop-views.js`. Referenzrevision:
`4b1c3b61ccd7b19351cd0b2dfac1006918103c97`. Die Referenz bleibt privat und
unverändert; diese öffentliche Implementierung enthält keine Originalgrafiken
oder Originalspielstände. Ausgangsstand der nativen Umsetzung ist `db89d88`.
## Sichtbare Ansichten
Spielstände verwenden den gemeinsamen Untermenürahmen mit 2720 × 2040
Entwurfseinheiten. Die Desktopansichten verwenden das eigenständige
Desktopdialogfenster mit 2560 × 1840 Einheiten. Beide haben eine unbegrenzt
scrollbare Liste, eine getrennte Detailansicht und bestätigte Aktionen für
Überschreiben, Umbenennen und Löschen. „Neuer Speicherstand“ beziehungsweise
„Neue Ansicht“ erscheint nur beim Speichern. Fehlende oder beschädigte Dateien
bleiben mit einer Fehlermeldung erkennbar.
Die Karriereübersicht zeigt Saison, Spieltag, Spieldatum, Manager und Vereine
aus dem ausgewählten Dokument. Nur ein neuer Eintrag zeigt die aktuelle
Karriere. Die Demo befindet sich ohne gesonderte gespeicherte
`game_info.matchday`-Angabe in der Vorbereitung; hier wird kein zukünftiger
Engine-Spieltag erfunden. Die Saison folgt dem gespeicherten Spieldatum und
beginnt im Juli. Speicherdatum, Dateigröße und Änderungsdatum stammen aus dem
Dateianbieter. Namen werden vor der Anzeige als RmlUI-Text maskiert.
Die Ansicht „Standard“ ist eine unveränderliche, immer verfügbare Vorlage.
Sie verwendet beim Laden den aktuellen Look. Ihre Vorschau wird unmittelbar
aus der Standardgeometrie gezeichnet; sie ist kein Screenshot einer heimlich
auf die aktive Karriere angewendeten Ansicht. Eigene Ansichten enthalten den
tatsächlichen Desktop-Screenshot zum Speicherzeitpunkt sowie Anordnung,
Widgetgrößen, Sichtbarkeit, Fixierungen und Look. Der Screenshot entsteht ohne
Dateidialog und ohne das darüberliegende Verwaltungsfenster.
## Lokale Dateitransaktionen
`DemoFiles` speichert ausschließlich UI-Demostände; es liest und schreibt keine
OBS-/Engine-Karriere. Die Ablage liegt unter dem weltbezogenen
`userdata/ui-demo/<world-hash>/saves` beziehungsweise `layouts`. Der explizite
Parameter `--ui-userdata` erlaubt eine vollständig isolierte QA-Ablage.
Globale Anzeige-, Sound- und Themenpräferenzen bleiben in ihrer eigenen Datei.
Ein Datensatz ist ein Dokument mit Schema `openbmh-ui-file@1`. Es enthält
Bezeichnung, Art, Zeitstempel, Payload, Welt-ID, Hash der Weltmanifestrevision,
PNG-Vorschau und separate Inhaltsprüfsummen. Die PNG-Bytes werden verlustfrei
hexadezimal eingebettet. Deshalb werden Layout und Screenshot mit **einem**
atomaren Dateiaustausch veröffentlicht. Die Dateinamen sind opake IDs und
werden nicht aus Benutzernamen zusammengesetzt. Eine umbenannte Ansicht
behält Identität, ursprünglichen Speicherzeitpunkt und Vorschau.
Vor der Veröffentlichung werden Karriere und Desktop in isolierten Objekten
validiert. Karriereprüfungen nutzen die bestehenden `DemoSource`-Regeln. Die
aktive Quelle wird erst nach erfolgreicher Validierung ersetzt. Entwürfe
binden sich an Welt, Source-Objekt und Source-Revision. Bestätigungen tragen
zusätzlich den SHA-256-Token der ausgewählten Dateiversion. Ein inzwischen
geänderter, gelöschter oder fremder Datensatz wird zurückgewiesen.
Ein kurzlebiges Transaktionsverzeichnis serialisiert Anbieteroperationen.
Fehlgeschlagene Schreibvorgänge behalten den bisherigen Datensatz. Löschen
verwendet eine atomare Umbenennung; bei einem unterbrochenen Aufräumen bleibt
die Datei als versteckter, wiederherstellbarer Rest erhalten. Ein nach einem
Prozessabsturz verbliebenes Transaktionsverzeichnis wird nicht ungeprüft
entfernt: Nach Beenden aller beteiligten Prozesse muss es geprüft werden.
Symlinks und Pfadwechsel aus der Ablage werden zurückgewiesen. Abgeleitete
PNG-Vorschaudateien unter `.previews` sind nur ein durch Hash identifizierter
Cache; sie sind nie die autoritative gespeicherte Vorschau.
Namen besitzen 1 bis 64 Unicode-Zeichen und keine Steuerzeichen. Der
plattformunabhängige Vergleich berücksichtigt Groß-/Kleinschreibung,
deutsches ß, Ö/ö und komponierte/dekomponierte lateinische Tastaturakzente.
Ansichten berücksichtigen zusätzlich vollbreite ASCII-Kompatibilitätszeichen;
„Standard“ bleibt dabei reserviert. Speichernamen verwenden diesen
Kompatibilitätsschritt nicht. Die kleine portable Hilfe ist kein vollständiger
Unicode-NFC-/NFKC-Normalisierer: Seltene kombinierte Schriftzeichen außerhalb
der dokumentierten lateinischen Akzente bleiben bytegenau unterscheidbar.
Diese Grenze betrifft die Namen, nicht die Dateiinhalte oder Spielvalidierung.
Ältere rohe Demo-JSON-Spielstände und Layoutdateien werden gelesen, aber beim
Navigieren nicht umgeschrieben. Vorhandene PNG-Seitendateien können in ein
neues konsistentes Dokument übernommen werden. Alte Ansichten ohne Vorschau
zeigen einen ausdrücklichen Hinweis; vor der Veröffentlichung einer neuen
Ansichtsdatei ist eine gültige Vorschau erforderlich.
## Aktionen und Zustandsgrenzen
Import und Export sind ausdrückliche Buttonaktionen. Erst dann öffnet NFD
einen Betriebssystemdialog. QA kann mit `--ui-file-import` und
`--ui-file-export` konkrete Pfade bereitstellen; die Parameter lösen allein
keine Dateiaktion aus. Import validiert das Dokument vollständig und legt
einen neuen, bei Namenskonflikten umbenannten Eintrag an. Es wird kein
bestehender lokaler Stand überschrieben und keine Karriere automatisch
geladen. Export enthält Payload und Vorschau gemeinsam; ein vorhandenes
Ziel benötigt eine separate Überschreibbestätigung.
Karriere-Save setzt Source und Karriere-Desktop erst nach erfolgreicher
Veröffentlichung auf „gespeichert“. Karriere-Load setzt den ausgewählten
validierten Stand samt Layout auf „gespeichert“. Ansichts-Save verändert diese
Karrieremarkierungen nicht. Ansichts-Load erzeugt einen Desktop-Undo-Schritt,
speichert die globale Themenpräferenz zuerst und übernimmt anschließend
Layout und Look. Andere Anzeige- oder Soundwerte werden dabei nicht aus dem
Spielstand übernommen.
Die Root-Glue-Hooks `files_saved_success(bool)` und `files_loaded_success()`
verantworten den Rücksprung ins Hauptmenü, die Fortsetzung eines bestätigten
Beenden-Ablaufs und das Zurücksetzen sourceabhängiger Presenter. Abbrechen
und Escape verwerfen nur lokale Dateifensterentwürfe und die ausstehende
Beenden-nach-Speichern-Absicht. Navigation, Auswahl und Vorschau verändern die
aktive Karriere nicht.
## Prüfung und offene Enginefragen
`tests/modern_files_ui_tests.cpp` verwendet nur eine synthetische Welt und
temporäre QA-Dateien. Es prüft Namenskonflikte, atomare Payload-/PNG-Rundläufe,
veraltete Tokens, beschädigte Importe, fehlgeschlagene Überschreibungen,
Transaktionskonflikte, ausgewählte Dateimetadaten, Exportkollisionen, getrennte
UI-Präferenzen und den Rollback fehlgeschlagener Karrierevalidierung.
Ein Build und native Screenshot-/Interaktionsprüfungen müssen separat
ausgeführt werden; die Testquelle allein belegt kein Plattformverhalten.
Die spätere Engineanbindung muss den gemeinsamen Karriere-/Sessionanbieter
verwenden. OBS-Migration, Managerbesitz, Engine-Revisionen, RNG-Zustände,
Autosaves und echte Saisonfortschritte werden hier ausdrücklich nicht als
implementiert behauptet. Sie gehören nicht in diesen UI-Demodateianbieter.
## Bewusste Abgrenzungen zum Browser-POC
Ansichten und Arbeitsanordnung liegen in dieser nativen Demo im weltbezogenen
UI-Verzeichnis; vorhandene ältere native Layouts bleiben so erreichbar. Der
Browser-POC speichert diese Bibliothek browserglobal. Anzeige und Sound bleiben
nativ unabhängig von der Welt gespeichert. Das Laden einer Karriere setzt
diese globalen Präferenzen nicht zurück; eine benannte Ansicht darf dagegen
ihre ausdrücklich gespeicherte Gestaltung wiederherstellen.
Erfolgreiches Speichern und Laden einer Karriere lässt das Dateifenster mit
Auswahl und Rückmeldung offen. Ansichts-Speichern und -Laden kehren zum Desktop
zurück. Arbeitsanordnungen lösen keinen Spielstand-Speicherbedarf aus.
+54
View File
@@ -0,0 +1,54 @@
# Desktop und Widgets · native Umsetzung
Stand: 26. Oktober 2026. Referenz ist der unveränderte private HTML-Goldstand
`4b1c3b61`, insbesondere modern-layout.js, modern-desktop.js/.css und
modern-dialogs.js. Die bisherige HD-Oberfläche bleibt erhalten.
Der Desktop enthält 32 Appbuttons und 17 Widgettypen mit insgesamt 48
Größenvarianten. Die Standardansicht zeigt acht Widgets; sämtliche Elemente
sind zunächst fixiert. Das Raster verwendet 224-Punkte-Zellen, 24 Punkte
Abstand und einen Ursprung bei 64/224 im logischen 3840×2160-Raum.
Alle drei Themes und der proportional skalierte Desktop bleiben erhalten.
Kalender, Konto/Eintritt, nächste Begegnung, Managerporträt und Vereinswappen
übernehmen die Referenzgeometrie. Warnlampen zeigen zehn Zustände; die breite
4×1-Variante fasst Sondertraining/Erschöpfung und Startelf/Ersatzspieler zu
acht Lampen zusammen. Sie lassen sich für einen erklärenden Hinweis anklicken.
Konto, Werbeverträge, Aktien und Trainings-/Kaderdaten stammen aus dem gemeinsamen
UI-Demostand. Fan-Stimmung, Saisonkurven, Form, Platz/Stärke und direkte Duelle
bleiben klar benannte Pseudodaten. Diagramme verwenden die Pfade und Werte der
HTML-Referenz; sie berechnen keine Ergebnisse oder Tabellenregeln.
Die Widgetgalerie bietet Vorschauen, Suche und jede freigegebene Größe. Ein
hinzugefügtes Widget wird als vorhanden markiert; die Galerie bleibt offen.
Im Raster führt Platzmangel zu vollständigem Rollback. Frei platzierte Widgets
können sich überlagern. Eine gemeinsame Größenbasis lässt 4×1 und 3×3 exakt an
Appbutton-Zellen anschließen. Hintergründe haben einen eigenen Auswahldialog;
bisher ist ausschließlich das vorhandene Nachtstadion freigegeben.
Das Rechtsklickmenü folgt dem Goldlayout und bleibt unabhängig von der
Desktopskalierung 270 physische Pixel breit. Es unterscheidet Desktop- und
Objektaktionen. Fixierte Elemente lassen sich weder verschieben, verkleinern
noch entfernen. Rasterumschalten und Anordnen erhalten fixierte Positionen;
fehlender Platz übernimmt keine Teilanordnung. Rückgängig hält bis zu 40 Stände.
Bewegliche Widgets können auf den Papierkorb gezogen werden; Appbuttons bleiben
erhalten. Escape verwirft eine laufende Bewegung. Pfeiltasten bewegen im Raster
um eine Zelle, frei um 24 Punkte beziehungsweise mit Umschalt um 96 Punkte.
Die Arbeitsanordnung wird atomar als `working-desktop.json` im weltbezogenen
UI-Demoverzeichnis gespeichert. Sie verändert weder Quellenrevision noch
Spiel-Dirty. Ein ausdrücklich angegebener `--ui-state` hat Vorrang; kaputte
Arbeitsanordnungen werden gemeldet und bis zur bewussten Änderung erhalten.
Benannte Ansichten sind davon unabhängig und werden mit Theme und tatsächlicher
PNG-Vorschau in der [Dateiverwaltung](../save-load/README.md) gespeichert.
Spiel beenden bietet eine eigene Rückfrage. Nur geänderte Spielwerte erzeugen
Speicherbedarf; Änderungen an Layout oder globalen UI-Präferenzen zählen nicht
dazu. Nach Speichern/Verwerfen geht es zum Hauptmenü, beim OS-Schließen endet
die Anwendung. Abbrechen lässt die laufende Partie offen. Anstoß bleibt ohne
Aktion; Match-Engine, Audiosystem und Stadionperipherie gehören nicht zum Paket.
Native Bildnachweise, Eingabeskripte und passende UI-Democheckpoints liegen privat
unter `bmh_4k_ui/docs/qa/desktop-files-batch-2026-10-25/`. Öffentliche Tests verwenden
synthetische Kataloge. Build-/Control-CI ist von einer tatsächlichen nativen
Windows-/macOS-Spielabnahme zu unterscheiden.
+16
View File
@@ -219,3 +219,19 @@ Eingabeskripte liegen unter `bmh_4k_ui/docs/qa/settings-batch-2026-10-25/`.
Die Runtimekohorten behalten ihre tatsächlichen Binär-/Stylesheet-Hashes;
Bildkontrollen laufen unter Linux/OpenGL. Das Paket schließt keine Engine-,
Audio- oder Windows-/macOS-Laufzeitabnahme ein.
Die Pakete Dateiverwaltung und Desktop/Widgets werden gemeinsam als Meilenstein
geprüft. Die lokale Suite besteht **34/34 Tests**. Zusätzliche öffentliche
Tests decken atomare Dateibibliotheken, Überschreibschutz, Pfadaliasse,
In-Memory-Laden, Bestätigung gespeicherter Revisionen, Widgetmetadaten,
Raster-/Fixierungsschutz und tatsächlich berechneten Galerie-Scrollbereich ab.
Die Schriftprüfung lädt beide Produktionsstylesheets und kontrolliert zusätzlich
Monatsname, Warnbeschriftungen und Begegnungsnamen in drei Themes/vier Dichten.
Die privaten Belege liegen unter
`bmh_4k_ui/docs/qa/desktop-files-batch-2026-10-25/`. Karriere- und Ansichtsdateien
bleiben UI-Demodaten. Die vertieften Dateitests enthalten tatsächliche
GUI-Eingaben und externe Änderungen eigener QA-Dateien zwischen Auswahl und
Bestätigung; es werden keine Produktzustände in den laufenden Prozess injiziert.
Separate Runtimekohorten bewahren ihre ursprünglichen Fingerprints.
+11
View File
@@ -101,3 +101,14 @@ Inhaltsabstand berücksichtigt. Anzeige und Sound werden unabhängig vom
OBW gespeichert; reine globale Änderungen verändern keinen Demostand.
Die Einstellungen verwenden weiterhin den nativen Select-Unterbau;
die bereits oben vermerkte vollständige Pickerangleichung bleibt offen.
In den Paketen Dateiverwaltung und Desktop/Widgets behoben: aktuelle statt
ausgewählter Speicherstanddaten, getrennte atomare Layout-/PNG-Transaktionen,
fehlende Widgetinhalte und Vorschauen, nicht zur Scrollhöhe beitragende
Galeriekarten, anonyme Flexbeschriftungen, der fehlende Eintrittspreisanker
sowie verlorener Dateizeilenfokus. Galerie-Vorschauen sind auch per Tastatur
inert. Kontextmenüs verwenden ihre Borderbox zur Randbegrenzung und zeigen
Fixierungs-/Rasterzustände. Exporte dürfen keine verwalteten Slots ersetzen.
Die native Ansichts-/Arbeitsablage bleibt bewusst weltbezogen, während Gold
browserglobal speichert; diese Abgrenzung ist in der Dateiverwaltung dokumentiert.