libadlmidi-js 2.0.0 → 2.1.0

package/src/profiles/full.slim.js

@@ -1,9 +1,9 @@
 /**
  * Zero-config full (slim) profile for libADLMIDI-JS
- * 
+ *
  * Exports pre-configured AdlMidi and AdlMidiCore with this profile's WASM.
  * Slim builds require loading a WOPL bank at runtime.
- * 
+ *
  * @module profiles/full.slim
  */
 
@@ -15,6 +15,10 @@ const PROCESSOR_URL = new URL('../../dist/libadlmidi.full.slim.processor.js', im
 const WASM_URL = new URL('../../dist/libadlmidi.full.slim.core.wasm', import.meta.url).href;
 const CORE_PATH = new URL('../../dist/libadlmidi.full.slim.core.js', import.meta.url).href;
 
+// Default synth settings injected at init. NUKED_FAST is preferred when the
+// profile bundles it (bit-exact vs Nuked 1.8, roughly 1.5x faster).
+const DEFAULT_SETTINGS = { emulator: 1 };
+
 /**
  * Pre-configured AdlMidi for full slim profile.
  * 
@@ -30,15 +34,17 @@ const CORE_PATH = new URL('../../dist/libadlmidi.full.slim.core.js', import.meta
 export class AdlMidi extends BaseAdlMidi {
     /**
      * Initialize the synthesizer with this profile's WASM.
-     * 
+     *
      * @param {string} [processorUrl] - Override processor URL (optional)
      * @param {string} [wasmUrl] - Override WASM URL (optional)
+     * @param {object} [defaultSettings] - Override profile's default synth settings
      * @returns {Promise<void>}
      */
-    async init(processorUrl, wasmUrl) {
+    async init(processorUrl, wasmUrl, defaultSettings) {
         return super.init(
             processorUrl || PROCESSOR_URL,
-            wasmUrl || WASM_URL
+            wasmUrl || WASM_URL,
+            defaultSettings || DEFAULT_SETTINGS
         );
     }
 }
@@ -60,13 +66,14 @@ export class AdlMidiCore {
     /**
      * Create a new AdlMidiCore instance with this profile's WASM.
      * 
-     * @param {{corePath?: string}} [options] - Options (corePath is pre-configured)
+     * @param {{corePath?: string, defaultEmulator?: number, wasmBinary?: ArrayBuffer}} [options]
+     *   Override profile defaults. corePath and defaultEmulator are pre-configured.
      * @returns {Promise<BaseAdlMidiCore>}
      */
     static async create(options = {}) {
         return BaseAdlMidiCore.create({
             ...options,
-            corePath: options.corePath || CORE_PATH
+            corePath: options.corePath || CORE_PATH, defaultEmulator: options.defaultEmulator !== undefined ? options.defaultEmulator : 1
         });
     }
 }

package/src/profiles/light.js

@@ -1,9 +1,9 @@
 /**
  * Zero-config light profile for libADLMIDI-JS
- * 
+ *
  * Exports pre-configured AdlMidi and AdlMidiCore with this profile's WASM.
  * 
- * 
+ *
  * @module profiles/light
  */
 
@@ -15,6 +15,10 @@ const PROCESSOR_URL = new URL('../../dist/libadlmidi.light.processor.js', import
 const WASM_URL = new URL('../../dist/libadlmidi.light.core.wasm', import.meta.url).href;
 const CORE_PATH = new URL('../../dist/libadlmidi.light.core.js', import.meta.url).href;
 
+// Default synth settings injected at init. NUKED_FAST is preferred when the
+// profile bundles it (bit-exact vs Nuked 1.8, roughly 1.5x faster).
+const DEFAULT_SETTINGS = { emulator: 1 };
+
 /**
  * Pre-configured AdlMidi for light profile.
  * 
@@ -30,15 +34,17 @@ const CORE_PATH = new URL('../../dist/libadlmidi.light.core.js', import.meta.url
 export class AdlMidi extends BaseAdlMidi {
     /**
      * Initialize the synthesizer with this profile's WASM.
-     * 
+     *
      * @param {string} [processorUrl] - Override processor URL (optional)
      * @param {string} [wasmUrl] - Override WASM URL (optional)
+     * @param {object} [defaultSettings] - Override profile's default synth settings
      * @returns {Promise<void>}
      */
-    async init(processorUrl, wasmUrl) {
+    async init(processorUrl, wasmUrl, defaultSettings) {
         return super.init(
             processorUrl || PROCESSOR_URL,
-            wasmUrl || WASM_URL
+            wasmUrl || WASM_URL,
+            defaultSettings || DEFAULT_SETTINGS
         );
     }
 }
@@ -60,13 +66,14 @@ export class AdlMidiCore {
     /**
      * Create a new AdlMidiCore instance with this profile's WASM.
      * 
-     * @param {{corePath?: string}} [options] - Options (corePath is pre-configured)
+     * @param {{corePath?: string, defaultEmulator?: number, wasmBinary?: ArrayBuffer}} [options]
+     *   Override profile defaults. corePath and defaultEmulator are pre-configured.
      * @returns {Promise<BaseAdlMidiCore>}
      */
     static async create(options = {}) {
         return BaseAdlMidiCore.create({
             ...options,
-            corePath: options.corePath || CORE_PATH
+            corePath: options.corePath || CORE_PATH, defaultEmulator: options.defaultEmulator !== undefined ? options.defaultEmulator : 1
         });
     }
 }

package/src/profiles/light.slim.js

@@ -1,9 +1,9 @@
 /**
  * Zero-config light (slim) profile for libADLMIDI-JS
- * 
+ *
  * Exports pre-configured AdlMidi and AdlMidiCore with this profile's WASM.
  * Slim builds require loading a WOPL bank at runtime.
- * 
+ *
  * @module profiles/light.slim
  */
 
@@ -15,6 +15,10 @@ const PROCESSOR_URL = new URL('../../dist/libadlmidi.light.slim.processor.js', i
 const WASM_URL = new URL('../../dist/libadlmidi.light.slim.core.wasm', import.meta.url).href;
 const CORE_PATH = new URL('../../dist/libadlmidi.light.slim.core.js', import.meta.url).href;
 
+// Default synth settings injected at init. NUKED_FAST is preferred when the
+// profile bundles it (bit-exact vs Nuked 1.8, roughly 1.5x faster).
+const DEFAULT_SETTINGS = { emulator: 1 };
+
 /**
  * Pre-configured AdlMidi for light slim profile.
  * 
@@ -30,15 +34,17 @@ const CORE_PATH = new URL('../../dist/libadlmidi.light.slim.core.js', import.met
 export class AdlMidi extends BaseAdlMidi {
     /**
      * Initialize the synthesizer with this profile's WASM.
-     * 
+     *
      * @param {string} [processorUrl] - Override processor URL (optional)
      * @param {string} [wasmUrl] - Override WASM URL (optional)
+     * @param {object} [defaultSettings] - Override profile's default synth settings
      * @returns {Promise<void>}
      */
-    async init(processorUrl, wasmUrl) {
+    async init(processorUrl, wasmUrl, defaultSettings) {
         return super.init(
             processorUrl || PROCESSOR_URL,
-            wasmUrl || WASM_URL
+            wasmUrl || WASM_URL,
+            defaultSettings || DEFAULT_SETTINGS
         );
     }
 }
@@ -60,13 +66,14 @@ export class AdlMidiCore {
     /**
      * Create a new AdlMidiCore instance with this profile's WASM.
      * 
-     * @param {{corePath?: string}} [options] - Options (corePath is pre-configured)
+     * @param {{corePath?: string, defaultEmulator?: number, wasmBinary?: ArrayBuffer}} [options]
+     *   Override profile defaults. corePath and defaultEmulator are pre-configured.
      * @returns {Promise<BaseAdlMidiCore>}
      */
     static async create(options = {}) {
         return BaseAdlMidiCore.create({
             ...options,
-            corePath: options.corePath || CORE_PATH
+            corePath: options.corePath || CORE_PATH, defaultEmulator: options.defaultEmulator !== undefined ? options.defaultEmulator : 1
         });
     }
 }

package/src/profiles/nuked.js

@@ -1,9 +1,9 @@
 /**
  * Zero-config nuked profile for libADLMIDI-JS
- * 
+ *
  * Exports pre-configured AdlMidi and AdlMidiCore with this profile's WASM.
  * 
- * 
+ *
  * @module profiles/nuked
  */
 
@@ -15,6 +15,10 @@ const PROCESSOR_URL = new URL('../../dist/libadlmidi.nuked.processor.js', import
 const WASM_URL = new URL('../../dist/libadlmidi.nuked.core.wasm', import.meta.url).href;
 const CORE_PATH = new URL('../../dist/libadlmidi.nuked.core.js', import.meta.url).href;
 
+// Default synth settings injected at init. NUKED_FAST is preferred when the
+// profile bundles it (bit-exact vs Nuked 1.8, roughly 1.5x faster).
+const DEFAULT_SETTINGS = { emulator: 1 };
+
 /**
  * Pre-configured AdlMidi for nuked profile.
  * 
@@ -30,15 +34,17 @@ const CORE_PATH = new URL('../../dist/libadlmidi.nuked.core.js', import.meta.url
 export class AdlMidi extends BaseAdlMidi {
     /**
      * Initialize the synthesizer with this profile's WASM.
-     * 
+     *
      * @param {string} [processorUrl] - Override processor URL (optional)
      * @param {string} [wasmUrl] - Override WASM URL (optional)
+     * @param {object} [defaultSettings] - Override profile's default synth settings
      * @returns {Promise<void>}
      */
-    async init(processorUrl, wasmUrl) {
+    async init(processorUrl, wasmUrl, defaultSettings) {
         return super.init(
             processorUrl || PROCESSOR_URL,
-            wasmUrl || WASM_URL
+            wasmUrl || WASM_URL,
+            defaultSettings || DEFAULT_SETTINGS
         );
     }
 }
@@ -60,13 +66,14 @@ export class AdlMidiCore {
     /**
      * Create a new AdlMidiCore instance with this profile's WASM.
      * 
-     * @param {{corePath?: string}} [options] - Options (corePath is pre-configured)
+     * @param {{corePath?: string, defaultEmulator?: number, wasmBinary?: ArrayBuffer}} [options]
+     *   Override profile defaults. corePath and defaultEmulator are pre-configured.
      * @returns {Promise<BaseAdlMidiCore>}
      */
     static async create(options = {}) {
         return BaseAdlMidiCore.create({
             ...options,
-            corePath: options.corePath || CORE_PATH
+            corePath: options.corePath || CORE_PATH, defaultEmulator: options.defaultEmulator !== undefined ? options.defaultEmulator : 1
         });
     }
 }

package/src/profiles/nuked.slim.js

@@ -1,9 +1,9 @@
 /**
  * Zero-config nuked (slim) profile for libADLMIDI-JS
- * 
+ *
  * Exports pre-configured AdlMidi and AdlMidiCore with this profile's WASM.
  * Slim builds require loading a WOPL bank at runtime.
- * 
+ *
  * @module profiles/nuked.slim
  */
 
@@ -15,6 +15,10 @@ const PROCESSOR_URL = new URL('../../dist/libadlmidi.nuked.slim.processor.js', i
 const WASM_URL = new URL('../../dist/libadlmidi.nuked.slim.core.wasm', import.meta.url).href;
 const CORE_PATH = new URL('../../dist/libadlmidi.nuked.slim.core.js', import.meta.url).href;
 
+// Default synth settings injected at init. NUKED_FAST is preferred when the
+// profile bundles it (bit-exact vs Nuked 1.8, roughly 1.5x faster).
+const DEFAULT_SETTINGS = { emulator: 1 };
+
 /**
  * Pre-configured AdlMidi for nuked slim profile.
  * 
@@ -30,15 +34,17 @@ const CORE_PATH = new URL('../../dist/libadlmidi.nuked.slim.core.js', import.met
 export class AdlMidi extends BaseAdlMidi {
     /**
      * Initialize the synthesizer with this profile's WASM.
-     * 
+     *
      * @param {string} [processorUrl] - Override processor URL (optional)
      * @param {string} [wasmUrl] - Override WASM URL (optional)
+     * @param {object} [defaultSettings] - Override profile's default synth settings
      * @returns {Promise<void>}
      */
-    async init(processorUrl, wasmUrl) {
+    async init(processorUrl, wasmUrl, defaultSettings) {
         return super.init(
             processorUrl || PROCESSOR_URL,
-            wasmUrl || WASM_URL
+            wasmUrl || WASM_URL,
+            defaultSettings || DEFAULT_SETTINGS
         );
     }
 }
@@ -60,13 +66,14 @@ export class AdlMidiCore {
     /**
      * Create a new AdlMidiCore instance with this profile's WASM.
      * 
-     * @param {{corePath?: string}} [options] - Options (corePath is pre-configured)
+     * @param {{corePath?: string, defaultEmulator?: number, wasmBinary?: ArrayBuffer}} [options]
+     *   Override profile defaults. corePath and defaultEmulator are pre-configured.
      * @returns {Promise<BaseAdlMidiCore>}
      */
     static async create(options = {}) {
         return BaseAdlMidiCore.create({
             ...options,
-            corePath: options.corePath || CORE_PATH
+            corePath: options.corePath || CORE_PATH, defaultEmulator: options.defaultEmulator !== undefined ? options.defaultEmulator : 1
         });
     }
 }

package/src/utils/constants.js

@@ -12,7 +12,9 @@
 export const Emulator = Object.freeze({
     /** Nuked OPL3 v1.8 - Most accurate, higher CPU usage */
     NUKED: 0,
-    /** Nuked OPL3 v1.7.4 - Slightly older version */
+    /** Optimized Nuked 1.8 fork by tgies with identical output */
+    NUKED_FAST: 1,
+    /** @deprecated Use NUKED_FAST */
     NUKED_174: 1,
     /** DosBox OPL3 - Good accuracy, lower CPU usage */
     DOSBOX: 2,