node-red-contrib-knx-ultimate 6.3.10 → 6.3.12

package/CHANGELOG.md

@@ -6,6 +6,14 @@
 
 # CHANGELOG
 
+**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/>
+
 **Version 6.3.10** - August 2026<br/>
 
 - **Watchdog**: added a default-on option to listen for error states reported by KNX-Ultimate nodes, including KNX Device, through the selected gateway; disabling it suppresses `NodeError` flow messages without affecting the Watchdog's own bus checks or control messages. Existing flows retain the previous enabled behavior.<br/>

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/knxUltimateMatterControllerDevice.html

@@ -3,6 +3,7 @@
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/11f26b4500.js"></script>
 
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/configNodeEditorSelection.js"></script>
 
 <script type="text/javascript">
   (function () {
@@ -161,16 +162,6 @@
           });
         }
         $("#node-input-updateLocalStateFromKNXWrite").prop("checked", node.updateLocalStateFromKNXWrite === true || node.updateLocalStateFromKNXWrite === "true"); // Starting from v 4.1.31
-        const ensureConfigSelection = (selector) => {
-          if ($(selector).val() !== "_ADD_") return;
-          try {
-            $(selector).prop("selectedIndex", 0);
-          } catch (error) {
-            // Ignore UI quirks for legacy Node-RED versions
-          }
-        };
-        ["#node-input-server", "#node-input-serverMatter"].forEach(ensureConfigSelection);
-
         function ensureVerticalTabsStyle() {
           if ($('#knxUltimateMatterControllerDeviceVerticalTabs').length) return;
           const style = `
@@ -261,7 +252,7 @@
         function onEditPrepare() {
           ensureVerticalTabsStyle();
           const $knxServerInput = $("#node-input-server");
-          const KNX_EMPTY_VALUES = new Set(['', 'none', '_ADD_', '__NONE__']);
+          const KNX_EMPTY_VALUES = new Set(['', 'none', '_add_', '__none__']);
           // Historical variable names are retained for saved-flow compatibility; they point to Matter widgets.
           const $hueServerInput = $("#node-input-serverMatter");
           const $matterControllerModeInput = $("#node-input-matterControllerMode");
@@ -300,6 +291,21 @@
           let matterDevicePickerMouseDown = false;
           let showingNoHueDevicesPlaceholder = false;
           const HUE_EMPTY_SERVER_VALUES = new Set(['', 'none', '_add_', '__none__', '__null__', 'null', 'undefined']);
+          const selectionApi = window.KNXUltimateConfigNodeEditorSelection;
+          const normalizeConfigSelection = selectionApi && typeof selectionApi.normalizeSelection === 'function'
+            ? selectionApi.normalizeSelection
+            : (value, emptyValues) => {
+                const normalized = value === undefined || value === null ? '' : String(value).trim();
+                return emptyValues.has(normalized.toLowerCase()) ? '' : normalized;
+              };
+          const resolveSelectedOrStoredSelection = selectionApi && typeof selectionApi.resolveSelectedOrStoredSelection === 'function'
+            ? selectionApi.resolveSelectedOrStoredSelection
+            : (selectedValue, storedValue, emptyValues) => normalizeConfigSelection(selectedValue, emptyValues) || normalizeConfigSelection(storedValue, emptyValues);
+          const shouldPreserveSelection = selectionApi && typeof selectionApi.shouldPreserveSelection === 'function'
+            ? selectionApi.shouldPreserveSelection
+            : (event, nextValue, currentValue, emptyValues) => (!event || !event.originalEvent) && normalizeConfigSelection(nextValue, emptyValues) === '' && normalizeConfigSelection(currentValue, emptyValues) !== '';
+          let activeKnxServerId = resolveSelectedOrStoredSelection($knxServerInput.val(), node.server, KNX_EMPTY_VALUES);
+          let activeMatterServerId = resolveSelectedOrStoredSelection($hueServerInput.val(), node.serverMatter, HUE_EMPTY_SERVER_VALUES);
           let locateSessionActive = false;
           let locateAutoResetTimer = null;
           let locatePendingRequest = null;
@@ -483,14 +489,7 @@
           };
 
           const resolveKnxServerValue = () => {
-            const domValue = $knxServerInput.val();
-            if (domValue !== undefined && domValue !== null && domValue !== '') {
-              return domValue;
-            }
-            if (node.server !== undefined && node.server !== null) {
-              return node.server;
-            }
-            return '';
+            return activeKnxServerId;
           };
 
           const hasKnxServerSelected = () => {
@@ -500,17 +499,7 @@
           };
 
           const resolveHueServerValue = ({ allowStored = false } = {}) => {
-            if ($hueServerInput.length) {
-              const domValue = $hueServerInput.val();
-              if (domValue !== undefined && domValue !== null) {
-                const trimmed = String(domValue).trim();
-                if (trimmed !== '' && !HUE_EMPTY_SERVER_VALUES.has(trimmed.toLowerCase())) return trimmed;
-              }
-            }
-            if (node.serverMatter !== undefined && node.serverMatter !== null) {
-              const stored = String(node.serverMatter).trim();
-              if (stored !== '' && !HUE_EMPTY_SERVER_VALUES.has(stored.toLowerCase())) return stored;
-            }
+            if (activeMatterServerId !== '') return activeMatterServerId;
             if (allowStored && node.__locateSessionInfo && node.__locateSessionInfo.serverId) {
               return node.__locateSessionInfo.serverId;
             }
@@ -1458,8 +1447,20 @@
           $matterControllerModeInput.on('change.knxUltimateMatterControllerDevice', applyControllerMode);
           $universalServiceInput.on('change.knxUltimateMatterControllerDevice', refreshUniversalServiceVisibility);
 
-          $knxServerInput.on('change.knxUltimateMatterControllerDevice', () => {
-            refreshKnxBindings();
+          $knxServerInput.on('change.knxUltimateMatterControllerDevice', function (event) {
+            const selectedValue = $(this).val();
+            if (shouldPreserveSelection(event, selectedValue, activeKnxServerId, KNX_EMPTY_VALUES)) {
+              // Node-RED 5 can briefly emit an empty placeholder while rebuilding
+              // config-node selectors. Restore the effective saved value so an
+              // untouched save and the mapping tabs both keep the KNX gateway.
+              $knxServerInput.val(activeKnxServerId);
+              updateTabsVisibility();
+              return;
+            }
+            activeKnxServerId = normalizeConfigSelection(selectedValue, KNX_EMPTY_VALUES);
+            // Selecting none only changes visibility. Keep the mounted GA/DPT
+            // controls intact so choosing the gateway again cannot lose values.
+            if (activeKnxServerId !== '') refreshKnxBindings();
             updateTabsVisibility();
           });
 
@@ -1553,7 +1554,15 @@
           }
 
           if ($hueServerInput.length) {
-            $hueServerInput.off('.knxUltimateMatterControllerDeviceDevices').on('change.knxUltimateMatterControllerDeviceDevices', () => {
+            $hueServerInput.off('.knxUltimateMatterControllerDeviceDevices').on('change.knxUltimateMatterControllerDeviceDevices', function (event) {
+              const selectedValue = $(this).val();
+              if (shouldPreserveSelection(event, selectedValue, activeMatterServerId, HUE_EMPTY_SERVER_VALUES)) {
+                $hueServerInput.val(activeMatterServerId);
+                return;
+              }
+              const nextMatterServerId = normalizeConfigSelection(selectedValue, HUE_EMPTY_SERVER_VALUES);
+              if (nextMatterServerId === activeMatterServerId) return;
+              activeMatterServerId = nextMatterServerId;
               cachedHueDevices = [];
               node._cachedHueLightDevices = cachedHueDevices;
               showingNoHueDevicesPlaceholder = false;
@@ -1772,11 +1781,6 @@
 
         // The Matter controller needs no readiness poll here: the light list is fetched
         // on demand by the autocomplete. Start the editor immediately.
-        $("#node-input-serverMatter").change(function () {
-          try {
-            node._cachedHueLightDevices = [];
-          } catch (error) { }
-        });
         Go();
         // ################################################################
 

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/knxUltimateMatterControllerDevice.html

@@ -11,7 +11,7 @@ Er ersetzt die unveröffentlichten getrennten Matter-Controller-Nodes und behäl
 
 |Feld|Beschreibung|
 |--|--|
-| KNX GW | KNX-Gateway zum Schreiben und Beantworten der konfigurierten Gruppenadressen. Kann leer bleiben, wenn nur der Node-RED-Ausgang benötigt wird. |
+| KNX GW | KNX-Gateway zum Schreiben und Beantworten der konfigurierten Gruppenadressen. Kann leer bleiben, wenn nur der Node-RED-Ausgang benötigt wird. Das gespeicherte Gateway bleibt während der Initialisierung des Editors ausgewählt und ändert sich erst nach einer ausdrücklichen Benutzerauswahl. |
 | Matter controller | Matter-Controller-Konfigurationsknoten, in dem das Gerät gekoppelt wurde. |
 | Matter device | Matter-Endpunkt aus den gekoppelten Geräten. Die UI wird aus den echten Fähigkeiten neu aufgebaut. |
 | Switch / Steckdose / Licht On-Off | On/Off-Befehls- und Status-Gruppenadressen, normalerweise DPT `1.001`. |

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/knxUltimateMatterControllerDevice.html

@@ -11,7 +11,7 @@ It replaces the unpublished per-device Matter controller nodes and keeps the ful
 
 |Field|Description|
 |--|--|
-| KNX GW | KNX gateway used to write and answer the configured group addresses. It can be left empty when only Node-RED output is needed. |
+| KNX GW | KNX gateway used to write and answer the configured group addresses. It can be left empty when only Node-RED output is needed. The saved gateway remains selected while the editor initializes and changes only after an explicit user selection. |
 | Matter controller | Matter controller configuration node where the device has been commissioned. |
 | Matter device | Matter endpoint selected from commissioned devices. The UI is rebuilt from its real capabilities. |
 | Switch / Plug / Light On-Off | On/Off command and status group addresses, usually DPT `1.001`. |