From 139186ebc434dd8e782bcc4b4c1a6582510d4bc4 Mon Sep 17 00:00:00 2001
From: Victor Giers <mail@victorgiers.com>
Date: Tue, 31 Mar 2026 06:47:21 +0200
Subject: [PATCH] Add interaction source entity types and helper functions

---
 src/app/App.tsx | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/src/app/App.tsx b/src/app/App.tsx
index 7113bea3..56673a8d 100644
--- a/src/app/App.tsx
+++ b/src/app/App.tsx
@@ -77,6 +77,7 @@ import {
 import { STARTER_MATERIAL_LIBRARY, type MaterialDef } from "../materials/starter-material-library";
 import { RunnerCanvas } from "../runner-web/RunnerCanvas";
 import type { FirstPersonTelemetry } from "../runtime-three/navigation-controller";
+import type { RuntimeInteractionPrompt } from "../runtime-three/runtime-interaction-system";
 import { buildRuntimeSceneFromDocument, type RuntimeNavigationMode, type RuntimeSceneDefinition } from "../runtime-three/runtime-scene-build";
 import { validateRuntimeSceneBuild } from "../runtime-three/runtime-scene-validation";
 import { Panel } from "../shared-ui/Panel";
@@ -101,6 +102,8 @@ interface Vec3Draft {
   z: string;
 }
 
+type InteractionSourceEntity = Extract<EntityInstance, { kind: "triggerVolume" | "interactable" }>;
+
 const FACE_LABELS: Record<BoxFaceId, string> = {
   posX: "+X Right",
   negX: "-X Left",
@@ -293,7 +296,14 @@ function describeSelection(selection: EditorSelection, brushes: BoxBrush[], enti
 }
 
 function getInteractionTriggerLabel(trigger: InteractionTriggerKind): string {
-  return trigger === "enter" ? "On Enter" : "On Exit";
+  switch (trigger) {
+    case "enter":
+      return "On Enter";
+    case "exit":
+      return "On Exit";
+    case "click":
+      return "On Click";
+  }
 }
 
 function getInteractionActionLabel(link: InteractionLink): string {
@@ -340,6 +350,16 @@ function getDefaultTriggerVolumeLinkTrigger(triggerOnEnter: boolean, triggerOnEx
   return "enter";
 }
 
+function isInteractionSourceEntity(entity: EntityInstance | null): entity is InteractionSourceEntity {
+  return entity !== null && (entity.kind === "triggerVolume" || entity.kind === "interactable");
+}
+
+function getDefaultInteractionLinkTrigger(sourceEntity: InteractionSourceEntity): InteractionTriggerKind {
+  return sourceEntity.kind === "triggerVolume"
+    ? getDefaultTriggerVolumeLinkTrigger(sourceEntity.triggerOnEnter, sourceEntity.triggerOnExit)
+    : "click";
+}
+
 function getErrorMessage(error: unknown): string {
   if (error instanceof Error) {
     return error.message;