node-red-contrib-knx-ultimate 4.0.10 → 4.0.11

package/CHANGELOG.md

@@ -6,6 +6,20 @@
 
 # CHANGELOG
 
+**Version 4.0.11** - October 2025<br/>
+- HUE nodes: hardened KNX telegram handling with a shared safe-send guard so editor events no longer ceases to function, when the KNX gateway is offline.<br/>
+- HUE Contact Sensor node: placeholders now leverage i18n translations with graceful fallback when translation keys are missing.<br/>
+- Editor polish: unified the default width of the `name` input across KNX and Hue nodes for a consistent layout.<br/>
+- KNX Scene Controller, Alerter and Load Control nodes: GA autocompletes now open their suggestion list immediately on focus/click to speed up GA selection.<br/>
+- Docs: audited external links; Hue API references require developer login but all other anchors resolve correctly.<br/>
+- HUE Light node: added configuration UI and runtime support for Hue lamp dynamic effects (candle, fireplace, etc.) with KNX mappings and status feedback.<br/>
+- NEW: Added Hue Plug/Outlet node to map KNX on/off control to Philips Hue smart plugs.<br/>
+- NEW: Added Hue Humidity Sensor node to expose relative humidity readings from Hue bridges to KNX.<br/>
+- NEW: Added Hue Camera Motion node to forward Hue camera motion detections to KNX, with optional flow output pins.<br/>
+- Hue Button node: refreshed editor layout and switched to Hue `button.button_report.event` instead of the deprecated `last_event`.<br/>
+- Hue Battery, Motion, Temperature, Light Sensor and Zigbee Connectivity nodes now share the unified editor layout with refresh icon, KNX-aware tabs and optional flow pin toggles.<br/>
+- Docs: cleaned bold markdown spacing across KNX Ultimate help translations to avoid rendering glitches.<br/>
+
 **Version 4.0.10** - October 2025<br/>
 - KNX Config node: you can now choose wether to display only the errors in the node statuses only errors.<br/>
 
@@ -1961,4 +1975,3 @@ This is an interim version, to quick fix some issues. Please report any issue wi
 
 **Version 0.0.1 BETA**<br/>
 - Initial release<br/>
-

package/nodes/hue-config.html

@@ -168,7 +168,7 @@
     <div id="waitWindow" hidden>
         <br/><br/>
         <p align="center">
-            <i class="fa-solid fa-hourglass-start fa-spin-pulse fa-4x"></i><br/><br/>
+            <i class="fa-solid fa-hourglass-start fa-spin-pulse fa-2x"></i><br/><br/>
             <span data-i18n="hue-config.properties.wait_message"></span>
         </p>
     </div>
@@ -231,4 +231,4 @@
     </div>
  
 
-</script>
+</script>

package/nodes/hue-config.js

@@ -246,6 +246,9 @@ module.exports = (RED) => {
         let allResources;
         if (_rtype === "light" || _rtype === "grouped_light") {
           allResources = node.hueAllResources.filter((a) => a.type === "light" || a.type === "grouped_light");
+        } else if (_rtype === "plug") {
+          allResources = node.hueAllResources.filter((a) => a.type === "plug" || a.type === "smartplug" || a.type === "smart_plug");
+          console.log('getResources plug raw resources', allResources.map((res) => ({ id: res.id, type: res.type, owner: res.owner?.rtype })));
         } else {
           allResources = node.hueAllResources.filter((a) => a.type === _rtype);
         }
@@ -324,6 +327,19 @@ module.exports = (RED) => {
                 id: resource.id,
               });
             }
+            if (_rtype === "plug") {
+              const linkedDevice = node.hueAllResources.find((dev) => dev.type === "device" && dev.services.find((serv) => serv.rid === resource.id));
+              const room = node.hueAllRooms?.find((roomItem) => roomItem.children?.find((child) => child.rid === linkedDevice?.id));
+              const plugName = linkedDevice?.metadata?.name || resource.metadata?.name || "Unnamed Plug";
+              const stateLabel = resource?.on?.on === true ? "on" : "off";
+              console.log('getResources plug direct resource', { id: resource.id, type: resource.type, name: plugName, linkedDevice: linkedDevice?.id });
+              retArray.push({
+                name: `Plug: ${plugName}${room !== undefined ? `, room ${room.metadata.name}` : ""} [${stateLabel}]`,
+                id: resource.id,
+                type: resource.type,
+                deviceObject: resource,
+              });
+            }
             if (_rtype === "temperature") {
               const Room = node.hueAllRooms.find((room) => room.children.find((child) => child.rid === resource.owner.rid));
               const linkedDevName = node.hueAllResources.find((dev) => dev.type === "device" && dev.services.find((serv) => serv.rid === resource.id)).metadata.name || "";
@@ -332,6 +348,14 @@ module.exports = (RED) => {
                 id: resource.id,
               });
             }
+            if (_rtype === "humidity") {
+              const Room = node.hueAllRooms.find((room) => room.children.find((child) => child.rid === resource.owner.rid));
+              const linkedDevName = node.hueAllResources.find((dev) => dev.type === "device" && dev.services.find((serv) => serv.rid === resource.id)).metadata.name || "";
+              retArray.push({
+                name: `Humidity: ${linkedDevName}${Room !== undefined ? `, room ${Room.metadata.name}` : ""}`,
+                id: resource.id,
+              });
+            }
             if (_rtype === "device_power") {
               const Room = node.hueAllRooms.find((room) => room.children.find((child) => child.rid === resource.owner.rid));
               const linkedDevName = node.hueAllResources.find((dev) => dev.type === "device" && dev.services.find((serv) => serv.rid === resource.id)).metadata.name || "";
@@ -379,6 +403,38 @@ module.exports = (RED) => {
             });
           }
         }
+        if (_rtype === "plug" && retArray.length === 0) {
+          const plugDevices = node.hueAllResources.filter((dev) => {
+            if (dev.type !== "device" || !Array.isArray(dev.services)) return false;
+            const archetypePlug = dev.product_data?.product_archetype === 'plug' || dev.metadata?.archetype === 'plug' || /plug/i.test(dev.product_data?.product_name || '') || /plug/i.test(dev.metadata?.name || '');
+            const hasService = dev.services.some((serv) => ['plug', 'smartplug', 'smart_plug', 'light'].includes(serv.rtype || ''));
+            return archetypePlug && hasService;
+          });
+          plugDevices.forEach((device) => {
+            try {
+              const plugService = device.services.find((serv) => ['plug', 'smartplug', 'smart_plug', 'light'].includes(serv.rtype || ''));
+              if (!plugService) return;
+              const plugResource = node.hueAllResources.find((res) => res.id === plugService.rid) || {};
+              const room = node.hueAllRooms?.find((roomItem) => roomItem.children?.find((child) => child.rid === device.id));
+              const plugName = device.metadata?.name || plugResource.metadata?.name || "Unnamed Plug";
+              const stateLabel = plugResource?.on?.on === true ? "on" : (plugResource?.on?.on === false ? "off" : "");
+              retArray.push({
+                name: `Plug: ${plugName}${room !== undefined ? `, room ${room.metadata.name}` : ""}${stateLabel ? ` [${stateLabel}]` : ""}`,
+                id: plugService.rid || device.id,
+                type: plugService.rtype || plugResource.type || 'light',
+                deviceObject: plugResource.on ? plugResource : {
+                  id: plugService.rid || device.id,
+                  type: plugService.rtype || plugResource.type || 'light',
+                  on: plugResource.on,
+                  owner: { rid: device.id, rtype: 'device' },
+                },
+              });
+            } catch (err) {
+              node.sysLogger?.warn(`KNXUltimateHue: getResources plug fallback error ${err.message}`);
+            }
+          });
+        }
+        node.sysLogger?.debug(`getResources plug returning ${retArray.length}`);
         return { devices: retArray };
       } catch (error) {
         node.sysLogger?.error(`KNXUltimateHue: hueEngine: classHUE: getResources: error ${error.message}`);

package/nodes/knxUltimate.html

@@ -161,16 +161,97 @@
                 })
             }
 
+            const applyEditorOptions = (editor) => {
+                try {
+                    if (!editor) return;
+                    if (typeof editor.updateOptions === 'function') {
+                        editor.updateOptions({ lineNumbers: 'off', minimap: { enabled: false }, scrollbar: { verticalScrollbarSize: 8, horizontalScrollbarSize: 8 } });
+                    } else if (editor.renderer && typeof editor.renderer.setShowGutter === 'function') {
+                        editor.renderer.setShowGutter(false);
+                    }
+                    if (typeof editor.setShowPrintMargin === 'function') editor.setShowPrintMargin(false);
+                } catch (error) { }
+            };
+
+            const highlightEditor = (editor, active) => {
+                if (!editor) return;
+                try {
+                    if (editor.renderer && editor.renderer.scroller) {
+                        editor.renderer.scroller.style.backgroundColor = active ? '#e6ffe6' : '';
+                    }
+                    if (editor.renderer && editor.renderer.content) {
+                        editor.renderer.content.style.backgroundColor = active ? '#e6ffe6' : '';
+                    }
+                    if (typeof editor.getDomNode === 'function') {
+                        const dom = editor.getDomNode();
+                        if (dom) dom.style.backgroundColor = active ? '#e6ffe6' : '';
+                    } else if (editor.container) {
+                        editor.container.style.backgroundColor = active ? '#e6ffe6' : '';
+                    }
+                } catch (error) { }
+            };
+
+            const attachFocusHandlers = (editor) => {
+                if (!editor) return;
+                try {
+                    if (typeof editor.on === 'function' && editor.renderer) {
+                        editor.on('focus', () => { node.activeCodeEditor = editor; highlightEditor(editor, true); });
+                        editor.on('blur', () => highlightEditor(editor, false));
+                    } else if (typeof editor.onDidFocusEditorWidget === 'function') {
+                        editor.onDidFocusEditorWidget(() => { node.activeCodeEditor = editor; highlightEditor(editor, true); });
+                        if (typeof editor.onDidBlurEditorWidget === 'function') {
+                            editor.onDidBlurEditorWidget(() => highlightEditor(editor, false));
+                        }
+                    }
+                } catch (error) { }
+            };
+
+            const insertTextIntoEditor = (editor, text) => {
+                if (!editor || !text) return;
+                try {
+                    if (editor.session && typeof editor.session.insert === 'function') {
+                        editor.focus();
+                        editor.session.insert(editor.getCursorPosition(), text);
+                        return;
+                    }
+                    if (typeof editor.executeEdits === 'function' && typeof editor.getPosition === 'function' && typeof monaco !== 'undefined') {
+                        const position = editor.getPosition();
+                        if (!position) return;
+                        const range = new monaco.Range(position.lineNumber, position.column, position.lineNumber, position.column);
+                        editor.executeEdits('knxInsertGA', [{ range, text, forceMoveMarkers: true }]);
+                        editor.setPosition({ lineNumber: position.lineNumber, column: position.column + text.length });
+                        editor.focus();
+                    }
+                } catch (error) { }
+            };
+
             node.sendMsgToKNXCodeEditor = RED.editor.createEditor({
                 id: 'sendMsgToKNXCode-editor',
                 mode: 'ace/mode/nrjavascript',
                 value: node.sendMsgToKNXCode
             });
+            applyEditorOptions(node.sendMsgToKNXCodeEditor);
             node.receiveMsgFromKNXCodeEditor = RED.editor.createEditor({
                 id: 'receiveMsgFromKNXCode-editor',
                 mode: 'ace/mode/nrjavascript',
                 value: node.receiveMsgFromKNXCode
             });
+            applyEditorOptions(node.receiveMsgFromKNXCodeEditor);
+            node.activeCodeEditor = null;
+            attachFocusHandlers(node.sendMsgToKNXCodeEditor);
+            attachFocusHandlers(node.receiveMsgFromKNXCodeEditor);
+
+            $("#btn-insert-knxFunctionGA").off('click').on('click', function () {
+                const value = $("#node-input-knxFunctionHelperGAList").val();
+                if (!value || value.trim() === '') {
+                    $("#node-input-knxFunctionHelperGAList").focus();
+                    return;
+                }
+                const editor = node.activeCodeEditor || node.sendMsgToKNXCodeEditor || node.receiveMsgFromKNXCodeEditor;
+                if (!editor) return;
+                insertTextIntoEditor(editor, value);
+            });
+
             const configureSnippetPicker = (snippets, inputSelector, datalistSelector, applySnippet) => {
                 const inputEl = $(inputSelector)
                 const datalistEl = $(datalistSelector)
@@ -718,7 +799,7 @@
                         <i class="fa fa-tag"></i>
                         <span data-i18n="knxUltimate.properties.node-input-name"></span>
                     </label>
-                    <input style="width:220px;" type="text" id="node-input-name"
+                    <input style="flex:1 1 240px; min-width:240px; max-width:240px;" type="text" id="node-input-name"
                         data-i18n="[placeholder]knxUltimate.properties.node-input-name" />
                 </div>
                 <div class="form-row" id="divTopic">
@@ -897,7 +978,11 @@
                         <i class="fa fa-search"></i> <span data-i18n="knxUltimate.snippets.searchGA"></span>
                     </label>
                     <input type="text" id="node-input-knxFunctionHelperGAList"
-                        data-i18n="[placeholder]knxUltimate.placeholder.search" />
+                        data-i18n="[placeholder]knxUltimate.placeholder.search" style="max-width:260px;" />
+                    <button type="button" class="red-ui-button" id="btn-insert-knxFunctionGA" title="Insert"
+                        style="margin-left:4px;">
+                        <i class="fa fa-level-down"></i>
+                    </button>
                 </div>
 
 

package/nodes/knxUltimateAlerter.html

@@ -119,8 +119,11 @@
                             }
 
                         }
-                    }).focus(function () {
-                        $(this).autocomplete('search', $(this).val() + 'exactmatch');
+                    });
+                    oTopicField.on('focus.knxUltimateAlerter click.knxUltimateAlerter', function () {
+                        try {
+                            $(this).autocomplete('search', '');
+                        } catch (error) { /* empty */ }
                     });
                     try { if (oNodeServer && oNodeServer.id) KNX_enableSecureFormatting(oTopicField, oNodeServer.id); } catch (e) {}
 
@@ -202,7 +205,7 @@
 
 <div class="form-row">
     <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="knxUltimateAlerter.properties.node-input-name"></span> </label>
-    <input type="text" id="node-input-name" data-i18n="[placeholder]knxUltimateAlerter.properties.node-input-name">
+    <input type="text" id="node-input-name" data-i18n="[placeholder]knxUltimateAlerter.properties.node-input-name" style="flex:1 1 240px; min-width:240px; max-width:240px;">
 </div>
 
 <div class="form-row">
@@ -242,5 +245,3 @@
 </div>
 
 </script>
-
-

package/nodes/knxUltimateAutoResponder.html

@@ -87,7 +87,7 @@
     <label for="node-input-name" >
         <i class="fa fa-tag"></i> Name
     </label>
-    <input  type="text" id="node-input-name" data-i18n="[placeholder]knxUltimateAutoResponder.node-input-name" />
+    <input  type="text" id="node-input-name" data-i18n="[placeholder]knxUltimateAutoResponder.node-input-name" style="flex:1 1 240px; min-width:240px; max-width:240px;" />
 </div>
 
 <div class="form-row">
@@ -97,4 +97,3 @@
 
 </script>
 
-

package/nodes/knxUltimateGlobalContext.html

@@ -86,7 +86,7 @@
         <i class="fa fa-tag"></i>
         <span data-i18n="knxUltimateGlobalContext.node-input-name"></span>
     </label>
-    <input style="width:35%;" type="text" id="node-input-name" data-i18n="[placeholder]knxUltimateGlobalContext.node-input-name" />
+    <input style="flex:1 1 240px; min-width:240px; max-width:240px;" type="text" id="node-input-name" data-i18n="[placeholder]knxUltimateGlobalContext.node-input-name" />
 </div>
 
 <div class="form-row">
@@ -123,4 +123,3 @@
 </div>
 
 </script>
-