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

package/dist/alphaTab.d.ts

@@ -105,15 +105,12 @@ declare class AlphaSynth extends AlphaSynthBase {
  * @public
  */
 declare class AlphaSynthBase implements IAlphaSynth {
-
-
     protected isSoundFontLoaded: boolean;
     private _isMidiLoaded;
     private _tickPosition;
     private _timePosition;
     private _metronomeVolume;
     private _countInVolume;
-
     protected midiEventsPlayedFilterSet: Set<MidiEventType>;
     private _notPlayedSamples;
     private _synthStopping;
@@ -149,7 +146,6 @@ declare class AlphaSynthBase implements IAlphaSynth {
     get isLooping(): boolean;
     set isLooping(value: boolean);
     destroy(): void;
-
     protected onSampleRequest(): void;
     play(): boolean;
     private _playInternal;
@@ -203,8 +199,6 @@ declare class AlphaSynthBase implements IAlphaSynth {
      * @lateinit
      */
     readonly playbackRangeChanged: IEventEmitterOfT<PlaybackRangeChangedEventArgs>;
-
-
     loadBackingTrack(_score: Score): void;
     updateSyncPoints(_syncPoints: BackingTrackSyncPoint[]): void;
 }
@@ -697,7 +691,6 @@ export declare class AlphaTabApiBase<TSettings> {
      */
     renderTracks(tracks: Track[], renderHints?: RenderHints): void;
     private _internalRenderTracks;
-
     private _appendRenderResult;
     private _updateRenderResult;
     /**
@@ -2508,7 +2501,6 @@ export declare class AlphaTabApiBase<TSettings> {
      *
      */
     readonly error: IEventEmitterOfT<Error>;
-
     /**
      * This event is fired when all required data for playback is loaded and ready.
      * @remarks
@@ -3287,7 +3279,6 @@ declare interface AlphaTexArgumentList extends AlphaTexAstNode {
      * The close parenthesis token grouping the arguments.
      */
     closeParenthesis?: AlphaTexParenthesisCloseTokenNode;
-
     /**
      * A list of indices to signatures which were selected as candidates matching
      * this argument list.
@@ -3763,7 +3754,6 @@ declare class AlphaTexImporter extends ScoreImporter implements IAlphaTexImporte
     private _beatDuration;
     private _parseDuration;
     private _note;
-
     applyStaffNoteKind(staff: Staff, staffNoteKind: AlphaTexStaffNoteKind): void;
     private _noteEffects;
     private _handleTransposition;
@@ -3838,7 +3828,6 @@ declare interface AlphaTexMetaDataNode extends AlphaTexAstNode {
      * The optional properties defined for the metadata.
      */
     properties?: AlphaTexPropertiesNode;
-
 }
 
 /**
@@ -4003,7 +3992,6 @@ declare class AlphaTexParser {
     get lexerDiagnostics(): AlphaTexDiagnosticBag;
     readonly parserDiagnostics: AlphaTexDiagnosticBag;
     addParserDiagnostic(diagnostics: AlphaTexDiagnostic): void;
-
     constructor(source: string);
     read(): AlphaTexScoreNode;
     private _score;
@@ -4408,7 +4396,6 @@ declare class BackingTrackSyncPoint {
  */
 declare class Bar {
     private static _globalBarId;
-
     /**
      * Gets or sets the unique id of this bar.
      */
@@ -4520,7 +4507,6 @@ declare class Bar {
      * If specified, overrides the value from the stylesheet on score level.
      */
     barNumberDisplay?: BarNumberDisplay;
-
     /**
      * The bar line to draw on the left side of the bar with an "automatic" type resolved to the actual one.
      * @param isFirstOfSystem  Whether the bar is the first one in the system.
@@ -4787,12 +4773,6 @@ declare class BeamingRules {
      * The map value defines the "groups" placed within the sliced.
      */
     groups: Map<Duration, number[]>;
-
-
-
-
-
-
 }
 
 /**
@@ -4805,7 +4785,6 @@ declare class BeamingRules {
  */
 declare class Beat {
     private static _globalBeatId;
-
     /**
      * Gets or sets the unique id of this beat.
      * @clone_ignore
@@ -6748,9 +6727,16 @@ export declare 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
      *
@@ -7107,9 +7093,16 @@ declare interface DisplaySettingsJson {
      *
      * 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
      *
@@ -7313,7 +7306,6 @@ declare class EndOfTrackEvent extends MidiEvent {
  */
 export declare class EngravingSettings {
     private static _bravuraDefaults?;
-
     /**
      * A {@link EngravingSettings} copy filled with the settings of the Bravura font used by default in alphaTab.
      */
@@ -7493,14 +7485,12 @@ export declare class EngravingSettings {
      * @smufl 1.4
      */
     glyphHeights: Map<MusicFontSymbol, number>;
-
     /**
      * Fills the engraving settings from the provided smufl metdata.
      * @param smufl The metadata shipped together with the SMuFL fonts.
      * @param musicFontSize The font size to configure in alphaTab for the music font.
      */
     fillFromSmufl(smufl: SmuflMetadata, musicFontSize?: number): void;
-
     private static _smuflNameToMusicFontSymbol;
     /**
      * The size of the bars drawn in numbered notation to indicate the durations.
@@ -8162,13 +8152,10 @@ declare interface EngravingStemInfoJson {
  * @public
  */
 export declare class Environment {
-
     /**
      * @target web
      */
     private static _globalThis;
-
-
     /**
      * @target web
      */
@@ -8201,7 +8188,6 @@ export declare class Environment {
      * @target web
      */
     private static _detectScriptFile;
-
     private static _appendScriptName;
     /**
      * @target web
@@ -8212,10 +8198,7 @@ export declare class Environment {
      */
     private static _registerJQueryPlugin;
     static readonly renderEngines: Map<string, RenderEngineFactory>;
-
-
     static getRenderEngineFactory(engine: string): RenderEngineFactory;
-
     /**
      * Gets all default ScoreImporters
      * @returns
@@ -8239,15 +8222,12 @@ export declare class Environment {
      * @partial
      */
     private static _createPlatformSpecificRenderEngines;
-
     private static _createDefaultStaveProfiles;
     private static _createDefaultLayoutEngines;
     /**
      * @target web
      */
     static initializeMain(createWebWorker: (settings: Settings, nameHint: string) => Worker, createAudioWorklet: (context: AudioContext, settings: Settings) => Promise<void>): void;
-
-
     /**
      * @target web
      */
@@ -8278,9 +8258,6 @@ export declare class Environment {
      * @partial
      */
     private static _printPlatformInfo;
-
-
-
 }
 
 export declare namespace exporter {
@@ -9791,7 +9768,6 @@ declare class InstrumentArticulation {
      */
     outputMidiNumber: number;
     constructor(elementType?: string, staffLine?: number, outputMidiNumber?: number, noteHeadDefault?: MusicFontSymbol, noteHeadHalf?: MusicFontSymbol, noteHeadWhole?: MusicFontSymbol, techniqueSymbol?: MusicFontSymbol, techniqueSymbolPlacement?: TechniqueSymbolPlacement, id?: number);
-
     getSymbol(duration: Duration): MusicFontSymbol;
 }
 
@@ -10787,7 +10763,6 @@ declare class MasterBar {
      * Defines the custom beaming rules which should be applied to this bar and all bars following.
      */
     beamingRules?: BeamingRules;
-
     /**
      * Gets or sets whether the bar indicates a free time playing.
      */
@@ -11353,7 +11328,6 @@ declare class MidiFileGenerator {
      * @returns The generated sync points for usage in the backing track playback.
      */
     static generateSyncPoints(score: Score, createNew?: boolean): BackingTrackSyncPoint[];
-
     private static _playThroughSong;
     private static _processBarTime;
     private static _processBarTimeWithNewSyncPoints;
@@ -11472,7 +11446,6 @@ declare class MidiFileGenerator {
  */
 declare class MidiTickLookup {
     private _currentMasterBar;
-
     /**
      * A list of all {@link MasterBarTickLookup} sorted by time.
      */
@@ -12726,8 +12699,6 @@ declare interface NotationSettingsJson {
  * @public
  */
 declare class Note {
-
-
     /**
      * Gets or sets the unique id of this note.
      * @clone_ignore
@@ -13128,8 +13099,6 @@ declare class Note {
     private static _noteIdLookupKey;
     private _noteIdBag;
     chain(sharedDataBag?: Map<string, unknown> | null): void;
-
-
 }
 
 /**
@@ -14346,6 +14315,13 @@ declare interface RenderHints {
      * internally it might still be decided to clear the viewport.
      */
     reuseViewport?: boolean;
+    /**
+     * Indicates the index of the first masterbar which was modified in the data model.
+     * @remarks
+     * AlphaTab will try to optimize the rendering and other updates to keep unchanged parts.
+     * At this point only the rendering is affected and the generated MIDI has to be updated separately.
+     */
+    firstChangedMasterBar?: number;
 }
 
 export declare namespace rendering {
@@ -14379,7 +14355,6 @@ export declare class RenderingResources {
      * The default fonts for notation elements if not specified by the user.
      */
     static defaultFonts: Map<NotationElement, Font>;
-
     /**
      * The SMuFL Metrics to use for rendering music symbols.
      * @defaultValue `alphaTab`
@@ -14576,7 +14551,6 @@ export declare class RenderingResources {
      */
     scoreInfoColor: Color;
     constructor();
-
 }
 
 /**
@@ -14587,7 +14561,6 @@ export declare class RenderingResources {
  * @target web
  */
 declare interface RenderingResourcesJson {
-
     /**
      * The SMuFL Metrics to use for rendering music symbols.
      * @defaultValue `alphaTab`
@@ -15045,7 +15018,6 @@ declare class ScoreRenderer implements IScoreRenderer {
     canvas: ICanvas | null;
     score: Score | null;
     tracks: Track[] | null;
-
     settings: Settings;
     boundsLookup: BoundsLookup | null;
     width: number;
@@ -15234,7 +15206,6 @@ export declare class Settings {
      * @target web
      */
     fillFromJson(json: SettingsJson): void;
-
 }
 
 /**
@@ -15633,7 +15604,14 @@ declare class StaffSystemBounds {
      */
     boundsLookup: 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: boolean;
+    /**
+     * 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?: number): void;
     /**
@@ -16156,7 +16134,6 @@ declare class TremoloPickingEffect {
      * The style of the tremolo picking.
      */
     style: TremoloPickingStyle;
-
     /**
      * Gets the duration of a single tremolo note played in a beat of the given duration
      * based on the configured marks.
@@ -16450,7 +16427,6 @@ declare class Voice {
     private _isEmpty;
     private _isRestOnly;
     private static _globalVoiceId;
-
     /**
      * Gets or sets the unique id of this bar.
      */
@@ -16478,12 +16454,10 @@ declare class Voice {
      * The style customizations for this item.
      */
     style?: VoiceStyle;
-
     /**
      * Gets or sets a value indicating whether this voice is empty.
      */
     get isRestOnly(): boolean;
-
     insertBeat(after: Beat, newBeat: Beat): void;
     addBeat(beat: Beat): void;
     private _chain;