node-red-contrib-knx-ultimate 8.0.4 → 8.0.5

package/CHANGELOG.md

@@ -6,6 +6,10 @@
 
 # CHANGELOG
 
+**Version 8.0.5** - September 2026
+
+- Added the KNX Ultimate 7-to-8 migration video to the package README, migration guide and all localized documentation pages.
+
 **Version 8.0.4** - September 2026
 
 - Automatic migration now validates only the HUE, Matter and KNX Utility nodes it converts. Invalid nodes from unrelated packages no longer block the upgrade.

package/MIGRATION.md

@@ -2,6 +2,8 @@
 
 Version 8 contains the current KNX nodes and gateway. HUE and Matter are provided by `node-red-contrib-hue-ultimate` and `node-red-contrib-matter-ultimate`; the old dedicated KNX utility nodes are replaced by KNX Utility.
 
+> ▶️ [Watch the KNX Ultimate 7 → 8 migration video](https://youtu.be/fpNNi1jZZSc) *(Italian)*
+
 ## Recommended path from version 7
 
 Install KNX Ultimate 7.1.4 first, open any KNX Ultimate node and press **Upgrade to v8**. The guided operation backs up the flows, installs the required HUE/Matter packages, converts compatible nodes, performs and verifies a full Deploy, and installs version 8. Restart the Node-RED service when requested.

package/README.md

@@ -22,6 +22,8 @@ The palette contains KNX Device, KNX Utility, KNX Viewer, KNX IoT Bridge, KNX Mu
 >
 > If version 8 was installed directly from an older v7, restart Node-RED and open the editor: the built-in recovery bridge offers the same protected backup, package installation, conversion and Deploy. Legacy KNX AI nodes still require manual replacement or removal.
 >
+> ▶️ **[Watch the KNX Ultimate 7 → 8 migration video](https://youtu.be/fpNNi1jZZSc)** *(Italian)*
+>
 > **Follow the [upgrade steps](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Migration-8) to keep your flows working.**
 
 ### Native seamless integrations

package/nodes/plugins/knxUltimate-v8-migration-recovery-plugin.html

@@ -1,3 +1,4 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/editorNotifications.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/hueControllerMigration.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "8.0.4",
+  "version": "8.0.5",
   "description": "KNX integration for Node-RED with KNX/IP and KNX Secure, ETS import, routing, diagnostics, automation utilities, MQTT and Modbus adapters. Optional Hue Ultimate and Matter Ultimate packages connect through the KNX gateway.",
   "files": [
     "nodes/",

package/resources/editorNotifications.js

@@ -0,0 +1,101 @@
+/* global RED */
+/* eslint-disable no-undef */
+
+;(function (root, factory) {
+  const api = factory()
+  if (typeof module === 'object' && module.exports) module.exports = api
+  if (root) root.UltimateEditorNotifications = api
+  try {
+    const editor = typeof RED !== 'undefined' ? RED : (root && root.RED)
+    if (editor) api.install(editor)
+  } catch (error) { /* Node-RED will call install when the resource loads again. */ }
+}(typeof globalThis !== 'undefined' ? globalThis : this, function () {
+  'use strict'
+
+  const PATCH_MARKER = '__ultimateCloseButtonPatched'
+  const CLOSE_BUTTON_CLASS = 'ultimate-notification-close'
+
+  const closeLabel = (RED) => {
+    const key = 'common.label.close'
+    try {
+      const translated = RED && typeof RED._ === 'function' ? RED._(key) : undefined
+      if (translated && translated !== key) return translated
+    } catch (error) { /* use the language-neutral fallback below */ }
+    return 'Close'
+  }
+
+  const normalizeOptions = (options, fixed, timeout) => {
+    if (options && typeof options === 'object') return { ...options }
+    const normalized = {}
+    if (options !== undefined && options !== null) normalized.type = options
+    if (fixed !== undefined) normalized.fixed = fixed
+    if (timeout !== undefined) normalized.timeout = timeout
+    return normalized
+  }
+
+  const closesNotification = (button) => {
+    if (!button || typeof button !== 'object') return false
+    if (String(button.class || '').split(/\s+/).includes(CLOSE_BUTTON_CLASS)) return true
+    if (typeof button.click !== 'function') return false
+
+    // Existing project buttons close either the notification directly or a
+    // named close/dismiss helper. Recognising them avoids duplicate buttons.
+    const source = Function.prototype.toString.call(button.click)
+    return /\.close\s*\(|\.dialog\s*\(\s*['"]close['"]|\b(?:close|dismiss)\w*\s*\(/i.test(source)
+  }
+
+  const withCloseButton = (RED, options, getNotification) => {
+    const normalized = { ...options }
+    const buttons = Array.isArray(normalized.buttons) ? normalized.buttons.slice() : []
+    if (!buttons.some(closesNotification)) {
+      buttons.push({
+        text: closeLabel(RED),
+        class: CLOSE_BUTTON_CLASS,
+        click: function () {
+          const notification = getNotification()
+          if (notification && typeof notification.close === 'function') notification.close()
+        }
+      })
+    }
+    normalized.buttons = buttons
+    return normalized
+  }
+
+  const install = (RED) => {
+    if (!RED || typeof RED.notify !== 'function') return false
+    if (RED.notify[PATCH_MARKER]) return true
+
+    const originalNotify = RED.notify
+    const notifyWithClose = function (message, options, fixed, timeout) {
+      const notificationRef = { current: null }
+      const normalized = withCloseButton(
+        RED,
+        normalizeOptions(options, fixed, timeout),
+        () => notificationRef.current
+      )
+      notificationRef.current = originalNotify.call(this, message, normalized)
+      const notification = notificationRef.current
+
+      if (notification && typeof notification.update === 'function' && !notification.update[PATCH_MARKER]) {
+        const originalUpdate = notification.update
+        const updateWithClose = function (updatedMessage, updatedOptions) {
+          const options = typeof updatedOptions === 'number'
+            ? { timeout: updatedOptions }
+            : normalizeOptions(updatedOptions)
+          return originalUpdate.call(this, updatedMessage, withCloseButton(RED, options, () => notification))
+        }
+        Object.defineProperty(updateWithClose, PATCH_MARKER, { value: true })
+        notification.update = updateWithClose
+      }
+
+      return notification
+    }
+
+    Object.defineProperty(notifyWithClose, PATCH_MARKER, { value: true })
+    Object.defineProperty(notifyWithClose, '__ultimateOriginalNotify', { value: originalNotify })
+    RED.notify = notifyWithClose
+    return true
+  }
+
+  return Object.freeze({ install })
+}))