@austencloud/backgrounds 0.1.0

package/dist/backgrounds/deep-ocean/domain/constants/fish-constants.js

@@ -0,0 +1,473 @@
+/**
+ * Fish Behavior & Animation Constants
+ *
+ * All magic numbers extracted and documented for maintainability.
+ * Values are tuned for a calm, ambient deep ocean aesthetic.
+ */
+/**
+ * Depth layer visual properties.
+ * Far fish appear smaller/slower (parallax effect simulating distance).
+ * Near fish are larger/faster and more prominent.
+ */
+export const DEPTH_LAYER_CONFIG = {
+    far: {
+        scale: [0.3, 0.45],
+        speedMultiplier: 0.5,
+        opacity: [0.6, 0.75],
+        verticalBand: [0.1, 0.4], // Upper background
+    },
+    mid: {
+        scale: [0.45, 0.65],
+        speedMultiplier: 0.75,
+        opacity: [0.85, 0.95],
+        verticalBand: [0.25, 0.65], // Middle
+    },
+    near: {
+        scale: [0.65, 0.85],
+        speedMultiplier: 1.0,
+        opacity: [1.0, 1.0],
+        verticalBand: [0.4, 0.85], // Foreground
+    },
+};
+/**
+ * Probability distribution for depth layer assignment.
+ * More fish in mid layer creates natural depth distribution.
+ */
+export const DEPTH_LAYER_DISTRIBUTION = {
+    /** Probability of far layer (0-25%) */
+    farThreshold: 0.25,
+    /** Probability of mid layer (25-70%) */
+    midThreshold: 0.7,
+    // near = remaining (70-100%)
+};
+// =============================================================================
+// MOVEMENT PHYSICS
+// =============================================================================
+export const FISH_MOVEMENT = {
+    /** Base horizontal speed range [min, max] in pixels per second */
+    baseSpeed: [25, 55],
+    /** Vertical drift range (pixels per second, centered at 0) */
+    verticalDrift: 4,
+    /** Bobbing animation amplitude range [min, max] in pixels */
+    bobAmplitude: [2, 5],
+    /** Bobbing animation speed range [min, max] (radians per frame at 60fps) */
+    bobSpeed: [0.008, 0.02],
+    /** Maximum spawn offset from screen edge (pixels or fraction of width) */
+    spawnOffset: { pixels: 140, fractionOfWidth: 0.2 },
+};
+/**
+ * Species-specific speed multipliers
+ * Fast fish like sleek predators swim faster than tropical fish
+ */
+export const SPECIES_SPEED_MULTIPLIERS = {
+    tropical: [0.7, 1.0], // Slower, casual swimmers
+    sleek: [1.2, 1.8], // Fast, streamlined predators
+    deep: [0.5, 0.8], // Slow, energy-conserving
+    schooling: [0.9, 1.3], // Medium speed, stay together
+};
+// =============================================================================
+// BEHAVIOR STATE MACHINE
+// =============================================================================
+export 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: [8, 20],
+    },
+    /**
+     * Turning: Fish reverses direction
+     * Triggered randomly or when approaching screen edge
+     */
+    turning: {
+        /** Fixed duration in seconds */
+        duration: 1.5,
+        /** Speed multiplier during turn (slows down) */
+        speedMultiplier: 0.3,
+        /** Maximum rotation angle in radians */
+        maxRotation: 0.3,
+    },
+    /**
+     * 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: 0.6,
+        /** Phase 1: Coil (preparatory) - body tenses before burst */
+        coilDuration: 0.05, // 50ms - body tenses
+        coilSpeedMultiplier: 0.3, // Slows down during windup
+        /** Phase 2: Burst (propulsive) - explosive acceleration */
+        burstDuration: 0.15, // 150ms - explosive acceleration
+        burstSpeedMultiplier: [4.0, 6.0], // Peak speed
+        /** Phase 3: Recovery (deceleration) - gradual slowdown */
+        recoveryDuration: 0.4, // 400ms - gradual slowdown
+        // Uses easeOutExpo curve: 1 - 2^(-10x) for natural deceleration
+        /** Legacy: kept for compatibility but not used in new 3-phase system */
+        speedMultiplier: [2.5, 4.0],
+    },
+    /**
+     * Schooling: Fish follow group leader
+     * Maintains formation while cruising
+     */
+    schooling: {
+        /** Duration range [min, max] in seconds */
+        duration: [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: [2, 4],
+        /** Speed multiplier range [min, max] - much faster than cruising */
+        speedMultiplier: [3.0, 5.0],
+        /** Body flex is reduced for streamlined appearance */
+        bodyFlexMultiplier: 0.3,
+    },
+    /**
+     * Ascending: Swimming upward with focus on vertical movement
+     * Fish browses toward the surface
+     */
+    ascending: {
+        /** Duration range [min, max] in seconds */
+        duration: [1.5, 3],
+        /** Speed multiplier (slightly slower than cruising) */
+        speedMultiplier: 0.8,
+        /** Vertical movement range [min, max] pixels per second */
+        verticalSpeed: [30, 60],
+        /** Body rotation angle range [min, max] in radians (tilted up) */
+        bodyRotation: [0.26, 0.44], // ~15-25 degrees
+    },
+    /**
+     * Descending: Swimming downward with focus on vertical movement
+     * Fish browses toward the depths
+     */
+    descending: {
+        /** Duration range [min, max] in seconds */
+        duration: [1.5, 3],
+        /** Speed multiplier (slightly slower than cruising) */
+        speedMultiplier: 0.8,
+        /** Vertical movement range [min, max] pixels per second (negative = down) */
+        verticalSpeed: [-60, -30],
+        /** Body rotation angle range [min, max] in radians (tilted down) */
+        bodyRotation: [-0.44, -0.26], // ~-25 to -15 degrees
+    },
+    /**
+     * Approaching: Swimming toward camera (z decreasing)
+     * Fish grows larger and more prominent
+     */
+    approaching: {
+        /** Duration range [min, max] in seconds - slow for smooth scaling */
+        duration: [3, 6],
+        /** Z-axis change range [min, max] - how much closer the fish gets */
+        zChange: [-0.4, -0.2],
+        /** Speed multiplier (normal horizontal movement) */
+        speedMultiplier: 1.0,
+    },
+    /**
+     * 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: [3, 6],
+        /** Z-axis change range [min, max] - how much farther the fish gets */
+        zChange: [0.2, 0.4],
+        /** Speed multiplier (normal horizontal movement) */
+        speedMultiplier: 1.0,
+    },
+};
+/**
+ * Depth transition configuration for 3D z-axis movement
+ */
+export const DEPTH_TRANSITION = {
+    /** Lerp speed for z-axis movement (per frame at 60fps) */
+    lerpSpeed: 0.015,
+    /** Minimum z value (closest to camera) */
+    minZ: 0,
+    /** Maximum z value (farthest from camera) */
+    maxZ: 1,
+    /** Scale factor: scale = 1 - (z * scaleReduction) */
+    scaleReduction: 0.6, // At z=1, fish is 40% original size
+    /** Opacity factor: opacity = 1 - (z * opacityReduction) */
+    opacityReduction: 0.25, // At z=1, fish is 75% opacity
+    /** Speed factor: speed = 1 - (z * speedReduction) */
+    speedReduction: 0.5, // At z=1, fish moves at 50% speed
+};
+/**
+ * Probability of transitioning to each behavior from cruising.
+ * Probabilities are checked in order; remaining = continue cruising.
+ */
+export const BEHAVIOR_TRANSITION_PROBABILITY = {
+    /** Chance to initiate a turn (8%) */
+    turn: 0.08,
+    /** Chance to dart/startle (4%) - checked after turn */
+    dart: 0.04,
+    /** Chance to start passing (fast straight swim) (3%) */
+    passing: 0.03,
+    /** Chance to start ascending (5%) */
+    ascending: 0.05,
+    /** Chance to start descending (5%) */
+    descending: 0.05,
+    /** Chance to approach (swim toward camera) (2%) */
+    approaching: 0.02,
+    /** Chance to recede (swim away from camera) (2%) */
+    receding: 0.02,
+    // Remaining ~71% = continue cruising
+};
+/**
+ * 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 const SPECIES_VERTICAL_PREFERENCES = {
+    tropical: {
+        preferredZone: [0.0, 0.4], // Top 40% - bright water
+        zoneAffinity: 0.35,
+        ascendingMod: 1.4,
+        descendingMod: 0.7,
+    },
+    deep: {
+        preferredZone: [0.6, 1.0], // Bottom 40% - dark abyss
+        zoneAffinity: 0.45,
+        ascendingMod: 0.6,
+        descendingMod: 1.5,
+    },
+    sleek: {
+        preferredZone: [0.3, 0.7], // Middle - predators patrol everywhere
+        zoneAffinity: 0.15,
+        ascendingMod: 1.0,
+        descendingMod: 1.0,
+    },
+    schooling: {
+        preferredZone: [0.2, 0.6], // Upper-middle - safety in numbers
+        zoneAffinity: 0.25,
+        ascendingMod: 1.1,
+        descendingMod: 0.95,
+    },
+};
+/**
+ * Species-specific behavior probability modifiers.
+ * Multipliers applied to base probabilities.
+ */
+export const SPECIES_BEHAVIOR_MODIFIERS = {
+    /** Sleek fish are more likely to pass (fast swim) */
+    sleek: {
+        passing: 1.5, // +50% chance to do fast passes
+        dart: 1.3, // +30% chance to dart
+    },
+    /** Deep fish are more likely to change depth layers */
+    deep: {
+        approaching: 2.0, // +100% chance to approach
+        receding: 2.0, // +100% chance to recede
+        ascending: 1.5,
+        descending: 1.5,
+    },
+    /** Tropical fish are more playful */
+    tropical: {
+        ascending: 1.3,
+        descending: 1.3,
+    },
+    /** Schooling fish stick to cruising */
+    schooling: {
+        passing: 0.3, // -70% less likely to break formation
+    },
+};
+/**
+ * Edge awareness thresholds.
+ * Fish are more likely to turn when approaching screen edges.
+ */
+export const EDGE_AWARENESS = {
+    /** Distance from edge (as fraction of screen width) to start considering turn */
+    warningZone: 0.15,
+    /** Multiplier for turn probability when in warning zone */
+    turnProbabilityMultiplier: 5,
+};
+// =============================================================================
+// FLOCKING (SCHOOLING) BEHAVIOR - Boids Algorithm Parameters
+// =============================================================================
+export const FLOCKING_CONFIG = {
+    /**
+     * Separation: Steer to avoid crowding nearby fish
+     */
+    separation: {
+        /** Radius within which separation force applies (pixels) */
+        radius: 50,
+        /** Strength of separation force */
+        weight: 1.5,
+    },
+    /**
+     * Alignment: Steer towards average heading of nearby fish
+     */
+    alignment: {
+        /** Radius within which alignment force applies (pixels) */
+        radius: 80,
+        /** Strength of alignment force */
+        weight: 1.0,
+    },
+    /**
+     * Cohesion: Steer towards center of mass of nearby fish
+     */
+    cohesion: {
+        /** Radius within which cohesion force applies (pixels) */
+        radius: 100,
+        /** Strength of cohesion force */
+        weight: 0.8,
+    },
+    /** Maximum steering force per frame (limits sudden turns) */
+    maxSteeringForce: 0.5,
+    /** School formation */
+    school: {
+        /** Target number of fish per school */
+        size: [2, 4],
+        /** Percentage of fish population to form into schools */
+        populationFraction: 0.35,
+    },
+};
+// =============================================================================
+// VISUAL PROPERTIES
+// =============================================================================
+export const FISH_VISUALS = {
+    /** Tail wiggle animation speed multiplier (relative to movement speed) */
+    tailWiggleSpeed: 0.15,
+    /** Maximum tail skew for wiggle effect */
+    maxTailSkew: 0.02,
+    /** Rotation response to vertical drift (tilt when swimming up/down) */
+    driftRotationFactor: 0.02,
+    /** Rotation smoothing factor (0-1, lower = smoother) */
+    rotationSmoothing: 0.1,
+};
+// =============================================================================
+// SPAWN & LIFECYCLE
+// =============================================================================
+export const SPAWN_CONFIG = {
+    /** Delay range [min, max] in seconds before respawning off-screen fish */
+    respawnDelay: [2, 8],
+    /** Buffer zone beyond screen edge before fish is considered "off-screen" */
+    offScreenBuffer: 100,
+};
+// =============================================================================
+// QUALITY-BASED COUNTS
+// =============================================================================
+export const FISH_COUNTS = {
+    minimal: 3,
+    low: 5,
+    medium: 8,
+    high: 12,
+};
+export const JELLYFISH_COUNTS = {
+    minimal: 1,
+    low: 2,
+    medium: 3,
+    high: 5,
+};
+/**
+ * Mood decay rates (per second)
+ * Higher = faster return to calm
+ */
+export const MOOD_DECAY_RATES = {
+    calm: 0, // Never decays (it's the default)
+    curious: 0.1, // 10 seconds to calm
+    alert: 0.2, // 5 seconds to calm
+    playful: 0.05, // 20 seconds to calm
+    hungry: 0.02, // 50 seconds (builds over time anyway)
+    tired: 0.015, // Very slow recovery
+    social: 0.08, // 12 seconds to calm
+};
+/**
+ * Visual modifiers for each mood
+ * Applied to rendering to express emotional state
+ */
+export const MOOD_VISUALS = {
+    calm: {
+        finFrequency: 1.0,
+        tailIntensity: 1.0,
+        glowPulse: 0.0,
+        colorSaturation: 1.0,
+    },
+    curious: {
+        finFrequency: 0.8, // Slower, careful movement
+        tailIntensity: 0.7,
+        glowPulse: 0.3, // Slight glow increase
+        colorSaturation: 1.1,
+    },
+    alert: {
+        finFrequency: 1.5, // Quick, nervous fins
+        tailIntensity: 1.3,
+        glowPulse: 0.5, // Higher glow
+        colorSaturation: 1.2,
+    },
+    playful: {
+        finFrequency: 1.3, // Energetic
+        tailIntensity: 1.2,
+        glowPulse: 0.2,
+        colorSaturation: 1.15,
+    },
+    hungry: {
+        finFrequency: 1.1,
+        tailIntensity: 1.1,
+        glowPulse: 0.1,
+        colorSaturation: 0.95, // Slightly washed out
+    },
+    tired: {
+        finFrequency: 0.5, // Slow, droopy
+        tailIntensity: 0.4,
+        glowPulse: 0.0,
+        colorSaturation: 0.85, // Desaturated
+    },
+    social: {
+        finFrequency: 1.0,
+        tailIntensity: 0.9,
+        glowPulse: 0.15,
+        colorSaturation: 1.05,
+    },
+};
+/**
+ * Mood thresholds for automatic transitions
+ */
+export const MOOD_THRESHOLDS = {
+    /** Energy below this triggers tired mood */
+    tiredEnergy: 0.25,
+    /** Hunger above this triggers hungry mood */
+    hungryLevel: 0.7,
+    /** Seconds without stimulus before mood decays */
+    boredTimeout: 30,
+    /** Energy below this prevents playful mood */
+    playfulMinEnergy: 0.4,
+};
+/**
+ * Stimulus effects on mood
+ */
+export const STIMULUS_EFFECTS = {
+    food: { mood: "hungry", energyCost: 0, hungerEffect: -0.3 },
+    threat: { mood: "alert", energyCost: 0.1, hungerEffect: 0 },
+    friend: { mood: "social", energyCost: 0, hungerEffect: 0 },
+    novelty: { mood: "curious", energyCost: 0.02, hungerEffect: 0 },
+};
+/**
+ * Energy and hunger drift rates per second
+ */
+export const METABOLISM_RATES = {
+    /** Energy drain per second (base rate) */
+    energyDrain: 0.002,
+    /** Energy drain multiplier when moving fast */
+    fastMovementDrain: 2.5,
+    /** Hunger increase per second */
+    hungerIncrease: 0.003,
+    /** Energy recovery when resting */
+    restRecovery: 0.01,
+};
+//# sourceMappingURL=fish-constants.js.map

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

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

package/dist/backgrounds/deep-ocean/domain/debug-config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Fish Debug Configuration
+ *
+ * Global toggles for isolating the fish spazzing bug.
+ * Can be modified at runtime via window.fishDebug in the console.
+ */
+export interface FishDebugConfig {
+    useSpineRendering: boolean;
+    enableWobble: boolean;
+    enableTailOscillation: boolean;
+    enablePropulsion: boolean;
+    enableFlocking: boolean;
+    enableInteractions: boolean;
+    enableRareBehaviors: boolean;
+    enableHomeZones: boolean;
+    enableHunting: boolean;
+    showHomeZones: boolean;
+    showInteractions: boolean;
+    showHunts: boolean;
+}
+export declare const fishDebugConfig: FishDebugConfig;
+//# sourceMappingURL=debug-config.d.ts.map

package/dist/backgrounds/deep-ocean/domain/debug-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-config.d.ts","sourceRoot":"","sources":["../../../../src/backgrounds/deep-ocean/domain/debug-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB;AAGD,eAAO,MAAM,eAAe,EAAE,eAa7B,CAAC"}

package/dist/backgrounds/deep-ocean/domain/debug-config.js

@@ -0,0 +1,26 @@
+/**
+ * Fish Debug Configuration
+ *
+ * Global toggles for isolating the fish spazzing bug.
+ * Can be modified at runtime via window.fishDebug in the console.
+ */
+// Global mutable debug state
+export const fishDebugConfig = {
+    useSpineRendering: true,
+    enableWobble: true,
+    enableTailOscillation: true,
+    enablePropulsion: true,
+    enableFlocking: true,
+    enableInteractions: true,
+    enableRareBehaviors: true,
+    enableHomeZones: true,
+    enableHunting: true,
+    showHomeZones: false,
+    showInteractions: false,
+    showHunts: false,
+};
+// Expose to window for console access
+if (typeof window !== 'undefined') {
+    window.fishDebugConfig = fishDebugConfig;
+}
+//# sourceMappingURL=debug-config.js.map

package/dist/backgrounds/deep-ocean/domain/debug-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-config.js","sourceRoot":"","sources":["../../../../src/backgrounds/deep-ocean/domain/debug-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,iBAAiB,EAAE,IAAI;IACvB,YAAY,EAAE,IAAI;IAClB,qBAAqB,EAAE,IAAI;IAC3B,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;IACpB,kBAAkB,EAAE,IAAI;IACxB,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;IACpB,gBAAgB,EAAE,KAAK;IACvB,SAAS,EAAE,KAAK;CACjB,CAAC;AAEF,sCAAsC;AACtC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;IACjC,MAAc,CAAC,eAAe,GAAG,eAAe,CAAC;AACpD,CAAC"}