node-red-contrib-knx-ultimate 6.2.3-beta.3 → 6.2.3-beta.5

package/CHANGELOG.md

@@ -6,8 +6,14 @@
 
 # CHANGELOG
 
-**Version 6.2.3-beta.3** - August 2026<br/>
+**Version 6.2.3-beta.5** - August 2026<br/>
 
+- **HUE Controller**: device-first selection with automatic type detection and all supported Hue API v2 resources.<br/>
+- **Device pickers**: Hue, Matter and KNX Group Address lists now stay open on click and show all entries before filtering.<br/>
+
+**Version 6.2.3-beta.4** - August 2026<br/>
+
+- **Matter Controller — live commissioning progress**: replaced the pairing overlay spinner with a milestone-based progress bar driven by the actual matter.js commissioning flow. The blocking panel now describes the active discovery, PASE, device-information, fail-safe, regulatory, time-sync, attestation, credential, access-control, CASE reconnect and completion phase in English; when exposed by the commissionee, its product name, Vendor ID and Product ID appear below the current operation. Progress polling is local to the Node-RED editor, stops with the pairing request and is isolated by operation ID across editor tabs.<br/>
 - **HUE Controller — unified Hue API v2 node**: added one controller node covering the complete set of existing Hue functions: lights and grouped lights, plugs, buttons, Tap dial, motion and camera motion, contacts, light level, temperature, humidity, scenes, battery, Zigbee connectivity and device software update. The compact device-function selector uses one third of the available width and opens the established dedicated editor with its localized labels; KNX mapping fields are hidden whenever no **KNX Gateway** is selected, including `none`, an empty value and **Add new...**. The YouTube tutorial playlist now appears once at the top of the editor, while routine inline `form-tips` are removed from the unified UI and a compact migration privacy disclaimer remains directly below the conversion button. The migration action runs entirely inside the browser and changes only the legacy HUE nodes requiring conversion, preserving every existing property, config reference, group, position and link; no flow or node data leaves the editor and the workspace remains undeployed for user review. After a successful conversion, an editable email draft addressed to the author opens without navigating the top-level Node-RED page and contains only the converted-node count and space for optional notes; the user decides whether to send it and nothing is sent automatically. The final Node-RED message offers an optional support button, and the PayPal donation page opens only when the user clicks it. Each profile executes the same mature runtime contract, preserving KNX telegram types, Hue event/status direction, flow pins and loop protection. Runtime implementations, editor definitions, templates and all six translation catalogs are embedded as package-internal HUE Controller profiles; registration order no longer matters, the KNX and Hue gateway fields remain real config-node selectors, and the controller has no runtime or editor dependency on deprecated node types. The original Hue Light node remains unchanged. Existing dedicated Hue nodes remain fully compatible and registered, use Node-RED's special `deprecated` category so they no longer appear in the palette, retain the lighter `#E7E9F6` color and `(deprecated)` canvas suffix without changing saved names, and show a localized HUE Controller migration notice at the top of their editors.<br/>
 - **HUE Controller — complete per-function help**: the established help of every dedicated Hue node is now incorporated under the corresponding HUE Controller function key, with an anchor index and automatic sidebar focus when the function changes. The same 15-section reference is included in the Controller wiki documentation in EN, IT, DE, FR, ES and zh-CN; legacy deprecation notices are deliberately excluded from the embedded copies.<br/>
 - **HUE Controller — legacy-independent maintenance boundary**: private runtime profiles and the private editor/template/translation sources are now the canonical implementation of HUE Controller. Its generator and consistency check read only those private sources and never inspect the frozen legacy nodes, so future Controller fixes remain isolated and the dedicated deprecated nodes can eventually be removed without breaking either runtime or UI. Added detailed architecture and lifecycle comments around runtime constructor capture, RED facades, editor mounting, profile drafts, dynamic pins, translations and the Hue Light bootstrap path.<br/>

package/nodes/commonFunctions.js

@@ -800,18 +800,51 @@ module.exports = (RED) => {
       }
     })
 
+    // MATTER: current commissioning milestone for the blocking editor overlay.
+    // The operation id keeps simultaneous editor tabs from displaying each other's progress.
+    RED.httpAdmin.get('/KNXUltimateMatterPairProgress', RED.auth.needsPermission('matter-config.read'), (req, res) => {
+      try {
+        const matterServer = RED.nodes.getNode(req.query.serverId)
+        if (matterServer === null || matterServer === undefined) {
+          res.json({ active: false, percent: 0, error: 'PLEASE DEPLOY FIRST: then try again.' })
+          return
+        }
+        res.json(matterServer.getCommissioningProgress(req.query.operationId))
+      } catch (error) {
+        RED.log.error(`Err KNXUltimateMatterPairProgress: ${error.message}`)
+        res.json({ active: false, percent: 0, error: error.message })
+      }
+    })
+
     // MATTER: commissions (pairs) a new Matter device using a pairing code or QR code string
     RED.httpAdmin.get('/KNXUltimateMatterPair', RED.auth.needsPermission('matter-config.write'), async (req, res) => {
+      let matterServer
+      const requestedOperationId = String(req.query.operationId || '').replace(/[^a-zA-Z0-9_-]/g, '').slice(0, 80)
+      // Keep direct callers of the pre-progress endpoint backward compatible. The editor
+      // supplies its own id so it can poll; legacy callers receive a server-only id.
+      const operationId = requestedOperationId || `server-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`
       try {
-        const matterServer = RED.nodes.getNode(req.query.serverId)
+        matterServer = RED.nodes.getNode(req.query.serverId)
         if (matterServer === null || matterServer === undefined) {
           res.json({ error: 'PLEASE DEPLOY FIRST: then try again.' })
           return
         }
-        const nodeId = await matterServer.commission(req.query.code, { targetHost: req.query.targetHost })
+        if (!matterServer.beginCommissioningProgress(operationId)) {
+          res.json({ error: 'Another Matter commissioning operation is already in progress.' })
+          return
+        }
+        const nodeId = await matterServer.commission(req.query.code, {
+          targetHost: req.query.targetHost,
+          onProgress: (progress) => matterServer.reportCommissioningProgress(operationId, progress)
+        })
         const requestedName = String(req.query.name || '').trim()
         let renameError = null
         if (requestedName !== '') {
+          matterServer.reportCommissioningProgress(operationId, {
+            phase: 'naming',
+            percent: 99,
+            message: 'Applying the requested device name…'
+          })
           try {
             await matterServer.renameCommissionedNode(nodeId, requestedName)
           } catch (error) {
@@ -823,8 +856,19 @@ module.exports = (RED) => {
         try {
           device = matterServer.getCommissionedNodesDetails().find((item) => String(item.nodeId) === String(nodeId)) || null
         } catch (error) { /* empty */ }
+        matterServer.endCommissioningProgress(operationId, {
+          phase: 'complete',
+          percent: 100,
+          message: 'Matter commissioning completed successfully.'
+        })
         res.json({ nodeId, name: device?.name, productName: device?.productName, vendorName: device?.vendorName, renameError })
       } catch (error) {
+        try {
+          matterServer?.endCommissioningProgress(operationId, {
+            phase: 'error',
+            message: `Commissioning failed: ${error.message}`
+          })
+        } catch (progressError) { /* empty */ }
         const targetHost = req.query.targetHost ? ` targetHost=${req.query.targetHost}` : ''
         RED.log.error(`Err KNXUltimateMatterPair:${targetHost} ${error.stack || error.message}`)
         res.json({ error: error.message })

package/nodes/hue-config.js

@@ -5,6 +5,10 @@
 /* eslint-disable no-inner-declarations */
 /* eslint-disable max-len */
 const cloneDeep = require('lodash/cloneDeep')
+const {
+  HUE_CONTROLLER_RESOURCE_TYPES,
+  buildHueControllerResourceCatalog
+} = require('./utils/hueControllerResourceCatalog')
 // const classHUE = require("./utils/hueEngine").classHUE;
 const hueColorConverter = require('./utils/colorManipulators/hueColorConverter')
 
@@ -355,6 +359,15 @@ module.exports = (RED) => {
           }
         }
         if (node.hueAllResources === undefined) return
+        if (_rtype === 'hue_controller') {
+          const resourceResults = await Promise.all(HUE_CONTROLLER_RESOURCE_TYPES.map(async (resourceType) => {
+            const result = await node.getResources(resourceType)
+            return [resourceType, Array.isArray(result?.devices) ? result.devices : []]
+          }))
+          return {
+            devices: buildHueControllerResourceCatalog(Object.fromEntries(resourceResults))
+          }
+        }
         // Returns capitalized string
         function capStr (s) {
           if (typeof s !== 'string') return ''

package/nodes/knxUltimate.html

@@ -1,24 +1,25 @@
 <!-- <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/jquery.searchableSelect.js"></script> -->
 
 <style>
-/* Monaco editor - first area (input to bus): light green */
-#sendMsgToKNXCode-editor .monaco-editor,
-#sendMsgToKNXCode-editor .monaco-editor-background,
-#sendMsgToKNXCode-editor .monaco-editor .margin,
-#sendMsgToKNXCode-editor .monaco-editor .overflow-guard,
-#sendMsgToKNXCode-editor .monaco-editor .lines-content,
-#sendMsgToKNXCode-editor .monaco-editor .editor-scrollable {
-    background-color: #e8f5e9 !important;
-}
-/* Monaco editor - second area (bus to output): light yellow */
-#receiveMsgFromKNXCode-editor .monaco-editor,
-#receiveMsgFromKNXCode-editor .monaco-editor-background,
-#receiveMsgFromKNXCode-editor .monaco-editor .margin,
-#receiveMsgFromKNXCode-editor .monaco-editor .overflow-guard,
-#receiveMsgFromKNXCode-editor .monaco-editor .lines-content,
-#receiveMsgFromKNXCode-editor .monaco-editor .editor-scrollable {
-    background-color: #fffde7 !important;
-}
+    /* Monaco editor - first area (input to bus): light green */
+    #sendMsgToKNXCode-editor .monaco-editor,
+    #sendMsgToKNXCode-editor .monaco-editor-background,
+    #sendMsgToKNXCode-editor .monaco-editor .margin,
+    #sendMsgToKNXCode-editor .monaco-editor .overflow-guard,
+    #sendMsgToKNXCode-editor .monaco-editor .lines-content,
+    #sendMsgToKNXCode-editor .monaco-editor .editor-scrollable {
+        background-color: #e8f5e9 !important;
+    }
+
+    /* Monaco editor - second area (bus to output): light yellow */
+    #receiveMsgFromKNXCode-editor .monaco-editor,
+    #receiveMsgFromKNXCode-editor .monaco-editor-background,
+    #receiveMsgFromKNXCode-editor .monaco-editor .margin,
+    #receiveMsgFromKNXCode-editor .monaco-editor .overflow-guard,
+    #receiveMsgFromKNXCode-editor .monaco-editor .lines-content,
+    #receiveMsgFromKNXCode-editor .monaco-editor .editor-scrollable {
+        background-color: #fffde7 !important;
+    }
 </style>
 
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
@@ -76,19 +77,19 @@
             return ((this.outputRBE === "true" || this.outputRBE === true) ? "|rbe| " : "") + functionSendMsgToKNXCode + (this.name || this.topic || "KNX Device") + (this.setTopicType === 'str' || this.setTopicType === undefined ? '' : ' [' + (this.setTopicType === 'listenAllGA' ? 'Universal' : this.setTopicType) + ']') + functionreceiveMsgFromKNXCode + ((this.inputRBE === "true" || this.inputRBE === true) ? " |rbe|" : "")
         },
         paletteLabel: "KNX DEVICE",
-	        button: {
-	            enabled: function () {
-	                return !this.changed;
-	            },
-	            visible: function () {
-	                const isUniversal = this.setTopicType === 'listenAllGA' || this.listenallga === true || this.listenallga === 'true';
-	                if (isUniversal) return false;
-	                return this.buttonEnabled === true || this.buttonEnabled === "true";
-	            },
-	            onclick: function () {
-	                const node = this;
-	                const mode = node.buttonMode || 'toggle';
-	                const request = { id: node.id, mode };
+        button: {
+            enabled: function () {
+                return !this.changed;
+            },
+            visible: function () {
+                const isUniversal = this.setTopicType === 'listenAllGA' || this.listenallga === true || this.listenallga === 'true';
+                if (isUniversal) return false;
+                return this.buttonEnabled === true || this.buttonEnabled === "true";
+            },
+            onclick: function () {
+                const node = this;
+                const mode = node.buttonMode || 'toggle';
+                const request = { id: node.id, mode };
                 if (mode === 'value') {
                     request.value = node.buttonStaticValue;
                 }
@@ -148,6 +149,7 @@
 
 
             var node = this;
+            let topicPickerMouseDown = false;
             if ($("#node-input-server").val() === "_ADD_") {
                 // Node-Red 4.0.x has a bug not selecting the default server node
                 try {
@@ -964,8 +966,20 @@ return msg;`
                                         }
                                     } catch (e) { }
                                 }
-                            }).focus(function () {
-                                $(this).autocomplete('search', $(this).val() + 'exactmatch');
+                            }).on('mousedown.knxUltimateTopicPicker', function () {
+                                topicPickerMouseDown = true;
+                            }).on('focus.knxUltimateTopicPicker', function () {
+                                if (!topicPickerMouseDown) {
+                                    $(this).autocomplete('search', '');
+                                }
+                            }).on('click.knxUltimateTopicPicker', function () {
+                                topicPickerMouseDown = false;
+                                const input = this;
+                                setTimeout(function () {
+                                    $(input).autocomplete('search', '');
+                                }, 0);
+                            }).on('blur.knxUltimateTopicPicker', function () {
+                                topicPickerMouseDown = false;
                             }).autocomplete("instance")._renderItem = function (ul, item) {
                                 const isSecure = !!item.isSecure;
                                 const colorStyle = isSecure ? 'color: green;' : '';
@@ -1185,10 +1199,6 @@ return msg;`
 <input id="node-input-gaSecure" name="node-input-gaSecure" type="hidden" value="false" />
 
 <div class="form-row">
-    <b>KNX Device node</b>
-    <br />
-    <br />
-
     <label for="node-input-server">
         <i class="fa fa-circle-o"></i> <span data-i18n="knxUltimate.properties.node-input-server"></span>
     </label>
@@ -1209,13 +1219,14 @@ return msg;`
             <option value="global" data-i18n="knxUltimate.selectlists.SetTopic_global"></option>
             <option value="env" data-i18n="knxUltimate.selectlists.SetTopic_env"></option>
         </select>
-        <input type="text" id="node-input-topic" data-i18n="[placeholder]knxUltimate.placeholder.search"
+         <input type="text" id="node-input-topic" data-i18n="[placeholder]knxUltimate.placeholder.search"
             style="width:180px" />
         <span id="gaSecureShield" title="Data Secure" style="display:none;color:green;margin-left:6px;"><i
                 class="fa fa-shield"></i></span>
+        <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="divDatapointSelection">
         <label for="node-input-dpt">
             <img
@@ -1229,19 +1240,10 @@ return msg;`
     </div>
     <div class="form-row">
         <span id="dptDetailsContainer" style="display:none;width:100%;">
-            <div id="sampleCodeEditor" class="dpt-details-helplink" style="color:red;margin-bottom:4px;"></div>
-            <div class="node-text-editor" id="example-editor" style="height:200px;min-height:150px;padding:0px;"></div>
+            <!-- <div id="sampleCodeEditor" class="dpt-details-helplink" style="color:red;margin-bottom:4px;"></div> -->
+            <div class="node-text-editor" id="example-editor" style="height:110px;padding:0px;"></div>
         </span>
     </div>
-    <!-- <div class="form-row">
-        <input type="checkbox" id="node-input-listenallga"
-            style="display:inline-block; width:auto; vertical-align:top;" />
-        <label style="width:auto" for="node-input-listenallga">
-            <img
-                src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAwAAAAMCAYAAABWdVznAAAACXBIWXMAAB7CAAAewgFu0HU+AAAFGmlUWHRYTUw6Y29tLmFkb2JlLnhtcAAAAAAAPD94cGFja2V0IGJlZ2luPSLvu78iIGlkPSJXNU0wTXBDZWhpSHpyZVN6TlRjemtjOWQiPz4gPHg6eG1wbWV0YSB4bWxuczp4PSJhZG9iZTpuczptZXRhLyIgeDp4bXB0az0iQWRvYmUgWE1QIENvcmUgNS42LWMxNDggNzkuMTY0MDM2LCAyMDE5LzA4LzEzLTAxOjA2OjU3ICAgICAgICAiPiA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPiA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIgeG1sbnM6cGhvdG9zaG9wPSJodHRwOi8vbnMuYWRvYmUuY29tL3Bob3Rvc2hvcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RFdnQ9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZUV2ZW50IyIgeG1wOkNyZWF0b3JUb29sPSJBZG9iZSBQaG90b3Nob3AgMjEuMSAoTWFjaW50b3NoKSIgeG1wOkNyZWF0ZURhdGU9IjIwMjAtMDMtMjNUMTY6MjM6MjMrMDE6MDAiIHhtcDpNb2RpZnlEYXRlPSIyMDIwLTAzLTIzVDE2OjI1OjM0KzAxOjAwIiB4bXA6TWV0YWRhdGFEYXRlPSIyMDIwLTAzLTIzVDE2OjI1OjM0KzAxOjAwIiBkYzpmb3JtYXQ9ImltYWdlL3BuZyIgcGhvdG9zaG9wOkNvbG9yTW9kZT0iMyIgcGhvdG9zaG9wOklDQ1Byb2ZpbGU9InNSR0IgSUVDNjE5NjYtMi4xIiB4bXBNTTpJbnN0YW5jZUlEPSJ4bXAuaWlkOmJmNGM3NWVjLTIwNGYtNGY1YS05YTMxLTQ5NTU5YWJmZDE4NSIgeG1wTU06RG9jdW1lbnRJRD0ieG1wLmRpZDpiZjRjNzVlYy0yMDRmLTRmNWEtOWEzMS00OTU1OWFiZmQxODUiIHhtcE1NOk9yaWdpbmFsRG9jdW1lbnRJRD0ieG1wLmRpZDpiZjRjNzVlYy0yMDRmLTRmNWEtOWEzMS00OTU1OWFiZmQxODUiPiA8eG1wTU06SGlzdG9yeT4gPHJkZjpTZXE+IDxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjcmVhdGVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOmJmNGM3NWVjLTIwNGYtNGY1YS05YTMxLTQ5NTU5YWJmZDE4NSIgc3RFdnQ6d2hlbj0iMjAyMC0wMy0yM1QxNjoyMzoyMyswMTowMCIgc3RFdnQ6c29mdHdhcmVBZ2VudD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiLz4gPC9yZGY6U2VxPiA8L3htcE1NOkhpc3Rvcnk+IDwvcmRmOkRlc2NyaXB0aW9uPiA8L3JkZjpSREY+IDwveDp4bXBtZXRhPiA8P3hwYWNrZXQgZW5kPSJyIj8+nhtLUgAAAE9JREFUKJG1UMsOACAIgub//7IdqvVQtjrExU1EEQLuiGCvgTNgl5D74MmVZPu4wIxQAgm+/sDec2VhgQPgf0sq1unjMlYJE/3MZrvy+kMFZQkZEWfC7ikAAAAASUVORK5CYII="></img>
-            <span data-i18n="knxUltimate.properties.node-input-listenallga"></span>
-        </label>
-    </div> -->
     <div id="tabs">
         <ul>
             <li><a href="#tabs-1"><i class="fa fa-braille"></i> Advanced options</a></li>
@@ -1254,14 +1256,6 @@ return msg;`
                         <i class="fa fa-desktop"></i> General properties
                     </dt>
                 </div>
-                <div class="form-row">
-                    <label style="width:180px" for="node-input-name">
-                        <i class="fa fa-tag"></i>
-                        <span data-i18n="knxUltimate.properties.node-input-name"></span>
-                    </label>
-                    <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">
                     <label style="width:180px" for="node-input-outputtopic">
                         <i class="fa fa-tasks"></i>