From 0026d1521bd64a16b6783856cad3a2f087bfd851 Mon Sep 17 00:00:00 2001
From: Victor Giers <mail@victorgiers.com>
Date: Sat, 25 Apr 2026 18:01:41 +0200
Subject: [PATCH] Add isLineSegmentClear method for checking collision
 clearance along a line segment

---
 src/runtime-three/rapier-collision-world.ts | 43 +++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/src/runtime-three/rapier-collision-world.ts b/src/runtime-three/rapier-collision-world.ts
index b66e0cb2..cf00601b 100644
--- a/src/runtime-three/rapier-collision-world.ts
+++ b/src/runtime-three/rapier-collision-world.ts
@@ -835,6 +835,49 @@ export class RapierCollisionWorld {
     return !intersects;
   }
 
+  isLineSegmentClear(
+    start: Vec3,
+    end: Vec3,
+    options: { targetClearance?: number } = {}
+  ): boolean {
+    const delta = {
+      x: end.x - start.x,
+      y: end.y - start.y,
+      z: end.z - start.z
+    };
+    const distance = Math.hypot(delta.x, delta.y, delta.z);
+
+    if (distance <= COLLISION_EPSILON) {
+      return true;
+    }
+
+    const maxToi = Math.max(
+      0,
+      distance - Math.max(0, options.targetClearance ?? 0)
+    );
+
+    if (maxToi <= COLLISION_EPSILON) {
+      return true;
+    }
+
+    const ray = new RAPIER.Ray(start, {
+      x: delta.x / distance,
+      y: delta.y / distance,
+      z: delta.z / distance
+    });
+
+    return (
+      this.world.castRay(
+        ray,
+        maxToi,
+        true,
+        undefined,
+        undefined,
+        this.playerCollider ?? undefined
+      ) === null
+    );
+  }
+
   resolveThirdPersonCameraCollision(
     pivot: Vec3,
     desiredCameraPosition: Vec3,