@coderline/alphatab 1.6.0-alpha.1430 → 1.6.0-alpha.1435

package/dist/alphaTab.js

@@ -1,5 +1,5 @@
 /*!
- * alphaTab v1.6.0-alpha.1430 (develop, build 1430)
+ * alphaTab v1.6.0-alpha.1435 (develop, build 1435)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -1012,6 +1012,26 @@
         get isEmpty() {
             return this._isEmpty;
         }
+        /**
+         * Whether this bar has any changes applied which are not related to the voices in it.
+         * (e.g. new key signatures)
+         */
+        get hasChanges() {
+            if (this.index === 0) {
+                return true;
+            }
+            const hasChangesToPrevious = this.keySignature !== this.previousBar.keySignature ||
+                this.keySignatureType !== this.previousBar.keySignatureType ||
+                this.clef !== this.previousBar.clef ||
+                this.clefOttava !== this.previousBar.clefOttava;
+            if (hasChangesToPrevious) {
+                return true;
+            }
+            return (this.simileMark !== SimileMark.None ||
+                this.sustainPedals.length > 0 ||
+                this.barLineLeft !== BarLineStyle.Automatic ||
+                this.barLineRight !== BarLineStyle.Automatic);
+        }
         /**
          * Whether this bar is empty or has only rests.
          */
@@ -2625,6 +2645,33 @@
              */
             this.directions = null;
         }
+        /**
+         * Whether the masterbar is has any changes applied to it (e.g. tempo changes, time signature changes etc)
+         * The first bar is always considered changed due to initial setup of values. It does not consider
+         * elements like whether the tempo really changes to the previous bar.
+         */
+        get hasChanges() {
+            if (this.index === 0) {
+                return false;
+            }
+            const hasChangesToPrevious = this.timeSignatureCommon !== this.previousMasterBar.timeSignatureCommon ||
+                this.timeSignatureNumerator !== this.previousMasterBar.timeSignatureNumerator ||
+                this.timeSignatureDenominator !== this.previousMasterBar.timeSignatureDenominator ||
+                this.tripletFeel !== this.previousMasterBar.tripletFeel;
+            if (hasChangesToPrevious) {
+                return true;
+            }
+            return (this.alternateEndings !== 0 ||
+                this.isRepeatStart ||
+                this.isRepeatEnd ||
+                this.isFreeTime ||
+                this.isSectionStart ||
+                this.tempoAutomations.length > 0 ||
+                this.syncPoints && this.syncPoints.length > 0 ||
+                (this.fermata !== null && this.fermata.size > 0) ||
+                (this.directions !== null && this.directions.size > 0) ||
+                this.isAnacrusis);
+        }
         /**
          * The key signature used on all bars.
          * @deprecated Use key signatures on bar level
@@ -3566,6 +3613,43 @@
                 }
             }
         }
+        /**
+         * Trims any empty bars at the end of the song.
+         * @param score
+         */
+        static trimEmptyBarsAtEnd(score) {
+            while (score.masterBars.length > 1) {
+                const barIndex = score.masterBars.length - 1;
+                const masterBar = score.masterBars[barIndex];
+                if (masterBar.hasChanges) {
+                    return;
+                }
+                for (const track of score.tracks) {
+                    for (const staff of track.staves) {
+                        if (barIndex < staff.bars.length) {
+                            const bar = staff.bars[barIndex];
+                            if (!bar.isEmpty || bar.hasChanges) {
+                                // found a non-empty bar, stop whole cleanup
+                                return;
+                            }
+                        }
+                    }
+                }
+                // if we reach here, all found bars are empty, remove the bar
+                for (const track of score.tracks) {
+                    for (const staff of track.staves) {
+                        if (barIndex < staff.bars.length) {
+                            const bar = staff.bars[barIndex];
+                            staff.bars.pop();
+                            // unlink
+                            bar.previousBar.nextBar = null;
+                        }
+                    }
+                }
+                score.masterBars.pop();
+                masterBar.previousMasterBar.nextMasterBar = null;
+            }
+        }
     }
     ModelUtils.TuningLetters = new Set([
         0x43 /* C */, 0x44 /* D */, 0x45 /* E */, 0x46 /* F */, 0x47 /* G */, 0x41 /* A */, 0x42 /* B */, 0x63 /* c */,
@@ -8683,6 +8767,7 @@
             this._slurs = new Map();
             this._articulationValueToIndex = new Map();
             this._accidentalMode = AlphaTexAccidentalMode.Explicit;
+            this._syncPoints = [];
             this.logErrors = false;
         }
         get name() {
@@ -8723,10 +8808,16 @@
                     if (!anyMetaRead && !anyBarsRead) {
                         throw new UnsupportedFormatError('No alphaTex data found');
                     }
+                    if (this._sy === AlphaTexSymbols.Dot) {
+                        this._sy = this.newSy();
+                        this.syncPoints();
+                    }
                 }
                 ModelUtils.consolidate(this._score);
                 this._score.finish(this.settings);
+                ModelUtils.trimEmptyBarsAtEnd(this._score);
                 this._score.rebuildRepeatGroups();
+                this._score.applyFlatSyncPoints(this._syncPoints);
                 for (const [track, lyrics] of this._lyrics) {
                     this._score.tracks[track].applyLyrics(lyrics);
                 }
@@ -8743,6 +8834,47 @@
                 throw e;
             }
         }
+        syncPoints() {
+            while (this._sy !== AlphaTexSymbols.Eof) {
+                this.syncPoint();
+            }
+        }
+        syncPoint() {
+            // \sync BarIndex Occurence MillisecondOffset
+            // \sync BarIndex Occurence MillisecondOffset RatioPosition
+            if (this._sy !== AlphaTexSymbols.MetaCommand || this._syData !== 'sync') {
+                this.error('syncPoint', AlphaTexSymbols.MetaCommand, true);
+            }
+            this._sy = this.newSy();
+            if (this._sy !== AlphaTexSymbols.Number) {
+                this.error('syncPointBarIndex', AlphaTexSymbols.Number, true);
+            }
+            const barIndex = this._syData;
+            this._sy = this.newSy();
+            if (this._sy !== AlphaTexSymbols.Number) {
+                this.error('syncPointBarOccurence', AlphaTexSymbols.Number, true);
+            }
+            const barOccurence = this._syData;
+            this._sy = this.newSy();
+            if (this._sy !== AlphaTexSymbols.Number) {
+                this.error('syncPointBarMillis', AlphaTexSymbols.Number, true);
+            }
+            const millisecondOffset = this._syData;
+            this._allowFloat = true;
+            this._sy = this.newSy();
+            this._allowFloat = false;
+            let barPosition = 0;
+            if (this._sy === AlphaTexSymbols.Number) {
+                barPosition = this._syData;
+                this._sy = this.newSy();
+            }
+            this._syncPoints.push({
+                barIndex,
+                barOccurence,
+                barPosition,
+                millisecondOffset
+            });
+        }
         error(nonterm, expected, wrongSymbol = true) {
             let receivedSymbol;
             let showSyData = false;
@@ -33108,7 +33240,7 @@
         addSamples(samples) {
             this._worker.postMessage({
                 cmd: 'alphaSynth.output.addSamples',
-                samples: samples
+                samples: Environment.prepareForPostMessage(samples)
             });
         }
         play() {
@@ -33304,7 +33436,7 @@
         onSoundFontLoadFailed(e) {
             this._main.postMessage({
                 cmd: 'alphaSynth.soundFontLoadFailed',
-                error: this.serializeException(e)
+                error: this.serializeException(Environment.prepareForPostMessage(e))
             });
         }
         serializeException(e) {
@@ -33335,7 +33467,7 @@
         onMidiLoadFailed(e) {
             this._main.postMessage({
                 cmd: 'alphaSynth.midiLoaded',
-                error: this.serializeException(e)
+                error: this.serializeException(Environment.prepareForPostMessage(e))
             });
         }
         onReadyForPlayback() {
@@ -42460,6 +42592,18 @@
      * available importers
      */
     class ScoreLoader {
+        /**
+         * Loads the given alphaTex string.
+         * @param tex The alphaTex string.
+         * @param settings The settings to use for parsing.
+         * @returns The parsed {@see Score}.
+         */
+        static loadAlphaTex(tex, settings) {
+            const parser = new AlphaTexImporter();
+            parser.logErrors = true;
+            parser.initFromString(tex, settings ?? new Settings());
+            return parser.readScore();
+        }
         /**
          * Loads a score asynchronously from the given datasource
          * @param path the source path to load the binary file from
@@ -43310,7 +43454,7 @@
             this._midiEventsPlayedFilter = value;
             this._synth.postMessage({
                 cmd: 'alphaSynth.setMidiEventsPlayedFilter',
-                value: value
+                value: Environment.prepareForPostMessage(value)
             });
         }
         get playbackSpeed() {
@@ -43375,7 +43519,7 @@
             this._playbackRange = value;
             this._synth.postMessage({
                 cmd: 'alphaSynth.setPlaybackRange',
-                value: value
+                value: Environment.prepareForPostMessage(value)
             });
         }
         constructor(player, settings) {
@@ -43469,13 +43613,13 @@
         playOneTimeMidiFile(midi) {
             this._synth.postMessage({
                 cmd: 'alphaSynth.playOneTimeMidiFile',
-                midi: JsonConverter.midiFileToJsObject(midi)
+                midi: JsonConverter.midiFileToJsObject(Environment.prepareForPostMessage(midi))
             });
         }
         loadSoundFont(data, append) {
             this._synth.postMessage({
                 cmd: 'alphaSynth.loadSoundFontBytes',
-                data: data,
+                data: Environment.prepareForPostMessage(data),
                 append: append
             });
         }
@@ -43487,13 +43631,13 @@
         loadMidiFile(midi) {
             this._synth.postMessage({
                 cmd: 'alphaSynth.loadMidi',
-                midi: JsonConverter.midiFileToJsObject(midi)
+                midi: JsonConverter.midiFileToJsObject(Environment.prepareForPostMessage(midi))
             });
         }
         applyTranspositionPitches(transpositionPitches) {
             this._synth.postMessage({
                 cmd: 'alphaSynth.applyTranspositionPitches',
-                transpositionPitches: JSON.stringify(Array.from(transpositionPitches.entries()))
+                transpositionPitches: JSON.stringify(Array.from(Environment.prepareForPostMessage(transpositionPitches).entries()))
             });
         }
         setChannelTranspositionPitch(channel, semitones) {
@@ -43665,7 +43809,7 @@
             });
         }
         serializeSettingsForWorker(settings) {
-            const jsObject = JsonConverter.settingsToJsObject(settings);
+            const jsObject = JsonConverter.settingsToJsObject(Environment.prepareForPostMessage(settings));
             // cut out player settings, they are only needed on UI thread side
             jsObject.delete('player');
             return jsObject;
@@ -43723,11 +43867,11 @@
             }
         }
         renderScore(score, trackIndexes) {
-            const jsObject = score == null ? null : JsonConverter.scoreToJsObject(score);
+            const jsObject = score == null ? null : JsonConverter.scoreToJsObject(Environment.prepareForPostMessage(score));
             this._worker.postMessage({
                 cmd: 'alphaTab.renderScore',
                 score: jsObject,
-                trackIndexes: trackIndexes,
+                trackIndexes: Environment.prepareForPostMessage(trackIndexes),
                 fontSizes: FontSizes.FontSizeLookupTables
             });
         }
@@ -43918,7 +44062,7 @@
         addSamples(f) {
             this._worklet?.port.postMessage({
                 cmd: AlphaSynthWorkerSynthOutput.CmdOutputAddSamples,
-                samples: f
+                samples: Environment.prepareForPostMessage(f)
             });
         }
         resetSamples() {
@@ -61138,9 +61282,9 @@
             print(`build date: ${VersionInfo.date}`);
         }
     }
-    VersionInfo.version = '1.6.0-alpha.1430';
-    VersionInfo.date = '2025-05-29T22:21:21.689Z';
-    VersionInfo.commit = '98a4c2bec8d71f2645008118d3b77fb40973e7fe';
+    VersionInfo.version = '1.6.0-alpha.1435';
+    VersionInfo.date = '2025-06-03T02:15:37.318Z';
+    VersionInfo.commit = 'abb74c7352231d1fc3619761642d7c5a07309917';
 
     /**
      * A factory for custom layout engines.
@@ -61685,6 +61829,29 @@
                 print(`Screen Size: ${window.screen.width}x${window.screen.height}`);
             }
         }
+        /**
+         * Prepares the given object to be sent to workers. Web Frameworks like Vue might
+         * create proxy objects for all objects used. This code handles the necessary unwrapping.
+         * @internal
+         * @target web
+         */
+        static prepareForPostMessage(object) {
+            if (!object) {
+                return object;
+            }
+            // Vue toRaw:
+            // https://github.com/vuejs/core/blob/e7381761cc7971c0d40ae0a0a72687a500fd8db3/packages/reactivity/src/reactive.ts#L378-L381
+            if (typeof object === 'object') {
+                const unwrapped = object.__v_raw;
+                if (unwrapped) {
+                    return Environment.prepareForPostMessage(unwrapped);
+                }
+            }
+            // Solidjs unwrap: the symbol required to access the raw object is unfortunately hidden and we cannot unwrap it without importing
+            // import { unwrap } from "solid-js/store"
+            // alternative for users is to replace this method during runtime. 
+            return object;
+        }
     }
     Environment.StaffIdBeforeSlashAlways = 'before-slash-always';
     Environment.StaffIdBeforeScoreAlways = 'before-score-always';
@@ -61956,6 +62123,7 @@
 
     const _barrel$7 = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
         __proto__: null,
+        AlphaTexImporter,
         ScoreImporter,
         ScoreLoader,
         UnsupportedFormatError