@grame/faustwasm 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grame/faustwasm",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "WebAssembly version of Faust Compiler",
   "main": "dist/cjs/index.js",
   "types": "dist/esm/index.d.ts",

package/src/FaustDspGenerator.ts

@@ -7,10 +7,24 @@ import { FaustMonoOfflineProcessor, FaustPolyOfflineProcessor, IFaustMonoOffline
 import { FaustMonoScriptProcessorNode, FaustPolyScriptProcessorNode } from "./FaustScriptProcessorNode";
 import { FaustBaseWebAudioDsp, FaustMonoWebAudioDsp, FaustPolyWebAudioDsp, FaustWebAudioDspVoice, IFaustMonoWebAudioNode, IFaustPolyWebAudioNode, Soundfile, WasmAllocator } from "./FaustWebAudioDsp";
 import type { IFaustCompiler } from "./FaustCompiler";
-import type { FaustDspFactory, FaustUIDescriptor, FaustDspMeta, FFTUtils, LooseFaustDspFactory } from "./types";
+import type { FaustDspFactory, FaustUIDescriptor, FaustDspMeta, FFTUtils, LooseFaustDspFactory, AudioData } from "./types";
 import SoundfileReader from "./SoundfileReader";
 
-export interface IFaustMonoDspGenerator {
+export interface GeneratorSupportingSoundfiles {
+    /**
+     * Attach a map of id - audio data, call after `compile()` before `createNode()`
+     * 
+     * @param soundfileMap a map of id - `AudioData` as an object where `AudioData` contains channel data as `audioBuffer: Float32Array[]` and `sampleRate: number`
+     */
+    addSoundfiles(soundfileMap: Record<string, AudioData>): void;
+
+    /**
+     * Get a list of soundfiles needed, call after `compile()`
+     */
+    getSoundfileList(): string[];
+}
+
+export interface IFaustMonoDspGenerator extends GeneratorSupportingSoundfiles {
     /**
      * Compile a monophonic DSP factory from given code.
      * 
@@ -26,6 +40,7 @@ export interface IFaustMonoDspGenerator {
         meta?: FaustDspMeta;
     } | null>;
 
+
     /**
      * Create a monophonic WebAudio node (either ScriptProcessorNode or AudioWorkletNode).
      *
@@ -102,7 +117,7 @@ export interface IFaustMonoDspGenerator {
     getUI(): FaustUIDescriptor;
 }
 
-export interface IFaustPolyDspGenerator {
+export interface IFaustPolyDspGenerator extends GeneratorSupportingSoundfiles {
     /**
      * Compile a monophonic DSP factory from given code.
      * 
@@ -205,6 +220,19 @@ export class FaustMonoDspGenerator implements IFaustMonoDspGenerator {
         }
     }
 
+    addSoundfiles(soundfileMap: Record<string, AudioData>) {
+        if (!this.factory) throw new Error("Code is not compiled, please define the factory or call `await this.compile()` first.");
+        for (const id in soundfileMap) {
+            this.factory.soundfiles[id] = soundfileMap[id];
+        }
+    }
+    getSoundfileList() {
+        if (!this.factory) throw new Error("Code is not compiled, please define the factory or call `await this.compile()` first.");
+        const meta = JSON.parse(this.factory.json);
+        const map = SoundfileReader.findSoundfilesFromMeta(meta);
+        return Object.keys(map);
+    }
+
     async createNode<SP extends boolean = false>(
         context: BaseAudioContext,
         name = this.name,
@@ -507,6 +535,22 @@ process = adaptorIns(dsp_code.process) : dsp_code.effect : adaptorOuts;
         }
     }
 
+    addSoundfiles(soundfileMap: Record<string, AudioData>) {
+        if (!this.voiceFactory) throw new Error("Code is not compiled, please define the factory or call `await this.compile()` first.");
+        for (const id in soundfileMap) {
+            this.voiceFactory.soundfiles[id] = soundfileMap[id];
+        }
+    }
+    getSoundfileList() {
+        if (!this.voiceFactory) throw new Error("Code is not compiled, please define the factory or call `await this.compile()` first.");
+        const meta = JSON.parse(this.voiceFactory.json);
+        const map = SoundfileReader.findSoundfilesFromMeta(meta);
+        if (!this.effectFactory) return Object.keys(map);
+        const effectMeta = JSON.parse(this.effectFactory.json);
+        const effectMap = SoundfileReader.findSoundfilesFromMeta(effectMeta);
+        return Object.keys({ ...effectMap, ...map });
+    }
+
     async createNode<SP extends boolean = false>(
         context: BaseAudioContext,
         voices: number,

package/src/SoundfileReader.ts

@@ -3,7 +3,7 @@ import type { AudioData, FaustDspMeta, FaustUIItem, LooseFaustDspFactory } from
 
 /** Read metadata and fetch soundfiles */
 class SoundfileReader {
-    static get fallbackPaths() { return [location.href, location.origin, "http://127.0.0.1:8000"]; }
+    static get fallbackPaths() { return [location.href, location.origin]; }
 
     /**
      * Convert an audio buffer to audio data.
@@ -25,7 +25,7 @@ class SoundfileReader {
      * @param dspMeta : the metadata
      * @returns : the URLs
      */
-    private static findSoundfilesFromMeta(dspMeta: FaustDspMeta): LooseFaustDspFactory["soundfiles"] {
+    static findSoundfilesFromMeta(dspMeta: FaustDspMeta): LooseFaustDspFactory["soundfiles"] {
         const soundfiles: LooseFaustDspFactory["soundfiles"] = {};
         const callback = (item: FaustUIItem) => {
             if (item.type === "soundfile") {

package/test/faustlive-wasm/faustwasm/index.d.ts

@@ -1196,7 +1196,7 @@ export declare class SoundfileReader {
 	 * @param dspMeta : the metadata
 	 * @returns : the URLs
 	 */
-	private static findSoundfilesFromMeta;
+	static findSoundfilesFromMeta(dspMeta: FaustDspMeta): LooseFaustDspFactory["soundfiles"];
 	/**
 	 * Check if the file exists.
 	 *
@@ -1336,7 +1336,19 @@ export declare class FaustPolyScriptProcessorNode extends FaustScriptProcessorNo
 	keyOff(channel: number, pitch: number, velocity: number): void;
 	allNotesOff(hard: boolean): void;
 }
-export interface IFaustMonoDspGenerator {
+export interface GeneratorSupportingSoundfiles {
+	/**
+	 * Attach a map of id - audio data, call after `compile()` before `createNode()`
+	 *
+	 * @param soundfileMap a map of id - `AudioData` as an object where `AudioData` contains channel data as `audioBuffer: Float32Array[]` and `sampleRate: number`
+	 */
+	addSoundfiles(soundfileMap: Record<string, AudioData>): void;
+	/**
+	 * Get a list of soundfiles needed, call after `compile()`
+	 */
+	getSoundfileList(): string[];
+}
+export interface IFaustMonoDspGenerator extends GeneratorSupportingSoundfiles {
 	/**
 	 * Compile a monophonic DSP factory from given code.
 	 *
@@ -1403,7 +1415,7 @@ export interface IFaustMonoDspGenerator {
 	 */
 	getUI(): FaustUIDescriptor;
 }
-export interface IFaustPolyDspGenerator {
+export interface IFaustPolyDspGenerator extends GeneratorSupportingSoundfiles {
 	/**
 	 * Compile a monophonic DSP factory from given code.
 	 *
@@ -1468,6 +1480,8 @@ export declare class FaustMonoDspGenerator implements IFaustMonoDspGenerator {
 	factory: FaustDspFactory | null;
 	constructor();
 	compile(compiler: IFaustCompiler, name: string, code: string, args: string): Promise<this | null>;
+	addSoundfiles(soundfileMap: Record<string, AudioData>): void;
+	getSoundfileList(): string[];
 	createNode<SP extends boolean = false>(context: BaseAudioContext, name?: string, factory?: LooseFaustDspFactory, sp?: SP, bufferSize?: number, processorName?: string): Promise<SP extends true ? FaustMonoScriptProcessorNode | null : FaustMonoAudioWorkletNode | null>;
 	createFFTNode(context: BaseAudioContext, fftUtils: typeof FFTUtils, name?: string, factory?: LooseFaustDspFactory, fftOptions?: Partial<FaustFFTOptionsData>, processorName?: string): Promise<FaustMonoAudioWorkletNode | null>;
 	createAudioWorkletProcessor(name?: string, factory?: LooseFaustDspFactory, processorName?: string): Promise<{
@@ -1489,6 +1503,8 @@ export declare class FaustPolyDspGenerator implements IFaustPolyDspGenerator {
 	mixerModule: WebAssembly.Module;
 	constructor();
 	compile(compiler: IFaustCompiler, name: string, dspCodeAux: string, args: string, effectCodeAux?: string): Promise<this | null>;
+	addSoundfiles(soundfileMap: Record<string, AudioData>): void;
+	getSoundfileList(): string[];
 	createNode<SP extends boolean = false>(context: BaseAudioContext, voices: number, name?: string, voiceFactory?: LooseFaustDspFactory, mixerModule?: WebAssembly.Module, effectFactory?: LooseFaustDspFactory | null, sp?: SP, bufferSize?: number, processorName?: string): Promise<SP extends true ? FaustPolyScriptProcessorNode | null : FaustPolyAudioWorkletNode | null>;
 	createAudioWorkletProcessor(name?: string, voiceFactory?: LooseFaustDspFactory, effectFactory?: LooseFaustDspFactory | null, processorName?: string): Promise<{
 		new (options: AudioWorkletNodeOptions): AudioWorkletProcessor;

package/test/faustlive-wasm/faustwasm/index.js

@@ -3111,7 +3111,7 @@ var WavDecoder_default = WavDecoder;
 // src/SoundfileReader.ts
 var SoundfileReader = class {
   static get fallbackPaths() {
-    return [location.href, location.origin, "http://127.0.0.1:8000"];
+    return [location.href, location.origin];
   }
   /**
    * Convert an audio buffer to audio data.
@@ -3544,6 +3544,20 @@ var _FaustMonoDspGenerator = class _FaustMonoDspGenerator {
       return null;
     }
   }
+  addSoundfiles(soundfileMap) {
+    if (!this.factory)
+      throw new Error("Code is not compiled, please define the factory or call `await this.compile()` first.");
+    for (const id in soundfileMap) {
+      this.factory.soundfiles[id] = soundfileMap[id];
+    }
+  }
+  getSoundfileList() {
+    if (!this.factory)
+      throw new Error("Code is not compiled, please define the factory or call `await this.compile()` first.");
+    const meta = JSON.parse(this.factory.json);
+    const map = SoundfileReader_default.findSoundfilesFromMeta(meta);
+    return Object.keys(map);
+  }
   async createNode(context, name = this.name, factory = this.factory, sp = false, bufferSize = 1024, processorName = (factory == null ? void 0 : factory.shaKey) || name) {
     var _a, _b;
     if (!factory)
@@ -3796,6 +3810,24 @@ process = adaptorIns(dsp_code.process) : dsp_code.effect : adaptorOuts;
       return null;
     }
   }
+  addSoundfiles(soundfileMap) {
+    if (!this.voiceFactory)
+      throw new Error("Code is not compiled, please define the factory or call `await this.compile()` first.");
+    for (const id in soundfileMap) {
+      this.voiceFactory.soundfiles[id] = soundfileMap[id];
+    }
+  }
+  getSoundfileList() {
+    if (!this.voiceFactory)
+      throw new Error("Code is not compiled, please define the factory or call `await this.compile()` first.");
+    const meta = JSON.parse(this.voiceFactory.json);
+    const map = SoundfileReader_default.findSoundfilesFromMeta(meta);
+    if (!this.effectFactory)
+      return Object.keys(map);
+    const effectMeta = JSON.parse(this.effectFactory.json);
+    const effectMap = SoundfileReader_default.findSoundfilesFromMeta(effectMeta);
+    return Object.keys({ ...effectMap, ...map });
+  }
   async createNode(context, voices, name = this.name, voiceFactory = this.voiceFactory, mixerModule = this.mixerModule, effectFactory = this.effectFactory, sp = false, bufferSize = 1024, processorName = ((voiceFactory == null ? void 0 : voiceFactory.shaKey) || "") + ((effectFactory == null ? void 0 : effectFactory.shaKey) || "") || `${name}_poly`) {
     var _a, _b;
     if (!voiceFactory)