Add documentation for valid plugin (#912)

Co-authored-by: Claude <noreply@anthropic.com>

Author: naltatis

docs/devices/plugins.mdx

@@ -34,6 +34,7 @@ Neben diesen Integrations-Plugins, gibt es noch Helfer-Plugins, die Zusatzfunkti
 - [Const Plugin](#const) - Spezielles Plugin das einfach einen konstanten Wert zurückliefert.
 - [Calc Plugin](#calc) - Meta-Plugin um Ausgaben von anderen Plugins arithmetisch zu verknüpfen.
 - [Combined Plugin](#combined) - Meta-Plugin speziell für `charger` um die booleschen Status-Werte für den angeschlossenen (_plugged_) und ladenden (_charging_) Zustand zu einem einzigen Ladestatus zu kombinieren.
+- [Valid Plugin](#valid) - Meta-Plugin um Plugin-Werte basierend auf einer booleschen Validierung bereitzustellen.
 
 ### Syntax
 
@@ -555,3 +556,26 @@ charging:
   source: mqtt
   topic: openWB/lp/1/boolChargeStat
 ```
+
+### Valid <Tag label="lesen" category="read" /> {#valid}
+
+Das `valid` Plugin ermöglicht es, Plugin-Werte basierend auf einer booleschen Validierung bereitzustellen.
+Es trennt die Gültigkeit eines Werts von dessen eigenem Inhalt.
+Wenn die Validierung `false` zurückgibt, wird der Wert als nicht verfügbar betrachtet.
+
+Dies ist besonders nützlich für Integrationen wie ioBroker, die Gültigkeit und Wert getrennt bereitstellen.
+
+**Beispiel Lesen**:
+
+```yaml
+source: valid
+valid:
+  source: mqtt
+  topic: iobroker/wallbox/power/valid
+value:
+  source: mqtt
+  topic: iobroker/wallbox/power/value
+```
+
+In diesem Beispiel wird der Wert nur verwendet, wenn das `valid` Topic `true` zurückgibt.
+Wenn es `false` zurückgibt, wird der Wert als nicht verfügbar markiert.

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

@@ -34,6 +34,7 @@ In addition to these integration plugins, there are also helper plugins that pro
 - [Const Plugin](#const) - Special plugin that simply returns a constant value.
 - [Calc Plugin](#calc) - Meta-plugin for arithmetically linking outputs from other plugins.
 - [Combined Plugin](#combined) - Meta-plugin specifically for `charger` to combine the boolean status values for the connected (_plugged_) and charging (_charging_) state into a single charging status.
+- [Valid Plugin](#valid) - Meta-plugin for providing plugin values based on boolean validation.
 
 ### Syntax
 
@@ -555,3 +556,26 @@ charging:
   source: mqtt
   topic: openWB/lp/1/boolChargeStat
 ```
+
+### Valid <Tag label="read" category="read" /> {#valid}
+
+The `valid` plugin allows providing plugin values based on boolean validation.
+It separates the validity of a value from its actual content.
+If the validation returns `false`, the value is considered unavailable.
+
+This is particularly useful for integrations like ioBroker that provide validity and value separately.
+
+**Reading Example**:
+
+```yaml
+source: valid
+valid:
+  source: mqtt
+  topic: iobroker/wallbox/power/valid
+value:
+  source: mqtt
+  topic: iobroker/wallbox/power/value
+```
+
+In this example, the value is only used when the `valid` topic returns `true`.
+If it returns `false`, the value is marked as unavailable.