@coderline/alphatab 1.3.0-alpha.139 → 1.3.0-alpha.143

package/dist/alphaTab.d.ts

@@ -958,7 +958,7 @@ declare enum AlphaTabErrorType {
 declare class AlphaTabError extends Error {
     inner: Error | null;
     type: AlphaTabErrorType;
-    constructor(type: AlphaTabErrorType, message?: string, inner?: Error);
+    constructor(type: AlphaTabErrorType, message?: string | null, inner?: Error);
 }
 
 /**
@@ -1428,6 +1428,7 @@ declare enum AutomationType {
  * Automations are used to change the behaviour of a song.
  * @cloneable
  * @json
+ * @json_strict
  */
 declare class Automation {
     /**
@@ -1459,6 +1460,7 @@ declare class Automation {
  * describe WhammyBar and String Bending effects.
  * @cloneable
  * @json
+ * @json_strict
  */
 declare class BendPoint {
     static readonly MaxPosition: number;
@@ -1569,6 +1571,7 @@ declare enum FermataType {
 /**
  * Represents a fermata.
  * @json
+ * @json_strict
  */
 declare class Fermata {
     /**
@@ -1692,6 +1695,7 @@ declare class RepeatGroup {
  * This class represents the rendering stylesheet.
  * It contains settings which control the display of the score when rendered.
  * @json
+ * @json_strict
  */
 declare class RenderStylesheet {
     /**
@@ -1734,6 +1738,7 @@ declare class Lyrics {
  * This public class stores the midi specific information of a track needed
  * for playback.
  * @json
+ * @json_strict
  */
 declare class PlaybackInformation {
     /**
@@ -2016,6 +2021,7 @@ declare enum Duration {
 /**
  * Describes an instrument articulation which is used for percussions.
  * @json
+ * @json_strict
  */
 declare class InstrumentArticulation {
     /**
@@ -2058,6 +2064,7 @@ declare class InstrumentArticulation {
  * This public class describes a single track or instrument of score.
  * It is bascially a list of staffs containing individual music notation kinds.
  * @json
+ * @json_strict
  */
 declare class Track {
     private static readonly ShortNameMaxLength;
@@ -2099,1291 +2106,1298 @@ declare class Track {
     percussionArticulations: InstrumentArticulation[];
     ensureStaveCount(staveCount: number): void;
     addStaff(staff: Staff): void;
-    finish(settings: Settings): void;
+    finish(settings: Settings, sharedDataBag: Map<string, unknown>): void;
     applyLyrics(lyrics: Lyrics[]): void;
 }
 
 /**
- * Lists all types of note acceuntations
- */
-declare enum AccentuationType {
-    /**
-     * No accentuation
-     */
-    None = 0,
-    /**
-     * Normal accentuation
-     */
-    Normal = 1,
-    /**
-     * Heavy accentuation
-     */
-    Heavy = 2
-}
-
-/**
- * Lists all types of bends
+ * The score is the root node of the complete
+ * model. It stores the basic information of
+ * a song and stores the sub components.
+ * @json
+ * @json_strict
  */
-declare enum BendType {
+declare class Score {
+    private _currentRepeatGroup;
     /**
-     * No bend at all
+     * The album of this song.
      */
-    None = 0,
+    album: string;
     /**
-     * Individual points define the bends in a flexible manner.
-     * This system was mainly used in Guitar Pro 3-5
+     * The artist who performs this song.
      */
-    Custom = 1,
+    artist: string;
     /**
-     * Simple Bend from an unbended string to a higher note.
+     * The owner of the copyright of this song.
      */
-    Bend = 2,
+    copyright: string;
     /**
-     * Release of a bend that was started on an earlier note.
+     * Additional instructions
      */
-    Release = 3,
+    instructions: string;
     /**
-     * A bend that starts from an unbended string,
-     * and also releases the bend after some time.
+     * The author of the music.
      */
-    BendRelease = 4,
+    music: string;
     /**
-     * Holds a bend that was started on an earlier note
+     * Some additional notes about the song.
      */
-    Hold = 5,
+    notices: string;
     /**
-     * A bend that is already started before the note is played then it is held until the end.
+     * The subtitle of the song.
      */
-    Prebend = 6,
+    subTitle: string;
     /**
-     * A bend that is already started before the note is played and
-     * bends even further, then it is held until the end.
+     * The title of the song.
      */
-    PrebendBend = 7,
+    title: string;
     /**
-     * A bend that is already started before the note is played and
-     * then releases the bend to a lower note where it is held until the end.
+     * The author of the song lyrics
      */
-    PrebendRelease = 8
-}
-
-/**
- * Lists all dynamics.
- */
-declare enum DynamicValue {
+    words: string;
     /**
-     * pianississimo (very very soft)
+     * The author of this tablature.
      */
-    PPP = 0,
+    tab: string;
     /**
-     * pianissimo (very soft)
+     * Gets or sets the global tempo of the song in BPM. The tempo might change via {@link MasterBar.tempo}.
      */
-    PP = 1,
+    tempo: number;
     /**
-     * piano (soft)
+     * Gets or sets the name/label of the tempo.
      */
-    P = 2,
+    tempoLabel: string;
     /**
-     * mezzo-piano (half soft)
+     * Gets or sets a list of all masterbars contained in this song.
+     * @json_add addMasterBar
      */
-    MP = 3,
+    masterBars: MasterBar[];
     /**
-     * mezzo-forte (half loud)
+     * Gets or sets a list of all tracks contained in this song.
+     * @json_add addTrack
      */
-    MF = 4,
+    tracks: Track[];
     /**
-     * forte (loud)
+     * Gets or sets the rendering stylesheet for this song.
      */
-    F = 5,
+    stylesheet: RenderStylesheet;
+    rebuildRepeatGroups(): void;
+    addMasterBar(bar: MasterBar): void;
+    addTrack(track: Track): void;
+    finish(settings: Settings): void;
+}
+
+/**
+ * This public class is used to describe the beginning of a
+ * section within a song. It acts like a marker.
+ * @json
+ * @json_strict
+ */
+declare class Section {
     /**
-     * fortissimo (very loud)
+     * Gets or sets the marker ID for this section.
      */
-    FF = 6,
+    marker: string;
     /**
-     * fortississimo (very very loud)
+     * Gets or sets the descriptional text of this section.
      */
-    FFF = 7
+    text: string;
 }
 
 /**
- * Lists all fingers.
+ * This public enumeration lists all feels of triplets.
  */
-declare enum Fingers {
+declare enum TripletFeel {
     /**
-     * Unknown type (not documented)
+     * No triplet feel
      */
-    Unknown = -2,
+    NoTripletFeel = 0,
     /**
-     * No finger, dead note
+     * Triplet 16th
      */
-    NoOrDead = -1,
+    Triplet16th = 1,
     /**
-     * The thumb
+     * Triplet 8th
      */
-    Thumb = 0,
+    Triplet8th = 2,
     /**
-     * The index finger
+     * Dotted 16th
      */
-    IndexFinger = 1,
+    Dotted16th = 3,
     /**
-     * The middle finger
+     * Dotted 8th
      */
-    MiddleFinger = 2,
+    Dotted8th = 4,
     /**
-     * The annular finger
+     * Scottish 16th
      */
-    AnnularFinger = 3,
+    Scottish16th = 5,
     /**
-     * The little finger
+     * Scottish 8th
      */
-    LittleFinger = 4
+    Scottish8th = 6
 }
 
 /**
- * Lists all harmonic types.
+ * The MasterBar stores information about a bar which affects
+ * all tracks.
+ * @json
+ * @json_strict
  */
-declare enum HarmonicType {
+declare class MasterBar {
+    static readonly MaxAlternateEndings: number;
     /**
-     * No harmonics.
+     * Gets or sets the bitflag for the alternate endings. Each bit defines for which repeat counts
+     * the bar is played.
      */
-    None = 0,
+    alternateEndings: number;
     /**
-     * Natural harmonic
+     * Gets or sets the next masterbar in the song.
+     * @json_ignore
      */
-    Natural = 1,
+    nextMasterBar: MasterBar | null;
     /**
-     * Artificial harmonic
+     * Gets or sets the next masterbar in the song.
+     * @json_ignore
      */
-    Artificial = 2,
+    previousMasterBar: MasterBar | null;
     /**
-     * Pinch harmonics
+     * Gets the zero based index of the masterbar.
+     * @json_ignore
      */
-    Pinch = 3,
+    index: number;
     /**
-     * Tap harmonics
+     * Gets or sets the key signature used on all bars.
      */
-    Tap = 4,
+    keySignature: KeySignature;
     /**
-     * Semi harmonics
+     * Gets or sets the type of key signature (major/minor)
      */
-    Semi = 5,
+    keySignatureType: KeySignatureType;
     /**
-     * Feedback harmonics
+     * Gets or sets whether a double bar is shown for this masterbar.
      */
-    Feedback = 6
-}
-
-/**
- * Lists the modes how accidentals are handled for notes
- */
-declare enum NoteAccidentalMode {
+    isDoubleBar: boolean;
     /**
-     * Accidentals are calculated automatically.
+     * Gets or sets whether a repeat section starts on this masterbar.
      */
-    Default = 0,
+    isRepeatStart: boolean;
+    get isRepeatEnd(): boolean;
     /**
-     * This will try to ensure that no accidental is shown.
+     * Gets or sets the number of repeats for the current repeat section.
      */
-    ForceNone = 1,
+    repeatCount: number;
     /**
-     * This will move the note one line down and applies a Naturalize.
+     * Gets or sets the repeat group this bar belongs to.
+     * @json_ignore
      */
-    ForceNatural = 2,
+    repeatGroup: RepeatGroup;
     /**
-     * This will move the note one line down and applies a Sharp.
+     * Gets or sets the time signature numerator.
      */
-    ForceSharp = 3,
+    timeSignatureNumerator: number;
     /**
-     * This will move the note to be shown 2 half-notes deeper with a double sharp symbol
+     * Gets or sets the time signature denominiator.
      */
-    ForceDoubleSharp = 4,
+    timeSignatureDenominator: number;
     /**
-     * This will move the note one line up and applies a Flat.
+     * Gets or sets whether this is bar has a common time signature.
      */
-    ForceFlat = 5,
+    timeSignatureCommon: boolean;
     /**
-     * This will move the note two half notes up with a double flag symbol.
+     * Gets or sets the triplet feel that is valid for this bar.
      */
-    ForceDoubleFlat = 6
-}
-
-/**
- * This public enum lists all different types of finger slide-ins on a string.
- */
-declare enum SlideInType {
+    tripletFeel: TripletFeel;
     /**
-     * No slide.
+     * Gets or sets the new section information for this bar.
      */
-    None = 0,
+    section: Section | null;
+    get isSectionStart(): boolean;
     /**
-     * Slide into the note from below on the same string.
+     * Gets or sets the tempo automation for this bar.
      */
-    IntoFromBelow = 1,
+    tempoAutomation: Automation | null;
     /**
-     * Slide into the note from above on the same string.
+     * Gets or sets the reference to the score this song belongs to.
+     * @json_ignore
      */
-    IntoFromAbove = 2
-}
-
-/**
- * This public enum lists all different types of finger slide-outs on a string.
- */
-declare enum SlideOutType {
+    score: Score;
     /**
-     * No slide.
+     * Gets or sets the fermatas for this bar. The key is the offset of the fermata in midi ticks.
+     * @json_add addFermata
      */
-    None = 0,
+    fermata: Map<number, Fermata> | null;
     /**
-     * Shift slide to next note on same string
+     * The timeline position of the voice within the whole score. (unit: midi ticks)
      */
-    Shift = 1,
+    start: number;
     /**
-     * Legato slide to next note on same string.
+     * Gets or sets a value indicating whether the master bar is an anacrusis (aka. pickup bar)
      */
-    Legato = 2,
+    isAnacrusis: boolean;
     /**
-     * Slide out from the note from upwards on the same string.
+     * Calculates the time spent in this bar. (unit: midi ticks)
      */
-    OutUp = 3,
+    calculateDuration(respectAnacrusis?: boolean): number;
     /**
-     * Slide out from the note from downwards on the same string.
+     * Adds a fermata to the masterbar.
+     * @param offset The offset of the fermata within the bar in midi ticks.
+     * @param fermata The fermata.
      */
-    OutDown = 4,
+    addFermata(offset: number, fermata: Fermata): void;
     /**
-     * Pickslide down on this note
+     * Gets the fermata for a given beat.
+     * @param beat The beat to get the fermata for.
+     * @returns
      */
-    PickSlideDown = 5,
+    getFermata(beat: Beat): Fermata | null;
+}
+
+/**
+ * Lists all ottavia.
+ */
+declare enum Ottavia {
     /**
-     * Pickslide up on this note
+     * 2 octaves higher
      */
-    PickSlideUp = 6
+    _15ma = 0,
+    /**
+     * 1 octave higher
+     */
+    _8va = 1,
+    /**
+     * Normal
+     */
+    Regular = 2,
+    /**
+     * 1 octave lower
+     */
+    _8vb = 3,
+    /**
+     * 2 octaves lower.
+     */
+    _15mb = 4
 }
 
 /**
- * This public enum lists all vibrato types that can be performed.
+ * Lists all simile mark types as they are assigned to bars.
  */
-declare enum VibratoType {
+declare enum SimileMark {
     /**
-     * No vibrato.
+     * No simile mark is applied
      */
     None = 0,
     /**
-     * A slight vibrato.
+     * A simple simile mark. The previous bar is repeated.
      */
-    Slight = 1,
+    Simple = 1,
     /**
-     * A wide vibrato.
+     * A double simile mark. This value is assigned to the first
+     * bar of the 2 repeat bars.
      */
-    Wide = 2
+    FirstOfDouble = 2,
+    /**
+     * A double simile mark. This value is assigned to the second
+     * bar of the 2 repeat bars.
+     */
+    SecondOfDouble = 3
 }
 
 /**
- * A note is a single played sound on a fretted instrument.
- * It consists of a fret offset and a string on which the note is played on.
- * It also can be modified by a lot of different effects.
- * @cloneable
+ * A voice represents a group of beats
+ * that can be played during a bar.
  * @json
+ * @json_strict
  */
-declare class Note {
-    static GlobalNoteId: number;
+declare class Voice {
+    private _beatLookup;
+    private static _globalBarId;
     /**
-     * Gets or sets the unique id of this note.
-     * @clone_ignore
+     * Gets or sets the unique id of this bar.
      */
     id: number;
     /**
-     * Gets or sets the zero-based index of this note within the beat.
+     * Gets or sets the zero-based index of this voice within the bar.
      * @json_ignore
      */
     index: number;
     /**
-     * Gets or sets the accentuation of this note.
+     * Gets or sets the reference to the bar this voice belongs to.
+     * @json_ignore
      */
-    accentuated: AccentuationType;
+    bar: Bar;
     /**
-     * Gets or sets the bend type for this note.
+     * Gets or sets the list of beats contained in this voice.
+     * @json_add addBeat
      */
-    bendType: BendType;
+    beats: Beat[];
     /**
-     * Gets or sets the bend style for this note.
+     * Gets or sets a value indicating whether this voice is empty.
      */
-    bendStyle: BendStyle;
+    isEmpty: boolean;
+    insertBeat(after: Beat, newBeat: Beat): void;
+    addBeat(beat: Beat): void;
+    private chain;
+    addGraceBeat(beat: Beat): void;
+    getBeatAtPlaybackStart(playbackStart: number): Beat | null;
+    finish(settings: Settings, sharedDataBag: Map<string, unknown>): void;
+    calculateDuration(): number;
+}
+
+/**
+ * A bar is a single block within a track, also known as Measure.
+ * @json
+ * @json_strict
+ */
+declare class Bar {
+    private static _globalBarId;
     /**
-     * Gets or sets the note from which this note continues the bend.
-     * @clone_ignore
+     * Gets or sets the unique id of this bar.
+     */
+    id: number;
+    /**
+     * Gets or sets the zero-based index of this bar within the staff.
      * @json_ignore
      */
-    bendOrigin: Note | null;
+    index: number;
     /**
-     * Gets or sets whether this note continues a bend from a previous note.
+     * Gets or sets the next bar that comes after this bar.
+     * @json_ignore
      */
-    isContinuedBend: boolean;
+    nextBar: Bar | null;
     /**
-     * Gets or sets a list of the points defining the bend behavior.
-     * @clone_add addBendPoint
-     * @json_add addBendPoint
+     * Gets or sets the previous bar that comes before this bar.
+     * @json_ignore
      */
-    bendPoints: BendPoint[];
+    previousBar: Bar | null;
     /**
-     * Gets or sets the bend point with the highest bend value.
-     * @clone_ignore
+     * Gets or sets the clef on this bar.
+     */
+    clef: Clef;
+    /**
+     * Gets or sets the ottava applied to the clef.
+     */
+    clefOttava: Ottavia;
+    /**
+     * Gets or sets the reference to the parent staff.
      * @json_ignore
      */
-    maxBendPoint: BendPoint | null;
-    get hasBend(): boolean;
-    get isStringed(): boolean;
+    staff: Staff;
     /**
-     * Gets or sets the fret on which this note is played on the instrument.
+     * Gets or sets the list of voices contained in this bar.
+     * @json_add addVoice
      */
-    fret: number;
+    voices: Voice[];
     /**
-     * Gets or sets the string number where the note is placed.
-     * 1 is the lowest string on the guitar and the bottom line on the tablature.
-     * It then increases the the number of strings on available on the track.
+     * Gets or sets the simile mark on this bar.
      */
-    string: number;
-    get isPiano(): boolean;
+    simileMark: SimileMark;
     /**
-     * Gets or sets the octave on which this note is played.
+     * Gets a value indicating whether this bar contains multiple voices with notes.
+     * @json_ignore
      */
-    octave: number;
+    isMultiVoice: boolean;
+    get masterBar(): MasterBar;
+    get isEmpty(): boolean;
+    addVoice(voice: Voice): void;
+    finish(settings: Settings, sharedDataBag: Map<string, unknown>): void;
+    calculateDuration(): number;
+}
+
+/**
+ * This public class represents a predefined string tuning.
+ * @json
+ * @json_strict
+ */
+declare class Tuning {
+    private static _sevenStrings;
+    private static _sixStrings;
+    private static _fiveStrings;
+    private static _fourStrings;
+    private static _defaultTunings;
+    static readonly defaultAccidentals: string[];
+    static readonly defaultSteps: string[];
+    static getTextForTuning(tuning: number, includeOctave: boolean): string;
+    static getTextPartsForTuning(tuning: number, octaveShift?: number): string[];
     /**
-     * Gets or sets the tone of this note within the octave.
+     * Gets the default tuning for the given string count.
+     * @param stringCount The string count.
+     * @returns The tuning for the given string count or null if the string count is not defined.
      */
-    tone: number;
-    get isPercussion(): boolean;
+    static getDefaultTuningFor(stringCount: number): Tuning | null;
     /**
-     * Gets or sets the percusson element.
-     * @deprecated
+     * Gets a list of all tuning presets for a given stirng count.
+     * @param stringCount The string count.
+     * @returns The list of known tunings for the given string count or an empty list if the string count is not defined.
      */
-    get element(): number;
+    static getPresetsFor(stringCount: number): Tuning[];
+    static initialize(): void;
     /**
-     * Gets or sets the variation of this note.
-     * @deprecated
+     * Tries to find a known tuning by a given list of tuning values.
+     * @param strings The values defining the tuning.
+     * @returns The known tuning.
      */
-    get variation(): number;
+    static findTuning(strings: number[]): Tuning | null;
     /**
-     * Gets or sets the index of percussion articulation in the related `track.percussionArticulations`.
-     * If the articulation is not listed in `track.percussionArticulations` the following list based on GP7 applies:
-     * - 029 Ride (choke)
-     * - 030 Cymbal (hit)
-     * - 031 Snare (side stick)
-     * - 033 Snare (side stick)
-     * - 034 Snare (hit)
-     * - 035 Kick (hit)
-     * - 036 Kick (hit)
-     * - 037 Snare (side stick)
-     * - 038 Snare (hit)
-     * - 039 Hand Clap (hit)
-     * - 040 Snare (hit)
-     * - 041 Low Floor Tom (hit)
-     * - 042 Hi-Hat (closed)
-     * - 043 Very Low Tom (hit)
-     * - 044 Pedal Hi-Hat (hit)
-     * - 045 Low Tom (hit)
-     * - 046 Hi-Hat (open)
-     * - 047 Mid Tom (hit)
-     * - 048 High Tom (hit)
-     * - 049 Crash high (hit)
-     * - 050 High Floor Tom (hit)
-     * - 051 Ride (middle)
-     * - 052 China (hit)
-     * - 053 Ride (bell)
-     * - 054 Tambourine (hit)
-     * - 055 Splash (hit)
-     * - 056 Cowbell medium (hit)
-     * - 057 Crash medium (hit)
-     * - 058 Vibraslap (hit)
-     * - 059 Ride (edge)
-     * - 060 Hand (hit)
-     * - 061 Hand (hit)
-     * - 062 Conga high (mute)
-     * - 063 Conga high (hit)
-     * - 064 Conga low (hit)
-     * - 065 Timbale high (hit)
-     * - 066 Timbale low (hit)
-     * - 067 Agogo high (hit)
-     * - 068 Agogo tow (hit)
-     * - 069 Cabasa (hit)
-     * - 070 Left Maraca (hit)
-     * - 071 Whistle high (hit)
-     * - 072 Whistle low (hit)
-     * - 073 Guiro (hit)
-     * - 074 Guiro (scrap-return)
-     * - 075 Claves (hit)
-     * - 076 Woodblock high (hit)
-     * - 077 Woodblock low (hit)
-     * - 078 Cuica (mute)
-     * - 079 Cuica (open)
-     * - 080 Triangle (rnute)
-     * - 081 Triangle (hit)
-     * - 082 Shaker (hit)
-     * - 083 Tinkle Bell (hat)
-     * - 083 Jingle Bell (hit)
-     * - 084 Bell Tree (hit)
-     * - 085 Castanets (hit)
-     * - 086 Surdo (hit)
-     * - 087 Surdo (mute)
-     * - 091 Snare (rim shot)
-     * - 092 Hi-Hat (half)
-     * - 093 Ride (edge)
-     * - 094 Ride (choke)
-     * - 095 Splash (choke)
-     * - 096 China (choke)
-     * - 097 Crash high (choke)
-     * - 098 Crash medium (choke)
-     * - 099 Cowbell low (hit)
-     * - 100 Cowbell low (tip)
-     * - 101 Cowbell medium (tip)
-     * - 102 Cowbell high (hit)
-     * - 103 Cowbell high (tip)
-     * - 104 Hand (mute)
-     * - 105 Hand (slap)
-     * - 106 Hand (mute)
-     * - 107 Hand (slap)
-     * - 108 Conga low (slap)
-     * - 109 Conga low (mute)
-     * - 110 Conga high (slap)
-     * - 111 Tambourine (return)
-     * - 112 Tambourine (roll)
-     * - 113 Tambourine (hand)
-     * - 114 Grancassa (hit)
-     * - 115 Piatti (hat)
-     * - 116 Piatti (hand)
-     * - 117 Cabasa (return)
-     * - 118 Left Maraca (return)
-     * - 119 Right Maraca (hit)
-     * - 120 Right Maraca (return)
-     * - 122 Shaker (return)
-     * - 123 Bell Tee (return)
-     * - 124 Golpe (thumb)
-     * - 125 Golpe (finger)
-     * - 126 Ride (middle)
-     * - 127 Ride (bell)
-     */
-    percussionArticulation: number;
-    /**
-     * Gets or sets whether this note is visible on the music sheet.
+     * Gets or sets whether this is the standard tuning for this number of strings.
      */
-    isVisible: boolean;
+    isStandard: boolean;
     /**
-     * Gets a value indicating whether the note is left hand tapped.
+     * Gets or sets the name of the tuning.
      */
-    isLeftHandTapped: boolean;
+    name: string;
     /**
-     * Gets or sets whether this note starts a hammeron or pulloff.
+     * Gets or sets the values for each string of the instrument.
      */
-    isHammerPullOrigin: boolean;
-    get isHammerPullDestination(): boolean;
+    tunings: number[];
     /**
-     * Gets the origin note id of the hammeron/pull-off of this note.
+     * Initializes a new instance of the {@link Tuning} class.
+     * @param name The name.
+     * @param tuning The tuning.
+     * @param isStandard if set to`true`[is standard].
      */
-    hammerPullOriginNoteId: number;
+    constructor(name?: string, tuning?: number[] | null, isStandard?: boolean);
     /**
-     * Gets the origin of the hammeron/pulloff of this note.
+     * Tries to detect the name and standard flag of the tuning from a known tuning list based
+     * on the string values.
      */
-    get hammerPullOrigin(): Note | null;
+    finish(): void;
+}
+
+/**
+ * This class describes a single staff within a track. There are instruments like pianos
+ * where a single track can contain multiple staffs.
+ * @json
+ * @json_strict
+ */
+declare class Staff {
     /**
-     * Gets the destination note id of the hammeron/pull-off of this note.
+     * Gets or sets the zero-based index of this staff within the track.
+     * @json_ignore
      */
-    hammerPullDestinationNoteId: number;
+    index: number;
     /**
-     * Gets the destination for the hammeron/pullof started by this note.
+     * Gets or sets the reference to the track this staff belongs to.
+     * @json_ignore
      */
-    get hammerPullDestination(): Note | null;
-    get isSlurOrigin(): boolean;
+    track: Track;
     /**
-     * Gets or sets whether this note finishes a slur.
+     * Gets or sets a list of all bars contained in this staff.
+     * @json_add addBar
      */
-    isSlurDestination: boolean;
+    bars: Bar[];
     /**
-     * Gets the note id where the slur of this note starts.
+     * Gets or sets a list of all chords defined for this staff. {@link Beat.chordId} refers to entries in this lookup.
+     * @json_add addChord
      */
-    slurOriginNoteId: number;
+    chords: Map<string, Chord> | null;
     /**
-     * Gets or sets the note where the slur of this note starts.
+     * Gets or sets the fret on which a capo is set.
      */
-    get slurOrigin(): Note | null;
+    capo: number;
     /**
-     * Gets or sets the note id where the slur of this note ends.
+     * Gets or sets the number of semitones this track should be
+     * transposed. This applies to rendering and playback.
      */
-    slurDestinationNoteId: number;
+    transpositionPitch: number;
     /**
-     * Gets or sets the note where the slur of this note ends.
+     * Gets or sets the number of semitones this track should be
+     * transposed. This applies only to rendering.
      */
-    get slurDestination(): Note | null;
-    get isHarmonic(): boolean;
+    displayTranspositionPitch: number;
     /**
-     * Gets or sets the harmonic type applied to this note.
+     * Get or set the guitar tuning of the guitar. This tuning also indicates the number of strings shown in the
+     * guitar tablature. Unlike the {@link Note.string} property this array directly represents
+     * the order of the tracks shown in the tablature. The first item is the most top tablature line.
      */
-    harmonicType: HarmonicType;
+    stringTuning: Tuning;
     /**
-     * Gets or sets the value defining the harmonic pitch.
+     * Get or set the values of the related guitar tuning.
      */
-    harmonicValue: number;
+    get tuning(): number[];
     /**
-     * Gets or sets whether the note is a ghost note and shown in parenthesis. Also this will make the note a bit more silent.
+     * Gets or sets the name of the tuning.
      */
-    isGhost: boolean;
+    get tuningName(): string;
+    get isStringed(): boolean;
     /**
-     * Gets or sets whether this note has a let-ring effect.
+     * Gets or sets whether the tabs are shown.
      */
-    isLetRing: boolean;
+    showTablature: boolean;
     /**
-     * Gets or sets the destination note for the let-ring effect.
-     * @clone_ignore
-     * @json_ignore
+     * Gets or sets whether the standard notation is shown.
      */
-    letRingDestination: Note | null;
+    showStandardNotation: boolean;
     /**
-     * Gets or sets whether this note has a palm-mute effect.
+     * Gets or sets whether the staff contains percussion notation
      */
-    isPalmMute: boolean;
+    isPercussion: boolean;
     /**
-     * Gets or sets the destination note for the palm-mute effect.
-     * @clone_ignore
-     * @json_ignore
+     * The number of lines shown for the standard notation.
+     * For some percussion instruments this number might vary.
      */
-    palmMuteDestination: Note | null;
+    standardNotationLineCount: number;
+    finish(settings: Settings, sharedDataBag: Map<string, unknown>): void;
+    addChord(chordId: string, chord: Chord): void;
+    hasChord(chordId: string): boolean;
+    getChord(chordId: string): Chord | null;
+    addBar(bar: Bar): void;
+}
+
+/**
+ * A chord definition.
+ * @json
+ * @json_strict
+ */
+declare class Chord {
     /**
-     * Gets or sets whether the note is shown and played as dead note.
+     * Gets or sets the name of the chord
      */
-    isDead: boolean;
+    name: string;
     /**
-     * Gets or sets whether the note is played as staccato.
+     * Indicates the first fret of the chord diagram.
      */
-    isStaccato: boolean;
+    firstFret: number;
     /**
-     * Gets or sets the slide-in type this note is played with.
+     * Gets or sets the frets played on the individual strings for this chord.
+     * - The order in this list goes from the highest string to the lowest string.
+     * - -1 indicates that the string is not played.
      */
-    slideInType: SlideInType;
+    strings: number[];
     /**
-     * Gets or sets the slide-out type this note is played with.
+     * Gets or sets a list of frets where the finger should hold a barre
      */
-    slideOutType: SlideOutType;
+    barreFrets: number[];
     /**
-     * Gets or sets the target note for several slide types.
-     * @clone_ignore
+     * Gets or sets the staff the chord belongs to.
      * @json_ignore
      */
-    slideTarget: Note | null;
+    staff: Staff;
     /**
-     * Gets or sets the source note for several slide types.
-     * @clone_ignore
-     * @json_ignore
+     * Gets or sets whether the chord name is shown above the chord diagram.
      */
-    slideOrigin: Note | null;
+    showName: boolean;
     /**
-     * Gets or sets whether a vibrato is played on the note.
+     * Gets or sets whether the chord diagram is shown.
      */
-    vibrato: VibratoType;
+    showDiagram: boolean;
     /**
-     * Gets the origin note id of the tied if this note is tied.
+     * Gets or sets whether the fingering is shown below the chord diagram.
      */
-    tieOriginNoteId: number;
+    showFingering: boolean;
+}
+
+/**
+ * Lists all Crescendo and Decrescendo types.
+ */
+declare enum CrescendoType {
     /**
-     * Gets the origin of the tied if this note is tied.
+     * No crescendo applied.
      */
-    get tieOrigin(): Note | null;
+    None = 0,
     /**
-     * Gets the desination note id of the tie.
+     * Normal crescendo applied.
      */
-    tieDestinationNoteId: number;
+    Crescendo = 1,
     /**
-     * Gets the desination of the tie.
+     * Normal decrescendo applied.
      */
-    get tieDestination(): Note | null;
+    Decrescendo = 2
+}
+
+/**
+ * Lists all dynamics.
+ */
+declare enum DynamicValue {
     /**
-     * Gets or sets whether this note is ends a tied note.
+     * pianississimo (very very soft)
      */
-    isTieDestination: boolean;
-    get isTieOrigin(): boolean;
+    PPP = 0,
     /**
-     * Gets or sets the fingers used for this note on the left hand.
+     * pianissimo (very soft)
      */
-    leftHandFinger: Fingers;
+    PP = 1,
     /**
-     * Gets or sets the fingers used for this note on the right hand.
+     * piano (soft)
      */
-    rightHandFinger: Fingers;
+    P = 2,
     /**
-     * Gets or sets whether this note has fingering defined.
+     * mezzo-piano (half soft)
      */
-    isFingering: boolean;
+    MP = 3,
     /**
-     * Gets or sets the target note value for the trill effect.
+     * mezzo-forte (half loud)
      */
-    trillValue: number;
-    get trillFret(): number;
-    get isTrill(): boolean;
+    MF = 4,
     /**
-     * Gets or sets the speed of the trill effect.
+     * forte (loud)
      */
-    trillSpeed: Duration;
+    F = 5,
     /**
-     * Gets or sets the percentual duration of the note relative to the overall beat duration .
+     * fortissimo (very loud)
      */
-    durationPercent: number;
+    FF = 6,
     /**
-     * Gets or sets how accidetnals for this note should  be handled.
+     * fortississimo (very very loud)
      */
-    accidentalMode: NoteAccidentalMode;
+    FFF = 7
+}
+
+/**
+ * Lists all types of grace notes
+ */
+declare enum GraceType {
     /**
-     * Gets or sets the reference to the parent beat to which this note belongs to.
-     * @clone_ignore
-     * @json_ignore
+     * No grace, normal beat.
      */
-    beat: Beat;
+    None = 0,
     /**
-     * Gets or sets the dynamics for this note.
+     * The beat contains on-beat grace notes.
      */
-    dynamics: DynamicValue;
+    OnBeat = 1,
     /**
-     * @clone_ignore
-     * @json_ignore
+     * The beat contains before-beat grace notes.
      */
-    isEffectSlurOrigin: boolean;
+    BeforeBeat = 2,
     /**
-     * @clone_ignore
-     * @json_ignore
+     * The beat contains very special bend-grace notes used in SongBook style displays.
      */
-    hasEffectSlur: boolean;
-    get isEffectSlurDestination(): boolean;
+    BendGrace = 3
+}
+
+/**
+ * Lists all types of note acceuntations
+ */
+declare enum AccentuationType {
     /**
-     * @clone_ignore
-     * @json_ignore
+     * No accentuation
      */
-    effectSlurOrigin: Note | null;
+    None = 0,
     /**
-     * @clone_ignore
-     * @json_ignore
+     * Normal accentuation
      */
-    effectSlurDestination: Note | null;
-    get stringTuning(): number;
-    static getStringTuning(staff: Staff, noteString: number): number;
-    get realValue(): number;
-    get realValueWithoutHarmonic(): number;
-    get harmonicPitch(): number;
-    get initialBendValue(): number;
-    get displayValue(): number;
-    get displayValueWithoutBend(): number;
-    get hasQuarterToneOffset(): boolean;
-    addBendPoint(point: BendPoint): void;
-    finish(settings: Settings): void;
-    private static readonly MaxOffsetForSameLineSearch;
-    static nextNoteOnSameLine(note: Note): Note | null;
-    static findHammerPullDestination(note: Note): Note | null;
-    static findTieOrigin(note: Note): Note | null;
-    chain(): void;
+    Normal = 1,
+    /**
+     * Heavy accentuation
+     */
+    Heavy = 2
 }
 
 /**
- * The score is the root node of the complete
- * model. It stores the basic information of
- * a song and stores the sub components.
- * @json
+ * Lists all types of bends
  */
-declare class Score {
-    private _noteByIdLookup;
-    private _currentRepeatGroup;
-    /**
-     * The album of this song.
-     */
-    album: string;
+declare enum BendType {
     /**
-     * The artist who performs this song.
+     * No bend at all
      */
-    artist: string;
+    None = 0,
     /**
-     * The owner of the copyright of this song.
+     * Individual points define the bends in a flexible manner.
+     * This system was mainly used in Guitar Pro 3-5
      */
-    copyright: string;
+    Custom = 1,
     /**
-     * Additional instructions
+     * Simple Bend from an unbended string to a higher note.
      */
-    instructions: string;
+    Bend = 2,
     /**
-     * The author of the music.
+     * Release of a bend that was started on an earlier note.
      */
-    music: string;
+    Release = 3,
     /**
-     * Some additional notes about the song.
+     * A bend that starts from an unbended string,
+     * and also releases the bend after some time.
      */
-    notices: string;
+    BendRelease = 4,
     /**
-     * The subtitle of the song.
+     * Holds a bend that was started on an earlier note
      */
-    subTitle: string;
+    Hold = 5,
     /**
-     * The title of the song.
+     * A bend that is already started before the note is played then it is held until the end.
      */
-    title: string;
+    Prebend = 6,
     /**
-     * The author of the song lyrics
+     * A bend that is already started before the note is played and
+     * bends even further, then it is held until the end.
      */
-    words: string;
+    PrebendBend = 7,
     /**
-     * The author of this tablature.
+     * A bend that is already started before the note is played and
+     * then releases the bend to a lower note where it is held until the end.
      */
-    tab: string;
+    PrebendRelease = 8
+}
+
+/**
+ * Lists all fingers.
+ */
+declare enum Fingers {
     /**
-     * Gets or sets the global tempo of the song in BPM. The tempo might change via {@link MasterBar.tempo}.
+     * Unknown type (not documented)
      */
-    tempo: number;
+    Unknown = -2,
     /**
-     * Gets or sets the name/label of the tempo.
+     * No finger, dead note
      */
-    tempoLabel: string;
+    NoOrDead = -1,
     /**
-     * Gets or sets a list of all masterbars contained in this song.
-     * @json_add addMasterBar
+     * The thumb
      */
-    masterBars: MasterBar[];
+    Thumb = 0,
     /**
-     * Gets or sets a list of all tracks contained in this song.
-     * @json_add addTrack
+     * The index finger
      */
-    tracks: Track[];
+    IndexFinger = 1,
     /**
-     * Gets or sets the rendering stylesheet for this song.
+     * The middle finger
      */
-    stylesheet: RenderStylesheet;
-    rebuildRepeatGroups(): void;
-    addMasterBar(bar: MasterBar): void;
-    addTrack(track: Track): void;
-    finish(settings: Settings): void;
-    registerNote(note: Note): void;
-    getNoteById(noteId: number): Note | null;
-}
-
-/**
- * This public class is used to describe the beginning of a
- * section within a song. It acts like a marker.
- * @json
- */
-declare class Section {
+    MiddleFinger = 2,
     /**
-     * Gets or sets the marker ID for this section.
+     * The annular finger
      */
-    marker: string;
+    AnnularFinger = 3,
     /**
-     * Gets or sets the descriptional text of this section.
+     * The little finger
      */
-    text: string;
+    LittleFinger = 4
 }
 
 /**
- * This public enumeration lists all feels of triplets.
+ * Lists all harmonic types.
  */
-declare enum TripletFeel {
+declare enum HarmonicType {
     /**
-     * No triplet feel
+     * No harmonics.
      */
-    NoTripletFeel = 0,
+    None = 0,
     /**
-     * Triplet 16th
+     * Natural harmonic
      */
-    Triplet16th = 1,
+    Natural = 1,
     /**
-     * Triplet 8th
+     * Artificial harmonic
      */
-    Triplet8th = 2,
+    Artificial = 2,
     /**
-     * Dotted 16th
+     * Pinch harmonics
      */
-    Dotted16th = 3,
+    Pinch = 3,
     /**
-     * Dotted 8th
+     * Tap harmonics
      */
-    Dotted8th = 4,
+    Tap = 4,
     /**
-     * Scottish 16th
+     * Semi harmonics
      */
-    Scottish16th = 5,
+    Semi = 5,
     /**
-     * Scottish 8th
+     * Feedback harmonics
      */
-    Scottish8th = 6
+    Feedback = 6
 }
 
 /**
- * The MasterBar stores information about a bar which affects
- * all tracks.
- * @json
+ * Lists the modes how accidentals are handled for notes
  */
-declare class MasterBar {
-    static readonly MaxAlternateEndings: number;
+declare enum NoteAccidentalMode {
     /**
-     * Gets or sets the bitflag for the alternate endings. Each bit defines for which repeat counts
-     * the bar is played.
+     * Accidentals are calculated automatically.
      */
-    alternateEndings: number;
+    Default = 0,
     /**
-     * Gets or sets the next masterbar in the song.
-     * @json_ignore
+     * This will try to ensure that no accidental is shown.
      */
-    nextMasterBar: MasterBar | null;
+    ForceNone = 1,
     /**
-     * Gets or sets the next masterbar in the song.
-     * @json_ignore
+     * This will move the note one line down and applies a Naturalize.
      */
-    previousMasterBar: MasterBar | null;
+    ForceNatural = 2,
     /**
-     * Gets the zero based index of the masterbar.
-     * @json_ignore
+     * This will move the note one line down and applies a Sharp.
      */
-    index: number;
+    ForceSharp = 3,
     /**
-     * Gets or sets the key signature used on all bars.
+     * This will move the note to be shown 2 half-notes deeper with a double sharp symbol
      */
-    keySignature: KeySignature;
+    ForceDoubleSharp = 4,
     /**
-     * Gets or sets the type of key signature (major/minor)
+     * This will move the note one line up and applies a Flat.
      */
-    keySignatureType: KeySignatureType;
+    ForceFlat = 5,
     /**
-     * Gets or sets whether a double bar is shown for this masterbar.
+     * This will move the note two half notes up with a double flag symbol.
      */
-    isDoubleBar: boolean;
+    ForceDoubleFlat = 6
+}
+
+/**
+ * This public enum lists all different types of finger slide-ins on a string.
+ */
+declare enum SlideInType {
     /**
-     * Gets or sets whether a repeat section starts on this masterbar.
+     * No slide.
      */
-    isRepeatStart: boolean;
-    get isRepeatEnd(): boolean;
+    None = 0,
     /**
-     * Gets or sets the number of repeats for the current repeat section.
+     * Slide into the note from below on the same string.
      */
-    repeatCount: number;
+    IntoFromBelow = 1,
     /**
-     * Gets or sets the repeat group this bar belongs to.
-     * @json_ignore
+     * Slide into the note from above on the same string.
      */
-    repeatGroup: RepeatGroup;
+    IntoFromAbove = 2
+}
+
+/**
+ * This public enum lists all different types of finger slide-outs on a string.
+ */
+declare enum SlideOutType {
     /**
-     * Gets or sets the time signature numerator.
+     * No slide.
      */
-    timeSignatureNumerator: number;
+    None = 0,
     /**
-     * Gets or sets the time signature denominiator.
+     * Shift slide to next note on same string
      */
-    timeSignatureDenominator: number;
+    Shift = 1,
     /**
-     * Gets or sets whether this is bar has a common time signature.
+     * Legato slide to next note on same string.
      */
-    timeSignatureCommon: boolean;
-    /**
-     * Gets or sets the triplet feel that is valid for this bar.
-     */
-    tripletFeel: TripletFeel;
-    /**
-     * Gets or sets the new section information for this bar.
-     */
-    section: Section | null;
-    get isSectionStart(): boolean;
-    /**
-     * Gets or sets the tempo automation for this bar.
-     */
-    tempoAutomation: Automation | null;
-    /**
-     * Gets or sets the reference to the score this song belongs to.
-     * @json_ignore
-     */
-    score: Score;
-    /**
-     * Gets or sets the fermatas for this bar. The key is the offset of the fermata in midi ticks.
-     */
-    fermata: Map<number, Fermata>;
-    /**
-     * The timeline position of the voice within the whole score. (unit: midi ticks)
-     */
-    start: number;
-    /**
-     * Gets or sets a value indicating whether the master bar is an anacrusis (aka. pickup bar)
-     */
-    isAnacrusis: boolean;
-    /**
-     * Calculates the time spent in this bar. (unit: midi ticks)
-     */
-    calculateDuration(respectAnacrusis?: boolean): number;
-    /**
-     * Adds a fermata to the masterbar.
-     * @param offset The offset of the fermata within the bar in midi ticks.
-     * @param fermata The fermata.
-     */
-    addFermata(offset: number, fermata: Fermata): void;
-    /**
-     * Gets the fermata for a given beat.
-     * @param beat The beat to get the fermata for.
-     * @returns
-     */
-    getFermata(beat: Beat): Fermata | null;
-}
-
-/**
- * Lists all ottavia.
- */
-declare enum Ottavia {
-    /**
-     * 2 octaves higher
-     */
-    _15ma = 0,
+    Legato = 2,
     /**
-     * 1 octave higher
+     * Slide out from the note from upwards on the same string.
      */
-    _8va = 1,
+    OutUp = 3,
     /**
-     * Normal
+     * Slide out from the note from downwards on the same string.
      */
-    Regular = 2,
+    OutDown = 4,
     /**
-     * 1 octave lower
+     * Pickslide down on this note
      */
-    _8vb = 3,
+    PickSlideDown = 5,
     /**
-     * 2 octaves lower.
+     * Pickslide up on this note
      */
-    _15mb = 4
+    PickSlideUp = 6
 }
 
 /**
- * Lists all simile mark types as they are assigned to bars.
+ * This public enum lists all vibrato types that can be performed.
  */
-declare enum SimileMark {
+declare enum VibratoType {
     /**
-     * No simile mark is applied
+     * No vibrato.
      */
     None = 0,
     /**
-     * A simple simile mark. The previous bar is repeated.
-     */
-    Simple = 1,
-    /**
-     * A double simile mark. This value is assigned to the first
-     * bar of the 2 repeat bars.
+     * A slight vibrato.
      */
-    FirstOfDouble = 2,
+    Slight = 1,
     /**
-     * A double simile mark. This value is assigned to the second
-     * bar of the 2 repeat bars.
+     * A wide vibrato.
      */
-    SecondOfDouble = 3
+    Wide = 2
 }
 
 /**
- * A voice represents a group of beats
- * that can be played during a bar.
+ * A note is a single played sound on a fretted instrument.
+ * It consists of a fret offset and a string on which the note is played on.
+ * It also can be modified by a lot of different effects.
+ * @cloneable
  * @json
+ * @json_strict
  */
-declare class Voice {
-    private _beatLookup;
-    private static _globalBarId;
+declare class Note {
+    static GlobalNoteId: number;
     /**
-     * Gets or sets the unique id of this bar.
+     * Gets or sets the unique id of this note.
+     * @clone_ignore
      */
     id: number;
     /**
-     * Gets or sets the zero-based index of this voice within the bar.
+     * Gets or sets the zero-based index of this note within the beat.
      * @json_ignore
      */
     index: number;
     /**
-     * Gets or sets the reference to the bar this voice belongs to.
-     * @json_ignore
+     * Gets or sets the accentuation of this note.
      */
-    bar: Bar;
+    accentuated: AccentuationType;
     /**
-     * Gets or sets the list of beats contained in this voice.
-     * @json_add addBeat
+     * Gets or sets the bend type for this note.
      */
-    beats: Beat[];
+    bendType: BendType;
     /**
-     * Gets or sets a value indicating whether this voice is empty.
+     * Gets or sets the bend style for this note.
      */
-    isEmpty: boolean;
-    insertBeat(after: Beat, newBeat: Beat): void;
-    addBeat(beat: Beat): void;
-    private chain;
-    addGraceBeat(beat: Beat): void;
-    getBeatAtPlaybackStart(playbackStart: number): Beat | null;
-    finish(settings: Settings): void;
-    calculateDuration(): number;
-}
-
-/**
- * A bar is a single block within a track, also known as Measure.
- * @json
- */
-declare class Bar {
-    private static _globalBarId;
+    bendStyle: BendStyle;
     /**
-     * Gets or sets the unique id of this bar.
+     * Gets or sets the note from which this note continues the bend.
+     * @clone_ignore
+     * @json_ignore
      */
-    id: number;
+    bendOrigin: Note | null;
     /**
-     * Gets or sets the zero-based index of this bar within the staff.
-     * @json_ignore
+     * Gets or sets whether this note continues a bend from a previous note.
      */
-    index: number;
+    isContinuedBend: boolean;
     /**
-     * Gets or sets the next bar that comes after this bar.
-     * @json_ignore
+     * Gets or sets a list of the points defining the bend behavior.
+     * @clone_add addBendPoint
+     * @json_add addBendPoint
      */
-    nextBar: Bar | null;
+    bendPoints: BendPoint[] | null;
     /**
-     * Gets or sets the previous bar that comes before this bar.
+     * Gets or sets the bend point with the highest bend value.
+     * @clone_ignore
      * @json_ignore
      */
-    previousBar: Bar | null;
+    maxBendPoint: BendPoint | null;
+    get hasBend(): boolean;
+    get isStringed(): boolean;
     /**
-     * Gets or sets the clef on this bar.
+     * Gets or sets the fret on which this note is played on the instrument.
      */
-    clef: Clef;
+    fret: number;
     /**
-     * Gets or sets the ottava applied to the clef.
+     * Gets or sets the string number where the note is placed.
+     * 1 is the lowest string on the guitar and the bottom line on the tablature.
+     * It then increases the the number of strings on available on the track.
      */
-    clefOttava: Ottavia;
+    string: number;
+    get isPiano(): boolean;
     /**
-     * Gets or sets the reference to the parent staff.
-     * @json_ignore
+     * Gets or sets the octave on which this note is played.
      */
-    staff: Staff;
+    octave: number;
     /**
-     * Gets or sets the list of voices contained in this bar.
-     * @json_add addVoice
+     * Gets or sets the tone of this note within the octave.
      */
-    voices: Voice[];
+    tone: number;
+    get isPercussion(): boolean;
     /**
-     * Gets or sets the simile mark on this bar.
+     * Gets or sets the percusson element.
+     * @deprecated
      */
-    simileMark: SimileMark;
+    get element(): number;
     /**
-     * Gets a value indicating whether this bar contains multiple voices with notes.
-     * @json_ignore
+     * Gets or sets the variation of this note.
+     * @deprecated
      */
-    isMultiVoice: boolean;
-    get masterBar(): MasterBar;
-    get isEmpty(): boolean;
-    addVoice(voice: Voice): void;
-    finish(settings: Settings): void;
-    calculateDuration(): number;
-}
-
-/**
- * This public class represents a predefined string tuning.
- * @json
- */
-declare class Tuning {
-    private static _sevenStrings;
-    private static _sixStrings;
-    private static _fiveStrings;
-    private static _fourStrings;
-    private static _defaultTunings;
-    static readonly defaultAccidentals: string[];
-    static readonly defaultSteps: string[];
-    static getTextForTuning(tuning: number, includeOctave: boolean): string;
-    static getTextPartsForTuning(tuning: number, octaveShift?: number): string[];
+    get variation(): number;
     /**
-     * Gets the default tuning for the given string count.
-     * @param stringCount The string count.
-     * @returns The tuning for the given string count or null if the string count is not defined.
+     * Gets or sets the index of percussion articulation in the related `track.percussionArticulations`.
+     * If the articulation is not listed in `track.percussionArticulations` the following list based on GP7 applies:
+     * - 029 Ride (choke)
+     * - 030 Cymbal (hit)
+     * - 031 Snare (side stick)
+     * - 033 Snare (side stick)
+     * - 034 Snare (hit)
+     * - 035 Kick (hit)
+     * - 036 Kick (hit)
+     * - 037 Snare (side stick)
+     * - 038 Snare (hit)
+     * - 039 Hand Clap (hit)
+     * - 040 Snare (hit)
+     * - 041 Low Floor Tom (hit)
+     * - 042 Hi-Hat (closed)
+     * - 043 Very Low Tom (hit)
+     * - 044 Pedal Hi-Hat (hit)
+     * - 045 Low Tom (hit)
+     * - 046 Hi-Hat (open)
+     * - 047 Mid Tom (hit)
+     * - 048 High Tom (hit)
+     * - 049 Crash high (hit)
+     * - 050 High Floor Tom (hit)
+     * - 051 Ride (middle)
+     * - 052 China (hit)
+     * - 053 Ride (bell)
+     * - 054 Tambourine (hit)
+     * - 055 Splash (hit)
+     * - 056 Cowbell medium (hit)
+     * - 057 Crash medium (hit)
+     * - 058 Vibraslap (hit)
+     * - 059 Ride (edge)
+     * - 060 Hand (hit)
+     * - 061 Hand (hit)
+     * - 062 Conga high (mute)
+     * - 063 Conga high (hit)
+     * - 064 Conga low (hit)
+     * - 065 Timbale high (hit)
+     * - 066 Timbale low (hit)
+     * - 067 Agogo high (hit)
+     * - 068 Agogo tow (hit)
+     * - 069 Cabasa (hit)
+     * - 070 Left Maraca (hit)
+     * - 071 Whistle high (hit)
+     * - 072 Whistle low (hit)
+     * - 073 Guiro (hit)
+     * - 074 Guiro (scrap-return)
+     * - 075 Claves (hit)
+     * - 076 Woodblock high (hit)
+     * - 077 Woodblock low (hit)
+     * - 078 Cuica (mute)
+     * - 079 Cuica (open)
+     * - 080 Triangle (rnute)
+     * - 081 Triangle (hit)
+     * - 082 Shaker (hit)
+     * - 083 Tinkle Bell (hat)
+     * - 083 Jingle Bell (hit)
+     * - 084 Bell Tree (hit)
+     * - 085 Castanets (hit)
+     * - 086 Surdo (hit)
+     * - 087 Surdo (mute)
+     * - 091 Snare (rim shot)
+     * - 092 Hi-Hat (half)
+     * - 093 Ride (edge)
+     * - 094 Ride (choke)
+     * - 095 Splash (choke)
+     * - 096 China (choke)
+     * - 097 Crash high (choke)
+     * - 098 Crash medium (choke)
+     * - 099 Cowbell low (hit)
+     * - 100 Cowbell low (tip)
+     * - 101 Cowbell medium (tip)
+     * - 102 Cowbell high (hit)
+     * - 103 Cowbell high (tip)
+     * - 104 Hand (mute)
+     * - 105 Hand (slap)
+     * - 106 Hand (mute)
+     * - 107 Hand (slap)
+     * - 108 Conga low (slap)
+     * - 109 Conga low (mute)
+     * - 110 Conga high (slap)
+     * - 111 Tambourine (return)
+     * - 112 Tambourine (roll)
+     * - 113 Tambourine (hand)
+     * - 114 Grancassa (hit)
+     * - 115 Piatti (hat)
+     * - 116 Piatti (hand)
+     * - 117 Cabasa (return)
+     * - 118 Left Maraca (return)
+     * - 119 Right Maraca (hit)
+     * - 120 Right Maraca (return)
+     * - 122 Shaker (return)
+     * - 123 Bell Tee (return)
+     * - 124 Golpe (thumb)
+     * - 125 Golpe (finger)
+     * - 126 Ride (middle)
+     * - 127 Ride (bell)
      */
-    static getDefaultTuningFor(stringCount: number): Tuning | null;
+    percussionArticulation: number;
     /**
-     * Gets a list of all tuning presets for a given stirng count.
-     * @param stringCount The string count.
-     * @returns The list of known tunings for the given string count or an empty list if the string count is not defined.
+     * Gets or sets whether this note is visible on the music sheet.
      */
-    static getPresetsFor(stringCount: number): Tuning[];
-    static initialize(): void;
+    isVisible: boolean;
     /**
-     * Tries to find a known tuning by a given list of tuning values.
-     * @param strings The values defining the tuning.
-     * @returns The known tuning.
+     * Gets a value indicating whether the note is left hand tapped.
      */
-    static findTuning(strings: number[]): Tuning | null;
+    isLeftHandTapped: boolean;
     /**
-     * Gets or sets whether this is the standard tuning for this number of strings.
+     * Gets or sets whether this note starts a hammeron or pulloff.
      */
-    isStandard: boolean;
+    isHammerPullOrigin: boolean;
+    get isHammerPullDestination(): boolean;
     /**
-     * Gets or sets the name of the tuning.
+     * Gets the origin of the hammeron/pulloff of this note.
+     * @clone_ignore
+     * @json_ignore
      */
-    name: string;
+    hammerPullOrigin: Note | null;
     /**
-     * Gets or sets the values for each string of the instrument.
+     * Gets the destination for the hammeron/pullof started by this note.
+     * @clone_ignore
+     * @json_ignore
      */
-    tunings: number[];
+    hammerPullDestination: Note | null;
+    get isSlurOrigin(): boolean;
     /**
-     * Initializes a new instance of the {@link Tuning} class.
-     * @param name The name.
-     * @param tuning The tuning.
-     * @param isStandard if set to`true`[is standard].
+     * Gets or sets whether this note finishes a slur.
      */
-    constructor(name?: string, tuning?: number[] | null, isStandard?: boolean);
+    isSlurDestination: boolean;
     /**
-     * Tries to detect the name and standard flag of the tuning from a known tuning list based
-     * on the string values.
+     * Gets or sets the note where the slur of this note starts.
+     * @clone_ignore
+     * @json_ignore
      */
-    finish(): void;
-}
-
-/**
- * This class describes a single staff within a track. There are instruments like pianos
- * where a single track can contain multiple staffs.
- * @json
- */
-declare class Staff {
+    slurOrigin: Note | null;
     /**
-     * Gets or sets the zero-based index of this staff within the track.
+     * Gets or sets the note where the slur of this note ends.
+     * @clone_ignore
      * @json_ignore
      */
-    index: number;
+    slurDestination: Note | null;
+    get isHarmonic(): boolean;
     /**
-     * Gets or sets the reference to the track this staff belongs to.
+     * Gets or sets the harmonic type applied to this note.
+     */
+    harmonicType: HarmonicType;
+    /**
+     * Gets or sets the value defining the harmonic pitch.
+     */
+    harmonicValue: number;
+    /**
+     * Gets or sets whether the note is a ghost note and shown in parenthesis. Also this will make the note a bit more silent.
+     */
+    isGhost: boolean;
+    /**
+     * Gets or sets whether this note has a let-ring effect.
+     */
+    isLetRing: boolean;
+    /**
+     * Gets or sets the destination note for the let-ring effect.
+     * @clone_ignore
      * @json_ignore
      */
-    track: Track;
+    letRingDestination: Note | null;
     /**
-     * Gets or sets a list of all bars contained in this staff.
-     * @json_add addBar
+     * Gets or sets whether this note has a palm-mute effect.
      */
-    bars: Bar[];
+    isPalmMute: boolean;
     /**
-     * Gets or sets a list of all chords defined for this staff. {@link Beat.chordId} refers to entries in this lookup.
-     * @json_add addChord
+     * Gets or sets the destination note for the palm-mute effect.
+     * @clone_ignore
+     * @json_ignore
      */
-    chords: Map<string, Chord>;
+    palmMuteDestination: Note | null;
     /**
-     * Gets or sets the fret on which a capo is set.
+     * Gets or sets whether the note is shown and played as dead note.
      */
-    capo: number;
+    isDead: boolean;
     /**
-     * Gets or sets the number of semitones this track should be
-     * transposed. This applies to rendering and playback.
+     * Gets or sets whether the note is played as staccato.
      */
-    transpositionPitch: number;
+    isStaccato: boolean;
     /**
-     * Gets or sets the number of semitones this track should be
-     * transposed. This applies only to rendering.
+     * Gets or sets the slide-in type this note is played with.
      */
-    displayTranspositionPitch: number;
+    slideInType: SlideInType;
     /**
-     * Get or set the guitar tuning of the guitar. This tuning also indicates the number of strings shown in the
-     * guitar tablature. Unlike the {@link Note.string} property this array directly represents
-     * the order of the tracks shown in the tablature. The first item is the most top tablature line.
+     * Gets or sets the slide-out type this note is played with.
      */
-    stringTuning: Tuning;
+    slideOutType: SlideOutType;
     /**
-     * Get or set the values of the related guitar tuning.
+     * Gets or sets the target note for several slide types.
+     * @clone_ignore
+     * @json_ignore
      */
-    get tuning(): number[];
+    slideTarget: Note | null;
     /**
-     * Gets or sets the name of the tuning.
+     * Gets or sets the source note for several slide types.
+     * @clone_ignore
+     * @json_ignore
      */
-    get tuningName(): string;
-    get isStringed(): boolean;
+    slideOrigin: Note | null;
     /**
-     * Gets or sets whether the tabs are shown.
+     * Gets or sets whether a vibrato is played on the note.
      */
-    showTablature: boolean;
+    vibrato: VibratoType;
     /**
-     * Gets or sets whether the standard notation is shown.
+     * Gets the origin of the tied if this note is tied.
+     * @clone_ignore
+     * @json_ignore
      */
-    showStandardNotation: boolean;
+    tieOrigin: Note | null;
     /**
-     * Gets or sets whether the staff contains percussion notation
+     * Gets the desination of the tie.
+     * @clone_ignore
+     * @json_ignore
      */
-    isPercussion: boolean;
+    tieDestination: Note | null;
     /**
-     * The number of lines shown for the standard notation.
-     * For some percussion instruments this number might vary.
+     * Gets or sets whether this note is ends a tied note.
      */
-    standardNotationLineCount: number;
-    finish(settings: Settings): void;
-    addChord(chordId: string, chord: Chord): void;
-    addBar(bar: Bar): void;
-}
-
-/**
- * A chord definition.
- * @json
- */
-declare class Chord {
+    isTieDestination: boolean;
+    get isTieOrigin(): boolean;
     /**
-     * Gets or sets the name of the chord
+     * Gets or sets the fingers used for this note on the left hand.
      */
-    name: string;
+    leftHandFinger: Fingers;
     /**
-     * Indicates the first fret of the chord diagram.
+     * Gets or sets the fingers used for this note on the right hand.
      */
-    firstFret: number;
+    rightHandFinger: Fingers;
     /**
-     * Gets or sets the frets played on the individual strings for this chord.
-     * - The order in this list goes from the highest string to the lowest string.
-     * - -1 indicates that the string is not played.
+     * Gets or sets whether this note has fingering defined.
      */
-    strings: number[];
+    isFingering: boolean;
     /**
-     * Gets or sets a list of frets where the finger should hold a barre
+     * Gets or sets the target note value for the trill effect.
      */
-    barreFrets: number[];
+    trillValue: number;
+    get trillFret(): number;
+    get isTrill(): boolean;
     /**
-     * Gets or sets the staff the chord belongs to.
-     * @json_ignore
+     * Gets or sets the speed of the trill effect.
      */
-    staff: Staff;
+    trillSpeed: Duration;
     /**
-     * Gets or sets whether the chord name is shown above the chord diagram.
+     * Gets or sets the percentual duration of the note relative to the overall beat duration .
      */
-    showName: boolean;
+    durationPercent: number;
     /**
-     * Gets or sets whether the chord diagram is shown.
+     * Gets or sets how accidetnals for this note should  be handled.
      */
-    showDiagram: boolean;
+    accidentalMode: NoteAccidentalMode;
     /**
-     * Gets or sets whether the fingering is shown below the chord diagram.
+     * Gets or sets the reference to the parent beat to which this note belongs to.
+     * @clone_ignore
+     * @json_ignore
      */
-    showFingering: boolean;
-}
-
-/**
- * Lists all Crescendo and Decrescendo types.
- */
-declare enum CrescendoType {
+    beat: Beat;
     /**
-     * No crescendo applied.
+     * Gets or sets the dynamics for this note.
      */
-    None = 0,
+    dynamics: DynamicValue;
     /**
-     * Normal crescendo applied.
+     * @clone_ignore
+     * @json_ignore
      */
-    Crescendo = 1,
+    isEffectSlurOrigin: boolean;
     /**
-     * Normal decrescendo applied.
+     * @clone_ignore
+     * @json_ignore
      */
-    Decrescendo = 2
-}
-
-/**
- * Lists all types of grace notes
- */
-declare enum GraceType {
+    hasEffectSlur: boolean;
+    get isEffectSlurDestination(): boolean;
     /**
-     * No grace, normal beat.
+     * @clone_ignore
+     * @json_ignore
      */
-    None = 0,
+    effectSlurOrigin: Note | null;
     /**
-     * The beat contains on-beat grace notes.
+     * @clone_ignore
+     * @json_ignore
      */
-    OnBeat = 1,
+    effectSlurDestination: Note | null;
+    get stringTuning(): number;
+    static getStringTuning(staff: Staff, noteString: number): number;
+    get realValue(): number;
+    get realValueWithoutHarmonic(): number;
+    get harmonicPitch(): number;
+    get initialBendValue(): number;
+    get displayValue(): number;
+    get displayValueWithoutBend(): number;
+    get hasQuarterToneOffset(): boolean;
+    addBendPoint(point: BendPoint): void;
+    finish(settings: Settings, sharedDataBag: Map<string, unknown>): void;
+    private static readonly MaxOffsetForSameLineSearch;
+    static nextNoteOnSameLine(note: Note): Note | null;
+    static findHammerPullDestination(note: Note): Note | null;
+    static findTieOrigin(note: Note): Note | null;
+    private static NoteIdLookupKey;
+    private _noteIdBag;
+    chain(sharedDataBag: Map<string, unknown>): void;
     /**
-     * The beat contains before-beat grace notes.
+     * @internal
      */
-    BeforeBeat = 2,
+    toJson(o: Map<string, unknown>): void;
     /**
-     * The beat contains very special bend-grace notes used in SongBook style displays.
+     * @internal
      */
-    BendGrace = 3
+    setProperty(property: string, v: unknown): boolean;
 }
 
 /**
@@ -3526,6 +3540,7 @@ declare enum BeatBeamingMode {
  * A beat is a single block within a bar. A beat is a combination
  * of several notes played at the same time.
  * @json
+ * @json_strict
  * @cloneable
  */
 declare class Beat {
@@ -3714,7 +3729,7 @@ declare class Beat {
      * @json_add addWhammyBarPoint
      * @clone_add addWhammyBarPoint
      */
-    whammyBarPoints: BendPoint[];
+    whammyBarPoints: BendPoint[] | null;
     /**
      * Gets or sets the highest point with for the highest whammy bar value.
      * @json_ignore
@@ -3830,7 +3845,7 @@ declare class Beat {
     private calculateDuration;
     updateDurations(): void;
     finishTuplet(): void;
-    finish(settings: Settings): void;
+    finish(settings: Settings, sharedDataBag: Map<string, unknown>): void;
     /**
      * Checks whether the current beat is timewise before the given beat.
      * @param beat
@@ -3845,7 +3860,7 @@ declare class Beat {
     isAfter(beat: Beat): boolean;
     hasNoteOnString(noteString: number): boolean;
     getNoteWithRealValue(noteRealValue: number): Note | null;
-    chain(): void;
+    chain(sharedDataBag: Map<string, unknown>): void;
 }
 
 /**
@@ -4341,7 +4356,7 @@ interface IScoreRenderer {
      * @param score The score defining the tracks.
      * @param trackIndexes The indexes of the tracks to draw.
      */
-    renderScore(score: Score, trackIndexes: number[]): void;
+    renderScore(score: Score | null, trackIndexes: number[] | null): void;
     /**
      * Initiates the rendering of a partial render result which the renderer
      * should have layed out already.
@@ -4715,6 +4730,7 @@ declare class AlphaTabApiBase<TSettings> {
     private _previousTick;
     private _playerState;
     private _currentBeat;
+    private _currentBarBounds;
     private _previousStateForCursor;
     private _previousCursorCache;
     private _lastScroll;
@@ -4724,12 +4740,18 @@ declare class AlphaTabApiBase<TSettings> {
      * updates the cursors to highlight the beat at the specified tick position
      * @param tick
      * @param stop
+     * @param shouldScroll whether we should scroll to the bar (if scrolling is active)
      */
     private cursorUpdateTick;
     /**
      * updates the cursors to highlight the specified beat
      */
     private cursorUpdateBeat;
+    /**
+     * Initiates a scroll to the cursor
+     */
+    scrollToCursor(): void;
+    internalScrollToCursor(barBoundings: MasterBarBounds): void;
     private internalCursorUpdateBeat;
     playedBeatChanged: IEventEmitterOfT<Beat>;
     private onPlayedBeatChanged;
@@ -4885,7 +4907,7 @@ declare class ScoreLoader {
  */
 declare class UnsupportedFormatError extends AlphaTabError {
     inner: Error | null;
-    constructor(message?: string, inner?: Error | null);
+    constructor(message?: string | null, inner?: Error | null);
 }
 
 type index_d$5_ScoreImporter = ScoreImporter;
@@ -6136,7 +6158,7 @@ declare class StaveGroup {
     paint(cx: number, cy: number, canvas: ICanvas): void;
     paintPartial(cx: number, cy: number, canvas: ICanvas, startIndex: number, count: number): void;
     finalizeGroup(): void;
-    private buildBoundingsLookup;
+    buildBoundingsLookup(cx: number, cy: number): void;
     getBarX(index: number): number;
 }
 
@@ -6413,7 +6435,7 @@ declare class TuningContainerGlyph extends RowContainerGlyph {
 }
 
 /**
- * This is the base public class for creating new layouting engines for the score renderer.
+ * This is the base class for creating new layouting engines for the score renderer.
  */
 declare abstract class ScoreLayout {
     private _barRendererLookup;
@@ -6425,7 +6447,6 @@ declare abstract class ScoreLayout {
     protected chordDiagrams: ChordDiagramContainerGlyph | null;
     protected tuningGlyph: TuningContainerGlyph | null;
     protected constructor(renderer: ScoreRenderer);
-    abstract get padding(): number[];
     abstract get firstBarX(): number;
     abstract get supportsResize(): boolean;
     resize(): void;
@@ -6458,6 +6479,9 @@ declare class ScoreRenderer implements IScoreRenderer {
     canvas: ICanvas | null;
     score: Score | null;
     tracks: Track[] | null;
+    /**
+     * @internal
+     */
     layout: ScoreLayout | null;
     settings: Settings;
     boundsLookup: BoundsLookup | null;
@@ -6470,7 +6494,7 @@ declare class ScoreRenderer implements IScoreRenderer {
     destroy(): void;
     private recreateCanvas;
     private recreateLayout;
-    renderScore(score: Score, trackIndexes: number[]): void;
+    renderScore(score: Score | null, trackIndexes: number[] | null): void;
     /**
      * Initiates rendering fof the given tracks.
      * @param tracks The tracks to render.