Kopfleiste: Steckplatz "aktionen" für eigene Knöpfe der Tools

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

README.md

@@ -44,6 +44,22 @@ Eigene Icons können in Authentik hochgeladen werden, sonst nimmt das Portal sei
 - `data-auto="false"`: nicht automatisch einfügen, sondern selbst `<hi-topbar app="vvl"></hi-topbar>` platzieren.
 - Die Leiste ist 44 px hoch und setzt `--hi-topbar-height` auf `<html>`. Layouts mit `height: 100vh` sollten `calc(100vh - var(--hi-topbar-height, 0px))` verwenden.
 - Die Leiste nutzt Shadow DOM, CSS-Konflikte mit dem Tool sind also ausgeschlossen.
+- **Eigene Knöpfe** (z.B. Speichern, Filter, Hilfe) erscheinen rechts vor dem Avatar, wenn sie als Kind mit `slot="aktionen"` in `<hi-topbar>` stehen. Die Leiste ist dunkelviolett, Text erbt Weiß; das Styling der Knöpfe bleibt beim Tool.
+
+  ```html
+  <!-- mit data-auto="false" selbst platziert -->
+  <hi-topbar app="vvl">
+    <button slot="aktionen" class="mein-knopf">Speichern</button>
+  </hi-topbar>
+  ```
+
+  ```js
+  // oder in die automatisch eingefügte Leiste hängen (nach DOMContentLoaded, in React z.B. im useEffect)
+  const btn = document.createElement('button');
+  btn.slot = 'aktionen';
+  btn.textContent = 'Speichern';
+  document.querySelector('hi-topbar')?.append(btn);
+  ```
 
 **Content-Security-Policy des Tools erweitern** (sonst blockiert der Browser die Leiste):