From 123b4dea841fbe9b2cd7dc4193e6c3169a1e7e28 Mon Sep 17 00:00:00 2001
From: rushabhcodes <mail@rushabh.dev>
Date: Sun, 14 Dec 2025 15:29:55 +0530
Subject: [PATCH 1/2] fix: add zOffsetFromSurface property to cadmodel
 documentation

---
 docs/elements/cadmodel.mdx | 43 ++++++++++++++++++++++++++++++++++++--
 1 file changed, 41 insertions(+), 2 deletions(-)

diff --git a/docs/elements/cadmodel.mdx b/docs/elements/cadmodel.mdx
index 948f8fd..e9a89e4 100644
--- a/docs/elements/cadmodel.mdx
+++ b/docs/elements/cadmodel.mdx
@@ -33,7 +33,7 @@ import CircuitPreview from "@site/src/components/CircuitPreview"
 
 ## Repositioning the Model
 
-You can use `positionOffset` and `rotationOffset` to reposition the model.
+You can use `positionOffset`, `rotationOffset`, and `zOffsetFromSurface` to reposition the model.
 
 <CircuitPreview
   defaultView="3d"
@@ -59,6 +59,33 @@ You can use `positionOffset` and `rotationOffset` to reposition the model.
   `}
 />
 
+### Z-Offset from Surface
+
+Use `zOffsetFromSurface` to control the vertical distance of the model from the PCB surface. This is useful for components that need to be positioned above or below the board surface.
+
+<CircuitPreview
+  defaultView="3d"
+  hidePCBTab
+  hideSchematicTab
+  browser3dView={false}
+  code={`
+  export default () => (
+    <board>
+      <chip
+        name="U1"
+        footprint="soic8"
+        cadModel={
+          <cadmodel
+            zOffsetFromSurface="2mm"
+            modelUrl="https://modelcdn.tscircuit.com/jscad_models/soic8.glb"
+          />
+        }
+      />
+    </board>
+  )
+  `}
+/>
+
 ## Importing local GLB models
 
 <CircuitPreview
@@ -131,4 +158,16 @@ The following model file formats are supported:
 - GLTF
 - OBJ
 - STEP
-- STL
\ No newline at end of file
+- STL
+
+## Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `modelUrl` | `string` | URL to the 3D model file (GLB, GLTF, OBJ, STL, STEP, WRL) |
+| `stepUrl` | `string` | URL to a STEP model file for export purposes |
+| `positionOffset` | `{x: number, y: number, z: number}` | Offset the model position from the component center |
+| `rotationOffset` | `number \| {x: number, y: number, z: number}` | Rotate the model (number = Z-axis rotation in degrees) |
+| `zOffsetFromSurface` | `Distance` | Vertical offset from the PCB surface (e.g., "2mm", "0.1in") |
+| `size` | `{x: number, y: number, z: number}` | Scale the model size |
+| `modelUnitToMmScale` | `Distance` | Scale factor to convert model units to millimeters |
\ No newline at end of file

From bff142dac82d5c4c43b00b497303ce6053cb4d4a Mon Sep 17 00:00:00 2001
From: rushabhcodes <mail@rushabh.dev>
Date: Sun, 14 Dec 2025 15:44:43 +0530
Subject: [PATCH 2/2] fix: add WRL format support to cadmodel documentation

---
 docs/elements/cadmodel.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/elements/cadmodel.mdx b/docs/elements/cadmodel.mdx
index e9a89e4..ccce455 100644
--- a/docs/elements/cadmodel.mdx
+++ b/docs/elements/cadmodel.mdx
@@ -159,6 +159,7 @@ The following model file formats are supported:
 - OBJ
 - STEP
 - STL
+- WRL
 
 ## Properties