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

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueScene">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 **Hue Scene** 节点将 Hue 场景发布到 KNX，并且可以把 Hue 的原始事件发送到 Node-RED 流程。场景字段支持自动补全；在网桥中新增场景后，请点击刷新图标更新列表。
 
 ### 选项卡概览

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueTapDial">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 **Hue Tap Dial** 节点将 Tap Dial 的旋转服务映射到 KNX，并把原始 Hue 事件发送到 Node-RED 流程。配对新设备后，请点击设备字段旁的刷新图标。
 
 ### 选项卡

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueTemperatureSensor">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>此节点读取 HUE 温度传感器的温度（°C），并将其映射到 KNX。</p>
 
 在 GA 字段（名称或组地址）中输入以关联 KNX GA；输入时会显示设备建议。

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueZigbeeConnectivity">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>该节点从 HUE 设备读取 Zigbee 连接状态，并发布到 KNX。</p>
 
 在 GA 字段输入 KNX 设备名或组地址，输入时会自动联想。

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHuedevice_software_update">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>该节点监控 HUE 设备的软件更新状态，并发布到 KNX。</p>
 
 开始在GA字段中键入KNX设备的名称或组地址，可用的设备开始显示

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.2.3-beta.2",
+  "version": "6.2.3-beta.3",
   "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/hueControllerMigrationDialog.js

@@ -12,6 +12,7 @@
 
   const EVENT_NAMESPACE = '.knxUltimateHueControllerMigrationDialog'
   const BUTTON_SELECTOR = '.hue-legacy-migrate-flow'
+  const BUTTON_STYLE_ID = 'knxUltimateHueLegacyMigrationButtonStyle'
   const I18N_PREFIX = 'node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.'
   let closeActiveDialog = function () {}
 
@@ -35,28 +36,38 @@
     if ($cancel.length) $cancel.trigger('click')
   }
 
-  function reserveDonationWindow (windowObject) {
-    try {
-      if (!windowObject || typeof windowObject.open !== 'function') return undefined
-      const donationWindow = windowObject.open('', '_blank')
-      if (donationWindow) {
-        try { donationWindow.opener = null } catch (error) { /* best-effort isolation */ }
-      }
-      return donationWindow
-    } catch (error) {
-      return undefined
-    }
+  function ensureLegacyButtonStyle ($) {
+    if ($(`#${BUTTON_STYLE_ID}`).length) return
+    $('<style></style>')
+      .attr('id', BUTTON_STYLE_ID)
+      .text(`
+        .hue-legacy-migrate-flow.red-ui-button,
+        .hue-legacy-migrate-flow.red-ui-button:hover,
+        .hue-legacy-migrate-flow.red-ui-button:active,
+        .hue-legacy-migrate-flow.red-ui-button:focus,
+        .hue-legacy-migrate-flow.red-ui-button > i,
+        .hue-legacy-migrate-flow.red-ui-button > span {
+          color: #ffffff !important;
+        }
+      `)
+      .appendTo('head')
   }
 
-  function closeDonationWindow (donationWindow) {
+  function openDonationPage (RED, translate, windowObject, donationUrl) {
     try {
-      if (donationWindow && typeof donationWindow.close === 'function') donationWindow.close()
-    } catch (error) { /* best effort after a failed conversion */ }
+      if (!windowObject || typeof windowObject.open !== 'function') throw new Error('Browser window opening is unavailable')
+      const donationWindow = windowObject.open(donationUrl, '_blank', 'noopener,noreferrer')
+      if (!donationWindow) throw new Error('The browser blocked the donation window')
+    } catch (error) {
+      if (RED && typeof RED.notify === 'function') {
+        RED.notify(translate('migration_donation_failed', 'The donation page could not be opened. You can try again.'), 'warning')
+      }
+    }
   }
 
-  function showCompletionMessage (RED, translate, convertedCount) {
+  function showCompletionMessage (RED, translate, convertedCount, windowObject, donationUrl) {
     if (!RED || typeof RED.notify !== 'function') return
-    const message = translate('migration_success', 'Process finished. {{count}} legacy HUE nodes were converted. Inspect every modified node, including its function, configuration, pins and wiring, before clicking Deploy.')
+    const message = translate('migration_success', 'Process finished. {{count}} legacy HUE nodes were converted. Inspect every modified node, including its function, configuration, pins and wiring, before clicking Deploy. If this conversion saved you time, you can support the continued development of KNX Ultimate with the optional button below.')
       .replace('{{count}}', String(convertedCount))
     let notification
     try {
@@ -64,13 +75,22 @@
         modal: true,
         fixed: true,
         type: 'success',
-        buttons: [{
-          text: translate('migration_ok', 'OK'),
-          class: 'primary',
-          click () {
-            if (notification && typeof notification.close === 'function') notification.close()
+        buttons: [
+          {
+            text: translate('migration_donate', 'Support KNX Ultimate ❤️'),
+            class: 'hue-controller-migration-donate',
+            click () {
+              openDonationPage(RED, translate, windowObject, donationUrl)
+            }
+          },
+          {
+            text: translate('migration_ok', 'OK'),
+            class: 'primary',
+            click () {
+              if (notification && typeof notification.close === 'function') notification.close()
+            }
           }
-        }]
+        ]
       })
     } catch (error) { /* the conversion is already complete */ }
   }
@@ -114,7 +134,7 @@
       .css({ marginBottom: '10px', padding: '8px 10px', borderLeft: '4px solid #2980b9', background: '#eaf4fb' })
       .appendTo($dialog)
     $('<div class="hue-controller-migration-email"></div>')
-      .text(translate('migration_email_notice', 'After conversion, your email app will open an editable draft addressed to the author without navigating away from Node-RED, and a new browser window will open the donation page. The draft contains only the number of converted nodes and space for optional notes; nothing is sent automatically and no flow data is added to the donation link.'))
+      .text(translate('migration_email_notice', 'After conversion, your email app will open an editable draft addressed to the author without navigating away from Node-RED. The draft contains only the number of converted nodes and space for optional notes; nothing is sent automatically. The final Node-RED message will offer an optional button to support KNX Ultimate.'))
       .css({ marginBottom: '10px' })
       .appendTo($dialog)
     $('<div class="form-tips hue-controller-migration-backup"></div>')
@@ -144,10 +164,8 @@
       if (running) return
       running = true
       $convert.prop('disabled', true)
-      let donationWindow
       try {
         migrationApi.createLocalMigrationPatches(legacyNodes)
-        donationWindow = reserveDonationWindow(windowObject)
         closeDialog()
         closeEditorTray(RED, $)
         windowObject.setTimeout(() => {
@@ -155,23 +173,10 @@
           try {
             convertedCount = migrationApi.applyLocalMigration(RED, legacyNodes)
           } catch (error) {
-            closeDonationWindow(donationWindow)
             const message = error && error.message ? error.message : String(error)
             RED.notify(`${translate('migration_failed', 'HUE migration failed; the flow was not changed:')} ${message}`, 'error')
             return
           }
-          try {
-            if (donationWindow && !donationWindow.closed && donationWindow.location) {
-              donationWindow.location.href = migrationApi.MIGRATION_DONATION_URL
-            } else if (typeof windowObject.open === 'function') {
-              const opened = windowObject.open(migrationApi.MIGRATION_DONATION_URL, '_blank', 'noopener,noreferrer')
-              if (!opened) throw new Error('The browser blocked the donation window')
-            } else {
-              throw new Error('Browser window opening is unavailable')
-            }
-          } catch (error) {
-            RED.notify(translate('migration_donation_failed', 'The nodes were converted, but the donation page could not be opened.'), 'warning')
-          }
           try {
             const mailto = migrationApi.createUsageMailto(convertedCount, {
               subject: translate('migration_email_subject', 'KNX Ultimate - legacy HUE conversion used'),
@@ -184,10 +189,9 @@
           } catch (error) {
             RED.notify(translate('migration_email_failed', 'The nodes were converted, but the email draft could not be opened.'), 'warning')
           }
-          showCompletionMessage(RED, translate, convertedCount)
+          showCompletionMessage(RED, translate, convertedCount, windowObject, migrationApi.MIGRATION_DONATION_URL)
         }, 0)
       } catch (error) {
-        closeDonationWindow(donationWindow)
         running = false
         $convert.prop('disabled', false)
         const message = error && error.message ? error.message : String(error)
@@ -222,6 +226,7 @@
 
   function installLegacyButton (RED, $, windowObject, documentObject) {
     if (!RED || !$ || !documentObject) return
+    ensureLegacyButtonStyle($)
     const $document = $(documentObject)
     $document.off(`click${EVENT_NAMESPACE}`, BUTTON_SELECTOR)
     $document.on(`click${EVENT_NAMESPACE}`, BUTTON_SELECTOR, (event) => {