plugins: in/out transform (#1021)

Author: naltatis

docs/devices/plugins.mdx

@@ -484,9 +484,15 @@ charger:
         // maxcurrent Variable ist automatisch verfügbar
 ```
 
-#### Input-Transformationen verwenden
+#### Input- und Output-Transformationen {#transformations}
+
+Die `go` und `js` Plugins unterstützen `in` und `out` Parameter, um Daten aus anderen Quellen als Variablen im Script zu verwenden bzw. das Ergebnis an andere Plugins weiterzuleiten.
+
+##### Input-Transformationen (`in`)
 
 Mit dem `in` Parameter können Werte aus anderen Quellen als Variablen im Script verwendet werden.
+Jeder Eintrag benötigt `name` (Variablenname im Script), `type` (`bool`, `int`, `float`, `string`) und `config` (Plugin-Konfiguration).
+
 Dieses Beispiel zeigt eine bedingte Logik, die mit den einfachen Calc-Operationen nicht möglich ist:
 
 ```yaml
@@ -514,6 +520,29 @@ power:
         value: false
 ```
 
+##### Output-Transformationen (`out`)
+
+Mit dem `out` Parameter kann das Ergebnis eines Scripts an andere Plugins weitergeleitet werden.
+Dies ist besonders nützlich im Schreibkontext, wenn das Script-Ergebnis z. B. per MQTT oder HTTP weiterverarbeitet werden soll.
+Jeder Eintrag benötigt `name`, `type` und `config` — analog zu `in`.
+
+```yaml
+chargers:
+  - name: smart-heater
+    type: custom
+    maxcurrent:
+      source: go
+      script: |
+        watts := maxcurrent * 230
+        watts
+      out:
+        - name: watts
+          type: float
+          config:
+            source: mqtt
+            topic: heater/target_power
+```
+
 ### HTTP <Tag label="lesen" category="read" /> <Tag label="schreiben" category="write" /> {#http}
 
 Das `http`-Plugin führt HTTP Aufrufe durch, um Daten zu lesen oder zu aktualisieren.
@@ -641,6 +670,8 @@ charger:
         console.log(maxcurrent);
 ```
 
+Das `js` Plugin unterstützt dieselben [Input- und Output-Transformationen](#transformations) (`in`/`out`) wie das `go` Plugin.
+
 ### Modbus <Tag label="lesen" category="read" /> <Tag label="schreiben" category="write" /> {#modbus}
 
 Das `modbus`-Plugin kann Daten von jedem Modbus-fähigen Gerät oder SunSpec-kompatiblen Wechselrichter lesen.

i18n/en/docusaurus-plugin-content-docs/current/devices/plugins.mdx

@@ -484,9 +484,15 @@ charger:
         // maxcurrent variable is automatically available
 ```
 
-#### Using Input Transformations
+#### Input and Output Transformations {#transformations}
+
+The `go` and `js` plugins support `in` and `out` parameters to use values from other sources as variables in the script or to forward the script result to other plugins.
+
+##### Input Transformations (`in`)
 
 The `in` parameter allows you to use values from other sources as variables in your script.
+Each entry requires `name` (variable name in the script), `type` (`bool`, `int`, `float`, `string`) and `config` (plugin configuration).
+
 This example shows conditional logic that cannot be achieved with simple Calc operations:
 
 ```yaml
@@ -514,6 +520,29 @@ power:
         value: false
 ```
 
+##### Output Transformations (`out`)
+
+The `out` parameter forwards the script result to other plugins.
+This is particularly useful in a writing context, e.g. when the script result should be further processed via MQTT or HTTP.
+Each entry requires `name`, `type` and `config` — analogous to `in`.
+
+```yaml
+chargers:
+  - name: smart-heater
+    type: custom
+    maxcurrent:
+      source: go
+      script: |
+        watts := maxcurrent * 230
+        watts
+      out:
+        - name: watts
+          type: float
+          config:
+            source: mqtt
+            topic: heater/target_power
+```
+
 ### HTTP <Tag label="read" category="read" /> <Tag label="write" category="write" /> {#http}
 
 The `http` plugin performs HTTP calls to read or update data.
@@ -641,6 +670,8 @@ charger:
         console.log(maxcurrent);
 ```
 
+The `js` plugin supports the same [input and output transformations](#transformations) (`in`/`out`) as the `go` plugin.
+
 ### Modbus <Tag label="read" category="read" /> <Tag label="write" category="write" /> {#modbus}
 
 The `modbus` plugin can read data from any Modbus-capable device or SunSpec-compatible inverter.