@austencloud/backgrounds 0.1.0

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

@@ -0,0 +1,32 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { LightRay, CausticsState } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for light ray and caustics calculations
+ */
+export interface ILightRayCalculator {
+    /**
+     * Initialize light rays for the given dimensions
+     */
+    initializeLightRays(dimensions: Dimensions, count: number): LightRay[];
+    /**
+     * Update light ray animations
+     */
+    updateLightRays(lightRays: LightRay[], frameMultiplier: number): LightRay[];
+    /**
+     * Initialize caustic patterns
+     */
+    initializeCaustics(dimensions: Dimensions): CausticsState;
+    /**
+     * Update caustic animations
+     */
+    updateCaustics(caustics: CausticsState, dimensions: Dimensions, frameMultiplier: number): CausticsState;
+    /**
+     * Get optimal light ray count for quality level
+     */
+    getLightRayCount(quality: string): number;
+    /**
+     * Check if caustics should be enabled for quality level
+     */
+    getCausticsEnabled(quality: string): boolean;
+}
+//# sourceMappingURL=ILightRayCalculator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ILightRayCalculator.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/ILightRayCalculator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAEvE;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAE5E;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,CAAC;IAE1D;;OAEG;IACH,cAAc,CACZ,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,MAAM,GACtB,aAAa,CAAC;IAEjB;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9C"}

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

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

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

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

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

@@ -0,0 +1,16 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { LightRay, CausticsState } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for light ray and caustics rendering
+ */
+export interface ILightRayRenderer {
+    /**
+     * Draw volumetric light rays from surface
+     */
+    drawLightRays(ctx: CanvasRenderingContext2D, dimensions: Dimensions, lightRays: LightRay[], quality: string): void;
+    /**
+     * Draw caustic patterns (dancing underwater light)
+     */
+    drawCaustics(ctx: CanvasRenderingContext2D, dimensions: Dimensions, caustics: CausticsState, quality: string): void;
+}
+//# sourceMappingURL=ILightRayRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ILightRayRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/ILightRayRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,aAAa,CACX,GAAG,EAAE,wBAAwB,EAC7B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,MAAM,GACd,IAAI,CAAC;IAER;;OAEG;IACH,YAAY,CACV,GAAG,EAAE,wBAAwB,EAC7B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,GACd,IAAI,CAAC;CACT"}

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

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

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

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

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

@@ -0,0 +1,11 @@
+import type { OceanParticle } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for particle rendering
+ */
+export interface IParticleRenderer {
+    /**
+     * Draw all ocean particles
+     */
+    drawParticles(ctx: CanvasRenderingContext2D, particles: OceanParticle[]): void;
+}
+//# sourceMappingURL=IParticleRenderer.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,28 @@
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { OceanParticle } from "../../domain/models/DeepOceanModels.js";
+/**
+ * Contract for particle system management
+ */
+export interface IParticleSystem {
+    /**
+     * Initialize particles for the given dimensions
+     */
+    initializeParticles(dimensions: Dimensions, count: number): OceanParticle[];
+    /**
+     * Create a single particle
+     */
+    createParticle(dimensions: Dimensions): OceanParticle;
+    /**
+     * Update particle positions and lifecycle
+     */
+    updateParticles(particles: OceanParticle[], dimensions: Dimensions, frameMultiplier: number): OceanParticle[];
+    /**
+     * Get optimal particle count for quality level
+     */
+    getParticleCount(quality: string): number;
+    /**
+     * Get particle color palette
+     */
+    getParticleColor(): string;
+}
+//# sourceMappingURL=IParticleSystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IParticleSystem.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/contracts/IParticleSystem.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,eAAe;IAC9B;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAE5E;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,CAAC;IAEtD;;OAEG;IACH,eAAe,CACb,SAAS,EAAE,aAAa,EAAE,EAC1B,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,MAAM,GACtB,aAAa,EAAE,CAAC;IAEnB;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C;;OAEG;IACH,gBAAgB,IAAI,MAAM,CAAC;CAC5B"}

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

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

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

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

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

@@ -0,0 +1,22 @@
+import type { Bubble } from "../../domain/models/DeepOceanModels.js";
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { IBubblePhysics } from "../contracts/IBubblePhysics.js";
+export declare class BubblePhysics implements IBubblePhysics {
+    private nextClusterId;
+    initializeBubbles(dimensions: Dimensions, count: number): Bubble[];
+    createBubble(dimensions: Dimensions, clusterId?: number, clusterOffset?: {
+        x: number;
+        y: number;
+    }): Bubble;
+    private createCluster;
+    updateBubbles(bubbles: Bubble[], dimensions: Dimensions, frameMultiplier: number, animationTime: number): Bubble[];
+    private updateBubblePhysics;
+    private updateTrailParticles;
+    private updateVisualPhases;
+    private pickSizeCategory;
+    getBubbleCount(quality: string): number;
+    private randomInRange;
+    private randomIntInRange;
+    private lerp;
+}
+//# sourceMappingURL=BubblePhysics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BubblePhysics.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/BubblePhysics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAGP,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAuErE,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,aAAa,CAAK;IAE1B,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAuBlE,YAAY,CACV,UAAU,EAAE,UAAU,EACtB,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GACvC,MAAM;IAmFT,OAAO,CAAC,aAAa;IA2BrB,aAAa,CACX,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB,MAAM,EAAE;IAqEX,OAAO,CAAC,mBAAmB;IA+C3B,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,gBAAgB;IASxB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAevC,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,IAAI;CAGb"}

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

@@ -0,0 +1,303 @@
+/**
+ * Bubble Configuration
+ * Tuned for beautiful, physically-accurate bubble behavior
+ */
+const BUBBLE_CONFIG = {
+    // Size categories with behavior profiles
+    sizes: {
+        small: {
+            radius: { min: 2, max: 4 },
+            speed: { min: 0.8, max: 1.5 },
+            acceleration: 0.002, // Fast acceleration
+            wobbleAmplitude: { min: 0.08, max: 0.12 },
+            wobbleSpeed: { min: 0.04, max: 0.06 },
+            turbulence: 0.8, // High jitter
+            opacity: { min: 0.2, max: 0.35 },
+            iridescentSpeed: { min: 0.015, max: 0.025 },
+            trailSpawnRate: 0.02, // Rarely spawn trails
+            weight: 0.5, // 50% chance
+        },
+        medium: {
+            radius: { min: 5, max: 8 },
+            speed: { min: 0.5, max: 1.0 },
+            acceleration: 0.0015,
+            wobbleAmplitude: { min: 0.06, max: 0.1 },
+            wobbleSpeed: { min: 0.025, max: 0.04 },
+            turbulence: 0.5,
+            opacity: { min: 0.25, max: 0.45 },
+            iridescentSpeed: { min: 0.01, max: 0.018 },
+            trailSpawnRate: 0.04,
+            weight: 0.35, // 35% chance
+        },
+        large: {
+            radius: { min: 10, max: 15 },
+            speed: { min: 0.3, max: 0.6 },
+            acceleration: 0.001, // Slow acceleration
+            wobbleAmplitude: { min: 0.04, max: 0.08 },
+            wobbleSpeed: { min: 0.015, max: 0.025 },
+            turbulence: 0.3, // Stable rise
+            opacity: { min: 0.35, max: 0.55 },
+            iridescentSpeed: { min: 0.006, max: 0.012 },
+            trailSpawnRate: 0.08, // Frequently spawn trails
+            weight: 0.15, // 15% chance
+        },
+    },
+    // Depth/parallax (0 = close, 1 = far)
+    depth: { min: 0.2, max: 0.9 },
+    depthSwayScale: { min: 0.4, max: 1.4 }, // Sway multiplier by depth (close = more sway)
+    // Physics
+    maxSpeed: 2.5, // Cap on upward velocity
+    swayMagnitude: { min: 0.3, max: 0.8 },
+    turbulenceFrequency: 0.03,
+    // Visual
+    fadeZoneHeight: 0.15, // Top 15% of screen = fade zone
+    rimHighlightSpeed: 0.008, // Slow rotation of highlight
+    // Trails
+    trailMaxAge: 0.8, // Seconds before trail fades
+    trailMaxParticles: 4, // Max particles per bubble
+    trailSizeRatio: 0.3, // Trail particle size relative to parent
+    // Clustering
+    clusterChance: 0.15, // 15% of bubbles are in clusters
+    clusterSize: { min: 2, max: 3 },
+    clusterSpread: 20, // Pixels between clustered bubbles
+};
+export class BubblePhysics {
+    nextClusterId = 1;
+    initializeBubbles(dimensions, count) {
+        const bubbles = [];
+        // Create clusters first
+        let remaining = count;
+        while (remaining > 0) {
+            if (Math.random() < BUBBLE_CONFIG.clusterChance && remaining >= 2) {
+                const clusterSize = this.randomIntInRange(BUBBLE_CONFIG.clusterSize.min, Math.min(BUBBLE_CONFIG.clusterSize.max, remaining));
+                const cluster = this.createCluster(dimensions, clusterSize);
+                bubbles.push(...cluster);
+                remaining -= clusterSize;
+            }
+            else {
+                bubbles.push(this.createBubble(dimensions));
+                remaining--;
+            }
+        }
+        return bubbles;
+    }
+    createBubble(dimensions, clusterId, clusterOffset) {
+        const sizeCategory = this.pickSizeCategory();
+        const config = BUBBLE_CONFIG.sizes[sizeCategory];
+        const radius = this.randomInRange(config.radius.min, config.radius.max);
+        const baseSpeed = this.randomInRange(config.speed.min, config.speed.max);
+        const baseOpacity = this.randomInRange(config.opacity.min, config.opacity.max);
+        // Assign depth (0 = close, 1 = far)
+        const depth = this.randomInRange(BUBBLE_CONFIG.depth.min, BUBBLE_CONFIG.depth.max);
+        // Depth affects sway: closer = more horizontal movement (parallax)
+        const depthSwayMultiplier = this.lerp(BUBBLE_CONFIG.depthSwayScale.max, BUBBLE_CONFIG.depthSwayScale.min, depth);
+        const startY = dimensions.height + 50 + Math.random() * 100;
+        return {
+            // Position
+            x: Math.random() * dimensions.width,
+            y: startY,
+            startY,
+            // Depth
+            depth,
+            // Size
+            radius,
+            sizeCategory,
+            // Physics
+            speed: baseSpeed,
+            baseSpeed,
+            acceleration: config.acceleration,
+            sway: this.randomInRange(BUBBLE_CONFIG.swayMagnitude.min, BUBBLE_CONFIG.swayMagnitude.max) * depthSwayMultiplier,
+            swayOffset: Math.random() * Math.PI * 2,
+            turbulenceX: 0,
+            turbulencePhase: Math.random() * Math.PI * 2,
+            // Wobble
+            wobblePhase: Math.random() * Math.PI * 2,
+            wobbleAmplitude: this.randomInRange(config.wobbleAmplitude.min, config.wobbleAmplitude.max),
+            wobbleSpeed: this.randomInRange(config.wobbleSpeed.min, config.wobbleSpeed.max),
+            // Visual
+            opacity: baseOpacity,
+            baseOpacity,
+            iridescentPhase: Math.random() * Math.PI * 2,
+            iridescentSpeed: this.randomInRange(config.iridescentSpeed.min, config.iridescentSpeed.max),
+            rimHighlightAngle: Math.random() * Math.PI * 2,
+            // Trail
+            trailParticles: [],
+            lastTrailSpawn: 0,
+            // Clustering
+            clusterId,
+            clusterOffset,
+            // Lifecycle
+            age: 0,
+            fadeZone: dimensions.height * BUBBLE_CONFIG.fadeZoneHeight,
+        };
+    }
+    createCluster(dimensions, size) {
+        const clusterId = this.nextClusterId++;
+        const bubbles = [];
+        // Leader bubble (no offset)
+        bubbles.push(this.createBubble(dimensions, clusterId, { x: 0, y: 0 }));
+        // Follower bubbles with offsets
+        for (let i = 1; i < size; i++) {
+            const angle = (i / (size - 1)) * Math.PI - Math.PI / 2;
+            const offset = {
+                x: Math.cos(angle) *
+                    BUBBLE_CONFIG.clusterSpread *
+                    (0.5 + Math.random() * 0.5),
+                y: Math.sin(angle) *
+                    BUBBLE_CONFIG.clusterSpread *
+                    0.5 *
+                    (0.5 + Math.random() * 0.5),
+            };
+            bubbles.push(this.createBubble(dimensions, clusterId, offset));
+        }
+        return bubbles;
+    }
+    updateBubbles(bubbles, dimensions, frameMultiplier, animationTime) {
+        const updatedBubbles = [];
+        // Group bubbles by cluster for synchronized movement
+        const clusterLeaders = new Map();
+        for (const bubble of bubbles) {
+            if (bubble.clusterId !== undefined &&
+                bubble.clusterOffset?.x === 0 &&
+                bubble.clusterOffset?.y === 0) {
+                clusterLeaders.set(bubble.clusterId, bubble);
+            }
+        }
+        for (const bubble of bubbles) {
+            // Update physics
+            this.updateBubblePhysics(bubble, dimensions, frameMultiplier, animationTime);
+            // Update cluster position (followers track leaders)
+            if (bubble.clusterId !== undefined &&
+                bubble.clusterOffset &&
+                (bubble.clusterOffset.x !== 0 || bubble.clusterOffset.y !== 0)) {
+                const leader = clusterLeaders.get(bubble.clusterId);
+                if (leader) {
+                    bubble.x = leader.x + bubble.clusterOffset.x;
+                    bubble.y = leader.y + bubble.clusterOffset.y;
+                }
+            }
+            // Update trail particles
+            this.updateTrailParticles(bubble, animationTime, frameMultiplier);
+            // Update visual phases
+            this.updateVisualPhases(bubble, frameMultiplier);
+            // Check if off-screen
+            if (bubble.y < -bubble.radius * 2) {
+                // Replace with new bubble (or cluster)
+                if (bubble.clusterId !== undefined) {
+                    // Only replace cluster leader
+                    if (bubble.clusterOffset?.x === 0 &&
+                        bubble.clusterOffset?.y === 0) {
+                        const cluster = this.createCluster(dimensions, this.randomIntInRange(BUBBLE_CONFIG.clusterSize.min, BUBBLE_CONFIG.clusterSize.max));
+                        updatedBubbles.push(...cluster);
+                    }
+                    // Followers are automatically replaced with leader
+                }
+                else {
+                    updatedBubbles.push(this.createBubble(dimensions));
+                }
+            }
+            else {
+                updatedBubbles.push(bubble);
+            }
+        }
+        return updatedBubbles;
+    }
+    updateBubblePhysics(bubble, dimensions, frameMultiplier, animationTime) {
+        const config = BUBBLE_CONFIG.sizes[bubble.sizeCategory];
+        // Acceleration (buoyancy - bubbles speed up as they rise)
+        bubble.speed = Math.min(BUBBLE_CONFIG.maxSpeed, bubble.speed + bubble.acceleration * frameMultiplier);
+        // Upward movement
+        bubble.y -= bubble.speed * frameMultiplier;
+        // Sinusoidal sway
+        const swayAmount = Math.sin(animationTime * bubble.sway + bubble.swayOffset) *
+            0.5 *
+            frameMultiplier;
+        // Turbulence (random jitter)
+        bubble.turbulencePhase += BUBBLE_CONFIG.turbulenceFrequency * frameMultiplier;
+        const turbulenceAmount = Math.sin(bubble.turbulencePhase * 7.3) *
+            Math.cos(bubble.turbulencePhase * 3.1) *
+            config.turbulence *
+            0.3 *
+            frameMultiplier;
+        bubble.turbulenceX = turbulenceAmount;
+        bubble.x += swayAmount + turbulenceAmount;
+        // Fade as approaching surface
+        if (bubble.y < bubble.fadeZone) {
+            const fadeProgress = 1 - bubble.y / bubble.fadeZone;
+            bubble.opacity = bubble.baseOpacity * (1 - fadeProgress * 0.8);
+        }
+        else {
+            // Fade in at start
+            const riseProgress = (bubble.startY - bubble.y) / (bubble.startY * 0.2);
+            bubble.age = Math.min(1, riseProgress);
+            bubble.opacity = bubble.baseOpacity * Math.min(1, bubble.age * 2);
+        }
+    }
+    updateTrailParticles(bubble, animationTime, frameMultiplier) {
+        const config = BUBBLE_CONFIG.sizes[bubble.sizeCategory];
+        // Age existing particles
+        for (let i = bubble.trailParticles.length - 1; i >= 0; i--) {
+            const particle = bubble.trailParticles[i];
+            if (particle) {
+                particle.age += (0.016 / BUBBLE_CONFIG.trailMaxAge) * frameMultiplier;
+                if (particle.age > 1) {
+                    bubble.trailParticles.splice(i, 1);
+                }
+            }
+        }
+        // Spawn new trail particles
+        const timeSinceLastSpawn = animationTime - bubble.lastTrailSpawn;
+        if (timeSinceLastSpawn > 0.1 &&
+            Math.random() < config.trailSpawnRate * frameMultiplier &&
+            bubble.trailParticles.length < BUBBLE_CONFIG.trailMaxParticles) {
+            bubble.trailParticles.push({
+                x: bubble.x + (Math.random() - 0.5) * bubble.radius * 0.5,
+                y: bubble.y + bubble.radius * 0.8,
+                age: 0,
+                size: bubble.radius * BUBBLE_CONFIG.trailSizeRatio * (0.5 + Math.random() * 0.5),
+            });
+            bubble.lastTrailSpawn = animationTime;
+        }
+    }
+    updateVisualPhases(bubble, frameMultiplier) {
+        // Wobble animation
+        bubble.wobblePhase += bubble.wobbleSpeed * frameMultiplier;
+        // Iridescent shimmer
+        bubble.iridescentPhase += bubble.iridescentSpeed * frameMultiplier;
+        // Rim highlight rotation (very slow)
+        bubble.rimHighlightAngle += BUBBLE_CONFIG.rimHighlightSpeed * frameMultiplier;
+    }
+    pickSizeCategory() {
+        const roll = Math.random();
+        const { small, medium, large } = BUBBLE_CONFIG.sizes;
+        if (roll < small.weight)
+            return "small";
+        if (roll < small.weight + medium.weight)
+            return "medium";
+        return "large";
+    }
+    getBubbleCount(quality) {
+        switch (quality) {
+            case "minimal":
+                return 6;
+            case "low":
+                return 12;
+            case "medium":
+                return 20;
+            case "high":
+                return 28;
+            default:
+                return 20;
+        }
+    }
+    randomInRange(min, max) {
+        return min + Math.random() * (max - min);
+    }
+    randomIntInRange(min, max) {
+        return min + Math.floor(Math.random() * (max - min + 1));
+    }
+    lerp(a, b, t) {
+        return a + (b - a) * t;
+    }
+}
+//# sourceMappingURL=BubblePhysics.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { Bubble } from "../../domain/models/DeepOceanModels.js";
+import type { IBubbleRenderer } from "../contracts/IBubbleRenderer.js";
+/**
+ * A+ Bubble Renderer
+ *
+ * Renders physically-accurate bubbles with:
+ * - Gradient shell (translucent soap-bubble effect)
+ * - Iridescent surface shimmer (rainbow that shifts with phase)
+ * - Inner refraction layer (distorted interior highlight)
+ * - Dynamic rim highlight (moves with light direction)
+ * - Wobble deformation (non-circular oscillation)
+ * - Trail particles (micro-bubbles following)
+ * - Size-based visual characteristics
+ */
+export declare class BubbleRenderer implements IBubbleRenderer {
+    drawBubbles(ctx: CanvasRenderingContext2D, bubbles: Bubble[]): void;
+    private drawSingleBubble;
+    /**
+     * Draw trail particles (micro-bubbles following larger bubble)
+     */
+    private drawTrailParticles;
+    /**
+     * Draw soft outer glow halo
+     */
+    private drawGlowHalo;
+    /**
+     * Draw main shell gradient (soap bubble translucency)
+     */
+    private drawShellGradient;
+    /**
+     * Draw inner refraction layer (distorted highlight showing depth)
+     */
+    private drawInnerRefraction;
+    /**
+     * Draw iridescent shimmer (rainbow effect that shifts)
+     */
+    private drawIridescentShimmer;
+    /**
+     * Draw dynamic rim highlight (light catching the edge)
+     */
+    private drawRimHighlight;
+}
+//# sourceMappingURL=BubbleRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BubbleRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/deep-ocean/services/implementations/BubbleRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wCAAwC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE;;;;;;;;;;;GAWG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,WAAW,CAAC,GAAG,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IASnE,OAAO,CAAC,gBAAgB;IAmCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4C3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyD7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAyFzB"}