Tool-Paket-Schnittstelle 0.1

Seit Studio-Version 0.1.89 kannst du ZIP-basierte Pakete mit der Endung .tp installieren. Bisherige .tp.zip-Dateien bleiben nutzbar; Endung und Manifest müssen zur Tool-Paketart passen.

Über Einstellungen → Tools installierst du ein lokales *.tp.zip. Installierte Tools erscheinen zusätzlich als Symbole in zwei Reihen der Editor-Werkzeugleiste; das Koffersymbol dort öffnet direkt den Tools-Tab zur Verwaltung. Tool-Pakete ergänzen den Editor, nicht die Widget-Palette oder Runtime. Schnittstelle 0.1 unterstützt eine deklarative Aktion: die Hintergrundfarbe der aktuellen Seite setzen. Ein Klick auf das Tool-Symbol oder Ausführen im Tools-Tab zeigt zunächst eine Vorschau; erst Anwenden übernimmt die Änderung. Sie lässt sich mit Rückgängig zurücknehmen und wird über den normalen Projektweg gespeichert. Bei der Installation wird keine Aktion ausgeführt.

UGSo Colorpicker 1.2.0

Ab Studio 0.1.113 behalten Colorpicker und Favoriten beim Tabwechsel dieselbe Dialoggröße. Die Favoriten stehen auf größeren Bildschirmen in zwei Spalten, auf schmalen Bildschirmen in einer Spalte. Lange Listen lassen sich innerhalb des Tabs scrollen. Bei installiertem Tool genügt das Studio-Update.

Update 1.2.0 (Studio 0.1.112): Zusätzlich zu Kopieren bietet der Colorpicker Als Favorit speichern. Im zweiten Tab Favoriten stehen bis zu 15 Farben mit HEX und Namen. Die Liste wird automatisch im Add-on gespeichert und ist für HA-Admins über Ingress auf mehreren Rechnern gemeinsam verfügbar. Normale Benutzer können den Colorpicker verwenden, haben aber keinen Zugriff auf die Favoriten. Doppelte Farben belegen keinen weiteren Platz. Bei voller Liste erscheint gelb Favoriten voll, und Speichern wird deaktiviert. Jeder Eintrag hat einen SVG-Kopierbutton für seinen HEX-Wert und einen Papierkorb zum Löschen; die übrigen rücken nach. Ein Klick auf die Farbe übernimmt sie in den Colorpicker. Beim Öffnen des Favoriten-Tabs wird die gemeinsame Liste neu geladen.

Lokale Favoriten übernehmen führt die bisherigen Browserfavoriten mit der gemeinsamen Liste zusammen. Farben, die nicht mehr hineinpassen, bleiben lokal erhalten. Ein Tool-Update oder eine erneute Tool-Installation löscht die Favoriten nicht. Sichere die Add-on-Daten vor einer Deinstallation oder einem Serverumzug. Falls die Adminprüfung fehlt, öffne Studio erneut über Home Assistant; Favoriten werden dann nicht lokal als Ersatz gespeichert.

Colorpicker 1.2.0 herunterladen.

Das Zusatztool benötigt HA Grafik Visual Studio 0.1.112 oder neuer. Installiere die heruntergeladene .tp-Datei unter Einstellungen → Tools. Bei bereits installiertem Colorpicker genügt das Studio-Update für den neuen Dialog. Das Farbkreis-Symbol in der Werkzeugleiste oder Ausführen öffnet den Colorpicker.

• Farbton und Sättigung im Farbkreis wählen; Helligkeit separat einstellen oder HEX direkt eingeben.
• Als Ausgabe HEX oder Farbname wählen und Kopieren drücken. Ohne Browser-Zwischenablage kannst du die Ausgabe markieren und manuell kopieren.
• Die 31.918 Farbnamen von meodai/color-names sind lokal mitgeliefert; Internetzugriff ist nicht erforderlich. Exakte und nächstliegende Treffer werden unterschieden. Die Ähnlichkeit wird über RGB-Abstand bestimmt.
• Farbnamen sind Bezeichnungen, keine CSS-Farbwerte. Für Widget-Farbfelder HEX kopieren.
• Das Tool benötigt keine Projekt- oder HA-Rechte und ändert keine Projektdaten. Auf dem Farbkreis ändern Pfeiltasten links/rechts den Farbton und oben/unten die Sättigung.

Die neue deklarative Aktion color-picker verwendet capabilities: []. Der Dialog und die Farbnamenliste gehören zur Studio-Version; das reine Datenpaket aktiviert das Tool. Alte Studio-Versionen unterstützen diese Aktion nicht. Lizenz und Quellenhinweis sind im Dialog erreichbar. Die vorhandene Aktion set-page-background bleibt unverändert.

Paket aufbauen

Das ZIP enthält manifest.json in UTF-8 und optional referenzierte SVG- oder PNG-Bilder unter icons/. Andere Dateien sind nicht zulässig. Eine Paket-ID ist punktgetrennt; die Tool-ID liegt im Paket-Namensraum. Die Paketversion hat das Format x.y.z. Ein Tool-Paket enthält genau ein Tool.

{
  "format": "ha-grafik-tool-package",
  "apiVersion": "0.1",
  "id": "beispiel.tools",
  "name": "Beispiel Tools",
  "version": "1.0.0",
  "license": "MIT",
  "tools": [{
    "id": "beispiel.tools/background",
    "definitionVersion": "0.1",
    "label": "Seitenfarbe",
    "description": "Setzt die Farbe der aktuellen Seite.",
    "context": "page",
    "capabilities": ["project.read", "project.write"],
    "action": { "kind": "set-page-background", "defaultColor": "#224466" }
  }]
}

defaultColor ist eine sechsstellige Hex-Farbe und lässt sich in der Vorschau ändern. Die genannten Fähigkeiten gelten nur für diese bestätigte Editor-Aktion. Sie geben Paket-Code keine allgemeine Schreibberechtigung. Paket oder Tool können optional ein Bild über "icon": "icons/name.svg" oder .png referenzieren. Die Datei muss im ZIP liegen; die Studio-Aktionsbuttons verwenden weiterhin SVG-Symbole.

Das ZIP darf höchstens 2 MB, das Manifest 200 KB und jedes Bild 50 KB groß sein. PNG-Bilder sind auf 1024 × 1024 Pixel begrenzt; SVG-Dateien werden auf passive Inhalte geprüft.

Installieren und verwalten

1. Erstelle beispielsweise seitenfarbe.tp mit manifest.json und gegebenenfalls den referenzierten Bildern. Auch seitenfarbe.tp.zip wird weiter angenommen.
2. Wähle die Datei unter Einstellungen → Tools. Die Liste zeigt Paket-ID, Version, Lizenz und das enthaltene Tool.
3. Öffne für das Tool über sein Symbol in der Editor-Werkzeugleiste oder mit Ausführen im Tools-Tab die Vorschau und bestätige die gewünschte Seitenänderung mit Anwenden.

Pakete können im Tool-Tab entfernt werden. Eigene Skripte, Home-Assistant-Dienste, externe URLs, GitHub-Installation und Updates sind noch nicht Teil von 0.1. Die geplanten Kompatibilitäts- und Erweiterungsregeln stehen in den Tool-Regeln im Quellcode.