From dbb5f8fce810c4c5f860f282d129a4bfff65ebbb Mon Sep 17 00:00:00 2001
From: Victor Giers <mail@victorgiers.com>
Date: Wed, 22 Apr 2026 18:29:31 +0200
Subject: [PATCH] auto-git:  [change] tests/domain/scene-paths.test.ts

---
 tests/domain/scene-paths.test.ts | 57 ++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/tests/domain/scene-paths.test.ts b/tests/domain/scene-paths.test.ts
index 065cbc69..eb63df82 100644
--- a/tests/domain/scene-paths.test.ts
+++ b/tests/domain/scene-paths.test.ts
@@ -3,6 +3,7 @@ import { describe, expect, it } from "vitest";
 import {
   createScenePath,
   getScenePathLength,
+  resolveNearestPointOnResolvedScenePath,
   resolveScenePath,
   sampleResolvedScenePathPosition,
   sampleResolvedScenePathTangent,
@@ -176,4 +177,60 @@ describe("scene paths", () => {
     expect(smoothedTangent.x).toBeGreaterThan(0);
     expect(smoothedTangent.z).toBeGreaterThan(0);
   });
+
+  it("projects world points onto the nearest resolved path segment and returns progress", () => {
+    const path = createScenePath({
+      id: "path-nearest-point",
+      points: [
+        {
+          id: "point-a",
+          position: {
+            x: 0,
+            y: 0,
+            z: 0
+          }
+        },
+        {
+          id: "point-b",
+          position: {
+            x: 0,
+            y: 0,
+            z: 4
+          }
+        },
+        {
+          id: "point-c",
+          position: {
+            x: 6,
+            y: 0,
+            z: 4
+          }
+        }
+      ]
+    });
+    const resolvedPath = resolveScenePath(path);
+
+    expect(
+      resolveNearestPointOnResolvedScenePath(resolvedPath, {
+        x: 2,
+        y: 0,
+        z: 5
+      })
+    ).toEqual({
+      progress: 0.6,
+      distance: 1,
+      distanceAlongPath: 6,
+      segmentIndex: 1,
+      position: {
+        x: 2,
+        y: 0,
+        z: 4
+      },
+      tangent: {
+        x: 1,
+        y: 0,
+        z: 0
+      }
+    });
+  });
 });