[stable-33.0] Develop stable 33.0

.claude/context/gui/CLAUDE.md

@@ -0,0 +1,44 @@
+# Kontext-Karte: src/gui
+
+Diese Struktur unter `.claude/context/gui/` spiegelt `src/gui/` und liefert für jeden Bereich eine kompakte, KI-lesbare Beschreibung: Zweck, Kernklassen, wie die Teile zusammenspielen, und was fork-spezifisch (BRICKMAKERS/IONOS/HiDrive Next/Strato-Whitelabel) statt generischer Nextcloud-Upstream-Code ist. Bewusst **getrennt vom Quellcode** gehalten, damit sie nicht mit echten Source-Dateien verwechselt oder versehentlich mitgebaut wird.
+
+`nc-desktop` ist ein Whitelabel-Fork des Nextcloud-Desktop-Clients für IONOS/HiDrive Next/STRATO. `src/gui/` enthält ~450 Dateien: 229 davon liegen flach direkt im Wurzelverzeichnis, der Rest verteilt sich auf 11 Unterordner.
+
+## Navigation
+
+**Unterordner** (jeweils eigenes `CLAUDE.md`, Struktur spiegelt `src/gui/<name>/`):
+
+| Ordner | Inhalt |
+|---|---|
+| [tray/](tray/CLAUDE.md) | Systray-Popup: Header, Account-Menü, Activity-Feed, Sync-Status, Unified Search *(größter Unterordner, bekannter Merge-Hotspot)* |
+| [wizard/](wizard/CLAUDE.md) | Account-Setup-Wizard (Server-URL, Login, Datenschutz-Consent, Ordner-Konfiguration) |
+| [macOS/](macOS/CLAUDE.md) | macOS-spezifische Integration (FileProvider/VFS, XPC, Single-Instance) |
+| [filedetails/](filedetails/CLAUDE.md) | Datei-Detailansicht mit Sharing-Tab |
+| [creds/](creds/CLAUDE.md) | Authentifizierung & Credential-Speicherung (Keychain, Login Flow v2) |
+| [updater/](updater/CLAUDE.md) | Selbst-Update-Mechanismus (NSIS/Sparkle/Passive) |
+| [SesComponents/](SesComponents/CLAUDE.md) | Fork-eigene, wiederverwendete UI-/Logik-Bausteine ("Ses"-Präfix) |
+| [cloudproviders/](cloudproviders/CLAUDE.md) | Linux `libcloudproviders`/GNOME-Integration |
+| [ga4/](ga4/CLAUDE.md) | Google-Analytics-4-Telemetrie (fork-eigen) |
+| [integration/](integration/CLAUDE.md) | Server-definierte Datei-Aktionen (Kontextmenü-Popup) |
+| [socketapi/](socketapi/CLAUDE.md) | IPC-Server für Explorer/Finder-Shell-Erweiterungen |
+
+**Wurzelverzeichnis** (229 Dateien ohne Unterordner, keine 1:1-Ordnerstruktur möglich):
+
+- [COMPONENTS.md](COMPONENTS.md) — Tabelle aller Dateien, gruppiert in acht fachliche Cluster: Account & Connection, Folder & Sync Management, **Settings Dialog & App Settings (⚠️ bekannter Merge-Hotspot)**, Sharing & OCS API Jobs, User Status & Emoji, App Shell/Theming & Window Chrome, File Activity/Tags & External Editing, Platform Glue (macOS/Cocoa) & Misc.
+
+## Fork-Erkennungsmerkmale
+
+Wiederkehrende Marker, an denen sich fork-eigener Code von generischem Nextcloud-Upstream-Code unterscheiden lässt:
+- Namenspräfix **"ses"** (BRICKMAKERS-Ticketpräfix, z. B. `sesStyle`, `SesComponents`, `sesFileIconProvider`) — praktisch immer fork-eigen.
+- Compile-Guards **`IONOS_BUILD`, `IONOS_WL_BUILD`, `STRATO_WL_BUILD`** — schalten Code zwischen IONOS- und Strato/HiDrive-Next-Branding um; `StratoTheme` ist der `#else`-Default-Zweig.
+- QML-Modul-Import **`com.strato.hidrivenext.desktopclient`** statt eines generischen `com.nextcloud.desktopclient` — praktisch jede `.qml`-Datei im Fork nutzt das.
+- Klassen **`BaseTheme`/`IonosTheme`/`StratoTheme`** als zentrale Theming-Schicht über dem generischen `Theme`; **`WLTheme`** ist keine eigene Klasse, sondern die global genutzte `static`-Singleton-Instanz davon (je nach Build-Guard `IONOS_WL_BUILD` vom Typ `IonosTheme` oder `StratoTheme`, siehe `whitelabeltheme.h`).
+- Referenzen auf **"hidrivenext"** in Log-Kategorien/Dateinamen (z. B. `hidrivenext.log`) als Branding-Leck in sonst generischem Code.
+
+## Bekannter Merge-Hotspot
+
+Die **Settings-Dialog-Dateien im Wurzelverzeichnis** (`settingsdialog.*`, `generalsettings.*`, `networksettings.*`) sowie Teile von `tray/` (`MainWindow.qml`, `TrayWindowAccountMenu.qml`, `UserLine.qml`) sind historisch die häufigsten Stellen für Merge-Konflikte mit dem upstream `stable-x.y`-Branch. Bei Arbeiten dort den [`stable-merge-check`-Skill](../../skills/stable-merge-check/SKILL.md) nutzen (Referenz-Branch siehe dort in `reference-branch.txt`).
+
+## Pflegehinweis
+
+Diese Dokumente wurden am 2026-08-17 automatisiert per Code-Scan erstellt (nicht Zeile-für-Zeile von Boris verifiziert) und sollten vor blindem Vertrauen gegengelesen werden — insbesondere Aussagen zu "dead code"/unbenutzten Pfaden. Sie beschreiben Struktur/Zweck, nicht Implementierungsdetails, und veralten daher langsamer als der Code selbst — trotzdem bei größeren Umbauten in einem Bereich das jeweilige `CLAUDE.md` mit aktualisieren.

.claude/context/gui/SesComponents/CLAUDE.md

@@ -0,0 +1,23 @@
+# src/gui/SesComponents
+
+This folder holds small, fork-specific UI/logic components used across the GUI, kept separate from upstream Nextcloud code so they survive upstream merges with minimal conflicts. "Ses" is this team's internal ticket/component prefix (BRICKMAKERS work on the IONOS/HiDrive Next/STRATO whitelabel fork). All six files here are fork-specific — there is no upstream equivalent folder.
+
+## Key classes/components
+
+- `SesErrorBox.qml` — reusable inline error banner (icon + bold "Error" title + wrapped message text), styled via `Style.ses*` tokens; used e.g. in `filedetails/ShareDetailsPage.qml` to show password errors.
+- `SesTrayHeader.qml` — custom tray-popup header bar (account menu button, "Website" link, local/team-folder button, optional "featured app"/assistant button); embedded into `tray/MainWindow.qml` as `trayWindowHeaderBackground`, replacing/restyling the upstream Nextcloud tray header row for the whitelabel look.
+- `SesCheckBox.qml` (SES-597) — themed `CheckBox` override: square 20×20 indicator (checked = `accentColor` fill, unchecked = `Style.sesTrayInputField` border) with a white checkmark glyph, `Style.sesTrayFontColor` label text. `accentColor` is a property (default `Style.sesCheckboxAccentColor`) rather than reaching up to a parent page, so call sites pass it explicitly. Extracted out of a local `component` block in `filedetails/ShareDetailsPage.qml` (its only current caller) to cut that page's structural drift from upstream `stable-33.0`.
+- `SesInputBackground.qml` (SES-597) — trivial bordered-`Rectangle` background (`Style.sesTrayInputField` border, `Style.sesBackgroundColor` fill, `z: -1`, fills parent) used behind text-entry fields. Extracted from three copy-pasted instances in `filedetails/ShareDetailsPage.qml` (its only current caller: password, expiry-date, note fields).
+- `syncdirvalidation.h` / `syncdirvalidation.cpp` — `SyncDirValidator` class: on Windows, checks that a chosen sync directory is not the app's own `%AppData%` roaming path (to avoid users pointing sync at the app's own data folder); on other OSes it's a no-op always returning valid. Used by `folderwizard.cpp` and `wizard/owncloudadvancedsetuppage.cpp` during local-folder selection.
+
+## How it fits together
+
+The QML components are drop-in replacements/extensions for tray and sharing UI, pulled in via relative QML imports (`import "../tray/"` etc.) and the shared `Style` singleton for whitelabel theming; `SyncDirValidator` is an unrelated plain C++ helper reused by folder-setup wizards to validate a picked path. All are additive fork logic, not modifications of upstream files. `SesCheckBox`/`SesInputBackground` are registered as QML types the same way as `SesErrorBox`/`SesTrayHeader` (via `ionos.qrc`).
+
+## Fork-specific notes
+
+- Entire folder is fork-only (BRICKMAKERS/IONOS-HiDrive Next fork), no upstream Nextcloud equivalent directory exists.
+- `SesTrayHeader.qml` specifically substitutes for/duplicates parts of what would otherwise be inline header markup in upstream `tray/MainWindow.qml`.
+- `SesCheckBox.qml`/`SesInputBackground.qml` are the newest additions (SES-597): both existed only as inline, duplicated markup inside `filedetails/ShareDetailsPage.qml` until extracted here specifically to reduce that page's ~99% line-level drift from upstream `stable-33.0` and ease future merges — a pattern worth repeating for other heavily-drifted pages.
+
+*Quelle: src/gui/SesComponents — Stand 2026-09-10, automatisch erstellt, bitte gegenlesen.*