Skip to content

v2.0.0 – Breiter Editor und anpassbare Vorlagen

Latest

Choose a tag to compare

@Baeka89 Baeka89 released this 04 Nov 05:28

v2.0.0 – Breiter Editor und anpassbare Vorlagen

Version 2.0.0, 2026-11-04.

Deutsch

Erstellung und Bearbeitung öffnen ein breites Fenster mit Vorschau. Vorhandene Karten lassen sich gezielt als fertige Karte, anpassbare oder leere Vorlage übernehmen; erkannte Eingaben und ihre Sensor-Einstellungen werden übersichtlich gruppiert.

Hinzugefügt

  • Breites Bearbeitungsfenster für neue und bestehende zentrale Vorlagen sowie lokale Karten mit den Reitern Karte, Eingabefelder, Vorlage, Erweitert und Popup & Verwendung. Auf schmalen Bildschirmen wird zwischen Bearbeitung und Vorschau gewechselt.
  • Durchsuchbarer, kategorisierter Hilfekatalog mit einem kontextbezogenen Hilfe-Button je Seite und Reiter sowie vollständiger Autorenanleitung für Vorlagen-Code.
  • Automatische Vorbereitung als fertige Karte, anpassbare oder leere Vorlage. Unterstützte Entitäten, Icons, Namen und Navigationsziele werden optional bearbeitbar; vorhandene, statisch zuordenbare Sensorgrenzen und Farben behalten ihre Vorgaben. Unbenutzte Zuordnungen blenden nur ihre zugehörigen Anzeigen aus.
  • Automatischer Feldabgleich nach zentralen YAML-, Originaleditor- und Feldbaumänderungen. Eigene Beschriftungen, Bereiche, Hinweise, manuelle Feldtypen und zentrale Bindungen werden berücksichtigt.
  • Gemeinsame aufklappbare Eingabebereiche wie Raumklima, darin einzelne Sensoren mit eigenem Unterbereich Einstellungen. Vorhandene Min-/Max-Werte und sensorbezogene Farben bleiben beim Sensor; gemeinsam verwendete Farben stehen separat. Weitere eigene Felder und Fundstellenprüfung stehen unter Erweitert.
  • Kategorieauswahl aus vorhandenen Namen mit freier Eingabe für neue Kategorien und einer Auswahl ohne Kategorie.

Geändert

  • Einsetzen übernimmt eine neue Karte nur in den vorherigen HA-Karteneditor und schließt das breite Fenster. Der HA-Editor und seine Raster-/Stapelauswahl bleiben offen; erst dessen Speichern schreibt das Dashboard. Zentrale Vorlagen und vorhandene Verwendungen behalten ihren direkten Speicherweg.
  • Karte bearbeiten öffnet die lokale Bearbeitung nur auf ausdrücklichen Klick. Überblick und allgemeine Bibliothekseinstellungen bleiben in der kompakten Verwaltung.
  • Leere unterstützte Sensorgrenzen deaktivieren genau diese Grenze. Der Zahlenwert 0, negative Zahlen und gültiger numerischer Text bleiben gültige Werte; Vergleiche, Rot-Vorrang und vorhandene Farben der Karte bleiben erhalten. Die Automatik ergänzt keine neuen Warnregeln, Schalter oder Layoutfelder.
  • Das vollständige Aktualisierungsskript verwendet v1.1.0 als Ausgangsstand und führt alle JavaScript-Prüfungen aus. Die bestehende HACS-Aufnahme bleibt erhalten; es wird kein zweiter Antrag erstellt.

Behoben

  • Interne Bibliotheksupdates verwenden nach dem HACS-Review Dispatcher-Signale statt vollständiger Eventbus-Nutzdaten. Speichern großer Bibliotheken verursacht dadurch keine Recorder-Warnung wegen dieser Eventdaten. WebSocket-Abonnenten erhalten weiterhin vollständige Aktualisierungen, auch beim Wiederherstellen, Deaktivieren und erneuten Aktivieren.
  • Verzögert aufgebaute Dropdown-/YAML-Bereiche werden beim ersten Öffnen berücksichtigt. Dialog-Schließen, Abbruchbestätigungen und asynchrone Speicherabläufe bleiben bedienbar und werden nicht mehrfach ausgeführt.
  • Verschieben oder Rendern einer Karte öffnet keine Bearbeitung. Native Raster-/Stapel-Unterkarten werden über ihren vollständigen äußeren Kartenbaum übernommen; benachbarte Karten und die Bibliotheksverwaltung bleiben erhalten.
  • Vorhandene automatisch vorbereitete lokale Vorlagen werden abgeglichen, ohne Karteninhalt und lokale Werte zu verlieren. Überzählige automatisch erzeugte Layout-Eingaben früherer lokaler Tests entfallen aus der Eingabeliste.

Entfernt

  • Das interne Update wird nicht mehr als Eventbus-Ereignis card_library_updated gesendet. Die gleichnamige integrationsinterne Dispatcher-Benachrichtigung ersetzt diesen Transport; die WebSocket-Befehle bleiben erhalten.

Updatehinweise

  • Bibliothek als JSON, verwendete Dashboards und bisherige Integrationsdateien sichern. Über HACS aktualisieren oder das vollständige Installationsarchiv übernehmen, HA neu starten, die bestehende JavaScript-Modul-Ressource auf /card_library/card-library.js?v=2.0.0 setzen und den Browser vollständig neu laden. Beim Wechsel vom lokalen Test den local-Zusatz entfernen. Integrationseinträge und .storage behalten.
  • Vorhandene v1.1.0-Vorlagen bleiben ohne manuelle Migration nutzbar. Automatische Eingaben werden bei noch nicht vorbereiteten Vorlagen erst über Vorlage automatisch vorbereiten erzeugt. Vorbereitete editor-09-Vorlagen bleiben nutzbar.
  • Vor einer Rückkehr zu älteren Versionen kompatible Bibliotheks- und Dashboarddaten wiederherstellen. Ältere Stände verstehen die neuen Vorbereitungs- und Feldmetadaten nicht vollständig; das Zurückkopieren von Programmdateien nimmt gespeicherte Datenänderungen nicht zurück.

Bekannte Einschränkungen

  • Beliebiges JavaScript wird nicht vollständig erkannt. Die Vorbereitung berücksichtigt nur eindeutige unterstützte Muster und höchstens 100 Eingabefelder pro Karte; unklare Fundstellen benötigen Prüfung. CSS/Layout und allgemeine Zahlen werden nicht automatisch zu Eingaben. Fachlich passende Sensorgrenzen bestimmt weiterhin der Nutzer.
  • Fremdkarten müssen separat installiert sein. Vorladen garantiert keine abgeschlossenen Netzabfragen und kann sichtbarkeitsabhängige Initialisierung nicht erzwingen. Dynamische oder mehrfache Button-Card-Template-Verweise und Konflikte mit zentralen Bindungen bleiben begrenzt.
  • Browserprüfungen verwenden teilweise nachgebildete HA-Schnittstellen. Der Nutzer hat den lokalen Editorstand auf seiner Installation erprobt; eine vollständige Live-Prüfung dieser Veröffentlichung mit allen Karten, Themes und Geräten ist nicht belegt.

Prüfungen

  • Lokal: 1079 JavaScript- und 239 Python-Prüfungen, darunter vier neue Dispatcher-Fälle für große Nutzdaten über 32 KB, getrennte Abonnenten, Abmelden/Wiederaktivieren und fehlgeschlagene Speicherung. Alle neun WebSocket-Schemas werden mit voluptuous und probatio geprüft; Syntax und Versions-/Modulverweise sowie reproduzierbares Installationsarchiv werden vor Veröffentlichung kontrolliert.
  • Browser: 69 verschiedene Szenarien (18 Vorlagen, 27 Fenster-/Speicherabläufe, sechs Sensoren, fünf Hilfe, drei Aufklappbereiche, fünf Dialog-/Blockadefälle, zweimal Bubble-Editor, zweimal Bubble-Vorladen, einmal Button-Card-Übernahme). Originale Button Card 7.0.1 und Bubble Card 3.2.0/3.4.2; HA-Schnittstellen sind teilweise nachgebildet. Details: DEVELOPMENT.md.
  • Freigabe: HACS, Hassfest und Tests müssen für genau den Release-Commit vollständig erfolgreich sein; Tag, Release-Text und Downloads werden anschließend gegen diesen Commit geprüft.

English

Creation and editing open a wide window with a preview. Existing cards can be imported as finished cards, adjustable templates or empty templates; recognized inputs and their sensor settings are grouped clearly.

Added

  • Wide editor for new and existing central templates and local cards, with Card, Inputs, Template, Advanced and Popup & Usage tabs. Narrow screens switch between editing and preview.
  • Searchable, categorized help catalogue with a contextual Help button for each page and tab, plus a complete template-code authoring guide.
  • Automatic preparation as a finished card, adjustable template or empty template. Supported entities, icons, names and navigation targets become optional inputs; existing statically assignable sensor limits and colors retain their defaults. Unused assignments hide only their associated displays.
  • Automatic input synchronization after central YAML, original-editor and field-tree changes, respecting custom labels, groups, hints, manual types and central bindings.
  • Shared collapsible input areas such as Room climate, with individual sensors and their own Settings section. Existing minimum/maximum values and sensor-specific colors follow their sensor; shared colors remain separate. Additional custom inputs and occurrence review are under Advanced.
  • Category selection from existing names, free entry for new categories and a no-category option.

Changed

  • Insert applies a new card only to the previous HA card editor and closes the wide window. The HA editor and its grid/stack selection stay open; its Save operation commits the dashboard. Central templates and existing uses retain direct saving.
  • Edit card opens local editing only after an explicit click. Overview and general library settings remain in the compact manager.
  • Empty supported sensor limits disable that specific limit. Zero, negative numbers and valid numeric text remain values; comparisons, red priority and existing card colors are preserved. Automatic preparation does not add warning rules, switches or layout inputs.
  • The complete updater uses v1.1.0 as its baseline and runs all JavaScript checks. Existing HACS inclusion remains intact; no second submission is created.

Fixed

  • Following the HACS review, internal library updates use dispatcher signals instead of complete event-bus payloads. Saving large libraries therefore no longer causes recorder warnings from those event payloads. WebSocket subscribers still receive complete updates, including restoration, deactivation and reactivation.
  • Deferred dropdown/YAML sections are included on their first opening. Closing dialogs, cancellation confirmations and asynchronous saves remain usable without duplicate execution.
  • Moving or rendering a card does not open editing. Native grid/stack child cards are applied through their complete outer card tree, retaining sibling cards and the library manager.
  • Existing automatically prepared local templates are synchronized without losing card content or local values. Excess automatically generated layout inputs from earlier local tests disappear from the input list.

Removed

  • Internal updates are no longer emitted as the card_library_updated event-bus event. The integration's dispatcher notification with the same name replaces that transport; WebSocket commands remain available.

Update notes

  • Export library JSON and back up used dashboards and existing integration files. Update through HACS or install the complete archive, restart HA, set the existing JavaScript-module resource to /card_library/card-library.js?v=2.0.0 and fully reload the browser. Remove the local query parameter when upgrading from a local test. Keep integration entries and .storage.
  • Existing v1.1.0 templates remain usable without manual migration. For unprepared templates, automatic inputs are created explicitly through Prepare template automatically. Prepared editor-09 templates remain usable.
  • Restore compatible library and dashboard data before downgrading. Older builds cannot fully read the new preparation and input metadata; replacing program files does not revert saved data changes.

Known limitations

  • Arbitrary JavaScript cannot be recognized completely. Preparation covers unambiguous supported patterns and at most 100 inputs per card; ambiguous occurrences need review. CSS/layout and general numeric values are not automatically exposed. Users remain responsible for appropriate sensor limits.
  • Custom cards must be installed separately. Preloading does not guarantee completed network requests or force visibility-dependent initialization. Dynamic or multiple Button Card template references and conflicts with central bindings remain limited.
  • Browser tests partly simulate HA interfaces. The user tried the local editor build in their installation; comprehensive live testing of this release with all cards, themes and devices is not established.

Checks

  • Local: 1079 JavaScript and 239 Python checks, including four new dispatcher cases for payloads over 32 KB, separate subscribers, unload/reactivation and failed persistence. All nine WebSocket schemas are checked with voluptuous and probatio; syntax, version/module references and a reproducible installation archive are checked before publication.
  • Browser: 69 distinct scenarios (18 template, 27 workspace/save, six sensor, five help, three disclosure, five dialog/blocking, two Bubble editor, two Bubble preload and one Button Card import case). Original Button Card 7.0.1 and Bubble Card 3.2.0/3.4.2; HA interfaces are partly simulated. Details: DEVELOPMENT.md.
  • Release gate: HACS, Hassfest and Tests must fully succeed for the exact release commit; its tag, release text and downloads are verified against that commit afterwards.

CHANGELOG v2.0.0 · Vergleich / Compare v1.1.0…v2.0.0