@coderline/alphatab 1.6.1 → 1.6.2

package/dist/alphaTab.core.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab v1.6.1 (, build 20)
+ * alphaTab v1.6.2 (, build 21)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -13745,9 +13745,7 @@ class BinaryStylesheet {
         return writer.toArray();
     }
     static addHeaderAndFooter(binaryStylesheet, style, prefix, name) {
-        if (style.template !== undefined) {
-            binaryStylesheet.addValue(`${prefix}${name}`, style.template, DataType.String);
-        }
+        binaryStylesheet.addValue(`${prefix}${name}`, style.template, DataType.String);
         binaryStylesheet.addValue(`${prefix}${name}Alignment`, style.textAlign, DataType.Integer);
         if (style.isVisible !== undefined) {
             binaryStylesheet.addValue(`${prefix}draw${name}`, style.isVisible, DataType.Boolean);
@@ -28320,11 +28318,15 @@ class TinySoundFont {
 }
 
 class EventEmitter {
-    constructor() {
+    constructor(fireOnRegister = undefined) {
         this._listeners = [];
+        this._fireOnRegister = fireOnRegister;
     }
     on(value) {
         this._listeners.push(value);
+        if (this._fireOnRegister?.()) {
+            value();
+        }
         return () => {
             this.off(value);
         };
@@ -28342,11 +28344,18 @@ class EventEmitter {
  * @partial
  */
 class EventEmitterOfT {
-    constructor() {
+    constructor(fireOnRegister = undefined) {
         this._listeners = [];
+        this._fireOnRegister = fireOnRegister;
     }
     on(value) {
         this._listeners.push(value);
+        if (this._fireOnRegister) {
+            const arg = this._fireOnRegister();
+            if (arg !== null) {
+                value(arg);
+            }
+        }
         return () => {
             this.off(value);
         };
@@ -28523,6 +28532,12 @@ class AlphaSynthBase {
         this.sequencer.playbackSpeed = value;
         this.timePosition = this.timePosition * (oldSpeed / value);
     }
+    get loadedMidiInfo() {
+        return this._loadedMidiInfo;
+    }
+    get currentPosition() {
+        return this._currentPosition;
+    }
     get tickPosition() {
         return this._tickPosition;
     }
@@ -28580,22 +28595,38 @@ class AlphaSynthBase {
         this._midiEventsPlayedFilter = new Set();
         this._notPlayedSamples = 0;
         this._synthStopping = false;
+        this._currentPosition = new PositionChangedEventArgs(0, 0, 0, 0, false, 120, 120);
         this.isReady = false;
         this.state = PlayerState.Paused;
         this._loadedSoundFonts = [];
-        this.ready = new EventEmitter();
         this.readyForPlayback = new EventEmitter();
         this.finished = new EventEmitter();
         this.soundFontLoaded = new EventEmitter();
         this.soundFontLoadFailed = new EventEmitterOfT();
-        this.midiLoaded = new EventEmitterOfT();
         this.midiLoadFailed = new EventEmitterOfT();
-        this.stateChanged = new EventEmitterOfT();
-        this.positionChanged = new EventEmitterOfT();
         this.midiEventsPlayed = new EventEmitterOfT();
-        this.playbackRangeChanged = new EventEmitterOfT();
         Logger.debug('AlphaSynth', 'Initializing player');
         this.state = PlayerState.Paused;
+        this.ready = new EventEmitter(() => this.isReady);
+        this.readyForPlayback = new EventEmitter(() => this.isReadyForPlayback);
+        this.midiLoaded = new EventEmitterOfT(() => {
+            if (this._loadedMidiInfo) {
+                return this._loadedMidiInfo;
+            }
+            return null;
+        });
+        this.stateChanged = new EventEmitterOfT(() => {
+            return new PlayerStateChangedEventArgs(this.state, false);
+        });
+        this.positionChanged = new EventEmitterOfT(() => {
+            return this._currentPosition;
+        });
+        this.playbackRangeChanged = new EventEmitterOfT(() => {
+            if (this.playbackRange) {
+                return new PlaybackRangeChangedEventArgs(this.playbackRange);
+            }
+            return null;
+        });
         Logger.debug('AlphaSynth', 'Creating output');
         this._output = output;
         Logger.debug('AlphaSynth', 'Creating synthesizer');
@@ -28773,7 +28804,8 @@ class AlphaSynthBase {
             Logger.debug('AlphaSynth', 'Loading midi from model');
             this.sequencer.loadMidi(midi);
             this._isMidiLoaded = true;
-            this.midiLoaded.trigger(new PositionChangedEventArgs(0, this.sequencer.currentEndTime, 0, this.sequencer.currentEndTick, false, this.sequencer.currentTempo, this.sequencer.modifiedTempo));
+            this._loadedMidiInfo = new PositionChangedEventArgs(0, this.sequencer.currentEndTime, 0, this.sequencer.currentEndTick, false, this.sequencer.currentTempo, this.sequencer.modifiedTempo);
+            this.midiLoaded.trigger(this._loadedMidiInfo);
             Logger.debug('AlphaSynth', 'Midi successfully loaded');
             this.checkReadyForPlayback();
             this.tickPosition = 0;
@@ -28876,23 +28908,28 @@ class AlphaSynthBase {
         this.sequencer.resetOneTimeMidi();
         this.timePosition = this.sequencer.currentTime;
     }
-    updateTimePosition(timePosition, isSeek) {
-        // update the real positions
-        let currentTime = timePosition;
-        this._timePosition = currentTime;
+    createPositionChangedEventArgs(isSeek) {
+        // on fade outs we can have some milliseconds longer, ensure we don't report this
+        let currentTime = this._timePosition;
         let currentTick = this.sequencer.currentTimePositionToTickPosition(currentTime);
-        this._tickPosition = currentTick;
         const endTime = this.sequencer.currentEndTime;
         const endTick = this.sequencer.currentEndTick;
-        // on fade outs we can have some milliseconds longer, ensure we don't report this
         if (currentTime > endTime) {
             currentTime = endTime;
             currentTick = endTick;
         }
+        return new PositionChangedEventArgs(currentTime, endTime, currentTick, endTick, isSeek, this.sequencer.currentTempo, this.sequencer.modifiedTempo);
+    }
+    updateTimePosition(timePosition, isSeek) {
+        // update the real positions
+        this._timePosition = timePosition;
+        const args = this.createPositionChangedEventArgs(isSeek);
+        this._tickPosition = args.currentTick;
         const mode = this.sequencer.isPlayingMain ? 'main' : this.sequencer.isPlayingCountIn ? 'count-in' : 'one-time';
-        Logger.debug('AlphaSynth', `Position changed: (time: ${currentTime}/${endTime}, tick: ${currentTick}/${endTick}, Active Voices: ${this.synthesizer.activeVoiceCount} (${mode}), Tempo original: ${this.sequencer.currentTempo}, Tempo modified: ${this.sequencer.modifiedTempo})`);
+        Logger.debug('AlphaSynth', `Position changed: (time: ${args.currentTime}/${args.endTime}, tick: ${args.currentTick}/${args.endTick}, Active Voices: ${this.synthesizer.activeVoiceCount} (${mode}), Tempo original: ${this.sequencer.currentTempo}, Tempo modified: ${this.sequencer.modifiedTempo})`);
         if (this.sequencer.isPlayingMain) {
-            this.positionChanged.trigger(new PositionChangedEventArgs(currentTime, endTime, currentTick, endTick, isSeek, this.sequencer.currentTempo, this.sequencer.modifiedTempo));
+            this._currentPosition = args;
+            this.positionChanged.trigger(args);
         }
         // build events which were actually played
         if (isSeek) {
@@ -28900,7 +28937,7 @@ class AlphaSynthBase {
         }
         else {
             const playedEvents = [];
-            while (!this._playedEventsQueue.isEmpty && this._playedEventsQueue.peek().time < currentTime) {
+            while (!this._playedEventsQueue.isEmpty && this._playedEventsQueue.peek().time < args.currentTime) {
                 const synthEvent = this._playedEventsQueue.dequeue();
                 playedEvents.push(synthEvent.event);
             }
@@ -31446,6 +31483,15 @@ class Settings {
     fillFromJson(json) {
         SettingsSerializer.fromJson(this, json);
     }
+    /**
+     * handles backwards compatibility aspects on the settings, removed in 2.0
+     * @internal
+     */
+    handleBackwardsCompatibility() {
+        if (this.player.playerMode === PlayerMode.Disabled && this.player.enablePlayer) {
+            this.player.playerMode = PlayerMode.EnabledAutomatic;
+        }
+    }
 }
 
 class SectionSerializer {
@@ -39128,17 +39174,29 @@ class AlphaSynthWrapper {
         this._playbackSpeed = 1;
         this._isLooping = false;
         this._midiEventsPlayedFilter = [];
-        this.ready = new EventEmitter();
-        this.readyForPlayback = new EventEmitter();
         this.finished = new EventEmitter();
         this.soundFontLoaded = new EventEmitter();
         this.soundFontLoadFailed = new EventEmitterOfT();
-        this.midiLoaded = new EventEmitterOfT();
         this.midiLoadFailed = new EventEmitterOfT();
-        this.stateChanged = new EventEmitterOfT();
-        this.positionChanged = new EventEmitterOfT();
         this.midiEventsPlayed = new EventEmitterOfT();
-        this.playbackRangeChanged = new EventEmitterOfT();
+        this.ready = new EventEmitter(() => this.isReady);
+        this.readyForPlayback = new EventEmitter(() => this.isReadyForPlayback);
+        this.midiLoaded = new EventEmitterOfT(() => {
+            return this._instance?.loadedMidiInfo ?? null;
+        });
+        this.stateChanged = new EventEmitterOfT(() => {
+            return new PlayerStateChangedEventArgs(this.state, false);
+        });
+        this.positionChanged = new EventEmitterOfT(() => {
+            return this.currentPosition;
+        });
+        this.playbackRangeChanged = new EventEmitterOfT(() => {
+            const range = this.playbackRange;
+            if (range) {
+                return new PlaybackRangeChangedEventArgs(range);
+            }
+            return null;
+        });
     }
     get instance() {
         return this._instance;
@@ -39160,10 +39218,14 @@ class AlphaSynthWrapper {
             newUnregister.push(value.finished.on(() => this.finished.trigger()));
             newUnregister.push(value.soundFontLoaded.on(() => this.soundFontLoaded.trigger()));
             newUnregister.push(value.soundFontLoadFailed.on(e => this.soundFontLoadFailed.trigger(e)));
-            newUnregister.push(value.midiLoaded.on(e => this.midiLoaded.trigger(e)));
+            newUnregister.push(value.midiLoaded.on(e => {
+                this.midiLoaded.trigger(e);
+            }));
             newUnregister.push(value.midiLoadFailed.on(e => this.midiLoadFailed.trigger(e)));
             newUnregister.push(value.stateChanged.on(e => this.stateChanged.trigger(e)));
-            newUnregister.push(value.positionChanged.on(e => this.positionChanged.trigger(e)));
+            newUnregister.push(value.positionChanged.on(e => {
+                this.positionChanged.trigger(e);
+            }));
             newUnregister.push(value.midiEventsPlayed.on(e => this.midiEventsPlayed.trigger(e)));
             newUnregister.push(value.playbackRangeChanged.on(e => this.playbackRangeChanged.trigger(e)));
             this._instanceEventUnregister = newUnregister;
@@ -39242,6 +39304,14 @@ class AlphaSynthWrapper {
             this._instance.playbackSpeed = value;
         }
     }
+    get loadedMidiInfo() {
+        return this._instance ? this._instance.loadedMidiInfo : undefined;
+    }
+    get currentPosition() {
+        return this._instance
+            ? this._instance.currentPosition
+            : new PositionChangedEventArgs(0, 0, 0, 0, false, 120, 120);
+    }
     get tickPosition() {
         return this._instance ? this._instance.tickPosition : 0;
     }
@@ -39583,83 +39653,6 @@ class AlphaTabApiBase {
         this._previousStateForCursor = PlayerState.Paused;
         this._previousCursorCache = null;
         this._lastScroll = 0;
-        /**
-         * This event is fired when the played beat changed.
-         *
-         * @eventProperty
-         * @category Events - Player
-         * @since 0.9.4
-         *
-         * @example
-         * JavaScript
-         * ```js
-         * const api = new alphaTab.AlphaTabApi(document.querySelector('#alphaTab'));
-         * api.playedBeatChanged.on((beat) => {
-         *     updateFretboard(beat);
-         * });
-         * ```
-         *
-         * @example
-         * C#
-         * ```cs
-         * var api = new AlphaTabApi<MyControl>(...);
-         * api.PlayedBeatChanged.On(beat =>
-         * {
-         *     UpdateFretboard(beat);
-         * });
-         * ```
-         *
-         * @example
-         * Android
-         * ```kotlin
-         * val api = AlphaTabApi<MyControl>(...)
-         * api.playedBeatChanged.on { beat ->
-         *     updateFretboard(beat)
-         * }
-         * ```
-         *
-         */
-        this.playedBeatChanged = new EventEmitterOfT();
-        /**
-         * This event is fired when the currently active beats across all tracks change.
-         *
-         * @remarks
-         * Unlike the {@link playedBeatChanged} event this event contains the beats of all tracks and voices independent of them being rendered.
-         *
-         * @eventProperty
-         * @category Events - Player
-         * @since 1.2.3
-         *
-         * @example
-         * JavaScript
-         * ```js
-         * const api = new alphaTab.AlphaTabApi(document.querySelector('#alphaTab'));
-         * api.activeBeatsChanged.on(args => {
-         *    updateHighlights(args.activeBeats);
-         * });
-         * ```
-         *
-         * @example
-         * C#
-         * ```cs
-         * var api = new AlphaTabApi<MyControl>(...);
-         * api.ActiveBeatsChanged.On(args =>
-         * {
-         *     UpdateHighlights(args.ActiveBeats);
-         * });
-         * ```
-         *
-         * @example
-         * Android
-         * ```kotlin
-         * val api = AlphaTabApi<MyControl>(...)
-         * api.activeBeatsChanged.on { args ->
-         *     updateHighlights(args.activeBeats)
-         * }
-         * ```
-         *
-         */
-        this.activeBeatsChanged = new EventEmitterOfT();
         this._beatMouseDown = false;
         this._noteMouseDown = false;
         this._selectionStart = null;
@@ -39898,47 +39891,6 @@ class AlphaTabApiBase {
          *
          */
         this.noteMouseUp = new EventEmitterOfT();
-        /**
-         * This event is fired whenever a new song is loaded.
-         * @remarks
-         * This event is fired whenever a new song is loaded or changing due to {@link renderScore} or {@link renderTracks} calls.
-         * It is fired after the transposition midi pitches from the settings were applied, but before any midi is generated or rendering is started.
-         * This allows any modification of the score before further processing.
-         *
-         * @eventProperty
-         * @category Events - Core
-         * @since 0.9.4
-         *
-         * @example
-         * JavaScript
-         * ```js
-         * const api = new alphaTab.AlphaTabApi(document.querySelector('#alphaTab'));
-         * api.scoreLoaded.on((score) => {
-         *     updateSongInformationInUi(score);
-         * });
-         * ```
-         *
-         * @example
-         * C#
-         * ```cs
-         * var api = new AlphaTabApi<MyControl>(...);
-         * api.ScoreLoaded.On(score =>
-         * {
-         *     UpdateSongInformationInUi(score);
-         * });
-         * ```
-         *
-         * @example
-         * Android
-         * ```kotlin
-         * val api = AlphaTabApi<MyControl>(...)
-         * api.scoreLoaded.on { score ->
-         *     updateSongInformationInUi(score)
-         * }
-         * ```
-         *
-         */
-        this.scoreLoaded = new EventEmitterOfT();
         /**
          * This event is fired when alphaTab was resized and is about to rerender the music notation.
          * @remarks
@@ -40197,46 +40149,6 @@ class AlphaTabApiBase {
          *
          */
         this.midiLoad = new EventEmitterOfT();
-        /**
-         * This event is fired when the Midi file needed for playback was loaded.
-         *
-         * @eventProperty
-         * @category Events - Player
-         * @since 0.9.4
-         *
-         * @example
-         * JavaScript
-         * ```js
-         * const api = new alphaTab.AlphaTabApi(document.querySelector('#alphaTab'));
-         * api.midiLoaded.on(e => {
-         *     hideGeneratingAudioIndicator();
-         *     updateSongDuration(e.endTime);
-         * });
-         * ```
-         *
-         * @example
-         * C#
-         * ```cs
-         * var api = new AlphaTabApi<MyControl>(...);
-         * api.MidiLoaded.On(e =>
-         * {
-         *     HideGeneratingAudioIndicator();
-         *     UpdateSongDuration(e.EndTime);
-         * });
-         * ```
-         *
-         * @example
-         * Android
-         * ```kotlin
-         * val api = AlphaTabApi<MyControl>(...)
-         * api.midiLoaded.on { e ->
-         *     hideGeneratingAudioIndicator()
-         *     updateSongDuration(e.endTime)
-         * }
-         * ```
-         *
-         */
-        this.midiLoaded = new EventEmitterOfT();
         /**
          * This event is fired when a settings update was requested.
          *
@@ -40276,12 +40188,30 @@ class AlphaTabApiBase {
         this.settingsUpdated = new EventEmitter();
         this.uiFacade = uiFacade;
         this.container = uiFacade.rootContainer;
+        this.activeBeatsChanged = new EventEmitterOfT(() => {
+            if (this._player.state === PlayerState.Playing && this._currentBeat) {
+                return new ActiveBeatsChangedEventArgs(this._currentBeat.beatLookup.highlightedBeats.map(h => h.beat));
+            }
+            return null;
+        });
+        this.playedBeatChanged = new EventEmitterOfT(() => {
+            if (this._player.state === PlayerState.Playing && this._currentBeat) {
+                return this._currentBeat.beat;
+            }
+            return null;
+        });
+        this.scoreLoaded = new EventEmitterOfT(() => {
+            if (this._score) {
+                return this._score;
+            }
+            return null;
+        });
+        this.midiLoaded = new EventEmitterOfT(() => {
+            return this._player.loadedMidiInfo ?? null;
+        });
         uiFacade.initialize(this, settings);
         Logger.logLevel = this.settings.core.logLevel;
-        // backwards compatibility: remove in 2.0
-        if (this.settings.player.playerMode === PlayerMode.Disabled && this.settings.player.enablePlayer) {
-            this.settings.player.playerMode = PlayerMode.EnabledAutomatic;
-        }
+        this.settings.handleBackwardsCompatibility();
         Environment.printEnvironmentInfo(false);
         this.canvasElement = uiFacade.createCanvasElement();
         this.container.appendChild(this.canvasElement);
@@ -40440,6 +40370,7 @@ class AlphaTabApiBase {
      * ```
      */
     updateSettings() {
+        this.settings.handleBackwardsCompatibility();
         const score = this.score;
         if (score) {
             ModelUtils.applyPitchOffsets(this.settings, score);
@@ -41247,6 +41178,22 @@ class AlphaTabApiBase {
     set timePosition(value) {
         this._player.timePosition = value;
     }
+    /**
+     * The total length of the song in midi ticks.
+     * @category Properties - Player
+     * @since 1.6.2
+     */
+    get endTick() {
+        return this._player.currentPosition.endTick;
+    }
+    /**
+     * The total length of the song in milliseconds.
+     * @category Properties - Player
+     * @since 1.6.2
+     */
+    get endTime() {
+        return this._player.currentPosition.endTime;
+    }
     /**
      * The range of the song that should be played.
      * @remarks
@@ -43886,27 +43833,33 @@ class AlphaSynthWebWorkerApi {
             value: value
         });
     }
+    get loadedMidiInfo() {
+        return this.loadedMidiInfo;
+    }
+    get currentPosition() {
+        return this._currentPosition;
+    }
     get tickPosition() {
-        return this._tickPosition;
+        return this._currentPosition.currentTick;
     }
     set tickPosition(value) {
         if (value < 0) {
             value = 0;
         }
-        this._tickPosition = value;
+        this._currentPosition = new PositionChangedEventArgs(this._currentPosition.currentTime, this._currentPosition.endTime, value, this._currentPosition.endTick, true, this._currentPosition.originalTempo, this._currentPosition.modifiedTempo);
         this._synth.postMessage({
             cmd: 'alphaSynth.setTickPosition',
             value: value
         });
     }
     get timePosition() {
-        return this._timePosition;
+        return this._currentPosition.currentTime;
     }
     set timePosition(value) {
         if (value < 0) {
             value = 0;
         }
-        this._timePosition = value;
+        this._currentPosition = new PositionChangedEventArgs(value, this._currentPosition.endTime, this._currentPosition.currentTick, this._currentPosition.endTick, true, this._currentPosition.originalTempo, this._currentPosition.modifiedTempo);
         this._synth.postMessage({
             cmd: 'alphaSynth.setTimePosition',
             value: value
@@ -43949,11 +43902,10 @@ class AlphaSynthWebWorkerApi {
         this._metronomeVolume = 0;
         this._countInVolume = 0;
         this._playbackSpeed = 0;
-        this._tickPosition = 0;
-        this._timePosition = 0;
         this._isLooping = false;
         this._playbackRange = null;
         this._midiEventsPlayedFilter = [];
+        this._currentPosition = new PositionChangedEventArgs(0, 0, 0, 0, false, 120, 120);
         this.ready = new EventEmitter();
         this.readyForPlayback = new EventEmitter();
         this.finished = new EventEmitter();
@@ -43972,8 +43924,6 @@ class AlphaSynthWebWorkerApi {
         this._masterVolume = 0.0;
         this._metronomeVolume = 0.0;
         this._playbackSpeed = 0.0;
-        this._tickPosition = 0;
-        this._timePosition = 0.0;
         this._isLooping = false;
         this._playbackRange = null;
         this._output = player;
@@ -44108,9 +44058,8 @@ class AlphaSynthWebWorkerApi {
                 this.checkReadyForPlayback();
                 break;
             case 'alphaSynth.positionChanged':
-                this._timePosition = data.currentTime;
-                this._tickPosition = data.currentTick;
-                this.positionChanged.trigger(new PositionChangedEventArgs(data.currentTime, data.endTime, data.currentTick, data.endTick, data.isSeek, data.originalTempo, data.modifiedTempo));
+                this._currentPosition = new PositionChangedEventArgs(data.currentTime, data.endTime, data.currentTick, data.endTick, data.isSeek, data.originalTempo, data.modifiedTempo);
+                this.positionChanged.trigger(this._currentPosition);
                 break;
             case 'alphaSynth.midiEventsPlayed':
                 this.midiEventsPlayed.trigger(new MidiEventsPlayedEventArgs(data.events.map(JsonConverter.jsObjectToMidiEvent)));
@@ -44134,7 +44083,8 @@ class AlphaSynthWebWorkerApi {
                 break;
             case 'alphaSynth.midiLoaded':
                 this.checkReadyForPlayback();
-                this.midiLoaded.trigger(new PositionChangedEventArgs(data.currentTime, data.endTime, data.currentTick, data.endTick, data.isSeek, data.originalTempo, data.modifiedTempo));
+                this._loadedMidiInfo = new PositionChangedEventArgs(data.currentTime, data.endTime, data.currentTick, data.endTick, data.isSeek, data.originalTempo, data.modifiedTempo);
+                this.midiLoaded.trigger(this._loadedMidiInfo);
                 break;
             case 'alphaSynth.midiLoadFailed':
                 this.checkReadyForPlayback();
@@ -61789,9 +61739,9 @@ class VersionInfo {
         print(`build date: ${VersionInfo.date}`);
     }
 }
-VersionInfo.version = '1.6.1';
-VersionInfo.date = '2025-07-23T21:10:31.910Z';
-VersionInfo.commit = '4f78524781ce9441cba1267d45a983c6ac92b977';
+VersionInfo.version = '1.6.2';
+VersionInfo.date = '2025-08-23T16:08:14.997Z';
+VersionInfo.commit = '7a3395e57a19e6e78397974ab295db87b6cc7bff';
 
 /**
  * A factory for custom layout engines.