@tspro/web-music-score 4.2.1 → 5.1.0

package/dist/instrument-DYboobMW.d.mts

@@ -0,0 +1,44 @@
+/**
+ * Instrument interface.
+ * <p>To create your own instrument just create a class that implement this simple interface.</p>
+ *
+ * ```ts
+ *   import * as Audio from "@tspro/web-music-score/audio";
+ *
+ *   class MyCoolInstrument implements Audio.Instrument {
+ *       constructor() { }
+ *       getName() { return "My Cool Instrument"; }
+ *       playNote(note: string, duration: number, linearVolume: number) { }
+ *       stop() { }
+ *   }
+ *
+ *   // Add and use my cool instrument.
+ *   Audio.addInstrument(new MyCoolInstrument());
+ * ```
+ */
+interface Instrument {
+    /**
+     * Get instrument name.
+     * @return - Instrument name.
+     */
+    getName(): string;
+    /**
+     * Play a note.
+     * @param note - Note to play (e.g. "C4").
+     * @param duration - Play duration in seconds.
+     * @param linearVolume - Linear volume in range [0, 1].
+     */
+    playNote(note: string, duration: number, linearVolume: number): void;
+    /**
+     * Stop playback.
+     */
+    stop(): void;
+}
+/**
+ * Linear volume to decibels converter.
+ * @param linearVolume - Linear volume in range [0, 1].
+ * @returns - Volume in decibels.
+ */
+declare function linearToDecibels(linearVolume: number): number;
+
+export { type Instrument as I, linearToDecibels as l };

package/dist/instrument-DYboobMW.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Instrument interface.
+ * <p>To create your own instrument just create a class that implement this simple interface.</p>
+ *
+ * ```ts
+ *   import * as Audio from "@tspro/web-music-score/audio";
+ *
+ *   class MyCoolInstrument implements Audio.Instrument {
+ *       constructor() { }
+ *       getName() { return "My Cool Instrument"; }
+ *       playNote(note: string, duration: number, linearVolume: number) { }
+ *       stop() { }
+ *   }
+ *
+ *   // Add and use my cool instrument.
+ *   Audio.addInstrument(new MyCoolInstrument());
+ * ```
+ */
+interface Instrument {
+    /**
+     * Get instrument name.
+     * @return - Instrument name.
+     */
+    getName(): string;
+    /**
+     * Play a note.
+     * @param note - Note to play (e.g. "C4").
+     * @param duration - Play duration in seconds.
+     * @param linearVolume - Linear volume in range [0, 1].
+     */
+    playNote(note: string, duration: number, linearVolume: number): void;
+    /**
+     * Stop playback.
+     */
+    stop(): void;
+}
+/**
+ * Linear volume to decibels converter.
+ * @param linearVolume - Linear volume in range [0, 1].
+ * @returns - Volume in decibels.
+ */
+declare function linearToDecibels(linearVolume: number): number;
+
+export { type Instrument as I, linearToDecibels as l };

package/dist/{music-objects-CI7IjsjE.d.ts → music-objects-CMdYZeC6.d.ts}

@@ -225,34 +225,39 @@ declare enum Clef {
     /** F-clef (bass cleff) */
     F = "F"
 }
+/** Base config for staff and tab configs. */
+type BaseConfig = {
+    /** Name for this staff/tab config. */
+    name?: string;
+    /** Voice ids that are presented in this staff/tab. */
+    voiceIds?: number[];
+};
 /** Staff config to add staff notation line in score configuration. */
-type StaffConfig = {
+type StaffConfig = BaseConfig & {
     /** Config type, must be "staff" for staff config. */
     type: "staff";
     /** G-clef or F-clef for this staff config? */
     clef: Clef | `${Clef}`;
-    /** Set name for this staff config. */
-    name?: string;
     /** Set octave down with G-clef for guitar treble staff notation line. */
     isOctaveDown?: boolean;
     /** Lowest note (e.g. "C2")that can be presented in this staff notation line. */
     minNote?: string;
     /** Highest note (e.g. "C6") that can be presented in this staff notation line. */
     maxNote?: string;
-    /** Voice ids that are presented in this staff notation line. */
-    voiceIds?: number[];
-    /** Set true for two staff configs with G-clef and F-clef to create grand staff. */
+    /**
+     * To create grand staff: use same `grandId` value (e.g. "grand1") for two
+     * consequtive staves, first having G-clef and second having F-clef.
+     */
+    grandId?: string;
+    /** @deprecated - Use `grandId` property instead. */
     isGrand?: boolean;
 };
 /** Tab config to add guitar tab in score configuration. */
-type TabConfig = {
+type TabConfig = BaseConfig & {
     /** Config type, must be "tab" for tab config. */
     type: "tab";
-    /** Set name for this tab config. */
-    name?: string;
+    /** Tuning name or array six notes (tune for each string). */
     tuning?: string | string[];
-    /** Voice ids that are presented in this guitar tab notation line. */
-    voiceIds?: number[];
 };
 /** Score configuration. */
 type ScoreConfiguration = StaffConfig | TabConfig | (StaffConfig | TabConfig)[];
@@ -613,7 +618,6 @@ declare class ObjStaff extends ObjNotationLine {
     isLine(diatonicId: number): boolean;
     isSpace(diatonicId: number): boolean;
     containsVoiceId(voiceId: number): boolean;
-    isGrand(): boolean;
     calcTop(): number;
     calcBottom(): number;
     pick(x: number, y: number): MusicObject[];
@@ -743,6 +747,9 @@ declare class ObjNoteGroup extends MusicObject {
     hasBeamCount(): boolean;
     getLeftBeamCount(): number;
     getRightBeamCount(): number;
+    setLeftBeamCount(count: number): void;
+    setRightBeamCount(count: number): void;
+    hasTuplet(): boolean;
     isEmpty(): boolean;
     visibleInStaff(staff: ObjStaff): boolean;
     getPlayTicks(note: Note): number;
@@ -752,8 +759,6 @@ declare class ObjNoteGroup extends MusicObject {
     setStemTipY(staff: ObjStaff, stemTipY: number): void;
     offset(dx: number, dy: number): void;
     draw(renderer: Renderer): void;
-    static setBeamCounts(groupNotes: (ObjNoteGroup | undefined)[]): void;
-    static setTupletBeamCounts(tuplet: ObjBeamGroup): void;
     getDotVerticalDisplacement(staff: ObjStaff, diatonicId: number, stemDir: Stem): 1 | 0 | -1;
     static hasSameNotes(ng1: ObjNoteGroup, ng2: ObjNoteGroup): boolean;
 }
@@ -805,6 +810,7 @@ declare class ObjBeamGroup extends MusicObject {
     pick(x: number, y: number): MusicObject[];
     getType(): BeamGroupType;
     isTuplet(): boolean;
+    getTupletRatioText(): string;
     getSymbols(): ReadonlyArray<RhythmSymbol>;
     getFirstSymbol(): RhythmSymbol | undefined;
     getLastSymbol(): RhythmSymbol | undefined;
@@ -814,6 +820,8 @@ declare class ObjBeamGroup extends MusicObject {
     updateStemTips(): void;
     offset(dx: number, dy: number): void;
     draw(renderer: Renderer): void;
+    private setBeamCounts;
+    private setTupletBeamCounts;
 }
 
 declare class ObjStaffRest extends MusicObject {
@@ -858,6 +866,7 @@ declare class ObjRest extends MusicObject {
         y: number;
         stemHeight: number;
     } | undefined)[];
+    hasTuplet(): boolean;
     isEmpty(): boolean;
     visibleInStaff(staff: ObjStaff): boolean;
     private getRestDotVerticalDisplacement;
@@ -1183,8 +1192,8 @@ declare class ObjMeasure extends MusicObject {
     addBeamGroup(beam: ObjBeamGroup): void;
     requestBeamsUpdate(): void;
     private createOldStyleTriplets;
+    getBeamGroups(): ReadonlyArray<ObjBeamGroup>;
     createBeams(): void;
-    private static setupBeamGroup;
     getBarLineLeft(): ObjBarLineLeft;
     getBarLineRight(): ObjBarLineRight;
     getVoiceSymbols(voiceId: VoiceId): ReadonlyArray<RhythmSymbol>;
@@ -1243,7 +1252,7 @@ declare class ObjScoreRow extends MusicObject {
     layoutWidth(renderer: Renderer, width: number): void;
     updateRect(): void;
     alignStemsToBeams(): void;
-    layoutPositionLines(renderer: Renderer): void;
+    layoutSetNotationLines(renderer: Renderer): void;
     layoutPadding(renderer: Renderer): void;
     layoutDone(): void;
     offset(dx: number, dy: number): void;
@@ -1364,6 +1373,9 @@ declare class Renderer {
     drawLine(startX: number, startY: number, endX: number, endY: number, color?: string, lineWidth?: number): void;
     drawPartialLine(startX: number, startY: number, endX: number, endY: number, startT: number, endT: number, color?: string, lineWidth?: number): void;
     drawLedgerLines(staff: ObjStaff, diatonicId: number, x: number): void;
+    getRestRect(restSize: number): DivRect;
+    drawRest(restSize: number, x: number, y: number, color: string): void;
+    drawFlag(rect: DivRect, dir: "up" | "down"): void;
 }
 
 declare class ObjEnding extends MusicObject {
@@ -1458,23 +1470,40 @@ declare class ObjExtensionLine extends MusicObject {
     draw(renderer: Renderer): void;
 }
 
+declare class ObjTabRhythm extends MusicObject {
+    readonly measure: ObjMeasure;
+    readonly tab: ObjTab;
+    private readonly voiceIds;
+    readonly mi: MTabRhythm;
+    constructor(measure: ObjMeasure, tab: ObjTab);
+    getMusicInterface(): MTabRhythm;
+    pick(x: number, y: number): MusicObject[];
+    layout(renderer: Renderer): void;
+    private hasTuplets;
+    layoutFitToMeasure(renderer: Renderer): void;
+    offset(dx: number, dy: number): void;
+    private readonly tupletPartsTextObjMap;
+    draw(renderer: Renderer): void;
+}
+
 declare enum LayoutGroupId {
-    Fermata = 0,
-    NoteLabel = 1,
-    Navigation = 2,
-    Ending = 3,
-    TempoAnnotation = 4,
-    DynamicsAnnotation = 5,
-    ChordLabel = 6,
-    LyricsVerse1 = 7,
-    LyricsVerse2 = 8,
-    LyricsVerse3 = 9
+    TabRhythm = 0,
+    Fermata = 1,
+    NoteLabel = 2,
+    Navigation = 3,
+    Ending = 4,
+    TempoAnnotation = 5,
+    DynamicsAnnotation = 6,
+    ChordLabel = 7,
+    LyricsVerse1 = 8,
+    LyricsVerse2 = 9,
+    LyricsVerse3 = 10
 }
 declare enum VerticalPos {
     Above = 0,
     Below = 1
 }
-type LayoutableMusicObject = ObjText | ObjSpecialText | ObjExtensionLine | ObjFermata | ObjEnding | ObjLyrics;
+type LayoutableMusicObject = ObjText | ObjSpecialText | ObjExtensionLine | ObjFermata | ObjEnding | ObjLyrics | ObjTabRhythm;
 declare class StaffGroup {
     readonly groupName: string;
     readonly staffsTabsAndGroups: number | string | (number | string)[];
@@ -1605,7 +1634,7 @@ declare class ObjImage extends MusicObject {
     draw(renderer: Renderer): void;
 }
 
-declare class ObjSignature extends MusicObject {
+declare class ObjStaffSignature extends MusicObject {
     readonly measure: ObjMeasure;
     readonly staff: ObjStaff;
     private clefImage?;
@@ -1616,9 +1645,9 @@ declare class ObjSignature extends MusicObject {
     private beatCountText?;
     private beatSizeText?;
     private tempoText?;
-    readonly mi: MSignature;
+    readonly mi: MStaffSignature;
     constructor(measure: ObjMeasure, staff: ObjStaff);
-    getMusicInterface(): MSignature;
+    getMusicInterface(): MStaffSignature;
     updateClefImage(renderer: Renderer, showClef: boolean): void;
     updateMeasureNumber(showMeasureNumber: boolean): void;
     updateKeySignature(showKeySignature: boolean): void;
@@ -1630,6 +1659,24 @@ declare class ObjSignature extends MusicObject {
     offset(dx: number, dy: number): void;
     draw(renderer: Renderer): void;
 }
+declare class ObjTabSignature extends MusicObject {
+    readonly measure: ObjMeasure;
+    readonly tab: ObjTab;
+    private measureNumber?;
+    private beatCountText?;
+    private beatSizeText?;
+    private tempoText?;
+    readonly mi: MTabSignature;
+    constructor(measure: ObjMeasure, tab: ObjTab);
+    getMusicInterface(): MTabSignature;
+    updateMeasureNumber(showMeasureNumber: boolean): void;
+    updateTimeSignature(showTimeSignature: boolean): void;
+    updateTempo(showTempo: boolean): void;
+    pick(x: number, y: number): MusicObject[];
+    layout(renderer: Renderer): void;
+    offset(dx: number, dy: number): void;
+    draw(renderer: Renderer): void;
+}
 
 /** Score event type. */
 type ScoreEventType = "enter" | "leave" | "click";
@@ -2321,21 +2368,56 @@ declare class MTab extends MusicInterface {
      */
     getRow(): MScoreRow;
 }
-/** Signature object contains clef, key signature, time signature and tempo, all optional depending on measure. */
-declare class MSignature extends MusicInterface {
+/** Staff signature object contains clef, key signature, time signature, tempo and measure number, all optional depending on measure. */
+declare class MStaffSignature extends MusicInterface {
     private readonly obj;
     /** Object name. */
-    static readonly Name = "Signature";
+    static readonly Name = "StaffSignature";
     /** @internal */
-    constructor(obj: ObjSignature);
+    constructor(obj: ObjStaffSignature);
     /** @internal */
-    getMusicObject(): ObjSignature;
+    getMusicObject(): ObjStaffSignature;
     /**
      * Get staff notation line this signature is in.
      * @returns - Staff object.
      */
     getStaff(): MStaff;
 }
+/** Tab signature object contains time signature, tempo and measure number, all optional depending on measure. */
+declare class MTabSignature extends MusicInterface {
+    private readonly obj;
+    /** Object name. */
+    static readonly Name = "TabSignature";
+    /** @internal */
+    constructor(obj: ObjTabSignature);
+    /** @internal */
+    getMusicObject(): ObjTabSignature;
+    /**
+     * Get tab notation line this signature is in.
+     * @returns - Tab object.
+     */
+    getTab(): MTab;
+}
+/** Tab rhythm object. */
+declare class MTabRhythm extends MusicInterface {
+    private readonly obj;
+    /** Object name. */
+    static readonly Name = "TabRhythm";
+    /** @internal */
+    constructor(obj: ObjTabRhythm);
+    /** @internal */
+    getMusicObject(): ObjTabRhythm;
+    /**
+     * Get measure.
+     * @returns - Measure.
+     */
+    getMeasure(): MMeasure;
+    /**
+     * Get tab.
+     * @returns - Tab.
+     */
+    getTab(): MTab;
+}
 /** Spacial text object contains text and possibly special symbols (e.g. Segno or Coda). */
 declare class MSpecialText extends MusicInterface {
     private readonly obj;
@@ -2392,4 +2474,4 @@ declare class MExtensionLine extends MusicInterface {
     getMusicObject(): ObjExtensionLine;
 }
 
-export { MText as $, type AnnotationText as A, MImage as B, Connective as C, DivRect as D, MMeasure as E, Fermata as F, MBarLineRight as G, MBarLineLeft as H, MStaffTabBarLine as I, MNoteGroup as J, MStaffNoteGroup as K, type LyricsOptions as L, MDocument as M, type NoteOptions as N, MTabNoteGroup as O, MRest as P, MStaffRest as Q, type RestOptions as R, StaffPreset as S, type TupletOptions as T, MRhythmColumn as U, type VoiceId as V, MScoreRow as W, MStaff as X, MTab as Y, MSignature as Z, MSpecialText as _, type ScoreConfiguration as a, MLyrics as a0, MExtensionLine as a1, Clef as a2, type StaffConfig as a3, type TabConfig as a4, getVoiceIds as a5, type StringNumber as a6, getStringNumbers as a7, getVerseNumbers as a8, Stem as a9, Arpeggio as aa, type StaffTabOrGroup as ab, LyricsAlign as ac, LyricsHyphen as ad, DynamicsAnnotation as ae, TempoAnnotation as af, PlayState as ag, type PlayStateChangeListener as ah, type VerseNumber as b, type StaffTabOrGroups as c, Navigation as d, Annotation as e, Label as f, TieType as g, NoteAnchor as h, VerticalPosition as i, type ScoreEventType as j, ScoreEvent as k, ScoreStaffPosEvent as l, ScoreObjectEvent as m, type ScoreEventListener as n, MPlayer as o, MRenderer as p, MPlaybackButtons as q, MusicInterface as r, MAccidental as s, MConnective as t, MArpeggio as u, MBeamGroup as v, MStaffBeamGroup as w, MEnding as x, MFermata as y, MHeader as z };
+export { MTabRhythm as $, type AnnotationText as A, MImage as B, Connective as C, DivRect as D, MMeasure as E, Fermata as F, MBarLineRight as G, MBarLineLeft as H, MStaffTabBarLine as I, MNoteGroup as J, MStaffNoteGroup as K, type LyricsOptions as L, MDocument as M, type NoteOptions as N, MTabNoteGroup as O, MRest as P, MStaffRest as Q, type RestOptions as R, StaffPreset as S, type TupletOptions as T, MRhythmColumn as U, type VoiceId as V, MScoreRow as W, MStaff as X, MTab as Y, MStaffSignature as Z, MTabSignature as _, type ScoreConfiguration as a, MSpecialText as a0, MText as a1, MLyrics as a2, MExtensionLine as a3, Clef as a4, type BaseConfig as a5, type StaffConfig as a6, type TabConfig as a7, getVoiceIds as a8, type StringNumber as a9, getStringNumbers as aa, getVerseNumbers as ab, Stem as ac, Arpeggio as ad, type StaffTabOrGroup as ae, LyricsAlign as af, LyricsHyphen as ag, DynamicsAnnotation as ah, TempoAnnotation as ai, PlayState as aj, type PlayStateChangeListener as ak, type VerseNumber as b, type StaffTabOrGroups as c, Navigation as d, Annotation as e, Label as f, TieType as g, NoteAnchor as h, VerticalPosition as i, type ScoreEventType as j, ScoreEvent as k, ScoreStaffPosEvent as l, ScoreObjectEvent as m, type ScoreEventListener as n, MPlayer as o, MRenderer as p, MPlaybackButtons as q, MusicInterface as r, MAccidental as s, MConnective as t, MArpeggio as u, MBeamGroup as v, MStaffBeamGroup as w, MEnding as x, MFermata as y, MHeader as z };

package/dist/{music-objects-3Hxlkxy6.d.mts → music-objects-DTDFSro0.d.mts}

@@ -225,34 +225,39 @@ declare enum Clef {
     /** F-clef (bass cleff) */
     F = "F"
 }
+/** Base config for staff and tab configs. */
+type BaseConfig = {
+    /** Name for this staff/tab config. */
+    name?: string;
+    /** Voice ids that are presented in this staff/tab. */
+    voiceIds?: number[];
+};
 /** Staff config to add staff notation line in score configuration. */
-type StaffConfig = {
+type StaffConfig = BaseConfig & {
     /** Config type, must be "staff" for staff config. */
     type: "staff";
     /** G-clef or F-clef for this staff config? */
     clef: Clef | `${Clef}`;
-    /** Set name for this staff config. */
-    name?: string;
     /** Set octave down with G-clef for guitar treble staff notation line. */
     isOctaveDown?: boolean;
     /** Lowest note (e.g. "C2")that can be presented in this staff notation line. */
     minNote?: string;
     /** Highest note (e.g. "C6") that can be presented in this staff notation line. */
     maxNote?: string;
-    /** Voice ids that are presented in this staff notation line. */
-    voiceIds?: number[];
-    /** Set true for two staff configs with G-clef and F-clef to create grand staff. */
+    /**
+     * To create grand staff: use same `grandId` value (e.g. "grand1") for two
+     * consequtive staves, first having G-clef and second having F-clef.
+     */
+    grandId?: string;
+    /** @deprecated - Use `grandId` property instead. */
     isGrand?: boolean;
 };
 /** Tab config to add guitar tab in score configuration. */
-type TabConfig = {
+type TabConfig = BaseConfig & {
     /** Config type, must be "tab" for tab config. */
     type: "tab";
-    /** Set name for this tab config. */
-    name?: string;
+    /** Tuning name or array six notes (tune for each string). */
     tuning?: string | string[];
-    /** Voice ids that are presented in this guitar tab notation line. */
-    voiceIds?: number[];
 };
 /** Score configuration. */
 type ScoreConfiguration = StaffConfig | TabConfig | (StaffConfig | TabConfig)[];
@@ -613,7 +618,6 @@ declare class ObjStaff extends ObjNotationLine {
     isLine(diatonicId: number): boolean;
     isSpace(diatonicId: number): boolean;
     containsVoiceId(voiceId: number): boolean;
-    isGrand(): boolean;
     calcTop(): number;
     calcBottom(): number;
     pick(x: number, y: number): MusicObject[];
@@ -743,6 +747,9 @@ declare class ObjNoteGroup extends MusicObject {
     hasBeamCount(): boolean;
     getLeftBeamCount(): number;
     getRightBeamCount(): number;
+    setLeftBeamCount(count: number): void;
+    setRightBeamCount(count: number): void;
+    hasTuplet(): boolean;
     isEmpty(): boolean;
     visibleInStaff(staff: ObjStaff): boolean;
     getPlayTicks(note: Note): number;
@@ -752,8 +759,6 @@ declare class ObjNoteGroup extends MusicObject {
     setStemTipY(staff: ObjStaff, stemTipY: number): void;
     offset(dx: number, dy: number): void;
     draw(renderer: Renderer): void;
-    static setBeamCounts(groupNotes: (ObjNoteGroup | undefined)[]): void;
-    static setTupletBeamCounts(tuplet: ObjBeamGroup): void;
     getDotVerticalDisplacement(staff: ObjStaff, diatonicId: number, stemDir: Stem): 1 | 0 | -1;
     static hasSameNotes(ng1: ObjNoteGroup, ng2: ObjNoteGroup): boolean;
 }
@@ -805,6 +810,7 @@ declare class ObjBeamGroup extends MusicObject {
     pick(x: number, y: number): MusicObject[];
     getType(): BeamGroupType;
     isTuplet(): boolean;
+    getTupletRatioText(): string;
     getSymbols(): ReadonlyArray<RhythmSymbol>;
     getFirstSymbol(): RhythmSymbol | undefined;
     getLastSymbol(): RhythmSymbol | undefined;
@@ -814,6 +820,8 @@ declare class ObjBeamGroup extends MusicObject {
     updateStemTips(): void;
     offset(dx: number, dy: number): void;
     draw(renderer: Renderer): void;
+    private setBeamCounts;
+    private setTupletBeamCounts;
 }
 
 declare class ObjStaffRest extends MusicObject {
@@ -858,6 +866,7 @@ declare class ObjRest extends MusicObject {
         y: number;
         stemHeight: number;
     } | undefined)[];
+    hasTuplet(): boolean;
     isEmpty(): boolean;
     visibleInStaff(staff: ObjStaff): boolean;
     private getRestDotVerticalDisplacement;
@@ -1183,8 +1192,8 @@ declare class ObjMeasure extends MusicObject {
     addBeamGroup(beam: ObjBeamGroup): void;
     requestBeamsUpdate(): void;
     private createOldStyleTriplets;
+    getBeamGroups(): ReadonlyArray<ObjBeamGroup>;
     createBeams(): void;
-    private static setupBeamGroup;
     getBarLineLeft(): ObjBarLineLeft;
     getBarLineRight(): ObjBarLineRight;
     getVoiceSymbols(voiceId: VoiceId): ReadonlyArray<RhythmSymbol>;
@@ -1243,7 +1252,7 @@ declare class ObjScoreRow extends MusicObject {
     layoutWidth(renderer: Renderer, width: number): void;
     updateRect(): void;
     alignStemsToBeams(): void;
-    layoutPositionLines(renderer: Renderer): void;
+    layoutSetNotationLines(renderer: Renderer): void;
     layoutPadding(renderer: Renderer): void;
     layoutDone(): void;
     offset(dx: number, dy: number): void;
@@ -1364,6 +1373,9 @@ declare class Renderer {
     drawLine(startX: number, startY: number, endX: number, endY: number, color?: string, lineWidth?: number): void;
     drawPartialLine(startX: number, startY: number, endX: number, endY: number, startT: number, endT: number, color?: string, lineWidth?: number): void;
     drawLedgerLines(staff: ObjStaff, diatonicId: number, x: number): void;
+    getRestRect(restSize: number): DivRect;
+    drawRest(restSize: number, x: number, y: number, color: string): void;
+    drawFlag(rect: DivRect, dir: "up" | "down"): void;
 }
 
 declare class ObjEnding extends MusicObject {
@@ -1458,23 +1470,40 @@ declare class ObjExtensionLine extends MusicObject {
     draw(renderer: Renderer): void;
 }
 
+declare class ObjTabRhythm extends MusicObject {
+    readonly measure: ObjMeasure;
+    readonly tab: ObjTab;
+    private readonly voiceIds;
+    readonly mi: MTabRhythm;
+    constructor(measure: ObjMeasure, tab: ObjTab);
+    getMusicInterface(): MTabRhythm;
+    pick(x: number, y: number): MusicObject[];
+    layout(renderer: Renderer): void;
+    private hasTuplets;
+    layoutFitToMeasure(renderer: Renderer): void;
+    offset(dx: number, dy: number): void;
+    private readonly tupletPartsTextObjMap;
+    draw(renderer: Renderer): void;
+}
+
 declare enum LayoutGroupId {
-    Fermata = 0,
-    NoteLabel = 1,
-    Navigation = 2,
-    Ending = 3,
-    TempoAnnotation = 4,
-    DynamicsAnnotation = 5,
-    ChordLabel = 6,
-    LyricsVerse1 = 7,
-    LyricsVerse2 = 8,
-    LyricsVerse3 = 9
+    TabRhythm = 0,
+    Fermata = 1,
+    NoteLabel = 2,
+    Navigation = 3,
+    Ending = 4,
+    TempoAnnotation = 5,
+    DynamicsAnnotation = 6,
+    ChordLabel = 7,
+    LyricsVerse1 = 8,
+    LyricsVerse2 = 9,
+    LyricsVerse3 = 10
 }
 declare enum VerticalPos {
     Above = 0,
     Below = 1
 }
-type LayoutableMusicObject = ObjText | ObjSpecialText | ObjExtensionLine | ObjFermata | ObjEnding | ObjLyrics;
+type LayoutableMusicObject = ObjText | ObjSpecialText | ObjExtensionLine | ObjFermata | ObjEnding | ObjLyrics | ObjTabRhythm;
 declare class StaffGroup {
     readonly groupName: string;
     readonly staffsTabsAndGroups: number | string | (number | string)[];
@@ -1605,7 +1634,7 @@ declare class ObjImage extends MusicObject {
     draw(renderer: Renderer): void;
 }
 
-declare class ObjSignature extends MusicObject {
+declare class ObjStaffSignature extends MusicObject {
     readonly measure: ObjMeasure;
     readonly staff: ObjStaff;
     private clefImage?;
@@ -1616,9 +1645,9 @@ declare class ObjSignature extends MusicObject {
     private beatCountText?;
     private beatSizeText?;
     private tempoText?;
-    readonly mi: MSignature;
+    readonly mi: MStaffSignature;
     constructor(measure: ObjMeasure, staff: ObjStaff);
-    getMusicInterface(): MSignature;
+    getMusicInterface(): MStaffSignature;
     updateClefImage(renderer: Renderer, showClef: boolean): void;
     updateMeasureNumber(showMeasureNumber: boolean): void;
     updateKeySignature(showKeySignature: boolean): void;
@@ -1630,6 +1659,24 @@ declare class ObjSignature extends MusicObject {
     offset(dx: number, dy: number): void;
     draw(renderer: Renderer): void;
 }
+declare class ObjTabSignature extends MusicObject {
+    readonly measure: ObjMeasure;
+    readonly tab: ObjTab;
+    private measureNumber?;
+    private beatCountText?;
+    private beatSizeText?;
+    private tempoText?;
+    readonly mi: MTabSignature;
+    constructor(measure: ObjMeasure, tab: ObjTab);
+    getMusicInterface(): MTabSignature;
+    updateMeasureNumber(showMeasureNumber: boolean): void;
+    updateTimeSignature(showTimeSignature: boolean): void;
+    updateTempo(showTempo: boolean): void;
+    pick(x: number, y: number): MusicObject[];
+    layout(renderer: Renderer): void;
+    offset(dx: number, dy: number): void;
+    draw(renderer: Renderer): void;
+}
 
 /** Score event type. */
 type ScoreEventType = "enter" | "leave" | "click";
@@ -2321,21 +2368,56 @@ declare class MTab extends MusicInterface {
      */
     getRow(): MScoreRow;
 }
-/** Signature object contains clef, key signature, time signature and tempo, all optional depending on measure. */
-declare class MSignature extends MusicInterface {
+/** Staff signature object contains clef, key signature, time signature, tempo and measure number, all optional depending on measure. */
+declare class MStaffSignature extends MusicInterface {
     private readonly obj;
     /** Object name. */
-    static readonly Name = "Signature";
+    static readonly Name = "StaffSignature";
     /** @internal */
-    constructor(obj: ObjSignature);
+    constructor(obj: ObjStaffSignature);
     /** @internal */
-    getMusicObject(): ObjSignature;
+    getMusicObject(): ObjStaffSignature;
     /**
      * Get staff notation line this signature is in.
      * @returns - Staff object.
      */
     getStaff(): MStaff;
 }
+/** Tab signature object contains time signature, tempo and measure number, all optional depending on measure. */
+declare class MTabSignature extends MusicInterface {
+    private readonly obj;
+    /** Object name. */
+    static readonly Name = "TabSignature";
+    /** @internal */
+    constructor(obj: ObjTabSignature);
+    /** @internal */
+    getMusicObject(): ObjTabSignature;
+    /**
+     * Get tab notation line this signature is in.
+     * @returns - Tab object.
+     */
+    getTab(): MTab;
+}
+/** Tab rhythm object. */
+declare class MTabRhythm extends MusicInterface {
+    private readonly obj;
+    /** Object name. */
+    static readonly Name = "TabRhythm";
+    /** @internal */
+    constructor(obj: ObjTabRhythm);
+    /** @internal */
+    getMusicObject(): ObjTabRhythm;
+    /**
+     * Get measure.
+     * @returns - Measure.
+     */
+    getMeasure(): MMeasure;
+    /**
+     * Get tab.
+     * @returns - Tab.
+     */
+    getTab(): MTab;
+}
 /** Spacial text object contains text and possibly special symbols (e.g. Segno or Coda). */
 declare class MSpecialText extends MusicInterface {
     private readonly obj;
@@ -2392,4 +2474,4 @@ declare class MExtensionLine extends MusicInterface {
     getMusicObject(): ObjExtensionLine;
 }
 
-export { MText as $, type AnnotationText as A, MImage as B, Connective as C, DivRect as D, MMeasure as E, Fermata as F, MBarLineRight as G, MBarLineLeft as H, MStaffTabBarLine as I, MNoteGroup as J, MStaffNoteGroup as K, type LyricsOptions as L, MDocument as M, type NoteOptions as N, MTabNoteGroup as O, MRest as P, MStaffRest as Q, type RestOptions as R, StaffPreset as S, type TupletOptions as T, MRhythmColumn as U, type VoiceId as V, MScoreRow as W, MStaff as X, MTab as Y, MSignature as Z, MSpecialText as _, type ScoreConfiguration as a, MLyrics as a0, MExtensionLine as a1, Clef as a2, type StaffConfig as a3, type TabConfig as a4, getVoiceIds as a5, type StringNumber as a6, getStringNumbers as a7, getVerseNumbers as a8, Stem as a9, Arpeggio as aa, type StaffTabOrGroup as ab, LyricsAlign as ac, LyricsHyphen as ad, DynamicsAnnotation as ae, TempoAnnotation as af, PlayState as ag, type PlayStateChangeListener as ah, type VerseNumber as b, type StaffTabOrGroups as c, Navigation as d, Annotation as e, Label as f, TieType as g, NoteAnchor as h, VerticalPosition as i, type ScoreEventType as j, ScoreEvent as k, ScoreStaffPosEvent as l, ScoreObjectEvent as m, type ScoreEventListener as n, MPlayer as o, MRenderer as p, MPlaybackButtons as q, MusicInterface as r, MAccidental as s, MConnective as t, MArpeggio as u, MBeamGroup as v, MStaffBeamGroup as w, MEnding as x, MFermata as y, MHeader as z };
+export { MTabRhythm as $, type AnnotationText as A, MImage as B, Connective as C, DivRect as D, MMeasure as E, Fermata as F, MBarLineRight as G, MBarLineLeft as H, MStaffTabBarLine as I, MNoteGroup as J, MStaffNoteGroup as K, type LyricsOptions as L, MDocument as M, type NoteOptions as N, MTabNoteGroup as O, MRest as P, MStaffRest as Q, type RestOptions as R, StaffPreset as S, type TupletOptions as T, MRhythmColumn as U, type VoiceId as V, MScoreRow as W, MStaff as X, MTab as Y, MStaffSignature as Z, MTabSignature as _, type ScoreConfiguration as a, MSpecialText as a0, MText as a1, MLyrics as a2, MExtensionLine as a3, Clef as a4, type BaseConfig as a5, type StaffConfig as a6, type TabConfig as a7, getVoiceIds as a8, type StringNumber as a9, getStringNumbers as aa, getVerseNumbers as ab, Stem as ac, Arpeggio as ad, type StaffTabOrGroup as ae, LyricsAlign as af, LyricsHyphen as ag, DynamicsAnnotation as ah, TempoAnnotation as ai, PlayState as aj, type PlayStateChangeListener as ak, type VerseNumber as b, type StaffTabOrGroups as c, Navigation as d, Annotation as e, Label as f, TieType as g, NoteAnchor as h, VerticalPosition as i, type ScoreEventType as j, ScoreEvent as k, ScoreStaffPosEvent as l, ScoreObjectEvent as m, type ScoreEventListener as n, MPlayer as o, MRenderer as p, MPlaybackButtons as q, MusicInterface as r, MAccidental as s, MConnective as t, MArpeggio as u, MBeamGroup as v, MStaffBeamGroup as w, MEnding as x, MFermata as y, MHeader as z };