@coderline/alphatab 1.6.1 → 1.6.2

package/dist/alphaTab.js

@@ -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.
  *
@@ -13751,9 +13751,7 @@
             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);
@@ -28326,11 +28324,15 @@
     }
 
     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);
             };
@@ -28348,11 +28350,18 @@
      * @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);
             };
@@ -28529,6 +28538,12 @@
             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;
         }
@@ -28586,22 +28601,38 @@
             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');
@@ -28779,7 +28810,8 @@
                 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;
@@ -28882,23 +28914,28 @@
             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) {
@@ -28906,7 +28943,7 @@
             }
             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);
                 }
@@ -31452,6 +31489,15 @@
         fillFromJson(json) {
             SettingsSerializer.fromJson(this, json);
         }
+        /**
+         * handles backwards compatibility aspects on the settings, removed in 2.0
+         * @internal
+         */
+        handleBackwardsCompatibility() {
+            if (this.player.playerMode === exports.PlayerMode.Disabled && this.player.enablePlayer) {
+                this.player.playerMode = exports.PlayerMode.EnabledAutomatic;
+            }
+        }
     }
 
     class SectionSerializer {
@@ -39134,17 +39180,29 @@
             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;
@@ -39166,10 +39224,14 @@
                 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;
@@ -39248,6 +39310,14 @@
                 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;
         }
@@ -39589,83 +39659,6 @@
             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;
@@ -39904,47 +39897,6 @@
              *
              */
             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
@@ -40203,46 +40155,6 @@
              *
              */
             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.
              *
@@ -40282,12 +40194,30 @@
             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 === exports.PlayerMode.Disabled && this.settings.player.enablePlayer) {
-                this.settings.player.playerMode = exports.PlayerMode.EnabledAutomatic;
-            }
+            this.settings.handleBackwardsCompatibility();
             Environment.printEnvironmentInfo(false);
             this.canvasElement = uiFacade.createCanvasElement();
             this.container.appendChild(this.canvasElement);
@@ -40446,6 +40376,7 @@
          * ```
          */
         updateSettings() {
+            this.settings.handleBackwardsCompatibility();
             const score = this.score;
             if (score) {
                 ModelUtils.applyPitchOffsets(this.settings, score);
@@ -41253,6 +41184,22 @@
         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
@@ -43892,27 +43839,33 @@
                 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
@@ -43955,11 +43908,10 @@
             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();
@@ -43978,8 +43930,6 @@
             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;
@@ -44114,9 +44064,8 @@
                     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)));
@@ -44140,7 +44089,8 @@
                     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();
@@ -61795,9 +61745,9 @@
             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.