@grame/faustwasm 0.13.7 → 0.14.1

package/package.json

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

package/src/FaustAudioWorkletNode.ts

@@ -32,6 +32,7 @@ export class FaustAudioWorkletNode<
     protected fUICallback: UIHandler;
     protected fDescriptor: FaustUIInputItem[];
     protected fCommunicator: FaustAudioWorkletNodeCommunicator;
+    protected fParamAliases: Record<string, string>;
     #hasAccInput = false;
     #hasGyrInput = false;
 
@@ -62,6 +63,7 @@ export class FaustAudioWorkletNode<
         this.fComputeHandler = null;
         this.fPlotHandler = null;
         this.fDescriptor = [];
+        this.fParamAliases = {};
 
         // Parse UI
         this.fInputsItems = [];
@@ -76,6 +78,13 @@ export class FaustAudioWorkletNode<
                 // Keep inputs adresses
                 this.fInputsItems.push(item.address);
                 this.fDescriptor.push(item);
+                const registerAlias = (alias: string) => {
+                    if (!this.fParamAliases[alias]) {
+                        this.fParamAliases[alias] = item.address;
+                    }
+                };
+                registerAlias(item.shortname);
+                registerAlias(item.label);
                 if (!item.meta) return;
                 item.meta.forEach((meta) => {
                     const { midi, acc, gyr } = meta;
@@ -289,15 +298,16 @@ export class FaustAudioWorkletNode<
     }
 
     setParamValue(path: string, value: number) {
-        const e = { type: 'param', data: { path, value } };
-        this.port.postMessage(e);
+        const resolved = this.fParamAliases[path] || path;
+        this.port.postMessage({ type: 'param', data: { path: resolved, value } });
         // Set value on AudioParam (but this is not used on Processor side for now)
-        const param = this.parameters.get(path);
+        const param = this.parameters.get(resolved);
         if (param) param.setValueAtTime(value, this.context.currentTime);
     }
     getParamValue(path: string) {
         // Get value of AudioParam
-        const param = this.parameters.get(path);
+        const resolved = this.fParamAliases[path] || path;
+        const param = this.parameters.get(resolved);
         return param ? param.value : 0;
     }
 

package/src/FaustWebAudioDsp.ts

@@ -779,9 +779,16 @@ export class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
     protected fPathTable: { [address: string]: number } = {};
     protected fUICallback: UIHandler = (item: FaustUIItem) => {
         if (item.type === 'hbargraph' || item.type === 'vbargraph') {
+            const registerPath = (alias: string) => {
+                if (this.fPathTable[alias] === undefined) {
+                    this.fPathTable[alias] = item.index;
+                }
+            };
             // Keep bargraph adresses
             this.fOutputsItems.push(item.address);
-            this.fPathTable[item.address] = item.index;
+            registerPath(item.address);
+            registerPath(item.shortname);
+            registerPath(item.label);
         } else if (
             item.type === 'vslider' ||
             item.type === 'hslider' ||
@@ -789,9 +796,16 @@ export class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
             item.type === 'checkbox' ||
             item.type === 'nentry'
         ) {
+            const registerPath = (alias: string) => {
+                if (this.fPathTable[alias] === undefined) {
+                    this.fPathTable[alias] = item.index;
+                }
+            };
             // Keep inputs adresses
             this.fInputsItems.push(item.address);
-            this.fPathTable[item.address] = item.index;
+            registerPath(item.address);
+            registerPath(item.shortname);
+            registerPath(item.label);
             this.fDescriptor.push(item);
             if (!item.meta) return;
             item.meta.forEach((meta) => {

package/src/SoundfileReader.ts

@@ -8,13 +8,21 @@ import type {
 
 /** Read metadata and fetch soundfiles */
 class SoundfileReader {
-    // Set the fallback paths
+    /**
+     * Set fallback base URLs used to resolve soundfile paths.
+     *
+     * In Node or other non-browser runtimes, `location` may be undefined;
+     * in that case this returns an empty list to avoid resolution errors.
+     */
     static get fallbackPaths() {
-        return [
-            location.href,
-            this.getParentUrl(location.href),
-            location.origin
-        ];
+        const loc =
+            typeof location !== 'undefined' ? (location as Location) : null;
+        const href = loc?.href;
+        const origin = loc?.origin;
+        const parent = href ? this.getParentUrl(href) : null;
+        return [href, parent, origin].filter(
+            (value): value is string => typeof value === 'string' && value.length > 0
+        );
     }
 
     /**

package/src/types.ts

@@ -167,6 +167,7 @@ export interface FaustUIInputItem {
     type: FaustUIInputType;
     label: string;
     address: string;
+    shortname: string;
     url: string;
     index: number;
     init?: number;
@@ -179,6 +180,7 @@ export interface FaustUIOutputItem {
     type: FaustUIOutputType;
     label: string;
     address: string;
+    shortname: string;
     index: number;
     min?: number;
     max?: number;

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

@@ -132,6 +132,7 @@ export interface FaustUIInputItem {
 	type: FaustUIInputType;
 	label: string;
 	address: string;
+	shortname: string;
 	url: string;
 	index: number;
 	init?: number;
@@ -144,6 +145,7 @@ export interface FaustUIOutputItem {
 	type: FaustUIOutputType;
 	label: string;
 	address: string;
+	shortname: string;
 	index: number;
 	min?: number;
 	max?: number;
@@ -1321,6 +1323,12 @@ export declare class WavDecoder {
 }
 /** Read metadata and fetch soundfiles */
 export declare class SoundfileReader {
+	/**
+	 * Set fallback base URLs used to resolve soundfile paths.
+	 *
+	 * In Node or other non-browser runtimes, `location` may be undefined;
+	 * in that case this returns an empty list to avoid resolution errors.
+	 */
 	static get fallbackPaths(): string[];
 	/**
 	 * Extract the parent URL from an URL.
@@ -1394,6 +1402,7 @@ export declare class FaustAudioWorkletNode<Poly extends boolean = false> extends
 	protected fUICallback: UIHandler;
 	protected fDescriptor: FaustUIInputItem[];
 	protected fCommunicator: FaustAudioWorkletNodeCommunicator;
+	protected fParamAliases: Record<string, string>;
 	constructor(context: BaseAudioContext, name: string, factory: LooseFaustDspFactory, options?: Partial<FaustAudioWorkletNodeOptions<Poly>>);
 	protected handleMessageAux: (e: MessageEvent) => void;
 	private handleDeviceMotion;

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

@@ -2526,11 +2526,25 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
     this.fPathTable = {};
     this.fUICallback = (item) => {
       if (item.type === "hbargraph" || item.type === "vbargraph") {
+        const registerPath = (alias) => {
+          if (this.fPathTable[alias] === void 0) {
+            this.fPathTable[alias] = item.index;
+          }
+        };
         this.fOutputsItems.push(item.address);
-        this.fPathTable[item.address] = item.index;
+        registerPath(item.address);
+        registerPath(item.shortname);
+        registerPath(item.label);
       } else if (item.type === "vslider" || item.type === "hslider" || item.type === "button" || item.type === "checkbox" || item.type === "nentry") {
+        const registerPath = (alias) => {
+          if (this.fPathTable[alias] === void 0) {
+            this.fPathTable[alias] = item.index;
+          }
+        };
         this.fInputsItems.push(item.address);
-        this.fPathTable[item.address] = item.index;
+        registerPath(item.address);
+        registerPath(item.shortname);
+        registerPath(item.label);
         this.fDescriptor.push(item);
         if (!item.meta) return;
         item.meta.forEach((meta) => {
@@ -4430,13 +4444,20 @@ var WavDecoder_default = WavDecoder;
 
 // src/SoundfileReader.ts
 var SoundfileReader = class {
-  // Set the fallback paths
+  /**
+   * Set fallback base URLs used to resolve soundfile paths.
+   *
+   * In Node or other non-browser runtimes, `location` may be undefined;
+   * in that case this returns an empty list to avoid resolution errors.
+   */
   static get fallbackPaths() {
-    return [
-      location.href,
-      this.getParentUrl(location.href),
-      location.origin
-    ];
+    const loc = typeof location !== "undefined" ? location : null;
+    const href = loc == null ? void 0 : loc.href;
+    const origin = loc == null ? void 0 : loc.origin;
+    const parent = href ? this.getParentUrl(href) : null;
+    return [href, parent, origin].filter(
+      (value) => typeof value === "string" && value.length > 0
+    );
   }
   /**
    * Extract the parent URL from an URL.
@@ -4735,11 +4756,19 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
     this.fComputeHandler = null;
     this.fPlotHandler = null;
     this.fDescriptor = [];
+    this.fParamAliases = {};
     this.fInputsItems = [];
     this.fUICallback = (item) => {
       if (item.type === "vslider" || item.type === "hslider" || item.type === "button" || item.type === "checkbox" || item.type === "nentry") {
         this.fInputsItems.push(item.address);
         this.fDescriptor.push(item);
+        const registerAlias = (alias) => {
+          if (!this.fParamAliases[alias]) {
+            this.fParamAliases[alias] = item.address;
+          }
+        };
+        registerAlias(item.shortname);
+        registerAlias(item.label);
         if (!item.meta) return;
         item.meta.forEach((meta) => {
           const { midi, acc, gyr } = meta;
@@ -4894,13 +4923,14 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
     });
   }
   setParamValue(path, value) {
-    const e = { type: "param", data: { path, value } };
-    this.port.postMessage(e);
-    const param = this.parameters.get(path);
+    const resolved = this.fParamAliases[path] || path;
+    this.port.postMessage({ type: "param", data: { path: resolved, value } });
+    const param = this.parameters.get(resolved);
     if (param) param.setValueAtTime(value, this.context.currentTime);
   }
   getParamValue(path) {
-    const param = this.parameters.get(path);
+    const resolved = this.fParamAliases[path] || path;
+    const param = this.parameters.get(resolved);
     return param ? param.value : 0;
   }
   getParams() {