@tspro/web-music-score 4.1.0 → 4.2.0

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

@@ -1,5 +1,5 @@
 import { N as Note, A as Accidental } from './note-eA2xPPiG.mjs';
-import { R as RhythmProps, N as NoteLength, i as NoteLengthStr, k as TupletRatio, d as Tempo, K as KeySignature, b as TimeSignature } from './tempo-S85Q7uJA.mjs';
+import { R as RhythmProps, N as NoteLength, i as NoteLengthStr, k as TupletRatio, d as Tempo, K as KeySignature, b as TimeSignature } from './tempo-dkctPkCS.mjs';
 import { Vec2 } from '@tspro/ts-utils-lib';
 
 /**
@@ -256,14 +256,18 @@ type TabConfig = {
 };
 /** Score configuration. */
 type ScoreConfiguration = StaffConfig | TabConfig | (StaffConfig | TabConfig)[];
-/** VoiceId type. */
+/** Voice id. */
 type VoiceId = 0 | 1 | 2 | 3;
-/** Get supported VoiceIds. Returns [0, 1, 2, 3]. */
+/** Get supported voice ids. Returns [0, 1, 2, 3]. */
 declare function getVoiceIds(): ReadonlyArray<VoiceId>;
-/** Strng number type. */
+/** Strng number. */
 type StringNumber = 1 | 2 | 3 | 4 | 5 | 6;
-/** Get strin numbers. Returns [0, 1, 2, 3, 4, 5]. */
+/** Get string numbers. Returns [0, 1, 2, 3, 4, 5]. */
 declare function getStringNumbers(): ReadonlyArray<StringNumber>;
+/** Verse number. */
+type VerseNumber = 1 | 2 | 3;
+/** Get supported verse numbers. Returns [1, 2, 3]. */
+declare function getVerseNumbers(): ReadonlyArray<VerseNumber>;
 /** Stem direction enum. */
 declare enum Stem {
     /** Auto stem direction. */
@@ -361,6 +365,29 @@ type TupletOptions = {
     /** Show tuplet ratio (e.g. "3:2") instead of number of parts (e.g. "3"). */
     showRatio?: boolean;
 };
+/** Lyrics text/syllable alignment.*/
+declare enum LyricsAlign {
+    /** Left align lyrics text/syllable. */
+    Left = "left",
+    /** Center align lyrics text/syllable. */
+    Center = "center",
+    /** Right align lyrics text/syllable. */
+    Right = "right"
+}
+/** Lyrics hyphen.*/
+declare enum LyricsHyphen {
+    /** Hyphen. */
+    Hyphen = "-",
+    /** Extender. */
+    Extender = "---"
+}
+/** Lyrics options. */
+type LyricsOptions = {
+    /** Alignment of lyrics text/syllable. */
+    align?: LyricsAlign | `${LyricsAlign}`;
+    /** Hyphen or extender after lyrics text/syllable. */
+    hyphen?: LyricsHyphen | `${LyricsHyphen}`;
+};
 /** Fermata enum. */
 declare enum Fermata {
     /** Anchor fermata to note/rest. */
@@ -660,7 +687,7 @@ declare class ObjTabNoteGroup extends MusicObject {
 }
 declare class ObjNoteGroup extends MusicObject {
     readonly col: ObjRhythmColumn;
-    readonly voiceId: number;
+    readonly voiceId: VoiceId;
     readonly notes: ReadonlyArray<Note>;
     readonly minDiatonicId: number;
     readonly maxDiatonicId: number;
@@ -681,7 +708,7 @@ declare class ObjNoteGroup extends MusicObject {
     private readonly staffObjects;
     private readonly tabObjects;
     readonly mi: MNoteGroup;
-    constructor(col: ObjRhythmColumn, voiceId: number, notes: ReadonlyArray<Note>, noteLength: NoteLength | NoteLengthStr, options?: NoteOptions, tupletRatio?: TupletRatio);
+    constructor(col: ObjRhythmColumn, voiceId: VoiceId, notes: ReadonlyArray<Note>, noteLength: NoteLength | NoteLengthStr, options?: NoteOptions, tupletRatio?: TupletRatio);
     getMusicInterface(): MNoteGroup;
     get doc(): ObjDocument;
     get measure(): ObjMeasure;
@@ -803,7 +830,7 @@ declare class ObjStaffRest extends MusicObject {
 }
 declare class ObjRest extends MusicObject {
     readonly col: ObjRhythmColumn;
-    readonly voiceId: number;
+    readonly voiceId: VoiceId;
     readonly ownStemDir: Stem.Up | Stem.Down;
     readonly ownDiatonicId: number;
     readonly color: string;
@@ -813,7 +840,7 @@ declare class ObjRest extends MusicObject {
     private beamGroup?;
     readonly staffObjects: ObjStaffRest[];
     readonly mi: MRest;
-    constructor(col: ObjRhythmColumn, voiceId: number, noteLength: NoteLength | NoteLengthStr, options?: RestOptions, tupletRatio?: TupletRatio);
+    constructor(col: ObjRhythmColumn, voiceId: VoiceId, noteLength: NoteLength | NoteLengthStr, options?: RestOptions, tupletRatio?: TupletRatio);
     getMusicInterface(): MRest;
     get doc(): ObjDocument;
     get measure(): ObjMeasure;
@@ -841,6 +868,34 @@ declare class ObjRest extends MusicObject {
     draw(renderer: Renderer): void;
 }
 
+declare class LyricsContainer {
+    readonly col: ObjRhythmColumn;
+    readonly lyricsObjects: ObjLyrics[];
+    readonly rhythmProps: RhythmProps;
+    constructor(col: ObjRhythmColumn, lyricsLength: NoteLength);
+    addLyricsObject(lyricsObj: ObjLyrics): void;
+}
+declare class ObjLyrics extends MusicObject {
+    readonly col: ObjRhythmColumn;
+    readonly verse: VerseNumber;
+    readonly line: ObjNotationLine;
+    readonly vpos: VerticalPos;
+    private nextLyricsObject?;
+    private readonly color;
+    private readonly hyphen?;
+    private readonly text;
+    readonly mi: MLyrics;
+    constructor(col: ObjRhythmColumn, verse: VerseNumber, line: ObjNotationLine, vpos: VerticalPos, lyricsText: string, lyricsOptions?: LyricsOptions);
+    getMusicInterface(): MLyrics;
+    get measure(): ObjMeasure;
+    getText(): string;
+    setNextLyricsObject(lyricsObj: ObjLyrics): void;
+    pick(x: number, y: number): MusicObject[];
+    layout(renderer: Renderer): void;
+    offset(dx: number, dy: number): void;
+    draw(renderer: Renderer): void;
+}
+
 type ScorePlayerNote = {
     note: Note;
     ticks: number;
@@ -848,10 +903,17 @@ type ScorePlayerNote = {
     slur: undefined | "first" | "slurred";
 };
 type RhythmSymbol = ObjNoteGroup | ObjRest;
+type LyricsContainerData = {
+    lyricsContainer: LyricsContainer;
+    verse: VerseNumber;
+    line: ObjNotationLine;
+    vpos: VerticalPos;
+};
 declare class ObjRhythmColumn extends MusicObject {
     readonly measure: ObjMeasure;
     readonly positionTicks: number;
     private readonly voiceSymbol;
+    private readonly lyricsContainers;
     private minDiatonicId?;
     private maxDiatonicId?;
     private staffMinDiatonicId;
@@ -885,8 +947,10 @@ declare class ObjRhythmColumn extends MusicObject {
     pick(x: number, y: number): MusicObject[];
     hasArpeggio(): boolean;
     getArpeggioDir(): Arpeggio;
-    setVoiceSymbol(voiceId: number, symbol: RhythmSymbol): void;
-    getVoiceSymbol(voiceId: number): RhythmSymbol | undefined;
+    setVoiceSymbol(voiceId: VoiceId, symbol: RhythmSymbol): void;
+    getVoiceSymbol(voiceId: VoiceId): RhythmSymbol | undefined;
+    getLyricsContainerDatas(): ReadonlyArray<LyricsContainerData>;
+    getLyricsContainer(verse: VerseNumber, line: ObjNotationLine, vpos: VerticalPos, lyricsLength?: NoteLength): LyricsContainer | undefined;
     getMinWidth(): number;
     setupNoteHeadDisplacements(): void;
     getNoteHeadDisplacement(noteGroup: ObjNoteGroup, note: Note): -1 | 0 | 1;
@@ -1035,6 +1099,7 @@ declare class ObjMeasure extends MusicObject {
     private endRepeatPlayCount;
     private endRepeatPlayCountText?;
     private staticObjectsCache;
+    private lyricsObjectsCache;
     readonly mi: MMeasure;
     constructor(row: ObjScoreRow);
     getMusicInterface(): MMeasure;
@@ -1089,8 +1154,9 @@ declare class ObjMeasure extends MusicObject {
     hasEndSection(): boolean;
     endRow(): void;
     private addRhythmSymbol;
-    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;
+    addNoteGroup(voiceId: VoiceId, notes: (Note | string)[], noteLength: NoteLength | NoteLengthStr, options?: NoteOptions, tupletRatio?: TupletRatio): ObjNoteGroup;
+    addRest(voiceId: VoiceId, restLength: NoteLength | NoteLengthStr, options?: RestOptions, tupletRatio?: TupletRatio): ObjRest;
+    addLyrics(staffTabOrGroups: StaffTabOrGroups | undefined, verse: VerseNumber, lyricsLength: NoteLength | NoteLengthStr, lyricsText: string, lyricsOptions: LyricsOptions): void;
     /**
      *
      * @param positionTicks - get ObjRhythmColumn with positionTicks. Insert new if necessary.
@@ -1107,6 +1173,8 @@ declare class ObjMeasure extends MusicObject {
     getMinWidth(): number;
     getStaffLineLeft(): number;
     getStaffLineRight(): number;
+    private getLyricsObjects;
+    getPrevLyricsObject(lyricsObj: ObjLyrics): ObjLyrics | undefined;
     getStaticObjects(line: ObjNotationLine): ReadonlyArray<MusicObject>;
     removeLayoutObjects(musicObj: MusicObject): void;
     addConnectiveObject(connective: ObjConnective): void;
@@ -1119,7 +1187,7 @@ declare class ObjMeasure extends MusicObject {
     private static setupBeamGroup;
     getBarLineLeft(): ObjBarLineLeft;
     getBarLineRight(): ObjBarLineRight;
-    getVoiceSymbols(voiceId: number): ReadonlyArray<RhythmSymbol>;
+    getVoiceSymbols(voiceId: VoiceId): ReadonlyArray<RhythmSymbol>;
     completeRests(voiceId?: VoiceId | VoiceId[]): void;
     requestLayout(): void;
     layout(renderer: Renderer): void;
@@ -1216,7 +1284,7 @@ declare class ObjDocument extends MusicObject {
     addMeasure(): ObjMeasure;
     addStaffGroup(groupName: string, layoutElements: number | string | (number | string)[], verticalPosition: VerticalPosition): void;
     getStaffGroup(groupName: string): StaffGroup | undefined;
-    getVoiceSymbols(voiceId: number): ReadonlyArray<RhythmSymbol>;
+    getVoiceSymbols(voiceId: VoiceId): ReadonlyArray<RhythmSymbol>;
     removeLayoutObjects(musicObj: MusicObject): void;
     private forEachMeasure;
     resetMeasures(): void;
@@ -1397,13 +1465,16 @@ declare enum LayoutGroupId {
     Ending = 3,
     TempoAnnotation = 4,
     DynamicsAnnotation = 5,
-    ChordLabel = 6
+    ChordLabel = 6,
+    LyricsVerse1 = 7,
+    LyricsVerse2 = 8,
+    LyricsVerse3 = 9
 }
 declare enum VerticalPos {
     Above = 0,
     Below = 1
 }
-type LayoutableMusicObject = ObjText | ObjSpecialText | ObjExtensionLine | ObjFermata | ObjEnding;
+type LayoutableMusicObject = ObjText | ObjSpecialText | ObjExtensionLine | ObjFermata | ObjEnding | ObjLyrics;
 declare class StaffGroup {
     readonly groupName: string;
     readonly staffsTabsAndGroups: number | string | (number | string)[];
@@ -2161,7 +2232,7 @@ declare class MRhythmColumn extends MusicInterface {
      * @param voiceId - Voice id.
      * @returns - Note group, rest or undefined.
      */
-    getRhythmSymbol(voiceId: number): MNoteGroup | MRest | undefined;
+    getRhythmSymbol(voiceId: VoiceId): MNoteGroup | MRest | undefined;
     /**
      * Get symbol (note group or rest) of this column for given voice id.
      * @deprecated - Use getRhythmSymbol(voiceId) instead.
@@ -2295,6 +2366,21 @@ declare class MText extends MusicInterface {
      */
     getText(): string;
 }
+/** Lyrics object. */
+declare class MLyrics extends MusicInterface {
+    private readonly obj;
+    /** Object name. */
+    static readonly Name = "Lyrics";
+    /** @internal */
+    constructor(obj: ObjLyrics);
+    /** @internal */
+    getMusicObject(): ObjLyrics;
+    /**
+     * Get lyrics text.
+     * @returns - Lyrics text.
+     */
+    getText(): string;
+}
 /** Extension line object. */
 declare class MExtensionLine extends MusicInterface {
     private readonly obj;
@@ -2306,4 +2392,4 @@ declare class MExtensionLine extends MusicInterface {
     getMusicObject(): ObjExtensionLine;
 }
 
-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 };
+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 };

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

@@ -1,5 +1,5 @@
 import { N as Note, A as Accidental } from './note-eA2xPPiG.js';
-import { R as RhythmProps, N as NoteLength, i as NoteLengthStr, k as TupletRatio, d as Tempo, K as KeySignature, b as TimeSignature } from './tempo-Bp1UzsrZ.js';
+import { R as RhythmProps, N as NoteLength, i as NoteLengthStr, k as TupletRatio, d as Tempo, K as KeySignature, b as TimeSignature } from './tempo-GrstpD9G.js';
 import { Vec2 } from '@tspro/ts-utils-lib';
 
 /**
@@ -256,14 +256,18 @@ type TabConfig = {
 };
 /** Score configuration. */
 type ScoreConfiguration = StaffConfig | TabConfig | (StaffConfig | TabConfig)[];
-/** VoiceId type. */
+/** Voice id. */
 type VoiceId = 0 | 1 | 2 | 3;
-/** Get supported VoiceIds. Returns [0, 1, 2, 3]. */
+/** Get supported voice ids. Returns [0, 1, 2, 3]. */
 declare function getVoiceIds(): ReadonlyArray<VoiceId>;
-/** Strng number type. */
+/** Strng number. */
 type StringNumber = 1 | 2 | 3 | 4 | 5 | 6;
-/** Get strin numbers. Returns [0, 1, 2, 3, 4, 5]. */
+/** Get string numbers. Returns [0, 1, 2, 3, 4, 5]. */
 declare function getStringNumbers(): ReadonlyArray<StringNumber>;
+/** Verse number. */
+type VerseNumber = 1 | 2 | 3;
+/** Get supported verse numbers. Returns [1, 2, 3]. */
+declare function getVerseNumbers(): ReadonlyArray<VerseNumber>;
 /** Stem direction enum. */
 declare enum Stem {
     /** Auto stem direction. */
@@ -361,6 +365,29 @@ type TupletOptions = {
     /** Show tuplet ratio (e.g. "3:2") instead of number of parts (e.g. "3"). */
     showRatio?: boolean;
 };
+/** Lyrics text/syllable alignment.*/
+declare enum LyricsAlign {
+    /** Left align lyrics text/syllable. */
+    Left = "left",
+    /** Center align lyrics text/syllable. */
+    Center = "center",
+    /** Right align lyrics text/syllable. */
+    Right = "right"
+}
+/** Lyrics hyphen.*/
+declare enum LyricsHyphen {
+    /** Hyphen. */
+    Hyphen = "-",
+    /** Extender. */
+    Extender = "---"
+}
+/** Lyrics options. */
+type LyricsOptions = {
+    /** Alignment of lyrics text/syllable. */
+    align?: LyricsAlign | `${LyricsAlign}`;
+    /** Hyphen or extender after lyrics text/syllable. */
+    hyphen?: LyricsHyphen | `${LyricsHyphen}`;
+};
 /** Fermata enum. */
 declare enum Fermata {
     /** Anchor fermata to note/rest. */
@@ -660,7 +687,7 @@ declare class ObjTabNoteGroup extends MusicObject {
 }
 declare class ObjNoteGroup extends MusicObject {
     readonly col: ObjRhythmColumn;
-    readonly voiceId: number;
+    readonly voiceId: VoiceId;
     readonly notes: ReadonlyArray<Note>;
     readonly minDiatonicId: number;
     readonly maxDiatonicId: number;
@@ -681,7 +708,7 @@ declare class ObjNoteGroup extends MusicObject {
     private readonly staffObjects;
     private readonly tabObjects;
     readonly mi: MNoteGroup;
-    constructor(col: ObjRhythmColumn, voiceId: number, notes: ReadonlyArray<Note>, noteLength: NoteLength | NoteLengthStr, options?: NoteOptions, tupletRatio?: TupletRatio);
+    constructor(col: ObjRhythmColumn, voiceId: VoiceId, notes: ReadonlyArray<Note>, noteLength: NoteLength | NoteLengthStr, options?: NoteOptions, tupletRatio?: TupletRatio);
     getMusicInterface(): MNoteGroup;
     get doc(): ObjDocument;
     get measure(): ObjMeasure;
@@ -803,7 +830,7 @@ declare class ObjStaffRest extends MusicObject {
 }
 declare class ObjRest extends MusicObject {
     readonly col: ObjRhythmColumn;
-    readonly voiceId: number;
+    readonly voiceId: VoiceId;
     readonly ownStemDir: Stem.Up | Stem.Down;
     readonly ownDiatonicId: number;
     readonly color: string;
@@ -813,7 +840,7 @@ declare class ObjRest extends MusicObject {
     private beamGroup?;
     readonly staffObjects: ObjStaffRest[];
     readonly mi: MRest;
-    constructor(col: ObjRhythmColumn, voiceId: number, noteLength: NoteLength | NoteLengthStr, options?: RestOptions, tupletRatio?: TupletRatio);
+    constructor(col: ObjRhythmColumn, voiceId: VoiceId, noteLength: NoteLength | NoteLengthStr, options?: RestOptions, tupletRatio?: TupletRatio);
     getMusicInterface(): MRest;
     get doc(): ObjDocument;
     get measure(): ObjMeasure;
@@ -841,6 +868,34 @@ declare class ObjRest extends MusicObject {
     draw(renderer: Renderer): void;
 }
 
+declare class LyricsContainer {
+    readonly col: ObjRhythmColumn;
+    readonly lyricsObjects: ObjLyrics[];
+    readonly rhythmProps: RhythmProps;
+    constructor(col: ObjRhythmColumn, lyricsLength: NoteLength);
+    addLyricsObject(lyricsObj: ObjLyrics): void;
+}
+declare class ObjLyrics extends MusicObject {
+    readonly col: ObjRhythmColumn;
+    readonly verse: VerseNumber;
+    readonly line: ObjNotationLine;
+    readonly vpos: VerticalPos;
+    private nextLyricsObject?;
+    private readonly color;
+    private readonly hyphen?;
+    private readonly text;
+    readonly mi: MLyrics;
+    constructor(col: ObjRhythmColumn, verse: VerseNumber, line: ObjNotationLine, vpos: VerticalPos, lyricsText: string, lyricsOptions?: LyricsOptions);
+    getMusicInterface(): MLyrics;
+    get measure(): ObjMeasure;
+    getText(): string;
+    setNextLyricsObject(lyricsObj: ObjLyrics): void;
+    pick(x: number, y: number): MusicObject[];
+    layout(renderer: Renderer): void;
+    offset(dx: number, dy: number): void;
+    draw(renderer: Renderer): void;
+}
+
 type ScorePlayerNote = {
     note: Note;
     ticks: number;
@@ -848,10 +903,17 @@ type ScorePlayerNote = {
     slur: undefined | "first" | "slurred";
 };
 type RhythmSymbol = ObjNoteGroup | ObjRest;
+type LyricsContainerData = {
+    lyricsContainer: LyricsContainer;
+    verse: VerseNumber;
+    line: ObjNotationLine;
+    vpos: VerticalPos;
+};
 declare class ObjRhythmColumn extends MusicObject {
     readonly measure: ObjMeasure;
     readonly positionTicks: number;
     private readonly voiceSymbol;
+    private readonly lyricsContainers;
     private minDiatonicId?;
     private maxDiatonicId?;
     private staffMinDiatonicId;
@@ -885,8 +947,10 @@ declare class ObjRhythmColumn extends MusicObject {
     pick(x: number, y: number): MusicObject[];
     hasArpeggio(): boolean;
     getArpeggioDir(): Arpeggio;
-    setVoiceSymbol(voiceId: number, symbol: RhythmSymbol): void;
-    getVoiceSymbol(voiceId: number): RhythmSymbol | undefined;
+    setVoiceSymbol(voiceId: VoiceId, symbol: RhythmSymbol): void;
+    getVoiceSymbol(voiceId: VoiceId): RhythmSymbol | undefined;
+    getLyricsContainerDatas(): ReadonlyArray<LyricsContainerData>;
+    getLyricsContainer(verse: VerseNumber, line: ObjNotationLine, vpos: VerticalPos, lyricsLength?: NoteLength): LyricsContainer | undefined;
     getMinWidth(): number;
     setupNoteHeadDisplacements(): void;
     getNoteHeadDisplacement(noteGroup: ObjNoteGroup, note: Note): -1 | 0 | 1;
@@ -1035,6 +1099,7 @@ declare class ObjMeasure extends MusicObject {
     private endRepeatPlayCount;
     private endRepeatPlayCountText?;
     private staticObjectsCache;
+    private lyricsObjectsCache;
     readonly mi: MMeasure;
     constructor(row: ObjScoreRow);
     getMusicInterface(): MMeasure;
@@ -1089,8 +1154,9 @@ declare class ObjMeasure extends MusicObject {
     hasEndSection(): boolean;
     endRow(): void;
     private addRhythmSymbol;
-    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;
+    addNoteGroup(voiceId: VoiceId, notes: (Note | string)[], noteLength: NoteLength | NoteLengthStr, options?: NoteOptions, tupletRatio?: TupletRatio): ObjNoteGroup;
+    addRest(voiceId: VoiceId, restLength: NoteLength | NoteLengthStr, options?: RestOptions, tupletRatio?: TupletRatio): ObjRest;
+    addLyrics(staffTabOrGroups: StaffTabOrGroups | undefined, verse: VerseNumber, lyricsLength: NoteLength | NoteLengthStr, lyricsText: string, lyricsOptions: LyricsOptions): void;
     /**
      *
      * @param positionTicks - get ObjRhythmColumn with positionTicks. Insert new if necessary.
@@ -1107,6 +1173,8 @@ declare class ObjMeasure extends MusicObject {
     getMinWidth(): number;
     getStaffLineLeft(): number;
     getStaffLineRight(): number;
+    private getLyricsObjects;
+    getPrevLyricsObject(lyricsObj: ObjLyrics): ObjLyrics | undefined;
     getStaticObjects(line: ObjNotationLine): ReadonlyArray<MusicObject>;
     removeLayoutObjects(musicObj: MusicObject): void;
     addConnectiveObject(connective: ObjConnective): void;
@@ -1119,7 +1187,7 @@ declare class ObjMeasure extends MusicObject {
     private static setupBeamGroup;
     getBarLineLeft(): ObjBarLineLeft;
     getBarLineRight(): ObjBarLineRight;
-    getVoiceSymbols(voiceId: number): ReadonlyArray<RhythmSymbol>;
+    getVoiceSymbols(voiceId: VoiceId): ReadonlyArray<RhythmSymbol>;
     completeRests(voiceId?: VoiceId | VoiceId[]): void;
     requestLayout(): void;
     layout(renderer: Renderer): void;
@@ -1216,7 +1284,7 @@ declare class ObjDocument extends MusicObject {
     addMeasure(): ObjMeasure;
     addStaffGroup(groupName: string, layoutElements: number | string | (number | string)[], verticalPosition: VerticalPosition): void;
     getStaffGroup(groupName: string): StaffGroup | undefined;
-    getVoiceSymbols(voiceId: number): ReadonlyArray<RhythmSymbol>;
+    getVoiceSymbols(voiceId: VoiceId): ReadonlyArray<RhythmSymbol>;
     removeLayoutObjects(musicObj: MusicObject): void;
     private forEachMeasure;
     resetMeasures(): void;
@@ -1397,13 +1465,16 @@ declare enum LayoutGroupId {
     Ending = 3,
     TempoAnnotation = 4,
     DynamicsAnnotation = 5,
-    ChordLabel = 6
+    ChordLabel = 6,
+    LyricsVerse1 = 7,
+    LyricsVerse2 = 8,
+    LyricsVerse3 = 9
 }
 declare enum VerticalPos {
     Above = 0,
     Below = 1
 }
-type LayoutableMusicObject = ObjText | ObjSpecialText | ObjExtensionLine | ObjFermata | ObjEnding;
+type LayoutableMusicObject = ObjText | ObjSpecialText | ObjExtensionLine | ObjFermata | ObjEnding | ObjLyrics;
 declare class StaffGroup {
     readonly groupName: string;
     readonly staffsTabsAndGroups: number | string | (number | string)[];
@@ -2161,7 +2232,7 @@ declare class MRhythmColumn extends MusicInterface {
      * @param voiceId - Voice id.
      * @returns - Note group, rest or undefined.
      */
-    getRhythmSymbol(voiceId: number): MNoteGroup | MRest | undefined;
+    getRhythmSymbol(voiceId: VoiceId): MNoteGroup | MRest | undefined;
     /**
      * Get symbol (note group or rest) of this column for given voice id.
      * @deprecated - Use getRhythmSymbol(voiceId) instead.
@@ -2295,6 +2366,21 @@ declare class MText extends MusicInterface {
      */
     getText(): string;
 }
+/** Lyrics object. */
+declare class MLyrics extends MusicInterface {
+    private readonly obj;
+    /** Object name. */
+    static readonly Name = "Lyrics";
+    /** @internal */
+    constructor(obj: ObjLyrics);
+    /** @internal */
+    getMusicObject(): ObjLyrics;
+    /**
+     * Get lyrics text.
+     * @returns - Lyrics text.
+     */
+    getText(): string;
+}
 /** Extension line object. */
 declare class MExtensionLine extends MusicInterface {
     private readonly obj;
@@ -2306,4 +2392,4 @@ declare class MExtensionLine extends MusicInterface {
     getMusicObject(): ObjExtensionLine;
 }
 
-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 };
+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 };

package/dist/pieces/index.d.mts

@@ -1,6 +1,6 @@
-import { M as MDocument } from '../music-objects-DIaqNPjs.mjs';
+import { M as MDocument } from '../music-objects-3Hxlkxy6.mjs';
 import '../note-eA2xPPiG.mjs';
-import '../tempo-S85Q7uJA.mjs';
+import '../tempo-dkctPkCS.mjs';
 import '@tspro/ts-utils-lib';
 
 /**

package/dist/pieces/index.d.ts

@@ -1,6 +1,6 @@
-import { M as MDocument } from '../music-objects-xJJNlFwK.js';
+import { M as MDocument } from '../music-objects-CI7IjsjE.js';
 import '../note-eA2xPPiG.js';
-import '../tempo-Bp1UzsrZ.js';
+import '../tempo-GrstpD9G.js';
 import '@tspro/ts-utils-lib';
 
 /**

package/dist/pieces/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v4.1.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -33,7 +33,7 @@ function createFrereJacques() {
   return new import_score.DocumentBuilder().setHeader("Fr\xE8re Jacques", "Traditional").setScoreConfiguration([
     { type: "staff", clef: "G", voiceIds: [0] },
     { type: "staff", clef: "F", voiceIds: [1] }
-  ]).setMeasuresPerRow(2).addMeasure().setKeySignature("D Major").setTimeSignature("4/4").addNote(0, "D4", "4n", { stem: "up" }).addNote(0, "E4", "4n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addRest(1, "1n", { staffPos: "F3" }).addMeasure().addNote(0, "D4", "4n").addNote(0, "E4", "4n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addRest(1, "1n", { staffPos: "F3" }).addMeasure().addNavigation("startRepeat").addNote(0, "F#4", "4n").addNote(0, "G4", "4n").addNote(0, "A4", "2n").addNote(1, "D3", "4n", { stem: "down" }).addNote(1, "E3", "4n").addNote(1, "F#3", "4n").addNote(1, "D3", "4n").addMeasure().addNote(0, "F#4", "4n").addNote(0, "G4", "4n").addNote(0, "A4", "2n").addNote(1, "D3", "4n").addNote(1, "E3", "4n").addNote(1, "F#3", "4n").addNote(1, "D3", "4n").addMeasure().addNote(0, "A4", "8n").addNote(0, "B4", "8n").addNote(0, "A4", "8n").addNote(0, "G4", "8n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(1, "F#3", "4n").addNote(1, "G3", "4n").addNote(1, "A3", "2n").addMeasure().addNote(0, "A4", "8n").addNote(0, "B4", "8n").addNote(0, "A4", "8n").addNote(0, "G4", "8n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(1, "F#3", "4n").addNote(1, "G3", "4n").addNote(1, "A3", "2n").addMeasure().addNote(0, "D4", "4n").addChord(0, ["C#4", "A4"], "4n").addNote(0, "D4", "4n").addRest(0, "4n").addNote(1, "A3", "8n").addNote(1, "B3", "8n").addNote(1, "A3", "8n").addNote(1, "G3", "8n").addNote(1, "F#3", "4n").addNote(1, "D3", "4n").addMeasure().addNote(0, "D4", "4n").addChord(0, ["C#4", "A4"], "4n").addNote(0, "D4", "4n").addRest(0, "4n").addNote(1, "A3", "8n").addNote(1, "B3", "8n").addNote(1, "A3", "8n").addNote(1, "G3", "8n").addNote(1, "F#3", "4n").addNote(1, "D3", "4n").addMeasure().setMeasuresPerRow(4).addNavigation("ending", 1).addNote(0, "D4", "4n").addNote(0, "E4", "4n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(1, "D3", "4n").addChord(1, ["C#3", "A3"], "4n").addNote(1, "D3", "4n").addRest(1, "4n").addMeasure().addNavigation("endRepeat").addNote(0, "D4", "4n").addNote(0, "E4", "4n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(1, "D3", "4n").addChord(1, ["C#3", "A3"], "4n").addNote(1, "D3", "4n").addRest(1, "4n").addMeasure().addNavigation("ending", 2).addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(1, "A3", "4n").addNote(1, "F#3", "4n").addNote(1, "A3", "4n").addNote(1, "F#3", "4n").addMeasure().addNote(0, "A3", "4n").addNote(0, "C#4", "8n").addNote(0, "C#4", "8n").addNote(0, "D4", "2n").addNote(1, "D3", "4n").addNote(1, "E3", "4n").addNote(1, "F#3", "2n").getDocument();
+  ]).setMeasuresPerRow(2).addMeasure().setKeySignature("D Major").setTimeSignature("4/4").addNote(0, "D4", "4n", { stem: "up" }).addLyrics(1, "4n", "Are").addNote(0, "E4", "4n").addLyrics(1, "4n", "you").addNote(0, "F#4", "4n").addLyrics(1, "4n", "sleep", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing?").addRest(1, "1n", { staffPos: "F3" }).addMeasure().addNote(0, "D4", "4n").addLyrics(1, "4n", "Are").addNote(0, "E4", "4n").addLyrics(1, "4n", "you").addNote(0, "F#4", "4n").addLyrics(1, "4n", "sleep", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing?").addRest(1, "1n", { staffPos: "F3" }).addMeasure().addNavigation("startRepeat").addNote(0, "F#4", "4n").addLyrics(1, "4n", "Bro", { hyphen: "-" }).addNote(0, "G4", "4n").addLyrics(1, "4n", "ther").addNote(0, "A4", "2n").addLyrics(1, "4n", "John?").addNote(1, "D3", "4n", { stem: "down" }).addLyricsTo(1, 1, "4n", "Are").addNote(1, "E3", "4n").addLyricsTo(1, 1, "4n", "you").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "sleep", { hyphen: "-" }).addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "ing?").addMeasure().addNote(0, "F#4", "4n").addLyrics(1, "4n", "Bro", { hyphen: "-" }).addNote(0, "G4", "4n").addLyrics(1, "4n", "ther").addNote(0, "A4", "2n").addLyrics(1, "4n", "John?").addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "Are").addNote(1, "E3", "4n").addLyricsTo(1, 1, "4n", "you").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "sleep", { hyphen: "-" }).addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "ing?").addMeasure().addNote(0, "A4", "8n").addLyrics(1, "8n", "Morn", { hyphen: "-" }).addNote(0, "B4", "8n").addLyrics(1, "8n", "ing").addNote(0, "A4", "8n").addLyrics(1, "8n", "bells").addNote(0, "G4", "8n").addLyrics(1, "8n", "are").addNote(0, "F#4", "4n").addLyrics(1, "4n", "ring", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing!").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "Bro", { hyphen: "-" }).addNote(1, "G3", "4n").addLyricsTo(1, 1, "4n", "ther").addNote(1, "A3", "2n").addLyricsTo(1, 1, "2n", "John?").addMeasure().addNote(0, "A4", "8n").addLyrics(1, "8n", "Morn", { hyphen: "-" }).addNote(0, "B4", "8n").addLyrics(1, "8n", "ing").addNote(0, "A4", "8n").addLyrics(1, "8n", "bells").addNote(0, "G4", "8n").addLyrics(1, "8n", "are").addNote(0, "F#4", "4n").addLyrics(1, "4n", "ring", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing!").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "Bro", { hyphen: "-" }).addNote(1, "G3", "4n").addLyricsTo(1, 1, "4n", "ther").addNote(1, "A3", "2n").addLyricsTo(1, 1, "2n", "John?").addMeasure().addNote(0, "D4", "4n").addLyrics(1, "4n", "Ding").addChord(0, ["C#4", "A4"], "4n").addLyrics(1, "4n", "ding").addNote(0, "D4", "4n").addLyrics(1, "4n", "dong!").addRest(0, "4n").addNote(1, "A3", "8n").addLyricsTo(1, 1, "8n", "Morn", { hyphen: "-" }).addNote(1, "B3", "8n").addLyricsTo(1, 1, "8n", "ing").addNote(1, "A3", "8n").addLyricsTo(1, 1, "8n", "bells").addNote(1, "G3", "8n").addLyricsTo(1, 1, "8n", "are").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "ring", { hyphen: "-" }).addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "ing!").addMeasure().addNote(0, "D4", "4n").addLyrics(1, "4n", "Ding").addChord(0, ["C#4", "A4"], "4n").addLyrics(1, "4n", "ding").addNote(0, "D4", "4n").addLyrics(1, "4n", "dong!").addRest(0, "4n").addNote(1, "A3", "8n").addLyricsTo(1, 1, "8n", "Morn", { hyphen: "-" }).addNote(1, "B3", "8n").addLyricsTo(1, 1, "8n", "ing").addNote(1, "A3", "8n").addLyricsTo(1, 1, "8n", "bells").addNote(1, "G3", "8n").addLyricsTo(1, 1, "8n", "are").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "ring", { hyphen: "-" }).addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "ing!").addMeasure().setMeasuresPerRow(4).addNote(0, "D4", "4n").addLyrics(1, "4n", "Are").addNote(0, "E4", "4n").addLyrics(1, "4n", "you").addNote(0, "F#4", "4n").addLyrics(1, "4n", "sleep", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing?").addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "Ding").addChord(1, ["C#3", "A3"], "4n").addLyricsTo(1, 1, "4n", "ding").addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "dong!").addRest(1, "4n").addMeasure().addNavigation("endRepeat").addNote(0, "D4", "4n").addLyrics(1, "4n", "Are").addNote(0, "E4", "4n").addLyrics(1, "4n", "you").addNote(0, "F#4", "4n").addLyrics(1, "4n", "sleep", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing?").addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "Ding").addChord(1, ["C#3", "A3"], "4n").addLyricsTo(1, 1, "4n", "ding").addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "dong!").addRest(1, "4n").addMeasure().addNote(0, "F#4", "4n").addLyrics(1, "4n", "YES").addNote(0, "D4", "4n").addLyrics(1, "4n", "I'm").addNote(0, "F#4", "4n").addLyrics(1, "4n", "SLEEP", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ING").addNote(1, "A3", "4n").addNote(1, "F#3", "4n").addNote(1, "A3", "4n").addNote(1, "F#3", "4n").addMeasure().addNote(0, "A3", "4n").addLyrics(1, "4n", "Please").addNote(0, "C#4", "8n").addLyrics(1, "8n", "GO").addNote(0, "C#4", "8n").addLyrics(1, "8n", "A", { hyphen: "-" }).addNote(0, "D4", "2n").addLyrics(1, "4n", "WAY!").addNote(1, "D3", "4n").addNote(1, "E3", "4n").addNote(1, "F#3", "2n").getDocument();
 }
 
 // src/pieces/greensleeves.ts

package/dist/pieces/index.mjs

@@ -1,5 +1,5 @@
-/* WebMusicScore v4.1.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
-import "../chunk-MHNTJ6FU.mjs";
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+import "../chunk-5NWLGWHS.mjs";
 
 // src/pieces/frere-jacques.ts
 import { DocumentBuilder } from "@tspro/web-music-score/score";
@@ -7,7 +7,7 @@ function createFrereJacques() {
   return new DocumentBuilder().setHeader("Fr\xE8re Jacques", "Traditional").setScoreConfiguration([
     { type: "staff", clef: "G", voiceIds: [0] },
     { type: "staff", clef: "F", voiceIds: [1] }
-  ]).setMeasuresPerRow(2).addMeasure().setKeySignature("D Major").setTimeSignature("4/4").addNote(0, "D4", "4n", { stem: "up" }).addNote(0, "E4", "4n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addRest(1, "1n", { staffPos: "F3" }).addMeasure().addNote(0, "D4", "4n").addNote(0, "E4", "4n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addRest(1, "1n", { staffPos: "F3" }).addMeasure().addNavigation("startRepeat").addNote(0, "F#4", "4n").addNote(0, "G4", "4n").addNote(0, "A4", "2n").addNote(1, "D3", "4n", { stem: "down" }).addNote(1, "E3", "4n").addNote(1, "F#3", "4n").addNote(1, "D3", "4n").addMeasure().addNote(0, "F#4", "4n").addNote(0, "G4", "4n").addNote(0, "A4", "2n").addNote(1, "D3", "4n").addNote(1, "E3", "4n").addNote(1, "F#3", "4n").addNote(1, "D3", "4n").addMeasure().addNote(0, "A4", "8n").addNote(0, "B4", "8n").addNote(0, "A4", "8n").addNote(0, "G4", "8n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(1, "F#3", "4n").addNote(1, "G3", "4n").addNote(1, "A3", "2n").addMeasure().addNote(0, "A4", "8n").addNote(0, "B4", "8n").addNote(0, "A4", "8n").addNote(0, "G4", "8n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(1, "F#3", "4n").addNote(1, "G3", "4n").addNote(1, "A3", "2n").addMeasure().addNote(0, "D4", "4n").addChord(0, ["C#4", "A4"], "4n").addNote(0, "D4", "4n").addRest(0, "4n").addNote(1, "A3", "8n").addNote(1, "B3", "8n").addNote(1, "A3", "8n").addNote(1, "G3", "8n").addNote(1, "F#3", "4n").addNote(1, "D3", "4n").addMeasure().addNote(0, "D4", "4n").addChord(0, ["C#4", "A4"], "4n").addNote(0, "D4", "4n").addRest(0, "4n").addNote(1, "A3", "8n").addNote(1, "B3", "8n").addNote(1, "A3", "8n").addNote(1, "G3", "8n").addNote(1, "F#3", "4n").addNote(1, "D3", "4n").addMeasure().setMeasuresPerRow(4).addNavigation("ending", 1).addNote(0, "D4", "4n").addNote(0, "E4", "4n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(1, "D3", "4n").addChord(1, ["C#3", "A3"], "4n").addNote(1, "D3", "4n").addRest(1, "4n").addMeasure().addNavigation("endRepeat").addNote(0, "D4", "4n").addNote(0, "E4", "4n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(1, "D3", "4n").addChord(1, ["C#3", "A3"], "4n").addNote(1, "D3", "4n").addRest(1, "4n").addMeasure().addNavigation("ending", 2).addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(0, "F#4", "4n").addNote(0, "D4", "4n").addNote(1, "A3", "4n").addNote(1, "F#3", "4n").addNote(1, "A3", "4n").addNote(1, "F#3", "4n").addMeasure().addNote(0, "A3", "4n").addNote(0, "C#4", "8n").addNote(0, "C#4", "8n").addNote(0, "D4", "2n").addNote(1, "D3", "4n").addNote(1, "E3", "4n").addNote(1, "F#3", "2n").getDocument();
+  ]).setMeasuresPerRow(2).addMeasure().setKeySignature("D Major").setTimeSignature("4/4").addNote(0, "D4", "4n", { stem: "up" }).addLyrics(1, "4n", "Are").addNote(0, "E4", "4n").addLyrics(1, "4n", "you").addNote(0, "F#4", "4n").addLyrics(1, "4n", "sleep", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing?").addRest(1, "1n", { staffPos: "F3" }).addMeasure().addNote(0, "D4", "4n").addLyrics(1, "4n", "Are").addNote(0, "E4", "4n").addLyrics(1, "4n", "you").addNote(0, "F#4", "4n").addLyrics(1, "4n", "sleep", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing?").addRest(1, "1n", { staffPos: "F3" }).addMeasure().addNavigation("startRepeat").addNote(0, "F#4", "4n").addLyrics(1, "4n", "Bro", { hyphen: "-" }).addNote(0, "G4", "4n").addLyrics(1, "4n", "ther").addNote(0, "A4", "2n").addLyrics(1, "4n", "John?").addNote(1, "D3", "4n", { stem: "down" }).addLyricsTo(1, 1, "4n", "Are").addNote(1, "E3", "4n").addLyricsTo(1, 1, "4n", "you").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "sleep", { hyphen: "-" }).addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "ing?").addMeasure().addNote(0, "F#4", "4n").addLyrics(1, "4n", "Bro", { hyphen: "-" }).addNote(0, "G4", "4n").addLyrics(1, "4n", "ther").addNote(0, "A4", "2n").addLyrics(1, "4n", "John?").addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "Are").addNote(1, "E3", "4n").addLyricsTo(1, 1, "4n", "you").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "sleep", { hyphen: "-" }).addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "ing?").addMeasure().addNote(0, "A4", "8n").addLyrics(1, "8n", "Morn", { hyphen: "-" }).addNote(0, "B4", "8n").addLyrics(1, "8n", "ing").addNote(0, "A4", "8n").addLyrics(1, "8n", "bells").addNote(0, "G4", "8n").addLyrics(1, "8n", "are").addNote(0, "F#4", "4n").addLyrics(1, "4n", "ring", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing!").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "Bro", { hyphen: "-" }).addNote(1, "G3", "4n").addLyricsTo(1, 1, "4n", "ther").addNote(1, "A3", "2n").addLyricsTo(1, 1, "2n", "John?").addMeasure().addNote(0, "A4", "8n").addLyrics(1, "8n", "Morn", { hyphen: "-" }).addNote(0, "B4", "8n").addLyrics(1, "8n", "ing").addNote(0, "A4", "8n").addLyrics(1, "8n", "bells").addNote(0, "G4", "8n").addLyrics(1, "8n", "are").addNote(0, "F#4", "4n").addLyrics(1, "4n", "ring", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing!").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "Bro", { hyphen: "-" }).addNote(1, "G3", "4n").addLyricsTo(1, 1, "4n", "ther").addNote(1, "A3", "2n").addLyricsTo(1, 1, "2n", "John?").addMeasure().addNote(0, "D4", "4n").addLyrics(1, "4n", "Ding").addChord(0, ["C#4", "A4"], "4n").addLyrics(1, "4n", "ding").addNote(0, "D4", "4n").addLyrics(1, "4n", "dong!").addRest(0, "4n").addNote(1, "A3", "8n").addLyricsTo(1, 1, "8n", "Morn", { hyphen: "-" }).addNote(1, "B3", "8n").addLyricsTo(1, 1, "8n", "ing").addNote(1, "A3", "8n").addLyricsTo(1, 1, "8n", "bells").addNote(1, "G3", "8n").addLyricsTo(1, 1, "8n", "are").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "ring", { hyphen: "-" }).addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "ing!").addMeasure().addNote(0, "D4", "4n").addLyrics(1, "4n", "Ding").addChord(0, ["C#4", "A4"], "4n").addLyrics(1, "4n", "ding").addNote(0, "D4", "4n").addLyrics(1, "4n", "dong!").addRest(0, "4n").addNote(1, "A3", "8n").addLyricsTo(1, 1, "8n", "Morn", { hyphen: "-" }).addNote(1, "B3", "8n").addLyricsTo(1, 1, "8n", "ing").addNote(1, "A3", "8n").addLyricsTo(1, 1, "8n", "bells").addNote(1, "G3", "8n").addLyricsTo(1, 1, "8n", "are").addNote(1, "F#3", "4n").addLyricsTo(1, 1, "4n", "ring", { hyphen: "-" }).addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "ing!").addMeasure().setMeasuresPerRow(4).addNote(0, "D4", "4n").addLyrics(1, "4n", "Are").addNote(0, "E4", "4n").addLyrics(1, "4n", "you").addNote(0, "F#4", "4n").addLyrics(1, "4n", "sleep", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing?").addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "Ding").addChord(1, ["C#3", "A3"], "4n").addLyricsTo(1, 1, "4n", "ding").addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "dong!").addRest(1, "4n").addMeasure().addNavigation("endRepeat").addNote(0, "D4", "4n").addLyrics(1, "4n", "Are").addNote(0, "E4", "4n").addLyrics(1, "4n", "you").addNote(0, "F#4", "4n").addLyrics(1, "4n", "sleep", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ing?").addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "Ding").addChord(1, ["C#3", "A3"], "4n").addLyricsTo(1, 1, "4n", "ding").addNote(1, "D3", "4n").addLyricsTo(1, 1, "4n", "dong!").addRest(1, "4n").addMeasure().addNote(0, "F#4", "4n").addLyrics(1, "4n", "YES").addNote(0, "D4", "4n").addLyrics(1, "4n", "I'm").addNote(0, "F#4", "4n").addLyrics(1, "4n", "SLEEP", { hyphen: "-" }).addNote(0, "D4", "4n").addLyrics(1, "4n", "ING").addNote(1, "A3", "4n").addNote(1, "F#3", "4n").addNote(1, "A3", "4n").addNote(1, "F#3", "4n").addMeasure().addNote(0, "A3", "4n").addLyrics(1, "4n", "Please").addNote(0, "C#4", "8n").addLyrics(1, "8n", "GO").addNote(0, "C#4", "8n").addLyrics(1, "8n", "A", { hyphen: "-" }).addNote(0, "D4", "2n").addLyrics(1, "4n", "WAY!").addNote(1, "D3", "4n").addNote(1, "E3", "4n").addNote(1, "F#3", "2n").getDocument();
 }
 
 // src/pieces/greensleeves.ts