upload docs for extensions new api and image mannagement (#6)

Author: xscriptor

docs/de/SUMMARY.md

@@ -2,7 +2,7 @@
 
 Ein plattformunabhangiges Systeminformations-Tool geschrieben in Rust.
 
-- **Version:** 0.2.0
+- ****Version:** 0.3.0
 - **Lizenz:** MIT
 - **Autor:** xscriptor
 - **Repository:** github.com/xfetch-cli/xfetch
@@ -63,22 +63,34 @@ Ein plattformunabhangiges Systeminformations-Tool geschrieben in Rust.
    - Eigene Plugins schreiben
    - Plugin-API-Crate
 
-6. [Anpassung](customization.md)
+6. [Erweiterungen](extensions.md)
+   - Erweiterungsarchitektur im Uberblick
+   - Konfiguration uber config_providers
+   - JSON-Drahtprotokoll
+   - Installation und CLI-Befehle
+   - Offizielle Erweiterungen
+     - config-roulette
+     - layout-override
+   - Eigene Erweiterungen schreiben
+
+7. [Anpassung](customization.md)
    - ASCII- und Bildlogos
+   - Bildgrosse und Positionierung
+   - Kitty Terminal Bild-Rendering
    - Logo-Animationsstile
    - Nerd Font Icons
    - ANSI-Farbanpassung
    - Paletten-Anzeigestile
    - Preset-Konfigurationen
 
-7. [Fortgeschrittene Nutzung](advanced-usage.md)
+8. [Fortgeschrittene Nutzung](advanced-usage.md)
    - Benchmark-Modus
    - Cache-System
    - Datenschutzeinstellungen
    - Plattformubergreifendes Verhalten
    - Leistungsoptimierung
 
-8. [Presets-Referenz](presets.md)
+9. [Presets-Referenz](presets.md)
    - Layout-Presets
    - Showcase-Presets
    - Plugin-Presets
@@ -95,7 +107,7 @@ Ein plattformunabhangiges Systeminformations-Tool geschrieben in Rust.
     - Aktionen (liste, suche, info, installiere)
     - Registry und benutzerdefinierte Registries
 
-11. [Mitwirken](contributing.md)
+12. [Mitwirken](contributing.md)
     - Aus dem Quellcode bauen
     - Projektstruktur
     - Plugin-Entwicklungsleitfaden
@@ -107,24 +119,24 @@ Ein plattformunabhangiges Systeminformations-Tool geschrieben in Rust.
     - Aktuelle Phase (Tests, erweiterte Funktionen)
     - Zukunftsplane
 
-13. [Sicherheit](security.md)
+14. [Sicherheit](security.md)
     - Melden von Sicherheitslucken
     - Sicherheitsempfehlungen
     - Unterstutzte Versionen
 
-14. [Support](support.md)
+15. [Support](support.md)
     - Hilfe erhalten
     - Vor dem Offnen eines Issues
     - Reaktionserwartungen
 
-15. [Anderungsprotokoll](changelog.md)
+16. [Anderungsprotokoll](changelog.md)
     - Versionsgeschichte
     - Phasenweises Anderungsprotokoll
 
-16. [Verhaltenskodex](code-of-conduct.md)
+17. [Verhaltenskodex](code-of-conduct.md)
     - Unsere Standards
     - Inakzeptables Verhalten
     - Melden
 
-17. [Lizenz](license.md)
+18. [Lizenz](license.md)
     - MIT-Lizenzbestimmungen

docs/de/changelog.md

@@ -1,5 +1,16 @@
 # Anderungsprotokoll
 
+## v0.3.0 · Bild-Rendering und Erweiterungen · 2026-07-25
+
+- **Kitty Bild-Rendering uberarbeitet:** `logo_kitty` Toggle (natives Protokoll vs Half-Block), `logo_gap` fur konfigurierbaren Bild-Text-Abstand, `logo_width`/`logo_height` fur explizite Grose, und auto-responsive Breite (28% des Terminals, clamp 12–42 Spalten)
+- **Cursor-Positionierung korrigiert:** `MoveUp`/`MoveToColumn` durch `SavePosition`/`RestorePosition` ersetzt fur korrektes Verhalten bei allen Bildprotokollen
+- **Stacked-Layout korrigiert:** `print_stacked_output()` fur reine Bildlogos (ohne ASCII-Text) repariert
+- **Erweiterungs-API:** `api/crates/extension-api/` erstellt — `ConfigProviderRequest`/`ConfigProviderResponse` Protokoll, `config_providers[]` Feld, stdin/stdout JSON-Kommunikation
+- **config-roulette Erweiterung:** Wahlt zufallige oder tagliche Konfiguration aus einer JSON-Routenliste, unterstutzt 100+ Routen
+- **layout-override Erweiterung:** Erzwingt Layout und/oder Module beim Konfigurationsladen
+- **Erweiterungs-CLI:** Befehle `xfetch extension install/list/remove` hinzugefugt
+- **100 bildbasierte Konfigurationen** fur config-roulette mit `logo_gap: 3` und `logo_kitty: true`
+
 ## Phase 0 · Grundlage und Kern
 
 - Rust-Projekt mit Abhangigkeiten initialisieren

docs/de/configuration.md

@@ -77,12 +77,17 @@ JSONC erweitert standard JSON um C-Style (`//`) und C++-Style (`/* */`) Kommenta
 | `palette_style` | `string` | `"squares"` | Paletten-Anzeigestil |
 | `logo_path` | `string` oder `null` | `null` | Pfad zu einer benutzerdefinierten Logodatei |
 | `ascii` | `string` oder `null` | `null` | Pfad zu einer ASCII-Kunst-Datei (Alternative zu logo_path) |
+| `logo_width` | `number` oder `null` | `null` | Breitenbeschränkung fur Bildlogos (in Terminal-Spalten, automatisch berechnet wenn nicht gesetzt) |
+| `logo_height` | `number` oder `null` | `null` | Hohenbeschränkung fur Bildlogos (in Terminal-Zeilen) |
+| `logo_gap` | `number` oder `null` | `12` | Abstand zwischen dem Logo/Bild und dem Infotext (in Spalten) |
+| `logo_kitty` | `boolean` oder `null` | `true` (in Kitty) | Kitty natives Bildprotokoll verwenden (`true`) oder Half-Block-Rendering (`false`). Half-Block hat geringere Auflosung, vermeidet aber Layout-Probleme |
 | `header_icons` | `array` oder `null` | `null` | Icons fur den oberen Rand (Pac-Man-Layout) |
 | `footer_text` | `string` oder `null` | `null` | Text fur den unteren Rand (Pac-Man-Layout) |
 | `disable_ip_fetching` | `boolean` | `false` | Abrufen der offentlichen IP aus Datenschutzgrunden deaktivieren |
 | `disable_cache` | `boolean` | `false` | Daten-Caching deaktivieren |
 | `logo_animation` | `object` oder `null` | `null` | Logo-Animationskonfiguration |
 | `info_plugins` | `array` | `[]` | Liste der auszufuhrenden Info-Plugins |
+| `config_providers` | `array` | `[]` | Liste der Konfigurations-Provider-Erweiterungen, die nach der Themenzusammenfuhrung ausgefuhrt werden |
 
 ### Standardmodule
 
@@ -268,6 +273,37 @@ Plugin-Daten werden uber Modulschussel mit dem Prefix `plugin:` abgerufen:
 }
 ```
 
+### Konfigurationsanbieter
+
+Das Feld `config_providers` ermoglicht Erweiterungen auf Konfigurationsebene, die Konfiguration vor dem Rendering zu andern. Erweiterungen werden nach der Themenzusammenfuhrung in Deklarationsreihenfolge ausgefuhrt:
+
+```jsonc
+{
+    "config_providers": [
+        {
+            "extension": "config-roulette",
+            "args": {
+                "routes": "~/.config/xfetch/routes.json",
+                "strategy": "random"
+            }
+        },
+        {
+            "extension": "layout-override",
+            "args": {
+                "layout": "tree"
+            }
+        }
+    ]
+}
+```
+
+| Feld | Typ | Beschreibung |
+|-------|------|-------------|
+| `extension` | `string` | Erweiterungsname (Binardatei: `xfetch-extension-<name>`) |
+| `args` | `object` oder `null` | Beliebige JSON-Argumente, die an die Erweiterung ubergeben werden |
+
+Erweiterungen kommunizieren uber stdin/stdout JSON, empfangen die vollstandig aufgeloste Konfiguration und geben eine modifizierte Version zuruck. Siehe [Erweiterungen](extensions.md) fur Details.
+
 ## Konfigurationsdatei-Speicherorte nach Plattform
 
 | Plattform | Standard-Konfigurationspfad |

docs/de/customization.md

@@ -68,10 +68,48 @@ xfetch kann PNG-, JPG- und SVG-Bilder als Logos mit der Bibliothek `viuer` rende
 Das Bild-Rendering verwendet das native Bildprotokoll des Terminals:
 
 - **iTerm2:** Inline-Bildprotokoll
-- **Kitty:** Kittys natives Bildprotokoll
+- **Kitty:** Kittys natives Bildprotokoll (hohe Auflosung)
 - **Sixel:** Sixel-Grafiken (kompatible Terminals wie xterm, mlterm)
 
-Wenn das Terminal keine Bildanzeige unterstützt, fallt xfetch auf ASCII zurück.
+Wenn das Terminal keine Bildanzeige unterstützt, fallt xfetch auf ASCII zuruck.
+
+#### Bildgrosse und Positionierung
+
+Steuern Sie Bildabmessungen und Abstande mit diesen Feldern:
+
+```jsonc
+{
+    "logo_path": "~/.config/xfetch/images/mein-bild.png",
+    "logo_width": 30,
+    "logo_height": null,
+    "logo_gap": 5
+}
+```
+
+| Feld | Standard | Beschreibung |
+|-------|---------|-------------|
+| `logo_width` | Auto (28% der Terminalbreite, clamp 12–42 Spalten) | Bildbreite in Terminal-Spalten |
+| `logo_height` | Auto (Seitenverhaltnis erhalten) | Bildhohe in Terminal-Zeilen |
+| `logo_gap` | 12 | Abstand in Spalten zwischen Bild und Infotext |
+
+Die automatische Breitenberechnung skaliert mit Ihrem Terminal: breitere Terminals erhalten proportional grosere Bilder.
+
+#### Kitty Terminal Bild-Rendering
+
+In Kitty-Terminals unterstutzt xfetch zwei Rendering-Modi, gesteuert durch `logo_kitty`:
+
+```jsonc
+{
+    "logo_kitty": true
+}
+```
+
+| Wert | Modus | Beschreibung |
+|-------|------|-------------|
+| `true` (Standard) | Natives Protokoll | Vollauflosende Bilder mit Kittys `\x1b_G` Grafikprotokoll. Beste Qualitat. |
+| `false` | Half-Block | Bilder gerendert mit Unicode Half-Block-Zeichen (`▄`). Geringere vertikale Auflosung, aber voll kompatibel mit allen Terminalfunktionen. |
+
+Setzen Sie `logo_kitty: false`, wenn Sie Layout-Probleme mit nativem Kitty-Rendering haben (z.B. Textuberlappung oder Fehlausrichtung). Der Half-Block-Fallback garantiert korrektes Side-by-Side-Layout auf Kosten etwas geringerer Bildtreue.
 
 ## Logo-Animation
 

docs/de/extensions.md

@@ -0,0 +1,136 @@
+# Erweiterungen
+
+Erweiterungen sind eigenständige Binardateien, die in den xfetch-Lebenszyklus auf Konfigurationsebene eingreifen. Anders als Plugins (die Infozeilen bereitstellen oder Logos animieren), empfangen Erweiterungen die vollständig aufgelöste Konfiguration uber stdin, modifizieren sie und geben eine modifizierte Version uber stdout zuruck.
+
+## Architektur
+
+```
+xfetch core
+  │
+  ├─ Ladt config.jsonc
+  ├─ Fugt Thema zusammen (falls gesetzt)
+  │
+  ├─ extension-1 (stdin/stdout JSON)  ← modifiziert Konfiguration
+  ├─ extension-2 (stdin/stdout JSON)  ← modifiziert Konfiguration
+  ├─ ...
+  │
+  └─ Rendert finale Konfiguration
+```
+
+Erweiterungen werden **nach der Themenzusammenfuhrung, in Deklarationsreihenfolge** ausgefuhrt. Jede Erweiterung erhalt die vom vorherigen Schritt produzierte Konfiguration, sodass sie verkettet werden konnen.
+
+## Installation
+
+Erweiterungen werden in `~/.config/xfetch/extensions/` installiert:
+
+```bash
+cp xfetch-extension-<name> ~/.config/xfetch/extensions/
+```
+
+Oder per CLI:
+
+```bash
+xfetch extension install ./pfad/zum/binar
+xfetch extension list
+xfetch extension remove <name>
+```
+
+Erweiterungsbinardateien folgen der Namenskonvention `xfetch-extension-<name>` (`.exe` unter Windows).
+
+## Konfiguration
+
+Fugen Sie Erweiterungen uber das Feld `config_providers` zu Ihrer Konfiguration hinzu:
+
+```jsonc
+{
+    "config_providers": [
+        {
+            "extension": "layout-override",
+            "args": {
+                "layout": "tree"
+            }
+        },
+        {
+            "extension": "config-roulette",
+            "args": {
+                "routes": "~/.config/xfetch/routes.json",
+                "strategy": "daily"
+            }
+        }
+    ]
+}
+```
+
+| Feld | Typ | Beschreibung |
+|-------|------|-------------|
+| `extension` | `string` | Erweiterungsname (Binardatei: `xfetch-extension-<name>`) |
+| `args` | `object` oder `null` | Beliebige JSON-Argumente, die an die Erweiterung ubergeben werden |
+
+## Protokoll
+
+Erweiterungen kommunizieren uber stdin/stdout mit dem JSON-Protokoll, das in `xfetch-extension-api` definiert ist.
+
+### Anfrage (stdin)
+
+```json
+{
+    "version": 1,
+    "kind": "config_provider",
+    "config": {
+        "layout": "section",
+        "modules": ["os", "kernel", "uptime"],
+        "colors": { "os": "Cyan" }
+    },
+    "args": {
+        "layout": "tree"
+    }
+}
+```
+
+Das Feld `config` enthalt die vollstandig aufgeloste xfetch-Konfiguration nach Zusammenfuhrung von Standardwerten, Konfigurationsdatei und ggf. Thema.
+
+### Antwort (stdout)
+
+```json
+{
+    "config": {
+        "layout": "tree",
+        "modules": ["os", "kernel", "uptime"],
+        "colors": { "os": "Cyan" }
+    }
+}
+```
+
+Die Erweiterung gibt die gesamte modifizierte Konfiguration zuruck. Unveranderte Felder sollten unverandert erhalten bleiben.
+
+### Fehlerbehandlung
+
+Fehler sollten auf stderr ausgegeben werden. Der Prozess sollte mit einem Status ungleich null beendet werden. xfetch uberspringt die Erweiterung und fahrt mit der aktuellen Konfiguration fort, wenn ein Fehler auftritt.
+
+## Verfugbare Erweiterungen
+
+| Erweiterung | Beschreibung |
+|-----------|-------------|
+| [config-roulette](extensions/config-roulette.md) | Wahlt eine zufallige (oder tagliche) Konfiguration aus einer Liste von Pfaden |
+| [layout-override](extensions/layout-override.md) | Uberschreibt das Layout und/oder die Module beim Laden der Konfiguration |
+
+## Verzeichnisse
+
+| Plattform | Erweiterungspfad |
+|----------|----------------|
+| Linux | `~/.config/xfetch/extensions/` |
+| macOS | `~/Library/Application Support/xfetch/extensions/` |
+| Windows | `%APPDATA%\xfetch\extensions\` |
+
+## Eigene Erweiterungen schreiben
+
+Erweiterungen mussen:
+
+1. Ein `ConfigProviderRequest` JSON-Objekt von stdin lesen
+2. Das `config`-Feld nach Bedarf modifizieren
+3. Ein `ConfigProviderResponse` JSON-Objekt auf stdout schreiben
+4. Mit Status 0 bei Erfolg, ungleich null bei Fehler beenden
+
+Verwenden Sie das `xfetch-extension-api` Crate von `github.com/xfetch-cli/api` fur typsichere Anfrage-/Antwortbehandlung in Rust.
+
+Das gemeinsame API-Crate ist verfugbar unter: [github.com/xfetch-cli/api](https://github.com/xfetch-cli/api)