@coderline/alphatab 1.4.0 → 1.4.3

package/dist/alphaTab.core.mjs

@@ -1,5 +1,5 @@
 /**
- * alphaTab v1.4.0 (, build 12)
+ * alphaTab v1.4.3 (, build 16)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -24332,10 +24332,10 @@ class Hydra {
                 // 6.1 Sample Data Format in the smpl Sub-chunk
                 // The smpl sub-chunk, if present, contains one or more "samples" of digital audio information in the form
                 // of linearly coded sixteen bit, signed, little endian (least significant byte first) words.
-                let shorts = new Int16Array(sampleBytes.buffer);
-                samples = new Float32Array(shorts.length);
-                for (let i = 0; i < shorts.length; i++) {
-                    samples[i] = shorts[i] / 32767;
+                const dataView = new DataView(sampleBytes.buffer, sampleBytes.byteOffset, sampleBytes.length);
+                samples = new Float32Array(sampleBytes.length / 2);
+                for (let i = 0; i < samples.length; i++) {
+                    samples[i] = dataView.getInt16(i * 2, true) / 32767;
                 }
             }
             this._sampleCache.set(key, samples);
@@ -28032,6 +28032,7 @@ class BeatBounds {
     finish(scale = 1) {
         this.realBounds.scaleWith(scale);
         this.visualBounds.scaleWith(scale);
+        this.onNotesX *= scale;
         if (this.notes) {
             for (const n of this.notes) {
                 n.finish(scale);
@@ -29799,6 +29800,24 @@ class MasterBarTickLookup {
     }
 }
 
+/**
+ * Describes how a cursor should be moving.
+ */
+var MidiTickLookupFindBeatResultCursorMode;
+(function (MidiTickLookupFindBeatResultCursorMode) {
+    /**
+     * Unknown/Undetermined mode. Should not happen on user level.
+     */
+    MidiTickLookupFindBeatResultCursorMode[MidiTickLookupFindBeatResultCursorMode["Unknown"] = 0] = "Unknown";
+    /**
+     * The cursor should animate to the next beat.
+     */
+    MidiTickLookupFindBeatResultCursorMode[MidiTickLookupFindBeatResultCursorMode["ToNextBext"] = 1] = "ToNextBext";
+    /**
+     * The cursor should animate to the end of the bar (typically on repeats and jumps)
+     */
+    MidiTickLookupFindBeatResultCursorMode[MidiTickLookupFindBeatResultCursorMode["ToEndOfBar"] = 2] = "ToEndOfBar";
+})(MidiTickLookupFindBeatResultCursorMode || (MidiTickLookupFindBeatResultCursorMode = {}));
 /**
  * Represents the results of searching the currently played beat.
  * @see MidiTickLookup.FindBeat
@@ -29823,6 +29842,10 @@ class MidiTickLookupFindBeatResult {
          * Gets or sets the duration in milliseconds how long this lookup is valid.
          */
         this.duration = 0;
+        /**
+         * The mode how the cursor should be handled.
+         */
+        this.cursorMode = MidiTickLookupFindBeatResultCursorMode.Unknown;
         this.masterBar = masterBar;
     }
     calculateDuration() {
@@ -29831,7 +29854,7 @@ class MidiTickLookupFindBeatResult {
             this.duration = MidiUtils.ticksToMillis(this.tickDuration, this.masterBar.tempoChanges[0].tempo);
         }
         else {
-            // Performance Note: I still wonder if we cannot calculate these slices efficiently ahead-of-time. 
+            // Performance Note: I still wonder if we cannot calculate these slices efficiently ahead-of-time.
             // the sub-slicing in the lookup across beats makes it a bit tricky to do on-the-fly
             // but maybe on finalizing the tick lookup?
             // slow path: need to walk through the tick time-axis and calculate for each slice the milliseconds
@@ -29947,20 +29970,30 @@ class MidiTickLookup {
         return null;
     }
     fillNextBeat(current, trackLookup) {
-        current.nextBeat = this.findBeatInMasterBar(current.masterBar, current.beatLookup.nextBeat, current.end, trackLookup, false, true);
+        current.nextBeat = this.findBeatInMasterBar(current.masterBar, current.beatLookup.nextBeat, current.end, trackLookup, true);
         if (current.nextBeat == null) {
             current.nextBeat = this.findBeatSlow(trackLookup, current, current.end, true);
         }
         // if we have the next beat take the difference between the times as duration
         if (current.nextBeat) {
             current.tickDuration = current.nextBeat.start - current.start;
+            current.cursorMode = MidiTickLookupFindBeatResultCursorMode.ToNextBext;
             current.calculateDuration();
         }
         // no next beat, animate to the end of the bar (could be an incomplete bar)
         if (!current.nextBeat) {
             current.tickDuration = current.masterBar.end - current.start;
+            current.cursorMode = MidiTickLookupFindBeatResultCursorMode.ToEndOfBar;
             current.calculateDuration();
         }
+        // if the next beat is not directly the next master bar (e.g. jumping back or forth)
+        // we report no next beat and animate to the end
+        if (current.nextBeat &&
+            current.nextBeat.masterBar.masterBar.index != current.masterBar.masterBar.index + 1 &&
+            (current.nextBeat.masterBar.masterBar.index != current.masterBar.masterBar.index ||
+                current.nextBeat.beat.playbackStart <= current.beat.playbackStart)) {
+            current.cursorMode = MidiTickLookupFindBeatResultCursorMode.ToEndOfBar;
+        }
     }
     findBeatSlow(trackLookup, currentBeatHint, tick, isNextSearch) {
         // get all beats within the masterbar
@@ -29988,7 +30021,7 @@ class MidiTickLookup {
         // scan through beats and find first one which has a beat visible
         while (masterBar) {
             if (masterBar.firstBeat) {
-                let beat = this.findBeatInMasterBar(masterBar, masterBar.firstBeat, tick, trackLookup, true, isNextSearch);
+                let beat = this.findBeatInMasterBar(masterBar, masterBar.firstBeat, tick, trackLookup, isNextSearch);
                 if (beat) {
                     return beat;
                 }
@@ -30003,10 +30036,10 @@ class MidiTickLookup {
      * @param currentStartLookup
      * @param tick
      * @param visibleTracks
-     * @param fillNext
+     * @param isNextSearch
      * @returns
      */
-    findBeatInMasterBar(masterBar, currentStartLookup, tick, visibleTracks, fillNext, isNextSeach) {
+    findBeatInMasterBar(masterBar, currentStartLookup, tick, visibleTracks, isNextSearch) {
         if (!currentStartLookup) {
             return null;
         }
@@ -30020,7 +30053,7 @@ class MidiTickLookup {
                 // found the matching beat lookup but none of the beats are visible
                 // in this case scan further to the next lookup which has any visible beat
                 if (!startBeat) {
-                    if (isNextSeach) {
+                    if (isNextSearch) {
                         let currentMasterBar = masterBar;
                         while (currentMasterBar != null && startBeat == null) {
                             while (currentStartLookup != null) {
@@ -30066,15 +30099,15 @@ class MidiTickLookup {
         if (startBeat == null) {
             return null;
         }
-        const result = this.createResult(masterBar, startBeatLookup, startBeat, fillNext, visibleTracks);
+        const result = this.createResult(masterBar, startBeatLookup, startBeat, isNextSearch, visibleTracks);
         return result;
     }
-    createResult(masterBar, beatLookup, beat, fillNext, visibleTracks) {
+    createResult(masterBar, beatLookup, beat, isNextSearch, visibleTracks) {
         const result = new MidiTickLookupFindBeatResult(masterBar);
         result.beat = beat;
         result.beatLookup = beatLookup;
         result.tickDuration = beatLookup.end - beatLookup.start;
-        if (fillNext) {
+        if (!isNextSearch) {
             this.fillNextBeat(result, visibleTracks);
         }
         result.calculateDuration();
@@ -32812,7 +32845,7 @@ class AlphaTabApiBase {
             this.player.positionChanged.on(e => {
                 this._previousTick = e.currentTick;
                 this.uiFacade.beginInvoke(() => {
-                    this.cursorUpdateTick(e.currentTick, false);
+                    this.cursorUpdateTick(e.currentTick, false, false, e.isSeek);
                 });
             });
             this.player.stateChanged.on(e => {
@@ -32833,14 +32866,14 @@ class AlphaTabApiBase {
      * @param stop
      * @param shouldScroll whether we should scroll to the bar (if scrolling is active)
      */
-    cursorUpdateTick(tick, stop, shouldScroll = false) {
+    cursorUpdateTick(tick, stop, shouldScroll = false, forceUpdate = false) {
         let cache = this._tickCache;
         if (cache) {
             let tracks = this._trackIndexLookup;
             if (tracks != null && tracks.size > 0) {
                 let beat = cache.findBeat(tracks, tick, this._currentBeat);
                 if (beat) {
-                    this.cursorUpdateBeat(beat, stop, shouldScroll);
+                    this.cursorUpdateBeat(beat, stop, shouldScroll, forceUpdate || this.playerState === PlayerState.Paused);
                 }
             }
         }
@@ -32866,7 +32899,8 @@ class AlphaTabApiBase {
         if (!forceUpdate &&
             beat === previousBeat?.beat &&
             cache === previousCache &&
-            previousState === this._playerState) {
+            previousState === this._playerState &&
+            previousBeat?.start === lookupResult.start) {
             return;
         }
         let beatBoundings = cache.findBeat(beat);
@@ -32879,7 +32913,7 @@ class AlphaTabApiBase {
         this._previousCursorCache = cache;
         this._previousStateForCursor = this._playerState;
         this.uiFacade.beginInvoke(() => {
-            this.internalCursorUpdateBeat(beat, nextBeat, duration, stop, beatsToHighlight, cache, beatBoundings, shouldScroll);
+            this.internalCursorUpdateBeat(beat, nextBeat, duration, stop, beatsToHighlight, cache, beatBoundings, shouldScroll, lookupResult.cursorMode);
         });
     }
     /**
@@ -32942,7 +32976,7 @@ class AlphaTabApiBase {
             }
         }
     }
-    internalCursorUpdateBeat(beat, nextBeat, duration, stop, beatsToHighlight, cache, beatBoundings, shouldScroll) {
+    internalCursorUpdateBeat(beat, nextBeat, duration, stop, beatsToHighlight, cache, beatBoundings, shouldScroll, cursorMode) {
         const barCursor = this._barCursor;
         const beatCursor = this._beatCursor;
         let barBoundings = beatBoundings.barBounds.masterBarBounds;
@@ -32974,7 +33008,7 @@ class AlphaTabApiBase {
             if (this.settings.player.enableAnimatedBeatCursor) {
                 let nextBeatX = barBoundings.visualBounds.x + barBoundings.visualBounds.w;
                 // get position of next beat on same system
-                if (nextBeat) {
+                if (nextBeat && cursorMode == MidiTickLookupFindBeatResultCursorMode.ToNextBext) {
                     // if we are moving within the same bar or to the next bar
                     // transition to the next beat, otherwise transition to the end of the bar.
                     let nextBeatBoundings = cache.findBeat(nextBeat);
@@ -52127,8 +52161,8 @@ class CoreSettings {
 // </auto-generated>
 class VersionInfo {
 }
-VersionInfo.version = '1.4.0';
-VersionInfo.date = '2025-03-02T15:59:05.431Z';
+VersionInfo.version = '1.4.3';
+VersionInfo.date = '2025-04-13T21:11:16.350Z';
 
 var index$4 = /*#__PURE__*/Object.freeze({
     __proto__: null,

package/dist/alphaTab.d.ts

@@ -7057,6 +7057,23 @@ declare class MasterBarTickLookup {
     addBeat(beat: Beat, beatPlaybackStart: number, sliceStart: number, sliceDuration: number): void;
 }
 
+/**
+ * Describes how a cursor should be moving.
+ */
+declare enum MidiTickLookupFindBeatResultCursorMode {
+    /**
+     * Unknown/Undetermined mode. Should not happen on user level.
+     */
+    Unknown = 0,
+    /**
+     * The cursor should animate to the next beat.
+     */
+    ToNextBext = 1,
+    /**
+     * The cursor should animate to the end of the bar (typically on repeats and jumps)
+     */
+    ToEndOfBar = 2
+}
 /**
  * Represents the results of searching the currently played beat.
  * @see MidiTickLookup.FindBeat
@@ -7087,6 +7104,10 @@ declare class MidiTickLookupFindBeatResult {
      * Gets or sets the duration in milliseconds how long this lookup is valid.
      */
     duration: number;
+    /**
+     * The mode how the cursor should be handled.
+     */
+    cursorMode: MidiTickLookupFindBeatResultCursorMode;
     get start(): number;
     get end(): number;
     constructor(masterBar: MasterBarTickLookup);
@@ -7154,7 +7175,7 @@ declare class MidiTickLookup {
      * @param currentStartLookup
      * @param tick
      * @param visibleTracks
-     * @param fillNext
+     * @param isNextSearch
      * @returns
      */
     private findBeatInMasterBar;

package/dist/alphaTab.js

@@ -1,5 +1,5 @@
 /**
- * alphaTab v1.4.0 (, build 12)
+ * alphaTab v1.4.3 (, build 16)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -24338,10 +24338,10 @@
                     // 6.1 Sample Data Format in the smpl Sub-chunk
                     // The smpl sub-chunk, if present, contains one or more "samples" of digital audio information in the form
                     // of linearly coded sixteen bit, signed, little endian (least significant byte first) words.
-                    let shorts = new Int16Array(sampleBytes.buffer);
-                    samples = new Float32Array(shorts.length);
-                    for (let i = 0; i < shorts.length; i++) {
-                        samples[i] = shorts[i] / 32767;
+                    const dataView = new DataView(sampleBytes.buffer, sampleBytes.byteOffset, sampleBytes.length);
+                    samples = new Float32Array(sampleBytes.length / 2);
+                    for (let i = 0; i < samples.length; i++) {
+                        samples[i] = dataView.getInt16(i * 2, true) / 32767;
                     }
                 }
                 this._sampleCache.set(key, samples);
@@ -28038,6 +28038,7 @@
         finish(scale = 1) {
             this.realBounds.scaleWith(scale);
             this.visualBounds.scaleWith(scale);
+            this.onNotesX *= scale;
             if (this.notes) {
                 for (const n of this.notes) {
                     n.finish(scale);
@@ -29805,6 +29806,24 @@
         }
     }
 
+    /**
+     * Describes how a cursor should be moving.
+     */
+    var MidiTickLookupFindBeatResultCursorMode;
+    (function (MidiTickLookupFindBeatResultCursorMode) {
+        /**
+         * Unknown/Undetermined mode. Should not happen on user level.
+         */
+        MidiTickLookupFindBeatResultCursorMode[MidiTickLookupFindBeatResultCursorMode["Unknown"] = 0] = "Unknown";
+        /**
+         * The cursor should animate to the next beat.
+         */
+        MidiTickLookupFindBeatResultCursorMode[MidiTickLookupFindBeatResultCursorMode["ToNextBext"] = 1] = "ToNextBext";
+        /**
+         * The cursor should animate to the end of the bar (typically on repeats and jumps)
+         */
+        MidiTickLookupFindBeatResultCursorMode[MidiTickLookupFindBeatResultCursorMode["ToEndOfBar"] = 2] = "ToEndOfBar";
+    })(MidiTickLookupFindBeatResultCursorMode || (MidiTickLookupFindBeatResultCursorMode = {}));
     /**
      * Represents the results of searching the currently played beat.
      * @see MidiTickLookup.FindBeat
@@ -29829,6 +29848,10 @@
              * Gets or sets the duration in milliseconds how long this lookup is valid.
              */
             this.duration = 0;
+            /**
+             * The mode how the cursor should be handled.
+             */
+            this.cursorMode = MidiTickLookupFindBeatResultCursorMode.Unknown;
             this.masterBar = masterBar;
         }
         calculateDuration() {
@@ -29837,7 +29860,7 @@
                 this.duration = MidiUtils.ticksToMillis(this.tickDuration, this.masterBar.tempoChanges[0].tempo);
             }
             else {
-                // Performance Note: I still wonder if we cannot calculate these slices efficiently ahead-of-time. 
+                // Performance Note: I still wonder if we cannot calculate these slices efficiently ahead-of-time.
                 // the sub-slicing in the lookup across beats makes it a bit tricky to do on-the-fly
                 // but maybe on finalizing the tick lookup?
                 // slow path: need to walk through the tick time-axis and calculate for each slice the milliseconds
@@ -29953,20 +29976,30 @@
             return null;
         }
         fillNextBeat(current, trackLookup) {
-            current.nextBeat = this.findBeatInMasterBar(current.masterBar, current.beatLookup.nextBeat, current.end, trackLookup, false, true);
+            current.nextBeat = this.findBeatInMasterBar(current.masterBar, current.beatLookup.nextBeat, current.end, trackLookup, true);
             if (current.nextBeat == null) {
                 current.nextBeat = this.findBeatSlow(trackLookup, current, current.end, true);
             }
             // if we have the next beat take the difference between the times as duration
             if (current.nextBeat) {
                 current.tickDuration = current.nextBeat.start - current.start;
+                current.cursorMode = MidiTickLookupFindBeatResultCursorMode.ToNextBext;
                 current.calculateDuration();
             }
             // no next beat, animate to the end of the bar (could be an incomplete bar)
             if (!current.nextBeat) {
                 current.tickDuration = current.masterBar.end - current.start;
+                current.cursorMode = MidiTickLookupFindBeatResultCursorMode.ToEndOfBar;
                 current.calculateDuration();
             }
+            // if the next beat is not directly the next master bar (e.g. jumping back or forth)
+            // we report no next beat and animate to the end
+            if (current.nextBeat &&
+                current.nextBeat.masterBar.masterBar.index != current.masterBar.masterBar.index + 1 &&
+                (current.nextBeat.masterBar.masterBar.index != current.masterBar.masterBar.index ||
+                    current.nextBeat.beat.playbackStart <= current.beat.playbackStart)) {
+                current.cursorMode = MidiTickLookupFindBeatResultCursorMode.ToEndOfBar;
+            }
         }
         findBeatSlow(trackLookup, currentBeatHint, tick, isNextSearch) {
             // get all beats within the masterbar
@@ -29994,7 +30027,7 @@
             // scan through beats and find first one which has a beat visible
             while (masterBar) {
                 if (masterBar.firstBeat) {
-                    let beat = this.findBeatInMasterBar(masterBar, masterBar.firstBeat, tick, trackLookup, true, isNextSearch);
+                    let beat = this.findBeatInMasterBar(masterBar, masterBar.firstBeat, tick, trackLookup, isNextSearch);
                     if (beat) {
                         return beat;
                     }
@@ -30009,10 +30042,10 @@
          * @param currentStartLookup
          * @param tick
          * @param visibleTracks
-         * @param fillNext
+         * @param isNextSearch
          * @returns
          */
-        findBeatInMasterBar(masterBar, currentStartLookup, tick, visibleTracks, fillNext, isNextSeach) {
+        findBeatInMasterBar(masterBar, currentStartLookup, tick, visibleTracks, isNextSearch) {
             if (!currentStartLookup) {
                 return null;
             }
@@ -30026,7 +30059,7 @@
                     // found the matching beat lookup but none of the beats are visible
                     // in this case scan further to the next lookup which has any visible beat
                     if (!startBeat) {
-                        if (isNextSeach) {
+                        if (isNextSearch) {
                             let currentMasterBar = masterBar;
                             while (currentMasterBar != null && startBeat == null) {
                                 while (currentStartLookup != null) {
@@ -30072,15 +30105,15 @@
             if (startBeat == null) {
                 return null;
             }
-            const result = this.createResult(masterBar, startBeatLookup, startBeat, fillNext, visibleTracks);
+            const result = this.createResult(masterBar, startBeatLookup, startBeat, isNextSearch, visibleTracks);
             return result;
         }
-        createResult(masterBar, beatLookup, beat, fillNext, visibleTracks) {
+        createResult(masterBar, beatLookup, beat, isNextSearch, visibleTracks) {
             const result = new MidiTickLookupFindBeatResult(masterBar);
             result.beat = beat;
             result.beatLookup = beatLookup;
             result.tickDuration = beatLookup.end - beatLookup.start;
-            if (fillNext) {
+            if (!isNextSearch) {
                 this.fillNextBeat(result, visibleTracks);
             }
             result.calculateDuration();
@@ -32818,7 +32851,7 @@
                 this.player.positionChanged.on(e => {
                     this._previousTick = e.currentTick;
                     this.uiFacade.beginInvoke(() => {
-                        this.cursorUpdateTick(e.currentTick, false);
+                        this.cursorUpdateTick(e.currentTick, false, false, e.isSeek);
                     });
                 });
                 this.player.stateChanged.on(e => {
@@ -32839,14 +32872,14 @@
          * @param stop
          * @param shouldScroll whether we should scroll to the bar (if scrolling is active)
          */
-        cursorUpdateTick(tick, stop, shouldScroll = false) {
+        cursorUpdateTick(tick, stop, shouldScroll = false, forceUpdate = false) {
             let cache = this._tickCache;
             if (cache) {
                 let tracks = this._trackIndexLookup;
                 if (tracks != null && tracks.size > 0) {
                     let beat = cache.findBeat(tracks, tick, this._currentBeat);
                     if (beat) {
-                        this.cursorUpdateBeat(beat, stop, shouldScroll);
+                        this.cursorUpdateBeat(beat, stop, shouldScroll, forceUpdate || this.playerState === PlayerState.Paused);
                     }
                 }
             }
@@ -32872,7 +32905,8 @@
             if (!forceUpdate &&
                 beat === previousBeat?.beat &&
                 cache === previousCache &&
-                previousState === this._playerState) {
+                previousState === this._playerState &&
+                previousBeat?.start === lookupResult.start) {
                 return;
             }
             let beatBoundings = cache.findBeat(beat);
@@ -32885,7 +32919,7 @@
             this._previousCursorCache = cache;
             this._previousStateForCursor = this._playerState;
             this.uiFacade.beginInvoke(() => {
-                this.internalCursorUpdateBeat(beat, nextBeat, duration, stop, beatsToHighlight, cache, beatBoundings, shouldScroll);
+                this.internalCursorUpdateBeat(beat, nextBeat, duration, stop, beatsToHighlight, cache, beatBoundings, shouldScroll, lookupResult.cursorMode);
             });
         }
         /**
@@ -32948,7 +32982,7 @@
                 }
             }
         }
-        internalCursorUpdateBeat(beat, nextBeat, duration, stop, beatsToHighlight, cache, beatBoundings, shouldScroll) {
+        internalCursorUpdateBeat(beat, nextBeat, duration, stop, beatsToHighlight, cache, beatBoundings, shouldScroll, cursorMode) {
             const barCursor = this._barCursor;
             const beatCursor = this._beatCursor;
             let barBoundings = beatBoundings.barBounds.masterBarBounds;
@@ -32980,7 +33014,7 @@
                 if (this.settings.player.enableAnimatedBeatCursor) {
                     let nextBeatX = barBoundings.visualBounds.x + barBoundings.visualBounds.w;
                     // get position of next beat on same system
-                    if (nextBeat) {
+                    if (nextBeat && cursorMode == MidiTickLookupFindBeatResultCursorMode.ToNextBext) {
                         // if we are moving within the same bar or to the next bar
                         // transition to the next beat, otherwise transition to the end of the bar.
                         let nextBeatBoundings = cache.findBeat(nextBeat);
@@ -52133,8 +52167,8 @@
     // </auto-generated>
     class VersionInfo {
     }
-    VersionInfo.version = '1.4.0';
-    VersionInfo.date = '2025-03-02T15:59:05.431Z';
+    VersionInfo.version = '1.4.3';
+    VersionInfo.date = '2025-04-13T21:11:16.350Z';
 
     var index$4 = /*#__PURE__*/Object.freeze({
         __proto__: null,