libadlmidi-js 1.2.0 → 2.1.0

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,13 +38,17 @@ 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';
 import { AdlMidiCore as BaseAdlMidiCore } from '../core.js';
 export { encodeInstrument, decodeInstrument, defaultInstrument, encodeOperator, decodeOperator, defaultOperator } from "../utils/struct.js";
+export { Emulator, TrackOption } from "../utils/constants.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,13 +38,17 @@ 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';
 import { AdlMidiCore as BaseAdlMidiCore } from '../core.js';
 export { encodeInstrument, decodeInstrument, defaultInstrument, encodeOperator, decodeOperator, defaultOperator } from "../utils/struct.js";
+export { Emulator, TrackOption } from "../utils/constants.js";

package/dist/utils/constants.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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.
+ */
+export type Emulator = number;
+/**
+ * Shared constants for libADLMIDI-JS
+ */
+/**
+ * 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
+ * @enum {number}
+ */
+export const Emulator: Readonly<{
+    /** Nuked OPL3 v1.8 - Most accurate, higher CPU usage */
+    NUKED: 0;
+    /** 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;
+    /** 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;
+    /** Nuked OPL2 Lite - Lightweight OPL2 emulation for AdLib-era music */
+    NUKED_OPL2_LITE: 11;
+}>;
+/**
+ * Track option flags for use with setTrackOptions().
+ */
+export type TrackOption = number;
+/**
+ * Track option flags for use with setTrackOptions().
+ * @readonly
+ * @enum {number}
+ */
+export const TrackOption: Readonly<{
+    /** Enable the track (default state) */
+    ON: 1;
+    /** Mute/disable the track */
+    OFF: 2;
+    /** Solo the track (mute all others) */
+    SOLO: 3;
+}>;

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "libadlmidi-js",
-  "version": "1.2.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"
+  }
 }