@coderline/alphatab 1.7.0-alpha.1582 → 1.7.0-alpha.1584

package/dist/alphaTab.d.ts

@@ -2933,31 +2933,867 @@ declare enum AlphaTabSystemExclusiveEvents {
     Rest = 1
 }
 
+export declare namespace alphaTex {
+    export {
+        AlphaTexAsteriskTokenNode,
+        AlphaTexAstNode,
+        AlphaTexAstNodeLocation,
+        AlphaTexBackSlashTokenNode,
+        AlphaTexBarNode,
+        AlphaTexBeatDurationChangeNode,
+        AlphaTexBeatNode,
+        AlphaTexBraceCloseTokenNode,
+        AlphaTexBraceOpenTokenNode,
+        AlphaTexColonTokenNode,
+        AlphaTexComment,
+        AlphaTexDotTokenNode,
+        AlphaTexDoubleBackSlashTokenNode,
+        AlphaTexIdentifier,
+        AlphaTexMetaDataNode,
+        AlphaTexMetaDataTagNode,
+        AlphaTexNodeType,
+        AlphaTexNoteListNode,
+        AlphaTexNoteNode,
+        AlphaTexNumberLiteral,
+        AlphaTexParenthesisCloseTokenNode,
+        AlphaTexParenthesisOpenTokenNode,
+        AlphaTexPipeTokenNode,
+        AlphaTexPropertiesNode,
+        AlphaTexPropertyNode,
+        AlphaTexScoreNode,
+        AlphaTexStringLiteral,
+        AlphaTexTextNode,
+        AlphaTexTokenNode,
+        AlphaTexValueList,
+        IAlphaTexAstNode,
+        IAlphaTexMetaDataTagPrefixNode,
+        IAlphaTexNoteValueNode,
+        IAlphaTexValueListItem,
+        AlphaTexLexer,
+        AlphaTexParser,
+        AlphaTexAccidentalMode,
+        AlphaTexDiagnostic,
+        AlphaTexDiagnosticBag,
+        AlphaTexDiagnosticCode,
+        AlphaTexDiagnosticsSeverity,
+        IAlphaTexImporter,
+        IAlphaTexImporterState
+    }
+}
+
+/**
+ * @public
+ */
+declare enum AlphaTexAccidentalMode {
+    Auto = 0,
+    Explicit = 1
+}
+
+/**
+ * @record
+ * @public
+ */
+declare interface AlphaTexAsteriskTokenNode extends AlphaTexTokenNode {
+    nodeType: AlphaTexNodeType.Asterisk;
+}
+
+/**
+ * The base type for all alphaTex AST nodes
+ * @record
+ * @public
+ */
+declare interface AlphaTexAstNode extends IAlphaTexAstNode {
+}
+
+/**
+ * Maps an AST node into its respective source code location.
+ * @record
+ * @public
+ */
+declare interface AlphaTexAstNodeLocation {
+    /**
+     * The 1-based line index within the source code.
+     */
+    line: number;
+    /**
+     * The 1-based column index within the source code.
+     */
+    col: number;
+    /**
+     * The 0-based codepoint offset within the source code.
+     */
+    offset: number;
+}
+
+/**
+ * @record
+ * @public
+ */
+declare interface AlphaTexBackSlashTokenNode extends AlphaTexTokenNode, IAlphaTexMetaDataTagPrefixNode {
+    nodeType: AlphaTexNodeType.Backslash;
+}
+
+/**
+ * A node describing the bar level contents as written in alphaTex.
+ * @record
+ * @public
+ */
+declare interface AlphaTexBarNode extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.Bar;
+    /**
+     * The metadata tags preceeding the bar contents, might start
+     * new tracks, staves, voices etc.
+     */
+    metaData: AlphaTexMetaDataNode[];
+    /**
+     * The beats contained in this bar.
+     */
+    beats: AlphaTexBeatNode[];
+    /**
+     * The pipe symbol denoting the end of the bar.
+     */
+    pipe?: AlphaTexPipeTokenNode;
+}
+
+/**
+ * A note describing a duration change like `:4` or `:4 { tu 3 }`
+ * @record
+ * @public
+ */
+declare interface AlphaTexBeatDurationChangeNode extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.Duration;
+    /**
+     * The colon token marking the duration change node
+     */
+    colon: AlphaTexColonTokenNode;
+    /**
+     * The numeric value describing the duration.
+     */
+    value?: AlphaTexNumberLiteral;
+    /**
+     * Additional duration attributes like tuplets.
+     */
+    properties?: AlphaTexPropertiesNode;
+}
+
+/**
+ * A node describing a beat within alphaTex.
+ * @record
+ * @public
+ */
+declare interface AlphaTexBeatNode extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.Beat;
+    /**
+     * An optional marker changing the beat duration via a marker like `:4`
+     */
+    durationChange?: AlphaTexBeatDurationChangeNode;
+    /**
+     * The notes contained in this beat (mutually exclusive with `rest`)
+     */
+    notes?: AlphaTexNoteListNode;
+    /**
+     * The marker indicating that this beat is a rest beat. Currently always an identifier with `r`
+     */
+    rest?: AlphaTexIdentifier;
+    /**
+     * The dot separating the beat content and the postfix beat duration
+     */
+    durationDot?: AlphaTexDotTokenNode;
+    /**
+     * The postfix beat duration.
+     */
+    durationValue?: AlphaTexNumberLiteral;
+    /**
+     * The `*` marker for repeating this beat multiple times. Must have a filled `beatMultiplierValue`
+     */
+    beatMultiplier?: AlphaTexAsteriskTokenNode;
+    /**
+     * The numeric value how often the beat should be repeated.
+     */
+    beatMultiplierValue?: AlphaTexNumberLiteral;
+    /**
+     * The effect list for this beat.
+     */
+    beatEffects?: AlphaTexPropertiesNode;
+}
+
+/**
+ * @record
+ * @public
+ */
+declare interface AlphaTexBraceCloseTokenNode extends AlphaTexTokenNode {
+    nodeType: AlphaTexNodeType.RBrace;
+}
+
+/**
+ * @record
+ * @public
+ */
+declare interface AlphaTexBraceOpenTokenNode extends AlphaTexTokenNode {
+    nodeType: AlphaTexNodeType.LBrace;
+}
+
+/**
+ * @record
+ * @public
+ */
+declare interface AlphaTexColonTokenNode extends AlphaTexTokenNode {
+    nodeType: AlphaTexNodeType.Colon;
+}
+
+/**
+ * A comment attached to a node.
+ * @record
+ * @public
+ */
+declare interface AlphaTexComment {
+    /**
+     * The start of this node when parsed from an input source file.
+     */
+    start?: AlphaTexAstNodeLocation;
+    /**
+     * The end (inclusive) of this node when parsed from an input source file.
+     */
+    end?: AlphaTexAstNodeLocation;
+    /**
+     * Whether the comment is a multiline comment or a single line comment
+     */
+    multiLine: boolean;
+    /**
+     * The comment text excluding the comment start/end markers.
+     */
+    text: string;
+}
+
+/**
+ * A diagnostics message for the alphaTex parser.
+ * @record
+ * @public
+ */
+declare interface AlphaTexDiagnostic {
+    /**
+     * The severity of the diagnostic.
+     */
+    severity: AlphaTexDiagnosticsSeverity;
+    /**
+     * The start location to which the diagnostic message belongs.
+     */
+    start?: AlphaTexAstNodeLocation;
+    /**
+     * The end location to which the diagnostic message belongs.
+     */
+    end?: AlphaTexAstNodeLocation;
+    /**
+     * A technical code describing the diagnostic message.
+     */
+    code: AlphaTexDiagnosticCode;
+    /**
+     * The textual message for the diagnostic.
+     */
+    message: string;
+}
+
+/**
+ * @public
+ */
+declare class AlphaTexDiagnosticBag implements Iterable<AlphaTexDiagnostic> {
+    private _hasErrors;
+    readonly items: AlphaTexDiagnostic[];
+    get errors(): AlphaTexDiagnostic[];
+    get hasErrors(): boolean;
+    push(diagnostic: AlphaTexDiagnostic): void;
+    [Symbol.iterator](): Iterator<AlphaTexDiagnostic>;
+}
+
+/**
+ * @public
+ */
+declare enum AlphaTexDiagnosticCode {
+    /**
+     * Unexpected character at comment start, expected '//' or '/*' but found '/%s'.
+     */
+    AT001 = 1,
+    /**
+     * Missing identifier after meta data start.
+     */
+    AT002 = 2,
+    /**
+     * Unexpected end of file. Need 4 hex characters on a \uXXXX escape sequence.
+     */
+    AT003 = 3,
+    /**
+     * Invalid unicode value. Need 4 hex characters on a \uXXXX escape sequence.
+     */
+    AT004 = 4,
+    /**
+     * Unsupported escape sequence. Expected '\n', '\r', '\t', or '\uXXXX' but found '\%s'.
+     */
+    AT005 = 5,
+    /**
+     * Unexpected end of file. String not closed.
+     */
+    AT006 = 6,
+    /**
+     * Missing beat multiplier value after '*'.
+     */
+    AT200 = 200,
+    /**
+     * Missing duration value after ':'.
+     */
+    AT201 = 201,
+    /**
+     * Unexpected '%s' token. Expected one of following: %s
+     */
+    AT202 = 202,
+    /**
+     * Unexpected end of file.
+     */
+    AT203 = 203,
+    /**
+     * Unrecognized metadata '%s'.
+     */
+    AT204 = 204,
+    /**
+     * Unrecognized property '%s'.
+     */
+    AT205 = 205,
+    /**
+     * Unexpected end of file. Group not closed.
+     */
+    AT206 = 206,
+    /**
+     * Missing string for fretted note.
+     */
+    AT207 = 207,
+    /**
+     * Note string is out of range. Available range: 1-%s
+     */
+    AT208 = 208,
+    /**
+     * Unexpected %s value '%s', expected: %s
+     */
+    AT209 = 209,
+    /**
+     * Missing values. Expected following values: %s
+     */
+    AT210 = 210,
+    /**
+     * Value is out of valid range. Allowed range: %s, Actual Value: %s
+     */
+    AT211 = 211,
+    /**
+     * Unrecogized property '%s', expected one of %s
+     */
+    AT212 = 212,
+    /**
+     * Invalid format for color
+     */
+    AT213 = 213,
+    /**
+     * The '%s' effect needs %s values per item. With %s points, %s values are needed, only %s values found.
+     */
+    AT214 = 214,
+    /**
+     * Cannot use pitched note value '%s' on %s staff, please specify notes using the 'fret.string' syntax.
+     */
+    AT215 = 215,
+    /**
+     * Cannot use pitched note value '%s' on percussion staff, please specify percussion articulations with numbers or names.
+     */
+    AT216 = 216,
+    /**
+     * Unrecognized note value '%s'.
+     */
+    AT217 = 217,
+    /**
+     * Wrong note kind '%s' for staff with note kind '%s'. Do not mix incompatible staves and notes.
+     */
+    AT218 = 218,
+    /**
+     * Expected no values, but found some. Values are ignored.
+     */
+    AT300 = 300,
+    /**
+     * Metadata values should be wrapped into parenthesis.
+     */
+    AT301 = 301,
+    /**
+     * Metadata values should be placed before metadata properties.
+     */
+    AT302 = 302,
+    /**
+     * Property values should be wrapped into parenthesis.
+     */
+    AT303 = 303,
+    /**
+     * The beat multiplier should be specified after the beat effects.
+     */
+    AT304 = 304,
+    /**
+     * This value should be rather specified via the properties.
+     */
+    AT305 = 305,
+    /**
+     * This staff metadata tag should be specified as staff property.
+     */
+    AT306 = 306,
+    /**
+     * The dots separating score metadata, score contents and the sync points can be removed.
+     */
+    AT400 = 400
+}
+
+/**
+ * The different severity levels for diagnostics parsing alphaTex.
+ * @public
+ */
+declare enum AlphaTexDiagnosticsSeverity {
+    Hint = 0,
+    Warning = 1,
+    Error = 2
+}
+
+/**
+ * @record
+ * @public
+ */
+declare interface AlphaTexDotTokenNode extends AlphaTexTokenNode {
+    nodeType: AlphaTexNodeType.Dot;
+}
+
+/**
+ * @record
+ * @public
+ */
+declare interface AlphaTexDoubleBackSlashTokenNode extends AlphaTexTokenNode, IAlphaTexMetaDataTagPrefixNode {
+    nodeType: AlphaTexNodeType.DoubleBackslash;
+}
+
+/**
+ * @public
+ */
+declare class AlphaTexErrorWithDiagnostics extends AlphaTabError {
+    lexerDiagnostics?: AlphaTexDiagnosticBag;
+    parserDiagnostics?: AlphaTexDiagnosticBag;
+    semanticDiagnostics?: AlphaTexDiagnosticBag;
+    iterateDiagnostics(): Generator<AlphaTexDiagnostic, void, unknown>;
+    constructor(message: string, lexerDiagnostics?: AlphaTexDiagnosticBag, parserDiagnostics?: AlphaTexDiagnosticBag, semanticDiagnostics?: AlphaTexDiagnosticBag);
+    toString(): string;
+    private static _diagnosticsToString;
+    private static _locationToString;
+}
+
 /**
  * This ScoreExporter can write alphaTex strings.
  * @public
  */
 declare class AlphaTexExporter extends ScoreExporter {
-    private static readonly _defaultScore;
-    private static readonly _defaultTrack;
+    private _handler;
     get name(): string;
     exportToString(score: Score, settings?: Settings | null): string;
     writeScore(score: Score): void;
     scoreToAlphaTexString(score: Score): string;
-    private _writeScoreTo;
-    private _writeStyleSheetTo;
-    private _writeTrackTo;
-    private _writeStaffTo;
-    private _writeBarTo;
-    private _writeStaffMetaTo;
-    private _writeChordTo;
-    private _writeMasterBarMetaTo;
-    private _writeBarMetaTo;
-    private _writeVoiceTo;
-    private _writeBeatTo;
-    private _writeBeatEffectsTo;
-    private _writeNoteTo;
-    private _writeNoteEffectsTo;
+    private _score;
+    private _track;
+    private _staff;
+    private _voice;
+    private _bar;
+    private _beat;
+    private _beatEffects;
+    private _notes;
+    private _note;
+    private _noteEffects;
+}
+
+/**
+ * A node describing an identifier. This is typically a string-like value
+ * but not quoted.
+ * @record
+ * @public
+ */
+declare interface AlphaTexIdentifier extends AlphaTexTextNode, IAlphaTexValueListItem, IAlphaTexNoteValueNode {
+    nodeType: AlphaTexNodeType.Ident;
+}
+
+/**
+ * @public
+ */
+declare class AlphaTexImporter extends ScoreImporter implements IAlphaTexImporter {
+    private _parser;
+    private _handler;
+    private _state;
+    get state(): IAlphaTexImporterState;
+    get name(): string;
+    get lexerDiagnostics(): AlphaTexDiagnosticBag;
+    get parserDiagnostics(): AlphaTexDiagnosticBag;
+    logErrors: boolean;
+    readonly semanticDiagnostics: AlphaTexDiagnosticBag;
+    addSemanticDiagnostic(diagnostic: AlphaTexDiagnostic): void;
+    initFromString(tex: string, settings: Settings): void;
+    readScore(): Score;
+    private _createDefaultScore;
+    private _newTrack;
+    private _beginStaff;
+    private _bars;
+    private _bar;
+    private _beat;
+    private _beatEffects;
+    private _beatDuration;
+    private _parseDuration;
+    private _note;
+
+    applyStaffNoteKind(staff: Staff, staffNoteKind: StaffNoteKind): void;
+    private _noteEffects;
+    private _handleTransposition;
+    private _detectTuningForStaff;
+    private _barMeta;
+    private _newBar;
+    startNewStaff(): Staff;
+    applyPercussionStaff(staff: Staff): void;
+    startNewTrack(): Track;
+    startNewVoice(): void;
+}
+
+/**
+ * @public
+ */
+declare class AlphaTexLexer {
+    private static readonly _eof;
+    private readonly _codepoints;
+    private _codepoint;
+    private _offset;
+    private _line;
+    private _col;
+    private _fatalError;
+    private _tokenStart;
+    private _leadingComments;
+    private _trailingCommentNode;
+    private _previousToken;
+    private _peekedToken;
+    readonly lexerDiagnostics: AlphaTexDiagnosticBag;
+    constructor(input: string);
+    peekToken(): AlphaTexAstNode | undefined;
+    extendToFloat(peekedNode: AlphaTexNumberLiteral): AlphaTexNumberLiteral;
+    advance(): void;
+    private _nextCodepoint;
+    previousTokenEndLocation(): AlphaTexAstNodeLocation;
+    currentTokenLocation(): AlphaTexAstNodeLocation;
+    private _currentLexerLocation;
+    private _readToken;
+    private _comment;
+    private static _terminalTokens;
+    private _metaCommand;
+    private _token;
+    private _string;
+    private _multiLineComment;
+    private _numberOrIdentifier;
+    private _singleLineComment;
+    private _whitespace;
+    private static _isDigit;
+    private static _buildNonIdentifierChars;
+    private static readonly _nonIdentifierChars;
+    private static _isIdentifierCharacter;
+    private static _isWhiteSpace;
+}
+
+/**
+ * A metadata tag with optional values and optional properties like:
+ * `\track "Name" {color "#F00"}` .
+ * @record
+ * @public
+ */
+declare interface AlphaTexMetaDataNode extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.Meta;
+    /**
+     * The tag part of the metadata.
+     */
+    tag: AlphaTexMetaDataTagNode;
+    /**
+     * A value list directly listed after the metadata (not within braces).
+     */
+    values?: AlphaTexValueList;
+    /**
+     * The optional properties attached to the metadata.
+     */
+    properties?: AlphaTexPropertiesNode;
+    /**
+     * Whether the properties are listed before the values (if both are present).
+     */
+    propertiesBeforeValues: boolean;
+}
+
+/**
+ * A metadata tag marker like `\title`
+ * @record
+ * @public
+ */
+declare interface AlphaTexMetaDataTagNode extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.Tag;
+    /**
+     * The prefix indicating the start of the tag (e.g. `\` or `\\`)
+     */
+    prefix?: IAlphaTexMetaDataTagPrefixNode;
+    /**
+     * The identifier of the tag (e.g. `title`)
+     */
+    tag: AlphaTexIdentifier;
+}
+
+/**
+ * All node types for the alphaTex syntax tree.
+ * @public
+ */
+declare enum AlphaTexNodeType {
+    Dot = 0,
+    Backslash = 1,
+    DoubleBackslash = 2,
+    Pipe = 3,
+    LBrace = 4,
+    RBrace = 5,
+    LParen = 6,
+    RParen = 7,
+    Colon = 8,
+    Asterisk = 9,
+    Ident = 10,
+    Tag = 11,
+    Meta = 12,
+    Values = 13,
+    Props = 14,
+    Prop = 15,
+    Number = 16,
+    String = 17,
+    Score = 18,
+    Bar = 19,
+    Beat = 20,
+    Duration = 21,
+    NoteList = 22,
+    Note = 23
+}
+
+/**
+ * A list of notes for the beat.
+ * @record
+ * @public
+ */
+declare interface AlphaTexNoteListNode extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.NoteList;
+    /**
+     * An open parenthesis token to group multiple notes for a beat.
+     */
+    openParenthesis?: AlphaTexParenthesisOpenTokenNode;
+    /**
+     * The notes contained in this list.
+     */
+    notes: AlphaTexNoteNode[];
+    /**
+     * A close parenthesis token to group multiple notes for a beat.
+     */
+    closeParenthesis?: AlphaTexParenthesisCloseTokenNode;
+}
+
+/**
+ * A node describing a single note.
+ * @record
+ * @public
+ */
+declare interface AlphaTexNoteNode extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.Note;
+    /**
+     * The value of the note. Depending on whether it is a fretted, pitched or percussion
+     * note this value varies.
+     */
+    noteValue: IAlphaTexNoteValueNode;
+    /**
+     * The dot separating the note value and the string for fretted/stringed instruments like guitars.
+     */
+    noteStringDot?: AlphaTexDotTokenNode;
+    /**
+     * The string value for fretted/stringed notes like guitars.
+     */
+    noteString?: AlphaTexNumberLiteral;
+    /**
+     * The effect list for this note. Semantically this list might also contain
+     * effects applied to the beat level. This allows specifying beat effects
+     * on a single note beat like `C4{txt "Beat Text" turn}` instead of
+     * `C4{turn}{txt Beat}`
+     */
+    noteEffects?: AlphaTexPropertiesNode;
+}
+
+/**
+ * A number literal within alphaTex. Can be a integer or floating point number.
+ * @record
+ * @public
+ */
+declare interface AlphaTexNumberLiteral extends AlphaTexAstNode, IAlphaTexValueListItem, IAlphaTexNoteValueNode {
+    nodeType: AlphaTexNodeType.Number;
+    /**
+     * The numeric value described by this literal.
+     */
+    value: number;
+}
+
+/**
+ * @record
+ * @public
+ */
+declare interface AlphaTexParenthesisCloseTokenNode extends AlphaTexTokenNode {
+    nodeType: AlphaTexNodeType.RParen;
+}
+
+/**
+ * @record
+ * @public
+ */
+declare interface AlphaTexParenthesisOpenTokenNode extends AlphaTexTokenNode {
+    nodeType: AlphaTexNodeType.LParen;
+}
+
+/**
+ * A parser for translating a given alphaTex source into an AST for further use
+ * in the alphaTex importer, editors etc.
+ * @public
+ */
+declare class AlphaTexParser {
+    readonly lexer: AlphaTexLexer;
+    private _scoreNode;
+    private _metaDataReader;
+    get lexerDiagnostics(): AlphaTexDiagnosticBag;
+    readonly parserDiagnostics: AlphaTexDiagnosticBag;
+    addParserDiagnostic(diagnostics: AlphaTexDiagnostic): void;
+
+    constructor(source: string);
+    read(): AlphaTexScoreNode;
+    private _score;
+    private _bars;
+    private _bar;
+    private _barMetaData;
+    private _barBeats;
+    private _beat;
+    private _beatDuration;
+    private _beatDurationChange;
+    private _beatContent;
+    private _beatMultiplier;
+    private _noteList;
+    private _note;
+    private _metaData;
+    private _properties;
+    private _property;
+    valueList(): AlphaTexValueList | undefined;
+}
+
+/**
+ * @record
+ * @public
+ */
+declare interface AlphaTexPipeTokenNode extends AlphaTexTokenNode {
+    nodeType: AlphaTexNodeType.Pipe;
+}
+
+/**
+ * A node describing a list of properties grouped by braces.
+ * Used in contexts like note effects, beat effects
+ * @record
+ * @public
+ */
+declare interface AlphaTexPropertiesNode extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.Props;
+    /**
+     * The open brace grouping the properties (if needed).
+     */
+    openBrace?: AlphaTexBraceOpenTokenNode;
+    /**
+     * The individual properties
+     */
+    properties: AlphaTexPropertyNode[];
+    /**
+     * The close brace grouping the properties (if needed).
+     */
+    closeBrace?: AlphaTexBraceCloseTokenNode;
+}
+
+/**
+ * A node describing a property with attached values.
+ * @record
+ * @public
+ */
+declare interface AlphaTexPropertyNode extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.Prop;
+    /**
+     * The identifier describing the property.
+     */
+    property: AlphaTexIdentifier;
+    /**
+     * The values attached to the property.
+     */
+    values?: AlphaTexValueList;
+}
+
+/**
+ * A node describing the root of an alphaTex file for a musical score.
+ * @record
+ * @public
+ */
+declare interface AlphaTexScoreNode extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.Score;
+    /**
+     * The bars describing the contents of the song.
+     */
+    bars: AlphaTexBarNode[];
+}
+
+/**
+ * A string literal within alphaTex.
+ * @record
+ * @public
+ */
+declare interface AlphaTexStringLiteral extends AlphaTexTextNode, IAlphaTexValueListItem, IAlphaTexNoteValueNode {
+    nodeType: AlphaTexNodeType.String;
+}
+
+/**
+ * A base interface for nodes holding a textual value
+ * like string literals or identifiers.
+ * @record
+ * @public
+ */
+declare interface AlphaTexTextNode extends AlphaTexAstNode {
+    /**
+     * The text contained in the node.
+     */
+    text: string;
+}
+
+/**
+ * A node describing a single token like dots or colons.
+ * @record
+ * @public
+ */
+declare interface AlphaTexTokenNode extends AlphaTexAstNode {
+}
+
+/**
+ * A node holding multiple values optionally grouped by parenthesis.
+ * Whether parenthesis are needed depends on the context.
+ * Used in contexts like bend effects `3.3{b (0 4)}`.
+ * @record
+ * @public
+ */
+declare interface AlphaTexValueList extends AlphaTexAstNode {
+    nodeType: AlphaTexNodeType.Values;
+    /**
+     * The open parenthesis token grouping the values.
+     */
+    openParenthesis?: AlphaTexParenthesisOpenTokenNode;
+    /**
+     * The list of values.
+     */
+    values: IAlphaTexValueListItem[];
+    /**
+     * The close parenthesis token grouping the values.
+     */
+    closeParenthesis?: AlphaTexParenthesisCloseTokenNode;
+
 }
 
 /**
@@ -7425,6 +8261,7 @@ declare class HeaderFooterStyle {
      */
     textAlign: TextAlign;
     constructor(template?: string, isVisible?: boolean | undefined, textAlign?: TextAlign);
+    static equals(a: HeaderFooterStyle, b: HeaderFooterStyle): boolean;
     buildText(score: Score): string;
     private static readonly _placeholderPattern;
 }
@@ -7662,6 +8499,83 @@ declare interface IAlphaSynthAudioExporter {
     render(milliseconds: number): AudioExportChunk | undefined;
 }
 
+/**
+ * The base type for all alphaTex AST nodes
+ * @public
+ */
+declare interface IAlphaTexAstNode {
+    /**
+     * The type of the node.
+     */
+    nodeType: AlphaTexNodeType;
+    /**
+     * The start of this node when parsed from an input source file.
+     */
+    start?: AlphaTexAstNodeLocation;
+    /**
+     * The end (inclusive) of this node when parsed from an input source file.
+     */
+    end?: AlphaTexAstNodeLocation;
+    /**
+     * The comments preceeding this node.
+     */
+    leadingComments?: AlphaTexComment[];
+    /**
+     * The comments after this node (if starting on the same line).
+     */
+    trailingComments?: AlphaTexComment[];
+}
+
+/**
+ * @public
+ */
+declare interface IAlphaTexImporter {
+    readonly state: IAlphaTexImporterState;
+    applyStaffNoteKind(staff: Staff, staffNoteKind: StaffNoteKind): void;
+    startNewVoice(): void;
+    startNewTrack(): Track;
+    startNewStaff(): Staff;
+    addSemanticDiagnostic(diagnostic: AlphaTexDiagnostic): void;
+}
+
+/**
+ * @public
+ */
+declare interface IAlphaTexImporterState {
+    score: Score;
+    accidentalMode: AlphaTexAccidentalMode;
+    currentDynamics: DynamicValue;
+    currentTupletNumerator: number;
+    currentTupletDenominator: number;
+    readonly syncPoints: FlatSyncPoint[];
+    readonly slurs: Map<string, Note>;
+    readonly percussionArticulationNames: Map<string, number>;
+    readonly lyrics: Map<number, Lyrics[]>;
+    readonly staffHasExplicitDisplayTransposition: Set<Staff>;
+    readonly staffHasExplicitTuning: Set<Staff>;
+    readonly staffTuningApplied: Set<Staff>;
+    readonly sustainPedalToBeat: Map<SustainPedalMarker, Beat>;
+}
+
+/**
+ * @public
+ */
+declare interface IAlphaTexMetaDataTagPrefixNode extends IAlphaTexAstNode {
+}
+
+/**
+ * @public
+ */
+declare interface IAlphaTexNoteValueNode extends IAlphaTexAstNode {
+}
+
+/**
+ * Defines the possible types for values in a {@link AlphaTexValueList}
+ * @public
+ */
+declare interface IAlphaTexValueListItem extends IAlphaTexAstNode {
+}
+
 /**
  * A {@link IBackingTrackSynthOutput} which uses a HTMLAudioElement as playback mechanism.
  * Allows the access to the element for further custom usage.
@@ -8062,6 +8976,9 @@ declare interface IMouseEventArgs {
 
 export declare namespace importer {
     export {
+        AlphaTexErrorWithDiagnostics,
+        AlphaTexImporter,
+        alphaTex,
         ScoreImporter,
         ScoreLoader,
         UnsupportedFormatError
@@ -13775,6 +14692,16 @@ declare class Staff {
     addBar(bar: Bar): void;
 }
 
+/**
+ * Lists the note kinds we can detect
+ * @public
+ */
+declare enum StaffNoteKind {
+    Pitched = 0,
+    Fretted = 1,
+    Articulation = 2
+}
+
 /**
  * Represents the bounds of a staff system.
  * @public
@@ -14388,6 +15315,7 @@ declare class Tuning {
      * @param isStandard if set to`true`[is standard].
      */
     constructor(name?: string, tuning?: number[] | null, isStandard?: boolean);
+    reset(): void;
     /**
      * Tries to detect the name and standard flag of the tuning from a known tuning list based
      * on the string values.