@grame/faustwasm 0.15.6 → 0.16.1

package/dist/esm/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/esm/index.js

@@ -219,6 +219,26 @@ var getFaustAudioWorkletProcessor = (dependencies, faustData, register = true) =
           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;
@@ -2712,7 +2732,7 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
     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;
@@ -3126,6 +3146,16 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
   stopSensors() {
     this.stopSensors();
   }
+  init() {
+  }
+  instanceInit() {
+  }
+  instanceClear() {
+  }
+  instanceConstants() {
+  }
+  instanceResetUserInterface() {
+  }
   start() {
     this.fProcessing = true;
   }
@@ -3144,6 +3174,7 @@ var FaustMonoWebAudioDsp = class extends FaustBaseWebAudioDsp {
   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);
@@ -3157,6 +3188,21 @@ var FaustMonoWebAudioDsp = class extends FaustBaseWebAudioDsp {
       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;
@@ -3306,7 +3352,6 @@ var FaustWebAudioDspVoice = class _FaustWebAudioDspVoice {
     this.fGainLabel = [];
     this.fKeyLabel = [];
     this.fVelLabel = [];
-    // Voice DSP code
     // Accessed by PolyDSPImp class
     this.fCurNote = _FaustWebAudioDspVoice.kFreeVoice;
     this.fNextNote = -1;
@@ -3315,7 +3360,8 @@ var FaustWebAudioDspVoice = class _FaustWebAudioDspVoice {
     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
@@ -3343,6 +3389,21 @@ var FaustWebAudioDspVoice = class _FaustWebAudioDspVoice {
   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")) {
@@ -3423,6 +3484,7 @@ var FaustPolyWebAudioDsp = class _FaustPolyWebAudioDsp extends FaustBaseWebAudio
   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;
@@ -3454,6 +3516,37 @@ var FaustPolyWebAudioDsp = class _FaustPolyWebAudioDsp extends FaustBaseWebAudio
       }
     }
   }
+  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);
@@ -3910,6 +4003,21 @@ var FaustOfflineProcessor = class {
   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();
   }
@@ -3973,7 +4081,7 @@ var FaustOfflineProcessor = class {
           outputs[i].set(output, l);
         }
       }
-      l += this.fBufferSize;
+      l += sliceLength;
       onUpdate == null ? void 0 : onUpdate(l);
     }
     this.fDSPCode.stop();
@@ -4522,29 +4630,12 @@ var SoundfileReader = class {
     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.
    *
@@ -4579,17 +4670,20 @@ var SoundfileReader = class {
         (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)}`
     );
   }
   /**
@@ -4967,7 +5061,10 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
   }
   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);
   }
@@ -4991,6 +5088,21 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
   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" });
   }
@@ -5087,7 +5199,7 @@ var FaustScriptProcessorNode = class extends (globalThis.ScriptProcessorNode ||
     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());
@@ -5117,6 +5229,21 @@ var FaustScriptProcessorNode = class extends (globalThis.ScriptProcessorNode ||
     };
     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() {
@@ -5334,7 +5461,7 @@ var _FaustMonoDspGenerator = class _FaustMonoDspGenerator {
         monoDsp.getNumOutputs()
       );
       Object.setPrototypeOf(sp2, FaustMonoScriptProcessorNode.prototype);
-      sp2.init(monoDsp);
+      sp2.setupNode(monoDsp);
       return sp2;
     } else {
       if (!_FaustMonoDspGenerator.gWorkletProcessors.has(context))
@@ -5718,7 +5845,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))