feat: animate cursor to playback range end and allow custom cursor handlers

[Danielku15]

Issues

Fixes #2515

Proposed changes

The first change in this PR is to animate cursors to the end of their respective "real position" which deprecates the "end of bar". This allows a more consistent behavior in the different scenarios.

Next is that we use the "animate to end of beat" mode when the "next beat" is outside the selected playback range ensuring the cursor will not go beyond the selected range.

Last this PR allows fully custom cursor handlers via ICursorHandler implementations. This should allow any customizations that users would want to do to the cursor (e.g. having additional adorners or adjusting the built-in element position). The API is tightly coupled to the internal alphaTab behavior but should allow everything needed.

Checklist

• I consent that this change becomes part of alphaTab under it's current or any future open source license
• Changes are implemented
• New tests were added

Further details

• This is a breaking change
• This change will require update of the documentation/website

[AvaTheArchitect]

Thank you! So now I know this will be available on beta but officially stable when the next future public release comes out! Very awesome! Super excited!

…

On Sun, Feb 1, 2026 at 10:25 AM Daniel Kuschny ***@***.***> wrote: Merged #2536 <#2536> into develop. — Reply to this email directly, view it on GitHub <#2536 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BNLESQH5RAJEP2EBVJYMIA34JZAIJAVCNFSM6AAAAACTTJ44NCVHI2DSMVQWIX3LMV45UABCJFZXG5LFIV3GK3TUJZXXI2LGNFRWC5DJN5XDWMRSGQ2DMOJWHAZDSNA> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[Danielku15]

I plan to ship this in a 1.8.1 these days. The earlier you report whether this works for you the more likely I can still address concerns. 😉

[AvaTheArchitect]

Should I test it on the current 1.9.x 1965, or should I switch back to the stable 1.8.0 for best results?

…

On Sun, Feb 1, 2026 at 11:07 AM Daniel Kuschny ***@***.***> wrote: *Danielku15* left a comment (CoderLine/alphaTab#2536) <#2536 (comment)> I plan to ship this in a 1.8.1 these days. The earlier you report whether this works for you the more likely I can still address concerns. 😉 — Reply to this email directly, view it on GitHub <#2536 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BNLESQG3C4R3X5VZTOMDYN34JZFHVAVCNFSM6AAAAACTTJ44NCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTQMZRG43TMOJRG4> . You are receiving this because you commented.Message ID: ***@***.***>

[AvaTheArchitect]

Hi Daniel, I updated to the latest beta ***@***.***) to test the fix for the loop end and cursor overshoot issue. However, the cursor is still overshooting the entire bar at the end of the loop. Could you share a code snippet for the expected implementation? I am wondering if this is a timing issue on my end or if there is something specific in beta @1699 that I should verify to ensure the update is testing properly. I am assuming this would be what is needed to ensure it’s set correctly for testing: api.playbackRange = { startTick, endTick }; // actual enforcement api.highlightPlaybackRange(startTick, endTick); // just UI highlight Range + highlight is that correct? Thank you

…

On Sun, Feb 1, 2026 at 11:07 AM Daniel Kuschny ***@***.***> wrote: *Danielku15* left a comment (CoderLine/alphaTab#2536) <#2536 (comment)> I plan to ship this in a 1.8.1 these days. The earlier you report whether this works for you the more likely I can still address concerns. 😉 — Reply to this email directly, view it on GitHub <#2536 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BNLESQG3C4R3X5VZTOMDYN34JZFHVAVCNFSM6AAAAACTTJ44NCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTQMZRG43TMOJRG4> . You are receiving this because you commented.Message ID: ***@***.***>