@austencloud/backgrounds 0.1.0

package/dist/backgrounds/deep-ocean/services/contracts/IFishMoodManager.d.ts

@@ -0,0 +1,44 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { FishMood, MoodVisuals } from "../../domain/types/fish-personality-types.js";
+/**
+ * IFishMoodManager - Manages emotional state transitions for fish
+ *
+ * Moods affect behavior decisions and visual expression.
+ * They decay over time back to 'calm' and can be triggered by stimuli.
+ */
+export interface IFishMoodManager {
+    /**
+     * Update mood state based on current conditions
+     * Handles decay, energy/hunger effects, and stimulus timeout
+     * @param fish - The fish to update
+     * @param deltaSeconds - Time since last frame
+     */
+    updateMood(fish: FishMarineLife, deltaSeconds: number): void;
+    /**
+     * Get visual modifiers for the current mood
+     * Used by renderers to adjust appearance
+     * @param fish - The fish to query
+     * @returns Visual modifier values
+     */
+    getMoodVisuals(fish: FishMarineLife): MoodVisuals;
+    /**
+     * Set mood directly (e.g., from external trigger)
+     * @param fish - The fish to update
+     * @param mood - The new mood
+     */
+    setMood(fish: FishMarineLife, mood: FishMood): void;
+    /**
+     * Mark that something interesting happened to this fish
+     * Can trigger mood changes based on stimulus type
+     * @param fish - The fish that experienced the stimulus
+     * @param type - Type of stimulus
+     */
+    markStimulus(fish: FishMarineLife, type: "food" | "threat" | "friend" | "novelty"): void;
+    /**
+     * Check if a mood transition should occur based on conditions
+     * @param fish - The fish to check
+     * @returns Whether the fish should consider changing behavior
+     */
+    shouldTransitionBehavior(fish: FishMarineLife): boolean;
+}
+//# sourceMappingURL=IFishMoodManager.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishMoodManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishMoodManager.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishMoodManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAE1F;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7D;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,CAAC;IAElD;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAEpD;;;;;OAKG;IACH,YAAY,CACV,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAC7C,IAAI,CAAC;IAER;;;;OAIG;IACH,wBAAwB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;CACzD"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishMoodManager.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFishMoodManager.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishMoodManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishMoodManager.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishMoodManager.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IFishMovementController.d.ts

@@ -0,0 +1,31 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for fish movement and behavior state machine
+ *
+ * Handles behavior transitions (cruising, turning, darting, schooling),
+ * movement application, and edge awareness.
+ */
+export interface IFishMovementController {
+    /**
+     * Apply behavior-specific movement to a fish
+     */
+    applyBehavior(fish: FishMarineLife, deltaSeconds: number, frameMultiplier: number, dimensions: Dimensions): void;
+    /**
+     * Transition to next behavior state
+     * @param fish - The fish to transition
+     * @param dimensions - Screen dimensions for edge detection
+     * @param nearbyFish - Other fish for social behavior decisions
+     * @param animationTime - Current animation time for context
+     */
+    transitionBehavior(fish: FishMarineLife, dimensions: Dimensions, nearbyFish?: FishMarineLife[], animationTime?: number): void;
+    /**
+     * Check if fish is off screen (for removal)
+     */
+    isOffScreen(fish: FishMarineLife, dimensions: Dimensions): boolean;
+    /**
+     * Get edge proximity (0-1, 1 = at edge)
+     */
+    getEdgeProximity(fish: FishMarineLife, dimensions: Dimensions): number;
+}
+//# sourceMappingURL=IFishMovementController.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishMovementController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishMovementController.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishMovementController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,aAAa,CACX,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,UAAU,GACrB,IAAI,CAAC;IAER;;;;;;OAMG;IACH,kBAAkB,CAChB,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,cAAc,EAAE,EAC7B,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAAC;IAER;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC;IAEnE;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC;CACxE"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishMovementController.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFishMovementController.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishMovementController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishMovementController.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishMovementController.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IFishPatternRenderer.d.ts

@@ -0,0 +1,23 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { SpineChain } from "../../physics/SpineChain.js";
+import type { Point } from "../../physics/BodyOutlineCalculator.js";
+/**
+ * Renders fish patterns (scales, stripes, spots, iridescence, lateral line).
+ */
+export interface IFishPatternRenderer {
+    drawSpineScalePattern(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    drawSpineStripes(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    drawVerticalBands(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    drawHorizontalStripes(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    drawSpineSpots(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    drawSpineIridescence(ctx: CanvasRenderingContext2D, fish: FishMarineLife, outline: {
+        leftPoints: Point[];
+        rightPoints: Point[];
+        headPoint: Point;
+        tailPoint: Point;
+    }): void;
+    drawSpineLateralLine(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    drawScalePattern(ctx: CanvasRenderingContext2D, fish: FishMarineLife, len: number, height: number): void;
+    drawLateralLine(ctx: CanvasRenderingContext2D, fish: FishMarineLife, len: number, height: number): void;
+}
+//# sourceMappingURL=IFishPatternRenderer.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishPatternRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishPatternRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishPatternRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAEnC,qBAAqB,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACpG,gBAAgB,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/F,iBAAiB,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAChG,qBAAqB,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACpG,cAAc,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7F,oBAAoB,CAClB,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,CAAC;IACR,oBAAoB,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAGnG,gBAAgB,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACzG,eAAe,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACzG"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishPatternRenderer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFishPatternRenderer.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishPatternRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishPatternRenderer.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishPatternRenderer.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IFishPersonalityGenerator.d.ts

@@ -0,0 +1,31 @@
+import type { FishSpecies } from "../../domain/models/DeepOceanModels.js";
+import type { FishPersonality, BehaviorModifiers } from "../../domain/types/fish-personality-types.js";
+/**
+ * IFishPersonalityGenerator - Creates unique personality traits for fish
+ *
+ * Each fish gets a personality at spawn that influences their behavior
+ * throughout their lifetime. Species affects the trait ranges.
+ */
+export interface IFishPersonalityGenerator {
+    /**
+     * Generate personality traits for a new fish
+     * Traits are influenced by species (tropical = bold, deep = shy, etc.)
+     * @param species - The fish species
+     * @returns Personality trait values (0-1 for each)
+     */
+    generatePersonality(species: FishSpecies): FishPersonality;
+    /**
+     * Calculate behavior probability modifiers from personality
+     * Used by decision maker to weight behavior choices
+     * @param personality - The fish's personality traits
+     * @returns Modifiers for various behavior probabilities
+     */
+    getBehaviorModifiers(personality: FishPersonality): BehaviorModifiers;
+    /**
+     * Get a description of the personality (for debugging/display)
+     * @param personality - The fish's personality traits
+     * @returns Human-readable description
+     */
+    describePersonality(personality: FishPersonality): string;
+}
+//# sourceMappingURL=IFishPersonalityGenerator.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishPersonalityGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishPersonalityGenerator.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishPersonalityGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,8CAA8C,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,CAAC;IAE3D;;;;;OAKG;IACH,oBAAoB,CAAC,WAAW,EAAE,eAAe,GAAG,iBAAiB,CAAC;IAEtE;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAAC;CAC3D"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishPersonalityGenerator.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFishPersonalityGenerator.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishPersonalityGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishPersonalityGenerator.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishPersonalityGenerator.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IFishPropulsionCalculator.d.ts

@@ -0,0 +1,33 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * IFishPropulsionCalculator - Calculates forward thrust from tail motion
+ *
+ * Real fish propulsion comes from the tail sweeping laterally through water.
+ * Thrust peaks when the tail crosses the center line (fastest lateral velocity).
+ * This creates a natural connection between tail animation and actual movement.
+ */
+export interface IFishPropulsionCalculator {
+    /**
+     * Calculate instantaneous forward thrust from tail oscillation
+     * @param fish - The fish entity with swim phase and tail parameters
+     * @returns Thrust multiplier (0-1+) to apply to base speed
+     */
+    calculateThrust(fish: FishMarineLife): number;
+    /**
+     * Calculate the target speed based on current swim intensity
+     * Combines base speed with thrust from tail motion
+     * @param fish - The fish entity
+     * @returns Target speed in pixels/second
+     */
+    calculateTargetSpeed(fish: FishMarineLife): number;
+    /**
+     * Get instantaneous tail velocity for physics calculations
+     * @param fish - The fish entity
+     * @returns Object with lateral and angular velocity components
+     */
+    getTailVelocity(fish: FishMarineLife): {
+        lateral: number;
+        angular: number;
+    };
+}
+//# sourceMappingURL=IFishPropulsionCalculator.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishPropulsionCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishPropulsionCalculator.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishPropulsionCalculator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAE9C;;;;;OAKG;IACH,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAEnD;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG;QACrC,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishPropulsionCalculator.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFishPropulsionCalculator.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishPropulsionCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishPropulsionCalculator.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishPropulsionCalculator.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IFishRareBehaviorHandler.d.ts

@@ -0,0 +1,55 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Rare behavior types that create memorable "did that fish just...?" moments
+ */
+export type RareBehaviorType = "barrel_roll" | "freeze" | "double_take" | "happy_flip" | "sync_swim";
+/**
+ * Result of a rare behavior check
+ */
+export interface RareBehaviorResult {
+    type: RareBehaviorType;
+    fish: FishMarineLife;
+    /** For sync_swim, the partner fish */
+    partner?: FishMarineLife;
+    /** Wobble type to trigger */
+    wobbleType: FishMarineLife["wobbleType"];
+    /** How long to pause normal behavior (seconds) */
+    pauseDuration?: number;
+}
+/**
+ * IFishRareBehaviorHandler - Triggers rare, memorable fish behaviors
+ *
+ * These are low-probability behaviors that create user delight:
+ * - Barrel rolls during playful mood
+ * - Freeze-then-dart when alert
+ * - Double-takes when curious
+ * - Happy flips when energy is high
+ * - Synchronized swimming with recognized "friends"
+ */
+export interface IFishRareBehaviorHandler {
+    /**
+     * Check if any rare behaviors should trigger this frame
+     * Called once per frame for all fish
+     *
+     * @param fish - All fish in the scene
+     * @param deltaSeconds - Time since last frame
+     * @returns Array of rare behaviors that triggered
+     */
+    checkRareBehaviors(fish: FishMarineLife[], deltaSeconds: number): RareBehaviorResult[];
+    /**
+     * Apply a rare behavior result
+     * Triggers wobbles and any special effects
+     *
+     * @param result - The rare behavior to apply
+     */
+    applyRareBehavior(result: RareBehaviorResult): void;
+    /**
+     * Manually trigger a rare behavior on a fish (for lab testing)
+     *
+     * @param fish - The fish to trigger on
+     * @param type - The rare behavior type
+     * @param partner - Optional partner for sync behaviors
+     */
+    triggerRareBehavior(fish: FishMarineLife, type: RareBehaviorType, partner?: FishMarineLife): void;
+}
+//# sourceMappingURL=IFishRareBehaviorHandler.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishRareBehaviorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishRareBehaviorHandler.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishRareBehaviorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,sCAAsC;IACtC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,6BAA6B;IAC7B,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IACzC,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;OAOG;IACH,kBAAkB,CAChB,IAAI,EAAE,cAAc,EAAE,EACtB,YAAY,EAAE,MAAM,GACnB,kBAAkB,EAAE,CAAC;IAExB;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEpD;;;;;;OAMG;IACH,mBAAmB,CACjB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI,CAAC;CACT"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishRareBehaviorHandler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFishRareBehaviorHandler.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishRareBehaviorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishRareBehaviorHandler.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishRareBehaviorHandler.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IFishRenderer.d.ts

@@ -0,0 +1,11 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for fish rendering
+ */
+export interface IFishRenderer {
+    /**
+     * Draw all fish with depth-based rendering
+     */
+    drawFish(ctx: CanvasRenderingContext2D, fish: FishMarineLife[]): void;
+}
+//# sourceMappingURL=IFishRenderer.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;CACvE"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishRenderer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFishRenderer.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishRenderer.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishRenderer.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IFishSpineController.d.ts

@@ -0,0 +1,40 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { SpineChain } from "../../physics/SpineChain.js";
+/**
+ * Contract for spine chain physics management
+ *
+ * Handles organic swimming animation via spine chains -
+ * initialization, physics updates, and joint synchronization.
+ */
+export interface IFishSpineController {
+    /**
+     * Initialize spine chain for a fish
+     * Sets up spine joints and attaches to fish entity
+     */
+    initializeSpineChain(fish: FishMarineLife): void;
+    /**
+     * Update propulsion based on tail physics
+     * Should be called BEFORE movement to update fish.speed based on thrust
+     * @param fish - The fish entity
+     * @param deltaSeconds - Time since last frame in seconds
+     */
+    updatePropulsion(fish: FishMarineLife, deltaSeconds: number): void;
+    /**
+     * Update spine chain physics for organic swimming
+     */
+    updateSpineChain(fish: FishMarineLife, deltaSeconds: number, frameMultiplier: number): void;
+    /**
+     * Get the spine chain for a fish (for external access)
+     */
+    getSpineChain(fish: FishMarineLife): SpineChain | undefined;
+    /**
+     * Remove spine chain reference when fish is removed
+     */
+    removeSpineChain(fish: FishMarineLife): void;
+    /**
+     * Reposition a fish's spine chain by a delta
+     * Call after manually moving a fish's position
+     */
+    repositionSpineChain(fish: FishMarineLife, dx: number, dy: number): void;
+}
+//# sourceMappingURL=IFishSpineController.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishSpineController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishSpineController.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishSpineController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAEjD;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnE;;OAEG;IACH,gBAAgB,CACd,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,IAAI,CAAC;IAER;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,GAAG,SAAS,CAAC;IAE5D;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAE7C;;;OAGG;IACH,oBAAoB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1E"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishSpineController.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFishSpineController.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishSpineController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishSpineController.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishSpineController.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IFishSpriteManager.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Fish Sprite Manager Contract
+ *
+ * Interface for managing pre-rendered fish sprites with color variants.
+ */
+/** Pre-rendered sprite with cached canvas */
+export interface PreRenderedSprite {
+    sprite: {
+        name: string;
+        path: string;
+    };
+    canvas: HTMLCanvasElement | OffscreenCanvas;
+    width: number;
+    height: number;
+    hueRotate: number;
+}
+/** Fish Sprite Manager interface */
+export interface IFishSpriteManager {
+    /**
+     * Preload and pre-render all fish sprites
+     */
+    preloadSprites(): Promise<void>;
+    /**
+     * Get a random pre-rendered sprite
+     */
+    getRandomSpriteEntry(): PreRenderedSprite | undefined;
+    /**
+     * Get any loaded sprite (for fallback)
+     */
+    getAnyLoadedSpriteEntry(): PreRenderedSprite | undefined;
+    /**
+     * Get a random color for marine life
+     */
+    getMarineLifeColor(type: "fish" | "jellyfish"): string;
+    /**
+     * Check if sprites are loaded and ready
+     */
+    isReady(): boolean;
+}
+//# sourceMappingURL=IFishSpriteManager.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishSpriteManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishSpriteManager.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishSpriteManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;OAEG;IACH,oBAAoB,IAAI,iBAAiB,GAAG,SAAS,CAAC;IAEtD;;OAEG;IACH,uBAAuB,IAAI,iBAAiB,GAAG,SAAS,CAAC;IAEzD;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAEvD;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC;CACpB"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishSpriteManager.js

@@ -0,0 +1,7 @@
+/**
+ * Fish Sprite Manager Contract
+ *
+ * Interface for managing pre-rendered fish sprites with color variants.
+ */
+export {};
+//# sourceMappingURL=IFishSpriteManager.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishSpriteManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishSpriteManager.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishSpriteManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishVisualUpdater.d.ts

@@ -0,0 +1,22 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for fish visual animation updates
+ *
+ * Handles fin physics, body flex, wake trails, bioluminescence,
+ * and other visual animations that don't affect movement.
+ */
+export interface IFishVisualUpdater {
+    /**
+     * Update all visual animations for a fish
+     */
+    updateVisuals(fish: FishMarineLife, frameMultiplier: number, animationTime: number): void;
+    /**
+     * Update legacy (non-spine) body flex animation
+     */
+    updateBodyFlex(fish: FishMarineLife, frameMultiplier: number): void;
+    /**
+     * Update fin physics (spring-based animation)
+     */
+    updateFinPhysics(fish: FishMarineLife, frameMultiplier: number): void;
+}
+//# sourceMappingURL=IFishVisualUpdater.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishVisualUpdater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishVisualUpdater.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishVisualUpdater.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,aAAa,CACX,IAAI,EAAE,cAAc,EACpB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB,IAAI,CAAC;IAER;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpE;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CACvE"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishVisualUpdater.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFishVisualUpdater.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishVisualUpdater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishVisualUpdater.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishVisualUpdater.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IFishWobbleAnimator.d.ts

@@ -0,0 +1,36 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { WobbleOffset } from "../../domain/types/fish-personality-types.js";
+/**
+ * IFishWobbleAnimator - Handles expressive wobble animations for fish
+ *
+ * Wobbles are brief visual animations that express personality and mood,
+ * similar to how the UFO system uses wobbles for character expression.
+ */
+export interface IFishWobbleAnimator {
+    /**
+     * Update wobble animation state (decay timer and intensity)
+     * @param fish - The fish to update
+     * @param deltaSeconds - Time since last frame
+     */
+    updateWobble(fish: FishMarineLife, deltaSeconds: number): void;
+    /**
+     * Calculate wobble offsets based on current wobble state
+     * @param fish - The fish to get offsets for
+     * @returns WobbleOffset with rotation, scale, and position adjustments
+     */
+    getWobbleOffset(fish: FishMarineLife): WobbleOffset;
+    /**
+     * Trigger a wobble animation on a fish
+     * @param fish - The fish to wobble
+     * @param wobbleType - The type of wobble to trigger
+     * @param intensity - Starting intensity (0-1)
+     */
+    triggerWobble(fish: FishMarineLife, wobbleType: FishMarineLife["wobbleType"], intensity?: number): void;
+    /**
+     * Check if a fish is currently wobbling
+     * @param fish - The fish to check
+     * @returns true if wobble is active
+     */
+    isWobbling(fish: FishMarineLife): boolean;
+}
+//# sourceMappingURL=IFishWobbleAnimator.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishWobbleAnimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishWobbleAnimator.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishWobbleAnimator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/D;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,CAAC;IAEpD;;;;;OAKG;IACH,aAAa,CACX,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,EACxC,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAAC;IAER;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;CAC3C"}

package/dist/backgrounds/deep-ocean/services/contracts/IFishWobbleAnimator.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFishWobbleAnimator.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IFishWobbleAnimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFishWobbleAnimator.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishWobbleAnimator.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IGradientRenderer.d.ts

@@ -0,0 +1,20 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { GradientState } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for ocean gradient background rendering
+ */
+export interface IGradientRenderer {
+    /**
+     * Initialize gradient animation state
+     */
+    initializeGradientState(dimensions: Dimensions): GradientState;
+    /**
+     * Update gradient animation state
+     */
+    updateGradientState(state: GradientState, frameMultiplier: number): GradientState;
+    /**
+     * Draw the ocean gradient background with animated effects
+     */
+    drawOceanGradient(ctx: CanvasRenderingContext2D, dimensions: Dimensions, state?: GradientState | null): void;
+}
+//# sourceMappingURL=IGradientRenderer.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IGradientRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGradientRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IGradientRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,CAAC;IAE/D;;OAEG;IACH,mBAAmB,CACjB,KAAK,EAAE,aAAa,EACpB,eAAe,EAAE,MAAM,GACtB,aAAa,CAAC;IAEjB;;OAEG;IACH,iBAAiB,CACf,GAAG,EAAE,wBAAwB,EAC7B,UAAU,EAAE,UAAU,EACtB,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,GAC3B,IAAI,CAAC;CACT"}

package/dist/backgrounds/deep-ocean/services/contracts/IGradientRenderer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IGradientRenderer.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IGradientRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGradientRenderer.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IGradientRenderer.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IJellyfishAnimator.d.ts

@@ -0,0 +1,24 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { JellyfishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for jellyfish animation and movement
+ */
+export interface IJellyfishAnimator {
+    /**
+     * Initialize jellyfish population
+     */
+    initializeJellyfish(dimensions: Dimensions, count: number): JellyfishMarineLife[];
+    /**
+     * Create a single jellyfish
+     */
+    createJellyfish(dimensions: Dimensions): JellyfishMarineLife;
+    /**
+     * Update all jellyfish positions and animations
+     */
+    updateJellyfish(jellyfish: JellyfishMarineLife[], dimensions: Dimensions, frameMultiplier: number): JellyfishMarineLife[];
+    /**
+     * Get optimal jellyfish count for quality level
+     */
+    getJellyfishCount(quality: string): number;
+}
+//# sourceMappingURL=IJellyfishAnimator.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IJellyfishAnimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IJellyfishAnimator.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IJellyfishAnimator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,mBAAmB,CACjB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,GACZ,mBAAmB,EAAE,CAAC;IAEzB;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,mBAAmB,CAAC;IAE7D;;OAEG;IACH,eAAe,CACb,SAAS,EAAE,mBAAmB,EAAE,EAChC,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,MAAM,GACtB,mBAAmB,EAAE,CAAC;IAEzB;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C"}

package/dist/backgrounds/deep-ocean/services/contracts/IJellyfishAnimator.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IJellyfishAnimator.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IJellyfishAnimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IJellyfishAnimator.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IJellyfishAnimator.ts"],"names":[],"mappings":""}

package/dist/backgrounds/deep-ocean/services/contracts/IJellyfishRenderer.d.ts

@@ -0,0 +1,11 @@
+import type { JellyfishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for jellyfish rendering
+ */
+export interface IJellyfishRenderer {
+    /**
+     * Draw all jellyfish with glow effects
+     */
+    drawJellyfish(ctx: CanvasRenderingContext2D, jellyfish: JellyfishMarineLife[]): void;
+}
+//# sourceMappingURL=IJellyfishRenderer.d.ts.map

package/dist/backgrounds/deep-ocean/services/contracts/IJellyfishRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IJellyfishRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IJellyfishRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,aAAa,CACX,GAAG,EAAE,wBAAwB,EAC7B,SAAS,EAAE,mBAAmB,EAAE,GAC/B,IAAI,CAAC;CACT"}

package/dist/backgrounds/deep-ocean/services/contracts/IJellyfishRenderer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IJellyfishRenderer.js.map

package/dist/backgrounds/deep-ocean/services/contracts/IJellyfishRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IJellyfishRenderer.js","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IJellyfishRenderer.ts"],"names":[],"mappings":""}