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

package/dist/alphaTab.js

@@ -1,5 +1,5 @@
 /*!
- * alphaTab v1.7.0-alpha.1561 (develop, build 1561)
+ * alphaTab v1.7.0-alpha.1574 (develop, build 1574)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -203,9 +203,9 @@
             print(`build date: ${VersionInfo.date}`);
         }
     }
-    VersionInfo.version = '1.7.0-alpha.1561';
-    VersionInfo.date = '2025-09-30T01:56:18.398Z';
-    VersionInfo.commit = '2d28283a958cd94f17df3c91ae34c8bdb4849d71';
+    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.
@@ -1487,8 +1487,13 @@
              * 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;
             }
@@ -1498,6 +1503,7 @@
             automation.isLinear = isLinear;
             automation.ratioPosition = ratioPosition;
             automation.value = value * references[reference];
+            automation.isVisible = isVisible;
             return automation;
         }
         static buildInstrumentAutomation(isLinear, ratioPosition, value) {
@@ -3904,6 +3910,19 @@
                     }
                 }
             }
+            // 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.
@@ -6234,6 +6253,7 @@
             clone.syncPointValue = original.syncPointValue ? SyncPointDataCloner.clone(original.syncPointValue) : undefined;
             clone.ratioPosition = original.ratioPosition;
             clone.text = original.text;
+            clone.isVisible = original.isVisible;
             return clone;
         }
     }
@@ -7634,14 +7654,6 @@
              * 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
@@ -7676,6 +7688,22 @@
             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 = [];
@@ -9521,6 +9549,7 @@
             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;
@@ -9688,8 +9717,6 @@
          */
         createDefaultScore() {
             this._score = new Score();
-            this._score.tempo = 120;
-            this._score.tempoLabel = '';
             this.newTrack();
         }
         newTrack() {
@@ -9977,14 +10004,14 @@
                     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;
@@ -10746,6 +10773,9 @@
                     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
@@ -11239,6 +11269,15 @@
             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;
@@ -12229,7 +12268,15 @@
                 }
                 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();
@@ -12517,7 +12564,7 @@
             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);
@@ -12533,8 +12580,12 @@
                 }
                 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();
             }
@@ -14009,6 +14060,7 @@
             this._trackChannel = 0;
             this._beamingMode = BeatBeamingMode.Auto;
             this._isFirstSystem = true;
+            this._initialTempo = -1;
             this._staffLookup = new Map();
             this._brackets = [];
             this._staffLayoutLookup = new Map();
@@ -14071,7 +14123,6 @@
             }
             if (root.localName === 'score') {
                 this.score = new Score();
-                this.score.tempo = 120;
                 // parse all children
                 for (const n of root.childElements()) {
                     switch (n.localName) {
@@ -14245,7 +14296,7 @@
         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') {
@@ -14352,6 +14403,9 @@
                 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;
@@ -15127,12 +15181,13 @@
                 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?
             }
@@ -15211,7 +15266,8 @@
             }
             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() {
@@ -15321,6 +15377,9 @@
                 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) {
@@ -17333,6 +17392,7 @@
             let reference = 0;
             let text = null;
             let syncPointValue = undefined;
+            let isVisible = true;
             for (const c of node.childElements()) {
                 switch (c.localName) {
                     case 'Type':
@@ -17387,6 +17447,9 @@
                     case 'Text':
                         text = c.innerText;
                         break;
+                    case 'Visible':
+                        isVisible = c.innerText.toLowerCase() === 'true';
+                        break;
                 }
             }
             if (!type) {
@@ -17395,7 +17458,7 @@
             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();
@@ -17403,6 +17466,7 @@
                     syncPoint.isLinear = isLinear;
                     syncPoint.ratioPosition = ratioPosition;
                     syncPoint.syncPointValue = syncPointValue;
+                    syncPoint.isVisible = isVisible;
                     newAutomations.push(syncPoint);
                     break;
                 case 'Sound':
@@ -17411,6 +17475,7 @@
                         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);
@@ -19551,12 +19616,6 @@
                     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:
@@ -20660,7 +20719,6 @@
                 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);
@@ -22302,9 +22360,6 @@
                 tempoAutomation.ratioPosition = getRatioPosition();
                 if (!this.hasSameTempo(masterBar, tempoAutomation)) {
                     masterBar.tempoAutomations.push(tempoAutomation);
-                    if (masterBar.index === 0) {
-                        masterBar.score.tempo = tempoAutomation.value;
-                    }
                 }
             }
             let previousWords = '';
@@ -22450,9 +22505,6 @@
                 tempoAutomation.ratioPosition = ratioPosition;
                 if (!this.hasSameTempo(masterBar, tempoAutomation)) {
                     masterBar.tempoAutomations.push(tempoAutomation);
-                    if (masterBar.index === 0) {
-                        masterBar.score.tempo = tempoAutomation.value;
-                    }
                 }
             }
         }
@@ -36918,6 +36970,7 @@
             }
             o.set("ratioposition", obj.ratioPosition);
             o.set("text", obj.text);
+            o.set("isvisible", obj.isVisible);
             return o;
         }
         static setProperty(obj, property, v) {
@@ -36946,6 +36999,9 @@
                 case "text":
                     obj.text = v;
                     return true;
+                case "isvisible":
+                    obj.isVisible = v;
+                    return true;
             }
             return false;
         }
@@ -38502,8 +38558,6 @@
             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);
@@ -38549,12 +38603,6 @@
                 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) {
@@ -56845,10 +56893,10 @@
             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;
@@ -66966,11 +67014,15 @@
                 }
             }
             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();
         }
@@ -68387,7 +68439,7 @@
                     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;