@grame/faustwasm 0.15.6 → 0.16.1

package/dist/cjs/index.d.ts

@@ -729,6 +729,26 @@ export interface IFaustBaseWebAudioDsp {
 	 * event: Pick<DeviceOrientationEvent, "alpha" | "beta" | "gamma">
 	 */
 	propagateGyr(event: Pick<DeviceOrientationEvent, "alpha" | "beta" | "gamma">): void;
+	/**
+	 * Reinitialize the DSP using its configured sample rate.
+	 */
+	init(): void;
+	/**
+	 * Reinitialize the DSP instance state using its configured sample rate.
+	 */
+	instanceInit(): void;
+	/**
+	 * Clear the DSP instance state.
+	 */
+	instanceClear(): void;
+	/**
+	 * Reinitialize the DSP instance constants using its configured sample rate.
+	 */
+	instanceConstants(): void;
+	/**
+	 * Reset DSP user interface parameters to their default values.
+	 */
+	instanceResetUserInterface(): void;
 	/**
 	 * Start the DSP audio processing.
 	 */
@@ -903,6 +923,11 @@ export declare class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
 	hasSoundfiles(): boolean;
 	startSensors(): void;
 	stopSensors(): void;
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	start(): void;
 	stop(): void;
 	destroy(): void;
@@ -910,7 +935,13 @@ export declare class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
 export declare class FaustMonoWebAudioDsp extends FaustBaseWebAudioDsp implements IFaustMonoWebAudioDsp {
 	private fInstance;
 	private fDSP;
+	private fSampleRate;
 	constructor(instance: FaustMonoDspInstance, sampleRate: number, sampleSize: number, bufferSize: number, soundfiles: LooseFaustDspFactory["soundfiles"]);
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	private initMemory;
 	toString(): string;
 	compute(input: Float32Array[] | ((input: Float32Array[] | Float64Array[]) => any), output: Float32Array[] | ((output: Float32Array[] | Float64Array[]) => any)): boolean;
@@ -938,6 +969,7 @@ export declare class FaustWebAudioDspVoice {
 	private fVelLabel;
 	private fDSP;
 	private fAPI;
+	private fSampleRate;
 	fCurNote: number;
 	fNextNote: number;
 	fNextVel: number;
@@ -948,6 +980,11 @@ export declare class FaustWebAudioDspVoice {
 	}, sampleRate: number);
 	static midiToFreq(note: number): number;
 	static normalizeVelocity(velocity: number): number;
+	init(sampleRate: number): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	private extractPaths;
 	keyOn(pitch: number, velocity: number, legato?: boolean): void;
 	keyOff(hard?: boolean): void;
@@ -963,7 +1000,13 @@ export declare class FaustPolyWebAudioDsp extends FaustBaseWebAudioDsp implement
 	private fAudioMixing;
 	private fAudioMixingHalf;
 	private fVoiceTable;
+	private fSampleRate;
 	constructor(instance: FaustPolyDspInstance, sampleRate: number, sampleSize: number, bufferSize: number, soundfiles: LooseFaustDspFactory["soundfiles"]);
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	private initMemory;
 	toString(): string;
 	private allocVoice;
@@ -1258,6 +1301,11 @@ export declare class FaustOfflineProcessor<Poly extends boolean = false> {
 	getJSON(): string;
 	getDescriptors(): FaustUIInputItem[];
 	getUI(): FaustUIDescriptor;
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	start(): void;
 	stop(): void;
 	destroy(): void;
@@ -1378,13 +1426,6 @@ export declare class SoundfileReader {
 	 * @returns : the URLs
 	 */
 	static findSoundfilesFromMeta(dspMeta: FaustDspMeta): LooseFaustDspFactory["soundfiles"];
-	/**
-	 * Check if the file exists.
-	 *
-	 * @param url : the url of the file to check
-	 * @returns : true if the file exists, otherwise false
-	 */
-	private static checkFileExists;
 	/**
 	 * Fetch the soundfile.
 	 *
@@ -1470,6 +1511,11 @@ export declare class FaustAudioWorkletNode<Poly extends boolean = false> extends
 	getJSON(): string;
 	getUI(): FaustUIDescriptor;
 	getDescriptors(): FaustUIInputItem[];
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	start(): void;
 	stop(): void;
 	destroy(): void;
@@ -1508,7 +1554,12 @@ export declare class FaustScriptProcessorNode<Poly extends boolean = false> exte
 	protected fOutputs: Float32Array[];
 	protected handleDeviceMotion: any;
 	protected handleDeviceOrientation: any;
-	init(instance: Poly extends true ? FaustPolyWebAudioDsp : FaustMonoWebAudioDsp): void;
+	setupNode(instance: Poly extends true ? FaustPolyWebAudioDsp : FaustMonoWebAudioDsp): void;
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	/** Start accelerometer and gyroscope handlers */
 	startSensors(): Promise<void>;
 	/** Stop accelerometer and gyroscope handlers */

package/dist/cjs/index.js

@@ -248,6 +248,26 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
             this.setupWamEventHandler();
             break;
           }
+          case "init": {
+            this.fDSPCode.init();
+            break;
+          }
+          case "instanceInit": {
+            this.fDSPCode.instanceInit();
+            break;
+          }
+          case "instanceClear": {
+            this.fDSPCode.instanceClear();
+            break;
+          }
+          case "instanceConstants": {
+            this.fDSPCode.instanceConstants();
+            break;
+          }
+          case "instanceResetUserInterface": {
+            this.fDSPCode.instanceResetUserInterface();
+            break;
+          }
           case "start": {
             this.fDSPCode.start();
             break;
@@ -2741,7 +2761,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
       const trimmed = input.replace(/^\{|\}$/g, "");
       return trimmed.split(";").map(
         (str) => str.length <= 2 ? "" : str.substring(1, str.length - 1)
-      );
+      ).map((str) => str.trim()).filter((str) => str.length > 0);
     }
     get hasAccInput() {
       return this.fAcc.x.length + this.fAcc.y.length + this.fAcc.z.length > 0;
@@ -3155,6 +3175,16 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     stopSensors() {
       this.stopSensors();
     }
+    init() {
+    }
+    instanceInit() {
+    }
+    instanceClear() {
+    }
+    instanceConstants() {
+    }
+    instanceResetUserInterface() {
+    }
     start() {
       this.fProcessing = true;
     }
@@ -3173,6 +3203,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     constructor(instance, sampleRate, sampleSize, bufferSize, soundfiles) {
       super(sampleSize, bufferSize, soundfiles);
       this.fInstance = instance;
+      this.fSampleRate = sampleRate;
       console.log(`sampleSize: ${sampleSize} bufferSize: ${bufferSize}`);
       this.fJSONDsp = JSON.parse(this.fInstance.json);
       FaustBaseWebAudioDsp.parseUI(this.fJSONDsp.ui, this.fUICallback);
@@ -3186,6 +3217,21 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
         this.initSoundfileMemory(allocator, this.fDSP);
       }
     }
+    init() {
+      this.fInstance.api.init(this.fDSP, this.fSampleRate);
+    }
+    instanceInit() {
+      this.fInstance.api.instanceInit(this.fDSP, this.fSampleRate);
+    }
+    instanceClear() {
+      this.fInstance.api.instanceClear(this.fDSP);
+    }
+    instanceConstants() {
+      this.fInstance.api.instanceConstants(this.fDSP, this.fSampleRate);
+    }
+    instanceResetUserInterface() {
+      this.fInstance.api.instanceResetUserInterface(this.fDSP);
+    }
     initMemory() {
       this.fDSP = 0;
       const $audio = this.fJSONDsp.size;
@@ -3335,7 +3381,6 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
       this.fGainLabel = [];
       this.fKeyLabel = [];
       this.fVelLabel = [];
-      // Voice DSP code
       // Accessed by PolyDSPImp class
       this.fCurNote = _FaustWebAudioDspVoice.kFreeVoice;
       this.fNextNote = -1;
@@ -3344,7 +3389,8 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
       this.fLevel = 0;
       this.fDSP = $dsp;
       this.fAPI = api;
-      this.fAPI.init(this.fDSP, sampleRate);
+      this.fSampleRate = sampleRate;
+      this.init(sampleRate);
       this.extractPaths(inputItems, pathTable);
     }
     // Voice state
@@ -3372,6 +3418,21 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     static normalizeVelocity(velocity) {
       return velocity / 127;
     }
+    init(sampleRate) {
+      this.fAPI.init(this.fDSP, sampleRate);
+    }
+    instanceInit() {
+      this.fAPI.instanceInit(this.fDSP, this.fSampleRate);
+    }
+    instanceClear() {
+      this.fAPI.instanceClear(this.fDSP);
+    }
+    instanceConstants() {
+      this.fAPI.instanceConstants(this.fDSP, this.fSampleRate);
+    }
+    instanceResetUserInterface() {
+      this.fAPI.instanceResetUserInterface(this.fDSP);
+    }
     extractPaths(inputItems, pathTable) {
       inputItems.forEach((item) => {
         if (item.endsWith("/gate")) {
@@ -3452,6 +3513,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     constructor(instance, sampleRate, sampleSize, bufferSize, soundfiles) {
       super(sampleSize, bufferSize, soundfiles);
       this.fInstance = instance;
+      this.fSampleRate = sampleRate;
       console.log(`sampleSize: ${sampleSize} bufferSize: ${bufferSize}`);
       this.fJSONDsp = JSON.parse(this.fInstance.voiceJSON);
       this.fJSONEffect = this.fInstance.effectAPI && this.fInstance.effectJSON ? JSON.parse(this.fInstance.effectJSON) : null;
@@ -3483,6 +3545,37 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
         }
       }
     }
+    init() {
+      this.fVoiceTable.forEach((voice) => voice.init(this.fSampleRate));
+      if (this.fInstance.effectAPI)
+        this.fInstance.effectAPI.init(this.fEffect, this.fSampleRate);
+    }
+    instanceInit() {
+      this.fVoiceTable.forEach((voice) => voice.instanceInit());
+      if (this.fInstance.effectAPI)
+        this.fInstance.effectAPI.instanceInit(
+          this.fEffect,
+          this.fSampleRate
+        );
+    }
+    instanceClear() {
+      this.fVoiceTable.forEach((voice) => voice.instanceClear());
+      if (this.fInstance.effectAPI)
+        this.fInstance.effectAPI.instanceClear(this.fEffect);
+    }
+    instanceConstants() {
+      this.fVoiceTable.forEach((voice) => voice.instanceConstants());
+      if (this.fInstance.effectAPI)
+        this.fInstance.effectAPI.instanceConstants(
+          this.fEffect,
+          this.fSampleRate
+        );
+    }
+    instanceResetUserInterface() {
+      this.fVoiceTable.forEach((voice) => voice.instanceResetUserInterface());
+      if (this.fInstance.effectAPI)
+        this.fInstance.effectAPI.instanceResetUserInterface(this.fEffect);
+    }
     initMemory() {
       this.fEffect = this.fJSONDsp.size * this.fInstance.voices;
       const $audio = this.fEffect + (this.fJSONEffect ? this.fJSONEffect.size : 0);
@@ -3939,6 +4032,21 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     getUI() {
       return this.fDSPCode.getUI();
     }
+    init() {
+      this.fDSPCode.init();
+    }
+    instanceInit() {
+      this.fDSPCode.instanceInit();
+    }
+    instanceClear() {
+      this.fDSPCode.instanceClear();
+    }
+    instanceConstants() {
+      this.fDSPCode.instanceConstants();
+    }
+    instanceResetUserInterface() {
+      this.fDSPCode.instanceResetUserInterface();
+    }
     start() {
       this.fDSPCode.start();
     }
@@ -4002,7 +4110,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
             outputs[i].set(output, l);
           }
         }
-        l += this.fBufferSize;
+        l += sliceLength;
         onUpdate == null ? void 0 : onUpdate(l);
       }
       this.fDSPCode.stop();
@@ -4551,29 +4659,12 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
       const callback = (item) => {
         if (item.type === "soundfile") {
           const urls = FaustBaseWebAudioDsp.splitSoundfileNames(item.url);
-          urls.forEach((url) => soundfiles[url] = null);
+          urls.filter((url) => url.trim().length > 0).forEach((url) => soundfiles[url] = null);
         }
       };
       FaustBaseWebAudioDsp.parseUI(dspMeta.ui, callback);
       return soundfiles;
     }
-    /**
-     * Check if the file exists.
-     *
-     * @param url : the url of the file to check
-     * @returns : true if the file exists, otherwise false
-     */
-    static async checkFileExists(url) {
-      try {
-        console.log(`"checkFileExists" url: ${url}`);
-        const response = await fetch(url);
-        console.log(`"checkFileExists" response.ok: ${response.ok}`);
-        return response.ok;
-      } catch (error) {
-        console.error("Fetch error:", error);
-        return false;
-      }
-    }
     /**
      * Fetch the soundfile.
      *
@@ -4608,17 +4699,20 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
           (path) => new URL(filename, path.endsWith("/") ? path : `${path}/`).href
         )
       ];
-      const checkResults = await Promise.all(
-        urlsToCheck.map((url) => this.checkFileExists(url))
-      );
-      const successIndex = checkResults.findIndex((r) => !!r);
-      if (successIndex === -1)
-        throw new Error(
-          `Failed to load sound file ${filename}, all check failed.`
-        );
-      soundfiles[filename] = await this.fetchSoundfile(
-        urlsToCheck[successIndex],
-        audioCtx
+      let lastError = null;
+      for (const url of urlsToCheck) {
+        try {
+          soundfiles[filename] = await this.fetchSoundfile(
+            url,
+            audioCtx
+          );
+          return;
+        } catch (error) {
+          lastError = error;
+        }
+      }
+      throw new Error(
+        `Failed to load sound file ${filename}, all check failed. Last error: ${String(lastError)}`
       );
     }
     /**
@@ -4996,7 +5090,10 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     }
     setParamValue(path, value) {
       const resolved = this.fParamAliases[path] || path;
-      this.port.postMessage({ type: "param", data: { path: resolved, value } });
+      this.port.postMessage({
+        type: "param",
+        data: { path: resolved, value }
+      });
       const param = this.parameters.get(resolved);
       if (param) param.setValueAtTime(value, this.context.currentTime);
     }
@@ -5020,6 +5117,21 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     getDescriptors() {
       return this.fDescriptor;
     }
+    init() {
+      this.port.postMessage({ type: "init" });
+    }
+    instanceInit() {
+      this.port.postMessage({ type: "instanceInit" });
+    }
+    instanceClear() {
+      this.port.postMessage({ type: "instanceClear" });
+    }
+    instanceConstants() {
+      this.port.postMessage({ type: "instanceConstants" });
+    }
+    instanceResetUserInterface() {
+      this.port.postMessage({ type: "instanceResetUserInterface" });
+    }
     start() {
       this.port.postMessage({ type: "start" });
     }
@@ -5116,7 +5228,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
       this.handleDeviceMotion = void 0;
       this.handleDeviceOrientation = void 0;
     }
-    init(instance) {
+    setupNode(instance) {
       this.fDSPCode = instance;
       this.fInputs = new Array(this.fDSPCode.getNumInputs());
       this.fOutputs = new Array(this.fDSPCode.getNumOutputs());
@@ -5146,6 +5258,21 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
       };
       this.start();
     }
+    init() {
+      this.fDSPCode.init();
+    }
+    instanceInit() {
+      this.fDSPCode.instanceInit();
+    }
+    instanceClear() {
+      this.fDSPCode.instanceClear();
+    }
+    instanceConstants() {
+      this.fDSPCode.instanceConstants();
+    }
+    instanceResetUserInterface() {
+      this.fDSPCode.instanceResetUserInterface();
+    }
     // Public API
     /** Start accelerometer and gyroscope handlers */
     async startSensors() {
@@ -5363,7 +5490,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
           monoDsp.getNumOutputs()
         );
         Object.setPrototypeOf(sp2, FaustMonoScriptProcessorNode.prototype);
-        sp2.init(monoDsp);
+        sp2.setupNode(monoDsp);
         return sp2;
       } else {
         if (!_FaustMonoDspGenerator.gWorkletProcessors.has(context))
@@ -5747,7 +5874,7 @@ process = adaptorIns(dsp_code.process) : dsp_code.effect : adaptorOuts;
           polyDsp.getNumOutputs()
         );
         Object.setPrototypeOf(sp2, FaustPolyScriptProcessorNode.prototype);
-        sp2.init(polyDsp);
+        sp2.setupNode(polyDsp);
         return sp2;
       } else {
         if (!_FaustPolyDspGenerator.gWorkletProcessors.has(context))