libadlmidi-js 1.0.0

package/dist/libadlmidi.js

@@ -0,0 +1,445 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+// src/libadlmidi.js
+var Emulator = Object.freeze({
+  /** Nuked OPL3 v1.8 - Most accurate, higher CPU usage */
+  NUKED: 0,
+  /** Nuked OPL3 v1.7.4 - Slightly older version */
+  NUKED_174: 1,
+  /** DosBox OPL3 - Good accuracy, lower CPU usage */
+  DOSBOX: 2,
+  /** Opal - Reality Adlib Tracker emulator */
+  OPAL: 3,
+  /** Java OPL3 - Port of emu8950 */
+  JAVA: 4,
+  /** ESFMu - ESFM chip emulator */
+  ESFMU: 5,
+  /** MAME OPL2 */
+  MAME_OPL2: 6,
+  /** YMFM OPL2 */
+  YMFM_OPL2: 7,
+  /** YMFM OPL3 */
+  YMFM_OPL3: 8,
+  /** Nuked OPL2 LLE - Transistor-level emulation */
+  NUKED_OPL2_LLE: 9,
+  /** Nuked OPL3 LLE - Transistor-level emulation */
+  NUKED_OPL3_LLE: 10
+});
+var _ready, _messageHandlers, _AdlMidi_instances, handleMessage_fn, onceMessage_fn, send_fn;
+var AdlMidi = class {
+  /**
+   * Create a new AdlMidi instance
+   * @param {AudioContext} [context] - Optional AudioContext to use. Creates one if not provided.
+   */
+  constructor(context) {
+    __privateAdd(this, _AdlMidi_instances);
+    /** @type {boolean} */
+    __privateAdd(this, _ready, false);
+    /** @type {Map<string, Set<Function>>} */
+    __privateAdd(this, _messageHandlers, /* @__PURE__ */ new Map());
+    this.ctx = context || null;
+    this.node = null;
+  }
+  /**
+   * Get the AudioContext (may be null before init)
+   * @returns {AudioContext | null}
+   */
+  get audioContext() {
+    return this.ctx;
+  }
+  /**
+   * Check if the synth is ready
+   * @returns {boolean}
+   */
+  get ready() {
+    return __privateGet(this, _ready);
+  }
+  /**
+   * Initialize the synthesizer
+   * @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.
+   * @returns {Promise<void>}
+   */
+  async init(processorUrl, wasmUrl = null) {
+    if (!this.ctx) {
+      this.ctx = new AudioContext({ sampleRate: 44100 });
+    }
+    if (this.ctx.state === "suspended") {
+      await this.ctx.resume();
+    }
+    let wasmBinary = null;
+    const effectiveWasmUrl = wasmUrl || processorUrl.replace(".processor.js", ".core.wasm");
+    const response = await fetch(effectiveWasmUrl);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch WASM: ${response.status}`);
+    }
+    wasmBinary = await response.arrayBuffer();
+    await this.ctx.audioWorklet.addModule(processorUrl);
+    this.node = new AudioWorkletNode(this.ctx, "adl-midi-processor", {
+      processorOptions: {
+        sampleRate: this.ctx.sampleRate,
+        wasmBinary
+        // null for bundled, ArrayBuffer for split
+      }
+    });
+    this.node.connect(this.ctx.destination);
+    this.node.port.onmessage = (e) => __privateMethod(this, _AdlMidi_instances, handleMessage_fn).call(this, e.data);
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(new Error("Timeout waiting for WASM initialization"));
+      }, 1e4);
+      __privateMethod(this, _AdlMidi_instances, onceMessage_fn).call(this, "ready", () => {
+        clearTimeout(timeout);
+        __privateSet(this, _ready, true);
+        resolve();
+      });
+      __privateMethod(this, _AdlMidi_instances, onceMessage_fn).call(
+        this,
+        "error",
+        /** @param {{message: string}} msg */
+        (msg) => {
+          clearTimeout(timeout);
+          reject(new Error(msg.message));
+        }
+      );
+    });
+  }
+  /**
+   * Play a note
+   * @param {number} channel - MIDI channel (0-15)
+   * @param {number} note - MIDI note number (0-127)
+   * @param {number} velocity - Note velocity (0-127)
+   */
+  noteOn(channel, note, velocity) {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "noteOn", channel, note, velocity });
+  }
+  /**
+   * Stop a note
+   * @param {number} channel - MIDI channel (0-15)
+   * @param {number} note - MIDI note number (0-127)
+   */
+  noteOff(channel, note) {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "noteOff", channel, note });
+  }
+  /**
+   * Set pitch bend
+   * @param {number} channel - MIDI channel (0-15)
+   * @param {number} value - Pitch bend value (0-16383, 8192 = center)
+   */
+  pitchBend(channel, value) {
+    const lsb = value & 127;
+    const msb = value >> 7 & 127;
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "pitchBend", channel, lsb, msb });
+  }
+  /**
+   * Send a control change
+   * @param {number} channel - MIDI channel (0-15)
+   * @param {number} controller - Controller number (0-127)
+   * @param {number} value - Controller value (0-127)
+   */
+  controlChange(channel, controller, value) {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "controlChange", channel, controller, value });
+  }
+  /**
+   * Change program (instrument)
+   * @param {number} channel - MIDI channel (0-15)
+   * @param {number} program - Program number (0-127)
+   */
+  programChange(channel, program) {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "programChange", channel, program });
+  }
+  /**
+   * Reset the real-time state (stops all notes, resets controllers)
+   * @returns {void}
+   */
+  resetState() {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "resetState" });
+  }
+  /**
+   * Panic - stop all sounds immediately
+   * @returns {void}
+   */
+  panic() {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "panic" });
+  }
+  /**
+   * Configure synth settings at runtime
+   * @param {ConfigureSettings} settings - Settings object
+   * @returns {Promise<void>}
+   */
+  async configure(settings) {
+    return new Promise((resolve) => {
+      __privateMethod(this, _AdlMidi_instances, onceMessage_fn).call(this, "configured", () => resolve());
+      __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "configure", settings });
+    });
+  }
+  /**
+   * Load a custom bank file (WOPL format)
+   * @param {ArrayBuffer} arrayBuffer - Bank file data
+   * @returns {Promise<void>}
+   */
+  async loadBank(arrayBuffer) {
+    return new Promise((resolve, reject) => {
+      __privateMethod(this, _AdlMidi_instances, onceMessage_fn).call(
+        this,
+        "bankLoaded",
+        /** @param {{success: boolean, error?: string}} msg */
+        (msg) => {
+          if (msg.success) {
+            resolve();
+          } else {
+            reject(new Error(msg.error || "Failed to load bank"));
+          }
+        }
+      );
+      __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "loadBank", data: arrayBuffer });
+    });
+  }
+  /**
+   * Set the embedded bank by number
+   * @param {number} bank - Bank number
+   * @returns {Promise<void>}
+   */
+  async setBank(bank) {
+    return new Promise((resolve, reject) => {
+      __privateMethod(this, _AdlMidi_instances, onceMessage_fn).call(
+        this,
+        "bankSet",
+        /** @param {{success: boolean}} msg */
+        (msg) => {
+          if (msg.success) {
+            resolve();
+          } else {
+            reject(new Error(`Failed to set bank ${bank}`));
+          }
+        }
+      );
+      __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "setBank", bank });
+    });
+  }
+  /**
+   * Get an instrument from a bank for editing
+   * @param {BankId} [bankId] - Bank identifier
+   * @param {number} [programNumber] - Program/instrument number (0-127)
+   * @returns {Promise<Instrument>} Instrument object with named properties
+   */
+  async getInstrument(bankId = { percussive: false, msb: 0, lsb: 0 }, programNumber = 0) {
+    return new Promise((resolve, reject) => {
+      __privateMethod(this, _AdlMidi_instances, onceMessage_fn).call(
+        this,
+        "instrumentLoaded",
+        /** @param {{success: boolean, instrument: Instrument, error?: string}} msg */
+        (msg) => {
+          if (msg.success) {
+            resolve(msg.instrument);
+          } else {
+            reject(new Error(msg.error || "Failed to get instrument"));
+          }
+        }
+      );
+      __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "getInstrument", bankId, programNumber });
+    });
+  }
+  /**
+   * Set an instrument in a bank
+   * @param {BankId} bankId - Bank identifier
+   * @param {number} programNumber - Program/instrument number (0-127)
+   * @param {Instrument} instrument - Instrument object with operator parameters
+   * @returns {Promise<void>}
+   */
+  async setInstrument(bankId = { percussive: false, msb: 0, lsb: 0 }, programNumber, instrument) {
+    return new Promise((resolve, reject) => {
+      __privateMethod(this, _AdlMidi_instances, onceMessage_fn).call(
+        this,
+        "instrumentSet",
+        /** @param {{success: boolean, error?: string}} msg */
+        (msg) => {
+          if (msg.success) {
+            resolve();
+          } else {
+            reject(new Error(msg.error || "Failed to set instrument"));
+          }
+        }
+      );
+      __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "setInstrument", bankId, programNumber, instrument });
+    });
+  }
+  /**
+   * Set the number of emulated OPL3 chips
+   * @param {number} chips - Number of chips (1-100)
+   */
+  setNumChips(chips) {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "setNumChips", chips });
+  }
+  /**
+   * Set the volume model
+   * @param {number} model - Volume model number
+   */
+  setVolumeModel(model) {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "setVolumeModel", model });
+  }
+  /**
+   * Enable/disable rhythm mode (percussion)
+   * @param {boolean} enabled
+   */
+  setPercussionMode(enabled) {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "setPercMode", enabled });
+  }
+  /**
+   * Enable/disable deep vibrato
+   * @param {boolean} enabled
+   */
+  setVibrato(enabled) {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "setVibrato", enabled });
+  }
+  /**
+   * Enable/disable deep tremolo
+   * @param {boolean} enabled
+   */
+  setTremolo(enabled) {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "setTremolo", enabled });
+  }
+  /**
+   * Switch the OPL3 emulator core at runtime
+   * 
+   * Only emulators compiled into the current build profile are available:
+   * - nuked profile: NUKED only
+   * - dosbox profile: DOSBOX only  
+   * - light profile: NUKED, DOSBOX
+   * - full profile: NUKED, DOSBOX, OPAL, JAVA, ESFMU, YMFM_OPL2, YMFM_OPL3
+   * 
+   * @param {number} emulator - Emulator ID from the Emulator enum
+   * @returns {Promise<void>} Resolves when emulator is switched, rejects if unavailable
+   * @example
+   * import { AdlMidi, Emulator } from 'libadlmidi-js';
+   * await synth.switchEmulator(Emulator.DOSBOX);
+   */
+  async switchEmulator(emulator) {
+    return new Promise((resolve, reject) => {
+      __privateMethod(this, _AdlMidi_instances, onceMessage_fn).call(
+        this,
+        "emulatorSwitched",
+        /** @param {{success: boolean, emulator: number}} msg */
+        (msg) => {
+          if (msg.success) {
+            resolve();
+          } else {
+            reject(new Error(`Failed to switch to emulator ${emulator}. It may not be available in this build profile.`));
+          }
+        }
+      );
+      __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "switchEmulator", emulator });
+    });
+  }
+  /**
+   * Get the name of the currently active OPL3 emulator
+   * @returns {Promise<string>} Human-readable emulator name (e.g., "Nuked OPL3 (v 1.8)")
+   * @example
+   * const name = await synth.getEmulatorName();
+   * console.log(`Using: ${name}`);
+   */
+  async getEmulatorName() {
+    return new Promise((resolve) => {
+      __privateMethod(this, _AdlMidi_instances, onceMessage_fn).call(
+        this,
+        "emulatorName",
+        /** @param {{name: string}} msg */
+        (msg) => {
+          resolve(msg.name);
+        }
+      );
+      __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "getEmulatorName" });
+    });
+  }
+  /**
+   * Reset the synthesizer
+   * @returns {void}
+   */
+  reset() {
+    __privateMethod(this, _AdlMidi_instances, send_fn).call(this, { type: "reset" });
+  }
+  /**
+   * Close the synthesizer and release resources
+   * @returns {void}
+   */
+  close() {
+    if (this.node) {
+      this.node.disconnect();
+      this.node = null;
+    }
+    this._ready = false;
+  }
+  /**
+   * Suspend the AudioContext (save CPU when not in use)
+   * @returns {Promise<void>}
+   */
+  async suspend() {
+    if (this.ctx) {
+      await this.ctx.suspend();
+    }
+  }
+  /**
+   * Resume the AudioContext
+   * @returns {Promise<void>}
+   */
+  async resume() {
+    if (this.ctx) {
+      await this.ctx.resume();
+    }
+  }
+};
+_ready = new WeakMap();
+_messageHandlers = new WeakMap();
+_AdlMidi_instances = new WeakSet();
+/**
+ * Internal message handler
+ * @param {{type: string}} msg - Message from processor
+ */
+handleMessage_fn = function(msg) {
+  const handlers = __privateGet(this, _messageHandlers).get(msg.type);
+  if (handlers) {
+    handlers.forEach(
+      /** @param {Function} handler */
+      (handler) => handler(msg)
+    );
+  }
+};
+/**
+ * Register a one-time message handler
+ * @param {string} type - Message type
+ * @param {Function} handler - Handler function
+ */
+onceMessage_fn = function(type, handler) {
+  if (!__privateGet(this, _messageHandlers).has(type)) {
+    __privateGet(this, _messageHandlers).set(type, /* @__PURE__ */ new Set());
+  }
+  const wrappedHandler = (msg) => {
+    __privateGet(this, _messageHandlers).get(type)?.delete(wrappedHandler);
+    handler(msg);
+  };
+  __privateGet(this, _messageHandlers).get(type)?.add(wrappedHandler);
+};
+/**
+ * Send a message to the processor
+ * @param {Object} msg - Message to send
+ */
+send_fn = function(msg) {
+  if (this.node) {
+    this.node.port.postMessage(msg);
+  }
+};
+var libadlmidi_default = AdlMidi;
+export {
+  AdlMidi,
+  Emulator,
+  libadlmidi_default as default
+};
+//# sourceMappingURL=libadlmidi.js.map

package/dist/libadlmidi.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/libadlmidi.js"],
+  "sourcesContent": ["/**\n * libADLMIDI-JS - Main Thread Interface\n * \n * High-level API for real-time OPL3 FM synthesis in the browser.\n * \n * @example\n * ```javascript\n * import { AdlMidi } from 'libadlmidi-js';\n * \n * const synth = new AdlMidi();\n * await synth.init('/path/to/processor.js');\n * \n * synth.noteOn(0, 60, 100);  // Middle C on channel 0\n * synth.noteOff(0, 60);\n * ```\n */\n\n/**\n * Bank identifier for instrument access\n * @typedef {Object} BankId\n * @property {boolean} percussive - True for percussion bank, false for melodic\n * @property {number} msb - Bank MSB (0-127)\n * @property {number} lsb - Bank LSB (0-127)\n */\n\n/**\n * OPL3 operator parameters  \n * @typedef {Object} Operator\n * @property {boolean} am - Amplitude modulation (tremolo)\n * @property {boolean} vibrato - Vibrato (frequency modulation)\n * @property {boolean} sustaining - Sustaining (EG type)\n * @property {boolean} ksr - Key scale rate\n * @property {number} freqMult - Frequency multiplier (0-15)\n * @property {number} keyScaleLevel - Key scale level (0-3)\n * @property {number} totalLevel - Total level / attenuation (0-63, 0 = loudest)\n * @property {number} attack - Attack rate (0-15)\n * @property {number} decay - Decay rate (0-15)\n * @property {number} sustain - Sustain level (0-15, 0 = loudest)\n * @property {number} release - Release rate (0-15)\n * @property {number} waveform - Waveform select (0-7)\n */\n\n/**\n * Complete OPL3 instrument definition\n * @typedef {Object} Instrument\n * @property {boolean} is4op - 4-operator mode enabled\n * @property {boolean} isPseudo4op - Pseudo 4-op (two 2-op voices)\n * @property {boolean} isBlank - Blank/unused instrument\n * @property {boolean} isRhythmModeCar - Rhythm mode carrier flag\n * @property {boolean} isRhythmModeMod - Rhythm mode modulator flag\n * @property {number} feedback1 - Voice 1 feedback (0-7)\n * @property {number} connection1 - Voice 1 connection (0 = FM, 1 = additive)\n * @property {number} feedback2 - Voice 2 feedback (0-7, 4-op only)\n * @property {number} connection2 - Voice 2 connection (0 = FM, 1 = additive, 4-op only)\n * @property {number} noteOffset1 - Note offset for voice 1 (semitones)\n * @property {number} noteOffset2 - Note offset for voice 2 (semitones)\n * @property {number} velocityOffset - Velocity offset\n * @property {number} secondVoiceDetune - Second voice detune (cents)\n * @property {number} percussionNote - Percussion note number\n * @property {number} delayOnMs - Delay before note-on (ms)\n * @property {number} delayOffMs - Delay before note-off (ms)\n * @property {[Operator, Operator, Operator, Operator]} operators - Four operators\n */\n\n/**\n * Configuration settings for the synthesizer\n * @typedef {Object} ConfigureSettings\n * @property {number} [numChips] - Number of emulated OPL3 chips (1-100)\n * @property {number} [numFourOpChannels] - Number of 4-op channels (-1 = auto)\n * @property {number} [bank] - Embedded bank number\n * @property {boolean} [softPan] - Enable soft stereo panning\n * @property {boolean} [deepVibrato] - Enable deep vibrato\n * @property {boolean} [deepTremolo] - Enable deep tremolo\n */\n\n/**\n * Available OPL3 emulator cores.\n * Use with switchEmulator() to change the synthesis engine at runtime.\n * Note: Only emulators compiled into the current profile are available.\n * @readonly\n * @enum {number}\n */\nexport const Emulator = Object.freeze({\n    /** Nuked OPL3 v1.8 - Most accurate, higher CPU usage */\n    NUKED: 0,\n    /** Nuked OPL3 v1.7.4 - Slightly older version */\n    NUKED_174: 1,\n    /** DosBox OPL3 - Good accuracy, lower CPU usage */\n    DOSBOX: 2,\n    /** Opal - Reality Adlib Tracker emulator */\n    OPAL: 3,\n    /** Java OPL3 - Port of emu8950 */\n    JAVA: 4,\n    /** ESFMu - ESFM chip emulator */\n    ESFMU: 5,\n    /** MAME OPL2 */\n    MAME_OPL2: 6,\n    /** YMFM OPL2 */\n    YMFM_OPL2: 7,\n    /** YMFM OPL3 */\n    YMFM_OPL3: 8,\n    /** Nuked OPL2 LLE - Transistor-level emulation */\n    NUKED_OPL2_LLE: 9,\n    /** Nuked OPL3 LLE - Transistor-level emulation */\n    NUKED_OPL3_LLE: 10,\n});\n\nexport class AdlMidi {\n    /** @type {boolean} */\n    #ready = false;\n    /** @type {Map<string, Set<Function>>} */\n    #messageHandlers = new Map();\n\n    /**\n     * Create a new AdlMidi instance\n     * @param {AudioContext} [context] - Optional AudioContext to use. Creates one if not provided.\n     */\n    constructor(context) {\n        this.ctx = context || null;\n        this.node = null;\n    }\n\n    /**\n     * Get the AudioContext (may be null before init)\n     * @returns {AudioContext | null}\n     */\n    get audioContext() {\n        return this.ctx;\n    }\n\n    /**\n     * Check if the synth is ready\n     * @returns {boolean}\n     */\n    get ready() {\n        return this.#ready;\n    }\n\n    /**\n     * Initialize the synthesizer\n     * @param {string} processorUrl - URL to the bundled processor JavaScript file\n     * @param {string | null} [wasmUrl=null] - Optional URL to the .wasm file for split builds.\n     *                             If not provided, assumes bundled version with embedded WASM.\n     * @returns {Promise<void>}\n     */\n    async init(processorUrl, wasmUrl = null) {\n        if (!this.ctx) {\n            this.ctx = new AudioContext({ sampleRate: 44100 });\n        }\n\n        // Resume AudioContext if suspended (browser autoplay policy)\n        if (this.ctx.state === 'suspended') {\n            await this.ctx.resume();\n        }\n\n        // For split builds, fetch the WASM binary from main thread\n        // (AudioWorklet doesn't have fetch access)\n        // If wasmUrl not provided, derive it from processorUrl\n        let wasmBinary = null;\n        const effectiveWasmUrl = wasmUrl || processorUrl.replace('.processor.js', '.core.wasm');\n        const response = await fetch(effectiveWasmUrl);\n        if (!response.ok) {\n            throw new Error(`Failed to fetch WASM: ${response.status}`);\n        }\n        wasmBinary = await response.arrayBuffer();\n\n        // Add the AudioWorklet module\n        await this.ctx.audioWorklet.addModule(processorUrl);\n\n        // Create the AudioWorkletNode\n        this.node = new AudioWorkletNode(this.ctx, 'adl-midi-processor', {\n            processorOptions: {\n                sampleRate: this.ctx.sampleRate,\n                wasmBinary: wasmBinary  // null for bundled, ArrayBuffer for split\n            }\n        });\n\n        // Connect to destination\n        this.node.connect(this.ctx.destination);\n\n        // Set up message handling\n        this.node.port.onmessage = (e) => this.#handleMessage(e.data);\n\n        // Wait for the processor to be ready\n        return new Promise((resolve, reject) => {\n            const timeout = setTimeout(() => {\n                reject(new Error('Timeout waiting for WASM initialization'));\n            }, 10000);\n\n            this.#onceMessage('ready', () => {\n                clearTimeout(timeout);\n                this.#ready = true;\n                resolve();\n            });\n\n            this.#onceMessage('error', /** @param {{message: string}} msg */(msg) => {\n                clearTimeout(timeout);\n                reject(new Error(msg.message));\n            });\n        });\n    }\n\n    /**\n     * Internal message handler\n     * @param {{type: string}} msg - Message from processor\n     */\n    #handleMessage(msg) {\n        const handlers = this.#messageHandlers.get(msg.type);\n        if (handlers) {\n            handlers.forEach(/** @param {Function} handler */ handler => handler(msg));\n        }\n    }\n\n    /**\n     * Register a one-time message handler\n     * @param {string} type - Message type\n     * @param {Function} handler - Handler function\n     */\n    #onceMessage(type, handler) {\n        if (!this.#messageHandlers.has(type)) {\n            this.#messageHandlers.set(type, new Set());\n        }\n\n        /** @param {Object} msg */\n        const wrappedHandler = (msg) => {\n            this.#messageHandlers.get(type)?.delete(wrappedHandler);\n            handler(msg);\n        };\n\n        this.#messageHandlers.get(type)?.add(wrappedHandler);\n    }\n\n    /**\n     * Send a message to the processor\n     * @param {Object} msg - Message to send\n     */\n    #send(msg) {\n        if (this.node) {\n            this.node.port.postMessage(msg);\n        }\n    }\n\n    /**\n     * Play a note\n     * @param {number} channel - MIDI channel (0-15)\n     * @param {number} note - MIDI note number (0-127)\n     * @param {number} velocity - Note velocity (0-127)\n     */\n    noteOn(channel, note, velocity) {\n        this.#send({ type: 'noteOn', channel, note, velocity });\n    }\n\n    /**\n     * Stop a note\n     * @param {number} channel - MIDI channel (0-15)\n     * @param {number} note - MIDI note number (0-127)\n     */\n    noteOff(channel, note) {\n        this.#send({ type: 'noteOff', channel, note });\n    }\n\n    /**\n     * Set pitch bend\n     * @param {number} channel - MIDI channel (0-15)\n     * @param {number} value - Pitch bend value (0-16383, 8192 = center)\n     */\n    pitchBend(channel, value) {\n        const lsb = value & 0x7F;\n        const msb = (value >> 7) & 0x7F;\n        this.#send({ type: 'pitchBend', channel, lsb, msb });\n    }\n\n    /**\n     * Send a control change\n     * @param {number} channel - MIDI channel (0-15)\n     * @param {number} controller - Controller number (0-127)\n     * @param {number} value - Controller value (0-127)\n     */\n    controlChange(channel, controller, value) {\n        this.#send({ type: 'controlChange', channel, controller, value });\n    }\n\n    /**\n     * Change program (instrument)\n     * @param {number} channel - MIDI channel (0-15)\n     * @param {number} program - Program number (0-127)\n     */\n    programChange(channel, program) {\n        this.#send({ type: 'programChange', channel, program });\n    }\n\n    /**\n     * Reset the real-time state (stops all notes, resets controllers)\n     * @returns {void}\n     */\n    resetState() {\n        this.#send({ type: 'resetState' });\n    }\n\n    /**\n     * Panic - stop all sounds immediately\n     * @returns {void}\n     */\n    panic() {\n        this.#send({ type: 'panic' });\n    }\n\n    /**\n     * Configure synth settings at runtime\n     * @param {ConfigureSettings} settings - Settings object\n     * @returns {Promise<void>}\n     */\n    async configure(settings) {\n        return new Promise((resolve) => {\n            this.#onceMessage('configured', () => resolve());\n            this.#send({ type: 'configure', settings });\n        });\n    }\n\n    /**\n     * Load a custom bank file (WOPL format)\n     * @param {ArrayBuffer} arrayBuffer - Bank file data\n     * @returns {Promise<void>}\n     */\n    async loadBank(arrayBuffer) {\n        return new Promise((resolve, reject) => {\n            this.#onceMessage('bankLoaded', /** @param {{success: boolean, error?: string}} msg */(msg) => {\n                if (msg.success) {\n                    resolve();\n                } else {\n                    reject(new Error(msg.error || 'Failed to load bank'));\n                }\n            });\n\n            this.#send({ type: 'loadBank', data: arrayBuffer });\n        });\n    }\n\n    /**\n     * Set the embedded bank by number\n     * @param {number} bank - Bank number\n     * @returns {Promise<void>}\n     */\n    async setBank(bank) {\n        return new Promise((resolve, reject) => {\n            this.#onceMessage('bankSet', /** @param {{success: boolean}} msg */(msg) => {\n                if (msg.success) {\n                    resolve();\n                } else {\n                    reject(new Error(`Failed to set bank ${bank}`));\n                }\n            });\n\n            this.#send({ type: 'setBank', bank });\n        });\n    }\n\n    /**\n     * Get an instrument from a bank for editing\n     * @param {BankId} [bankId] - Bank identifier\n     * @param {number} [programNumber] - Program/instrument number (0-127)\n     * @returns {Promise<Instrument>} Instrument object with named properties\n     */\n    async getInstrument(bankId = { percussive: false, msb: 0, lsb: 0 }, programNumber = 0) {\n        return new Promise((resolve, reject) => {\n            this.#onceMessage('instrumentLoaded', /** @param {{success: boolean, instrument: Instrument, error?: string}} msg */(msg) => {\n                if (msg.success) {\n                    resolve(msg.instrument);\n                } else {\n                    reject(new Error(msg.error || 'Failed to get instrument'));\n                }\n            });\n\n            this.#send({ type: 'getInstrument', bankId, programNumber });\n        });\n    }\n\n    /**\n     * Set an instrument in a bank\n     * @param {BankId} bankId - Bank identifier\n     * @param {number} programNumber - Program/instrument number (0-127)\n     * @param {Instrument} instrument - Instrument object with operator parameters\n     * @returns {Promise<void>}\n     */\n    async setInstrument(bankId = { percussive: false, msb: 0, lsb: 0 }, programNumber, instrument) {\n        return new Promise((resolve, reject) => {\n            this.#onceMessage('instrumentSet', /** @param {{success: boolean, error?: string}} msg */(msg) => {\n                if (msg.success) {\n                    resolve();\n                } else {\n                    reject(new Error(msg.error || 'Failed to set instrument'));\n                }\n            });\n\n            this.#send({ type: 'setInstrument', bankId, programNumber, instrument });\n        });\n    }\n\n    /**\n     * Set the number of emulated OPL3 chips\n     * @param {number} chips - Number of chips (1-100)\n     */\n    setNumChips(chips) {\n        this.#send({ type: 'setNumChips', chips });\n    }\n\n    /**\n     * Set the volume model\n     * @param {number} model - Volume model number\n     */\n    setVolumeModel(model) {\n        this.#send({ type: 'setVolumeModel', model });\n    }\n\n    /**\n     * Enable/disable rhythm mode (percussion)\n     * @param {boolean} enabled\n     */\n    setPercussionMode(enabled) {\n        this.#send({ type: 'setPercMode', enabled });\n    }\n\n    /**\n     * Enable/disable deep vibrato\n     * @param {boolean} enabled\n     */\n    setVibrato(enabled) {\n        this.#send({ type: 'setVibrato', enabled });\n    }\n\n    /**\n     * Enable/disable deep tremolo\n     * @param {boolean} enabled\n     */\n    setTremolo(enabled) {\n        this.#send({ type: 'setTremolo', enabled });\n    }\n\n    /**\n     * Switch the OPL3 emulator core at runtime\n     * \n     * Only emulators compiled into the current build profile are available:\n     * - nuked profile: NUKED only\n     * - dosbox profile: DOSBOX only  \n     * - light profile: NUKED, DOSBOX\n     * - full profile: NUKED, DOSBOX, OPAL, JAVA, ESFMU, YMFM_OPL2, YMFM_OPL3\n     * \n     * @param {number} emulator - Emulator ID from the Emulator enum\n     * @returns {Promise<void>} Resolves when emulator is switched, rejects if unavailable\n     * @example\n     * import { AdlMidi, Emulator } from 'libadlmidi-js';\n     * await synth.switchEmulator(Emulator.DOSBOX);\n     */\n    async switchEmulator(emulator) {\n        return new Promise((resolve, reject) => {\n            this.#onceMessage('emulatorSwitched', /** @param {{success: boolean, emulator: number}} msg */(msg) => {\n                if (msg.success) {\n                    resolve();\n                } else {\n                    reject(new Error(`Failed to switch to emulator ${emulator}. It may not be available in this build profile.`));\n                }\n            });\n            this.#send({ type: 'switchEmulator', emulator });\n        });\n    }\n\n    /**\n     * Get the name of the currently active OPL3 emulator\n     * @returns {Promise<string>} Human-readable emulator name (e.g., \"Nuked OPL3 (v 1.8)\")\n     * @example\n     * const name = await synth.getEmulatorName();\n     * console.log(`Using: ${name}`);\n     */\n    async getEmulatorName() {\n        return new Promise((resolve) => {\n            this.#onceMessage('emulatorName', /** @param {{name: string}} msg */(msg) => {\n                resolve(msg.name);\n            });\n            this.#send({ type: 'getEmulatorName' });\n        });\n    }\n\n    /**\n     * Reset the synthesizer\n     * @returns {void}\n     */\n    reset() {\n        this.#send({ type: 'reset' });\n    }\n\n    /**\n     * Close the synthesizer and release resources\n     * @returns {void}\n     */\n    close() {\n        if (this.node) {\n            this.node.disconnect();\n            this.node = null;\n        }\n        this._ready = false;\n    }\n\n    /**\n     * Suspend the AudioContext (save CPU when not in use)\n     * @returns {Promise<void>}\n     */\n    async suspend() {\n        if (this.ctx) {\n            await this.ctx.suspend();\n        }\n    }\n\n    /**\n     * Resume the AudioContext\n     * @returns {Promise<void>}\n     */\n    async resume() {\n        if (this.ctx) {\n            await this.ctx.resume();\n        }\n    }\n}\n\nexport default AdlMidi;\n"],
+  "mappings": "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",
+  "names": []
+}