@directivegames/genesys.js 3.1.24

package/dist/src/components/gameplay/PickupComponent.js

@@ -0,0 +1,429 @@
+/**
+ * PickupComponent provides pickup functionality for actors with trigger physics components.
+ *
+ * This component automatically finds trigger-enabled SceneComponents on its actor and
+ * sets up collision detection for pickup interactions. It includes support for sound
+ * effects when collected and provides extensible pickup behavior through delegates
+ * and virtual methods.
+ *
+ * Key Features:
+ * - Automatic trigger component detection (requires isTrigger=true physics state)
+ * - Sound effect support with configurable volume and distance
+ * - Delegate-based event system (onPickup) for external handling
+ * - Extensible pickup logic through canPickup and onPickupInternal overrides
+ * - Built-in actor destruction after pickup
+ *
+ * Included Classes:
+ * - PickupComponent: Base pickup functionality with sound support
+ * - HealthPickupComponent: Specialized pickup that heals CharacterStatsComponent
+ * - PickupSpawnerComponent: Automated spawning system with configurable intervals
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Attach to an actor that has a SceneComponent with physics enabled
+ * - Ensure the physics component has isTrigger: true and generateCollisionEvents: true
+ * - Override canPickup and onPickupInternal methods for custom pickup behavior
+ * - Use HealthPickupComponent for health restoration functionality
+ * - Use PickupSpawnerComponent for automatic pickup respawning
+ */
+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 PickupComponent_1, HealthPickupComponent_1, PickupSpawnerComponent_1;
+import * as THREE from 'three';
+import * as ENGINE from '../../index.js';
+import { EngineClass } from '../../systems/ClassRegistry.js';
+import { Delegate } from '../../utils/Delegate.js';
+import { PrimitiveComponent } from '../PrimitiveComponent.js';
+import { SceneComponent } from '../SceneComponent.js';
+let PickupComponent = PickupComponent_1 = class PickupComponent extends SceneComponent {
+    static get DEFAULT_OPTIONS() {
+        return {
+            ...SceneComponent.DEFAULT_OPTIONS,
+            sound: {
+                volume: 0.5,
+                maxDistance: 10
+            }
+        };
+    }
+    constructor(options = {}) {
+        // Merge sound options from DEFAULT_OPTIONS with any passed options
+        const mergedOptions = {
+            ...options,
+            sound: {
+                ...PickupComponent_1.DEFAULT_OPTIONS.sound,
+                ...options.sound
+            }
+        };
+        super(mergedOptions);
+        Object.defineProperty(this, "pickupSoundUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "triggerComponent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        /** Delegate called when this pickup is collected */
+        Object.defineProperty(this, "onPickup", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        // Store pickup sound URL if configured
+        if (mergedOptions.sound?.pickupSoundUrl) {
+            this.pickupSoundUrl = mergedOptions.sound.pickupSoundUrl;
+        }
+    }
+    beginPlay() {
+        super.beginPlay();
+        // do it in the next tick to allow physics to be initialized
+        this.getWorld()?.runInNextTick(() => {
+            this.findTriggerComponent();
+        });
+        // special handling for GLTFMeshComponents which can take some time to load
+        const gltfMeshComponents = this.getActor()?.getComponents(ENGINE.GLTFMeshComponent) ?? [];
+        for (const gltfMeshComponent of gltfMeshComponents) {
+            gltfMeshComponent.onMeshLoaded.add((gltfMeshComponent, mesh) => {
+                this.findTriggerComponent();
+            });
+        }
+    }
+    findTriggerComponent() {
+        if (this.triggerComponent) {
+            return;
+        }
+        const actor = this.getActor();
+        if (!actor) {
+            console.warn('[PickupComponent] No actor found');
+            return;
+        }
+        const allPrimitiveComponents = actor.getComponents(PrimitiveComponent);
+        for (const primitiveComponent of allPrimitiveComponents) {
+            if (!primitiveComponent.getPhysicsOptions()?.generateCollisionEvents) {
+                continue;
+            }
+            const physicsState = this.getPhysicsEngine()?.getComponentState(primitiveComponent);
+            if (!physicsState) {
+                continue;
+            }
+            if (physicsState.isTrigger) {
+                this.triggerComponent = primitiveComponent;
+                break;
+            }
+        }
+        if (!this.triggerComponent) {
+            return;
+        }
+        // Set up overlap detection on the mesh component
+        this.triggerComponent.onOverlapWith.add((thisComponent, otherComponent, collisionEvent) => {
+            const otherActor = otherComponent.getActor();
+            // Check if the pickup can be collected by this actor
+            if (otherActor && this.canPickup(otherActor)) {
+                this.handlePickup(otherActor);
+            }
+        });
+        console.log('[PickupComponent] Successfully initialized with trigger component');
+    }
+    /**
+     * Determines if the pickup can be collected by the given actor
+     * Override this method in subclasses to implement custom pickup logic
+     * @param actor The actor attempting to pick up this item
+     * @returns True if the actor can pick up this item
+     */
+    canPickup(actor) {
+        // Default implementation: only Pawns can pick up items
+        return actor instanceof ENGINE.Pawn;
+    }
+    /**
+     * Internal method that handles the pickup process
+     * @param collector The actor that collected this pickup
+     */
+    handlePickup(collector) {
+        const pickupActor = this.getActor();
+        if (!pickupActor)
+            return;
+        // Invoke the delegate first (before destroying the actor)
+        this.onPickup.invoke(pickupActor, collector);
+        // Then call the overridable method
+        this.onPickupInternal(collector);
+    }
+    /**
+     * Called when the pickup is collected
+     * Override this method in subclasses to implement custom pickup behavior
+     * @param collector The actor that collected this pickup
+     */
+    onPickupInternal(collector) {
+        console.log('[PickupComponent] Pickup collected!');
+        if (this.pickupSoundUrl) {
+            const world = this.getWorld();
+            if (world?.globalAudioManager) {
+                const soundOptions = this.options.sound;
+                world.globalAudioManager.playGlobalSound(this.pickupSoundUrl, {
+                    volume: soundOptions?.volume ?? 0.7
+                });
+            }
+        }
+        else {
+            console.log('[PickupComponent] No pickup sound configured');
+        }
+        // Remove the pickup actor from the world
+        const actor = this.getActor();
+        if (actor) {
+            actor.destroy();
+        }
+    }
+    //====================================================================================================
+    // Editor Functions
+    //====================================================================================================
+    getEditorClassIcon() {
+        return 'Icon_Pickup';
+    }
+};
+Object.defineProperty(PickupComponent, "EDITOR_CLASS_META", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: {
+        ...SceneComponent.EDITOR_CLASS_META,
+    }
+});
+PickupComponent = PickupComponent_1 = __decorate([
+    EngineClass('PickupComponent'),
+    __metadata("design:paramtypes", [Object])
+], PickupComponent);
+export { PickupComponent };
+let HealthPickupComponent = HealthPickupComponent_1 = class HealthPickupComponent extends PickupComponent {
+    static get DEFAULT_OPTIONS() {
+        return {
+            ...PickupComponent.DEFAULT_OPTIONS,
+            healAmount: 25,
+            sound: {
+                pickupSoundUrl: '@engine/assets/sounds/pickup.mp3',
+                volume: 0.7,
+                maxDistance: 12
+            }
+        };
+    }
+    constructor(options = {}) {
+        super(options);
+        Object.defineProperty(this, "healAmount", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.healAmount = options.healAmount ?? HealthPickupComponent_1.DEFAULT_OPTIONS.healAmount;
+    }
+    /**
+     * Override to ensure only Pawns with CharacterStatsComponent can pick up health
+     */
+    canPickup(actor) {
+        // First check if it's a Pawn (base class requirement)
+        if (!super.canPickup(actor)) {
+            return false;
+        }
+        // Then check if it has a CharacterStatsComponent
+        const pawn = actor;
+        const statsComponent = pawn.getComponent(ENGINE.CharacterStatsComponent);
+        return statsComponent !== null;
+    }
+    /**
+     * Override to heal the player when picked up
+     */
+    onPickupInternal(collector) {
+        const player = collector;
+        const statsComponent = player.getComponent(ENGINE.CharacterStatsComponent);
+        if (statsComponent) {
+            const currentHealth = statsComponent.getCurrentHealth();
+            const maxHealth = statsComponent.getMaxHealth();
+            // Heal the player
+            const actualHealed = statsComponent.heal(this.healAmount);
+            console.log(`[HealthPickupComponent] Healed player: ${currentHealth}/${maxHealth} -> ${statsComponent.getCurrentHealth()}/${maxHealth} (healed ${actualHealed} HP)`);
+        }
+        // Call the base pickup behavior (destroy)
+        super.onPickupInternal(collector);
+    }
+    //====================================================================================================
+    // Editor Functions
+    //====================================================================================================
+    getEditorClassIcon() {
+        return 'Icon_HealthPickup';
+    }
+};
+HealthPickupComponent = HealthPickupComponent_1 = __decorate([
+    EngineClass('HealthPickupComponent'),
+    __metadata("design:paramtypes", [Object])
+], HealthPickupComponent);
+export { HealthPickupComponent };
+let PickupSpawnerComponent = PickupSpawnerComponent_1 = class PickupSpawnerComponent extends SceneComponent {
+    static get DEFAULT_OPTIONS() {
+        return {
+            ...SceneComponent.DEFAULT_OPTIONS,
+            prefabPath: '@engine/assets/prefabs/actors/demo_health_pickup.prefab.json',
+            spawnInterval: 5.0,
+            spawnOffset: new THREE.Vector3(0, 2, 0),
+            sound: undefined,
+        };
+    }
+    constructor(options = {}) {
+        const mergedOptions = {
+            ...PickupSpawnerComponent_1.DEFAULT_OPTIONS,
+            ...options,
+            sound: {
+                ...PickupSpawnerComponent_1.DEFAULT_OPTIONS.sound,
+                ...options.sound
+            }
+        };
+        super(mergedOptions);
+        Object.defineProperty(this, "currentPickup", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "spawnTimerId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+    }
+    beginPlay() {
+        super.beginPlay();
+        console.log('[PickupSpawnerComponent] Starting pickup spawner');
+        // Spawn the initial pickup
+        this.spawnPickup();
+    }
+    endPlay() {
+        super.endPlay();
+        // Clean up timer
+        if (this.spawnTimerId !== null) {
+            const world = this.getWorld();
+            if (world) {
+                world.timerSystem.clearTimer(this.spawnTimerId);
+                this.spawnTimerId = null;
+            }
+        }
+    }
+    async spawnPickup() {
+        const world = this.getWorld();
+        const actor = this.getActor();
+        if (!world || !actor) {
+            console.warn('[PickupSpawnerComponent] No world or actor found');
+            return;
+        }
+        const options = this.options;
+        if (!options.prefabPath) {
+            console.warn('[PickupSpawnerComponent] No prefab path specified');
+            return;
+        }
+        try {
+            // Calculate spawn position
+            const spawnerPosition = actor.rootComponent.getWorldPosition();
+            const spawnOffset = options.spawnOffset ?? new THREE.Vector3(0, 2, 0);
+            const spawnPosition = spawnerPosition.clone().add(spawnOffset);
+            // Spawn the pickup using WorldCommands
+            const pickupActors = await ENGINE.WorldCommands.placePrefabs({
+                world: world,
+                prefabs: [
+                    {
+                        path: options.prefabPath,
+                        transform: {
+                            position: spawnPosition,
+                            rotation: new THREE.Euler(0, 0, 0)
+                        }
+                    }
+                ]
+            });
+            if (pickupActors.length > 0) {
+                this.currentPickup = pickupActors[0];
+                // Find the pickup component and bind to its onPickup delegate
+                const pickupComponent = this.currentPickup.getComponent(PickupComponent);
+                if (pickupComponent) {
+                    pickupComponent.onPickup.add((pickupActor, collector) => {
+                        this.onPickupCollected(pickupActor, collector);
+                    });
+                }
+                // Play spawn sound if configured
+                if (options.sound?.spawnSoundUrl) {
+                    world.globalAudioManager?.playGlobalSound(options.sound.spawnSoundUrl, {
+                        volume: options.sound.volume ?? 0.5
+                    });
+                }
+                console.log('[PickupSpawnerComponent] Spawned pickup at:', spawnPosition);
+            }
+        }
+        catch (error) {
+            console.error('[PickupSpawnerComponent] Failed to spawn pickup:', error);
+        }
+    }
+    onPickupCollected(pickupActor, collector) {
+        console.log('[PickupSpawnerComponent] Pickup was collected');
+        this.currentPickup = null;
+        const options = this.options;
+        const spawnInterval = options.spawnInterval ?? 5.0;
+        // Only respawn if interval is non-negative
+        if (spawnInterval >= 0) {
+            const world = this.getWorld();
+            if (world) {
+                // Schedule the next spawn
+                this.spawnTimerId = world.timerSystem.setTimeout(() => {
+                    this.spawnTimerId = null;
+                    this.spawnPickup();
+                }, spawnInterval);
+                console.log(`[PickupSpawnerComponent] Next pickup will spawn in ${spawnInterval} seconds`);
+            }
+        }
+        else {
+            console.log('[PickupSpawnerComponent] Single-use spawner, will not respawn');
+        }
+    }
+    /**
+     * Manually trigger a pickup spawn (if no pickup is currently active)
+     */
+    manualSpawn() {
+        if (!this.currentPickup) {
+            this.spawnPickup();
+        }
+        else {
+            console.log('[PickupSpawnerComponent] Cannot spawn, pickup already exists');
+        }
+    }
+    /**
+     * Get the currently spawned pickup actor
+     */
+    getCurrentPickup() {
+        return this.currentPickup;
+    }
+    //====================================================================================================
+    // Editor Functions
+    //====================================================================================================
+    getEditorClassIcon() {
+        return 'Icon_Pickup';
+    }
+};
+Object.defineProperty(PickupSpawnerComponent, "EDITOR_CLASS_META", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: {
+        ...SceneComponent.EDITOR_CLASS_META,
+    }
+});
+PickupSpawnerComponent = PickupSpawnerComponent_1 = __decorate([
+    EngineClass('PickupSpawnerComponent'),
+    __metadata("design:paramtypes", [Object])
+], PickupSpawnerComponent);
+export { PickupSpawnerComponent };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUGlja3VwQ29tcG9uZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvZ2FtZXBsYXkvUGlja3VwQ29tcG9uZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQTBCRzs7Ozs7Ozs7Ozs7QUFFSCxPQUFPLEtBQUssS0FBSyxNQUFNLE9BQU8sQ0FBQztBQUUvQixPQUFPLEtBQUssTUFBTSxNQUFNLGdCQUFnQixDQUFDO0FBQ3pDLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUM3RCxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDbkQsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDOUQsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBa0IvQyxJQUFNLGVBQWUsdUJBQXJCLE1BQU0sZUFBZ0IsU0FBUSxjQUFzQztJQVd6RSxNQUFNLEtBQWMsZUFBZTtRQUNqQyxPQUFPO1lBQ0wsR0FBRyxjQUFjLENBQUMsZUFBZTtZQUNqQyxLQUFLLEVBQUU7Z0JBQ0wsTUFBTSxFQUFFLEdBQUc7Z0JBQ1gsV0FBVyxFQUFFLEVBQUU7YUFDaEI7U0FDRixDQUFDO0lBQ0osQ0FBQztJQUVELFlBQVksVUFBa0MsRUFBRTtRQUM5QyxtRUFBbUU7UUFDbkUsTUFBTSxhQUFhLEdBQUc7WUFDcEIsR0FBRyxPQUFPO1lBQ1YsS0FBSyxFQUFFO2dCQUNMLEdBQUcsaUJBQWUsQ0FBQyxlQUFlLENBQUMsS0FBSztnQkFDeEMsR0FBRyxPQUFPLENBQUMsS0FBSzthQUNqQjtTQUNGLENBQUM7UUFFRixLQUFLLENBQUMsYUFBYSxDQUFDLENBQUM7UUE5QmY7Ozs7bUJBQWdDLElBQUk7V0FBQztRQUNuQzs7OzttQkFBOEMsSUFBSTtXQUFDO1FBRTdELG9EQUFvRDtRQUNwQzs7Oztt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

package/dist/src/components/gameplay/ProjectileWeaponComponent.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ProjectileWeaponComponent fires Projectile actors with configurable options.
+ *
+ * Built on top of BaseWeaponComponent, it gathers the firing position and
+ * direction from the owning component and instantiates a Projectile each time
+ * `doFire` is called. Target positions can be provided to force shots toward a
+ * point in world space. The projectile class is customizable allowing different
+ * projectile behaviors without modifying the component itself.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Set `projectileOptions` to control speed, collision settings and more.
+ * - Call `tryFireAtTarget` for one-off shots toward a specific position.
+ * - Override `getFirePositionAndDirection` if the spawn point should be offset
+ *   from the component's transform.
+ */
+import { Projectile } from '../../actors/Projectile.js';
+import { Delegate } from '../../utils/Delegate.js';
+import { BaseWeaponComponent } from './BaseWeaponComponent.js';
+import type { BaseWeaponOptions } from './BaseWeaponComponent.js';
+import type { IEquipment } from './Equipment.js';
+import type { ProjectileOptions } from '../../actors/Projectile.js';
+import type { OptionalSome } from '../../utils/Utils.js';
+import type * as THREE from 'three';
+export type WeaponProjectileOptions = OptionalSome<ProjectileOptions, 'position' | 'direction'>;
+export interface ProjectileWeaponOptions extends BaseWeaponOptions {
+    projectileOptions: WeaponProjectileOptions;
+    /**
+     * Optional class to use for the projectile.
+     * If not provided, the default Projectile class will be used.
+     */
+    projectileClass?: new (options: ProjectileOptions) => Projectile;
+    /**
+     * Optional offset from the weapon component's position for the projectile spawn.
+     */
+    projectileSpawnOffset?: THREE.Vector3;
+}
+export type ProjectileFiredDelegate = Delegate<[Projectile], void>;
+export type ProjectileWeaponDefaultOptions = BaseWeaponOptions & Partial<ProjectileWeaponOptions>;
+export declare class ProjectileWeaponComponent extends BaseWeaponComponent<ProjectileWeaponOptions> implements IEquipment {
+    static get DEFAULT_OPTIONS(): ProjectileWeaponDefaultOptions;
+    readonly onProjectileFired: ProjectileFiredDelegate;
+    constructor(options: ProjectileWeaponOptions);
+    protected doFire(): void;
+    protected getFirePositionAndDirection(): {
+        position: THREE.Vector3;
+        direction: THREE.Vector3;
+    };
+    getEditorClassIcon(): string | null;
+}

package/dist/src/components/gameplay/ProjectileWeaponComponent.js

@@ -0,0 +1,93 @@
+/**
+ * ProjectileWeaponComponent fires Projectile actors with configurable options.
+ *
+ * Built on top of BaseWeaponComponent, it gathers the firing position and
+ * direction from the owning component and instantiates a Projectile each time
+ * `doFire` is called. Target positions can be provided to force shots toward a
+ * point in world space. The projectile class is customizable allowing different
+ * projectile behaviors without modifying the component itself.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Set `projectileOptions` to control speed, collision settings and more.
+ * - Call `tryFireAtTarget` for one-off shots toward a specific position.
+ * - Override `getFirePositionAndDirection` if the spawn point should be offset
+ *   from the component's transform.
+ */
+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 ProjectileWeaponComponent_1;
+import { Projectile } from '../../actors/Projectile.js';
+import { EngineClass } from '../../systems/ClassRegistry.js';
+import { Delegate } from '../../utils/Delegate.js';
+import { BaseWeaponComponent } from './BaseWeaponComponent.js';
+let ProjectileWeaponComponent = ProjectileWeaponComponent_1 = class ProjectileWeaponComponent extends BaseWeaponComponent {
+    static get DEFAULT_OPTIONS() {
+        return {
+            ...BaseWeaponComponent.DEFAULT_OPTIONS,
+            projectileClass: Projectile,
+        };
+    }
+    constructor(options) {
+        super(options);
+        Object.defineProperty(this, "onProjectileFired", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+    }
+    doFire() {
+        // Guard against firing without ammo
+        if (!this.canFire()) {
+            return;
+        }
+        let { position, direction } = this.getFirePositionAndDirection();
+        // Apply target direction if available
+        const targetDirection = this.getTargetDirection();
+        if (targetDirection) {
+            direction = targetDirection;
+        }
+        const projectileClass = this.options.projectileClass ?? ProjectileWeaponComponent_1.DEFAULT_OPTIONS.projectileClass;
+        const projectile = new projectileClass({
+            ...this.options.projectileOptions,
+            // honor the provided position and direction if they exist
+            position: this.options.projectileOptions.position ?? position,
+            direction: this.options.projectileOptions.direction ?? direction,
+            // Pass the owner actor so the projectile won't hit its owner
+            owner: this.getActor() ?? undefined,
+        });
+        this.getWorld()?.addActors(projectile);
+        this.onProjectileFired.invoke(projectile);
+        // Handle weapon effects and ammo
+        this.consumeAmmo();
+        this.playFireSound();
+        this.applyRecoilEffects();
+    }
+    getFirePositionAndDirection() {
+        const { position, direction } = super.getFirePositionAndDirection();
+        // Apply projectile-specific spawn offset if provided
+        if (this.options.projectileSpawnOffset) {
+            position.add(this.options.projectileSpawnOffset.clone().applyQuaternion(this.getWorldQuaternion()));
+        }
+        return { position, direction };
+    }
+    //====================================================================================================
+    // Editor Functions
+    //====================================================================================================
+    getEditorClassIcon() {
+        return 'Icon_ProjectileWeapon';
+    }
+};
+ProjectileWeaponComponent = ProjectileWeaponComponent_1 = __decorate([
+    EngineClass('ProjectileWeaponComponent'),
+    __metadata("design:paramtypes", [Object])
+], ProjectileWeaponComponent);
+export { ProjectileWeaponComponent };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUHJvamVjdGlsZVdlYXBvbkNvbXBvbmVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9jb21wb25lbnRzL2dhbWVwbGF5L1Byb2plY3RpbGVXZWFwb25Db21wb25lbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7Ozs7O0dBY0c7Ozs7Ozs7Ozs7O0FBRUgsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ3hELE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUM3RCxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFFbkQsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUEyQnhELElBQU0seUJBQXlCLGlDQUEvQixNQUFNLHlCQUEwQixTQUFRLG1CQUE0QztJQUN6RixNQUFNLEtBQWMsZUFBZTtRQUNqQyxPQUFPO1lBQ0wsR0FBRyxtQkFBbUIsQ0FBQyxlQUFlO1lBQ3RDLGVBQWUsRUFBRSxVQUFVO1NBQzVCLENBQUM7SUFDSixDQUFDO0lBSUQsWUFBWSxPQUFnQztRQUMxQyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFIRDs7OzttQkFBNkMsSUFBSSxRQUFRLEVBQXNCO1dBQUM7SUFJaEcsQ0FBQztJQUlrQixNQUFNO1FBQ3ZCLG9DQUFvQztRQUNwQyxJQUFJLENBQUMsSUFBSSxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUM7WUFDcEIsT0FBTztRQUNULENBQUM7UUFFRCxJQUFJLEVBQUUsUUFBUSxFQUFFLFNBQVMsRUFBRSxHQUFHLElBQUksQ0FBQywyQkFBMkIsRUFBRSxDQUFDO1FBRWpFLHNDQUFzQztRQUN0QyxNQUFNLGVBQWUsR0FBRyxJQUFJLENBQUMsa0JBQWtCLEVBQUUsQ0FBQztRQUNsRCxJQUFJLGVBQWUsRUFBRSxDQUFDO1lBQ3BCLFNBQVMsR0FBRyxlQUFlLENBQUM7UUFDOUIsQ0FBQztRQUVELE1BQU0sZUFBZSxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsZUFBZSxJQUFJLDJCQUF5QixDQUFDLGVBQWUsQ0FBQyxlQUFnQixDQUFDO1FBQ25ILE1BQU0sVUFBVSxHQUFHLElBQUksZUFBZSxDQUFDO1lBQ3JDLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxpQkFBaUI7WUFDakMsMERBQTBEO1lBQzFELFFBQVEsRUFBRSxJQUFJLENBQUMsT0FBTyxDQUFDLGlCQUFpQixDQUFDLFFBQVEsSUFBSSxRQUFRO1lBQzdELFNBQVMsRUFBRSxJQUFJLENBQUMsT0FBTyxDQUFDLGlCQUFpQixDQUFDLFNBQVMsSUFBSSxTQUFTO1lBQ2hFLDZEQUE2RDtZQUM3RCxLQUFLLEVBQUUsSUFBSSxDQUFDLFFBQVEsRUFBRSxJQUFJLFNBQVM7U0FDcEMsQ0FBQyxDQUFDO1FBQ0gsSUFBSSxDQUFDLFFBQVEsRUFBRSxFQUFFLFNBQVMsQ0FBQyxVQUFVLENBQUMsQ0FBQztRQUN2QyxJQUFJLENBQUMsaUJBQWlCLENBQUMsTUFBTSxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBRTFDLGlDQUFpQztRQUNqQyxJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7UUFDbkIsSUFBSSxDQUFDLGFBQWEsRUFBRSxDQUFDO1FBQ3JCLElBQUksQ0FBQyxrQkFBa0IsRUFBRSxDQUFDO0lBQzVCLENBQUM7SUFFa0IsMkJBQTJCO1FBQzVDLE1BQU0sRUFBRSxRQUFRLEVBQUUsU0FBUyxFQUFFLEdBQUcsS0FBSyxDQUFDLDJCQUEyQixFQUFFLENBQUM7UUFFcEUscURBQXFEO1FBQ3JELElBQUksSUFBSSxDQUFDLE9BQU8sQ0FBQyxxQkFBcUIsRUFBRSxDQUFDO1lBQ3ZDLFFBQVEsQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxxQkFBcUIsQ0FBQyxLQUFLLEVBQUUsQ0FBQyxlQUFlLENBQUMsSUFBSSxDQUFDLGtCQUFrQixFQUFFLENBQUMsQ0FBQyxDQUFDO1FBQ3RHLENBQUM7UUFFRCxPQUFPLEVBQUUsUUFBUSxFQUFFLFNBQVMsRUFBRSxDQUFDO0lBQ2pDLENBQUM7SUFFRCxzR0FBc0c7SUFDdEcsbUJBQW1CO0lBQ25CLHNHQUFzRztJQUV0RixrQkFBa0I7UUFDaEMsT0FBTyx1QkFBdUIsQ0FBQztJQUNqQyxDQUFDO0NBQ0YsQ0FBQTtBQWxFWSx5QkFBeUI7SUFEckMsV0FBVyxDQUFDLDJCQUEyQixDQUFDOztHQUM1Qix5QkFBeUIsQ0FrRXJDIn0=

package/dist/src/components/gameplay/ShotgunComponent.d.ts

@@ -0,0 +1,18 @@
+import * as THREE from 'three';
+import { ProjectileWeaponComponent } from './ProjectileWeaponComponent.js';
+import type { ProjectileWeaponOptions } from './ProjectileWeaponComponent.js';
+export declare class ShotgunComponent extends ProjectileWeaponComponent {
+    private originalRotation;
+    private reloadRotation;
+    private isRotating;
+    static readonly SHOTGUN_CONFIG: ProjectileWeaponOptions;
+    constructor();
+    protected get gunMesh(): THREE.Object3D | null;
+    protected startReload(): void;
+    private animateRotationTo;
+    private easeInOutCubic;
+    beginFire(): boolean;
+    protected doFire(): void;
+    private createMuzzleFlashEffect;
+    getEditorClassIcon(): string | null;
+}