@coderline/alphatab 1.9.0-alpha.1806 → 1.9.0-alpha.1848

package/dist/alphaTab.d.ts

@@ -4503,10 +4503,31 @@ declare class Bar {
      */
     keySignatureType: KeySignatureType;
     /**
-     * How bar numbers should be displayed.
-     * If specified, overrides the value from the stylesheet on score level.
+     * How bar numbers should be displayed on this specific bar.
+     * @deprecated Use {@link scoreDisplay}, {@link tabDisplay},
+     * {@link slashDisplay}, or {@link numberedDisplay} `.barNumber` for
+     * per-staff-type per-bar control. The setter broadcasts the value
+     * to all four override bags (lazy-creating each); on `undefined`
+     * it clears `.barNumber` on each existing bag without removing it.
      */
-    barNumberDisplay?: BarNumberDisplay;
+    get barNumberDisplay(): BarNumberDisplay | undefined;
+    set barNumberDisplay(value: BarNumberDisplay | undefined);
+    /**
+     * Per-bar override for the standard-notation staff's display.
+     */
+    scoreDisplay?: ScoreBarOverride;
+    /**
+     * Per-bar override for the tablature staff's display.
+     */
+    tabDisplay?: TabBarOverride;
+    /**
+     * Per-bar override for the slash staff's display.
+     */
+    slashDisplay?: SlashBarOverride;
+    /**
+     * Per-bar override for the numbered (jianpu) staff's display.
+     */
+    numberedDisplay?: NumberedBarOverride;
     /**
      * 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.
@@ -4909,6 +4930,7 @@ declare class Beat {
     /**
      * Gets a value indicating whether this beat is fade-in.
      * @deprecated Use `fade`
+     * @json_read_only
      */
     get fadeIn(): boolean;
     /**
@@ -5044,6 +5066,7 @@ declare class Beat {
     /**
      * The speed of the tremolo.
      * @deprecated Set {@link tremoloPicking} instead.
+     * @json_read_only
      */
     get tremoloSpeed(): Duration | null;
     /**
@@ -6415,6 +6438,34 @@ export declare class DisplaySettings {
      * | ![Default](https://alphatab.net/img/reference/property/stretchforce-default.png) | ![0.5](https://alphatab.net/img/reference/property/stretchforce-half.png) |
      */
     stretchForce: number;
+    /**
+     * The proportional spacing ratio between successive note durations.
+     * @since 1.9.0
+     * @category Display
+     * @defaultValue `Math.SQRT2` (≈ 1.414, matches Dorico's default)
+     * @remarks
+     * Controls the *shape* of the horizontal spacing curve - how much wider a note of duration `2d` is rendered relative to a note of duration `d`.
+     * AlphaTab uses a power-law spacing model (the same approach used by Dorico, MuseScore and Finale): doubling the note duration multiplies its
+     * allocated horizontal space by `spacingRatio`.
+     *
+     * Reference values for cross-application comparison:
+     *
+     * | Application / Style        | Ratio                | Character                          |
+     * |----------------------------|----------------------|------------------------------------|
+     * | Dorico default             | √2 ≈ 1.414           | Tight, efficient, orchestral       |
+     * | MuseScore default          | 1.5                  | Balanced, general-purpose          |
+     * | Finale default (Fibonacci) | φ ≈ 1.618            | Loose, traditional engraving       |
+     *
+     * AlphaTab defaults to `√2` (Dorico's value). This produces tighter spacing at long
+     * durations than the alternatives, which matters for guitar tablature where rest bars and
+     * whole notes are common - looser ratios make those bars dominate system width.
+     *
+     * This setting is orthogonal to {@link stretchForce}: `spacingRatio` controls the *shape* of the spacing (proportions between durations),
+     * `stretchForce` controls the overall *density* (how tightly or loosely the music is packed). Both can be adjusted independently.
+     *
+     * Values are clamped to the range `[1.2, 2.0]`. A value of `1.0` would produce equal spacing for all durations and is rejected.
+     */
+    spacingRatio: number;
     /**
      * The layouting mode used to arrange the the notation.
      * @remarks
@@ -6480,19 +6531,60 @@ export declare class DisplaySettings {
      * setting controls how many bars are placed within such a partial.
      */
     barCountPerPartial: number;
+    /**
+     * The minimum fullness ratio at which the last system in a flow is justified to fill the
+     * available staff width.
+     * @since 1.9.0
+     * @category Display
+     * @defaultValue `1`
+     * @remarks
+     * The "fullness" of a system is its natural unjustified width divided by the available
+     * staff width. The last system is stretched to full width only when its fullness is
+     * **greater than or equal to** this threshold; otherwise it renders at its natural width.
+     *
+     * Following industry convention (Dorico, MuseScore), a sparsely populated final system
+     * looks better compact than spread across the full page. The threshold lets users tune
+     * where that boundary sits.
+     *
+     * Common values:
+     *
+     * - `1` (default) — never justify the last system. Equivalent to the legacy
+     *   `justifyLastSystem = false` behaviour.
+     * - `0` — always justify the last system, even when sparse. Equivalent to the legacy
+     *   `justifyLastSystem = true` behaviour.
+     * - `0.4`–`0.7` — Dorico/MuseScore-style: justify when the last system is reasonably full,
+     *   leave compact when only a few bars trail.
+     *
+     * The threshold is bypassed when the last system is naturally wider than the available
+     * staff width - in that case the system still compresses to fit, since otherwise content
+     * would overflow horizontally.
+     *
+     * Values outside `[0, 1]` are clamped.
+     */
+    lastSystemFillThreshold: number;
     /**
      * Whether to justify also the last system in page layouts.
+     *
      * @remarks
-     * Setting this option to `true` tells alphaTab to also justify the last system (row) like it
-     * already does for the systems which are full.
+     * @deprecated Use {@link lastSystemFillThreshold} for fine-grained control over when the
+     * last system is justified. This property is now a thin wrapper:
+     *
+     * - **Get** returns `true` when {@link lastSystemFillThreshold} is less than `1` (i.e. some
+     *   degree of last-system justification is enabled), `false` otherwise.
+     * - **Set** to `true` writes `lastSystemFillThreshold = 0` (always justify regardless of
+     *   fullness). Set to `false` writes `lastSystemFillThreshold = 1` (never justify).
+     *
      * | Justification Disabled                                       | Justification Enabled                                |
      * |--------------------------------------------------------------|-------------------------------------------------------|
      * | ![Disabled](https://alphatab.net/img/reference/property/justify-last-system-false.png) | ![Enabled](https://alphatab.net/img/reference/property/justify-last-system-true.png) |
+     *
      * @since 1.3.0
      * @category Display
      * @defaultValue `false`
+     * @json_read_only
      */
-    justifyLastSystem: boolean;
+    get justifyLastSystem(): boolean;
+    set justifyLastSystem(value: boolean);
     /**
      * Allows adjusting of the used fonts and colors for rendering.
      * @json_partial_names
@@ -6655,10 +6747,14 @@ export declare class DisplaySettings {
      */
     staffPaddingLeft: number;
     /**
-     * The padding between individual effect bands.
+     * Clearance applied around each effect band on its staff-facing side:
+     * "bottom padding" for top bands (between the band and the staff or
+     * the band stacked below it) and "top padding" for bottom bands
+     * (mirrored). Also used as the inter-band gap when bands stack on
+     * the same side.
      * @since 1.7.0
      * @category Display
-     * @defaultValue `2`
+     * @defaultValue `5`
      */
     effectBandPaddingBottom: number;
     /**
@@ -6781,6 +6877,34 @@ declare interface DisplaySettingsJson {
      * | ![Default](https://alphatab.net/img/reference/property/stretchforce-default.png) | ![0.5](https://alphatab.net/img/reference/property/stretchforce-half.png) |
      */
     stretchForce?: number;
+    /**
+     * The proportional spacing ratio between successive note durations.
+     * @since 1.9.0
+     * @category Display
+     * @defaultValue `Math.SQRT2` (≈ 1.414, matches Dorico's default)
+     * @remarks
+     * Controls the *shape* of the horizontal spacing curve - how much wider a note of duration `2d` is rendered relative to a note of duration `d`.
+     * AlphaTab uses a power-law spacing model (the same approach used by Dorico, MuseScore and Finale): doubling the note duration multiplies its
+     * allocated horizontal space by `spacingRatio`.
+     *
+     * Reference values for cross-application comparison:
+     *
+     * | Application / Style        | Ratio                | Character                          |
+     * |----------------------------|----------------------|------------------------------------|
+     * | Dorico default             | √2 ≈ 1.414           | Tight, efficient, orchestral       |
+     * | MuseScore default          | 1.5                  | Balanced, general-purpose          |
+     * | Finale default (Fibonacci) | φ ≈ 1.618            | Loose, traditional engraving       |
+     *
+     * AlphaTab defaults to `√2` (Dorico's value). This produces tighter spacing at long
+     * durations than the alternatives, which matters for guitar tablature where rest bars and
+     * whole notes are common - looser ratios make those bars dominate system width.
+     *
+     * This setting is orthogonal to {@link stretchForce}: `spacingRatio` controls the *shape* of the spacing (proportions between durations),
+     * `stretchForce` controls the overall *density* (how tightly or loosely the music is packed). Both can be adjusted independently.
+     *
+     * Values are clamped to the range `[1.2, 2.0]`. A value of `1.0` would produce equal spacing for all durations and is rejected.
+     */
+    spacingRatio?: number;
     /**
      * The layouting mode used to arrange the the notation.
      * @remarks
@@ -6846,17 +6970,57 @@ declare interface DisplaySettingsJson {
      * setting controls how many bars are placed within such a partial.
      */
     barCountPerPartial?: number;
+    /**
+     * The minimum fullness ratio at which the last system in a flow is justified to fill the
+     * available staff width.
+     * @since 1.9.0
+     * @category Display
+     * @defaultValue `1`
+     * @remarks
+     * The "fullness" of a system is its natural unjustified width divided by the available
+     * staff width. The last system is stretched to full width only when its fullness is
+     * **greater than or equal to** this threshold; otherwise it renders at its natural width.
+     *
+     * Following industry convention (Dorico, MuseScore), a sparsely populated final system
+     * looks better compact than spread across the full page. The threshold lets users tune
+     * where that boundary sits.
+     *
+     * Common values:
+     *
+     * - `1` (default) — never justify the last system. Equivalent to the legacy
+     *   `justifyLastSystem = false` behaviour.
+     * - `0` — always justify the last system, even when sparse. Equivalent to the legacy
+     *   `justifyLastSystem = true` behaviour.
+     * - `0.4`–`0.7` — Dorico/MuseScore-style: justify when the last system is reasonably full,
+     *   leave compact when only a few bars trail.
+     *
+     * The threshold is bypassed when the last system is naturally wider than the available
+     * staff width - in that case the system still compresses to fit, since otherwise content
+     * would overflow horizontally.
+     *
+     * Values outside `[0, 1]` are clamped.
+     */
+    lastSystemFillThreshold?: number;
     /**
      * Whether to justify also the last system in page layouts.
+     *
      * @remarks
-     * Setting this option to `true` tells alphaTab to also justify the last system (row) like it
-     * already does for the systems which are full.
+     * @deprecated Use {@link lastSystemFillThreshold} for fine-grained control over when the
+     * last system is justified. This property is now a thin wrapper:
+     *
+     * - **Get** returns `true` when {@link lastSystemFillThreshold} is less than `1` (i.e. some
+     *   degree of last-system justification is enabled), `false` otherwise.
+     * - **Set** to `true` writes `lastSystemFillThreshold = 0` (always justify regardless of
+     *   fullness). Set to `false` writes `lastSystemFillThreshold = 1` (never justify).
+     *
      * | Justification Disabled                                       | Justification Enabled                                |
      * |--------------------------------------------------------------|-------------------------------------------------------|
      * | ![Disabled](https://alphatab.net/img/reference/property/justify-last-system-false.png) | ![Enabled](https://alphatab.net/img/reference/property/justify-last-system-true.png) |
+     *
      * @since 1.3.0
      * @category Display
      * @defaultValue `false`
+     * @json_read_only
      */
     justifyLastSystem?: boolean;
     /**
@@ -7021,10 +7185,14 @@ declare interface DisplaySettingsJson {
      */
     staffPaddingLeft?: number;
     /**
-     * The padding between individual effect bands.
+     * Clearance applied around each effect band on its staff-facing side:
+     * "bottom padding" for top bands (between the band and the staff or
+     * the band stacked below it) and "top padding" for bottom bands
+     * (mirrored). Also used as the inter-band gap when bands stack on
+     * the same side.
      * @since 1.7.0
      * @category Display
-     * @defaultValue `2`
+     * @defaultValue `5`
      */
     effectBandPaddingBottom?: number;
     /**
@@ -7259,6 +7427,34 @@ declare enum DynamicValue {
     SFZP = 25
 }
 
+/**
+ * Per-axis visibility / placement / system-display selector for an
+ * element on a staff type. Used as the value type for the clef,
+ * key signature, time signature, and rests entries on the per-staff-type
+ * configuration carriers.
+ *
+ * Each axis is independently optional. An `undefined` axis defers to
+ * the outer layer in the three-layer resolution chain (per-bar →
+ * per-staff → score-wide stylesheet).
+ * @record
+ * @json
+ * @public
+ */
+declare interface ElementDisplay {
+    /**
+     * Whether to paint the element at all.
+     */
+    isVisible?: boolean;
+    /**
+     * Spatial selector across the staves of a system.
+     */
+    staffPlacement?: StaffPlacement;
+    /**
+     * Temporal selector across the systems of the score.
+     */
+    systemDisplay?: SystemDisplay;
+}
+
 /**
  * Defines the custom styles for an element in the music sheet (like bars, voices, notes etc).
  * @public
@@ -10743,6 +10939,7 @@ declare class MasterBar {
     /**
      * The key signature used on all bars.
      * @deprecated Use key signatures on bar level
+     * @json_read_only
      */
     get keySignature(): KeySignature;
     /**
@@ -10753,6 +10950,7 @@ declare class MasterBar {
     /**
      * The type of key signature (major/minor)
      * @deprecated Use key signatures on bar level
+     * @json_read_only
      */
     get keySignatureType(): KeySignatureType;
     /**
@@ -11735,7 +11933,18 @@ export declare namespace model {
         WahPedal,
         WhammyType,
         ElementStyle,
-        BackingTrack
+        BackingTrack,
+        StaffPlacement,
+        SystemDisplay,
+        ElementDisplay,
+        ScoreStaffConfig,
+        TabStaffConfig,
+        SlashStaffConfig,
+        NumberedStaffConfig,
+        ScoreBarOverride,
+        TabBarOverride,
+        SlashBarOverride,
+        NumberedBarOverride
     }
 }
 
@@ -13351,6 +13560,30 @@ declare enum NoteSubElement {
     NumberedEffects = 10
 }
 
+/**
+ * Per-bar override for the numbered (jianpu) staff's display.
+ * @record
+ * @json
+ * @public
+ */
+declare interface NumberedBarOverride {
+    timeSignature?: ElementDisplay;
+    barNumber?: BarNumberDisplay;
+}
+
+/**
+ * Per-staff-type display configuration for the numbered (jianpu) staff.
+ * The "1=X" key designation is rendered as an above-staff effect-band
+ * label, not a header glyph, so this config has no `keySignature` field.
+ * @record
+ * @json
+ * @public
+ */
+declare interface NumberedStaffConfig {
+    timeSignature?: ElementDisplay;
+    barNumber?: BarNumberDisplay;
+}
+
 /**
  * Lists all ottavia.
  * @public
@@ -14420,6 +14653,7 @@ export declare class RenderingResources {
      * @defaultValue `bold 12px Arial, sans-serif`
      * @since 0.9.6
      * @deprecated use {@link elementFonts} with {@link NotationElement.ScoreCopyright}
+     * @json_read_only
      */
     get copyrightFont(): Font;
     /**
@@ -14431,6 +14665,7 @@ export declare class RenderingResources {
      * @defaultValue `32px Georgia, serif`
      * @since 0.9.6
      * @deprecated use {@link elementFonts} with {@link NotationElement.ScoreTitle}
+     * @json_read_only
      */
     get titleFont(): Font;
     /**
@@ -14442,6 +14677,7 @@ export declare class RenderingResources {
      * @defaultValue `20px Georgia, serif`
      * @since 0.9.6
      * @deprecated use {@link elementFonts} with {@link NotationElement.ScoreSubTitle}
+     * @json_read_only
      */
     get subTitleFont(): Font;
     /**
@@ -14453,6 +14689,7 @@ export declare class RenderingResources {
      * @defaultValue `15px Arial, sans-serif`
      * @since 0.9.6
      * @deprecated use {@link elementFonts} with {@link NotationElement.ScoreWords}
+     * @json_read_only
      */
     get wordsFont(): Font;
     /**
@@ -14464,6 +14701,7 @@ export declare class RenderingResources {
      * @defaultValue `12px Georgia, serif`
      * @since 1.4.0
      * @deprecated use {@link elementFonts} with {@link NotationElement.EffectBeatTimer}
+     * @json_read_only
      */
     get timerFont(): Font;
     /**
@@ -14475,6 +14713,7 @@ export declare class RenderingResources {
      * @defaultValue `14px Georgia, serif`
      * @since 1.4.0
      * @deprecated use {@link elementFonts} with {@link NotationElement.EffectDirections}
+     * @json_read_only
      */
     get directionsFont(): Font;
     /**
@@ -14486,6 +14725,7 @@ export declare class RenderingResources {
      * @defaultValue `11px Arial, sans-serif`
      * @since 0.9.6
      * @deprecated use {@link elementFonts} with {@link NotationElement.ChordDiagramFretboardNumbers}
+     * @json_read_only
      */
     get fretboardNumberFont(): Font;
     /**
@@ -14513,6 +14753,7 @@ export declare class RenderingResources {
      * @defaultValue `bold 14px Georgia, serif`
      * @since 0.9.6
      * @deprecated use {@link elementFonts} with {@link NotationElement.EffectMarker}
+     * @json_read_only
      */
     get markerFont(): Font;
     /**
@@ -14532,6 +14773,7 @@ export declare class RenderingResources {
      * @defaultValue `11px Arial, sans-serif`
      * @since 0.9.6
      * @deprecated use {@link elementFonts} with {@link NotationElement.BarNumber}
+     * @json_read_only
      */
     get barNumberFont(): Font;
     /**
@@ -14622,29 +14864,77 @@ declare interface RenderingResourcesJson {
      */
     engravingSettings?: EngravingSettingsJson;
     /**
-     * Unused, see deprecation note.
-     * @defaultValue `14px Georgia, serif`
+     * 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
-     * @deprecated Since 1.7.0 alphaTab uses the glyphs contained in the SMuFL font
-     * @json_ignore
+     * @deprecated use {@link elementFonts} with {@link NotationElement.ScoreCopyright}
+     * @json_read_only
      */
-    fingeringFont?: FontJson;
+    copyrightFont?: FontJson;
     /**
-     * Unused, see deprecation note.
+     * The font to use for displaying the songs title in the header of the music sheet.
+     * @defaultValue `32px Georgia, serif`
+     * @since 0.9.6
+     * @deprecated use {@link elementFonts} with {@link NotationElement.ScoreTitle}
+     * @json_read_only
+     */
+    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
+     * @deprecated use {@link elementFonts} with {@link NotationElement.ScoreSubTitle}
+     * @json_read_only
+     */
+    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
+     * @deprecated use {@link elementFonts} with {@link NotationElement.ScoreWords}
+     * @json_read_only
+     */
+    wordsFont?: FontJson;
+    /**
+     * The font to use for displaying beat time information in 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
-     * @json_ignore
+     * @deprecated use {@link elementFonts} with {@link NotationElement.EffectBeatTimer}
+     * @json_read_only
      */
-    inlineFingeringFont?: FontJson;
+    timerFont?: FontJson;
     /**
-     * Ununsed, see deprecation note.
-     * @defaultValue `italic 12px Georgia, serif`
+     * The font to use for displaying the directions texts.
+     * @defaultValue `14px Georgia, serif`
+     * @since 1.4.0
+     * @deprecated use {@link elementFonts} with {@link NotationElement.EffectDirections}
+     * @json_read_only
+     */
+    directionsFont?: FontJson;
+    /**
+     * The font to use for displaying the fretboard numbers in chord diagrams.
+     * @defaultValue `11px Arial, sans-serif`
      * @since 0.9.6
-     * @deprecated use {@link elementFonts} with the respective
-     * @json_ignore
+     * @deprecated use {@link elementFonts} with {@link NotationElement.ChordDiagramFretboardNumbers}
+     * @json_read_only
+     */
+    fretboardNumberFont?: FontJson;
+    /**
+     * The font to use for section marker labels shown above the music sheet.
+     * @defaultValue `bold 14px Georgia, serif`
+     * @since 0.9.6
+     * @deprecated use {@link elementFonts} with {@link NotationElement.EffectMarker}
+     * @json_read_only
      */
-    effectFont?: FontJson;
+    markerFont?: FontJson;
+    /**
+     * The font to use for displaying the bar numbers above the music sheet.
+     * @defaultValue `11px Arial, sans-serif`
+     * @since 0.9.6
+     * @deprecated use {@link elementFonts} with {@link NotationElement.BarNumber}
+     * @json_read_only
+     */
+    barNumberFont?: FontJson;
     /**
      * The fonts used by individual elements. Check `defaultFonts` for the elements which have custom fonts.
      * Removing fonts from this map can lead to unexpected side effects and errors. Only update it with new values.
@@ -14807,9 +15097,30 @@ declare class RenderStylesheet {
      */
     showSingleStaffBrackets: boolean;
     /**
-     * How bar numbers should be displayed.
+     * How bar numbers should be displayed score-wide.
+     * @deprecated Use {@link scoreConfig}, {@link tabConfig},
+     * {@link slashConfig}, or {@link numberedConfig} `.barNumber` for
+     * per-staff-type control. The setter broadcasts to all four
+     * staff-type entries.
      */
-    barNumberDisplay: BarNumberDisplay;
+    get barNumberDisplay(): BarNumberDisplay;
+    set barNumberDisplay(value: BarNumberDisplay);
+    /**
+     * Score-wide display configuration for the standard-notation staff.
+     */
+    scoreConfig: ScoreStaffConfig;
+    /**
+     * Score-wide display configuration for the tablature staff.
+     */
+    tabConfig: TabStaffConfig;
+    /**
+     * Score-wide display configuration for the slash staff.
+     */
+    slashConfig: SlashStaffConfig;
+    /**
+     * Score-wide display configuration for the numbered (jianpu) staff.
+     */
+    numberedConfig: NumberedStaffConfig;
 }
 
 /**
@@ -14982,6 +15293,19 @@ declare class Score {
     exportFlatSyncPoints(): FlatSyncPoint[];
 }
 
+/**
+ * Per-bar override for the standard-notation staff's display.
+ * @record
+ * @json
+ * @public
+ */
+declare interface ScoreBarOverride {
+    clef?: ElementDisplay;
+    keySignature?: ElementDisplay;
+    timeSignature?: ElementDisplay;
+    barNumber?: BarNumberDisplay;
+}
+
 /**
  * This is the base class for creating new song exporters which
  * enable writing scores to a binary datasink.
@@ -15103,6 +15427,19 @@ declare class ScoreRenderer implements IScoreRenderer {
     private _onRenderFinished;
 }
 
+/**
+ * Per-staff-type display configuration for the standard-notation staff.
+ * @record
+ * @json
+ * @public
+ */
+declare interface ScoreStaffConfig {
+    clef?: ElementDisplay;
+    keySignature?: ElementDisplay;
+    timeSignature?: ElementDisplay;
+    barNumber?: BarNumberDisplay;
+}
+
 /**
  * Defines the custom styles for Scores.
  * @json
@@ -15330,6 +15667,30 @@ declare enum SimileMark {
     SecondOfDouble = 3
 }
 
+/**
+ * Per-bar override for the slash staff's display.
+ * @record
+ * @json
+ * @public
+ */
+declare interface SlashBarOverride {
+    keySignature?: ElementDisplay;
+    timeSignature?: ElementDisplay;
+    barNumber?: BarNumberDisplay;
+}
+
+/**
+ * Per-staff-type display configuration for the slash staff.
+ * @record
+ * @json
+ * @public
+ */
+declare interface SlashStaffConfig {
+    keySignature?: ElementDisplay;
+    timeSignature?: ElementDisplay;
+    barNumber?: BarNumberDisplay;
+}
+
 /**
  * This public enum lists all different types of finger slide-ins on a string.
  * @public
@@ -15609,6 +15970,22 @@ declare class Staff {
      * Gets or sets whether the standard notation is shown.
      */
     showStandardNotation: boolean;
+    /**
+     * Per-{@link Staff} override for the standard-notation staff's display.
+     */
+    scoreConfig?: ScoreStaffConfig;
+    /**
+     * Per-{@link Staff} override for the tablature staff's display.
+     */
+    tabConfig?: TabStaffConfig;
+    /**
+     * Per-{@link Staff} override for the slash staff's display.
+     */
+    slashConfig?: SlashStaffConfig;
+    /**
+     * Per-{@link Staff} override for the numbered (jianpu) staff's display.
+     */
+    numberedConfig?: NumberedStaffConfig;
     /**
      * Gets or sets whether the staff contains percussion notation
      */
@@ -15631,6 +16008,26 @@ declare class Staff {
     addBar(bar: Bar): void;
 }
 
+/**
+ * Spatial selector for an element across the staves of a system.
+ *
+ * One axis of {@link ElementDisplay}. The renderer dispatches per-staff
+ * on this axis to decide which staves paint the element.
+ * @public
+ */
+declare enum StaffPlacement {
+    /**
+     * Paint the element on every staff whose
+     * {@link ElementDisplay.isVisible} resolves to `true`.
+     */
+    AllStaves = 0,
+    /**
+     * Paint only on the cascade-primary render-staff for each model
+     * {@link Staff}. Priority: `score → tab → slash → numbered`.
+     */
+    Primary = 1
+}
+
 /**
  * Represents the bounds of a staff system.
  * @public
@@ -15829,6 +16226,24 @@ declare enum SystemCommonType {
     SystemExclusive2 = 247
 }
 
+/**
+ * Temporal selector for an element across the systems of the score.
+ *
+ * One axis of {@link ElementDisplay}. Independent of
+ * {@link StaffPlacement}.
+ * @public
+ */
+declare enum SystemDisplay {
+    /**
+     * Restate the element at the start of every system.
+     */
+    AllSystems = 0,
+    /**
+     * Show only on the first system; subsequent systems do not restate.
+     */
+    FirstSystemOnly = 1
+}
+
 /**
  * @deprecated Move to the new concrete Midi Event Types.
  * @public
@@ -15859,6 +16274,18 @@ export declare enum SystemsLayoutMode {
     UseModelLayout = 1
 }
 
+/**
+ * Per-bar override for the tablature staff's display.
+ * @record
+ * @json
+ * @public
+ */
+declare interface TabBarOverride {
+    clef?: ElementDisplay;
+    timeSignature?: ElementDisplay;
+    barNumber?: BarNumberDisplay;
+}
+
 /**
  * Lists the different modes on how rhythm notation is shown on the tab staff.
  * @public
@@ -15883,6 +16310,20 @@ export declare enum TabRhythmMode {
     Automatic = 3
 }
 
+/**
+ * Per-staff-type display configuration for the tablature staff.
+ * @record
+ * @json
+ * @public
+ */
+declare interface TabStaffConfig {
+    clef?: ElementDisplay;
+    timeSignature?: ElementDisplay;
+    barNumber?: BarNumberDisplay;
+    rhythm?: TabRhythmMode;
+    rests?: ElementDisplay;
+}
+
 /**
  * This public enum lists all base line modes
  * @public