---
name: xp-content
description: Gemeinsame Inhalte eigener XP- und MCP-Apps.
wiki: {"schema": "wiki-page/v1", "title": "XP-Content: aktueller Vertrag", "summary": "Stabiler Einstieg, Buildmanifest, gemeinsame Komponenten und gebündelte Assets.", "document_type": "reference", "status": "active", "navigation": {"placement": "unlisted"}, "tags": ["xp", "contract", "css"], "audience": ["developer", "admin", "codex"], "owner": "infrastructure", "reviewed_at": "2026-10-05", "related": []}
---

# XP-Content: aktueller Vertrag

Verbindlicher Einstieg für Apps und Entwickler: https://mcp-lab.christian-igel.tech/xp-contract/
Neue Builds lesen manifest.json hier und beziehen xp-content.css und xp-content-menu.js anhand der veröffentlichten Hashes. Versionen müssen nicht im App-Code oder sichtbaren Hinweis festgeschrieben werden. Das Release hält die tatsächlich gebündelten Bytes, Version und SHA-256 intern fest. Offline-Builds verwenden ausdrücklich ihren geprüften Lockbestand; historische Versionen sind nur eine begründete Ausnahme.
MCP bündelt beide Dateien im HTML; kein Laufzeit-Hotlink und keine neue Sandbox-Netzfreigabe. HostContext/Metadaten sind das getrennte Präsentationsprotokoll 1.1.0; bestehendes 1.0.0 bleibt kompatibel. Ein CSS-Update erteilt keine Rechte.
Root .xp-content[data-xp-content-version="1"], Darstellung data-xp-presentation="xp|neutral", Theme data-xp-theme="light|dark". Klassen erzeugen keine Fachfunktionen.
Explorer: xp-menu-item, xp-menu-select, xp-menu-only, data-xp-menu="file|view|projects". Seltene Aktionen und Projektauswahl ins Menü; Speichern und häufige Aktionen zusätzlich im Inhalt. Ausblenden erst nach bestätigter Registrierung.
Klassenreferenzen: https://mcp-lab.christian-igel.tech/documentation/contracts/xp-content/v1.1/ (Sidebar, Navigation, Toolbar, Menüs), /v1.4/ (Darstellungsprofile) und /v1.5/ (Desktop-Steuerelemente). Diese historischen Referenzen bleiben erreichbar; Apps verwenden den stabilen Einstieg.
Prüfen: XP/neutral, light/dark, Tastatur/ARIA, 320/390/1280 CSS-Pixel, 200% Zoom, Kontrast und Fensterlebenszyklus. Keine Parent-DOM-Injektion, keine Auth-/CSP-Lockerung, Dokument-CSS isoliert erhalten.


## Sonnengelb für Gast

XP-Content 1.5.1 ergänzt gemeinsame Gast-Farbtokens. Die dominante Farbe ist
ein sattes Sonnengelb; dunkle Schrift und Fokuslinien erhalten den Kontrast.

| Token | Wert | Verwendung |
| --- | --- | --- |
| `--xp-role-guest-color` | `#ffd21f` | kräftiges Sonnengelb, Auswahl |
| `--xp-role-guest-light` | `#fff28a` | helle Gastflächen |
| `--xp-role-guest-deep` | `#f5b800` | satter gelber Verlauf |
| `--xp-role-guest-ink` | `#302400` | lesbare Schrift auf Gelb |
| `--xp-role-guest-focus` | `#634900` | kontrastreiche Fokuslinie auf hellen Flächen |

Ein teilnehmender Adapter kann am eigenen Vertragsroot
`data-xp-app-role="guest"` setzen, nachdem er die bestätigte Ansichtsrolle aus
dem HostContext gelesen hat. In XP-Darstellung nutzen Sidebar, Toolbar und
Auswahl dann die Gastpalette; im dunklen Theme bleiben Flächen dunkel und
gelbe Akzente lesbar. Ohne Attribut bleiben bisherige Farben erhalten.
Neutraldarstellung bleibt unverändert. Systemfarben überschreiben die Palette
im Modus mit erzwungenen Farben.

Das Attribut und die Tokens beschreiben ausschließlich die Darstellung. Sie
ändern weder Sitzung noch Rollenrechte; der Server entscheidet weiterhin über
den Zugriff. Es wird keine neue SDK-Benachrichtigung eingeführt und kein
Parent-DOM gelesen. Fensterrahmen und XP-Modern-/XP-Aero-Material gehören zum
Host. Die vier Inhaltsansichten MCP/HTML mit oder ohne XP-Vertrag bleiben davon
unabhängig. Historische Releases einschließlich 1.5.0 bleiben unverändert.

Fensterfokus: `data-xp-window-focus="foreground|background"`, Inhaltsklassen `xp-window-content-foreground|background`; siehe window-focus.md. Fokus ist unabhängig von Rolle und Min/Max. Host oder eigener Adapter besitzt den Effekt, niemals beide.


## Optionaler Aktionslebenszyklus

[ci-action-lifecycle/v1](actions/v1/contract.md) ergänzt passende MCP-Aktionen mit
sofortigem lokalem Warten, echten accepted/alive/progress-Ereignissen und
maßgeblicher fachlicher Endantwort. [Gemeinsames UI-Modul 1.0.0](actions/v1/README.md)
und [interaktives Beispiel](actions/v1/example.html) stehen bereit. Capability
ausdrücklich aushandeln; ohne Unterstützung Legacy-JSON, kein Status-Polling und
kein Wiederholen bereits begonnener Aufrufe. Transportabbruch bestätigt keinen
Serverabbruch. XP-Presentation bleibt 1.1.0; keine automatische Bestandsmigration.