@grame/faustwasm 0.11.3 → 0.12.1

package/assets/standalone/index-pwa.js

@@ -1,201 +1,69 @@
-// Set to > 0 if the DSP is polyphonic
-const FAUST_DSP_VOICES = 0;
-
-/**
- * @typedef {import("./faustwasm").FaustAudioWorkletNode} FaustAudioWorkletNode
- * @typedef {import("./faustwasm").FaustDspMeta} FaustDspMeta
- * @typedef {import("./faustwasm").FaustUIDescriptor} FaustUIDescriptor
- * @typedef {import("./faustwasm").FaustUIGroup} FaustUIGroup
- * @typedef {import("./faustwasm").FaustUIItem} FaustUIItem
- */
 
 /**
- * Registers the service worker.
+ * @file index-pwa.js
+ * Entry point for initializing and managing the Faust PWA instance.
+ *
+ * ## Overview
+ * This script dynamically imports {@link createFaustPWA} from `faust-pwa.js`,
+ * creates the Faust PWA controller, and manages user-activation of the
+ * Web Audio API (click/touch) as well as visibility-based suspension.
+ *
+ * ## Responsibilities
+ * - Dynamically import `createFaustPWA` (ES module)
+ * - Create the PWA instance for the selected DSP
+ * - Resume/suspend AudioContext on user interaction or page visibility changes
+ * - Activate/deactivate MIDI and sensors
+ *
+ * ## Emitted Events (from FaustPWA)
+ * - `created` — DSP and UI successfully initialized
+ * - `started` — Audio, MIDI, and sensors activated
+ * - `stopped` — Audio, MIDI, and sensors deactivated
+ * - `destroy` — Resources released
+ * - `error` — Operational error; see event.detail.error
+ *
+ * @module index-pwa
  */
-if ("serviceWorker" in navigator) {
-    window.addEventListener("load", () => {
-        navigator.serviceWorker.register("./service-worker.js")
-            .then(reg => console.log("Service Worker registered", reg))
-            .catch(err => console.log("Service Worker registration failed", err));
-    });
-}
 
-/** @type {HTMLDivElement} */
-const $divFaustUI = document.getElementById("div-faust-ui");
-
-/** @type {typeof AudioContext} */
-const AudioCtx = window.AudioContext || window.webkitAudioContext;
-const audioContext = new AudioCtx({ latencyHint: 0.00001 });
-audioContext.destination.channelInterpretation = "discrete";
-audioContext.suspend();
-
-// Declare faustNode as a global variable
-let faustNode;
+// Set to > 0 if the DSP is polyphonic
+const FAUST_DSP_VOICES = 0;
 
-// Called at load time
 (async () => {
 
-    // Import the create-node module
-    const { createFaustNode, createFaustUI } = await import("./create-node.js");
+    const { FaustPWA } = await import("./faust-pwa.js");
 
-    // To test the ScriptProcessorNode mode
-    // const result = await createFaustNode(audioContext, "FAUST_DSP_NAME", FAUST_DSP_VOICES, true, 512);
-    const result = await createFaustNode(audioContext, "FAUST_DSP_NAME", FAUST_DSP_VOICES);
-    faustNode = result.faustNode;  // Assign to the global variable
-    if (!faustNode) throw new Error("Faust DSP not compiled");
+    /** @type {HTMLDivElement} */
+    const divFaustUI = document.getElementById("div-faust-ui");
 
-    // Create the Faust UI
-    await createFaustUI($divFaustUI, faustNode);
+    // Declare faustNode as a global variable
+    const pwa = new FaustPWA({ dspName: "FAUST_DSP_NAME", voices: FAUST_DSP_VOICES, uiContainer: divFaustUI });
 
-})();
+    // Create PWA and UI
+    await pwa.create();
 
-// Synchronous function to resume AudioContext, to be called first in the synchronous event listener
-function resumeAudioContext() {
-    if (audioContext.state === 'suspended') {
-        audioContext.resume().then(() => {
-            console.log('AudioContext resumed successfully');
-        }).catch(error => {
-            console.error('Error when resuming AudioContext:', error);
-        });
-    }
-}
+    // Event listener to handle user interaction
+    function handleUserInteraction() {
 
-// Function to start MIDI
-function startMIDI() {
-    // Check if the browser supports the Web MIDI API
-    if (navigator.requestMIDIAccess) {
-        navigator.requestMIDIAccess().then(
-            midiAccess => {
-                console.log("MIDI Access obtained.");
-                for (let input of midiAccess.inputs.values()) {
-                    input.onmidimessage = (event) => faustNode.midiMessage(event.data);
-                    console.log(`Connected to input: ${input.name}`);
-                }
-            },
-            () => console.error("Failed to access MIDI devices.")
-        );
-    } else {
-        console.log("Web MIDI API is not supported in this browser.");
-    }
-}
+        // Resume AudioContext synchronously
+        pwa.resumeAudioContext();
 
-// Function to stop MIDI
-function stopMIDI() {
-    // Check if the browser supports the Web MIDI API
-    if (navigator.requestMIDIAccess) {
-        navigator.requestMIDIAccess().then(
-            midiAccess => {
-                console.log("MIDI Access obtained.");
-                for (let input of midiAccess.inputs.values()) {
-                    input.onmidimessage = null;
-                    console.log(`Disconnected from input: ${input.name}`);
-                }
-            },
-            () => console.error("Failed to access MIDI devices.")
-        );
-    } else {
-        console.log("Web MIDI API is not supported in this browser.");
+        // Activate MIDI and Sensors
+        pwa.activateMIDISensors()
     }
-}
-
-let sensorHandlersBound = false;
-let midiHandlersBound = false;
-
-// Keyboard to MIDI handing
-let keyboard2MIDI = null;
-
-async function startKeyboard2MIDI() {
-    // Import the create-node module
-    const { createKey2MIDI } = await import("./create-node.js");
 
-    keyboard2MIDI = createKey2MIDI((event) => faustNode.midiMessage(event));
-    keyboard2MIDI.start();
-}
+    // Activate AudioContext, MIDI and Sensors on user interaction
+    window.addEventListener('click', handleUserInteraction);
+    window.addEventListener('touchstart', handleUserInteraction);
 
-function stopKeyboard2MIDI() {
-    keyboard2MIDI.stop();
-    keyboard2MIDI = null;
-}
+    // Deactivate AudioContext, MIDI and Sensors on user interaction
+    window.addEventListener('visibilitychange', function () {
+        if (window.visibilityState === 'hidden') {
 
-// Function to activate MIDI and Sensors on user interaction
-async function activateMIDISensors() {
+            // Suspend AudioContext
+            pwa.suspendAudioContext();
 
-    // Import the create-node module
-    const { connectToAudioInput, requestPermissions } = await import("./create-node.js");
-
-    // Request permission for sensors
-    await requestPermissions();
-
-    // Activate sensor listeners
-    if (!sensorHandlersBound) {
-        await faustNode.startSensors();
-        sensorHandlersBound = true;
-    }
-
-    // Initialize the MIDI setup
-    if (!midiHandlersBound) {
-        startMIDI();
-        await startKeyboard2MIDI();
-        midiHandlersBound = true;
-    }
-
-    // Connect the Faust node to the audio output
-    faustNode.connect(audioContext.destination);
-
-    // Connect the Faust node to the audio input
-    if (faustNode.numberOfInputs > 0) {
-        await connectToAudioInput(audioContext, null, faustNode, null);
-    }
-
-    // Resume the AudioContext
-    if (audioContext.state === 'suspended') {
-        await audioContext.resume();
-    }
-}
-
-// Function to suspend AudioContext, deactivate MIDI and Sensors on user interaction
-async function deactivateAudioMIDISensors() {
-
-    // Suspend the AudioContext
-    if (audioContext.state === 'running') {
-        await audioContext.suspend();
-    }
-
-    // Deactivate sensor listeners
-    if (sensorHandlersBound) {
-        faustNode.stopSensors();
-        sensorHandlersBound = false;
-    }
-
-    // Deactivate the MIDI setup
-    if (midiHandlersBound && FAUST_DSP_VOICES > 0) {
-        stopMIDI();
-        stopKeyboard2MIDI();
-        midiHandlersBound = false;
-    }
-}
-
-// Event listener to handle user interaction
-function handleUserInteraction() {
-
-    // Resume AudioContext synchronously
-    resumeAudioContext();
-
-    // Launch the activation of MIDI and Sensors
-    activateMIDISensors().catch(error => {
-        console.error('Error when activating audio, MIDI and sensors:', error);
+            // Deactivate MIDI and Sensors
+            pwa.deactivateMIDISensors();
+        }
     });
-}
-
-// Activate AudioContext, MIDI and Sensors on user interaction
-window.addEventListener('click', handleUserInteraction);
-window.addEventListener('touchstart', handleUserInteraction);
-
-// Deactivate AudioContext, MIDI and Sensors on user interaction
-window.addEventListener('visibilitychange', function () {
-    if (window.visibilityState === 'hidden') {
-        deactivateAudioMIDISensors();
-    }
-});
-
 
+})();