@tspro/web-music-score 3.2.0 → 4.0.0

package/dist/pieces/index.mjs

@@ -1,25 +1,22 @@
-/* WebMusicScore v3.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
-import "../chunk-LCTM7BID.mjs";
+/* WebMusicScore v4.0.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+import "../chunk-D643HZHM.mjs";
 
 // src/pieces/frere-jacques.ts
-import { NoteLength, ScaleType } from "@tspro/web-music-score/theory";
-import { DocumentBuilder, StaffPreset } from "@tspro/web-music-score/score";
+import { DocumentBuilder } from "@tspro/web-music-score/score";
 function createFrereJacques() {
-  return new DocumentBuilder().setScoreConfiguration(StaffPreset.GuitarTreble).setHeader("Frere Jacques").addMeasure().setKeySignature("G", ScaleType.Major).setTimeSignature("4/4").addNote(0, "G3", NoteLength.Quarter).addNote(0, "A3", NoteLength.Quarter).addNote(0, "B3", NoteLength.Quarter).addNote(0, "G3", NoteLength.Quarter).addMeasure().addNote(0, "G3", NoteLength.Quarter).addNote(0, "A3", NoteLength.Quarter).addNote(0, "B3", NoteLength.Quarter).addNote(0, "G3", NoteLength.Quarter).addMeasure().addNote(0, "B3", NoteLength.Quarter).addNote(0, "C4", NoteLength.Quarter).addNote(0, "D4", NoteLength.Half).endRow().addMeasure().addNote(0, "B3", NoteLength.Quarter).addNote(0, "C4", NoteLength.Quarter).addNote(0, "D4", NoteLength.Half).addMeasure().addNote(0, "D4", NoteLength.Eighth).addNote(0, "E4", NoteLength.Eighth).addNote(0, "D4", NoteLength.Eighth).addNote(0, "C4", NoteLength.Eighth).addNote(0, "B3", NoteLength.Quarter).addNote(0, "G3", NoteLength.Quarter).endRow().addMeasure().addNote(0, "D4", NoteLength.Eighth).addNote(0, "E4", NoteLength.Eighth).addNote(0, "D4", NoteLength.Eighth).addNote(0, "C4", NoteLength.Eighth).addNote(0, "B3", NoteLength.Quarter).addNote(0, "G3", NoteLength.Quarter).addMeasure().addNote(0, "G3", NoteLength.Quarter).addNote(0, "D3", NoteLength.Quarter).addNote(0, "G3", NoteLength.Half).addMeasure().addNote(0, "G3", NoteLength.Quarter).addNote(0, "D3", NoteLength.Quarter).addNote(0, "G3", NoteLength.Half).getDocument();
+  return new DocumentBuilder().setScoreConfiguration("guitarTreble").setHeader("Frere Jacques").addMeasure().setKeySignature("G", "Major").setTimeSignature("4/4").addNote(0, "G3", "4n").addNote(0, "A3", "4n").addNote(0, "B3", "4n").addNote(0, "G3", "4n").addMeasure().addNote(0, "G3", "4n").addNote(0, "A3", "4n").addNote(0, "B3", "4n").addNote(0, "G3", "4n").addMeasure().addNote(0, "B3", "4n").addNote(0, "C4", "4n").addNote(0, "D4", "2n").endRow().addMeasure().addNote(0, "B3", "4n").addNote(0, "C4", "4n").addNote(0, "D4", "2n").addMeasure().addNote(0, "D4", "8n").addNote(0, "E4", "8n").addNote(0, "D4", "8n").addNote(0, "C4", "8n").addNote(0, "B3", "4n").addNote(0, "G3", "4n").endRow().addMeasure().addNote(0, "D4", "8n").addNote(0, "E4", "8n").addNote(0, "D4", "8n").addNote(0, "C4", "8n").addNote(0, "B3", "4n").addNote(0, "G3", "4n").addMeasure().addNote(0, "G3", "4n").addNote(0, "D3", "4n").addNote(0, "G3", "2n").addMeasure().addNote(0, "G3", "4n").addNote(0, "D3", "4n").addNote(0, "G3", "2n").getDocument();
 }
 
 // src/pieces/greensleeves.ts
-import { NoteLength as NoteLength2, ScaleType as ScaleType2 } from "@tspro/web-music-score/theory";
-import { Arpeggio, Navigation, StaffPreset as StaffPreset2, Stem, Label, DocumentBuilder as DocumentBuilder2 } from "@tspro/web-music-score/score";
+import { Navigation, DocumentBuilder as DocumentBuilder2 } from "@tspro/web-music-score/score";
 function createGreensleeves() {
-  return new DocumentBuilder2().setScoreConfiguration(StaffPreset2.GuitarTreble).setHeader("Greensleeves").addMeasure().setKeySignature("C", ScaleType2.Major).setTimeSignature("6/8").setTempo(140).addNote(0, "A3", NoteLength2.Eighth).addMeasure().addNavigation(Navigation.StartRepeat).addNote(0, "C4", NoteLength2.Quarter, { stem: Stem.Up }).addLabel(Label.Chord, "Am").addNote(0, "D4", NoteLength2.Eighth).addNote(0, "E4", NoteLength2.Eighth, { dotted: true }).addNote(0, "F4", NoteLength2.Sixteenth).addNote(0, "E4", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "E3", NoteLength2.Quarter).addNote(1, "A2", NoteLength2.Eighth).addNote(1, "E3", NoteLength2.Quarter).addMeasure().addNote(0, "D4", NoteLength2.Quarter, { stem: Stem.Up }).addLabel(Label.Chord, "G").addNote(0, "B3", NoteLength2.Eighth).addNote(0, "G3", NoteLength2.Eighth, { dotted: true }).addLabel(Label.Chord, "Em").addNote(0, "A3", NoteLength2.Sixteenth).addNote(0, "B3", NoteLength2.Eighth).addNote(1, "G2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "D3", NoteLength2.Quarter).addNote(1, "E2", NoteLength2.Eighth).addNote(1, "B2", NoteLength2.Quarter).addMeasure().addNote(0, "C4", NoteLength2.Quarter, { stem: Stem.Up }).addLabel(Label.Chord, "Am").addNote(0, "A3", NoteLength2.Eighth).addNote(0, "A3", NoteLength2.Eighth, { dotted: true }).addLabel(Label.Chord, "F").addNote(0, "G#3", NoteLength2.Sixteenth).addNote(0, "A3", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "E3", NoteLength2.Quarter).addNote(1, "F2", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Quarter).addMeasure().addNote(0, "B3", NoteLength2.Quarter, { stem: Stem.Up }).addLabel(Label.Chord, "E").addNote(0, "G#3", NoteLength2.Eighth).addNote(0, "E3", NoteLength2.Quarter).addNote(0, "A3", NoteLength2.Eighth).addNote(1, "E2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "B2", NoteLength2.Quarter).addNote(1, "E2", NoteLength2.Eighth).addNote(1, "B2", NoteLength2.Quarter).endRow().addMeasure().addNote(0, "C4", NoteLength2.Quarter, { stem: Stem.Up }).addLabel(Label.Chord, "Am").addNote(0, "D4", NoteLength2.Eighth).addNote(0, "E4", NoteLength2.Eighth, { dotted: true }).addNote(0, "F4", NoteLength2.Sixteenth).addNote(0, "E4", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "E3", NoteLength2.Quarter).addNote(1, "A2", NoteLength2.Eighth).addNote(1, "E3", NoteLength2.Quarter).addMeasure().addNote(0, "D4", NoteLength2.Quarter, { stem: Stem.Up }).addLabel(Label.Chord, "G").addNote(0, "B3", NoteLength2.Eighth).addNote(0, "G3", NoteLength2.Eighth, { dotted: true }).addLabel(Label.Chord, "Em").addNote(0, "A3", NoteLength2.Sixteenth).addNote(0, "B3", NoteLength2.Eighth).addNote(1, "G2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "D3", NoteLength2.Quarter).addNote(1, "E2", NoteLength2.Eighth).addNote(1, "B2", NoteLength2.Quarter).addMeasure().addNote(0, "C4", NoteLength2.Eighth, { dotted: true, stem: Stem.Up }).addLabel(Label.Chord, "Am").addNote(0, "B3", NoteLength2.Sixteenth).addNote(0, "A3", NoteLength2.Eighth).addNote(0, "G#3", NoteLength2.Eighth, { dotted: true }).addLabel(Label.Chord, "E").addNote(0, "F#3", NoteLength2.Sixteenth).addNote(0, "G#3", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "E3", NoteLength2.Quarter).addNote(1, "E2", NoteLength2.Eighth).addNote(1, "B2", NoteLength2.Quarter).addMeasure().addNote(0, "A3", NoteLength2.Quarter, { dotted: true, stem: Stem.Up }).addLabel(Label.Chord, "Am").addNote(0, "A3", NoteLength2.Quarter, { dotted: true }).addNote(1, "A2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "E3", NoteLength2.Eighth).addNote(1, "C4", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Quarter, { dotted: true }).endRow().addMeasure().addChord(0, ["C3", "E3", "G3", "C4", "G4"], NoteLength2.Quarter, { dotted: true, arpeggio: Arpeggio.Up, stem: Stem.Up }).addLabel(Label.Chord, "C").addNote(0, "G4", NoteLength2.Eighth, { dotted: true }).addNote(0, "F#4", NoteLength2.Sixteenth).addNote(0, "E4", NoteLength2.Eighth).addRest(1, NoteLength2.Quarter, { dotted: true, hide: true }).addNote(1, "C3", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "G3", NoteLength2.Quarter).addMeasure().addNote(0, "D4", NoteLength2.Quarter, { stem: Stem.Up }).addLabel(Label.Chord, "G").addNote(0, "B3", NoteLength2.Eighth).addNote(0, "G3", NoteLength2.Eighth, { dotted: true }).addLabel(Label.Chord, "Em").addNote(0, "A3", NoteLength2.Sixteenth).addNote(0, "B3", NoteLength2.Eighth).addNote(1, "G2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "D3", NoteLength2.Quarter).addNote(1, "E2", NoteLength2.Eighth).addNote(1, "B2", NoteLength2.Quarter).addMeasure().addNote(0, "C4", NoteLength2.Quarter, { stem: Stem.Up }).addLabel(Label.Chord, "Am").addNote(0, "A3", NoteLength2.Eighth).addNote(0, "A3", NoteLength2.Eighth, { dotted: true }).addLabel(Label.Chord, "F").addNote(0, "G#3", NoteLength2.Sixteenth).addNote(0, "A3", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "E3", NoteLength2.Quarter).addNote(1, "F2", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Quarter).addMeasure().addNote(0, "B3", NoteLength2.Quarter, { stem: Stem.Up }).addLabel(Label.Chord, "E").addNote(0, "G#3", NoteLength2.Eighth).addNote(0, "E3", NoteLength2.Quarter, { dotted: true }).addNote(1, "E2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "B2", NoteLength2.Quarter).addNote(1, "E2", NoteLength2.Eighth).addNote(1, "B2", NoteLength2.Eighth).addNote(1, "E3", NoteLength2.Eighth).endRow().addMeasure().addNote(0, "G4", NoteLength2.Quarter, { dotted: true, stem: Stem.Up }).addLabel(Label.Chord, "C").addNote(0, "G4", NoteLength2.Eighth, { dotted: true }).addNote(0, "F#4", NoteLength2.Sixteenth).addNote(0, "E4", NoteLength2.Eighth).addNote(1, "C3", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "G3", NoteLength2.Eighth).addNote(1, "C4", NoteLength2.Eighth).addNote(1, "C3", NoteLength2.Eighth).addNote(1, "G3", NoteLength2.Quarter).addMeasure().addNote(0, "D4", NoteLength2.Quarter, { stem: Stem.Up }).addLabel(Label.Chord, "G").addNote(0, "B3", NoteLength2.Eighth).addNote(0, "G3", NoteLength2.Eighth, { dotted: true }).addLabel(Label.Chord, "Em").addNote(0, "A3", NoteLength2.Sixteenth).addNote(0, "B3", NoteLength2.Eighth).addNote(1, "G2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "D3", NoteLength2.Quarter).addNote(1, "E2", NoteLength2.Eighth).addNote(1, "B2", NoteLength2.Quarter).addMeasure().addNote(0, "C4", NoteLength2.Eighth, { dotted: true, stem: Stem.Up }).addLabel(Label.Chord, "Am").addNote(0, "B3", NoteLength2.Sixteenth).addNote(0, "A3", NoteLength2.Eighth).addNote(0, "G#3", NoteLength2.Eighth, { dotted: true }).addLabel(Label.Chord, "E").addNote(0, "F#3", NoteLength2.Sixteenth).addNote(0, "G#3", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "E3", NoteLength2.Quarter).addNote(1, "E2", NoteLength2.Eighth).addNote(1, "B2", NoteLength2.Quarter).addMeasure().addNavigation(Navigation.Ending, 1).addNavigation(Navigation.EndRepeat).addNote(0, "A3", NoteLength2.Quarter, { dotted: true, stem: Stem.Up }).addLabel(Label.Chord, "Am").addNote(0, "A3", NoteLength2.Quarter).addNote(0, "A3", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "E3", NoteLength2.Eighth).addNote(1, "C4", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Quarter, { dotted: true }).addMeasure().addNavigation(Navigation.Ending, 2).addNote(0, "A3", NoteLength2.Quarter, { dotted: true, stem: Stem.Up }).addLabel(Label.Chord, "Am").addNote(0, "A3", NoteLength2.Quarter, { dotted: true }).addFermata().addNote(1, "A2", NoteLength2.Eighth, { stem: Stem.Down }).addNote(1, "E3", NoteLength2.Eighth).addNote(1, "C4", NoteLength2.Eighth).addNote(1, "A2", NoteLength2.Quarter, { dotted: true }).getDocument();
+  return new DocumentBuilder2().setScoreConfiguration("guitarTreble").setHeader("Greensleeves").addMeasure().setKeySignature("C", "Major").setTimeSignature("6/8").setTempo(140).addNote(0, "A3", "8n").addMeasure().addNavigation(Navigation.StartRepeat).addNote(0, "C4", "4n", { stem: "up" }).addLabel("chord", "Am").addNote(0, "D4", "8n").addNote(0, "E4", "8.").addNote(0, "F4", "16n").addNote(0, "E4", "8n").addNote(1, "A2", "8n", { stem: "down" }).addNote(1, "E3", "4n").addNote(1, "A2", "8n").addNote(1, "E3", "4n").addMeasure().addNote(0, "D4", "4n", { stem: "up" }).addLabel("chord", "G").addNote(0, "B3", "8n").addNote(0, "G3", "8.").addLabel("chord", "Em").addNote(0, "A3", "16n").addNote(0, "B3", "8n").addNote(1, "G2", "8n", { stem: "down" }).addNote(1, "D3", "4n").addNote(1, "E2", "8n").addNote(1, "B2", "4n").addMeasure().addNote(0, "C4", "4n", { stem: "up" }).addLabel("chord", "Am").addNote(0, "A3", "8n").addNote(0, "A3", "8.").addLabel("chord", "F").addNote(0, "G#3", "16n").addNote(0, "A3", "8n").addNote(1, "A2", "8n", { stem: "down" }).addNote(1, "E3", "4n").addNote(1, "F2", "8n").addNote(1, "A2", "4n").addMeasure().addNote(0, "B3", "4n", { stem: "up" }).addLabel("chord", "E").addNote(0, "G#3", "8n").addNote(0, "E3", "4n").addNote(0, "A3", "8n").addNote(1, "E2", "8n", { stem: "down" }).addNote(1, "B2", "4n").addNote(1, "E2", "8n").addNote(1, "B2", "4n").endRow().addMeasure().addNote(0, "C4", "4n", { stem: "up" }).addLabel("chord", "Am").addNote(0, "D4", "8n").addNote(0, "E4", "8.").addNote(0, "F4", "16n").addNote(0, "E4", "8n").addNote(1, "A2", "8n", { stem: "down" }).addNote(1, "E3", "4n").addNote(1, "A2", "8n").addNote(1, "E3", "4n").addMeasure().addNote(0, "D4", "4n", { stem: "up" }).addLabel("chord", "G").addNote(0, "B3", "8n").addNote(0, "G3", "8.").addLabel("chord", "Em").addNote(0, "A3", "16n").addNote(0, "B3", "8n").addNote(1, "G2", "8n", { stem: "down" }).addNote(1, "D3", "4n").addNote(1, "E2", "8n").addNote(1, "B2", "4n").addMeasure().addNote(0, "C4", "8.", { stem: "up" }).addLabel("chord", "Am").addNote(0, "B3", "16n").addNote(0, "A3", "8n").addNote(0, "G#3", "8.").addLabel("chord", "E").addNote(0, "F#3", "16n").addNote(0, "G#3", "8n").addNote(1, "A2", "8n", { stem: "down" }).addNote(1, "E3", "4n").addNote(1, "E2", "8n").addNote(1, "B2", "4n").addMeasure().addNote(0, "A3", "4.", { stem: "up" }).addLabel("chord", "Am").addNote(0, "A3", "4.").addNote(1, "A2", "8n", { stem: "down" }).addNote(1, "E3", "8n").addNote(1, "C4", "8n").addNote(1, "A2", "4.").endRow().addMeasure().addChord(0, ["C3", "E3", "G3", "C4", "G4"], "4.", { arpeggio: "up", stem: "up" }).addLabel("chord", "C").addNote(0, "G4", "8.").addNote(0, "F#4", "16n").addNote(0, "E4", "8n").addRest(1, "4.", { hide: true }).addNote(1, "C3", "8n", { stem: "down" }).addNote(1, "G3", "4n").addMeasure().addNote(0, "D4", "4n", { stem: "up" }).addLabel("chord", "G").addNote(0, "B3", "8n").addNote(0, "G3", "8.").addLabel("chord", "Em").addNote(0, "A3", "16n").addNote(0, "B3", "8n").addNote(1, "G2", "8n", { stem: "down" }).addNote(1, "D3", "4n").addNote(1, "E2", "8n").addNote(1, "B2", "4n").addMeasure().addNote(0, "C4", "4n", { stem: "up" }).addLabel("chord", "Am").addNote(0, "A3", "8n").addNote(0, "A3", "8.").addLabel("chord", "F").addNote(0, "G#3", "16n").addNote(0, "A3", "8n").addNote(1, "A2", "8n", { stem: "down" }).addNote(1, "E3", "4n").addNote(1, "F2", "8n").addNote(1, "A2", "4n").addMeasure().addNote(0, "B3", "4n", { stem: "up" }).addLabel("chord", "E").addNote(0, "G#3", "8n").addNote(0, "E3", "4.").addNote(1, "E2", "8n", { stem: "down" }).addNote(1, "B2", "4n").addNote(1, "E2", "8n").addNote(1, "B2", "8n").addNote(1, "E3", "8n").endRow().addMeasure().addNote(0, "G4", "4.", { stem: "up" }).addLabel("chord", "C").addNote(0, "G4", "8.").addNote(0, "F#4", "16n").addNote(0, "E4", "8n").addNote(1, "C3", "8n", { stem: "down" }).addNote(1, "G3", "8n").addNote(1, "C4", "8n").addNote(1, "C3", "8n").addNote(1, "G3", "4n").addMeasure().addNote(0, "D4", "4n", { stem: "up" }).addLabel("chord", "G").addNote(0, "B3", "8n").addNote(0, "G3", "8.").addLabel("chord", "Em").addNote(0, "A3", "16n").addNote(0, "B3", "8n").addNote(1, "G2", "8n", { stem: "down" }).addNote(1, "D3", "4n").addNote(1, "E2", "8n").addNote(1, "B2", "4n").addMeasure().addNote(0, "C4", "8.", { stem: "up" }).addLabel("chord", "Am").addNote(0, "B3", "16n").addNote(0, "A3", "8n").addNote(0, "G#3", "8.").addLabel("chord", "E").addNote(0, "F#3", "16n").addNote(0, "G#3", "8n").addNote(1, "A2", "8n", { stem: "down" }).addNote(1, "E3", "4n").addNote(1, "E2", "8n").addNote(1, "B2", "4n").addMeasure().addNavigation("ending", 1).addNavigation("endRepeat").addNote(0, "A3", "4.", { stem: "up" }).addLabel("chord", "Am").addNote(0, "A3", "4n").addNote(0, "A3", "8n").addNote(1, "A2", "8n", { stem: "down" }).addNote(1, "E3", "8n").addNote(1, "C4", "8n").addNote(1, "A2", "4.").addMeasure().addNavigation("ending", 2).addNote(0, "A3", "4.", { stem: "up" }).addLabel("chord", "Am").addNote(0, "A3", "4.").addFermata().addNote(1, "A2", "8n", { stem: "down" }).addNote(1, "E3", "8n").addNote(1, "C4", "8n").addNote(1, "A2", "4.").getDocument();
 }
 
 // src/pieces/andante-diabelli.ts
-import { NoteLength as NoteLength3, ScaleType as ScaleType3 } from "@tspro/web-music-score/theory";
-import { NoteAnchor, Navigation as Navigation2, Annotation, StaffPreset as StaffPreset3, Stem as Stem2, DocumentBuilder as DocumentBuilder3, Connective } from "@tspro/web-music-score/score";
+import { DocumentBuilder as DocumentBuilder3 } from "@tspro/web-music-score/score";
 function createAndanteByDiabelli() {
-  return new DocumentBuilder3().setScoreConfiguration(StaffPreset3.GuitarTreble).setHeader("Andante", "A. Diabelli").addMeasure().setKeySignature("D", ScaleType3.Major).setTimeSignature("3/4").setTempo(80).addRest(0, NoteLength3.Eighth, { staffPos: "G4" }).addAnnotation(Annotation.Dynamics, "p").addNote(0, "F#4", NoteLength3.Eighth, { stem: Stem2.Up }).addNote(0, "G4", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "F#4", NoteLength3.Eighth).addNote(0, "E4", NoteLength3.Eighth).addNote(0, "D4", NoteLength3.Eighth).addNote(1, "D3", NoteLength3.Half, { dotted: true, stem: Stem2.Down }).addMeasure().addNote(0, "C#4", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "D4", NoteLength3.Eighth).addNote(0, "E4", NoteLength3.Eighth).addNote(0, "F#4", NoteLength3.Eighth).addNote(0, "G4", NoteLength3.Quarter).addNote(1, "A2", NoteLength3.Half, { dotted: true }).addMeasure().addRest(0, NoteLength3.Eighth, { staffPos: "B3" }).addAnnotation(Annotation.Dynamics, "f").addNote(0, "A3", NoteLength3.Eighth).addNote(0, "G#3", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "A3", NoteLength3.Eighth).addNote(0, "B3", NoteLength3.Eighth).addNote(0, "C#4", NoteLength3.Eighth).addNote(1, "A2", NoteLength3.Half, { dotted: true }).endRow().addMeasure().addNote(0, "D4", NoteLength3.Eighth, { string: 3 }).addNote(0, "E4", NoteLength3.Eighth).addNote(0, "F#4", NoteLength3.Eighth).addNote(0, "G4", NoteLength3.Eighth).addNote(0, "A4", NoteLength3.Quarter).addNote(1, "D3", NoteLength3.Half, { dotted: true }).addMeasure().addRest(0, NoteLength3.Eighth, { staffPos: "G4" }).addAnnotation(Annotation.Dynamics, "p").addNote(0, "F#4", NoteLength3.Eighth).addNote(0, "G4", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "F#4", NoteLength3.Eighth).addNote(0, "E4", NoteLength3.Eighth).addNote(0, "D4", NoteLength3.Eighth).addNote(1, "D3", NoteLength3.Half, { dotted: true }).addMeasure().addNote(0, "C#4", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "D4", NoteLength3.Eighth).addNote(0, "E4", NoteLength3.Eighth).addNote(0, "F#4", NoteLength3.Eighth).addNote(0, "G4", NoteLength3.Quarter).addNote(1, "A2", NoteLength3.Half, { dotted: true }).endRow().addMeasure().addRest(0, NoteLength3.Eighth, { staffPos: "B3" }).addAnnotation(Annotation.Dynamics, "f").addNote(0, "A3", NoteLength3.Eighth).addNote(0, "G#3", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "A3", NoteLength3.Eighth).addNote(0, "B3", NoteLength3.Eighth).addNote(0, "C#4", NoteLength3.Eighth).addNote(1, "A2", NoteLength3.Half, { dotted: true }).addMeasure().addNote(0, "D4", NoteLength3.Quarter).addRest(1, NoteLength3.Quarter, { staffPos: "D3" }).addNote(0, "D3", NoteLength3.Quarter).addNote(1, "D3", NoteLength3.Quarter).addRest(1, NoteLength3.Quarter, { staffPos: "B3" }).addNavigation(Navigation2.EndRepeat).addMeasure().addRest(0, NoteLength3.Eighth, { staffPos: "D4" }).addAnnotation(Annotation.Dynamics, "f").addNote(0, "D4", NoteLength3.Eighth).addNote(0, "E4", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "D4", NoteLength3.Eighth).addNote(0, "C#4", NoteLength3.Eighth).addNote(0, "B3", NoteLength3.Eighth).addNote(1, "E2", NoteLength3.Half, { dotted: true }).endRow().addMeasure().addNote(0, "C#4", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "D4", NoteLength3.Eighth).addNote(0, "E4", NoteLength3.Eighth).addNote(0, "F#4", NoteLength3.Eighth).addNote(0, "E4", NoteLength3.Quarter).addNote(1, "A2", NoteLength3.Half, { dotted: true }).addMeasure().addRest(0, NoteLength3.Eighth, { staffPos: "B3" }).addAnnotation(Annotation.Dynamics, "p").addNote(0, "E3", NoteLength3.Eighth).addNote(0, "D#3", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "E3", NoteLength3.Eighth).addNote(0, "F#3", NoteLength3.Eighth).addNote(0, "G#3", NoteLength3.Eighth).addNote(1, "E2", NoteLength3.Half, { dotted: true }).addMeasure().addNote(0, "A3", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "G#3", NoteLength3.Eighth).addNote(0, "A3", NoteLength3.Eighth).addNote(0, "B3", NoteLength3.Eighth).addNote(0, "C#4", NoteLength3.Quarter).addNote(1, "A2", NoteLength3.Half, { dotted: true }).endRow().addMeasure().addRest(0, NoteLength3.Eighth, { staffPos: "G4" }).addAnnotation(Annotation.Dynamics, "f").addNote(0, "G4", NoteLength3.Eighth).addNote(0, "A4", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "G4", NoteLength3.Eighth).addNote(0, "F#4", NoteLength3.Eighth).addNote(0, "E4", NoteLength3.Eighth).addNote(1, "A2", NoteLength3.Half, { dotted: true }).addMeasure().addNote(0, "D4", NoteLength3.Eighth).addNote(0, "C#4", NoteLength3.Eighth).addNote(0, "D4", NoteLength3.Eighth).addNote(0, "E4", NoteLength3.Eighth).addNote(0, "F#4", NoteLength3.Quarter).addNote(1, "D3", NoteLength3.Half, { dotted: true }).addMeasure().addRest(0, NoteLength3.Eighth, { staffPos: "B3" }).addAnnotation(Annotation.Dynamics, "ff").addNote(0, "A3", NoteLength3.Eighth).addNote(0, "G#3", NoteLength3.Eighth).addConnective(Connective.Slur, 2, NoteAnchor.Below).addNote(0, "A3", NoteLength3.Eighth).addNote(0, "B3", NoteLength3.Eighth).addNote(0, "C#4", NoteLength3.Eighth).addNote(1, "A2", NoteLength3.Half, { dotted: true }).addMeasure().addNote(0, "D4", NoteLength3.Quarter).addRest(1, NoteLength3.Quarter, { staffPos: "D3" }).addNote(0, "D3", NoteLength3.Quarter).addNote(1, "D3", NoteLength3.Quarter).addRest(1, NoteLength3.Quarter, { staffPos: "B3" }).endSong().getDocument();
+  return new DocumentBuilder3().setScoreConfiguration("guitarTreble").setHeader("Andante", "A. Diabelli").addMeasure().setKeySignature("D", "Major").setTimeSignature("3/4").setTempo(80).addRest(0, "8n", { staffPos: "G4" }).addAnnotation("dynamics", "p").addNote(0, "F#4", "8n", { stem: "up" }).addNote(0, "G4", "8n").addConnective("slur", 2, "below").addNote(0, "F#4", "8n").addNote(0, "E4", "8n").addNote(0, "D4", "8n").addNote(1, "D3", "2.", { stem: "down" }).addMeasure().addNote(0, "C#4", "8n").addConnective("slur", 2, "below").addNote(0, "D4", "8n").addNote(0, "E4", "8n").addNote(0, "F#4", "8n").addNote(0, "G4", "4n").addNote(1, "A2", "2.").addMeasure().addRest(0, "8n", { staffPos: "B3" }).addAnnotation("dynamics", "f").addNote(0, "A3", "8n").addNote(0, "G#3", "8n").addConnective("slur", 2, "below").addNote(0, "A3", "8n").addNote(0, "B3", "8n").addNote(0, "C#4", "8n").addNote(1, "A2", "2.").endRow().addMeasure().addNote(0, "D4", "8n", { string: 3 }).addNote(0, "E4", "8n").addNote(0, "F#4", "8n").addNote(0, "G4", "8n").addNote(0, "A4", "4n").addNote(1, "D3", "2.").addMeasure().addRest(0, "8n", { staffPos: "G4" }).addAnnotation("dynamics", "p").addNote(0, "F#4", "8n").addNote(0, "G4", "8n").addConnective("slur", 2, "below").addNote(0, "F#4", "8n").addNote(0, "E4", "8n").addNote(0, "D4", "8n").addNote(1, "D3", "2.").addMeasure().addNote(0, "C#4", "8n").addConnective("slur", 2, "below").addNote(0, "D4", "8n").addNote(0, "E4", "8n").addNote(0, "F#4", "8n").addNote(0, "G4", "4n").addNote(1, "A2", "2.").endRow().addMeasure().addRest(0, "8n", { staffPos: "B3" }).addAnnotation("dynamics", "f").addNote(0, "A3", "8n").addNote(0, "G#3", "8n").addConnective("slur", 2, "below").addNote(0, "A3", "8n").addNote(0, "B3", "8n").addNote(0, "C#4", "8n").addNote(1, "A2", "2.").addMeasure().addNote(0, "D4", "4n").addRest(1, "4n", { staffPos: "D3" }).addNote(0, "D3", "4n").addNote(1, "D3", "4n").addRest(1, "4n", { staffPos: "B3" }).addNavigation("endRepeat").addMeasure().addRest(0, "8n", { staffPos: "D4" }).addAnnotation("dynamics", "f").addNote(0, "D4", "8n").addNote(0, "E4", "8n").addConnective("slur", 2, "below").addNote(0, "D4", "8n").addNote(0, "C#4", "8n").addNote(0, "B3", "8n").addNote(1, "E2", "2.").endRow().addMeasure().addNote(0, "C#4", "8n").addConnective("slur", 2, "below").addNote(0, "D4", "8n").addNote(0, "E4", "8n").addNote(0, "F#4", "8n").addNote(0, "E4", "4n").addNote(1, "A2", "2.").addMeasure().addRest(0, "8n", { staffPos: "B3" }).addAnnotation("dynamics", "p").addNote(0, "E3", "8n").addNote(0, "D#3", "8n").addConnective("slur", 2, "below").addNote(0, "E3", "8n").addNote(0, "F#3", "8n").addNote(0, "G#3", "8n").addNote(1, "E2", "2.").addMeasure().addNote(0, "A3", "8n").addConnective("slur", 2, "below").addNote(0, "G#3", "8n").addNote(0, "A3", "8n").addNote(0, "B3", "8n").addNote(0, "C#4", "4n").addNote(1, "A2", "2.").endRow().addMeasure().addRest(0, "8n", { staffPos: "G4" }).addAnnotation("dynamics", "f").addNote(0, "G4", "8n").addNote(0, "A4", "8n").addConnective("slur", 2, "below").addNote(0, "G4", "8n").addNote(0, "F#4", "8n").addNote(0, "E4", "8n").addNote(1, "A2", "2.").addMeasure().addNote(0, "D4", "8n").addNote(0, "C#4", "8n").addNote(0, "D4", "8n").addNote(0, "E4", "8n").addNote(0, "F#4", "4n").addNote(1, "D3", "2.").addMeasure().addRest(0, "8n", { staffPos: "B3" }).addAnnotation("dynamics", "ff").addNote(0, "A3", "8n").addNote(0, "G#3", "8n").addConnective("slur", 2, "below").addNote(0, "A3", "8n").addNote(0, "B3", "8n").addNote(0, "C#4", "8n").addNote(1, "A2", "2.").addMeasure().addNote(0, "D4", "4n").addRest(1, "4n", { staffPos: "D3" }).addNote(0, "D3", "4n").addNote(1, "D3", "4n").addRest(1, "4n", { staffPos: "B3" }).endSong().getDocument();
 }
 export {
   createAndanteByDiabelli,

package/dist/react-ui/index.d.mts

@@ -1,10 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { c as Scale, S as ScaleType } from '../scale-DRR-t4Kr.mjs';
+import { c as Scale, S as ScaleType } from '../scale-C2pCNxdE.mjs';
 import { b as PitchNotation, G as GuitarNoteLabel, N as Note } from '../note-BFa43I86.mjs';
 import { H as Handedness } from '../guitar-DggbM2UL.mjs';
-import { D as DivRect, M as MDocument, i as ScoreEventListener, W as MRenderer, X as MPlaybackButtons } from '../interface-Bn5HFt_U.mjs';
-import '../tempo-B4h5Ktob.mjs';
+import { D as DivRect, M as MDocument, k as ScoreEventListener, Y as MRenderer, Z as MPlaybackButtons } from '../interface-XoKiryoV.mjs';
+import '../tempo-BAYoZ_Li.mjs';
 import '@tspro/ts-utils-lib';
 
 interface CircleOfFifthsProps {

package/dist/react-ui/index.d.ts

@@ -1,10 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { c as Scale, S as ScaleType } from '../scale-ebJm37q1.js';
-import { b as PitchNotation, G as GuitarNoteLabel, N as Note } from '../note-BFa43I86.js';
-import { H as Handedness } from '../guitar-C2Cp71NZ.js';
-import { D as DivRect, M as MDocument, i as ScoreEventListener, W as MRenderer, X as MPlaybackButtons } from '../interface-BlNl69uT.js';
-import '../tempo-DgqDEsn0.js';
+import { c as Scale, S as ScaleType } from '../scale-CvPbJvfN.js';
+import { b as PitchNotation, G as GuitarNoteLabel, N as Note } from '../note-CcVdUFqS.js';
+import { H as Handedness } from '../guitar-cNmE-EvH.js';
+import { D as DivRect, M as MDocument, k as ScoreEventListener, Y as MRenderer, Z as MPlaybackButtons } from '../interface-7k8qGG44.js';
+import '../tempo-r2sb6Ku2.js';
 import '@tspro/ts-utils-lib';
 
 interface CircleOfFifthsProps {

package/dist/react-ui/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v3.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.0.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/react-ui/index.mjs

@@ -1,7 +1,7 @@
-/* WebMusicScore v3.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.0.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "../chunk-LCTM7BID.mjs";
+} from "../chunk-D643HZHM.mjs";
 
 // src/react-ui/circle-of-fifths.tsx
 import * as React from "react";

package/dist/{scale-DRR-t4Kr.d.mts → scale-C2pCNxdE.d.mts}

@@ -1,5 +1,5 @@
 import { N as Note, S as SymbolSet } from './note-BFa43I86.mjs';
-import { K as KeySignature } from './tempo-B4h5Ktob.mjs';
+import { K as KeySignature } from './tempo-BAYoZ_Li.mjs';
 
 type IntervalDirection = "Unison" | "Ascending" | "Descending";
 type IntervalQuality = "Perfect" | "Major" | "minor" | "Augmented" | "Doubly Augmented" | "diminished" | "doubly diminished";
@@ -66,9 +66,10 @@ declare class ScaleFactory {
     hasScale(tonic: string): boolean;
 }
 declare function getScaleFactoryList(): ReadonlyArray<ScaleFactory | string>;
-declare function getScaleFactory(scaleType: ScaleType): ScaleFactory;
+declare function getScaleFactory(scaleType: ScaleType | `${ScaleType}`): ScaleFactory;
 declare function validateScaleType(scaleType: unknown): ScaleType;
-declare function getScale(tonic: string, scaleType: ScaleType): Scale;
+declare function getScale(tonic: string, scaleType: ScaleType | `${ScaleType}`): Scale;
+declare function getScale(scale: string): Scale;
 declare function getDefaultScale(): Scale;
 
 export { type Degree as D, type IntervalDirection as I, ScaleType as S, type IntervalQuality as a, Interval as b, Scale as c, ScaleFactory as d, getScaleFactory as e, validateScaleType as f, getScaleFactoryList as g, getScale as h, getDefaultScale as i, validateIntervalQuality as v };

package/dist/{scale-ebJm37q1.d.ts → scale-CvPbJvfN.d.ts}

@@ -1,5 +1,5 @@
-import { N as Note, S as SymbolSet } from './note-BFa43I86.js';
-import { K as KeySignature } from './tempo-DgqDEsn0.js';
+import { N as Note, S as SymbolSet } from './note-CcVdUFqS.js';
+import { K as KeySignature } from './tempo-r2sb6Ku2.js';
 
 type IntervalDirection = "Unison" | "Ascending" | "Descending";
 type IntervalQuality = "Perfect" | "Major" | "minor" | "Augmented" | "Doubly Augmented" | "diminished" | "doubly diminished";
@@ -66,9 +66,10 @@ declare class ScaleFactory {
     hasScale(tonic: string): boolean;
 }
 declare function getScaleFactoryList(): ReadonlyArray<ScaleFactory | string>;
-declare function getScaleFactory(scaleType: ScaleType): ScaleFactory;
+declare function getScaleFactory(scaleType: ScaleType | `${ScaleType}`): ScaleFactory;
 declare function validateScaleType(scaleType: unknown): ScaleType;
-declare function getScale(tonic: string, scaleType: ScaleType): Scale;
+declare function getScale(tonic: string, scaleType: ScaleType | `${ScaleType}`): Scale;
+declare function getScale(scale: string): Scale;
 declare function getDefaultScale(): Scale;
 
 export { type Degree as D, type IntervalDirection as I, ScaleType as S, type IntervalQuality as a, Interval as b, Scale as c, ScaleFactory as d, getScaleFactory as e, validateScaleType as f, getScaleFactoryList as g, getScale as h, getDefaultScale as i, validateIntervalQuality as v };

package/dist/score/index.d.mts

@@ -1,54 +1,121 @@
-import { S as StaffPreset, a as ScoreConfiguration, M as MDocument, N as NoteOptions, R as RestOptions, F as Fermata, b as StaffTabOrGroups, c as Navigation, L as Label, A as Annotation, C as Connective, T as TieType, d as NoteAnchor, V as VerticalPosition } from '../interface-Bn5HFt_U.mjs';
-export { a4 as Arpeggio, Y as Clef, a5 as ConnectiveSpan, D as DivRect, k as MAccidental, m as MArpeggio, v as MBarLineLeft, u as MBarLineRight, n as MBeamGroup, l as MConnective, p as MEnding, Q as MExtensionLine, q as MFermata, r as MHeader, s as MImage, t as MMeasure, x as MNoteGroup, X as MPlaybackButtons, U as MPlayer, W as MRenderer, B as MRest, G as MRhythmColumn, H as MScoreRow, K as MSignature, O as MSpecialText, I as MStaff, o as MStaffBeamGroup, y as MStaffNoteGroup, E as MStaffRest, w as MStaffTabBarLine, J as MTab, z as MTabNoteGroup, P as MText, j as MusicInterface, a7 as PlayState, a8 as PlayStateChangeListener, f as ScoreEvent, i as ScoreEventListener, e as ScoreEventType, h as ScoreObjectEvent, g as ScoreStaffPosEvent, Z as StaffConfig, a6 as StaffTabOrGroup, a3 as Stem, a1 as StringNumber, _ as TabConfig, $ as VoiceId, a2 as getStringNumbers, a0 as getVoiceIds } from '../interface-Bn5HFt_U.mjs';
+import { N as NoteOptions, R as RestOptions, S as StaffPreset, a as ScoreConfiguration, M as MDocument, V as VoiceId, T as TupletOptions, F as Fermata, b as StaffTabOrGroups, c as Navigation, A as Annotation, L as Label, C as Connective, d as TieType, e as NoteAnchor, f as VerticalPosition } from '../interface-XoKiryoV.mjs';
+export { a5 as Arpeggio, _ as Clef, D as DivRect, m as MAccidental, o as MArpeggio, x as MBarLineLeft, w as MBarLineRight, p as MBeamGroup, n as MConnective, r as MEnding, W as MExtensionLine, s as MFermata, t as MHeader, u as MImage, v as MMeasure, z as MNoteGroup, Z as MPlaybackButtons, X as MPlayer, Y as MRenderer, G as MRest, I as MRhythmColumn, J as MScoreRow, P as MSignature, Q as MSpecialText, K as MStaff, q as MStaffBeamGroup, B as MStaffNoteGroup, H as MStaffRest, y as MStaffTabBarLine, O as MTab, E as MTabNoteGroup, U as MText, l as MusicInterface, a7 as PlayState, a8 as PlayStateChangeListener, h as ScoreEvent, k as ScoreEventListener, g as ScoreEventType, j as ScoreObjectEvent, i as ScoreStaffPosEvent, $ as StaffConfig, a6 as StaffTabOrGroup, a4 as Stem, a2 as StringNumber, a0 as TabConfig, a3 as getStringNumbers, a1 as getVoiceIds } from '../interface-XoKiryoV.mjs';
 import { N as Note } from '../note-BFa43I86.mjs';
-import { S as ScaleType, c as Scale } from '../scale-DRR-t4Kr.mjs';
-import { K as KeySignature, a as TimeSignature, T as TimeSignatureString, N as NoteLength } from '../tempo-B4h5Ktob.mjs';
+import { S as ScaleType, c as Scale } from '../scale-C2pCNxdE.mjs';
+import { N as NoteLength, h as NoteLengthStr, K as KeySignature, a as TimeSignature, T as TimeSignatureString, j as TupletRatio } from '../tempo-BAYoZ_Li.mjs';
 import '@tspro/ts-utils-lib';
 
+declare enum DynamicsAnnotations {
+    cresc = "cresc.",
+    decresc = "decresc.",
+    dim = "dim.",
+    ppp = "ppp",
+    pp = "pp",
+    p = "p",
+    mp = "mp",
+    m = "m",
+    mf = "mf",
+    f = "f",
+    ff = "ff",
+    fff = "fff"
+}
+declare enum TempoAnnotations {
+    accel = "accel.",
+    rit = "rit.",
+    a_tempo = "a tempo"
+}
+type AnnotationsType = `${DynamicsAnnotations}` | `${TempoAnnotations}`;
+
+type TupletBuilder = {
+    addNote: (note: Note | string, noteLength: NoteLength | NoteLengthStr, options?: NoteOptions) => TupletBuilder;
+    addChord: (notes: (Note | string)[], noteLength: NoteLength | NoteLengthStr, options?: NoteOptions) => TupletBuilder;
+    addRest: (restLength: NoteLength | NoteLengthStr, options?: RestOptions) => TupletBuilder;
+};
+type ExtensionBuilder = {
+    notes: (noteLength: NoteLength | NoteLengthStr, noteCount?: number) => ExtensionBuilder;
+    measures: (measureCount: number) => ExtensionBuilder;
+    infinity: () => ExtensionBuilder;
+    hide: () => ExtensionBuilder;
+};
 declare class DocumentBuilder {
     private readonly doc;
     constructor();
-    setScoreConfiguration(staffPreset: StaffPreset): DocumentBuilder;
+    setScoreConfiguration(staffPreset: StaffPreset | `${StaffPreset}`): DocumentBuilder;
     setScoreConfiguration(config: ScoreConfiguration): DocumentBuilder;
     private getMeasure;
     getDocument(): MDocument;
     setHeader(title?: string, composer?: string, arranger?: string): DocumentBuilder;
     setMeasuresPerRow(measuresPerRow: number): DocumentBuilder;
     addMeasure(): DocumentBuilder;
-    setKeySignature(tonic: string, scaleType: ScaleType): DocumentBuilder;
+    setKeySignature(tonic: string, scaleType: ScaleType | `${ScaleType}`): DocumentBuilder;
     setKeySignature(keySignature: KeySignature): DocumentBuilder;
+    setKeySignature(keySignature: string): DocumentBuilder;
     setKeySignature(scale: Scale): DocumentBuilder;
     setTimeSignature(timeSignature: TimeSignature | TimeSignatureString): DocumentBuilder;
-    setTempo(beatsPerMinute: number, beatLength?: NoteLength, dotted?: boolean): DocumentBuilder;
-    addNote(voiceId: number, note: Note | string, noteLength: NoteLength, options?: NoteOptions): DocumentBuilder;
-    addChord(voiceId: number, notes: (Note | string)[], noteLength: NoteLength, options?: NoteOptions): DocumentBuilder;
-    addRest(voiceId: number, restLength: NoteLength, options?: RestOptions): DocumentBuilder;
+    setTempo(beatsPerMinute: number): DocumentBuilder;
+    setTempo(beatsPerMinute: number, beatLength: NoteLength | NoteLengthStr): DocumentBuilder;
+    /** @deprecated - Use dotted beatLength instead (e.g. "4..") */
+    setTempo(beatsPerMinute: number, beatLength: NoteLength | NoteLengthStr, dotted: boolean | number): DocumentBuilder;
+    addNote(voiceId: number, note: Note | string, noteLength: NoteLength | NoteLengthStr, options?: NoteOptions): DocumentBuilder;
+    addChord(voiceId: number, notes: (Note | string)[], noteLength: NoteLength | NoteLengthStr, options?: NoteOptions): DocumentBuilder;
+    addRest(voiceId: number, restLength: NoteLength | NoteLengthStr, options?: RestOptions): DocumentBuilder;
+    /**
+     * Usage:
+     * <pre>
+     * addTuplet(0, Theory.Tuplet.Triplet, notes => {
+     *     notes.addNote("G3", Theory.NoteLength.Eighth);
+     *     notes.addNote("B3", Theory.NoteLength.Eighth);
+     *     notes.addNote("D4", Theory.NoteLength.Eighth);
+     * });
+     * </pre>
+     *
+     * @param voiceId
+     * @param tupletRatio - You can also use Theory.Tuplet presets (e.g. Theory.Tuplet.Triplet).
+     * @param tupletBuilder
+     * @returns
+     */
+    addTuplet(voiceId: VoiceId, tupletRatio: TupletRatio & TupletOptions, tupletBuilder: (notes: TupletBuilder) => void): DocumentBuilder;
     private addFermataInternal;
-    addFermata(fermata?: Fermata): DocumentBuilder;
+    addFermata(fermata?: Fermata | `${Fermata}`): DocumentBuilder;
     /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addFermataTo(staffTabOrGroups: StaffTabOrGroups, fermata?: Fermata): DocumentBuilder;
+    addFermataTo(staffTabOrGroups: StaffTabOrGroups, fermata?: Fermata | `${Fermata}`): DocumentBuilder;
     private addNavigationInternal;
-    addNavigation(navigation: Navigation): DocumentBuilder;
-    addNavigation(navigation: Navigation.EndRepeat, playCount: number): DocumentBuilder;
-    addNavigation(navigation: Navigation.Ending, ...passages: number[]): DocumentBuilder;
+    addNavigation(navigation: Navigation | `${Navigation}`): DocumentBuilder;
+    addNavigation(navigation: Navigation.EndRepeat | `${Navigation.EndRepeat}`, playCount: number): DocumentBuilder;
+    addNavigation(navigation: Navigation.Ending | `${Navigation.Ending}`, ...passages: number[]): DocumentBuilder;
     /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation): DocumentBuilder;
+    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation | `${Navigation}`): DocumentBuilder;
     /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation.EndRepeat, playCount: number): DocumentBuilder;
+    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation.EndRepeat | `${Navigation.EndRepeat}`, playCount: number): DocumentBuilder;
     /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation.Ending, ...passages: number[]): DocumentBuilder;
-    private addLabelInternal;
-    addLabel(label: Label, text: string): DocumentBuilder;
-    /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addLabelTo(staffTabOrGroups: StaffTabOrGroups, label: Label, text: string): DocumentBuilder;
+    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation.Ending | `${Navigation.Ending}`, ...passages: number[]): DocumentBuilder;
     private addAnnotationInternal;
-    addAnnotation(annotation: Annotation, text: string): DocumentBuilder;
+    addAnnotation(text: AnnotationsType): DocumentBuilder;
+    addAnnotation(annotation: Annotation | `${Annotation}`, text: string): DocumentBuilder;
+    /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
+    addAnnotationTo(staffTabOrGroups: StaffTabOrGroups, text: AnnotationsType): DocumentBuilder;
+    /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
+    addAnnotationTo(staffTabOrGroups: StaffTabOrGroups, annotation: Annotation | `${Annotation}`, text: string): DocumentBuilder;
+    private addLabelInternal;
+    addLabel(label: Label | `${Label}`, text: string): DocumentBuilder;
     /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addAnnotationTo(staffTabOrGroups: StaffTabOrGroups, annotation: Annotation, text: string): DocumentBuilder;
-    addConnective(connective: Connective.Tie, tieSpan?: number | TieType, notAnchor?: NoteAnchor): DocumentBuilder;
-    addConnective(connective: Connective.Slur, slurSpan?: number, notAnchor?: NoteAnchor): DocumentBuilder;
-    addConnective(connective: Connective.Slide, notAnchor?: NoteAnchor): DocumentBuilder;
-    addExtension(extensionLength: NoteLength | number, extensionVisible?: boolean): DocumentBuilder;
+    addLabelTo(staffTabOrGroups: StaffTabOrGroups, label: Label | `${Label}`, text: string): DocumentBuilder;
+    addConnective(connective: Connective.Tie | `${Connective.Tie}`, tieSpan?: number | TieType | `${TieType}`, notAnchor?: NoteAnchor | `${NoteAnchor}`): DocumentBuilder;
+    addConnective(connective: Connective.Slur | `${Connective.Slur}`, slurSpan?: number, notAnchor?: NoteAnchor | `${NoteAnchor}`): DocumentBuilder;
+    addConnective(connective: Connective.Slide | `${Connective.Slide}`, notAnchor?: NoteAnchor | `${NoteAnchor}`): DocumentBuilder;
+    /**
+     * Extension length example:
+     * <pre>
+     *     addExtension(ext => ext.notes("1n", 2))          // length is 2 whole notes
+     *     addExtension(ext => ext.measures(3).hide())      // length is 3 measures, hidden
+     *     addExtension(ext => ext.measures(1).notes("8n")) // length is 1 measure + 1 eigth note
+     *     addExtension(ext => ext.infinity())              // length is as long as possible
+     * </pre>
+     * @param extensionLength
+     * @param extensionVisible
+     * @returns
+     */
+    addExtension(extensionBuilder?: (ext: ExtensionBuilder) => void): DocumentBuilder;
     /**
      *
      * @param groupName - Name of staff group.
@@ -56,12 +123,12 @@ declare class DocumentBuilder {
      * @param verticalPosition - Vertical position, are elements added above, below or both.
      * @returns
      */
-    addStaffGroup(groupName: string, staffsTabsAndGroups: number | string | (number | string)[], verticalPosition?: VerticalPosition): DocumentBuilder;
+    addStaffGroup(groupName: string, staffsTabsAndGroups: number | string | (number | string)[], verticalPosition?: VerticalPosition | `${VerticalPosition}`): DocumentBuilder;
     endSong(): DocumentBuilder;
     endSection(): DocumentBuilder;
     endRow(): DocumentBuilder;
-    completeRests(voiceId?: number): DocumentBuilder;
+    completeRests(voiceId?: VoiceId | VoiceId[]): DocumentBuilder;
     addScaleArpeggio(scale: Scale, bottomNote: string, numOctaves: number): DocumentBuilder;
 }
 
-export { Annotation, Connective, DocumentBuilder, Fermata, Label, MDocument, Navigation, NoteAnchor, NoteOptions, RestOptions, ScoreConfiguration, StaffPreset, StaffTabOrGroups, TieType, VerticalPosition };
+export { Annotation, Connective, DocumentBuilder, type ExtensionBuilder, Fermata, Label, MDocument, Navigation, NoteAnchor, NoteOptions, RestOptions, ScoreConfiguration, StaffPreset, StaffTabOrGroups, TieType, type TupletBuilder, TupletOptions, VerticalPosition, VoiceId };

package/dist/score/index.d.ts

@@ -1,54 +1,121 @@
-import { S as StaffPreset, a as ScoreConfiguration, M as MDocument, N as NoteOptions, R as RestOptions, F as Fermata, b as StaffTabOrGroups, c as Navigation, L as Label, A as Annotation, C as Connective, T as TieType, d as NoteAnchor, V as VerticalPosition } from '../interface-BlNl69uT.js';
-export { a4 as Arpeggio, Y as Clef, a5 as ConnectiveSpan, D as DivRect, k as MAccidental, m as MArpeggio, v as MBarLineLeft, u as MBarLineRight, n as MBeamGroup, l as MConnective, p as MEnding, Q as MExtensionLine, q as MFermata, r as MHeader, s as MImage, t as MMeasure, x as MNoteGroup, X as MPlaybackButtons, U as MPlayer, W as MRenderer, B as MRest, G as MRhythmColumn, H as MScoreRow, K as MSignature, O as MSpecialText, I as MStaff, o as MStaffBeamGroup, y as MStaffNoteGroup, E as MStaffRest, w as MStaffTabBarLine, J as MTab, z as MTabNoteGroup, P as MText, j as MusicInterface, a7 as PlayState, a8 as PlayStateChangeListener, f as ScoreEvent, i as ScoreEventListener, e as ScoreEventType, h as ScoreObjectEvent, g as ScoreStaffPosEvent, Z as StaffConfig, a6 as StaffTabOrGroup, a3 as Stem, a1 as StringNumber, _ as TabConfig, $ as VoiceId, a2 as getStringNumbers, a0 as getVoiceIds } from '../interface-BlNl69uT.js';
-import { N as Note } from '../note-BFa43I86.js';
-import { S as ScaleType, c as Scale } from '../scale-ebJm37q1.js';
-import { K as KeySignature, a as TimeSignature, T as TimeSignatureString, N as NoteLength } from '../tempo-DgqDEsn0.js';
+import { N as NoteOptions, R as RestOptions, S as StaffPreset, a as ScoreConfiguration, M as MDocument, V as VoiceId, T as TupletOptions, F as Fermata, b as StaffTabOrGroups, c as Navigation, A as Annotation, L as Label, C as Connective, d as TieType, e as NoteAnchor, f as VerticalPosition } from '../interface-7k8qGG44.js';
+export { a5 as Arpeggio, _ as Clef, D as DivRect, m as MAccidental, o as MArpeggio, x as MBarLineLeft, w as MBarLineRight, p as MBeamGroup, n as MConnective, r as MEnding, W as MExtensionLine, s as MFermata, t as MHeader, u as MImage, v as MMeasure, z as MNoteGroup, Z as MPlaybackButtons, X as MPlayer, Y as MRenderer, G as MRest, I as MRhythmColumn, J as MScoreRow, P as MSignature, Q as MSpecialText, K as MStaff, q as MStaffBeamGroup, B as MStaffNoteGroup, H as MStaffRest, y as MStaffTabBarLine, O as MTab, E as MTabNoteGroup, U as MText, l as MusicInterface, a7 as PlayState, a8 as PlayStateChangeListener, h as ScoreEvent, k as ScoreEventListener, g as ScoreEventType, j as ScoreObjectEvent, i as ScoreStaffPosEvent, $ as StaffConfig, a6 as StaffTabOrGroup, a4 as Stem, a2 as StringNumber, a0 as TabConfig, a3 as getStringNumbers, a1 as getVoiceIds } from '../interface-7k8qGG44.js';
+import { N as Note } from '../note-CcVdUFqS.js';
+import { S as ScaleType, c as Scale } from '../scale-CvPbJvfN.js';
+import { N as NoteLength, h as NoteLengthStr, K as KeySignature, a as TimeSignature, T as TimeSignatureString, j as TupletRatio } from '../tempo-r2sb6Ku2.js';
 import '@tspro/ts-utils-lib';
 
+declare enum DynamicsAnnotations {
+    cresc = "cresc.",
+    decresc = "decresc.",
+    dim = "dim.",
+    ppp = "ppp",
+    pp = "pp",
+    p = "p",
+    mp = "mp",
+    m = "m",
+    mf = "mf",
+    f = "f",
+    ff = "ff",
+    fff = "fff"
+}
+declare enum TempoAnnotations {
+    accel = "accel.",
+    rit = "rit.",
+    a_tempo = "a tempo"
+}
+type AnnotationsType = `${DynamicsAnnotations}` | `${TempoAnnotations}`;
+
+type TupletBuilder = {
+    addNote: (note: Note | string, noteLength: NoteLength | NoteLengthStr, options?: NoteOptions) => TupletBuilder;
+    addChord: (notes: (Note | string)[], noteLength: NoteLength | NoteLengthStr, options?: NoteOptions) => TupletBuilder;
+    addRest: (restLength: NoteLength | NoteLengthStr, options?: RestOptions) => TupletBuilder;
+};
+type ExtensionBuilder = {
+    notes: (noteLength: NoteLength | NoteLengthStr, noteCount?: number) => ExtensionBuilder;
+    measures: (measureCount: number) => ExtensionBuilder;
+    infinity: () => ExtensionBuilder;
+    hide: () => ExtensionBuilder;
+};
 declare class DocumentBuilder {
     private readonly doc;
     constructor();
-    setScoreConfiguration(staffPreset: StaffPreset): DocumentBuilder;
+    setScoreConfiguration(staffPreset: StaffPreset | `${StaffPreset}`): DocumentBuilder;
     setScoreConfiguration(config: ScoreConfiguration): DocumentBuilder;
     private getMeasure;
     getDocument(): MDocument;
     setHeader(title?: string, composer?: string, arranger?: string): DocumentBuilder;
     setMeasuresPerRow(measuresPerRow: number): DocumentBuilder;
     addMeasure(): DocumentBuilder;
-    setKeySignature(tonic: string, scaleType: ScaleType): DocumentBuilder;
+    setKeySignature(tonic: string, scaleType: ScaleType | `${ScaleType}`): DocumentBuilder;
     setKeySignature(keySignature: KeySignature): DocumentBuilder;
+    setKeySignature(keySignature: string): DocumentBuilder;
     setKeySignature(scale: Scale): DocumentBuilder;
     setTimeSignature(timeSignature: TimeSignature | TimeSignatureString): DocumentBuilder;
-    setTempo(beatsPerMinute: number, beatLength?: NoteLength, dotted?: boolean): DocumentBuilder;
-    addNote(voiceId: number, note: Note | string, noteLength: NoteLength, options?: NoteOptions): DocumentBuilder;
-    addChord(voiceId: number, notes: (Note | string)[], noteLength: NoteLength, options?: NoteOptions): DocumentBuilder;
-    addRest(voiceId: number, restLength: NoteLength, options?: RestOptions): DocumentBuilder;
+    setTempo(beatsPerMinute: number): DocumentBuilder;
+    setTempo(beatsPerMinute: number, beatLength: NoteLength | NoteLengthStr): DocumentBuilder;
+    /** @deprecated - Use dotted beatLength instead (e.g. "4..") */
+    setTempo(beatsPerMinute: number, beatLength: NoteLength | NoteLengthStr, dotted: boolean | number): DocumentBuilder;
+    addNote(voiceId: number, note: Note | string, noteLength: NoteLength | NoteLengthStr, options?: NoteOptions): DocumentBuilder;
+    addChord(voiceId: number, notes: (Note | string)[], noteLength: NoteLength | NoteLengthStr, options?: NoteOptions): DocumentBuilder;
+    addRest(voiceId: number, restLength: NoteLength | NoteLengthStr, options?: RestOptions): DocumentBuilder;
+    /**
+     * Usage:
+     * <pre>
+     * addTuplet(0, Theory.Tuplet.Triplet, notes => {
+     *     notes.addNote("G3", Theory.NoteLength.Eighth);
+     *     notes.addNote("B3", Theory.NoteLength.Eighth);
+     *     notes.addNote("D4", Theory.NoteLength.Eighth);
+     * });
+     * </pre>
+     *
+     * @param voiceId
+     * @param tupletRatio - You can also use Theory.Tuplet presets (e.g. Theory.Tuplet.Triplet).
+     * @param tupletBuilder
+     * @returns
+     */
+    addTuplet(voiceId: VoiceId, tupletRatio: TupletRatio & TupletOptions, tupletBuilder: (notes: TupletBuilder) => void): DocumentBuilder;
     private addFermataInternal;
-    addFermata(fermata?: Fermata): DocumentBuilder;
+    addFermata(fermata?: Fermata | `${Fermata}`): DocumentBuilder;
     /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addFermataTo(staffTabOrGroups: StaffTabOrGroups, fermata?: Fermata): DocumentBuilder;
+    addFermataTo(staffTabOrGroups: StaffTabOrGroups, fermata?: Fermata | `${Fermata}`): DocumentBuilder;
     private addNavigationInternal;
-    addNavigation(navigation: Navigation): DocumentBuilder;
-    addNavigation(navigation: Navigation.EndRepeat, playCount: number): DocumentBuilder;
-    addNavigation(navigation: Navigation.Ending, ...passages: number[]): DocumentBuilder;
+    addNavigation(navigation: Navigation | `${Navigation}`): DocumentBuilder;
+    addNavigation(navigation: Navigation.EndRepeat | `${Navigation.EndRepeat}`, playCount: number): DocumentBuilder;
+    addNavigation(navigation: Navigation.Ending | `${Navigation.Ending}`, ...passages: number[]): DocumentBuilder;
     /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation): DocumentBuilder;
+    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation | `${Navigation}`): DocumentBuilder;
     /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation.EndRepeat, playCount: number): DocumentBuilder;
+    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation.EndRepeat | `${Navigation.EndRepeat}`, playCount: number): DocumentBuilder;
     /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation.Ending, ...passages: number[]): DocumentBuilder;
-    private addLabelInternal;
-    addLabel(label: Label, text: string): DocumentBuilder;
-    /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addLabelTo(staffTabOrGroups: StaffTabOrGroups, label: Label, text: string): DocumentBuilder;
+    addNavigationTo(staffTabOrGroups: StaffTabOrGroups, navigation: Navigation.Ending | `${Navigation.Ending}`, ...passages: number[]): DocumentBuilder;
     private addAnnotationInternal;
-    addAnnotation(annotation: Annotation, text: string): DocumentBuilder;
+    addAnnotation(text: AnnotationsType): DocumentBuilder;
+    addAnnotation(annotation: Annotation | `${Annotation}`, text: string): DocumentBuilder;
+    /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
+    addAnnotationTo(staffTabOrGroups: StaffTabOrGroups, text: AnnotationsType): DocumentBuilder;
+    /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
+    addAnnotationTo(staffTabOrGroups: StaffTabOrGroups, annotation: Annotation | `${Annotation}`, text: string): DocumentBuilder;
+    private addLabelInternal;
+    addLabel(label: Label | `${Label}`, text: string): DocumentBuilder;
     /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-    addAnnotationTo(staffTabOrGroups: StaffTabOrGroups, annotation: Annotation, text: string): DocumentBuilder;
-    addConnective(connective: Connective.Tie, tieSpan?: number | TieType, notAnchor?: NoteAnchor): DocumentBuilder;
-    addConnective(connective: Connective.Slur, slurSpan?: number, notAnchor?: NoteAnchor): DocumentBuilder;
-    addConnective(connective: Connective.Slide, notAnchor?: NoteAnchor): DocumentBuilder;
-    addExtension(extensionLength: NoteLength | number, extensionVisible?: boolean): DocumentBuilder;
+    addLabelTo(staffTabOrGroups: StaffTabOrGroups, label: Label | `${Label}`, text: string): DocumentBuilder;
+    addConnective(connective: Connective.Tie | `${Connective.Tie}`, tieSpan?: number | TieType | `${TieType}`, notAnchor?: NoteAnchor | `${NoteAnchor}`): DocumentBuilder;
+    addConnective(connective: Connective.Slur | `${Connective.Slur}`, slurSpan?: number, notAnchor?: NoteAnchor | `${NoteAnchor}`): DocumentBuilder;
+    addConnective(connective: Connective.Slide | `${Connective.Slide}`, notAnchor?: NoteAnchor | `${NoteAnchor}`): DocumentBuilder;
+    /**
+     * Extension length example:
+     * <pre>
+     *     addExtension(ext => ext.notes("1n", 2))          // length is 2 whole notes
+     *     addExtension(ext => ext.measures(3).hide())      // length is 3 measures, hidden
+     *     addExtension(ext => ext.measures(1).notes("8n")) // length is 1 measure + 1 eigth note
+     *     addExtension(ext => ext.infinity())              // length is as long as possible
+     * </pre>
+     * @param extensionLength
+     * @param extensionVisible
+     * @returns
+     */
+    addExtension(extensionBuilder?: (ext: ExtensionBuilder) => void): DocumentBuilder;
     /**
      *
      * @param groupName - Name of staff group.
@@ -56,12 +123,12 @@ declare class DocumentBuilder {
      * @param verticalPosition - Vertical position, are elements added above, below or both.
      * @returns
      */
-    addStaffGroup(groupName: string, staffsTabsAndGroups: number | string | (number | string)[], verticalPosition?: VerticalPosition): DocumentBuilder;
+    addStaffGroup(groupName: string, staffsTabsAndGroups: number | string | (number | string)[], verticalPosition?: VerticalPosition | `${VerticalPosition}`): DocumentBuilder;
     endSong(): DocumentBuilder;
     endSection(): DocumentBuilder;
     endRow(): DocumentBuilder;
-    completeRests(voiceId?: number): DocumentBuilder;
+    completeRests(voiceId?: VoiceId | VoiceId[]): DocumentBuilder;
     addScaleArpeggio(scale: Scale, bottomNote: string, numOctaves: number): DocumentBuilder;
 }
 
-export { Annotation, Connective, DocumentBuilder, Fermata, Label, MDocument, Navigation, NoteAnchor, NoteOptions, RestOptions, ScoreConfiguration, StaffPreset, StaffTabOrGroups, TieType, VerticalPosition };
+export { Annotation, Connective, DocumentBuilder, type ExtensionBuilder, Fermata, Label, MDocument, Navigation, NoteAnchor, NoteOptions, RestOptions, ScoreConfiguration, StaffPreset, StaffTabOrGroups, TieType, type TupletBuilder, TupletOptions, VerticalPosition, VoiceId };