@austencloud/backgrounds 0.1.0

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

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

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

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

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

@@ -0,0 +1,60 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { WobbleOffset } from "../../domain/types/fish-personality-types.js";
+import type { IFishRareBehaviorHandler } from "./IFishRareBehaviorHandler.js";
+import type { IFishHomeZoneHandler } from "./IFishHomeZoneHandler.js";
+import type { IFishInteractionHandler } from "./IFishInteractionHandler.js";
+import type { IFishHuntingHandler } from "./IFishHuntingHandler.js";
+/**
+ * Contract for fish animation and behavior
+ */
+export interface IFishAnimator {
+    /**
+     * Initialize fish population
+     * @param spawnOnScreen - If true, fish spawn within visible area
+     */
+    initializeFish(dimensions: Dimensions, count: number, useSpineChain?: boolean, spawnOnScreen?: boolean): Promise<FishMarineLife[]>;
+    /**
+     * Create a single fish with behavior properties
+     * @param spawnOnScreen - If true, fish spawns within visible area
+     */
+    createFish(dimensions: Dimensions, useSpineChain?: boolean, spawnOnScreen?: boolean): FishMarineLife;
+    /**
+     * Update all fish positions, behaviors, and animations
+     */
+    updateFish(fish: FishMarineLife[], dimensions: Dimensions, frameMultiplier: number, animationTime: number): FishMarineLife[];
+    /**
+     * Get optimal fish count for quality level
+     */
+    getFishCount(quality: string): number;
+    /**
+     * Schedule a fish spawn
+     */
+    scheduleSpawn(spawnTime: number): void;
+    /**
+     * Process pending spawns and return new fish
+     */
+    processPendingSpawns(dimensions: Dimensions, currentTime: number): FishMarineLife[];
+    /**
+     * Get wobble offset for rendering
+     * Returns rotation, scale, and position adjustments for expressive animations
+     */
+    getWobbleOffset(fish: FishMarineLife): WobbleOffset;
+    /**
+     * Get the rare behavior handler for manual triggering in lab
+     */
+    getRareBehaviorHandler(): IFishRareBehaviorHandler;
+    /**
+     * Get the home zone handler for visualization in lab
+     */
+    getHomeZoneHandler(): IFishHomeZoneHandler;
+    /**
+     * Get the interaction handler for manual triggering in lab
+     */
+    getInteractionHandler(): IFishInteractionHandler;
+    /**
+     * Get the hunting handler for visualization and manual triggering in lab
+     */
+    getHuntingHandler(): IFishHuntingHandler;
+}
+//# sourceMappingURL=IFishAnimator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishAnimator.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishAnimator.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,YAAY,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,cAAc,CACZ,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,OAAO,EACvB,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7B;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAErG;;OAEG;IACH,UAAU,CACR,IAAI,EAAE,cAAc,EAAE,EACtB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB,cAAc,EAAE,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,oBAAoB,CAClB,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,GAClB,cAAc,EAAE,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,CAAC;IAMpD;;OAEG;IACH,sBAAsB,IAAI,wBAAwB,CAAC;IAEnD;;OAEG;IACH,kBAAkB,IAAI,oBAAoB,CAAC;IAE3C;;OAEG;IACH,qBAAqB,IAAI,uBAAuB,CAAC;IAEjD;;OAEG;IACH,iBAAiB,IAAI,mBAAmB,CAAC;CAC1C"}

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

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

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

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

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

@@ -0,0 +1,21 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { Point } from "../../physics/BodyOutlineCalculator.js";
+/**
+ * Renders fish body shapes (spine-based and legacy Bezier).
+ */
+export interface IFishBodyRenderer {
+    /**
+     * Draw spine-based fish body from calculated outline
+     */
+    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;
+}
+//# sourceMappingURL=IFishBodyRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishBodyRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishBodyRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;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,CAAC;IAER;;OAEG;IACH,QAAQ,CACN,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,IAAI,CAAC;CACT"}

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

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

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

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

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

@@ -0,0 +1,61 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { FishMarineLife, FishBehavior } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Decision context provided to the decision maker
+ */
+export interface DecisionContext {
+    fish: FishMarineLife;
+    nearbyFish: FishMarineLife[];
+    dimensions: Dimensions;
+    animationTime: number;
+}
+/**
+ * Decision result - what behavior to transition to
+ */
+export interface FishDecision {
+    /** The behavior to transition to */
+    behavior: FishBehavior;
+    /** Optional target direction for turning */
+    targetDirection?: 1 | -1;
+    /** Speed multiplier for the new behavior */
+    speedMultiplier?: number;
+    /** Whether to trigger a wobble animation */
+    triggerWobble?: "curious_tilt" | "startled_dart" | "playful_wiggle" | "tired_drift";
+    /** Target Y position for ascending/descending behaviors */
+    targetY?: number;
+    /** Target Z position for approaching/receding behaviors */
+    targetZ?: number;
+}
+/**
+ * IFishDecisionMaker - Decides behavior transitions based on personality and mood
+ *
+ * Replaces simple random behavior selection with personality-influenced decisions.
+ * Integrates with the mood system to create varied, believable behavior.
+ */
+export interface IFishDecisionMaker {
+    /**
+     * Decide what behavior to transition to
+     * Called when behavior timer expires
+     * @param ctx - Context including fish state and environment
+     * @returns Decision with new behavior and optional modifiers
+     */
+    decideNextBehavior(ctx: DecisionContext): FishDecision;
+    /**
+     * Get modified probabilities for behavior transitions
+     * Based on personality traits
+     * @param fish - The fish making the decision
+     * @returns Modified probability weights
+     */
+    getTransitionWeights(fish: FishMarineLife): {
+        turn: number;
+        dart: number;
+        cruise: number;
+        school: number;
+        passing: number;
+        ascending: number;
+        descending: number;
+        approaching: number;
+        receding: number;
+    };
+}
+//# sourceMappingURL=IFishDecisionMaker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishDecisionMaker.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishDecisionMaker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,QAAQ,EAAE,YAAY,CAAC;IAEvB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEzB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,cAAc,GAAG,eAAe,GAAG,gBAAgB,GAAG,aAAa,CAAC;IAEpF,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,YAAY,CAAC;IAEvD;;;;;OAKG;IACH,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,CAAC;CACH"}

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

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

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

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

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

@@ -0,0 +1,34 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { SpineChain } from "../../physics/SpineChain.js";
+import type { Point } from "../../physics/BodyOutlineCalculator.js";
+/**
+ * Renders visual effects for fish (wake trails, bioluminescence).
+ */
+export interface IFishEffectRenderer {
+    /**
+     * Draw wake trail particles (in world space)
+     */
+    drawWakeTrail(ctx: CanvasRenderingContext2D, fish: FishMarineLife): void;
+    /**
+     * Draw bioluminescence glow for spine-based fish
+     */
+    drawSpineBioluminescenceGlow(ctx: CanvasRenderingContext2D, fish: FishMarineLife, outline: {
+        leftPoints: Point[];
+        rightPoints: Point[];
+        headPoint: Point;
+        tailPoint: Point;
+    }): void;
+    /**
+     * Draw bioluminescence spots along spine
+     */
+    drawSpineBioluminescenceSpots(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    /**
+     * Draw bioluminescence glow for legacy Bezier fish
+     */
+    drawBioluminescenceGlow(ctx: CanvasRenderingContext2D, fish: FishMarineLife, len: number, height: number): void;
+    /**
+     * Draw bioluminescence spots for legacy Bezier fish
+     */
+    drawBioluminescenceSpots(ctx: CanvasRenderingContext2D, fish: FishMarineLife, len: number, height: number): void;
+}
+//# sourceMappingURL=IFishEffectRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishEffectRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishEffectRenderer.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,mBAAmB;IAClC;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAEzE;;OAEG;IACH,4BAA4B,CAC1B,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;IAER;;OAEG;IACH,6BAA6B,CAC3B,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,GAChB,IAAI,CAAC;IAER;;OAEG;IACH,uBAAuB,CACrB,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,IAAI,CAAC;IAER;;OAEG;IACH,wBAAwB,CACtB,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,IAAI,CAAC;CACT"}

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

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

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

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

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

@@ -0,0 +1,24 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { SpineChain } from "../../physics/SpineChain.js";
+/**
+ * Renders fish facial features (eyes, gills).
+ */
+export interface IFishFaceRenderer {
+    /**
+     * Draw eye on spine-based fish
+     */
+    drawSpineEye(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    /**
+     * Draw gill slit on spine-based fish
+     */
+    drawSpineGill(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    /**
+     * Draw eye on legacy Bezier fish
+     */
+    drawEye(ctx: CanvasRenderingContext2D, fish: FishMarineLife, len: number, height: number): void;
+    /**
+     * Draw gill slit on legacy Bezier fish
+     */
+    drawGill(ctx: CanvasRenderingContext2D, fish: FishMarineLife, len: number, height: number): void;
+}
+//# sourceMappingURL=IFishFaceRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishFaceRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishFaceRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,YAAY,CACV,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,GAChB,IAAI,CAAC;IAER;;OAEG;IACH,aAAa,CACX,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,GAChB,IAAI,CAAC;IAER;;OAEG;IACH,OAAO,CACL,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,IAAI,CAAC;IAER;;OAEG;IACH,QAAQ,CACN,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,IAAI,CAAC;CACT"}

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

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

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

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

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

@@ -0,0 +1,21 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for fish creation and initialization
+ *
+ * Handles species assignment, body generation, fin/tail creation,
+ * and initial positioning of new fish.
+ */
+export interface IFishFactory {
+    /**
+     * Create a single fish with all properties initialized
+     * @param spawnOnScreen - If true, fish spawns within visible area instead of off-screen
+     */
+    createFish(dimensions: Dimensions, useSpineChain?: boolean, spawnOnScreen?: boolean): FishMarineLife;
+    /**
+     * Initialize a population of fish
+     * @param spawnOnScreen - If true, fish spawn within visible area instead of off-screen
+     */
+    initializeFish(dimensions: Dimensions, count: number, useSpineChain?: boolean, spawnOnScreen?: boolean): FishMarineLife[];
+}
+//# sourceMappingURL=IFishFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishFactory.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishFactory.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,YAAY;IAC3B;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAErG;;;OAGG;IACH,cAAc,CACZ,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,OAAO,EACvB,aAAa,CAAC,EAAE,OAAO,GACtB,cAAc,EAAE,CAAC;CACrB"}

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

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

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

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

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

@@ -0,0 +1,35 @@
+import type { FishMarineLife, FinState, TailState, SpineFin } from "../../domain/models/DeepOceanModels.js";
+import type { SpineChain } from "../../physics/SpineChain.js";
+/**
+ * Renders fish fins (spine-based and legacy Bezier).
+ */
+export interface IFishFinRenderer {
+    /**
+     * Draw all fins on spine-based fish
+     */
+    drawSpineFins(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    /**
+     * Draw individual fin on spine-based fish
+     * @param x - Calculated attachment X position
+     * @param y - Calculated attachment Y position
+     * @param angle - Calculated fin angle
+     */
+    drawSpineFin(ctx: CanvasRenderingContext2D, fin: SpineFin, fish: FishMarineLife, x: number, y: number, angle: number): void;
+    /**
+     * Draw tail fin on spine-based fish
+     */
+    drawSpineTailFin(ctx: CanvasRenderingContext2D, fish: FishMarineLife, spine: SpineChain): void;
+    /**
+     * Draw all fins on legacy Bezier fish
+     */
+    drawFins(ctx: CanvasRenderingContext2D, fish: FishMarineLife, len: number, height: number): void;
+    /**
+     * Draw individual fin on legacy Bezier fish
+     */
+    drawFin(ctx: CanvasRenderingContext2D, fish: FishMarineLife, finState: FinState, x: number, y: number, baseLength: number, baseWidth: number, angle: number): void;
+    /**
+     * Draw tail fin on legacy Bezier fish
+     */
+    drawTailFin(ctx: CanvasRenderingContext2D, fish: FishMarineLife, tailState: TailState, x: number, y: number, baseSize: number): void;
+}
+//# sourceMappingURL=IFishFinRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishFinRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishFinRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAC5G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,aAAa,CACX,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,GAChB,IAAI,CAAC;IAER;;;;;OAKG;IACH,YAAY,CACV,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,cAAc,EACpB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC;IAER;;OAEG;IACH,gBAAgB,CACd,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,GAChB,IAAI,CAAC;IAER;;OAEG;IACH,QAAQ,CACN,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,IAAI,CAAC;IAER;;OAEG;IACH,OAAO,CACL,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,QAAQ,EAClB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC;IAER;;OAEG;IACH,WAAW,CACT,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,SAAS,EACpB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,GACf,IAAI,CAAC;CACT"}

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

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

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

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

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

@@ -0,0 +1,18 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for fish flocking behavior (Boids algorithm)
+ *
+ * Handles school formation, separation/alignment/cohesion forces,
+ * and steering application for schooling fish.
+ */
+export interface IFishFlockingCalculator {
+    /**
+     * Apply flocking forces to all schooling fish
+     */
+    applyFlockingForces(fish: FishMarineLife[], deltaSeconds: number): void;
+    /**
+     * Form initial schools from fish population
+     */
+    formSchools(fish: FishMarineLife[]): void;
+}
+//# sourceMappingURL=IFishFlockingCalculator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishFlockingCalculator.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishFlockingCalculator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAExE;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;CAC3C"}

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

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

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

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

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

@@ -0,0 +1,38 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * IFishHomeZoneHandler - Manages fish home zone preferences
+ *
+ * Fish have a preferred "home zone" where they spawned. Over time,
+ * they have a subtle tendency to drift back toward this area,
+ * making their movement feel more purposeful and less random.
+ */
+export interface IFishHomeZoneHandler {
+    /**
+     * Initialize home zone for a newly spawned fish
+     * Should be called right after fish creation
+     *
+     * @param fish - The fish to initialize
+     */
+    initializeHomeZone(fish: FishMarineLife): void;
+    /**
+     * Apply home zone drift influence to fish movement
+     * Adds a subtle bias toward the home zone
+     *
+     * @param fish - The fish to update
+     * @param deltaSeconds - Time since last frame
+     */
+    applyHomeZoneDrift(fish: FishMarineLife, deltaSeconds: number): void;
+    /**
+     * Get debug visualization data for a fish's home zone
+     *
+     * @param fish - The fish to get zone for
+     * @returns Center and radius for debug drawing, or null if no zone
+     */
+    getHomeZoneVisualization(fish: FishMarineLife): {
+        x: number;
+        y: number;
+        radius: number;
+        affinity: number;
+    } | null;
+}
+//# sourceMappingURL=IFishHomeZoneHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishHomeZoneHandler.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishHomeZoneHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAE/C;;;;;;OAMG;IACH,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAErE;;;;;OAKG;IACH,wBAAwB,CACtB,IAAI,EAAE,cAAc,GACnB;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACtE"}

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

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

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

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

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

@@ -0,0 +1,101 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Hunt state - lifecycle of a predator/prey chase sequence
+ */
+export type HuntState = "idle" | "stalking" | "chasing" | "cooldown";
+/**
+ * Hunt outcome - how a chase ended
+ */
+export type HuntOutcome = "escaped" | "caught" | "timeout" | "cancelled";
+/**
+ * Active hunt data
+ */
+export interface ActiveHunt {
+    /** ID of the hunting predator */
+    hunterId: number;
+    /** ID of the prey being hunted */
+    targetId: number;
+    /** Current hunt phase */
+    state: HuntState;
+    /** Animation time when hunt started */
+    startTime: number;
+    /** Maximum duration before predator gives up */
+    maxDuration: number;
+}
+/**
+ * Hunt result - returned when a hunt completes
+ */
+export interface HuntResult {
+    hunt: ActiveHunt;
+    outcome: HuntOutcome;
+}
+/**
+ * Hunt statistics for debugging/lab display
+ */
+export interface HuntStats {
+    activeHunts: number;
+    totalHunts: number;
+    successfulCatches: number;
+    escapes: number;
+}
+/**
+ * IFishHuntingHandler - Manages predator/prey chase sequences
+ *
+ * Creates emergent drama through pursuit and escape. Sleek fish hunt,
+ * tropical/schooling fish flee. No death - just pursuit behavior.
+ *
+ * Hunt lifecycle:
+ * 1. Detection - hungry predator spots nearby prey
+ * 2. Stalking - slow approach, prey unaware (2-3 seconds)
+ * 3. Chasing - burst pursuit, prey flees (4-6 seconds)
+ * 4. Resolution - prey escapes (80%) or predator "catches" (20%)
+ * 5. Cooldown - predator rests before hunting again (30 seconds)
+ */
+export interface IFishHuntingHandler {
+    /**
+     * Process hunting behavior for all fish
+     * Detects new hunts, updates active hunts, resolves completions
+     * @returns Array of hunts that completed this frame
+     */
+    processHunting(fish: FishMarineLife[], deltaSeconds: number, animationTime: number): HuntResult[];
+    /**
+     * Apply effects from a completed hunt
+     * - Catch: predator does feeding_lunge, hunger resets
+     * - Escape: prey darts away, mood becomes alert
+     */
+    applyHuntResult(result: HuntResult, fish: FishMarineLife[]): void;
+    /**
+     * Check if a fish is a predator species
+     */
+    isPredator(fish: FishMarineLife): boolean;
+    /**
+     * Check if a fish is prey species
+     */
+    isPrey(fish: FishMarineLife): boolean;
+    /**
+     * Get all currently active hunts
+     */
+    getActiveHunts(): ActiveHunt[];
+    /**
+     * Get hunt statistics for display
+     */
+    getStats(): HuntStats;
+    /**
+     * Force a specific predator to hunt a specific prey (for lab testing)
+     */
+    forceHunt(predator: FishMarineLife, prey: FishMarineLife, animationTime: number): void;
+    /**
+     * Cancel all active hunts (for reset/cleanup)
+     */
+    cancelAllHunts(): void;
+    /**
+     * Get the hunt visualization data for a specific fish
+     * Returns predator -> prey line data if fish is hunting
+     */
+    getHuntVisualization(fish: FishMarineLife): {
+        targetX: number;
+        targetY: number;
+        state: HuntState;
+    } | null;
+}
+//# sourceMappingURL=IFishHuntingHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishHuntingHandler.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishHuntingHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,yBAAyB;IACzB,KAAK,EAAE,SAAS,CAAC;IAEjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,cAAc,CACZ,IAAI,EAAE,cAAc,EAAE,EACtB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,UAAU,EAAE,CAAC;IAEhB;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAElE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;IAE1C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;IAEtC;;OAEG;IACH,cAAc,IAAI,UAAU,EAAE,CAAC;IAE/B;;OAEG;IACH,QAAQ,IAAI,SAAS,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvF;;OAEG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB;;;OAGG;IACH,oBAAoB,CAClB,IAAI,EAAE,cAAc,GACnB;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC;CAClE"}

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

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

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

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

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

@@ -0,0 +1,55 @@
+import type { FishMarineLife } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Interaction types between fish
+ */
+export type FishInteractionType = "passing_greeting" | "yield" | "social_approach" | "shy_avoidance";
+/**
+ * Result of processing an interaction
+ */
+export interface InteractionResult {
+    type: FishInteractionType;
+    /** Fish that initiated or was primary in interaction */
+    fish: FishMarineLife;
+    /** The other fish involved */
+    other: FishMarineLife;
+    /** Wobble to trigger (if any) */
+    triggerWobble?: FishMarineLife["wobbleType"];
+    /** Speed modifier to apply temporarily */
+    speedModifier?: number;
+    /** Vertical nudge in pixels */
+    verticalNudge?: number;
+}
+/**
+ * IFishInteractionHandler - Detects and handles micro-interactions between fish
+ *
+ * Creates emergent social behaviors by detecting when fish pass close to each
+ * other and triggering personality-appropriate responses. This makes fish
+ * feel like they exist in a shared world where they notice each other.
+ */
+export interface IFishInteractionHandler {
+    /**
+     * Process potential interactions for all fish
+     * Should be called once per frame before movement updates
+     *
+     * @param fish - All fish in the scene
+     * @param deltaSeconds - Time since last frame
+     * @returns Array of interactions that occurred this frame
+     */
+    processInteractions(fish: FishMarineLife[], deltaSeconds: number): InteractionResult[];
+    /**
+     * Apply the effects of an interaction to the fish involved
+     * Triggers wobbles, speed changes, and position nudges
+     *
+     * @param result - The interaction result to apply
+     */
+    applyInteraction(result: InteractionResult): void;
+    /**
+     * Check if a fish is on interaction cooldown
+     * Prevents fish from constantly triggering interactions
+     *
+     * @param fish - The fish to check
+     * @returns true if fish cannot trigger new interactions
+     */
+    isOnCooldown(fish: FishMarineLife): boolean;
+}
+//# sourceMappingURL=IFishInteractionHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IFishInteractionHandler.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IFishInteractionHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,OAAO,GACP,iBAAiB,GACjB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,wDAAwD;IACxD,IAAI,EAAE,cAAc,CAAC;IACrB,8BAA8B;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,iCAAiC;IACjC,aAAa,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAC7C,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,mBAAmB,CACjB,IAAI,EAAE,cAAc,EAAE,EACtB,YAAY,EAAE,MAAM,GACnB,iBAAiB,EAAE,CAAC;IAEvB;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAElD;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;CAC7C"}

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

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

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

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