@scorelabs/core 1.0.11 → 1.1.0

package/dist/models/Note.js

@@ -1,10 +1,10 @@
 import { Pitch } from './Pitch.js';
 import { Accidental, Duration, calculateDurationValue, } from './types.js';
-// TODO: replace dotCountOrIsDotted with dotCount: number and use it everywhere. Do not worry about legacy stuff.
 export class Note {
     duration;
     pitch;
     isRest;
+    dotCount;
     accidental;
     beamGroup;
     articulations;
@@ -14,6 +14,7 @@ export class Note {
     tuplet;
     hairpin;
     isGrace;
+    isCue;
     lyric;
     chord;
     glissando;
@@ -35,12 +36,24 @@ export class Note {
     palmMute;
     hammerOn;
     pullOff;
+    tieSpans;
+    slurs;
+    beamLevels;
+    grace;
+    accidentalDisplay;
+    restDisplay;
+    ornamentDetails;
+    harmonic;
+    bend;
+    vibrato;
+    placement;
     constructor(duration, pitch, // undefined for rests
-    isRest = false, dotCountOrIsDotted = 0, accidental, beamGroup, // Group ID for beamed notes
-    articulations = [], dynamic, tie, slur, tuplet, hairpin, isGrace = false, lyric, chord, glissando, arpeggio, ottava, pedal, ornament, fret, string, fretboardDiagram, lyrics, staffText, color, notehead, bowing, fingering, stemDirection, isStringCircled, palmMute, hammerOn, pullOff) {
+    isRest = false, dotCount = 0, accidental, beamGroup, // Group ID for beamed notes
+    articulations = [], dynamic, tie, slur, tuplet, hairpin, isGrace = false, isCue = false, lyric, chord, glissando, arpeggio, ottava, pedal, ornament, fret, string, fretboardDiagram, lyrics, staffText, color, notehead, bowing, fingering, stemDirection, isStringCircled, palmMute, hammerOn, pullOff, tieSpans = tie ? [{ placement: 'start', number: 1 }] : [], slurs = slur ? [slur] : [], beamLevels, grace, accidentalDisplay, restDisplay, ornamentDetails, harmonic, bend, vibrato, placement) {
         this.duration = duration;
         this.pitch = pitch;
         this.isRest = isRest;
+        this.dotCount = dotCount;
         this.accidental = accidental;
         this.beamGroup = beamGroup;
         this.articulations = articulations;
@@ -50,6 +63,7 @@ export class Note {
         this.tuplet = tuplet;
         this.hairpin = hairpin;
         this.isGrace = isGrace;
+        this.isCue = isCue;
         this.lyric = lyric;
         this.chord = chord;
         this.glissando = glissando;
@@ -71,10 +85,18 @@ export class Note {
         this.palmMute = palmMute;
         this.hammerOn = hammerOn;
         this.pullOff = pullOff;
-        this.dotCount =
-            typeof dotCountOrIsDotted === 'number' ? dotCountOrIsDotted : dotCountOrIsDotted ? 1 : 0;
+        this.tieSpans = tieSpans;
+        this.slurs = slurs;
+        this.beamLevels = beamLevels;
+        this.grace = grace;
+        this.accidentalDisplay = accidentalDisplay;
+        this.restDisplay = restDisplay;
+        this.ornamentDetails = ornamentDetails;
+        this.harmonic = harmonic;
+        this.bend = bend;
+        this.vibrato = vibrato;
+        this.placement = placement;
     }
-    dotCount;
     get isDotted() {
         return this.dotCount > 0;
     }
@@ -121,10 +143,13 @@ export class Note {
                 this.duration === Duration.TwoHundredFiftySixth));
     }
     withGrace(isGrace) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
+    }
+    withCue(isCue) {
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withChord(chord) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     transpose(semitones) {
         if (this.isRest || !this.pitch) {
@@ -134,7 +159,7 @@ export class Note {
         const chromaticIdx = newPitch.midiNumber % 12;
         const hasSharp = [1, 3, 6, 8, 10].includes(chromaticIdx);
         const newAccidental = hasSharp ? Accidental.Sharp : undefined;
-        return new Note(this.duration, newPitch, this.isRest, this.dotCount, newAccidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, newPitch, this.isRest, this.dotCount, newAccidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     transposeOctave(octaves) {
         if (!this.pitch || this.isRest)
@@ -167,97 +192,115 @@ export class Note {
         return this.withPitch(newPitch).withAccidental(newAccidental);
     }
     withPitch(pitch) {
-        return new Note(this.duration, pitch, false, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, pitch, false, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withArticulation(articulation) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, articulation ? [articulation] : [], this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, articulation ? [articulation] : [], this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withArticulations(articulations) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withDynamic(dynamic) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withTie(tie) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        const tieSpans = tie ? [{ placement: 'start', number: 1 }] : [];
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withSlur(slur) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        const slurs = slur ? [slur] : [];
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, slurs);
     }
     withTuplet(tuplet) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withLyric(lyric) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withLyrics(lyrics) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withHairpin(hairpin) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withAccidental(accidental) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
+    }
+    withAccidentalDisplay(accidentalDisplay) {
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
-    withDuration(duration, dotCountOrIsDotted = 0) {
-        return new Note(duration, this.pitch, this.isRest, dotCountOrIsDotted, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+    withDuration(duration, dotCount = 0) {
+        return new Note(duration, this.pitch, this.isRest, dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withRest(isRest) {
-        return new Note(this.duration, this.pitch, isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withFretboardDiagram(diagram) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, diagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, diagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withBeamGroup(beamGroup) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        const preservedBeamLevels = beamGroup === this.beamGroup ? this.beamLevels : undefined;
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, preservedBeamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withGlissando(glissando) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withArpeggio(arpeggio) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withOttava(ottava) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withPedal(pedal) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withOrnament(ornament) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, ornament ? this.ornamentDetails : undefined, this.harmonic, this.bend, this.vibrato);
+    }
+    withOrnamentDetails(ornamentDetails) {
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withTab(fret, string) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, fret, string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, fret, string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withStaffText(text) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, text, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, text, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withColor(color) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withNotehead(notehead) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withBowing(bowing) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withFingering(fingering) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withStemDirection(stemDirection) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withStringCircled(isStringCircled) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, isStringCircled, this.palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withPalmMute(palmMute) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, palmMute, this.hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withHammerOn(hammerOn) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, hammerOn, this.pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
     }
     withPullOff(pullOff) {
-        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, pullOff);
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, this.vibrato);
+    }
+    withHarmonic(harmonic) {
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, harmonic, this.bend, this.vibrato);
+    }
+    withBend(bend) {
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, bend, this.vibrato);
+    }
+    withVibrato(vibrato) {
+        return new Note(this.duration, this.pitch, this.isRest, this.dotCount, this.accidental, this.beamGroup, this.articulations, this.dynamic, this.tie, this.slur, this.tuplet, this.hairpin, this.isGrace, this.isCue, this.lyric, this.chord, this.glissando, this.arpeggio, this.ottava, this.pedal, this.ornament, this.fret, this.string, this.fretboardDiagram, this.lyrics, this.staffText, this.color, this.notehead, this.bowing, this.fingering, this.stemDirection, this.isStringCircled, this.palmMute, this.hammerOn, this.pullOff, this.tieSpans, this.slurs, this.beamLevels, this.grace, this.accidentalDisplay, this.restDisplay, this.ornamentDetails, this.harmonic, this.bend, vibrato);
     }
     toJSON() {
         return {
@@ -277,13 +320,17 @@ export class Note {
             dotCount: this.dotCount || undefined,
             accidental: this.accidental,
             beamGroup: this.beamGroup,
+            beamLevels: this.beamLevels,
             articulations: this.articulations.length > 0 ? this.articulations : undefined,
             dynamic: this.dynamic,
             tie: this.tie,
             slur: this.slur,
+            tieSpans: this.tieSpans.length > 0 ? this.tieSpans : undefined,
+            slurs: this.slurs.length > 0 ? this.slurs : undefined,
             tuplet: this.tuplet,
             hairpin: this.hairpin,
             isGrace: this.isGrace || undefined,
+            isCue: this.isCue || undefined,
             lyric: this.lyric,
             chord: this.chord,
             glissando: this.glissando,
@@ -305,6 +352,14 @@ export class Note {
             palmMute: this.palmMute,
             hammerOn: this.hammerOn,
             pullOff: this.pullOff,
+            grace: this.grace,
+            accidentalDisplay: this.accidentalDisplay,
+            restDisplay: this.restDisplay,
+            ornamentDetails: this.ornamentDetails,
+            harmonic: this.harmonic,
+            bend: this.bend,
+            vibrato: this.vibrato,
+            placement: this.placement,
             // Legacy field (optional)
             articulation: this.articulations.length > 0 ? this.articulations[0] : undefined,
         };
@@ -321,6 +376,6 @@ export class Note {
         else if (data.articulation) {
             articulations = [data.articulation];
         }
-        return new Note(data.duration, pitch, data.isRest ?? false, data.dotCount !== undefined ? data.dotCount : data.isDotted ? 1 : 0, data.accidental, data.beamGroup, articulations, data.dynamic, data.tie, data.slur, data.tuplet, data.hairpin, data.isGrace ?? false, data.lyric, data.chord, data.glissando, data.arpeggio, data.ottava, data.pedal, data.ornament, data.fret, data.string, data.fretboardDiagram, data.lyrics, data.staffText, data.color, data.notehead, data.bowing, data.fingering, data.stemDirection, data.isStringCircled, data.palmMute, data.hammerOn, data.pullOff);
+        return new Note(data.duration, pitch, data.isRest ?? false, data.dotCount !== undefined ? data.dotCount : data.isDotted ? 1 : 0, data.accidental, data.beamGroup, articulations, data.dynamic, data.tie, data.slur, data.tuplet, data.hairpin, data.isGrace ?? false, data.isCue ?? false, data.lyric, data.chord, data.glissando, data.arpeggio, data.ottava, data.pedal, data.ornament, data.fret, data.string, data.fretboardDiagram, data.lyrics, data.staffText, data.color, data.notehead, data.bowing, data.fingering, data.stemDirection, data.isStringCircled, data.palmMute, data.hammerOn, data.pullOff, data.tieSpans || [], data.slurs || (data.slur ? [data.slur] : []), data.beamLevels, data.grace, data.accidentalDisplay, data.restDisplay, data.ornamentDetails, data.harmonic, data.bend, data.vibrato, data.placement);
     }
 }

package/dist/models/NoteSet.d.ts

@@ -1,6 +1,6 @@
 import { Note, NoteJSON } from './Note.js';
 import { Pitch } from './Pitch.js';
-import { Accidental, Arpeggio, Articulation, Bowing, Duration, Dynamic, FretboardDiagram, Glissando, Hairpin, Lyric, NoteheadShape, Ornament, Ottava, Pedal, Slur, StemDirection, Tuplet } from './types.js';
+import { Accidental, AccidentalDisplay, Arpeggio, Articulation, BeamLevels, Bowing, Duration, Dynamic, FretboardDiagram, Glissando, GraceNote, Hairpin, Lyric, NoteheadShape, Ornament, Ottava, Pedal, RestDisplay, Slur, StemDirection, TieSpan, Tuplet } from './types.js';
 export declare class NoteSet {
     readonly notes: Note[];
     constructor(notes: Note[]);
@@ -9,10 +9,11 @@ export declare class NoteSet {
     get dotCount(): number;
     get isRest(): boolean;
     get beamGroup(): number | undefined;
+    get beamLevels(): BeamLevels | undefined;
     get tuplet(): Tuplet | undefined;
     getDurationValue(): number;
     isBeamable(): boolean;
-    withDuration(duration: Duration, dotCountOrIsDotted?: number | boolean): NoteSet;
+    withDuration(duration: Duration, dotCount?: number): NoteSet;
     withBeamGroup(group?: number): NoteSet;
     withNotes(notes: Note[]): NoteSet;
     withLyrics(lyrics: Lyric[]): NoteSet;
@@ -21,6 +22,8 @@ export declare class NoteSet {
     withAccidental(accidental?: Accidental): NoteSet;
     withRest(isRest: boolean): NoteSet;
     withGrace(isGrace: boolean): NoteSet;
+    withCue(isCue: boolean): NoteSet;
+    withAccidentalDisplay(accidentalDisplay?: AccidentalDisplay): NoteSet;
     toggleEnharmonic(): NoteSet;
     transpose(semitones: number): NoteSet;
     transposeOctave(octaves: number): NoteSet;
@@ -51,8 +54,14 @@ export declare class NoteSet {
     withFretboardDiagram(diagram?: FretboardDiagram): NoteSet;
     get pitch(): Pitch | undefined;
     get accidental(): Accidental | undefined;
+    get accidentalDisplay(): AccidentalDisplay | undefined;
     get tie(): boolean | undefined;
     get slur(): Slur | undefined;
+    get tieSpans(): TieSpan[];
+    get slurs(): Slur[];
+    get grace(): GraceNote | undefined;
+    get isCue(): boolean;
+    get restDisplay(): RestDisplay | undefined;
     get articulations(): Articulation[] | undefined;
     get articulation(): Articulation | undefined;
     get ornament(): Ornament | undefined;

package/dist/models/NoteSet.js

@@ -23,6 +23,9 @@ export class NoteSet {
     get beamGroup() {
         return this.notes[0].beamGroup;
     }
+    get beamLevels() {
+        return this.notes[0].beamLevels;
+    }
     get tuplet() {
         return this.notes[0].tuplet;
     }
@@ -32,8 +35,8 @@ export class NoteSet {
     isBeamable() {
         return this.notes[0].isBeamable();
     }
-    withDuration(duration, dotCountOrIsDotted = 0) {
-        return new NoteSet(this.notes.map((n) => n.withDuration(duration, dotCountOrIsDotted)));
+    withDuration(duration, dotCount = 0) {
+        return new NoteSet(this.notes.map((n) => n.withDuration(duration, dotCount)));
     }
     withBeamGroup(group) {
         return new NoteSet(this.notes.map((n) => n.withBeamGroup(group)));
@@ -81,6 +84,16 @@ export class NoteSet {
     withGrace(isGrace) {
         return new NoteSet(this.notes.map((n) => n.withGrace(isGrace)));
     }
+    withCue(isCue) {
+        return new NoteSet(this.notes.map((n) => n.withCue(isCue)));
+    }
+    withAccidentalDisplay(accidentalDisplay) {
+        const newNotes = [...this.notes];
+        if (newNotes.length > 0) {
+            newNotes[0] = newNotes[0].withAccidentalDisplay(accidentalDisplay);
+        }
+        return new NoteSet(newNotes);
+    }
     toggleEnharmonic() {
         const newNotes = [...this.notes];
         if (newNotes.length > 0) {
@@ -175,12 +188,30 @@ export class NoteSet {
     get accidental() {
         return this.notes[0].accidental;
     }
+    get accidentalDisplay() {
+        return this.notes[0].accidentalDisplay;
+    }
     get tie() {
         return this.notes[0].tie;
     }
     get slur() {
         return this.notes[0].slur;
     }
+    get tieSpans() {
+        return this.notes[0].tieSpans || [];
+    }
+    get slurs() {
+        return this.notes[0].slurs || (this.notes[0].slur ? [this.notes[0].slur] : []);
+    }
+    get grace() {
+        return this.notes[0].grace;
+    }
+    get isCue() {
+        return !!this.notes[0].isCue;
+    }
+    get restDisplay() {
+        return this.notes[0].restDisplay;
+    }
     get articulations() {
         return this.notes[0].articulations;
     }

package/dist/models/Part.d.ts

@@ -19,7 +19,7 @@ export declare class Part {
     replaceNote(staffIndex: number, measureIndex: number, noteIndex: number, newNote: Note, voiceIndex?: number): Part;
     replaceMeasure(staffIndex: number, measureIndex: number, newMeasure: Measure): Part;
     deleteNote(staffIndex: number, measureIndex: number, noteIndex: number, voiceIndex?: number): Part;
-    changeNoteDuration(staffIndex: number, measureIndex: number, noteIndex: number, newDuration: Duration, isDotted?: boolean, voiceIndex?: number): Part;
+    changeNoteDuration(staffIndex: number, measureIndex: number, noteIndex: number, newDuration: Duration, dotCount?: number, voiceIndex?: number): Part;
     toJSON(): PartJSON;
     withInstrument(instrument: Instrument): Part;
     replaceStaff(staffIndex: number, newStaff: Staff): Part;

package/dist/models/Part.js

@@ -49,11 +49,11 @@ export class Part {
         newStaves[staffIndex] = newStaves[staffIndex].deleteNote(measureIndex, noteIndex, voiceIndex);
         return new Part(this.name, newStaves, this.abbreviation, this.instrument);
     }
-    changeNoteDuration(staffIndex, measureIndex, noteIndex, newDuration, isDotted = false, voiceIndex = 0) {
+    changeNoteDuration(staffIndex, measureIndex, noteIndex, newDuration, dotCount = 0, voiceIndex = 0) {
         if (staffIndex < 0 || staffIndex >= this.staves.length)
             return this;
         const newStaves = [...this.staves];
-        newStaves[staffIndex] = newStaves[staffIndex].changeNoteDuration(measureIndex, noteIndex, newDuration, isDotted, voiceIndex);
+        newStaves[staffIndex] = newStaves[staffIndex].changeNoteDuration(measureIndex, noteIndex, newDuration, dotCount, voiceIndex);
         return new Part(this.name, newStaves, this.abbreviation, this.instrument);
     }
     toJSON() {

package/dist/models/Score.d.ts

@@ -14,7 +14,6 @@ export declare class Score {
     readonly parts: Part[];
     readonly bpm: number;
     readonly tempoDuration: Duration;
-    readonly tempoIsDotted: boolean;
     readonly copyright: string;
     readonly lyricist: string;
     readonly swing: boolean;
@@ -22,7 +21,7 @@ export declare class Score {
     readonly genre: Genre;
     readonly tempoText: string;
     readonly tempoDotCount: number;
-    constructor(title: string, composer: string, timeSignature: TimeSignature, keySignature: KeySignature, parts: Part[], bpm?: number, tempoDuration?: Duration, tempoIsDotted?: boolean, copyright?: string, lyricist?: string, swing?: boolean, subtitle?: string, genre?: Genre, tempoText?: string, tempoDotCount?: number);
+    constructor(title: string, composer: string, timeSignature: TimeSignature, keySignature: KeySignature, parts: Part[], bpm?: number, tempoDuration?: Duration, copyright?: string, lyricist?: string, swing?: boolean, subtitle?: string, genre?: Genre, tempoText?: string, tempoDotCount?: number);
     withTitle(title: string): Score;
     withComposer(composer: string): Score;
     withSubtitle(subtitle: string): Score;
@@ -57,10 +56,10 @@ export declare class Score {
     private reflowStaff;
     replaceMeasure(partIndex: number, staffIndex: number, measureIndex: number, newMeasure: Measure, autoBeam?: boolean): Score;
     deleteNote(partIndex: number, staffIndex: number, measureIndex: number, noteIndex: number, voiceIndex?: number): Score;
-    changeNoteDuration(partIndex: number, staffIndex: number, measureIndex: number, noteIndex: number, newDuration: Duration, isDotted?: boolean, voiceIndex?: number): Score;
+    changeNoteDuration(partIndex: number, staffIndex: number, measureIndex: number, noteIndex: number, newDuration: Duration, dotCount?: number, voiceIndex?: number): Score;
     moveNoteToVoice(partIndex: number, staffIndex: number, measureIndex: number, noteIndex: number, fromVoiceIndex: number, toVoiceIndex: number): Score;
     pasteNotes(partIndex: number, staffIndex: number, measureIndex: number, noteIndex: number, notesToPaste: NoteSet[]): Score;
-    withTempo(bpm: number, duration: Duration, isDotted: boolean): Score;
+    withTempo(bpm: number, duration: Duration, dotCount?: number): Score;
     withTempoText(text: string): Score;
     withSwing(swing: boolean): Score;
     withLyricist(lyricist: string): Score;
@@ -73,6 +72,7 @@ export declare class Score {
     replaceStaff(partIndex: number, staffIndex: number, newStaff: Staff): Score;
     addMeasure(index: number, measure: Measure): Score;
     deleteMeasure(index: number): Score;
+    deleteMeasures(startIndex: number, endIndex: number): Score;
     getPlaybackSequence(): number[];
 }
 export interface ScoreJSON {
@@ -83,8 +83,8 @@ export interface ScoreJSON {
     parts: PartJSON[];
     bpm?: number;
     tempoDuration?: Duration;
-    tempoIsDotted?: boolean;
     tempoDotCount?: number;
+    tempoIsDotted?: boolean;
     copyright?: string;
     lyricist?: string;
     swing?: boolean;