@coderline/alphatab 1.7.0-alpha.1511 → 1.7.0-alpha.1517

package/dist/alphaTab.d.ts

@@ -3040,28 +3040,44 @@ declare enum AlphaTabSystemExclusiveEvents {
     Rest = 1
 }
 
+/**
+ * This ScoreExporter can write alphaTex strings.
+ */
+declare class AlphaTexExporter extends ScoreExporter {
+    private static readonly DefaultScore;
+    private static readonly DefaultTrack;
+    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 writeTrackMetaTo;
+    private writePlaybackInfoTo;
+    private writeStaffMetaTo;
+    private writeChordTo;
+    private writeMasterBarMetaTo;
+    private writeBarMetaTo;
+    private writeVoiceTo;
+    private writeBeatTo;
+    private writeBeatEffectsTo;
+    private writeNoteTo;
+    private writeNoteEffectsTo;
+}
+
 /**
  * This importer can parse alphaTex markup into a score structure.
  */
 declare class AlphaTexImporter extends ScoreImporter {
-    private static readonly Eof;
     private _trackChannel;
     private _score;
     private _currentTrack;
     private _currentStaff;
     private _barIndex;
     private _voiceIndex;
-    private _input;
-    private _ch;
-    private _curChPos;
-    private _line;
-    private _col;
-    private _lastValidSpot;
-    private _sy;
-    private _syData;
-    private _allowNegatives;
-    private _allowFloat;
-    private _allowTuning;
     private _currentDuration;
     private _currentDynamics;
     private _currentTuplet;
@@ -3075,11 +3091,16 @@ declare class AlphaTexImporter extends ScoreImporter {
     private _sustainPedalToBeat;
     private _slurs;
     private _articulationValueToIndex;
+    private _lexer;
     private _accidentalMode;
     private _syncPoints;
     logErrors: boolean;
     get name(): string;
     initFromString(tex: string, settings: Settings): void;
+    private get sy();
+    private get syData();
+    private set sy(value);
+    private newSy;
     readScore(): Score;
     private syncPoints;
     private syncPoint;
@@ -3112,33 +3133,6 @@ declare class AlphaTexImporter extends ScoreImporter {
      */
     private parseKeySignature;
     private parseKeySignatureType;
-    /**
-     * Reads, saves, and returns the next character of the source stream.
-     */
-    private nextChar;
-    /**
-     * Saves the current position, line, and column.
-     * All parsed data until this point is assumed to be valid.
-     */
-    private saveValidSpot;
-    /**
-     * Reads, saves, and returns the next terminal symbol.
-     */
-    private newSy;
-    private readNumberOrName;
-    /**
-     * Checks if the given character is a valid letter for a name.
-     * (no control characters, whitespaces, numbers or dots)
-     */
-    private static isNameLetter;
-    private static isTerminal;
-    private static isWhiteSpace;
-    private isDigit;
-    /**
-     * Reads a string from the stream.
-     * @returns the read string.
-     */
-    private readName;
     private metaData;
     headerFooterStyle(element: ScoreSubElement): void;
     private parseTrackNamePolicy;
@@ -3450,11 +3444,17 @@ declare class Bar {
      * Gets or sets the simile mark on this bar.
      */
     simileMark: SimileMark;
+    private _filledVoices;
     /**
      * Gets a value indicating whether this bar contains multiple voices with notes.
      * @json_ignore
      */
-    isMultiVoice: boolean;
+    get isMultiVoice(): boolean;
+    /**
+     * Gets the number of voices which have content within this stuff.
+     * @json_ignore
+     */
+    get filledVoices(): Set<number>;
     /**
      * A relative scale for the size of the bar when displayed. The scale is relative
      * within a single line (system). The sum of all scales in one line make the total width,
@@ -4106,7 +4106,7 @@ declare class Beat {
      */
     isLetRing: boolean;
     /**
-     * Gets or sets whether any note in this beat has a palm-mute paplied.
+     * Gets or sets whether any note in this beat has a palm-mute applied.
      * @json_ignore
      */
     isPalmMute: boolean;
@@ -7482,15 +7482,64 @@ export declare class Environment {
      */
     private static printPlatformInfo;
     /* Excluded from this release type: prepareForPostMessage */
+    /* Excluded from this release type: quoteJsonString */
 }
 
 export declare namespace exporter {
     export {
-        ScoreExporter,
-        Gp7Exporter
+        AlphaTexExporter,
+        Gp7Exporter,
+        ScoreExporter
     }
 }
 
+/**
+ * All settings related to exporters that encode file formats.
+ * @json
+ * @json_declaration
+ */
+export declare class ExporterSettings {
+    /**
+     * How many characters should be indented on formatted outputs. If set to negative values
+     * formatted outputs are disabled.
+     * @since 1.7.0
+     * @defaultValue `2`
+     * @category Exporter
+     */
+    indent: number;
+    /**
+     * Whether to write extended comments into the exported file (e.g. to in alphaTex to mark where certain metadata or bars starts)
+     * @since 1.7.0
+     * @defaultValue `false`
+     * @category Exporter
+     */
+    comments: boolean;
+}
+
+/**
+ * All settings related to exporters that encode file formats.
+ * @json
+ * @json_declaration
+ * @target web
+ */
+declare interface ExporterSettingsJson {
+    /**
+     * How many characters should be indented on formatted outputs. If set to negative values
+     * formatted outputs are disabled.
+     * @since 1.7.0
+     * @defaultValue `2`
+     * @category Exporter
+     */
+    indent?: number;
+    /**
+     * Whether to write extended comments into the exported file (e.g. to in alphaTex to mark where certain metadata or bars starts)
+     * @since 1.7.0
+     * @defaultValue `false`
+     * @category Exporter
+     */
+    comments?: boolean;
+}
+
 /**
  * Lists the different fade types.
  */
@@ -9073,6 +9122,9 @@ declare class IOHelper {
     static writeInt16LE(o: IWriteable, v: number): void;
     static writeInt16BE(o: IWriteable, v: number): void;
     static writeFloat32BE(o: IWriteable, v: number): void;
+    static iterateCodepoints(input: string): Generator<number, void, unknown>;
+    static isLeadingSurrogate(charCode: number): boolean;
+    static isTrailingSurrogate(charCode: number): boolean;
 }
 
 /**
@@ -9545,6 +9597,7 @@ export declare namespace json {
         DisplaySettingsJson,
         EngravingStemInfoJson,
         EngravingSettingsJson,
+        ExporterSettingsJson,
         ImporterSettingsJson,
         NotationSettingsJson,
         VibratoPlaybackSettingsJson,
@@ -10867,6 +10920,7 @@ export declare namespace model {
         GolpeType,
         HarmonicType,
         InstrumentArticulation,
+        TechniqueSymbolPlacement,
         JsonConverter,
         KeySignature,
         KeySignatureType,
@@ -14417,6 +14471,11 @@ export declare class Settings {
      * @json_partial_names
      */
     readonly player: PlayerSettings;
+    /**
+     * All settings related to exporter that export file formats.
+     * @json_partial_names
+     */
+    readonly exporter: ExporterSettings;
     setSongBookModeSettings(): void;
     static get songBook(): Settings;
     /**
@@ -14461,6 +14520,11 @@ declare interface SettingsJson {
      * @json_partial_names
      */
     player?: PlayerSettingsJson;
+    /**
+     * All settings related to exporter that export file formats.
+     * @json_partial_names
+     */
+    exporter?: ExporterSettingsJson;
 }
 
 /**
@@ -14780,6 +14844,12 @@ declare class Staff {
      * For some percussion instruments this number might vary.
      */
     standardNotationLineCount: number;
+    private _filledVoices;
+    /**
+     * The indexes of the non-empty voices in this staff..
+     * @json_ignore
+     */
+    get filledVoices(): Set<number>;
     finish(settings: Settings, sharedDataBag?: Map<string, unknown> | null): void;
     addChord(chordId: string, chord: Chord): void;
     hasChord(chordId: string): boolean;
@@ -15482,8 +15552,7 @@ declare class Tuning {
     private static _fiveStrings;
     private static _fourStrings;
     private static _defaultTunings;
-    static readonly defaultAccidentals: string[];
-    static readonly defaultSteps: string[];
+    static readonly noteNames: string[];
     static getTextForTuning(tuning: number, includeOctave: boolean): string;
     static getTextPartsForTuning(tuning: number, octaveShift?: number): string[];
     /**