node-red-contrib-knx-ultimate 7.0.0 → 7.0.2

package/CHANGELOG.md

@@ -6,6 +6,16 @@
 
 # CHANGELOG
 
+**Version 7.0.2** - September 2026<br/>
+
+- **KNX Device — group address autocomplete**: both input and output function editors now suggest imported ETS group addresses in the first argument of `getGAValue(...)` and `setGAValue(...)`. Search by address, device name or DPT in Monaco and Ace.<br/>
+- **KNX Device — readable GA references**: selecting an address adds its full ETS name and hierarchy to a deduplicated comment list at the beginning of the code. Clicking **Done** removes unused addresses from each editor's list before saving; addresses mentioned only in comments do not count as used.<br/>
+
+**Version 7.0.1** - September 2026<br/>
+
+KNX Device: fixed a wrong status text, when the node receives a READ request and responds with the last payload received.</br>
+KNX Device: the input msg now supports **msg.event = "GroupValue_Read"** as an additional method besides msg.readstatus = true, to issue a READ command to the bus.</br>
+
 **Version 7.0.0** - September 2026<br/>
 
 - **Major release — focused KNX package**: KNX Ultimate 7 starts the new package boundary. Conversational AI, supervised home learning, shared memory and multi-platform chat now belong to the standalone `node-red-contrib-cerebrum-ultimate`; this package remains the optional KNX/ETS integration. Existing deployed flows that contain the hidden legacy runtime types continue to load, but new instances can no longer be added from the palette.<br/>

package/README.md

@@ -8,7 +8,7 @@
 
 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, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.
 
-## Cerebrum Ultimate
+
 
 The former bundled AI assistant has moved to the standalone [Cerebrum Ultimate](https://github.com/Supergiovane/node-red-contrib-cerebrum-ultimate) package. Cerebrum Ultimate now provides the conversational, learning and supervised home-intelligence features, while using KNX Ultimate as an optional compatible integration. Hidden legacy runtime types remain in this package only so existing Node-RED flows continue to load; new installations should add the Cerebrum node from the standalone package.
 

package/nodes/knxUltimate-config.js

@@ -1529,9 +1529,9 @@ module.exports = (RED) => {
                   }
                   _input.handleSend(msg)
                 } else if (_input.hasOwnProperty('isSceneController')) { // 19/03/2020 in the middle of coronavirus. Whole italy is red zone, closed down. Scene Controller implementation
-                // 12/08/2020 Check wether is a learn (save) command or a activate (play) command.
+                  // 12/08/2020 Check wether is a learn (save) command or a activate (play) command.
                   if (_dest === _input.topic || _dest === _input.topicSave) {
-                  // Prepare the two messages to be evaluated directly into the Scene Controller node.
+                    // Prepare the two messages to be evaluated directly into the Scene Controller node.
                     new Promise((resolve) => {
                       if (_dest === _input.topic) {
                         try {
@@ -1568,16 +1568,16 @@ module.exports = (RED) => {
                         } catch (error) { }
                       }
                       resolve(true) // fulfilled
-                    // reject("error"); // rejected
+                      // reject("error"); // rejected
                     })
                       .then(function () { })
                       .catch(function () { })
                   } else {
-                  // 19/03/2020 Check and Update value if the input is part of a scene controller
+                    // 19/03/2020 Check and Update value if the input is part of a scene controller
                     new Promise((resolve) => {
-                    // Check and update the values of each device in the scene and update the rule array accordingly.
+                      // Check and update the values of each device in the scene and update the rule array accordingly.
                       for (let i = 0; i < _input.rules.length; i++) {
-                      // rule is { topic: rowRuleTopic, devicename: rowRuleDeviceName, dpt:rowRuleDPT, send: rowRuleSend}
+                        // rule is { topic: rowRuleTopic, devicename: rowRuleDeviceName, dpt:rowRuleDPT, send: rowRuleSend}
                         const oDevice = _input.rules[i]
                         if (typeof oDevice !== 'undefined' && oDevice.topic == _dest) {
                           const msg = buildInputMessage({
@@ -1606,23 +1606,23 @@ module.exports = (RED) => {
                         }
                       }
                       resolve(true) // fulfilled
-                    // reject("error"); // rejected
+                      // reject("error"); // rejected
                     })
                       .then(function () { })
                       .catch(function () { })
                   }
                 } else if (_input.hasOwnProperty('isLogger')) {
-                // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
-                // 24/03/2021 Logger Node, i'll pass cemiETS
+                  // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
+                  // 24/03/2021 Logger Node, i'll pass cemiETS
                   if (_cemiETS !== undefined) {
-                  // new Promise((resolve, reject) => {
+                    // new Promise((resolve, reject) => {
                     _input.handleSend(_cemiETS)
-                  //    resolve(true); // fulfilled
-                  // reject("error"); // rejected
-                  // }).then(function () { }).catch(function () { });
+                    //    resolve(true); // fulfilled
+                    // reject("error"); // rejected
+                    // }).then(function () { }).catch(function () { });
                   }
                 } else if (_input.listenallga === true && universalNodeAcceptsGA(_input, _dest)) {
-                // 25/10/2019 TRY TO AUTO DECODE IF Group address not found in the CSV
+                  // 25/10/2019 TRY TO AUTO DECODE IF Group address not found in the CSV
                   const msg = buildInputMessage({
                     _srcGA: _src,
                     _destGA: _dest,
@@ -1645,8 +1645,8 @@ module.exports = (RED) => {
                   _input.handleSend(msg)
                 } else if (_input.topic == _dest) {
                   if (_input.hasOwnProperty('isWatchDog')) {
-                  // 04/02/2020 Watchdog implementation
-                  // Is a watchdog node
+                    // 04/02/2020 Watchdog implementation
+                    // Is a watchdog node
                   } else {
                     const msg = buildInputMessage({
                       _srcGA: _src,
@@ -1721,14 +1721,14 @@ module.exports = (RED) => {
                   _input.handleSend(msg)
                 } else
                 if (_input.hasOwnProperty('isLogger')) {
-                // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
-                // 24/03/2021 Logger Node, i'll pass cemiETS
+                  // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
+                  // 24/03/2021 Logger Node, i'll pass cemiETS
                   if (_cemiETS !== undefined) {
-                  // new Promise((resolve, reject) => {
+                    // new Promise((resolve, reject) => {
                     _input.handleSend(_cemiETS)
-                  //    resolve(true); // fulfilled
-                  // reject("error"); // rejected
-                  // }).then(function () { }).catch(function () { });
+                    //    resolve(true); // fulfilled
+                    // reject("error"); // rejected
+                    // }).then(function () { }).catch(function () { });
                   }
                 } else if (_input.listenallga === true && universalNodeAcceptsGA(_input, _dest)) {
                   const msg = buildInputMessage({
@@ -1752,9 +1752,9 @@ module.exports = (RED) => {
                   })
                   _input.handleSend(msg)
                 } else if (_input.topic === _dest) {
-                // 04/02/2020 Watchdog implementation
+                  // 04/02/2020 Watchdog implementation
                   if (_input.hasOwnProperty('isWatchDog')) {
-                  // Is a watchdog node
+                    // Is a watchdog node
                     _input.watchDogTimerReset()
                   } else {
                     const msg = buildInputMessage({
@@ -1827,18 +1827,18 @@ module.exports = (RED) => {
                   _input.handleSend(msg)
                 } else
                 if (_input.hasOwnProperty('isLogger')) {
-                // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
-                // node.sysLogger?.info("BANANA isLogger", _evt, _src, _dest, _rawValue, _cemiETS);
-                // 24/03/2021 Logger Node, i'll pass cemiETS
+                  // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
+                  // node.sysLogger?.info("BANANA isLogger", _evt, _src, _dest, _rawValue, _cemiETS);
+                  // 24/03/2021 Logger Node, i'll pass cemiETS
                   if (_cemiETS !== undefined) {
-                  // new Promise((resolve, reject) => {
+                    // new Promise((resolve, reject) => {
                     _input.handleSend(_cemiETS)
-                  //    resolve(true); // fulfilled
-                  // reject("error"); // rejected
-                  // }).then(function () { }).catch(function () { });
+                    //    resolve(true); // fulfilled
+                    // reject("error"); // rejected
+                    // }).then(function () { }).catch(function () { });
                   }
                 } else if (_input.listenallga === true && universalNodeAcceptsGA(_input, _dest)) {
-                // Read Request
+                  // Read Request
                   const msg = buildInputMessage({
                     _srcGA: _src,
                     _destGA: _dest,
@@ -1860,11 +1860,11 @@ module.exports = (RED) => {
                   })
                   _input.handleSend(msg)
                 } else if (_input.topic === _dest) {
-                // 04/02/2020 Watchdog implementation
+                  // 04/02/2020 Watchdog implementation
                   if (_input.hasOwnProperty('isWatchDog')) {
-                  // Is a watchdog node
+                    // Is a watchdog node
                   } else {
-                  // Read Request
+                    // Read Request
                     const msg = buildInputMessage({
                       _srcGA: _src,
                       _destGA: _dest,
@@ -1881,7 +1881,7 @@ module.exports = (RED) => {
                     // 24/09/2019 Autorespond to BUS
                     if (_input.hasOwnProperty('notifyreadrequestalsorespondtobus') && _input.notifyreadrequestalsorespondtobus === true) {
                       if (typeof _input.currentPayload === 'undefined' || _input.currentPayload === '' || _input.currentPayload === null) {
-                      // 14/08/2021 Added || input.currentPayload === null
+                        // 14/08/2021 Added || input.currentPayload === null
                         node.sendKNXTelegramToKNXEngine({
                           grpaddr: _dest,
                           payload: _input.notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized,
@@ -1909,8 +1909,8 @@ module.exports = (RED) => {
                         _input.setNodeStatus({
                           fill: 'blue',
                           shape: 'ring',
-                          text: 'Read & Autorespond with default',
-                          payload: _input.notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized,
+                          text: 'Read & Autorespond',
+                          payload: _input.currentPayload,
                           GA: _input.topic,
                           dpt: msg.knx.dpt,
                           devicename: ''

package/nodes/knxUltimate.html

@@ -25,6 +25,7 @@
 <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/KNXSendSnippets.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/KNXReceiveSnippets.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxFunctionAutocomplete.js"></script>
 
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimate', {
@@ -407,6 +408,36 @@ return msg;`
                 })
             }
 
+            let groupAddressRequest = null;
+            let groupAddressServerId = null;
+            let functionEditorsDisposed = false;
+            const functionEditorDisposables = [];
+            const loadFunctionGroupAddresses = () => {
+                const serverId = $("#node-input-server").val();
+                if (functionEditorsDisposed || !serverId || serverId === '_ADD_') return Promise.resolve([]);
+                if (!groupAddressRequest || groupAddressServerId !== serverId) {
+                    groupAddressServerId = serverId;
+                    groupAddressRequest = new Promise(resolve => {
+                        $.getJSON("knxUltimatecsv?nodeID=" + encodeURIComponent(serverId))
+                            .done(data => resolve(Array.isArray(data) ? data : []))
+                            .fail(() => { groupAddressRequest = null; resolve([]); });
+                    });
+                }
+                return groupAddressRequest.then(data => {
+                    return !functionEditorsDisposed && $("#node-input-server").val() === serverId ? data : [];
+                });
+            };
+            node.disposeKnxFunctionEditors = () => {
+                functionEditorsDisposed = true;
+                functionEditorDisposables.forEach(disposable => disposable.dispose());
+                ['sampleEditor', 'sendMsgToKNXCodeEditor', 'receiveMsgFromKNXCodeEditor'].forEach(key => {
+                    try { if (node[key]) node[key].destroy(); } catch (error) { }
+                    delete node[key];
+                });
+                delete node.activeCodeEditor;
+                delete node.disposeKnxFunctionEditors;
+            };
+
             const applyEditorOptions = (editor) => {
                 try {
                     if (!editor) return;
@@ -425,47 +456,15 @@ return msg;`
                             enableLiveAutocompletion: true
                         });
                     }
-                    if (typeof editor.completers === 'undefined') {
-                        editor.completers = [];
-                    }
-                    if (Array.isArray(editor.completers) && !editor._knxHelperCompleter) {
-                        const aceCompletions = knxFunctionHelperItems.map(item => ({
-                            caption: item.label,
-                            value: item.aceValue,
-                            snippet: item.snippet,
-                            meta: 'KNX helper',
-                            doc: item.doc
-                        }));
-                        const helperCompleter = {
-                            getCompletions: function (_editor, _session, _pos, prefix, callback) {
-                                const search = (prefix || '').toLowerCase();
-                                const filtered = search
-                                    ? aceCompletions.filter(entry => entry.caption.toLowerCase().startsWith(search) || entry.value.toLowerCase().startsWith(search))
-                                    : aceCompletions;
-                                callback(null, filtered.length ? filtered : aceCompletions);
-                            },
-                            getDocTooltip: function (item) {
-                                if (!item || item.docHTML || !item.doc) return;
-                                item.docHTML = '<b>' + item.caption + '</b><hr />' + item.doc;
-                            }
-                        };
-                        editor.completers.push(helperCompleter);
-                        editor._knxHelperCompleter = helperCompleter;
-                    }
-                    if (typeof monaco !== 'undefined' && !globalScope.knxFunctionMonacoCompletionProvider) {
+                    functionEditorDisposables.push(globalScope.KNXUltimateFunctionAutocomplete.attach(editor, {
+                        monaco: typeof monaco !== 'undefined' ? monaco : null,
+                        ace: typeof ace !== 'undefined' ? ace : null,
+                        loadGroupAddresses: loadFunctionGroupAddresses,
+                        helperItems: knxFunctionHelperItems
+                    }));
+                    if (typeof monaco !== 'undefined' && !globalScope.knxFunctionMonacoGlobals) {
                         try {
-                            const functionSuggestions = knxFunctionHelperItems.map(item => ({
-                                label: item.label,
-                                kind: monaco.languages.CompletionItemKind.Function,
-                                insertText: item.snippet,
-                                insertTextRules: monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
-                                documentation: item.doc
-                            }));
-
-                            globalScope.knxFunctionMonacoCompletionProvider = monaco.languages.registerCompletionItemProvider('javascript', {
-                                provideCompletionItems: () => ({ suggestions: functionSuggestions })
-                            });
-
+                            globalScope.knxFunctionMonacoGlobals = true;
                             monaco.languages.typescript.javascriptDefaults.addExtraLib([
                                 '/** Read a KNX group address. This helper is async, so use await to get the real value. By default, if the value is not cached, a KNX read is sent. Pass false as third parameter to use cache-only mode. */',
                                 'declare function getGAValue(address: string, dptOrReadIfMissing?: string | boolean, readIfMissing?: boolean): Promise<any>;',
@@ -764,6 +763,7 @@ return msg;`
             })
 
             function checkUI() {
+                groupAddressRequest = null;
 
                 // Backward compatibility
                 if (node.outputRBE === true || $("#node-input-outputRBE").val() === true) {
@@ -1117,8 +1117,9 @@ return msg;`
             } catch (error) { }
 
             var node = this;
-            this.sendMsgToKNXCode = this.sendMsgToKNXCodeEditor.getValue();
-            this.receiveMsgFromKNXCode = this.receiveMsgFromKNXCodeEditor.getValue();
+            const cleanFunctionCode = window.KNXUltimateFunctionAutocomplete.pruneUnusedGaComments;
+            this.sendMsgToKNXCode = cleanFunctionCode(this.sendMsgToKNXCodeEditor.getValue());
+            this.receiveMsgFromKNXCode = cleanFunctionCode(this.receiveMsgFromKNXCodeEditor.getValue());
             if ($("#node-input-setTopicType").val() === "listenAllGA") {
                 this.listenallga = true;
             } else {
@@ -1150,16 +1151,7 @@ return msg;`
                 // $("#divInputRBE").show()               
             }
 
-            // 15/09/2020 Supergiovane, Detele the sample help editor
-            try {
-                node.sampleEditor.destroy();
-                delete node.sampleEditor;
-                node.sendMsgToKNXCodeEditor.destroy();
-                delete node.sendMsgToKNXCodeEditor;
-                node.receiveMsgFromKNXCodeEditor.destroy();
-                delete node.receiveMsgFromKNXCodeEditor;
-                //RED.editor.destroy(); // 23/01/2024 added  
-            } catch (error) { }
+            if (node.disposeKnxFunctionEditors) node.disposeKnxFunctionEditors();
 
         },
         oneditcancel: function () {
@@ -1168,16 +1160,7 @@ return msg;`
                 RED.sidebar.show("info");
             } catch (error) { }
 
-            // 15/09/2020 Supergiovane, Detele the sample help editor
-            try {
-                node.sampleEditor.destroy();
-                delete node.sampleEditor;
-                node.sendMsgToKNXCodeEditor.destroy();
-                delete node.sendMsgToKNXCodeEditor;
-                node.receiveMsgFromKNXCodeEditor.destroy();
-                delete node.receiveMsgFromKNXCodeEditor;
-                RED.editor.destroy(); // 23/01/2024 added  
-            } catch (error) { }
+            if (this.disposeKnxFunctionEditors) this.disposeKnxFunctionEditors();
         }
     })
 

package/nodes/knxUltimate.js

@@ -756,7 +756,7 @@ module.exports = function (RED) {
       // #endregion
 
       // 25/07/2019 if payload is read or the Telegram type is set to "read", do a read, otherwise, write to the bus
-      if ((msg.hasOwnProperty('readstatus') && msg.readstatus === true) || node.outputtype === 'read') {
+      if ((msg.hasOwnProperty('readstatus') && msg.readstatus === true) || node.outputtype === 'read' || (msg.hasOwnProperty('event') && msg.event === 'GroupValue_Read')) {
         // READ: Send a Read request to the bus
         let grpaddr = ''
         if (node.listenallga == false) {

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "7.0.0",
+  "version": "7.0.2",
   "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 and Modbus adapters, 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/knxFunctionAutocomplete.js

@@ -0,0 +1,223 @@
+(function (root, factory) {
+  const api = factory()
+  if (typeof module === 'object' && module.exports) module.exports = api
+  if (root) root.KNXUltimateFunctionAutocomplete = api
+}(typeof window !== 'undefined' ? window : globalThis, function () {
+  const firstArgument = /(?:^|[^\w$.])(?:getGAValue|setGAValue)\s*\(\s*$/
+
+  // Scan strings and comments so helper names in examples/comments cannot trigger a GA edit.
+  function getContext (source, offset) {
+    let code = ''
+    let index = 0
+    while (index < offset) {
+      const char = source[index]
+      if (source.slice(index, index + 2) === '//') {
+        const end = source.indexOf('\n', index + 2)
+        if (end < 0 || end >= offset) return null
+        code += ' '
+        index = end
+      } else if (source.slice(index, index + 2) === '/*') {
+        const end = source.indexOf('*/', index + 2)
+        if (end < 0 || end + 2 > offset) return null
+        code += ' '
+        index = end + 2
+      } else if (char === "'" || char === '"' || char === '`') {
+        const start = index + 1
+        let end = start
+        while (end < source.length && source[end] !== char && source[end] !== '\n') {
+          if (source[end] === '\\') end++
+          end++
+        }
+        if (offset <= end) {
+          if (!firstArgument.test(code) || (char === '`' && source.slice(start, end).includes('${'))) return null
+          return { start, end, query: source.slice(start, offset), quote: char, closed: source[end] === char }
+        }
+        code += ' literal '
+        index = end + 1
+        // Template literals can span lines; skip the rest rather than treating their text as code.
+        if (char === '`' && source[end] !== char) {
+          while (index < source.length && source[index] !== '`') {
+            if (source[index] === '\\') index++
+            index++
+          }
+          if (index >= offset) return null
+          index++
+        }
+      } else {
+        code += char
+        index++
+      }
+    }
+    return firstArgument.test(code) ? { start: offset, end: offset, query: '', quote: '', closed: false } : null
+  }
+
+  function getEntries (data, query) {
+    const terms = query.toLowerCase().trim().split(/\s+/).filter(Boolean)
+    const seen = new Set()
+    return (Array.isArray(data) ? data : []).filter(entry => {
+      if (!entry || typeof entry.ga !== 'string' || !entry.ga || seen.has(entry.ga)) return false
+      seen.add(entry.ga)
+      return terms.every(term => `${entry.ga} ${entry.devicename || ''} ${entry.dpt || ''}`.toLowerCase().includes(term))
+    }).map(entry => ({
+      ga: entry.ga,
+      comment: '// ' + `${entry.ga} ${entry.devicename || ''}`.replace(/[\r\n\u2028\u2029]+/g, ' ').trim(),
+      label: `${entry.ga} # ${entry.devicename || ''} # ${entry.dpt || ''}`
+    }))
+  }
+
+  function replacement (context, ga) {
+    return context.quote ? ga + (context.closed ? '' : context.quote) : "'" + ga + "'"
+  }
+
+  function getGaHeader (source) {
+    const entries = []
+    let end = 0
+    let match
+    const line = /^[\t ]*\/\/[\t ]+(\d+(?:\/\d+){0,2})(?:[\t ]+[^\r\n]*)?(?:\r?\n|$)/
+    while ((match = source.slice(end).match(line))) {
+      entries.push({ ga: match[1], comment: match[0].trim(), start: end, end: end + match[0].length })
+      end += match[0].length
+    }
+    return { entries, end }
+  }
+
+  function getCommentEdit (source, entry) {
+    const header = getGaHeader(source)
+    const existing = header.entries.find(item => item.ga === entry.ga)
+    if (existing && existing.comment === entry.comment) return null
+    const eol = source.includes('\r\n') ? '\r\n' : '\n'
+    return { start: existing ? existing.start : header.end, end: existing ? existing.end : header.end, text: entry.comment + eol }
+  }
+
+  function pruneUnusedGaComments (source) {
+    const header = getGaHeader(source)
+    if (!header.entries.length) return source
+    const body = source.slice(header.end)
+    // Preserve quoted strings while removing disabled code and explanatory comments.
+    const code = body.replace(/"(?:\\[\s\S]|[^"\\])*"|'(?:\\[\s\S]|[^'\\])*'|`(?:\\[\s\S]|[^`\\])*`|\/\/[^\r\n]*|\/\*[\s\S]*?(?:\*\/|$)/g, token => {
+      return token.startsWith('//') || token.startsWith('/*') ? ' ' : token
+    }).replace(/\\\//g, '/')
+    const seen = new Set()
+    const kept = header.entries.filter(entry => {
+      if (seen.has(entry.ga) || !new RegExp('(^|[^\\w/])' + entry.ga + '(?![\\w/])').test(code)) return false
+      seen.add(entry.ga)
+      return true
+    })
+    const eol = source.includes('\r\n') ? '\r\n' : '\n'
+    return kept.map(entry => entry.comment + eol).join('') + body
+  }
+
+  function attach (editor, { monaco, ace, loadGroupAddresses, helperItems }) {
+    if (monaco && typeof editor.getModel === 'function') {
+      editor.updateOptions({ quickSuggestions: { other: true, comments: false, strings: true }, suggestOnTriggerCharacters: true })
+      return monaco.languages.registerCompletionItemProvider('javascript', {
+        triggerCharacters: ['(', "'", '"', '`', '/'],
+        provideCompletionItems: async (model, position, _context, token) => {
+          if (model !== editor.getModel()) return { suggestions: [] }
+          const context = getContext(model.getValue(), model.getOffsetAt(position))
+          if (!context) {
+            const word = model.getWordUntilPosition(position)
+            return {
+              suggestions: helperItems.map(item => ({
+                label: item.label,
+                kind: monaco.languages.CompletionItemKind.Function,
+                insertText: item.snippet,
+                insertTextRules: monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
+                documentation: item.doc,
+                range: new monaco.Range(position.lineNumber, word.startColumn, position.lineNumber, word.endColumn)
+              }))
+            }
+          }
+          const entries = getEntries(await loadGroupAddresses(), context.query)
+          if ((token && token.isCancellationRequested) || model.isDisposed() || model !== editor.getModel()) return { suggestions: [] }
+          const start = model.getPositionAt(context.start)
+          const end = model.getPositionAt(context.end)
+          return {
+            incomplete: true,
+            suggestions: entries.map(entry => {
+              const comment = getCommentEdit(model.getValue(), entry)
+              const suggestion = {
+                label: entry.label,
+                kind: monaco.languages.CompletionItemKind.Value,
+                insertText: replacement(context, entry.ga),
+                // The list is already filtered by every search term, including ETS names.
+                filterText: context.query + ' ' + entry.label,
+                detail: 'KNX group address',
+                range: new monaco.Range(start.lineNumber, start.column, end.lineNumber, end.column)
+              }
+              if (comment) {
+                const position = model.getPositionAt(comment.start)
+                const end = model.getPositionAt(comment.end)
+                suggestion.additionalTextEdits = [{
+                  range: new monaco.Range(position.lineNumber, position.column, end.lineNumber, end.column),
+                  text: comment.text
+                }]
+              }
+              return suggestion
+            })
+          }
+        }
+      })
+    }
+
+    if (!ace || !ace.require) return { dispose () {} }
+    const Range = ace.require('ace/range').Range
+    const getAceContext = (session, position) => getContext(session.getValue(), session.getDocument().positionToIndex(position))
+    const helpers = {
+      getCompletions (_editor, session, position, prefix, callback) {
+        if (getAceContext(session, position)) return callback(null, [])
+        const search = (prefix || '').toLowerCase()
+        callback(null, helperItems.filter(item => item.id.toLowerCase().startsWith(search)).map(item => ({
+          caption: item.label, value: item.aceValue, snippet: item.snippet, meta: 'KNX helper', docText: item.doc
+        })))
+      }
+    }
+    const addresses = {
+      identifierRegexps: [/[a-zA-Z0-9_$\/\u00A2-\uFFFF]/],
+      getCompletions (_editor, session, position, _prefix, callback) {
+        const context = getAceContext(session, position)
+        if (!context) return callback(null, [])
+        loadGroupAddresses().then(data => callback(null, getEntries(data, context.query).map(entry => ({
+          caption: entry.label, value: entry.ga, comment: entry.comment, meta: 'KNX GA', score: 1000, completer: addresses
+        }))), () => callback(null, []))
+      },
+      insertMatch (target, item) {
+        const context = getAceContext(target.session, target.getCursorPosition())
+        if (!context) return
+        const doc = target.session.getDocument()
+        const start = doc.indexToPosition(context.start)
+        const end = doc.indexToPosition(context.end)
+        const text = replacement(context, item.value)
+        const comment = getCommentEdit(target.session.getValue(), { ga: item.value, comment: item.comment })
+        target.session.replace(new Range(start.row, start.column, end.row, end.column), text)
+        if (comment) {
+          const position = doc.indexToPosition(comment.start)
+          const end = doc.indexToPosition(comment.end)
+          target.session.replace(new Range(position.row, position.column, end.row, end.column), comment.text)
+        }
+        target.clearSelection()
+        target.moveCursorToPosition(doc.indexToPosition(context.start + text.length + (comment ? comment.text.length - (comment.end - comment.start) : 0)))
+      }
+    }
+    // Ace's default completer array is shared across editor instances.
+    editor.completers = (editor.completers || []).concat(helpers, addresses)
+    const afterExec = event => {
+      if (event.command.name !== 'insertstring' || !['(', "'", '"', '`', '/', ' '].includes(event.args)) return
+      if (!getAceContext(editor.session, editor.getCursorPosition())) return
+      const Autocomplete = ace.require('ace/autocomplete').Autocomplete
+      const completer = editor.completer || new Autocomplete()
+      editor.completer = completer
+      completer.autoInsert = false
+      completer.showPopup(editor)
+    }
+    editor.commands.on('afterExec', afterExec)
+    return {
+      dispose () {
+        editor.commands.off('afterExec', afterExec)
+        editor.completers = editor.completers.filter(item => item !== helpers && item !== addresses)
+      }
+    }
+  }
+
+  return { getContext, getEntries, attach, pruneUnusedGaComments }
+}))