@austencloud/backgrounds 0.1.0

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

@@ -0,0 +1,272 @@
+import { FishWobbleAnimator } from "./FishWobbleAnimator.js";
+/**
+ * Configuration for fish interaction detection
+ */
+const INTERACTION_CONFIG = {
+    /** Distance threshold for interaction detection (pixels) */
+    proximityRadius: 55,
+    /** Vertical distance threshold (fish at very different depths don't interact) */
+    verticalThreshold: 40,
+    /** Z-depth difference threshold (fish far apart in depth don't interact) */
+    depthThreshold: 0.3,
+    /** Cooldown between interactions for each fish (seconds) */
+    cooldownDuration: 2.5,
+    /** Minimum speed difference to trigger yield behavior */
+    yieldSpeedDifference: 15,
+    /** Speed reduction for yielding fish */
+    yieldSpeedMultiplier: 0.6,
+    /** Duration of yield speed reduction (seconds) */
+    yieldDuration: 0.4,
+    /** Maximum vertical nudge for avoidance (pixels) */
+    maxVerticalNudge: 8,
+    /** Probability thresholds for different interaction types */
+    probabilities: {
+        /** Base chance of passing greeting (modified by sociability) */
+        passingGreeting: 0.35,
+        /** Base chance of yield behavior (modified by boldness difference) */
+        yield: 0.25,
+        /** Base chance of social approach (modified by sociability) */
+        socialApproach: 0.2,
+        /** Base chance of shy avoidance (modified by inverse sociability) */
+        shyAvoidance: 0.3,
+    },
+};
+/**
+ * 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 class FishInteractionHandler {
+    wobbleAnimator;
+    /** Cooldown timers per fish (using fish reference as key via WeakMap) */
+    cooldowns = new WeakMap();
+    /** Track processed pairs this frame to avoid duplicate interactions */
+    processedPairs = new Set();
+    /** Temporary speed modifiers (fish -> {multiplier, remaining}) */
+    speedModifiers = new WeakMap();
+    constructor(wobbleAnimator = new FishWobbleAnimator()) {
+        this.wobbleAnimator = wobbleAnimator;
+    }
+    processInteractions(fish, deltaSeconds) {
+        const results = [];
+        this.processedPairs.clear();
+        // Update cooldowns
+        this.updateCooldowns(fish, deltaSeconds);
+        // Update and apply temporary speed modifiers
+        this.updateSpeedModifiers(fish, deltaSeconds);
+        // Check each pair of fish for potential interactions
+        for (let i = 0; i < fish.length; i++) {
+            const fishA = fish[i];
+            // Skip fish that are currently wobbling (let animation finish)
+            if (this.wobbleAnimator.isWobbling(fishA))
+                continue;
+            for (let j = i + 1; j < fish.length; j++) {
+                const fishB = fish[j];
+                // Skip if either fish is on cooldown
+                if (this.isOnCooldown(fishA) || this.isOnCooldown(fishB))
+                    continue;
+                // Skip if B is wobbling
+                if (this.wobbleAnimator.isWobbling(fishB))
+                    continue;
+                // Check if fish are close enough to interact
+                if (!this.areInProximity(fishA, fishB))
+                    continue;
+                // Determine and create interaction
+                const interaction = this.determineInteraction(fishA, fishB);
+                if (interaction) {
+                    results.push(interaction);
+                    // Set cooldowns for both fish
+                    this.setCooldown(fishA);
+                    this.setCooldown(fishB);
+                }
+            }
+        }
+        return results;
+    }
+    applyInteraction(result) {
+        const { fish, other, type, triggerWobble, speedModifier, verticalNudge } = result;
+        // Trigger wobble animation
+        if (triggerWobble) {
+            this.wobbleAnimator.triggerWobble(fish, triggerWobble, 0.7);
+        }
+        // Apply temporary speed modifier
+        if (speedModifier !== undefined && speedModifier !== 1) {
+            this.speedModifiers.set(fish, {
+                multiplier: speedModifier,
+                remaining: INTERACTION_CONFIG.yieldDuration,
+            });
+        }
+        // Apply vertical nudge (avoidance/approach)
+        if (verticalNudge) {
+            fish.baseY += verticalNudge;
+            fish.y += verticalNudge;
+        }
+        // For passing greetings, also trigger wobble on the other fish
+        if (type === "passing_greeting" && other.personality) {
+            const otherSociability = other.personality.sociability ?? 0.5;
+            // Other fish responds if they're also social
+            if (Math.random() < otherSociability) {
+                this.wobbleAnimator.triggerWobble(other, "social_shimmer", 0.5);
+            }
+        }
+    }
+    isOnCooldown(fish) {
+        const remaining = this.cooldowns.get(fish);
+        return remaining !== undefined && remaining > 0;
+    }
+    // ============================================================================
+    // PRIVATE METHODS
+    // ============================================================================
+    updateCooldowns(fish, deltaSeconds) {
+        for (const f of fish) {
+            const remaining = this.cooldowns.get(f);
+            if (remaining !== undefined && remaining > 0) {
+                this.cooldowns.set(f, remaining - deltaSeconds);
+            }
+        }
+    }
+    updateSpeedModifiers(fish, deltaSeconds) {
+        for (const f of fish) {
+            const modifier = this.speedModifiers.get(f);
+            if (modifier) {
+                modifier.remaining -= deltaSeconds;
+                if (modifier.remaining <= 0) {
+                    // Remove modifier, restore speed
+                    this.speedModifiers.delete(f);
+                }
+                else {
+                    // Apply modifier to current speed
+                    // We modify the current speed, not baseSpeed, for temporary effect
+                    f.speed = f.baseSpeed * modifier.multiplier;
+                }
+            }
+        }
+    }
+    setCooldown(fish) {
+        // Add some randomness to cooldown to prevent synchronized behaviors
+        const cooldown = INTERACTION_CONFIG.cooldownDuration * (0.8 + Math.random() * 0.4);
+        this.cooldowns.set(fish, cooldown);
+    }
+    areInProximity(fishA, fishB) {
+        // Horizontal distance
+        const dx = Math.abs(fishA.x - fishB.x);
+        if (dx > INTERACTION_CONFIG.proximityRadius)
+            return false;
+        // Vertical distance
+        const dy = Math.abs(fishA.y - fishB.y);
+        if (dy > INTERACTION_CONFIG.verticalThreshold)
+            return false;
+        // Z-depth distance (fish at very different depths don't interact)
+        const dz = Math.abs(fishA.z - fishB.z);
+        if (dz > INTERACTION_CONFIG.depthThreshold)
+            return false;
+        return true;
+    }
+    determineInteraction(fishA, fishB) {
+        const personalityA = fishA.personality ?? this.defaultPersonality();
+        const personalityB = fishB.personality ?? this.defaultPersonality();
+        // Determine if fish are passing each other (moving in opposite directions)
+        const arePassing = fishA.direction !== fishB.direction;
+        // Determine if one fish is overtaking another (same direction, different speeds)
+        const areOvertaking = fishA.direction === fishB.direction &&
+            Math.abs(fishA.speed - fishB.speed) > INTERACTION_CONFIG.yieldSpeedDifference;
+        // Calculate relevant personality differences
+        const boldnessDiff = personalityA.boldness - personalityB.boldness;
+        const avgSociability = (personalityA.sociability + personalityB.sociability) / 2;
+        const minSociability = Math.min(personalityA.sociability, personalityB.sociability);
+        // Roll for each interaction type and pick the first that triggers
+        const roll = Math.random();
+        // 1. PASSING GREETING - Social fish acknowledge each other when passing
+        if (arePassing && avgSociability > 0.4) {
+            const greetingChance = INTERACTION_CONFIG.probabilities.passingGreeting * avgSociability;
+            if (roll < greetingChance) {
+                // The more social fish initiates
+                const initiator = personalityA.sociability >= personalityB.sociability ? fishA : fishB;
+                const other = initiator === fishA ? fishB : fishA;
+                return {
+                    type: "passing_greeting",
+                    fish: initiator,
+                    other,
+                    triggerWobble: "social_shimmer",
+                };
+            }
+        }
+        // 2. YIELD - Less bold fish slows for bolder fish when paths cross
+        if ((arePassing || areOvertaking) && Math.abs(boldnessDiff) > 0.25) {
+            const yieldChance = INTERACTION_CONFIG.probabilities.yield * Math.abs(boldnessDiff);
+            if (roll < yieldChance) {
+                // The less bold fish yields
+                const yielder = boldnessDiff < 0 ? fishA : fishB;
+                const dominant = yielder === fishA ? fishB : fishA;
+                return {
+                    type: "yield",
+                    fish: yielder,
+                    other: dominant,
+                    speedModifier: INTERACTION_CONFIG.yieldSpeedMultiplier,
+                    // Subtle head bob when yielding
+                    triggerWobble: "curious_tilt",
+                };
+            }
+        }
+        // 3. SOCIAL APPROACH - Very social fish veer toward neighbors
+        if (avgSociability > 0.65) {
+            const approachChance = INTERACTION_CONFIG.probabilities.socialApproach *
+                (avgSociability - 0.4);
+            if (roll < approachChance) {
+                // The more social fish approaches
+                const approacher = personalityA.sociability >= personalityB.sociability ? fishA : fishB;
+                const target = approacher === fishA ? fishB : fishA;
+                // Calculate nudge direction (toward the other fish)
+                const nudgeDirection = target.y > approacher.y ? 1 : -1;
+                const nudgeAmount = nudgeDirection *
+                    INTERACTION_CONFIG.maxVerticalNudge *
+                    approacher.personality.sociability;
+                return {
+                    type: "social_approach",
+                    fish: approacher,
+                    other: target,
+                    verticalNudge: nudgeAmount,
+                    triggerWobble: "playful_wiggle",
+                };
+            }
+        }
+        // 4. SHY AVOIDANCE - Asocial fish veer away from neighbors
+        if (minSociability < 0.35) {
+            const shySociability = Math.min(personalityA.sociability, personalityB.sociability);
+            const avoidanceChance = INTERACTION_CONFIG.probabilities.shyAvoidance *
+                (1 - shySociability);
+            if (roll < avoidanceChance) {
+                // The less social fish avoids
+                const avoider = personalityA.sociability <= personalityB.sociability ? fishA : fishB;
+                const avoided = avoider === fishA ? fishB : fishA;
+                // Calculate nudge direction (away from the other fish)
+                const nudgeDirection = avoided.y > avoider.y ? -1 : 1;
+                const nudgeAmount = nudgeDirection *
+                    INTERACTION_CONFIG.maxVerticalNudge *
+                    (1 - avoider.personality.sociability);
+                return {
+                    type: "shy_avoidance",
+                    fish: avoider,
+                    other: avoided,
+                    verticalNudge: nudgeAmount,
+                    // Startled reaction for very shy fish
+                    triggerWobble: avoider.personality.boldness < 0.3 ? "startled_dart" : undefined,
+                };
+            }
+        }
+        return null;
+    }
+    defaultPersonality() {
+        return {
+            boldness: 0.5,
+            sociability: 0.5,
+            activity: 0.5,
+            curiosity: 0.5,
+        };
+    }
+}
+//# sourceMappingURL=FishInteractionHandler.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { FishMood, MoodVisuals } from "../../domain/types/fish-personality-types.js";
+import type { IFishMoodManager } from "../contracts/IFishMoodManager.js";
+/**
+ * FishMoodManager - Manages emotional state transitions for fish
+ *
+ * Handles mood decay, energy/hunger metabolism, stimulus responses,
+ * and provides visual modifiers for rendering.
+ */
+export declare class FishMoodManager implements IFishMoodManager {
+    private static DEBUG_MOOD;
+    updateMood(fish: FishMarineLife, deltaSeconds: number): void;
+    getMoodVisuals(fish: FishMarineLife): MoodVisuals;
+    setMood(fish: FishMarineLife, mood: FishMood): void;
+    markStimulus(fish: FishMarineLife, type: "food" | "threat" | "friend" | "novelty"): void;
+    shouldTransitionBehavior(fish: FishMarineLife): boolean;
+    private updateMetabolism;
+    private checkAutomaticTransitions;
+    private decayMood;
+    /**
+     * Get the mood to decay to (allows step-down transitions)
+     */
+    private getDecayMood;
+}
+//# sourceMappingURL=FishMoodManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FishMoodManager.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/FishMoodManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AASzE;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAEtD,OAAO,CAAC,MAAM,CAAC,UAAU,CAAS;IAElC,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAoC5D,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW;IAKjD,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAKnD,YAAY,CACV,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAC7C,IAAI;IAmDP,wBAAwB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAqBvD,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,yBAAyB;IAqDjC,OAAO,CAAC,SAAS;IAwBjB;;OAEG;IACH,OAAO,CAAC,YAAY;CAoCrB"}

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

@@ -0,0 +1,241 @@
+import { MOOD_DECAY_RATES, MOOD_VISUALS, MOOD_THRESHOLDS, STIMULUS_EFFECTS, METABOLISM_RATES, } from "../../domain/constants/fish-constants.js";
+/**
+ * FishMoodManager - Manages emotional state transitions for fish
+ *
+ * Handles mood decay, energy/hunger metabolism, stimulus responses,
+ * and provides visual modifiers for rendering.
+ */
+export class FishMoodManager {
+    // Debug: Track mood changes (enable for debugging mood issues)
+    static DEBUG_MOOD = false;
+    updateMood(fish, deltaSeconds) {
+        // Initialize if needed
+        if (fish.mood === undefined)
+            fish.mood = "calm";
+        if (fish.moodTimer === undefined)
+            fish.moodTimer = 0;
+        if (fish.energy === undefined)
+            fish.energy = 0.8;
+        if (fish.hunger === undefined)
+            fish.hunger = 0.2;
+        if (fish.lastStimulusTime === undefined)
+            fish.lastStimulusTime = 0;
+        // Check if mood was manually set recently (from Fish Behavior Lab)
+        // If so, skip ALL automatic mood processing for 5 seconds
+        const manualSetAt = fish._manualMoodSetAt;
+        if (manualSetAt) {
+            const elapsed = performance.now() - manualSetAt;
+            if (elapsed < 5000) {
+                // Only update timers, don't change mood
+                fish.moodTimer += deltaSeconds;
+                fish.lastStimulusTime += deltaSeconds;
+                this.updateMetabolism(fish, deltaSeconds);
+                return;
+            }
+        }
+        // Update metabolism
+        this.updateMetabolism(fish, deltaSeconds);
+        // Update mood timer
+        fish.moodTimer += deltaSeconds;
+        fish.lastStimulusTime += deltaSeconds;
+        // Check for automatic mood transitions based on state
+        this.checkAutomaticTransitions(fish);
+        // Decay current mood toward calm
+        this.decayMood(fish, deltaSeconds);
+    }
+    getMoodVisuals(fish) {
+        const mood = fish.mood ?? "calm";
+        return MOOD_VISUALS[mood];
+    }
+    setMood(fish, mood) {
+        fish.mood = mood;
+        fish.moodTimer = 0;
+    }
+    markStimulus(fish, type) {
+        const effect = STIMULUS_EFFECTS[type];
+        // Reset stimulus timer
+        fish.lastStimulusTime = 0;
+        // Apply energy cost
+        if (fish.energy !== undefined) {
+            fish.energy = Math.max(0, fish.energy - effect.energyCost);
+        }
+        // Apply hunger effect
+        if (fish.hunger !== undefined) {
+            fish.hunger = Math.max(0, Math.min(1, fish.hunger + effect.hungerEffect));
+        }
+        // Personality affects how fish respond to stimuli
+        const personality = fish.personality;
+        if (personality) {
+            // Bold fish don't get as startled by threats
+            if (type === "threat" && personality.boldness > 0.7) {
+                // High boldness: might become curious instead of alert
+                if (Math.random() < personality.boldness - 0.5) {
+                    this.setMood(fish, "curious");
+                    return;
+                }
+            }
+            // Shy fish don't approach friends as readily
+            if (type === "friend" && personality.sociability < 0.3) {
+                // Low sociability: might stay calm instead of social
+                if (Math.random() > personality.sociability + 0.2) {
+                    return; // No mood change
+                }
+            }
+            // High curiosity fish get more excited by novelty
+            if (type === "novelty" && personality.curiosity > 0.7) {
+                this.setMood(fish, "curious");
+                // Might trigger wobble
+                fish.wobbleType = "curious_tilt";
+                fish.wobbleTimer = 0.6; // Match WOBBLE_CONFIGS duration
+                fish.wobbleIntensity = 1;
+                return;
+            }
+        }
+        // Default: apply the stimulus mood
+        this.setMood(fish, effect.mood);
+    }
+    shouldTransitionBehavior(fish) {
+        const mood = fish.mood ?? "calm";
+        // Alert fish should consider fleeing
+        if (mood === "alert")
+            return true;
+        // Hungry fish should consider feeding
+        if (mood === "hungry" && (fish.hunger ?? 0) > 0.6)
+            return true;
+        // Tired fish should consider resting
+        if (mood === "tired")
+            return true;
+        // Social fish should consider approaching others
+        if (mood === "social")
+            return true;
+        // Playful fish change behavior more often
+        if (mood === "playful")
+            return Math.random() < 0.3;
+        return false;
+    }
+    updateMetabolism(fish, deltaSeconds) {
+        // Energy drain
+        let energyDrain = METABOLISM_RATES.energyDrain;
+        // Faster movement drains more energy
+        if (fish.speed > fish.baseSpeed * 1.5) {
+            energyDrain *= METABOLISM_RATES.fastMovementDrain;
+        }
+        // Activity personality affects drain
+        if (fish.personality?.activity) {
+            // High activity fish burn energy faster but also recover faster
+            energyDrain *= 0.8 + fish.personality.activity * 0.4;
+        }
+        // Resting recovers energy (behavior check would be better but mood is proxy)
+        if (fish.mood === "tired" && fish.speed < fish.baseSpeed * 0.5) {
+            fish.energy = Math.min(1, (fish.energy ?? 0) + METABOLISM_RATES.restRecovery * deltaSeconds);
+        }
+        else {
+            fish.energy = Math.max(0, (fish.energy ?? 0) - energyDrain * deltaSeconds);
+        }
+        // Hunger increases over time
+        fish.hunger = Math.min(1, (fish.hunger ?? 0) + METABOLISM_RATES.hungerIncrease * deltaSeconds);
+    }
+    checkAutomaticTransitions(fish) {
+        const energy = fish.energy ?? 0.8;
+        const hunger = fish.hunger ?? 0;
+        const currentMood = fish.mood ?? "calm";
+        const moodTimer = fish.moodTimer ?? 0;
+        // Don't override moods that were just set (within 2 seconds)
+        // This allows manual mood changes from the lab to persist
+        if (moodTimer < 2 && currentMood !== "calm") {
+            if (FishMoodManager.DEBUG_MOOD) {
+                // Only log occasionally to avoid spam
+                if (Math.random() < 0.01) {
+                    console.log(`🛡️ GUARD PROTECTED: ${currentMood} (timer: ${moodTimer.toFixed(3)})`);
+                }
+            }
+            return;
+        }
+        // Tired overrides most moods when energy is very low
+        if (energy < MOOD_THRESHOLDS.tiredEnergy && currentMood !== "alert") {
+            if (currentMood !== "tired") {
+                this.setMood(fish, "tired");
+                // Trigger tired wobble
+                fish.wobbleType = "tired_drift";
+                fish.wobbleTimer = 1.2; // Match WOBBLE_CONFIGS duration
+                fish.wobbleIntensity = 1;
+            }
+            return;
+        }
+        // Hungry mood when hunger is high
+        if (hunger > MOOD_THRESHOLDS.hungryLevel && currentMood === "calm") {
+            this.setMood(fish, "hungry");
+            return;
+        }
+        // Spontaneous playfulness (if enough energy and right personality)
+        if (currentMood === "calm" &&
+            energy > MOOD_THRESHOLDS.playfulMinEnergy &&
+            fish.personality?.activity &&
+            fish.personality.activity > 0.6) {
+            // Higher activity = more likely to become playful spontaneously
+            if (Math.random() < 0.001 * fish.personality.activity) {
+                this.setMood(fish, "playful");
+                fish.wobbleType = "playful_wiggle";
+                fish.wobbleTimer = 0.8; // Match WOBBLE_CONFIGS duration
+                fish.wobbleIntensity = 1;
+            }
+        }
+    }
+    decayMood(fish, deltaSeconds) {
+        const mood = fish.mood ?? "calm";
+        if (mood === "calm")
+            return; // Already at baseline
+        const decayRate = MOOD_DECAY_RATES[mood];
+        const moodTimer = fish.moodTimer ?? 0;
+        // Minimum time before decay can start (gives manual changes time to be observed)
+        const minMoodDuration = Math.max(3, 1 / decayRate);
+        // Check if mood should decay back to calm
+        // Decay probability increases with time and decay rate
+        const decayChance = decayRate * deltaSeconds;
+        if (moodTimer > minMoodDuration && Math.random() < decayChance) {
+            // Check if there's a natural "step down" mood
+            const nextMood = this.getDecayMood(mood, fish);
+            if (FishMoodManager.DEBUG_MOOD) {
+                console.log(`📉 DECAY: ${mood} → ${nextMood} (timer: ${moodTimer.toFixed(2)}, minDuration: ${minMoodDuration.toFixed(2)})`);
+            }
+            this.setMood(fish, nextMood);
+        }
+    }
+    /**
+     * Get the mood to decay to (allows step-down transitions)
+     */
+    getDecayMood(currentMood, fish) {
+        // Most moods decay to calm
+        // But some have intermediate states
+        switch (currentMood) {
+            case "alert":
+                // Alert can decay to curious (still watchful) then calm
+                if ((fish.moodTimer ?? 0) < 3)
+                    return "curious";
+                return "calm";
+            case "playful":
+                // Playful can decay to calm, or tired if low energy
+                if ((fish.energy ?? 1) < 0.4)
+                    return "tired";
+                return "calm";
+            case "social":
+                // Social decays to calm
+                return "calm";
+            case "hungry":
+                // Hungry persists until fed, but can decay if hunger drops
+                if ((fish.hunger ?? 0) < 0.5)
+                    return "calm";
+                return "hungry"; // Stay hungry
+            case "tired":
+                // Tired persists until energy recovers
+                if ((fish.energy ?? 0) > 0.5)
+                    return "calm";
+                return "tired"; // Stay tired
+            case "curious":
+                return "calm";
+            default:
+                return "calm";
+        }
+    }
+}
+//# sourceMappingURL=FishMoodManager.js.map

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

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

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

@@ -0,0 +1,50 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { IFishMovementController } from "../contracts/IFishMovementController.js";
+import type { IFishDecisionMaker } from "../contracts/IFishDecisionMaker.js";
+/**
+ * FishMovementController - Manages fish behavior state machine and movement
+ *
+ * Handles behavior transitions (cruising, turning, darting, schooling),
+ * applies movement based on current behavior, and manages edge awareness.
+ * Now supports personality-influenced decisions via FishDecisionMaker.
+ */
+export declare class FishMovementController implements IFishMovementController {
+    private decisionMaker;
+    constructor(decisionMaker?: IFishDecisionMaker);
+    applyBehavior(fish: FishMarineLife, deltaSeconds: number, frameMultiplier: number, dimensions: Dimensions): void;
+    /**
+     * Updates the fish's z-axis position by lerping toward targetZ.
+     * Called every frame to smoothly animate depth changes.
+     */
+    updateDepth(fish: FishMarineLife, frameMultiplier: number): void;
+    transitionBehavior(fish: FishMarineLife, dimensions: Dimensions, nearbyFish?: FishMarineLife[], animationTime?: number): void;
+    isOffScreen(fish: FishMarineLife, dimensions: Dimensions): boolean;
+    getEdgeProximity(fish: FishMarineLife, dimensions: Dimensions): number;
+    private applyCruising;
+    private applyTurning;
+    /**
+     * Natural fish C-start escape response with three phases:
+     * 1. COIL - body tenses, slows down briefly (preparatory)
+     * 2. BURST - explosive acceleration (propulsive)
+     * 3. RECOVERY - gradual easeOutExpo deceleration
+     */
+    private applyDarting;
+    /**
+     * Fast direct swimming - no bobbing, straight line, streamlined posture.
+     * Creates variety with fish that zoom across the screen.
+     */
+    private applyPassing;
+    /**
+     * Ascending - swimming upward with vertical focus.
+     * Fish browses toward the surface with angled body rotation.
+     */
+    private applyAscending;
+    /**
+     * Descending - swimming downward with vertical focus.
+     * Fish browses toward the depths with angled body rotation.
+     */
+    private applyDescending;
+    private randomInRange;
+}
+//# sourceMappingURL=FishMovementController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FishMovementController.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/FishMovementController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAS7E;;;;;;GAMG;AACH,qBAAa,sBAAuB,YAAW,uBAAuB;IACpE,OAAO,CAAC,aAAa,CAAqB;gBAE9B,aAAa,CAAC,EAAE,kBAAkB;IAG9C,aAAa,CACX,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,UAAU,GACrB,IAAI;IA6CP;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAQhE,kBAAkB,CAChB,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,GAAE,cAAc,EAAO,EACjC,aAAa,GAAE,MAAU,GACxB,IAAI;IAoIP,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO;IAKlE,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM;IActE,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,YAAY;IAYpB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAwDpB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAOpB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAsBtB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,aAAa;CAKtB"}