littlejsengine 1.19.3 → 1.20.0

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "littlejsengine",
-  "version": "1.19.3",
+  "version": "1.20.0",
   "description": "LittleJS - Tiny and Fast HTML5 Game Engine",
   "main": "dist/littlejs.esm.js",
   "types": "dist/littlejs.d.ts",
   "exports": {
-    "types": "./dist/littlejs.d.ts",
-    "production": "./dist/littlejs.esm.min.js",
-    "default": "./dist/littlejs.esm.js"
+    ".": {
+      "types": "./dist/littlejs.d.ts",
+      "production": "./dist/littlejs.esm.min.js",
+      "default": "./dist/littlejs.esm.js"
+    },
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
   },
   "repository": {
     "type": "git",
@@ -33,6 +37,7 @@
     "dist/",
     "src/",
     "plugins/",
+    "!plugins/box2d.wasm.*",
     "COPYRIGHT.txt",
     "FAQ.md"
   ],
@@ -43,7 +48,7 @@
     "test": "node --test --import ./test/setup.mjs \"test/**/*.test.mjs\""
   },
   "engines": {
-    "node": ">=18"
+    "node": "^20.19.0 || >=22.12.0"
   },
   "devDependencies": {
     "bestzip": "^2.2.1",

package/plugins/audioEffects.js

@@ -10,23 +10,7 @@
 'use strict';
 
 ///////////////////////////////////////////////////////////////////////////////
-
-// ramp an audio param to a value, cancelling anything already scheduled so stacked calls don't fight
-function audioParamRamp(param, value, fadeTime=0)
-{
-    ASSERT(fadeTime >= 0, 'fadeTime must be positive or zero');
-    const startTime = audioContext.currentTime;
-    param.cancelScheduledValues(startTime);
-    if (fadeTime)
-    {
-        param.setValueAtTime(param.value, startTime);
-        param.linearRampToValueAtTime(value, startTime + fadeTime);
-    }
-    else
-        param.value = value;
-}
-
-///////////////////////////////////////////////////////////////////////////////
+// audioParamRamp lives in engineAudio.js, core loads before plugins in the bundle
 /**
  * Base class for audio effects, an input and output with a wet/dry mix between them
  * - Sounds connect to input, output goes to the master gain until connect() moves it
@@ -44,6 +28,10 @@ class AudioEffect
     {
         ASSERT(isNumber(mix), 'mix must be a number');
 
+        /** @property {number} - Wet/dry balance, 0 is fully dry and 1 is fully wet */
+        this.mix = clamp(mix);
+        if (!audioContext) return; // no audio outside a browser, where the engine runs headless
+
         /** @property {GainNode} - Connect sounds to this node */
         this.input = audioContext.createGain();
         /** @property {GainNode} - This node carries the mixed result, send it somewhere with connect(), never by assigning here
@@ -53,8 +41,6 @@ class AudioEffect
         this.dryGain = audioContext.createGain();
         /** @property {GainNode} - Level of the processed signal */
         this.wetGain = audioContext.createGain();
-        /** @property {number} - Wet/dry balance, 0 is fully dry and 1 is fully wet */
-        this.mix = mix;
 
         this.input.connect(this.dryGain).connect(this.output);
         this.wetGain.connect(this.output);
@@ -71,6 +57,7 @@ class AudioEffect
     {
         ASSERT(isNumber(mix), 'mix must be a number');
         this.mix = mix = clamp(mix);
+        if (!audioContext) return;
         this.rampParam(this.dryGain.gain, 1-mix, fadeTime);
         this.rampParam(this.wetGain.gain, mix, fadeTime);
     }
@@ -94,10 +81,13 @@ class AudioEffect
     }
 
     /** Send this effect's output into another effect or audio node instead of the speakers
-     *  @param {AudioEffect|AudioNode} target - The next effect in the chain, or any audio node
-     *  @return {AudioEffect|AudioNode} - The target, so chains read left to right */
+     *  @template {AudioEffect|AudioNode} T
+     *  @param {T} target - The next effect in the chain, or any audio node
+     *  @return {T} - The target, so chains read left to right */
     connect(target)
     {
+        if (!audioContext) return target; // no audio outside a browser, where the engine runs headless
+
         // an effect stands in for its input node, the same rule as sound.output
         const node = /** @type {AudioNode} */ (target && 'input' in target ? target.input : target);
         ASSERT(node && typeof node.connect === 'function', 'target must be an AudioEffect or AudioNode');
@@ -107,7 +97,7 @@ class AudioEffect
     }
 
     /** Stop sending this effect's output anywhere */
-    disconnect() { this.output.disconnect(); }
+    disconnect() { this.output?.disconnect(); }
 
     /** Wire nodes between the input and the wet gain, for subclasses
      *  @param {AudioNode} first - Node the input connects to
@@ -142,6 +132,7 @@ class AudioFilter extends AudioEffect
         super(mix);
         ASSERT(isNumber(frequency) && frequency >= 0, 'frequency must be positive or zero');
         ASSERT(isNumber(q), 'q must be a number');
+        if (!audioContext) return; // no audio outside a browser, where the engine runs headless
 
         /** @property {BiquadFilterNode} - The filter node */
         this.node = audioContext.createBiquadFilter();
@@ -157,6 +148,7 @@ class AudioFilter extends AudioEffect
     setFrequency(frequency, fadeTime=0)
     {
         ASSERT(isNumber(frequency) && frequency >= 0, 'frequency must be positive or zero');
+        if (!audioContext) return;
         this.rampParam(this.node.frequency, frequency, fadeTime);
     }
 
@@ -166,6 +158,7 @@ class AudioFilter extends AudioEffect
     setQ(q, fadeTime=0)
     {
         ASSERT(isNumber(q), 'q must be a number');
+        if (!audioContext) return;
         this.rampParam(this.node.Q, q, fadeTime);
     }
 }
@@ -189,6 +182,7 @@ class AudioReverb extends AudioEffect
     constructor(duration=2, decay=2, mix=.5)
     {
         super(mix);
+        if (!audioContext) return; // no audio outside a browser, where the engine runs headless
 
         /** @property {ConvolverNode} - The convolver node */
         this.node = audioContext.createConvolver();
@@ -203,6 +197,7 @@ class AudioReverb extends AudioEffect
     {
         ASSERT(isNumber(duration) && duration > 0, 'duration must be positive');
         ASSERT(isNumber(decay) && decay > 0, 'decay must be positive');
+        if (!audioContext) return;
         this.node.buffer = this.createImpulse(duration, decay);
     }
 
@@ -243,6 +238,7 @@ class AudioDelay extends AudioEffect
     constructor(time=.3, feedback=.4, mix=.5)
     {
         super(mix);
+        if (!audioContext) return; // no audio outside a browser, where the engine runs headless
 
         /** @property {DelayNode} - The delay node */
         this.node = audioContext.createDelay(5);
@@ -261,6 +257,7 @@ class AudioDelay extends AudioEffect
     setTime(time, fadeTime=0)
     {
         ASSERT(isNumber(time) && time >= 0 && time <= 5, 'time must be between 0 and 5');
+        if (!audioContext) return;
         this.rampParam(this.node.delayTime, time, fadeTime);
     }
 
@@ -270,6 +267,7 @@ class AudioDelay extends AudioEffect
     setFeedback(feedback, fadeTime=0)
     {
         ASSERT(isNumber(feedback), 'feedback must be a number');
+        if (!audioContext) return;
         this.rampParam(this.feedbackGain.gain, clamp(feedback, 0, .95), fadeTime);
     }
 }
@@ -292,11 +290,13 @@ class AudioDistortion extends AudioEffect
     {
         super(mix);
 
+        /** @property {number} - How hard the signal is driven, 0 is clean and 1 is crushed */
+        this.amount = clamp(amount);
+        if (!audioContext) return; // no audio outside a browser, where the engine runs headless
+
         /** @property {WaveShaperNode} - The wave shaper node */
         this.node = audioContext.createWaveShaper();
         this.node.oversample = '2x';
-        /** @property {number} - How hard the signal is driven, 0 is clean and 1 is crushed */
-        this.amount = amount;
         this.setAmount(amount);
         this.connectEffect(this.node);
     }
@@ -307,6 +307,7 @@ class AudioDistortion extends AudioEffect
     {
         ASSERT(isNumber(amount), 'amount must be a number');
         this.amount = amount = clamp(amount);
+        if (!audioContext) return;
 
         // soft clip curve, drive grows with the square of amount so low values stay subtle
         // enough points that quiet signals are still shaped at high drive, where the curve is steep near 0
@@ -343,6 +344,7 @@ class AudioCompressor extends AudioEffect
         super(mix);
         ASSERT(isNumber(threshold), 'threshold must be a number');
         ASSERT(isNumber(ratio) && ratio >= 1, 'ratio must be 1 or more');
+        if (!audioContext) return; // no audio outside a browser, where the engine runs headless
 
         /** @property {DynamicsCompressorNode} - The compressor node */
         this.node = audioContext.createDynamicsCompressor();
@@ -357,6 +359,7 @@ class AudioCompressor extends AudioEffect
     setThreshold(threshold, fadeTime=0)
     {
         ASSERT(isNumber(threshold), 'threshold must be a number');
+        if (!audioContext) return;
         this.rampParam(this.node.threshold, threshold, fadeTime);
     }
 
@@ -366,6 +369,7 @@ class AudioCompressor extends AudioEffect
     setRatio(ratio, fadeTime=0)
     {
         ASSERT(isNumber(ratio) && ratio >= 1, 'ratio must be 1 or more');
+        if (!audioContext) return;
         this.rampParam(this.node.ratio, ratio, fadeTime);
     }
 }