node-red-contrib-knx-ultimate 6.3.5 → 6.3.6

package/CHANGELOG.md

@@ -6,6 +6,10 @@
 
 # CHANGELOG
 
+**Version 6.3.6** - August 2026<br/>
+
+- **HUE Controller**: grouped lights now always show the complete Light mapping editor when KNX is configured, without checking child-light capabilities.<br/>
+
 **Version 6.3.5** - August 2026<br/>
 
 - **HUE Controller**: fixed Light mapping tabs being blocked by the Hue resource-readiness check and false-success Locate requests. Editor and Locate failures now show a red Node-RED message.<br/>

package/nodes/locales/de/knxUltimateHueController.html

@@ -42,6 +42,8 @@
 
 <p>Dieser Node steuert HUE-Leuchten (einzeln oder gruppiert) und ordnet Befehle/Zustände KNX-Gruppenadressen zu.</p>
 
+<p><strong>Leuchtengruppen:</strong> wenn ein KNX-Gateway konfiguriert ist, zeigt die Auswahl eines <code>grouped_light</code> immer die vollständigen Zuordnungen für Schalten, Dimmen, Tunable White, RGB/HSV, Effekte und Verhalten. Der Editor schränkt diese Felder nicht anhand der aktuell enthaltenen Leuchten ein.</p>
+
 **Allgemein**
 
 | Eigenschaft | Beschreibung |

package/nodes/locales/en/knxUltimateHueController.html

@@ -42,6 +42,8 @@
 
 <p>This node controls Philips Hue lights (single or grouped) and maps their commands/states to KNX.</p>
 
+<p><strong>Grouped lights:</strong> when a KNX gateway is configured, selecting a <code>grouped_light</code> always displays the complete Switch, Dim, Tunable White, RGB/HSV, Effects and Behaviour mappings. The editor does not restrict these fields according to the group's current child lights.</p>
+
 **General**
 
 |Property|Description|

package/nodes/locales/es/knxUltimateHueController.html

@@ -42,6 +42,8 @@
 
 <p> Este nodo controla las luces de Hue Philips (single o agrupada) y mapea sus comandos/estados a KNX. </p>
 
+<p><strong>Grupos de luces:</strong> cuando hay una pasarela KNX configurada, al seleccionar un <code>grouped_light</code> siempre se muestran todas las asignaciones de Interruptor, Regulación, Blanco ajustable, RGB/HSV, Efectos y Comportamiento. El editor no limita estos campos según las luces incluidas actualmente en el grupo.</p>
+
 **General**
 
 | Propiedad | Descripción |

package/nodes/locales/fr/knxUltimateHueController.html

@@ -42,6 +42,8 @@
 
 <p> Ce nœud contrôle les lumières de Hue Philips (simple ou groupées) et mappe leurs commandes / états à KNX. </p>
 
+<p><strong>Groupes de lampes :</strong> lorsqu'une passerelle KNX est configurée, la sélection d'un <code>grouped_light</code> affiche toujours toutes les associations Interrupteur, Variation, Blanc réglable, RGB/HSV, Effets et Comportement. L'éditeur ne limite pas ces champs selon les lampes actuellement présentes dans le groupe.</p>
+
 **Général**
 
 | Propriété | Description |

package/nodes/locales/it/knxUltimateHueController.html

@@ -42,6 +42,8 @@
 
 <p>Questo nodo controlla le luci HUE (singole o raggruppate) e mappa comandi/stati su KNX.</p>
 
+<p><strong>Gruppi di luci:</strong> quando è configurato un gateway KNX, selezionando un <code>grouped_light</code> vengono sempre mostrate tutte le mappature Switch, Dim, Tunable White, RGB/HSV, Effetti e Comportamento. L'editor non limita questi campi in base alle luci attualmente incluse nel gruppo.</p>
+
 **Generale**
 
 | Proprietà | Descrizione |

package/nodes/locales/zh-CN/knxUltimateHueController.html

@@ -42,6 +42,8 @@
 
 <p>此节点使您可以控制飞利浦色调灯和分组的灯光，还可以将此灯的状态发送到KNX巴士。</p>
 
+<p><strong>灯组：</strong>配置 KNX 网关后，选择 <code>grouped_light</code> 将始终显示完整的开关、调光、可调白光、RGB/HSV、效果和行为映射。编辑器不会根据灯组当前包含的灯具限制这些字段。</p>
+
 **一般的**
 
 |属性|描述|

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.3.5",
+  "version": "6.3.6",
   "description": "KNX Ultimate is the most advanced KNX integration for Node-RED, providing secure KNX/IP communication, routing, ETS project import, Philips Hue, Matter Controller and Matter Bridge (control matter device via KNX and expose KNX GA via Matter), MQTT, diagnostics with AI, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.",
   "files": [
     "nodes/",

package/resources/hueControllerProfiles.js

@@ -1238,14 +1238,7 @@
                   $hueDeviceInput.val(initialHueDeviceRaw);
                   updateTabsVisibility();
                   if (getJsonPromise !== undefined) getJsonPromise.abort();
-                  // HUE Controller temporarily selects Node-RED's `_ADD_` sentinel
-                  // while it bootstraps this mature editor. Reading the select here
-                  // would therefore query an inexistent bridge and return `{}` even
-                  // though the selected light has dimming, colour or tunable-white
-                  // capabilities. Resolve the real persisted config-node ID through
-                  // the same helper used by resource discovery and Locate instead.
-                  const capabilityServerId = resolveHueServerValue({ allowStored: true });
-                  const capabilityResourceId = initialHueDeviceRaw.split("#")[0];
+                  const selectedHueResourceType = String(initialHueDeviceRaw.split("#")[1] || '').trim().toLowerCase();
                   const applyHueCapabilities = (data) => {
                     let oLight = data || {};
                     const effects = (oLight && oLight.effects && Array.isArray(oLight.effects.status_values))
@@ -1380,20 +1373,35 @@
                     $("#node-input-specifySwitchOnBrightness").val(node.specifySwitchOnBrightness).trigger('change');
                     $("#node-input-enableDayNightLighting").val(node.enableDayNightLighting).trigger('change');
                   };
-                  getJsonPromise = $.getJSON(`knxUltimateGetLightObject?id=${encodeURIComponent(capabilityResourceId)}&serverId=${encodeURIComponent(capabilityServerId)}&_=${Date.now()}`, (data) => {
-                    try {
-                      applyHueCapabilities(data);
-                    } catch (error) {
-                      notifyEditorError(error, 'capabilities');
-                    }
-                  }).fail((xhr, textStatus, errorThrown) => {
-                    if (textStatus === 'abort') return;
-                    const detail = xhr && xhr.responseJSON && xhr.responseJSON.error
-                      ? xhr.responseJSON.error
-                      : (errorThrown || textStatus || 'Unable to load Hue capabilities');
-                    notifyEditorError(new Error(detail), 'capabilities request');
-                  });
-                  setTimeout(function () { if (getJsonPromise !== undefined) getJsonPromise.abort(); }, 10000);
+                  if (selectedHueResourceType === "grouped_light") {
+                    // A Hue group represents an aggregate control surface. Its
+                    // editor must remain complete and deterministic regardless of
+                    // the capabilities exposed by its current child lights.
+                    applyHueCapabilities({ type: "grouped_light" });
+                  } else {
+                    // HUE Controller temporarily selects Node-RED's `_ADD_` sentinel
+                    // while it bootstraps this mature editor. Reading the select here
+                    // would therefore query an inexistent bridge and return `{}` even
+                    // though the selected light has dimming, colour or tunable-white
+                    // capabilities. Resolve the real persisted config-node ID through
+                    // the same helper used by resource discovery and Locate instead.
+                    const capabilityServerId = resolveHueServerValue({ allowStored: true });
+                    const capabilityResourceId = initialHueDeviceRaw.split("#")[0];
+                    getJsonPromise = $.getJSON(`knxUltimateGetLightObject?id=${encodeURIComponent(capabilityResourceId)}&serverId=${encodeURIComponent(capabilityServerId)}&_=${Date.now()}`, (data) => {
+                      try {
+                        applyHueCapabilities(data);
+                      } catch (error) {
+                        notifyEditorError(error, 'capabilities');
+                      }
+                    }).fail((xhr, textStatus, errorThrown) => {
+                      if (textStatus === 'abort') return;
+                      const detail = xhr && xhr.responseJSON && xhr.responseJSON.error
+                        ? xhr.responseJSON.error
+                        : (errorThrown || textStatus || 'Unable to load Hue capabilities');
+                      notifyEditorError(new Error(detail), 'capabilities request');
+                    });
+                    setTimeout(function () { if (getJsonPromise !== undefined) getJsonPromise.abort(); }, 10000);
+                  }
                 }
                 // Show/Hide the div of the color at swich on
                 if (node.specifySwitchOnBrightness === "yes") {