@coderline/alphatab 1.7.0-alpha.1568 → 1.7.0-alpha.1574

package/dist/alphaTab.core.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab v1.7.0-alpha.1568 (develop, build 1568)
+ * alphaTab v1.7.0-alpha.1574 (develop, build 1574)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -197,9 +197,9 @@ class VersionInfo {
         print(`build date: ${VersionInfo.date}`);
     }
 }
-VersionInfo.version = '1.7.0-alpha.1568';
-VersionInfo.date = '2025-10-07T01:57:28.773Z';
-VersionInfo.commit = '74a7b1503601f5a61437e95ba242fc411e55052a';
+VersionInfo.version = '1.7.0-alpha.1574';
+VersionInfo.date = '2025-10-13T02:06:10.997Z';
+VersionInfo.commit = '870f57e8775bddacc5a91b00ccb39c598babb881';
 
 /**
  * This public class provides names for all general midi instruments.
@@ -1481,8 +1481,13 @@ class Automation {
          * Gets or sets the additional text of the automation.
          */
         this.text = '';
+        /**
+         * Whether this automation should be visible. (not all automation types are shown,
+         * e.g. tempo changes shown in the score while volume changes are not).
+         */
+        this.isVisible = true;
     }
-    static buildTempoAutomation(isLinear, ratioPosition, value, reference) {
+    static buildTempoAutomation(isLinear, ratioPosition, value, reference, isVisible = true) {
         if (reference < 1 || reference > 5) {
             reference = 2;
         }
@@ -1492,6 +1497,7 @@ class Automation {
         automation.isLinear = isLinear;
         automation.ratioPosition = ratioPosition;
         automation.value = value * references[reference];
+        automation.isVisible = isVisible;
         return automation;
     }
     static buildInstrumentAutomation(isLinear, ratioPosition, value) {
@@ -3898,6 +3904,19 @@ class ModelUtils {
                 }
             }
         }
+        // ensure first masterbar has a tempo automation for score tempo
+        if (score.masterBars.length > 0) {
+            const firstTempoAutomation = score.masterBars[0].tempoAutomations.find(a => a.type === AutomationType.Tempo && a.ratioPosition === 0);
+            if (!firstTempoAutomation) {
+                const tempoAutomation = new Automation();
+                tempoAutomation.isLinear = false;
+                tempoAutomation.type = AutomationType.Tempo;
+                tempoAutomation.value = score.tempo;
+                tempoAutomation.text = score.tempoLabel;
+                tempoAutomation.isVisible = false;
+                score.masterBars[0].tempoAutomations.push(tempoAutomation);
+            }
+        }
     }
     /**
      * Trims any empty bars at the end of the song.
@@ -6228,6 +6247,7 @@ class AutomationCloner {
         clone.syncPointValue = original.syncPointValue ? SyncPointDataCloner.clone(original.syncPointValue) : undefined;
         clone.ratioPosition = original.ratioPosition;
         clone.text = original.text;
+        clone.isVisible = original.isVisible;
         return clone;
     }
 }
@@ -7628,14 +7648,6 @@ class Score {
          * The author of this tablature.
          */
         this.tab = '';
-        /**
-         * Gets or sets the global tempo of the song in BPM. The tempo might change via {@link MasterBar.tempoAutomations}.
-         */
-        this.tempo = 120;
-        /**
-         * Gets or sets the name/label of the tempo.
-         */
-        this.tempoLabel = '';
         /**
          * Gets or sets a list of all masterbars contained in this song.
          * @json_add addMasterBar
@@ -7670,6 +7682,22 @@ class Score {
         Voice$1.resetIds();
         Note.resetIds();
     }
+    /**
+     * The initial tempo of the song in BPM. The tempo might change via {@link MasterBar.tempoAutomations}.
+     */
+    get tempo() {
+        return this.masterBars.length && this.masterBars[0].tempoAutomations.length > 0
+            ? this.masterBars[0].tempoAutomations[0].value
+            : 120;
+    }
+    /**
+     * The name/label of the initial tempo.
+     */
+    get tempoLabel() {
+        return this.masterBars.length && this.masterBars[0].tempoAutomations.length > 0
+            ? this.masterBars[0].tempoAutomations[0].text
+            : '';
+    }
     rebuildRepeatGroups() {
         this._currentRepeatGroup = null;
         this._openedRepeatGroups = [];
@@ -9515,6 +9543,7 @@ class AlphaTexImporter extends ScoreImporter {
         this._trackChannel = 0;
         this._barIndex = 0;
         this._voiceIndex = 0;
+        this._initialTempo = Automation.buildTempoAutomation(false, 0, 120, 0);
         // Last known position that had valid syntax/symbols
         this._currentDuration = Duration.QuadrupleWhole;
         this._currentDynamics = DynamicValue.PPP;
@@ -9682,8 +9711,6 @@ class AlphaTexImporter extends ScoreImporter {
      */
     createDefaultScore() {
         this._score = new Score();
-        this._score.tempo = 120;
-        this._score.tempoLabel = '';
         this.newTrack();
     }
     newTrack() {
@@ -9971,14 +9998,14 @@ class AlphaTexImporter extends ScoreImporter {
                 case 'tempo':
                     this.sy = this.newSy(true);
                     if (this.sy === AlphaTexSymbols.Number) {
-                        this._score.tempo = this.syData;
+                        this._initialTempo.value = this.syData;
                     }
                     else {
                         this.error('tempo', AlphaTexSymbols.Number, true);
                     }
                     this.sy = this.newSy();
                     if (this.sy === AlphaTexSymbols.String) {
-                        this._score.tempoLabel = this.syData;
+                        this._initialTempo.text = this.syData;
                         this.sy = this.newSy();
                     }
                     anyTopLevelMeta = true;
@@ -10740,6 +10767,9 @@ class AlphaTexImporter extends ScoreImporter {
                 master.timeSignatureNumerator = master.previousMasterBar.timeSignatureNumerator;
                 master.tripletFeel = master.previousMasterBar.tripletFeel;
             }
+            else {
+                master.tempoAutomations.push(this._initialTempo);
+            }
         }
         const anyBarMeta = this.barMeta(bar);
         // detect tuning for staff
@@ -11233,6 +11263,15 @@ class AlphaTexImporter extends ScoreImporter {
         else if (syData === 'tempo') {
             // NOTE: playbackRatio is calculated on score finish when playback positions are known
             const tempoAutomation = this.readTempoAutomation(false);
+            if (beat.index === 0) {
+                const existing = beat.voice.bar.masterBar.tempoAutomations.find(a => a.ratioPosition === 0);
+                if (existing) {
+                    existing.value = tempoAutomation.value;
+                    existing.text = tempoAutomation.text;
+                    beat.automations.push(existing);
+                    return true;
+                }
+            }
             beat.automations.push(tempoAutomation);
             beat.voice.bar.masterBar.tempoAutomations.push(tempoAutomation);
             return true;
@@ -12223,7 +12262,15 @@ class AlphaTexImporter extends ScoreImporter {
             }
             else if (syData === 'tempo') {
                 const tempoAutomation = this.readTempoAutomation(true);
-                master.tempoAutomations.push(tempoAutomation);
+                const existing = master.tempoAutomations.find(a => a.ratioPosition === tempoAutomation.ratioPosition);
+                if (existing) {
+                    existing.value = tempoAutomation.value;
+                    existing.text = tempoAutomation.text;
+                    existing.isVisible = tempoAutomation.isVisible;
+                }
+                else {
+                    master.tempoAutomations.push(tempoAutomation);
+                }
             }
             else if (syData === 'section') {
                 this.sy = this.newSy();
@@ -12511,7 +12558,7 @@ class AlphaTexImporter extends ScoreImporter {
         const tempoAutomation = new Automation();
         tempoAutomation.isLinear = false;
         tempoAutomation.type = AutomationType.Tempo;
-        if (this.sy === AlphaTexSymbols.LBrace && withPosition) {
+        if (this.sy === AlphaTexSymbols.LParensis && withPosition) {
             this.sy = this.newSy(true);
             if (this.sy !== AlphaTexSymbols.Number) {
                 this.error('tempo', AlphaTexSymbols.Number, true);
@@ -12527,8 +12574,12 @@ class AlphaTexImporter extends ScoreImporter {
             }
             tempoAutomation.ratioPosition = this.syData;
             this.sy = this.newSy();
-            if (this.sy !== AlphaTexSymbols.RBrace) {
-                this.error('tempo', AlphaTexSymbols.RBrace, true);
+            if (this.sy === AlphaTexSymbols.String && this.syData === 'hide') {
+                tempoAutomation.isVisible = false;
+                this.sy = this.newSy();
+            }
+            if (this.sy !== AlphaTexSymbols.RParensis) {
+                this.error('tempo', AlphaTexSymbols.RParensis, true);
             }
             this.sy = this.newSy();
         }
@@ -14003,6 +14054,7 @@ class CapellaParser {
         this._trackChannel = 0;
         this._beamingMode = BeatBeamingMode.Auto;
         this._isFirstSystem = true;
+        this._initialTempo = -1;
         this._staffLookup = new Map();
         this._brackets = [];
         this._staffLayoutLookup = new Map();
@@ -14065,7 +14117,6 @@ class CapellaParser {
         }
         if (root.localName === 'score') {
             this.score = new Score();
-            this.score.tempo = 120;
             // parse all children
             for (const n of root.childElements()) {
                 switch (n.localName) {
@@ -14239,7 +14290,7 @@ class CapellaParser {
     parseSystem(element) {
         if (element.attributes.has('tempo')) {
             if (this.score.masterBars.length === 0) {
-                this.score.tempo = Number.parseInt(element.attributes.get('tempo'), 10);
+                this._initialTempo = Number.parseInt(element.attributes.get('tempo'), 10);
             }
         }
         if (element.getAttribute('beamGrouping') === '0') {
@@ -14346,6 +14397,9 @@ class CapellaParser {
             if (master.index > 0) {
                 master.tripletFeel = master.previousMasterBar.tripletFeel;
             }
+            else if (this._initialTempo > 0) {
+                master.tempoAutomations.push(Automation.buildTempoAutomation(false, 0, this._initialTempo, 0));
+            }
             master.timeSignatureDenominator = this._timeSignature.timeSignatureDenominator;
             master.timeSignatureNumerator = this._timeSignature.timeSignatureNumerator;
             master.timeSignatureCommon = this._timeSignature.timeSignatureCommon;
@@ -15121,12 +15175,13 @@ class Gp3To5Importer extends ScoreImporter {
             this.data.skip(19);
         }
         // page setup since GP5
+        this._initialTempo = Automation.buildTempoAutomation(false, 0, 0, 0);
         if (this._versionNumber >= 500) {
             this.readPageSetup();
-            this._score.tempoLabel = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding);
+            this._initialTempo.text = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding);
         }
         // tempo stuff
-        this._score.tempo = IOHelper.readInt32LE(this.data);
+        this._initialTempo.value = IOHelper.readInt32LE(this.data);
         if (this._versionNumber >= 510) {
             GpBinaryHelpers.gpReadBool(this.data); // hide tempo?
         }
@@ -15205,7 +15260,8 @@ class Gp3To5Importer extends ScoreImporter {
         }
         version = version.substr(Gp3To5Importer.VersionString.length + 1);
         const dot = version.indexOf(String.fromCharCode(46));
-        this._versionNumber = 100 * Number.parseInt(version.substr(0, dot), 10) + Number.parseInt(version.substr(dot + 1), 10);
+        this._versionNumber =
+            100 * Number.parseInt(version.substr(0, dot), 10) + Number.parseInt(version.substr(dot + 1), 10);
         Logger.debug(this.name, `Guitar Pro version ${version} detected`);
     }
     readScoreInformation() {
@@ -15315,6 +15371,9 @@ class Gp3To5Importer extends ScoreImporter {
             previousMasterBar = this._score.masterBars[this._score.masterBars.length - 1];
         }
         const newMasterBar = new MasterBar();
+        if (!previousMasterBar && this._initialTempo.value > 0) {
+            newMasterBar.tempoAutomations.push(this._initialTempo);
+        }
         const flags = this.data.readByte();
         // time signature
         if ((flags & 0x01) !== 0) {
@@ -17327,6 +17386,7 @@ class GpifParser {
         let reference = 0;
         let text = null;
         let syncPointValue = undefined;
+        let isVisible = true;
         for (const c of node.childElements()) {
             switch (c.localName) {
                 case 'Type':
@@ -17381,6 +17441,9 @@ class GpifParser {
                 case 'Text':
                     text = c.innerText;
                     break;
+                case 'Visible':
+                    isVisible = c.innerText.toLowerCase() === 'true';
+                    break;
             }
         }
         if (!type) {
@@ -17389,7 +17452,7 @@ class GpifParser {
         const newAutomations = [];
         switch (type) {
             case 'Tempo':
-                newAutomations.push(Automation.buildTempoAutomation(isLinear, ratioPosition, numberValue, reference));
+                newAutomations.push(Automation.buildTempoAutomation(isLinear, ratioPosition, numberValue, reference, isVisible));
                 break;
             case 'SyncPoint':
                 const syncPoint = new Automation();
@@ -17397,6 +17460,7 @@ class GpifParser {
                 syncPoint.isLinear = isLinear;
                 syncPoint.ratioPosition = ratioPosition;
                 syncPoint.syncPointValue = syncPointValue;
+                syncPoint.isVisible = isVisible;
                 newAutomations.push(syncPoint);
                 break;
             case 'Sound':
@@ -17405,6 +17469,7 @@ class GpifParser {
                     bankChange.type = AutomationType.Bank;
                     bankChange.ratioPosition = ratioPosition;
                     bankChange.value = sounds.get(textValue).bank;
+                    bankChange.isVisible = isVisible;
                     newAutomations.push(bankChange);
                     const programChange = Automation.buildInstrumentAutomation(isLinear, ratioPosition, sounds.get(textValue).program);
                     newAutomations.push(programChange);
@@ -19545,12 +19610,6 @@ class GpifParser {
                 const automation = automations[i];
                 switch (automation.type) {
                     case AutomationType.Tempo:
-                        if (barNumber === 0) {
-                            this.score.tempo = automation.value | 0;
-                            if (automation.text) {
-                                this.score.tempoLabel = automation.text;
-                            }
-                        }
                         masterBar.tempoAutomations.push(automation);
                         break;
                     case AutomationType.SyncPoint:
@@ -20654,7 +20713,6 @@ class MusicXmlImporter extends ScoreImporter {
             throw new UnsupportedFormatError('Unsupported format', e);
         }
         this._score = new Score();
-        this._score.tempo = 120;
         this._score.stylesheet.hideDynamics = true;
         this.parseDom(dom);
         ModelUtils.consolidate(this._score);
@@ -22296,9 +22354,6 @@ class MusicXmlImporter extends ScoreImporter {
             tempoAutomation.ratioPosition = getRatioPosition();
             if (!this.hasSameTempo(masterBar, tempoAutomation)) {
                 masterBar.tempoAutomations.push(tempoAutomation);
-                if (masterBar.index === 0) {
-                    masterBar.score.tempo = tempoAutomation.value;
-                }
             }
         }
         let previousWords = '';
@@ -22444,9 +22499,6 @@ class MusicXmlImporter extends ScoreImporter {
             tempoAutomation.ratioPosition = ratioPosition;
             if (!this.hasSameTempo(masterBar, tempoAutomation)) {
                 masterBar.tempoAutomations.push(tempoAutomation);
-                if (masterBar.index === 0) {
-                    masterBar.score.tempo = tempoAutomation.value;
-                }
             }
         }
     }
@@ -36912,6 +36964,7 @@ class AutomationSerializer {
         }
         o.set("ratioposition", obj.ratioPosition);
         o.set("text", obj.text);
+        o.set("isvisible", obj.isVisible);
         return o;
     }
     static setProperty(obj, property, v) {
@@ -36940,6 +36993,9 @@ class AutomationSerializer {
             case "text":
                 obj.text = v;
                 return true;
+            case "isvisible":
+                obj.isVisible = v;
+                return true;
         }
         return false;
     }
@@ -38496,8 +38552,6 @@ class ScoreSerializer {
         o.set("title", obj.title);
         o.set("words", obj.words);
         o.set("tab", obj.tab);
-        o.set("tempo", obj.tempo);
-        o.set("tempolabel", obj.tempoLabel);
         o.set("masterbars", obj.masterBars.map(i => MasterBarSerializer.toJson(i)));
         o.set("tracks", obj.tracks.map(i => TrackSerializer.toJson(i)));
         o.set("defaultsystemslayout", obj.defaultSystemsLayout);
@@ -38543,12 +38597,6 @@ class ScoreSerializer {
             case "tab":
                 obj.tab = v;
                 return true;
-            case "tempo":
-                obj.tempo = v;
-                return true;
-            case "tempolabel":
-                obj.tempoLabel = v;
-                return true;
             case "masterbars":
                 obj.masterBars = [];
                 for (const o of v) {
@@ -56839,10 +56887,10 @@ class TempoEffectInfo extends EffectBarRendererInfo {
         return (beat.voice.bar.staff.index === 0 &&
             beat.voice.index === 0 &&
             beat.index === 0 &&
-            beat.voice.bar.masterBar.tempoAutomations.length > 0);
+            beat.voice.bar.masterBar.tempoAutomations.some(t => t.isVisible));
     }
     createNewGlyph(_renderer, beat) {
-        return new BarTempoGlyph(beat.voice.bar.masterBar.tempoAutomations);
+        return new BarTempoGlyph(beat.voice.bar.masterBar.tempoAutomations.filter(a => a.isVisible));
     }
     canExpand(_from, _to) {
         return true;
@@ -66960,11 +67008,15 @@ class AlphaTexExporter extends ScoreExporter {
             }
         }
         for (const a of masterBar.tempoAutomations) {
-            writer.write(`\\tempo { ${a.value} `);
+            writer.write(`\\tempo ( ${a.value} `);
             if (a.text) {
                 writer.writeString(a.text);
             }
-            writer.writeLine(`${a.ratioPosition} }`);
+            writer.write(`${a.ratioPosition} `);
+            if (!a.isVisible) {
+                writer.writeLine('hide ');
+            }
+            writer.writeLine(`)`);
         }
         writer.dropSingleLineComment();
     }
@@ -68381,7 +68433,7 @@ class GpifWriter {
                 tempoAutomation.addElement('Linear').innerText = automation.isLinear ? 'true' : 'false';
                 tempoAutomation.addElement('Bar').innerText = mb.index.toString();
                 tempoAutomation.addElement('Position').innerText = automation.ratioPosition.toString();
-                tempoAutomation.addElement('Visible').innerText = 'true';
+                tempoAutomation.addElement('Visible').innerText = automation.isVisible ? 'true' : 'false';
                 tempoAutomation.addElement('Value').innerText = `${automation.value} 2`;
                 if (automation.text) {
                     tempoAutomation.addElement('Text').innerText = automation.text;

package/dist/alphaTab.d.ts

@@ -3110,6 +3110,7 @@ declare class AlphaTexImporter extends ScoreImporter {
     private _currentStaff;
     private _barIndex;
     private _voiceIndex;
+    private _initialTempo;
     private _currentDuration;
     private _currentDynamics;
     private _currentTuplet;
@@ -3337,7 +3338,12 @@ declare class Automation {
      * Gets or sets the additional text of the automation.
      */
     text: string;
-    static buildTempoAutomation(isLinear: boolean, ratioPosition: number, value: number, reference: number): Automation;
+    /**
+     * Whether this automation should be visible. (not all automation types are shown,
+     * e.g. tempo changes shown in the score while volume changes are not).
+     */
+    isVisible: boolean;
+    static buildTempoAutomation(isLinear: boolean, ratioPosition: number, value: number, reference: number, isVisible?: boolean): Automation;
     static buildInstrumentAutomation(isLinear: boolean, ratioPosition: number, value: number): Automation;
 }
 
@@ -14163,13 +14169,13 @@ declare class Score {
      */
     tab: string;
     /**
-     * Gets or sets the global tempo of the song in BPM. The tempo might change via {@link MasterBar.tempoAutomations}.
+     * The initial tempo of the song in BPM. The tempo might change via {@link MasterBar.tempoAutomations}.
      */
-    tempo: number;
+    get tempo(): number;
     /**
-     * Gets or sets the name/label of the tempo.
+     * The name/label of the initial tempo.
      */
-    tempoLabel: string;
+    get tempoLabel(): string;
     /**
      * Gets or sets a list of all masterbars contained in this song.
      * @json_add addMasterBar