libadlmidi-js 1.1.0 → 1.2.0

package/README.md

@@ -2,6 +2,14 @@
 
 WebAssembly build of [libADLMIDI](https://github.com/Wohlstand/libADLMIDI) - a free Software MIDI synthesizer library with OPL3 (FM synthesis) emulation.
 
+Check out some [examples](https://libadlmidi-js.github.io):
+- [oplsfxr](https://libadlmidi-js.github.io/examples/oplsfxr.html)
+- [midi player](https://libadlmidi-js.github.io/examples/player.html)
+- [keyboard](https://libadlmidi-js.github.io/examples/keyboard.html)
+- [patch editor](https://libadlmidi-js.github.io/examples/patch-editor.html)
+- [midi to wav](https://libadlmidi-js.github.io/examples/midi-to-audio.html)
+- [connect any midi controller](https://libadlmidi-js.github.io/examples/webmidi.html)
+
 ## Features
 
 - **AudioWorklet Integration**: Runs synthesis in a separate thread to prevent UI stuttering. Interoperates with all the usual browser audio APIs.
@@ -32,6 +40,34 @@ setTimeout(() => {
 }, 1000);
 ```
 
+## CDN Usage
+
+You can load the library from a CDN to use it right away.
+
+**unpkg** or **jsdelivr**:
+```html
+<script type="module">
+  import { AdlMidi } from 'https://unpkg.com/libadlmidi-js/src/profiles/light.js';
+  // or: https://cdn.jsdelivr.net/npm/libadlmidi-js/src/profiles/light.js
+  
+  const synth = new AdlMidi();
+  await synth.init();
+</script>
+```
+
+**esm.sh** requires explicit URLs:
+```html
+<script type="module">
+  import { AdlMidi } from 'https://esm.sh/libadlmidi-js/src/libadlmidi.js';
+  
+  const synth = new AdlMidi();
+  await synth.init(
+    'https://esm.sh/libadlmidi-js/dist/libadlmidi.light.processor.js?raw',
+    'https://esm.sh/libadlmidi-js/dist/libadlmidi.light.core.wasm?raw'
+  );
+</script>
+```
+
 ## Low-Level API (Node.js / Custom Backends)
 
 For batch rendering, custom audio backends, or non-browser environments:
@@ -98,7 +134,6 @@ synth.noteOn(0, 60, 100);
 // You can also decode instrument data from a bank
 const decoded = decodeInstrument(bytes);
 ```
-
 ## Profiles
 
 | Profile | Emulator(s) | Usage |

package/dist/core.d.ts

@@ -61,6 +61,10 @@ export class AdlMidiCore {
      * Reset the synthesizer state (stop all notes).
      */
     reset(): void;
+    /**
+     * Full reset to apply instrument/bank changes.
+     */
+    resetFull(): void;
     /**
      * Panic - immediately stop all notes.
      */
@@ -101,6 +105,55 @@ export class AdlMidiCore {
      * @returns {boolean} True if successful
      */
     setNumChips(count: number): boolean;
+    /**
+     * Set the number of 4-operator channels.
+     *
+     * @param {number} count - Number of channels (-1 for auto)
+     * @returns {boolean} True if successful
+     */
+    setNumFourOpChannels(count: number): boolean;
+    /**
+     * Get the number of 4-operator channels.
+     *
+     * @returns {number} Count of channels
+     */
+    getNumFourOpChannels(): number;
+    /**
+     * Enable/disable scaling of modulators by volume.
+     *
+     * @param {boolean} enabled
+     */
+    setScaleModulators(enabled: boolean): void;
+    /**
+     * Enable/disable full-range brightness (0-127).
+     *
+     * @param {boolean} enabled
+     */
+    setFullRangeBrightness(enabled: boolean): void;
+    /**
+     * Enable/disable automatic arpeggio.
+     *
+     * @param {boolean} enabled
+     */
+    setAutoArpeggio(enabled: boolean): void;
+    /**
+     * Get automatic arpeggio state.
+     *
+     * @returns {boolean}
+     */
+    getAutoArpeggio(): boolean;
+    /**
+     * Set channel allocation mode.
+     *
+     * @param {number} mode - Mode ID
+     */
+    setChannelAllocMode(mode: number): void;
+    /**
+     * Get channel allocation mode.
+     *
+     * @returns {number} Mode ID
+     */
+    getChannelAllocMode(): number;
     /**
      * Enable/disable soft stereo panning.
      *
@@ -132,6 +185,53 @@ export class AdlMidiCore {
      * @returns {string} Emulator name
      */
     getEmulatorName(): string;
+    /**
+     * Get the version string of the linked libADLMIDI library.
+     *
+     * @returns {string} Version string (e.g., "1.5.1")
+     */
+    getLibraryVersion(): string;
+    /**
+     * Get the version of the linked libADLMIDI library as an object.
+     *
+     * @returns {{major: number, minor: number, patch: number}}
+     */
+    getVersion(): {
+        major: number;
+        minor: number;
+        patch: number;
+    };
+    /**
+     * Get the number of emulated chips.
+     *
+     * @returns {number}
+     */
+    getNumChips(): number;
+    /**
+     * Get the number of emulated chips obtained.
+     *
+     * @returns {number}
+     */
+    getNumChipsObtained(): number;
+    /**
+     * Get the volume range model.
+     *
+     * @returns {number}
+     */
+    getVolumeModel(): number;
+    /**
+     * Set the volume range model.
+     *
+     * @param {number} model - Volume model type
+     */
+    setVolumeModel(model: number): void;
+    /**
+     * Run emulator with PCM rate to reduce CPU usage.
+     *
+     * @param {boolean} enabled
+     * @returns {boolean} True if successful
+     */
+    setRunAtPcmRate(enabled: boolean): boolean;
     /**
      * Trigger a note on.
      *
@@ -147,6 +247,21 @@ export class AdlMidiCore {
      * @param {number} note - MIDI note (0-127)
      */
     noteOff(channel: number, note: number): void;
+    /**
+     * Send a note aftertouch message.
+     *
+     * @param {number} channel - MIDI channel (0-15)
+     * @param {number} note - MIDI note (0-127)
+     * @param {number} pressure - Aftertouch pressure (0-127)
+     */
+    noteAfterTouch(channel: number, note: number, pressure: number): void;
+    /**
+     * Send a channel aftertouch message.
+     *
+     * @param {number} channel - MIDI channel (0-15)
+     * @param {number} pressure - Aftertouch pressure (0-127)
+     */
+    channelAfterTouch(channel: number, pressure: number): void;
     /**
      * Send a pitch bend message.
      *
@@ -169,6 +284,27 @@ export class AdlMidiCore {
      * @param {number} program - Program number (0-127)
      */
     programChange(channel: number, program: number): void;
+    /**
+     * Send a bank change message (16-bit).
+     *
+     * @param {number} channel - MIDI channel (0-15)
+     * @param {number} bank - Bank number
+     */
+    bankChange(channel: number, bank: number): void;
+    /**
+     * Send a bank change MSB message.
+     *
+     * @param {number} channel - MIDI channel (0-15)
+     * @param {number} msb - Bank MSB (0-127)
+     */
+    bankChangeMSB(channel: number, msb: number): void;
+    /**
+     * Send a bank change LSB message.
+     *
+     * @param {number} channel - MIDI channel (0-15)
+     * @param {number} lsb - Bank LSB (0-127)
+     */
+    bankChangeLSB(channel: number, lsb: number): void;
     /**
      * Generate audio samples (real-time synthesis).
      *
@@ -183,6 +319,18 @@ export class AdlMidiCore {
      * @returns {boolean} True if successful
      */
     loadMidi(data: ArrayBuffer | Uint8Array): boolean;
+    /**
+     * Get the music title of the loaded MIDI file.
+     *
+     * @returns {string} Title or empty string
+     */
+    getMusicTitle(): string;
+    /**
+     * Get the copyright notice of the loaded MIDI file.
+     *
+     * @returns {string} Copyright or empty string
+     */
+    getMusicCopyright(): string;
     /**
      * Play MIDI file and generate audio.
      *

package/dist/fm_banks/manifest.json

@@ -1,5 +1,5 @@
 {
-  "generated": "2026-01-20T13:26:00.406Z",
+  "generated": "2026-03-17T14:43:16.332Z",
   "categories": {
     "wopl": {
       "description": "General WOPL banks",

package/dist/libadlmidi.d.ts

@@ -1,5 +1,5 @@
 /**
- * Available OPL3 emulator cores.
+ * Available OPL2/OPL3 emulator cores.
  * Use with switchEmulator() to change the synthesis engine at runtime.
  * Note: Only emulators compiled into the current profile are available.
  */
@@ -75,7 +75,7 @@ export type Emulator = number;
  * @property {boolean} [deepTremolo] - Enable deep tremolo
  */
 /**
- * Available OPL3 emulator cores.
+ * Available OPL2/OPL3 emulator cores.
  * Use with switchEmulator() to change the synthesis engine at runtime.
  * Note: Only emulators compiled into the current profile are available.
  * @readonly
@@ -104,6 +104,8 @@ export const Emulator: Readonly<{
     NUKED_OPL2_LLE: 9;
     /** Nuked OPL3 LLE - Transistor-level emulation */
     NUKED_OPL3_LLE: 10;
+    /** Nuked OPL2 Lite - Lightweight OPL2 emulation for AdLib-era music */
+    NUKED_OPL2_LITE: 11;
 }>;
 export class AdlMidi {
     /**
@@ -163,6 +165,37 @@ export class AdlMidi {
      * @param {number} program - Program number (0-127)
      */
     programChange(channel: number, program: number): void;
+    /**
+     * Send note aftertouch
+     * @param {number} channel - MIDI channel (0-15)
+     * @param {number} note - Note number (0-127)
+     * @param {number} pressure - Pressure (0-127)
+     */
+    noteAfterTouch(channel: number, note: number, pressure: number): void;
+    /**
+     * Send channel aftertouch
+     * @param {number} channel - MIDI channel (0-15)
+     * @param {number} pressure - Pressure (0-127)
+     */
+    channelAfterTouch(channel: number, pressure: number): void;
+    /**
+     * Change bank (16-bit)
+     * @param {number} channel - MIDI channel (0-15)
+     * @param {number} bank - Bank number
+     */
+    bankChange(channel: number, bank: number): void;
+    /**
+     * Change bank MSB
+     * @param {number} channel - MIDI channel (0-15)
+     * @param {number} msb - Bank MSB (0-127)
+     */
+    bankChangeMSB(channel: number, msb: number): void;
+    /**
+     * Change bank LSB
+     * @param {number} channel - MIDI channel (0-15)
+     * @param {number} lsb - Bank LSB (0-127)
+     */
+    bankChangeLSB(channel: number, lsb: number): void;
     /**
      * Reset the real-time state (stops all notes, resets controllers)
      * @returns {void}
@@ -211,6 +244,46 @@ export class AdlMidi {
      * @param {number} chips - Number of chips (1-100)
      */
     setNumChips(chips: number): void;
+    /**
+     * Set the number of 4-operator channels
+     * @param {number} channels - Number of channels (-1 for auto)
+     */
+    setNumFourOpChannels(channels: number): void;
+    /**
+     * Get the number of 4-operator channels
+     * @returns {Promise<number>}
+     */
+    getNumFourOpChannels(): Promise<number>;
+    /**
+     * Enable/disable scaling of modulators by volume
+     * @param {boolean} enabled
+     */
+    setScaleModulators(enabled: boolean): void;
+    /**
+     * Enable/disable full-range brightness
+     * @param {boolean} enabled
+     */
+    setFullRangeBrightness(enabled: boolean): void;
+    /**
+     * Enable/disable automatic arpeggio
+     * @param {boolean} enabled
+     */
+    setAutoArpeggio(enabled: boolean): void;
+    /**
+     * Get automatic arpeggio state
+     * @returns {Promise<boolean>}
+     */
+    getAutoArpeggio(): Promise<boolean>;
+    /**
+     * Set channel allocation mode
+     * @param {number} mode - Mode ID
+     */
+    setChannelAllocMode(mode: number): void;
+    /**
+     * Get channel allocation mode
+     * @returns {Promise<number>}
+     */
+    getChannelAllocMode(): Promise<number>;
     /**
      * Set the volume model
      * @param {number} model - Volume model number
@@ -231,6 +304,11 @@ export class AdlMidi {
      * @param {boolean} enabled
      */
     setTremolo(enabled: boolean): void;
+    /**
+     * Run emulator with PCM rate to reduce CPU usage
+     * @param {boolean} enabled
+     */
+    setRunAtPcmRate(enabled: boolean): void;
     /**
      * Switch the OPL3 emulator core at runtime
      *
@@ -255,6 +333,35 @@ export class AdlMidi {
      * console.log(`Using: ${name}`);
      */
     getEmulatorName(): Promise<string>;
+    /**
+     * Get the version string of the linked libADLMIDI library
+     * @returns {Promise<string>}
+     */
+    getLibraryVersion(): Promise<string>;
+    /**
+     * Get the version of the linked libADLMIDI library as an object
+     * @returns {Promise<{major: number, minor: number, patch: number}>}
+     */
+    getVersion(): Promise<{
+        major: number;
+        minor: number;
+        patch: number;
+    }>;
+    /**
+     * Get the number of emulated chips
+     * @returns {Promise<number>}
+     */
+    getNumChips(): Promise<number>;
+    /**
+     * Get the number of emulated chips obtained
+     * @returns {Promise<number>}
+     */
+    getNumChipsObtained(): Promise<number>;
+    /**
+     * Get the volume range model
+     * @returns {Promise<number>}
+     */
+    getVolumeModel(): Promise<number>;
     /**
      * Get list of embedded banks available in this build
      * Note: Slim builds have no embedded banks and will return an empty array
@@ -280,6 +387,16 @@ export class AdlMidi {
     loadMidi(arrayBuffer: ArrayBuffer): Promise<{
         duration: number;
     }>;
+    /**
+     * Get the music title of the loaded MIDI file
+     * @returns {Promise<string>}
+     */
+    getMusicTitle(): Promise<string>;
+    /**
+     * Get the copyright notice of the loaded MIDI file
+     * @returns {Promise<string>}
+     */
+    getMusicCopyright(): Promise<string>;
     /**
      * Start or resume MIDI file playback
      * @returns {void}