@coderline/alphatab 1.9.0-alpha.1767 → 1.9.0-alpha.1785

package/dist/alphaTab.core.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab v1.9.0-alpha.1767 (develop, build 1767)
+ * alphaTab v1.9.0-alpha.1785 (develop, build 1785)
  *
  * Copyright © 2026, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -203,9 +203,9 @@ class AlphaTabError extends Error {
  * @internal
  */
 class VersionInfo {
-    static version = '1.9.0-alpha.1767';
-    static date = '2026-04-09T03:22:29.010Z';
-    static commit = '6c3194f5f54595c44b979b1fee6cf423b1c9ed15';
+    static version = '1.9.0-alpha.1785';
+    static date = '2026-04-27T03:55:02.662Z';
+    static commit = '760ed909a3d8dc36b159d23b4ff6780e95a3daf1';
     static print(print) {
         print(`alphaTab ${VersionInfo.version}`);
         print(`commit: ${VersionInfo.commit}`);
@@ -3826,7 +3826,6 @@ class Score {
  */
 class SynthConstants {
     static DefaultChannelCount = 16 + 1;
-    static MetronomeChannel = SynthConstants.DefaultChannelCount - 1;
     static MetronomeKey = 33;
     static AudioChannels = 2;
     static MinVolume = 0;
@@ -3850,6 +3849,10 @@ class SynthConstants {
     static DefaultPitchWheel = SynthConstants.MaxPitchWheel / 2;
     static MicroBufferCount = 32;
     static MicroBufferSize = 64;
+    /**
+     * approximately -60 dB, which is inaudible to humans
+     */
+    static AudibleLevelThreshold = 1e-3;
 }
 
 /**
@@ -23814,26 +23817,26 @@ class GpifParser {
                         case 'HarmonicType':
                             const htype = c.findChildElement('HType');
                             if (htype) {
-                                switch (htype.innerText) {
-                                    case 'NoHarmonic':
+                                switch (htype.innerText.toLowerCase()) {
+                                    case 'noharmonic':
                                         note.harmonicType = HarmonicType.None;
                                         break;
-                                    case 'Natural':
+                                    case 'natural':
                                         note.harmonicType = HarmonicType.Natural;
                                         break;
-                                    case 'Artificial':
+                                    case 'artificial':
                                         note.harmonicType = HarmonicType.Artificial;
                                         break;
-                                    case 'Pinch':
+                                    case 'pinch':
                                         note.harmonicType = HarmonicType.Pinch;
                                         break;
-                                    case 'Tap':
+                                    case 'tap':
                                         note.harmonicType = HarmonicType.Tap;
                                         break;
-                                    case 'Semi':
+                                    case 'semi':
                                         note.harmonicType = HarmonicType.Semi;
                                         break;
-                                    case 'Feedback':
+                                    case 'feedback':
                                         note.harmonicType = HarmonicType.Feedback;
                                         break;
                                 }
@@ -32625,9 +32628,16 @@ class DisplaySettings {
      *
      * The page layout does not use `displayWidth`. The use of absolute widths would break the proper alignments needed for this kind of display.
      *
-     * Also note that the sizing is including any glyphs and notation elements within the bar. e.g. if there are clefs in the bar, they are still "squeezed" into the available size.
-     * It is not the case that the actual notes with their lengths are sized accordingly. This fits the sizing system of Guitar Pro and when files are customized there,
-     * alphaTab will match this layout quite close.
+     * In both modes, prefix and postfix glyphs (clef, key signature, time signature, barlines) are treated as fixed overhead: they keep their
+     * natural size and the remaining staff width is distributed across bars by a per-bar weight. This matches the convention used by
+     * Guitar Pro, Dorico, Finale, Sibelius and MuseScore. Bars that carry a system-start prefix or a mid-line clef/key/time-signature change
+     * are therefore visibly wider than plain bars with the same weight. The weight source depends on the mode:
+     *
+     * * `Automatic` (default for `page` layout): weights come from the built-in spacing engine (the natural content width of each bar).
+     *   `displayScale` on the model is ignored.
+     * * `UseModelLayout` (and the `parchment` layout): weights come from `bar.displayScale` / `masterBar.displayScale`. An unset
+     *   `displayScale` defaults to `1` and behaves identically to an explicit `1`, matching Guitar Pro (which omits the value when the
+     *   author hasn't customized it).
      *
      * ### Horizontal Layout
      *
@@ -38826,14 +38836,25 @@ class StaffSystemBounds {
      */
     boundsLookup;
     /**
-     * Finished the lookup for optimized access.
+     * Whether this system's bounds have already been scaled via `finish`. Prevents double-scaling
+     * when the parent `BoundsLookup` is preserved across partial renders and `finish` is invoked
+     * again on a mix of already-scaled (preserved) and newly-registered (natural-coordinate) systems.
+     */
+    isFinished = false;
+    /**
+     * Finished the lookup for optimized access. Idempotent: once finished, further calls are no-ops
+     * so preserved systems survive partial renders without being re-scaled.
      */
     finish(scale = 1) {
+        if (this.isFinished) {
+            return;
+        }
         this.realBounds.scaleWith(scale);
         this.visualBounds.scaleWith(scale);
         for (const t of this.bars) {
             t.finish(scale);
         }
+        this.isFinished = true;
     }
     /**
      * Adds a new master bar to this lookup.
@@ -39006,6 +39027,58 @@ class BoundsLookup {
         }
         this.isFinished = true;
     }
+    /**
+     * Re-opens the lookup for registrations without discarding previously registered bounds.
+     * Used by the renderer when it preserves this lookup across a partial render so that new
+     * bounds for the re-layouted range can be added while preserved systems stay intact.
+     * @internal
+     */
+    resetForPartialUpdate() {
+        this.isFinished = false;
+    }
+    /**
+     * Removes all entries belonging to the given master bar index and any bars after it.
+     * Used before a partial render re-registers bounds for the re-layouted range, so the
+     * preserved lookup ends up with only the unchanged entries when registration begins.
+     *
+     * Assumes the layout aligns its re-layouted range to system boundaries - i.e. the first
+     * system to clear starts exactly at `masterBarIndex`. Caller is responsible for passing
+     * the first master-bar-index of the first re-layouted system.
+     * @internal
+     */
+    clearFromMasterBar(masterBarIndex) {
+        // drop staff systems whose bars start at or after the cleared range.
+        let firstRemovedSystem = -1;
+        for (let i = 0; i < this.staffSystems.length; i++) {
+            const systemBars = this.staffSystems[i].bars;
+            if (systemBars.length > 0 && systemBars[0].index >= masterBarIndex) {
+                firstRemovedSystem = i;
+                break;
+            }
+        }
+        if (firstRemovedSystem !== -1) {
+            this.staffSystems.splice(firstRemovedSystem, this.staffSystems.length - firstRemovedSystem);
+        }
+        // drop master bar entries at or beyond the cleared range.
+        for (const key of Array.from(this._masterBarLookup.keys())) {
+            if (key >= masterBarIndex) {
+                this._masterBarLookup.delete(key);
+            }
+        }
+        // drop beat entries whose beats belong to cleared bars.
+        for (const key of Array.from(this._beatLookup.keys())) {
+            const list = this._beatLookup.get(key);
+            const filtered = list.filter(b => b.beat.voice.bar.index < masterBarIndex);
+            if (filtered.length === 0) {
+                this._beatLookup.delete(key);
+            }
+            else if (filtered.length !== list.length) {
+                this._beatLookup.set(key, filtered);
+            }
+        }
+        // drop the in-progress pointer - the next addStaffSystem call will replace it.
+        this._currentStaffSystem = null;
+    }
     /**
      * Adds a new staff sytem to the lookup.
      * @param bounds The staff system bounds to add.
@@ -39223,8 +39296,11 @@ class AlphaTabWorkerScoreRenderer {
                 this.renderFinished.trigger(data.result);
                 break;
             case 'alphaTab.postRenderFinished':
-                this.boundsLookup = BoundsLookup.fromJson(data.boundsLookup, this._api.score);
-                this.boundsLookup?.finish();
+                const score = this._api.score;
+                if (score && data.boundsLookup) {
+                    this.boundsLookup = BoundsLookup.fromJson(data.boundsLookup, this._api.score);
+                    this.boundsLookup?.finish();
+                }
                 this.postRenderFinished.trigger();
                 break;
             case 'alphaTab.error':
@@ -39481,6 +39557,164 @@ class AudioElementBackingTrackSynthOutput {
     }
 }
 
+/**
+ * @internal
+ */
+class QueueItem {
+    value;
+    next;
+    constructor(value) {
+        this.value = value;
+    }
+}
+/**
+ * @internal
+ */
+class Queue {
+    _head;
+    _tail;
+    get isEmpty() {
+        return this._head === undefined;
+    }
+    clear() {
+        this._head = undefined;
+        this._tail = undefined;
+    }
+    enqueue(item) {
+        const queueItem = new QueueItem(item);
+        if (this._tail) {
+            // not empty -> add after tail
+            this._tail.next = queueItem;
+            this._tail = queueItem;
+        }
+        else {
+            // empty -> new item takes head and tail
+            this._head = queueItem;
+            this._tail = queueItem;
+        }
+    }
+    enqueueFront(item) {
+        const queueItem = new QueueItem(item);
+        queueItem.next = this._head;
+        if (this._head) {
+            this._head = queueItem;
+        }
+        else {
+            this._head = queueItem;
+            this._tail = queueItem;
+        }
+    }
+    peek() {
+        const head = this._head;
+        if (!head) {
+            return undefined;
+        }
+        return head.value;
+    }
+    dequeue() {
+        const head = this._head;
+        if (!head) {
+            return undefined;
+        }
+        const newHead = head.next;
+        this._head = newHead;
+        // last item removed?
+        if (!newHead) {
+            this._tail = undefined;
+        }
+        return head.value;
+    }
+}
+
+/**
+ * The options controlling how to export the audio.
+ * @public
+ */
+class AudioExportOptions {
+    /**
+     * The soundfonts to load and use for generating the audio.
+     * If not provided, the already loaded soundfonts of the synthesizer will be used.
+     * If no existing synthesizer is initialized, the generated audio might not contain any hearable audio.
+     */
+    soundFonts;
+    /**
+     * The output sample rate.
+     * @default `44100`
+     */
+    sampleRate = 44100;
+    /**
+     * Whether to respect sync point information during export.
+     * @default `true`
+     * @remarks
+     * If the song contains sync point information for synchronization with an external media,
+     * this option allows controlling whether the synthesized audio is aligned with these points.
+     *
+     * This is useful when mixing the exported audio together with external media, keeping the same timing.
+     *
+     * Disable this option if you want the original/exact timing as per music sheet in the exported audio.
+     */
+    useSyncPoints = false;
+    /**
+     * The current master volume as percentage. (range: 0.0-3.0, default 1.0)
+     */
+    masterVolume = 1;
+    /**
+     * The metronome volume. (range: 0.0-3.0, default 0.0)
+     */
+    metronomeVolume = 0;
+    /**
+     * The range of the song that should be exported. Set this to null
+     * to play the whole song.
+     */
+    playbackRange;
+    /**
+     * The volume for individual tracks as percentage (range: 0.0-3.0).
+     * @remarks
+     * The key is the track index, and the value is the relative volume.
+     * The configured volume (as per data model) still applies, this is an additional volume control.
+     * If no custom value is set, 100% is used.
+     * No values from the currently active synthesizer are applied.
+     *
+     * The meaning of the key changes when used with AlphaSynth directly, in this case the key is the midi channel .
+     */
+    trackVolume = new Map();
+    /**
+     * The additional semitone pitch transpose to apply for individual tracks.
+     * @remarks
+     * The key is the track index, and the value is the number of semitones to apply.
+     * No values from the currently active synthesizer are applied.
+     *
+     * The meaning of the key changes when used with AlphaSynth directly, in this case the key is the midi channel .
+     */
+    trackTranspositionPitches = new Map();
+}
+/**
+ * Represents a single chunk of audio produced.
+ * @public
+ */
+class AudioExportChunk {
+    /**
+     * The generated samples for the requested chunk.
+     */
+    samples;
+    /**
+     * The current time position within the song in milliseconds.
+     */
+    currentTime = 0;
+    /**
+     * The total length of the song in milliseconds.
+     */
+    endTime = 0;
+    /**
+     * The current time position within the song in midi ticks.
+     */
+    currentTick = 0;
+    /**
+     * The total length of the song in midi ticks.
+     */
+    endTick = 0;
+}
+
 // The SoundFont loading and Audio Synthesis is based on TinySoundFont, licensed under MIT,
 // developed by Bernhard Schelling (https://github.com/schellingb/TinySoundFont)
 // TypeScript port for alphaTab: (C) 2020 by Daniel Kuschny
@@ -39594,6 +39828,7 @@ class MidiSequencerState {
     endTime = 0;
     currentTempo = 0;
     syncPointTempo = 0;
+    metronomeChannel = SynthConstants.DefaultChannelCount - 1;
 }
 /**
  * This sequencer dispatches midi events to the synthesizer based on the current
@@ -39606,6 +39841,9 @@ class MidiFileSequencer {
     _mainState;
     _oneTimeState = null;
     _countInState = null;
+    get metronomeChannel() {
+        return this._mainState.metronomeChannel;
+    }
     get isPlayingMain() {
         return this._currentState === this._mainState;
     }
@@ -39689,7 +39927,7 @@ class MidiFileSequencer {
                 const metronomeVolume = this._synthesizer.metronomeVolume;
                 this._synthesizer.noteOffAll(true);
                 this._synthesizer.resetSoft();
-                this._synthesizer.setupMetronomeChannel(metronomeVolume);
+                this._synthesizer.setupMetronomeChannel(this.metronomeChannel, metronomeVolume);
             }
             this._mainSilentProcess(timePosition);
         }
@@ -39741,6 +39979,7 @@ class MidiFileSequencer {
         let metronomeLengthInMillis = 0;
         let metronomeTick = midiFile.tickShift; // shift metronome to content
         let metronomeTime = 0.0;
+        let maxChannel = 0;
         let previousTick = 0;
         for (const mEvent of midiFile.events) {
             const synthData = new SynthEvent(state.synthData.length, mEvent);
@@ -39782,6 +40021,9 @@ class MidiFileSequencer {
                 if (!state.firstProgramEventPerChannel.has(channel)) {
                     state.firstProgramEventPerChannel.set(channel, synthData);
                 }
+                if (channel > maxChannel) {
+                    maxChannel = channel;
+                }
                 const isPercussion = channel === SynthConstants.PercussionChannel;
                 if (!isPercussion) {
                     this.instrumentPrograms.add(programChange.program);
@@ -39793,6 +40035,9 @@ class MidiFileSequencer {
                 if (isPercussion) {
                     this.percussionKeys.add(noteOn.noteKey);
                 }
+                if (noteOn.channel > maxChannel) {
+                    maxChannel = noteOn.channel;
+                }
             }
         }
         state.currentTempo = state.tempoChanges.length > 0 ? state.tempoChanges[0].bpm : bpm;
@@ -39808,6 +40053,7 @@ class MidiFileSequencer {
         });
         state.endTime = absTime;
         state.endTick = absTick;
+        state.metronomeChannel = maxChannel + 1;
         return state;
     }
     fillMidiEventQueue() {
@@ -44013,6 +44259,11 @@ class Voice {
             if (dynamicGain) {
                 noteGain = SynthHelper.decibelsToGain(this.noteGainDb + this.modLfo.level * tmpModLfoToVolume);
             }
+            // Update EG.
+            this.ampEnv.process(blockSamples, f.outSampleRate);
+            if (updateModEnv) {
+                this.modEnv.process(blockSamples, f.outSampleRate);
+            }
             gainMono = noteGain * this.ampEnv.level;
             if (isMuted) {
                 gainMono = 0;
@@ -44020,11 +44271,6 @@ class Voice {
             else {
                 gainMono *= this.mixVolume;
             }
-            // Update EG.
-            this.ampEnv.process(blockSamples, f.outSampleRate);
-            if (updateModEnv) {
-                this.modEnv.process(blockSamples, f.outSampleRate);
-            }
             // Update LFOs.
             if (updateModLFO) {
                 this.modLfo.process(blockSamples);
@@ -44103,7 +44349,12 @@ class Voice {
                     }
                     break;
             }
-            if (tmpSourceSamplePosition >= tmpSampleEndDbl || this.ampEnv.segment === VoiceEnvelopeSegment.Done) {
+            const inaudible = this.ampEnv.segment === VoiceEnvelopeSegment.Release &&
+                Math.abs(gainMono) < SynthConstants.AudibleLevelThreshold;
+            if (tmpSourceSamplePosition >= tmpSampleEndDbl ||
+                this.ampEnv.segment === VoiceEnvelopeSegment.Done ||
+                // Check if voice is inaudible during release to terminate early
+                inaudible) {
                 this.kill();
                 return;
             }
@@ -44118,75 +44369,6 @@ class Voice {
     }
 }
 
-/**
- * @internal
- */
-class QueueItem {
-    value;
-    next;
-    constructor(value) {
-        this.value = value;
-    }
-}
-/**
- * @internal
- */
-class Queue {
-    _head;
-    _tail;
-    get isEmpty() {
-        return this._head === undefined;
-    }
-    clear() {
-        this._head = undefined;
-        this._tail = undefined;
-    }
-    enqueue(item) {
-        const queueItem = new QueueItem(item);
-        if (this._tail) {
-            // not empty -> add after tail
-            this._tail.next = queueItem;
-            this._tail = queueItem;
-        }
-        else {
-            // empty -> new item takes head and tail
-            this._head = queueItem;
-            this._tail = queueItem;
-        }
-    }
-    enqueueFront(item) {
-        const queueItem = new QueueItem(item);
-        queueItem.next = this._head;
-        if (this._head) {
-            this._head = queueItem;
-        }
-        else {
-            this._head = queueItem;
-            this._tail = queueItem;
-        }
-    }
-    peek() {
-        const head = this._head;
-        if (!head) {
-            return undefined;
-        }
-        return head.value;
-    }
-    dequeue() {
-        const head = this._head;
-        if (!head) {
-            return undefined;
-        }
-        const newHead = head.next;
-        this._head = newHead;
-        // last item removed?
-        if (!newHead) {
-            this._tail = undefined;
-        }
-        return head.value;
-    }
-}
-
 /**
  * Lists all midi controllers.
  * @public
@@ -44343,6 +44525,7 @@ class TinySoundFont {
     currentTempo = 0;
     timeSignatureNumerator = 0;
     timeSignatureDenominator = 0;
+    _metronomeChannel = SynthConstants.DefaultChannelCount - 1;
     constructor(sampleRate) {
         this.outSampleRate = sampleRate;
     }
@@ -44447,8 +44630,8 @@ class TinySoundFont {
         while (!this._midiEventQueue.isEmpty) {
             const m = this._midiEventQueue.dequeue();
             if (m.isMetronome && this.metronomeVolume > 0) {
-                this.channelNoteOff(SynthConstants.MetronomeChannel, SynthConstants.MetronomeKey);
-                this.channelNoteOn(SynthConstants.MetronomeChannel, SynthConstants.MetronomeKey, 95 / 127);
+                this.channelNoteOff(this._metronomeChannel, SynthConstants.MetronomeKey);
+                this.channelNoteOn(this._metronomeChannel, SynthConstants.MetronomeKey, 95 / 127);
             }
             else if (m.event) {
                 this.processMidiMessage(m.event);
@@ -44462,7 +44645,7 @@ class TinySoundFont {
                 // channel is muted if it is either explicitley muted, or another channel is set to solo but not this one.
                 // exception. metronome is implicitly added in solo
                 const isChannelMuted = this._mutedChannels.has(channel) ||
-                    (anySolo && channel !== SynthConstants.MetronomeChannel && !this._soloChannels.has(channel));
+                    (anySolo && channel !== this._metronomeChannel && !this._soloChannels.has(channel));
                 if (!buffer) {
                     voice.kill();
                 }
@@ -44516,16 +44699,17 @@ class TinySoundFont {
         }
     }
     get metronomeVolume() {
-        return this.channelGetMixVolume(SynthConstants.MetronomeChannel);
+        return this.channelGetMixVolume(this._metronomeChannel);
     }
     set metronomeVolume(value) {
-        this.setupMetronomeChannel(value);
+        this.setupMetronomeChannel(this._metronomeChannel, value);
     }
-    setupMetronomeChannel(volume) {
-        this.channelSetMixVolume(SynthConstants.MetronomeChannel, volume);
+    setupMetronomeChannel(channel, volume) {
+        this._metronomeChannel = channel;
+        this.channelSetMixVolume(channel, volume);
         if (volume > 0) {
-            this.channelSetVolume(SynthConstants.MetronomeChannel, 1);
-            this.channelSetPresetNumber(SynthConstants.MetronomeChannel, 0, true);
+            this.channelSetVolume(channel, 1);
+            this.channelSetPresetNumber(channel, 0, true);
         }
     }
     get masterVolume() {
@@ -45605,95 +45789,6 @@ class TinySoundFont {
     }
 }
 
-/**
- * The options controlling how to export the audio.
- * @public
- */
-class AudioExportOptions {
-    /**
-     * The soundfonts to load and use for generating the audio.
-     * If not provided, the already loaded soundfonts of the synthesizer will be used.
-     * If no existing synthesizer is initialized, the generated audio might not contain any hearable audio.
-     */
-    soundFonts;
-    /**
-     * The output sample rate.
-     * @default `44100`
-     */
-    sampleRate = 44100;
-    /**
-     * Whether to respect sync point information during export.
-     * @default `true`
-     * @remarks
-     * If the song contains sync point information for synchronization with an external media,
-     * this option allows controlling whether the synthesized audio is aligned with these points.
-     *
-     * This is useful when mixing the exported audio together with external media, keeping the same timing.
-     *
-     * Disable this option if you want the original/exact timing as per music sheet in the exported audio.
-     */
-    useSyncPoints = false;
-    /**
-     * The current master volume as percentage. (range: 0.0-3.0, default 1.0)
-     */
-    masterVolume = 1;
-    /**
-     * The metronome volume. (range: 0.0-3.0, default 0.0)
-     */
-    metronomeVolume = 0;
-    /**
-     * The range of the song that should be exported. Set this to null
-     * to play the whole song.
-     */
-    playbackRange;
-    /**
-     * The volume for individual tracks as percentage (range: 0.0-3.0).
-     * @remarks
-     * The key is the track index, and the value is the relative volume.
-     * The configured volume (as per data model) still applies, this is an additional volume control.
-     * If no custom value is set, 100% is used.
-     * No values from the currently active synthesizer are applied.
-     *
-     * The meaning of the key changes when used with AlphaSynth directly, in this case the key is the midi channel .
-     */
-    trackVolume = new Map();
-    /**
-     * The additional semitone pitch transpose to apply for individual tracks.
-     * @remarks
-     * The key is the track index, and the value is the number of semitones to apply.
-     * No values from the currently active synthesizer are applied.
-     *
-     * The meaning of the key changes when used with AlphaSynth directly, in this case the key is the midi channel .
-     */
-    trackTranspositionPitches = new Map();
-}
-/**
- * Represents a single chunk of audio produced.
- * @public
- */
-class AudioExportChunk {
-    /**
-     * The generated samples for the requested chunk.
-     */
-    samples;
-    /**
-     * The current time position within the song in milliseconds.
-     */
-    currentTime = 0;
-    /**
-     * The total length of the song in milliseconds.
-     */
-    endTime = 0;
-    /**
-     * The current time position within the song in midi ticks.
-     */
-    currentTick = 0;
-    /**
-     * The total length of the song in midi ticks.
-     */
-    endTick = 0;
-}
-
 /**
  * This is the base class for synthesizer components which can be used to
  * play a {@link MidiFile} via a {@link ISynthOutput}.
@@ -45902,6 +45997,17 @@ class AlphaSynthBase {
             }
             this._notPlayedSamples += samples.length;
             this.output.addSamples(samples);
+            // if the sequencer finished, we instantly force a noteOff on all 
+            // voices to complete playback and stop voices fast. 
+            // Doing this in the samplePlayed callback is too late as we might
+            // continue generating audio for long-release notes (especially percussion like cymbals)
+            // we still have checkForFinish which takes care of the counterpart
+            // on the sample played area to ensure we seek back. 
+            // but thanks to this code we ensure the output will complete fast as we won't 
+            // be adding more samples beside a 0.1s ramp-down
+            if (this.sequencer.isFinished) {
+                this.synthesizer.noteOffAll(true);
+            }
         }
         else {
             // Tell output that there is no data left for it.
@@ -45918,7 +46024,7 @@ class AlphaSynthBase {
         if (this._countInVolume > 0) {
             Logger.debug('AlphaSynth', 'Starting countin');
             this.sequencer.startCountIn();
-            this.synthesizer.setupMetronomeChannel(this._countInVolume);
+            this.synthesizer.setupMetronomeChannel(this.sequencer.metronomeChannel, this._countInVolume);
             this.updateTimePosition(0, true);
         }
         this.output.play();
@@ -45930,7 +46036,7 @@ class AlphaSynthBase {
             this._stopOneTimeMidi();
         }
         Logger.debug('AlphaSynth', 'Starting playback');
-        this.synthesizer.setupMetronomeChannel(this.metronomeVolume);
+        this.synthesizer.setupMetronomeChannel(this.sequencer.metronomeChannel, this.metronomeVolume);
         this._synthStopping = false;
         this.state = PlayerState.Playing;
         this.stateChanged.trigger(new PlayerStateChangedEventArgs(this.state, false));
@@ -46014,7 +46120,7 @@ class AlphaSynthBase {
     }
     _checkReadyForPlayback() {
         if (this.isReadyForPlayback) {
-            this.synthesizer.setupMetronomeChannel(this.metronomeVolume);
+            this.synthesizer.setupMetronomeChannel(this.sequencer.metronomeChannel, this.metronomeVolume);
             const programs = this.sequencer.instrumentPrograms;
             const percussionKeys = this.sequencer.percussionKeys;
             let append = false;
@@ -46355,7 +46461,7 @@ class AlphaSynthAudioExporter {
     _generatedAudioCurrentTime = 0;
     _generatedAudioEndTime = 0;
     setup() {
-        this._synth.setupMetronomeChannel(this._synth.metronomeVolume);
+        this._synth.setupMetronomeChannel(this._sequencer.metronomeChannel, this._synth.metronomeVolume);
         const syncPoints = this._sequencer.currentSyncPoints;
         const alphaTabEndTime = this._sequencer.currentEndTime;
         if (syncPoints.length === 0) {
@@ -46437,7 +46543,7 @@ class BackingTrackAudioSynthesizer {
     }
     loadPresets(_hydra, _instrumentPrograms, _percussionKeys, _append) {
     }
-    setupMetronomeChannel(_metronomeVolume) {
+    setupMetronomeChannel(_metronomeChannel, _metronomeVolume) {
     }
     synthesizeSilent(_sampleCount) {
         this.fakeSynthesize();
@@ -46804,7 +46910,15 @@ class ScoreRenderer {
             Logger.warning('Rendering', 'AlphaTab skipped rendering because of width=0 (element invisible)', null);
             return;
         }
-        this.boundsLookup = new BoundsLookup();
+        // For partial renders we preserve the existing lookup so bars outside the re-layouted
+        // range keep their already-scaled bounds - the layout will clear the changed range
+        // before the paint pass re-registers fresh entries for it.
+        if (renderHints?.firstChangedMasterBar !== undefined && this.boundsLookup) {
+            this.boundsLookup.resetForPartialUpdate();
+        }
+        else {
+            this.boundsLookup = new BoundsLookup();
+        }
         this._recreateCanvas();
         this.canvas.lineWidth = 1;
         this.canvas.settings = this.settings;
@@ -47871,6 +47985,7 @@ class AlphaSynthAudioWorkletOutput extends AlphaSynthWebAudioOutputBase {
     _bufferTimeInMilliseconds = 0;
     _settings;
     _boundHandleMessage;
+    _pendingEvents;
     constructor(settings) {
         super();
         this._settings = settings;
@@ -47898,6 +48013,13 @@ class AlphaSynthAudioWorkletOutput extends AlphaSynthWebAudioOutputBase {
             this.source.connect(this._worklet);
             this.source.start(0);
             this._worklet.connect(ctx.destination);
+            const pending = this._pendingEvents;
+            if (pending) {
+                for (const e of pending) {
+                    this._worklet.port.postMessage(e);
+                }
+                this._pendingEvents = undefined;
+            }
         }, (reason) => {
             Logger.error('WebAudio', `Audio Worklet creation failed: reason=${reason}`);
         });
@@ -47924,15 +48046,26 @@ class AlphaSynthAudioWorkletOutput extends AlphaSynthWebAudioOutputBase {
             this._worklet.disconnect();
         }
         this._worklet = null;
+        this._pendingEvents = undefined;
+    }
+    _postWorkerMessage(message) {
+        const worklet = this._worklet;
+        if (worklet) {
+            worklet.port.postMessage(message);
+        }
+        else {
+            this._pendingEvents ??= [];
+            this._pendingEvents.push(message);
+        }
     }
     addSamples(f) {
-        this._worklet?.port.postMessage({
+        this._postWorkerMessage({
             cmd: 'alphaSynth.output.addSamples',
             samples: Environment.prepareForPostMessage(f)
         });
     }
     resetSamples() {
-        this._worklet?.port.postMessage({
+        this._postWorkerMessage({
             cmd: 'alphaSynth.output.resetSamples'
         });
     }
@@ -48659,9 +48792,6 @@ class BeatTickLookup {
      * @param beat The beat to add.
      */
     highlightBeat(beat, playbackStart) {
-        if (beat.isEmpty && !beat.voice.isEmpty) {
-            return;
-        }
         if (!this._highlightedBeats.has(beat.id)) {
             this._highlightedBeats.set(beat.id, true);
             this.highlightedBeats.push(new BeatTickLookupItem(beat, playbackStart));
@@ -50129,7 +50259,13 @@ class MidiFileGenerator {
         let beatStart = beat.playbackStart;
         let audioDuration = beat.playbackDuration;
         const masterBarDuration = beat.voice.bar.masterBar.calculateDuration();
-        if (beat.voice.bar.isEmpty) {
+        // For a bar whose voice contains a single empty beat (the typical "whole-bar rest"
+        // placeholder inserted during score.finish), extend the beat's audio duration to cover
+        // the full bar so cursor navigation has a beat to follow across the whole bar. Don't
+        // apply this when the voice has multiple beats: those represent explicit rhythmic
+        // subdivisions even when each beat is empty (e.g. a recording grid of placeholder
+        // slots), and overriding would make every beat overlap the whole bar.
+        if (beat.voice.bar.isEmpty && beat.voice.beats.length === 1) {
             audioDuration = masterBarDuration;
         }
         else if (beat.voice.bar.masterBar.tripletFeel !== TripletFeel.NoTripletFeel &&
@@ -54750,7 +54886,8 @@ class AlphaTabApiBase {
                     this._isInitialBeatCursorUpdate ||
                     barBounds.y !== previousBeatBounds.barBounds.masterBarBounds.visualBounds.y ||
                     startBeatX < previousBeatBounds.onNotesX ||
-                    barBoundings.index > previousBeatBounds.barBounds.masterBarBounds.index + 1;
+                    barBoundings.index > previousBeatBounds.barBounds.masterBarBounds.index + 1 ||
+                    barBounds.h !== previousBeatBounds.barBounds.masterBarBounds.visualBounds.h;
                 if (jumpCursor) {
                     cursorHandler.placeBeatCursor(beatCursor, beatBoundings, startBeatX);
                 }
@@ -55805,6 +55942,9 @@ class AlphaTabApiBase {
         this._beatVisibilityChecker.bounds = this.boundsLookup;
         this._currentBeat = null;
         this._cursorUpdateTick(this._previousTick, false, 1, true, true);
+        if (this._selectionStart) {
+            this.highlightPlaybackRange(this._selectionStart.beat, this._selectionEnd.beat);
+        }
         this.postRenderFinished.trigger();
         this.uiFacade.triggerEvent(this.container, 'postRenderFinished', null);
     }
@@ -57987,8 +58127,9 @@ class AlphaTabWebWorker {
                 break;
             case 'alphaTab.renderScore':
                 this._updateFontSizes(data.fontSizes);
+                const renderHints = data.renderHints;
                 const score = data.score == null ? null : JsonConverter.jsObjectToScore(data.score, this._renderer.settings);
-                this._renderMultiple(score, data.trackIndexes);
+                this._renderMultiple(score, data.trackIndexes, renderHints);
                 break;
             case 'alphaTab.updateSettings':
                 this._updateSettings(data.settings);
@@ -62861,6 +63002,15 @@ class BarRendererBase {
         }
         return false;
     }
+    /**
+     * The fixed-overhead width of this renderer: glyphs that do not stretch when
+     * the bar is scaled (clef, key signature, time signature, barlines, courtesy
+     * accidentals, etc). Treated as a fixed allocation by the system-level layout
+     * before distributing remaining width across bars by {@link Bar.displayScale}.
+     */
+    get fixedOverhead() {
+        return this._preBeatGlyphs.width + this._postBeatGlyphs.width;
+    }
     scaleToWidth(width) {
         // preBeat and postBeat glyphs do not get resized
         const containerWidth = width - this._preBeatGlyphs.width - this._postBeatGlyphs.width;
@@ -65419,6 +65569,22 @@ class BarLayoutingInfo {
     postBeatSize = 0;
     minStretchForce = 0;
     totalSpringConstant = 0;
+    /**
+     * The smallest note duration encountered within this bar's springs, used as the reference in
+     * the Gourlay stretch formula. Read by the owning {@link StaffSystem} so that the system can
+     * aggregate a shared minimum across all bars and trigger a reconcile if an added bar introduces
+     * a shorter duration than previously seen.
+     */
+    get localMinDuration() {
+        return this._minDuration;
+    }
+    /**
+     * The minimum-duration reference against which the spring constants currently held by this info
+     * were computed. Set by {@link finish} and {@link recomputeSpringConstants}. The owning
+     * StaffSystem compares this against its system-wide minimum to decide whether spring constants
+     * need re-derivation.
+     */
+    computedWithMinDuration = 0;
     _updateMinStretchForce(force) {
         if (this.minStretchForce < force) {
             this.minStretchForce = force;
@@ -65588,10 +65754,26 @@ class BarLayoutingInfo {
                 this._incompleteGraceRodsWidth += sp.preBeatWidth + sp.postSpringWidth;
             }
         }
-        this._calculateSpringConstants();
+        this._calculateSpringConstants(this._minDuration);
+        this.computedWithMinDuration = this._minDuration;
         this.version++;
     }
-    _calculateSpringConstants() {
+    /**
+     * Re-derives the spring constants (and {@link minStretchForce} / {@link totalSpringConstant})
+     * using a caller-supplied minimum-duration reference rather than this bar's local minimum.
+     *
+     * Called by {@link StaffSystem.reconcileMinDurationIfDirty} when a bar added later to the
+     * system introduced a shorter note than previously seen, invalidating this bar's spring
+     * constants. Grace-rod data is not recomputed — it is independent of the minimum-duration
+     * reference. The internal {@link version} is bumped so downstream consumers (e.g.
+     * {@link BarRendererBase.applyLayoutingInfo}) pick up the refreshed positions.
+     */
+    recomputeSpringConstants(minDuration) {
+        this._calculateSpringConstants(minDuration);
+        this.computedWithMinDuration = minDuration;
+        this.version++;
+    }
+    _calculateSpringConstants(minDuration) {
         let totalSpringConstant = 0;
         const sortedSprings = this._timeSortedSprings;
         if (sortedSprings.length === 0) {
@@ -65609,7 +65791,7 @@ class BarLayoutingInfo {
                 const nextSpring = sortedSprings[i + 1];
                 duration = Math.abs(nextSpring.timePosition - currentSpring.timePosition);
             }
-            currentSpring.springConstant = this._calculateSpringConstant(currentSpring, duration);
+            currentSpring.springConstant = this._calculateSpringConstant(currentSpring, duration, minDuration);
             totalSpringConstant += 1 / currentSpring.springConstant;
         }
         this.totalSpringConstant = 1 / totalSpringConstant;
@@ -65669,7 +65851,7 @@ class BarLayoutingInfo {
     //         springX += this.calculateWidth(force, spring.springConstant);
     //     }
     // }
-    _calculateSpringConstant(spring, duration) {
+    _calculateSpringConstant(spring, duration, minDuration) {
         if (duration <= 0) {
             duration = MidiUtils.toTicks(Duration.TwoHundredFiftySixth);
         }
@@ -65677,7 +65859,6 @@ class BarLayoutingInfo {
             spring.smallestDuration = duration;
         }
         const smallestDuration = spring.smallestDuration;
-        const minDuration = this._minDuration;
         const minDurationWidth = BarLayoutingInfo._defaultMinDurationWidth;
         const phi = 1 + 0.85 * Math.log2(duration / minDuration);
         return (smallestDuration / duration) * (1 / (phi * minDurationWidth));
@@ -65740,6 +65921,18 @@ class MasterBarsRenderers {
     canWrap = true;
     masterBar;
     additionalMultiBarRestIndexes = null;
+    /**
+     * Max fixed overhead (prefix + postfix glyph width) across all staves of this bar.
+     * Used by the layout-mode horizontal scaling pass to carve out the fixed-overhead bucket
+     * before distributing staff width across bars.
+     */
+    maxFixedOverhead = 0;
+    /**
+     * Max natural content width (computedWidth - fixedOverhead) across all staves of this bar.
+     * Used as the bar weight when the layout ignores {@link MasterBar.displayScale} (e.g.
+     * Page layout with `SystemsLayoutMode.Automatic`).
+     */
+    maxContentWidth = 0;
     get lastMasterBarIndex() {
         if (this.additionalMultiBarRestIndexes) {
             return this.additionalMultiBarRestIndexes[this.additionalMultiBarRestIndexes.length - 1];
@@ -65921,6 +66114,45 @@ class StaffSystem {
      * This value is mainly used in the parchment style layout for correct scaling of the bars.
      */
     totalBarDisplayScale = 0;
+    /**
+     * Sum of per-bar {@link MasterBarsRenderers.maxFixedOverhead} across the system. The layout-mode
+     * horizontal scaling pass subtracts this from the available staff width before distributing the
+     * remainder across bars.
+     */
+    totalFixedOverhead = 0;
+    /**
+     * Sum of per-bar {@link MasterBarsRenderers.maxContentWidth} across the system. Used as the
+     * denominator when distributing staff width in modes that weight bars by natural content width
+     * (Page layout with `SystemsLayoutMode.Automatic`).
+     */
+    totalContentWidth = 0;
+    /**
+     * Shortest note duration (in ticks) across every bar that has been added to this system, used
+     * as the common reference in the Gourlay stretch formula so that rhythmically-equivalent beats
+     * in different bars of the same system align column-wise.
+     *
+     * `-1` means "no bar added yet". The value only moves downward during system assembly; when a
+     * new bar introduces a shorter minimum, {@link isMinDurationDirty} is set so that
+     * {@link reconcileMinDurationIfDirty} can re-derive spring constants on the previously-added
+     * bars before layout distribution runs.
+     */
+    minDuration = -1;
+    /**
+     * Set when a bar added to this system introduced a shorter {@link minDuration} than previously
+     * seen, leaving earlier bars' spring constants stale. Consumed by
+     * {@link reconcileMinDurationIfDirty} which is called from `VerticalLayoutBase._fitSystem`
+     * once the system is fully assembled.
+     */
+    isMinDurationDirty = false;
+    /**
+     * Whether this system coordinates a shared minimum-duration reference across its bars for the
+     * Gourlay stretch formula. Defaults to `true` for page-style and parchment layouts where bars
+     * of a system fight for a common staff width. Set to `false` for horizontal layouts where each
+     * bar is sized independently (by `bar.displayWidth` or its intrinsic width) and there is no
+     * column-alignment concern - each bar keeps its local minimum so pre-existing rendering is
+     * preserved.
+     */
+    shareMinDurationAcrossBars = true;
     isLast = false;
     masterBarsRenderers = [];
     staves = [];
@@ -65982,6 +66214,9 @@ class StaffSystem {
         }
         this.firstVisibleStaff = firstVisibleStaff;
         this._calculateAccoladeSpacing(tracks);
+        // On the resize path the layoutingInfo was finalized in a previous layout pass, so we
+        // only need to check whether its min-duration reference still matches the new system's.
+        this._trackSystemMinDuration(renderers.layoutingInfo);
         this._applyLayoutAndUpdateWidth();
         return renderers;
     }
@@ -66037,10 +66272,89 @@ class StaffSystem {
         this.firstVisibleStaff = firstVisibleStaff;
         this._calculateAccoladeSpacing(tracks);
         barLayoutingInfo.finish();
+        // Reconcile against the system-wide minimum-duration reference now that springs are
+        // finalized. If this bar introduced a shorter note, earlier bars become stale (flagged
+        // for bulk reconcile at fit time). If the system already had a shorter min than this
+        // bar's local one, this bar's spring constants are recomputed immediately so the width
+        // we return below reflects the shared reference.
+        this._trackSystemMinDuration(barLayoutingInfo);
         // ensure same widths of new renderer
         result.width = this._applyLayoutAndUpdateWidth();
         return result;
     }
+    /**
+     * Updates {@link minDuration} and {@link isMinDurationDirty} when a bar is added, and brings
+     * the just-added bar's {@link BarLayoutingInfo} in line with the current system minimum if the
+     * system already saw a shorter reference. The bulk reconcile over previously-added bars is
+     * deferred to {@link reconcileMinDurationIfDirty} (called from `_fitSystem`) to avoid
+     * re-iterating the system every time a bar is appended.
+     */
+    _trackSystemMinDuration(info) {
+        if (!this.shareMinDurationAcrossBars) {
+            return;
+        }
+        const localMin = info.localMinDuration;
+        if (this.minDuration === -1 || localMin < this.minDuration) {
+            // this bar shortens the system minimum; earlier bars (if any) are now stale
+            if (this.masterBarsRenderers.length > 1 && localMin !== this.minDuration) {
+                this.isMinDurationDirty = true;
+            }
+            this.minDuration = localMin;
+        }
+        if (info.computedWithMinDuration > this.minDuration) {
+            // this bar was initialized against a larger (local) min than the system carries; pull
+            // it down to the system reference so its computedWidth reflects the shared spacing.
+            info.recomputeSpringConstants(this.minDuration);
+        }
+    }
+    /**
+     * Re-derives spring constants on bars whose {@link BarLayoutingInfo.computedWithMinDuration}
+     * is out of sync with the current {@link minDuration}, and rebuilds the cached system totals
+     * (widths, {@link totalFixedOverhead}, {@link totalContentWidth}) from the refreshed bar
+     * widths. Called from `VerticalLayoutBase._fitSystem` after the system is fully assembled and
+     * before distribution runs. No-op when {@link isMinDurationDirty} is false.
+     */
+    reconcileMinDurationIfDirty() {
+        if (!this.isMinDurationDirty) {
+            return;
+        }
+        let systemWidth = this.accoladeWidth;
+        let totalFixedOverhead = 0;
+        let totalContentWidth = 0;
+        for (const mb of this.masterBarsRenderers) {
+            if (mb.layoutingInfo.computedWithMinDuration > this.minDuration) {
+                mb.layoutingInfo.recomputeSpringConstants(this.minDuration);
+            }
+            let maxPrefix = 0;
+            let maxContent = 0;
+            let realWidth = 0;
+            for (const r of mb.renderers) {
+                r.applyLayoutingInfo();
+                if (r.computedWidth > realWidth) {
+                    realWidth = r.computedWidth;
+                }
+                const overhead = r.fixedOverhead;
+                if (overhead > maxPrefix) {
+                    maxPrefix = overhead;
+                }
+                const content = Math.max(0, r.computedWidth - overhead);
+                if (content > maxContent) {
+                    maxContent = content;
+                }
+            }
+            mb.maxFixedOverhead = maxPrefix;
+            mb.maxContentWidth = maxContent;
+            mb.width = realWidth;
+            systemWidth += realWidth;
+            totalFixedOverhead += maxPrefix;
+            totalContentWidth += maxContent;
+        }
+        this.width = systemWidth;
+        this.computedWidth = systemWidth;
+        this.totalFixedOverhead = totalFixedOverhead;
+        this.totalContentWidth = totalContentWidth;
+        this.isMinDurationDirty = false;
+    }
     getBarDisplayScale(renderer) {
         return this.staves.length > 1 ? renderer.bar.masterBar.displayScale : renderer.bar.displayScale;
     }
@@ -66079,12 +66393,16 @@ class StaffSystem {
             this.width -= width;
             this.computedWidth -= width;
             this.totalBarDisplayScale -= barDisplayScale;
+            this.totalFixedOverhead -= toRemove.maxFixedOverhead;
+            this.totalContentWidth -= toRemove.maxContentWidth;
             return toRemove;
         }
         return null;
     }
     _applyLayoutAndUpdateWidth() {
         let realWidth = 0;
+        let maxFixedOverhead = 0;
+        let maxContentWidth = 0;
         let barDisplayScale = 0;
         for (const s of this.allStaves) {
             const last = s.barRenderers[s.barRenderers.length - 1];
@@ -66093,8 +66411,21 @@ class StaffSystem {
             if (last.computedWidth > realWidth) {
                 realWidth = last.computedWidth;
             }
+            const overhead = last.fixedOverhead;
+            if (overhead > maxFixedOverhead) {
+                maxFixedOverhead = overhead;
+            }
+            const content = Math.max(0, last.computedWidth - overhead);
+            if (content > maxContentWidth) {
+                maxContentWidth = content;
+            }
         }
+        const renderers = this.masterBarsRenderers[this.masterBarsRenderers.length - 1];
+        renderers.maxFixedOverhead = maxFixedOverhead;
+        renderers.maxContentWidth = maxContentWidth;
         this.totalBarDisplayScale += barDisplayScale;
+        this.totalFixedOverhead += maxFixedOverhead;
+        this.totalContentWidth += maxContentWidth;
         this.width += realWidth;
         this.computedWidth += realWidth;
         return realWidth;
@@ -66592,17 +66923,6 @@ class StaffSystem {
     }
 }
 
-/**
- * @internal
- */
-class LazyPartial {
-    args;
-    renderCallback;
-    constructor(args, renderCallback) {
-        this.args = args;
-        this.renderCallback = renderCallback;
-    }
-}
 /**
  * This is the base class for creating new layouting engines for the score renderer.
  * @internal
@@ -66633,15 +66953,21 @@ class ScoreLayout {
         this.doResize();
     }
     layoutAndRender(renderHints) {
-        this._lazyPartials.clear();
         this.slurRegistry.clear();
-        this.beamingRuleLookups.clear();
-        this._barRendererLookup.clear();
-        this.profile = Environment.staveProfiles.get(this.renderer.settings.display.staveProfile);
         const score = this.renderer.score;
         this.firstBarIndex = ModelUtils.computeFirstDisplayedBarIndex(score, this.renderer.settings);
         this.lastBarIndex = ModelUtils.computeLastDisplayedBarIndex(score, this.renderer.settings, this.firstBarIndex);
         this.multiBarRestInfo = ModelUtils.buildMultiBarRestInfo(this.renderer.tracks, this.firstBarIndex, this.lastBarIndex);
+        const firstChangedMasterBar = renderHints?.firstChangedMasterBar;
+        if (firstChangedMasterBar !== undefined) {
+            if (this.doUpdateForBars(renderHints)) {
+                return;
+            }
+        }
+        this._lazyPartials.clear();
+        this.beamingRuleLookups.clear();
+        this._barRendererLookup.clear();
+        this.profile = Environment.staveProfiles.get(this.renderer.settings.display.staveProfile);
         this.pagePadding = this.renderer.settings.display.padding.map(p => p / this.renderer.settings.display.scale);
         if (!this.pagePadding) {
             this.pagePadding = [0, 0, 0, 0];
@@ -66656,6 +66982,9 @@ class ScoreLayout {
         this.doLayoutAndRender(renderHints);
     }
     _lazyPartials = new Map();
+    getExistingPartialArgs(id) {
+        return this._lazyPartials.has(id) ? this._lazyPartials.get(id).args : undefined;
+    }
     registerPartial(args, callback) {
         if (args.height === 0) {
             return;
@@ -66674,7 +67003,11 @@ class ScoreLayout {
         }
         else {
             // in case of lazy loading -> first register lazy, then notify
-            this._lazyPartials.set(args.id, new LazyPartial(args, callback));
+            const partial = {
+                args,
+                renderCallback: callback
+            };
+            this._lazyPartials.set(args.id, partial);
             this.renderer.partialLayoutFinished.trigger(args);
         }
     }
@@ -66969,7 +67302,7 @@ class ScoreLayout {
             glyph.textAlign = TextAlign.Left;
         }
     }
-    layoutAndRenderAnnotation(y) {
+    _layoutAndRenderAnnotation(y) {
         // attention, you are not allowed to remove change this notice within any version of this library without permission!
         const msg = 'rendered by alphaTab';
         const resources = this.renderer.settings.display.resources;
@@ -67033,6 +67366,12 @@ class HorizontalScreenLayout extends ScoreLayout {
     }
     doResize() {
     }
+    doUpdateForBars(_renderHints) {
+        // not supported yet, modifications likely cause anyhow full updates
+        // as we do not optimize effect bands yet. with effect bands being more 
+        // isolated in bars we could try updating dynamically
+        return false;
+    }
     doLayoutAndRender(renderHints) {
         const score = this.renderer.score;
         let startIndex = this.renderer.settings.display.startBar;
@@ -67046,6 +67385,11 @@ class HorizontalScreenLayout extends ScoreLayout {
         endBarIndex = startIndex + endBarIndex - 1; // map count to array index
         endBarIndex = Math.min(score.masterBars.length - 1, Math.max(0, endBarIndex));
         this._system = this.createEmptyStaffSystem(0);
+        // Each bar in horizontal layout is sized independently (by bar.displayWidth or the bar's
+        // intrinsic width), so there is no shared staff width to distribute across bars. Keep each
+        // bar's spring constants referenced against its own local minimum-duration so rendering
+        // matches the historical per-bar behaviour.
+        this._system.shareMinDurationAcrossBars = false;
         this._system.isLast = true;
         this._system.x = this.pagePadding[0];
         this._system.y = this.pagePadding[1];
@@ -67107,7 +67451,7 @@ class HorizontalScreenLayout extends ScoreLayout {
             currentBarIndex += partial.masterBars.length;
         }
         this.height = this.layoutAndRenderBottomScoreInfo(this.height);
-        this.height = this.layoutAndRenderAnnotation(this.height);
+        this.height = this._layoutAndRenderAnnotation(this.height);
         this.height += this.pagePadding[3];
         this.height *= this.renderer.settings.display.scale;
     }
@@ -67174,11 +67518,16 @@ class VerticalLayoutBase extends ScoreLayout {
     _allMasterBarRenderers = [];
     _barsFromPreviousSystem = [];
     _reuseViewPort = false;
+    _preSystemPartialIds = [];
+    _systemPartialIds = [];
     doLayoutAndRender(renderHints) {
         let y = this.pagePadding[1];
         this.width = this.renderer.width;
         this._allMasterBarRenderers = [];
+        this._preSystemPartialIds = [];
+        this._systemPartialIds = [];
         this._reuseViewPort = renderHints?.reuseViewport ?? false;
+        this._systems = [];
         //
         // 1. Score Info
         y = this._layoutAndRenderScoreInfo(y, -1);
@@ -67190,15 +67539,23 @@ class VerticalLayoutBase extends ScoreLayout {
         y = this._layoutAndRenderChordDiagrams(y, -1);
         //
         // 4. One result per StaffSystem
-        y = this._layoutAndRenderScore(y);
+        y = this._layoutAndRenderScore(y, this.firstBarIndex);
         y = this.layoutAndRenderBottomScoreInfo(y);
-        y = this.layoutAndRenderAnnotation(y);
+        y = this._layoutAndRenderAnnotation(y);
         this.height = (y + this.pagePadding[3]) * this.renderer.settings.display.scale;
     }
     registerPartial(args, callback) {
         args.reuseViewport = this._reuseViewPort;
         super.registerPartial(args, callback);
     }
+    reregisterPartial(id) {
+        const args = this.getExistingPartialArgs(id);
+        if (!args) {
+            return;
+        }
+        args.reuseViewport = this._reuseViewPort;
+        this.renderer.partialLayoutFinished.trigger(args);
+    }
     get supportsResize() {
         return true;
     }
@@ -67209,6 +67566,47 @@ class VerticalLayoutBase extends ScoreLayout {
         }
         return x;
     }
+    doUpdateForBars(renderHints) {
+        this._reuseViewPort = renderHints.reuseViewport ?? false;
+        const firstModifiedMasterBar = renderHints.firstChangedMasterBar;
+        // first update existing systems as needed
+        const systemIndex = this._systems.findIndex(s => {
+            const first = s.masterBarsRenderers[0].masterBar.index;
+            const last = s.masterBarsRenderers[s.masterBarsRenderers.length - 1].masterBar.index;
+            return first <= firstModifiedMasterBar && firstModifiedMasterBar <= last;
+        });
+        if (systemIndex === -1 || !this.renderer.settings.core.enableLazyLoading) {
+            return false;
+        }
+        // Bars from the start of the re-layouted system onward will be re-registered during the
+        // paint pass. Clear their old entries from the preserved BoundsLookup so registration
+        // produces a clean, complete lookup after this render finishes.
+        const firstRebuiltBarIndex = this._systems[systemIndex].masterBarsRenderers[0].masterBar.index;
+        this.renderer.boundsLookup.clearFromMasterBar(firstRebuiltBarIndex);
+        // for now we do a full relayout from the first modified masterbar
+        // there is a lot of room for even more performant updates, but they come
+        // at a risk that features break.
+        // e.g. we could only shift systems where the content didn't change,
+        // but we might still have ties/slurs which have to be updated.
+        const removeSystems = this._systems.splice(systemIndex, this._systems.length - systemIndex);
+        this._systemPartialIds.splice(systemIndex, this._systemPartialIds.length - systemIndex);
+        const system = removeSystems[0];
+        let y = system.y;
+        const firstBarIndex = system.masterBarsRenderers[0].masterBar.index;
+        // signal all partials which didn't change
+        for (const preSystemPartial of this._preSystemPartialIds) {
+            this.reregisterPartial(preSystemPartial);
+        }
+        for (let i = 0; i < systemIndex; i++) {
+            this.reregisterPartial(this._systemPartialIds[i]);
+        }
+        // new partials for all other prats
+        y = this._layoutAndRenderScore(y, firstBarIndex);
+        y = this.layoutAndRenderBottomScoreInfo(y);
+        y = this._layoutAndRenderAnnotation(y);
+        this.height = (y + this.pagePadding[3]) * this.renderer.settings.display.scale;
+        return true;
+    }
     doResize() {
         let y = this.pagePadding[1];
         this.width = this.renderer.width;
@@ -67227,7 +67625,7 @@ class VerticalLayoutBase extends ScoreLayout {
         // 4. One result per StaffSystem
         y = this._resizeAndRenderScore(y, oldHeight);
         y = this.layoutAndRenderBottomScoreInfo(y);
-        y = this.layoutAndRenderAnnotation(y);
+        y = this._layoutAndRenderAnnotation(y);
         this.height = (y + this.pagePadding[3]) * this.renderer.settings.display.scale;
     }
     _layoutAndRenderTunings(y, totalHeight = -1) {
@@ -67251,6 +67649,7 @@ class VerticalLayoutBase extends ScoreLayout {
             canvas.textAlign = TextAlign.Center;
             this.tuningGlyph.paint(0, 0, canvas);
         });
+        this._preSystemPartialIds.push(e.id);
         return y + tuningHeight;
     }
     _layoutAndRenderChordDiagrams(y, totalHeight = -1) {
@@ -67274,6 +67673,7 @@ class VerticalLayoutBase extends ScoreLayout {
             canvas.textAlign = TextAlign.Center;
             this.chordDiagrams.paint(0, 0, canvas);
         });
+        this._preSystemPartialIds.push(e.id);
         return y + diagramHeight;
     }
     _layoutAndRenderScoreInfo(y, totalHeight = -1) {
@@ -67316,12 +67716,14 @@ class VerticalLayoutBase extends ScoreLayout {
                     g.paint(0, 0, canvas);
                 }
             });
+            this._preSystemPartialIds.push(e.id);
         }
         return y + infoHeight;
     }
     _resizeAndRenderScore(y, oldHeight) {
         // if we have a fixed number of bars per row, we only need to refit them.
         const barsPerRowActive = this.getBarsPerSystem(0) > 0;
+        this._systemPartialIds = [];
         if (barsPerRowActive) {
             for (let i = 0; i < this._systems.length; i++) {
                 const system = this._systems[i];
@@ -67384,11 +67786,9 @@ class VerticalLayoutBase extends ScoreLayout {
         }
         return y;
     }
-    _layoutAndRenderScore(y) {
-        const startIndex = this.firstBarIndex;
+    _layoutAndRenderScore(y, startIndex) {
         let currentBarIndex = startIndex;
         const endBarIndex = this.lastBarIndex;
-        this._systems = [];
         while (currentBarIndex <= endBarIndex) {
             // create system and align set proper coordinates
             const system = this._createStaffSystem(currentBarIndex, endBarIndex);
@@ -67423,6 +67823,7 @@ class VerticalLayoutBase extends ScoreLayout {
             // since we use partial drawing
             system.paint(0, -(args.y / this.renderer.settings.display.scale), canvas);
         });
+        this._systemPartialIds.push(args.id);
         // calculate coordinates for next system
         return height;
     }
@@ -67430,6 +67831,10 @@ class VerticalLayoutBase extends ScoreLayout {
      * Realignes the bars in this line according to the available space
      */
     _fitSystem(system) {
+        // If a bar added late in the assembly introduced a shorter note than earlier bars, the
+        // earlier bars' spring constants (and the cached system widths / totals) are stale.
+        // Reconcile now - it's a no-op when nothing changed.
+        system.reconcileMinDurationIfDirty();
         if (system.isFull || system.width > this._maxWidth || this.renderer.settings.display.justifyLastSystem) {
             this._scaleToWidth(system, this._maxWidth);
         }
@@ -67441,29 +67846,35 @@ class VerticalLayoutBase extends ScoreLayout {
     _scaleToWidth(system, width) {
         const staffWidth = width - system.accoladeWidth;
         const shouldApplyBarScale = this.shouldApplyBarScale;
-        const totalScale = system.totalBarDisplayScale;
-        // NOTE: it currently delivers best results if we evenly distribute the available space across bars
-        // scaling bars relatively to their computed width, rather causes distortions whenever bars have
-        // pre-beat glyphs.
-        // most precise scaling would come if we use the contents (voiceContainerGlyph) width as a calculation
-        // factor. but this would make the calculation additionally complex with not much gain.
-        const difference = width - system.computedWidth;
-        const spacePerBar = difference / system.masterBarsRenderers.length;
+        // Industry fixed-overhead model (Behind Bars, Dorico, Finale, Sibelius, MuseScore, Guitar Pro):
+        // prefix/postfix glyphs (clef, key sig, time sig, barlines) are treated as fixed overhead and the
+        // remaining staff width is distributed across bars by a per-bar weight.
+        //
+        //   distributable = staffWidth - totalFixedOverhead
+        //   contentShare  = distributable / sum(weight)
+        //   bar.width     = bar.maxFixedOverhead + weight * contentShare
+        //
+        // The weight depends on the layout mode:
+        //   - shouldApplyBarScale=true  -> weight = bar.displayScale (model-driven, matches Guitar Pro)
+        //                                  displayScale defaults to 1, so an unset value behaves identically
+        //                                  to an explicit 1 (GP omits the property when not customized).
+        //   - shouldApplyBarScale=false -> weight = natural content width (automatic, ignores displayScale)
+        //
+        // Per-bar maxFixedOverhead / maxContentWidth and the system-wide totals are maintained incrementally
+        // in StaffSystem._applyLayoutAndUpdateWidth / revertLastBar so this pass can apply directly.
+        const weightTotal = shouldApplyBarScale ? system.totalBarDisplayScale : system.totalContentWidth;
+        const distributable = Math.max(0, staffWidth - system.totalFixedOverhead);
+        const contentShare = weightTotal > 0 ? distributable / weightTotal : 0;
         for (const s of system.allStaves) {
             s.resetSharedLayoutData();
-            // scale the bars by keeping their respective ratio size
             let w = 0;
-            for (const renderer of s.barRenderers) {
+            for (let i = 0; i < s.barRenderers.length; i++) {
+                const renderer = s.barRenderers[i];
+                const mb = system.masterBarsRenderers[i];
                 renderer.x = w;
                 renderer.y = s.topPadding + s.topOverflow;
-                let actualBarWidth;
-                if (shouldApplyBarScale) {
-                    const barDisplayScale = system.getBarDisplayScale(renderer);
-                    actualBarWidth = (barDisplayScale * staffWidth) / totalScale;
-                }
-                else {
-                    actualBarWidth = renderer.computedWidth + spacePerBar;
-                }
+                const weight = shouldApplyBarScale ? system.getBarDisplayScale(renderer) : mb.maxContentWidth;
+                const actualBarWidth = mb.maxFixedOverhead + weight * contentShare;
                 renderer.scaleToWidth(actualBarWidth);
                 w += renderer.width;
             }
@@ -69210,16 +69621,18 @@ class LineBarRenderer extends BarRendererBase {
             s = [];
             const zero = MusicFontSymbol.Tuplet0;
             if (num > 10) {
-                s.push((zero + Math.floor(num / 10)));
-                s.push((zero + (num - 10)));
+                const tens = Math.floor(num / 10);
+                s.push((zero + tens));
+                s.push((zero + (num - 10 * tens)));
             }
             else {
                 s.push((zero + num));
             }
             s.push(MusicFontSymbol.TupletColon);
             if (den > 10) {
-                s.push((zero + Math.floor(den / 10)));
-                s.push((zero + (den - 10)));
+                const tens = Math.floor(den / 10);
+                s.push((zero + tens));
+                s.push((zero + (den - 10 * tens)));
             }
             else {
                 s.push((zero + den));
@@ -69285,12 +69698,24 @@ class LineBarRenderer extends BarRendererBase {
                 const firstNonRestBeamingHelper = this.helpers.getBeamingHelperForBeat(firstNonRestBeat);
                 const lastNonRestBeamingHelper = this.helpers.getBeamingHelperForBeat(lastNonRestBeat);
                 const direction = this.getTupletBeamDirection(firstNonRestBeamingHelper);
-                let startY = this.calculateBeamYWithDirection(firstNonRestBeamingHelper, startX, direction);
-                let endY = this.calculateBeamYWithDirection(lastNonRestBeamingHelper, endX, direction);
+                let startY;
+                let endY;
                 if (isRestOnly) {
-                    startY = Math.max(startY, endY);
+                    // rests have no stems, so anchor to the actual rest glyph bounds
+                    // instead of a stem-adjusted flag position (which would place the bracket
+                    // a full quarter-stem length away from the rests).
+                    if (direction === BeamDirection.Up) {
+                        startY = Math.min(this.getRestY(firstNonRestBeat, NoteYPosition.Top), this.getRestY(lastNonRestBeat, NoteYPosition.Top));
+                    }
+                    else {
+                        startY = Math.max(this.getRestY(firstNonRestBeat, NoteYPosition.Bottom), this.getRestY(lastNonRestBeat, NoteYPosition.Bottom));
+                    }
                     endY = startY;
                 }
+                else {
+                    startY = this.calculateBeamYWithDirection(firstNonRestBeamingHelper, startX, direction);
+                    endY = this.calculateBeamYWithDirection(lastNonRestBeamingHelper, endX, direction);
+                }
                 // align line centered in available space
                 if (direction === BeamDirection.Down) {
                     startY += shift;
@@ -69660,7 +70085,30 @@ class LineBarRenderer extends BarRendererBase {
         let minNoteY = 0;
         for (const v of this.helpers.beamHelpers) {
             for (const h of v) {
-                if (!this.shouldPaintBeamingHelper(h)) ;
+                if (!this.shouldPaintBeamingHelper(h)) {
+                    // beam is not drawn, but a rest-only tuplet still draws a bracket
+                    // anchored to the rest glyph bounds and needs overflow reserved.
+                    if (h.hasTuplet && h.isRestBeamHelper) {
+                        const tupletGroup = h.beats[0].tupletGroup;
+                        const tupletFirst = tupletGroup.beats[0];
+                        const tupletLast = tupletGroup.beats[tupletGroup.beats.length - 1];
+                        const tupletDirection = this.getTupletBeamDirection(h);
+                        if (tupletDirection === BeamDirection.Up) {
+                            const restTop = Math.min(this.getRestY(tupletFirst, NoteYPosition.Top), this.getRestY(tupletLast, NoteYPosition.Top));
+                            const topY = restTop - this.tupletSize - this.tupletOffset;
+                            if (topY < maxNoteY) {
+                                maxNoteY = topY;
+                            }
+                        }
+                        else {
+                            const restBottom = Math.max(this.getRestY(tupletFirst, NoteYPosition.Bottom), this.getRestY(tupletLast, NoteYPosition.Bottom));
+                            const bottomY = restBottom + this.tupletSize + this.tupletOffset;
+                            if (bottomY > minNoteY) {
+                                minNoteY = bottomY;
+                            }
+                        }
+                    }
+                }
                 else if (h.beats.length === 1 && h.beats[0].duration >= Duration.Half) {
                     const tupletDirection = this.getTupletBeamDirection(h);
                     const direction = this.getBeamDirection(h);
@@ -72198,8 +72646,10 @@ class ScoreBeatGlyph extends BeatOnNoteGlyphBase {
                 const group = new GlyphGroup(0, 0);
                 group.renderer = this.renderer;
                 for (const note of this.container.beat.notes) {
-                    const g = this._createBeatDot(sr.getNoteSteps(note), group);
-                    g.colorOverride = ElementStyleHelper.noteColor(sr.resources, NoteSubElement.StandardNotationEffects, note);
+                    if (note.isVisible) {
+                        const g = this._createBeatDot(sr.getNoteSteps(note), group);
+                        g.colorOverride = ElementStyleHelper.noteColor(sr.resources, NoteSubElement.StandardNotationEffects, note);
+                    }
                 }
                 this.addEffect(group);
             }