From f736db271f348a724ee616abb3751eb4748602d4 Mon Sep 17 00:00:00 2001
From: ShiboSoftwareDev <shibosoftwaredev@gmail.com>
Date: Fri, 14 Nov 2025 17:36:05 +0200
Subject: [PATCH] feat(docs): add half-wave rectifier SPICE example

---
 .../spice-simulation/Diodes/_category_.json   |  6 ++
 .../Diodes/half-wave-rectifier.mdx            | 55 +++++++++++++++++++
 .../spice-simulation/boost-converter.mdx      |  2 +-
 .../spice-simulation/rc-charging-circuit.mdx  |  2 +-
 .../spice-simulation/switch-example.mdx       |  2 +-
 5 files changed, 64 insertions(+), 3 deletions(-)
 create mode 100644 docs/guides/spice-simulation/Diodes/_category_.json
 create mode 100644 docs/guides/spice-simulation/Diodes/half-wave-rectifier.mdx

diff --git a/docs/guides/spice-simulation/Diodes/_category_.json b/docs/guides/spice-simulation/Diodes/_category_.json
new file mode 100644
index 0000000..081b92c
--- /dev/null
+++ b/docs/guides/spice-simulation/Diodes/_category_.json
@@ -0,0 +1,6 @@
+{
+  "label": "Diodes",
+  "position": 2,
+  "collapsible": true,
+  "collapsed": true
+}
diff --git a/docs/guides/spice-simulation/Diodes/half-wave-rectifier.mdx b/docs/guides/spice-simulation/Diodes/half-wave-rectifier.mdx
new file mode 100644
index 0000000..c79f16e
--- /dev/null
+++ b/docs/guides/spice-simulation/Diodes/half-wave-rectifier.mdx
@@ -0,0 +1,55 @@
+---
+title: Half-Wave Rectifier Example
+sidebar_label: Half-Wave Rectifier
+sidebar_position: 1
+description: An example of a half-wave rectifier circuit for SPICE simulation.
+---
+import CircuitPreview from "@site/src/components/CircuitPreview"
+
+<p>
+  This example demonstrates a half-wave rectifier. The diode allows current to
+  flow in only one direction, effectively cutting off the negative portion of
+  the AC input sine wave. The two voltage probes allow for a comparison of
+  the input and output waveforms.
+</p>
+<CircuitPreview
+  defaultView="schematic"
+  hidePCBTab={true}
+  hide3DTab={true}
+  verticalStack={true}
+  showSimulationGraph={true}
+  code={`
+export default () => (
+      <board schMaxTraceDistance={10} routingDisabled>
+        <voltagesource
+          name="V1"
+          voltage="5V"
+          frequency="40Hz"
+          waveShape="sinewave"
+        />
+        <diode name="D1" />
+        <resistor name="R1" resistance="640ohm" />
+
+        <trace from=".V1 > .pin1" to=".D1 > .anode" />
+        <trace from=".D1 > .cathode" to=".R1 > .pin1" />
+
+        <trace from=".V1 > .pin2" to=".R1 > .pin2" />
+
+        <voltageprobe name="VP_IN" connectsTo=".V1 > .pin1" />
+        <voltageprobe name="VP_OUT" connectsTo=".R1 > .pin1" />
+
+        <analogsimulation
+          duration="50ms"
+          timePerStep="0.1ms"
+          spiceEngine="ngspice"
+        />
+      </board>
+)
+`}
+/>
+<p>
+  The simulation graph shows the input sine wave and the rectified output.
+  The output voltage follows the positive half of the input sine wave and is
+  approximately 0V during the negative half, demonstrating the rectifying
+  action of the diode.
+</p>
diff --git a/docs/guides/spice-simulation/boost-converter.mdx b/docs/guides/spice-simulation/boost-converter.mdx
index ce5de14..42d43d0 100644
--- a/docs/guides/spice-simulation/boost-converter.mdx
+++ b/docs/guides/spice-simulation/boost-converter.mdx
@@ -1,7 +1,7 @@
 ---
 title: Boost Converter Example
 sidebar_label: Boost Converter
-sidebar_position: 2
+sidebar_position: 3
 description: An example of a boost converter circuit configured for SPICE simulation.
 ---
 import CircuitPreview from "@site/src/components/CircuitPreview"
diff --git a/docs/guides/spice-simulation/rc-charging-circuit.mdx b/docs/guides/spice-simulation/rc-charging-circuit.mdx
index 3c5096e..517f06f 100644
--- a/docs/guides/spice-simulation/rc-charging-circuit.mdx
+++ b/docs/guides/spice-simulation/rc-charging-circuit.mdx
@@ -1,7 +1,7 @@
 ---
 title: RC Charging Circuit Example
 sidebar_label: RC Charging Circuit
-sidebar_position: 3
+sidebar_position: 4
 description: An example of an RC charging circuit configured for SPICE simulation.
 ---
 import CircuitPreview from "@site/src/components/CircuitPreview"
diff --git a/docs/guides/spice-simulation/switch-example.mdx b/docs/guides/spice-simulation/switch-example.mdx
index 9a41aaa..7214580 100644
--- a/docs/guides/spice-simulation/switch-example.mdx
+++ b/docs/guides/spice-simulation/switch-example.mdx
@@ -1,7 +1,7 @@
 ---
 title: Switch Example
 sidebar_label: Switch
-sidebar_position: 4
+sidebar_position: 5
 description: An example of using a switch in a SPICE simulation.
 ---
 import CircuitPreview from "@site/src/components/CircuitPreview"