node-red-contrib-boolean-logic-ultimate 1.1.26 → 1.2.0

package/CHANGELOG.md

@@ -3,11 +3,22 @@
 
 # CHANGELOG
 
+<p>
+<b>Version 1.2.0</b> September 2025<br/>
+- NEW: PresenceSimulatorUltimate to replay configurable message sequences and simulate occupancy.<br/>
+- NEW: StaircaseLightUltimate to manage staircase lighting timers with pre-off warnings.<br/>
+- NEW: RateLimiterUltimate node with debounce, throttle and window modes.<br/>
+- Added shared helper for consistent status/timer handling across ultimate nodes.</br>
+</p>
+
+<p>
+<b>Version 1.1.27</b> July 2025<br/>
+- Status node: UI correction. </br>
+</p>
 <p>
 <b>Version 1.1.26</b> July 2025<br/>
 - Interruptflow node: fixed non functional msg.play. </br>
 </p>
-
 <p>
 <b>Version 1.1.25</b> January 2025<br/>
 - BREAKING CHANGE<br/>
@@ -382,4 +393,4 @@
 <p>
 <b>Version 0.0.1</b><br/>
 - Initial release<br/>
-</p>
+</p>

package/README.md

@@ -546,6 +546,113 @@ Please refer to [this](https://github.com/wouterbulten/kalmanjs) link, on how it
 
 <br/>
 
+# RATE LIMITER ULTIMATE
+
+Gateway per sensori e dispositivi troppo “chiacchieroni”: limita burst e rimbalzi con modalità **Debounce**, **Throttle** e **Window**. Lo stato del nodo riporta sempre modalità corrente, contatori di messaggi inoltrati e bloccati.
+
+### NODE CONFIGURATION
+
+| Property | Description |
+| -------- | ----------- |
+| Mode | Seleziona la logica: *Debounce* (attende quiete), *Throttle* (impone un intervallo minimo), *Window* (massimo N messaggi per finestra temporale). |
+| Wait (ms) | Ritardo di quiete per la modalità debounce. |
+| Emit | Per debounce: scegli tra *Leading* (subito), *Trailing* (ultimo), *Both*. |
+| Interval (ms) | Intervallo minimo tra messaggi in modalità throttle. |
+| Emit trailing | In throttle, inoltra l’ultimo messaggio ricevuto allo scadere dell’intervallo. |
+| Window size (ms) | Larghezza della finestra mobile in modalità window. |
+| Max messages | Numero di messaggi ammessi nella finestra. |
+| On limit | *Drop* scarta i messaggi extra, *Queue last* accoda l’ultimo e lo riproduce appena possibile. |
+| Control topic | Topic dei messaggi di controllo (default `rate`). |
+| With Input | Proprietà del messaggio da monitorare (default `msg.payload`). |
+| Stats every (s) | Ogni quanti secondi emettere un riepilogo statistico (0 = disattivato). |
+| Translator | Nodo translator-config opzionale per adattare le stringhe d’ingresso a true/false. |
+
+<br/>
+
+### OUTPUTS
+
+- **Output 1**: messaggi inoltrati, invariati.
+- **Output 2**: diagnostica (`{mode, reason, passed, dropped, msg, propertyValue}`) e statistiche periodiche su `controlTopic/stats`.
+
+<br/>
+
+### CONTROL MESSAGES (`msg.topic === controlTopic`)
+
+- `msg.reset = true` &rarr; azzera contatori, accoda azzerata e timer cancellati.
+- `msg.flush = true` &rarr; forza l’emissione immediata del messaggio in attesa.
+- `msg.mode = 'debounce'|'throttle'|'window'` &rarr; cambia modalità runtime e resetta lo stato.
+- `msg.interval`, `msg.wait`, `msg.windowSize`, `msg.maxInWindow` &rarr; aggiorna i parametri corrispondenti.
+
+<br/>
+
+# PRESENCE SIMULATOR ULTIMATE
+
+The purpose of this node is to replay a programmable sequence of messages in order to simulate occupancy when you are away.
+
+### NODE CONFIGURATION
+
+| Property | Description |
+| -------- | ----------- |
+| Control topic | Topic used for runtime commands such as start/stop/reset. |
+| Auto start | Starts the sequence automatically after deploy or restart. |
+| Loop sequence | Repeats the sequence when it reaches the end. |
+| Random delays | Enables a random variation of the programmed delays. |
+| Jitter (%) | Maximum percentage of variation applied when random delays are enabled. |
+| With Input | Message property to inspect for inline events (default `payload`). |
+| Translator | Optional translator-config to convert incoming values. |
+| Sequence | One JSON object per line, each containing at least `delay` (ms) plus the properties to output. |
+
+### CONTROL MESSAGES (`msg.topic === controlTopic`)
+
+- `msg.command = 'start'` / `msg.start = true` &rarr; begin playback.
+- `msg.command = 'stop'` / `msg.stop = true` &rarr; halt playback.
+- `msg.reset = true` &rarr; reset counters and start position.
+- `msg.sequence = [...]` &rarr; load a new sequence at runtime.
+- `msg.loop`, `msg.randomize`, `msg.jitter` &rarr; update the corresponding options.
+
+Each event in the sequence outputs a message configured in the JSON line. When random delays are enabled, the effective delay is varied within the configured jitter.
+
+<br/>
+
+# STAIRCASE LIGHT ULTIMATE
+
+The purpose of this node is to control staircase lighting with a timer, pre-off warning and optional extension on every trigger.
+
+### NODE CONFIGURATION
+
+| Property | Description |
+| -------- | ----------- |
+| Control topic | Topic that receives manual commands such as `on`, `off`, `extend`. |
+| Duration (s) | Lighting duration for each trigger. |
+| Warning before off | Enables emission of a pre-off warning on output 2. |
+| Warning offset (s) | Seconds before switch-off when the warning is sent. |
+| Restart on trigger | Restarts the timer when a new trigger arrives while active. |
+| Allow off input | Allows a `false` from the main input to switch off immediately. |
+| With Input | Message property evaluated as trigger (default `payload`). |
+| Translator | Optional translator-config for true/false conversion. |
+| On/Off payload | Values emitted on output 1 to turn the light on/off. |
+| Warning payload | Value emitted on output 2 when the warning fires. |
+
+### CONTROL MESSAGES (`msg.topic === controlTopic`)
+
+- `msg.command = 'on'` / `msg.start = true` &rarr; start the timer and turn on the light.
+- `msg.command = 'off'` / `msg.stop = true` &rarr; switch off immediately.
+- `msg.command = 'extend'` / `msg.extend = true` &rarr; refresh the timer while keeping the light on.
+- `msg.duration`, `msg.warningEnabled`, `msg.warningOffset` &rarr; adjust runtime settings.
+
+Output 1 delivers the ON/OFF command. Output 2 delivers the warning and includes `msg.remaining` with the seconds left.
+
+<br/>
+
+# DEVELOPMENT
+
+Per eseguire i test automatici:
+
+1. `npm install`
+2. `npm test`
+
+<br/>
+
 [license-image]: https://img.shields.io/badge/license-MIT-blue.svg
 
 [license-url]: https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate/master/LICENSE
@@ -560,4 +667,4 @@ Please refer to [this](https://github.com/wouterbulten/kalmanjs) link, on how it
 
 [youtube-image]: https://img.shields.io/badge/Visit%20me-youtube-red
 
-[youtube-url]: https://youtube.com/playlist?list=PL9Yh1bjbLAYoRH4IyQB7EL5srHAihiKpy
+[youtube-url]: https://youtube.com/playlist?list=PL9Yh1bjbLAYoRH4IyQB7EL5srHAihiKpy

package/boolean-logic-ultimate/PresenceSimulatorUltimate.html

@@ -0,0 +1,119 @@
+<script type="text/javascript">
+  RED.nodes.registerType('PresenceSimulatorUltimate', {
+    category: 'Boolean Logic Ultimate',
+    color: '#ffe599',
+    defaults: {
+      name: { value: '' },
+      controlTopic: { value: 'presence' },
+      autoStart: { value: false },
+      autoLoop: { value: true },
+      randomize: { value: false },
+      jitter: { value: 10, validate: RED.validators.number() },
+      payloadPropName: { value: 'payload', required: false },
+      translatorConfig: { type: 'translator-config', required: false },
+      patterns: { value: '' }
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: 'file-in.png',
+    label: function () {
+      return this.name || 'Presence Simulator';
+    },
+    paletteLabel: function () {
+      return 'Presence Simulator';
+    },
+    oneditprepare: function () {
+      const payloadField = $('#node-input-payloadPropName');
+      if (payloadField.val() === '') payloadField.val('payload');
+      payloadField.typedInput({ default: 'msg', types: ['msg'] });
+    }
+  });
+</script>
+
+<script type="text/html" data-template-name="PresenceSimulatorUltimate">
+  <div class="form-row">
+    <b>Presence Simulator Ultimate</b>
+    &nbsp;&nbsp;<span style="color:red"><i class="fa fa-question-circle"></i>&nbsp;<a target="_blank" href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate"><u>Help online</u></a></span>
+  </div>
+
+  <div class="form-row">
+    <label for="node-input-name"><i class="icon-tag"></i> Name</label>
+    <input type="text" id="node-input-name" placeholder="Name">
+  </div>
+
+  <div class="form-row">
+    <label for="node-input-controlTopic"><i class="fa fa-tag"></i> Control topic</label>
+    <input type="text" id="node-input-controlTopic">
+  </div>
+
+  <div class="form-row">
+    <label for="node-input-autoStart"><i class="fa fa-play"></i> Auto start</label>
+    <input type="checkbox" id="node-input-autoStart" style="width:auto; margin-top:7px;">
+  </div>
+
+  <div class="form-row">
+    <label for="node-input-autoLoop"><i class="fa fa-refresh"></i> Loop sequence</label>
+    <input type="checkbox" id="node-input-autoLoop" style="width:auto; margin-top:7px;">
+  </div>
+
+  <div class="form-row">
+    <label for="node-input-randomize"><i class="fa fa-random"></i> Random delays</label>
+    <input type="checkbox" id="node-input-randomize" style="width:auto; margin-top:7px;">
+  </div>
+
+  <div class="form-row">
+    <label for="node-input-jitter"><i class="fa fa-percent"></i> Jitter (%)</label>
+    <input type="number" id="node-input-jitter" min="0" max="100">
+  </div>
+
+  <div class="form-row">
+    <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> With Input</label>
+    <input type="text" id="node-input-payloadPropName">
+  </div>
+
+  <div class="form-row">
+    <label for="node-input-translatorConfig"><i class="fa fa-language"></i> Translator</label>
+    <input type="text" id="node-input-translatorConfig">
+  </div>
+
+  <div class="form-row">
+    <label for="node-input-patterns"><i class="fa fa-list"></i> Sequence</label>
+    <textarea id="node-input-patterns" style="width:100%; height:150px;" placeholder='{"delay":600000,"payload":true,"topic":"light/living"}'></textarea>
+  </div>
+</script>
+
+<script type="text/markdown" data-help-name="PresenceSimulatorUltimate">
+<p>The purpose of this node is to replay a programmable sequence of messages in order to simulate occupancy.</p>
+
+|Property|Description|
+|--|--|
+| Control topic | Topic used for runtime commands such as start/stop/reset. |
+| Auto start | Starts the sequence automatically after deploy or restart. |
+| Loop sequence | Repeats the sequence when the end is reached. |
+| Random delays | Enables a random variation of the programmed delays. |
+| Jitter (%) | Maximum percentage of variation applied when random delays are enabled. |
+| With Input | Message property to inspect for inline events (default `payload`). |
+| Translator | Optional translator-config to convert incoming values. |
+| Sequence | One JSON object per line, each composed at least of `delay` (in ms) and the properties to output. |
+
+<br/>
+
+* Control topic commands (`msg.topic` must match the control topic)
+
+Pass <code>msg.command = "start"</code> (or <code>msg.start = true</code>) to begin playback</br>
+Pass <code>msg.command = "stop"</code> (or <code>msg.stop = true</code>) to halt playback</br>
+Pass <code>msg.reset = true</code> to reset counters and start position</br>
+Pass <code>msg.sequence = [...]</code> to load a new sequence at runtime</br>
+Pass <code>msg.loop</code>, <code>msg.randomize</code> or <code>msg.jitter</code> to update the related options</br>
+
+<br/>
+
+Each event in the sequence outputs a message containing the fields defined in the JSON line. When random delays are enabled, the effective delay is varied within the configured jitter.</br>
+
+<br/>
+
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)</br>
+
+[Find it useful?](https://www.paypal.me/techtoday)
+
+</script>

package/boolean-logic-ultimate/PresenceSimulatorUltimate.js

@@ -0,0 +1,247 @@
+'use strict';
+
+module.exports = function (RED) {
+  const helpers = require('./lib/node-helpers.js');
+
+  function PresenceSimulatorUltimate(config) {
+    RED.nodes.createNode(this, config);
+    const node = this;
+
+    node.config = config;
+
+    const {
+      controlTopic = 'presence',
+      autoStart = false,
+      autoLoop = true,
+      randomize = false,
+      jitter = 0,
+      payloadPropName = 'payload',
+      translatorConfig,
+      patterns = '',
+    } = config;
+
+    const setNodeStatus = helpers.createStatus(node);
+    const timerBag = helpers.createTimerBag(node);
+
+    let eventSequence = parsePatterns(patterns || '');
+    let currentIndex = 0;
+    let running = false;
+    let scheduledTimer = null;
+    let emittedCount = 0;
+
+    function parsePatterns(text) {
+      const events = [];
+      if (!text) {
+        return events;
+      }
+      const lines = text.split('\n').map((l) => l.trim()).filter(Boolean);
+      for (const line of lines) {
+        try {
+          const entry = JSON.parse(line);
+          if (typeof entry.delay !== 'number' || entry.delay < 0) {
+            continue;
+          }
+          events.push(entry);
+        } catch (err) {
+          // Ignore malformed lines
+          node.log(`PresenceSimulatorUltimate: unable to parse pattern line: ${line}`);
+        }
+      }
+      return events;
+    }
+
+    function resetState() {
+      stopPlayback();
+      currentIndex = 0;
+      emittedCount = 0;
+    }
+
+    function updateStatus(state) {
+      const label = state || (running ? 'running' : 'idle');
+      const colour = running ? 'green' : 'grey';
+      setNodeStatus({
+        fill: colour,
+        shape: running ? 'dot' : 'ring',
+        text: `Presence ${label} sent:${emittedCount}`,
+      });
+    }
+
+    function scheduleNext(delay, handler) {
+      if (scheduledTimer) {
+        timerBag.clearTimeout(scheduledTimer);
+        scheduledTimer = null;
+      }
+      scheduledTimer = timerBag.setTimeout(handler, delay);
+    }
+
+    function computeDelay(baseDelay) {
+      if (!randomize) {
+        return baseDelay;
+      }
+      const jitterValue = Number(config.jitter ?? jitter) || 0;
+      if (jitterValue <= 0) {
+        return baseDelay;
+      }
+      const perc = Math.min(Math.max(jitterValue, 0), 100);
+      const delta = baseDelay * (perc / 100);
+      const min = Math.max(0, baseDelay - delta);
+      const max = baseDelay + delta;
+      return Math.floor(Math.random() * (max - min + 1) + min);
+    }
+
+    function emitEvent(event) {
+      if (!event) {
+        return;
+      }
+      const msg = {
+        topic: event.topic || config.outputTopic || node.topic || 'presence',
+      };
+      if (event.hasOwnProperty('payload')) {
+        msg.payload = event.payload;
+      }
+      if (event.hasOwnProperty('properties') && typeof event.properties === 'object') {
+        Object.assign(msg, event.properties);
+      }
+      if (event.clone && typeof event.clone === 'object') {
+        Object.assign(msg, event.clone);
+      }
+      emittedCount += 1;
+      node.send(msg);
+      updateStatus('playing');
+    }
+
+    function nextEventIndex() {
+      if (eventSequence.length === 0) {
+        return -1;
+      }
+      if (config.autoLoop ?? autoLoop) {
+        currentIndex = (currentIndex + 1) % eventSequence.length;
+        return currentIndex;
+      }
+      currentIndex += 1;
+      if (currentIndex >= eventSequence.length) {
+        return -1;
+      }
+      return currentIndex;
+    }
+
+    function playFrom(index) {
+      if (!running || eventSequence.length === 0) {
+        stopPlayback();
+        return;
+      }
+      const event = eventSequence[index];
+      if (!event) {
+        stopPlayback();
+        return;
+      }
+      const delay = computeDelay(event.delay);
+      scheduleNext(delay, () => {
+        emitEvent(event);
+        const nextIndex = nextEventIndex();
+        if (nextIndex === -1) {
+          stopPlayback();
+        } else {
+          playFrom(nextIndex);
+        }
+      });
+    }
+
+    function startPlayback() {
+      if (running) {
+        return;
+      }
+      if (!eventSequence.length) {
+        updateStatus('no events');
+        return;
+      }
+      running = true;
+      updateStatus('starting');
+      currentIndex = currentIndex % eventSequence.length;
+      playFrom(currentIndex);
+    }
+
+    function stopPlayback() {
+      running = false;
+      if (scheduledTimer) {
+        timerBag.clearTimeout(scheduledTimer);
+        scheduledTimer = null;
+      }
+      updateStatus('stopped');
+    }
+
+    function setSequence(newSequence) {
+      if (Array.isArray(newSequence)) {
+        eventSequence = newSequence
+          .filter((entry) => entry && typeof entry.delay === 'number' && entry.delay >= 0)
+          .map((entry) => ({ ...entry }));
+        currentIndex = 0;
+        emittedCount = 0;
+        updateStatus('sequence loaded');
+      }
+    }
+
+    function handleControlMessage(msg) {
+      let consumed = false;
+      if (msg.reset === true) {
+        resetState();
+        consumed = true;
+      }
+      if (msg.start === true || msg.command === 'start') {
+        startPlayback();
+        consumed = true;
+      }
+      if (msg.stop === true || msg.command === 'stop') {
+        stopPlayback();
+        consumed = true;
+      }
+      if (msg.hasOwnProperty('sequence') && Array.isArray(msg.sequence)) {
+        setSequence(msg.sequence);
+        consumed = true;
+      }
+      if (msg.hasOwnProperty('loop')) {
+        config.autoLoop = Boolean(msg.loop);
+        consumed = true;
+      }
+      if (msg.hasOwnProperty('randomize')) {
+        config.randomize = Boolean(msg.randomize);
+        consumed = true;
+      }
+      if (msg.hasOwnProperty('jitter')) {
+        config.jitter = Number(msg.jitter);
+        consumed = true;
+      }
+      return consumed;
+    }
+
+    node.on('input', (msg) => {
+      if (msg.topic === controlTopic) {
+        if (handleControlMessage(msg)) {
+          return;
+        }
+      }
+
+      // Optional runtime addition: if message contains inline event, enqueue it
+      if (msg.hasOwnProperty('delay') && typeof msg.delay === 'number') {
+        eventSequence.push({
+          delay: msg.delay,
+          payload: msg[payloadPropName],
+          topic: msg.topic,
+          properties: msg.properties,
+        });
+        updateStatus('event added');
+      }
+    });
+
+    node.on('close', () => {
+      stopPlayback();
+    });
+
+    updateStatus();
+    if (autoStart) {
+      startPlayback();
+    }
+  }
+
+  RED.nodes.registerType('PresenceSimulatorUltimate', PresenceSimulatorUltimate);
+};

package/boolean-logic-ultimate/RateLimiterUltimate.html

@@ -0,0 +1,164 @@
+<script type="text/javascript">
+  RED.nodes.registerType('RateLimiterUltimate', {
+    category: 'Boolean Logic Ultimate',
+    color: '#ffcc66',
+    defaults: {
+      name: { value: '' },
+      mode: { value: 'debounce' },
+      wait: { value: 500, validate: RED.validators.number() },
+      emitOn: { value: 'trailing' },
+      interval: { value: 1000, validate: RED.validators.number() },
+      trailing: { value: false },
+      windowSize: { value: 1000, validate: RED.validators.number() },
+      maxInWindow: { value: 10, validate: RED.validators.number() },
+      dropStrategy: { value: 'drop' },
+      payloadPropName: { value: 'payload', required: false },
+      translatorConfig: { type: 'translator-config', required: false },
+      controlTopic: { value: 'rate' },
+      statInterval: { value: 0, validate: RED.validators.number() }
+    },
+    inputs: 1,
+    outputs: 2,
+    outputLabels: function (index) {
+      return index === 0 ? 'Forward' : 'Diagnostics';
+    },
+    icon: 'file-in.png',
+    label: function () {
+      const mode = (this.mode || 'debounce').charAt(0).toUpperCase() + (this.mode || 'debounce').slice(1);
+      return (this.name || 'RateLimiter') + ' (' + mode + ')';
+    },
+    paletteLabel: function () {
+      return 'Rate Limiter';
+    },
+    oneditprepare: function () {
+      const payloadField = $('#node-input-payloadPropName');
+      if (payloadField.val() === '') payloadField.val('payload');
+      payloadField.typedInput({ default: 'msg', types: ['msg'] });
+
+      $('#node-input-trailing').prop('checked', this.trailing === true);
+
+      function toggleSections(mode) {
+        $('.rate-config-section').hide();
+        $('.rate-config-common').show();
+        $('.rate-config-' + mode).show();
+      }
+
+      $('#node-input-mode').on('change', function () {
+        toggleSections($(this).val());
+      });
+
+      toggleSections($('#node-input-mode').val());
+    },
+    oneditsave: function () {
+      this.trailing = $('#node-input-trailing').is(':checked');
+    }
+  });
+</script>
+
+<script type="text/html" data-template-name="RateLimiterUltimate">
+  <div class="form-row">
+    <b>Rate Limiter Ultimate</b>&nbsp;&nbsp;
+    <span style="color:red"><i class="fa fa-question-circle"></i>&nbsp;<a target="_blank" href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate"><u>Help online</u></a></span>
+    &nbsp;&nbsp;<span style="color:red"><i class="fa fa-youtube-play"></i>&nbsp;<a target="_blank" href="https://youtu.be/1T1g0HCeYA8"><u>Youtube Sample</u></a></span>
+  </div>
+
+  <div class="form-row">
+    <label for="node-input-name"><i class="icon-tag"></i> Name</label>
+    <input type="text" id="node-input-name" placeholder="Name">
+  </div>
+
+  <div class="form-row rate-config-common">
+    <label for="node-input-mode"><i class="fa fa-sliders"></i> Mode</label>
+    <select id="node-input-mode">
+      <option value="debounce">Debounce</option>
+      <option value="throttle">Throttle</option>
+      <option value="window">Window</option>
+    </select>
+  </div>
+
+  <div class="form-row rate-config-common">
+    <label for="node-input-controlTopic"><i class="fa fa-tag"></i> Control topic</label>
+    <input type="text" id="node-input-controlTopic">
+  </div>
+
+  <div class="form-row rate-config-common">
+    <label for="node-input-statInterval"><i class="fa fa-clock-o"></i> Stats every (s)</label>
+    <input type="number" min="0" id="node-input-statInterval" placeholder="0 = off">
+  </div>
+
+  <div class="form-row rate-config-common">
+    <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> With Input</label>
+    <input type="text" id="node-input-payloadPropName">
+  </div>
+
+  <div class="form-row rate-config-common">
+    <label for="node-input-translatorConfig"><i class="fa fa-language"></i> Translator</label>
+    <input type="text" id="node-input-translatorConfig">
+  </div>
+
+  <div class="form-row rate-config-section rate-config-debounce">
+    <label for="node-input-wait"><i class="fa fa-hourglass-o"></i> Wait (ms)</label>
+    <input type="number" id="node-input-wait" min="0">
+  </div>
+
+  <div class="form-row rate-config-section rate-config-debounce">
+    <label for="node-input-emitOn"><i class="fa fa-exchange"></i> Emit</label>
+    <select id="node-input-emitOn">
+      <option value="leading">Leading edge</option>
+      <option value="trailing">Trailing edge</option>
+      <option value="both">Both</option>
+    </select>
+  </div>
+
+  <div class="form-row rate-config-section rate-config-throttle">
+    <label for="node-input-interval"><i class="fa fa-hourglass-start"></i> Interval (ms)</label>
+    <input type="number" id="node-input-interval" min="0">
+  </div>
+
+  <div class="form-row rate-config-section rate-config-throttle">
+    <label for="node-input-trailing"><i class="fa fa-arrow-circle-right"></i> Emit trailing</label>
+    <input type="checkbox" id="node-input-trailing" style="width:auto; margin-top:7px;">
+  </div>
+
+  <div class="form-row rate-config-section rate-config-window">
+    <label for="node-input-windowSize"><i class="fa fa-arrows-h"></i> Window size (ms)</label>
+    <input type="number" id="node-input-windowSize" min="0">
+  </div>
+
+  <div class="form-row rate-config-section rate-config-window">
+    <label for="node-input-maxInWindow"><i class="fa fa-filter"></i> Max messages</label>
+    <input type="number" id="node-input-maxInWindow" min="1">
+  </div>
+
+  <div class="form-row rate-config-section rate-config-window">
+    <label for="node-input-dropStrategy"><i class="fa fa-random"></i> On limit</label>
+    <select id="node-input-dropStrategy">
+      <option value="drop">Drop</option>
+      <option value="queue">Queue last</option>
+    </select>
+  </div>
+</script>
+
+<script type="text/markdown" data-help-name="RateLimiterUltimate">
+The purpose of this node is to moderate the frequency of incoming messages.
+
+**Modes**
+
+- **Debounce** – waits for the line to be quiet before forwarding the final message. With *Leading* it emits the first message immediately and blocks the following ones until the delay ends; *Trailing* sends only the last message; *Both* combines both behaviours.
+- **Throttle** – enforces a minimum interval between consecutive messages. When *Emit trailing* is enabled the most recent message is forwarded once the interval has elapsed.
+- **Window** – limits the number of messages in a moving time window. Extra messages can be dropped or queued to play once a slot becomes available.
+
+**Outputs**
+
+- Output 1: messages that pass the limiter.
+- Output 2: diagnostic events `{ payload: { mode, reason, passed, dropped, msg, propertyValue } }` and periodic statistics (`controlTopic/stats`).
+
+**Control messages** (when `msg.topic` equals the *Control topic*):
+
+- `msg.reset = true` – clears counters and buffers.
+- `msg.flush = true` – forces emission of the pending message, if any.
+- `msg.mode = 'debounce'|'throttle'|'window'` – changes mode at runtime.
+- `msg.interval`, `msg.wait`, `msg.windowSize`, `msg.maxInWindow` – adjust the related thresholds.
+
+The **With Input** field selects which message property to evaluate (default `msg.payload`). When configured, it can be translated through the **translator-config** node for Home Assistant compatibility.
+</script>