node-red-contrib-knx-ultimate 7.1.4 → 8.0.2

package/nodes/knxUltimateMatterBridge.html

@@ -1,689 +0,0 @@
-<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/11f26b4500.js"></script>
-<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
-
-<script type="text/javascript">
-  (function () {
-    // GA fields of each virtual device type.
-    // dir 'command' = Matter -> KNX (GA written on assistant commands), 'status' = KNX -> Matter.
-    const TYPE_FIELDS = {
-      onofflight: [
-        { key: 'OnOff', labelKey: 'fn_onoff_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'OnOffStatus', labelKey: 'fn_onoff_status', dptPrefix: '1.', fallbackDpt: '1.001' }
-      ],
-      onoffplug: [
-        { key: 'OnOff', labelKey: 'fn_onoff_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'OnOffStatus', labelKey: 'fn_onoff_status', dptPrefix: '1.', fallbackDpt: '1.001' }
-      ],
-      dimmablelight: [
-        { key: 'OnOff', labelKey: 'fn_onoff_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'OnOffStatus', labelKey: 'fn_onoff_status', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'Level', labelKey: 'fn_level_cmd', dptPrefix: '5.', fallbackDpt: '5.001' },
-        { key: 'LevelStatus', labelKey: 'fn_level_status', dptPrefix: '5.', fallbackDpt: '5.001' }
-      ],
-      rgblight: [
-        { key: 'OnOff', labelKey: 'fn_onoff_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'OnOffStatus', labelKey: 'fn_onoff_status', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'Level', labelKey: 'fn_level_cmd', dptPrefix: '5.', fallbackDpt: '5.001' },
-        { key: 'LevelStatus', labelKey: 'fn_level_status', dptPrefix: '5.', fallbackDpt: '5.001' },
-        { key: 'RGB', labelKey: 'fn_rgb_cmd', dptPrefix: '232.', fallbackDpt: '232.600' },
-        { key: 'RGBStatus', labelKey: 'fn_rgb_status', dptPrefix: '232.', fallbackDpt: '232.600' }
-      ],
-      colortemperaturelight: [
-        { key: 'OnOff', labelKey: 'fn_onoff_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'OnOffStatus', labelKey: 'fn_onoff_status', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'Level', labelKey: 'fn_level_cmd', dptPrefix: '5.', fallbackDpt: '5.001' },
-        { key: 'LevelStatus', labelKey: 'fn_level_status', dptPrefix: '5.', fallbackDpt: '5.001' },
-        { key: 'CT', labelKey: 'fn_ct_cmd', dptPrefix: '7.', fallbackDpt: '7.600' },
-        { key: 'CTStatus', labelKey: 'fn_ct_status', dptPrefix: '7.', fallbackDpt: '7.600' }
-      ],
-      temperaturesensor: [{ key: 'Status', labelKey: 'fn_sensor_ga', dptPrefix: '9.', fallbackDpt: '9.001' }],
-      humiditysensor: [{ key: 'Status', labelKey: 'fn_sensor_ga', dptPrefix: '9.', fallbackDpt: '9.007' }],
-      lightsensor: [{ key: 'Status', labelKey: 'fn_sensor_ga', dptPrefix: '9.', fallbackDpt: '9.004' }],
-      occupancysensor: [{ key: 'Status', labelKey: 'fn_sensor_ga', dptPrefix: '1.', fallbackDpt: '1.011' }],
-      contactsensor: [{ key: 'Status', labelKey: 'fn_sensor_ga', dptPrefix: '1.', fallbackDpt: '1.002' }],
-      windowcovering: [
-        { key: 'UpDown', labelKey: 'fn_updown', dptPrefix: '1.', fallbackDpt: '1.008' },
-        { key: 'Stop', labelKey: 'fn_stop', dptPrefix: '1.', fallbackDpt: '1.017' },
-        { key: 'Position', labelKey: 'fn_position_cmd', dptPrefix: '5.', fallbackDpt: '5.001' },
-        { key: 'PositionStatus', labelKey: 'fn_position_status', dptPrefix: '5.', fallbackDpt: '5.001' }
-      ],
-      thermostat: [
-        { key: 'CurrentTemp', labelKey: 'fn_currenttemp', dptPrefix: '9.', fallbackDpt: '9.001' },
-        { key: 'Setpoint', labelKey: 'fn_setpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
-        { key: 'SetpointStatus', labelKey: 'fn_setpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' },
-        { key: 'CoolingSetpoint', labelKey: 'fn_coolingsetpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
-        { key: 'CoolingSetpointStatus', labelKey: 'fn_coolingsetpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' }
-      ],
-      roomairconditioner: [
-        { key: 'OnOff', labelKey: 'fn_onoff_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'OnOffStatus', labelKey: 'fn_onoff_status', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'CurrentTemp', labelKey: 'fn_currenttemp', dptPrefix: '9.', fallbackDpt: '9.001' },
-        { key: 'Setpoint', labelKey: 'fn_setpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
-        { key: 'SetpointStatus', labelKey: 'fn_setpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' },
-        { key: 'CoolingSetpoint', labelKey: 'fn_coolingsetpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
-        { key: 'CoolingSetpointStatus', labelKey: 'fn_coolingsetpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' },
-        { key: 'FanSpeed', labelKey: 'fn_fanspeed_cmd', dptPrefix: '5.', fallbackDpt: '5.001' },
-        { key: 'FanSpeedStatus', labelKey: 'fn_fanspeed_status', dptPrefix: '5.', fallbackDpt: '5.001' }
-      ],
-      doorlock: [
-        { key: 'Lock', labelKey: 'fn_lock_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
-        { key: 'LockStatus', labelKey: 'fn_lock_status', dptPrefix: '1.', fallbackDpt: '1.001' }
-      ],
-      smokecoalarm: [
-        { key: 'Smoke', labelKey: 'fn_smoke_ga', dptPrefix: '1.', fallbackDpt: '1.005' },
-        { key: 'CO', labelKey: 'fn_co_ga', dptPrefix: '1.', fallbackDpt: '1.005' }
-      ],
-      waterleakdetector: [{ key: 'Status', labelKey: 'fn_leak_ga', dptPrefix: '1.', fallbackDpt: '1.005' }],
-      airqualitysensor: [{ key: 'Status', labelKey: 'fn_co2_ga', dptPrefix: '9.', fallbackDpt: '9.008' }],
-      fan: [
-        { key: 'FanSpeed', labelKey: 'fn_fanspeed_cmd', dptPrefix: '5.', fallbackDpt: '5.001' },
-        { key: 'FanSpeedStatus', labelKey: 'fn_fanspeed_status', dptPrefix: '5.', fallbackDpt: '5.001' }
-      ],
-      robotvacuum: [] // Flow-only: no GA fields, controlled via the node PINs
-    };
-    const TYPE_ORDER = ['onofflight', 'dimmablelight', 'rgblight', 'colortemperaturelight', 'onoffplug', 'windowcovering', 'thermostat', 'roomairconditioner', 'fan', 'doorlock', 'temperaturesensor', 'humiditysensor', 'lightsensor', 'occupancysensor', 'contactsensor', 'smokecoalarm', 'waterleakdetector', 'airqualitysensor', 'robotvacuum'];
-    const FLOW_HELP = {
-      onofflight: { input: [['onoff', true]], output: [['onoff', true]] },
-      onoffplug: { input: [['onoff', true]], output: [['onoff', true]] },
-      dimmablelight: { input: [['onoff', true], ['level', 50]], output: [['onoff', true], ['level', 50]] },
-      rgblight: { input: [['onoff', true], ['level', 50], ['rgb', { red: 255, green: 80, blue: 20 }]], output: [['onoff', true], ['level', 50], ['rgb', { red: 255, green: 80, blue: 20 }]] },
-      colortemperaturelight: { input: [['onoff', true], ['level', 50], ['colortemp', 3000]], output: [['onoff', true], ['level', 50], ['colortemp', 3000]] },
-      temperaturesensor: { input: [['temperature', 21.5]], output: [] },
-      humiditysensor: { input: [['humidity', 45]], output: [] },
-      lightsensor: { input: [['illuminance', 500]], output: [] },
-      occupancysensor: { input: [['occupancy', true]], output: [] },
-      contactsensor: { input: [['contact', true]], output: [] },
-      windowcovering: { input: [['position', 35]], output: [['updown', false], ['position', 35], ['stop', true]] },
-      thermostat: { input: [['currenttemp', 21.5], ['setpoint', 21], ['coolingsetpoint', 24]], output: [['setpoint', 21], ['coolingsetpoint', 24]] },
-      roomairconditioner: { input: [['onoff', true], ['currenttemp', 25.5], ['setpoint', 21], ['coolingsetpoint', 24], ['fanspeed', 60]], output: [['onoff', true], ['setpoint', 21], ['coolingsetpoint', 24], ['fanspeed', 60]] },
-      doorlock: { input: [['lock', true]], output: [['lock', true]] },
-      smokecoalarm: { input: [['smoke', true], ['co', true]], output: [] },
-      waterleakdetector: { input: [['leak', true]], output: [] },
-      airqualitysensor: { input: [['co2', 850]], output: [] },
-      fan: { input: [['fanspeed', 60]], output: [['fanspeed', 60]] },
-      robotvacuum: {
-        input: [['rvcstate', 'charging'], ['rvcmode', 'idle']],
-        output: [['rvccommand', 'gohome'], ['rvccommand', 'pause'], ['rvccommand', 'resume'], ['rvcmode', 'cleaning']]
-      }
-    };
-
-    // Every GA/DPT key across all types, used to declare the node defaults.
-    const ALL_KEYS = [];
-    Object.keys(TYPE_FIELDS).forEach((t) => TYPE_FIELDS[t].forEach((f) => { if (ALL_KEYS.indexOf(f.key) === -1) ALL_KEYS.push(f.key); }));
-    const gaDefaults = {
-      server: { type: 'knxUltimate-config', required: false },
-      serverMatterBridge: { type: 'matterbridge-config', required: true },
-      name: { value: '' },
-      deviceType: { value: 'onofflight' },
-      invertPosition: { value: false },
-      coverSwapOpenClose: { value: false },
-      coverSliderDebounceMs: { value: 0 },
-      commandDedupMs: { value: 1200 },
-      turnOnBehavior: { value: 'ignoreLevelAfterOn' },
-      ignoreLevelAfterOnMs: { value: 800 },
-      coverUpdateMode: { value: 'optimistic' },
-      coverStatusTimeoutMs: { value: 3000 },
-      readStatusAtStartup: { value: 'yes' },
-      enableNodePINS: { value: 'no' },
-      outputs: { value: 0 },
-      inputs: { value: 0 }
-    };
-    ALL_KEYS.forEach((key) => {
-      gaDefaults['ga' + key] = { value: '' };
-      gaDefaults['dpt' + key] = { value: '' };
-    });
-
-    RED.nodes.registerType('knxUltimateMatterBridge', {
-      category: 'KNX Ultimate',
-      color: '#8FB1FA',
-      defaults: gaDefaults,
-      inputs: 0,
-      outputs: 0,
-      icon: 'node-matter-bridge-icon.svg',
-      label() {
-        return this.name || 'Expose KNX to Matter';
-      },
-      paletteLabel: 'Expose KNX to Matter',
-      oneditprepare() {
-        try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
-        const node = this;
-
-        // Keep the same left-hand vertical tab orientation as Matter Controller.
-        if ($('#knxUltimateMatterControllerDeviceVerticalTabs').length === 0) {
-          $('head').append(`
-            <style id="knxUltimateMatterControllerDeviceVerticalTabs">
-              .hue-vertical-tabs.ui-tabs.ui-widget.ui-widget-content.ui-corner-all {
-                display: flex;
-                border: none;
-                padding: 0;
-              }
-              .hue-vertical-tabs > ul.ui-tabs-nav {
-                flex: 0 0 180px;
-                border-right: 1px solid #ccc;
-                border-left: none;
-                border-top: none;
-                border-bottom: none;
-                padding: 0.5em 0.3em;
-              }
-              .hue-vertical-tabs > ul.ui-tabs-nav li {
-                float: none;
-                width: 100%;
-                margin: 0 0 2px 0;
-              }
-              .hue-vertical-tabs > ul.ui-tabs-nav li a {
-                display: block;
-                width: 100%;
-                white-space: normal;
-                position: relative;
-                border-bottom: none !important;
-              }
-              .hue-vertical-tabs > ul.ui-tabs-nav li.ui-tabs-active {
-                border-bottom: none !important;
-              }
-              .hue-vertical-tabs > ul.ui-tabs-nav li.ui-tabs-active a::after {
-                content: "";
-                position: absolute;
-                left: 0;
-                bottom: 0;
-                width: 50%;
-                height: 3px;
-                background: currentColor;
-              }
-              .hue-vertical-tabs .ui-tabs-panel {
-                flex: 1;
-                padding: 0.8em 1em;
-                box-sizing: border-box;
-                border: none;
-                background: transparent;
-              }
-              .hue-vertical-tabs .form-row > dt {
-                flex: 1 1 auto;
-                margin: 0;
-              }
-              .hue-vertical-tabs hr {
-                width: 100%;
-                border: 0;
-                border-top: 1px solid #ccc;
-                margin: 8px 0;
-              }
-              .matter-bridge-flow-help-table {
-                width: 100%;
-                border-collapse: collapse;
-                margin-bottom: 12px;
-              }
-              .matter-bridge-flow-help-table th,
-              .matter-bridge-flow-help-table td {
-                border-bottom: 1px solid #ddd;
-                padding: 7px 6px;
-                text-align: left;
-                vertical-align: top;
-              }
-              .matter-bridge-flow-help-table code {
-                white-space: pre-wrap;
-                word-break: break-word;
-              }
-              .matter-bridge-flow-help-copy {
-                white-space: nowrap;
-              }
-            </style>`);
-        }
-        const $tabs = $('#mb-tabs');
-        $tabs.addClass('hue-vertical-tabs');
-        $tabs.tabs();
-        $tabs.find('ul').addClass('ui-tabs-nav');
-        $tabs.find('li').removeClass('ui-corner-top').addClass('ui-corner-left');
-
-        // Resolves the KNX gateway at query time: the selected one, or - as a
-        // fallback - the first knxUltimate-config available, so the GA list works
-        // even before the user picks the gateway on this device node.
-        const findKnxGateway = () => {
-          let srv = null;
-          try {
-            const val = $('#node-input-server').val();
-            if (val && val !== '_ADD_') srv = RED.nodes.node(val);
-          } catch (error) { /* empty */ }
-          if (!srv) {
-            try {
-              RED.nodes.eachConfig((c) => { if (!srv && c.type === 'knxUltimate-config') srv = c; });
-            } catch (error) { /* empty */ }
-          }
-          return srv;
-        };
-
-        // Auto-select the KNX gateway when there is only one, sparing the user a click per device node
-        try {
-          const cur = $('#node-input-server').val();
-          if (!cur || cur === '_ADD_') {
-            const gws = [];
-            RED.nodes.eachConfig((c) => { if (c.type === 'knxUltimate-config') gws.push(c); });
-            if (gws.length === 1) $('#node-input-server').val(gws[0].id).trigger('change');
-          }
-        } catch (error) { /* empty */ }
-
-        // Device type dropdown
-        const $type = $('#node-input-deviceType');
-        TYPE_ORDER.forEach((t) => {
-          $type.append($('<option></option>').attr('value', t).text(node._('knxUltimateMatterBridge.types.' + t)));
-        });
-        $type.val(node.deviceType || 'onofflight');
-
-        // Compact "list" layout: a small gray caption above each input, fields wrapping
-        // on one or more rows (same pattern used across the rest of the KNX-Ultimate nodes).
-        const $fields = $('#mb-ga-fields').css({ display: 'flex', flexWrap: 'wrap', alignItems: 'flex-end', gap: '10px' });
-        const $invertRow = $('#mb-invert-row');
-        const $advancedRows = $('#mb-compatibility-options');
-        const $commandAdvancedRows = $('.mb-command-advanced-row');
-        const $dimmerAdvancedRows = $('.mb-dimmer-advanced-row');
-        const $coverAdvancedRows = $('.mb-cover-advanced-row');
-        const $pinSelect = $('#node-input-enableNodePINS');
-        const $flowHelp = $('#matter-bridge-flow-help');
-        const $nameInput = $('#node-input-name');
-        const gaInputs = {};
-
-        function createLabeledField(row, element, options = {}) {
-          const wrapper = $('<div/>', {
-            style: 'display:flex; flex-direction:column; margin-bottom:8px;'
-          }).appendTo(row);
-          if (options.width) wrapper.css('width', options.width);
-          const $labelSpan = $('<span/>', {
-            style: 'font-size:11px; color:#666; margin-bottom:2px; white-space:nowrap;'
-          }).appendTo(wrapper);
-          element.css('width', '100%');
-          element.appendTo(wrapper);
-          return { wrapper, $labelSpan };
-        }
-
-        function attachGaAutocomplete($ga, $dpt, fieldDef) {
-          $ga.autocomplete({
-            minLength: 0,
-            source(request, response) {
-              const gw = findKnxGateway();
-              if (!gw) { response([]); return; }
-              $.getJSON(`knxUltimatecsv?nodeID=${gw.id}`, (data) => {
-                response($.map(data, (value) => {
-                  const search = `${value.ga} (${value.devicename}) DPT${value.dpt}`;
-                  if (htmlUtilsfullCSVSearch(search, `${request.term} ${fieldDef.dptPrefix}`)) {
-                    return { label: `${value.ga} # ${value.devicename} # ${value.dpt}`, value: value.ga, dpt: value.dpt };
-                  }
-                  return null;
-                }));
-              });
-            },
-            select(event, ui) { $dpt.val(ui.item.dpt || fieldDef.fallbackDpt); }
-          });
-          $ga.on('focus.knxUltimateMatterBridge click.knxUltimateMatterBridge', function () {
-            try { $(this).autocomplete('search', ''); } catch (error) { /* empty */ }
-          });
-          try {
-            const gw = findKnxGateway();
-            if (gw && gw.id) KNX_enableSecureFormatting($ga, gw.id);
-          } catch (error) { /* empty */ }
-        }
-
-        // Build one field per possible GA key; show only the ones of the selected type.
-        ALL_KEYS.forEach((key) => {
-          const fieldDef = {};
-          Object.keys(TYPE_FIELDS).forEach((t) => { const f = TYPE_FIELDS[t].find((x) => x.key === key); if (f) Object.assign(fieldDef, f); });
-          const $ga = $('<input/>', { type: 'text', placeholder: '1/1/1' }).val(node['ga' + key] || '');
-          const $dpt = $('<input/>', { type: 'hidden' }).val(node['dpt' + key] || '');
-          const { wrapper, $labelSpan } = createLabeledField($fields, $ga, { width: '150px' });
-          wrapper.append($dpt); // Kept alongside the GA input; never rendered.
-          attachGaAutocomplete($ga, $dpt, fieldDef);
-          // Keyed by field key (not DOM position), so save is robust regardless of layout.
-          gaInputs[key] = { wrapper, $ga, $dpt, $labelSpan };
-        });
-
-        const inputMessageCode = (fn, value) => `msg.payload = ${JSON.stringify({ function: fn, value }, null, 2)};\nreturn msg;`;
-        const outputMessageCode = (fn, value) => JSON.stringify({
-          topic: ($nameInput.val() || node.name || 'Matter device').toString(),
-          payload: value,
-          matter: { fn, value }
-        }, null, 2);
-        const appendFlowHelpRow = ($body, fn, code) => {
-          const $row = $('<tr></tr>');
-          $('<td><code></code></td>').find('code').text(fn).end().appendTo($row);
-          $('<td><code></code></td>').find('code').text(code).end().appendTo($row);
-          $('<td></td>').append(
-            $('<button type="button" class="red-ui-button matter-bridge-flow-help-copy"><i class="fa fa-copy"></i></button>')
-              .attr('title', node._('knxUltimateMatterBridge.flow_help.copy') || 'Copy')
-              .data('copy-text', code)
-          ).appendTo($row);
-          $body.append($row);
-        };
-        const copyFlowHelpText = (value) => {
-          const copied = () => RED.notify(node._('knxUltimateMatterBridge.flow_help.copied') || 'Message copied', 'success');
-          if (navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {
-            navigator.clipboard.writeText(value).then(copied).catch(() => {
-              const $temporary = $('<textarea></textarea>').val(value).appendTo('body').select();
-              try { document.execCommand('copy'); copied(); } finally { $temporary.remove(); }
-            });
-            return;
-          }
-          const $temporary = $('<textarea></textarea>').val(value).appendTo('body').select();
-          try { document.execCommand('copy'); copied(); } finally { $temporary.remove(); }
-        };
-        const renderFlowHelp = () => {
-          const examples = FLOW_HELP[$type.val()] || { input: [], output: [] };
-          const $inputBody = $('#matter-bridge-flow-help-input-body').empty();
-          const $outputBody = $('#matter-bridge-flow-help-output-body').empty();
-          examples.input.forEach(([fn, value]) => appendFlowHelpRow($inputBody, fn, inputMessageCode(fn, value)));
-          examples.output.forEach(([fn, value]) => appendFlowHelpRow($outputBody, fn, outputMessageCode(fn, value)));
-          $('#matter-bridge-flow-help-input-empty').toggle(examples.input.length === 0);
-          $('#matter-bridge-flow-help-output-empty').toggle(examples.output.length === 0);
-          $('#matter-bridge-flow-help-output-table').toggle(examples.output.length > 0);
-        };
-        const updateFlowHelpVisibility = () => {
-          const visible = $pinSelect.val() === 'yes';
-          $flowHelp.toggle(visible);
-          if (visible) renderFlowHelp();
-        };
-
-        function updateTypePresentation() {
-          const selected = $type.val();
-          const active = TYPE_FIELDS[selected] || [];
-          ALL_KEYS.forEach((key) => {
-            const entry = gaInputs[key];
-            const fieldForType = active.find((f) => f.key === key);
-            if (fieldForType) {
-              entry.wrapper.show();
-              entry.$labelSpan.text(node._('knxUltimateMatterBridge.functions.' + fieldForType.labelKey));
-            } else {
-              entry.wrapper.hide();
-            }
-          });
-          $invertRow.toggle(selected === 'windowcovering');
-          const hasLevel = selected === 'dimmablelight' || selected === 'rgblight' || selected === 'colortemperaturelight';
-          const isCover = selected === 'windowcovering';
-          // The Alexa duplicate-command dedup applies to any device that emits On/Off or
-          // level commands (plain on/off lights and plugs included), not just dimmers.
-          const hasCommand = selected === 'onofflight' || selected === 'onoffplug' || selected === 'roomairconditioner' || hasLevel;
-          $advancedRows.toggle(hasCommand || isCover);
-          $commandAdvancedRows.toggle(hasCommand);
-          $dimmerAdvancedRows.toggle(hasLevel);
-          $coverAdvancedRows.toggle(isCover);
-          updateFlowHelpVisibility();
-        }
-        $type.on('change', updateTypePresentation);
-        updateTypePresentation();
-
-        // oneditsave reads the GA values straight from these references: no DOM
-        // position matching, so it cannot break if the layout changes again.
-        node._matterGaInputs = gaInputs;
-
-        $('#node-input-invertPosition').prop('checked', node.invertPosition === true);
-        $('#node-input-coverSwapOpenClose').prop('checked', node.coverSwapOpenClose === true);
-        $('#node-input-coverSliderDebounceMs').val(node.coverSliderDebounceMs === undefined ? 0 : node.coverSliderDebounceMs);
-        $('#node-input-commandDedupMs').val(node.commandDedupMs === undefined ? 1200 : node.commandDedupMs);
-        $('#node-input-turnOnBehavior').val(node.turnOnBehavior || 'ignoreLevelAfterOn');
-        $('#node-input-ignoreLevelAfterOnMs').val(node.ignoreLevelAfterOnMs === undefined ? 800 : node.ignoreLevelAfterOnMs);
-        $('#node-input-coverUpdateMode').val(node.coverUpdateMode || 'optimistic');
-        $('#node-input-coverStatusTimeoutMs').val(node.coverStatusTimeoutMs === undefined ? 3000 : node.coverStatusTimeoutMs);
-        $('#node-input-readStatusAtStartup').val(node.readStatusAtStartup || 'yes');
-        $pinSelect.val(node.enableNodePINS || 'no');
-        $pinSelect.on('change.knxUltimateMatterBridge', updateFlowHelpVisibility);
-        $nameInput.on('change.knxUltimateMatterBridge input.knxUltimateMatterBridge', () => {
-          if ($flowHelp.is(':visible')) renderFlowHelp();
-        });
-        $flowHelp.off('click.knxUltimateMatterBridge').on('click.knxUltimateMatterBridge', '.matter-bridge-flow-help-copy', function () {
-          copyFlowHelpText($(this).data('copy-text') || '');
-        });
-        updateFlowHelpVisibility();
-      },
-      oneditsave() {
-        try { RED.sidebar.show('info'); } catch (error) { /* empty */ }
-        const node = this;
-        const selected = $('#node-input-deviceType').val();
-        node.deviceType = selected;
-        node.invertPosition = $('#node-input-invertPosition').is(':checked');
-        node.coverSwapOpenClose = $('#node-input-coverSwapOpenClose').is(':checked');
-        const active = TYPE_FIELDS[selected] || [];
-        const gaInputs = node._matterGaInputs || {};
-        // Clear every GA/DPT, then write only the ones of the selected type, reading
-        // straight from the field references built in oneditprepare (not DOM position).
-        ALL_KEYS.forEach((key) => {
-          node['ga' + key] = '';
-          node['dpt' + key] = '';
-          const entry = gaInputs[key];
-          if (!entry) return;
-          const isActive = active.some((f) => f.key === key);
-          const ga = (entry.$ga.val() || '').trim();
-          if (isActive && ga !== '') {
-            node['ga' + key] = ga;
-            node['dpt' + key] = (entry.$dpt.val() || '').trim();
-          }
-        });
-        delete node._matterGaInputs;
-        // Keep an explicit 0 (dedup disabled); treat only an empty/invalid field as the default.
-        const dedupRaw = $('#node-input-commandDedupMs').val();
-        this.commandDedupMs = (dedupRaw === '' || dedupRaw === null || isNaN(Number(dedupRaw))) ? 1200 : Math.max(0, Number(dedupRaw));
-        const coverDebounceRaw = $('#node-input-coverSliderDebounceMs').val();
-        this.coverSliderDebounceMs = (coverDebounceRaw === '' || coverDebounceRaw === null || isNaN(Number(coverDebounceRaw))) ? 0 : Math.min(5000, Math.max(0, Number(coverDebounceRaw)));
-        this.turnOnBehavior = $('#node-input-turnOnBehavior').val() || 'ignoreLevelAfterOn';
-        this.ignoreLevelAfterOnMs = Number($('#node-input-ignoreLevelAfterOnMs').val()) || 0;
-        this.coverUpdateMode = $('#node-input-coverUpdateMode').val() || 'optimistic';
-        this.coverStatusTimeoutMs = Number($('#node-input-coverStatusTimeoutMs').val()) || 0;
-        this.enableNodePINS = $('#node-input-enableNodePINS').val() || 'no';
-        this.outputs = this.enableNodePINS === 'yes' ? 1 : 0;
-        this.inputs = this.enableNodePINS === 'yes' ? 1 : 0;
-      },
-      oneditcancel() {
-        try { RED.sidebar.show('info'); } catch (error) { /* empty */ }
-        delete this._matterGaInputs;
-      }
-    });
-  }());
-</script>
-
-<script type="text/html" data-template-name="knxUltimateMatterBridge">
-    <div class="form-row knx-ultimate-v8-upgrade-row">
-        <button type="button" class="red-ui-button knx-ultimate-v8-upgrade-button" data-i18n="[title]node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button_title">
-            <i class="fa fa-arrow-circle-up" aria-hidden="true"></i>
-            <span data-i18n="node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.v8_upgrade.button"></span>
-        </button>
-    </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>
-
-  <div class="form-row">
-    <label for="node-input-server">
-      <img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAKnRFWHRDcmVhdGlvbiBUaW1lAEZyIDYgQXVnIDIwMTAgMjE6NTI6MTkgKzAxMDD84aS8AAAAB3RJTUUH3gYYCicNV+4WIQAAAAlwSFlzAAALEgAACxIB0t1+/AAAAARnQU1BAACxjwv8YQUAAACUSURBVHjaY2CgFZg5c+Z/ZEyWAZ8+f/6/ZsWs/xoamqMGkGrA6Wla/1+fVARjEBuGsSoGmY4eZSCNL59d/g8DIDbIAHR14OgFGQByKjIGKX5+6/T///8gGMQGiV1+/B0Fg70GIkD+RMYgxf/O5/7//2MSmAZhkBi6OrgB6Bg5DGB4ajr3f2xqsYYLSDE2THJUDg0AAAqyDVd4tp4YAAAAAElFTkSuQmCC" />
-      <span data-i18n="common.knx_gw"></span>
-    </label>
-    <input type="text" id="node-input-server">
-  </div>
-
-  <div class="form-row">
-    <label for="node-input-serverMatterBridge">
-      <i class="fa fa-share-alt"></i> <span data-i18n="knxUltimateMatterBridge.bridge"></span>
-    </label>
-    <input type="text" id="node-input-serverMatterBridge">
-  </div>
-
-  <div class="form-row">
-    <label for="node-input-name">
-      <i class="fa fa-tag"></i> <span data-i18n="knxUltimateMatterBridge.device_name"></span>
-    </label>
-    <input type="text" id="node-input-name" data-i18n="[placeholder]knxUltimateMatterBridge.fields.name_placeholder">
-  </div>
-
-  <div class="form-row">
-    <label for="node-input-deviceType">
-      <i class="fa fa-microchip"></i> <span data-i18n="knxUltimateMatterBridge.fields.type"></span>
-    </label>
-    <select id="node-input-deviceType" style="width:260px;"></select>
-  </div>
-
-  <div id="mb-tabs" style="margin-top:12px;">
-    <ul>
-      <li><a href="#mb-tab-mappings"><i class="fa fa-exchange"></i> <span data-i18n="knxUltimateMatterBridge.tabs.mappings"></span></a></li>
-      <li><a href="#mb-tab-advanced"><i class="fa fa-sliders"></i> <span data-i18n="knxUltimateMatterBridge.tabs.advanced"></span></a></li>
-    </ul>
-
-    <div id="mb-tab-mappings" style="padding-top:12px;">
-      <div id="mb-ga-fields"></div>
-
-      <div class="form-row" id="mb-invert-row" style="display:none;">
-        <label for="node-input-invertPosition" style="width:auto;">
-          <i class="fa fa-exchange"></i>
-          <span data-i18n="knxUltimateMatterBridge.fields.invert"></span>
-          <input type="checkbox" id="node-input-invertPosition" style="width:auto; display:inline-block; vertical-align:middle; margin-left:6px;">
-        </label>
-      </div>
-    </div>
-
-    <div id="mb-tab-advanced" style="padding-top:12px;">
-      <div id="mb-compatibility-options" style="display:none;">
-        <div class="form-row mb-command-advanced-row" style="display:none; margin-top:8px;">
-          <label for="node-input-commandDedupMs" style="width:260px;">
-            <i class="fa fa-clone"></i> <span data-i18n="knxUltimateMatterBridge.advanced.alexa_dedup_ms"></span>
-          </label>
-          <input type="number" id="node-input-commandDedupMs" min="0" step="100" style="width:120px;">
-        </div>
-
-        <div class="form-row mb-dimmer-advanced-row" style="display:none; margin-top:8px;">
-          <label for="node-input-turnOnBehavior" style="width:260px;">
-            <i class="fa fa-lightbulb-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.turn_on_behavior"></span>
-          </label>
-          <select id="node-input-turnOnBehavior" style="width:280px;">
-            <option value="ignoreLevelAfterOn" data-i18n="knxUltimateMatterBridge.advanced.turn_on_ignore_level"></option>
-            <option value="forwardAll" data-i18n="knxUltimateMatterBridge.advanced.turn_on_forward_all"></option>
-          </select>
-        </div>
-
-        <div class="form-row mb-dimmer-advanced-row" style="display:none;">
-          <label for="node-input-ignoreLevelAfterOnMs" style="width:260px;">
-            <i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.ignore_level_ms"></span>
-          </label>
-          <input type="number" id="node-input-ignoreLevelAfterOnMs" min="0" step="100" style="width:120px;">
-        </div>
-
-        <div class="form-row mb-cover-advanced-row" style="display:none; margin-top:8px;">
-          <label for="node-input-coverSwapOpenClose" style="width:260px;">
-            <i class="fa fa-exchange"></i> <span data-i18n="knxUltimateMatterBridge.advanced.cover_swap_open_close"></span>
-          </label>
-          <input type="checkbox" id="node-input-coverSwapOpenClose" style="width:auto; vertical-align:middle;">
-        </div>
-
-        <div class="form-row mb-cover-advanced-row" style="display:none;">
-          <label for="node-input-coverSliderDebounceMs" style="width:260px;">
-            <i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.cover_slider_debounce"></span>
-          </label>
-          <input type="number" id="node-input-coverSliderDebounceMs" min="0" max="5000" step="50" style="width:120px;">
-        </div>
-
-        <div class="form-row mb-cover-advanced-row" style="display:none; margin-top:8px;">
-          <label for="node-input-coverUpdateMode" style="width:260px;">
-            <i class="fa fa-window-maximize"></i> <span data-i18n="knxUltimateMatterBridge.advanced.cover_update_mode"></span>
-          </label>
-          <select id="node-input-coverUpdateMode" style="width:280px;">
-            <option value="optimistic" data-i18n="knxUltimateMatterBridge.advanced.cover_optimistic"></option>
-            <option value="waitStatus" data-i18n="knxUltimateMatterBridge.advanced.cover_wait_status"></option>
-          </select>
-        </div>
-
-        <div class="form-row mb-cover-advanced-row" style="display:none;">
-          <label for="node-input-coverStatusTimeoutMs" style="width:260px;">
-            <i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.cover_status_timeout"></span>
-          </label>
-          <input type="number" id="node-input-coverStatusTimeoutMs" min="0" step="500" style="width:120px;">
-        </div>
-      </div>
-
-      <div class="form-row">
-        <label for="node-input-readStatusAtStartup" style="width:260px;">
-          <i class="fa fa-question-circle"></i> <span data-i18n="knxUltimateMatterBridge.read_status_startup"></span>
-        </label>
-        <select id="node-input-readStatusAtStartup" style="width:120px;">
-          <option value="yes" data-i18n="knxUltimateMatterBridge.opt_yes"></option>
-          <option value="no" data-i18n="knxUltimateMatterBridge.opt_no"></option>
-        </select>
-      </div>
-
-    </div>
-  </div>
-
-  <div class="form-row" style="margin-top:12px;">
-    <label for="node-input-enableNodePINS" style="width:260px;">
-      <i class="fa fa-code"></i> <span data-i18n="knxUltimateMatterBridge.node_pins"></span>
-    </label>
-    <select id="node-input-enableNodePINS" style="width:220px;">
-      <option value="no" data-i18n="knxUltimateMatterBridge.node_pins_hide"></option>
-      <option value="yes" data-i18n="knxUltimateMatterBridge.node_pins_show"></option>
-    </select>
-  </div>
-
-  <div id="matter-bridge-flow-help" style="display:none; width:900px; margin-top:12px;">
-    <h4><i class="fa fa-code"></i> <span data-i18n="knxUltimateMatterBridge.flow_help.title"></span></h4>
-    <p data-i18n="knxUltimateMatterBridge.flow_help.intro"></p>
-
-    <h4 data-i18n="knxUltimateMatterBridge.flow_help.input_title"></h4>
-    <p data-i18n="knxUltimateMatterBridge.flow_help.input_hint"></p>
-    <table class="matter-bridge-flow-help-table">
-      <thead>
-        <tr>
-          <th data-i18n="knxUltimateMatterBridge.flow_help.function"></th>
-          <th data-i18n="knxUltimateMatterBridge.flow_help.message"></th>
-          <th></th>
-        </tr>
-      </thead>
-      <tbody id="matter-bridge-flow-help-input-body"></tbody>
-    </table>
-    <p id="matter-bridge-flow-help-input-empty" style="display:none;" data-i18n="knxUltimateMatterBridge.flow_help.no_input"></p>
-
-    <h4 data-i18n="knxUltimateMatterBridge.flow_help.output_title"></h4>
-    <p data-i18n="knxUltimateMatterBridge.flow_help.output_hint"></p>
-    <table id="matter-bridge-flow-help-output-table" class="matter-bridge-flow-help-table">
-      <thead>
-        <tr>
-          <th data-i18n="knxUltimateMatterBridge.flow_help.function"></th>
-          <th data-i18n="knxUltimateMatterBridge.flow_help.message"></th>
-          <th></th>
-        </tr>
-      </thead>
-      <tbody id="matter-bridge-flow-help-output-body"></tbody>
-    </table>
-    <p id="matter-bridge-flow-help-output-empty" style="display:none;" data-i18n="knxUltimateMatterBridge.flow_help.no_output"></p>
-  </div>
-
-  <br/>
-  <br/>
-  <br/>
-  <br/>
-  <br/>
-  
-</script>
-
-<script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-### Upgrade to KNX Ultimate 8
-
-Version 7 shows a compact **Upgrade to v8** button at the top of this editor. It downloads a flow backup, installs the required companion packages, converts compatible nodes, performs a full Deploy, verifies the saved flows and installs version 8. Restart the Node-RED service when prompted; reloading only the browser is not enough. Legacy KNX AI nodes stop the automatic operation.
-
-[Full upgrade guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Upgrade-to-v8)
-
-<br/>
-
-Exposes **one KNX device as a Matter device**.
-
-Point it to a **Matter Bridge** configuration node (the actual bridge, paired once by Alexa/Google Home/Apple Home), pick the device type, give it the name the assistant will use, and fill the group addresses.
-
-The **Mappings** and **Advanced** tabs are arranged vertically on the left, matching the Matter Controller editor.
-
-- **Matter → KNX**: commands from the voice assistant write to the *command* group addresses.
-- **KNX → Matter**: telegrams on the *status* group addresses update the Matter attribute (and the app UI).
-
-The advanced compatibility options are intentionally type-specific:
-
-- dimmable devices can ignore the brightness command that some controllers send immediately after an On command
-- covers can swap Open/Close (including the percentage direction) for controllers such as Alexa that interpret them in reverse
-- cover slider debounce coalesces rapid intermediate targets before writing to KNX: `0` uses adaptive 400/150 ms windows, while `1`–`5000` forces a fixed window
-- covers can optimistically update the Matter position after a command, then correct it when the KNX status GA reports the real position
-
-The **KNX gateway is optional**: without it, enable the node PINs and drive the device from the flow.
-
-The PIN selector sits outside the tabs. Enabling it reveals a contextual **Flow input/output**
-section directly below, with copyable examples filtered to the selected device type:
-
-- input: `msg.payload = { function: "onoff", value: true }` updates the Matter state without the KNX bus
-- output: every command from a Matter controller is forwarded as `msg` (topic = device name, payload = value, `msg.matter` = raw command)
-</script>