node-red-contrib-knx-ultimate 6.3.11 → 6.3.13

package/CHANGELOG.md

@@ -6,6 +6,15 @@
 
 # CHANGELOG
 
+**Version 6.3.13** - August 2026<br/>
+
+- **Matter**: promoted Matter Controller, Matter Bridge and Expose KNX to Matter from BETA to production-ready status; removed BETA labels and experimental warnings from the palette, editor help, examples and multilingual documentation while retaining pairing, backup and endpoint-structure safety guidance.<br/>
+- **Matter visual identity**: changed the Matter node background to the official Matter Day color (`#F3FFFF`) and the controller/bridge icon artwork to Matter Night (`#131926`) for readable, standards-aligned palette and canvas presentation.<br/>
+
+**Version 6.3.12** - August 2026<br/>
+
+- **HUE Controller**: completed the EN, IT, DE, FR, ES and zh-CN editor translations, including Light Level, Locate, Light mapping labels, mapping placeholders, error messages and tutorial links; the embedded profiles and dynamic device labels now follow Node-RED's active locale instead of a potentially stale page-language attribute. Corrected French/Spanish Hue and KNX terminology and realigned the localized help and wiki documentation.<br/>
+
 **Version 6.3.11** - August 2026<br/>
 
 - **Matter Controller**: fixed KNX GA mapping tabs being hidden by transient empty KNX/Matter config-selector values during Node-RED 5 editor initialization; saved gateways now remain selected until the user explicitly changes them.<br/>

package/examples/Matter Controller - Semantic Flow Input.json

@@ -4,7 +4,7 @@
     "type": "tab",
     "label": "Matter Controller - Flow input",
     "disabled": false,
-    "info": "Example of the semantic msg.payload = { function, value } contract for Control Matter from KNX (BETA).\n\nAfter importing:\n1. Open the example Matter Controller node.\n2. Select your existing Matter Controller configuration and a commissioned non-light endpoint.\n3. Enable Node Input/Output PINs.\n4. In the Flow input section shown below the PIN selector, use only the Inject nodes matching functions advertised by the device.\n\nThis example creates no matter-config and sends no command automatically."
+    "info": "Example of the semantic msg.payload = { function, value } contract for Control Matter from KNX.\n\nAfter importing:\n1. Open the example Matter Controller node.\n2. Select your existing Matter Controller configuration and a commissioned non-light endpoint.\n3. Enable Node Input/Output PINs.\n4. In the Flow input section shown below the PIN selector, use only the Inject nodes matching functions advertised by the device.\n\nThis example creates no matter-config and sends no command automatically."
   },
   {
     "id": "matter_semantic_instructions",

package/nodes/icons/node-matter-bridge-icon.svg

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <svg width="40" height="60" viewBox="0 0 40 60" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Matter Bridge">
-  <text x="20" y="21" fill="#ffffff" text-anchor="middle" font-family="Arial, sans-serif" font-size="20" font-weight="700" textLength="38" lengthAdjust="spacingAndGlyphs">mat</text>
+  <text x="20" y="21" fill="#131926" text-anchor="middle" font-family="Arial, sans-serif" font-size="20" font-weight="700" textLength="38" lengthAdjust="spacingAndGlyphs">mat</text>
   <path d="M 37 34 H 12 V 29 L 2 38 L 12 47 V 42 H 25"
-    fill="none" stroke="#ffffff" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round"/>
+    fill="none" stroke="#131926" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round"/>
 </svg>

package/nodes/icons/node-matter-controller-icon.svg

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <svg width="40" height="60" viewBox="0 0 40 60" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Matter Controller">
-  <text x="20" y="21" fill="#ffffff" text-anchor="middle" font-family="Arial, sans-serif" font-size="20" font-weight="700" textLength="38" lengthAdjust="spacingAndGlyphs">mat</text>
+  <text x="20" y="21" fill="#131926" text-anchor="middle" font-family="Arial, sans-serif" font-size="20" font-weight="700" textLength="38" lengthAdjust="spacingAndGlyphs">mat</text>
   <path d="M 3 34 H 28 V 29 L 38 38 L 28 47 V 42 H 15"
-    fill="none" stroke="#ffffff" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round"/>
+    fill="none" stroke="#131926" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round"/>
 </svg>

package/nodes/icons/node-matter-icon.svg

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <svg width="40" height="60" viewBox="0 0 40 60" xmlns="http://www.w3.org/2000/svg">
-    <g fill="#ffffff" stroke="none">
+    <g fill="#131926" stroke="none">
         <circle cx="20" cy="30" r="4.5"/>
         <g id="matterArrow">
             <rect x="18.4" y="9" width="3.2" height="11"/>

package/nodes/knxUltimateHueController.html

@@ -254,11 +254,18 @@
       `);
     };
 
-    const migrationText = (node, key, fallback, values) => {
+    const controllerMessage = (key, values) => {
       try {
-        const translated = node._(`knxUltimateHueController.${key}`, values);
-        if (translated && translated !== `knxUltimateHueController.${key}`) return translated;
+        const messageKey = `node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.${key}`;
+        const translated = RED._(messageKey, values);
+        if (translated && translated !== messageKey) return translated;
       } catch (error) { /* empty */ }
+      return undefined;
+    };
+
+    const migrationText = (_node, key, fallback, values) => {
+      const translated = controllerMessage(key, values);
+      if (translated) return translated;
       return fallback;
     };
 
@@ -318,7 +325,13 @@
       icon: 'node-hue-icon.svg',
       label() {
         const profile = PROFILE_TYPES[this.hueControllerType] || PROFILE_TYPES.light;
-        return this.name || `HUE Controller · ${profile.label}`;
+        let typeLabel = profile.label;
+        try {
+          const translationKey = `node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.types.${this.hueControllerType || 'light'}`;
+          const translated = RED._(translationKey);
+          if (translated && translated !== translationKey) typeLabel = translated;
+        } catch (error) { /* use catalog fallback */ }
+        return this.name || `HUE Controller · ${typeLabel}`;
       },
       paletteLabel: 'HUE Controller',
       oneditprepare() {
@@ -435,10 +448,8 @@
         };
 
         const controllerText = (key, fallback) => {
-          try {
-            const translated = controllerNode._(`knxUltimateHueController.${key}`);
-            if (translated && translated !== `knxUltimateHueController.${key}`) return translated;
-          } catch (error) { /* empty */ }
+          const translated = controllerMessage(key);
+          if (translated) return translated;
           return fallback;
         };
 
@@ -710,7 +721,9 @@
           $container.toggleClass('hue-controller-light-profile', controllerType === 'light');
 
           if (!definition || !template) {
-            $container.html('<div class="hue-controller-editor-error">The selected Hue editor is unavailable. Restart Node-RED after updating the package.</div>');
+            $container.html($('<div class="hue-controller-editor-error"></div>').text(
+              controllerText('editor_unavailable', 'The selected Hue editor is unavailable. Restart Node-RED after updating the package.')
+            ));
             return;
           }
 
@@ -967,7 +980,7 @@
 <script type="text/html" data-template-name="knxUltimateHueController">
   <div class="form-row" style="margin-bottom:14px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;
-    <a target="_blank" rel="noopener noreferrer" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
+    <a target="_blank" rel="noopener noreferrer" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b data-i18n="knxUltimateHueController.tutorials_link"></b></a>
   </div>
   <div class="form-row" id="hue-controller-migrate-legacy-flow-row" style="display:none; margin-bottom:14px;">
     <a class="hue-legacy-migration-video" href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer" style="display:inline-flex; align-items:center; gap:5px; margin-right:10px;" data-i18n="[title]knxUltimateHueController.migration_video_title">

package/nodes/knxUltimateMatterBridge.html

@@ -118,15 +118,15 @@
 
     RED.nodes.registerType('knxUltimateMatterBridge', {
       category: 'KNX Ultimate Matter',
-      color: '#8FE3D4',
+      color: '#F3FFFF',
       defaults: gaDefaults,
       inputs: 0,
       outputs: 0,
       icon: 'node-matter-bridge-icon.svg',
       label() {
-        return this.name || 'Expose KNX to Matter (BETA)';
+        return this.name || 'Expose KNX to Matter';
       },
-      paletteLabel: 'Expose KNX to Matter (BETA)',
+      paletteLabel: 'Expose KNX to Matter',
       oneditprepare() {
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
@@ -632,7 +632,7 @@
 </script>
 
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-Exposes **one KNX device as a Matter device**. This node is in **BETA**.
+Exposes **one KNX device as a Matter device**.
 
 Point it to a **Matter Bridge** configuration node (the actual bridge, paired once by Alexa/Google Home/Apple Home), pick the device type, give it the name the assistant will use, and fill the group addresses.
 

package/nodes/knxUltimateMatterControllerDevice.html

@@ -10,7 +10,7 @@
 
     RED.nodes.registerType("knxUltimateMatterControllerDevice", {
       category: "KNX Ultimate Matter",
-      color: "#8FE3D4",
+      color: "#F3FFFF",
       defaults: {
         //buttonState: {value: true},
         server: { type: "knxUltimate-config", required: false },
@@ -142,9 +142,9 @@
       outputs: 0,
       icon: "node-matter-controller-icon.svg",
       label: function () {
-        return this.name || this.matterDeviceName || "Control Matter from KNX (BETA)";
+        return this.name || this.matterDeviceName || "Control Matter from KNX";
       },
-      paletteLabel: "Control Matter from KNX (BETA)",
+      paletteLabel: "Control Matter from KNX",
       oneditprepare: function () {
         // Go to the help panel
         try {

package/nodes/locales/de/knxUltimateHueController.html

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueController">
-<p><a href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E" target="_blank" rel="noopener noreferrer"><strong>KNX-Ultimate video tutorials (YouTube playlist)</strong></a> Sehen Sie sich vor dem Start die <a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">Videoanleitung auf YouTube</a> an.</p>
+<p><a href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E" target="_blank" rel="noopener noreferrer"><strong>KNX-Ultimate-Videotutorials (YouTube-Playlist)</strong></a> Sehen Sie sich vor dem Start die <a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">Videoanleitung auf YouTube</a> an.</p>
 <p><strong>HUE Controller</strong> ist der einheitliche Knoten für Hue-API-v2-Ressourcen.</p>
 <p>Wählen Sie ein Hue-Gerät oder eine Hue-Ressource. HUE Controller erkennt den Gerätetyp automatisch und öffnet den passenden Editor für KNX-Zuordnungen, Verhalten und Node-Anschlüsse.</p>
 <p>Geräteauswahl, Aktualisierung und erkannter Typ stehen wie beim Matter Controller in derselben kompakten Zeile.</p>
@@ -154,6 +154,8 @@ Die Tabelle **Hue-native Effekte** ordnet KNX-Werte den vom Bridge gemeldeten Ef
 | Night lighting | Nacht-Profil (Farbe oder Temperatur/Helligkeit) |
 | Day/Night | GA zur Umschaltung Tag/Nacht (_true_ = Tag, _false_ = Nacht) |
 | Invert Day/Night | Wert der Tag/Nacht-GA invertieren |
+| Status beim Start lesen | Status beim Start lesen und bei Start/Wiederverbindung als Ereignis auf den KNX-Bus senden (Standard: „Nein“) |
+| Tagmodus erzwingen | Der Tagmodus kann durch schnelles Aus- und Einschalten dieser Leuchte oder aller Leuchtenknoten aktiviert werden. |
 | Node I/O pins | Ein/Ausblenden der Eingangs/Ausgangs-Pins; Input folgt HUE API v2 (z. B. <code>msg.on = { on: true }</code>) |
 
 Hinweis: Start/Stop-Dimmen im KNX-Modus wird über die üblichen Start/Stop-Telegramme gesteuert.

package/nodes/locales/de/knxUltimateHueController.json

@@ -4,6 +4,9 @@
     "hue_bridge": "Hue Bridge"
   },
   "knxUltimateHueController": {
+    "locale": "de",
+    "tutorials_link": "KNX-Ultimate-Videotutorials (YouTube-Playlist)",
+    "editor_unavailable": "Der ausgewählte Hue-Editor ist nicht verfügbar. Starten Sie Node-RED nach der Paketaktualisierung neu.",
     "device_function": "Gerätefunktion",
     "hue_device": "Hue-Gerät",
     "hue_device_placeholder": "Hue-Gerät oder -Ressource suchen",

package/nodes/locales/de/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-> Dieser Node ist in **BETA**: Er funktioniert, aber Details können sich zwischen Releases noch ändern.
-
 ## Übersicht
 
 Jeder Expose KNX to Matter Node stellt **ein KNX-Gerät als Matter-Gerät** bereit: Die gekoppelten Controller (Alexa, Google Home, Apple Home...) sehen es mit dem von dir vergebenen Namen — bereit für App- und Sprachsteuerung. Verweise ihn auf einen **Matter Bridge**-Konfigurations-Node (die eigentliche Bridge, einmal gekoppelt - der Kopplungs-QR-Code lebt dort) und füge beliebig viele Device-Nodes hinzu, überall in deinen Flows.

package/nodes/locales/de/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Expose KNX to Matter (BETA)",
+    "title": "Expose KNX to Matter",
     "bridge_name": "Name der Matter-Bridge",
     "port": "Port",
     "devices_help": "Füge die KNX-Geräte hinzu, die über Matter bereitgestellt werden sollen. Der \"Name\" ist der, den Alexa/Google/Apple anzeigen und für Sprachbefehle verwenden. Befehls-GA = wird geschrieben, wenn der Assistent einen Befehl sendet; Status-GA = wird vom Bus gelesen, um die App aktuell zu halten.",

package/nodes/locales/de/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-> Dieser Knoten ist **BETA**: das Verhalten kann sich ändern, während die Matter-Implementierung weiter verfeinert wird.
-
 Dieser Knoten steuert einen bereits gekoppelten Matter-Endpunkt über KNX. Wähle das Matter-Gerät aus; der Editor erkennt die Fähigkeiten des Endpunkts und zeigt nur die passenden KNX-Zuordnungen.
 
 Ein Klick oder Fokus auf das Matter-Gerätefeld öffnet immer die vollständige Liste der gekoppelten Endpunkte, auch wenn bereits ein Gerät ausgewählt ist. Beim Tippen wird die Liste weiterhin gefiltert.

package/nodes/locales/de/matterbridge-config.html

@@ -1,7 +1,5 @@
 <script type="text/markdown" data-help-name="matterbridge-config">
-# Matter Bridge (BETA)
-
-> Dieser Node ist in **BETA**: Er funktioniert, aber Details können sich zwischen Releases noch ändern.
+# Matter Bridge
 
 ## Übersicht
 

package/nodes/locales/en/knxUltimateHueController.json

@@ -4,6 +4,9 @@
     "hue_bridge": "Hue Bridge"
   },
   "knxUltimateHueController": {
+    "locale": "en",
+    "tutorials_link": "KNX-Ultimate video tutorials (YouTube playlist)",
+    "editor_unavailable": "The selected Hue editor is unavailable. Restart Node-RED after updating the package.",
     "device_function": "Device function",
     "hue_device": "Hue device",
     "hue_device_placeholder": "Search your Hue device or resource",

package/nodes/locales/en/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-> This node is in **BETA**: it works, but details may still change between releases.
-
 ## Overview
 
 Each Expose KNX to Matter node exposes **one KNX device as a Matter device**: the paired controllers (Alexa, Google Home, Apple Home...) see it, with the name you typed, ready for app and voice control. Point it to a **Matter Bridge** configuration node (the actual bridge, paired once - the pairing QR code lives there) and add as many device nodes as you want, anywhere in your flows.

package/nodes/locales/en/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Expose KNX to Matter (BETA)",
+    "title": "Expose KNX to Matter",
     "bridge_name": "Matter bridge name",
     "port": "Port",
     "devices_help": "Add the KNX devices to expose on Matter. The \"Name\" is what Alexa/Google/Apple will show and use for voice commands. Command GA = written when the assistant sends a command; Status GA = read from the bus to keep the app updated.",

package/nodes/locales/en/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-> This node is in **BETA**: behaviour can change while the Matter implementation is refined.
-
 This node controls a commissioned Matter endpoint from KNX. Select the Matter device and the editor detects its capabilities, then shows only the KNX mappings that make sense for that endpoint.
 
 Clicking or focusing the Matter device field always opens the complete commissioned endpoint list, even when a device is already selected. Typing continues to filter it.

package/nodes/locales/en/matterbridge-config.html

@@ -1,7 +1,5 @@
 <script type="text/markdown" data-help-name="matterbridge-config">
-# Matter Bridge (BETA)
-
-> This node is in **BETA**: it works, but details may still change between releases.
+# Matter Bridge
 
 ## Overview