@austencloud/backgrounds 0.1.0

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

@@ -0,0 +1,293 @@
+import { FISH_COUNTS, SPAWN_CONFIG } from "../../domain/constants/fish-constants.js";
+import { fishDebugConfig } from "../../domain/debug-config.js";
+import { FishMoodManager } from "./FishMoodManager.js";
+import { FishWobbleAnimator } from "./FishWobbleAnimator.js";
+import { FishInteractionHandler } from "./FishInteractionHandler.js";
+import { FishRareBehaviorHandler } from "./FishRareBehaviorHandler.js";
+import { FishHomeZoneHandler } from "./FishHomeZoneHandler.js";
+import { FishHuntingHandler } from "./FishHuntingHandler.js";
+/**
+ * FishAnimator - Orchestrates fish animation subsystems
+ *
+ * Coordinates creation, physics, movement, flocking, mood, and visual updates
+ * by delegating to specialized services. Manages spawn scheduling and
+ * fish lifecycle.
+ */
+export class FishAnimator {
+    fishFactory;
+    spineController;
+    movementController;
+    flockingCalculator;
+    visualUpdater;
+    pendingSpawns = [];
+    moodManager;
+    wobbleAnimator;
+    interactionHandler;
+    rareBehaviorHandler;
+    homeZoneHandler;
+    huntingHandler;
+    constructor(fishFactory, spineController, movementController, flockingCalculator, visualUpdater, moodManager, wobbleAnimator, interactionHandler, rareBehaviorHandler, homeZoneHandler, huntingHandler) {
+        this.fishFactory = fishFactory;
+        this.spineController = spineController;
+        this.movementController = movementController;
+        this.flockingCalculator = flockingCalculator;
+        this.visualUpdater = visualUpdater;
+        this.moodManager = moodManager ?? new FishMoodManager();
+        this.wobbleAnimator = wobbleAnimator ?? new FishWobbleAnimator();
+        this.interactionHandler = interactionHandler ?? new FishInteractionHandler(this.wobbleAnimator);
+        this.rareBehaviorHandler = rareBehaviorHandler ?? new FishRareBehaviorHandler(this.wobbleAnimator);
+        this.homeZoneHandler = homeZoneHandler ?? new FishHomeZoneHandler();
+        this.huntingHandler = huntingHandler ?? new FishHuntingHandler(this.wobbleAnimator);
+    }
+    async initializeFish(dimensions, count, useSpineChain = true, spawnOnScreen = false) {
+        const fish = this.fishFactory.initializeFish(dimensions, count, useSpineChain, spawnOnScreen);
+        // Initialize spine chains and home zones for all fish
+        for (const f of fish) {
+            if (f.useSpineChain) {
+                this.spineController.initializeSpineChain(f);
+            }
+            // Initialize home zone at spawn position
+            this.homeZoneHandler.initializeHomeZone(f);
+        }
+        // Form schools
+        this.flockingCalculator.formSchools(fish);
+        return fish;
+    }
+    createFish(dimensions, useSpineChain = true, spawnOnScreen = false) {
+        const fish = this.fishFactory.createFish(dimensions, useSpineChain, spawnOnScreen);
+        if (fish.useSpineChain) {
+            this.spineController.initializeSpineChain(fish);
+        }
+        // Initialize home zone at spawn position
+        this.homeZoneHandler.initializeHomeZone(fish);
+        return fish;
+    }
+    // Debug: Track position jumps (disabled - was causing console spam)
+    static DEBUG_POSITION_JUMPS = false;
+    static JUMP_THRESHOLD = 30; // pixels
+    updateFish(fish, dimensions, frameMultiplier, animationTime) {
+        const updatedFish = [];
+        const deltaSeconds = 0.016 * frameMultiplier;
+        // Apply flocking forces to schooling fish
+        this.flockingCalculator.applyFlockingForces(fish, deltaSeconds);
+        // Process fish-to-fish micro-interactions (greetings, yielding, etc.)
+        if (fishDebugConfig.enableInteractions) {
+            const interactions = this.interactionHandler.processInteractions(fish, deltaSeconds);
+            for (const interaction of interactions) {
+                this.interactionHandler.applyInteraction(interaction);
+            }
+        }
+        // Process rare special behaviors (barrel rolls, freezes, etc.)
+        if (fishDebugConfig.enableRareBehaviors) {
+            const rareBehaviors = this.rareBehaviorHandler.checkRareBehaviors(fish, deltaSeconds);
+            for (const behavior of rareBehaviors) {
+                this.rareBehaviorHandler.applyRareBehavior(behavior);
+            }
+        }
+        // Apply home zone drift (subtle pull toward spawn area)
+        if (fishDebugConfig.enableHomeZones) {
+            for (const f of fish) {
+                this.homeZoneHandler.applyHomeZoneDrift(f, deltaSeconds);
+            }
+        }
+        // Process predator/prey hunting (chase sequences)
+        if (fishDebugConfig.enableHunting) {
+            const huntResults = this.huntingHandler.processHunting(fish, deltaSeconds, animationTime);
+            for (const result of huntResults) {
+                this.huntingHandler.applyHuntResult(result, fish);
+            }
+        }
+        // Update each fish
+        for (const f of fish) {
+            // DEBUG: Capture position before update
+            const beforeX = f.x;
+            const beforeY = f.y;
+            const beforeSpineX = f.spineJoints?.[0]?.x;
+            const beforeSpineY = f.spineJoints?.[0]?.y;
+            const stepPositions = [];
+            if (FishAnimator.DEBUG_POSITION_JUMPS) {
+                stepPositions.push({ step: 'start', x: f.x, y: f.y, spineX: f.spineJoints?.[0]?.x, spineY: f.spineJoints?.[0]?.y });
+            }
+            // Update behavior timer
+            f.behaviorTimer -= deltaSeconds;
+            if (f.behaviorTimer <= 0) {
+                // Pass nearby fish for social behavior decisions
+                const nearbyFish = fish.filter((other) => other !== f &&
+                    Math.abs(other.x - f.x) < 200 &&
+                    Math.abs(other.y - f.y) < 100);
+                this.movementController.transitionBehavior(f, dimensions, nearbyFish, animationTime);
+            }
+            // Update mood state (handles energy, hunger, mood decay)
+            this.moodManager.updateMood(f, deltaSeconds);
+            if (FishAnimator.DEBUG_POSITION_JUMPS) {
+                stepPositions.push({ step: 'afterMood', x: f.x, y: f.y, spineX: f.spineJoints?.[0]?.x, spineY: f.spineJoints?.[0]?.y });
+            }
+            // Update propulsion from tail physics BEFORE movement
+            // This connects tail animation to actual speed
+            if (f.useSpineChain) {
+                this.spineController.updatePropulsion(f, deltaSeconds);
+            }
+            if (FishAnimator.DEBUG_POSITION_JUMPS) {
+                stepPositions.push({ step: 'afterPropulsion', x: f.x, y: f.y, spineX: f.spineJoints?.[0]?.x, spineY: f.spineJoints?.[0]?.y });
+            }
+            // Apply behavior-specific movement (now uses thrust-modulated speed)
+            this.movementController.applyBehavior(f, deltaSeconds, frameMultiplier, dimensions);
+            if (FishAnimator.DEBUG_POSITION_JUMPS) {
+                stepPositions.push({ step: 'afterBehavior', x: f.x, y: f.y, spineX: f.spineJoints?.[0]?.x, spineY: f.spineJoints?.[0]?.y });
+            }
+            // Update animation based on mode
+            if (f.useSpineChain) {
+                this.spineController.updateSpineChain(f, deltaSeconds, frameMultiplier);
+                if (FishAnimator.DEBUG_POSITION_JUMPS) {
+                    stepPositions.push({ step: 'afterSpineUpdate', x: f.x, y: f.y, spineX: f.spineJoints?.[0]?.x, spineY: f.spineJoints?.[0]?.y });
+                }
+            }
+            else {
+                this.visualUpdater.updateBodyFlex(f, frameMultiplier);
+                this.visualUpdater.updateFinPhysics(f, frameMultiplier);
+            }
+            // Update visual animations
+            this.visualUpdater.updateVisuals(f, frameMultiplier, animationTime);
+            if (FishAnimator.DEBUG_POSITION_JUMPS) {
+                stepPositions.push({ step: 'afterVisuals', x: f.x, y: f.y, spineX: f.spineJoints?.[0]?.x, spineY: f.spineJoints?.[0]?.y });
+            }
+            // Update wobble animations (decay timer and intensity)
+            this.wobbleAnimator.updateWobble(f, deltaSeconds);
+            // DEBUG: Detect position jumps
+            if (FishAnimator.DEBUG_POSITION_JUMPS) {
+                const afterX = f.x;
+                const afterY = f.y;
+                const afterSpineX = f.spineJoints?.[0]?.x;
+                const afterSpineY = f.spineJoints?.[0]?.y;
+                const deltaX = Math.abs(afterX - beforeX);
+                const deltaY = Math.abs(afterY - beforeY);
+                const deltaSpineX = beforeSpineX !== undefined && afterSpineX !== undefined
+                    ? Math.abs(afterSpineX - beforeSpineX) : 0;
+                const deltaSpineY = beforeSpineY !== undefined && afterSpineY !== undefined
+                    ? Math.abs(afterSpineY - beforeSpineY) : 0;
+                const maxDelta = Math.max(deltaX, deltaY, deltaSpineX, deltaSpineY);
+                if (maxDelta > FishAnimator.JUMP_THRESHOLD) {
+                    // Find where the jump happened
+                    let jumpStep = 'unknown';
+                    for (let i = 1; i < stepPositions.length; i++) {
+                        const prev = stepPositions[i - 1];
+                        const curr = stepPositions[i];
+                        const stepDeltaX = Math.abs(curr.x - prev.x);
+                        const stepDeltaY = Math.abs(curr.y - prev.y);
+                        const stepDeltaSpineX = prev.spineX !== undefined && curr.spineX !== undefined
+                            ? Math.abs(curr.spineX - prev.spineX) : 0;
+                        const stepDeltaSpineY = prev.spineY !== undefined && curr.spineY !== undefined
+                            ? Math.abs(curr.spineY - prev.spineY) : 0;
+                        const stepMaxDelta = Math.max(stepDeltaX, stepDeltaY, stepDeltaSpineX, stepDeltaSpineY);
+                        if (stepMaxDelta > FishAnimator.JUMP_THRESHOLD) {
+                            jumpStep = `${prev.step} → ${curr.step} (delta: ${stepMaxDelta.toFixed(1)})`;
+                            break;
+                        }
+                    }
+                    console.warn(`🐟 POSITION JUMP DETECTED!`, {
+                        jumpStep,
+                        species: f.species,
+                        behavior: f.behavior,
+                        mood: f.mood,
+                        wobbleType: f.wobbleType,
+                        wobbleTimer: f.wobbleTimer?.toFixed(3),
+                        wobbleIntensity: f.wobbleIntensity?.toFixed(3),
+                        frameMultiplier: frameMultiplier.toFixed(3),
+                        deltaSeconds: deltaSeconds.toFixed(4),
+                        speed: f.speed.toFixed(1),
+                        baseSpeed: f.baseSpeed.toFixed(1),
+                        position: {
+                            before: { x: beforeX.toFixed(1), y: beforeY.toFixed(1) },
+                            after: { x: afterX.toFixed(1), y: afterY.toFixed(1) },
+                            deltaX: deltaX.toFixed(1),
+                            deltaY: deltaY.toFixed(1),
+                        },
+                        spine: beforeSpineX !== undefined ? {
+                            before: { x: beforeSpineX.toFixed(1), y: beforeSpineY?.toFixed(1) },
+                            after: { x: afterSpineX?.toFixed(1), y: afterSpineY?.toFixed(1) },
+                            deltaX: deltaSpineX.toFixed(1),
+                            deltaY: deltaSpineY.toFixed(1),
+                        } : 'no spine',
+                        stepTrace: stepPositions.map(s => `${s.step}: (${s.x.toFixed(0)}, ${s.y.toFixed(0)}) spine:(${s.spineX?.toFixed(0) ?? '?'}, ${s.spineY?.toFixed(0) ?? '?'})`),
+                    });
+                }
+            }
+            // Check if off screen
+            if (this.movementController.isOffScreen(f, dimensions)) {
+                this.scheduleSpawn(animationTime + this.randomInRange(SPAWN_CONFIG.respawnDelay));
+                this.spineController.removeSpineChain(f);
+            }
+            else {
+                updatedFish.push(f);
+            }
+        }
+        return updatedFish;
+    }
+    /**
+     * Get spine chain for a fish (for external access)
+     */
+    getSpineChain(fish) {
+        return this.spineController.getSpineChain(fish);
+    }
+    /**
+     * Get wobble offset for a fish (for rendering)
+     */
+    getWobbleOffset(fish) {
+        return this.wobbleAnimator.getWobbleOffset(fish);
+    }
+    /**
+     * Reposition a fish's spine chain by a delta
+     * Call this after manually moving a fish's position to keep physics in sync
+     */
+    repositionFish(fish, dx, dy) {
+        this.spineController.repositionSpineChain(fish, dx, dy);
+    }
+    getFishCount(quality) {
+        return FISH_COUNTS[quality] ?? 8;
+    }
+    scheduleSpawn(spawnTime) {
+        this.pendingSpawns.push(spawnTime);
+    }
+    processPendingSpawns(dimensions, currentTime) {
+        const newFish = [];
+        for (let i = this.pendingSpawns.length - 1; i >= 0; i--) {
+            const spawnTime = this.pendingSpawns[i];
+            if (spawnTime !== undefined && currentTime >= spawnTime) {
+                newFish.push(this.createFish(dimensions));
+                this.pendingSpawns.splice(i, 1);
+            }
+        }
+        return newFish;
+    }
+    randomInRange(range) {
+        return range[0] + Math.random() * (range[1] - range[0]);
+    }
+    // ============================================================================
+    // Handler Access (for lab/testing)
+    // ============================================================================
+    /**
+     * Get the rare behavior handler for manual triggering in lab
+     */
+    getRareBehaviorHandler() {
+        return this.rareBehaviorHandler;
+    }
+    /**
+     * Get the home zone handler for visualization in lab
+     */
+    getHomeZoneHandler() {
+        return this.homeZoneHandler;
+    }
+    /**
+     * Get the interaction handler for manual triggering in lab
+     */
+    getInteractionHandler() {
+        return this.interactionHandler;
+    }
+    /**
+     * Get the hunting handler for visualization and manual triggering in lab
+     */
+    getHuntingHandler() {
+        return this.huntingHandler;
+    }
+}
+//# sourceMappingURL=FishAnimator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FishAnimator.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/FishAnimator.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IAUJ;IACA;IACA;IACA;IACA;IAbX,aAAa,GAAa,EAAE,CAAC;IAC7B,WAAW,CAAmB;IAC9B,cAAc,CAAsB;IACpC,kBAAkB,CAA0B;IAC5C,mBAAmB,CAA2B;IAC9C,eAAe,CAAuB;IACtC,cAAc,CAAsB;IAE5C,YACmB,WAAyB,EACzB,eAAqC,EACrC,kBAA2C,EAC3C,kBAA2C,EAC3C,aAAiC,EAClD,WAA8B,EAC9B,cAAoC,EACpC,kBAA4C,EAC5C,mBAA8C,EAC9C,eAAsC,EACtC,cAAoC;QAVnB,gBAAW,GAAX,WAAW,CAAc;QACzB,oBAAe,GAAf,eAAe,CAAsB;QACrC,uBAAkB,GAAlB,kBAAkB,CAAyB;QAC3C,uBAAkB,GAAlB,kBAAkB,CAAyB;QAC3C,kBAAa,GAAb,aAAa,CAAoB;QAQlD,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,IAAI,eAAe,EAAE,CAAC;QACxD,IAAI,CAAC,cAAc,GAAG,cAAc,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACjE,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,IAAI,IAAI,sBAAsB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChG,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,IAAI,IAAI,uBAAuB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACnG,IAAI,CAAC,eAAe,GAAG,eAAe,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACpE,IAAI,CAAC,cAAc,GAAG,cAAc,IAAI,IAAI,kBAAkB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,UAAsB,EACtB,KAAa,EACb,gBAAyB,IAAI,EAC7B,gBAAyB,KAAK;QAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QAE9F,sDAAsD;QACtD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;gBACpB,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;YACD,yCAAyC;YACzC,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,eAAe;QACf,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAE1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,CAAC,UAAsB,EAAE,gBAAyB,IAAI,EAAE,gBAAyB,KAAK;QAC9F,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QAEnF,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QAED,yCAAyC;QACzC,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAE9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IAC5D,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAC;IACpC,MAAM,CAAC,cAAc,GAAG,EAAE,CAAC,CAAC,SAAS;IAE7C,UAAU,CACR,IAAsB,EACtB,UAAsB,EACtB,eAAuB,EACvB,aAAqB;QAErB,MAAM,WAAW,GAAqB,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,KAAK,GAAG,eAAe,CAAC;QAE7C,0CAA0C;QAC1C,IAAI,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAEhE,sEAAsE;QACtE,IAAI,eAAe,CAAC,kBAAkB,EAAE,CAAC;YACvC,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACrF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;gBACvC,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,+DAA+D;QAC/D,IAAI,eAAe,CAAC,mBAAmB,EAAE,CAAC;YACxC,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACtF,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;gBACrC,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,IAAI,eAAe,CAAC,eAAe,EAAE,CAAC;YACpC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,IAAI,eAAe,CAAC,aAAa,EAAE,CAAC;YAClC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,cAAc,CACpD,IAAI,EACJ,YAAY,EACZ,aAAa,CACd,CAAC;YACF,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;gBACjC,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,wCAAwC;YACxC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;YACpB,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;YACpB,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3C,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3C,MAAM,aAAa,GAAkF,EAAE,CAAC;YACxG,IAAI,YAAY,CAAC,oBAAoB,EAAE,CAAC;gBACtC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACtH,CAAC;YACD,wBAAwB;YACxB,CAAC,CAAC,aAAa,IAAI,YAAY,CAAC;YAChC,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC;gBACzB,iDAAiD;gBACjD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,KAAK,CAAC;oBACX,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;oBAC7B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAChC,CAAC;gBACF,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,CACxC,CAAC,EACD,UAAU,EACV,UAAU,EACV,aAAa,CACd,CAAC;YACJ,CAAC;YAED,yDAAyD;YACzD,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YAC7C,IAAI,YAAY,CAAC,oBAAoB,EAAE,CAAC;gBACtC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC1H,CAAC;YAED,sDAAsD;YACtD,+CAA+C;YAC/C,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;gBACpB,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YACzD,CAAC;YACD,IAAI,YAAY,CAAC,oBAAoB,EAAE,CAAC;gBACtC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAChI,CAAC;YAED,qEAAqE;YACrE,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;YACpF,IAAI,YAAY,CAAC,oBAAoB,EAAE,CAAC;gBACtC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9H,CAAC;YAED,iCAAiC;YACjC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;gBACpB,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;gBACxE,IAAI,YAAY,CAAC,oBAAoB,EAAE,CAAC;oBACtC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACjI,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;gBACtD,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;YAC1D,CAAC;YAED,2BAA2B;YAC3B,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;YACpE,IAAI,YAAY,CAAC,oBAAoB,EAAE,CAAC;gBACtC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC7H,CAAC;YAED,uDAAuD;YACvD,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YAElD,+BAA+B;YAC/B,IAAI,YAAY,CAAC,oBAAoB,EAAE,CAAC;gBACtC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;gBACnB,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;gBACnB,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC1C,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAE1C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;gBAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;gBAC1C,MAAM,WAAW,GAAG,YAAY,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS;oBACzE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7C,MAAM,WAAW,GAAG,YAAY,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS;oBACzE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;gBAEpE,IAAI,QAAQ,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC;oBAC3C,+BAA+B;oBAC/B,IAAI,QAAQ,GAAG,SAAS,CAAC;oBACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;wBAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;wBACnC,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAE,CAAC;wBAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;wBAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;wBAC7C,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;4BAC5E,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC5C,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;4BAC5E,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;wBACxF,IAAI,YAAY,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC;4BAC/C,QAAQ,GAAG,GAAG,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,YAAY,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;4BAC7E,MAAM;wBACR,CAAC;oBACH,CAAC;oBAED,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE;wBACzC,QAAQ;wBACR,OAAO,EAAE,CAAC,CAAC,OAAO;wBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;wBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,UAAU,EAAE,CAAC,CAAC,UAAU;wBACxB,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;wBACtC,eAAe,EAAE,CAAC,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;wBAC9C,eAAe,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;wBAC3C,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;wBACrC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;wBACzB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;wBACjC,QAAQ,EAAE;4BACR,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;4BACxD,KAAK,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;4BACrD,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;4BACzB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;yBAC1B;wBACD,KAAK,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC;4BAClC,MAAM,EAAE,EAAE,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE;4BACnE,KAAK,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE;4BACjE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;4BAC9B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;yBAC/B,CAAC,CAAC,CAAC,UAAU;wBACd,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;qBAC9J,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,sBAAsB;YACtB,IAAI,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC;gBACvD,IAAI,CAAC,aAAa,CAChB,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,YAAY,CAAC,CAC9D,CAAC;gBACF,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAAoB;QAChC,OAAO,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAoB;QAClC,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,IAAoB,EAAE,EAAU,EAAE,EAAU;QACzD,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,oBAAoB,CAClB,UAAsB,EACtB,WAAmB;QAEnB,MAAM,OAAO,GAAqB,EAAE,CAAC;QAErC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACxD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,SAAS,KAAK,SAAS,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;gBACxD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC1C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,aAAa,CACnB,KAAmD;QAEnD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,+EAA+E;IAC/E,mCAAmC;IACnC,+EAA+E;IAE/E;;OAEG;IACH,sBAAsB;QACpB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { IFishBodyRenderer } from "../contracts/IFishBodyRenderer.js";
+import type { IColorCalculator } from "../contracts/IColorCalculator.js";
+import { type Point } from "../../physics/BodyOutlineCalculator.js";
+/**
+ * Renders fish body shapes (spine-based and legacy Bezier).
+ */
+export declare class FishBodyRenderer implements IFishBodyRenderer {
+    private colorCalc;
+    private bodyOutlineCalculator;
+    constructor(colorCalc: IColorCalculator);
+    /**
+     * Draw body from spine outline with gradient
+     */
+    drawSpineBody(ctx: CanvasRenderingContext2D, fish: FishMarineLife, outline: {
+        leftPoints: Point[];
+        rightPoints: Point[];
+        headPoint: Point;
+        tailPoint: Point;
+    }): void;
+    /**
+     * Draw legacy Bezier fish body
+     */
+    drawBody(ctx: CanvasRenderingContext2D, fish: FishMarineLife, len: number, height: number): void;
+    private getFlexOffset;
+}
+//# sourceMappingURL=FishBodyRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FishBodyRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/FishBodyRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,wCAAwC,CAAC;AAmE3F;;GAEG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IAG5C,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,qBAAqB,CAA+B;gBAExC,SAAS,EAAE,gBAAgB;IAE/C;;OAEG;IACH,aAAa,CACX,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE;QAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAAC,WAAW,EAAE,KAAK,EAAE,CAAC;QAAC,SAAS,EAAE,KAAK,CAAC;QAAC,SAAS,EAAE,KAAK,CAAA;KAAE,GACzF,IAAI;IAiCP;;OAEG;IACH,QAAQ,CACN,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,IAAI;IA2EP,OAAO,CAAC,aAAa;CAItB"}

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

@@ -0,0 +1,152 @@
+import { BodyOutlineCalculator } from "../../physics/BodyOutlineCalculator.js";
+/**
+ * Body Shape Configuration
+ *
+ * Control points for Bezier curves defining fish body shapes.
+ */
+const RENDER_CONFIG = {
+    // Body shape control points (fraction of body length)
+    bodyShape: {
+        // Control points for dorsal (top) curve
+        dorsalControlPoints: [
+            { x: -0.5, y: 0 }, // Nose
+            { x: -0.3, y: -0.4 }, // Forehead rise
+            { x: 0.0, y: -0.5 }, // Peak (widest)
+            { x: 0.3, y: -0.3 }, // Toward tail
+            { x: 0.45, y: -0.1 }, // Tail junction
+        ],
+        // Control points for ventral (bottom) curve
+        ventralControlPoints: [
+            { x: -0.5, y: 0 }, // Nose (same as dorsal)
+            { x: -0.3, y: 0.25 }, // Lower jaw
+            { x: 0.0, y: 0.4 }, // Belly peak
+            { x: 0.3, y: 0.25 }, // Toward tail
+            { x: 0.45, y: 0.1 }, // Tail junction
+        ],
+    },
+};
+/**
+ * Species-specific body shape modifiers
+ */
+const SPECIES_SHAPE = {
+    tropical: {
+        dorsalMod: 1.2, // Taller dorsal
+        ventralMod: 1.1,
+        noseTaper: 0.8, // Rounder nose
+        tailTaper: 0.7,
+    },
+    sleek: {
+        dorsalMod: 0.7, // Flatter
+        ventralMod: 0.6,
+        noseTaper: 1.3, // Pointed nose
+        tailTaper: 1.2,
+    },
+    deep: {
+        dorsalMod: 1.0,
+        ventralMod: 1.1,
+        noseTaper: 0.9,
+        tailTaper: 0.8,
+    },
+    schooling: {
+        dorsalMod: 0.9,
+        ventralMod: 0.85,
+        noseTaper: 1.0,
+        tailTaper: 0.9,
+    },
+};
+/**
+ * Renders fish body shapes (spine-based and legacy Bezier).
+ */
+export class FishBodyRenderer {
+    colorCalc;
+    bodyOutlineCalculator = new BodyOutlineCalculator();
+    constructor(colorCalc) {
+        this.colorCalc = colorCalc;
+    }
+    /**
+     * Draw body from spine outline with gradient
+     */
+    drawSpineBody(ctx, fish, outline) {
+        const { leftPoints, rightPoints, headPoint, tailPoint } = outline;
+        if (leftPoints.length < 2)
+            return;
+        // Calculate bounds for gradient
+        let minY = Infinity, maxY = -Infinity;
+        for (const p of leftPoints) {
+            minY = Math.min(minY, p.y);
+            maxY = Math.max(maxY, p.y);
+        }
+        for (const p of rightPoints) {
+            minY = Math.min(minY, p.y);
+            maxY = Math.max(maxY, p.y);
+        }
+        // Draw body path
+        this.bodyOutlineCalculator.drawBodyPath(ctx, outline);
+        // Body gradient (top to bottom)
+        const gradient = ctx.createLinearGradient(0, minY, 0, maxY);
+        gradient.addColorStop(0, fish.colors.bodyTop);
+        gradient.addColorStop(0.4, this.colorCalc.blendColors(fish.colors.bodyTop, fish.colors.bodyBottom, 0.3));
+        gradient.addColorStop(1, fish.colors.bodyBottom);
+        ctx.fillStyle = gradient;
+        ctx.fill();
+        // Subtle outline
+        ctx.strokeStyle = this.colorCalc.adjustAlpha(fish.colors.bodyTop, 0.3);
+        ctx.lineWidth = 0.5;
+        ctx.stroke();
+    }
+    /**
+     * Draw legacy Bezier fish body
+     */
+    drawBody(ctx, fish, len, height) {
+        const shape = SPECIES_SHAPE[fish.species];
+        const colors = fish.colors;
+        // Apply body flex (S-curve deformation)
+        const flexAmount = Math.sin(fish.bodyFlexPhase) * fish.bodyFlexAmount * height * 0.5;
+        // Create body path
+        ctx.beginPath();
+        // Get modified control points
+        const dorsalPoints = RENDER_CONFIG.bodyShape.dorsalControlPoints.map((p, i) => ({
+            x: p.x * len,
+            y: p.y * height * shape.dorsalMod + this.getFlexOffset(p.x, flexAmount),
+        }));
+        const ventralPoints = RENDER_CONFIG.bodyShape.ventralControlPoints.map((p) => ({
+            x: p.x * len,
+            y: p.y * height * shape.ventralMod + this.getFlexOffset(p.x, flexAmount),
+        }));
+        // Draw dorsal curve (top)
+        ctx.moveTo(dorsalPoints[0].x, dorsalPoints[0].y);
+        for (let i = 1; i < dorsalPoints.length; i++) {
+            const prev = dorsalPoints[i - 1];
+            const curr = dorsalPoints[i];
+            const cpX = (prev.x + curr.x) / 2;
+            ctx.quadraticCurveTo(prev.x + (curr.x - prev.x) * 0.5, prev.y, cpX, (prev.y + curr.y) / 2);
+        }
+        // Continue to last dorsal point
+        const lastDorsal = dorsalPoints[dorsalPoints.length - 1];
+        ctx.lineTo(lastDorsal.x, lastDorsal.y);
+        // Draw ventral curve (bottom) in reverse
+        for (let i = ventralPoints.length - 1; i >= 0; i--) {
+            const curr = ventralPoints[i];
+            const next = i > 0 ? ventralPoints[i - 1] : curr;
+            const cpX = (curr.x + next.x) / 2;
+            ctx.quadraticCurveTo(curr.x - (curr.x - next.x) * 0.5, curr.y, cpX, (curr.y + next.y) / 2);
+        }
+        ctx.closePath();
+        // Body gradient (top to bottom)
+        const gradient = ctx.createLinearGradient(0, -height * 0.5, 0, height * 0.5);
+        gradient.addColorStop(0, colors.bodyTop);
+        gradient.addColorStop(0.4, this.colorCalc.blendColors(colors.bodyTop, colors.bodyBottom, 0.3));
+        gradient.addColorStop(1, colors.bodyBottom);
+        ctx.fillStyle = gradient;
+        ctx.fill();
+        // Subtle outline
+        ctx.strokeStyle = this.colorCalc.adjustAlpha(colors.bodyTop, 0.3);
+        ctx.lineWidth = 0.5;
+        ctx.stroke();
+    }
+    getFlexOffset(xFraction, flexAmount) {
+        // S-curve: positive at front, negative at back
+        return Math.sin(xFraction * Math.PI * 2) * flexAmount;
+    }
+}
+//# sourceMappingURL=FishBodyRenderer.js.map

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

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

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

@@ -0,0 +1,54 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { IFishDecisionMaker, DecisionContext, FishDecision } from "../contracts/IFishDecisionMaker.js";
+/**
+ * FishDecisionMaker - Personality and mood-influenced behavior decisions
+ *
+ * Modifies behavior transition probabilities based on:
+ * - Personality traits (boldness, curiosity, activity, sociability)
+ * - Current mood (alert, playful, tired, etc.)
+ * - Environmental context (nearby fish, edge proximity)
+ */
+export declare class FishDecisionMaker implements IFishDecisionMaker {
+    decideNextBehavior(ctx: DecisionContext): FishDecision;
+    getTransitionWeights(fish: FishMarineLife): {
+        turn: number;
+        dart: number;
+        cruise: number;
+        school: number;
+        passing: number;
+        ascending: number;
+        descending: number;
+        approaching: number;
+        receding: number;
+    };
+    /**
+     * Check if mood should override normal decision making
+     */
+    private checkMoodOverrides;
+    private createTurnDecision;
+    private createDartDecision;
+    private createSchoolDecision;
+    private createCruiseDecision;
+    /**
+     * Fast direct swimming - fish zooms across screen in a straight line
+     */
+    private createPassingDecision;
+    /**
+     * Ascending - fish swims upward exploring vertical space
+     */
+    private createAscendingDecision;
+    /**
+     * Descending - fish swims downward exploring vertical space
+     */
+    private createDescendingDecision;
+    /**
+     * Approaching - fish swims toward camera (z decreasing)
+     */
+    private createApproachingDecision;
+    /**
+     * Receding - fish swims away from camera (z increasing)
+     */
+    private createRecedingDecision;
+    private getEdgeProximity;
+}
+//# sourceMappingURL=FishDecisionMaker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FishDecisionMaker.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/FishDecisionMaker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,wCAAwC,CAAC;AAC3F,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,EACb,MAAM,oCAAoC,CAAC;AAS5C;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,YAAY;IAmGtD,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG;QAC1C,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAyID;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqC1B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoBhC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAajC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,gBAAgB;CAWzB"}