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

package/CHANGELOG.md

@@ -6,16 +6,17 @@
 
 # CHANGELOG
 
-**Version 6.2.3-beta.0** - August 2026<br/>
+**Version 6.2.3-beta.2** - August 2026<br/>
 
-- **HUE Controller — unified Hue API v2 node**: added one controller node covering the complete set of existing Hue functions: lights and grouped lights, plugs, buttons, Tap dial, motion and camera motion, contacts, light level, temperature, humidity, scenes, battery, Zigbee connectivity and device software update. The compact device-function selector uses one third of the available width and opens the established dedicated editor with its localized labels; KNX mapping fields are hidden whenever no **KNX Gateway** is selected, including `none`, an empty value and **Add new...**. The YouTube tutorial playlist now appears once at the top of the editor, while inline `form-tips` are removed from the unified UI and their useful guidance remains in the multilingual help. A local paste-in migration tool converts a complete exported flow from the dedicated HUE node types to HUE Controller without inspecting or changing the open flow, preserving IDs, configuration references, properties, positions, wires and dynamic pin counts in the copyable JSON output. Because Node-RED excludes credentials from flow exports, same-instance migration now omits the referenced Hue and KNX config-node definitions by default while retaining their IDs, so the imported controllers reuse the existing configurations and their stored credentials; an explicit option keeps config nodes for cross-instance migration with a warning to re-enter credentials. Copying the converted flow now uses the asynchronous browser Clipboard API with a real selected-textarea fallback and selects the visible output for manual copying if the browser blocks both paths. Each profile executes the same mature runtime contract, preserving KNX telegram types, Hue event/status direction, flow pins and loop protection. Runtime implementations, editor definitions, templates and all six translation catalogs are embedded as package-internal HUE Controller profiles; registration order no longer matters, the KNX and Hue gateway fields remain real config-node selectors, and the controller has no runtime or editor dependency on deprecated node types. The original Hue Light node remains unchanged. Existing dedicated Hue nodes remain fully compatible and registered, use Node-RED's special `deprecated` category so they no longer appear in the palette, retain the lighter `#E7E9F6` color and `(deprecated)` canvas suffix without changing saved names, and show a localized HUE Controller migration notice at the top of their editors.<br/>
+- **HUE Controller — unified Hue API v2 node**: added one controller node covering the complete set of existing Hue functions: lights and grouped lights, plugs, buttons, Tap dial, motion and camera motion, contacts, light level, temperature, humidity, scenes, battery, Zigbee connectivity and device software update. The compact device-function selector uses one third of the available width and opens the established dedicated editor with its localized labels; KNX mapping fields are hidden whenever no **KNX Gateway** is selected, including `none`, an empty value and **Add new...**. The YouTube tutorial playlist now appears once at the top of the editor, while routine inline `form-tips` are removed from the unified UI and a compact migration privacy disclaimer remains directly below the conversion button. The migration action runs entirely inside the browser and changes only the legacy HUE nodes requiring conversion, preserving every existing property, config reference, group, position and link; no flow or node data leaves the editor and the workspace remains undeployed for user review. After a successful conversion, an editable email draft addressed to the author opens without navigating the top-level Node-RED page and contains only the converted-node count and space for optional notes, while the PayPal donation page opens in a new browser window without flow data in its URL; the user decides whether to send the email and nothing is sent automatically. Each profile executes the same mature runtime contract, preserving KNX telegram types, Hue event/status direction, flow pins and loop protection. Runtime implementations, editor definitions, templates and all six translation catalogs are embedded as package-internal HUE Controller profiles; registration order no longer matters, the KNX and Hue gateway fields remain real config-node selectors, and the controller has no runtime or editor dependency on deprecated node types. The original Hue Light node remains unchanged. Existing dedicated Hue nodes remain fully compatible and registered, use Node-RED's special `deprecated` category so they no longer appear in the palette, retain the lighter `#E7E9F6` color and `(deprecated)` canvas suffix without changing saved names, and show a localized HUE Controller migration notice at the top of their editors.<br/>
 - **HUE Controller — complete per-function help**: the established help of every dedicated Hue node is now incorporated under the corresponding HUE Controller function key, with an anchor index and automatic sidebar focus when the function changes. The same 15-section reference is included in the Controller wiki documentation in EN, IT, DE, FR, ES and zh-CN; legacy deprecation notices are deliberately excluded from the embedded copies.<br/>
 - **HUE Controller — legacy-independent maintenance boundary**: private runtime profiles and the private editor/template/translation sources are now the canonical implementation of HUE Controller. Its generator and consistency check read only those private sources and never inspect the frozen legacy nodes, so future Controller fixes remain isolated and the dedicated deprecated nodes can eventually be removed without breaking either runtime or UI. Added detailed architecture and lifecycle comments around runtime constructor capture, RED facades, editor mounting, profile drafts, dynamic pins, translations and the Hue Light bootstrap path.<br/>
 - **HUE Controller — consolidated documentation**: removed all dedicated legacy Hue nodes from the multilingual documentation home cards and HUE navigation, leaving only Hue Bridge configuration and HUE Controller. Reworked the Controller page in EN, IT, DE, FR, ES and zh-CN with a responsive visual overview, the complete 15-function capability map, common Controller behavior, a four-step setup path, optional-KNX guidance, migration details and the full per-function reference inherited from the former dedicated nodes.<br/>
 - **HUE Controller — visible migration action**: highlighted the legacy-flow migration button with a high-contrast orange treatment, darker hover/active states and an accessible keyboard focus ring so it is immediately recognizable in light and dark Node-RED editor themes.<br/>
 - **HUE Controller documentation routing**: added canonical Jekyll front matter and localized permalinks to every HUE Controller wiki page, fixing the GitHub Pages `404` and restoring correct links between EN, IT, DE, FR, ES and zh-CN.<br/>
 - **Matter documentation visual refresh**: redesigned the Matter Controller, Matter Bridge configuration and Expose KNX to Matter wiki introductions in EN, IT, DE, FR, ES and zh-CN. The responsive visual overviews now surface the controller lifecycle, commissioning and backup workflow, persistent multi-fabric bridge identity, live endpoint reconciliation, the complete 17-profile device map and concise setup paths while retaining the established technical reference below.<br/>
-- **HUE Controller — contextual migration action**: the highlighted legacy-flow migration button now appears in HUE Controller only when the Node-RED editor finds at least one registered legacy HUE node in the current flows, and the same orange action is available directly below the deprecation notice in every dedicated legacy HUE editor. All 15 legacy editors share one delegated dialog implementation and the canonical converter; the read-only Controller scan affects visibility only, while conversion remains isolated from editor state and processes exclusively the flow JSON pasted by the user.<br/>
+- **HUE Controller — contextual migration action**: the highlighted legacy-flow migration button now appears in HUE Controller only when the Node-RED editor finds at least one registered legacy HUE node in the current flows, and the same orange action is available directly below the deprecation notice in every dedicated legacy HUE editor. All 15 legacy editors share one delegated confirmation dialog with the original pale-yellow backup warning before the fully local conversion and a separate safety notice requiring users to inspect every modified HUE node—function, configuration references, pins and wiring—before Deploy. Locked or changed flows and local conversion errors leave the workspace untouched; successful conversion creates one undoable editor change, opens an editable usage email draft without navigating away from Node-RED plus the PayPal donation page in a new browser window, and never deploys or sends email automatically. When these steps finish, a fixed modal Node-RED success message remains visible until the user clicks **OK**.<br/>
+- **HUE Controller — legacy KNX mapping preservation**: fixed asynchronous DPT selectors overwriting an existing value when a converted node was inspected and saved before their options had finished loading. Conversion now treats every GA and DPT already stored by all 15 legacy HUE node types as authoritative and preserves those values unchanged; it does not infer, replace or recover missing DPTs.<br/>
 - **HUE Controller — light capability discovery**: fixed single lights losing their Dim, Tunable White, RGB/HSV and native-effects KNX sections while the embedded Light editor was bootstrapping. Capability discovery now resolves the persisted Hue Bridge configuration instead of Node-RED's temporary `_ADD_` selector sentinel, so Hue API v2 `dimming`, `color_temperature`, `color` and `effects` capabilities enable the corresponding mappings correctly. The legacy Hue Light node remains unchanged.<br/>
 - **HUE Controller — bounded Hue Bridge wait**: restored the Light editor's spinning-hourglass dialog while the selected Hue Bridge is still loading resources. Readiness is polled every 500 ms and the editor is always released after about 10 seconds with a localized error; Save, Cancel, Close and function changes cancel the timer. Removed the Controller wrapper overrides that had forced the wait icon hidden, and replaced the legacy global-`this` timer with strict-mode-safe private state. The legacy Hue Light node remains unchanged.<br/>
 - **HUE Controller — compact KNX rows**: reduced the DPT selector to 90–105 px and the Name field to 70–115 px within Controller mapping rows, keeping GA, DPT and Name on one line instead of wrapping on narrower editor trays. Rows are identified from their strict DPT field IDs after the private profile is mounted, so the scoped layout applies consistently without changing any frozen legacy template or persisted value.<br/>

package/nodes/knxUltimateHueAreaMotion.html

@@ -527,6 +527,7 @@
     <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>

package/nodes/knxUltimateHueBattery.html

@@ -506,6 +506,7 @@
     <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>

package/nodes/knxUltimateHueButton.html

@@ -624,6 +624,7 @@
     <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>

package/nodes/knxUltimateHueCameraMotion.html

@@ -537,6 +537,7 @@
     <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>

package/nodes/knxUltimateHueContactSensor.html

@@ -497,6 +497,7 @@
     <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>

package/nodes/knxUltimateHueController.html

@@ -113,7 +113,15 @@
       if (!$field.length) return currentValue;
       if ($field.is(':checkbox')) return $field.prop('checked');
       if ($field.is(':radio')) return $field.filter(':checked').val();
-      return $field.val();
+      const value = $field.val();
+      // DPT options are loaded asynchronously by the mounted profile. A select
+      // can therefore temporarily have no selected option even though the node
+      // has a valid saved value. Preserve that value when Save is pressed while
+      // the request is still in flight instead of persisting null.
+      if ($field.is('select') && (value === undefined || value === null)) {
+        return currentValue;
+      }
+      return value;
     };
 
     const translateProfileEditor = ($container, controllerType, nodeType) => {
@@ -217,9 +225,8 @@
     };
 
     const editorContainsLegacyHueNodes = () => {
-      // This read-only scan controls visibility only. The converter itself
-      // remains deliberately isolated from the open editor and still accepts
-      // only JSON explicitly pasted by the user.
+      // This read-only scan controls visibility. The shared migration resource
+      // later converts each matching node entirely inside the editor.
       const migrationApi = window.KNXUltimateHueControllerMigration;
       if (!migrationApi || typeof migrationApi.isLegacyHueNode !== 'function') return false;
       if (!RED.nodes || typeof RED.nodes.eachNode !== 'function') return false;
@@ -237,145 +244,18 @@
     };
 
     const openLegacyMigrationDialog = (node) => {
-      const migrationApi = window.KNXUltimateHueControllerMigration;
-      if (!migrationApi || typeof migrationApi.convertLegacyHueFlowJson !== 'function') {
+      const dialogApi = window.KNXUltimateHueControllerMigrationDialog;
+      if (!dialogApi || typeof dialogApi.open !== 'function') {
         RED.notify(migrationText(node, 'migration_unavailable', 'The HUE migration tool is unavailable. Restart Node-RED after updating the package.'), 'error');
         return () => { };
       }
-
-      const $dialog = $('<div class="hue-controller-migration-dialog"></div>').appendTo('body');
-      $('<div class="hue-controller-migration-note"></div>')
-        .text(migrationText(node, 'migration_privacy', 'Paste an exported Node-RED flow. Conversion happens locally and does not modify the open flow.'))
-        .css({ marginBottom: '8px' })
-        .appendTo($dialog);
-      $('<div class="hue-controller-migration-credentials"></div>')
-        .text(migrationText(node, 'migration_credentials_notice', 'Node-RED deliberately excludes keys and passwords from exported flows. The converter cannot read or recreate them.'))
-        .css({ marginBottom: '12px', padding: '8px 10px', borderLeft: '4px solid #d79b00', background: '#fff8df' })
-        .appendTo($dialog);
-      $('<label for="hue-controller-migration-input"></label>')
-        .text(migrationText(node, 'migration_input', 'Original flow JSON'))
-        .css({ display: 'block', fontWeight: 'bold', marginBottom: '4px' })
-        .appendTo($dialog);
-      const $input = $('<textarea id="hue-controller-migration-input"></textarea>')
-        .attr('placeholder', migrationText(node, 'migration_input_placeholder', 'Paste the complete Node-RED flow export here'))
-        .css({ width: '100%', height: '190px', boxSizing: 'border-box', fontFamily: 'monospace', resize: 'vertical' })
-        .appendTo($dialog);
-      const $reuseConfigsRow = $('<div></div>')
-        .css({ margin: '10px 0' })
-        .appendTo($dialog);
-      const $reuseConfigs = $('<input type="checkbox" id="hue-controller-migration-reuse-configs">')
-        .prop('checked', true)
-        .appendTo($reuseConfigsRow);
-      $('<label for="hue-controller-migration-reuse-configs"></label>')
-        .text(` ${migrationText(node, 'migration_reuse_configs', 'Reuse existing Hue and KNX config nodes (recommended)')}`)
-        .css({ display: 'inline', fontWeight: 'bold' })
-        .appendTo($reuseConfigsRow);
-      $('<div></div>')
-        .text(migrationText(node, 'migration_reuse_configs_help', 'Keep this selected when importing back into the same Node-RED installation. Referenced config nodes are omitted from the result, so their stored credentials remain untouched.'))
-        .css({ margin: '4px 0 0 22px', color: '#666' })
-        .appendTo($reuseConfigsRow);
-      const $toolbar = $('<div></div>')
-        .css({ display: 'flex', gap: '8px', alignItems: 'center', margin: '10px 0' })
-        .appendTo($dialog);
-      const $convert = $('<button type="button" class="red-ui-button"></button>')
-        .append($('<i class="fa fa-exchange"></i>'))
-        .append(document.createTextNode(` ${migrationText(node, 'migration_convert', 'Convert')}`))
-        .appendTo($toolbar);
-      const $copy = $('<button type="button" class="red-ui-button"></button>')
-        .append($('<i class="fa fa-clipboard"></i>'))
-        .append(document.createTextNode(` ${migrationText(node, 'migration_copy', 'Copy converted flow')}`))
-        .prop('disabled', true)
-        .appendTo($toolbar);
-      const $status = $('<span class="hue-controller-migration-status"></span>')
-        .css({ marginLeft: '4px' })
-        .appendTo($toolbar);
-      $('<label for="hue-controller-migration-output"></label>')
-        .text(migrationText(node, 'migration_output', 'Converted flow JSON'))
-        .css({ display: 'block', fontWeight: 'bold', marginBottom: '4px' })
-        .appendTo($dialog);
-      const $output = $('<textarea id="hue-controller-migration-output" readonly></textarea>')
-        .css({ width: '100%', height: '230px', boxSizing: 'border-box', fontFamily: 'monospace', resize: 'vertical' })
-        .appendTo($dialog);
-
-      $convert.on('click.knxUltimateHueControllerMigration', () => {
-        try {
-          const result = migrationApi.convertLegacyHueFlowJson($input.val(), {
-            reuseConfigNodes: $reuseConfigs.prop('checked')
-          });
-          $output.val(result.json).scrollTop(0);
-          $copy.prop('disabled', false);
-          if (result.convertedCount === 0) {
-            $status.text(migrationText(node, 'migration_none', 'No legacy HUE nodes were found.')).css('color', '#a15c00');
-          } else {
-            let summary = migrationText(node, 'migration_summary', '{{count}} legacy HUE nodes converted.')
-              .replace('{{count}}', String(result.convertedCount));
-            let statusColor = '#1b7d33';
-            if (result.omittedConfigCount > 0) {
-              summary += ` ${migrationText(node, 'migration_summary_reused', '{{count}} referenced config nodes will be reused with their existing credentials.')
-                .replace('{{count}}', String(result.omittedConfigCount))}`;
-            } else if (!$reuseConfigs.prop('checked')) {
-              summary += ` ${migrationText(node, 'migration_configs_included_warning', 'Config nodes are included without exported credentials; enter their keys and passwords after import.')}`;
-              statusColor = '#a15c00';
-            }
-            $status.text(summary).css('color', statusColor);
-          }
-        } catch (error) {
-          $output.val('');
-          $copy.prop('disabled', true);
-          const message = error && error.message ? error.message : String(error);
-          $status
-            .text(`${migrationText(node, 'migration_invalid', 'Invalid flow JSON:')} ${message}`)
-            .css('color', '#b00020');
-        }
-      });
-
-      $copy.on('click.knxUltimateHueControllerMigration', () => {
-        const convertedJson = $output.val();
-        if (!convertedJson) return;
-        $copy.prop('disabled', true);
-        migrationApi.copyTextToClipboard(convertedJson, {
-          navigator: window.navigator,
-          document: window.document
-        }).then(() => {
-          RED.notify(migrationText(node, 'migration_copy_success', 'Converted flow copied.'), 'success');
-        }).catch(() => {
-          const outputElement = $output.get(0);
-          if (outputElement) {
-            outputElement.focus();
-            outputElement.select();
-            if (typeof outputElement.setSelectionRange === 'function') {
-              outputElement.setSelectionRange(0, convertedJson.length);
-            }
-          }
-          RED.notify(migrationText(node, 'migration_copy_failed', 'Clipboard access was blocked. The converted JSON has been selected; copy it manually.'), 'error');
-        }).finally(() => {
-          $copy.prop('disabled', false);
-        });
-      });
-
-      let closed = false;
-      const closeDialog = () => {
-        if (closed) return;
-        closed = true;
-        $convert.off('.knxUltimateHueControllerMigration');
-        $copy.off('.knxUltimateHueControllerMigration');
-        try { $dialog.dialog('destroy'); } catch (error) { /* empty */ }
-        $dialog.remove();
-      };
-
-      $dialog.dialog({
-        modal: true,
-        width: Math.min(920, Math.max(620, $(window).width() - 80)),
-        height: Math.min(760, Math.max(600, $(window).height() - 60)),
-        title: migrationText(node, 'migration_title', 'Convert legacy HUE flow'),
-        close: closeDialog,
-        buttons: [{
-          text: migrationText(node, 'migration_close', 'Close'),
-          click() { $(this).dialog('close'); }
-        }]
+      return dialogApi.open({
+        RED,
+        $,
+        windowObject: window,
+        documentObject: document,
+        translate: (key, fallback, values) => migrationText(node, key, fallback, values)
       });
-      setTimeout(() => $input.trigger('focus'), 0);
-      return closeDialog;
     };
 
     RED.nodes.registerType('knxUltimateHueController', {
@@ -651,6 +531,7 @@
       <i class="fa fa-exchange"></i>
       <span data-i18n="knxUltimateHueController.migration_button"></span>
     </button>
+    <div class="form-tips hue-controller-migration-disclaimer" style="margin-top:8px;" data-i18n="knxUltimateHueController.migration_disclaimer"></div>
   </div>
   <div class="form-row">
     <label for="node-input-server">
@@ -717,7 +598,7 @@ Node-RED intentionally excludes credentials from flow exports. When importing in
 
 Each function uses its private mature runtime contract. Hue events remain status updates and are never reflected to Hue or KNX as new commands unless the selected function explicitly maps them to a KNX output. The Controller owns its Light implementation without modifying the original legacy Hue Light node.
 
-Dedicated legacy HUE nodes remain registered for existing flows, but are frozen and receive no new features or maintenance updates. Node-RED hides their special `deprecated` category from the palette, while existing instances remain editable, deployable, lighter than HUE Controller and visibly marked `(deprecated)` on the canvas. They also show a migration notice at the top of their editor. Use HUE Controller for new work or migrate them with the paste-in converter.
+Dedicated legacy HUE nodes remain registered for existing flows, but are frozen and receive no new features or maintenance updates. Node-RED hides their special `deprecated` category from the palette, while existing instances remain editable, deployable, lighter than HUE Controller and visibly marked `(deprecated)` on the canvas. They also show a migration notice at the top of their editor. Use HUE Controller for new work or migrate them with the fully local conversion button; afterwards, the browser opens an editable usage email draft without navigating away from Node-RED and opens the donation page in a new browser window. The email is never sent automatically. Before Deploy, inspect every modified HUE node and verify its function, configuration references, pins and wiring. A fixed Node-RED completion message remains visible until you click **OK**.
 
 When no **KNX Gateway** is selected (including **none** and **Add new...**), the KNX mapping fields are hidden. Hue resource selection and flow-only options remain available.
 
@@ -727,7 +608,7 @@ While the Hue Bridge is still loading its resources, the Light editor displays a
 
 Changing **Device function** changes the visible editor and the node pin layout. After saving, reopen the node to verify the selected resource and mappings.
 
-KNX mapping rows keep GA, DPT and Name on one line. DPT selectors use a compact fixed range, while Name fields are shorter and may contract further on a narrow editor tray without changing their stored text.
+KNX mapping rows keep GA, DPT and Name on one line. DPT selectors use a compact fixed range, while Name fields are shorter and may contract further on a narrow editor tray without changing their stored text. Saved DPT values are retained while selector options load asynchronously.
 
 <!-- HUE_CONTROLLER_PROFILE_HELP_START -->
 

package/nodes/knxUltimateHueHumiditySensor.html

@@ -507,6 +507,7 @@
     <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>

package/nodes/knxUltimateHueLight.html

@@ -1769,6 +1769,7 @@
     <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>

package/nodes/knxUltimateHueLightSensor.html

@@ -495,6 +495,7 @@
     <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>

package/nodes/knxUltimateHueMotion.html

@@ -499,6 +499,7 @@
     <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>

package/nodes/knxUltimateHuePlug.html

@@ -437,6 +437,7 @@
     <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>

package/nodes/knxUltimateHueScene.html

@@ -778,6 +778,7 @@
     <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>

package/nodes/knxUltimateHueTapDial.html

@@ -506,6 +506,7 @@
     <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>

package/nodes/knxUltimateHueTemperatureSensor.html

@@ -498,6 +498,7 @@
     <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>

package/nodes/knxUltimateHueZigbeeConnectivity.html

@@ -506,6 +506,7 @@
     <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>

package/nodes/knxUltimateHuedevice_software_update.html

@@ -511,6 +511,7 @@
     <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>

package/nodes/locales/de/knxUltimateHueAreaMotion.html

@@ -1,5 +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 in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
+<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.

package/nodes/locales/de/knxUltimateHueBattery.html

@@ -1,5 +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 in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
+<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,5 +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 in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
+<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,5 +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 in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
+<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,5 +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 in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
+<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.

package/nodes/locales/de/knxUltimateHueController.html

@@ -3,16 +3,15 @@
 <p><strong>HUE Controller</strong> ist der einheitliche Knoten für Hue-API-v2-Ressourcen.</p>
 <p>Wählen Sie die Gerätefunktion und konfigurieren Sie anschließend dieselbe KNX-Zuordnung und dasselbe Verhalten wie im bewährten dedizierten Hue-Knoten.</p>
 <p>Die Auswahl der Gerätefunktion verwendet ein Drittel der verfügbaren Breite, damit der Editor kompakt bleibt.</p>
-<p>KNX-Zuordnungszeilen halten GA, DPT und Name in einer Zeile. DPT-Auswahl und Namensfeld verwenden kompakte Breiten; das Namensfeld kann sich in schmalen Editoren weiter verkleinern, ohne den gespeicherten Text zu ändern.</p>
+<p>KNX-Zuordnungszeilen halten GA, DPT und Name in einer Zeile. DPT-Auswahl und Namensfeld verwenden kompakte Breiten; das Namensfeld kann sich in schmalen Editoren weiter verkleinern, ohne den gespeicherten Text zu ändern. Gespeicherte DPT-Werte bleiben erhalten, während die Auswahloptionen asynchron geladen werden.</p>
 <p>Unterstützt werden Leuchten und Leuchtengruppen, Steckdosen, Taster, Tap dial, Bewegungs- und Kamerabewegungsressourcen, Kontakte, Lichtstärke, Temperatur, Luftfeuchtigkeit, Szenen, Batterie, Zigbee-Verbindung und Softwareupdate.</p>
 <p>Wenn kein <strong>KNX-Gateway</strong> ausgewählt ist (einschließlich <code>none</code> und <em>Neu hinzufügen...</em>), werden die KNX-Zuordnungsfelder ausgeblendet; die Auswahl der Hue-Ressource und reine Flow-Optionen bleiben verfügbar.</p>
 <p>Bei einer einzelnen Leuchte richten sich die Bereiche <strong>Dimmen</strong>, <strong>Abstimmbares Weiß</strong>, <strong>RGB/HSV</strong> und native Effekte nach den Live-Fähigkeiten der ausgewählten Hue-API-v2-Ressource. Die zugehörigen KNX-Zuordnungen erscheinen automatisch, wenn die Leuchte <code>dimming</code>, <code>color_temperature</code> oder <code>color</code> bereitstellt.</p>
 <p>Während die Hue Bridge ihre Ressourcen lädt, zeigt der Leuchteneditor eine animierte Sanduhr und prüft die Bereitschaft alle 500 ms. Nach etwa 10 Sekunden wird der Editor freigegeben, die Zuordnungsregister bleiben verborgen und ein lokalisierter Fehler wird angezeigt. Speichern, Schließen oder ein Funktionswechsel beendet die ausstehende Wartezeit.</p>
 <p>Wenn ein Gateway ausgewählt ist, akzeptieren die Zuordnungsfelder eine KNX-Gruppenadresse oder einen importierten ETS-Namen; passende Datenpunkte werden von diesem Gateway geladen.</p>
-<p>Der Migrationsbutton wird nur angezeigt, wenn der Node-RED-Editor mindestens einen Legacy-HUE-Knoten in den aktuellen Flows erkennt. Derselbe orange Button steht auch direkt unter dem Deprecated-Hinweis in jedem Legacy-HUE-Editor bereit. Diese Prüfung ist schreibgeschützt; die Konvertierung verwendet weiterhin ausschließlich das vom Benutzer eingefügte JSON.</p>
-<p><strong>Legacy-HUE-Flow konvertieren</strong> akzeptiert einen vollständigen Node-RED-Flow-Export und liefert kopierbares JSON, in dem jeder unterstützte Legacy-HUE-Knoten durch HUE Controller ersetzt ist. Die Konvertierung erfolgt lokal und behält IDs, Konfigurationsreferenzen, Eigenschaften, Positionen und Verbindungen bei; der geöffnete Flow wird nicht verändert.</p>
-<p>Node-RED schließt Zugangsdaten absichtlich aus Flow-Exporten aus. Lassen Sie beim Import in dieselbe Installation <strong>Vorhandene Hue- und KNX-Konfigurationsknoten wiederverwenden</strong> aktiviert: Die referenzierten Konfigurationsobjekte werden ausgelassen, ihre IDs bleiben jedoch in den konvertierten Knoten erhalten, sodass vorhandene Schlüssel und Passwörter unverändert bleiben. Deaktivieren Sie die Option nur für eine andere Installation und geben Sie dort die Zugangsdaten nach dem Import erneut ein.</p>
-<p><strong>Konvertierten Flow kopieren</strong> verwendet die Clipboard API des Browsers und als Fallback ein temporäres Textfeld. Wenn beide Methoden blockiert werden, wird das Ausgabe-JSON für das manuelle Kopieren markiert.</p>
+<p>Der Migrationsbutton wird nur angezeigt, wenn der Node-RED-Editor mindestens einen Legacy-HUE-Knoten in den aktuellen Flows erkennt. Derselbe orange Button steht unter dem Deprecated-Hinweis in jedem Legacy-HUE-Editor bereit.</p>
+<p><strong>Legacy-HUE-Knoten konvertieren</strong> führt die gesamte Konvertierung im Browser aus und sendet keinerlei Flow- oder Knotendaten. Nach erfolgreicher lokaler Konvertierung öffnet der Browser einen bearbeitbaren E-Mail-Entwurf an den Autor, ohne Node-RED zu verlassen, und die Spendenseite in einem neuen Browserfenster. Der Entwurf enthält nur die Anzahl konvertierter Knoten und Platz für optionale Hinweise; er wird niemals automatisch gesendet und dem PayPal-Link werden keine Flow-Daten hinzugefügt.</p>
+<p>Exportieren Sie vor dem Start eine Sicherung Ihrer Flows. Der Editor ändert ausschließlich die erkannten Legacy-HUE-Knoten in HUE-Controller-Instanzen. Vorhandene Eigenschaften, Konfigurationsreferenzen, Positionen, Gruppen und Verbindungen bleiben unverändert. Der Flow wird als geändert markiert, aber nicht automatisch deployt: Prüfen Sie ihn und klicken Sie selbst auf <strong>Deploy</strong>. Bei einem geänderten Knoten, einem gesperrten Flow oder einem lokalen Konvertierungsfehler bleibt der Flow unverändert. <strong>Sicherheitsprüfung:</strong> Prüfen Sie vor dem Deploy jeden geänderten HUE-Knoten einschließlich Funktion, Konfigurationsreferenzen, Ein-/Ausgangsanschlüssen und Verbindungen. Nach Abschluss bleibt eine feste Node-RED-Meldung sichtbar, bis Sie auf <strong>OK</strong> klicken.</p>
 <p>Hue-Ereignisse bleiben Statusaktualisierungen und werden nicht zu neuen Hue-Befehlen. HUE Controller enthält private Profile für Runtime, Editor, Vorlagen und Übersetzungen und ist daher nicht vom Laden der veralteten Knotentypen abhängig. Der ursprüngliche Hue-Light-Knoten bleibt unverändert. Die dedizierten Hue-Knoten bleiben für bestehende Flows registriert, sind jedoch eingefroren und erhalten keine neuen Funktionen oder Wartungsupdates. Node-RED blendet ihre spezielle Kategorie <code>deprecated</code> aus der Palette aus; vorhandene Instanzen bleiben bearbeitbar und einsatzfähig, verwenden eine hellere Farbe als HUE Controller, sind auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet und zeigen oben im Editor einen Migrationshinweis.</p>
 
 <!-- HUE_CONTROLLER_PROFILE_HELP_START -->

package/nodes/locales/de/knxUltimateHueController.json

@@ -6,26 +6,25 @@
   "knxUltimateHueController": {
     "device_function": "Gerätefunktion",
     "legacy_node_notice": "Dieser Legacy-HUE-Knoten ist veraltet. Verwenden Sie für neue Flows den neuen HUE Controller-Knoten.",
-    "migration_button": "Legacy-HUE-Flow konvertieren",
-    "migration_button_title": "Einen Node-RED-Flow einfügen und seine Legacy-HUE-Knoten konvertieren",
-    "migration_title": "Legacy-HUE-Flow konvertieren",
-    "migration_privacy": "Fügen Sie einen exportierten Node-RED-Flow ein. Die Konvertierung erfolgt lokal und ändert den geöffneten Flow nicht.",
-    "migration_credentials_notice": "Node-RED schließt Schlüssel und Passwörter absichtlich aus exportierten Flows aus. Der Konverter kann sie weder lesen noch wiederherstellen.",
-    "migration_reuse_configs": "Vorhandene Hue- und KNX-Konfigurationsknoten wiederverwenden (empfohlen)",
-    "migration_reuse_configs_help": "Lassen Sie diese Option aktiviert, wenn Sie in dieselbe Node-RED-Installation importieren. Referenzierte Konfigurationsknoten werden aus dem Ergebnis entfernt, sodass ihre gespeicherten Zugangsdaten unverändert bleiben.",
-    "migration_input": "JSON des ursprünglichen Flows",
-    "migration_input_placeholder": "Vollständigen Node-RED-Flow-Export hier einfügen",
-    "migration_convert": "Konvertieren",
-    "migration_copy": "Konvertierten Flow kopieren",
-    "migration_output": "JSON des konvertierten Flows",
-    "migration_close": "Schließen",
-    "migration_summary": "{{count}} Legacy-HUE-Knoten konvertiert.",
-    "migration_summary_reused": "{{count}} referenzierte Konfigurationsknoten werden mit ihren vorhandenen Zugangsdaten wiederverwendet.",
-    "migration_configs_included_warning": "Konfigurationsknoten sind ohne exportierte Zugangsdaten enthalten; geben Sie Schlüssel und Passwörter nach dem Import erneut ein.",
+    "migration_button": "Legacy-HUE-Knoten konvertieren",
+    "migration_button_title": "Alle Legacy-HUE-Knoten im Editor konvertieren",
+    "migration_disclaimer": "Die Konvertierung erfolgt vollständig im Browser. Es werden keinerlei Flow- oder Knotendaten versendet. Anschließend öffnen sich ein bearbeitbarer E-Mail-Entwurf und die Spendenseite in einem neuen Fenster; nichts wird automatisch gesendet und dem PayPal-Link werden keine Flow-Daten hinzugefügt.",
+    "migration_title": "Legacy-HUE-Knoten konvertieren",
+    "migration_confirm": "{{count}} Legacy-HUE-Knoten werden direkt im Editor konvertiert.",
+    "migration_privacy": "Die Konvertierung erfolgt vollständig in diesem Browser. Es werden keine Flow-, Knoten-, Konfigurations-, Zugangs-, Gruppenadress- oder Verbindungsdaten übertragen oder gespeichert.",
+    "migration_email_notice": "Nach der Konvertierung öffnet Ihre E-Mail-Anwendung einen bearbeitbaren Entwurf an den Autor, ohne die Node-RED-Seite zu verlassen, und ein neues Browserfenster öffnet die Spendenseite. Der Entwurf enthält nur die Anzahl der konvertierten Knoten und Platz für optionale Hinweise; nichts wird automatisch gesendet und dem PayPal-Link werden keine Flow-Daten hinzugefügt.",
+    "migration_email_subject": "KNX Ultimate - Legacy-HUE-Konvertierung verwendet",
+    "migration_email_body": "Hallo Massimo,\n\nich habe die Konvertierungsschaltfläche für Legacy-HUE-Knoten verwendet.\nKonvertierte Legacy-HUE-Knoten: {{count}}.\n\nOptionale Hinweise:\n",
+    "migration_email_failed": "Die Knoten wurden konvertiert, aber der E-Mail-Entwurf konnte nicht geöffnet werden.",
+    "migration_donation_failed": "Die Knoten wurden konvertiert, aber die Spendenseite konnte nicht geöffnet werden.",
+    "migration_deploy_notice": "Exportieren Sie vor dem Fortfahren eine Sicherung Ihrer Flows. Der aktuelle Editor wird geschlossen. Nur Legacy-HUE-Knoten werden geändert; Konfigurationsknoten und Verbindungen bleiben unverändert. Prüfen Sie das Ergebnis und klicken Sie anschließend selbst auf Deploy.",
+    "migration_review_notice": "Sicherheitsprüfung: Prüfen Sie nach der Konvertierung jeden geänderten HUE-Knoten im Flow. Kontrollieren Sie vor dem Deploy die gewählte Funktion, Konfigurationsreferenzen, Ein-/Ausgangsanschlüsse und Verbindungen.",
+    "migration_convert": "HUE-Knoten konvertieren",
+    "migration_close": "Abbrechen",
+    "migration_ok": "OK",
+    "migration_success": "Vorgang abgeschlossen. {{count}} Legacy-HUE-Knoten wurden konvertiert. Prüfen Sie vor dem Deploy jeden geänderten Knoten einschließlich Funktion, Konfiguration, Anschlüssen und Verbindungen.",
+    "migration_failed": "Lokale HUE-Migration fehlgeschlagen; der Flow wurde nicht geändert:",
     "migration_none": "Keine Legacy-HUE-Knoten gefunden.",
-    "migration_invalid": "Ungültiges Flow-JSON:",
-    "migration_copy_success": "Konvertierter Flow kopiert.",
-    "migration_copy_failed": "Der Zugriff auf die Zwischenablage wurde blockiert. Das konvertierte JSON wurde markiert; kopieren Sie es manuell.",
     "migration_unavailable": "Das HUE-Migrationswerkzeug ist nicht verfügbar. Starten Sie Node-RED nach der Paketaktualisierung neu.",
     "types": {
       "light": "Leuchte / Leuchtengruppe",

package/nodes/locales/de/knxUltimateHueHumiditySensor.html

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueHumiditySensor">
-<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 in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
+<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 Knoten liest die relative Luftfeuchtigkeit (%) von einem HUE-Sensor und überträgt sie auf KNX.</p>
 
 Beginne im GA-Feld (Name oder Gruppenadresse) zu tippen, um die KNX-GA zu verknüpfen; während der Eingabe werden passende Geräte angezeigt.

package/nodes/locales/de/knxUltimateHueLight.html

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueLight">
-<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 in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
+<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 steuert HUE-Leuchten (einzeln oder gruppiert) und ordnet Befehle/Zustände KNX-Gruppenadressen zu.</p>
 
 **Allgemein**

package/nodes/locales/de/knxUltimateHueLightSensor.html

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueLightSensor">
-<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 in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
+<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 liest Lux-Ereignisse eines HUE-Lichtsensors und spiegelt sie nach KNX.</p>
 
 Es wird die Umgebungshelligkeit (Lux) bei Änderungen ausgegeben. Im GA-Feld den KNX-Gerätenamen oder die GA eingeben (Autocomplete), um die GA zu verknüpfen.