webeditor3d/tests/domain/runtime-interaction-system.test.js

import { describe, expect, it } from "vitest";
import { createPlayAnimationInteractionLink, createPlaySoundInteractionLink, createTeleportPlayerInteractionLink, createToggleVisibilityInteractionLink, createStopAnimationInteractionLink, createStopSoundInteractionLink } from "../../src/interactions/interaction-links";
import { createDefaultWorldSettings } from "../../src/document/world-settings";
import { RuntimeInteractionSystem } from "../../src/runtime-three/runtime-interaction-system";
function createRuntimeSceneFixture() {
    return {
        world: {
            ...createDefaultWorldSettings(),
            background: {
                mode: "solid",
                colorHex: "#000000"
            },
            ambientLight: {
                colorHex: "#ffffff",
                intensity: 1
            },
            sunLight: {
                colorHex: "#ffffff",
                intensity: 1,
                direction: {
                    x: 0,
                    y: 1,
                    z: 0
                }
            }
        },
        brushes: [],
        colliders: [],
        sceneBounds: null,
        localLights: {
            pointLights: [],
            spotLights: []
        },
        modelInstances: [],
        entities: {
            playerStarts: [],
            soundEmitters: [
                {
                    entityId: "entity-sound-lobby",
                    position: {
                        x: 0,
                        y: 1,
                        z: 0
                    },
                    audioAssetId: "asset-audio-lobby",
                    volume: 0.75,
                    refDistance: 6,
                    maxDistance: 24,
                    autoplay: false,
                    loop: true
                }
            ],
            triggerVolumes: [
                {
                    entityId: "entity-trigger-main",
                    position: {
                        x: 0,
                        y: 0,
                        z: 0
                    },
                    size: {
                        x: 2,
                        y: 2,
                        z: 2
                    },
                    triggerOnEnter: true,
                    triggerOnExit: true
                }
            ],
            teleportTargets: [
                {
                    entityId: "entity-teleport-main",
                    position: {
                        x: 8,
                        y: 0,
                        z: -4
                    },
                    yawDegrees: 180
                }
            ],
            interactables: [
                {
                    entityId: "entity-interactable-console",
                    position: {
                        x: 0,
                        y: 1,
                        z: 1
                    },
                    radius: 2,
                    prompt: "Use Console",
                    enabled: true
                },
                {
                    entityId: "entity-interactable-disabled",
                    position: {
                        x: 0.25,
                        y: 1,
                        z: 1
                    },
                    radius: 2,
                    prompt: "Disabled Prompt",
                    enabled: false
                }
            ]
        },
        interactionLinks: [],
        playerStart: null,
        playerCollider: {
            mode: "capsule",
            radius: 0.3,
            height: 1.8,
            eyeHeight: 1.6
        },
        spawn: {
            source: "fallback",
            entityId: null,
            position: {
                x: 0,
                y: 0,
                z: 0
            },
            yawDegrees: 0
        }
    };
}
describe("RuntimeInteractionSystem", () => {
    it("dispatches teleport player on Trigger Volume enter", () => {
        const runtimeScene = createRuntimeSceneFixture();
        runtimeScene.interactionLinks = [
            createTeleportPlayerInteractionLink({
                id: "link-teleport",
                sourceEntityId: "entity-trigger-main",
                trigger: "enter",
                targetEntityId: "entity-teleport-main"
            })
        ];
        const interactionSystem = new RuntimeInteractionSystem();
        const dispatches = [];
        interactionSystem.updatePlayerPosition({
            x: 0,
            y: 0,
            z: 0
        }, runtimeScene, {
            teleportPlayer: (target, link) => {
                dispatches.push(`${link.id}:${target.entityId}:${target.position.x}`);
            },
            toggleBrushVisibility: () => {
                dispatches.push("toggle");
            },
            playAnimation: () => { },
            stopAnimation: () => { },
            playSound: () => { },
            stopSound: () => { }
        });
        interactionSystem.updatePlayerPosition({
            x: 0.25,
            y: 0,
            z: 0.25
        }, runtimeScene, {
            teleportPlayer: (target, link) => {
                dispatches.push(`${link.id}:${target.entityId}:${target.position.x}`);
            },
            toggleBrushVisibility: () => {
                dispatches.push("toggle");
            },
            playAnimation: () => { },
            stopAnimation: () => { },
            playSound: () => { },
            stopSound: () => { }
        });
        expect(dispatches).toEqual(["link-teleport:entity-teleport-main:8"]);
    });
    it("dispatches animation actions with the authored target model instance and clip", () => {
        const runtimeScene = createRuntimeSceneFixture();
        runtimeScene.interactionLinks = [
            createPlayAnimationInteractionLink({
                id: "link-play-animation",
                sourceEntityId: "entity-interactable-console",
                trigger: "click",
                targetModelInstanceId: "model-instance-animated",
                clipName: "Walk",
                loop: false
            }),
            createStopAnimationInteractionLink({
                id: "link-stop-animation",
                sourceEntityId: "entity-interactable-console",
                trigger: "click",
                targetModelInstanceId: "model-instance-animated"
            })
        ];
        const interactionSystem = new RuntimeInteractionSystem();
        const dispatches = [];
        interactionSystem.dispatchClickInteraction("entity-interactable-console", runtimeScene, {
            teleportPlayer: () => {
                throw new Error("Teleport should not dispatch in this fixture.");
            },
            toggleBrushVisibility: () => {
                throw new Error("Visibility should not dispatch in this fixture.");
            },
            playAnimation: (instanceId, clipName, loop, link) => {
                dispatches.push(`${link.id}:${instanceId}:${clipName}:${loop === false ? "once" : "loop"}`);
            },
            stopAnimation: (instanceId, link) => {
                dispatches.push(`${link.id}:${instanceId}`);
            },
            playSound: () => { },
            stopSound: () => { }
        });
        expect(dispatches).toEqual([
            "link-play-animation:model-instance-animated:Walk:once",
            "link-stop-animation:model-instance-animated"
        ]);
    });
    it("dispatches visibility actions only when exiting an occupied Trigger Volume", () => {
        const runtimeScene = createRuntimeSceneFixture();
        runtimeScene.interactionLinks = [
            createToggleVisibilityInteractionLink({
                id: "link-hide-door",
                sourceEntityId: "entity-trigger-main",
                trigger: "exit",
                targetBrushId: "brush-door",
                visible: false
            })
        ];
        const interactionSystem = new RuntimeInteractionSystem();
        const dispatches = [];
        interactionSystem.updatePlayerPosition({
            x: 0,
            y: 0,
            z: 0
        }, runtimeScene, {
            teleportPlayer: () => {
                throw new Error("Teleport should not dispatch in this fixture.");
            },
            toggleBrushVisibility: (brushId, visible) => {
                dispatches.push({
                    brushId,
                    visible
                });
            },
            playAnimation: () => { },
            stopAnimation: () => { },
            playSound: () => { },
            stopSound: () => { }
        });
        interactionSystem.updatePlayerPosition({
            x: 3,
            y: 0,
            z: 0
        }, runtimeScene, {
            teleportPlayer: () => {
                throw new Error("Teleport should not dispatch in this fixture.");
            },
            toggleBrushVisibility: (brushId, visible) => {
                dispatches.push({
                    brushId,
                    visible
                });
            },
            playAnimation: () => { },
            stopAnimation: () => { },
            playSound: () => { },
            stopSound: () => { }
        });
        expect(dispatches).toEqual([
            {
                brushId: "brush-door",
                visible: false
            }
        ]);
    });
    it("shows a click prompt only for enabled interactables with authored click links inside range", () => {
        const runtimeScene = createRuntimeSceneFixture();
        runtimeScene.interactionLinks = [
            createTeleportPlayerInteractionLink({
                id: "link-click-teleport",
                sourceEntityId: "entity-interactable-console",
                trigger: "click",
                targetEntityId: "entity-teleport-main"
            })
        ];
        const interactionSystem = new RuntimeInteractionSystem();
        expect(interactionSystem.resolveClickInteractionPrompt({
            x: 0,
            y: 1.6,
            z: 0
        }, {
            x: 0,
            y: 0,
            z: 1
        }, runtimeScene)).toEqual({
            sourceEntityId: "entity-interactable-console",
            prompt: "Use Console",
            distance: expect.any(Number),
            range: 2
        });
        expect(interactionSystem.resolveClickInteractionPrompt({
            x: 0,
            y: 1.6,
            z: 0
        }, {
            x: 1,
            y: 0,
            z: 0
        }, runtimeScene)).toBeNull();
    });
    it("dispatches click actions for the targeted Interactable", () => {
        const runtimeScene = createRuntimeSceneFixture();
        runtimeScene.interactionLinks = [
            createTeleportPlayerInteractionLink({
                id: "link-click-teleport",
                sourceEntityId: "entity-interactable-console",
                trigger: "click",
                targetEntityId: "entity-teleport-main"
            })
        ];
        const interactionSystem = new RuntimeInteractionSystem();
        const dispatches = [];
        interactionSystem.dispatchClickInteraction("entity-interactable-console", runtimeScene, {
            teleportPlayer: (target, link) => {
                dispatches.push(`${link.id}:${target.entityId}:${target.position.x}`);
            },
            toggleBrushVisibility: () => {
                throw new Error("Visibility should not dispatch for this click fixture.");
            },
            playAnimation: () => { },
            stopAnimation: () => { },
            playSound: () => { },
            stopSound: () => { }
        });
        expect(dispatches).toEqual(["link-click-teleport:entity-teleport-main:8"]);
    });
    it("dispatches play and stop sound actions for the targeted Sound Emitter", () => {
        const runtimeScene = createRuntimeSceneFixture();
        runtimeScene.interactionLinks = [
            createPlaySoundInteractionLink({
                id: "link-play-sound",
                sourceEntityId: "entity-interactable-console",
                trigger: "click",
                targetSoundEmitterId: "entity-sound-lobby"
            }),
            createStopSoundInteractionLink({
                id: "link-stop-sound",
                sourceEntityId: "entity-interactable-console",
                trigger: "click",
                targetSoundEmitterId: "entity-sound-lobby"
            })
        ];
        const interactionSystem = new RuntimeInteractionSystem();
        const dispatches = [];
        interactionSystem.dispatchClickInteraction("entity-interactable-console", runtimeScene, {
            teleportPlayer: () => {
                throw new Error("Teleport should not dispatch in this fixture.");
            },
            toggleBrushVisibility: () => {
                throw new Error("Visibility should not dispatch in this fixture.");
            },
            playAnimation: () => {
                throw new Error("Animation should not dispatch in this fixture.");
            },
            stopAnimation: () => {
                throw new Error("Animation should not dispatch in this fixture.");
            },
            playSound: (soundEmitterId, link) => {
                dispatches.push(`${link.id}:${soundEmitterId}`);
            },
            stopSound: (soundEmitterId, link) => {
                dispatches.push(`${link.id}:${soundEmitterId}`);
            }
        });
        expect(dispatches).toEqual(["link-play-sound:entity-sound-lobby", "link-stop-sound:entity-sound-lobby"]);
    });
});