@directivegames/genesys.js 3.1.24

package/dist/src/components/visual/TerrainMeshComponent.js

@@ -0,0 +1,309 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var TerrainMeshComponent_1;
+/**
+ * TerrainMeshComponent procedurally generates a height-mapped terrain mesh.
+ *
+ * At creation it builds a plane geometry and displaces vertices using either
+ * random or Perlin noise. Options control size, segment resolution, noise scale
+ * and seed. The component can regenerate the terrain or query height values at
+ * runtime, and it integrates with physics when enabled to create a static
+ * collision body.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Call `generateTerrain` when changing dimensions or noise parameters.
+ * - Retrieve heights via `getHeightAt` for gameplay checks.
+ * - Use `uvScaleTilesPerUnit` so materials tile correctly over large areas.
+ */
+import * as THREE from 'three';
+import { MaterialUtils } from '../../materials.js';
+import { PhysicsMotionType } from '../../physics/PhysicsTypes.js';
+import { EngineClass } from '../../systems/ClassRegistry.js';
+import Perlin from '../../utils/Perlin.js';
+import { resourceManager } from '../../utils/ResourceManager.js';
+import { PrimitiveComponent } from '../PrimitiveComponent.js';
+let TerrainMeshComponent = TerrainMeshComponent_1 = class TerrainMeshComponent extends PrimitiveComponent {
+    static get DEFAULT_OPTIONS() {
+        return {
+            ...PrimitiveComponent.DEFAULT_OPTIONS,
+            width: 200,
+            depth: 200,
+            widthSegments: 200,
+            depthSegments: 200,
+            maxHeight: 5,
+            material: undefined,
+            noiseType: 'perlin',
+            noiseFrequency: 0.1,
+            noiseSeed: 100,
+            physicsOptions: {
+                enabled: true,
+                motionType: PhysicsMotionType.Static,
+                density: 1
+            }
+        };
+    }
+    /**
+       * Creates a new TerrainMeshComponent instance
+       * @param options Configuration options for the terrain
+       * @param options.width Width of the terrain in world units
+       * @param options.depth Depth of the terrain in world units
+       * @param options.widthSegments Number of segments along the width
+       * @param options.depthSegments Number of segments along the depth
+       * @param options.maxHeight Maximum height of the terrain
+       * @param options.material Material to use for the terrain (defaults to MeshStandardMaterial)
+       * @param options.noiseType Type of noise to use for terrain generation ('random' or 'perlin')
+       * @param options.noiseFrequency Frequency of the noise (default: 1)
+       * @param options.noiseSeed Seed for noise generation (default: random)
+       */
+    constructor(options = TerrainMeshComponent_1.DEFAULT_OPTIONS) {
+        options.material = options.material ?? new THREE.MeshStandardMaterial();
+        // Call the parent constructor
+        super(options);
+        Object.defineProperty(this, "heightMap", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "mesh", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        // Create a placeholder geometry initially
+        const geometry = new THREE.PlaneGeometry(1, 1, 1, 1);
+        this.mesh = new THREE.Mesh(geometry);
+        this.bindObject3DProperties(this.mesh, ['castShadow', 'receiveShadow']);
+        this.add(this.mesh);
+        if (options.material) {
+            this.setMaterial(options.material);
+        }
+        this.generateTerrain();
+    }
+    /**
+       * Gets the underlying Three.js mesh object
+       * @returns The Three.js Mesh instance representing the terrain
+       */
+    getMesh() {
+        return this.mesh;
+    }
+    /**
+       * Sets the material for the terrain mesh
+       * @param material The new material to apply
+       */
+    setMaterial(material) {
+        resourceManager.loadGenericMaterial(material).then((material) => {
+            if (material) {
+                this.mesh.material = material;
+            }
+        });
+    }
+    /**
+       * Applies the height map to the vertices
+       * @param vertices The vertices to modify
+       */
+    applyHeightMap(vertices) {
+        if (!this.heightMap)
+            return;
+        // Fix: Convert ArrayLike to a mutable array
+        const verticesArray = new Float32Array(vertices);
+        // Apply height map to the y-coordinate of each vertex
+        for (let i = 0; i < verticesArray.length; i += 3) {
+            const index = Math.floor(i / 3);
+            // Y is the up axis after rotation
+            verticesArray[i + 1] = this.heightMap[index];
+        }
+        // Update the original buffer with our modified values
+        for (let i = 0; i < vertices.length; i++) {
+            vertices[i] = verticesArray[i];
+        }
+    }
+    /**
+       * Sets a new height map for the terrain
+       * @param heightMap New height map data
+       */
+    setHeightMap(heightMap) {
+        if (heightMap.length !== (this.options.widthSegments + 1) * (this.options.depthSegments + 1)) {
+            console.error('Height map size does not match terrain dimensions');
+            return;
+        }
+        this.heightMap = heightMap;
+        this.generateFromHeightMap();
+        if (this.options.uvScaleTilesPerUnit) {
+            MaterialUtils.scaleUVsBySize(this.mesh, this.options.uvScaleTilesPerUnit);
+        }
+    }
+    /**
+       * Generates a height map using Perlin noise
+       * @param scale Scale of the noise
+       * @param maxHeight Maximum height of the terrain (defaults to the component's maxHeight)
+       */
+    generateTerrain(frequency, maxHeight, seed, noiseType) {
+        frequency = frequency ?? this.options.noiseFrequency ?? 1;
+        maxHeight = maxHeight ?? this.options.maxHeight;
+        seed = seed ?? this.options.noiseSeed ?? Math.random();
+        noiseType = noiseType ?? this.options.noiseType;
+        const generator = new Perlin(seed);
+        // always recreate the height map to support regeneration
+        this.heightMap = new Float32Array((this.options.widthSegments + 1) * (this.options.depthSegments + 1));
+        // Generate heights using noise
+        if (noiseType === 'random') {
+            let index = 0;
+            for (let z = 0; z <= this.options.depthSegments; z++) {
+                for (let x = 0; x <= this.options.widthSegments; x++) {
+                    const height = generator.simplex2(x * frequency, z * frequency);
+                    this.heightMap[index++] = height * maxHeight;
+                }
+            }
+        }
+        else {
+            let index = 0;
+            for (let z = 0; z <= this.options.depthSegments; z++) {
+                for (let x = 0; x <= this.options.widthSegments; x++) {
+                    const height = generator.perlin2(x * frequency, z * frequency);
+                    this.heightMap[index++] = height * maxHeight;
+                }
+            }
+        }
+        this.generateFromHeightMap();
+        if (this.options.uvScaleTilesPerUnit) {
+            MaterialUtils.scaleUVsBySize(this.mesh, this.options.uvScaleTilesPerUnit);
+        }
+    }
+    generateFromHeightMap() {
+        // Create a plane geometry for the terrain
+        const geometry = new THREE.PlaneGeometry(this.options.width, this.options.depth, this.options.widthSegments, this.options.depthSegments);
+        // Rotate the plane to be horizontal (facing up)
+        geometry.rotateX(-Math.PI / 2);
+        // Get the position attribute from the geometry
+        const positionAttribute = geometry.getAttribute('position');
+        const vertices = positionAttribute.array;
+        // Apply the height map to the vertices
+        this.applyHeightMap(vertices);
+        // Update the position attribute
+        positionAttribute.needsUpdate = true;
+        // Update normals
+        geometry.computeVertexNormals();
+        // Set the new geometry
+        this.mesh.geometry.dispose();
+        this.mesh.geometry = geometry;
+    }
+    /**
+       * Sets the maximum height for the terrain
+       * @param height New maximum height
+       * @param regenerate Whether to regenerate the terrain with the new height
+       */
+    setMaxHeight(height, regenerate = true) {
+        this.options.maxHeight = height;
+        if (regenerate && this.heightMap) {
+            this.generateTerrain();
+        }
+    }
+    /**
+       * Gets the current maximum height setting
+       */
+    getMaxHeight() {
+        return this.options.maxHeight;
+    }
+    /**
+       * Updates the terrain with new dimensions
+       * @param width New width
+       * @param depth New depth
+       * @param widthSegments New width segments
+       * @param depthSegments New depth segments
+       */
+    updateTerrainDimensions(width, depth, widthSegments, depthSegments) {
+        if (width !== undefined)
+            this.options.width = width;
+        if (depth !== undefined)
+            this.options.depth = depth;
+        if (widthSegments !== undefined)
+            this.options.widthSegments = widthSegments;
+        if (depthSegments !== undefined)
+            this.options.depthSegments = depthSegments;
+        this.generateTerrain();
+    }
+    /**
+       * Gets the height at a specific world position
+       * @param x X coordinate in world space
+       * @param z Z coordinate in world space
+       * @returns Height at position or null if out of bounds
+       */
+    getHeightAt(x, z) {
+        if (!this.heightMap)
+            return null;
+        // Convert world coordinates to terrain coordinates
+        const localX = x + this.options.width / 2;
+        const localZ = z + this.options.depth / 2;
+        // Convert to UV coordinates (0-1)
+        const u = localX / this.options.width;
+        const v = localZ / this.options.depth;
+        // Check if the point is within the terrain bounds
+        if (u < 0 || u > 1 || v < 0 || v > 1) {
+            return null;
+        }
+        // Convert to grid coordinates
+        const gridX = Math.min(Math.floor(u * this.options.widthSegments), this.options.widthSegments - 1);
+        const gridZ = Math.min(Math.floor(v * this.options.depthSegments), this.options.depthSegments - 1);
+        // Get the index in the height map
+        const index = gridZ * (this.options.widthSegments + 1) + gridX;
+        return this.heightMap[index];
+    }
+    /**
+       * Gets the current height map data
+       * @returns Current height map array or null if not generated
+       */
+    getHeightMap() {
+        return this.heightMap;
+    }
+    /**
+       * Syncs the terrain with physics (currently does nothing)
+       * @param position Position vector (unused)
+       * @param quat Quaternion (unused)
+       * @returns This instance for chaining
+       */
+    syncFromPhysics(position, quat) {
+        return this;
+    }
+    //====================================================================================================
+    // Editor Functions
+    //====================================================================================================
+    getEditorClassIcon() {
+        return 'Icon_TerrainMesh';
+    }
+    onEditorPropertyChanged(path, value, result) {
+        super.onEditorPropertyChanged(path, value, result);
+        if (['width', 'depth', 'widthSegments', 'depthSegments', 'maxHeight', 'noiseType', 'noiseFrequency', 'noiseSeed', 'uvScaleTilesPerUnit'].includes(path)) {
+            this.generateTerrain();
+            return;
+        }
+        if (['material'].includes(path)) {
+            this.setMaterial(value);
+            return;
+        }
+    }
+};
+Object.defineProperty(TerrainMeshComponent, "EDITOR_CLASS_META", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: {
+        ...PrimitiveComponent.EDITOR_CLASS_META,
+        noiseType: { select: ['random', 'perlin'] },
+        material: { type: ['material'] },
+    }
+});
+TerrainMeshComponent = TerrainMeshComponent_1 = __decorate([
+    EngineClass('TerrainMeshComponent'),
+    __metadata("design:paramtypes", [Object])
+], TerrainMeshComponent);
+export { TerrainMeshComponent };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVGVycmFpbk1lc2hDb21wb25lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvY29tcG9uZW50cy92aXN1YWwvVGVycmFpbk1lc2hDb21wb25lbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7OztBQUFBOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxPQUFPLEtBQUssS0FBSyxNQUFNLE9BQU8sQ0FBQztBQUUvQixPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDbkQsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDbEUsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQzdELE9BQU8sTUFBTSxNQUFNLHVCQUF1QixDQUFDO0FBQzNDLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUNqRSxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQXVCdkQsSUFBTSxvQkFBb0IsNEJBQTFCLE1BQU0sb0JBQXFCLFNBQVEsa0JBQStDO0lBUXZGLE1BQU0sS0FBYyxlQUFlO1FBQ2pDLE9BQU87WUFDTCxHQUFHLGtCQUFrQixDQUFDLGVBQWU7WUFDckMsS0FBSyxFQUFFLEdBQUc7WUFDVixLQUFLLEVBQUUsR0FBRztZQUNWLGFBQWEsRUFBRSxHQUFHO1lBQ2xCLGFBQWEsRUFBRSxHQUFHO1lBQ2xCLFNBQVMsRUFBRSxDQUFDO1lBQ1osUUFBUSxFQUFFLFNBQVM7WUFDbkIsU0FBUyxFQUFFLFFBQVE7WUFDbkIsY0FBYyxFQUFFLEdBQUc7WUFDbkIsU0FBUyxFQUFFLEdBQUc7WUFDZCxjQUFjLEVBQUU7Z0JBQ2QsT0FBTyxFQUFFLElBQUk7Z0JBQ2IsVUFBVSxFQUFFLGlCQUFpQixDQUFDLE1BQU07Z0JBQ3BDLE9BQU8sRUFBRSxDQUFDO2FBQ1g7U0FDRixDQUFDO0lBQ0osQ0FBQztJQUtEOzs7Ozs7Ozs7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

package/dist/src/components/visual/UI3DComponent.d.ts

@@ -0,0 +1,60 @@
+import { IAsyncLoadableTag } from '../../utils/IAsyncLoadable.js';
+import { SceneComponent } from '../SceneComponent.js';
+import type { BaseUIComponent } from '../../ui/components/BaseUIComponent.js';
+import type { IAsyncLoadable } from '../../utils/IAsyncLoadable.js';
+import type { SceneComponentOptions } from '../SceneComponent.js';
+export interface UI3DComponentOptions extends SceneComponentOptions {
+    /** The BaseUIComponent instance to manage */
+    uiComponent?: BaseUIComponent<any>;
+    /** Margin from screen edges to hide the UI component */
+    screenMargin?: number;
+    /** Whether to hide the UI when the component is behind the camera */
+    hideWhenBehindCamera?: boolean;
+    /** Whether to clamp the UI position to screen bounds */
+    clampToScreenBounds?: boolean;
+    /** Screen space offset in pixels {x, y} */
+    screenOffset?: {
+        x: number;
+        y: number;
+    };
+    distanceScaling?: {
+        /** Base distance for scale calculation (scale = 1.0 at this distance) */
+        baseDistance: number;
+        /** Minimum scale factor */
+        minScale: number;
+        /** Maximum scale factor */
+        maxScale: number;
+    };
+}
+export declare class UI3DComponent extends SceneComponent<UI3DComponentOptions> implements IAsyncLoadable {
+    static get DEFAULT_OPTIONS(): UI3DComponentOptions;
+    readonly [IAsyncLoadableTag] = true;
+    private uiComponent;
+    private tempWorldPosition;
+    private tempCameraWorldPosition;
+    private tempScreenPosition;
+    private isUIComponentReady;
+    private _asyncTaskWorker;
+    constructor(options?: UI3DComponentOptions);
+    beginPlay(): void;
+    endPlay(): void;
+    waitForLoad(): Promise<void>;
+    isLoading(): boolean;
+    /**
+     * Set the UI component to be managed by this 3D component
+     */
+    setUIComponent(uiComponent: BaseUIComponent<any>): Promise<void>;
+    /**
+     * Get the managed UI component
+     */
+    getUIComponent(): BaseUIComponent<any> | null;
+    /**
+     * Set the visibility of the UI component
+     */
+    setVisible(visible: boolean): void;
+    private initializeUIComponent;
+    private detachUIComponent;
+    tickPostPhysics(deltaTime: number): void;
+    private shouldUIBeVisible;
+    getEditorClassIcon(): string | null;
+}

package/dist/src/components/visual/UI3DComponent.js

@@ -0,0 +1,248 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var _a;
+/**
+ * UI3DComponent provides a bridge between 3D world objects and 2D UI components.
+ *
+ * This component automatically calculates the UI component's 2D position by projecting
+ * its own 3D position to screen space each frame. It's useful for world-space UI
+ * components like health bars, name tags, or interaction prompts that need to follow
+ * 3D objects.
+ *
+ * Recommended usage:
+ * - Attach to any actor that needs a UI component to follow it in screen space
+ * - Provide a BaseUIComponent instance that will be managed by this component
+ * - The component handles visibility culling and boundary clamping automatically
+ */
+import * as THREE from 'three';
+import { EngineClass } from '../../systems/ClassRegistry.js';
+import { AsyncTaskWorker, IAsyncLoadableTag } from '../../utils/IAsyncLoadable.js';
+import { SceneComponent } from '../SceneComponent.js';
+let UI3DComponent = class UI3DComponent extends SceneComponent {
+    static get DEFAULT_OPTIONS() {
+        return {
+            ...SceneComponent.DEFAULT_OPTIONS,
+            uiComponent: undefined,
+            screenMargin: 10,
+            hideWhenBehindCamera: true,
+            clampToScreenBounds: true,
+        };
+    }
+    constructor(options = {}) {
+        super(options);
+        Object.defineProperty(this, _a, {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
+        Object.defineProperty(this, "uiComponent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "tempWorldPosition", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new THREE.Vector3()
+        });
+        Object.defineProperty(this, "tempCameraWorldPosition", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new THREE.Vector3()
+        });
+        Object.defineProperty(this, "tempScreenPosition", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new THREE.Vector3()
+        });
+        Object.defineProperty(this, "isUIComponentReady", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "_asyncTaskWorker", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new AsyncTaskWorker()
+        });
+        if (options.uiComponent) {
+            this.setUIComponent(options.uiComponent);
+        }
+    }
+    beginPlay() {
+        super.beginPlay();
+        if (this.uiComponent && !this.isUIComponentReady) {
+            this.initializeUIComponent();
+        }
+    }
+    endPlay() {
+        this.detachUIComponent();
+        super.endPlay();
+    }
+    // start IAsyncLoadable implementation
+    async waitForLoad() {
+        await this._asyncTaskWorker.waitUntilComplete();
+    }
+    isLoading() {
+        return this._asyncTaskWorker.isRunning();
+    }
+    // end IAsyncLoadable implementation
+    /**
+     * Set the UI component to be managed by this 3D component
+     */
+    async setUIComponent(uiComponent) {
+        // Detach existing component if any
+        if (this.uiComponent) {
+            this.detachUIComponent();
+        }
+        this.uiComponent = uiComponent;
+        // If the component is already playing, initialize the UI component immediately
+        if (this.getWorld()) {
+            await this.initializeUIComponent();
+        }
+    }
+    /**
+     * Get the managed UI component
+     */
+    getUIComponent() {
+        return this.uiComponent;
+    }
+    /**
+     * Set the visibility of the UI component
+     */
+    setVisible(visible) {
+        if (this.uiComponent && this.isUIComponentReady) {
+            if (visible) {
+                this.uiComponent.show();
+            }
+            else {
+                this.uiComponent.hide();
+            }
+        }
+    }
+    async initializeUIComponent() {
+        await this._asyncTaskWorker.runTask(async () => {
+            if (!this.uiComponent) {
+                return;
+            }
+            try {
+                // Initialize the UI component if not already initialized
+                if (!this.uiComponent.getIsInitialized()) {
+                    await this.uiComponent.initialize();
+                }
+                // Set initial visibility
+                this.uiComponent.show();
+                this.isUIComponentReady = true;
+            }
+            catch (error) {
+                console.error('UI3DComponent: Failed to initialize UI component:', error);
+            }
+        });
+    }
+    detachUIComponent() {
+        if (this.uiComponent && this.isUIComponentReady) {
+            this.uiComponent.hide();
+            this.isUIComponentReady = false;
+        }
+        // Note: We don't destroy the UI component as it might be used elsewhere
+        // The caller is responsible for component lifecycle management
+        this.uiComponent = null;
+    }
+    tickPostPhysics(deltaTime) {
+        super.tickPostPhysics(deltaTime);
+        if (!this.uiComponent || !this.isUIComponentReady) {
+            return;
+        }
+        const camera = this.getWorld()?.getActiveCamera();
+        const windowSize = this.getWorld()?.getRenderWindowSize();
+        if (!camera || !windowSize) {
+            return;
+        }
+        // Calculate world position with offset
+        this.getWorldPosition(this.tempWorldPosition);
+        // Project 3D position to screen coordinates
+        this.tempScreenPosition.copy(this.tempWorldPosition).project(camera);
+        const containerSize = windowSize;
+        const screenX = (this.tempScreenPosition.x * 0.5 + 0.5) * containerSize.width;
+        const screenY = (this.tempScreenPosition.y * -0.5 + 0.5) * containerSize.height;
+        // Calculate distance-based scale
+        let distanceScale = 1.0;
+        if (this.options.distanceScaling) {
+            camera.getWorldPosition(this.tempCameraWorldPosition);
+            const distanceToCamera = this.tempWorldPosition.distanceTo(this.tempCameraWorldPosition);
+            const baseDistance = this.options.distanceScaling.baseDistance;
+            const minScale = this.options.distanceScaling.minScale;
+            const maxScale = this.options.distanceScaling.maxScale;
+            // Scale inversely with distance (closer = larger, farther = smaller)
+            distanceScale = baseDistance / distanceToCamera;
+            distanceScale = Math.max(minScale, Math.min(maxScale, distanceScale));
+        }
+        // Apply screen offset
+        const offset = this.options.screenOffset ?? { x: 0, y: 0 };
+        const finalX = screenX + offset.x * distanceScale;
+        const finalY = screenY + offset.y * distanceScale;
+        // Check visibility conditions
+        const margin = this.options.screenMargin ?? 0;
+        const isVisible = this.shouldUIBeVisible(finalX, finalY, containerSize, margin);
+        if (isVisible) {
+            // Clamp to screen bounds if enabled
+            let clampedX = finalX;
+            let clampedY = finalY;
+            if (this.options.clampToScreenBounds) {
+                clampedX = Math.max(margin, Math.min(finalX, containerSize.width - margin));
+                clampedY = Math.max(margin, Math.min(finalY, containerSize.height - margin));
+            }
+            // Update UI component position and scale using BaseUIComponent's setPosition method
+            this.uiComponent.setPosition({
+                left: `${clampedX}px`,
+                top: `${clampedY}px`,
+                position: 'absolute',
+                transform: `translate(-50%, -50%) scale(${distanceScale})`,
+                transformOrigin: 'center'
+            });
+            this.uiComponent.show();
+        }
+        else {
+            this.uiComponent.hide();
+        }
+    }
+    shouldUIBeVisible(x, y, containerSize, margin) {
+        // Check if behind camera
+        if (this.options.hideWhenBehindCamera && (this.tempScreenPosition.z > 1 || this.tempScreenPosition.z < 0)) {
+            return false;
+        }
+        // Check if outside screen bounds
+        if (x < margin || x > containerSize.width - margin ||
+            y < margin || y > containerSize.height - margin) {
+            return false;
+        }
+        return true;
+    }
+    //====================================================================================================
+    // Editor Functions
+    //====================================================================================================
+    getEditorClassIcon() {
+        return 'Icon_UI3D';
+    }
+};
+_a = IAsyncLoadableTag;
+UI3DComponent = __decorate([
+    EngineClass('UI3DComponent'),
+    __metadata("design:paramtypes", [Object])
+], UI3DComponent);
+export { UI3DComponent };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVUkzRENvbXBvbmVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9jb21wb25lbnRzL3Zpc3VhbC9VSTNEQ29tcG9uZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7QUFBQTs7Ozs7Ozs7Ozs7O0dBWUc7QUFDSCxPQUFPLEtBQUssS0FBSyxNQUFNLE9BQU8sQ0FBQztBQUUvQixPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDN0QsT0FBTyxFQUFFLGVBQWUsRUFBRSxpQkFBaUIsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBQ25GLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQTZCL0MsSUFBTSxhQUFhLEdBQW5CLE1BQU0sYUFBYyxTQUFRLGNBQW9DO0lBRXJFLE1BQU0sS0FBYyxlQUFlO1FBQ2pDLE9BQU87WUFDTCxHQUFHLGNBQWMsQ0FBQyxlQUFlO1lBQ2pDLFdBQVcsRUFBRSxTQUFTO1lBQ3RCLFlBQVksRUFBRSxFQUFFO1lBQ2hCLG9CQUFvQixFQUFFLElBQUk7WUFDMUIsbUJBQW1CLEVBQUUsSUFBSTtTQUMxQixDQUFDO0lBQ0osQ0FBQztJQVVELFlBQVksVUFBZ0MsRUFBRTtRQUM1QyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFWUjs7OzttQkFBc0IsSUFBSTtXQUFDO1FBRTVCOzs7O21CQUEyQyxJQUFJO1dBQUM7UUFDaEQ7Ozs7bUJBQW1DLElBQUksS0FBSyxDQUFDLE9BQU8sRUFBRTtXQUFDO1FBQ3ZEOzs7O21CQUF5QyxJQUFJLEtBQUssQ0FBQyxPQUFPLEVBQUU7V0FBQztRQUM3RDs7OzttQkFBb0MsSUFBSSxLQUFLLENBQUMsT0FBTyxFQUFFO1dBQUM7UUFDeEQ7Ozs7bUJBQXFCLEtBQUs7V0FBQztRQUMzQjs7OzttQkFBb0MsSUFBSSxlQUFlLEVBQUU7V0FBQztRQUtoRSxJQUFJLE9BQU8sQ0FBQyxXQUFXLEVBQUUsQ0FBQztZ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

package/dist/src/components/visual/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Visual components aggregate export.
+ *
+ * This module re-exports components responsible for rendering and animation in
+ * the Genesys engine. Including this barrel allows external modules and AI
+ * scripts to easily access billboard, mesh, camera, and particle systems from a
+ * single import location. Keeping these exports together makes engine
+ * extensibility more straightforward.
+ */
+export * from './BillboardComponent.js';
+export * from './BaseInstancedMeshComponent.js';
+export * from './EditorOnlyMeshComponent.js';
+export * from './GLTFMeshComponent.js';
+export * from './AnimationComponent.js';
+export * from './AnimationStateMachineComponent.js';
+export * from './InstancedGltfMeshComponent.js';
+export * from './InstancedMeshComponent.js';
+export * from './MeshComponent.js';
+export * from './ParticleEmitterComponent.js';
+export * from './TerrainMeshComponent.js';
+export * from './SkyboxComponent.js';
+export * from './FogComponent.js';
+export * from './UI3DComponent.js';