@austencloud/backgrounds 0.1.0

package/dist/backgrounds/cherry-blossom/services/environment/TreeSilhouetteSystem.d.ts

@@ -0,0 +1,26 @@
+/**
+ * TreeSilhouetteSystem
+ *
+ * Renders stylized cherry tree silhouettes along edges.
+ * Uses cached OffscreenCanvas for performance.
+ */
+import type { Dimensions } from "../../../../core/domain/types.js";
+export declare class TreeSilhouetteSystem {
+    private cachedCanvas;
+    private lastDimensions;
+    private silhouetteColor;
+    private isInitialized;
+    constructor();
+    initialize(dimensions: Dimensions): void;
+    private renderToCache;
+    private drawTree;
+    update(_dimensions: Dimensions, _frameMultiplier?: number): void;
+    draw(ctx: CanvasRenderingContext2D, dimensions: Dimensions): void;
+    handleResize(newDimensions: Dimensions): void;
+    /**
+     * Set silhouette color (for different time-of-day modes)
+     */
+    setSilhouetteColor(color: string): void;
+    cleanup(): void;
+}
+//# sourceMappingURL=TreeSilhouetteSystem.d.ts.map

package/dist/backgrounds/cherry-blossom/services/environment/TreeSilhouetteSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSilhouetteSystem.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/cherry-blossom/services/environment/TreeSilhouetteSystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAsBnE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,aAAa,CAAS;;IAS9B,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAMxC,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,QAAQ;IAkFhB,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,gBAAgB,GAAE,MAAY,GAAG,IAAI;IAKrE,IAAI,CAAC,GAAG,EAAE,wBAAwB,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAiBjE,YAAY,CAAC,aAAa,EAAE,UAAU,GAAG,IAAI;IAK7C;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOvC,OAAO,IAAI,IAAI;CAKhB"}

package/dist/backgrounds/cherry-blossom/services/environment/TreeSilhouetteSystem.js

@@ -0,0 +1,144 @@
+/**
+ * TreeSilhouetteSystem
+ *
+ * Renders stylized cherry tree silhouettes along edges.
+ * Uses cached OffscreenCanvas for performance.
+ */
+// Predefined tree templates for consistent, hand-crafted look
+const TREE_TEMPLATES = [
+    // Left side tree - tall, leaning slightly right
+    { x: 0.05, baseY: 0.1, height: 0.7, width: 0.35, trunkWidth: 0.08, branches: 4, lean: 0.3 },
+    // Right side tree - medium, leaning slightly left
+    { x: 0.88, baseY: 0.08, height: 0.55, width: 0.3, trunkWidth: 0.07, branches: 3, lean: -0.2 },
+    // Far left small tree
+    { x: -0.05, baseY: 0.05, height: 0.4, width: 0.25, trunkWidth: 0.06, branches: 2, lean: 0.1 },
+];
+export class TreeSilhouetteSystem {
+    cachedCanvas = null;
+    lastDimensions = null;
+    silhouetteColor = "#0a0808"; // Near-black with slight warmth
+    isInitialized = false;
+    constructor() {
+        // Support for OffscreenCanvas
+        if (typeof OffscreenCanvas === "undefined") {
+            console.warn("OffscreenCanvas not supported, trees will be drawn directly");
+        }
+    }
+    initialize(dimensions) {
+        this.renderToCache(dimensions);
+        this.lastDimensions = dimensions;
+        this.isInitialized = true;
+    }
+    renderToCache(dimensions) {
+        const { width, height } = dimensions;
+        // Use OffscreenCanvas if available, otherwise use regular canvas
+        if (typeof OffscreenCanvas !== "undefined") {
+            this.cachedCanvas = new OffscreenCanvas(width, height);
+        }
+        else {
+            const canvas = document.createElement("canvas");
+            canvas.width = width;
+            canvas.height = height;
+            this.cachedCanvas = canvas;
+        }
+        const ctx = this.cachedCanvas.getContext("2d");
+        if (!ctx)
+            return;
+        ctx.clearRect(0, 0, width, height);
+        // Render each tree template
+        for (const template of TREE_TEMPLATES) {
+            this.drawTree(ctx, dimensions, template);
+        }
+    }
+    drawTree(ctx, dimensions, params) {
+        const { width, height } = dimensions;
+        const baseX = width * params.x;
+        const baseY = height * (1 - params.baseY);
+        const treeHeight = height * params.height;
+        const canopyWidth = width * params.width;
+        const trunkW = canopyWidth * params.trunkWidth;
+        ctx.save();
+        ctx.fillStyle = this.silhouetteColor;
+        // Draw trunk
+        const trunkTop = baseY - treeHeight * 0.3;
+        const lean = params.lean * canopyWidth * 0.3;
+        ctx.beginPath();
+        ctx.moveTo(baseX - trunkW / 2, baseY);
+        ctx.lineTo(baseX + trunkW / 2, baseY);
+        ctx.lineTo(baseX + lean + trunkW / 4, trunkTop);
+        ctx.lineTo(baseX + lean - trunkW / 4, trunkTop);
+        ctx.closePath();
+        ctx.fill();
+        // Draw canopy (layered cloud-like shapes for cherry blossom style)
+        const canopyBase = baseY - treeHeight * 0.25;
+        const canopyCenterX = baseX + lean;
+        // Multiple overlapping circles to create organic canopy shape
+        const layers = params.branches;
+        for (let layer = 0; layer < layers; layer++) {
+            const layerProgress = layer / (layers - 1);
+            const layerY = canopyBase - treeHeight * 0.6 * layerProgress;
+            const layerWidth = canopyWidth * (1 - layerProgress * 0.4);
+            // Create 3-5 overlapping circles per layer
+            const circlesInLayer = 3 + Math.floor(Math.random() * 2);
+            for (let i = 0; i < circlesInLayer; i++) {
+                const circleProgress = i / (circlesInLayer - 1);
+                const offsetX = (circleProgress - 0.5) * layerWidth * 0.8;
+                const radius = layerWidth * (0.2 + Math.random() * 0.15);
+                ctx.beginPath();
+                ctx.arc(canopyCenterX + offsetX, layerY + Math.random() * treeHeight * 0.1, radius, 0, Math.PI * 2);
+                ctx.fill();
+            }
+        }
+        // Add some hanging branches
+        const branchCount = 5 + Math.floor(Math.random() * 3);
+        for (let i = 0; i < branchCount; i++) {
+            const branchX = canopyCenterX + (Math.random() - 0.5) * canopyWidth * 0.9;
+            const branchStartY = canopyBase - treeHeight * 0.3 - Math.random() * treeHeight * 0.4;
+            const branchLength = treeHeight * 0.1 + Math.random() * treeHeight * 0.15;
+            const branchCurve = (Math.random() - 0.5) * 0.3;
+            ctx.beginPath();
+            ctx.moveTo(branchX, branchStartY);
+            ctx.quadraticCurveTo(branchX + branchCurve * canopyWidth * 0.1, branchStartY + branchLength * 0.5, branchX + branchCurve * canopyWidth * 0.15, branchStartY + branchLength);
+            ctx.strokeStyle = this.silhouetteColor;
+            ctx.lineWidth = 2 + Math.random() * 2;
+            ctx.stroke();
+        }
+        ctx.restore();
+    }
+    update(_dimensions, _frameMultiplier = 1.0) {
+        // Trees are static - no animation needed
+        // Could add subtle sway in future
+    }
+    draw(ctx, dimensions) {
+        // Check if we need to re-render cache
+        if (!this.isInitialized ||
+            !this.lastDimensions ||
+            dimensions.width !== this.lastDimensions.width ||
+            dimensions.height !== this.lastDimensions.height) {
+            this.initialize(dimensions);
+        }
+        if (!this.cachedCanvas)
+            return;
+        // Draw cached silhouettes
+        ctx.drawImage(this.cachedCanvas, 0, 0);
+    }
+    handleResize(newDimensions) {
+        // Re-render cache for new dimensions
+        this.initialize(newDimensions);
+    }
+    /**
+     * Set silhouette color (for different time-of-day modes)
+     */
+    setSilhouetteColor(color) {
+        this.silhouetteColor = color;
+        if (this.lastDimensions) {
+            this.renderToCache(this.lastDimensions);
+        }
+    }
+    cleanup() {
+        this.cachedCanvas = null;
+        this.lastDimensions = null;
+        this.isInitialized = false;
+    }
+}
+//# sourceMappingURL=TreeSilhouetteSystem.js.map

package/dist/backgrounds/cherry-blossom/services/environment/TreeSilhouetteSystem.js.map

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

package/dist/backgrounds/deep-ocean/domain/constants/fish-constants.d.ts

@@ -0,0 +1,338 @@
+/**
+ * Fish Behavior & Animation Constants
+ *
+ * All magic numbers extracted and documented for maintainability.
+ * Values are tuned for a calm, ambient deep ocean aesthetic.
+ */
+import type { DepthLayer, FishSpecies } from "../models/DeepOceanModels.js";
+/**
+ * Depth layer visual properties.
+ * Far fish appear smaller/slower (parallax effect simulating distance).
+ * Near fish are larger/faster and more prominent.
+ */
+export declare const DEPTH_LAYER_CONFIG: Record<DepthLayer, {
+    /** Scale range [min, max] as fraction of sprite size */
+    scale: [number, number];
+    /** Speed multiplier (1.0 = base speed) */
+    speedMultiplier: number;
+    /** Opacity range [min, max] */
+    opacity: [number, number];
+    /** Vertical band as fraction of screen height [min, max] */
+    verticalBand: [number, number];
+}>;
+/**
+ * Probability distribution for depth layer assignment.
+ * More fish in mid layer creates natural depth distribution.
+ */
+export declare const DEPTH_LAYER_DISTRIBUTION: {
+    /** Probability of far layer (0-25%) */
+    farThreshold: number;
+    /** Probability of mid layer (25-70%) */
+    midThreshold: number;
+};
+export declare const FISH_MOVEMENT: {
+    /** Base horizontal speed range [min, max] in pixels per second */
+    baseSpeed: readonly [25, 55];
+    /** Vertical drift range (pixels per second, centered at 0) */
+    verticalDrift: number;
+    /** Bobbing animation amplitude range [min, max] in pixels */
+    bobAmplitude: readonly [2, 5];
+    /** Bobbing animation speed range [min, max] (radians per frame at 60fps) */
+    bobSpeed: readonly [0.008, 0.02];
+    /** Maximum spawn offset from screen edge (pixels or fraction of width) */
+    spawnOffset: {
+        pixels: number;
+        fractionOfWidth: number;
+    };
+};
+/**
+ * Species-specific speed multipliers
+ * Fast fish like sleek predators swim faster than tropical fish
+ */
+export declare const SPECIES_SPEED_MULTIPLIERS: Record<FishSpecies, [number, number]>;
+export declare const BEHAVIOR_CONFIG: {
+    /**
+     * Cruising: Normal swimming state
+     * Fish swim in one direction with gentle bob motion
+     */
+    cruising: {
+        /** Duration range [min, max] in seconds before behavior change */
+        duration: readonly [8, 20];
+    };
+    /**
+     * Turning: Fish reverses direction
+     * Triggered randomly or when approaching screen edge
+     */
+    turning: {
+        /** Fixed duration in seconds */
+        duration: number;
+        /** Speed multiplier during turn (slows down) */
+        speedMultiplier: number;
+        /** Maximum rotation angle in radians */
+        maxRotation: number;
+    };
+    /**
+     * Darting: Natural fish C-start escape response
+     *
+     * Based on fish biomechanics research: real fish use a three-phase escape:
+     * 1. COIL (preparatory): Body tenses, bends into C-shape (~50ms)
+     * 2. BURST (propulsive): Explosive tail flip acceleration (~150ms)
+     * 3. RECOVERY (deceleration): Gradual easeOutExpo slowdown (~400ms)
+     *
+     * Reference: Journal of Experimental Biology - Fish Escape Responses
+     */
+    darting: {
+        /** Total duration of all three phases (seconds) */
+        duration: number;
+        /** Phase 1: Coil (preparatory) - body tenses before burst */
+        coilDuration: number;
+        coilSpeedMultiplier: number;
+        /** Phase 2: Burst (propulsive) - explosive acceleration */
+        burstDuration: number;
+        burstSpeedMultiplier: readonly [4, 6];
+        /** Phase 3: Recovery (deceleration) - gradual slowdown */
+        recoveryDuration: number;
+        /** Legacy: kept for compatibility but not used in new 3-phase system */
+        speedMultiplier: readonly [2.5, 4];
+    };
+    /**
+     * Schooling: Fish follow group leader
+     * Maintains formation while cruising
+     */
+    schooling: {
+        /** Duration range [min, max] in seconds */
+        duration: readonly [10, 25];
+    };
+    /**
+     * Passing: Fast direct swimmer - no bobbing, straight line
+     * Creates variety with some fish that zoom across the screen
+     */
+    passing: {
+        /** Duration range [min, max] in seconds */
+        duration: readonly [2, 4];
+        /** Speed multiplier range [min, max] - much faster than cruising */
+        speedMultiplier: readonly [3, 5];
+        /** Body flex is reduced for streamlined appearance */
+        bodyFlexMultiplier: number;
+    };
+    /**
+     * Ascending: Swimming upward with focus on vertical movement
+     * Fish browses toward the surface
+     */
+    ascending: {
+        /** Duration range [min, max] in seconds */
+        duration: readonly [1.5, 3];
+        /** Speed multiplier (slightly slower than cruising) */
+        speedMultiplier: number;
+        /** Vertical movement range [min, max] pixels per second */
+        verticalSpeed: readonly [30, 60];
+        /** Body rotation angle range [min, max] in radians (tilted up) */
+        bodyRotation: readonly [0.26, 0.44];
+    };
+    /**
+     * Descending: Swimming downward with focus on vertical movement
+     * Fish browses toward the depths
+     */
+    descending: {
+        /** Duration range [min, max] in seconds */
+        duration: readonly [1.5, 3];
+        /** Speed multiplier (slightly slower than cruising) */
+        speedMultiplier: number;
+        /** Vertical movement range [min, max] pixels per second (negative = down) */
+        verticalSpeed: readonly [-60, -30];
+        /** Body rotation angle range [min, max] in radians (tilted down) */
+        bodyRotation: readonly [-0.44, -0.26];
+    };
+    /**
+     * Approaching: Swimming toward camera (z decreasing)
+     * Fish grows larger and more prominent
+     */
+    approaching: {
+        /** Duration range [min, max] in seconds - slow for smooth scaling */
+        duration: readonly [3, 6];
+        /** Z-axis change range [min, max] - how much closer the fish gets */
+        zChange: readonly [-0.4, -0.2];
+        /** Speed multiplier (normal horizontal movement) */
+        speedMultiplier: number;
+    };
+    /**
+     * Receding: Swimming away from camera (z increasing)
+     * Fish shrinks and fades into the background
+     */
+    receding: {
+        /** Duration range [min, max] in seconds - slow for smooth scaling */
+        duration: readonly [3, 6];
+        /** Z-axis change range [min, max] - how much farther the fish gets */
+        zChange: readonly [0.2, 0.4];
+        /** Speed multiplier (normal horizontal movement) */
+        speedMultiplier: number;
+    };
+};
+/**
+ * Depth transition configuration for 3D z-axis movement
+ */
+export declare const DEPTH_TRANSITION: {
+    /** Lerp speed for z-axis movement (per frame at 60fps) */
+    lerpSpeed: number;
+    /** Minimum z value (closest to camera) */
+    minZ: number;
+    /** Maximum z value (farthest from camera) */
+    maxZ: number;
+    /** Scale factor: scale = 1 - (z * scaleReduction) */
+    scaleReduction: number;
+    /** Opacity factor: opacity = 1 - (z * opacityReduction) */
+    opacityReduction: number;
+    /** Speed factor: speed = 1 - (z * speedReduction) */
+    speedReduction: number;
+};
+/**
+ * Probability of transitioning to each behavior from cruising.
+ * Probabilities are checked in order; remaining = continue cruising.
+ */
+export declare const BEHAVIOR_TRANSITION_PROBABILITY: {
+    /** Chance to initiate a turn (8%) */
+    turn: number;
+    /** Chance to dart/startle (4%) - checked after turn */
+    dart: number;
+    /** Chance to start passing (fast straight swim) (3%) */
+    passing: number;
+    /** Chance to start ascending (5%) */
+    ascending: number;
+    /** Chance to start descending (5%) */
+    descending: number;
+    /** Chance to approach (swim toward camera) (2%) */
+    approaching: number;
+    /** Chance to recede (swim away from camera) (2%) */
+    receding: number;
+};
+/**
+ * Species-specific vertical preferences within their depth band.
+ * Controls where fish spawn and drift over time.
+ *
+ * preferredZone: [0, 1] where 0 = top of band, 1 = bottom
+ * zoneAffinity: how strongly fish are drawn back to preferred zone (0-1)
+ * ascendingMod/descendingMod: multipliers for vertical movement probability
+ */
+export declare const SPECIES_VERTICAL_PREFERENCES: Record<FishSpecies, {
+    preferredZone: [number, number];
+    zoneAffinity: number;
+    ascendingMod: number;
+    descendingMod: number;
+}>;
+/**
+ * Species-specific behavior probability modifiers.
+ * Multipliers applied to base probabilities.
+ */
+export declare const SPECIES_BEHAVIOR_MODIFIERS: Record<FishSpecies, Partial<Record<keyof typeof BEHAVIOR_TRANSITION_PROBABILITY, number>>>;
+/**
+ * Edge awareness thresholds.
+ * Fish are more likely to turn when approaching screen edges.
+ */
+export declare const EDGE_AWARENESS: {
+    /** Distance from edge (as fraction of screen width) to start considering turn */
+    warningZone: number;
+    /** Multiplier for turn probability when in warning zone */
+    turnProbabilityMultiplier: number;
+};
+export declare const FLOCKING_CONFIG: {
+    /**
+     * Separation: Steer to avoid crowding nearby fish
+     */
+    separation: {
+        /** Radius within which separation force applies (pixels) */
+        radius: number;
+        /** Strength of separation force */
+        weight: number;
+    };
+    /**
+     * Alignment: Steer towards average heading of nearby fish
+     */
+    alignment: {
+        /** Radius within which alignment force applies (pixels) */
+        radius: number;
+        /** Strength of alignment force */
+        weight: number;
+    };
+    /**
+     * Cohesion: Steer towards center of mass of nearby fish
+     */
+    cohesion: {
+        /** Radius within which cohesion force applies (pixels) */
+        radius: number;
+        /** Strength of cohesion force */
+        weight: number;
+    };
+    /** Maximum steering force per frame (limits sudden turns) */
+    maxSteeringForce: number;
+    /** School formation */
+    school: {
+        /** Target number of fish per school */
+        size: readonly [2, 4];
+        /** Percentage of fish population to form into schools */
+        populationFraction: number;
+    };
+};
+export declare const FISH_VISUALS: {
+    /** Tail wiggle animation speed multiplier (relative to movement speed) */
+    tailWiggleSpeed: number;
+    /** Maximum tail skew for wiggle effect */
+    maxTailSkew: number;
+    /** Rotation response to vertical drift (tilt when swimming up/down) */
+    driftRotationFactor: number;
+    /** Rotation smoothing factor (0-1, lower = smoother) */
+    rotationSmoothing: number;
+};
+export declare const SPAWN_CONFIG: {
+    /** Delay range [min, max] in seconds before respawning off-screen fish */
+    respawnDelay: readonly [2, 8];
+    /** Buffer zone beyond screen edge before fish is considered "off-screen" */
+    offScreenBuffer: number;
+};
+export declare const FISH_COUNTS: Record<string, number>;
+export declare const JELLYFISH_COUNTS: Record<string, number>;
+import type { FishMood, MoodVisuals } from "../types/fish-personality-types.js";
+/**
+ * Mood decay rates (per second)
+ * Higher = faster return to calm
+ */
+export declare const MOOD_DECAY_RATES: Record<FishMood, number>;
+/**
+ * Visual modifiers for each mood
+ * Applied to rendering to express emotional state
+ */
+export declare const MOOD_VISUALS: Record<FishMood, MoodVisuals>;
+/**
+ * Mood thresholds for automatic transitions
+ */
+export declare const MOOD_THRESHOLDS: {
+    /** Energy below this triggers tired mood */
+    tiredEnergy: number;
+    /** Hunger above this triggers hungry mood */
+    hungryLevel: number;
+    /** Seconds without stimulus before mood decays */
+    boredTimeout: number;
+    /** Energy below this prevents playful mood */
+    playfulMinEnergy: number;
+};
+/**
+ * Stimulus effects on mood
+ */
+export declare const STIMULUS_EFFECTS: Record<"food" | "threat" | "friend" | "novelty", {
+    mood: FishMood;
+    energyCost: number;
+    hungerEffect: number;
+}>;
+/**
+ * Energy and hunger drift rates per second
+ */
+export declare const METABOLISM_RATES: {
+    /** Energy drain per second (base rate) */
+    energyDrain: number;
+    /** Energy drain multiplier when moving fast */
+    fastMovementDrain: number;
+    /** Hunger increase per second */
+    hungerIncrease: number;
+    /** Energy recovery when resting */
+    restRecovery: number;
+};
+//# sourceMappingURL=fish-constants.d.ts.map

package/dist/backgrounds/deep-ocean/domain/constants/fish-constants.d.ts.map

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