node-red-contrib-knx-ultimate 6.2.2 → 6.2.3-beta.1

package/nodes/knxUltimateHueController.js

@@ -0,0 +1,28 @@
+'use strict'
+
+const { setupHueControllerRuntime } = require('./utils/hueControllerProfileAdapter')
+
+module.exports = function (RED) {
+  // Keep the public wrapper intentionally boring. Device-specific behavior lives
+  // in the Controller-owned private profiles; this file owns only selection,
+  // startup containment and the single public Node-RED registration.
+  function knxUltimateHueController (config) {
+    try {
+      // The selected profile performs RED.nodes.createNode itself. Calling it
+      // here as a constructor-on-this preserves its complete, proven lifecycle.
+      setupHueControllerRuntime(RED, this, config)
+    } catch (error) {
+      // If a profile cannot start, still create a valid Node-RED node and surface
+      // the operational failure without allowing it to stop the runtime.
+      // Avoid a second createNode call when the profile failed after creating it.
+      if (!this.id) RED.nodes.createNode(this, config)
+      const message = error && error.message ? error.message : String(error)
+      RED.log.error(`knxUltimateHueController: ${message}`)
+      this.status({ fill: 'red', shape: 'dot', text: message })
+      this.error(message)
+    }
+  }
+
+  // This is the only registration produced by the Controller architecture.
+  RED.nodes.registerType('knxUltimateHueController', knxUltimateHueController)
+}

package/nodes/knxUltimateHueHumiditySensor.html

@@ -352,8 +352,8 @@
     };
 
     RED.nodes.registerType('knxUltimateHueHumiditySensor', {
-      category: 'KNX Ultimate HUE',
-      color: '#C0C7E9',
+      category: 'deprecated',
+      color: '#E7E9F6',
       defaults: {
         server: { type: 'knxUltimate-config', required: false },
         serverHue: { type: 'hue-config', required: true },
@@ -372,9 +372,9 @@
       outputs: 1,
       icon: 'node-hue-icon.svg',
       label() {
-        return this.name || 'Hue Humidity Sensor';
+        return `${this.name || 'Hue Humidity Sensor'} (deprecated)`;
       },
-      paletteLabel: 'Hue Humidity Sensor',
+      paletteLabel: 'Hue Humidity Sensor (deprecated)',
       oneditprepare() {
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
@@ -499,6 +499,16 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateHueHumiditySensor">
+  <div class="form-row hue-legacy-controller-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:14px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true" style="color:#a15c00; margin-right:6px;"></i>
+    <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.legacy_node_notice"></span>
+  </div>
+  <div class="form-row hue-legacy-migration-action" style="margin-top:-6px; margin-bottom:14px;">
+    <button type="button" class="red-ui-button hue-legacy-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff; font-weight:700;" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button_title">
+      <i class="fa fa-exchange"></i> <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button"></span>
+    </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_disclaimer"></div>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -583,6 +593,8 @@
 </script>
 
 <script type="text/markdown" data-help-name="knxUltimateHueHumiditySensor">
+> **Deprecated:** This dedicated HUE node remains available for existing flows. Use **HUE Controller** for new work. The legacy node is marked `(deprecated)` in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice.
+
 <p>This node reads relative humidity (%) from a HUE humidity sensor and maps it to KNX.</p>
 
 Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.

package/nodes/knxUltimateHueLight.html

@@ -8,8 +8,8 @@
   (function () {
 
     RED.nodes.registerType("knxUltimateHueLight", {
-      category: "KNX Ultimate HUE",
-      color: "#C0C7E9",
+      category: "deprecated",
+      color: "#E7E9F6",
       defaults: {
         //buttonState: {value: true},
         server: { type: "knxUltimate-config", required: false },
@@ -136,9 +136,9 @@
       outputs: 0,
       icon: "node-hue-icon.svg",
       label: function () {
-        return this.name || "Hue Light/Outlet";
+        return `${this.name || "Hue Light/Outlet"} (deprecated)`;
       },
-      paletteLabel: "Hue Light/Outlet",
+      paletteLabel: "Hue Light/Outlet (deprecated)",
       oneditprepare: function () {
         // Go to the help panel
         try {
@@ -1761,6 +1761,16 @@
 
 
 <script type="text/html" data-template-name="knxUltimateHueLight">
+  <div class="form-row hue-legacy-controller-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:14px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true" style="color:#a15c00; margin-right:6px;"></i>
+    <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.legacy_node_notice"></span>
+  </div>
+  <div class="form-row hue-legacy-migration-action" style="margin-top:-6px; margin-bottom:14px;">
+    <button type="button" class="red-ui-button hue-legacy-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff; font-weight:700;" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button_title">
+      <i class="fa fa-exchange"></i> <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button"></span>
+    </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_disclaimer"></div>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -2370,6 +2380,8 @@
 
 
 <script type="text/markdown" data-help-name="knxUltimateHueLight">
+> **Deprecated:** This dedicated HUE node remains available for existing flows. Use **HUE Controller** for new work. The legacy node is marked `(deprecated)` in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice.
+
 <p>This node controls Philips Hue lights (single or grouped) and maps their commands/states to KNX.</p>
 
 **General**

package/nodes/knxUltimateHueLightSensor.html

@@ -347,8 +347,8 @@
     };
 
     RED.nodes.registerType('knxUltimateHueLightSensor', {
-      category: 'KNX Ultimate HUE',
-      color: '#C0C7E9',
+      category: 'deprecated',
+      color: '#E7E9F6',
       defaults: {
         server: { type: 'knxUltimate-config', required: false },
         serverHue: { type: 'hue-config', required: true },
@@ -365,9 +365,9 @@
       outputs: 1,
       icon: 'node-hue-icon.svg',
       label() {
-        return this.name || 'Hue Light Sensor';
+        return `${this.name || 'Hue Light Sensor'} (deprecated)`;
       },
-      paletteLabel: 'Hue Light Sensor',
+      paletteLabel: 'Hue Light Sensor (deprecated)',
       oneditprepare() {
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
@@ -487,6 +487,16 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateHueLightSensor">
+  <div class="form-row hue-legacy-controller-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:14px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true" style="color:#a15c00; margin-right:6px;"></i>
+    <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.legacy_node_notice"></span>
+  </div>
+  <div class="form-row hue-legacy-migration-action" style="margin-top:-6px; margin-bottom:14px;">
+    <button type="button" class="red-ui-button hue-legacy-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff; font-weight:700;" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button_title">
+      <i class="fa fa-exchange"></i> <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button"></span>
+    </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_disclaimer"></div>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -576,6 +586,8 @@
 
 
 <script type="text/markdown" data-help-name="knxUltimateHueLightSensor">
+> **Deprecated:** This dedicated HUE node remains available for existing flows. Use **HUE Controller** for new work. The legacy node is marked `(deprecated)` in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice.
+
 <p>This node reads lux events from a Hue Light Sensor and maps them to KNX.</p>
 
 It emits the ambient illuminance (lux) each time it changes. Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.

package/nodes/knxUltimateHueMotion.html

@@ -358,8 +358,8 @@
     };
 
     RED.nodes.registerType('knxUltimateHueMotion', {
-      category: 'KNX Ultimate HUE',
-      color: '#C0C7E9',
+      category: 'deprecated',
+      color: '#E7E9F6',
       defaults: {
         server: { type: 'knxUltimate-config', required: false },
         serverHue: { type: 'hue-config', required: true },
@@ -375,9 +375,9 @@
       outputs: 1,
       icon: 'node-hue-icon.svg',
       label() {
-        return this.name || RED._('node-red-contrib-knx-ultimate/knxUltimateHueMotion:knxUltimateHueMotion.paletteLabel');
+        return `${this.name || RED._('node-red-contrib-knx-ultimate/knxUltimateHueMotion:knxUltimateHueMotion.paletteLabel')} (deprecated)`;
       },
-      paletteLabel: 'Hue Motion',
+      paletteLabel: 'Hue Motion (deprecated)',
       oneditprepare() {
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
@@ -491,6 +491,16 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateHueMotion">
+  <div class="form-row hue-legacy-controller-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:14px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true" style="color:#a15c00; margin-right:6px;"></i>
+    <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.legacy_node_notice"></span>
+  </div>
+  <div class="form-row hue-legacy-migration-action" style="margin-top:-6px; margin-bottom:14px;">
+    <button type="button" class="red-ui-button hue-legacy-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff; font-weight:700;" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button_title">
+      <i class="fa fa-exchange"></i> <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button"></span>
+    </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_disclaimer"></div>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -571,6 +581,8 @@
 
 
 <script type="text/markdown" data-help-name="knxUltimateHueMotion">
+> **Deprecated:** This dedicated HUE node remains available for existing flows. Use **HUE Controller** for new work. The legacy node is marked `(deprecated)` in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice.
+
 <p>This node listens to a Hue motion sensor and mirrors the events to KNX and/or your Node-RED flow.</p>
 
 Start typing the KNX device name or Group Address in the GA field; suggestions appear while you type. Hit the refresh button next to "Hue sensor” to reload the device list from the bridge if you add new sensors.

package/nodes/knxUltimateHuePlug.html

@@ -119,8 +119,8 @@
     };
 
     RED.nodes.registerType('knxUltimateHuePlug', {
-      category: 'KNX Ultimate HUE',
-      color: '#C0C7E9',
+      category: 'deprecated',
+      color: '#E7E9F6',
       defaults: {
         server: { type: 'knxUltimate-config', required: false },
         serverHue: { type: 'hue-config', required: true },
@@ -151,9 +151,9 @@
       outputs: 0,
       icon: 'node-hue-icon.svg',
       label() {
-        return this.name || 'Hue Plug/Outlet';
+        return `${this.name || 'Hue Plug/Outlet'} (deprecated)`;
       },
-      paletteLabel: 'Hue Plug/Outlet',
+      paletteLabel: 'Hue Plug/Outlet (deprecated)',
       oneditprepare() {
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
@@ -429,6 +429,16 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateHuePlug">
+  <div class="form-row hue-legacy-controller-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:14px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true" style="color:#a15c00; margin-right:6px;"></i>
+    <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.legacy_node_notice"></span>
+  </div>
+  <div class="form-row hue-legacy-migration-action" style="margin-top:-6px; margin-bottom:14px;">
+    <button type="button" class="red-ui-button hue-legacy-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff; font-weight:700;" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button_title">
+      <i class="fa fa-exchange"></i> <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button"></span>
+    </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_disclaimer"></div>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -543,4 +553,6 @@
 </script>
 
 <script type="text/markdown" data-help-name="knxUltimateHuePlug">
+> **Deprecated:** This dedicated HUE node remains available for existing flows. Use **HUE Controller** for new work. The legacy node is marked `(deprecated)` in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice.
+
 </script>

package/nodes/knxUltimateHueScene.html

@@ -512,8 +512,8 @@
     };
 
     RED.nodes.registerType('knxUltimateHueScene', {
-      category: 'KNX Ultimate HUE',
-      color: '#C0C7E9',
+      category: 'deprecated',
+      color: '#E7E9F6',
       defaults: {
         server: { type: 'knxUltimate-config', required: false },
         serverHue: { type: 'hue-config', required: true },
@@ -540,12 +540,12 @@
       outputs: 0,
       icon: 'node-hue-icon.svg',
       label() {
-        if (this.selectedModeTabNumber === undefined) return this.name;
-        if (Number(this.selectedModeTabNumber) === 0) return this.name || this.namescene || 'Hue Scene';
-        if (Number(this.selectedModeTabNumber) === 1) return this.namesceneMulti || this.name || 'Hue Scene';
-        return this.name || 'Hue Scene';
+        let nodeLabel = this.name;
+        if (Number(this.selectedModeTabNumber) === 0) nodeLabel = this.name || this.namescene || 'Hue Scene';
+        if (Number(this.selectedModeTabNumber) === 1) nodeLabel = this.namesceneMulti || this.name || 'Hue Scene';
+        return `${nodeLabel || 'Hue Scene'} (deprecated)`;
       },
-      paletteLabel: 'Hue Scene',
+      paletteLabel: 'Hue Scene (deprecated)',
       oneditprepare() {
         const node = this;
         try {
@@ -770,6 +770,16 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateHueScene">
+  <div class="form-row hue-legacy-controller-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:14px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true" style="color:#a15c00; margin-right:6px;"></i>
+    <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.legacy_node_notice"></span>
+  </div>
+  <div class="form-row hue-legacy-migration-action" style="margin-top:-6px; margin-bottom:14px;">
+    <button type="button" class="red-ui-button hue-legacy-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff; font-weight:700;" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button_title">
+      <i class="fa fa-exchange"></i> <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button"></span>
+    </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_disclaimer"></div>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -900,6 +910,8 @@
 
 
 <script type="text/markdown" data-help-name="knxUltimateHueScene">
+> **Deprecated:** This dedicated HUE node remains available for existing flows. Use **HUE Controller** for new work. The legacy node is marked `(deprecated)` in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice.
+
 The **Hue Scene** node exposes Hue scenes to KNX and can forward the raw Hue events to a Node-RED flow. The scene field supports autocomplete; use the refresh icon after adding scenes on the bridge so the list stays up to date.
 
 ### Tabs at a glance

package/nodes/knxUltimateHueTapDial.html

@@ -365,8 +365,8 @@
     };
 
     RED.nodes.registerType('knxUltimateHueTapDial', {
-      category: 'KNX Ultimate HUE',
-      color: '#C0C7E9',
+      category: 'deprecated',
+      color: '#E7E9F6',
       defaults: {
         server: { type: 'knxUltimate-config', required: false },
         serverHue: { type: 'hue-config', required: true },
@@ -382,9 +382,9 @@
       outputs: 1,
       icon: 'node-hue-icon.svg',
       label() {
-        return this.name || RED._('node-red-contrib-knx-ultimate/knxUltimateHueTapDial:knxUltimateHueTapDial.paletteLabel');
+        return `${this.name || RED._('node-red-contrib-knx-ultimate/knxUltimateHueTapDial:knxUltimateHueTapDial.paletteLabel')} (deprecated)`;
       },
-      paletteLabel: 'Hue Tap Dial',
+      paletteLabel: 'Hue Tap Dial (deprecated)',
       oneditprepare() {
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
@@ -498,6 +498,16 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateHueTapDial">
+  <div class="form-row hue-legacy-controller-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:14px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true" style="color:#a15c00; margin-right:6px;"></i>
+    <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.legacy_node_notice"></span>
+  </div>
+  <div class="form-row hue-legacy-migration-action" style="margin-top:-6px; margin-bottom:14px;">
+    <button type="button" class="red-ui-button hue-legacy-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff; font-weight:700;" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button_title">
+      <i class="fa fa-exchange"></i> <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button"></span>
+    </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_disclaimer"></div>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -578,6 +588,8 @@
 
 
 <script type="text/markdown" data-help-name="knxUltimateHueTapDial">
+> **Deprecated:** This dedicated HUE node remains available for existing flows. Use **HUE Controller** for new work. The legacy node is marked `(deprecated)` in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice.
+
 The **Hue Tap Dial** node maps the rotary service of the Hue Tap Dial to KNX and forwards the raw Hue events to your flow. Use the refresh icon beside the device field after pairing a new dial on the bridge.
 
 ### Tabs

package/nodes/knxUltimateHueTemperatureSensor.html

@@ -350,8 +350,8 @@
     };
 
     RED.nodes.registerType('knxUltimateHueTemperatureSensor', {
-      category: 'KNX Ultimate HUE',
-      color: '#C0C7E9',
+      category: 'deprecated',
+      color: '#E7E9F6',
       defaults: {
         server: { type: 'knxUltimate-config', required: false },
         serverHue: { type: 'hue-config', required: true },
@@ -368,9 +368,9 @@
       outputs: 1,
       icon: 'node-hue-icon.svg',
       label() {
-        return this.name || RED._('node-red-contrib-knx-ultimate/knxUltimateHueTemperatureSensor:knxUltimateHueTemperatureSensor.paletteLabel');
+        return `${this.name || RED._('node-red-contrib-knx-ultimate/knxUltimateHueTemperatureSensor:knxUltimateHueTemperatureSensor.paletteLabel')} (deprecated)`;
       },
-      paletteLabel: 'Hue Temperature Sensor',
+      paletteLabel: 'Hue Temperature Sensor (deprecated)',
       oneditprepare() {
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
@@ -490,6 +490,16 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateHueTemperatureSensor">
+  <div class="form-row hue-legacy-controller-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:14px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true" style="color:#a15c00; margin-right:6px;"></i>
+    <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.legacy_node_notice"></span>
+  </div>
+  <div class="form-row hue-legacy-migration-action" style="margin-top:-6px; margin-bottom:14px;">
+    <button type="button" class="red-ui-button hue-legacy-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff; font-weight:700;" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button_title">
+      <i class="fa fa-exchange"></i> <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button"></span>
+    </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_disclaimer"></div>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -579,6 +589,8 @@
 
 
 <script type="text/markdown" data-help-name="knxUltimateHueTemperatureSensor">
+> **Deprecated:** This dedicated HUE node remains available for existing flows. Use **HUE Controller** for new work. The legacy node is marked `(deprecated)` in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice.
+
 <p>This node reads temperature (°C) from a Hue temperature sensor and maps it to KNX.</p>
 
 Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.

package/nodes/knxUltimateHueZigbeeConnectivity.html

@@ -359,8 +359,8 @@
     };
 
     RED.nodes.registerType('knxUltimateHueZigbeeConnectivity', {
-      category: 'KNX Ultimate HUE',
-      color: '#C0C7E9',
+      category: 'deprecated',
+      color: '#E7E9F6',
       defaults: {
         server: { type: 'knxUltimate-config', required: false },
         serverHue: { type: 'hue-config', required: true },
@@ -377,9 +377,9 @@
       outputs: 1,
       icon: 'node-hue-icon.svg',
       label() {
-        return this.name || RED._('node-red-contrib-knx-ultimate/knxUltimateHueZigbeeConnectivity:knxUltimateHueZigbeeConnectivity.paletteLabel');
+        return `${this.name || RED._('node-red-contrib-knx-ultimate/knxUltimateHueZigbeeConnectivity:knxUltimateHueZigbeeConnectivity.paletteLabel')} (deprecated)`;
       },
-      paletteLabel: 'Hue Zigbee Connectivity',
+      paletteLabel: 'Hue Zigbee Connectivity (deprecated)',
       oneditprepare() {
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
@@ -498,6 +498,16 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateHueZigbeeConnectivity">
+  <div class="form-row hue-legacy-controller-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:14px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true" style="color:#a15c00; margin-right:6px;"></i>
+    <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.legacy_node_notice"></span>
+  </div>
+  <div class="form-row hue-legacy-migration-action" style="margin-top:-6px; margin-bottom:14px;">
+    <button type="button" class="red-ui-button hue-legacy-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff; font-weight:700;" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button_title">
+      <i class="fa fa-exchange"></i> <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button"></span>
+    </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_disclaimer"></div>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -587,6 +597,8 @@
 
 
 <script type="text/markdown" data-help-name="knxUltimateHueZigbeeConnectivity">
+> **Deprecated:** This dedicated HUE node remains available for existing flows. Use **HUE Controller** for new work. The legacy node is marked `(deprecated)` in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice.
+
 <p>This node retrieves the Zigbee connectivity status from a Hue device and exposes it to KNX.</p>
 
 Start typing the KNX device name or Group Address in the GA field; suggestions appear while you type.

package/nodes/knxUltimateHuedevice_software_update.html

@@ -364,8 +364,8 @@
     };
 
     RED.nodes.registerType('knxUltimateHuedevice_software_update', {
-      category: 'KNX Ultimate HUE',
-      color: '#C0C7E9',
+      category: 'deprecated',
+      color: '#E7E9F6',
       defaults: {
         server: { type: 'knxUltimate-config', required: false },
         serverHue: { type: 'hue-config', required: true },
@@ -382,9 +382,9 @@
       outputs: 1,
       icon: 'node-hue-icon.svg',
       label() {
-        return this.name || RED._('node-red-contrib-knx-ultimate/knxUltimateHuedevice_software_update:knxUltimateHuedevice_software_update.paletteLabel');
+        return `${this.name || RED._('node-red-contrib-knx-ultimate/knxUltimateHuedevice_software_update:knxUltimateHuedevice_software_update.paletteLabel')} (deprecated)`;
       },
-      paletteLabel: 'Hue Software Update',
+      paletteLabel: 'Hue Software Update (deprecated)',
       oneditprepare() {
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
@@ -503,6 +503,16 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateHuedevice_software_update">
+  <div class="form-row hue-legacy-controller-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:14px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true" style="color:#a15c00; margin-right:6px;"></i>
+    <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.legacy_node_notice"></span>
+  </div>
+  <div class="form-row hue-legacy-migration-action" style="margin-top:-6px; margin-bottom:14px;">
+    <button type="button" class="red-ui-button hue-legacy-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff; font-weight:700;" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button_title">
+      <i class="fa fa-exchange"></i> <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_button"></span>
+    </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.migration_disclaimer"></div>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -592,6 +602,8 @@
 
 
 <script type="text/markdown" data-help-name="knxUltimateHuedevice_software_update">
+> **Deprecated:** This dedicated HUE node remains available for existing flows. Use **HUE Controller** for new work. The legacy node is marked `(deprecated)` in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice.
+
 <p>This node monitors whether a selected Hue device has a software update available and publishes the status to KNX.</p>
 
 Start typing the name or group address of your KNX device in the GA field, the avaiable devices start showing up while

package/nodes/locales/de/knxUltimateHueAreaMotion.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueAreaMotion">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton konvertiert alle Legacy-HUE-Knoten lokal; anschließend öffnet er einen bearbeitbaren E-Mail-Entwurf und die Spendenseite in einem neuen Browserfenster. Die E-Mail wird niemals automatisch gesendet. Nach Abschluss des Vorgangs bleibt eine feste Node-RED-Meldung sichtbar, bis Sie auf OK klicken.</p>
 <p>Der Hue Bewegungsbereich-Node lauscht auf MotionAware-Bereichsereignisse (Hue Bridge Pro) und spiegelt den aggregierten Bewegung / keine-Bewegung-Status nach KNX bzw. in Ihren Node-RED-Flow.</p>
 
 Geben Sie im GA-Feld (Name oder Gruppenadresse) die gewünschte KNX-GA ein; passende Einträge werden während der Eingabe vorgeschlagen.
@@ -33,4 +34,3 @@ Geben Sie im GA-Feld (Name oder Gruppenadresse) die gewünschte KNX-GA ein; pass
 
 `msg.payload` enthält den von MotionAware gelieferten, aggregierten Bewegungsstatus des ausgewählten Bereichs.
 </script>
-

package/nodes/locales/de/knxUltimateHueBattery.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueBattery">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton konvertiert alle Legacy-HUE-Knoten lokal; anschließend öffnet er einen bearbeitbaren E-Mail-Entwurf und die Spendenseite in einem neuen Browserfenster. Die E-Mail wird niemals automatisch gesendet. Nach Abschluss des Vorgangs bleibt eine feste Node-RED-Meldung sichtbar, bis Sie auf OK klicken.</p>
 <p>Dieser Node spiegelt den Batteriestand eines Hue-Geräts nach KNX und löst Ereignisse aus, sobald sich der Wert ändert.</p>
 
 Im GA-Feld den KNX-Gerätenamen oder die Gruppenadresse eingeben; beim Tippen erscheinen Vorschläge. Über das Aktualisieren-Symbol neben "Hue Sensor" lässt sich die Geräteliste der Hue-Bridge neu laden.

package/nodes/locales/de/knxUltimateHueButton.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueButton">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton konvertiert alle Legacy-HUE-Knoten lokal; anschließend öffnet er einen bearbeitbaren E-Mail-Entwurf und die Spendenseite in einem neuen Browserfenster. Die E-Mail wird niemals automatisch gesendet. Nach Abschluss des Vorgangs bleibt eine feste Node-RED-Meldung sichtbar, bis Sie auf OK klicken.</p>
 <p>Der Hue-Taster-Node spiegelt Hue-Taster-Ereignisse auf KNX und den Flow-Ausgang und nutzt das Attribut <code>button.button_report.event</code>.</p>
 
 Tippen Sie im GA-Feld (Name oder Gruppenadresse), um die KNX-GA zu verknüpfen; passende Einträge erscheinen während der Eingabe.

package/nodes/locales/de/knxUltimateHueCameraMotion.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueCameraMotion">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton konvertiert alle Legacy-HUE-Knoten lokal; anschließend öffnet er einen bearbeitbaren E-Mail-Entwurf und die Spendenseite in einem neuen Browserfenster. Die E-Mail wird niemals automatisch gesendet. Nach Abschluss des Vorgangs bleibt eine feste Node-RED-Meldung sichtbar, bis Sie auf OK klicken.</p>
 <p>Der Hue Camera Motion Node lauscht auf Bewegungsereignisse der Philips-Hue-Kameras und spiegelt den erkannt/nicht-erkannt-Status in KNX.</p>
 
 Geben Sie im GA-Feld (Name oder Gruppenadresse) den gewünschten Wert ein; passende Geräte werden während der Eingabe vorgeschlagen.

package/nodes/locales/de/knxUltimateHueContactSensor.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueContactSensor">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton konvertiert alle Legacy-HUE-Knoten lokal; anschließend öffnet er einen bearbeitbaren E-Mail-Entwurf und die Spendenseite in einem neuen Browserfenster. Die E-Mail wird niemals automatisch gesendet. Nach Abschluss des Vorgangs bleibt eine feste Node-RED-Meldung sichtbar, bis Sie auf OK klicken.</p>
 <p>Dieser Node leitet Ereignisse eines HUE-Kontaktsensors weiter und ordnet sie KNX-Gruppenadressen zu.</p>
 
 Tippen Sie in das Feld GA, die Name oder die Gruppenadresse Ihres KNX -Geräts, die avabaren Geräte werden beim Eingeben angezeigt.