@coderline/alphatab 1.4.0 → 1.5.0-alpha.1331

package/dist/alphaTab.core.mjs

@@ -1,5 +1,5 @@
 /**
- * alphaTab v1.4.0 (, build 12)
+ * alphaTab v1.5.0-alpha.1331 (develop, build 1331)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -27073,6 +27073,9 @@ class PlaybackRangeChangedEventArgs {
  * play a {@link MidiFile} via a {@link ISynthOutput}.
  */
 class AlphaSynth {
+    get output() {
+        return this._output;
+    }
     get isReadyForPlayback() {
         return this.isReady && this._isSoundFontLoaded && this._isMidiLoaded;
     }
@@ -27193,7 +27196,7 @@ class AlphaSynth {
         Logger.debug('AlphaSynth', 'Initializing player');
         this.state = PlayerState.Paused;
         Logger.debug('AlphaSynth', 'Creating output');
-        this.output = output;
+        this._output = output;
         Logger.debug('AlphaSynth', 'Creating synthesizer');
         this._synthesizer = new TinySoundFont(this.output.sampleRate);
         this._sequencer = new MidiFileSequencer(this._synthesizer);
@@ -27566,6 +27569,13 @@ class AlphaSynthWorkerSynthOutput {
     activate() {
         // nothing to do
     }
+    async enumerateOutputDevices() {
+        return [];
+    }
+    async setOutputDevice(device) { }
+    async getOutputDevice() {
+        return null;
+    }
 }
 AlphaSynthWorkerSynthOutput.CmdOutputPrefix = 'alphaSynth.output.';
 AlphaSynthWorkerSynthOutput.CmdOutputAddSamples = AlphaSynthWorkerSynthOutput.CmdOutputPrefix + 'addSamples';
@@ -33383,6 +33393,37 @@ class AlphaTabApiBase {
         this.settingsUpdated.trigger();
         this.uiFacade.triggerEvent(this.container, 'settingsUpdated', null);
     }
+    /**
+     * Loads and lists the available output devices which can be used by the player. Will request permissions if needed.
+     * @returns the list of available devices or an empty list if there are no permissions, or the player is not enabled.
+     */
+    async enumerateOutputDevices() {
+        if (this.player) {
+            return await this.player.output.enumerateOutputDevices();
+        }
+        return [];
+    }
+    /**
+     * Changes the output device which should be used for playing the audio (player must be enabled).
+     * @param device The output device to use, or null to switch to the default device.
+     */
+    async setOutputDevice(device) {
+        if (this.player) {
+            await this.player.output.setOutputDevice(device);
+        }
+    }
+    /**
+     * The currently configured output device if changed via {@link setOutputDevice}.
+     * @returns The custom configured output device which was set via {@link setOutputDevice} or `null`
+     * if the default outputDevice is used.
+     * The output device might change dynamically if devices are connected/disconnected (e.g. bluetooth headset).
+     */
+    async getOutputDevice() {
+        if (this.player) {
+            return await this.player.output.getOutputDevice();
+        }
+        return null;
+    }
 }
 
 /**
@@ -33845,6 +33886,21 @@ class CircularSampleBuffer {
     }
 }
 
+/**
+ * @target web
+ */
+class AlphaSynthWebAudioSynthOutputDevice {
+    constructor(device) {
+        this.isDefault = false;
+        this.device = device;
+    }
+    get deviceId() {
+        return this.device.deviceId;
+    }
+    get label() {
+        return this.device.label;
+    }
+}
 /**
  * @target web
  */
@@ -33856,6 +33912,7 @@ class AlphaSynthWebAudioOutputBase {
         this.ready = new EventEmitter();
         this.samplesPlayed = new EventEmitterOfT();
         this.sampleRequest = new EventEmitter();
+        this._knownDevices = [];
     }
     get sampleRate() {
         return this._context ? this._context.sampleRate : AlphaSynthWebAudioOutputBase.PreferredSampleRate;
@@ -33954,6 +34011,101 @@ class AlphaSynthWebAudioOutputBase {
     onReady() {
         this.ready.trigger();
     }
+    async checkSinkIdSupport() {
+        // https://caniuse.com/mdn-api_audiocontext_sinkid
+        const context = this._context ?? this.createAudioContext();
+        if (!('setSinkId' in context)) {
+            Logger.warning('WebAudio', 'Browser does not support changing the output device');
+            return false;
+        }
+        return true;
+    }
+    async enumerateOutputDevices() {
+        try {
+            if (!(await this.checkSinkIdSupport())) {
+                return [];
+            }
+            // Request permissions
+            try {
+                await navigator.mediaDevices.getUserMedia({ audio: true });
+            }
+            catch (e) {
+                // sometimes we get an error but can still enumerate, e.g. if microphone access is denied,
+                // we can still load the output devices in some cases.
+                Logger.warning('WebAudio', 'Output device permission rejected', e);
+            }
+            // load devices
+            const devices = await navigator.mediaDevices.enumerateDevices();
+            // default device candidates
+            let defaultDeviceGroupId = '';
+            let defaultDeviceId = '';
+            const realDevices = new Map();
+            for (const device of devices) {
+                if (device.kind === 'audiooutput') {
+                    realDevices.set(device.groupId, new AlphaSynthWebAudioSynthOutputDevice(device));
+                    // chromium has the default device as deviceID: 'default'
+                    // the standard defines empty-string as default
+                    if (device.deviceId === 'default' || device.deviceId === '') {
+                        defaultDeviceGroupId = device.groupId;
+                        defaultDeviceId = device.deviceId;
+                    }
+                }
+            }
+            const final = Array.from(realDevices.values());
+            // flag default device
+            let defaultDevice = final.find(d => d.deviceId === defaultDeviceId);
+            if (!defaultDevice) {
+                defaultDevice = final.find(d => d.device.groupId === defaultDeviceGroupId);
+            }
+            if (!defaultDevice && final.length > 0) {
+                defaultDevice = final[0];
+            }
+            if (defaultDevice) {
+                defaultDevice.isDefault = true;
+            }
+            this._knownDevices = final;
+            return final;
+        }
+        catch (e) {
+            Logger.error('WebAudio', 'Failed to enumerate output devices', e);
+            return [];
+        }
+    }
+    async setOutputDevice(device) {
+        if (!(await this.checkSinkIdSupport())) {
+            return;
+        }
+        // https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/setSinkId
+        if (!device) {
+            await this._context.setSinkId('');
+        }
+        else {
+            await this._context.setSinkId(device.deviceId);
+        }
+    }
+    async getOutputDevice() {
+        if (!(await this.checkSinkIdSupport())) {
+            return null;
+        }
+        // https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/sinkId
+        const sinkId = this._context.sinkId;
+        if (typeof sinkId !== 'string' || sinkId === '' || sinkId === 'default') {
+            return null;
+        }
+        // fast path -> cached devices list
+        let device = this._knownDevices.find(d => d.deviceId === sinkId);
+        if (device) {
+            return device;
+        }
+        // slow path -> enumerate devices
+        const allDevices = await this.enumerateOutputDevices();
+        device = allDevices.find(d => d.deviceId === sinkId);
+        if (device) {
+            return device;
+        }
+        Logger.warning('WebAudio', 'Could not find output device in device list', sinkId, allDevices);
+        return null;
+    }
 }
 AlphaSynthWebAudioOutputBase.BufferSize = 4096;
 AlphaSynthWebAudioOutputBase.PreferredSampleRate = 44100;
@@ -34070,6 +34222,9 @@ class ProgressEventArgs {
  * @target web
  */
 class AlphaSynthWebWorkerApi {
+    get output() {
+        return this._output;
+    }
     get isReady() {
         return this._workerIsReady && this._outputIsReady;
     }
@@ -52127,8 +52282,8 @@ class CoreSettings {
 // </auto-generated>
 class VersionInfo {
 }
-VersionInfo.version = '1.4.0';
-VersionInfo.date = '2025-03-02T15:59:05.431Z';
+VersionInfo.version = '1.5.0-alpha.1331';
+VersionInfo.date = '2025-03-03T01:56:53.590Z';
 
 var index$4 = /*#__PURE__*/Object.freeze({
     __proto__: null,

package/dist/alphaTab.d.ts

@@ -7299,6 +7299,95 @@ declare class MidiEventsPlayedEventArgs {
     constructor(events: MidiEvent[]);
 }
 
+/**
+ * Represents a output device on which the synth can send the audio to.
+ */
+interface ISynthOutputDevice {
+    /**
+     * The ID to uniquely identify the device.
+     */
+    readonly deviceId: string;
+    /**
+     * A string describing the device.
+     */
+    readonly label: string;
+    /**
+     * Gets a value indicating whether the device is the default output device.
+     */
+    readonly isDefault: boolean;
+}
+/**
+ * This is the base interface for output devices which can
+ * request and playback audio samples.
+ * @csharp_public
+ */
+interface ISynthOutput {
+    /**
+     * Gets the sample rate required by the output.
+     */
+    readonly sampleRate: number;
+    /**
+     * Called when the output should be opened.
+     */
+    open(bufferTimeInMilliseconds: number): void;
+    /**
+     * Called when the output should start the playback.
+     */
+    play(): void;
+    /**
+     * Requests the output to destroy itself.
+     */
+    destroy(): void;
+    /**
+     * Called when the output should stop the playback.
+     */
+    pause(): void;
+    /**
+     * Called when samples have been synthesized and should be added to the playback buffer.
+     * @param samples
+     */
+    addSamples(samples: Float32Array): void;
+    /**
+     * Called when the samples in the output buffer should be reset. This is neeed for instance when seeking to another position.
+     */
+    resetSamples(): void;
+    /**
+     * Activates the output component.
+     */
+    activate(): void;
+    /**
+     * Fired when the output has been successfully opened and is ready to play samples.
+     */
+    readonly ready: IEventEmitter;
+    /**
+     * Fired when a certain number of samples have been played.
+     */
+    readonly samplesPlayed: IEventEmitterOfT<number>;
+    /**
+     * Fired when the output needs more samples to be played.
+     */
+    readonly sampleRequest: IEventEmitter;
+    /**
+     * Loads and lists the available output devices. Will request permissions if needed.
+     * @async
+     */
+    enumerateOutputDevices(): Promise<ISynthOutputDevice[]>;
+    /**
+     * Changes the output device which should be used for playing the audio.
+     * @async
+     * @param device The output device to use, or null to switch to the default device.
+     */
+    setOutputDevice(device: ISynthOutputDevice | null): Promise<void>;
+    /**
+     * The currently configured output device if changed via {@link setOutputDevice}.
+     * @async
+     * @returns The custom configured output device which was set via {@link setOutputDevice} or `null`
+     * if the default outputDevice is used.
+     * The output device might change dynamically if devices are connected/disconnected (e.g. bluetooth headset).
+     */
+    getOutputDevice(): Promise<ISynthOutputDevice | null>;
+}
+
 /**
  * The public API interface for interacting with the synthesizer.
  */
@@ -7356,6 +7445,10 @@ interface IAlphaSynth {
      * Gets or sets the midi events which will trigger the `midiEventsPlayed` event.
      */
     midiEventsPlayedFilter: MidiEventType[];
+    /**
+     * Gets the output used by alphaSynth.
+     */
+    readonly output: ISynthOutput;
     /**
      * Destroys the synthesizer and all related components
      */
@@ -8039,6 +8132,23 @@ declare class AlphaTabApiBase<TSettings> {
      */
     settingsUpdated: IEventEmitter;
     private onSettingsUpdated;
+    /**
+     * Loads and lists the available output devices which can be used by the player. Will request permissions if needed.
+     * @returns the list of available devices or an empty list if there are no permissions, or the player is not enabled.
+     */
+    enumerateOutputDevices(): Promise<ISynthOutputDevice[]>;
+    /**
+     * Changes the output device which should be used for playing the audio (player must be enabled).
+     * @param device The output device to use, or null to switch to the default device.
+     */
+    setOutputDevice(device: ISynthOutputDevice | null): Promise<void>;
+    /**
+     * The currently configured output device if changed via {@link setOutputDevice}.
+     * @returns The custom configured output device which was set via {@link setOutputDevice} or `null`
+     * if the default outputDevice is used.
+     * The output device might change dynamically if devices are connected/disconnected (e.g. bluetooth headset).
+     */
+    getOutputDevice(): Promise<ISynthOutputDevice | null>;
 }
 
 /**
@@ -8542,59 +8652,6 @@ declare namespace index_d$1 {
   export { index_d$1_CssFontSvgCanvas as CssFontSvgCanvas, index_d$1_Cursors as Cursors, index_d$1_FontSizes as FontSizes, type index_d$1_ICanvas as ICanvas, type index_d$1_IContainer as IContainer, type index_d$1_IMouseEventArgs as IMouseEventArgs, type index_d$1_IUiFacade as IUiFacade, index_d$1_SvgCanvas as SvgCanvas, index_d$1_TextAlign as TextAlign, index_d$1_TextBaseline as TextBaseline };
 }
 
-/**
- * This is the base interface for output devices which can
- * request and playback audio samples.
- * @csharp_public
- */
-interface ISynthOutput {
-    /**
-     * Gets the sample rate required by the output.
-     */
-    readonly sampleRate: number;
-    /**
-     * Called when the output should be opened.
-     */
-    open(bufferTimeInMilliseconds: number): void;
-    /**
-     * Called when the output should start the playback.
-     */
-    play(): void;
-    /**
-     * Requests the output to destroy itself.
-     */
-    destroy(): void;
-    /**
-     * Called when the output should stop the playback.
-     */
-    pause(): void;
-    /**
-     * Called when samples have been synthesized and should be added to the playback buffer.
-     * @param samples
-     */
-    addSamples(samples: Float32Array): void;
-    /**
-     * Called when the samples in the output buffer should be reset. This is neeed for instance when seeking to another position.
-     */
-    resetSamples(): void;
-    /**
-     * Activates the output component.
-     */
-    activate(): void;
-    /**
-     * Fired when the output has been successfully opened and is ready to play samples.
-     */
-    readonly ready: IEventEmitter;
-    /**
-     * Fired when a certain number of samples have been played.
-     */
-    readonly samplesPlayed: IEventEmitterOfT<number>;
-    /**
-     * Fired when the output needs more samples to be played.
-     */
-    readonly sampleRequest: IEventEmitter;
-}
-
 /**
  * This is the main synthesizer component which can be used to
  * play a {@link MidiFile} via a {@link ISynthOutput}.
@@ -8612,10 +8669,8 @@ declare class AlphaSynth implements IAlphaSynth {
     private _midiEventsPlayedFilter;
     private _notPlayedSamples;
     private _synthStopping;
-    /**
-     * Gets the {@link ISynthOutput} used for playing the generated samples.
-     */
-    readonly output: ISynthOutput;
+    private _output;
+    get output(): ISynthOutput;
     isReady: boolean;
     get isReadyForPlayback(): boolean;
     state: PlayerState;
@@ -8750,6 +8805,7 @@ declare class AlphaSynthWebWorkerApi implements IAlphaSynth {
     private _isLooping;
     private _playbackRange;
     private _midiEventsPlayedFilter;
+    get output(): ISynthOutput;
     get isReady(): boolean;
     get isReadyForPlayback(): boolean;
     get state(): PlayerState;
@@ -8837,6 +8893,11 @@ declare abstract class AlphaSynthWebAudioOutputBase implements ISynthOutput {
     protected onSamplesPlayed(numberOfSamples: number): void;
     protected onSampleRequest(): void;
     protected onReady(): void;
+    private checkSinkIdSupport;
+    private _knownDevices;
+    enumerateOutputDevices(): Promise<ISynthOutputDevice[]>;
+    setOutputDevice(device: ISynthOutputDevice | null): Promise<void>;
+    getOutputDevice(): Promise<ISynthOutputDevice | null>;
 }
 
 /**
@@ -8893,6 +8954,7 @@ type index_d_CircularSampleBuffer = CircularSampleBuffer;
 declare const index_d_CircularSampleBuffer: typeof CircularSampleBuffer;
 type index_d_IAlphaSynth = IAlphaSynth;
 type index_d_ISynthOutput = ISynthOutput;
+type index_d_ISynthOutputDevice = ISynthOutputDevice;
 type index_d_MidiEventsPlayedEventArgs = MidiEventsPlayedEventArgs;
 declare const index_d_MidiEventsPlayedEventArgs: typeof MidiEventsPlayedEventArgs;
 type index_d_PlaybackRange = PlaybackRange;
@@ -8906,7 +8968,7 @@ declare const index_d_PlayerStateChangedEventArgs: typeof PlayerStateChangedEven
 type index_d_PositionChangedEventArgs = PositionChangedEventArgs;
 declare const index_d_PositionChangedEventArgs: typeof PositionChangedEventArgs;
 declare namespace index_d {
-  export { index_d_ActiveBeatsChangedEventArgs as ActiveBeatsChangedEventArgs, index_d_AlphaSynth as AlphaSynth, index_d_AlphaSynthAudioWorkletOutput as AlphaSynthAudioWorkletOutput, index_d_AlphaSynthScriptProcessorOutput as AlphaSynthScriptProcessorOutput, index_d_AlphaSynthWebAudioOutputBase as AlphaSynthWebAudioOutputBase, index_d_AlphaSynthWebWorkerApi as AlphaSynthWebWorkerApi, index_d_CircularSampleBuffer as CircularSampleBuffer, type index_d_IAlphaSynth as IAlphaSynth, type index_d_ISynthOutput as ISynthOutput, index_d_MidiEventsPlayedEventArgs as MidiEventsPlayedEventArgs, index_d_PlaybackRange as PlaybackRange, index_d_PlaybackRangeChangedEventArgs as PlaybackRangeChangedEventArgs, index_d_PlayerState as PlayerState, index_d_PlayerStateChangedEventArgs as PlayerStateChangedEventArgs, index_d_PositionChangedEventArgs as PositionChangedEventArgs };
+  export { index_d_ActiveBeatsChangedEventArgs as ActiveBeatsChangedEventArgs, index_d_AlphaSynth as AlphaSynth, index_d_AlphaSynthAudioWorkletOutput as AlphaSynthAudioWorkletOutput, index_d_AlphaSynthScriptProcessorOutput as AlphaSynthScriptProcessorOutput, index_d_AlphaSynthWebAudioOutputBase as AlphaSynthWebAudioOutputBase, index_d_AlphaSynthWebWorkerApi as AlphaSynthWebWorkerApi, index_d_CircularSampleBuffer as CircularSampleBuffer, type index_d_IAlphaSynth as IAlphaSynth, type index_d_ISynthOutput as ISynthOutput, type index_d_ISynthOutputDevice as ISynthOutputDevice, index_d_MidiEventsPlayedEventArgs as MidiEventsPlayedEventArgs, index_d_PlaybackRange as PlaybackRange, index_d_PlaybackRangeChangedEventArgs as PlaybackRangeChangedEventArgs, index_d_PlayerState as PlayerState, index_d_PlayerStateChangedEventArgs as PlayerStateChangedEventArgs, index_d_PositionChangedEventArgs as PositionChangedEventArgs };
 }
 
 type json_d_CoreSettingsJson = CoreSettingsJson;

package/dist/alphaTab.js

@@ -1,5 +1,5 @@
 /**
- * alphaTab v1.4.0 (, build 12)
+ * alphaTab v1.5.0-alpha.1331 (develop, build 1331)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -27079,6 +27079,9 @@
      * play a {@link MidiFile} via a {@link ISynthOutput}.
      */
     class AlphaSynth {
+        get output() {
+            return this._output;
+        }
         get isReadyForPlayback() {
             return this.isReady && this._isSoundFontLoaded && this._isMidiLoaded;
         }
@@ -27199,7 +27202,7 @@
             Logger.debug('AlphaSynth', 'Initializing player');
             this.state = PlayerState.Paused;
             Logger.debug('AlphaSynth', 'Creating output');
-            this.output = output;
+            this._output = output;
             Logger.debug('AlphaSynth', 'Creating synthesizer');
             this._synthesizer = new TinySoundFont(this.output.sampleRate);
             this._sequencer = new MidiFileSequencer(this._synthesizer);
@@ -27572,6 +27575,13 @@
         activate() {
             // nothing to do
         }
+        async enumerateOutputDevices() {
+            return [];
+        }
+        async setOutputDevice(device) { }
+        async getOutputDevice() {
+            return null;
+        }
     }
     AlphaSynthWorkerSynthOutput.CmdOutputPrefix = 'alphaSynth.output.';
     AlphaSynthWorkerSynthOutput.CmdOutputAddSamples = AlphaSynthWorkerSynthOutput.CmdOutputPrefix + 'addSamples';
@@ -33389,6 +33399,37 @@
             this.settingsUpdated.trigger();
             this.uiFacade.triggerEvent(this.container, 'settingsUpdated', null);
         }
+        /**
+         * Loads and lists the available output devices which can be used by the player. Will request permissions if needed.
+         * @returns the list of available devices or an empty list if there are no permissions, or the player is not enabled.
+         */
+        async enumerateOutputDevices() {
+            if (this.player) {
+                return await this.player.output.enumerateOutputDevices();
+            }
+            return [];
+        }
+        /**
+         * Changes the output device which should be used for playing the audio (player must be enabled).
+         * @param device The output device to use, or null to switch to the default device.
+         */
+        async setOutputDevice(device) {
+            if (this.player) {
+                await this.player.output.setOutputDevice(device);
+            }
+        }
+        /**
+         * The currently configured output device if changed via {@link setOutputDevice}.
+         * @returns The custom configured output device which was set via {@link setOutputDevice} or `null`
+         * if the default outputDevice is used.
+         * The output device might change dynamically if devices are connected/disconnected (e.g. bluetooth headset).
+         */
+        async getOutputDevice() {
+            if (this.player) {
+                return await this.player.output.getOutputDevice();
+            }
+            return null;
+        }
     }
 
     /**
@@ -33851,6 +33892,21 @@
         }
     }
 
+    /**
+     * @target web
+     */
+    class AlphaSynthWebAudioSynthOutputDevice {
+        constructor(device) {
+            this.isDefault = false;
+            this.device = device;
+        }
+        get deviceId() {
+            return this.device.deviceId;
+        }
+        get label() {
+            return this.device.label;
+        }
+    }
     /**
      * @target web
      */
@@ -33862,6 +33918,7 @@
             this.ready = new EventEmitter();
             this.samplesPlayed = new EventEmitterOfT();
             this.sampleRequest = new EventEmitter();
+            this._knownDevices = [];
         }
         get sampleRate() {
             return this._context ? this._context.sampleRate : AlphaSynthWebAudioOutputBase.PreferredSampleRate;
@@ -33960,6 +34017,101 @@
         onReady() {
             this.ready.trigger();
         }
+        async checkSinkIdSupport() {
+            // https://caniuse.com/mdn-api_audiocontext_sinkid
+            const context = this._context ?? this.createAudioContext();
+            if (!('setSinkId' in context)) {
+                Logger.warning('WebAudio', 'Browser does not support changing the output device');
+                return false;
+            }
+            return true;
+        }
+        async enumerateOutputDevices() {
+            try {
+                if (!(await this.checkSinkIdSupport())) {
+                    return [];
+                }
+                // Request permissions
+                try {
+                    await navigator.mediaDevices.getUserMedia({ audio: true });
+                }
+                catch (e) {
+                    // sometimes we get an error but can still enumerate, e.g. if microphone access is denied,
+                    // we can still load the output devices in some cases.
+                    Logger.warning('WebAudio', 'Output device permission rejected', e);
+                }
+                // load devices
+                const devices = await navigator.mediaDevices.enumerateDevices();
+                // default device candidates
+                let defaultDeviceGroupId = '';
+                let defaultDeviceId = '';
+                const realDevices = new Map();
+                for (const device of devices) {
+                    if (device.kind === 'audiooutput') {
+                        realDevices.set(device.groupId, new AlphaSynthWebAudioSynthOutputDevice(device));
+                        // chromium has the default device as deviceID: 'default'
+                        // the standard defines empty-string as default
+                        if (device.deviceId === 'default' || device.deviceId === '') {
+                            defaultDeviceGroupId = device.groupId;
+                            defaultDeviceId = device.deviceId;
+                        }
+                    }
+                }
+                const final = Array.from(realDevices.values());
+                // flag default device
+                let defaultDevice = final.find(d => d.deviceId === defaultDeviceId);
+                if (!defaultDevice) {
+                    defaultDevice = final.find(d => d.device.groupId === defaultDeviceGroupId);
+                }
+                if (!defaultDevice && final.length > 0) {
+                    defaultDevice = final[0];
+                }
+                if (defaultDevice) {
+                    defaultDevice.isDefault = true;
+                }
+                this._knownDevices = final;
+                return final;
+            }
+            catch (e) {
+                Logger.error('WebAudio', 'Failed to enumerate output devices', e);
+                return [];
+            }
+        }
+        async setOutputDevice(device) {
+            if (!(await this.checkSinkIdSupport())) {
+                return;
+            }
+            // https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/setSinkId
+            if (!device) {
+                await this._context.setSinkId('');
+            }
+            else {
+                await this._context.setSinkId(device.deviceId);
+            }
+        }
+        async getOutputDevice() {
+            if (!(await this.checkSinkIdSupport())) {
+                return null;
+            }
+            // https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/sinkId
+            const sinkId = this._context.sinkId;
+            if (typeof sinkId !== 'string' || sinkId === '' || sinkId === 'default') {
+                return null;
+            }
+            // fast path -> cached devices list
+            let device = this._knownDevices.find(d => d.deviceId === sinkId);
+            if (device) {
+                return device;
+            }
+            // slow path -> enumerate devices
+            const allDevices = await this.enumerateOutputDevices();
+            device = allDevices.find(d => d.deviceId === sinkId);
+            if (device) {
+                return device;
+            }
+            Logger.warning('WebAudio', 'Could not find output device in device list', sinkId, allDevices);
+            return null;
+        }
     }
     AlphaSynthWebAudioOutputBase.BufferSize = 4096;
     AlphaSynthWebAudioOutputBase.PreferredSampleRate = 44100;
@@ -34076,6 +34228,9 @@
      * @target web
      */
     class AlphaSynthWebWorkerApi {
+        get output() {
+            return this._output;
+        }
         get isReady() {
             return this._workerIsReady && this._outputIsReady;
         }
@@ -52133,8 +52288,8 @@
     // </auto-generated>
     class VersionInfo {
     }
-    VersionInfo.version = '1.4.0';
-    VersionInfo.date = '2025-03-02T15:59:05.431Z';
+    VersionInfo.version = '1.5.0-alpha.1331';
+    VersionInfo.date = '2025-03-03T01:56:53.590Z';
 
     var index$4 = /*#__PURE__*/Object.freeze({
         __proto__: null,