libadlmidi-js 2.0.0 → 2.1.0

package/dist/libadlmidi.nuked.slim.processor.js

@@ -2900,6 +2900,8 @@ var _AdlMidiProcessor = class _AdlMidiProcessor extends AudioWorkletProcessor {
       // Deep vibrato
       deepTremolo: false,
       // Deep tremolo
+      emulator: void 0,
+      // Emulator core (undefined = libADLMIDI default)
       ...options.processorOptions?.settings
     };
     this.initWasm(options.processorOptions);
@@ -2941,6 +2943,9 @@ var _AdlMidiProcessor = class _AdlMidiProcessor extends AudioWorkletProcessor {
    */
   applySettings(settings) {
     if (!this.midi) return;
+    if (settings.emulator !== void 0) {
+      this.adl._adl_switchEmulator(this.midi, settings.emulator);
+    }
     if (settings.numChips !== void 0) {
       this.adl._adl_setNumChips(this.midi, settings.numChips);
     }

package/dist/profiles/dosbox.d.ts

@@ -16,9 +16,10 @@ export class AdlMidi extends BaseAdlMidi {
      *
      * @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>}
      */
-    init(processorUrl?: string, wasmUrl?: string): Promise<void>;
+    init(processorUrl?: string, wasmUrl?: string, defaultSettings?: object): Promise<void>;
 }
 /**
  * Pre-configured AdlMidiCore for dosbox profile.
@@ -37,11 +38,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 create(options?: {
         corePath?: string;
+        defaultEmulator?: number;
+        wasmBinary?: ArrayBuffer;
     }): Promise<BaseAdlMidiCore>;
 }
 import { AdlMidi as BaseAdlMidi } from '../libadlmidi.js';

package/dist/profiles/dosbox.slim.d.ts

@@ -16,9 +16,10 @@ export class AdlMidi extends BaseAdlMidi {
      *
      * @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>}
      */
-    init(processorUrl?: string, wasmUrl?: string): Promise<void>;
+    init(processorUrl?: string, wasmUrl?: string, defaultSettings?: object): Promise<void>;
 }
 /**
  * Pre-configured AdlMidiCore for dosbox slim profile.
@@ -37,11 +38,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 create(options?: {
         corePath?: string;
+        defaultEmulator?: number;
+        wasmBinary?: ArrayBuffer;
     }): Promise<BaseAdlMidiCore>;
 }
 import { AdlMidi as BaseAdlMidi } from '../libadlmidi.js';

package/dist/profiles/full.d.ts

@@ -16,9 +16,10 @@ export class AdlMidi extends BaseAdlMidi {
      *
      * @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>}
      */
-    init(processorUrl?: string, wasmUrl?: string): Promise<void>;
+    init(processorUrl?: string, wasmUrl?: string, defaultSettings?: object): Promise<void>;
 }
 /**
  * Pre-configured AdlMidiCore for full profile.
@@ -37,11 +38,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 create(options?: {
         corePath?: string;
+        defaultEmulator?: number;
+        wasmBinary?: ArrayBuffer;
     }): Promise<BaseAdlMidiCore>;
 }
 import { AdlMidi as BaseAdlMidi } from '../libadlmidi.js';

package/dist/profiles/full.slim.d.ts

@@ -16,9 +16,10 @@ export class AdlMidi extends BaseAdlMidi {
      *
      * @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>}
      */
-    init(processorUrl?: string, wasmUrl?: string): Promise<void>;
+    init(processorUrl?: string, wasmUrl?: string, defaultSettings?: object): Promise<void>;
 }
 /**
  * Pre-configured AdlMidiCore for full slim profile.
@@ -37,11 +38,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 create(options?: {
         corePath?: string;
+        defaultEmulator?: number;
+        wasmBinary?: ArrayBuffer;
     }): Promise<BaseAdlMidiCore>;
 }
 import { AdlMidi as BaseAdlMidi } from '../libadlmidi.js';

package/dist/profiles/light.d.ts

@@ -16,9 +16,10 @@ export class AdlMidi extends BaseAdlMidi {
      *
      * @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>}
      */
-    init(processorUrl?: string, wasmUrl?: string): Promise<void>;
+    init(processorUrl?: string, wasmUrl?: string, defaultSettings?: object): Promise<void>;
 }
 /**
  * Pre-configured AdlMidiCore for light profile.
@@ -37,11 +38,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 create(options?: {
         corePath?: string;
+        defaultEmulator?: number;
+        wasmBinary?: ArrayBuffer;
     }): Promise<BaseAdlMidiCore>;
 }
 import { AdlMidi as BaseAdlMidi } from '../libadlmidi.js';

package/dist/profiles/light.slim.d.ts

@@ -16,9 +16,10 @@ export class AdlMidi extends BaseAdlMidi {
      *
      * @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>}
      */
-    init(processorUrl?: string, wasmUrl?: string): Promise<void>;
+    init(processorUrl?: string, wasmUrl?: string, defaultSettings?: object): Promise<void>;
 }
 /**
  * Pre-configured AdlMidiCore for light slim profile.
@@ -37,11 +38,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 create(options?: {
         corePath?: string;
+        defaultEmulator?: number;
+        wasmBinary?: ArrayBuffer;
     }): Promise<BaseAdlMidiCore>;
 }
 import { AdlMidi as BaseAdlMidi } from '../libadlmidi.js';

package/dist/profiles/nuked.d.ts

@@ -16,9 +16,10 @@ export class AdlMidi extends BaseAdlMidi {
      *
      * @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>}
      */
-    init(processorUrl?: string, wasmUrl?: string): Promise<void>;
+    init(processorUrl?: string, wasmUrl?: string, defaultSettings?: object): Promise<void>;
 }
 /**
  * Pre-configured AdlMidiCore for nuked profile.
@@ -37,11 +38,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 create(options?: {
         corePath?: string;
+        defaultEmulator?: number;
+        wasmBinary?: ArrayBuffer;
     }): Promise<BaseAdlMidiCore>;
 }
 import { AdlMidi as BaseAdlMidi } from '../libadlmidi.js';

package/dist/profiles/nuked.slim.d.ts

@@ -16,9 +16,10 @@ export class AdlMidi extends BaseAdlMidi {
      *
      * @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>}
      */
-    init(processorUrl?: string, wasmUrl?: string): Promise<void>;
+    init(processorUrl?: string, wasmUrl?: string, defaultSettings?: object): Promise<void>;
 }
 /**
  * Pre-configured AdlMidiCore for nuked slim profile.
@@ -37,11 +38,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 create(options?: {
         corePath?: string;
+        defaultEmulator?: number;
+        wasmBinary?: ArrayBuffer;
     }): Promise<BaseAdlMidiCore>;
 }
 import { AdlMidi as BaseAdlMidi } from '../libadlmidi.js';

package/dist/utils/constants.d.ts

@@ -17,7 +17,9 @@ export type Emulator = number;
 export const Emulator: Readonly<{
     /** 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;

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "libadlmidi-js",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "libadlmidi": {
     "version": "1.6.2",
-    "commit": "89284b0b63e236ccaf84ac2763574738840d37b4"
+    "commit": "6528dafce641e81ded5d62809445267b82dc0d8d"
   },
   "description": "WebAssembly build of libADLMIDI - OPL3/FM synthesis for the browser",
   "main": "dist/libadlmidi.js",
@@ -11,35 +11,43 @@
   "exports": {
     ".": "./dist/libadlmidi.js",
     "./core": {
-      "import": "./src/core.js",
-      "types": "./dist/core.d.ts"
+      "types": "./dist/core.d.ts",
+      "import": "./src/core.js"
     },
     "./structs": {
-      "import": "./src/utils/struct.js",
-      "types": "./dist/utils/struct.d.ts"
+      "types": "./dist/utils/struct.d.ts",
+      "import": "./src/utils/struct.js"
     },
     "./nuked": {
+      "types": "./dist/profiles/nuked.d.ts",
       "import": "./src/profiles/nuked.js"
     },
     "./nuked/slim": {
+      "types": "./dist/profiles/nuked.slim.d.ts",
       "import": "./src/profiles/nuked.slim.js"
     },
     "./dosbox": {
+      "types": "./dist/profiles/dosbox.d.ts",
       "import": "./src/profiles/dosbox.js"
     },
     "./dosbox/slim": {
+      "types": "./dist/profiles/dosbox.slim.d.ts",
       "import": "./src/profiles/dosbox.slim.js"
     },
     "./light": {
+      "types": "./dist/profiles/light.d.ts",
       "import": "./src/profiles/light.js"
     },
     "./light/slim": {
+      "types": "./dist/profiles/light.slim.d.ts",
       "import": "./src/profiles/light.slim.js"
     },
     "./full": {
+      "types": "./dist/profiles/full.d.ts",
       "import": "./src/profiles/full.js"
     },
     "./full/slim": {
+      "types": "./dist/profiles/full.slim.d.ts",
       "import": "./src/profiles/full.slim.js"
     },
     "./dist/*": "./dist/*"
@@ -66,7 +74,10 @@
     "lint:fix": "eslint . --fix",
     "check": "npm run lint && npm run typecheck && npm run sync-version -- --check",
     "sync-version": "node scripts/sync-libadlmidi-version.js",
-    "prepare": "command -v pre-commit >/dev/null && pre-commit install || echo 'pre-commit not found, run: pipx install pre-commit'"
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "*.js": "eslint --fix"
   },
   "types": "dist/libadlmidi.d.ts",
   "keywords": [
@@ -86,15 +97,22 @@
     "url": "https://github.com/libadlmidi-js/libadlmidi-js.git"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@commitlint/cli": "^21.0.1",
+    "@commitlint/config-conventional": "^21.0.1",
+    "@emnapi/core": "1.10.0",
+    "@emnapi/runtime": "1.10.0",
     "@eslint/js": "^10.0.1",
     "@playwright/test": "^1.57.0",
     "@types/node": "^25.0.3",
     "esbuild": "^0.27.2",
     "eslint": "^10.0.3",
     "globals": "^17.4.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.5",
     "playwright": "^1.57.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.16"
+    "vitest": "^4.1.5"
   },
   "files": [
     "dist/",
@@ -109,5 +127,8 @@
     "light-slim.js",
     "full-slim.js",
     "README.md"
-  ]
+  ],
+  "overrides": {
+    "fflate": "0.8.2"
+  }
 }

package/src/core.js

@@ -51,6 +51,8 @@ export class AdlMidiCore {
      * @param {Object} options
      * @param {string} options.corePath - Path to the .core.js WASM loader module
      * @param {ArrayBuffer} [options.wasmBinary] - Pre-loaded WASM binary (optional)
+     * @param {number} [options.defaultEmulator] - Emulator to switch to after init.
+     *                            Profile wrappers use this to default to NUKED_FAST.
      * @returns {Promise<AdlMidiCore>}
      */
     static async create(options) {
@@ -73,6 +75,7 @@ export class AdlMidiCore {
         core._sampleRate = 44100;
         core._audioBuffer = null;
         core._audioBufferPtr = null;
+        core._defaultEmulator = options.defaultEmulator;
 
         return core;
     }
@@ -88,6 +91,8 @@ export class AdlMidiCore {
         this._audioBuffer = null;
         /** @private @type {number|null} */
         this._audioBufferPtr = null;
+        /** @private @type {number|undefined} */
+        this._defaultEmulator = undefined;
     }
 
     /**
@@ -108,6 +113,10 @@ export class AdlMidiCore {
             throw new Error('Failed to initialize ADL MIDI player');
         }
 
+        if (this._defaultEmulator !== undefined) {
+            this._module._adl_switchEmulator(this._player, this._defaultEmulator);
+        }
+
         return true;
     }
 

package/src/libadlmidi.js

@@ -114,9 +114,11 @@ export class AdlMidi {
      * @param {string} processorUrl - URL to the bundled processor JavaScript file
      * @param {string | null} [wasmUrl=null] - Optional URL to the .wasm file for split builds.
      *                             If not provided, assumes bundled version with embedded WASM.
+     * @param {object} [defaultSettings={}] - Initial synth settings applied before ready.
+     *                             Profile wrappers use this to set a default emulator.
      * @returns {Promise<void>}
      */
-    async init(processorUrl, wasmUrl = null) {
+    async init(processorUrl, wasmUrl = null, defaultSettings = {}) {
         if (!this.ctx) {
             this.ctx = new AudioContext({ sampleRate: 44100 });
         }
@@ -143,7 +145,8 @@ export class AdlMidi {
         this.node = new AudioWorkletNode(this.ctx, 'adl-midi-processor', {
             processorOptions: {
                 sampleRate: this.ctx.sampleRate,
-                wasmBinary: wasmBinary  // null for bundled, ArrayBuffer for split
+                wasmBinary: wasmBinary,  // null for bundled, ArrayBuffer for split
+                settings: defaultSettings
             }
         });
 

package/src/processor.js

@@ -45,6 +45,7 @@ class AdlMidiProcessor extends AudioWorkletProcessor {
             softPan: true,            // Soft stereo panning
             deepVibrato: false,       // Deep vibrato
             deepTremolo: false,       // Deep tremolo
+            emulator: undefined,      // Emulator core (undefined = libADLMIDI default)
             ...options.processorOptions?.settings
         };
 
@@ -104,6 +105,11 @@ class AdlMidiProcessor extends AudioWorkletProcessor {
     applySettings(settings) {
         if (!this.midi) return;
 
+        // Switch emulator first; adl_switchEmulator does a partialReset and a
+        // wrong-order subsequent setBank etc. would otherwise need re-applying.
+        if (settings.emulator !== undefined) {
+            this.adl._adl_switchEmulator(this.midi, settings.emulator);
+        }
         if (settings.numChips !== undefined) {
             this.adl._adl_setNumChips(this.midi, settings.numChips);
         }

package/src/profiles/dosbox.js

@@ -1,9 +1,9 @@
 /**
  * Zero-config dosbox profile for libADLMIDI-JS
- * 
+ *
  * Exports pre-configured AdlMidi and AdlMidiCore with this profile's WASM.
  * 
- * 
+ *
  * @module profiles/dosbox
  */
 
@@ -15,6 +15,10 @@ const PROCESSOR_URL = new URL('../../dist/libadlmidi.dosbox.processor.js', impor
 const WASM_URL = new URL('../../dist/libadlmidi.dosbox.core.wasm', import.meta.url).href;
 const CORE_PATH = new URL('../../dist/libadlmidi.dosbox.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 = {};
+
 /**
  * Pre-configured AdlMidi for dosbox profile.
  * 
@@ -30,15 +34,17 @@ const CORE_PATH = new URL('../../dist/libadlmidi.dosbox.core.js', import.meta.ur
 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,7 +66,8 @@ 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 = {}) {

package/src/profiles/dosbox.slim.js

@@ -1,9 +1,9 @@
 /**
  * Zero-config dosbox (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/dosbox.slim
  */
 
@@ -15,6 +15,10 @@ const PROCESSOR_URL = new URL('../../dist/libadlmidi.dosbox.slim.processor.js',
 const WASM_URL = new URL('../../dist/libadlmidi.dosbox.slim.core.wasm', import.meta.url).href;
 const CORE_PATH = new URL('../../dist/libadlmidi.dosbox.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 = {};
+
 /**
  * Pre-configured AdlMidi for dosbox slim profile.
  * 
@@ -30,15 +34,17 @@ const CORE_PATH = new URL('../../dist/libadlmidi.dosbox.slim.core.js', import.me
 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,7 +66,8 @@ 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 = {}) {

package/src/profiles/full.js

@@ -1,9 +1,9 @@
 /**
  * Zero-config full profile for libADLMIDI-JS
- * 
+ *
  * Exports pre-configured AdlMidi and AdlMidiCore with this profile's WASM.
  * 
- * 
+ *
  * @module profiles/full
  */
 
@@ -15,6 +15,10 @@ const PROCESSOR_URL = new URL('../../dist/libadlmidi.full.processor.js', import.
 const WASM_URL = new URL('../../dist/libadlmidi.full.core.wasm', import.meta.url).href;
 const CORE_PATH = new URL('../../dist/libadlmidi.full.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 profile.
  * 
@@ -30,15 +34,17 @@ const CORE_PATH = new URL('../../dist/libadlmidi.full.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
         });
     }
 }