From 4c36f058219c773ac11ceac52977320e3aae40bb Mon Sep 17 00:00:00 2001
From: Victor Giers <mail@victorgiers.com>
Date: Fri, 1 May 2026 16:50:10 +0200
Subject: [PATCH] auto-git:  [change] tests/unit/player-edge-assist.test.ts

---
 tests/unit/player-edge-assist.test.ts | 84 +++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)

diff --git a/tests/unit/player-edge-assist.test.ts b/tests/unit/player-edge-assist.test.ts
index a1c4e083..0a46b988 100644
--- a/tests/unit/player-edge-assist.test.ts
+++ b/tests/unit/player-edge-assist.test.ts
@@ -2,6 +2,7 @@ import { describe, expect, it } from "vitest";
 
 import { FIRST_PERSON_PLAYER_SHAPE } from "../../src/runtime-three/player-collision";
 import {
+  resolvePlayerLedgeGrabTarget,
   resolvePlayerEdgeAssistTopOut,
   shouldAttemptPlayerEdgeAssist
 } from "../../src/runtime-three/player-edge-assist";
@@ -112,4 +113,87 @@ describe("player edge assist", () => {
 
     expect(result).toBeNull();
   });
+
+  it("resolves an upper-body ledge grab target above push-to-top height", () => {
+    const topY = 2;
+    const result = resolvePlayerLedgeGrabTarget({
+      feetPosition: {
+        x: 0,
+        y: 1,
+        z: 0
+      },
+      shape: FIRST_PERSON_PLAYER_SHAPE,
+      direction: {
+        x: 0,
+        y: 0,
+        z: 1
+      },
+      pushToTopHeight: 0.55,
+      canOccupyShape: (feetPosition) =>
+        feetPosition.z <= 0.08 || feetPosition.y >= topY,
+      probeGround: (feetPosition, _shape, maxDistance) => {
+        const distance = feetPosition.y - topY;
+
+        return feetPosition.z > 0.1 && distance >= 0 && distance <= maxDistance
+          ? {
+              grounded: true,
+              distance,
+              normal: { x: 0, y: 1, z: 0 },
+              slopeDegrees: 0
+            }
+          : {
+              grounded: false,
+              distance: null,
+              normal: null,
+              slopeDegrees: null
+            };
+      }
+    });
+
+    expect(result).not.toBeNull();
+    expect(result?.standFeetPosition.y).toBeCloseTo(topY);
+    expect(result?.hangFeetPosition.y).toBeLessThan(
+      result?.standFeetPosition.y ?? 0
+    );
+    expect(result?.topOutHeight).toBeGreaterThan(0.55);
+    expect(result?.forwardDistance).toBeGreaterThan(0);
+  });
+
+  it("does not turn the push-to-top height band into a ledge grab", () => {
+    const topY = 1.35;
+    const result = resolvePlayerLedgeGrabTarget({
+      feetPosition: {
+        x: 0,
+        y: 1,
+        z: 0
+      },
+      shape: FIRST_PERSON_PLAYER_SHAPE,
+      direction: {
+        x: 0,
+        y: 0,
+        z: 1
+      },
+      pushToTopHeight: 0.55,
+      canOccupyShape: () => true,
+      probeGround: (feetPosition, _shape, maxDistance) => {
+        const distance = feetPosition.y - topY;
+
+        return distance >= 0 && distance <= maxDistance
+          ? {
+              grounded: true,
+              distance,
+              normal: { x: 0, y: 1, z: 0 },
+              slopeDegrees: 0
+            }
+          : {
+              grounded: false,
+              distance: null,
+              normal: null,
+              slopeDegrees: null
+            };
+      }
+    });
+
+    expect(result).toBeNull();
+  });
 });