@coderline/alphatab 1.8.0-alpha.1646 → 1.8.0-alpha.1650

package/dist/alphaTab.d.ts

@@ -357,6 +357,7 @@ export declare class AlphaTabApiBase<TSettings> {
     private _startTime;
     private _trackIndexes;
     private _trackIndexLookup;
+    private readonly _beatVisibilityChecker;
     private _isDestroyed;
     private _score;
     private _tracks;
@@ -5263,6 +5264,12 @@ declare class BeatTickLookup {
      * @returns The first beat which is visible according to the given tracks or null.
      */
     getVisibleBeatAtStart(visibleTracks: Set<number>): Beat | null;
+    /**
+     * Looks for the first visible beat which starts at this lookup so it can be used for cursor placement.
+     * @param checker The custom checker to see if a beat is visible.
+     * @returns The first beat which is visible according to the given tracks or null.
+     */
+    getVisibleBeatAtStartWithChecker(checker: IBeatVisibilityChecker): Beat | null;
 }
 
 /**
@@ -7328,7 +7335,7 @@ export declare class EngravingSettings {
      */
     numberedBarRendererBarSpacing: number;
     /**
-     * The size of the dashed drawn in numbered notation to indicate the durations.
+     * The padding minimum between the duration dashes.
      */
     numberedDashGlyphPadding: number;
     /**
@@ -7725,7 +7732,7 @@ declare interface EngravingSettingsJson {
      */
     numberedBarRendererBarSpacing?: number;
     /**
-     * The size of the dashed drawn in numbered notation to indicate the durations.
+     * The padding minimum between the duration dashes.
      */
     numberedDashGlyphPadding?: number;
     /**
@@ -9017,6 +9024,15 @@ declare interface IBackingTrackSynthOutput extends ISynthOutput {
     loadBackingTrack(backingTrack: BackingTrack): void;
 }
 
+/**
+ * Classes implementing this interface can help in checking whether beats are currently being
+ * displayed so that they can be considered for a tick-search.
+ * @public
+ */
+declare interface IBeatVisibilityChecker {
+    isVisible(beat: Beat): boolean;
+}
+
 /**
  * This is the base public interface for canvas implementations on different plattforms.
  * @public
@@ -11106,6 +11122,14 @@ declare class MidiTickLookup {
      * @returns The information about the current beat or null if no beat could be found.
      */
     findBeat(trackLookup: Set<number>, tick: number, currentBeatHint?: MidiTickLookupFindBeatResult | null): MidiTickLookupFindBeatResult | null;
+    /**
+     * Finds the currently played beat given a list of tracks and the current time.
+     * @param checker The checker to ask whether a beat is visible and should be considered for result.
+     * @param tick The current time in midi ticks.
+     * @param currentBeatHint Used for optimized lookup during playback. By passing in a previous result lookup of the next one can be optimized using heuristics. (optional).
+     * @returns The information about the current beat or null if no beat could be found.
+     */
+    findBeatWithChecker(checker: IBeatVisibilityChecker, tick: number, currentBeatHint?: MidiTickLookupFindBeatResult | null): MidiTickLookupFindBeatResult | null;
     private _findBeatFast;
     private _fillNextBeatMultiBarRest;
     private _fillNextBeat;
@@ -11828,7 +11852,11 @@ export declare enum NotationElement {
     /**
      * The whammy bar line effect shown above the tab staff
      */
-    EffectWhammyBarLine = 50
+    EffectWhammyBarLine = 50,
+    /**
+     * The key signature for numbered notation staff.
+     */
+    EffectNumberedNotationKeySignature = 51
 }
 
 /**
@@ -14284,6 +14312,23 @@ declare class RenderStylesheet {
      * Whether barlines should be drawn across staves within the same system.
      */
     extendBarLines: boolean;
+    /**
+     * Whether to hide empty staves.
+     */
+    hideEmptyStaves: boolean;
+    /**
+     * Whether to also hide empty staves in the first system.
+     * @remarks
+     * Only has an effect when activating {@link hideEmptyStaves}.
+     */
+    hideEmptyStavesInFirstSystem: boolean;
+    /**
+     * Whether to show brackets and braces across single staves.
+     * @remarks
+     * This allows a more consistent view for identifying staves when using
+     * {@link hideEmptyStaves}
+     */
+    showSingleStaffBrackets: boolean;
 }
 
 /**