@joshtol/emotive-engine 3.3.2 → 3.3.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@joshtol/emotive-engine",
-  "version": "3.3.2",
+  "version": "3.3.4",
   "description": "Open-source animation engine for AI-controlled emotional visualizations with musical time synchronization",
   "main": "dist/emotive-mascot.umd.js",
   "module": "dist/mascot.js",

package/src/3d/Core3DManager.js

@@ -1878,7 +1878,10 @@ export class Core3DManager {
             calibrationRotation: this.calibrationRotation,  // Applied on top of animated rotation
             solarEclipse: this.effectManager.getSolarEclipse(),  // Pass eclipse manager for synchronized updates
             deltaTime,  // Pass deltaTime for eclipse animation
-            morphProgress: morphState.isTransitioning ? morphState.visualProgress : null  // For corona fade-in
+            morphProgress: morphState.isTransitioning ? morphState.visualProgress : null,  // For corona fade-in
+            // OPTIMIZATION FLAGS: Skip render passes when not needed
+            hasSoul: this.customMaterialType === 'crystal' && this.crystalSoul !== null,
+            hasParticles: this.particleVisibility && this.particleOrchestrator !== null
         });
 
         // Update lunar eclipse animation (Blood Moon)

package/src/3d/ThreeRenderer.js

@@ -1270,6 +1270,8 @@ export class ThreeRenderer {
      * @param {number} [params.cameraRoll=0] - Camera-space roll rotation
      * @param {SolarEclipse} [params.solarEclipse=null] - Solar eclipse manager for synchronized updates
      * @param {number} [params.deltaTime=0] - Delta time for eclipse animation (seconds)
+     * @param {boolean} [params.hasSoul=false] - Whether this geometry has a soul layer (optimization)
+     * @param {boolean} [params.hasParticles=true] - Whether particles are enabled (optimization)
      */
     render(params = {}) {
         // Guard against calls after destroy
@@ -1347,7 +1349,9 @@ export class ThreeRenderer {
             cameraRoll = 0,  // Camera-space roll rotation applied after all other rotations
             solarEclipse = null,  // Solar eclipse manager for synchronized updates
             deltaTime = 0,  // Delta time for eclipse animation
-            morphProgress = null  // Morph progress for corona fade-in (null = no morph, 0-1 = morphing)
+            morphProgress = null,  // Morph progress for corona fade-in (null = no morph, 0-1 = morphing)
+            hasSoul = false,  // Whether this geometry has a soul layer (skip soul pass if false)
+            hasParticles = true  // Whether particles are enabled (skip particle pass if false)
         } = params;
 
         // Update camera controls FIRST before any rendering
@@ -1488,7 +1492,8 @@ export class ThreeRenderer {
         // Render with post-processing if enabled, otherwise direct render
         if (this.composer) {
             // === STEP 0: Render soul (layer 2) to texture for refraction sampling ===
-            if (this.soulRenderTarget) {
+            // OPTIMIZATION: Skip soul pass entirely if geometry doesn't have a soul
+            if (this.soulRenderTarget && hasSoul) {
                 // Find soul mesh in scene (needed for screen center calculation)
                 let soulMesh = null;
                 this.scene.traverse(obj => {
@@ -1533,7 +1538,8 @@ export class ThreeRenderer {
             this.composer.render();
 
             // === STEP 2: Render particles (layer 1) to separate render target ===
-            if (this.particleRenderTarget && this.particleBloomPass) {
+            // OPTIMIZATION: Skip particle pass entirely if particles are disabled
+            if (hasParticles && this.particleRenderTarget && this.particleBloomPass) {
                 // Clear particle render target with WHITE (non-black) to prevent dark halos
                 this.renderer.setRenderTarget(this.particleRenderTarget);
                 this.renderer.setClearColor(0xffffff, 0); // White RGB, but 0 alpha
@@ -1565,7 +1571,7 @@ export class ThreeRenderer {
                 // Reset clear color
                 this.renderer.setClearColor(0x000000, 0);
                 this.renderer.setRenderTarget(null);
-            } else {
+            } else if (hasParticles) {
                 // Fallback: Render particles directly (no bloom)
                 this.camera.layers.set(1);
                 this.renderer.render(this.scene, this.camera);

package/src/3d/effects/CrystalSoul.js

@@ -95,18 +95,14 @@ const soulFragmentShader = `
 
         if (driftEnabled > 0.5) {
             float t = time * driftSpeed;
-            // Primary drift - moving in one direction
+            // OPTIMIZED: Reduced from 4 noise calls to 2 for better performance
+            // Primary drift - single noise call with combined coordinates
             float drift1 = noise3D(vPosition * 2.0 + vec3(t, t * 0.7, t * 0.3));
-            float drift2 = noise3D(vPosition * 3.0 - vec3(t * 0.5, t, t * 0.8));
-            // Use max instead of multiply to avoid near-zero products
-            primaryDrift = max(drift1, drift2);
-            primaryDrift = max(0.0, primaryDrift - 0.4) * 2.0; // Rescale after threshold
-
-            // Secondary drift - offset in opposite direction to fill gaps
-            float drift3 = noise3D(vPosition * 2.5 - vec3(t * 0.8, t * 0.4, t));
-            float drift4 = noise3D(vPosition * 1.8 + vec3(t * 0.6, t * 0.9, t * 0.2));
-            secondaryDrift = max(drift3, drift4);
-            secondaryDrift = max(0.0, secondaryDrift - 0.4) * 2.0;
+            primaryDrift = max(0.0, drift1 - 0.3) * 1.5; // Adjusted threshold for single noise
+
+            // Secondary drift - offset phase to fill gaps
+            float drift2 = noise3D(vPosition * 2.5 - vec3(t * 0.6, t * 0.4, t));
+            secondaryDrift = max(0.0, drift2 - 0.3) * 1.5;
 
             driftEnergy = primaryDrift + secondaryDrift;
         }

package/src/3d/shaders/utils/blendModes.glsl

@@ -39,7 +39,7 @@ vec3 rgbToHsl(vec3 rgb) {
     float l = (maxC + minC) / 2.0;
 
     if (delta > 0.0001) {
-        s = l < 0.5 ? delta / (maxC + minC) : delta / (2.0 - maxC - minC);
+        s = l < 0.5 ? delta / max(maxC + minC, 0.0001) : delta / max(2.0 - maxC - minC, 0.0001);
 
         // Use tolerance-based comparison instead of exact equality
         float eps = 0.0001;
@@ -135,18 +135,20 @@ vec3 applyBlendMode(vec3 base, vec3 blend, int mode) {
     } else if (mode == 2) {
         // COLOR BURN: (blend==0.0) ? 0.0 : max((1.0-((1.0-base)/blend)), 0.0)
         // Darkens base color to reflect blend color by increasing contrast
+        // Use safe division with epsilon to avoid division by zero
         return vec3(
-            blend.r == 0.0 ? 0.0 : max(1.0 - ((1.0 - base.r) / blend.r), 0.0),
-            blend.g == 0.0 ? 0.0 : max(1.0 - ((1.0 - base.g) / blend.g), 0.0),
-            blend.b == 0.0 ? 0.0 : max(1.0 - ((1.0 - base.b) / blend.b), 0.0)
+            max(1.0 - ((1.0 - base.r) / max(blend.r, 0.0001)), 0.0),
+            max(1.0 - ((1.0 - base.g) / max(blend.g, 0.0001)), 0.0),
+            max(1.0 - ((1.0 - base.b) / max(blend.b, 0.0001)), 0.0)
         );
     } else if (mode == 3) {
         // COLOR DODGE: (blend==1.0) ? 1.0 : min(base/(1.0-blend), 1.0)
         // Brightens base color to reflect blend color by decreasing contrast
+        // Use safe division with epsilon to avoid division by zero
         return vec3(
-            blend.r == 1.0 ? 1.0 : min(base.r / (1.0 - blend.r), 1.0),
-            blend.g == 1.0 ? 1.0 : min(base.g / (1.0 - blend.g), 1.0),
-            blend.b == 1.0 ? 1.0 : min(base.b / (1.0 - blend.b), 1.0)
+            min(base.r / max(1.0 - blend.r, 0.0001), 1.0),
+            min(base.g / max(1.0 - blend.g, 0.0001), 1.0),
+            min(base.b / max(1.0 - blend.b, 0.0001), 1.0)
         );
     } else if (mode == 4) {
         // SCREEN: 1 - (1 - base) * (1 - blend)
@@ -183,10 +185,11 @@ vec3 applyBlendMode(vec3 base, vec3 blend, int mode) {
     } else if (mode == 9) {
         // VIVID LIGHT: blend < 0.5 ? ColorBurn(base, 2*blend) : ColorDodge(base, 2*(blend-0.5))
         // Burns or dodges by increasing/decreasing contrast - extreme saturation boost
+        // Use safe division with epsilon to avoid division by zero
         return vec3(
-            blend.r < 0.5 ? (blend.r == 0.0 ? 0.0 : max(1.0 - ((1.0 - base.r) / (2.0 * blend.r)), 0.0)) : (blend.r == 1.0 ? 1.0 : min(base.r / (2.0 * (1.0 - blend.r)), 1.0)),
-            blend.g < 0.5 ? (blend.g == 0.0 ? 0.0 : max(1.0 - ((1.0 - base.g) / (2.0 * blend.g)), 0.0)) : (blend.g == 1.0 ? 1.0 : min(base.g / (2.0 * (1.0 - blend.g)), 1.0)),
-            blend.b < 0.5 ? (blend.b == 0.0 ? 0.0 : max(1.0 - ((1.0 - base.b) / (2.0 * blend.b)), 0.0)) : (blend.b == 1.0 ? 1.0 : min(base.b / (2.0 * (1.0 - blend.b)), 1.0))
+            blend.r < 0.5 ? max(1.0 - ((1.0 - base.r) / max(2.0 * blend.r, 0.0001)), 0.0) : min(base.r / max(2.0 * (1.0 - blend.r), 0.0001), 1.0),
+            blend.g < 0.5 ? max(1.0 - ((1.0 - base.g) / max(2.0 * blend.g, 0.0001)), 0.0) : min(base.g / max(2.0 * (1.0 - blend.g), 0.0001), 1.0),
+            blend.b < 0.5 ? max(1.0 - ((1.0 - base.b) / max(2.0 * blend.b, 0.0001)), 0.0) : min(base.b / max(2.0 * (1.0 - blend.b), 0.0001), 1.0)
         );
     } else if (mode == 10) {
         // LINEAR LIGHT: blend < 0.5 ? LinearBurn(base, 2*blend) : LinearDodge(base, 2*(blend-0.5))