@scorelabs/core 1.0.10 → 1.0.13

package/dist/models/Note.js

@@ -1,13 +1,10 @@
-import { Pitch } from './Pitch';
-import { Accidental, DURATION_VALUES, Duration, } from './types';
-/**
- * Represents a single note or rest in a measure.
- */
+import { Pitch } from './Pitch.js';
+import { Accidental, Duration, calculateDurationValue, } from './types.js';
 export class Note {
     duration;
     pitch;
     isRest;
-    isDotted;
+    dotCount;
     accidental;
     beamGroup;
     articulations;
@@ -17,6 +14,7 @@ export class Note {
     tuplet;
     hairpin;
     isGrace;
+    isCue;
     lyric;
     chord;
     glissando;
@@ -38,13 +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, isDotted = false, 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.isDotted = isDotted;
+        this.dotCount = dotCount;
         this.accidental = accidental;
         this.beamGroup = beamGroup;
         this.articulations = articulations;
@@ -54,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;
@@ -75,6 +85,20 @@ export class Note {
         this.palmMute = palmMute;
         this.hammerOn = hammerOn;
         this.pullOff = pullOff;
+        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;
+    }
+    get isDotted() {
+        return this.dotCount > 0;
     }
     /**
      * Get all lyrics as standardized objects
@@ -100,8 +124,7 @@ export class Note {
     getDurationValue() {
         if (this.isGrace)
             return 0;
-        const base = DURATION_VALUES[this.duration];
-        let val = this.isDotted ? base * 1.5 : base;
+        let val = calculateDurationValue(this.duration, this.dotCount);
         if (this.tuplet) {
             val = val * (this.tuplet.normal / this.tuplet.actual);
         }
@@ -120,10 +143,13 @@ export class Note {
                 this.duration === Duration.TwoHundredFiftySixth));
     }
     withGrace(isGrace) {
-        return new Note(this.duration, this.pitch, this.isRest, this.isDotted, 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);
+        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.isDotted, 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);
+        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) {
@@ -133,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.isDotted, 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)
@@ -166,97 +192,115 @@ export class Note {
         return this.withPitch(newPitch).withAccidental(newAccidental);
     }
     withPitch(pitch) {
-        return new Note(this.duration, pitch, false, this.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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, isDotted = false) {
-        return new Note(duration, this.pitch, this.isRest, isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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);
+        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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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.isDotted, 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 {
@@ -273,15 +317,20 @@ export class Note {
                     : undefined,
             isRest: this.isRest || undefined,
             isDotted: this.isDotted || undefined,
+            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,
@@ -303,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,
         };
@@ -319,6 +376,6 @@ export class Note {
         else if (data.articulation) {
             articulations = [data.articulation];
         }
-        return new Note(data.duration, pitch, data.isRest ?? false, data.isDotted ?? false, 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,17 +1,19 @@
-import { Note, NoteJSON } from './Note';
-import { Pitch } from './Pitch';
-import { Accidental, Arpeggio, Articulation, Bowing, Duration, Dynamic, FretboardDiagram, Glissando, Hairpin, Lyric, NoteheadShape, Ornament, Ottava, Pedal, Slur, StemDirection, Tuplet } from './types';
+import { Note, NoteJSON } from './Note.js';
+import { Pitch } from './Pitch.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[]);
     get duration(): Duration;
     get isDotted(): boolean;
+    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, isDotted?: boolean): NoteSet;
+    withDuration(duration: Duration, dotCount?: number): NoteSet;
     withBeamGroup(group?: number): NoteSet;
     withNotes(notes: Note[]): NoteSet;
     withLyrics(lyrics: Lyric[]): NoteSet;
@@ -20,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;
@@ -50,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

@@ -1,5 +1,5 @@
-import { Note } from './Note';
-import { Duration, } from './types';
+import { Note } from './Note.js';
+import { Duration, } from './types.js';
 export class NoteSet {
     notes;
     constructor(notes) {
@@ -14,12 +14,18 @@ export class NoteSet {
     get isDotted() {
         return this.notes[0].isDotted;
     }
+    get dotCount() {
+        return this.notes[0].dotCount;
+    }
     get isRest() {
         return this.notes[0].isRest;
     }
     get beamGroup() {
         return this.notes[0].beamGroup;
     }
+    get beamLevels() {
+        return this.notes[0].beamLevels;
+    }
     get tuplet() {
         return this.notes[0].tuplet;
     }
@@ -29,8 +35,8 @@ export class NoteSet {
     isBeamable() {
         return this.notes[0].isBeamable();
     }
-    withDuration(duration, isDotted = false) {
-        return new NoteSet(this.notes.map((n) => n.withDuration(duration, isDotted)));
+    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)));
@@ -78,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) {
@@ -172,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

@@ -1,8 +1,8 @@
-import { Instrument } from './Instrument';
-import { Measure } from './Measure';
-import { Note } from './Note';
-import { Staff, StaffJSON } from './Staff';
-import { Duration } from './types';
+import { Instrument } from './Instrument.js';
+import { Measure } from './Measure.js';
+import { Note } from './Note.js';
+import { Staff, StaffJSON } from './Staff.js';
+import { Duration } from './types.js';
 /**
  * Represents a musical part (instrument/voice) which can have multiple staves.
  */
@@ -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

@@ -1,5 +1,5 @@
-import { PRESET_INSTRUMENTS } from './Instrument';
-import { Staff } from './Staff';
+import { PRESET_INSTRUMENTS } from './Instrument.js';
+import { Staff } from './Staff.js';
 /**
  * Represents a musical part (instrument/voice) which can have multiple staves.
  */
@@ -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/Pitch.d.ts

@@ -1,4 +1,4 @@
-import { Clef } from './types';
+import { Clef } from './types.js';
 /**
  * Pitch representation using MIDI numbers and explicit spelling (step, alter, octave).
  */

package/dist/models/Pitch.js

@@ -1,4 +1,4 @@
-import { Clef } from './types';
+import { Clef } from './types.js';
 /**
  * Pitch representation using MIDI numbers and explicit spelling (step, alter, octave).
  */

package/dist/models/PreMeasure.d.ts

@@ -1,4 +1,4 @@
-import { Clef, KeySignature, TimeSignature } from './types';
+import { Clef, KeySignature, TimeSignature } from './types.js';
 export interface PreMeasureJSON {
     clef?: string;
     keySignature?: KeySignature;