@tspro/web-music-score 3.2.0 → 4.0.1

package/dist/score/index.mjs

@@ -1,7 +1,7 @@
-/* WebMusicScore v3.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.0.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 import {
   __publicField
-} from "../chunk-LCTM7BID.mjs";
+} from "../chunk-YFPLOHP2.mjs";
 
 // src/score/pub/div-rect.ts
 import { Utils } from "@tspro/ts-utils-lib";
@@ -277,16 +277,16 @@ var DivRect = class _DivRect {
 };
 
 // src/score/pub/document-builder.ts
-import { Utils as Utils11 } from "@tspro/ts-utils-lib";
+import { Utils as Utils13 } from "@tspro/ts-utils-lib";
 
 // src/score/pub/types.ts
 var StaffPreset = /* @__PURE__ */ ((StaffPreset3) => {
-  StaffPreset3[StaffPreset3["Treble"] = 1] = "Treble";
-  StaffPreset3[StaffPreset3["Bass"] = 2] = "Bass";
-  StaffPreset3[StaffPreset3["Grand"] = 3] = "Grand";
-  StaffPreset3[StaffPreset3["GuitarTreble"] = 4] = "GuitarTreble";
-  StaffPreset3[StaffPreset3["GuitarTab"] = 8] = "GuitarTab";
-  StaffPreset3[StaffPreset3["GuitarCombined"] = 12] = "GuitarCombined";
+  StaffPreset3["Treble"] = "treble";
+  StaffPreset3["Bass"] = "bass";
+  StaffPreset3["Grand"] = "grand";
+  StaffPreset3["GuitarTreble"] = "guitarTreble";
+  StaffPreset3["GuitarTab"] = "guitarTab";
+  StaffPreset3["GuitarCombined"] = "guitarCombined";
   return StaffPreset3;
 })(StaffPreset || {});
 var Clef = /* @__PURE__ */ ((Clef2) => {
@@ -301,77 +301,98 @@ function getStringNumbers() {
   return [1, 2, 3, 4, 5, 6];
 }
 var Stem = /* @__PURE__ */ ((Stem2) => {
-  Stem2[Stem2["Auto"] = 0] = "Auto";
-  Stem2[Stem2["Up"] = 1] = "Up";
-  Stem2[Stem2["Down"] = 2] = "Down";
+  Stem2["Auto"] = "auto";
+  Stem2["Up"] = "up";
+  Stem2["Down"] = "down";
   return Stem2;
 })(Stem || {});
 var Arpeggio = /* @__PURE__ */ ((Arpeggio2) => {
-  Arpeggio2[Arpeggio2["Up"] = 0] = "Up";
-  Arpeggio2[Arpeggio2["Down"] = 1] = "Down";
+  Arpeggio2["Up"] = "up";
+  Arpeggio2["Down"] = "down";
   return Arpeggio2;
 })(Arpeggio || {});
 var TieType = /* @__PURE__ */ ((TieType2) => {
-  TieType2[TieType2["Stub"] = -1] = "Stub";
-  TieType2[TieType2["ToMeasureEnd"] = -2] = "ToMeasureEnd";
+  TieType2["Stub"] = "stub";
+  TieType2["ToMeasureEnd"] = "toMeasureEnd";
   return TieType2;
 })(TieType || {});
 var NoteAnchor = /* @__PURE__ */ ((NoteAnchor2) => {
-  NoteAnchor2[NoteAnchor2["Auto"] = 0] = "Auto";
-  NoteAnchor2[NoteAnchor2["Above"] = 1] = "Above";
-  NoteAnchor2[NoteAnchor2["Center"] = 2] = "Center";
-  NoteAnchor2[NoteAnchor2["Below"] = 3] = "Below";
-  NoteAnchor2[NoteAnchor2["StemTip"] = 4] = "StemTip";
+  NoteAnchor2["Auto"] = "auto";
+  NoteAnchor2["Above"] = "above";
+  NoteAnchor2["Center"] = "center";
+  NoteAnchor2["Below"] = "below";
+  NoteAnchor2["StemTip"] = "stemTip";
   return NoteAnchor2;
 })(NoteAnchor || {});
 var Connective = /* @__PURE__ */ ((Connective2) => {
-  Connective2[Connective2["Tie"] = 0] = "Tie";
-  Connective2[Connective2["Slur"] = 1] = "Slur";
-  Connective2[Connective2["Slide"] = 2] = "Slide";
+  Connective2["Tie"] = "tie";
+  Connective2["Slur"] = "slur";
+  Connective2["Slide"] = "slide";
   return Connective2;
 })(Connective || {});
 var VerticalPosition = /* @__PURE__ */ ((VerticalPosition4) => {
-  VerticalPosition4[VerticalPosition4["Above"] = 0] = "Above";
-  VerticalPosition4[VerticalPosition4["Below"] = 1] = "Below";
-  VerticalPosition4[VerticalPosition4["Both"] = 2] = "Both";
-  VerticalPosition4[VerticalPosition4["Auto"] = 3] = "Auto";
+  VerticalPosition4["Auto"] = "auto";
+  VerticalPosition4["Above"] = "above";
+  VerticalPosition4["Below"] = "below";
+  VerticalPosition4["Both"] = "both";
   return VerticalPosition4;
 })(VerticalPosition || {});
-var PlayState = /* @__PURE__ */ ((PlayState2) => {
-  PlayState2[PlayState2["Playing"] = 0] = "Playing";
-  PlayState2[PlayState2["Paused"] = 1] = "Paused";
-  PlayState2[PlayState2["Stopped"] = 2] = "Stopped";
-  return PlayState2;
-})(PlayState || {});
 var Fermata = /* @__PURE__ */ ((Fermata2) => {
-  Fermata2[Fermata2["AtNote"] = 0] = "AtNote";
-  Fermata2[Fermata2["AtMeasureEnd"] = 1] = "AtMeasureEnd";
+  Fermata2["AtNote"] = "atNote";
+  Fermata2["AtMeasureEnd"] = "atMeasureEnd";
   return Fermata2;
 })(Fermata || {});
 var Navigation = /* @__PURE__ */ ((Navigation2) => {
-  Navigation2[Navigation2["DC_al_Fine"] = 0] = "DC_al_Fine";
-  Navigation2[Navigation2["DC_al_Coda"] = 1] = "DC_al_Coda";
-  Navigation2[Navigation2["DS_al_Fine"] = 2] = "DS_al_Fine";
-  Navigation2[Navigation2["DS_al_Coda"] = 3] = "DS_al_Coda";
-  Navigation2[Navigation2["Coda"] = 4] = "Coda";
-  Navigation2[Navigation2["toCoda"] = 5] = "toCoda";
-  Navigation2[Navigation2["Segno"] = 6] = "Segno";
-  Navigation2[Navigation2["Fine"] = 7] = "Fine";
-  Navigation2[Navigation2["StartRepeat"] = 8] = "StartRepeat";
-  Navigation2[Navigation2["EndRepeat"] = 9] = "EndRepeat";
-  Navigation2[Navigation2["Ending"] = 10] = "Ending";
+  Navigation2["DC_al_Fine"] = "D.C. al Fine";
+  Navigation2["DC_al_Coda"] = "D.C. al Coda";
+  Navigation2["DS_al_Fine"] = "D.S. al Fine";
+  Navigation2["DS_al_Coda"] = "D.S. al Coda";
+  Navigation2["Coda"] = "Coda";
+  Navigation2["toCoda"] = "toCoda";
+  Navigation2["Segno"] = "Segno";
+  Navigation2["Fine"] = "Fine";
+  Navigation2["StartRepeat"] = "startRepeat";
+  Navigation2["EndRepeat"] = "endRepeat";
+  Navigation2["Ending"] = "ending";
   return Navigation2;
 })(Navigation || {});
 var Annotation = /* @__PURE__ */ ((Annotation2) => {
-  Annotation2[Annotation2["Dynamics"] = 0] = "Dynamics";
-  Annotation2[Annotation2["Tempo"] = 1] = "Tempo";
+  Annotation2["Dynamics"] = "dynamics";
+  Annotation2["Tempo"] = "tempo";
   return Annotation2;
 })(Annotation || {});
+var DynamicsAnnotation = /* @__PURE__ */ ((DynamicsAnnotation2) => {
+  DynamicsAnnotation2["cresc"] = "cresc.";
+  DynamicsAnnotation2["decresc"] = "decresc.";
+  DynamicsAnnotation2["dim"] = "dim.";
+  DynamicsAnnotation2["ppp"] = "ppp";
+  DynamicsAnnotation2["pp"] = "pp";
+  DynamicsAnnotation2["p"] = "p";
+  DynamicsAnnotation2["mp"] = "mp";
+  DynamicsAnnotation2["m"] = "m";
+  DynamicsAnnotation2["mf"] = "mf";
+  DynamicsAnnotation2["f"] = "f";
+  DynamicsAnnotation2["ff"] = "ff";
+  DynamicsAnnotation2["fff"] = "fff";
+  return DynamicsAnnotation2;
+})(DynamicsAnnotation || {});
+var TempoAnnotation = /* @__PURE__ */ ((TempoAnnotation2) => {
+  TempoAnnotation2["accel"] = "accel.";
+  TempoAnnotation2["rit"] = "rit.";
+  TempoAnnotation2["a_tempo"] = "a tempo";
+  return TempoAnnotation2;
+})(TempoAnnotation || {});
 var Label = /* @__PURE__ */ ((Label2) => {
-  Label2[Label2["Note"] = 0] = "Note";
-  Label2[Label2["Chord"] = 1] = "Chord";
+  Label2["Note"] = "note";
+  Label2["Chord"] = "chord";
   return Label2;
 })(Label || {});
+var PlayState = /* @__PURE__ */ ((PlayState2) => {
+  PlayState2[PlayState2["Playing"] = 0] = "Playing";
+  PlayState2[PlayState2["Paused"] = 1] = "Paused";
+  PlayState2[PlayState2["Stopped"] = 2] = "Stopped";
+  return PlayState2;
+})(PlayState || {});
 
 // src/score/engine/music-object.ts
 var MusicObjectLink = class {
@@ -870,11 +891,11 @@ var Renderer = class {
 
 // src/score/engine/obj-staff-and-tab.ts
 import { MusicError as MusicError15, MusicErrorType as MusicErrorType15 } from "@tspro/web-music-score/core";
-import { Utils as Utils9 } from "@tspro/ts-utils-lib";
+import { Utils as Utils11 } from "@tspro/ts-utils-lib";
 
 // src/score/engine/obj-measure.ts
-import { Utils as Utils8 } from "@tspro/ts-utils-lib";
-import { getScale, Scale, validateScaleType, Note as Note7, NoteLength as NoteLength6, RhythmProps as RhythmProps4, KeySignature as KeySignature2, getDefaultKeySignature, PitchNotation, SymbolSet } from "@tspro/web-music-score/theory";
+import { Utils as Utils10 } from "@tspro/ts-utils-lib";
+import { getScale, Scale, validateScaleType, Note as Note7, RhythmProps as RhythmProps4, KeySignature as KeySignature2, getDefaultKeySignature, PitchNotation, SymbolSet, validateNoteLength, NoteLengthProps as NoteLengthProps4 } from "@tspro/web-music-score/theory";
 import { getDefaultTempo, TimeSignature, getDefaultTimeSignature } from "@tspro/web-music-score/theory";
 
 // src/score/engine/acc-state.ts
@@ -1462,12 +1483,12 @@ var ObjSignature = class extends MusicObject {
 };
 
 // src/score/engine/player.ts
-import { Utils as Utils5 } from "@tspro/ts-utils-lib";
+import { Utils as Utils6 } from "@tspro/ts-utils-lib";
 import { NoteLength as NoteLength5, RhythmProps as RhythmProps3, alterTempoSpeed } from "@tspro/web-music-score/theory";
 import * as Audio from "@tspro/web-music-score/audio";
 
 // src/score/engine/obj-rhythm-column.ts
-import { Note as Note5, NoteLength as NoteLength4 } from "@tspro/web-music-score/theory";
+import { Note as Note5 } from "@tspro/web-music-score/theory";
 
 // src/score/engine/obj-arpeggio.ts
 var ObjArpeggio = class extends MusicObject {
@@ -1492,8 +1513,8 @@ var ObjArpeggio = class extends MusicObject {
   }
   layout(renderer) {
     let { unitSize } = renderer;
-    this.topArrowHeight = this.arpeggioDir === 0 /* Up */ ? unitSize : 0;
-    this.bottomArrowHeight = this.arpeggioDir === 1 /* Down */ ? unitSize : 0;
+    this.topArrowHeight = this.arpeggioDir === "up" /* Up */ ? unitSize : 0;
+    this.bottomArrowHeight = this.arpeggioDir === "down" /* Down */ ? unitSize : 0;
     let top = this.line.getTopLineY();
     let bottom = this.line.getBottomLineY();
     this.cycleHeight = unitSize * 2;
@@ -1540,7 +1561,7 @@ var ObjArpeggio = class extends MusicObject {
 };
 
 // src/score/engine/obj-rest.ts
-import { Note as Note3, NoteLength, RhythmProps } from "@tspro/web-music-score/theory";
+import { Note as Note3, NoteLength, NoteLengthProps, RhythmProps, Tuplet } from "@tspro/web-music-score/theory";
 import { MusicError as MusicError5, MusicErrorType as MusicErrorType5 } from "@tspro/web-music-score/core";
 function getDiatonicIdFromStaffPos(staffPos) {
   if (typeof staffPos === "number") {
@@ -1559,7 +1580,7 @@ var ObjStaffRest = class extends MusicObject {
     this.staff = staff;
     this.rest = rest;
     __publicField(this, "restRect", new DivRect());
-    __publicField(this, "dotRect");
+    __publicField(this, "dotRects", []);
     __publicField(this, "mi");
     staff.addObject(this);
     this.mi = new MStaffRest(this);
@@ -1571,21 +1592,18 @@ var ObjStaffRest = class extends MusicObject {
     return this.getRect().contains(x, y) ? [this] : [];
   }
   offset(dx, dy) {
-    var _a;
     this.restRect.offsetInPlace(dx, dy);
-    (_a = this.dotRect) == null ? void 0 : _a.offsetInPlace(dx, dy);
+    this.dotRects.forEach((r) => r.offsetInPlace(dx, dy));
     this.requestRectUpdate();
     this.rest.requestRectUpdate();
   }
   updateRect() {
     this.rect = this.restRect.copy();
-    if (this.dotRect) {
-      this.rect.expandInPlace(this.dotRect);
-    }
+    this.dotRects.forEach((r) => this.rect.expandInPlace(r));
   }
 };
 var ObjRest = class extends MusicObject {
-  constructor(col, voiceId, noteLength, options) {
+  constructor(col, voiceId, noteLength, options, tupletRatio) {
     var _a, _b;
     super(col);
     this.col = col;
@@ -1594,6 +1612,7 @@ var ObjRest = class extends MusicObject {
     __publicField(this, "ownDiatonicId");
     __publicField(this, "color");
     __publicField(this, "hide");
+    __publicField(this, "oldStyleTriplet");
     __publicField(this, "rhythmProps");
     __publicField(this, "beamGroup");
     __publicField(this, "staffObjects", []);
@@ -1617,7 +1636,9 @@ var ObjRest = class extends MusicObject {
     }
     this.color = (_a = options == null ? void 0 : options.color) != null ? _a : "black";
     this.hide = (_b = options == null ? void 0 : options.hide) != null ? _b : false;
-    this.rhythmProps = new RhythmProps(noteLength, options == null ? void 0 : options.dotted, options == null ? void 0 : options.triplet);
+    this.oldStyleTriplet = tupletRatio === void 0 && ((options == null ? void 0 : options.triplet) === true || NoteLengthProps.get(noteLength).isTriplet);
+    let dotCount = typeof (options == null ? void 0 : options.dotted) === "number" ? options.dotted > 0 ? options.dotted : void 0 : (options == null ? void 0 : options.dotted) === true ? 1 : void 0;
+    this.rhythmProps = RhythmProps.get(noteLength, dotCount, (tupletRatio != null ? tupletRatio : this.oldStyleTriplet) ? Tuplet.Triplet : void 0);
     this.mi = new MRest(this);
   }
   getMusicInterface() {
@@ -1635,15 +1656,9 @@ var ObjRest = class extends MusicObject {
   get noteLength() {
     return this.rhythmProps.noteLength;
   }
-  get dotted() {
-    return this.rhythmProps.dotted;
-  }
   get stemDir() {
     return this.beamGroup ? this.beamGroup.stemDir : this.ownStemDir;
   }
-  get triplet() {
-    return this.rhythmProps.triplet;
-  }
   getStaticObjects(line) {
     let staticObjects = [];
     this.staffObjects.forEach((obj) => {
@@ -1668,8 +1683,8 @@ var ObjRest = class extends MusicObject {
   getBeamGroup() {
     return this.beamGroup;
   }
-  setBeamGroup(beam) {
-    this.beamGroup = beam;
+  setBeamGroup(beamGroup) {
+    this.beamGroup = beamGroup;
   }
   resetBeamGroup() {
     this.beamGroup = void 0;
@@ -1678,7 +1693,7 @@ var ObjRest = class extends MusicObject {
     return this.staffObjects.map((obj) => {
       let staff = obj.staff;
       let x = obj.getRect().centerX;
-      let y = this.stemDir === 1 /* Up */ ? obj.getRect().top : obj.getRect().bottom;
+      let y = this.stemDir === "up" /* Up */ ? obj.getRect().top : obj.getRect().bottom;
       let stemHeight = Math.abs(obj.getRect().centerY - y);
       return { staff, x, y, stemHeight };
     });
@@ -1719,7 +1734,7 @@ var ObjRest = class extends MusicObject {
     }
     let { unitSize } = renderer;
     let { ownDiatonicId } = this;
-    let { noteLength, dotted, flagCount } = this.rhythmProps;
+    let { noteLength, dotCount, flagCount } = this.rhythmProps;
     let leftw = 0;
     let rightw = 0;
     let toph = 0;
@@ -1752,11 +1767,11 @@ var ObjRest = class extends MusicObject {
       }
       let obj = new ObjStaffRest(staff, this);
       obj.restRect = new DivRect(-leftw, 0, rightw, -toph, 0, bottomh);
-      if (dotted) {
+      for (let i = 0; i < dotCount; i++) {
         let dotWidth = DocumentSettings.DotSize * unitSize;
-        let dotX = rightw + (DocumentSettings.RestDotSpace + DocumentSettings.DotSize / 2) * unitSize;
+        let dotX = rightw + (DocumentSettings.RestDotSpace + DocumentSettings.DotSize * unitSize) + i * DocumentSettings.DotSize * unitSize * 1.5;
         let dotY = this.getRestDotVerticalDisplacement(noteLength) * unitSize;
-        obj.dotRect = DivRect.createCentered(dotX, dotY, dotWidth, dotWidth);
+        obj.dotRects.push(DivRect.createCentered(dotX, dotY, dotWidth, dotWidth));
       }
       obj.offset(0, staff.getDiatonicIdY(ownDiatonicId));
       this.staffObjects.push(obj);
@@ -1790,7 +1805,7 @@ var ObjRest = class extends MusicObject {
     ctx.strokeStyle = ctx.fillStyle = color;
     ctx.lineWidth = lineWidth;
     this.staffObjects.forEach((obj) => {
-      let { dotRect, restRect } = obj;
+      let { dotRects, restRect } = obj;
       let x = restRect.centerX;
       let y = restRect.centerY;
       if (noteLength === NoteLength.Whole) {
@@ -1855,20 +1870,20 @@ var ObjRest = class extends MusicObject {
           ctx.fill();
         }
       }
-      if (dotRect) {
-        renderer.fillCircle(dotRect.centerX, dotRect.centerY, dotRect.width / 2);
-      }
+      dotRects.forEach((r) => {
+        renderer.fillCircle(r.centerX, r.centerY, r.width / 2);
+      });
     });
   }
 };
 
 // src/score/engine/obj-note-group.ts
 import { Utils as Utils4 } from "@tspro/ts-utils-lib";
-import { Note as Note4, NoteLength as NoteLength3, RhythmProps as RhythmProps2 } from "@tspro/web-music-score/theory";
+import { Note as Note4, NoteLengthProps as NoteLengthProps3, RhythmProps as RhythmProps2, Tuplet as Tuplet3 } from "@tspro/web-music-score/theory";
 
 // src/score/engine/obj-beam-group.ts
 import { Utils as Utils3 } from "@tspro/ts-utils-lib";
-import { MinNoteLength, NoteLength as NoteLength2 } from "@tspro/web-music-score/theory";
+import { NoteLength as NoteLength2, Tuplet as Tuplet2, NoteLengthProps as NoteLengthProps2 } from "@tspro/web-music-score/theory";
 import { MusicError as MusicError6, MusicErrorType as MusicErrorType6 } from "@tspro/web-music-score/core";
 var adjustBeamAngle = (dx, dy) => {
   let T = DocumentSettings.BeamAngleFactor;
@@ -1905,8 +1920,8 @@ var ObjStaffBeamGroup = class extends MusicObject {
     super(staff);
     this.staff = staff;
     this.beamGroup = beamGroup;
-    __publicField(this, "tripletNumber");
-    __publicField(this, "tripletNumberOffsetY", 0);
+    __publicField(this, "tupletNumber");
+    __publicField(this, "tupletNumberOffsetY", 0);
     __publicField(this, "points", []);
     __publicField(this, "mi");
     staff.addObject(this);
@@ -1921,48 +1936,47 @@ var ObjStaffBeamGroup = class extends MusicObject {
   offset(dx, dy) {
     var _a;
     this.points.forEach((p) => p.offset(dx, 0));
-    (_a = this.tripletNumber) == null ? void 0 : _a.offset(dx, dy);
+    (_a = this.tupletNumber) == null ? void 0 : _a.offset(dx, dy);
     this.requestRectUpdate();
     this.beamGroup.requestRectUpdate();
   }
   updateRect() {
     if (this.points.length > 0) {
       this.rect = this.points[0].getRect().copy();
-    } else if (this.tripletNumber) {
-      this.rect = this.tripletNumber.getRect().copy();
+    } else if (this.tupletNumber) {
+      this.rect = this.tupletNumber.getRect().copy();
     }
     this.points.forEach((pt) => this.rect.expandInPlace(pt.getRect()));
-    if (this.tripletNumber) {
-      this.rect.expandInPlace(this.tripletNumber.getRect());
+    if (this.tupletNumber) {
+      this.rect.expandInPlace(this.tupletNumber.getRect());
     }
   }
 };
 var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
-  constructor(symbols, triplet) {
+  constructor(symbols, tupletRatio) {
     super(symbols[0].measure);
     this.symbols = symbols;
+    this.tupletRatio = tupletRatio;
     __publicField(this, "mi");
     __publicField(this, "type");
     __publicField(this, "staffObjects", []);
     this.mi = new MBeamGroup(this);
+    let beamGroupName = tupletRatio ? "Tuplet" : "BeamGroup";
     if (!symbols.every((s) => s.measure === symbols[0].measure)) {
-      throw new MusicError6(MusicErrorType6.Score, "All beam group symbols are not in same measure.");
+      throw new MusicError6(MusicErrorType6.Score, `All ${beamGroupName} symbols are not in same measure.`);
     } else if (symbols.length < 2) {
-      throw new MusicError6(MusicErrorType6.Score, "Beam group need minimum 2 symbols, but " + symbols.length + " given.");
+      throw new MusicError6(MusicErrorType6.Score, `${beamGroupName} needs minimum 2 symbols, but ${symbols.length} given.`);
     }
-    if (triplet) {
-      if (!symbols.every((s) => s.triplet)) {
-        throw new MusicError6(MusicErrorType6.Score, "Not every symbol's triplet property is true.");
-      }
+    if (tupletRatio !== void 0) {
       let isGroup = symbols.length < 3 || symbols.some((s) => !(s instanceof ObjNoteGroup)) || symbols.some((s) => s.rhythmProps.flagCount !== symbols[0].rhythmProps.flagCount);
-      if (symbols.length === 3 && symbols[0] instanceof ObjNoteGroup && symbols[symbols.length - 1] instanceof ObjNoteGroup && symbols[0].rhythmProps.flagCount === symbols[symbols.length - 1].rhythmProps.flagCount) {
+      if (symbols.length >= 3 && symbols[0] instanceof ObjNoteGroup && symbols[symbols.length - 1] instanceof ObjNoteGroup && symbols[0].rhythmProps.flagCount === symbols[symbols.length - 1].rhythmProps.flagCount) {
         isGroup = false;
       }
-      if (symbols.some((s) => s.rhythmProps.noteLength >= NoteLength2.Quarter)) {
+      if (symbols.some((s) => NoteLengthProps2.cmp(s.rhythmProps.noteLength, NoteLength2.Quarter) >= 0)) {
         isGroup = true;
       }
-      this.type = isGroup ? 2 /* TripletGroup */ : 1 /* TripletBeam */;
-      ObjNoteGroup.setTripletBeamCounts(this);
+      this.type = isGroup ? 2 /* TupletGroup */ : 1 /* TupletBeam */;
+      ObjNoteGroup.setTupletBeamCounts(this);
     } else {
       this.type = 0 /* RegularBeam */;
     }
@@ -1970,29 +1984,35 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
       symbols.forEach((s) => s.setBeamGroup(this));
       symbols[0].measure.addBeamGroup(this);
     } else {
-      throw new MusicError6(MusicErrorType6.Score, "Cannot add beam group because some symbol already has one.");
+      throw new MusicError6(MusicErrorType6.Score, `Cannot add ${beamGroupName} because some symbol already has one.`);
     }
   }
+  get showTupletRatio() {
+    var _a;
+    return ((_a = this.tupletRatio) == null ? void 0 : _a.showRatio) === true;
+  }
   static createBeam(noteGroups) {
     if (noteGroups.length > 1) {
-      new _ObjBeamGroup(noteGroups, false);
+      new _ObjBeamGroup(noteGroups, void 0);
     }
   }
-  static createTriplet(symbols) {
-    let MaxTripletNoteLenght = NoteLength2.Half;
-    let len = symbols.map((s) => s.rhythmProps.noteLength);
-    if (symbols.length == 2) {
-      if (len[0] <= MaxTripletNoteLenght && len[1] === len[0] / 2 && len[0] / 2 >= MinNoteLength || len[1] <= MaxTripletNoteLenght && len[0] === len[1] / 2 && len[1] / 2 >= MinNoteLength) {
-        new _ObjBeamGroup(symbols, true);
-        return true;
-      }
-    } else if (symbols.length === 3) {
-      if (len[0] <= MaxTripletNoteLenght && len.every((l) => l === len[0])) {
-        new _ObjBeamGroup(symbols, true);
-        return true;
-      }
+  static createOldStyleTriplet(symbols) {
+    let s2 = symbols.slice(0, 2);
+    let n2 = s2.map((s) => s.rhythmProps.noteSize);
+    if (s2.length === 2 && s2.every((s) => s.oldStyleTriplet && s.getBeamGroup() === void 0) && (n2[0] * 2 === n2[1] || n2[1] * 2 === n2[0])) {
+      new _ObjBeamGroup(s2, Tuplet2.Triplet);
+      return 2;
     }
-    return false;
+    let s3 = symbols.slice(0, 3);
+    let n3 = s3.map((s) => s.rhythmProps.noteSize);
+    if (s3.length === 3 && s3.every((s) => s.oldStyleTriplet && s.getBeamGroup() === void 0) && n3.every((n) => n === n3[0])) {
+      new _ObjBeamGroup(s3, Tuplet2.Triplet);
+      return 3;
+    }
+    return 0;
+  }
+  static createTuplet(symbols, tupletRatio) {
+    new _ObjBeamGroup(symbols, tupletRatio);
   }
   getMusicInterface() {
     return this.mi;
@@ -2018,8 +2038,8 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
   getType() {
     return this.type;
   }
-  isTriplet() {
-    return this.type === 1 /* TripletBeam */ || this.type === 2 /* TripletGroup */;
+  isTuplet() {
+    return this.type === 1 /* TupletBeam */ || this.type === 2 /* TupletGroup */;
   }
   getSymbols() {
     return this.symbols;
@@ -2081,10 +2101,10 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
       }
       let leftStemHeight = (_a = symbolStemHeight[0]) != null ? _a : 0;
       let rightStemHeight = (_b = symbolStemHeight[symbolStemHeight.length - 1]) != null ? _b : 0;
-      if (this.type !== 2 /* TripletGroup */) {
+      if (this.type !== 2 /* TupletGroup */) {
         let leftDy = leftStemHeight < rightStemHeight ? Math.sqrt(rightStemHeight - leftStemHeight) : 0;
         let rightDy = rightStemHeight < leftStemHeight ? Math.sqrt(leftStemHeight - rightStemHeight) : 0;
-        if (stemDir === 1 /* Up */) {
+        if (stemDir === "up" /* Up */) {
           leftDy *= -1;
           rightDy *= -1;
         }
@@ -2097,7 +2117,7 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
           symbolY[symbolY.length - 1] += rightDy;
         }
       }
-      let groupLineDy = unitSize * 2 * (stemDir === 1 /* Up */ ? -1 : 1);
+      let groupLineDy = unitSize * 2 * (stemDir === "up" /* Up */ ? -1 : 1);
       let centerY = (rightY + leftY) / 2;
       let halfDy = adjustBeamAngle(rightX - leftX, rightY - leftY) / 2;
       leftY = centerY - halfDy;
@@ -2108,9 +2128,9 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
         if (symX !== void 0 && symY !== void 0) {
           let beamY = Utils3.Math.interpolateY(leftX, leftY, rightX, rightY, symX);
           let raiseY = symY - beamY;
-          if (stemDir === 1 /* Up */ && raiseY < 0) {
+          if (stemDir === "up" /* Up */ && raiseY < 0) {
             raiseBeamY = Math.min(raiseBeamY, raiseY);
-          } else if (stemDir === 2 /* Down */ && raiseY > 0) {
+          } else if (stemDir === "down" /* Down */ && raiseY > 0) {
             raiseBeamY = Math.max(raiseBeamY, raiseY);
           }
         }
@@ -2119,21 +2139,21 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
       rightY += raiseBeamY;
       symbolY = symbolY.map((y) => y === void 0 ? void 0 : y + raiseBeamY);
       let obj = new ObjStaffBeamGroup(mainStaff, this);
-      if (this.type === 2 /* TripletGroup */) {
+      if (this.type === 2 /* TupletGroup */) {
         let ef = unitSize / (rightX - leftX);
         let l = Utils3.Math.interpolateCoord(leftX, leftY + groupLineDy, rightX, rightY + groupLineDy, -ef);
         let r = Utils3.Math.interpolateCoord(leftX, leftY + groupLineDy, rightX, rightY + groupLineDy, 1 + ef);
         obj.points.push(new BeamPoint(leftStaff, this, leftSymbol, l.x, l.y));
         obj.points.push(new BeamPoint(rightStaff, this, rightSymbol, r.x, r.y));
-        obj.tripletNumberOffsetY = 0;
-      } else if (this.type === 0 /* RegularBeam */ || this.type === 1 /* TripletBeam */) {
+        obj.tupletNumberOffsetY = 0;
+      } else if (this.type === 0 /* RegularBeam */ || this.type === 1 /* TupletBeam */) {
         raiseBeamY *= 0.5;
         let { beamThickness } = renderer;
         const beamHeight = (i) => {
           let sym = symbols[i];
           if (sym instanceof ObjNoteGroup) {
             let beamCount = sym instanceof ObjNoteGroup ? Math.max(sym.getLeftBeamCount(), sym.getRightBeamCount()) : 0;
-            return DocumentSettings.BeamSeparation * unitSize * (this.stemDir === 1 /* Up */ ? beamCount - 1 : 0);
+            return DocumentSettings.BeamSeparation * unitSize * (this.stemDir === "up" /* Up */ ? beamCount - 1 : 0);
           } else {
             return 0;
           }
@@ -2144,17 +2164,18 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
           let symY = symbolY[i];
           if (symStaff && symX !== void 0 && symY !== void 0) {
             let pt = new BeamPoint(symStaff, this, sym, symX, symY);
-            pt.topBeamsHeight = beamThickness / 2 + (stemDir === 2 /* Down */ ? beamHeight(i) : 0);
-            pt.bottomBeamsHeight = beamThickness / 2 + (stemDir === 1 /* Up */ ? beamHeight(i) : 0);
+            pt.topBeamsHeight = beamThickness / 2 + (stemDir === "down" /* Down */ ? beamHeight(i) : 0);
+            pt.bottomBeamsHeight = beamThickness / 2 + (stemDir === "up" /* Up */ ? beamHeight(i) : 0);
             obj.points.push(pt);
           }
         });
-        obj.tripletNumberOffsetY = groupLineDy;
+        obj.tupletNumberOffsetY = groupLineDy;
       }
-      if (this.isTriplet()) {
-        obj.tripletNumber = new ObjText(this, "3", 0.5, 0.5);
-        obj.tripletNumber.layout(renderer);
-        obj.tripletNumber.offset((leftX + rightX) / 2, (leftY + rightY) / 2 + obj.tripletNumberOffsetY);
+      if (this.isTuplet() && this.tupletRatio) {
+        let txt = this.showTupletRatio ? String(this.tupletRatio.parts) + ":" + String(this.tupletRatio.inTimeOf) : String(this.tupletRatio.parts);
+        obj.tupletNumber = new ObjText(this, txt, 0.5, 0.5);
+        obj.tupletNumber.layout(renderer);
+        obj.tupletNumber.offset((leftX + rightX) / 2, (leftY + rightY) / 2 + obj.tupletNumberOffsetY);
       }
       if (obj.points.length >= 2) {
         this.staffObjects.push(obj);
@@ -2176,7 +2197,7 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
     this.staffObjects.forEach((obj) => {
       let left = obj.points[0];
       let right = obj.points[obj.points.length - 1];
-      if (this.type !== 2 /* TripletGroup */) {
+      if (this.type !== 2 /* TupletGroup */) {
         obj.points.forEach((pt) => {
           if (pt.symbol instanceof ObjNoteGroup) {
             if (pt !== left && pt !== right) {
@@ -2186,9 +2207,9 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
           }
         });
       }
-      if (obj.tripletNumber) {
-        let y = (left.y + right.y) / 2 + obj.tripletNumberOffsetY;
-        obj.tripletNumber.offset(0, -obj.tripletNumber.getRect().centerY + y);
+      if (obj.tupletNumber) {
+        let y = (left.y + right.y) / 2 + obj.tupletNumberOffsetY;
+        obj.tupletNumber.offset(0, -obj.tupletNumber.getRect().centerY + y);
       }
     });
   }
@@ -2200,21 +2221,21 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
     let { unitSize, beamThickness, lineWidth } = renderer;
     let color = "black";
     this.staffObjects.forEach((obj) => {
-      if (this.type === 2 /* TripletGroup */) {
+      if (this.type === 2 /* TupletGroup */) {
         let l = obj.points[0];
         let r = obj.points[obj.points.length - 1];
         if (l && r) {
-          let tf = obj.tripletNumber ? obj.tripletNumber.getRect().width / (r.x - l.x) * 1.2 : 0;
+          let tf = obj.tupletNumber ? obj.tupletNumber.getRect().width / (r.x - l.x) * 1.2 : 0;
           let lc = Utils3.Math.interpolateCoord(l.x, l.y, r.x, r.y, 0.5 - tf / 2);
           let rc = Utils3.Math.interpolateCoord(l.x, l.y, r.x, r.y, 0.5 + tf / 2);
-          let tipH = this.stemDir === 1 /* Up */ ? unitSize : -unitSize;
+          let tipH = this.stemDir === "up" /* Up */ ? unitSize : -unitSize;
           renderer.drawLine(l.x, l.y, lc.x, lc.y, color, lineWidth);
           renderer.drawLine(rc.x, rc.y, r.x, r.y, color, lineWidth);
           renderer.drawLine(l.x, l.y, l.x, l.y + tipH, color, lineWidth);
           renderer.drawLine(r.x, r.y, r.x, r.y + tipH, color, lineWidth);
         }
-      } else if (this.type === 0 /* RegularBeam */ || this.type === 1 /* TripletBeam */) {
-        let beamSeparation = DocumentSettings.BeamSeparation * unitSize * (this.stemDir === 1 /* Up */ ? 1 : -1);
+      } else if (this.type === 0 /* RegularBeam */ || this.type === 1 /* TupletBeam */) {
+        let beamSeparation = DocumentSettings.BeamSeparation * unitSize * (this.stemDir === "up" /* Up */ ? 1 : -1);
         let noteGroupPoints = obj.points.filter((p) => p.symbol instanceof ObjNoteGroup);
         for (let i = 0; i < noteGroupPoints.length - 1; i++) {
           let left = noteGroupPoints[i];
@@ -2241,8 +2262,8 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
           }
         }
       }
-      if (obj.tripletNumber) {
-        obj.tripletNumber.draw(renderer);
+      if (obj.tupletNumber) {
+        obj.tupletNumber.draw(renderer);
       }
     });
   }
@@ -2250,6 +2271,12 @@ var ObjBeamGroup = class _ObjBeamGroup extends MusicObject {
 
 // src/score/engine/obj-note-group.ts
 import { MusicError as MusicError7, MusicErrorType as MusicErrorType7 } from "@tspro/web-music-score/core";
+function getStem(stem) {
+  return Utils4.Is.isEnumValue(stem, Stem) ? stem : void 0;
+}
+function getArpeggio(a) {
+  return Utils4.Is.isEnumValue(a, Arpeggio) ? a : a === true ? "up" /* Up */ : void 0;
+}
 function sortNoteStringData(notes, strings) {
   let stringArr = Utils4.Arr.isArray(strings) ? strings : strings !== void 0 ? [strings] : [];
   let noteStringData = notes.map((note, i) => {
@@ -2261,9 +2288,6 @@ function sortNoteStringData(notes, strings) {
     strings: noteStringData.every((e) => e.string === void 0) ? void 0 : noteStringData.map((e) => e.string)
   };
 }
-function solveArpeggio(a) {
-  return a === true || a === 0 /* Up */ ? 0 /* Up */ : a === 1 /* Down */ ? 1 /* Down */ : void 0;
-}
 var ObjStaffNoteGroup = class extends MusicObject {
   constructor(staff, noteGroup) {
     super(staff);
@@ -2353,7 +2377,7 @@ var ObjTabNoteGroup = class extends MusicObject {
   }
 };
 var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
-  constructor(col, voiceId, notes, noteLength, options) {
+  constructor(col, voiceId, notes, noteLength, options, tupletRatio) {
     var _a, _b, _c;
     super(col);
     this.col = col;
@@ -2369,6 +2393,7 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
     __publicField(this, "staccato");
     __publicField(this, "diamond");
     __publicField(this, "arpeggio");
+    __publicField(this, "oldStyleTriplet");
     __publicField(this, "rhythmProps");
     __publicField(this, "startConnnectives", []);
     __publicField(this, "runningConnectives", []);
@@ -2386,13 +2411,15 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
     this.minDiatonicId = this.notes[0].diatonicId;
     this.maxDiatonicId = this.notes[this.notes.length - 1].diatonicId;
     this.ownDiatonicId = this.measure.updateOwnDiatonicId(voiceId, Math.round((this.minDiatonicId + this.maxDiatonicId) / 2));
-    this.ownStemDir = this.measure.updateOwnStemDir(this, options == null ? void 0 : options.stem);
+    this.ownStemDir = this.measure.updateOwnStemDir(this, getStem(options == null ? void 0 : options.stem));
     this.ownString = this.measure.updateOwnString(this, noteStringData.strings);
     this.color = (_a = options == null ? void 0 : options.color) != null ? _a : "black";
     this.staccato = (_b = options == null ? void 0 : options.staccato) != null ? _b : false;
     this.diamond = (_c = options == null ? void 0 : options.diamond) != null ? _c : false;
-    this.arpeggio = solveArpeggio(options == null ? void 0 : options.arpeggio);
-    this.rhythmProps = new RhythmProps2(noteLength, options == null ? void 0 : options.dotted, options == null ? void 0 : options.triplet);
+    this.arpeggio = getArpeggio(options == null ? void 0 : options.arpeggio);
+    this.oldStyleTriplet = tupletRatio === void 0 && ((options == null ? void 0 : options.triplet) === true || NoteLengthProps3.get(noteLength).isTriplet);
+    let dotCount = typeof (options == null ? void 0 : options.dotted) === "number" ? options.dotted > 0 ? options.dotted : void 0 : (options == null ? void 0 : options.dotted) === true ? 1 : void 0;
+    this.rhythmProps = RhythmProps2.get(noteLength, dotCount, (tupletRatio != null ? tupletRatio : this.oldStyleTriplet) ? Tuplet3.Triplet : void 0);
     this.mi = new MNoteGroup(this);
   }
   getMusicInterface() {
@@ -2410,16 +2437,13 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
   get stemDir() {
     return this.beamGroup ? this.beamGroup.stemDir : this.ownStemDir;
   }
-  get triplet() {
-    return this.rhythmProps.triplet;
-  }
   enableConnective(line) {
     return line.containsVoiceId(this.voiceId) && (line instanceof ObjTab || line.containsDiatonicId(this.ownDiatonicId));
   }
   startConnective(connectiveProps) {
-    if (!this.row.hasStaff && connectiveProps.connective === 0 /* Tie */) {
+    if (!this.row.hasStaff && connectiveProps.connective === "tie" /* Tie */) {
       throw new MusicError7(MusicErrorType7.Score, "Ties not implemented for guitar tabs alone, staff is required!");
-    } else if (!this.row.hasStaff && connectiveProps.connective === 1 /* Slur */) {
+    } else if (!this.row.hasStaff && connectiveProps.connective === "slur" /* Slur */) {
       throw new MusicError7(MusicErrorType7.Score, "Slurs not implemented for guitar tabs alone, staff is required!");
     }
     this.startConnnectives.push(connectiveProps);
@@ -2478,7 +2502,7 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
       let stemTip = obj.stemTip;
       let stemDir = this.stemDir;
       let hasStem = stemTip !== void 0;
-      let stemSide = !hasStem ? void 0 : stemDir === 1 /* Up */ ? "right" : "left";
+      let stemSide = !hasStem ? void 0 : stemDir === "up" /* Up */ ? "right" : "left";
       let padding = noteHeadRect.height / 2;
       let centerX = noteHeadRect.centerX;
       let centerY = noteHeadRect.centerY;
@@ -2486,16 +2510,16 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
       let rightX = noteHeadRect.right + padding;
       let aboveY = noteHeadRect.top - padding;
       let belowY = noteHeadRect.bottom + padding;
-      if (noteAnchor === 0 /* Auto */) {
-        noteAnchor = 3 /* Below */;
-      } else if (noteAnchor === 4 /* StemTip */ && !hasStem) {
-        noteAnchor = stemDir === 1 /* Up */ ? 1 /* Above */ : 3 /* Below */;
+      if (noteAnchor === "auto" /* Auto */) {
+        noteAnchor = "below" /* Below */;
+      } else if (noteAnchor === "stemTip" /* StemTip */ && !hasStem) {
+        noteAnchor = stemDir === "up" /* Up */ ? "above" /* Above */ : "below" /* Below */;
       }
       switch (noteAnchor) {
-        case 2 /* Center */:
+        case "center" /* Center */:
           return side === "left" ? { x: rightX, y: centerY } : { x: leftX, y: centerY };
-        case 1 /* Above */:
-          if (!hasStem || stemDir === 2 /* Down */) {
+        case "above" /* Above */:
+          if (!hasStem || stemDir === "down" /* Down */) {
             return { x: centerX, y: aboveY };
           } else {
             return {
@@ -2503,8 +2527,8 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
               y: aboveY
             };
           }
-        case 3 /* Below */:
-          if (!hasStem || stemDir === 1 /* Up */) {
+        case "below" /* Below */:
+          if (!hasStem || stemDir === "up" /* Up */) {
             return { x: centerX, y: belowY };
           } else {
             return {
@@ -2512,8 +2536,8 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
               y: belowY
             };
           }
-        case 4 /* StemTip */:
-          return { x: centerX, y: stemTip.centerY + (stemDir === 1 /* Up */ ? -padding : padding) };
+        case "stemTip" /* StemTip */:
+          return { x: centerX, y: stemTip.centerY + (stemDir === "up" /* Up */ ? -padding : padding) };
         default:
           throw new MusicError7(MusicErrorType7.Score, "Invalid noteAnchor: " + noteAnchor);
       }
@@ -2528,7 +2552,7 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
       let x = side === "right" ? r.left : r.right;
       let y;
       let s = 0.9;
-      if (connectiveProps.connective === 2 /* Slide */) {
+      if (connectiveProps.connective === "slide" /* Slide */) {
         let leftFretNumber = connectiveProps.noteGroups[0].getFretNumber(obj, 0);
         let rightFretNumber = connectiveProps.noteGroups[1].getFretNumber(obj, 0);
         let slideUp = leftFretNumber === void 0 || rightFretNumber === void 0 || leftFretNumber <= rightFretNumber;
@@ -2582,7 +2606,7 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
     this.runningConnectives = [];
   }
   getPlaySlur() {
-    let slurs = this.runningConnectives.filter((c) => c.connective === 1 /* Slur */).map((c) => c.startsWith(this) ? "first" : "slurred");
+    let slurs = this.runningConnectives.filter((c) => c.connective === "slur" /* Slur */).map((c) => c.startsWith(this) ? "first" : "slurred");
     if (slurs.indexOf("first") >= 0) {
       return "first";
     } else if (slurs.indexOf("slurred") >= 0) {
@@ -2594,8 +2618,8 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
   getBeamGroup() {
     return this.beamGroup;
   }
-  setBeamGroup(beam) {
-    this.beamGroup = beam;
+  setBeamGroup(beamGroup) {
+    this.beamGroup = beamGroup;
   }
   resetBeamGroup() {
     this.leftBeamCount = this.rightBeamCount = 0;
@@ -2606,19 +2630,19 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
       var _a, _b, _c, _d;
       let staff = obj.staff;
       let x = (_b = (_a = obj.stemTip) == null ? void 0 : _a.centerX) != null ? _b : obj.noteHeadRects[0].centerX;
-      let y = (_d = (_c = obj.stemTip) == null ? void 0 : _c.centerY) != null ? _d : this.stemDir === 1 /* Up */ ? obj.getRect().top : obj.getRect().bottom;
-      let stemHeight = this.stemDir === 1 /* Up */ ? Math.abs(obj.noteHeadRects[0].centerY - y) : Math.abs(obj.noteHeadRects[obj.noteHeadRects.length - 1].centerY - y);
+      let y = (_d = (_c = obj.stemTip) == null ? void 0 : _c.centerY) != null ? _d : this.stemDir === "up" /* Up */ ? obj.getRect().top : obj.getRect().bottom;
+      let stemHeight = this.stemDir === "up" /* Up */ ? Math.abs(obj.noteHeadRects[0].centerY - y) : Math.abs(obj.noteHeadRects[obj.noteHeadRects.length - 1].centerY - y);
       return { staff, x, y, stemHeight };
     });
   }
   getStemHeight(renderer) {
     let { unitSize } = renderer;
-    let { noteLength, flagCount } = this.rhythmProps;
-    if (noteLength >= NoteLength3.Whole) {
-      return 0;
-    } else {
+    let { flagCount, hasStem } = this.rhythmProps;
+    if (hasStem) {
       let addY = this.hasBeamCount() ? DocumentSettings.BeamSeparation : DocumentSettings.FlagSeparation;
       return (DocumentSettings.StemHeight + Math.max(0, flagCount - 1) * addY) * unitSize;
+    } else {
+      return 0;
     }
   }
   hasBeamCount() {
@@ -2637,13 +2661,13 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
     return staff.containsVoiceId(this.voiceId) && this.staffObjects.some((obj) => obj instanceof ObjStaffNoteGroup && obj.staff === staff);
   }
   getPlayTicks(note) {
-    let tiedTicks = this.runningConnectives.filter((c) => c.connective === 0 /* Tie */).map((tie) => {
+    let tiedTicks = this.runningConnectives.filter((c) => c.connective === "tie" /* Tie */).map((tie) => {
       let tieNoteGroups = tie.noteGroups;
       let j = tieNoteGroups.indexOf(this);
       if (j < 0) {
         return 0;
       }
-      if (tie.span === -1 /* Stub */ || tie.span === -2 /* ToMeasureEnd */) {
+      if (tie.span === "stub" /* Stub */ || tie.span === "toMeasureEnd" /* ToMeasureEnd */) {
         return Math.max(this.rhythmProps.ticks, this.measure.getMeasureTicks() - this.col.positionTicks);
       }
       let prev = tieNoteGroups[j - 1];
@@ -2670,7 +2694,7 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
     this.requestRectUpdate();
     let { unitSize } = renderer;
     let { row, stemDir } = this;
-    let { dotted, flagCount } = this.rhythmProps;
+    let { dotCount, flagCount, hasStem } = this.rhythmProps;
     let dotWidth = DocumentSettings.DotSize * unitSize;
     let noteHeadWidth = (this.diamond ? DocumentSettings.DiamondNoteHeadSize : DocumentSettings.NoteHeadWidth) * unitSize;
     let noteHeadHeight = (this.diamond ? DocumentSettings.DiamondNoteHeadSize : DocumentSettings.NoteHeadHeight) * unitSize;
@@ -2690,10 +2714,10 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
         let noteX = this.col.getNoteHeadDisplacement(this, note) * noteHeadWidth;
         let noteY = noteStaff.getDiatonicIdY(note.diatonicId);
         let isNoteOnLine = noteStaff.isLine(note.diatonicId);
-        if (isBottomNote && stemDir === 1 /* Up */) stemBaseStaff = noteStaff;
-        if (isTopNote && stemDir === 1 /* Up */) stemTipStaff = noteStaff;
-        if (isBottomNote && stemDir === 2 /* Down */) stemTipStaff = noteStaff;
-        if (isTopNote && stemDir === 2 /* Down */) stemBaseStaff = noteStaff;
+        if (isBottomNote && stemDir === "up" /* Up */) stemBaseStaff = noteStaff;
+        if (isTopNote && stemDir === "up" /* Up */) stemTipStaff = noteStaff;
+        if (isBottomNote && stemDir === "down" /* Down */) stemTipStaff = noteStaff;
+        if (isTopNote && stemDir === "down" /* Down */) stemBaseStaff = noteStaff;
         let noteHeadRect = obj.noteHeadRects[noteIndex] = DivRect.createCentered(noteX, noteY, noteHeadWidth, noteHeadHeight);
         noteStaff.addObject(noteHeadRect);
         if (accState.needAccidental(note)) {
@@ -2704,21 +2728,21 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
           }
           noteStaff.addObject(acc);
         }
-        if (dotted) {
-          let dotX = noteHeadRect.right + DocumentSettings.NoteDotSpace * unitSize + dotWidth / 2;
+        for (let i = 0; i < dotCount; i++) {
+          let dotX = noteHeadRect.right + DocumentSettings.NoteDotSpace * unitSize + dotWidth / 2 + i * dotWidth * 1.5;
           let dotY = noteY + this.getDotVerticalDisplacement(staff, note.diatonicId, stemDir) * unitSize;
           let r = DivRect.createCentered(dotX, dotY, dotWidth, dotWidth);
           obj.dotRects.push(r);
           noteStaff.addObject(r);
         }
         if (this.staccato) {
-          if (stemDir === 1 /* Up */ && isBottomNote) {
+          if (stemDir === "up" /* Up */ && isBottomNote) {
             let dotX = noteX;
             let dotY = noteY + unitSize * (isNoteOnLine ? 3 : 2);
             let r = DivRect.createCentered(dotX, dotY, dotWidth, dotWidth);
             obj.dotRects.push(r);
             stemBaseStaff.addObject(r);
-          } else if (stemDir === 2 /* Down */ && isTopNote) {
+          } else if (stemDir === "down" /* Down */ && isTopNote) {
             let dotX = noteX;
             let dotY = noteY - unitSize * (isNoteOnLine ? 3 : 2);
             let r = DivRect.createCentered(dotX, dotY, dotWidth, dotWidth);
@@ -2729,11 +2753,11 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
       });
       let bottomNoteY = obj.noteHeadRects[0].centerY;
       let topNoteY = obj.noteHeadRects[obj.noteHeadRects.length - 1].centerY;
-      let stemX = stemDir === 1 /* Up */ ? noteHeadWidth / 2 : -noteHeadWidth / 2;
+      let stemX = stemDir === "up" /* Up */ ? noteHeadWidth / 2 : -noteHeadWidth / 2;
       let stemHeight = this.getStemHeight(renderer);
-      let stemTipY = stemDir === 1 /* Up */ ? topNoteY - stemHeight : bottomNoteY + stemHeight;
-      let stemBaseY = stemDir === 1 /* Up */ ? bottomNoteY : topNoteY;
-      if (this.rhythmProps.hasStem()) {
+      let stemTipY = stemDir === "up" /* Up */ ? topNoteY - stemHeight : bottomNoteY + stemHeight;
+      let stemBaseY = stemDir === "up" /* Up */ ? bottomNoteY : topNoteY;
+      if (hasStem) {
         obj.stemTip = new DivRect(stemX, stemX, stemTipY, stemTipY);
         obj.stemBase = new DivRect(stemX, stemX, stemBaseY, stemBaseY);
         stemTipStaff.addObject(obj.stemTip);
@@ -2744,7 +2768,7 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
         let flagHeight = flagCount === 0 ? 0 : DocumentSettings.FlagHeight * unitSize;
         for (let i = 0; i < flagCount; i++) {
           let flagAddY = i * unitSize * DocumentSettings.FlagSeparation;
-          let r = obj.flagRects[i] = stemDir === 1 /* Up */ ? new DivRect(stemX, stemX + flagWidth, stemTipY + flagAddY, stemTipY + flagHeight + flagAddY) : new DivRect(stemX, stemX + flagWidth, stemTipY - flagHeight - flagAddY, stemTipY - flagAddY);
+          let r = obj.flagRects[i] = stemDir === "up" /* Up */ ? new DivRect(stemX, stemX + flagWidth, stemTipY + flagAddY, stemTipY + flagHeight + flagAddY) : new DivRect(stemX, stemX + flagWidth, stemTipY - flagHeight - flagAddY, stemTipY - flagAddY);
           stemTipStaff.addObject(r);
         }
       }
@@ -2757,7 +2781,6 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
       }
       let obj = new ObjTabNoteGroup(tab, this);
       this.notes.forEach((note, noteIndex) => {
-        var _a, _b;
         if (this.ownString[noteIndex] !== void 0) {
           let stringId = this.ownString[noteIndex] - 1;
           let fretId = note.chromaticId - tab.getTuningStrings()[stringId].chromaticId;
@@ -2765,9 +2788,7 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
           let fretNumber = new ObjText(this, { text: String(fretId), color, bgcolor: "white" }, 0.5, 0.5);
           obj.fretNumbers.push(fretNumber);
           fretNumber.layout(renderer);
-          let noteX = this.col.getNoteHeadDisplacement(this, note) * noteHeadWidth;
-          let stemX = (_b = (_a = this.staffObjects[0]) == null ? void 0 : _a.stemBase) == null ? void 0 : _b.centerX;
-          let x = stemX != null ? stemX : noteX;
+          let x = this.col.getRect().centerX;
           let y = tab.getStringY(stringId);
           fretNumber.offset(x, y);
         }
@@ -2810,15 +2831,22 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
     renderer.drawDebugRect(this.getRect());
     let { lineWidth } = renderer;
     let { color, stemDir } = this;
-    let { noteLength } = this.rhythmProps;
+    let { isSolidNoteHead } = this.rhythmProps;
     this.staffObjects.forEach((obj) => {
       obj.accidentals.forEach((d) => d.draw(renderer));
       ctx.strokeStyle = ctx.fillStyle = color;
       ctx.lineWidth = lineWidth;
       obj.noteHeadRects.forEach((r) => {
-        let outlinedNoteHead = noteLength >= NoteLength3.Half;
         if (this.diamond) {
-          if (outlinedNoteHead) {
+          if (isSolidNoteHead) {
+            ctx.beginPath();
+            ctx.moveTo(r.centerX, r.top);
+            ctx.lineTo(r.right, r.centerY);
+            ctx.lineTo(r.centerX, r.bottom);
+            ctx.lineTo(r.left, r.centerY);
+            ctx.lineTo(r.centerX, r.top);
+            ctx.fill();
+          } else {
             ctx.beginPath();
             ctx.lineWidth = lineWidth * 2.5;
             ctx.moveTo(r.centerX, r.top);
@@ -2833,22 +2861,14 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
             ctx.moveTo(r.centerX, r.top);
             ctx.lineTo(r.left, r.centerY);
             ctx.stroke();
-          } else {
-            ctx.beginPath();
-            ctx.moveTo(r.centerX, r.top);
-            ctx.lineTo(r.right, r.centerY);
-            ctx.lineTo(r.centerX, r.bottom);
-            ctx.lineTo(r.left, r.centerY);
-            ctx.lineTo(r.centerX, r.top);
-            ctx.fill();
           }
         } else {
           ctx.beginPath();
           ctx.ellipse(r.centerX, r.centerY, r.leftw, r.toph, -0.3, 0, Math.PI * 2);
-          if (outlinedNoteHead) {
-            ctx.stroke();
-          } else {
+          if (isSolidNoteHead) {
             ctx.fill();
+          } else {
+            ctx.stroke();
           }
         }
       });
@@ -2863,8 +2883,8 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
         let left = rect.left;
         let right = rect.right;
         let width = right - left;
-        let top = stemDir === 1 /* Up */ ? rect.top : rect.bottom;
-        let bottom = stemDir === 1 /* Up */ ? rect.bottom : rect.top;
+        let top = stemDir === "up" /* Up */ ? rect.top : rect.bottom;
+        let bottom = stemDir === "up" /* Up */ ? rect.bottom : rect.top;
         ctx.beginPath();
         ctx.moveTo(left, top);
         ctx.bezierCurveTo(
@@ -2878,13 +2898,13 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
         ctx.stroke();
       });
     });
-    this.tabObjects.forEach((obj) => {
-      obj.fretNumbers.forEach((fn) => fn.draw(renderer));
-    });
+    this.tabObjects.forEach((obj) => obj.fretNumbers.forEach((fn) => fn.draw(renderer)));
   }
   static setBeamCounts(groupNotes) {
     const isADottedBHalf = (a, b) => {
-      return a.rhythmProps.noteLength === b.rhythmProps.noteLength * 2 && a.rhythmProps.dotted && !b.rhythmProps.dotted && a.rhythmProps.flagCount > 0 && b.rhythmProps.flagCount > 0;
+      let { flagCount: aFlagCount, noteSize: aNoteSize, dotCount: aDotCount } = a.rhythmProps;
+      let { flagCount: bFlagCount, noteSize: bNoteSize, dotCount: bDotCount } = b.rhythmProps;
+      return aFlagCount > 0 && bFlagCount > 0 && aDotCount > 0 && bDotCount === 0 && aNoteSize * Math.pow(2, aDotCount) === bNoteSize;
     };
     for (let i = 0; i < groupNotes.length; i++) {
       let center = groupNotes[i];
@@ -2930,29 +2950,27 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
       }
     } while (fixAgain);
   }
-  static setTripletBeamCounts(triplet) {
-    let type = triplet.getType();
-    let symbols = triplet.getSymbols();
-    if (type === 1 /* TripletBeam */) {
+  static setTupletBeamCounts(tuplet) {
+    let type = tuplet.getType();
+    let symbols = tuplet.getSymbols();
+    if (type === 1 /* TupletBeam */) {
       symbols.forEach((s, i) => {
         if (s instanceof _ObjNoteGroup) {
           s.leftBeamCount = i === 0 ? 0 : s.rhythmProps.flagCount;
           s.rightBeamCount = i === symbols.length - 1 ? 0 : s.rhythmProps.flagCount;
         }
       });
-    } else if (type === 2 /* TripletGroup */) {
+    } else if (type === 2 /* TupletGroup */) {
       symbols.forEach((s) => {
         if (s instanceof _ObjNoteGroup) {
           s.leftBeamCount = s.rightBeamCount = 0;
         }
       });
-    } else {
-      throw new MusicError7(MusicErrorType7.Score, "Cannot set triplet beam count because triplet beam group type is invalid.");
     }
   }
   getDotVerticalDisplacement(staff, diatonicId, stemDir) {
     if (staff.isLine(diatonicId)) {
-      return stemDir === 1 /* Up */ ? -1 : 1;
+      return stemDir === "up" /* Up */ ? -1 : 1;
     } else {
       return 0;
     }
@@ -2977,7 +2995,7 @@ import { MusicError as MusicError8, MusicErrorType as MusicErrorType8 } from "@t
 var noteHeadDataCompareFunc = (a, b) => {
   let cmp = Note5.compareFunc(a.note, b.note);
   if (cmp === 0) {
-    cmp = a.noteGroup.stemDir === b.noteGroup.stemDir ? 0 : a.noteGroup.stemDir === 1 /* Up */ ? 1 : -1;
+    cmp = a.noteGroup.stemDir === b.noteGroup.stemDir ? 0 : a.noteGroup.stemDir === "up" /* Up */ ? 1 : -1;
   }
   return cmp;
 };
@@ -3090,16 +3108,14 @@ var ObjRhythmColumn = class extends MusicObject {
   }
   getArpeggioDir() {
     var _a;
-    return (_a = this.arpeggioDir) != null ? _a : 0 /* Up */;
+    return (_a = this.arpeggioDir) != null ? _a : "up" /* Up */;
   }
   setVoiceSymbol(voiceId, symbol) {
     validateVoiceId(voiceId);
     this.voiceSymbol[voiceId] = symbol;
-    if (symbol instanceof ObjRest) {
-      if (!symbol.hide && symbol.noteLength >= NoteLength4.Half) {
-        this.minDiatonicId = this.minDiatonicId === void 0 ? symbol.ownDiatonicId : Math.min(this.minDiatonicId, symbol.ownDiatonicId);
-        this.maxDiatonicId = this.maxDiatonicId === void 0 ? symbol.ownDiatonicId : Math.max(this.maxDiatonicId, symbol.ownDiatonicId);
-      }
+    if (symbol instanceof ObjRest && !symbol.hide) {
+      this.minDiatonicId = this.minDiatonicId === void 0 ? symbol.ownDiatonicId : Math.min(this.minDiatonicId, symbol.ownDiatonicId);
+      this.maxDiatonicId = this.maxDiatonicId === void 0 ? symbol.ownDiatonicId : Math.max(this.maxDiatonicId, symbol.ownDiatonicId);
     } else if (symbol instanceof ObjNoteGroup) {
       this.minDiatonicId = this.minDiatonicId === void 0 ? symbol.notes[0].diatonicId : Math.min(this.minDiatonicId, symbol.notes[0].diatonicId);
       this.maxDiatonicId = this.maxDiatonicId === void 0 ? symbol.notes[symbol.notes.length - 1].diatonicId : Math.max(this.maxDiatonicId, symbol.notes[symbol.notes.length - 1].diatonicId);
@@ -3115,15 +3131,18 @@ var ObjRhythmColumn = class extends MusicObject {
     return this.voiceSymbol[voiceId];
   }
   getMinWidth() {
-    let maxNoteLength = Math.max(...this.voiceSymbol.map((s) => s.rhythmProps.noteLength));
+    let maxNoteSize = Math.max(...this.voiceSymbol.map((s) => s.rhythmProps.noteSize));
     let w = DocumentSettings.NoteHeadWidth;
-    switch (maxNoteLength) {
-      case NoteLength4.Whole:
+    switch (maxNoteSize) {
+      case 1:
         return w * 5;
-      case NoteLength4.Half:
+      // whole note
+      case 2:
         return w * 3;
-      case NoteLength4.Quarter:
+      // half note
+      case 4:
         return w * 2;
+      // quarter note
       default:
         return w;
     }
@@ -3155,7 +3174,7 @@ var ObjRhythmColumn = class extends MusicObject {
       if (cur.displacement !== void 0) {
         continue;
       }
-      let d = cur.noteGroup.stemDir === 2 /* Down */ ? -1 : 1;
+      let d = cur.noteGroup.stemDir === "down" /* Down */ ? -1 : 1;
       if (prev && cur.note.diatonicId - prev.note.diatonicId <= 1) {
         cur.displacement = prev.displacement === 0 ? d : 0;
       } else if (next && next.note.diatonicId - cur.note.diatonicId <= 1) {
@@ -3209,7 +3228,7 @@ var ObjRhythmColumn = class extends MusicObject {
       }
     });
     playerNotes.sort((a, b) => Note5.compareFunc(a.note, b.note));
-    if (this.hasArpeggio() && this.getArpeggioDir() === 1 /* Down */) {
+    if (this.hasArpeggio() && this.getArpeggioDir() === "down" /* Down */) {
       playerNotes.reverse();
     }
     return playerNotes;
@@ -3326,6 +3345,12 @@ var ObjRhythmColumn = class extends MusicObject {
   }
 };
 
+// src/score/engine/extension.ts
+import { MusicError as MusicError9, MusicErrorType as MusicErrorType9 } from "@tspro/web-music-score/core";
+
+// src/score/engine/element-data.ts
+import { Utils as Utils5 } from "@tspro/ts-utils-lib";
+
 // src/score/engine/obj-special-text.ts
 var _ObjSpecialText = class _ObjSpecialText extends MusicObject {
   constructor(parent, text) {
@@ -3423,40 +3448,53 @@ __publicField(_ObjSpecialText, "Segno", "\u{1D10B}");
 var ObjSpecialText = _ObjSpecialText;
 
 // src/score/engine/element-data.ts
-function getNavigationString(n) {
-  switch (n) {
-    case 1 /* DC_al_Coda */:
+function getNavigationString(navigation) {
+  switch (navigation) {
+    case "D.C. al Coda" /* DC_al_Coda */:
       return "D.C. al Coda";
-    case 0 /* DC_al_Fine */:
+    case "D.C. al Fine" /* DC_al_Fine */:
       return "D.C. al Fine";
-    case 3 /* DS_al_Coda */:
+    case "D.S. al Coda" /* DS_al_Coda */:
       return "D.S. al Coda";
-    case 2 /* DS_al_Fine */:
+    case "D.S. al Fine" /* DS_al_Fine */:
       return "D.S. al Fine";
-    case 7 /* Fine */:
+    case "Fine" /* Fine */:
       return "Fine";
-    case 6 /* Segno */:
+    case "Segno" /* Segno */:
       return ObjSpecialText.Segno;
-    case 4 /* Coda */:
+    case "Coda" /* Coda */:
       return ObjSpecialText.Coda;
-    case 5 /* toCoda */:
+    case "toCoda" /* toCoda */:
       return ObjSpecialText.toCoda;
     default:
-      return Navigation[n];
+      return navigation[0].toUpperCase() + navigation.substring(1);
   }
 }
 function isDynamicsText(text) {
-  return ["ppp", "pp", "p", "mp", "m", "mf", "f", "ff", "fff", "cresc.", "decresc.", "dim."].indexOf(text) >= 0;
+  return Utils5.Is.isEnumValue(text, DynamicsAnnotation);
 }
-function isDynamicsLevelText(text) {
-  return ["ppp", "pp", "p", "mp", "m", "mf", "f", "ff", "fff"].indexOf(text) >= 0;
+function getDynamicsVolume(text) {
+  if (/^(p+|f+|m|mp|mf)$/.test(text)) {
+    let volume = 0.5 - Utils5.Str.charCount(text, "p") * 0.1 + Utils5.Str.charCount(text, "f") * 0.1;
+    return Utils5.Math.clamp(volume, 0, 1);
+  } else {
+    return void 0;
+  }
 }
 function isTempoText(text) {
-  return ["accel.", "rit.", "a tempo"].indexOf(text) >= 0;
+  return Utils5.Is.isEnumValue(text, TempoAnnotation);
+}
+function getAnnotation(text) {
+  if (Utils5.Is.isEnumValue(text, DynamicsAnnotation)) {
+    return "dynamics" /* Dynamics */;
+  } else if (Utils5.Is.isEnumValue(text, TempoAnnotation)) {
+    return "tempo" /* Tempo */;
+  } else {
+    return void 0;
+  }
 }
 
 // src/score/engine/extension.ts
-import { MusicError as MusicError9, MusicErrorType as MusicErrorType9 } from "@tspro/web-music-score/core";
 function getTextAnchorY(linePos) {
   switch (linePos) {
     case "bottom":
@@ -3511,7 +3549,7 @@ var Extension = class extends MusicObjectLink {
         if (prevMeasure.hasEndSection() || prevMeasure.hasEndSong()) {
           return "section-break";
         }
-        let elemArr = [9 /* EndRepeat */, 10 /* Ending */];
+        let elemArr = ["endRepeat" /* EndRepeat */, "ending" /* Ending */];
         for (let i = 0; i < elemArr.length; i++) {
           if (prevMeasure.hasNavigation(elemArr[i])) {
             return "section-break";
@@ -3572,35 +3610,12 @@ var RitardandoSpeedDiv = 2;
 var CrescendoVolumeAdd = 0.5;
 var DiminuendoVolumeSub = 0.5;
 function calcTicksDuration(ticks, tempo) {
-  let beatTicks = new RhythmProps3(tempo.options.beatLength, tempo.options.dotted).ticks;
+  let beatTicks = RhythmProps3.get(tempo.options.beatLength, tempo.options.dotCount).ticks;
   let ticksPerMinute = tempo.beatsPerMinute * beatTicks;
   return 60 * ticks / ticksPerMinute;
 }
-function getVolume(dynamicsLevelText) {
-  switch (dynamicsLevelText) {
-    case "fff":
-      return 0.9;
-    case "ff":
-      return 0.8;
-    case "f":
-      return 0.7;
-    case "mf":
-      return 0.6;
-    default:
-    case "m":
-      return 0.5;
-    case "mp":
-      return 0.4;
-    case "p":
-      return 0.3;
-    case "pp":
-      return 0.2;
-    case "ppp":
-      return 0.1;
-  }
-}
 function getDefaultVolume() {
-  return getVolume("m");
+  return getDynamicsVolume("m");
 }
 function adjustVolume(linearVolume) {
   return linearVolume * 1.25;
@@ -3628,7 +3643,7 @@ var PlayerColumnProps = class {
     return this.speed;
   }
   getTempo() {
-    let speed = Utils5.Math.clamp(this.getSpeed(), 0.1, 10);
+    let speed = Utils6.Math.clamp(this.getSpeed(), 0.1, 10);
     return alterTempoSpeed(this.measure.getTempo(), speed);
   }
   setVolume(volume) {
@@ -3653,7 +3668,7 @@ var PlayerColumnProps = class {
       if (symbolsTicks.length === 0) {
         return 0;
       } else {
-        return Utils5.Math.sum(symbolsTicks) / symbolsTicks.length;
+        return Utils6.Math.sum(symbolsTicks) / symbolsTicks.length;
       }
     }
   }
@@ -3716,34 +3731,34 @@ var Player = class _Player {
         continue;
       }
       measureSequence.push(curMeasure);
-      if (curMeasure.hasNavigation(8 /* StartRepeat */)) {
+      if (curMeasure.hasNavigation("startRepeat" /* StartRepeat */)) {
         startRepeatMeasure = curMeasure;
       }
-      if (curMeasure.hasNavigation(6 /* Segno */)) {
+      if (curMeasure.hasNavigation("Segno" /* Segno */)) {
         segnoMeasure = curMeasure;
       }
-      if (alCoda && curMeasure.hasNavigation(5 /* toCoda */)) {
-        while (curMeasure && !curMeasure.hasNavigation(4 /* Coda */)) {
+      if (alCoda && curMeasure.hasNavigation("toCoda" /* toCoda */)) {
+        while (curMeasure && !curMeasure.hasNavigation("Coda" /* Coda */)) {
           curMeasure = curMeasure.getNextMeasure();
         }
-      } else if (alFine && curMeasure.hasNavigation(7 /* Fine */)) {
+      } else if (alFine && curMeasure.hasNavigation("Fine" /* Fine */)) {
         curMeasure = void 0;
-      } else if (curMeasure.hasNavigation(1 /* DC_al_Coda */)) {
+      } else if (curMeasure.hasNavigation("D.C. al Coda" /* DC_al_Coda */)) {
         alCoda = true;
         curMeasure = this.doc.getFirstMeasure();
-      } else if (curMeasure.hasNavigation(0 /* DC_al_Fine */)) {
+      } else if (curMeasure.hasNavigation("D.C. al Fine" /* DC_al_Fine */)) {
         alFine = true;
         curMeasure = this.doc.getFirstMeasure();
-      } else if (curMeasure.hasNavigation(3 /* DS_al_Coda */)) {
+      } else if (curMeasure.hasNavigation("D.S. al Coda" /* DS_al_Coda */)) {
         alCoda = true;
         curMeasure = segnoMeasure;
-      } else if (curMeasure.hasNavigation(2 /* DS_al_Fine */)) {
+      } else if (curMeasure.hasNavigation("D.S. al Fine" /* DS_al_Fine */)) {
         alFine = true;
         curMeasure = segnoMeasure;
-      } else if (curMeasure.hasNavigation(9 /* EndRepeat */)) {
+      } else if (curMeasure.hasNavigation("endRepeat" /* EndRepeat */)) {
         let passage = curMeasure.getPassCount();
         let repeatCount = curMeasure.getEndRepeatPlayCount() - 1;
-        let cannotPassThrough = ((_a = curMeasure.getNextMeasure()) == null ? void 0 : _a.hasNavigation(10 /* Ending */)) === true;
+        let cannotPassThrough = ((_a = curMeasure.getNextMeasure()) == null ? void 0 : _a.hasNavigation("ending" /* Ending */)) === true;
         if (passage <= repeatCount || cannotPassThrough) {
           curMeasure = startRepeatMeasure;
         } else {
@@ -3794,14 +3809,15 @@ var Player = class _Player {
       col.getAnchoredLayoutObjects().forEach((layoutObj) => {
         var _a2;
         let text = (_a2 = layoutObj.getTextContent()) != null ? _a2 : "";
-        if (text === "a tempo") {
+        let vol;
+        if (text === "a tempo" /* a_tempo */) {
           curSpeed = 1;
-        } else if (isDynamicsLevelText(text)) {
-          curVolume = getVolume(text);
+        } else if ((vol = getDynamicsVolume(text)) !== void 0) {
+          curVolume = vol;
         } else if (layoutObj.musicObj.getLink() instanceof Extension) {
           let extension = layoutObj.musicObj.getLink();
           let { columnRange, extensionBreakText } = extension.getExtensionRangeInfo();
-          let totalTicks = Utils5.Math.sum(columnRange.map((c) => c.getTicksToNextColumn()));
+          let totalTicks = Utils6.Math.sum(columnRange.map((c) => c.getTicksToNextColumn()));
           switch (text) {
             case "accel." /* accel */: {
               let startSpeed = curSpeed;
@@ -3826,8 +3842,8 @@ var Player = class _Player {
             case "cresc." /* cresc */: {
               let startVol = curVolume;
               let endVol = startVol + CrescendoVolumeAdd;
-              if (extensionBreakText && isDynamicsLevelText(extensionBreakText) && getVolume(extensionBreakText) > startVol) {
-                endVol = getVolume(extensionBreakText);
+              if (extensionBreakText && (vol = getDynamicsVolume(extensionBreakText)) !== void 0 && vol > startVol) {
+                endVol = vol;
               }
               let accuTicks = 0;
               columnRange.forEach((c) => {
@@ -3840,8 +3856,8 @@ var Player = class _Player {
             case "dim." /* dim */: {
               let startVol = curVolume;
               let endVol = startVol - DiminuendoVolumeSub;
-              if (extensionBreakText && isDynamicsLevelText(extensionBreakText) && getVolume(extensionBreakText) < startVol) {
-                endVol = getVolume(extensionBreakText);
+              if (extensionBreakText && (vol = getDynamicsVolume(extensionBreakText)) !== void 0 && vol < startVol) {
+                endVol = vol;
               }
               let accuTicks = 0;
               columnRange.forEach((c) => {
@@ -3855,11 +3871,11 @@ var Player = class _Player {
       });
       let speedArr = (_a = speedMap.get(col)) != null ? _a : [];
       if (speedArr.length > 0) {
-        curSpeed = Utils5.Math.sum(speedArr) / speedArr.length;
+        curSpeed = Utils6.Math.sum(speedArr) / speedArr.length;
       }
       let volumeArr = (_b = volumeMap.get(col)) != null ? _b : [];
       if (volumeArr.length > 0) {
-        curVolume = Utils5.Math.sum(volumeArr) / volumeArr.length;
+        curVolume = Utils6.Math.sum(volumeArr) / volumeArr.length;
       }
       col.getPlayerProps().setSpeed(curSpeed);
       col.getPlayerProps().setVolume(curVolume);
@@ -3872,7 +3888,7 @@ var Player = class _Player {
         return m;
       }
       let next = m == null ? void 0 : m.getNextMeasure();
-      if (!m || m.hasEndSong() || m.hasEndSection() || !next || next.hasNavigation(8 /* StartRepeat */)) {
+      if (!m || m.hasEndSong() || m.hasEndSection() || !next || next.hasNavigation("startRepeat" /* StartRepeat */)) {
         return void 0;
       }
     }
@@ -3897,11 +3913,11 @@ var Player = class _Player {
     } else {
       let playerNotes = col.getPlayerNotes();
       playerNotes.forEach((note, i) => {
-        let arpeggioDelayTicks = col.hasArpeggio() ? NoteLength5.ThirtySecond * i : 0;
+        let arpeggioDelayTicks = col.hasArpeggio() ? RhythmProps3.get(NoteLength5.ThirtySecond).ticks * i : 0;
         let noteSeconds = getDuration(note.ticks + fermataHoldTicks - arpeggioDelayTicks, tempo);
         if (noteSeconds > 0) {
           if (note.staccato) {
-            noteSeconds = Math.min(getDuration(NoteLength5.Eighth, tempo) / 2, noteSeconds / 2);
+            noteSeconds = Math.min(getDuration(RhythmProps3.get(NoteLength5.Eighth).ticks, tempo) / 2, noteSeconds / 2);
           }
           let volume = adjustVolume(col.getPlayerProps().getVolume());
           if (note.slur === "slurred") {
@@ -4139,8 +4155,8 @@ var ObjBarLineLeft = class extends ObjBarLine {
   solveBarLineType() {
     let m = this.measure;
     let prev = m.getPrevMeasure();
-    if (m.hasNavigation(8 /* StartRepeat */)) {
-      if (prev && prev.row === m.row && prev.hasNavigation(9 /* EndRepeat */)) {
+    if (m.hasNavigation("startRepeat" /* StartRepeat */)) {
+      if (prev && prev.row === m.row && prev.hasNavigation("endRepeat" /* EndRepeat */)) {
         return 0 /* None */;
       } else {
         return 4 /* StartRepeat */;
@@ -4167,8 +4183,8 @@ var ObjBarLineRight = class extends ObjBarLine {
   solveBarLineType() {
     let m = this.measure;
     let next = m.getNextMeasure();
-    if (m.hasNavigation(9 /* EndRepeat */)) {
-      if (next && next.row === m.row && next.hasNavigation(8 /* StartRepeat */)) {
+    if (m.hasNavigation("endRepeat" /* EndRepeat */)) {
+      if (next && next.row === m.row && next.hasNavigation("startRepeat" /* StartRepeat */)) {
         return 6 /* EndStartRepeat */;
       } else {
         return 5 /* EndRepeat */;
@@ -4178,10 +4194,10 @@ var ObjBarLineRight = class extends ObjBarLine {
     } else if (m.hasEndSection()) {
       return 2 /* Double */;
     }
-    if (m === m.row.getLastMeasure() && next && next.row === m.row.getNextRow() && next.hasNavigation(8 /* StartRepeat */)) {
+    if (m === m.row.getLastMeasure() && next && next.row === m.row.getNextRow() && next.hasNavigation("startRepeat" /* StartRepeat */)) {
       return 2 /* Double */;
     }
-    if (next && next.hasNavigation(8 /* StartRepeat */)) {
+    if (next && next.hasNavigation("startRepeat" /* StartRepeat */)) {
       return 0 /* None */;
     }
     return 1 /* Single */;
@@ -4189,7 +4205,7 @@ var ObjBarLineRight = class extends ObjBarLine {
 };
 
 // src/score/engine/obj-ending.ts
-import { Utils as Utils6 } from "@tspro/ts-utils-lib";
+import { Utils as Utils7 } from "@tspro/ts-utils-lib";
 import { MusicError as MusicError10, MusicErrorType as MusicErrorType10 } from "@tspro/web-music-score/core";
 var ObjEnding = class extends MusicObject {
   constructor(measure, passages) {
@@ -4200,9 +4216,9 @@ var ObjEnding = class extends MusicObject {
     __publicField(this, "shapeRects", []);
     __publicField(this, "mi");
     this.mi = new MEnding(this);
-    if (!Utils6.Is.isIntegerGte(passages.length, 1)) {
+    if (!Utils7.Is.isIntegerGte(passages.length, 1)) {
       throw new MusicError10(MusicErrorType10.Score, "Passages is empty.");
-    } else if (!this.passages.every((p) => Utils6.Is.isIntegerGte(p, 1))) {
+    } else if (!this.passages.every((p) => Utils7.Is.isIntegerGte(p, 1))) {
       throw new MusicError10(MusicErrorType10.Score, "Invalid passages: " + this.passages);
     }
     this.passages.sort((a, b) => a - b);
@@ -4218,7 +4234,7 @@ var ObjEnding = class extends MusicObject {
   isSingleMeasureEnding() {
     let { measure } = this;
     let next = measure.getNextMeasure();
-    return (next == null ? void 0 : next.hasNavigation(10 /* Ending */)) === true || measure.hasNavigation(9 /* EndRepeat */) || measure.isLastMeasure();
+    return (next == null ? void 0 : next.hasNavigation("ending" /* Ending */)) === true || measure.hasNavigation("endRepeat" /* EndRepeat */) || measure.isLastMeasure();
   }
   hasPassage(pass) {
     return this.passages.some((p) => p === pass);
@@ -4417,7 +4433,7 @@ import { MusicError as MusicError13, MusicErrorType as MusicErrorType13 } from "
 import { Note as Note6 } from "@tspro/web-music-score/theory";
 
 // src/score/engine/obj-connective.ts
-import { Utils as Utils7 } from "@tspro/ts-utils-lib";
+import { Utils as Utils8 } from "@tspro/ts-utils-lib";
 import { MusicError as MusicError11, MusicErrorType as MusicErrorType11 } from "@tspro/web-music-score/core";
 var ObjConnective = class extends MusicObject {
   constructor(connectiveProps, line, measure, leftNoteGroup, leftNoteId, ...args) {
@@ -4446,7 +4462,7 @@ var ObjConnective = class extends MusicObject {
       this.rightNoteGroup = args[0];
       this.rightNoteId = args[1];
       this.tieType = void 0;
-    } else if (Utils7.Is.isEnumValue(args[0], TieType)) {
+    } else if (Utils8.Is.isEnumValue(args[0], TieType)) {
       this.rightNoteGroup = void 0;
       this.rightNoteId = void 0;
       this.tieType = args[0];
@@ -4477,7 +4493,7 @@ var ObjConnective = class extends MusicObject {
     if (rightNoteGroup !== void 0 && rightNoteId !== void 0) {
       rightPos = rightNoteGroup.getConnectiveAnchorPoint(connectiveProps, line, rightNoteId, noteAnchor, "right");
     } else {
-      rightPos = this.tieType === -2 /* ToMeasureEnd */ ? { x: measure.getColumnsContentRect().right, y: leftPos.y } : { x: leftPos.x + unitSize * DocumentSettings.StubTieLength, y: leftPos.y };
+      rightPos = this.tieType === "toMeasureEnd" /* ToMeasureEnd */ ? { x: measure.getColumnsContentRect().right, y: leftPos.y } : { x: leftPos.x + unitSize * DocumentSettings.StubTieLength, y: leftPos.y };
     }
     let lx, ly, rx, ry;
     if (rightNoteGroup === void 0) {
@@ -4515,8 +4531,8 @@ var ObjConnective = class extends MusicObject {
     this.ly = ly;
     this.rx = rx;
     this.ry = ry;
-    this.arcHeight = this.connectiveProps.connective === 2 /* Slide */ ? 0 : arcHeight;
-    let { nx, ny } = Utils7.Math.calcNormal(lx, ly, rx, ry);
+    this.arcHeight = this.connectiveProps.connective === "slide" /* Slide */ ? 0 : arcHeight;
+    let { nx, ny } = Utils8.Math.calcNormal(lx, ly, rx, ry);
     this.cp1x = lx * 0.7 + rx * 0.3 + nx * this.arcHeight;
     this.cp1y = ly * 0.7 + ry * 0.3 + ny * this.arcHeight;
     this.cp2x = lx * 0.3 + rx * 0.7 + nx * this.arcHeight;
@@ -4577,6 +4593,7 @@ var ObjConnective = class extends MusicObject {
 
 // src/score/engine/connective-props.ts
 import { MusicError as MusicError12, MusicErrorType as MusicErrorType12 } from "@tspro/web-music-score/core";
+import { Utils as Utils9 } from "@tspro/ts-utils-lib";
 var ConnectiveProps = class {
   constructor(connective, span, noteAnchor, startNoteGroup) {
     this.connective = connective;
@@ -4598,7 +4615,7 @@ var ConnectiveProps = class {
    * @returns true if noteGroup was added, false if not.
    */
   addNoteGroup(noteGroup) {
-    if (this.span === -1 /* Stub */ || this.span === -2 /* ToMeasureEnd */) {
+    if (this.span === "stub" /* Stub */ || this.span === "toMeasureEnd" /* ToMeasureEnd */) {
       return false;
     } else if (this.span > this.noteGroups.length) {
       this.noteGroups.push(noteGroup);
@@ -4608,29 +4625,29 @@ var ConnectiveProps = class {
     }
   }
   computeParams() {
-    let stemDir = this.noteGroups[0].stemDir;
-    let hasStem = this.noteGroups[0].rhythmProps.hasStem;
-    if (this.noteAnchor === 4 /* StemTip */) {
-      this.arcDir = stemDir === 1 /* Up */ ? "up" : "down";
-    } else if (this.noteAnchor === 0 /* Auto */) {
-      this.arcDir = stemDir === 1 /* Up */ || !hasStem ? "down" : "up";
+    let { stemDir } = this.noteGroups[0];
+    let { hasStem } = this.noteGroups[0].rhythmProps;
+    if (this.noteAnchor === "stemTip" /* StemTip */) {
+      this.arcDir = stemDir === "up" /* Up */ ? "up" : "down";
+    } else if (this.noteAnchor === "auto" /* Auto */) {
+      this.arcDir = stemDir === "up" /* Up */ || !hasStem ? "down" : "up";
       if (this.noteGroups[0].notes.length > 1) {
-        this.noteAnchor = 2 /* Center */;
-      } else if (this.connective === 2 /* Slide */) {
-        this.noteAnchor = 2 /* Center */;
+        this.noteAnchor = "center" /* Center */;
+      } else if (this.connective === "slide" /* Slide */) {
+        this.noteAnchor = "center" /* Center */;
       } else if (this.arcDir === "up") {
-        this.noteAnchor = 1 /* Above */;
+        this.noteAnchor = "above" /* Above */;
       } else {
-        this.noteAnchor = 3 /* Below */;
+        this.noteAnchor = "below" /* Below */;
       }
-    } else if (this.noteAnchor === 2 /* Center */) {
+    } else if (this.noteAnchor === "center" /* Center */) {
       let { row } = this.noteGroups[0].measure;
       let diatonicId = this.noteGroups[0].ownDiatonicId;
       let staff = row.getStaff(diatonicId);
       this.arcDir = !staff || diatonicId < staff.middleLineDiatonicId ? "down" : "up";
-    } else if (this.noteAnchor === 1 /* Above */) {
+    } else if (this.noteAnchor === "above" /* Above */) {
       this.arcDir = "up";
-    } else if (this.noteAnchor === 3 /* Below */) {
+    } else if (this.noteAnchor === "below" /* Below */) {
       this.arcDir = "down";
     }
   }
@@ -4645,8 +4662,8 @@ var ConnectiveProps = class {
     this.getStartNoteGroup().collectConnectiveProps();
     this.computeParams();
     let { connective, span } = this;
-    if (connective === 0 /* Tie */) {
-      if (span === -1 /* Stub */ || span === -2 /* ToMeasureEnd */) {
+    if (connective === "tie" /* Tie */) {
+      if (Utils9.Is.isEnumValue(span, TieType)) {
         let leftNoteGroup = this.noteGroups[0];
         for (let noteId = 0; noteId < leftNoteGroup.notes.length; noteId++) {
           this.createObjConnectiveWithTieType(leftNoteGroup, noteId, span);
@@ -4663,13 +4680,13 @@ var ConnectiveProps = class {
           });
         }
       }
-    } else if (connective === 1 /* Slur */) {
+    } else if (connective === "slur" /* Slur */) {
       if (typeof span === "number" && span >= 2 && this.noteGroups.length === span) {
         let leftNoteGroup = this.noteGroups[0];
         let rightNoteGroup = this.noteGroups[this.noteGroups.length - 1];
         this.createObjConnective(leftNoteGroup, 0, rightNoteGroup, 0);
       }
-    } else if (connective === 2 /* Slide */) {
+    } else if (connective === "slide" /* Slide */) {
       if (this.noteGroups.length >= 2) {
         for (let i = 0; i < this.noteGroups.length - 1; i++) {
           let leftNoteGroup = this.noteGroups[i];
@@ -4699,7 +4716,7 @@ var ConnectiveProps = class {
         } else {
           let leftString = leftNoteGroup2.getFretNumberString(leftNoteId2);
           let rightString = rightNoteGroup2.getFretNumberString(rightNoteId2);
-          if (leftString !== void 0 && rightString !== void 0 && (leftString === rightString || this.connective === 1 /* Slur */)) {
+          if (leftString !== void 0 && rightString !== void 0 && (leftString === rightString || this.connective === "slur" /* Slur */)) {
             new ObjConnective(this, line, measure, leftNoteGroup2, leftNoteId2, rightNoteGroup2, rightNoteId2);
           }
         }
@@ -4724,6 +4741,32 @@ function validateVoiceId(voiceId) {
     return voiceId;
   }
 }
+function getExtensionTicks(extensionLength) {
+  if (typeof extensionLength === "string") {
+    extensionLength = [extensionLength];
+  }
+  if (Utils10.Is.isArray(extensionLength)) {
+    let totalTicks = 0;
+    for (let i = 0; i < extensionLength.length; ) {
+      let str = extensionLength[i];
+      let num = extensionLength[i + 1];
+      if (typeof str === "string") {
+        i++;
+        let ticks = RhythmProps4.get(str).ticks;
+        if (typeof num === "number") {
+          i++;
+          ticks *= num;
+        }
+        totalTicks += ticks;
+      } else {
+        i++;
+      }
+    }
+    return totalTicks;
+  } else {
+    return extensionLength;
+  }
+}
 var _ObjMeasure = class _ObjMeasure extends MusicObject {
   constructor(row) {
     super(row);
@@ -4827,15 +4870,15 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     if (setStemDir !== void 0) {
       this.useStemDir[voiceId] = setStemDir;
     } else if (this.useStemDir[voiceId] === void 0) {
-      this.useStemDir[voiceId] = (_b = (_a = this.getPrevMeasure()) == null ? void 0 : _a.useStemDir[voiceId]) != null ? _b : 0 /* Auto */;
+      this.useStemDir[voiceId] = (_b = (_a = this.getPrevMeasure()) == null ? void 0 : _a.useStemDir[voiceId]) != null ? _b : "auto" /* Auto */;
     }
     let stemDir = this.useStemDir[voiceId];
-    if (stemDir === 0 /* Auto */ || stemDir === void 0) {
+    if (stemDir === "auto" /* Auto */ || stemDir === void 0) {
       let staff = this.row.getStaff(symbol.ownDiatonicId);
       if (staff) {
-        return symbol.ownDiatonicId > staff.middleLineDiatonicId ? 2 /* Down */ : 1 /* Up */;
+        return symbol.ownDiatonicId > staff.middleLineDiatonicId ? "down" /* Down */ : "up" /* Up */;
       } else {
-        return 1 /* Up */;
+        return "up" /* Up */;
       }
     } else {
       return stemDir;
@@ -4942,6 +4985,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   // See MMeasure interface
   //setKeySignature(tonic: string, scaleType: ScaleType): void;
   //setKeySignature(keySignature: KeySignature): void;
+  //setKeySignature(keySignature: string): void;
   //setKeySignature(scale: Scale): void;
   setKeySignature(...args) {
     var _a;
@@ -4950,13 +4994,17 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
       this.alterKeySignature = args[0];
     } else if (args[0] instanceof Scale) {
       this.alterKeySignature = args[0];
-    } else {
-      try {
-        let tonic = "" + args[0];
-        let scaleType = validateScaleType("" + args[1]);
-        this.alterKeySignature = getScale(tonic, scaleType);
-      } catch (e) {
-        throw new MusicError13(MusicErrorType13.Score, "Cannot set key signature because invalid args: " + args);
+    } else if (Utils10.Is.isNonEmptyString(args[0])) {
+      if (args.length === 1) {
+        this.alterKeySignature = getScale(args[0]);
+      } else if (args.length === 2) {
+        try {
+          let tonic = "" + args[0];
+          let scaleType = validateScaleType("" + args[1]);
+          this.alterKeySignature = getScale(tonic, scaleType);
+        } catch (e) {
+          throw new MusicError13(MusicErrorType13.Score, "Cannot set key signature because invalid args: " + args);
+        }
       }
     }
     this.updateKeySignature();
@@ -4996,8 +5044,16 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   setTempo(beatsPerMinute, beatLength, dotted) {
     var _a;
     (_a = this.getPrevMeasure()) == null ? void 0 : _a.endSection();
-    let options = beatLength !== void 0 ? { beatLength, dotted } : void 0;
-    this.alterTempo = { beatsPerMinute, options };
+    if (beatLength === void 0) {
+      this.alterTempo = { beatsPerMinute };
+    } else {
+      let dotCount = typeof dotted === "number" && dotted > 0 ? dotted : dotted === true ? 1 : NoteLengthProps4.get(beatLength).dotCount;
+      let options = {
+        beatLength: validateNoteLength(beatLength),
+        dotCount: dotCount > 0 ? dotCount : void 0
+      };
+      this.alterTempo = { beatsPerMinute, options };
+    }
     this.updateTempo();
   }
   updateTempo() {
@@ -5006,18 +5062,18 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     if (this.alterTempo) {
       let beatsPerMinute = this.alterTempo.beatsPerMinute;
       let beatLength;
-      let dotted;
+      let dotCount;
       if (this.alterTempo.options) {
         beatLength = this.alterTempo.options.beatLength;
-        dotted = (_a = this.alterTempo.options.dotted) != null ? _a : false;
+        dotCount = (_a = this.alterTempo.options.dotCount) != null ? _a : 0;
       } else if (this.alterTimeSignature) {
         beatLength = this.alterTimeSignature.beatLength;
-        dotted = false;
+        dotCount = 0;
       } else {
         beatLength = this.tempo.options.beatLength;
-        dotted = this.tempo.options.dotted;
+        dotCount = this.tempo.options.dotCount;
       }
-      this.tempo = { beatsPerMinute, options: { beatLength, dotted } };
+      this.tempo = { beatsPerMinute, options: { beatLength, dotCount } };
     }
     if (this.nextMeasure) {
       this.nextMeasure.updateTempo();
@@ -5049,19 +5105,19 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
           let grp = this.doc.getStaffGroup(staffTabOrGroup);
           if (grp && !prevGroups.includes(staffTabOrGroup)) {
             let curGroups = [...prevGroups, staffTabOrGroup];
-            (Utils8.Is.isArray(grp.staffsTabsAndGroups) ? grp.staffsTabsAndGroups : [grp.staffsTabsAndGroups]).forEach((staffTabOrGroup2) => {
+            (Utils10.Is.isArray(grp.staffsTabsAndGroups) ? grp.staffsTabsAndGroups : [grp.staffsTabsAndGroups]).forEach((staffTabOrGroup2) => {
               switch (grp.verticalPosition) {
-                case 0 /* Above */:
+                case "above" /* Above */:
                   addToStaffTabOrGroup(staffTabOrGroup2, 0 /* Above */, curGroups);
                   break;
-                case 1 /* Below */:
+                case "below" /* Below */:
                   addToStaffTabOrGroup(staffTabOrGroup2, 1 /* Below */, curGroups);
                   break;
-                case 2 /* Both */:
+                case "both" /* Both */:
                   addToStaffTabOrGroup(staffTabOrGroup2, 0 /* Above */, curGroups);
                   addToStaffTabOrGroup(staffTabOrGroup2, 1 /* Below */, curGroups);
                   break;
-                case 3 /* Auto */:
+                case "auto" /* Auto */:
                   addToStaffTabOrGroup(staffTabOrGroup2, defaultVerticalPos, curGroups);
                   break;
               }
@@ -5076,14 +5132,14 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
       } else {
         addToStaffTabOrGroup(0, defaultVerticalPos);
       }
-    } else if (Utils8.Is.isArray(staffTabOrGroups)) {
+    } else if (Utils10.Is.isArray(staffTabOrGroups)) {
       staffTabOrGroups.forEach((staffTabOrGroup) => addToStaffTabOrGroup(staffTabOrGroup, defaultVerticalPos));
     } else {
       addToStaffTabOrGroup(staffTabOrGroups, defaultVerticalPos);
     }
   }
   addFermata(staffTabOrGroups, fermata) {
-    let anchor = fermata === 1 /* AtMeasureEnd */ ? this.barLineRight : this.lastAddedRhythmColumn;
+    let anchor = fermata === "atMeasureEnd" /* AtMeasureEnd */ ? this.barLineRight : this.lastAddedRhythmColumn;
     if (!anchor) {
       throw new MusicError13(MusicErrorType13.Score, "Cannot add Fermata because anchor is undefined.");
     }
@@ -5099,7 +5155,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   addNavigation(staffTabOrGroups, navigation, ...args) {
     let addLayoutObjectProps = void 0;
     switch (navigation) {
-      case 10 /* Ending */:
+      case "ending" /* Ending */:
         if (this.navigationSet.has(navigation)) {
           throw new MusicError13(MusicErrorType13.Score, "Cannot add ending beasure measure already has one.");
         }
@@ -5111,10 +5167,10 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
           defaultVerticalPos: 0 /* Above */
         };
         break;
-      case 1 /* DC_al_Coda */:
-      case 0 /* DC_al_Fine */:
-      case 3 /* DS_al_Coda */:
-      case 2 /* DS_al_Fine */: {
+      case "D.C. al Coda" /* DC_al_Coda */:
+      case "D.C. al Fine" /* DC_al_Fine */:
+      case "D.S. al Coda" /* DS_al_Coda */:
+      case "D.S. al Fine" /* DS_al_Fine */: {
         let anchor2 = this.barLineRight;
         let text = getNavigationString(navigation);
         addLayoutObjectProps = {
@@ -5122,11 +5178,11 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
           layoutGroupId: 2 /* Navigation */,
           defaultVerticalPos: 0 /* Above */
         };
-        this.addNavigation(staffTabOrGroups, 9 /* EndRepeat */);
+        this.addNavigation(staffTabOrGroups, "endRepeat" /* EndRepeat */);
         this.endSong();
         break;
       }
-      case 7 /* Fine */: {
+      case "Fine" /* Fine */: {
         let anchor2 = this.barLineRight;
         let text = getNavigationString(navigation);
         addLayoutObjectProps = {
@@ -5136,8 +5192,8 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
         };
         break;
       }
-      case 6 /* Segno */:
-      case 4 /* Coda */: {
+      case "Segno" /* Segno */:
+      case "Coda" /* Coda */: {
         let anchor2 = this.barLineLeft;
         let text = getNavigationString(navigation);
         addLayoutObjectProps = {
@@ -5147,7 +5203,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
         };
         break;
       }
-      case 5 /* toCoda */: {
+      case "toCoda" /* toCoda */: {
         let anchor2 = this.barLineRight;
         let text = getNavigationString(navigation);
         addLayoutObjectProps = {
@@ -5157,10 +5213,10 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
         };
         break;
       }
-      case 9 /* EndRepeat */:
+      case "endRepeat" /* EndRepeat */:
         if (args.length === 0) {
           this.endRepeatPlayCount = 2;
-        } else if (Utils8.Is.isIntegerGte(args[0], 2)) {
+        } else if (Utils10.Is.isIntegerGte(args[0], 2)) {
           this.endRepeatPlayCount = args[0];
         } else {
           throw new MusicError13(MusicErrorType13.Score, "Invalid end repeat play count (should be 2 or greater integer): " + args[0]);
@@ -5196,17 +5252,18 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     let layoutGroupId;
     let defaultVerticalPos;
     switch (annotation) {
-      case 0 /* Dynamics */:
+      case "dynamics" /* Dynamics */:
         layoutGroupId = 5 /* DynamicsAnnotation */;
         defaultVerticalPos = 0 /* Above */;
         textProps.italic = true;
         break;
-      case 1 /* Tempo */:
+      case "tempo" /* Tempo */:
         layoutGroupId = 4 /* TempoAnnotation */;
         defaultVerticalPos = 0 /* Above */;
         textProps.italic = true;
         break;
     }
+    this.disableExtension();
     this.forEachStaffGroup(staffTabOrGroups, defaultVerticalPos, (line, vpos) => {
       let textObj = new ObjText(anchor, textProps, 0.5, 1);
       this.addLayoutObject(textObj, line, layoutGroupId, vpos);
@@ -5224,15 +5281,16 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     let layoutGroupId;
     let defaultVerticalPos;
     switch (label) {
-      case 0 /* Note */:
+      case "note" /* Note */:
         layoutGroupId = 1 /* NoteLabel */;
         defaultVerticalPos = 1 /* Below */;
         break;
-      case 1 /* Chord */:
+      case "chord" /* Chord */:
         layoutGroupId = 6 /* ChordLabel */;
         defaultVerticalPos = 0 /* Above */;
         break;
     }
+    this.disableExtension();
     this.forEachStaffGroup(staffTabOrGroups, defaultVerticalPos, (line, vpos) => {
       let textObj = new ObjText(anchor, textProps, 0.5, 1);
       this.addLayoutObject(textObj, line, layoutGroupId, vpos);
@@ -5244,17 +5302,17 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     if (!(anchor instanceof ObjNoteGroup)) {
       throw new MusicError13(MusicErrorType13.Score, "Connective can be added to note group only.");
     }
-    if (connective === 0 /* Tie */) {
-      let tieSpan = Utils8.Is.isInteger(args[0]) || Utils8.Is.isEnumValue(args[0], TieType) ? args[0] : 2;
-      let noteAnchor = Utils8.Is.isEnumValue(args[1], NoteAnchor) ? args[1] : 0 /* Auto */;
-      anchor.startConnective(new ConnectiveProps(0 /* Tie */, tieSpan, noteAnchor, anchor));
-    } else if (connective === 1 /* Slur */) {
-      let slurSpan = Utils8.Is.isInteger(args[0]) ? args[0] : 2;
-      let noteAnchor = Utils8.Is.isEnumValue(args[1], NoteAnchor) ? args[1] : 0 /* Auto */;
-      anchor.startConnective(new ConnectiveProps(1 /* Slur */, slurSpan, noteAnchor, anchor));
-    } else if (connective === 2 /* Slide */) {
-      let noteAnchor = Utils8.Is.isEnumValue(args[0], NoteAnchor) ? args[0] : 0 /* Auto */;
-      anchor.startConnective(new ConnectiveProps(2 /* Slide */, 2, noteAnchor, anchor));
+    if (connective === "tie" /* Tie */) {
+      let tieSpan = Utils10.Is.isInteger(args[0]) || Utils10.Is.isEnumValue(args[0], TieType) ? args[0] : 2;
+      let noteAnchor = Utils10.Is.isEnumValue(args[1], NoteAnchor) ? args[1] : "auto" /* Auto */;
+      anchor.startConnective(new ConnectiveProps("tie" /* Tie */, tieSpan, noteAnchor, anchor));
+    } else if (connective === "slur" /* Slur */) {
+      let slurSpan = Utils10.Is.isInteger(args[0]) ? args[0] : 2;
+      let noteAnchor = Utils10.Is.isEnumValue(args[1], NoteAnchor) ? args[1] : "auto" /* Auto */;
+      anchor.startConnective(new ConnectiveProps("slur" /* Slur */, slurSpan, noteAnchor, anchor));
+    } else if (connective === "slide" /* Slide */) {
+      let noteAnchor = Utils10.Is.isEnumValue(args[0], NoteAnchor) ? args[0] : "auto" /* Auto */;
+      anchor.startConnective(new ConnectiveProps("slide" /* Slide */, 2, noteAnchor, anchor));
     }
   }
   addExtension(extensionLength, extensionVisible) {
@@ -5263,7 +5321,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
       if (musicObj instanceof ObjText && anchor instanceof ObjRhythmColumn) {
         let lineStyle = "dashed";
         let linePos = "bottom";
-        let extension = new Extension(musicObj, anchor, extensionLength, extensionVisible, lineStyle, linePos);
+        let extension = new Extension(musicObj, anchor, getExtensionTicks(extensionLength), extensionVisible, lineStyle, linePos);
         musicObj.setLink(extension);
       } else {
         throw new MusicError13(MusicErrorType13.Score, "Cannot add extension becaue no compatible music object to attach it to.");
@@ -5312,21 +5370,25 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     col.setVoiceSymbol(voiceId, symbol);
     this.getVoiceSymbols(voiceId);
     this.voiceSymbols[voiceId].push(symbol);
-    if (symbol.triplet) {
+    if (symbol.oldStyleTriplet) {
       this.createOldStyleTriplets(voiceId);
     }
     this.requestBeamsUpdate();
     this.lastAddedRhythmColumn = col;
     this.lastAddedRhythmSymbol = symbol;
   }
-  addNoteGroup(voiceId, notes, noteLength, options) {
-    let notes2 = notes.map((note) => typeof note === "string" ? Note7.getNote(note) : note);
+  addNoteGroup(voiceId, notes, noteLength, options, tupletRatio) {
+    let realNotes = notes.map((note) => typeof note === "string" ? Note7.getNote(note) : note);
     let col = this.getRhythmColumn(voiceId);
-    this.addRhythmSymbol(voiceId, new ObjNoteGroup(col, voiceId, notes2, noteLength, options));
+    let noteGroup = new ObjNoteGroup(col, voiceId, realNotes, noteLength, options, tupletRatio);
+    this.addRhythmSymbol(voiceId, noteGroup);
+    return noteGroup;
   }
-  addRest(voiceId, restLength, options) {
+  addRest(voiceId, restLength, options, tupletRatio) {
     let col = this.getRhythmColumn(voiceId);
-    this.addRhythmSymbol(voiceId, new ObjRest(col, voiceId, restLength, options));
+    let rest = new ObjRest(col, voiceId, restLength, options, tupletRatio);
+    this.addRhythmSymbol(voiceId, rest);
+    return rest;
   }
   /**
    * 
@@ -5468,18 +5530,13 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   requestBeamsUpdate() {
     this.needBeamsUpdate = true;
   }
+  // Create triplets by triplet property of NoteOptions/RestOptions.
   createOldStyleTriplets(voiceId) {
     let symbols = this.getVoiceSymbols(voiceId);
-    if (symbols.length <= 2) {
-      return;
-    }
     for (let i = 0; i < symbols.length; ) {
-      let s2 = symbols.slice(i, i + 2);
-      let s3 = symbols.slice(i, i + 3);
-      if (s2.length === 2 && s2.every((s) => s.triplet) && s2.every((s) => s.getBeamGroup() === void 0) && ObjBeamGroup.createTriplet(s2)) {
-        i += 2;
-      } else if (s3.length === 3 && s3.every((s) => s.triplet) && s3.every((s) => s.getBeamGroup() === void 0) && ObjBeamGroup.createTriplet(s3)) {
-        i += 3;
+      if (symbols[i].oldStyleTriplet) {
+        let n = ObjBeamGroup.createOldStyleTriplet(symbols.slice(i, i + 3));
+        i += n === 0 ? 1 : n;
       } else {
         i++;
       }
@@ -5491,11 +5548,11 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
       return;
     }
     this.beamGroups = this.beamGroups.filter((beamGroup) => {
-      if (beamGroup.getType() === 0 /* RegularBeam */) {
+      if (beamGroup.isTuplet()) {
+        return true;
+      } else {
         beamGroup.detach();
         return false;
-      } else {
-        return true;
       }
     });
     getVoiceIds().forEach((voiceId) => {
@@ -5531,7 +5588,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   static setupBeamGroup(groupSymbols) {
     let groupNotes = groupSymbols.map((s) => {
       var _a;
-      return s instanceof ObjNoteGroup && ((_a = s.getBeamGroup()) == null ? void 0 : _a.isTriplet()) !== true ? s : void 0;
+      return s instanceof ObjNoteGroup && ((_a = s.getBeamGroup()) == null ? void 0 : _a.isTuplet()) !== true ? s : void 0;
     });
     ObjNoteGroup.setBeamCounts(groupNotes);
     let beamNotes = [];
@@ -5563,36 +5620,32 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
       if (this.getConsumedTicks() === 0) {
         this.completeRests(0);
       } else {
-        getVoiceIds().forEach((voiceId2) => {
-          if (this.getConsumedTicks(voiceId2) > 0) {
-            this.completeRests(voiceId2);
-          }
-        });
+        this.completeRests(getVoiceIds().filter((id) => this.getConsumedTicks(id) > 0));
       }
       return;
-    }
-    let measureTicks = this.getMeasureTicks();
-    let consumedTicks = this.getConsumedTicks(voiceId);
-    let remainingTicks = measureTicks - consumedTicks;
-    let rests = [];
-    let noteLengthValues = Utils8.Enum.getEnumValues(NoteLength6);
-    while (remainingTicks > 0) {
-      noteLengthValues.forEach((restLength) => {
-        let restValue = new RhythmProps4(restLength, false);
-        if (restValue.canDot()) {
-          let dottedRestValue = new RhythmProps4(restLength, true);
-          while (dottedRestValue.ticks <= remainingTicks) {
-            rests.push(dottedRestValue);
-            remainingTicks -= dottedRestValue.ticks;
+    } else if (Utils10.Is.isArray(voiceId)) {
+      voiceId.forEach((id) => this.completeRests(id));
+      return;
+    } else {
+      validateVoiceId(voiceId);
+      let measureTicks = this.getMeasureTicks();
+      let consumedTicks = this.getConsumedTicks(voiceId);
+      let remainingTicks = measureTicks - consumedTicks;
+      let rests = [];
+      while (remainingTicks > 0) {
+        for (let noteSize = NoteLengthProps4.LongestNoteSize; noteSize <= NoteLengthProps4.ShortestNoteSize; noteSize *= 2) {
+          let restLength = NoteLengthProps4.create(noteSize).noteLength;
+          for (let dotCount = NoteLengthProps4.get(restLength).maxDotCount; dotCount >= 0; dotCount--) {
+            let restProps = RhythmProps4.get(restLength, dotCount);
+            while (restProps.ticks <= remainingTicks) {
+              rests.push(restProps);
+              remainingTicks -= restProps.ticks;
+            }
           }
         }
-        while (restValue.ticks <= remainingTicks) {
-          rests.push(restValue);
-          remainingTicks -= restValue.ticks;
-        }
-      });
+      }
+      rests.reverse().forEach((rest) => this.addRest(voiceId, rest.noteLength, { dotted: rest.dotCount }));
     }
-    rests.reverse().forEach((rest) => this.addRest(voiceId, rest.noteLength, { dotted: rest.dotted }));
   }
   requestLayout() {
     if (!this.needLayout) {
@@ -5685,7 +5738,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     let columnsAreaLeft = this.rect.left + this.leftSolidAreaWidth;
     let columnsAreaRight = this.rect.right - this.rightSolidAreaWidth;
     let columnsAreaWidth = columnsAreaRight - columnsAreaLeft;
-    let columnsWidth = Utils8.Math.sum(this.columns.map((col) => col.getRect().width));
+    let columnsWidth = Utils10.Math.sum(this.columns.map((col) => col.getRect().width));
     let columnScale = columnsAreaWidth / columnsWidth;
     let columnLeft = columnsAreaLeft;
     this.columns.forEach((col) => {
@@ -6025,10 +6078,12 @@ var ObjStaff = class extends ObjNotationLine4 {
       this.clefImageAsset = 0 /* TrebleClefPng */;
       this.clefLineDiatonicId = getDiatonicId("G4", staffConfig.isOctaveDown === true);
       this.middleLineDiatonicId = this.clefLineDiatonicId + 2;
-    } else {
+    } else if (staffConfig.clef === "F" /* F */) {
       this.clefImageAsset = 1 /* BassClefPng */;
       this.clefLineDiatonicId = getDiatonicId("F3", staffConfig.isOctaveDown === true);
       this.middleLineDiatonicId = this.clefLineDiatonicId - 2;
+    } else {
+      throw new MusicError15(MusicErrorType15.Score, `Invalid staffConfig.clef ${staffConfig.clef}.`);
     }
     this.topLineDiatonicId = this.middleLineDiatonicId + 4;
     this.bottomLineDiatonicId = this.middleLineDiatonicId - 4;
@@ -6164,7 +6219,7 @@ var ObjTab = class extends ObjNotationLine4 {
     __publicField(this, "tuningName");
     __publicField(this, "tuningStrings");
     __publicField(this, "mi");
-    if (Utils9.Is.isArray(tabConfig.tuning)) {
+    if (Utils11.Is.isArray(tabConfig.tuning)) {
       this.tuningName = void 0;
       this.tuningStrings = tabConfig.tuning.map((noteName) => Note8.getNote(noteName)).reverse();
     } else if (typeof tabConfig.tuning === "string") {
@@ -6619,7 +6674,7 @@ var ObjHeader = class extends MusicObject {
 };
 
 // src/score/engine/obj-document.ts
-import { Utils as Utils10 } from "@tspro/ts-utils-lib";
+import { Utils as Utils12 } from "@tspro/ts-utils-lib";
 var ObjDocument = class extends MusicObject {
   constructor() {
     super(void 0);
@@ -6640,35 +6695,35 @@ var ObjDocument = class extends MusicObject {
     return this.mi;
   }
   setScoreConfiguration(config) {
-    if (Utils10.Is.isEnumValue(config, StaffPreset)) {
+    if (Utils12.Is.isEnumValue(config, StaffPreset)) {
       switch (config) {
         default:
-        case 1 /* Treble */:
+        case "treble" /* Treble */:
           this.curScoreConfig = [{ type: "staff", clef: "G" /* G */ }];
           break;
-        case 2 /* Bass */:
+        case "bass" /* Bass */:
           this.curScoreConfig = [{ type: "staff", clef: "F" /* F */ }];
           break;
-        case 3 /* Grand */:
+        case "grand" /* Grand */:
           this.curScoreConfig = [
             { type: "staff", clef: "G" /* G */, isGrand: true },
             { type: "staff", clef: "F" /* F */, isGrand: true }
           ];
           break;
-        case 4 /* GuitarTreble */:
+        case "guitarTreble" /* GuitarTreble */:
           this.curScoreConfig = [{ type: "staff", clef: "G" /* G */, isOctaveDown: true }];
           break;
-        case 8 /* GuitarTab */:
+        case "guitarTab" /* GuitarTab */:
           this.curScoreConfig = [{ type: "tab", tuning: "Standard" }];
           break;
-        case 12 /* GuitarCombined */:
+        case "guitarCombined" /* GuitarCombined */:
           this.curScoreConfig = [
             { type: "staff", clef: "G" /* G */, isOctaveDown: true },
             { type: "tab", tuning: "Standard" }
           ];
           break;
       }
-    } else if (Utils10.Is.isArray(config)) {
+    } else if (Utils12.Is.isArray(config)) {
       this.curScoreConfig = config;
     } else {
       this.curScoreConfig = [config];
@@ -6894,7 +6949,7 @@ var ObjDocument = class extends MusicObject {
 };
 
 // src/score/pub/document-builder.ts
-import { KeySignature as KeySignature3, Note as Note10, NoteLength as NoteLength7, Scale as Scale2, ScaleType, SymbolSet as SymbolSet2, TimeSignature as TimeSignature2, TuningNameList } from "@tspro/web-music-score/theory";
+import { KeySignature as KeySignature3, Note as Note10, NoteLength as NoteLength7, RhythmProps as RhythmProps5, Scale as Scale2, ScaleType, SymbolSet as SymbolSet2, TimeSignature as TimeSignature2, TuningNameList, validateNoteLength as validateNoteLength2, validateTupletRatio } from "@tspro/web-music-score/theory";
 import { MusicError as MusicError17, MusicErrorType as MusicErrorType17 } from "@tspro/web-music-score/core";
 function assertArg(condition, argName, argValue) {
   if (!condition) {
@@ -6910,180 +6965,318 @@ function isNote(note) {
   }
 }
 function isVoiceId(value) {
-  return Utils11.Is.isNumber(value) && getVoiceIds().indexOf(value) >= 0;
+  return Utils13.Is.isNumber(value) && getVoiceIds().indexOf(value) >= 0;
 }
 function isStringNumber(value) {
-  return Utils11.Is.isNumber(value) && getStringNumbers().indexOf(value) >= 0;
+  return Utils13.Is.isNumber(value) && getStringNumbers().indexOf(value) >= 0;
 }
 function assertStaffConfig(staffConfig) {
-  assertArg(Utils11.Is.isObject(staffConfig), "staffConfig", staffConfig);
+  assertArg(Utils13.Is.isObject(staffConfig), "staffConfig", staffConfig);
   assertArg(staffConfig.type === "staff", "staffConfig.type", staffConfig.type);
-  assertArg(Utils11.Is.isEnumValue(staffConfig.clef, Clef), "staffConfig.clef", staffConfig.clef);
-  assertArg(Utils11.Is.isBooleanOrUndefined(staffConfig.isOctaveDown), "staffConfig.isOctaveDown", staffConfig.isOctaveDown);
-  assertArg(Utils11.Is.isUndefined(staffConfig.minNote) || isNote(staffConfig.minNote), "staffConfig.minNote", staffConfig.minNote);
-  assertArg(Utils11.Is.isUndefined(staffConfig.maxNote) || isNote(staffConfig.maxNote), "staffConfig.maxNote", staffConfig.maxNote);
-  assertArg(Utils11.Is.isUndefined(staffConfig.voiceIds) || Utils11.Is.isArray(staffConfig.voiceIds) && staffConfig.voiceIds.every((voiceId) => Utils11.Is.isNumber(voiceId)), "staffConfig.voiceIds", staffConfig.voiceIds);
-  assertArg(Utils11.Is.isBooleanOrUndefined(staffConfig.isGrand), "staffConfig.isGrand", staffConfig.isGrand);
+  assertArg(Utils13.Is.isEnumValue(staffConfig.clef, Clef), "staffConfig.clef", staffConfig.clef);
+  assertArg(Utils13.Is.isBooleanOrUndefined(staffConfig.isOctaveDown), "staffConfig.isOctaveDown", staffConfig.isOctaveDown);
+  assertArg(Utils13.Is.isUndefined(staffConfig.minNote) || isNote(staffConfig.minNote), "staffConfig.minNote", staffConfig.minNote);
+  assertArg(Utils13.Is.isUndefined(staffConfig.maxNote) || isNote(staffConfig.maxNote), "staffConfig.maxNote", staffConfig.maxNote);
+  assertArg(Utils13.Is.isUndefined(staffConfig.voiceIds) || Utils13.Is.isArray(staffConfig.voiceIds) && staffConfig.voiceIds.every((voiceId) => Utils13.Is.isNumber(voiceId)), "staffConfig.voiceIds", staffConfig.voiceIds);
+  assertArg(Utils13.Is.isBooleanOrUndefined(staffConfig.isGrand), "staffConfig.isGrand", staffConfig.isGrand);
 }
 function assertTabConfig(tabConfig) {
-  assertArg(Utils11.Is.isObject(tabConfig), "tabConfig", tabConfig);
+  assertArg(Utils13.Is.isObject(tabConfig), "tabConfig", tabConfig);
   assertArg(tabConfig.type === "tab", "tabConfig.type", tabConfig.type);
   if (typeof tabConfig.tuning === "string") {
     assertArg(TuningNameList.includes(tabConfig.tuning), "tabConfig.tuning", tabConfig.tuning);
-  } else if (Utils11.Is.isArray(tabConfig.tuning)) {
-    assertArg(tabConfig.tuning.length === 6 && tabConfig.tuning.every((s) => isNote(s)), "tabConfig.tuning", tabConfig.tuning);
+  } else if (Utils13.Is.isArray(tabConfig.tuning)) {
+    assertArg(tabConfig.tuning.length === getStringNumbers().length && tabConfig.tuning.every((s) => isNote(s)), "tabConfig.tuning", tabConfig.tuning);
   }
-  assertArg(Utils11.Is.isUndefined(tabConfig.voiceIds) || Utils11.Is.isArray(tabConfig.voiceIds) && tabConfig.voiceIds.every((voiceId) => Utils11.Is.isNumber(voiceId)), "tabConfig.voiceIds", tabConfig.voiceIds);
+  assertArg(Utils13.Is.isUndefined(tabConfig.voiceIds) || Utils13.Is.isArray(tabConfig.voiceIds) && tabConfig.voiceIds.every((voiceId) => Utils13.Is.isNumber(voiceId)), "tabConfig.voiceIds", tabConfig.voiceIds);
 }
 function assertNoteOptions(options) {
-  assertArg(Utils11.Is.isObject(options), "noteOptions", options);
-  assertArg(Utils11.Is.isBooleanOrUndefined(options.dotted), "noteOptions.dotted", options.dotted);
-  assertArg(Utils11.Is.isEnumValueOrUndefined(options.stem, Stem), "noteOptions.stem", options.stem);
-  assertArg(Utils11.Is.isStringOrUndefined(options.color), "noteOptions.color", options.color);
-  assertArg(Utils11.Is.isBooleanOrUndefined(options.arpeggio) || Utils11.Is.isEnumValue(options.arpeggio, Arpeggio), "noteOptions.arpeggio", options.arpeggio);
-  assertArg(Utils11.Is.isBooleanOrUndefined(options.staccato), "noteOptions.staccato", options.staccato);
-  assertArg(Utils11.Is.isBooleanOrUndefined(options.diamond), "noteOptions.diamond", options.diamond);
-  assertArg(Utils11.Is.isBooleanOrUndefined(options.triplet), "noteOptions.triplet", options.triplet);
-  assertArg(Utils11.Is.isUndefined(options.string) || isStringNumber(options.string) || Utils11.Is.isArray(options.string) && options.string.length > 0 && options.string.every((string) => isStringNumber(string)), "noteOptions.string", options.string);
+  assertArg(Utils13.Is.isObject(options), "noteOptions", options);
+  assertArg(Utils13.Is.isBooleanOrUndefined(options.dotted) || Utils13.Is.isIntegerGte(options.dotted, 0), "noteOptions.dotted", options.dotted);
+  assertArg(Utils13.Is.isEnumValueOrUndefined(options.stem, Stem), "noteOptions.stem", options.stem);
+  assertArg(Utils13.Is.isStringOrUndefined(options.color), "noteOptions.color", options.color);
+  assertArg(Utils13.Is.isBooleanOrUndefined(options.arpeggio) || Utils13.Is.isEnumValue(options.arpeggio, Arpeggio), "noteOptions.arpeggio", options.arpeggio);
+  assertArg(Utils13.Is.isBooleanOrUndefined(options.staccato), "noteOptions.staccato", options.staccato);
+  assertArg(Utils13.Is.isBooleanOrUndefined(options.diamond), "noteOptions.diamond", options.diamond);
+  assertArg(Utils13.Is.isBooleanOrUndefined(options.triplet), "noteOptions.triplet", options.triplet);
+  assertArg(Utils13.Is.isUndefined(options.string) || isStringNumber(options.string) || Utils13.Is.isNonEmptyArray(options.string) && options.string.every((string) => isStringNumber(string)), "noteOptions.string", options.string);
+  assertArg(Utils13.Is.isUndefined(options.tieSpan), 'NoteOptions.tieSpan was removed. Use addConnective("tie", tieSpan)', "");
+  assertArg(Utils13.Is.isUndefined(options.slurSpan), 'NoteOptions.slurSpan was removed. Use addConnective("slur", slurSpan)', "");
 }
 function assertRestOptions(options) {
-  assertArg(Utils11.Is.isObject(options), "restOptions", options);
-  assertArg(Utils11.Is.isBooleanOrUndefined(options.dotted), "restOptions.dotted", options.dotted);
-  assertArg(Utils11.Is.isStringOrUndefined(options.staffPos) || Utils11.Is.isInteger(options.staffPos) || options.staffPos instanceof Note10, "restOptions.staffPos", options.staffPos);
-  assertArg(Utils11.Is.isStringOrUndefined(options.color), "restOptions.color", options.color);
-  assertArg(Utils11.Is.isBooleanOrUndefined(options.hide), "restOptions.hide", options.hide);
-  assertArg(Utils11.Is.isBooleanOrUndefined(options.triplet), "restOptions.triplet", options.triplet);
+  assertArg(Utils13.Is.isObject(options), "restOptions", options);
+  assertArg(Utils13.Is.isBooleanOrUndefined(options.dotted) || Utils13.Is.isIntegerGte(options.dotted, 0), "restOptions.dotted", options.dotted);
+  assertArg(Utils13.Is.isStringOrUndefined(options.staffPos) || Utils13.Is.isInteger(options.staffPos) || options.staffPos instanceof Note10, "restOptions.staffPos", options.staffPos);
+  assertArg(Utils13.Is.isStringOrUndefined(options.color), "restOptions.color", options.color);
+  assertArg(Utils13.Is.isBooleanOrUndefined(options.hide), "restOptions.hide", options.hide);
+  assertArg(Utils13.Is.isBooleanOrUndefined(options.triplet), "restOptions.triplet", options.triplet);
 }
 function assertStaffTabOrGRoups(staffTabOrGroups) {
   assertArg(
-    Utils11.Is.isStringOrUndefined(staffTabOrGroups) || Utils11.Is.isIntegerGte(staffTabOrGroups, 0) || Utils11.Is.isArray(staffTabOrGroups) && staffTabOrGroups.every(
-      (staffTabOrGroup) => Utils11.Is.isString(staffTabOrGroup) || Utils11.Is.isIntegerGte(staffTabOrGroup, 0)
+    Utils13.Is.isStringOrUndefined(staffTabOrGroups) || Utils13.Is.isIntegerGte(staffTabOrGroups, 0) || Utils13.Is.isNonEmptyArray(staffTabOrGroups) && staffTabOrGroups.every(
+      (staffTabOrGroup) => Utils13.Is.isString(staffTabOrGroup) || Utils13.Is.isIntegerGte(staffTabOrGroup, 0)
     ),
     "staffTabOrGroup",
     staffTabOrGroups
   );
 }
+function isNoteLength(noteLen) {
+  try {
+    validateNoteLength2(noteLen);
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+function isTupletRatio(tupletRatio) {
+  try {
+    validateTupletRatio(tupletRatio);
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
 var DocumentBuilder = class {
+  /**
+   * Create new document builder instance.
+   */
   constructor() {
     __publicField(this, "doc");
     this.doc = new ObjDocument();
   }
   setScoreConfiguration(config) {
-    if (Utils11.Is.isEnumValue(config, StaffPreset)) {
-    } else if (Utils11.Is.isObject(config) && config.type === "staff") {
+    if (Utils13.Is.isEnumValue(config, StaffPreset)) {
+      this.doc.setScoreConfiguration(config);
+    } else if (Utils13.Is.isObject(config) && config.type === "staff") {
       assertStaffConfig(config);
-    } else if (Utils11.Is.isObject(config) && config.type === "tab") {
+      this.doc.setScoreConfiguration(config);
+    } else if (Utils13.Is.isObject(config) && config.type === "tab") {
       assertTabConfig(config);
-    } else if (Utils11.Is.isArray(config)) {
-      assertArg(config.length > 0, "config", config);
+      this.doc.setScoreConfiguration(config);
+    } else if (Utils13.Is.isNonEmptyArray(config)) {
       config.forEach((c) => {
-        if (Utils11.Is.isObject(c) && c.type === "staff") {
+        if (Utils13.Is.isObject(c) && c.type === "staff") {
           assertStaffConfig(c);
-        } else if (Utils11.Is.isObject(c) && c.type === "tab") {
+        } else if (Utils13.Is.isObject(c) && c.type === "tab") {
           assertTabConfig(c);
         } else {
           assertArg(false, "config", config);
         }
       });
+      this.doc.setScoreConfiguration(config);
     } else {
       assertArg(false, "config", config);
     }
-    this.doc.setScoreConfiguration(config);
     return this;
   }
   getMeasure() {
     var _a;
     return (_a = this.doc.getLastMeasure()) != null ? _a : this.doc.addMeasure();
   }
+  /**
+   * Get music document after finished building.
+   * @returns - Music document.
+   */
   getDocument() {
     return this.doc.getMusicInterface();
   }
+  /**
+   * Set header texts.
+   * @param title - Title of this docmument/musical piece.
+   * @param composer - Composer of this document/musical piece.
+   * @param arranger - Arranger of this document/musical piece.
+   * @returns - This document builder instance.
+   */
   setHeader(title, composer, arranger) {
-    assertArg(Utils11.Is.isStringOrUndefined(title), "title", title);
-    assertArg(Utils11.Is.isStringOrUndefined(composer), "composer", composer);
-    assertArg(Utils11.Is.isStringOrUndefined(arranger), "arranger", arranger);
+    assertArg(Utils13.Is.isStringOrUndefined(title), "title", title);
+    assertArg(Utils13.Is.isStringOrUndefined(composer), "composer", composer);
+    assertArg(Utils13.Is.isStringOrUndefined(arranger), "arranger", arranger);
     this.doc.setHeader(title, composer, arranger);
     return this;
   }
+  /**
+   * Automatically limit number of measures per score row.
+   * @param measuresPerRow - Number of measures per row. Must be integer >=1 or Infinity.
+   * @returns - This document builder instance.
+   */
   setMeasuresPerRow(measuresPerRow) {
-    assertArg(Utils11.Is.isIntegerGte(measuresPerRow, 1) || measuresPerRow === Infinity, "measuresPerRow", measuresPerRow);
+    assertArg(Utils13.Is.isIntegerGte(measuresPerRow, 1) || Utils13.Is.isPosInfinity(measuresPerRow), "measuresPerRow", measuresPerRow);
     this.doc.setMeasuresPerRow(measuresPerRow);
     return this;
   }
+  /**
+   * Add new measure.
+   * @returns - This document builder instance.
+   */
   addMeasure() {
     this.doc.addMeasure();
     return this;
   }
   setKeySignature(...args) {
-    assertArg(args[0] instanceof Scale2 || args[0] instanceof KeySignature3 || Utils11.Is.isString(args[0]) && Utils11.Is.isEnumValue(args[1], ScaleType), "keySignature", args);
+    assertArg(args[0] instanceof Scale2 || args[0] instanceof KeySignature3 || Utils13.Is.isNonEmptyString(args[0]) && (args.length === 1 || Utils13.Is.isEnumValue(args[1], ScaleType)), "keySignature", args);
     this.getMeasure().setKeySignature(...args);
     return this;
   }
+  /**
+   * Set time signature for current measure and forward.
+   * @param timeSignature - TimeSignature  object instance or string (e.g. "3/4").
+   * @returns - This document builder instance.
+   */
   setTimeSignature(timeSignature) {
-    assertArg(timeSignature instanceof TimeSignature2 || Utils11.Is.isString(timeSignature), "timeSignature", timeSignature);
+    assertArg(timeSignature instanceof TimeSignature2 || Utils13.Is.isNonEmptyString(timeSignature), "timeSignature", timeSignature);
     this.getMeasure().setTimeSignature(timeSignature);
     return this;
   }
   setTempo(beatsPerMinute, beatLength, dotted) {
-    assertArg(Utils11.Is.isIntegerGte(beatsPerMinute, 1), "beatsPerMinute", beatsPerMinute);
+    assertArg(Utils13.Is.isIntegerGte(beatsPerMinute, 1), "beatsPerMinute", beatsPerMinute);
     if (beatLength === void 0) {
-      assertArg(Utils11.Is.isUndefined(dotted), "dotted", dotted);
+      assertArg(Utils13.Is.isUndefined(dotted), "dotted", dotted);
     } else {
-      assertArg(Utils11.Is.isEnumValue(beatLength, NoteLength7), "beatLength", beatLength);
-      assertArg(Utils11.Is.isBooleanOrUndefined(dotted), "dotted", dotted);
+      assertArg(Utils13.Is.isEnumValue(beatLength, NoteLength7) || isNoteLength(beatLength), "beatLength", beatLength);
+      assertArg(Utils13.Is.isBooleanOrUndefined(dotted) || Utils13.Is.isIntegerGte(dotted, 0), "dotted", dotted);
     }
     this.getMeasure().setTempo(beatsPerMinute, beatLength, dotted);
     return this;
   }
+  /**
+   * Add note o current measure.
+   * @param voiceId - Voice id to add note to.
+   * @param note - Note instance of Note or string (e.g. "D4").
+   * @param noteLength - Note length (e.g. "4n").
+   * @param options - Note options.
+   * @returns - This document builder instance.
+   */
   addNote(voiceId, note, noteLength, options) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
-    assertArg(note instanceof Note10 || Utils11.Is.isString(note), "note", note);
-    assertArg(Utils11.Is.isEnumValue(noteLength, NoteLength7), "noteLength", noteLength);
+    assertArg(note instanceof Note10 || Utils13.Is.isNonEmptyString(note), "note", note);
+    assertArg(Utils13.Is.isEnumValue(noteLength, NoteLength7) || isNoteLength(noteLength), "noteLength", noteLength);
     if (options !== void 0) {
       assertNoteOptions(options);
     }
     this.getMeasure().addNoteGroup(voiceId, [note], noteLength, options);
     return this;
   }
+  /**
+   * @param voiceId - Voice id to add chord to.
+   * @param notes - Array of notes, each instance of Note or string (e.g. "D4"). 
+   * @param noteLength - Note length (e.g. "4n"). 
+   * @param options - Note options. 
+   * @returns - This document builder instance.
+   */
   addChord(voiceId, notes, noteLength, options) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
-    assertArg(Utils11.Is.isArray(notes) && notes.length >= 1 && notes.every((note) => note instanceof Note10 || Utils11.Is.isString(note)), "notes", notes);
-    assertArg(Utils11.Is.isEnumValue(noteLength, NoteLength7), "noteLength", noteLength);
+    assertArg(Utils13.Is.isNonEmptyArray(notes) && notes.every((note) => note instanceof Note10 || Utils13.Is.isNonEmptyString(note)), "notes", notes);
+    assertArg(Utils13.Is.isEnumValue(noteLength, NoteLength7) || isNoteLength(noteLength), "noteLength", noteLength);
     if (options !== void 0) {
       assertNoteOptions(options);
     }
     this.getMeasure().addNoteGroup(voiceId, notes, noteLength, options);
     return this;
   }
+  /**
+   * 
+   * @param voiceId - Voice id to add rest to.
+   * @param restLength - Rest length (e.g. "4n").  
+   * @param options - Rest options.
+   * @returns - This document builder instance.
+   */
   addRest(voiceId, restLength, options) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
-    assertArg(Utils11.Is.isEnumValue(restLength, NoteLength7), "restLength", restLength);
+    assertArg(Utils13.Is.isEnumValue(restLength, NoteLength7) || isNoteLength(restLength), "restLength", restLength);
     if (options !== void 0) {
       assertRestOptions(options);
     }
     this.getMeasure().addRest(voiceId, restLength, options);
     return this;
   }
+  /**
+   * Usage:
+   * <pre>
+   * addTuplet(0, Theory.Tuplet.Triplet, notes => {
+   *     notes.addNote("G3", Theory.NoteLength.Eighth);
+   *     notes.addNote("B3", Theory.NoteLength.Eighth);
+   *     notes.addNote("D4", Theory.NoteLength.Eighth);
+   * });
+   * </pre>
+   * 
+   * @param voiceId - Voice id to add tuplet to.
+   * @param tupletRatio - You can also use Theory.Tuplet presets (e.g. Theory.Tuplet.Triplet).
+   * @param tupletBuilder - Tuplet builder function to build tuplet.
+   * @returns - This document builder instance.
+   */
+  addTuplet(voiceId, tupletRatio, tupletBuilder) {
+    assertArg(isVoiceId(voiceId), "voiceId", voiceId);
+    assertArg(Utils13.Is.isFunction(tupletBuilder), "tupletBuilder", tupletBuilder);
+    assertArg(isTupletRatio(tupletRatio) && Utils13.Is.isBooleanOrUndefined(tupletRatio.showRatio), "tupletRatio", tupletRatio);
+    let tupletSymbols = [];
+    const helper = {
+      addNote: (note, noteLength, options) => {
+        assertArg(note instanceof Note10 || Utils13.Is.isNonEmptyString(note), "note", note);
+        assertArg(Utils13.Is.isEnumValue(noteLength, NoteLength7) || isNoteLength(noteLength), "noteLength", noteLength);
+        if (options !== void 0) {
+          delete options.triplet;
+          assertNoteOptions(options);
+        }
+        let s = this.getMeasure().addNoteGroup(voiceId, [note], noteLength, options, tupletRatio);
+        tupletSymbols.push(s);
+        return helper;
+      },
+      addChord: (notes, noteLength, options) => {
+        assertArg(Utils13.Is.isNonEmptyArray(notes) && notes.every((note) => note instanceof Note10 || Utils13.Is.isNonEmptyString(note)), "notes", notes);
+        assertArg(Utils13.Is.isEnumValue(noteLength, NoteLength7) || isNoteLength(noteLength), "noteLength", noteLength);
+        if (options !== void 0) {
+          delete options.triplet;
+          assertNoteOptions(options);
+        }
+        let s = this.getMeasure().addNoteGroup(voiceId, notes, noteLength, options, tupletRatio);
+        tupletSymbols.push(s);
+        return helper;
+      },
+      addRest: (restLength, options) => {
+        assertArg(Utils13.Is.isEnumValue(restLength, NoteLength7) || isNoteLength(restLength), "restLength", restLength);
+        if (options !== void 0) {
+          delete options.triplet;
+          assertRestOptions(options);
+        }
+        let s = this.getMeasure().addRest(voiceId, restLength, options, tupletRatio);
+        tupletSymbols.push(s);
+        return helper;
+      }
+    };
+    tupletBuilder(helper);
+    ObjBeamGroup.createTuplet(tupletSymbols, tupletRatio);
+    return this;
+  }
   addFermataInternal(staffTabOrGroups, fermata) {
     assertStaffTabOrGRoups(staffTabOrGroups);
-    assertArg(Utils11.Is.isEnumValue(fermata, Fermata), "fermata", fermata);
+    assertArg(Utils13.Is.isEnumValue(fermata, Fermata), "fermata", fermata);
     this.getMeasure().addFermata(staffTabOrGroups, fermata);
     return this;
   }
-  addFermata(fermata = 0 /* AtNote */) {
+  /**
+   * Add fermata to current measure.
+   * @param fermata - Fermata type (e.g. "atNote" or Fermata.AtrNote).
+   * @returns - This document builder instance.
+   */
+  addFermata(fermata = "atNote" /* AtNote */) {
     return this.addFermataInternal(void 0, fermata);
   }
-  /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-  addFermataTo(staffTabOrGroups, fermata = 0 /* AtNote */) {
+  /**
+   * Add Fermata to current measure to given staff/tab/group.
+   * @param staffTabOrGroups - staff/tab index (0=top), staff/tab name, or staff group name.
+   * @param fermata - Fermata type (e.g. "atNote" or Fermata.AtrNote).
+   * @returns - This document builder instance.
+   */
+  addFermataTo(staffTabOrGroups, fermata = "atNote" /* AtNote */) {
     return this.addFermataInternal(staffTabOrGroups, fermata);
   }
   addNavigationInternal(staffTabOrGroups, navigation, ...args) {
     assertStaffTabOrGRoups(staffTabOrGroups);
-    assertArg(Utils11.Is.isEnumValue(navigation, Navigation), "navigation", navigation);
-    if (navigation === 9 /* EndRepeat */ && args.length > 0) {
-      assertArg(Utils11.Is.isIntegerGte(args[0], 1), "playCount", args[0]);
-    } else if (navigation === 10 /* Ending */ && args.length > 0) {
-      assertArg(args.every((passage) => Utils11.Is.isIntegerGte(passage, 1)), "passages", args);
+    assertArg(Utils13.Is.isEnumValue(navigation, Navigation), "navigation", navigation);
+    if (navigation === "endRepeat" /* EndRepeat */ && args.length > 0) {
+      assertArg(Utils13.Is.isIntegerGte(args[0], 1), "playCount", args[0]);
+    } else if (navigation === "ending" /* Ending */ && args.length > 0) {
+      assertArg(args.every((passage) => Utils13.Is.isIntegerGte(passage, 1)), "passages", args);
     }
     this.getMeasure().addNavigation(staffTabOrGroups, navigation, ...args);
     return this;
@@ -7094,100 +7287,186 @@ var DocumentBuilder = class {
   addNavigationTo(staffTabOrGroups, navigation, ...args) {
     return this.addNavigationInternal(staffTabOrGroups, navigation, ...args);
   }
+  addAnnotationInternal(staffTabOrGroups, annotation, text) {
+    annotation != null ? annotation : annotation = getAnnotation(text);
+    if (annotation === void 0) {
+      throw new MusicError17(MusicErrorType17.Score, `Annotation text "${text}" is not known annotation.`);
+    }
+    assertStaffTabOrGRoups(staffTabOrGroups);
+    assertArg(Utils13.Is.isEnumValue(annotation, Annotation), "annotation", annotation);
+    assertArg(Utils13.Is.isNonEmptyString(text), "text", text);
+    this.getMeasure().addAnnotation(staffTabOrGroups, annotation, text);
+    return this;
+  }
+  addAnnotation(...args) {
+    if (args.length === 1) {
+      return this.addAnnotationInternal(void 0, void 0, args[0]);
+    } else {
+      return this.addAnnotationInternal(void 0, args[0], args[1]);
+    }
+  }
+  addAnnotationTo(staffTabOrGroups, ...args) {
+    if (args.length === 1) {
+      return this.addAnnotationInternal(staffTabOrGroups, void 0, args[0]);
+    } else {
+      return this.addAnnotationInternal(staffTabOrGroups, args[0], args[1]);
+    }
+  }
   addLabelInternal(staffTabOrGroups, label, text) {
     assertStaffTabOrGRoups(staffTabOrGroups);
-    assertArg(Utils11.Is.isEnumValue(label, Label), "label", label);
-    assertArg(Utils11.Is.isString(text), "text", text);
+    assertArg(Utils13.Is.isEnumValue(label, Label), "label", label);
+    assertArg(Utils13.Is.isNonEmptyString(text), "text", text);
     this.getMeasure().addLabel(staffTabOrGroups, label, text);
     return this;
   }
+  /**
+   * Add label text to column of last added note/chord/rest in current measure.
+   * @param label - Label type (e.g. "chord" or Label.Chord).
+   * @param text - label text (e.g. "Am").
+   * @returns - This document builder instance.
+   */
   addLabel(label, text) {
     return this.addLabelInternal(void 0, label, text);
   }
-  /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
+  /**
+   * Add label text to column of last added note/chord/rest in current measure to given staff/tab/group.
+   * @param staffTabOrGroups - staff/tab index (0=top), staff/tab name, or staff group name.
+   * @param label - Label type (e.g. "chord" or Label.Chord).
+   * @param text - label text (e.g. "Am").
+   * @returns - This document builder instance.
+   */
   addLabelTo(staffTabOrGroups, label, text) {
     return this.addLabelInternal(staffTabOrGroups, label, text);
   }
-  addAnnotationInternal(staffTabOrGroups, annotation, text) {
-    assertStaffTabOrGRoups(staffTabOrGroups);
-    assertArg(Utils11.Is.isEnumValue(annotation, Annotation), "annotation", annotation);
-    assertArg(Utils11.Is.isString(text), "text", text);
-    this.getMeasure().addAnnotation(staffTabOrGroups, annotation, text);
-    return this;
-  }
-  addAnnotation(annotation, text) {
-    return this.addAnnotationInternal(void 0, annotation, text);
-  }
-  /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
-  addAnnotationTo(staffTabOrGroups, annotation, text) {
-    return this.addAnnotationInternal(staffTabOrGroups, annotation, text);
-  }
   addConnective(connective, ...args) {
-    assertArg(Utils11.Is.isEnumValue(connective, Connective), "connective", connective);
-    if (connective === 0 /* Tie */) {
-      assertArg(Utils11.Is.isUndefined(args[0]) || Utils11.Is.isInteger(args[0]) || Utils11.Is.isEnumValue(args[0], TieType), "tieSpan", args[0]);
-      assertArg(Utils11.Is.isEnumValueOrUndefined(args[1], NoteAnchor), "noteAnchor", args[1]);
+    assertArg(Utils13.Is.isEnumValue(connective, Connective), "connective", connective);
+    if (connective === "tie" /* Tie */) {
+      assertArg(Utils13.Is.isIntegerOrUndefined(args[0]) || Utils13.Is.isEnumValue(args[0], TieType), "tieSpan", args[0]);
+      assertArg(Utils13.Is.isEnumValueOrUndefined(args[1], NoteAnchor), "noteAnchor", args[1]);
       let tieSpan = args[0];
       let noteAnchor = args[1];
       this.getMeasure().addConnective(connective, tieSpan, noteAnchor);
-    } else if (connective === 1 /* Slur */) {
-      assertArg(Utils11.Is.isUndefined(args[0]) || Utils11.Is.isInteger(args[0]), "slurSpan", args[0]);
-      assertArg(Utils11.Is.isEnumValueOrUndefined(args[1], NoteAnchor), "noteAnchor", args[1]);
+    } else if (connective === "slur" /* Slur */) {
+      assertArg(Utils13.Is.isIntegerOrUndefined(args[0]), "slurSpan", args[0]);
+      assertArg(Utils13.Is.isEnumValueOrUndefined(args[1], NoteAnchor), "noteAnchor", args[1]);
       let slurSpan = args[0];
       let noteAnchor = args[1];
       this.getMeasure().addConnective(connective, slurSpan, noteAnchor);
-    } else if (connective === 2 /* Slide */) {
-      assertArg(Utils11.Is.isEnumValueOrUndefined(args[0], NoteAnchor), "noteAnchor", args[0]);
+    } else if (connective === "slide" /* Slide */) {
+      assertArg(Utils13.Is.isEnumValueOrUndefined(args[0], NoteAnchor), "noteAnchor", args[0]);
       let noteAnchor = args[0];
       this.getMeasure().addConnective(connective, noteAnchor);
     }
     return this;
   }
-  addExtension(extensionLength, extensionVisible) {
-    assertArg(Utils11.Is.isIntegerGte(extensionLength, 0) || extensionLength === Infinity || Utils11.Is.isEnumValue(extensionLength, NoteLength7), "extendionLength", extensionLength);
-    assertArg(Utils11.Is.isBooleanOrUndefined(extensionVisible), "extensionVisible", extensionVisible);
-    this.getMeasure().addExtension(extensionLength, extensionVisible != null ? extensionVisible : true);
+  /**
+   * Add extension line to previously added annotation or label element.
+   * <pre>
+   *     // Example
+   *     addExtension(ext => ext.notes("1n", 2))          // length is 2 whole notes
+   *     addExtension(ext => ext.measures(3).hide())      // length is 3 measures, hidden
+   *     addExtension(ext => ext.measures(1).notes("8n")) // length is 1 measure + 1 eigth note
+   *     addExtension(ext => ext.infinity())              // length is as long as possible
+   * </pre>
+   * @param extensionBuilder - Extension builder function used to build exstension.
+   * @returns - This document builder instance.
+   */
+  addExtension(extensionBuilder) {
+    assertArg(Utils13.Is.isFunctionOrUndefined(extensionBuilder), "addExtension() has new usage, for e.g. addExtension(ext => ext.measures(2)). Please refer to README or API Reference.", extensionBuilder);
+    let ticks = 0;
+    let visible = true;
+    const helper = {
+      notes: (noteLength, noteCount) => {
+        assertArg(Utils13.Is.isEnumValue(noteLength, NoteLength7) || isNoteLength(noteLength), "noteLength", noteLength);
+        assertArg(Utils13.Is.isUndefined(noteCount) || Utils13.Is.isNumber(noteCount) && noteCount >= 0, "noteCount", noteCount);
+        ticks += RhythmProps5.get(noteLength).ticks * (noteCount != null ? noteCount : 1);
+        return helper;
+      },
+      measures: (measureCount) => {
+        assertArg(Utils13.Is.isNumber(measureCount) && measureCount >= 1, "measureCount", measureCount);
+        ticks += this.getMeasure().getMeasureTicks() * measureCount;
+        return helper;
+      },
+      infinity: () => {
+        ticks = Infinity;
+        return helper;
+      },
+      hide: () => {
+        visible = false;
+        return helper;
+      }
+    };
+    if (extensionBuilder) {
+      extensionBuilder(helper);
+    } else {
+      ticks = Infinity;
+    }
+    this.getMeasure().addExtension(ticks, visible);
     return this;
   }
   /**
-   * 
+   * Add staff group.
    * @param groupName - Name of staff group.
    * @param staffsTabsAndGroups - staff/tab index (0=top), staff/tab name, or staff group name. Single value or array.
    * @param verticalPosition - Vertical position, are elements added above, below or both.
-   * @returns 
+   * @returns - This document builder instance.
    */
-  addStaffGroup(groupName, staffsTabsAndGroups, verticalPosition = 3 /* Auto */) {
-    assertArg(Utils11.Is.isString(groupName) && groupName.length > 0, "groupName", groupName);
+  addStaffGroup(groupName, staffsTabsAndGroups, verticalPosition = "auto" /* Auto */) {
+    assertArg(Utils13.Is.isNonEmptyString(groupName), "groupName", groupName);
     assertArg(
-      Utils11.Is.isString(staffsTabsAndGroups) && staffsTabsAndGroups.length > 0 || Utils11.Is.isIntegerGte(staffsTabsAndGroups, 0) || Utils11.Is.isArray(staffsTabsAndGroups) && staffsTabsAndGroups.every((line) => Utils11.Is.isString(line) && line.length > 0 || Utils11.Is.isIntegerGte(line, 0)),
+      Utils13.Is.isNonEmptyString(staffsTabsAndGroups) || Utils13.Is.isIntegerGte(staffsTabsAndGroups, 0) || Utils13.Is.isNonEmptyArray(staffsTabsAndGroups) && staffsTabsAndGroups.every((line) => Utils13.Is.isNonEmptyString(line) || Utils13.Is.isIntegerGte(line, 0)),
       "staffsTabsAndGroups",
       staffsTabsAndGroups
     );
-    assertArg(Utils11.Is.isEnumValue(verticalPosition, VerticalPosition), "verticalPosition", verticalPosition);
+    assertArg(Utils13.Is.isEnumValue(verticalPosition, VerticalPosition), "verticalPosition", verticalPosition);
     this.doc.addStaffGroup(groupName, staffsTabsAndGroups, verticalPosition);
     return this;
   }
+  /**
+   * Add song end. Adds certain bar line at the end of measure.
+   * @returns - This document builder instance.
+   */
   endSong() {
     this.getMeasure().endSong();
     return this;
   }
+  /**
+   * Add section end. Adds certain bar line at the end of measure.
+   * @returns - This document builder instance.
+   */
   endSection() {
     this.getMeasure().endSection();
     return this;
   }
+  /**
+   * End current score row. Next measure will start new row.
+   * @returns - This document builder instance.
+   */
   endRow() {
     var _a;
     (_a = this.doc.getLastMeasure()) == null ? void 0 : _a.endRow();
     return this;
   }
+  /**
+   * Add rests to fill current measure.
+   * @param voiceId - Voice id to add rests to. Single value, array or all if omitted.
+   * @returns - This document builder instance.
+   */
   completeRests(voiceId) {
-    assertArg(Utils11.Is.isUndefined(voiceId) || isVoiceId(voiceId), "voiceId", voiceId);
+    assertArg(Utils13.Is.isUndefined(voiceId) || isVoiceId(voiceId) || Utils13.Is.isArray(voiceId) && voiceId.every((id) => isVoiceId(id)), "voiceId", voiceId);
     this.getMeasure().completeRests(voiceId);
     return this;
   }
+  /**
+   * Add notes of given scale in ascending order.
+   * @param scale - Scale.
+   * @param bottomNote - Scale starts from note >= bottom note.
+   * @param numOctaves - Number of octaves to add.
+   * @returns - This document builder instance.
+   */
   addScaleArpeggio(scale, bottomNote, numOctaves) {
-    assertArg(Utils11.Is.isString(bottomNote), "bottomNote", bottomNote);
-    assertArg(Utils11.Is.isIntegerGte(numOctaves, 1), "numOctaves", numOctaves);
+    assertArg(Utils13.Is.isNonEmptyString(bottomNote), "bottomNote", bottomNote);
+    assertArg(Utils13.Is.isIntegerGte(numOctaves, 1), "numOctaves", numOctaves);
     let ts = this.getMeasure().getTimeSignature();
     let notes = scale.getScaleNotes(bottomNote, numOctaves);
     for (let i = 0; i < notes.length; i++) {
@@ -7196,7 +7475,7 @@ var DocumentBuilder = class {
       }
       let note = notes[i];
       this.addNote(0, note, ts.beatLength);
-      this.addLabel(0 /* Note */, note.formatOmitOctave(SymbolSet2.Unicode));
+      this.addLabel("note" /* Note */, note.formatOmitOctave(SymbolSet2.Unicode));
     }
     return this;
   }
@@ -7205,11 +7484,22 @@ var DocumentBuilder = class {
 // src/score/pub/event.ts
 import { MusicError as MusicError18, MusicErrorType as MusicErrorType18 } from "@tspro/web-music-score/core";
 var ScoreEvent = class {
+  /**
+   * Create new score event instance.
+   * @param type - Score event type.
+   */
   constructor(type) {
     this.type = type;
   }
 };
 var ScoreStaffPosEvent = class extends ScoreEvent {
+  /**
+   * Create new score staff position event.
+   * @param type - Score event type.
+   * @param renderer - Renderer.
+   * @param scoreRow - Score row.
+   * @param diatonicId - Diatonic id that was clicked/entered/left.
+   */
   constructor(type, renderer, scoreRow, diatonicId) {
     super(type);
     this.renderer = renderer;
@@ -7218,6 +7508,12 @@ var ScoreStaffPosEvent = class extends ScoreEvent {
   }
 };
 var ScoreObjectEvent = class extends ScoreEvent {
+  /**
+   * Create new score object event.
+   * @param type - Score event type.
+   * @param renderer - Renderer.
+   * @param objects - Array of objects, last object in this array is the top object that was clicked/entered/left, previous objects are it's parent objects.
+   */
   constructor(type, renderer, objects) {
     super(type);
     this.renderer = renderer;
@@ -7226,32 +7522,34 @@ var ScoreObjectEvent = class extends ScoreEvent {
       throw new MusicError18(MusicErrorType18.Score, "Empty array in score object event!");
     }
   }
+  /** Top object getter. */
   get topObject() {
     return this.objects[this.objects.length - 1];
   }
+  /**
+   * Find object.
+   * @param fn - Compare function.
+   * @returns - First object that matched compare function, or undefined if no match.
+   */
   findObject(fn) {
     return this.objects.find((obj) => fn(obj));
   }
 };
 
-// src/score/pub/interface.ts
+// src/score/pub/music-interface.ts
 import * as Audio2 from "@tspro/web-music-score/audio";
-import { Utils as Utils12 } from "@tspro/ts-utils-lib";
+import { Utils as Utils15 } from "@tspro/ts-utils-lib";
+
+// src/score/pub/music-objects.ts
+import { Utils as Utils14 } from "@tspro/ts-utils-lib";
 import { MusicError as MusicError19, MusicErrorType as MusicErrorType19 } from "@tspro/web-music-score/core";
 function assertArg2(condition, argName, argValue) {
   if (!condition) {
     throw new MusicError19(MusicErrorType19.Score, `Invalid arg: ${argName} = ${argValue}`);
   }
 }
-function require_t(t, message) {
-  if (t === void 0 || t === null) {
-    throw new TypeError(message);
-  } else {
-    return t;
-  }
-}
 function isVoiceId2(value) {
-  return Utils12.Is.isNumber(value) && getVoiceIds().indexOf(value) >= 0;
+  return Utils14.Is.isNumber(value) && getVoiceIds().indexOf(value) >= 0;
 }
 function getNotationLine(line) {
   if (line instanceof ObjStaff || line instanceof ObjTab) {
@@ -7261,9 +7559,17 @@ function getNotationLine(line) {
   }
 }
 var MusicInterface6 = class {
+  /**
+   * Create new music interface object.
+   * @param name - OBject name.
+   */
   constructor(name) {
     this.name = name;
   }
+  /**
+   * Get parent object.
+   * @returns - Parent object or undefined.
+   */
   getParent() {
     var _a;
     return (_a = this.getMusicObject().getParent()) == null ? void 0 : _a.getMusicInterface();
@@ -7279,10 +7585,15 @@ var _MAccidental = class _MAccidental extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get accidental.
+   * @returns - Accidental (e.g. 1 = #).
+   */
   getAccidental() {
     return this.obj.accidental;
   }
 };
+/** Object name. */
 __publicField(_MAccidental, "Name", "Accidental");
 var MAccidental = _MAccidental;
 var _MConnective = class _MConnective extends MusicInterface6 {
@@ -7296,6 +7607,7 @@ var _MConnective = class _MConnective extends MusicInterface6 {
     return this.obj;
   }
 };
+/** Object name. */
 __publicField(_MConnective, "Name", "Connective");
 var MConnective = _MConnective;
 var _MArpeggio = class _MArpeggio extends MusicInterface6 {
@@ -7308,13 +7620,22 @@ var _MArpeggio = class _MArpeggio extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get rhythm column this arpeggio is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.obj.col.getMusicInterface();
   }
+  /**
+   * Get notation line this arpeggio is in.
+   * @returns - Staff or tab object.
+   */
   getNotationLine() {
     return getNotationLine(this.obj.line);
   }
 };
+/** Object name. */
 __publicField(_MArpeggio, "Name", "Arpeggio");
 var MArpeggio = _MArpeggio;
 var _MBeamGroup = class _MBeamGroup extends MusicInterface6 {
@@ -7328,6 +7649,7 @@ var _MBeamGroup = class _MBeamGroup extends MusicInterface6 {
     return this.obj;
   }
 };
+/** OBject name. */
 __publicField(_MBeamGroup, "Name", "BeamGroup");
 var MBeamGroup = _MBeamGroup;
 var _MStaffBeamGroup = class _MStaffBeamGroup extends MusicInterface6 {
@@ -7340,10 +7662,15 @@ var _MStaffBeamGroup = class _MStaffBeamGroup extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get staff this beam group is in.
+   * @returns - Staff object.
+   */
   getStaff() {
     return this.obj.staff.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MStaffBeamGroup, "Name", "StaffBeamGroup");
 var MStaffBeamGroup = _MStaffBeamGroup;
 var _MDocument = class _MDocument extends MusicInterface6 {
@@ -7356,27 +7683,53 @@ var _MDocument = class _MDocument extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get title.
+   * @returns - Title string or undefined.
+   */
   getTitle() {
     return this.obj.getTitle();
   }
+  /**
+   * Get composer.
+   * @returns - Composer string or undefined.
+   */
   getComposer() {
     return this.obj.getComposer();
     3;
   }
+  /**
+   * Get arranger.
+   * @returns - Arranger string or undefined.
+   */
   getArranger() {
     return this.obj.getArranger();
   }
+  /**
+   * Get score rows.
+   * @returns - Array or score rows.
+   */
   getRows() {
     return this.obj.getRows().map((r) => r.getMusicInterface());
   }
+  /**
+   * Get measures.
+   * @returns - Array of measures.
+   */
   getMeasures() {
     return this.obj.getMeasures().map((m) => m.getMusicInterface());
   }
-  play(fn) {
-    assertArg2(Utils12.Is.isFunctionOrUndefined(fn), "playStateChangeListener", fn);
-    return new MPlayer(this, fn).play();
+  /**
+   * Play this document.
+   * @param playStateChangeListener - Play state change listener function or undefined.
+   * @returns - Player instance.
+   */
+  play(playStateChangeListener) {
+    assertArg2(Utils14.Is.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
+    return new MPlayer(this, playStateChangeListener).play();
   }
 };
+/** Object name. */
 __publicField(_MDocument, "Name", "Document");
 var MDocument2 = _MDocument;
 var _MEnding = class _MEnding extends MusicInterface6 {
@@ -7389,14 +7742,24 @@ var _MEnding = class _MEnding extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get passages.
+   * @returns - Array of passage numbers, e.g. passage number 1 means that this ending is played on first pass.
+   */
   getPassages() {
     return this.obj.passages;
   }
+  /**
+   * Has passage number?
+   * @param passage - Passage number to find out.
+   * @returns - Boolean whether this ending has asked passage number.
+   */
   hasPassage(passage) {
-    assertArg2(Utils12.Is.isIntegerGte(passage, 1), "passage", passage);
+    assertArg2(Utils14.Is.isIntegerGte(passage, 1), "passage", passage);
     return this.obj.hasPassage(passage);
   }
 };
+/** Object name. */
 __publicField(_MEnding, "Name", "Ending");
 var MEnding = _MEnding;
 var _MFermata = class _MFermata extends MusicInterface6 {
@@ -7410,6 +7773,7 @@ var _MFermata = class _MFermata extends MusicInterface6 {
     return this.obj;
   }
 };
+/** OBject name. */
 __publicField(_MFermata, "Name", "Fermata");
 var MFermata = _MFermata;
 var _MHeader = class _MHeader extends MusicInterface6 {
@@ -7422,16 +7786,29 @@ var _MHeader = class _MHeader extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get title.
+   * @returns - Title string or undefined.
+   */
   getTitle() {
     return this.obj.title;
   }
+  /**
+   * Get composer.
+   * @returns - Composer string or undefined.
+   */
   getComposer() {
     return this.obj.composer;
   }
+  /**
+   * Get arranger.
+   * @returns - Arranger string or undefined.
+   */
   getArranger() {
     return this.obj.arranger;
   }
 };
+/** OBject name. */
 __publicField(_MHeader, "Name", "Header");
 var MHeader = _MHeader;
 var _MImage = class _MImage extends MusicInterface6 {
@@ -7445,6 +7822,7 @@ var _MImage = class _MImage extends MusicInterface6 {
     return this.obj;
   }
 };
+/** Object name. */
 __publicField(_MImage, "Name", "Image");
 var MImage = _MImage;
 var _MMeasure = class _MMeasure extends MusicInterface6 {
@@ -7457,16 +7835,29 @@ var _MMeasure = class _MMeasure extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get measure number.
+   * @returns - Measure number starting from 1, or 0 if upbeat.
+   */
   getMeasureNumber() {
     return this.obj.getMeasureNumber();
   }
+  /**
+   * Get rhythm columns.
+   * @returns - Array of rhythm columns.
+   */
   getRhythmColumns() {
     return this.obj.getColumns().map((col) => col.getMusicInterface());
   }
+  /**
+   * Get score row that this measure is in.
+   * @returns - Score row.
+   */
   getRow() {
     return this.obj.row.getMusicInterface();
   }
 };
+/** OBject name. */
 __publicField(_MMeasure, "Name", "Measure");
 var MMeasure = _MMeasure;
 var _MBarLineRight = class _MBarLineRight extends MusicInterface6 {
@@ -7480,6 +7871,7 @@ var _MBarLineRight = class _MBarLineRight extends MusicInterface6 {
     return this.obj;
   }
 };
+/** OBject name. */
 __publicField(_MBarLineRight, "Name", "BarLineRight");
 var MBarLineRight = _MBarLineRight;
 var _MBarLineLeft = class _MBarLineLeft extends MusicInterface6 {
@@ -7493,6 +7885,7 @@ var _MBarLineLeft = class _MBarLineLeft extends MusicInterface6 {
     return this.obj;
   }
 };
+/** Object name. */
 __publicField(_MBarLineLeft, "Name", "BarLineLeft");
 var MBarLineLeft = _MBarLineLeft;
 var _MStaffTabBarLine = class _MStaffTabBarLine extends MusicInterface6 {
@@ -7505,6 +7898,10 @@ var _MStaffTabBarLine = class _MStaffTabBarLine extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get parent bar line object.
+   * @returns - Parent bar line object.
+   */
   getBarLine() {
     let barLine = this.obj.barLine;
     if (barLine instanceof ObjBarLineLeft || barLine instanceof ObjBarLineRight) {
@@ -7513,10 +7910,15 @@ var _MStaffTabBarLine = class _MStaffTabBarLine extends MusicInterface6 {
       throw new MusicError19(MusicErrorType19.Score, `Bar line not let nor right.`);
     }
   }
+  /**
+   * Get staff or tab this bar lien object is in.
+   * @returns - Staff or tab.
+   */
   getNotationLine() {
     return getNotationLine(this.obj.line);
   }
 };
+/** Object name. */
 __publicField(_MStaffTabBarLine, "Name", "StaffTabBarLine");
 var MStaffTabBarLine = _MStaffTabBarLine;
 var _MNoteGroup = class _MNoteGroup extends MusicInterface6 {
@@ -7529,19 +7931,36 @@ var _MNoteGroup = class _MNoteGroup extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get notes of this note group.
+   * @returns - Array of Note instances.
+   */
   getNotes() {
     return this.obj.notes;
   }
+  /**
+   * Get rhythm props of this note group.
+   * @returns - Rhythm props.
+   */
   getRhythmProps() {
     return this.obj.rhythmProps;
   }
+  /**
+   * Get rhythm column this note group is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.obj.col.getMusicInterface();
   }
+  /**
+   * Get the measure this note group is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.obj.measure.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MNoteGroup, "Name", "NoteGroup");
 var MNoteGroup = _MNoteGroup;
 var _MStaffNoteGroup = class _MStaffNoteGroup extends MusicInterface6 {
@@ -7554,19 +7973,36 @@ var _MStaffNoteGroup = class _MStaffNoteGroup extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get parent note group.
+   * @returns - Parent note group.
+   */
   getNoteGroup() {
     return this.obj.noteGroup.getMusicInterface();
   }
+  /**
+   * Get rhythm column this note group is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.getNoteGroup().getRhythmColumn();
   }
+  /**
+   * Get the measure this note group is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.getNoteGroup().getMeasure();
   }
+  /**
+   * Get staff notation line this note group is in.
+   * @returns - Staff object.
+   */
   getStaff() {
     return this.obj.staff.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MStaffNoteGroup, "Name", "StaffNoteGroup");
 var MStaffNoteGroup = _MStaffNoteGroup;
 var _MTabNoteGroup = class _MTabNoteGroup extends MusicInterface6 {
@@ -7579,19 +8015,36 @@ var _MTabNoteGroup = class _MTabNoteGroup extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get parent note group.
+   * @returns - Parent note group.
+   */
   getNoteGroup() {
     return this.obj.noteGroup.getMusicInterface();
   }
+  /**
+   * Get rhythm column this note group is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.getNoteGroup().getRhythmColumn();
   }
+  /**
+   * Get the measure this note group is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.getNoteGroup().getMeasure();
   }
+  /**
+   * Get guitar tab this note group is in.
+   * @returns - Tab object.
+   */
   getTab() {
     return this.obj.tab.getMusicInterface();
   }
 };
+/** OBject name. */
 __publicField(_MTabNoteGroup, "Name", "TabNoteGroup");
 var MTabNoteGroup = _MTabNoteGroup;
 var _MRest = class _MRest extends MusicInterface6 {
@@ -7604,16 +8057,29 @@ var _MRest = class _MRest extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get rhythm props of this rest.
+   * @returns - Rhythm props.
+   */
   getRhythmProps() {
     return this.obj.rhythmProps;
   }
+  /**
+   * Get rhythm column this rest is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.obj.col.getMusicInterface();
   }
+  /**
+   * Get the measure this rest is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.obj.measure.getMusicInterface();
   }
 };
+/** OBject name. */
 __publicField(_MRest, "Name", "Rest");
 var MRest = _MRest;
 var _MStaffRest = class _MStaffRest extends MusicInterface6 {
@@ -7626,19 +8092,36 @@ var _MStaffRest = class _MStaffRest extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get parent rest object.
+   * @returns - Parent rest object.
+   */
   getRest() {
     return this.obj.rest.getMusicInterface();
   }
+  /**
+   * Get rhythm column this rest is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.getRest().getRhythmColumn();
   }
+  /**
+   * Get the measure this rest is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.getRest().getMeasure();
   }
+  /**
+   * Get staff notation line this rest is in.
+   * @returns - Staff object.
+   */
   getStaff() {
     return this.obj.staff.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MStaffRest, "Name", "StaffRest");
 var MStaffRest = _MStaffRest;
 var _MRhythmColumn = class _MRhythmColumn extends MusicInterface6 {
@@ -7651,19 +8134,36 @@ var _MRhythmColumn = class _MRhythmColumn extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get symbol (note group or rest) of this column for given voice id.
+   * @param voiceId - Voice id.
+   * @returns - Note group, rest or undefined.
+   */
   getRhythmSymbol(voiceId) {
     var _a;
     assertArg2(isVoiceId2(voiceId), "voiceId", voiceId);
     return (_a = this.obj.getVoiceSymbol(voiceId)) == null ? void 0 : _a.getMusicInterface();
   }
+  /**
+   * Get symbol (note group or rest) of this column for given voice id.
+   * @deprecated - Use getRhythmSymbol(voiceId) instead.
+   * @param voiceId - Voice id.
+   * @returns - Note group, rest or undefined.
+   */
+  getVoiceSymbol(voiceId) {
+    var _a;
+    assertArg2(isVoiceId2(voiceId), "voiceId", voiceId);
+    return (_a = this.obj.getVoiceSymbol(voiceId)) == null ? void 0 : _a.getMusicInterface();
+  }
+  /**
+   * Get the measure this rhythm column is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.obj.measure.getMusicInterface();
   }
-  getVoiceSymbol(voiceId) {
-    let s = this.obj.getVoiceSymbol(voiceId);
-    return s instanceof ObjNoteGroup || s instanceof ObjRest ? s.getMusicInterface() : void 0;
-  }
 };
+/** OBject name. */
 __publicField(_MRhythmColumn, "Name", "RhythmColumn");
 var MRhythmColumn = _MRhythmColumn;
 var _MScoreRow = class _MScoreRow extends MusicInterface6 {
@@ -7676,16 +8176,29 @@ var _MScoreRow = class _MScoreRow extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Parent music document.
+   * @returns - Parent music document.
+   */
   getDocument() {
     return this.obj.doc.getMusicInterface();
   }
+  /**
+   * Get measures of this score row.
+   * @returns - Array of measures.
+   */
   getMeasures() {
     return this.obj.getMeasures().map((m) => m.getMusicInterface());
   }
+  /**
+   * Get notation lines (staves and tabs) of this score row.
+   * @returns - Array of staves and tabs.
+   */
   getNotationLines() {
     return this.obj.getNotationLines().map((line) => getNotationLine(line));
   }
 };
+/** Object name. */
 __publicField(_MScoreRow, "Name", "ScoreRow");
 var MScoreRow = _MScoreRow;
 var _MStaff = class _MStaff extends MusicInterface6 {
@@ -7698,16 +8211,29 @@ var _MStaff = class _MStaff extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get index of this staff in score row.
+   * @returns - Index (0=top notation line).
+   */
   getId() {
     return this.obj.id;
   }
+  /**
+   * Get name of this staff.
+   * @returns - Staff name.
+   */
   getName() {
     return this.obj.name.length > 0 ? this.obj.name : void 0;
   }
+  /**
+   * Get the score row this staff is in.
+   * @returns - Score row.
+   */
   getRow() {
     return this.obj.row.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MStaff, "Name", "Staff");
 var MStaff = _MStaff;
 var _MTab = class _MTab extends MusicInterface6 {
@@ -7720,16 +8246,29 @@ var _MTab = class _MTab extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get index of this guitar tab in score row.
+   * @returns - Index (0=top notation line).
+   */
   getId() {
     return this.obj.id;
   }
+  /**
+   * Get name of this guitar tab.
+   * @returns - Staff name.
+   */
   getName() {
     return this.obj.name.length > 0 ? this.obj.name : void 0;
   }
+  /**
+   * Get the score row this guitar tab is in.
+   * @returns - Score row.
+   */
   getRow() {
     return this.obj.row.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MTab, "Name", "Tab");
 var MTab = _MTab;
 var _MSignature = class _MSignature extends MusicInterface6 {
@@ -7742,10 +8281,15 @@ var _MSignature = class _MSignature extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get staff notation line this signature is in.
+   * @returns - Staff object.
+   */
   getStaff() {
     return this.obj.staff.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MSignature, "Name", "Signature");
 var MSignature = _MSignature;
 var _MSpecialText = class _MSpecialText extends MusicInterface6 {
@@ -7758,10 +8302,15 @@ var _MSpecialText = class _MSpecialText extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get text content.
+   * @returns - Text content.
+   */
   getText() {
     return this.obj.getText();
   }
 };
+/** Object name. */
 __publicField(_MSpecialText, "Name", "SpecialText");
 var MSpecialText = _MSpecialText;
 var _MText = class _MText extends MusicInterface6 {
@@ -7774,10 +8323,15 @@ var _MText = class _MText extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get text content.
+   * @returns - Text content.
+   */
   getText() {
     return this.obj.getText();
   }
 };
+/** Object name. */
 __publicField(_MText, "Name", "Text");
 var MText = _MText;
 var _MExtensionLine = class _MExtensionLine extends MusicInterface6 {
@@ -7791,33 +8345,69 @@ var _MExtensionLine = class _MExtensionLine extends MusicInterface6 {
     return this.obj;
   }
 };
+/** OBject name. */
 __publicField(_MExtensionLine, "Name", "ExtensionLine");
 var MExtensionLine = _MExtensionLine;
+
+// src/score/pub/music-interface.ts
+import { MusicError as MusicError20, MusicErrorType as MusicErrorType20 } from "@tspro/web-music-score/core";
+function assertArg3(condition, argName, argValue) {
+  if (!condition) {
+    throw new MusicError20(MusicErrorType20.Score, `Invalid arg: ${argName} = ${argValue}`);
+  }
+}
+function require_t(t, message) {
+  if (t === void 0 || t === null) {
+    throw new TypeError(message);
+  } else {
+    return t;
+  }
+}
 var _MPlayer = class _MPlayer {
-  constructor(doc, fn) {
+  /**
+   * Create new music player.
+   * @param doc - Music document to play.
+   * @param playStateChangeListener - Play state change listener.
+   */
+  constructor(doc, playStateChangeListener) {
     __publicField(this, "player");
-    assertArg2(doc instanceof MDocument2, "doc", doc);
-    assertArg2(Utils12.Is.isFunctionOrUndefined(fn), "playStateChangeListener", fn);
+    assertArg3(doc instanceof MDocument2, "doc", doc);
+    assertArg3(Utils15.Is.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
     this.player = new Player();
     this.player.setDocument(doc.getMusicObject());
     this.player.setCursorPositionChangeListener((cursorRect) => doc.getMusicObject().updateCursorRect(cursorRect));
-    if (fn) {
-      this.player.setPlayStateChnageListener(fn);
+    if (playStateChangeListener) {
+      this.player.setPlayStateChnageListener(playStateChangeListener);
     }
   }
+  /**
+   * Stop all playing.
+   */
   static stopAll() {
     this.currentlyPlaying.forEach((p) => p.stop());
     Audio2.stop();
   }
+  /**
+   * Playe attached document.
+   * @returns - This player instance.
+   */
   play() {
     _MPlayer.currentlyPlaying.add(this);
     this.player.play();
     return this;
   }
+  /**
+   * Pause playback of attached document.
+   * @returns - This player instance.
+   */
   pause() {
     this.player.pause();
     return this;
   }
+  /**
+   * Stop playback of attached document.
+   * @returns - This player instance.
+   */
   stop() {
     this.player.stop();
     _MPlayer.currentlyPlaying.delete(this);
@@ -7827,33 +8417,61 @@ var _MPlayer = class _MPlayer {
 __publicField(_MPlayer, "currentlyPlaying", /* @__PURE__ */ new Set());
 var MPlayer = _MPlayer;
 var MRenderer2 = class {
+  /**
+   * Create new renderer instance.
+   */
   constructor() {
     __publicField(this, "renderer");
     this.renderer = new Renderer(this);
   }
+  /**
+   * Attach music document to this renderer.
+   * @param doc - Music document.
+   * @returns - This renderer instance.
+   */
   setDocument(doc) {
-    assertArg2(Utils12.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
+    assertArg3(Utils15.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
     this.renderer.setDocument(doc);
     return this;
   }
+  /**
+   * Set target canvas html element for this renderer.
+   * @param canvas - HTML canvas element or element id.
+   * @returns - This renderer instance.
+   */
   setCanvas(canvas) {
-    canvas = require_t(Utils12.Dom.getCanvas(canvas), typeof canvas === "string" ? "Cannot set renderer canvas because invalid canvas id: " + canvas : "Cannot set renderer canvas because given canvas is undefined.");
+    canvas = require_t(Utils15.Dom.getCanvas(canvas), typeof canvas === "string" ? "Cannot set renderer canvas because invalid canvas id: " + canvas : "Cannot set renderer canvas because given canvas is undefined.");
     this.renderer.setCanvas(canvas);
     return this;
   }
-  setScoreEventListener(fn) {
-    assertArg2(Utils12.Is.isFunctionOrUndefined(fn), "scoreEventListener", fn);
-    this.renderer.setScoreEventListener(fn);
+  /**
+   * Set score event listener.
+   * @param scoreEventListener - Score event listener.
+   */
+  setScoreEventListener(scoreEventListener) {
+    assertArg3(Utils15.Is.isFunctionOrUndefined(scoreEventListener), "scoreEventListener", scoreEventListener);
+    this.renderer.setScoreEventListener(scoreEventListener);
   }
+  /**
+   * Draw given music object hilighted.
+   * @param obj - Music object or undefined to remove hilighting.
+   */
   hilightObject(obj) {
     this.renderer.hilightObject(obj == null ? void 0 : obj.getMusicObject());
   }
+  /**
+   * Draw given staff position hilighted.
+   * @param staffPos - Staff position (score row and diatonic id) or undefined to remove hilighting.
+   */
   hilightStaffPos(staffPos) {
     this.renderer.hilightStaffPos(staffPos ? {
       scoreRow: staffPos.scoreRow.getMusicObject(),
       diatonicId: staffPos.diatonicId
     } : void 0);
   }
+  /**
+   * Draw contents of attached music document to attached canvas.
+   */
   draw() {
     try {
       this.renderer.draw();
@@ -7864,6 +8482,9 @@ var MRenderer2 = class {
   }
 };
 var _MPlaybackButtons = class _MPlaybackButtons {
+  /**
+   * Create new playback buttons helper class instance.
+   */
   constructor() {
     __publicField(this, "playButton");
     __publicField(this, "stopButton");
@@ -7896,8 +8517,13 @@ var _MPlaybackButtons = class _MPlaybackButtons {
     };
     this.updateButtons();
   }
+  /**
+   * Attach music document whose playcak will be controlled by this playback buttons helper class instance.
+   * @param doc - Music document.
+   * @returns 
+   */
   setDocument(doc) {
-    assertArg2(Utils12.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
+    assertArg3(Utils15.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
     this.onStop();
     if (doc) {
       this.player = new MPlayer(doc, (playState) => {
@@ -7910,6 +8536,9 @@ var _MPlaybackButtons = class _MPlaybackButtons {
     this.updateButtons();
     return this;
   }
+  /**
+   * Detach attached music document.
+   */
   detachDocument() {
     this.setDocument(void 0);
   }
@@ -7931,31 +8560,50 @@ var _MPlaybackButtons = class _MPlaybackButtons {
       this.pauseButton.innerText = this.pauseLabel;
     }
   }
+  /**
+   * Set play button.
+   * @param btn - HTML button element or element id.
+   * @param btnLabel - Custom button label (e.g. "Play").
+   * @returns - This playback buttons class instance.
+   */
   setPlayButton(btn, btnLabel) {
-    assertArg2(Utils12.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(Utils15.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.playButton, this.onPlay);
-    this.playButton = require_t(Utils12.Dom.getButton(btn), "Play button required!");
+    this.playButton = require_t(Utils15.Dom.getButton(btn), "Play button required!");
     this.playLabel = btnLabel != null ? btnLabel : "Play";
     _MPlaybackButtons.removeOnClickListeners(this.playButton, "all");
     _MPlaybackButtons.addOnClickListener(this.playButton, this.onPlay);
     this.updateButtons();
     return this;
   }
+  /**
+   * Set stop button.
+   * @param btn - HTML button element or element id.
+   * @param btnLabel - Custom button label (e.g. "Stop").
+   * @returns - This playback buttons class instance.
+   */
   setStopButton(btn, btnLabel) {
-    assertArg2(Utils12.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(Utils15.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.stopButton, this.onStop);
-    this.stopButton = require_t(Utils12.Dom.getButton(btn), "Stop button required!");
+    this.stopButton = require_t(Utils15.Dom.getButton(btn), "Stop button required!");
     this.stopLabel = btnLabel != null ? btnLabel : "Stop";
     _MPlaybackButtons.removeOnClickListeners(this.stopButton, "all");
     _MPlaybackButtons.addOnClickListener(this.stopButton, this.onStop);
     this.updateButtons();
     return this;
   }
+  /**
+   * Set play/stop button.
+   * @param btn - HTML button element or element id.
+   * @param playLabel - Custom button label for play action (e.g. "Play").
+   * @param stopLabel - Custom button label for stop action (e.g. "Stop").
+   * @returns - This playback buttons class instance.
+   */
   setPlayStopButton(btn, playLabel, stopLabel) {
-    assertArg2(Utils12.Is.isStringOrUndefined(playLabel), "playLabel", playLabel);
-    assertArg2(Utils12.Is.isStringOrUndefined(stopLabel), "stopLabel", stopLabel);
+    assertArg3(Utils15.Is.isStringOrUndefined(playLabel), "playLabel", playLabel);
+    assertArg3(Utils15.Is.isStringOrUndefined(stopLabel), "stopLabel", stopLabel);
     _MPlaybackButtons.removeOnClickListeners(this.playStopButton, this.onPlayStop);
-    this.playStopButton = require_t(Utils12.Dom.getButton(btn), "Play/stop button required!");
+    this.playStopButton = require_t(Utils15.Dom.getButton(btn), "Play/stop button required!");
     this.playLabel = playLabel != null ? playLabel : "Play";
     this.stopLabel = stopLabel != null ? stopLabel : "Stop";
     _MPlaybackButtons.removeOnClickListeners(this.playStopButton, "all");
@@ -7963,10 +8611,16 @@ var _MPlaybackButtons = class _MPlaybackButtons {
     this.updateButtons();
     return this;
   }
+  /**
+   * Set pause button.
+   * @param btn - HTML button element or element id.
+   * @param btnLabel - Custom button label (e.g. "Pause").
+   * @returns - This playback buttons class instance.
+   */
   setPauseButton(btn, btnLabel) {
-    assertArg2(Utils12.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(Utils15.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.pauseButton, this.onPause);
-    this.pauseButton = require_t(Utils12.Dom.getButton(btn), "Pause button required!");
+    this.pauseButton = require_t(Utils15.Dom.getButton(btn), "Pause button required!");
     this.pauseLabel = btnLabel != null ? btnLabel : "Pause";
     _MPlaybackButtons.removeOnClickListeners(this.pauseButton, "all");
     _MPlaybackButtons.addOnClickListener(this.pauseButton, this.onPause);
@@ -7988,7 +8642,7 @@ var _MPlaybackButtons = class _MPlaybackButtons {
     }
   }
   static addOnClickListener(btn, onClick) {
-    assertArg2(Utils12.Is.isFunction(onClick), "onClick", onClick);
+    assertArg3(Utils15.Is.isFunction(onClick), "onClick", onClick);
     btn.addEventListener("click", onClick);
     let clickListeners = this.savedOnClickListeners.get(btn) || [];
     this.savedOnClickListeners.set(btn, [...clickListeners, onClick]);
@@ -8007,6 +8661,7 @@ export {
   Connective,
   DivRect,
   DocumentBuilder,
+  DynamicsAnnotation,
   Fermata,
   Label,
   MAccidental,
@@ -8048,6 +8703,7 @@ export {
   ScoreStaffPosEvent,
   StaffPreset,
   Stem,
+  TempoAnnotation,
   TieType,
   VerticalPosition,
   getStringNumbers,