@austencloud/backgrounds 0.1.0

package/dist/backgrounds/deep-ocean/services/implementations/FishHuntingHandler.d.ts

@@ -0,0 +1,43 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { IFishHuntingHandler, ActiveHunt, HuntResult, HuntState, HuntStats } from "../contracts/IFishHuntingHandler.js";
+import type { IFishWobbleAnimator } from "../contracts/IFishWobbleAnimator.js";
+/**
+ * FishHuntingHandler - Manages predator/prey chase sequences
+ *
+ * Creates emergent drama through pursuit and escape:
+ * - Sleek fish are active predators (fast, bold, solitary)
+ * - Deep fish are ambush predators (patient, z-axis approach)
+ * - Tropical/schooling fish are prey (flee, school up)
+ *
+ * No death mechanics - just pursuit behavior that adds life to the scene.
+ */
+export declare class FishHuntingHandler implements IFishHuntingHandler {
+    private activeHunts;
+    private stats;
+    private wobbleAnimator;
+    constructor(wobbleAnimator?: IFishWobbleAnimator);
+    processHunting(fish: FishMarineLife[], deltaSeconds: number, animationTime: number): HuntResult[];
+    applyHuntResult(result: HuntResult, fish: FishMarineLife[]): void;
+    isPredator(fish: FishMarineLife): boolean;
+    isPrey(fish: FishMarineLife): boolean;
+    getActiveHunts(): ActiveHunt[];
+    getStats(): HuntStats;
+    forceHunt(predator: FishMarineLife, prey: FishMarineLife, animationTime: number): void;
+    cancelAllHunts(): void;
+    getHuntVisualization(fish: FishMarineLife): {
+        targetX: number;
+        targetY: number;
+        state: HuntState;
+    } | null;
+    private canHunt;
+    private findPrey;
+    private startHunt;
+    private clearHuntState;
+    private applyStalking;
+    private applyChasing;
+    private applyFleeing;
+    private alertSchoolmates;
+    private distance;
+    private randomInRange;
+}
+//# sourceMappingURL=FishHuntingHandler.d.ts.map

package/dist/backgrounds/deep-ocean/services/implementations/FishHuntingHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FishHuntingHandler.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/FishHuntingHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EACV,mBAAmB,EACnB,UAAU,EACV,UAAU,EAEV,SAAS,EACT,SAAS,EACV,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AA2B/E;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,cAAc,CAAsB;gBAEhC,cAAc,CAAC,EAAE,mBAAmB;IAIhD,cAAc,CACZ,IAAI,EAAE,cAAc,EAAE,EACtB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,UAAU,EAAE;IA+Gf,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,IAAI;IA0CjE,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAIzC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAIrC,cAAc,IAAI,UAAU,EAAE;IAI9B,QAAQ,IAAI,SAAS;IAIrB,SAAS,CACP,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,cAAc,EACpB,aAAa,EAAE,MAAM,GACpB,IAAI;IAUP,cAAc,IAAI,IAAI;IAKtB,oBAAoB,CAClB,IAAI,EAAE,cAAc,GACnB;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI;IAahE,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,QAAQ;IAsBhB,OAAO,CAAC,SAAS;IAgCjB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,aAAa;CAGtB"}

package/dist/backgrounds/deep-ocean/services/implementations/FishHuntingHandler.js

@@ -0,0 +1,340 @@
+import { FishWobbleAnimator } from "./FishWobbleAnimator.js";
+/**
+ * Hunting system configuration
+ */
+const HUNTING_CONFIG = {
+    // Trigger conditions
+    hungerThreshold: 0.6, // Min hunger to start hunting
+    detectionRadius: 150, // How far predator can spot prey
+    chaseRadius: 200, // Max distance predator will chase
+    // Timing (seconds)
+    stalkDuration: [2, 3], // How long stalk phase lasts
+    maxChaseDuration: [4, 6], // Max chase before giving up
+    huntCooldown: 30, // Time between hunts
+    // Outcomes
+    catchProbability: 0.2, // 20% catch rate
+    escapeSpeedBoost: 1.5, // Prey speed multiplier when fleeing
+    predatorChaseSpeed: 2.0, // Predator burst speed multiplier
+    predatorStalkSpeed: 0.6, // Slow approach during stalk
+    // School defense
+    alertPropagationRadius: 100, // Alert nearby fish in school
+};
+/**
+ * FishHuntingHandler - Manages predator/prey chase sequences
+ *
+ * Creates emergent drama through pursuit and escape:
+ * - Sleek fish are active predators (fast, bold, solitary)
+ * - Deep fish are ambush predators (patient, z-axis approach)
+ * - Tropical/schooling fish are prey (flee, school up)
+ *
+ * No death mechanics - just pursuit behavior that adds life to the scene.
+ */
+export class FishHuntingHandler {
+    activeHunts = new Map();
+    stats = {
+        activeHunts: 0,
+        totalHunts: 0,
+        successfulCatches: 0,
+        escapes: 0,
+    };
+    wobbleAnimator;
+    constructor(wobbleAnimator) {
+        this.wobbleAnimator = wobbleAnimator ?? new FishWobbleAnimator();
+    }
+    processHunting(fish, deltaSeconds, animationTime) {
+        const results = [];
+        // Build lookup maps
+        const fishById = new Map(fish.map((f) => [f.fishId ?? 0, f]));
+        // Update existing hunts
+        for (const [hunterId, hunt] of this.activeHunts) {
+            const predator = fishById.get(hunterId);
+            const prey = fishById.get(hunt.targetId);
+            // Cancel if either fish is gone
+            if (!predator || !prey) {
+                results.push({ hunt, outcome: "cancelled" });
+                this.activeHunts.delete(hunterId);
+                continue;
+            }
+            const huntAge = animationTime - hunt.startTime;
+            // State machine
+            switch (hunt.state) {
+                case "stalking": {
+                    // Check if stalk phase is complete
+                    const stalkEnd = HUNTING_CONFIG.stalkDuration[0] +
+                        Math.random() *
+                            (HUNTING_CONFIG.stalkDuration[1] -
+                                HUNTING_CONFIG.stalkDuration[0]);
+                    if (huntAge >= stalkEnd) {
+                        // Transition to chase
+                        hunt.state = "chasing";
+                        predator.huntState = "chasing";
+                        predator.behavior = "chasing";
+                        // Prey detects predator and starts fleeing
+                        prey.isBeingHunted = true;
+                        prey.hunterId = hunterId;
+                        prey.mood = "alert";
+                        prey.behavior = "fleeing";
+                        this.wobbleAnimator.triggerWobble(prey, "startled_dart", 0.8);
+                        // Alert nearby schoolmates
+                        this.alertSchoolmates(prey, fish, animationTime);
+                    }
+                    else {
+                        // Slow approach during stalk
+                        this.applyStalking(predator, prey, deltaSeconds);
+                    }
+                    break;
+                }
+                case "chasing": {
+                    // Check timeout
+                    if (huntAge >= hunt.maxDuration) {
+                        results.push({ hunt, outcome: "timeout" });
+                        this.clearHuntState(predator, prey, animationTime);
+                        this.activeHunts.delete(hunterId);
+                        continue;
+                    }
+                    // Check distance - escaped if too far
+                    const dist = this.distance(predator, prey);
+                    if (dist > HUNTING_CONFIG.chaseRadius) {
+                        results.push({ hunt, outcome: "escaped" });
+                        this.clearHuntState(predator, prey, animationTime);
+                        this.activeHunts.delete(hunterId);
+                        this.stats.escapes++;
+                        continue;
+                    }
+                    // Check catch - random chance when close enough
+                    if (dist < 30) {
+                        const caught = Math.random() < HUNTING_CONFIG.catchProbability;
+                        if (caught) {
+                            results.push({ hunt, outcome: "caught" });
+                            this.clearHuntState(predator, prey, animationTime);
+                            this.activeHunts.delete(hunterId);
+                            this.stats.successfulCatches++;
+                            continue;
+                        }
+                    }
+                    // Apply chase movement
+                    this.applyChasing(predator, prey, deltaSeconds);
+                    this.applyFleeing(prey, predator, deltaSeconds);
+                    break;
+                }
+            }
+        }
+        // Look for new hunts
+        const predators = fish.filter((f) => this.isPredator(f) &&
+            !this.activeHunts.has(f.fishId ?? 0) &&
+            this.canHunt(f, animationTime));
+        for (const predator of predators) {
+            const prey = this.findPrey(predator, fish);
+            if (prey) {
+                this.startHunt(predator, prey, animationTime);
+            }
+        }
+        // Update stats
+        this.stats.activeHunts = this.activeHunts.size;
+        return results;
+    }
+    applyHuntResult(result, fish) {
+        const fishById = new Map(fish.map((f) => [f.fishId ?? 0, f]));
+        const predator = fishById.get(result.hunt.hunterId);
+        const prey = fishById.get(result.hunt.targetId);
+        switch (result.outcome) {
+            case "caught":
+                // Predator gets satisfied
+                if (predator) {
+                    predator.hunger = Math.max(0, (predator.hunger ?? 0.5) - 0.4);
+                    predator.mood = "calm";
+                    this.wobbleAnimator.triggerWobble(predator, "feeding_lunge", 0.9);
+                }
+                // Prey gets startled (but survives - no death in this system)
+                if (prey) {
+                    prey.mood = "alert";
+                    this.wobbleAnimator.triggerWobble(prey, "startled_dart", 1.0);
+                }
+                break;
+            case "escaped":
+                // Prey relief
+                if (prey) {
+                    prey.mood = "alert";
+                    prey.energy = Math.max(0, (prey.energy ?? 0.7) - 0.2); // Tired from fleeing
+                }
+                break;
+            case "timeout":
+                // Predator frustrated
+                if (predator) {
+                    predator.mood = "tired";
+                    predator.energy = Math.max(0, (predator.energy ?? 0.7) - 0.15);
+                }
+                break;
+            case "cancelled":
+                // Nothing special
+                break;
+        }
+    }
+    isPredator(fish) {
+        return fish.species === "sleek" || fish.species === "deep";
+    }
+    isPrey(fish) {
+        return fish.species === "tropical" || fish.species === "schooling";
+    }
+    getActiveHunts() {
+        return Array.from(this.activeHunts.values());
+    }
+    getStats() {
+        return { ...this.stats };
+    }
+    forceHunt(predator, prey, animationTime) {
+        if (!predator.fishId || !prey.fishId)
+            return;
+        // Cancel any existing hunt
+        this.activeHunts.delete(predator.fishId);
+        // Start new hunt (skip hunger check)
+        this.startHunt(predator, prey, animationTime);
+    }
+    cancelAllHunts() {
+        this.activeHunts.clear();
+        this.stats.activeHunts = 0;
+    }
+    getHuntVisualization(fish) {
+        const hunt = this.activeHunts.get(fish.fishId ?? 0);
+        if (!hunt)
+            return null;
+        // We'd need the prey's position, which we don't have here
+        // This should be called from a context with access to all fish
+        return null;
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    canHunt(predator, animationTime) {
+        // Check hunger threshold
+        const hunger = predator.hunger ?? 0.3;
+        if (hunger < HUNTING_CONFIG.hungerThreshold)
+            return false;
+        // Check cooldown
+        if (predator.huntCooldownEnd &&
+            animationTime < predator.huntCooldownEnd) {
+            return false;
+        }
+        // Check mood - don't hunt if tired
+        if (predator.mood === "tired")
+            return false;
+        return true;
+    }
+    findPrey(predator, allFish) {
+        // Find closest prey within detection range
+        let closestPrey = null;
+        let closestDist = HUNTING_CONFIG.detectionRadius;
+        for (const fish of allFish) {
+            if (!this.isPrey(fish))
+                continue;
+            if (fish.isBeingHunted)
+                continue; // Already being chased
+            const dist = this.distance(predator, fish);
+            if (dist < closestDist) {
+                closestDist = dist;
+                closestPrey = fish;
+            }
+        }
+        return closestPrey;
+    }
+    startHunt(predator, prey, animationTime) {
+        const hunterId = predator.fishId ?? 0;
+        const targetId = prey.fishId ?? 0;
+        const maxDuration = HUNTING_CONFIG.maxChaseDuration[0] +
+            Math.random() *
+                (HUNTING_CONFIG.maxChaseDuration[1] -
+                    HUNTING_CONFIG.maxChaseDuration[0]);
+        const hunt = {
+            hunterId,
+            targetId,
+            state: "stalking",
+            startTime: animationTime,
+            maxDuration,
+        };
+        this.activeHunts.set(hunterId, hunt);
+        this.stats.totalHunts++;
+        // Update predator state
+        predator.huntState = "stalking";
+        predator.huntingTarget = targetId;
+        predator.huntStartTime = animationTime;
+        predator.behavior = "stalking";
+    }
+    clearHuntState(predator, prey, animationTime) {
+        // Clear predator state
+        predator.huntState = "cooldown";
+        predator.huntingTarget = undefined;
+        predator.huntStartTime = undefined;
+        predator.huntCooldownEnd = animationTime + HUNTING_CONFIG.huntCooldown;
+        predator.behavior = "cruising";
+        // Clear prey state
+        prey.isBeingHunted = false;
+        prey.hunterId = undefined;
+        prey.behavior = "cruising";
+    }
+    applyStalking(predator, prey, deltaSeconds) {
+        // Slow, steady approach toward prey
+        const dx = prey.x - predator.x;
+        const dy = prey.y - predator.y;
+        const dist = Math.sqrt(dx * dx + dy * dy);
+        if (dist > 0) {
+            const speed = predator.baseSpeed * HUNTING_CONFIG.predatorStalkSpeed * deltaSeconds;
+            predator.x += (dx / dist) * speed * 60;
+            predator.y += (dy / dist) * speed * 60;
+            // Update direction to face prey
+            predator.direction = dx > 0 ? 1 : -1;
+        }
+    }
+    applyChasing(predator, prey, deltaSeconds) {
+        // Burst speed pursuit
+        const dx = prey.x - predator.x;
+        const dy = prey.y - predator.y;
+        const dist = Math.sqrt(dx * dx + dy * dy);
+        if (dist > 0) {
+            const speed = predator.baseSpeed * HUNTING_CONFIG.predatorChaseSpeed * deltaSeconds;
+            predator.x += (dx / dist) * speed * 60;
+            predator.y += (dy / dist) * speed * 60;
+            // Update direction
+            predator.direction = dx > 0 ? 1 : -1;
+            // Set high speed for visual effect
+            predator.speed = predator.baseSpeed * HUNTING_CONFIG.predatorChaseSpeed;
+        }
+    }
+    applyFleeing(prey, predator, deltaSeconds) {
+        // Flee away from predator
+        const dx = prey.x - predator.x;
+        const dy = prey.y - predator.y;
+        const dist = Math.sqrt(dx * dx + dy * dy);
+        if (dist > 0) {
+            const speed = prey.baseSpeed * HUNTING_CONFIG.escapeSpeedBoost * deltaSeconds;
+            prey.x += (dx / dist) * speed * 60;
+            prey.y += (dy / dist) * speed * 60;
+            // Update direction (away from predator)
+            prey.direction = dx > 0 ? 1 : -1;
+            // Set high speed for visual effect
+            prey.speed = prey.baseSpeed * HUNTING_CONFIG.escapeSpeedBoost;
+        }
+    }
+    alertSchoolmates(alertedFish, allFish, _animationTime) {
+        // Find schoolmates within alert radius
+        for (const fish of allFish) {
+            if (fish === alertedFish)
+                continue;
+            if (fish.schoolId !== alertedFish.schoolId)
+                continue;
+            const dist = this.distance(alertedFish, fish);
+            if (dist < HUNTING_CONFIG.alertPropagationRadius) {
+                fish.mood = "alert";
+                this.wobbleAnimator.triggerWobble(fish, "startled_dart", 0.5);
+            }
+        }
+    }
+    distance(a, b) {
+        const dx = a.x - b.x;
+        const dy = a.y - b.y;
+        return Math.sqrt(dx * dx + dy * dy);
+    }
+    randomInRange(range) {
+        return range[0] + Math.random() * (range[1] - range[0]);
+    }
+}
+//# sourceMappingURL=FishHuntingHandler.js.map

package/dist/backgrounds/deep-ocean/services/implementations/FishHuntingHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FishHuntingHandler.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/FishHuntingHandler.ts"],"names":[],"mappings":"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"}

package/dist/backgrounds/deep-ocean/services/implementations/FishInteractionHandler.d.ts

@@ -0,0 +1,32 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { IFishInteractionHandler, InteractionResult } from "../contracts/IFishInteractionHandler.js";
+import type { IFishWobbleAnimator } from "../contracts/IFishWobbleAnimator.js";
+/**
+ * FishInteractionHandler - Detects and handles micro-interactions between fish
+ *
+ * Creates emergent social behaviors when fish pass close to each other:
+ * - Passing greetings (social fish shimmy at each other)
+ * - Yield behavior (timid fish slow down for bold ones)
+ * - Social approach (social fish veer toward neighbors)
+ * - Shy avoidance (asocial fish veer away from neighbors)
+ */
+export declare class FishInteractionHandler implements IFishInteractionHandler {
+    private wobbleAnimator;
+    /** Cooldown timers per fish (using fish reference as key via WeakMap) */
+    private cooldowns;
+    /** Track processed pairs this frame to avoid duplicate interactions */
+    private processedPairs;
+    /** Temporary speed modifiers (fish -> {multiplier, remaining}) */
+    private speedModifiers;
+    constructor(wobbleAnimator?: IFishWobbleAnimator);
+    processInteractions(fish: FishMarineLife[], deltaSeconds: number): InteractionResult[];
+    applyInteraction(result: InteractionResult): void;
+    isOnCooldown(fish: FishMarineLife): boolean;
+    private updateCooldowns;
+    private updateSpeedModifiers;
+    private setCooldown;
+    private areInProximity;
+    private determineInteraction;
+    private defaultPersonality;
+}
+//# sourceMappingURL=FishInteractionHandler.d.ts.map

package/dist/backgrounds/deep-ocean/services/implementations/FishInteractionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FishInteractionHandler.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/FishInteractionHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EAElB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AA4C/E;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,YAAW,uBAAuB;IAaxD,OAAO,CAAC,cAAc;IAZlC,yEAAyE;IACzE,OAAO,CAAC,SAAS,CAAyC;IAE1D,uEAAuE;IACvE,OAAO,CAAC,cAAc,CAAqB;IAE3C,kEAAkE;IAClE,OAAO,CAAC,cAAc,CAGlB;gBAEgB,cAAc,GAAE,mBAA8C;IAElF,mBAAmB,CACjB,IAAI,EAAE,cAAc,EAAE,EACtB,YAAY,EAAE,MAAM,GACnB,iBAAiB,EAAE;IA4CtB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAgCjD,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAS3C,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,oBAAoB;IA4H5B,OAAO,CAAC,kBAAkB;CAQ3B"}