@coderline/alphatab-monaco 1.7.0-alpha.1626

package/dist/types/alphatab/src/generated/NotationSettingsJson.d.ts

@@ -0,0 +1,210 @@
+import { NotationMode } from "./../NotationSettings";
+import { FingeringMode } from "./../NotationSettings";
+import { NotationElement } from "./../NotationSettings";
+import { TabRhythmMode } from "./../NotationSettings";
+/**
+ * The notation settings control how various music notation elements are shown and behaving
+ * @json
+ * @json_declaration
+ * @public
+ * @target web
+ */
+export interface NotationSettingsJson {
+    /**
+     * The mode to use for display and play music notation elements.
+     * @since 0.9.6
+     * @category Notation
+     * @defaultValue `NotationMode.GuitarPro`
+     * @remarks
+     * AlphaTab provides 2 main music notation display modes `GuitarPro` and `SongBook`.
+     * As the names indicate they adjust the overall music notation rendering either to be more in line how [Arobas Guitar Pro](https://www.guitar-pro.com) displays it,
+     * or more like the common practice in paper song books practices the display.
+     *
+     * The main differences in the Songbook display mode are:
+     *
+     * 1. **Bends**
+     * For bends additional grace beats are introduced. Bends are categorized into gradual and fast bends.
+     *     * Gradual bends are indicated by beat text "grad" or "grad.". Bend will sound along the beat duration.
+     *     * Fast bends are done right before the next note. If the next note is tied even on-beat of the next note.
+     * 2.  **Whammy Bars**
+     * Dips are shown as simple annotation over the beats. Whammy Bars are categorized into gradual and fast.
+     *     * Gradual whammys are indicated by beat text "grad" or "grad.". Whammys will sound along the beat duration.
+     *     * Fast whammys are done right the beat.
+     *
+     * 3. **Let Ring**
+     * Tied notes with let ring are not shown in standard notation. Let ring does not cause a longer playback, duration is defined via tied notes.
+     *
+     * 4. **Settings**
+     * Following default setting values are applied:
+     * ```js
+     * {
+     *     notation: {
+     *         smallGraceTabNotes: false,
+     *         fingeringMode: alphaTab.FingeringMode.SingleNoteEffectBandm
+     *         extendBendArrowsOnTiedNotes: false
+     *     },
+     *     elements: {
+     *         parenthesisOnTiedBends: false,
+     *         tabNotesOnTiedBends: false,
+     *         zerosOnDiveWhammys: true
+     *     }
+     * }
+     * ```
+     */
+    notationMode?: NotationMode | keyof typeof NotationMode | Lowercase<keyof typeof NotationMode>;
+    /**
+     * The fingering mode to use.
+     * @since 0.9.6
+     * @category Notation
+     * @defaultValue `FingeringMode.ScoreDefault`
+     * @remarks
+     * AlphaTab supports multiple modes on how to display fingering information in the music sheet. This setting controls how they should be displayed. The default behavior is to show the finger information
+     * directly in the score along the notes. For some use cases of training courses and for beginners this notation might be hard to read. The effect band mode allows to show a single finger information above the staff.
+     *
+     * | Score                                                       | Effect Band                                                       |
+     * |-------------------------------------------------------------|-------------------------------------------------------------------|
+     * | ![Enabled](https://alphatab.net/img/reference/property/fingeringmode-score.png) | ![Disabled](https://alphatab.net/img/reference/property/fingeringmode-effectband.png) |
+     */
+    fingeringMode?: FingeringMode | keyof typeof FingeringMode | Lowercase<keyof typeof FingeringMode>;
+    /**
+     * Whether music notation elements are visible or not.
+     * @since 0.9.8
+     * @category Notation
+     * @defaultValue `[[NotationElement.ZerosOnDiveWhammys, false]]`
+     * @remarks
+     * AlphaTab has quite a set of notation elements that are usually shown by default or only shown when using
+     * the `SongBook` notation mode. This setting allows showing/hiding individual notation elements like the
+     * song information or the track names.
+     *
+     * For each element you can configure whether it is visible or not. The setting is a Map/Dictionary where
+     * the key is the element to configure and the value is a boolean value whether it should be visible or not.
+     * @example
+     * JavaScript
+     * Internally the setting is a [Map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map) where the key must be a {@link NotationElement} enumeration value.
+     * For JSON input the usual enumeration serialization applies where also the names can be used. The names
+     * are case insensitive.
+     *
+     * ```js
+     * const api = new alphaTab.AlphaTabApi(document.querySelector('#alphaTab'), {
+     *     notation: {
+     *         elements: {
+     *             scoreTitle: false,
+     *             trackNames: false
+     *         }
+     *     }
+     * });
+     * api.settings.notation.elements.set(alphaTab.NotationElement.EffectWhammyBar, false);
+     * ```
+     * @example
+     * C#
+     * ```cs
+     * var settings = new AlphaTab.Settings();
+     * settings.Notation.Elements[AlphaTab.NotationElement.ScoreTitle] = false;
+     * settings.Notation.Elements[AlphaTab.NotationElement.TrackNames] = false;
+     * ```
+     * @example
+     * Android
+     * ```kotlin
+     * val settings = AlphaTab.Settings();
+     * settings.notation.elements[alphaTab.NotationElement.ScoreTitle] = false;
+     * settings.notation.elements[alphaTab.NotationElement.TrackNames] = false;
+     * ```
+     */
+    elements?: Map<NotationElement | keyof typeof NotationElement | Lowercase<keyof typeof NotationElement>, boolean>;
+    /**
+     * Controls how the rhythm notation is rendered for tab staves.
+     * @since 0.9.6
+     * @category Notation
+     * @defaultValue `TabRhythmMode.Automatic`
+     * @remarks
+     * This setting enables the display of rhythm notation on tab staffs. [Demo](https://alphatab.net/docs/showcase/guitar-tabs)
+     * {@since 1.4.0} its automatically detected whether rhythm notation should be shown on tabs (based on the visibility of other staves).
+     */
+    rhythmMode?: TabRhythmMode | keyof typeof TabRhythmMode | Lowercase<keyof typeof TabRhythmMode>;
+    /**
+     * Controls how high the ryhthm notation is rendered below the tab staff
+     * @since 0.9.6
+     * @category Notation
+     * @defaultValue `15`
+     * @remarks
+     * This setting can be used in combination with the {@link rhythmMode} setting to control how high the rhythm notation should be rendered below the tab staff.
+     */
+    rhythmHeight?: number;
+    /**
+     * The transposition pitch offsets for the individual tracks used for rendering and playback.
+     * @since 0.9.6
+     * @category Notation
+     * @defaultValue `[]`
+     * @remarks
+     * This setting allows transposing of tracks for display and playback.
+     * The `transpositionPitches` setting allows defining an additional pitch offset per track, that is then considered when displaying the music sheet.
+     */
+    transpositionPitches?: number[];
+    /**
+     * The transposition pitch offsets for the individual tracks used for rendering only.
+     * @since 0.9.6
+     * @category Notation
+     * @defaultValue `[]`
+     * @remarks
+     * For some instruments the pitch shown on the standard notation has an additional transposition. One example is the Guitar.
+     * Notes are shown 1 octave higher than they are on the piano. The following image shows a C4 for a piano and a guitar, and a C5 for the piano as comparison:
+     *
+     * ![Display Transposition Pitches example](https://alphatab.net/img/reference/property/displaytranspositionpitches.png)
+     *
+     * The `DisplayTranspositionPitch` setting allows defining an additional pitch offset per track, that is then considered when displaying the music sheet.
+     * This setting does not affect the playback of the instrument in any way. Despite the 2 different standard notations in the above example, they both play the same note height.
+     * The transposition is defined as number of semitones and one value per track of the song can be defined.
+     */
+    displayTranspositionPitches?: number[];
+    /**
+     * If set to true the guitar tabs on grace beats are rendered smaller.
+     * @since 0.9.6
+     * @category Notation
+     * @defaultValue `true`
+     * @remarks
+     * By default, grace notes are drawn smaller on the guitar tabs than the other numbers. With this setting alphaTab can be configured to show grace tab notes with normal text size.
+     * | Enabled                                                            | Disabled                                                             |
+     * |--------------------------------------------------------------------|----------------------------------------------------------------------|
+     * | ![Enabled](https://alphatab.net/img/reference/property/smallgracetabnotes-enabled.png) | ![Disabled](https://alphatab.net/img/reference/property/smallgracetabnotes-disabled.png) |
+     */
+    smallGraceTabNotes?: boolean;
+    /**
+     * If set to true bend arrows expand to the end of the last tied note of the string. Otherwise they end on the next beat.
+     * @since 0.9.6
+     * @category Notation
+     * @defaultValue `true`
+     * @remarks
+     * By default the arrows and lines on bend effects are extended to the space of tied notes. This behavior is the Guitar Pro default but some applications and songbooks practice it different.
+     * There the bend only is drawn to the next beat.
+     * | Enabled                                                                     | Disabled                                                                      |
+     * |-----------------------------------------------------------------------------|-------------------------------------------------------------------------------|
+     * | ![Enabled](https://alphatab.net/img/reference/property/extendbendarrowsontiednotes-enabled.png) | ![Disabled](https://alphatab.net/img/reference/property/extendbendarrowsontiednotes-disabled.png) |
+     */
+    extendBendArrowsOnTiedNotes?: boolean;
+    /**
+     * If set to true, line effects like w/bar and let-ring are drawn until the end of the beat instead of the start
+     * @since 0.9.6
+     * @category Notation
+     * @defaultValue `false`
+     * @remarks
+     * By default effect annotations that render a line above the staff, stop on the beat. This is the typical display of Guitar Pro. In songbooks and some other tools
+     * these effects are drawn to the end of this beat.
+     * | Enabled                                                                     | Disabled                                                                      |
+     * |-----------------------------------------------------------------------------|-------------------------------------------------------------------------------|
+     * | ![Enabled](https://alphatab.net/img/reference/property/extendlineeffectstobeatend-enabled.png) | ![Disabled](https://alphatab.net/img/reference/property/extendlineeffectstobeatend-disabled.png) |
+     */
+    extendLineEffectsToBeatEnd?: boolean;
+    /**
+     * The height scale factor for slurs
+     * @since 0.9.6
+     * @category Notation
+     * @defaultValue `5`
+     * @remarks
+     * Slurs and ties currently calculate their height based on the distance they have from start to end note. Most music notation software do some complex collision detection to avoid a slur to overlap with other elements, alphaTab
+     * only has a simplified version of the slur positioning as of today. This setting allows adjusting the slur height to avoid collisions. The factor defined by this setting, is multiplied with the logarithmic distance between start and end.
+     * | Slur Height Default                                                    | Slur Height 14                                               |
+     * |------------------------------------------------------------------------|--------------------------------------------------------------|
+     * | ![Slur Height Default](https://alphatab.net/img/reference/property/slurheight-default.png) | ![Slur Height 14](https://alphatab.net/img/reference/property/slurheight-14.png)  |
+     */
+    slurHeight?: number;
+}

package/dist/types/alphatab/src/generated/NotationSettingsSerializer.d.ts

@@ -0,0 +1,9 @@
+import { NotationSettings } from "./../NotationSettings";
+/**
+ * @internal
+ */
+export declare class NotationSettingsSerializer {
+    static fromJson(obj: NotationSettings, m: unknown): void;
+    static toJson(obj: NotationSettings | null): Map<string, unknown> | null;
+    static setProperty(obj: NotationSettings, property: string, v: unknown): boolean;
+}

package/dist/types/alphatab/src/generated/PlayerSettingsJson.d.ts

@@ -0,0 +1,276 @@
+import { PlayerOutputMode } from "./../PlayerSettings";
+import { PlayerMode } from "./../PlayerSettings";
+import { ScrollMode } from "./../PlayerSettings";
+import { VibratoPlaybackSettingsJson } from "./VibratoPlaybackSettingsJson";
+import { SlidePlaybackSettingsJson } from "./SlidePlaybackSettingsJson";
+/**
+ * The player settings control how the audio playback and UI is behaving.
+ * @json
+ * @json_declaration
+ * @public
+ * @target web
+ */
+export interface PlayerSettingsJson {
+    /**
+     * The sound font file to load for the player.
+     * @target web
+     * @since 0.9.6
+     * @defaultValue `null`
+     * @category Player - JavaScript Specific
+     * @remarks
+     * When the player is enabled the soundfont from this URL will be loaded automatically after the player is ready.
+     */
+    soundFont?: string | null;
+    /**
+     * The element to apply the scrolling on.
+     * @target web
+     * @json_read_only
+     * @json_raw
+     * @since 0.9.6
+     * @defaultValue `html,body`
+     * @category Player - JavaScript Specific
+     * @remarks
+     * When the player is active, it by default automatically scrolls the browser window to the currently played bar. This setting
+     * defines which elements should be scrolled to bring the played bar into the view port. By default scrolling happens on the `html,body`
+     * selector.
+     */
+    scrollElement?: string | HTMLElement;
+    /**
+     * The mode used for playing audio samples
+     * @target web
+     * @since 1.3.0
+     * @defaultValue `PlayerOutputMode.WebAudioAudioWorklets`
+     * @category Player - JavaScript Specific
+     * @remarks
+     * Controls how alphaTab will play the audio samples in the browser.
+     */
+    outputMode?: PlayerOutputMode | keyof typeof PlayerOutputMode | Lowercase<keyof typeof PlayerOutputMode>;
+    /**
+     * Whether the player should be enabled.
+     * @since 0.9.6
+     * @defaultValue `false`
+     * @category Player
+     * @deprecated Use {@link playerMode} instead.
+     * @remarks
+     * This setting configures whether the player feature is enabled or not. Depending on the platform enabling the player needs some additional actions of the developer.
+     * For the JavaScript version the [player.soundFont](/docs/reference/settings/player/soundfont) property must be set to the URL of the sound font that should be used or it must be loaded manually via API.
+     * For .net manually the soundfont must be loaded.
+     *
+     * AlphaTab does not ship a default UI for the player. The API must be hooked up to some UI controls to allow the user to interact with the player.
+     */
+    enablePlayer?: boolean;
+    /**
+     * Whether the player should be enabled and which mode it should use.
+     * @since 1.6.0
+     * @defaultValue `PlayerMode.Disabled`
+     * @category Player
+     * @remarks
+     * This setting configures whether the player feature is enabled or not. Depending on the platform enabling the player needs some additional actions of the developer.
+     *
+     * **Synthesizer**
+     *
+     * If the synthesizer is used (via {@link PlayerMode.EnabledAutomatic} or {@link PlayerMode.EnabledSynthesizer}) a sound font is needed so that the midi synthesizer can produce the audio samples.
+     *
+     * For the JavaScript version the [player.soundFont](/docs/reference/settings/player/soundfont) property must be set to the URL of the sound font that should be used or it must be loaded manually via API.
+     * For .net manually the soundfont must be loaded.
+     *
+     * **Backing Track**
+     *
+     * For a built-in backing track of the input file no additional data needs to be loaded (assuming everything is filled via the input file).
+     * Otherwise the `score.backingTrack` needs to be filled before loading and the related sync points need to be configured.
+     *
+     * **External Media**
+     *
+     * For synchronizing alphaTab with an external media no data needs to be loaded into alphaTab. The configured sync points on the MasterBars are used
+     * as reference to synchronize the external media with the internal time axis. Then the related APIs on the AlphaTabApi object need to be used
+     * to update the playback state and exterrnal audio position during playback.
+     *
+     * **User Interface**
+     *
+     * AlphaTab does not ship a default UI for the player. The API must be hooked up to some UI controls to allow the user to interact with the player.
+     */
+    playerMode?: PlayerMode | keyof typeof PlayerMode | Lowercase<keyof typeof PlayerMode>;
+    /**
+     * Whether playback cursors should be displayed.
+     * @since 0.9.6
+     * @defaultValue `true` (if player is not disabled)
+     * @category Player
+     * @remarks
+     * This setting configures whether the playback cursors are shown or not. In case a developer decides to built an own cursor system the default one can be disabled with this setting. Enabling the cursor also requires the player to be active.
+     */
+    enableCursor?: boolean;
+    /**
+     * Whether the beat cursor should be animated or just ticking.
+     * @since 1.2.3
+     * @defaultValue `true`
+     * @category Player
+     * @remarks
+     * This setting configures whether the beat cursor is animated smoothly or whether it is ticking from beat to beat.
+     * The animation of the cursor might not be available on all targets so it might not have any effect.
+     */
+    enableAnimatedBeatCursor?: boolean;
+    /**
+     * Whether the notation elements of the currently played beat should be highlighted.
+     * @since 1.2.3
+     * @defaultValue `true`
+     * @category Player
+     * @remarks
+     * This setting configures whether the note elements are highlighted during playback.
+     * The highlighting of elements might not be available on all targets and render engine, so it might not have any effect.
+     */
+    enableElementHighlighting?: boolean;
+    /**
+     * Whether the default user interaction behavior should be active or not.
+     * @since 0.9.7
+     * @defaultValue `true`
+     * @category Player
+     * @remarks
+     * This setting configures whether alphaTab provides the default user interaction features like selection of the playback range and "seek on click".
+     * By default users can select the desired playback range with the mouse and also jump to individual beats by click. This behavior can be contolled with this setting.
+     */
+    enableUserInteraction?: boolean;
+    /**
+     * The X-offset to add when scrolling.
+     * @since 0.9.6
+     * @defaultValue `0`
+     * @category Player
+     * @remarks
+     * When alphaTab does an auto-scrolling to the displayed bar, it will try to align the view port to the displayed bar. If due to
+     * some layout specifics or for aesthetics a small padding is needed, this setting allows an additional X-offset that is added to the
+     * scroll position.
+     */
+    scrollOffsetX?: number;
+    /**
+     * The Y-offset to add when scrolling.
+     * @since 0.9.6
+     * @defaultValue `0`
+     * @category Player
+     * @remarks
+     * When alphaTab does an auto-scrolling to the displayed bar, it will try to align the view port to the displayed bar. If due to
+     * some layout specifics or for aesthetics a small padding is needed, this setting allows an additional Y-offset that is added to the
+     * scroll position.
+     */
+    scrollOffsetY?: number;
+    /**
+     * The mode how to scroll.
+     * @since 0.9.6
+     * @defaultValue `ScrollMode.Continuous`
+     * @category Player
+     * @remarks
+     * This setting controls how alphaTab behaves for scrolling.
+     */
+    scrollMode?: ScrollMode | keyof typeof ScrollMode | Lowercase<keyof typeof ScrollMode>;
+    /**
+     * How fast the scrolling to the new position should happen.
+     * @since 0.9.6
+     * @defaultValue `300`
+     * @category Player
+     * @remarks
+     * If possible from the platform, alphaTab will try to do a smooth scrolling to the played bar.
+     * This setting defines the speed of scrolling in milliseconds.
+     * Note that {@link nativeBrowserSmoothScroll} must be set to `false` for this to have an effect.
+     */
+    scrollSpeed?: number;
+    /**
+     * Whether the native browser smooth scroll mechanism should be used over a custom animation.
+     * @target web
+     * @since 1.2.3
+     * @defaultValue `true`
+     * @category Player
+     * @remarks
+     * This setting configures whether the [native browser feature](https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollTo)
+     * for smooth scrolling should be used over a custom animation.
+     * If this setting is enabled, options like {@link scrollSpeed} will not have an effect anymore.
+     */
+    nativeBrowserSmoothScroll?: boolean;
+    /**
+     * The bend duration in milliseconds for songbook bends.
+     * @since 0.9.6
+     * @defaultValue `75`
+     * @category Player
+     * @remarks
+     * If the display mode `songbook` is enabled, this has an effect on the way bends are played. For songbook bends the bend is done very quickly at the end or start of the beat.
+     * This setting defines the play duration for those bends in milliseconds. This duration is in milliseconds unlike some other settings which are in midi ticks. The reason is that on songbook bends,
+     * the bends should always be played in the same speed, regardless of the song tempo. Midi ticks are tempo dependent.
+     */
+    songBookBendDuration?: number;
+    /**
+     * The duration of whammy dips in milliseconds for songbook whammys.
+     * @since 0.9.6
+     * @defaultValue `150`
+     * @category Player
+     * @remarks
+     * If the display mode `songbook` is enabled, this has an effect on the way whammy dips are played. For songbook dips the whammy is pressed very quickly at the start of the beat.
+     * This setting defines the play duration for those whammy bars in milliseconds. This duration is in milliseconds unlike some other settings which are in midi ticks. The reason is that on songbook dips,
+     * the whammy should always be pressed in the same speed, regardless of the song tempo. Midi ticks are tempo dependent.
+     */
+    songBookDipDuration?: number;
+    /**
+     * The Vibrato settings allow control how the different vibrato types are generated for audio.
+     * @json_partial_names
+     * @since 0.9.6
+     * @category Player
+     * @remarks
+     * AlphaTab supports 4 types of vibratos, for each vibrato the amplitude and the wavelength can be configured. The amplitude controls how many semitones
+     * the vibrato changes the pitch up and down while playback. The wavelength controls how many midi ticks it will take to complete one up and down vibrato.
+     * The 4 vibrato types are:
+     *
+     * 1. Beat Slight - A fast vibrato on the whole beat. This vibrato is usually done with the whammy bar.
+     * 2. Beat Wide - A slow vibrato on the whole beat. This vibrato is usually done with the whammy bar.
+     * 3. Note Slight - A fast vibrato on a single note. This vibrato is usually done with the finger on the fretboard.
+     * 4. Note Wide - A slow vibrato on a single note. This vibrato is usually done with the finger on the fretboard.
+     */
+    vibrato?: VibratoPlaybackSettingsJson;
+    /**
+     * The slide settings allow control how the different slide types are generated for audio.
+     * @json_partial_names
+     * @since 0.9.6
+     * @domWildcard
+     * @category Player
+     * @remarks
+     * AlphaTab supports various types of slides which can be grouped into 3 types:
+     *
+     * * Shift Slides
+     * * Legato Slides
+     *
+     *
+     * * Slide into from below
+     * * Slide into from above
+     * * Slide out to below
+     * * Slide out to above
+     *
+     *
+     * * Pick Slide out to above
+     * * Pick Slide out to below
+     *
+     * For the first 2 groups the audio generation can be adapted. For the pick slide the audio generation cannot be adapted
+     * as there is no mechanism yet in alphaTab to play pick slides to make them sound real.
+     *
+     * For the first group only the duration or start point of the slide can be configured while for the second group
+     * the duration/start-point and the pitch offset can be configured.
+     */
+    slide?: SlidePlaybackSettingsJson;
+    /**
+     * Whether the triplet feel should be played or only displayed.
+     * @since 0.9.6
+     * @defaultValue `true`
+     * @category Player
+     * @remarks
+     * If this setting is enabled alphaTab will play the triplet feels accordingly, if it is disabled the triplet feel is only displayed but not played.
+     */
+    playTripletFeel?: boolean;
+    /**
+     * The number of milliseconds the player should buffer.
+     * @since 1.2.3
+     * @defaultValue `500`
+     * @category Player
+     * @remarks
+     * Gets or sets how many milliseconds of audio samples should be buffered in total.
+     *
+     * * Larger buffers cause a delay from when audio settings like volumes will be applied.
+     * * Smaller buffers can cause audio crackling due to constant buffering that is happening.
+     *
+     * This buffer size can be changed whenever needed.
+     */
+    bufferTimeInMilliseconds?: number;
+}

package/dist/types/alphatab/src/generated/PlayerSettingsSerializer.d.ts

@@ -0,0 +1,9 @@
+import { PlayerSettings } from "./../PlayerSettings";
+/**
+ * @internal
+ */
+export declare class PlayerSettingsSerializer {
+    static fromJson(obj: PlayerSettings, m: unknown): void;
+    static toJson(obj: PlayerSettings | null): Map<string, unknown> | null;
+    static setProperty(obj: PlayerSettings, property: string, v: unknown): boolean;
+}

package/dist/types/alphatab/src/generated/RenderingResourcesJson.d.ts

@@ -0,0 +1,168 @@
+import { EngravingSettingsJson } from "./EngravingSettingsJson";
+import { FontJson } from "./../model/Font";
+import { ColorJson } from "./../model/Color";
+/**
+ * This public class contains central definitions for controlling the visual appearance.
+ * @json
+ * @json_declaration
+ * @public
+ * @target web
+ */
+export interface RenderingResourcesJson {
+    /**
+     * The name of the SMuFL Font to use for rendering music symbols.
+     *
+     * @remarks
+     * If this family name is provided, alphaTab will not load any custom font, but expects
+     * this font to be available in your environment (loadad as webfont or registered in alphaSkia).
+     *
+     * When using alphaTab in a browser environment it is rather recommended to specify the web font
+     * via the `smuflFontSources` on the `CoreSettings`and skipping this setting.
+     *
+     * You will also need to fill {@link engravingSettings} to match this font.
+     *
+     * @since 1.7.0
+     * @internal
+     */
+    smuflFontFamilyName?: string;
+    /**
+     * The SMuFL Metrics to use for rendering music symbols.
+     * @defaultValue `alphaTab`
+     * @since 1.7.0
+     */
+    engravingSettings?: EngravingSettingsJson;
+    /**
+     * The font to use for displaying the songs copyright information in the header of the music sheet.
+     * @defaultValue `bold 12px Arial, sans-serif`
+     * @since 0.9.6
+     */
+    copyrightFont?: FontJson;
+    /**
+     * The font to use for displaying the songs title in the header of the music sheet.
+     * @defaultValue `32px Georgia, serif`
+     * @since 0.9.6
+     */
+    titleFont?: FontJson;
+    /**
+     * The font to use for displaying the songs subtitle in the header of the music sheet.
+     * @defaultValue `20px Georgia, serif`
+     * @since 0.9.6
+     */
+    subTitleFont?: FontJson;
+    /**
+     * The font to use for displaying the lyrics information in the header of the music sheet.
+     * @defaultValue `15px Arial, sans-serif`
+     * @since 0.9.6
+     */
+    wordsFont?: FontJson;
+    /**
+     * The font to use for displaying certain effect related elements in the music sheet.
+     * @defaultValue `italic 12px Georgia, serif`
+     * @since 0.9.6
+     */
+    effectFont?: FontJson;
+    /**
+     * The font to use for displaying beat time information in the music sheet.
+     * @defaultValue `12px Georgia, serif`
+     * @since 1.4.0
+     */
+    timerFont?: FontJson;
+    /**
+     * The font to use for displaying the directions texts.
+     * @defaultValue `14px Georgia, serif`
+     * @since 1.4.0
+     */
+    directionsFont?: FontJson;
+    /**
+     * The font to use for displaying the fretboard numbers in chord diagrams.
+     * @defaultValue `11px Arial, sans-serif`
+     * @since 0.9.6
+     */
+    fretboardNumberFont?: FontJson;
+    /**
+     * The font to use for displaying the numbered music notation in the music sheet.
+     * @defaultValue `14px Arial, sans-serif`
+     * @since 1.4.0
+     */
+    numberedNotationFont?: FontJson;
+    /**
+     * The font to use for displaying the grace notes in numbered music notation in the music sheet.
+     * @defaultValue `16px Arial, sans-serif`
+     * @since 1.4.0
+     */
+    numberedNotationGraceFont?: FontJson;
+    /**
+     * The font to use for displaying the guitar tablature numbers in the music sheet.
+     * @defaultValue `13px Arial, sans-serif`
+     * @since 0.9.6
+     */
+    tablatureFont?: FontJson;
+    /**
+     * The font to use for grace notation related texts in the music sheet.
+     * @defaultValue `11px Arial, sans-serif`
+     * @since 0.9.6
+     */
+    graceFont?: FontJson;
+    /**
+     * The color to use for rendering the lines of staves.
+     * @defaultValue `rgb(165, 165, 165)`
+     * @since 0.9.6
+     */
+    staffLineColor?: ColorJson;
+    /**
+     * The color to use for rendering bar separators, the accolade and repeat signs.
+     * @defaultValue `rgb(34, 34, 17)`
+     * @since 0.9.6
+     */
+    barSeparatorColor?: ColorJson;
+    /**
+     * The font to use for displaying the bar numbers above the music sheet.
+     * @defaultValue `11px Arial, sans-serif`
+     * @since 0.9.6
+     */
+    barNumberFont?: FontJson;
+    /**
+     * The color to use for displaying the bar numbers above the music sheet.
+     * @defaultValue `rgb(200, 0, 0)`
+     * @since 0.9.6
+     */
+    barNumberColor?: ColorJson;
+    /**
+     * The font to use for displaying finger information in the music sheet.
+     * @defaultValue `14px Georgia, serif`
+     * @since 0.9.6
+     * @deprecated Since 1.7.0 alphaTab uses the glyphs contained in the SMuFL font
+     */
+    fingeringFont?: FontJson;
+    /**
+     * The font to use for displaying finger information when inline into the music sheet.
+     * @defaultValue `12px Georgia, serif`
+     * @since 1.4.0
+     * @deprecated Since 1.7.0 alphaTab uses the glyphs contained in the SMuFL font
+     */
+    inlineFingeringFont?: FontJson;
+    /**
+     * The font to use for section marker labels shown above the music sheet.
+     * @defaultValue `bold 14px Georgia, serif`
+     * @since 0.9.6
+     */
+    markerFont?: FontJson;
+    /**
+     * The color to use for music notation elements of the primary voice.
+     * @defaultValue `rgb(0, 0, 0)`
+     * @since 0.9.6
+     */
+    mainGlyphColor?: ColorJson;
+    /**
+     * The color to use for music notation elements of the secondary voices.
+     * @defaultValue `rgb(0,0,0,0.4)`
+     * @since 0.9.6
+     */
+    secondaryGlyphColor?: ColorJson;
+    /**
+     * The color to use for displaying the song information above the music sheets.
+     * @defaultValue `rgb(0, 0, 0)`
+     * @since 0.9.6
+     */
+    scoreInfoColor?: ColorJson;
+}