@tspro/web-music-score 3.2.0 → 4.0.1

package/dist/{interface-Bn5HFt_U.d.mts → music-objects-DJQ4d2OA.d.mts}

@@ -1,5 +1,5 @@
-import { N as Note, A as Accidental } from './note-BFa43I86.mjs';
-import { R as RhythmProps, N as NoteLength, c as Tempo, K as KeySignature, a as TimeSignature, T as TimeSignatureString } from './tempo-B4h5Ktob.mjs';
+import { N as Note, A as Accidental } from './note-eA2xPPiG.mjs';
+import { R as RhythmProps, N as NoteLength, h as NoteLengthStr, j as TupletRatio, c as Tempo, K as KeySignature, a as TimeSignature, T as TimeSignatureString } from './tempo-CtUhvJbr.mjs';
 import { Vec2 } from '@tspro/ts-utils-lib';
 
 /**
@@ -197,142 +197,244 @@ declare class DivRect {
     getRect(): DivRect;
 }
 
+/** Staff preset values for score configuration. */
 declare enum StaffPreset {
     /** Treble staff has treble (G-) clef. */
-    Treble = 1,
+    Treble = "treble",
     /** Bass staff has bass (F-) clef. */
-    Bass = 2,
+    Bass = "bass",
     /** Grand staff has both treble and bass clefs. */
-    Grand = 3,
+    Grand = "grand",
     /** GuitarTreble has treble clef but is one octave lower. */
-    GuitarTreble = 4,
+    GuitarTreble = "guitarTreble",
     /** GuitarTab has tab for guitar. */
-    GuitarTab = 8,
+    GuitarTab = "guitarTab",
     /** GuitarCombined has treble clef and tab for guitar. */
-    GuitarCombined = 12
+    GuitarCombined = "guitarCombined"
 }
+/** Clef for staff notation lines. */
 declare enum Clef {
+    /** G-clef (treble cleff) */
     G = "G",
+    /** F-clef (bass cleff) */
     F = "F"
 }
+/** Staff config to add staff notation line in score configuration. */
 type StaffConfig = {
+    /** Config type, must be "staff" for staff config. */
     type: "staff";
-    clef: Clef;
+    /** 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. */
     isGrand?: boolean;
 };
+/** Tab config to add guitar tab in score configuration. */
 type TabConfig = {
+    /** Config type, must be "tab" for tab config. */
     type: "tab";
+    /** Set name for this tab config. */
     name?: 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)[];
+/** VoiceId type. */
 type VoiceId = 0 | 1 | 2 | 3;
+/** Get supported VoiceIds. Returns [0, 1, 2, 3]. */
 declare function getVoiceIds(): ReadonlyArray<VoiceId>;
+/** Strng number type. */
 type StringNumber = 1 | 2 | 3 | 4 | 5 | 6;
+/** Get strin numbers. Returns [0, 1, 2, 3, 4, 5]. */
 declare function getStringNumbers(): ReadonlyArray<StringNumber>;
+/** Stem direction enum. */
 declare enum Stem {
-    Auto = 0,
-    Up = 1,
-    Down = 2
-}
+    /** Auto stem direction. */
+    Auto = "auto",
+    /** Stem is upwards. */
+    Up = "up",
+    /** Stm is downwards. */
+    Down = "down"
+}
+/** Arpeggio direction enum. */
 declare enum Arpeggio {
-    Up = 0,
-    Down = 1
+    /** Upwards, chord played from lowes to highest. */
+    Up = "up",
+    /** Downwards, chord played from highest to loest. */
+    Down = "down"
 }
+/** Special tie length enum. */
 declare enum TieType {
-    Stub = -1,
-    ToMeasureEnd = -2
+    /** Stub tie is short tie that left anchors to note and has not right anchor point. */
+    Stub = "stub",
+    /** To measure end tie is tie that left anchors to note and right anchors to measure end. */
+    ToMeasureEnd = "toMeasureEnd"
 }
+/** Anchor point enum for connectives (ties, slurs, slides). */
 declare enum NoteAnchor {
-    Auto = 0,
-    Above = 1,
-    Center = 2,
-    Below = 3,
-    StemTip = 4
-}
+    /** Automatically choose anchor point using simple logic. */
+    Auto = "auto",
+    /** Anchor connective above note head. */
+    Above = "above",
+    /** Anchor connective center/next to note head.*/
+    Center = "center",
+    /** Anchor connective below note head. */
+    Below = "below",
+    /** Anchor connective to stem tip. */
+    StemTip = "stemTip"
+}
+/** Connective enum. */
 declare enum Connective {
-    Tie = 0,
-    Slur = 1,
-    Slide = 2
-}
-type ConnectiveSpan = number | TieType;
+    /** Tie, connects two or more adjacent notes of same pitch with arc. */
+    Tie = "tie",
+    /** Slur, connects two or more adjacent notes of different pitch with arc. */
+    Slur = "slur",
+    /** Slide, connects two adjacent notes of different pitch with straight line. */
+    Slide = "slide"
+}
+/** Vertical position enum used to layout notation elements. */
 declare enum VerticalPosition {
-    Above = 0,
-    Below = 1,
-    Both = 2,
-    Auto = 3
-}
+    /** Automatic/default layout position depending on element. */
+    Auto = "auto",
+    /** Add  element above staff/tab. */
+    Above = "above",
+    /** Add element below staff/tab. */
+    Below = "below",
+    /** Add element both above and below staff/tab. */
+    Both = "both"
+}
+/** Staff/tab/group type can be staff/tab index or staff/tab/group name. */
 type StaffTabOrGroup = number | string;
+/** Staff/tab/group snglevalue or array of values. */
 type StaffTabOrGroups = StaffTabOrGroup | StaffTabOrGroup[];
+/** Options for notes/chords. */
 type NoteOptions = {
-    dotted?: boolean;
-    stem?: Stem;
+    /** Stem direction. */
+    stem?: Stem | `${Stem}`;
+    /** Set color. */
     color?: string;
-    arpeggio?: Arpeggio | boolean;
+    /** Arepggio direction for chords. true = "up". */
+    arpeggio?: boolean | Arpeggio | `${Arpeggio}`;
+    /** Add staccato dot. */
     staccato?: boolean;
+    /** Use diamond shaped note head. */
     diamond?: boolean;
-    triplet?: boolean;
+    /** Set string number (array of numbers for chord) to use in guitar tab. */
     string?: StringNumber | StringNumber[];
+    /** @deprecated - Use triplet NoteLength values instead, e.g. NoteLength.QuarterTriplet or "4t", etc. */
+    triplet?: boolean;
+    /** @deprecated - Use dotted NoteLength values instead, e.g. NoteLength.Quarter2Dots or "4..", etc. */
+    dotted?: boolean | number;
 };
+/** Options for rests. */
 type RestOptions = {
-    dotted?: boolean;
+    /** Set staff position for this rest. Can be instance of Note, string (e.g. "C3"), or midiNumber. */
     staffPos?: Note | string | number;
+    /** Set color. */
     color?: string;
+    /** Hide this rest, still affects playing. */
     hide?: boolean;
+    /** @deprecated - Use triplet NoteLength values instead, e.g. NoteLength.QuarterTriplet or "4t", etc. */
     triplet?: boolean;
+    /** @deprecated - Use dotted NoteLength values instead, e.g. NoteLength.Quarter2Dots or "4..", etc. */
+    dotted?: boolean | number;
 };
-declare enum PlayState {
-    Playing = 0,
-    Paused = 1,
-    Stopped = 2
-}
-type PlayStateChangeListener = (playState: PlayState) => void;
+/** Tuplet options. */
+type TupletOptions = {
+    /** Show tuplet ratio (e.g. "3:2") instead of number of parts (e.g. "3"). */
+    showRatio?: boolean;
+};
+/** Fermata enum. */
 declare enum Fermata {
-    AtNote = 0,
-    AtMeasureEnd = 1
+    /** Anchor fermata to note/rest. */
+    AtNote = "atNote",
+    /** Anchor fermata to measure end. */
+    AtMeasureEnd = "atMeasureEnd"
 }
+/** Navigation element enum. */
 declare enum Navigation {
     /** Repeat back to beginning and play to the "Fine" marking. */
-    DC_al_Fine = 0,
+    DC_al_Fine = "D.C. al Fine",
     /** Repeat back to beginning and play to the "to Coda 𝄌", then jump to the "𝄌 Coda". */
-    DC_al_Coda = 1,
+    DC_al_Coda = "D.C. al Coda",
     /** Repeat back to Segno sign (𝄋) and play to the "Fine" marking. */
-    DS_al_Fine = 2,
+    DS_al_Fine = "D.S. al Fine",
     /** Repeat back to Segno sign (𝄋) and play to the "to Coda 𝄌", then jump to the "𝄌 Coda". */
-    DS_al_Coda = 3,
+    DS_al_Coda = "D.S. al Coda",
     /** "𝄌 Coda" section. */
-    Coda = 4,
+    Coda = "Coda",
     /** From "toCoda 𝄌" jump to the "𝄌 Coda" section. */
-    toCoda = 5,
+    toCoda = "toCoda",
     /** Jump here from D.S. al Fine or D.S. al Coda. */
-    Segno = 6,
+    Segno = "Segno",
     /** Stop playing after D.C. al Fine or D.S. al Fine. */
-    Fine = 7,
+    Fine = "Fine",
     /** Start of repeat section. */
-    StartRepeat = 8,
+    StartRepeat = "startRepeat",
     /** End of repeat section. Jump to start of repeat section. */
-    EndRepeat = 9,
+    EndRepeat = "endRepeat",
     /** Jump to ending with correct passage number. */
-    Ending = 10
+    Ending = "ending"
 }
+/** Annotation element enum. */
 declare enum Annotation {
     /** "ppp", "pp", "p", "mp", "m", "mf", "f", "ff", "fff", "cresc.", "decresc.", "dim." */
-    Dynamics = 0,
+    Dynamics = "dynamics",
     /** "accel.", "rit.", "a tempo" */
-    Tempo = 1
-}
+    Tempo = "tempo"
+}
+/** Some known dynamics annotations. */
+declare enum DynamicsAnnotation {
+    cresc = "cresc.",
+    decresc = "decresc.",
+    dim = "dim.",
+    ppp = "ppp",
+    pp = "pp",
+    p = "p",
+    mp = "mp",
+    m = "m",
+    mf = "mf",
+    f = "f",
+    ff = "ff",
+    fff = "fff"
+}
+/** Some known tempo annotations. */
+declare enum TempoAnnotation {
+    accel = "accel.",
+    rit = "rit.",
+    a_tempo = "a tempo"
+}
+/** Known annotation test type. */
+type AnnotationText = `${DynamicsAnnotation}` | `${TempoAnnotation}`;
+/** Label element enum. */
 declare enum Label {
     /** "C", "C#", "Db", "D", etc. */
-    Note = 0,
+    Note = "note",
     /** "C", "Am", "G7", etc. */
-    Chord = 1
+    Chord = "chord"
 }
+/** Play state enum. */
+declare enum PlayState {
+    /** Playing. */
+    Playing = 0,
+    /** Paused. */
+    Paused = 1,
+    /** Stopped. */
+    Stopped = 2
+}
+/** Play state change listener type. */
+type PlayStateChangeListener = (playState: PlayState) => void;
 
 declare class AccidentalState {
     readonly measure: ObjMeasure;
@@ -345,11 +447,11 @@ declare class AccidentalState {
 
 declare class ConnectiveProps {
     readonly connective: Connective;
-    readonly span: ConnectiveSpan;
+    readonly span: number | TieType | `${TieType}`;
     noteAnchor: NoteAnchor;
     noteGroups: ObjNoteGroup[];
     arcDir: "up" | "down";
-    constructor(connective: Connective, span: ConnectiveSpan, noteAnchor: NoteAnchor, startNoteGroup: ObjNoteGroup);
+    constructor(connective: Connective, span: number | TieType | `${TieType}`, noteAnchor: NoteAnchor, startNoteGroup: ObjNoteGroup);
     getStartNoteGroup(): ObjNoteGroup;
     startsWith(noteGroup: ObjNoteGroup): boolean;
     /**
@@ -563,6 +665,7 @@ declare class ObjNoteGroup extends MusicObject {
     readonly staccato: boolean;
     readonly diamond: boolean;
     readonly arpeggio: Arpeggio | undefined;
+    readonly oldStyleTriplet: boolean;
     readonly rhythmProps: RhythmProps;
     private startConnnectives;
     private runningConnectives;
@@ -572,13 +675,12 @@ declare class ObjNoteGroup extends MusicObject {
     private readonly staffObjects;
     private readonly tabObjects;
     readonly mi: MNoteGroup;
-    constructor(col: ObjRhythmColumn, voiceId: number, notes: ReadonlyArray<Note>, noteLength: NoteLength, options?: NoteOptions);
+    constructor(col: ObjRhythmColumn, voiceId: number, notes: ReadonlyArray<Note>, noteLength: NoteLength | NoteLengthStr, options?: NoteOptions, tupletRatio?: TupletRatio);
     getMusicInterface(): MNoteGroup;
     get doc(): ObjDocument;
     get measure(): ObjMeasure;
     get row(): ObjScoreRow;
     get stemDir(): Stem.Up | Stem.Down;
-    get triplet(): boolean;
     enableConnective(line: ObjNotationLine): boolean;
     startConnective(connectiveProps: ConnectiveProps): void;
     getStaticObjects(line: ObjNotationLine): ReadonlyArray<MusicObject>;
@@ -596,7 +698,7 @@ declare class ObjNoteGroup extends MusicObject {
     removeConnectiveProps(): void;
     getPlaySlur(): "first" | "slurred" | undefined;
     getBeamGroup(): ObjBeamGroup | undefined;
-    setBeamGroup(beam: ObjBeamGroup): void;
+    setBeamGroup(beamGroup: ObjBeamGroup): void;
     resetBeamGroup(): void;
     getBeamCoords(): ({
         staff: ObjStaff;
@@ -618,15 +720,15 @@ declare class ObjNoteGroup extends MusicObject {
     offset(dx: number, dy: number): void;
     draw(renderer: Renderer): void;
     static setBeamCounts(groupNotes: (ObjNoteGroup | undefined)[]): void;
-    static setTripletBeamCounts(triplet: ObjBeamGroup): void;
+    static setTupletBeamCounts(tuplet: ObjBeamGroup): void;
     getDotVerticalDisplacement(staff: ObjStaff, diatonicId: number, stemDir: Stem): 1 | 0 | -1;
     static hasSameNotes(ng1: ObjNoteGroup, ng2: ObjNoteGroup): boolean;
 }
 
 declare enum BeamGroupType {
     RegularBeam = 0,
-    TripletBeam = 1,
-    TripletGroup = 2
+    TupletBeam = 1,
+    TupletGroup = 2
 }
 declare class BeamPoint {
     staff: ObjStaff;
@@ -643,8 +745,8 @@ declare class BeamPoint {
 declare class ObjStaffBeamGroup extends MusicObject {
     readonly staff: ObjStaff;
     readonly beamGroup: ObjBeamGroup;
-    tripletNumber?: ObjText;
-    tripletNumberOffsetY: number;
+    tupletNumber?: ObjText;
+    tupletNumberOffsetY: number;
     points: BeamPoint[];
     readonly mi: MStaffBeamGroup;
     constructor(staff: ObjStaff, beamGroup: ObjBeamGroup);
@@ -655,18 +757,21 @@ declare class ObjStaffBeamGroup extends MusicObject {
 }
 declare class ObjBeamGroup extends MusicObject {
     private readonly symbols;
+    readonly tupletRatio: TupletRatio & TupletOptions | undefined;
     readonly mi: MBeamGroup;
     private readonly type;
     private readonly staffObjects;
     private constructor();
+    private get showTupletRatio();
     static createBeam(noteGroups: ObjNoteGroup[]): void;
-    static createTriplet(symbols: RhythmSymbol[]): boolean;
+    static createOldStyleTriplet(symbols: RhythmSymbol[]): number;
+    static createTuplet(symbols: RhythmSymbol[], tupletRatio: TupletRatio & TupletOptions): void;
     getMusicInterface(): MBeamGroup;
     detach(): void;
     isEmpty(): boolean;
     pick(x: number, y: number): MusicObject[];
     getType(): BeamGroupType;
-    isTriplet(): boolean;
+    isTuplet(): boolean;
     getSymbols(): ReadonlyArray<RhythmSymbol>;
     getFirstSymbol(): RhythmSymbol | undefined;
     getLastSymbol(): RhythmSymbol | undefined;
@@ -682,7 +787,7 @@ declare class ObjStaffRest extends MusicObject {
     readonly staff: ObjStaff;
     readonly rest: ObjRest;
     restRect: DivRect;
-    dotRect?: DivRect;
+    dotRects: DivRect[];
     readonly mi: MStaffRest;
     constructor(staff: ObjStaff, rest: ObjRest);
     getMusicInterface(): MusicInterface;
@@ -697,23 +802,22 @@ declare class ObjRest extends MusicObject {
     readonly ownDiatonicId: number;
     readonly color: string;
     readonly hide: boolean;
+    readonly oldStyleTriplet: boolean;
     readonly rhythmProps: RhythmProps;
     private beamGroup?;
     readonly staffObjects: ObjStaffRest[];
     readonly mi: MRest;
-    constructor(col: ObjRhythmColumn, voiceId: number, noteLength: NoteLength, options?: RestOptions);
+    constructor(col: ObjRhythmColumn, voiceId: number, noteLength: NoteLength | NoteLengthStr, options?: RestOptions, tupletRatio?: TupletRatio);
     getMusicInterface(): MRest;
     get doc(): ObjDocument;
     get measure(): ObjMeasure;
     get row(): ObjScoreRow;
     get noteLength(): NoteLength;
-    get dotted(): boolean;
     get stemDir(): Stem.Up | Stem.Down;
-    get triplet(): boolean;
     getStaticObjects(line: ObjNotationLine): ReadonlyArray<MusicObject>;
     pick(x: number, y: number): MusicObject[];
     getBeamGroup(): ObjBeamGroup | undefined;
-    setBeamGroup(beam: ObjBeamGroup): void;
+    setBeamGroup(beamGroup: ObjBeamGroup): void;
     resetBeamGroup(): void;
     getBeamCoords(): ({
         staff: ObjStaff;
@@ -953,7 +1057,7 @@ declare class ObjMeasure extends MusicObject {
     setTimeSignature(timeSignature: TimeSignature | TimeSignatureString): void;
     updateTimeSignature(): void;
     getTempo(): Tempo;
-    setTempo(beatsPerMinute: number, beatLength?: NoteLength, dotted?: boolean): void;
+    setTempo(beatsPerMinute: number, beatLength?: NoteLength | NoteLengthStr, dotted?: boolean | number): void;
     updateTempo(): void;
     hasPostMeasureBreak(): boolean;
     getPostMeasureBreakWidth(): number;
@@ -968,7 +1072,7 @@ declare class ObjMeasure extends MusicObject {
     addConnective(connective: Connective.Tie, tieSpan?: number | TieType, notAnchor?: NoteAnchor): void;
     addConnective(connective: Connective.Slur, slurSpan?: number, notAnchor?: NoteAnchor): void;
     addConnective(connective: Connective.Slide, notAnchor?: NoteAnchor): void;
-    addExtension(extensionLength: number, extensionVisible: boolean): void;
+    addExtension(extensionLength: number | NoteLengthStr | (NoteLengthStr | number)[], extensionVisible: boolean): void;
     private enableExtension;
     private disableExtension;
     getEnding(): ObjEnding | undefined;
@@ -979,8 +1083,8 @@ declare class ObjMeasure extends MusicObject {
     hasEndSection(): boolean;
     endRow(): void;
     private addRhythmSymbol;
-    addNoteGroup(voiceId: number, notes: (Note | string)[], noteLength: NoteLength, options?: NoteOptions): void;
-    addRest(voiceId: number, restLength: NoteLength, options?: RestOptions): void;
+    addNoteGroup(voiceId: number, notes: (Note | string)[], noteLength: NoteLength | NoteLengthStr, options?: NoteOptions, tupletRatio?: TupletRatio): ObjNoteGroup;
+    addRest(voiceId: number, restLength: NoteLength | NoteLengthStr, options?: RestOptions, tupletRatio?: TupletRatio): ObjRest;
     /**
      *
      * @param positionTicks - get ObjRhythmColumn with positionTicks. Insert new if necessary.
@@ -988,7 +1092,7 @@ declare class ObjMeasure extends MusicObject {
      */
     private getRhythmColumn;
     getMeasureTicks(): number;
-    getConsumedTicks(voiceId?: number): number;
+    getConsumedTicks(voiceId?: VoiceId): number;
     getColumnsContentRect(): DivRect;
     getLeftSolidAreaWidth(): number;
     getMinColumnsAreaWidth(): number;
@@ -1010,7 +1114,7 @@ declare class ObjMeasure extends MusicObject {
     getBarLineLeft(): ObjBarLineLeft;
     getBarLineRight(): ObjBarLineRight;
     getVoiceSymbols(voiceId: number): ReadonlyArray<RhythmSymbol>;
-    completeRests(voiceId?: number): void;
+    completeRests(voiceId?: VoiceId | VoiceId[]): void;
     requestLayout(): void;
     layout(renderer: Renderer): void;
     layoutWidth(renderer: Renderer, width: number): void;
@@ -1450,350 +1554,750 @@ declare class ObjSignature extends MusicObject {
     draw(renderer: Renderer): void;
 }
 
+/** Score event type. */
 type ScoreEventType = "enter" | "leave" | "click";
+/** Abstract score event class. */
 declare abstract class ScoreEvent {
     readonly type: ScoreEventType;
+    /**
+     * Create new score event instance.
+     * @param type - Score event type.
+     */
     constructor(type: ScoreEventType);
 }
+/** Score staff position event for clicking/entering/leaving staff position (diatonic id) in staff notation line. */
 declare class ScoreStaffPosEvent extends ScoreEvent {
     readonly renderer: MRenderer;
     readonly scoreRow: MScoreRow;
     readonly diatonicId: number;
+    /**
+     * Create new score staff position event.
+     * @param type - Score event type.
+     * @param renderer - Renderer.
+     * @param scoreRow - Score row.
+     * @param diatonicId - Diatonic id that was clicked/entered/left.
+     */
     constructor(type: ScoreEventType, renderer: MRenderer, scoreRow: MScoreRow, diatonicId: number);
 }
+/** Score object event for clicking/entering/leaving score object. */
 declare class ScoreObjectEvent extends ScoreEvent {
     readonly renderer: MRenderer;
     readonly objects: MusicInterface[];
+    /**
+     * Create new score object event.
+     * @param type - Score event type.
+     * @param renderer - Renderer.
+     * @param objects - Array of objects, last object in this array is the top object that was clicked/entered/left, previous objects are it's parent objects.
+     */
     constructor(type: ScoreEventType, renderer: MRenderer, objects: MusicInterface[]);
+    /** Top object getter. */
     get topObject(): MusicInterface;
+    /**
+     * Find object.
+     * @param fn - Compare function.
+     * @returns - First object that matched compare function, or undefined if no match.
+     */
     findObject(fn: (obj: MusicInterface) => boolean): MusicInterface | undefined;
 }
+/** Score event listener type. */
 type ScoreEventListener = (event: ScoreEvent) => void;
 
+/** Music player class. */
+declare class MPlayer {
+    private static currentlyPlaying;
+    private readonly player;
+    /**
+     * Create new music player.
+     * @param doc - Music document to play.
+     * @param playStateChangeListener - Play state change listener.
+     */
+    constructor(doc: MDocument, playStateChangeListener?: PlayStateChangeListener);
+    /**
+     * Stop all playing.
+     */
+    static stopAll(): void;
+    /**
+     * Playe attached document.
+     * @returns - This player instance.
+     */
+    play(): this;
+    /**
+     * Pause playback of attached document.
+     * @returns - This player instance.
+     */
+    pause(): this;
+    /**
+     * Stop playback of attached document.
+     * @returns - This player instance.
+     */
+    stop(): this;
+}
+/** Renderer class. */
+declare class MRenderer {
+    private readonly renderer;
+    /**
+     * Create new renderer instance.
+     */
+    constructor();
+    /**
+     * Attach music document to this renderer.
+     * @param doc - Music document.
+     * @returns - This renderer instance.
+     */
+    setDocument(doc?: MDocument): MRenderer;
+    /**
+     * Set target canvas html element for this renderer.
+     * @param canvas - HTML canvas element or element id.
+     * @returns - This renderer instance.
+     */
+    setCanvas(canvas: HTMLCanvasElement | string): MRenderer;
+    /**
+     * Set score event listener.
+     * @param scoreEventListener - Score event listener.
+     */
+    setScoreEventListener(scoreEventListener: ScoreEventListener): void;
+    /**
+     * Draw given music object hilighted.
+     * @param obj - Music object or undefined to remove hilighting.
+     */
+    hilightObject(obj?: MusicInterface): void;
+    /**
+     * Draw given staff position hilighted.
+     * @param staffPos - Staff position (score row and diatonic id) or undefined to remove hilighting.
+     */
+    hilightStaffPos(staffPos?: {
+        scoreRow: MScoreRow;
+        diatonicId: number;
+    }): void;
+    /**
+     * Draw contents of attached music document to attached canvas.
+     */
+    draw(): void;
+}
+/** Playback buttons helper class. */
+declare class MPlaybackButtons {
+    private playButton?;
+    private stopButton?;
+    private playStopButton?;
+    private pauseButton?;
+    private onPlay;
+    private onStop;
+    private onPlayStop;
+    private onPause;
+    private playLabel;
+    private stopLabel;
+    private pauseLabel;
+    private playState;
+    private player?;
+    /**
+     * Create new playback buttons helper class instance.
+     */
+    constructor();
+    /**
+     * Attach music document whose playcak will be controlled by this playback buttons helper class instance.
+     * @param doc - Music document.
+     * @returns
+     */
+    setDocument(doc?: MDocument): MPlaybackButtons;
+    /**
+     * Detach attached music document.
+     */
+    detachDocument(): void;
+    private updateButtons;
+    /**
+     * Set play button.
+     * @param btn - HTML button element or element id.
+     * @param btnLabel - Custom button label (e.g. "Play").
+     * @returns - This playback buttons class instance.
+     */
+    setPlayButton(btn: HTMLButtonElement | string, btnLabel?: string): MPlaybackButtons;
+    /**
+     * Set stop button.
+     * @param btn - HTML button element or element id.
+     * @param btnLabel - Custom button label (e.g. "Stop").
+     * @returns - This playback buttons class instance.
+     */
+    setStopButton(btn: HTMLButtonElement | string, btnLabel?: string): MPlaybackButtons;
+    /**
+     * Set play/stop button.
+     * @param btn - HTML button element or element id.
+     * @param playLabel - Custom button label for play action (e.g. "Play").
+     * @param stopLabel - Custom button label for stop action (e.g. "Stop").
+     * @returns - This playback buttons class instance.
+     */
+    setPlayStopButton(btn: HTMLButtonElement | string, playLabel?: string, stopLabel?: string): MPlaybackButtons;
+    /**
+     * Set pause button.
+     * @param btn - HTML button element or element id.
+     * @param btnLabel - Custom button label (e.g. "Pause").
+     * @returns - This playback buttons class instance.
+     */
+    setPauseButton(btn: HTMLButtonElement | string, btnLabel?: string): MPlaybackButtons;
+    private static savedOnClickListeners;
+    private static removeOnClickListeners;
+    private static addOnClickListener;
+}
+
+/** Abstract music interface object class. */
 declare abstract class MusicInterface {
     readonly name: string;
+    /**
+     * Create new music interface object.
+     * @param name - OBject name.
+     */
     constructor(name: string);
     /** @internal */
     abstract getMusicObject(): MusicObject;
+    /**
+     * Get parent object.
+     * @returns - Parent object or undefined.
+     */
     getParent(): MusicInterface | undefined;
 }
+/** Accidental object. */
 declare class MAccidental extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "Accidental";
     /** @internal */
     constructor(obj: ObjAccidental);
     /** @internal */
     getMusicObject(): ObjAccidental;
+    /**
+     * Get accidental.
+     * @returns - Accidental (e.g. 1 = #).
+     */
     getAccidental(): Accidental;
 }
+/** Connective object. */
 declare class MConnective extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "Connective";
     /** @internal */
     constructor(obj: ObjConnective);
     /** @internal */
     getMusicObject(): ObjConnective;
 }
+/** Arpeggio object. */
 declare class MArpeggio extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "Arpeggio";
     /** @internal */
     constructor(obj: ObjArpeggio);
     /** @internal */
     getMusicObject(): ObjArpeggio;
+    /**
+     * Get rhythm column this arpeggio is in.
+     * @returns - Rhythm column.
+     */
     getRhythmColumn(): MRhythmColumn;
+    /**
+     * Get notation line this arpeggio is in.
+     * @returns - Staff or tab object.
+     */
     getNotationLine(): MStaff | MTab;
 }
+/** Beam group object. */
 declare class MBeamGroup extends MusicInterface {
     private readonly obj;
+    /** OBject name. */
     static readonly Name = "BeamGroup";
     /** @internal */
     constructor(obj: ObjBeamGroup);
     /** @internal */
     getMusicObject(): ObjBeamGroup;
 }
+/** Beam group object of certain staff. */
 declare class MStaffBeamGroup extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "StaffBeamGroup";
     /** @internal */
     constructor(obj: ObjStaffBeamGroup);
     /** @internal */
     getMusicObject(): ObjStaffBeamGroup;
+    /**
+     * Get staff this beam group is in.
+     * @returns - Staff object.
+     */
     getStaff(): MStaff;
 }
+/** Document object. */
 declare class MDocument extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "Document";
     /** @internal */
     constructor(obj: ObjDocument);
     /** @internal */
     getMusicObject(): ObjDocument;
+    /**
+     * Get title.
+     * @returns - Title string or undefined.
+     */
     getTitle(): string | undefined;
+    /**
+     * Get composer.
+     * @returns - Composer string or undefined.
+     */
     getComposer(): string | undefined;
+    /**
+     * Get arranger.
+     * @returns - Arranger string or undefined.
+     */
     getArranger(): string | undefined;
+    /**
+     * Get score rows.
+     * @returns - Array or score rows.
+     */
     getRows(): ReadonlyArray<MScoreRow>;
+    /**
+     * Get measures.
+     * @returns - Array of measures.
+     */
     getMeasures(): ReadonlyArray<MMeasure>;
-    play(fn?: PlayStateChangeListener): MPlayer;
+    /**
+     * Play this document.
+     * @param playStateChangeListener - Play state change listener function or undefined.
+     * @returns - Player instance.
+     */
+    play(playStateChangeListener?: PlayStateChangeListener): MPlayer;
 }
+/** Ending object. */
 declare class MEnding extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "Ending";
     /** @internal */
     constructor(obj: ObjEnding);
     /** @internal */
     getMusicObject(): ObjEnding;
+    /**
+     * Get passages.
+     * @returns - Array of passage numbers, e.g. passage number 1 means that this ending is played on first pass.
+     */
     getPassages(): ReadonlyArray<number>;
+    /**
+     * Has passage number?
+     * @param passage - Passage number to find out.
+     * @returns - Boolean whether this ending has asked passage number.
+     */
     hasPassage(passage: number): boolean;
 }
+/** Fermata object. */
 declare class MFermata extends MusicInterface {
     private readonly obj;
+    /** OBject name. */
     static readonly Name = "Fermata";
     /** @internal */
     constructor(obj: ObjFermata);
     /** @internal */
     getMusicObject(): ObjFermata;
 }
+/** Header object. */
 declare class MHeader extends MusicInterface {
     private readonly obj;
+    /** OBject name. */
     static readonly Name = "Header";
     /** @internal */
     constructor(obj: ObjHeader);
     /** @internal */
     getMusicObject(): ObjHeader;
+    /**
+     * Get title.
+     * @returns - Title string or undefined.
+     */
     getTitle(): string | undefined;
+    /**
+     * Get composer.
+     * @returns - Composer string or undefined.
+     */
     getComposer(): string | undefined;
+    /**
+     * Get arranger.
+     * @returns - Arranger string or undefined.
+     */
     getArranger(): string | undefined;
 }
+/** Image object. */
 declare class MImage extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "Image";
     /** @internal */
     constructor(obj: ObjImage);
     /** @internal */
     getMusicObject(): ObjImage;
 }
+/** Measure object. */
 declare class MMeasure extends MusicInterface {
     private readonly obj;
+    /** OBject name. */
     static readonly Name = "Measure";
     /** @internal */
     constructor(obj: ObjMeasure);
     /** @internal */
     getMusicObject(): ObjMeasure;
+    /**
+     * Get measure number.
+     * @returns - Measure number starting from 1, or 0 if upbeat.
+     */
     getMeasureNumber(): number;
+    /**
+     * Get rhythm columns.
+     * @returns - Array of rhythm columns.
+     */
     getRhythmColumns(): ReadonlyArray<MRhythmColumn>;
+    /**
+     * Get score row that this measure is in.
+     * @returns - Score row.
+     */
     getRow(): MScoreRow;
 }
+/** Right bar line object. */
 declare class MBarLineRight extends MusicInterface {
     private readonly obj;
+    /** OBject name. */
     static readonly Name = "BarLineRight";
     /** @internal */
     constructor(obj: ObjBarLineRight);
     /** @internal */
     getMusicObject(): ObjBarLineRight;
 }
+/** Left bar line object. */
 declare class MBarLineLeft extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "BarLineLeft";
     /** @internal */
     constructor(obj: ObjBarLineLeft);
     /** @internal */
     getMusicObject(): ObjBarLineLeft;
 }
+/** Bar line object for certain staff or tab. */
 declare class MStaffTabBarLine extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "StaffTabBarLine";
     /** @internal */
     constructor(obj: ObjStaffTabBarLine);
     /** @internal */
     getMusicObject(): ObjStaffTabBarLine;
+    /**
+     * Get parent bar line object.
+     * @returns - Parent bar line object.
+     */
     getBarLine(): MBarLineLeft | MBarLineRight;
+    /**
+     * Get staff or tab this bar lien object is in.
+     * @returns - Staff or tab.
+     */
     getNotationLine(): MStaff | MTab;
 }
+/** Note group object. */
 declare class MNoteGroup extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "NoteGroup";
     /** @internal */
     constructor(obj: ObjNoteGroup);
     /** @internal */
     getMusicObject(): ObjNoteGroup;
+    /**
+     * Get notes of this note group.
+     * @returns - Array of Note instances.
+     */
     getNotes(): ReadonlyArray<Note>;
+    /**
+     * Get rhythm props of this note group.
+     * @returns - Rhythm props.
+     */
     getRhythmProps(): RhythmProps;
+    /**
+     * Get rhythm column this note group is in.
+     * @returns - Rhythm column.
+     */
     getRhythmColumn(): MRhythmColumn;
+    /**
+     * Get the measure this note group is in.
+     * @returns - Measure.
+     */
     getMeasure(): MMeasure;
 }
+/** Note group object of certain staff. */
 declare class MStaffNoteGroup extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "StaffNoteGroup";
     /** @internal */
     constructor(obj: ObjStaffNoteGroup);
     /** @internal */
     getMusicObject(): ObjStaffNoteGroup;
+    /**
+     * Get parent note group.
+     * @returns - Parent note group.
+     */
     getNoteGroup(): MNoteGroup;
+    /**
+     * Get rhythm column this note group is in.
+     * @returns - Rhythm column.
+     */
     getRhythmColumn(): MRhythmColumn;
+    /**
+     * Get the measure this note group is in.
+     * @returns - Measure.
+     */
     getMeasure(): MMeasure;
+    /**
+     * Get staff notation line this note group is in.
+     * @returns - Staff object.
+     */
     getStaff(): MStaff;
 }
+/** Note group object of certain tab. Contains fret numbers for tab. */
 declare class MTabNoteGroup extends MusicInterface {
     private readonly obj;
+    /** OBject name. */
     static readonly Name = "TabNoteGroup";
     /** @internal */
     constructor(obj: ObjTabNoteGroup);
     /** @internal */
     getMusicObject(): ObjTabNoteGroup;
+    /**
+     * Get parent note group.
+     * @returns - Parent note group.
+     */
     getNoteGroup(): MNoteGroup;
+    /**
+     * Get rhythm column this note group is in.
+     * @returns - Rhythm column.
+     */
     getRhythmColumn(): MRhythmColumn;
+    /**
+     * Get the measure this note group is in.
+     * @returns - Measure.
+     */
     getMeasure(): MMeasure;
+    /**
+     * Get guitar tab this note group is in.
+     * @returns - Tab object.
+     */
     getTab(): MTab;
 }
+/** Rest object. */
 declare class MRest extends MusicInterface {
     private readonly obj;
+    /** OBject name. */
     static readonly Name = "Rest";
     /** @internal */
     constructor(obj: ObjRest);
     /** @internal */
     getMusicObject(): ObjRest;
+    /**
+     * Get rhythm props of this rest.
+     * @returns - Rhythm props.
+     */
     getRhythmProps(): RhythmProps;
+    /**
+     * Get rhythm column this rest is in.
+     * @returns - Rhythm column.
+     */
     getRhythmColumn(): MRhythmColumn;
+    /**
+     * Get the measure this rest is in.
+     * @returns - Measure.
+     */
     getMeasure(): MMeasure;
 }
+/** Rest object for certain tab. */
 declare class MStaffRest extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "StaffRest";
     /** @internal */
     constructor(obj: ObjStaffRest);
     /** @internal */
     getMusicObject(): ObjStaffRest;
+    /**
+     * Get parent rest object.
+     * @returns - Parent rest object.
+     */
     getRest(): MRest;
+    /**
+     * Get rhythm column this rest is in.
+     * @returns - Rhythm column.
+     */
     getRhythmColumn(): MRhythmColumn;
+    /**
+     * Get the measure this rest is in.
+     * @returns - Measure.
+     */
     getMeasure(): MMeasure;
+    /**
+     * Get staff notation line this rest is in.
+     * @returns - Staff object.
+     */
     getStaff(): MStaff;
 }
+/** Rhythm column object. */
 declare class MRhythmColumn extends MusicInterface {
     private readonly obj;
+    /** OBject name. */
     static readonly Name = "RhythmColumn";
     /** @internal */
     constructor(obj: ObjRhythmColumn);
     /** @internal */
     getMusicObject(): ObjRhythmColumn;
+    /**
+     * Get symbol (note group or rest) of this column for given voice id.
+     * @param voiceId - Voice id.
+     * @returns - Note group, rest or undefined.
+     */
     getRhythmSymbol(voiceId: number): MNoteGroup | MRest | undefined;
-    getMeasure(): MMeasure;
+    /**
+     * Get symbol (note group or rest) of this column for given voice id.
+     * @deprecated - Use getRhythmSymbol(voiceId) instead.
+     * @param voiceId - Voice id.
+     * @returns - Note group, rest or undefined.
+     */
     getVoiceSymbol(voiceId: VoiceId): MNoteGroup | MRest | undefined;
+    /**
+     * Get the measure this rhythm column is in.
+     * @returns - Measure.
+     */
+    getMeasure(): MMeasure;
 }
+/** Score row object. */
 declare class MScoreRow extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "ScoreRow";
     /** @internal */
     constructor(obj: ObjScoreRow);
     /** @internal */
     getMusicObject(): ObjScoreRow;
+    /**
+     * Parent music document.
+     * @returns - Parent music document.
+     */
     getDocument(): MDocument;
+    /**
+     * Get measures of this score row.
+     * @returns - Array of measures.
+     */
     getMeasures(): ReadonlyArray<MMeasure>;
+    /**
+     * Get notation lines (staves and tabs) of this score row.
+     * @returns - Array of staves and tabs.
+     */
     getNotationLines(): ReadonlyArray<MStaff | MTab>;
 }
+/** Staff notatio line object. */
 declare class MStaff extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "Staff";
     /** @internal */
     constructor(obj: ObjStaff);
     /** @internal */
     getMusicObject(): ObjStaff;
+    /**
+     * Get index of this staff in score row.
+     * @returns - Index (0=top notation line).
+     */
     getId(): number;
+    /**
+     * Get name of this staff.
+     * @returns - Staff name.
+     */
     getName(): string | undefined;
+    /**
+     * Get the score row this staff is in.
+     * @returns - Score row.
+     */
     getRow(): MScoreRow;
 }
+/** Guitar tab notation line object. */
 declare class MTab extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "Tab";
     /** @internal */
     constructor(obj: ObjTab);
     /** @internal */
     getMusicObject(): ObjTab;
+    /**
+     * Get index of this guitar tab in score row.
+     * @returns - Index (0=top notation line).
+     */
     getId(): number;
+    /**
+     * Get name of this guitar tab.
+     * @returns - Staff name.
+     */
     getName(): string | undefined;
+    /**
+     * Get the score row this guitar tab is in.
+     * @returns - Score row.
+     */
     getRow(): MScoreRow;
 }
+/** Signature object contains clef, key signature, time signature and tempo, all optional depending on measure. */
 declare class MSignature extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "Signature";
     /** @internal */
     constructor(obj: ObjSignature);
     /** @internal */
     getMusicObject(): ObjSignature;
+    /**
+     * Get staff notation line this signature is in.
+     * @returns - Staff object.
+     */
     getStaff(): MStaff;
 }
+/** Spacial text object contains text and possibly special symbols (e.g. Segno or Coda). */
 declare class MSpecialText extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "SpecialText";
     /** @internal */
     constructor(obj: ObjSpecialText);
     /** @internal */
     getMusicObject(): ObjSpecialText;
+    /**
+     * Get text content.
+     * @returns - Text content.
+     */
     getText(): string;
 }
+/** Text object. */
 declare class MText extends MusicInterface {
     private readonly obj;
+    /** Object name. */
     static readonly Name = "Text";
     /** @internal */
     constructor(obj: ObjText);
     /** @internal */
     getMusicObject(): ObjText;
+    /**
+     * Get text content.
+     * @returns - Text content.
+     */
     getText(): string;
 }
+/** Extension line object. */
 declare class MExtensionLine extends MusicInterface {
     private readonly obj;
+    /** OBject name. */
     static readonly Name = "ExtensionLine";
     /** @internal */
     constructor(obj: ObjExtensionLine);
     /** @internal */
     getMusicObject(): ObjExtensionLine;
 }
-declare class MPlayer {
-    private static currentlyPlaying;
-    private readonly player;
-    constructor(doc: MDocument, fn?: PlayStateChangeListener);
-    static stopAll(): void;
-    play(): this;
-    pause(): this;
-    stop(): this;
-}
-declare class MRenderer {
-    private readonly renderer;
-    constructor();
-    setDocument(doc?: MDocument): this;
-    setCanvas(canvas: HTMLCanvasElement | string): this;
-    setScoreEventListener(fn: ScoreEventListener): void;
-    hilightObject(obj?: MusicInterface): void;
-    hilightStaffPos(staffPos?: {
-        scoreRow: MScoreRow;
-        diatonicId: number;
-    }): void;
-    draw(): void;
-}
-declare class MPlaybackButtons {
-    private playButton?;
-    private stopButton?;
-    private playStopButton?;
-    private pauseButton?;
-    private onPlay;
-    private onStop;
-    private onPlayStop;
-    private onPause;
-    private playLabel;
-    private stopLabel;
-    private pauseLabel;
-    private playState;
-    private player?;
-    constructor();
-    setDocument(doc?: MDocument): this;
-    detachDocument(): void;
-    private updateButtons;
-    setPlayButton(btn: HTMLButtonElement | string, btnLabel?: string): this;
-    setStopButton(btn: HTMLButtonElement | string, btnLabel?: string): this;
-    setPlayStopButton(btn: HTMLButtonElement | string, playLabel?: string, stopLabel?: string): this;
-    setPauseButton(btn: HTMLButtonElement | string, btnLabel?: string): this;
-    private static savedOnClickListeners;
-    private static removeOnClickListeners;
-    private static addOnClickListener;
-}
 
-export { type VoiceId as $, Annotation as A, MRest as B, Connective as C, DivRect as D, MStaffRest as E, Fermata as F, MRhythmColumn as G, MScoreRow as H, MStaff as I, MTab as J, MSignature as K, Label as L, MDocument as M, type NoteOptions as N, MSpecialText as O, MText as P, MExtensionLine as Q, type RestOptions as R, StaffPreset as S, TieType as T, MPlayer as U, VerticalPosition as V, MRenderer as W, MPlaybackButtons as X, Clef as Y, type StaffConfig as Z, type TabConfig as _, type ScoreConfiguration as a, getVoiceIds as a0, type StringNumber as a1, getStringNumbers as a2, Stem as a3, Arpeggio as a4, type ConnectiveSpan as a5, type StaffTabOrGroup as a6, PlayState as a7, type PlayStateChangeListener as a8, type StaffTabOrGroups as b, Navigation as c, NoteAnchor as d, type ScoreEventType as e, ScoreEvent as f, ScoreStaffPosEvent as g, ScoreObjectEvent as h, type ScoreEventListener as i, MusicInterface as j, MAccidental as k, MConnective as l, MArpeggio as m, MBeamGroup as n, MStaffBeamGroup as o, MEnding as p, MFermata as q, MHeader as r, MImage as s, MMeasure as t, MBarLineRight as u, MBarLineLeft as v, MStaffTabBarLine as w, MNoteGroup as x, MStaffNoteGroup as y, MTabNoteGroup as z };
+export { Clef as $, type AnnotationText as A, MBarLineRight as B, Connective as C, DivRect as D, MBarLineLeft as E, Fermata as F, MStaffTabBarLine as G, MNoteGroup as H, MStaffNoteGroup as I, MTabNoteGroup as J, MRest as K, Label as L, MDocument as M, type NoteOptions as N, MStaffRest as O, MRhythmColumn as P, MScoreRow as Q, type RestOptions as R, StaffPreset as S, type TupletOptions as T, MStaff as U, type VoiceId as V, MTab as W, MSignature as X, MSpecialText as Y, MText as Z, MExtensionLine as _, type ScoreConfiguration as a, type StaffConfig as a0, type TabConfig as a1, getVoiceIds as a2, type StringNumber as a3, getStringNumbers as a4, Stem as a5, Arpeggio as a6, type StaffTabOrGroup as a7, DynamicsAnnotation as a8, TempoAnnotation as a9, PlayState as aa, type PlayStateChangeListener as ab, type StaffTabOrGroups as b, Navigation as c, Annotation as d, TieType as e, NoteAnchor as f, VerticalPosition as g, type ScoreEventType as h, ScoreEvent as i, ScoreStaffPosEvent as j, ScoreObjectEvent as k, type ScoreEventListener as l, MPlayer as m, MRenderer as n, MPlaybackButtons as o, MusicInterface as p, MAccidental as q, MConnective as r, MArpeggio as s, MBeamGroup as t, MStaffBeamGroup as u, MEnding as v, MFermata as w, MHeader as x, MImage as y, MMeasure as z };