@austencloud/backgrounds 0.1.0

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

@@ -0,0 +1,274 @@
+// =============================================================================
+// SPRING PHYSICS HELPERS
+// =============================================================================
+/**
+ * Critically damped spring decay - fastest settle without oscillation.
+ * From theorangeduck.com/page/spring-roll-call
+ *
+ * @param t - Time elapsed (seconds)
+ * @param halflife - Time for amplitude to decay to 50%
+ * @returns Decay multiplier (0-1, starts at 1)
+ */
+function criticallyDampedDecay(t, halflife) {
+    const damping = (4 * Math.LN2) / halflife; // LN2 = 0.693...
+    const y = damping / 2;
+    return Math.exp(-y * t) * (1 + y * t);
+}
+/**
+ * easeOutExpo - Quick initial response, smooth settle.
+ * From easings.net
+ *
+ * @param x - Progress (0-1)
+ * @returns Eased value (0-1)
+ */
+function easeOutExpo(x) {
+    return x === 1 ? 1 : 1 - Math.pow(2, -10 * x);
+}
+/**
+ * Wobble animation configurations by type
+ */
+const WOBBLE_CONFIGS = {
+    curious_tilt: {
+        duration: 0.6,
+        rotationAmplitude: 0.15, // ~8 degrees
+        scaleXAmplitude: 0,
+        scaleYAmplitude: 0.05,
+        offsetXAmplitude: 0,
+        offsetYAmplitude: -3, // Rise up slightly
+        frequency: 1.5,
+        decay: "linear",
+        envelope: "ease_out_expo", // Quick response, holds the curious pose
+    },
+    startled_dart: {
+        duration: 0.3,
+        rotationAmplitude: 0.1,
+        scaleXAmplitude: 0.08, // Stretch horizontally (backward)
+        scaleYAmplitude: -0.05, // Compress vertically
+        offsetXAmplitude: -5, // Jerk backward
+        offsetYAmplitude: 2,
+        frequency: 4,
+        decay: "exponential",
+        envelope: "critically_damped", // Spring physics, fastest settle
+        halflife: 0.15, // Fast recovery from startle
+    },
+    playful_wiggle: {
+        duration: 0.8,
+        rotationAmplitude: 0.2, // More rotation
+        scaleXAmplitude: 0.03,
+        scaleYAmplitude: 0.03,
+        offsetXAmplitude: 3, // Side to side
+        offsetYAmplitude: 2,
+        frequency: 6,
+        decay: "linear",
+        envelope: "underdamped", // Allows overshoot for playfulness
+        halflife: 0.3,
+        overshoot: 0.2, // 20% overshoot for bouncy feel
+    },
+    tired_drift: {
+        duration: 1.2,
+        rotationAmplitude: 0.08, // Slight droop
+        scaleXAmplitude: 0,
+        scaleYAmplitude: -0.03, // Slightly compressed
+        offsetXAmplitude: 0,
+        offsetYAmplitude: 4, // Sink down
+        frequency: 0.5,
+        decay: "linear",
+        envelope: "linear", // Slow, predictable fade for tired feeling
+    },
+    feeding_lunge: {
+        duration: 0.4,
+        rotationAmplitude: 0.05,
+        scaleXAmplitude: 0.1, // Stretch forward
+        scaleYAmplitude: -0.05,
+        offsetXAmplitude: 8, // Lunge forward
+        offsetYAmplitude: 0,
+        frequency: 2,
+        decay: "exponential",
+        envelope: "critically_damped", // Sharp attack, clean settle
+        halflife: 0.12,
+    },
+    social_shimmer: {
+        duration: 0.7,
+        rotationAmplitude: 0.05,
+        scaleXAmplitude: 0.02,
+        scaleYAmplitude: 0.04, // Puff up slightly
+        offsetXAmplitude: 1,
+        offsetYAmplitude: 1,
+        frequency: 8, // Fast shimmer
+        decay: "linear",
+        envelope: "underdamped", // Gentle oscillation for social display
+        halflife: 0.4,
+        overshoot: 0.1,
+    },
+    // Rare special behaviors
+    barrel_roll: {
+        duration: 0.8,
+        rotationAmplitude: Math.PI, // Full 180° each way = 360° total
+        scaleXAmplitude: 0.05,
+        scaleYAmplitude: 0.05,
+        offsetXAmplitude: 0,
+        offsetYAmplitude: 5, // Slight lift during roll
+        frequency: 1.25, // One full rotation
+        decay: "linear",
+        envelope: "linear", // Consistent through the roll
+    },
+    freeze: {
+        duration: 0.6,
+        rotationAmplitude: 0, // No movement
+        scaleXAmplitude: 0,
+        scaleYAmplitude: 0,
+        offsetXAmplitude: 0,
+        offsetYAmplitude: 0,
+        frequency: 0,
+        decay: "linear",
+        envelope: "linear",
+    },
+    double_take: {
+        duration: 0.5,
+        rotationAmplitude: 0.4, // Strong head turn
+        scaleXAmplitude: 0.03,
+        scaleYAmplitude: 0,
+        offsetXAmplitude: -4, // Slight backward motion
+        offsetYAmplitude: 0,
+        frequency: 2, // Quick back-and-forth
+        decay: "exponential",
+        envelope: "critically_damped", // Sharp snap, clean settle
+        halflife: 0.1,
+    },
+    happy_flip: {
+        duration: 0.6,
+        rotationAmplitude: 0.5, // Upward tilt
+        scaleXAmplitude: 0.08,
+        scaleYAmplitude: 0.08,
+        offsetXAmplitude: 3,
+        offsetYAmplitude: -12, // Strong upward pop
+        frequency: 1.5,
+        decay: "exponential",
+        envelope: "underdamped", // Bouncy, joyful overshoot
+        halflife: 0.2,
+        overshoot: 0.25,
+    },
+    sync_pulse: {
+        duration: 0.4,
+        rotationAmplitude: 0.02,
+        scaleXAmplitude: 0.06, // Brief expansion
+        scaleYAmplitude: 0.06,
+        offsetXAmplitude: 0,
+        offsetYAmplitude: 0,
+        frequency: 3,
+        decay: "exponential",
+        envelope: "ease_out_expo", // Quick pulse, smooth fade
+    },
+};
+/**
+ * FishWobbleAnimator - Produces expressive wobble animations
+ *
+ * Each wobble type creates a unique visual expression through
+ * rotation, scale, and position offsets that decay over time.
+ */
+export class FishWobbleAnimator {
+    updateWobble(fish, deltaSeconds) {
+        if (!fish.wobbleTimer || fish.wobbleTimer <= 0) {
+            fish.wobbleType = "none";
+            fish.wobbleIntensity = 0;
+            return;
+        }
+        // Decay timer
+        fish.wobbleTimer -= deltaSeconds;
+        // Decay intensity based on wobble type
+        const wobbleType = fish.wobbleType;
+        if (wobbleType && wobbleType !== "none") {
+            const config = WOBBLE_CONFIGS[wobbleType];
+            if (config.decay === "exponential") {
+                // Fast initial decay, slows down
+                fish.wobbleIntensity = (fish.wobbleIntensity ?? 1) * (1 - deltaSeconds * 3);
+            }
+            else {
+                // Linear decay
+                fish.wobbleIntensity = Math.max(0, fish.wobbleTimer / config.duration);
+            }
+        }
+        // Clear when done
+        if (fish.wobbleTimer <= 0) {
+            fish.wobbleType = "none";
+            fish.wobbleIntensity = 0;
+            fish.wobbleTimer = 0;
+        }
+    }
+    getWobbleOffset(fish) {
+        const noOffset = {
+            rotation: 0,
+            scaleX: 1,
+            scaleY: 1,
+            offsetX: 0,
+            offsetY: 0,
+        };
+        const wobbleType = fish.wobbleType;
+        if (!wobbleType || wobbleType === "none" || !fish.wobbleTimer) {
+            return noOffset;
+        }
+        const config = WOBBLE_CONFIGS[wobbleType];
+        const timeInWobble = config.duration - fish.wobbleTimer;
+        const progress = timeInWobble / config.duration; // 0 to 1
+        const phase = timeInWobble * config.frequency * Math.PI * 2;
+        // Calculate envelope based on type - this replaces the simple intensity decay
+        let envelope;
+        switch (config.envelope) {
+            case "critically_damped":
+                // Spring physics - fastest settle without oscillation
+                envelope = criticallyDampedDecay(timeInWobble, config.halflife ?? 0.2);
+                break;
+            case "underdamped":
+                // Spring with overshoot for bouncy, organic feel
+                const decay = criticallyDampedDecay(timeInWobble, config.halflife ?? 0.3);
+                // Add overshoot oscillation that fades with progress
+                const overshootAmount = config.overshoot ?? 0.15;
+                const overshoot = Math.sin(timeInWobble * 8) * overshootAmount * (1 - progress);
+                envelope = Math.max(0, decay + overshoot);
+                break;
+            case "ease_out_expo":
+                // Quick response, smooth hold - good for curious/attention poses
+                envelope = 1 - easeOutExpo(progress);
+                break;
+            case "exponential":
+                // Legacy: fast initial decay with long tail
+                envelope = fish.wobbleIntensity ?? Math.pow(1 - progress, 2);
+                break;
+            case "linear":
+            default:
+                // Simple linear decay
+                envelope = 1 - progress;
+                break;
+        }
+        // Direction-aware offsets (fish swimming left should jerk in opposite direction)
+        const dir = fish.direction ?? 1;
+        // Calculate each offset component with oscillation and envelope
+        const rotation = Math.sin(phase) * config.rotationAmplitude * envelope * dir;
+        const scaleX = 1 + Math.sin(phase) * config.scaleXAmplitude * envelope;
+        const scaleY = 1 + Math.cos(phase * 0.7) * config.scaleYAmplitude * envelope;
+        const offsetX = Math.sin(phase) * config.offsetXAmplitude * envelope * dir;
+        const offsetY = Math.sin(phase * 1.3) * config.offsetYAmplitude * envelope;
+        return {
+            rotation,
+            scaleX,
+            scaleY,
+            offsetX,
+            offsetY,
+        };
+    }
+    triggerWobble(fish, wobbleType, intensity = 1) {
+        if (!wobbleType || wobbleType === "none") {
+            return;
+        }
+        const config = WOBBLE_CONFIGS[wobbleType];
+        fish.wobbleType = wobbleType;
+        fish.wobbleTimer = config.duration;
+        fish.wobbleIntensity = Math.min(1, Math.max(0, intensity));
+    }
+    isWobbling(fish) {
+        return (!!fish.wobbleType &&
+            fish.wobbleType !== "none" &&
+            (fish.wobbleTimer ?? 0) > 0);
+    }
+}
+//# sourceMappingURL=FishWobbleAnimator.js.map

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

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

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

@@ -0,0 +1,31 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { GradientState } from "../../domain/models/DeepOceanModels.js";
+import type { IGradientRenderer } from "../contracts/IGradientRenderer.js";
+export declare class GradientRenderer implements IGradientRenderer {
+    initializeGradientState(dimensions: Dimensions): GradientState;
+    private createFogLayers;
+    private createDistantGlows;
+    updateGradientState(state: GradientState, frameMultiplier: number): GradientState;
+    drawOceanGradient(ctx: CanvasRenderingContext2D, dimensions: Dimensions, state?: GradientState | null): void;
+    /**
+     * Draw the base ocean gradient with color breathing
+     */
+    private drawBaseGradient;
+    /**
+     * Draw horizontal depth fog layers
+     */
+    private drawDepthFog;
+    /**
+     * Draw distant bioluminescent glow spots
+     */
+    private drawDistantBioluminescence;
+    /**
+     * Draw subtle edge vignette
+     */
+    private drawVignette;
+    private hsl;
+    private hexToRgb;
+    private randomInRange;
+    private randomIntInRange;
+}
+//# sourceMappingURL=GradientRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GradientRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/GradientRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAwC3E,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa;IAY9D,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,kBAAkB;IAkC1B,mBAAmB,CACjB,KAAK,EAAE,aAAa,EACpB,eAAe,EAAE,MAAM,GACtB,aAAa;IAyBhB,iBAAiB,CACf,GAAG,EAAE,wBAAwB,EAC7B,UAAU,EAAE,UAAU,EACtB,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,GAC3B,IAAI;IAYP;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoDxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAuClC;;OAEG;IACH,OAAO,CAAC,YAAY;IAmCpB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;CAGzB"}

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

@@ -0,0 +1,208 @@
+/**
+ * Gradient Configuration
+ * Tuned for atmospheric, living ocean depth
+ */
+const GRADIENT_CONFIG = {
+    // Base colors (HSL for easy breathing animation)
+    colors: {
+        surface: { h: 205, s: 65, l: 17 }, // #0d2d47
+        midDepth: { h: 195, s: 45, l: 20 }, // #1a3a4a
+        deep: { h: 205, s: 55, l: 13 }, // #0f2535
+        abyss: { h: 210, s: 50, l: 10 }, // #091a2b
+    },
+    // Breathing animation
+    breathingSpeed: 0.0003, // Very slow
+    breathingRange: {
+        hue: 5, // ±5 degrees
+        saturation: 8, // ±8%
+        lightness: 3, // ±3%
+    },
+    // Fog layers
+    fogLayerCount: 3,
+    fogOpacity: { min: 0.02, max: 0.06 },
+    fogSpeed: { min: 0.001, max: 0.003 },
+    // Distant bioluminescence
+    glowCount: { min: 4, max: 8 },
+    glowSize: { min: 40, max: 120 },
+    glowIntensity: { min: 0.015, max: 0.04 },
+    glowSpeed: { min: 0.003, max: 0.008 },
+    glowColors: ["#4db8ff", "#7b68ee", "#00ced1", "#9370db"], // Cyan, purple, teal, violet
+    // Vignette
+    vignetteIntensity: 0.25,
+    vignetteRadius: 0.7, // Start at 70% from center
+};
+export class GradientRenderer {
+    initializeGradientState(dimensions) {
+        return {
+            breathingPhase: Math.random() * Math.PI * 2,
+            breathingSpeed: GRADIENT_CONFIG.breathingSpeed,
+            fogLayers: this.createFogLayers(dimensions),
+            distantGlows: this.createDistantGlows(dimensions),
+            vignetteIntensity: GRADIENT_CONFIG.vignetteIntensity,
+        };
+    }
+    createFogLayers(dimensions) {
+        const layers = [];
+        for (let i = 0; i < GRADIENT_CONFIG.fogLayerCount; i++) {
+            layers.push({
+                y: (i + 1) / (GRADIENT_CONFIG.fogLayerCount + 1) * dimensions.height,
+                opacity: this.randomInRange(GRADIENT_CONFIG.fogOpacity.min, GRADIENT_CONFIG.fogOpacity.max),
+                phase: Math.random() * Math.PI * 2,
+                speed: this.randomInRange(GRADIENT_CONFIG.fogSpeed.min, GRADIENT_CONFIG.fogSpeed.max),
+            });
+        }
+        return layers;
+    }
+    createDistantGlows(dimensions) {
+        const count = this.randomIntInRange(GRADIENT_CONFIG.glowCount.min, GRADIENT_CONFIG.glowCount.max);
+        const glows = [];
+        for (let i = 0; i < count; i++) {
+            const color = GRADIENT_CONFIG.glowColors[Math.floor(Math.random() * GRADIENT_CONFIG.glowColors.length)] ?? GRADIENT_CONFIG.glowColors[0];
+            glows.push({
+                x: Math.random() * dimensions.width,
+                y: dimensions.height * 0.3 + Math.random() * dimensions.height * 0.6, // Middle-lower portion
+                size: this.randomInRange(GRADIENT_CONFIG.glowSize.min, GRADIENT_CONFIG.glowSize.max),
+                intensity: this.randomInRange(GRADIENT_CONFIG.glowIntensity.min, GRADIENT_CONFIG.glowIntensity.max),
+                phase: Math.random() * Math.PI * 2,
+                speed: this.randomInRange(GRADIENT_CONFIG.glowSpeed.min, GRADIENT_CONFIG.glowSpeed.max),
+                color,
+            });
+        }
+        return glows;
+    }
+    updateGradientState(state, frameMultiplier) {
+        // Update breathing phase
+        const newBreathingPhase = state.breathingPhase + state.breathingSpeed * frameMultiplier;
+        // Update fog layers
+        const updatedFogLayers = state.fogLayers.map((layer) => ({
+            ...layer,
+            phase: layer.phase + layer.speed * frameMultiplier,
+        }));
+        // Update distant glows
+        const updatedGlows = state.distantGlows.map((glow) => ({
+            ...glow,
+            phase: glow.phase + glow.speed * frameMultiplier,
+        }));
+        return {
+            ...state,
+            breathingPhase: newBreathingPhase,
+            fogLayers: updatedFogLayers,
+            distantGlows: updatedGlows,
+        };
+    }
+    drawOceanGradient(ctx, dimensions, state) {
+        // Draw base gradient (always works even without state)
+        this.drawBaseGradient(ctx, dimensions, state?.breathingPhase ?? 0);
+        // Draw animated effects if state is provided
+        if (state) {
+            this.drawDepthFog(ctx, dimensions, state.fogLayers);
+            this.drawDistantBioluminescence(ctx, state.distantGlows);
+            this.drawVignette(ctx, dimensions, state.vignetteIntensity);
+        }
+    }
+    /**
+     * Draw the base ocean gradient with color breathing
+     */
+    drawBaseGradient(ctx, dimensions, breathingPhase) {
+        const gradient = ctx.createLinearGradient(0, 0, 0, dimensions.height);
+        const { colors, breathingRange } = GRADIENT_CONFIG;
+        // Calculate breathing offsets
+        const breathSin = Math.sin(breathingPhase);
+        const hueOffset = breathSin * breathingRange.hue;
+        const satOffset = breathSin * breathingRange.saturation;
+        const lightOffset = Math.sin(breathingPhase * 0.7) * breathingRange.lightness;
+        // Apply breathing to each color stop
+        gradient.addColorStop(0, this.hsl(colors.surface.h + hueOffset, colors.surface.s + satOffset, colors.surface.l + lightOffset));
+        gradient.addColorStop(0.3, this.hsl(colors.midDepth.h + hueOffset * 0.7, colors.midDepth.s + satOffset * 0.5, colors.midDepth.l + lightOffset * 0.7));
+        gradient.addColorStop(0.7, this.hsl(colors.deep.h + hueOffset * 0.5, colors.deep.s + satOffset * 0.3, colors.deep.l + lightOffset * 0.5));
+        gradient.addColorStop(1, this.hsl(colors.abyss.h + hueOffset * 0.3, colors.abyss.s + satOffset * 0.2, colors.abyss.l + lightOffset * 0.3));
+        ctx.fillStyle = gradient;
+        ctx.fillRect(0, 0, dimensions.width, dimensions.height);
+    }
+    /**
+     * Draw horizontal depth fog layers
+     */
+    drawDepthFog(ctx, dimensions, fogLayers) {
+        ctx.save();
+        for (const layer of fogLayers) {
+            const pulse = 0.5 + Math.sin(layer.phase) * 0.5;
+            const alpha = layer.opacity * pulse;
+            // Fog band gradient (horizontal haze)
+            const fogHeight = dimensions.height * 0.15;
+            const gradient = ctx.createLinearGradient(0, layer.y - fogHeight / 2, 0, layer.y + fogHeight / 2);
+            gradient.addColorStop(0, `rgba(100, 150, 180, 0)`);
+            gradient.addColorStop(0.3, `rgba(80, 130, 160, ${alpha * 0.5})`);
+            gradient.addColorStop(0.5, `rgba(70, 120, 150, ${alpha})`);
+            gradient.addColorStop(0.7, `rgba(80, 130, 160, ${alpha * 0.5})`);
+            gradient.addColorStop(1, `rgba(100, 150, 180, 0)`);
+            ctx.fillStyle = gradient;
+            ctx.fillRect(0, layer.y - fogHeight / 2, dimensions.width, fogHeight);
+        }
+        ctx.restore();
+    }
+    /**
+     * Draw distant bioluminescent glow spots
+     */
+    drawDistantBioluminescence(ctx, glows) {
+        ctx.save();
+        for (const glow of glows) {
+            const pulse = 0.3 + Math.sin(glow.phase) * 0.7;
+            const alpha = glow.intensity * pulse;
+            if (alpha < 0.005)
+                continue;
+            ctx.globalAlpha = alpha;
+            // Parse color and create gradient
+            const rgb = this.hexToRgb(glow.color);
+            const gradient = ctx.createRadialGradient(glow.x, glow.y, 0, glow.x, glow.y, glow.size);
+            gradient.addColorStop(0, `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, 0.6)`);
+            gradient.addColorStop(0.3, `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, 0.3)`);
+            gradient.addColorStop(0.6, `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, 0.1)`);
+            gradient.addColorStop(1, `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, 0)`);
+            ctx.fillStyle = gradient;
+            ctx.beginPath();
+            ctx.arc(glow.x, glow.y, glow.size, 0, Math.PI * 2);
+            ctx.fill();
+        }
+        ctx.restore();
+    }
+    /**
+     * Draw subtle edge vignette
+     */
+    drawVignette(ctx, dimensions, intensity) {
+        const centerX = dimensions.width / 2;
+        const centerY = dimensions.height / 2;
+        const maxRadius = Math.sqrt(centerX * centerX + centerY * centerY);
+        const startRadius = maxRadius * GRADIENT_CONFIG.vignetteRadius;
+        ctx.save();
+        const gradient = ctx.createRadialGradient(centerX, centerY, startRadius, centerX, centerY, maxRadius);
+        gradient.addColorStop(0, `rgba(0, 10, 20, 0)`);
+        gradient.addColorStop(0.5, `rgba(0, 8, 18, ${intensity * 0.3})`);
+        gradient.addColorStop(1, `rgba(0, 5, 15, ${intensity})`);
+        ctx.fillStyle = gradient;
+        ctx.fillRect(0, 0, dimensions.width, dimensions.height);
+        ctx.restore();
+    }
+    // ============================================
+    // Utility Methods
+    // ============================================
+    hsl(h, s, l) {
+        return `hsl(${h}, ${s}%, ${l}%)`;
+    }
+    hexToRgb(hex) {
+        const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+        return result
+            ? {
+                r: parseInt(result[1], 16),
+                g: parseInt(result[2], 16),
+                b: parseInt(result[3], 16),
+            }
+            : { r: 100, g: 150, b: 200 };
+    }
+    randomInRange(min, max) {
+        return min + Math.random() * (max - min);
+    }
+    randomIntInRange(min, max) {
+        return min + Math.floor(Math.random() * (max - min + 1));
+    }
+}
+//# sourceMappingURL=GradientRenderer.js.map

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

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

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

@@ -0,0 +1,38 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { JellyfishMarineLife } from "../../domain/models/DeepOceanModels.js";
+import type { IJellyfishAnimator } from "../contracts/IJellyfishAnimator.js";
+export declare class JellyfishAnimator implements IJellyfishAnimator {
+    initializeJellyfish(dimensions: Dimensions, count: number): JellyfishMarineLife[];
+    createJellyfish(dimensions: Dimensions): JellyfishMarineLife;
+    /**
+     * Generate gonads (the distinctive internal organs)
+     */
+    private generateGonads;
+    /**
+     * Generate oral arms (thick inner tentacles)
+     */
+    private generateOralArms;
+    /**
+     * Generate trailing tentacles with segments
+     * Pre-calculates initial angles to avoid spaz on first frame
+     */
+    private generateTentacles;
+    updateJellyfish(jellyfish: JellyfishMarineLife[], dimensions: Dimensions, frameMultiplier: number): JellyfishMarineLife[];
+    /**
+     * Calculate pulse amount (0-1) with asymmetric timing
+     */
+    private getPulseAmount;
+    /**
+     * Update tentacle segment physics for fluid motion
+     */
+    private updateTentaclePhysics;
+    /**
+     * Update particle trail positions
+     */
+    private updateTrailPositions;
+    getJellyfishCount(quality: string): number;
+    private randomInRange;
+    private randomIntInRange;
+    private lerp;
+}
+//# sourceMappingURL=JellyfishAnimator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JellyfishAnimator.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/JellyfishAnimator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EACV,mBAAmB,EAMpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAwJ7E,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,mBAAmB,CACjB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,GACZ,mBAAmB,EAAE;IAQxB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,mBAAmB;IAoJ5D;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAoDzB,eAAe,CACb,SAAS,EAAE,mBAAmB,EAAE,EAChC,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,MAAM,GACtB,mBAAmB,EAAE;IA2DxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6C7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA8B5B,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI1C,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,IAAI;CAGb"}