@tspro/web-music-score 4.0.1 → 4.2.0

package/dist/score/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v4.0.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.2.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -42,6 +42,8 @@ __export(score_exports, {
   DynamicsAnnotation: () => DynamicsAnnotation,
   Fermata: () => Fermata,
   Label: () => Label,
+  LyricsAlign: () => LyricsAlign,
+  LyricsHyphen: () => LyricsHyphen,
   MAccidental: () => MAccidental,
   MArpeggio: () => MArpeggio,
   MBarLineLeft: () => MBarLineLeft,
@@ -54,6 +56,7 @@ __export(score_exports, {
   MFermata: () => MFermata,
   MHeader: () => MHeader,
   MImage: () => MImage,
+  MLyrics: () => MLyrics,
   MMeasure: () => MMeasure,
   MNoteGroup: () => MNoteGroup,
   MPlaybackButtons: () => MPlaybackButtons,
@@ -85,6 +88,7 @@ __export(score_exports, {
   TieType: () => TieType,
   VerticalPosition: () => VerticalPosition,
   getStringNumbers: () => getStringNumbers,
+  getVerseNumbers: () => getVerseNumbers,
   getVoiceIds: () => getVoiceIds
 });
 module.exports = __toCommonJS(score_exports);
@@ -124,11 +128,11 @@ var DivRect = class _DivRect {
   /**
    * Create rect from basic left, top, width and height arguments.
    * 
-   * @param left -
-   * @param top -
-   * @param width -
-   * @param height -
-   * @returns 
+   * @param left - Left coordinate.
+   * @param top - Top coordinate.
+   * @param width - With.
+   * @param height - Height.
+   * @returns - DivRect.
    */
   static create(left, top, width, height) {
     return new _DivRect(left, left + width, top, top + height);
@@ -138,9 +142,9 @@ var DivRect = class _DivRect {
    * 
    * @param centerX - Center x-coordinate.
    * @param centerY - Center y-coordinate.
-   * @param width -
-   * @param height -
-   * @returns 
+   * @param width - Width.
+   * @param height - Height.
+   * @returns - DivRect.
    */
   static createCentered(centerX, centerY, width, height) {
     return new _DivRect(centerX - width / 2, centerX + width / 2, centerY - height / 2, centerY + height / 2);
@@ -152,43 +156,43 @@ var DivRect = class _DivRect {
    * @param rightw - Right section width.
    * @param toph - Top section height.
    * @param bottomh - Bottomsection height.
-   * @returns 
+   * @returns - DivRect.
    */
   static createSections(leftw, rightw, toph, bottomh) {
     return new _DivRect(-leftw, 0, rightw, -toph, 0, bottomh);
   }
   /**
-   * Width.
+   * Width getter.
    */
   get width() {
     return this.right - this.left;
   }
   /**
-   * Height.
+   * Height getter.
    */
   get height() {
     return this.bottom - this.top;
   }
   /**
-   * Left section width.
+   * Left section width getter.
    */
   get leftw() {
     return this.centerX - this.left;
   }
   /**
-   * Right section width.
+   * Right section width getter.
    */
   get rightw() {
     return this.right - this.centerX;
   }
   /**
-   * Top section height.
+   * Top section height getter.
    */
   get toph() {
     return this.centerY - this.top;
   }
   /**
-   * Bottom section height.
+   * Bottom section height getter.
    */
   get bottomh() {
     return this.bottom - this.centerY;
@@ -196,9 +200,9 @@ var DivRect = class _DivRect {
   /**
    * Does this Rect contain given (x, y)-point?
    * 
-   * @param x -
-   * @param y -
-   * @returns 
+   * @param x - X-coordinate.
+   * @param y - Y-coordinate.
+   * @returns - True/false.
    */
   contains(x, y) {
     return x >= this.left && x <= this.right && y >= this.top && y <= this.bottom;
@@ -206,9 +210,9 @@ var DivRect = class _DivRect {
   /**
    * Do a and b rects overlap?
    * 
-   * @param a -
-   * @param b -
-   * @returns 
+   * @param a - DivRect a.
+   * @param b - DivRect b.
+   * @returns - True/false.
    */
   static overlap(a, b) {
     return a.right > b.left && a.left < b.right && a.bottom > b.top && a.top < b.bottom;
@@ -216,17 +220,18 @@ var DivRect = class _DivRect {
   /**
    * Do horizontal measures of a and b rects overlap?
    * 
-   * @param a -
-   * @param b -
-   * @returns 
+   * @param a - DivRect a.
+   * @param b - DivRect b.
+   * @returns - True/false.
    */
   static overlapX(a, b) {
     return a.right > b.left && a.left < b.right;
   }
   /**
    * Check if this Rect equals with given Rect.
-   * @param b -
-   * @returns 
+   * @param a - DivRect a.
+   * @param b - DivRect b.
+   * @returns - True/false.
    */
   static equals(a, b) {
     if (a == null && b == null) {
@@ -238,10 +243,11 @@ var DivRect = class _DivRect {
     }
   }
   /**
-   * Check if frame (ignoring centerX/Y) of this Rect equals with given Rect, ignoring centerX and centerY.
+   * Check if frame of this Rect equals with given Rect, ignoring center x- and center y-coordinates.
    * 
-   * @param b -
-   * @returns 
+   * @param a - DivRect a.
+   * @param b - DivRect b.
+   * @returns - True/false.
    */
   static equalsFrame(a, b) {
     if (a == null && b == null) {
@@ -255,7 +261,7 @@ var DivRect = class _DivRect {
   /**
    * Created duplicate of this Rect.
    * 
-   * @returns 
+   * @returns - Duplicate.
    */
   copy() {
     return new _DivRect(this.left, this.centerX, this.right, this.top, this.centerY, this.bottom);
@@ -263,9 +269,9 @@ var DivRect = class _DivRect {
   /**
    * Move this rect by (dx, dy). Modifies this Rect.
    * 
-   * @param dx -
-   * @param dy -
-   * @returns 
+   * @param dx - Offset amount in x-direction.
+   * @param dy - Offset amount in y-direction.
+   * @returns - This DivRect instance.
    */
   offsetInPlace(dx, dy) {
     this.left += dx;
@@ -279,9 +285,9 @@ var DivRect = class _DivRect {
   /**
    * Move this rect by (dx, dy). Immutable, returns modified copy.
    * 
-   * @param dx -
-   * @param dy -
-   * @returns 
+   * @param dx - Offset amount in x-direction.
+   * @param dy - Offset amount in y-direction.
+   * @returns - DivRect copy with applied offset.
    */
   offsetCopy(dx, dy) {
     return this.copy().offsetInPlace(dx, dy);
@@ -289,8 +295,8 @@ var DivRect = class _DivRect {
   /**
    * Expand this Rect by given Rect. Modifies this Rect.
    * 
-   * @param rect - 
-   * @returns 
+   * @param rect - DivRect to expand this instance with.
+   * @returns - This DivRect instance.
    */
   expandInPlace(rect) {
     this.left = Math.min(this.left, rect.left);
@@ -302,8 +308,8 @@ var DivRect = class _DivRect {
   /**
    * Expand this Rect by given Rect. Immutable, returns modified copy.
    * 
-   * @param rect -
-   * @returns 
+   * @param rect - DivRect to expand this instance with.
+   * @returns - Expanded copy of this DivRect.
    */
   expandCopy(rect) {
     return this.copy().expandInPlace(rect);
@@ -311,8 +317,8 @@ var DivRect = class _DivRect {
   /**
    * Clip this Rect by given Rect. Mmodifies this Rect.
    * 
-   * @param clipRect -
-   * @returns 
+   * @param clipRect - DivRect to clip this instance with.
+   * @returns - This DivRect instance.
    */
   clipInPlace(clipRect) {
     this.left = Math.max(this.left, clipRect.left);
@@ -326,8 +332,8 @@ var DivRect = class _DivRect {
   /**
    * Clip this Rect by given Rect. Immutable, return modified copy.
    * 
-   * @param clipRect -
-   * @returns 
+   * @param clipRect - DivRecto to clip this instance with.
+   * @returns - Clipped DivRect copy.
    */
   clipCopy(clipRect) {
     return this.copy().clipInPlace(clipRect);
@@ -335,9 +341,9 @@ var DivRect = class _DivRect {
   /**
    * Scale Rect. Anchor pos is (centerX, centerY). Modifies this Rect.
    * 
-   * @param scaleX -
-   * @param scaleY -
-   * @returns Copy of scaled Rect.
+   * @param scaleX - Scale x-amount.
+   * @param scaleY - Scale y-amount. If undefined then scale x-amount is used.
+   * @returns This DivRect instance.
    */
   scaleInPlace(scaleX, scaleY) {
     scaleY = scaleY != null ? scaleY : scaleX;
@@ -350,20 +356,24 @@ var DivRect = class _DivRect {
   /**
    * Scale Rect. Anchor pos is (centerX, centerY). Immutable, returns modified copy.
    * 
-   * @param scaleX -
-   * @param scaleY -
-   * @returns Copy of scaled Rect.
+   * @param scaleX - Scale x-amount.
+   * @param scaleY - Scale y-amount. If undefined then scale x-amount is used.
+   * @returns Scaled copy of this DivRect.
    */
   scaleCopy(scaleX, scaleY) {
     return this.copy().scaleInPlace(scaleX, scaleY);
   }
+  /**
+   * Get this DivRect instance.
+   * @returns - This DivRect instance.
+   */
   getRect() {
     return this;
   }
 };
 
 // src/score/pub/document-builder.ts
-var import_ts_utils_lib13 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib15 = require("@tspro/ts-utils-lib");
 
 // src/score/pub/types.ts
 var StaffPreset = /* @__PURE__ */ ((StaffPreset3) => {
@@ -386,6 +396,9 @@ function getVoiceIds() {
 function getStringNumbers() {
   return [1, 2, 3, 4, 5, 6];
 }
+function getVerseNumbers() {
+  return [1, 2, 3];
+}
 var Stem = /* @__PURE__ */ ((Stem2) => {
   Stem2["Auto"] = "auto";
   Stem2["Up"] = "up";
@@ -423,6 +436,17 @@ var VerticalPosition = /* @__PURE__ */ ((VerticalPosition4) => {
   VerticalPosition4["Both"] = "both";
   return VerticalPosition4;
 })(VerticalPosition || {});
+var LyricsAlign = /* @__PURE__ */ ((LyricsAlign2) => {
+  LyricsAlign2["Left"] = "left";
+  LyricsAlign2["Center"] = "center";
+  LyricsAlign2["Right"] = "right";
+  return LyricsAlign2;
+})(LyricsAlign || {});
+var LyricsHyphen = /* @__PURE__ */ ((LyricsHyphen2) => {
+  LyricsHyphen2["Hyphen"] = "-";
+  LyricsHyphen2["Extender"] = "---";
+  return LyricsHyphen2;
+})(LyricsHyphen || {});
 var Fermata = /* @__PURE__ */ ((Fermata2) => {
   Fermata2["AtNote"] = "atNote";
   Fermata2["AtMeasureEnd"] = "atMeasureEnd";
@@ -976,11 +1000,11 @@ var Renderer = class {
 };
 
 // src/score/engine/obj-staff-and-tab.ts
-var import_core15 = require("@tspro/web-music-score/core");
-var import_ts_utils_lib11 = require("@tspro/ts-utils-lib");
+var import_core16 = require("@tspro/web-music-score/core");
+var import_ts_utils_lib13 = require("@tspro/ts-utils-lib");
 
 // src/score/engine/obj-measure.ts
-var import_ts_utils_lib10 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib12 = require("@tspro/ts-utils-lib");
 var import_theory9 = require("@tspro/web-music-score/theory");
 var import_theory10 = require("@tspro/web-music-score/theory");
 
@@ -1365,9 +1389,9 @@ var ObjSignature = class extends MusicObject {
     if (showTimeSignature) {
       let timeSignature = this.measure.getTimeSignature();
       let beatCount = timeSignature.beatCount.toString();
-      this.beatCountText = new ObjText(this, { text: beatCount, scale: 1.4 }, 0, 0.5);
+      this.beatCountText = new ObjText(this, { text: beatCount, scale: 1.4 }, 0.5, 0.5);
       let beatSize = timeSignature.beatSize.toString();
-      this.beatSizeText = new ObjText(this, { text: beatSize, scale: 1.4 }, 0, 0.5);
+      this.beatSizeText = new ObjText(this, { text: beatSize, scale: 1.4 }, 0.5, 0.5);
     } else {
       this.beatCountText = this.beatSizeText = void 0;
     }
@@ -1457,6 +1481,7 @@ var ObjSignature = class extends MusicObject {
     return [this];
   }
   layout(renderer) {
+    var _a, _b, _c, _d, _e, _f;
     let { unitSize } = renderer;
     let { staff } = this;
     let paddingX = unitSize;
@@ -1501,15 +1526,16 @@ var ObjSignature = class extends MusicObject {
       });
     }
     let right = x;
+    (_a = this.beatCountText) == null ? void 0 : _a.layout(renderer);
+    (_b = this.beatSizeText) == null ? void 0 : _b.layout(renderer);
+    let tsWidth = Math.max((_d = (_c = this.beatCountText) == null ? void 0 : _c.getRect().width) != null ? _d : 0, (_f = (_e = this.beatSizeText) == null ? void 0 : _e.getRect().width) != null ? _f : 0);
     if (this.beatCountText) {
-      this.beatCountText.layout(renderer);
-      this.beatCountText.offset(x + paddingX, staff.getDiatonicIdY(staff.middleLineDiatonicId + 2));
+      this.beatCountText.offset(x + tsWidth / 2 + paddingX, staff.getDiatonicIdY(staff.middleLineDiatonicId + 2));
       this.rect.expandInPlace(this.beatCountText.getRect());
       right = Math.max(right, this.rect.right);
     }
     if (this.beatSizeText) {
-      this.beatSizeText.layout(renderer);
-      this.beatSizeText.offset(x + paddingX, staff.getDiatonicIdY(staff.bottomLineDiatonicId + 2));
+      this.beatSizeText.offset(x + tsWidth / 2 + paddingX, staff.getDiatonicIdY(staff.bottomLineDiatonicId + 2));
       this.rect.expandInPlace(this.beatSizeText.getRect());
       right = Math.max(right, this.rect.right);
     }
@@ -1569,7 +1595,7 @@ var ObjSignature = class extends MusicObject {
 };
 
 // src/score/engine/player.ts
-var import_ts_utils_lib6 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib8 = require("@tspro/ts-utils-lib");
 var import_theory7 = require("@tspro/web-music-score/theory");
 var Audio = __toESM(require("@tspro/web-music-score/audio"));
 
@@ -2898,11 +2924,10 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
   }
   setStemTipY(staff, stemTipY) {
     let obj = this.staffObjects.find((obj2) => obj2.staff === staff);
-    if (!(obj == null ? void 0 : obj.stemTip) || stemTipY === obj.stemTip.centerY) {
-      return;
+    if (this.hasBeamCount() && (obj == null ? void 0 : obj.stemTip) && stemTipY !== obj.stemTip.centerY) {
+      obj.stemTip.top = obj.stemTip.centerY = obj.stemTip.bottom = stemTipY;
+      this.requestRectUpdate();
     }
-    obj.stemTip.top = obj.stemTip.centerY = obj.stemTip.bottom = stemTipY;
-    this.requestRectUpdate();
   }
   offset(dx, dy) {
     this.staffObjects.forEach((obj) => obj.offset(dx, 0));
@@ -3077,13 +3102,344 @@ var ObjNoteGroup = class _ObjNoteGroup extends MusicObject {
 };
 
 // src/score/engine/obj-rhythm-column.ts
+var import_core9 = require("@tspro/web-music-score/core");
+
+// src/theory/rhythm.ts
+var import_ts_utils_lib5 = require("@tspro/ts-utils-lib");
 var import_core8 = require("@tspro/web-music-score/core");
+var cmp = (a, b) => a === b ? 0 : a < b ? -1 : 1;
+var MaxTupletRatioValue = 12;
+var TicksMultiplier = 12 * 11 * 9 * 7 * 5;
+var NoteLength4 = /* @__PURE__ */ ((NoteLength10) => {
+  NoteLength10["Whole"] = "1n";
+  NoteLength10["WholeTriplet"] = "1t";
+  NoteLength10["WholeDot"] = "1.";
+  NoteLength10["Whole2Dots"] = "1..";
+  NoteLength10["Whole12Dots"] = "1..";
+  NoteLength10["Whole3Dots"] = "1...";
+  NoteLength10["Whole4Dots"] = "1....";
+  NoteLength10["Whole5Dots"] = "1.....";
+  NoteLength10["Whole6Dots"] = "1......";
+  NoteLength10["Half"] = "2n";
+  NoteLength10["HalfTriplet"] = "2t";
+  NoteLength10["HalfDot"] = "2.";
+  NoteLength10["Half2Dots"] = "2..";
+  NoteLength10["Half3Dots"] = "2...";
+  NoteLength10["Half4Dots"] = "2....";
+  NoteLength10["Half5Dots"] = "2.....";
+  NoteLength10["Quarter"] = "4n";
+  NoteLength10["QuarterTriplet"] = "4t";
+  NoteLength10["QuarterDot"] = "4.";
+  NoteLength10["Quarter2Dots"] = "4..";
+  NoteLength10["Quarter3Dots"] = "4...";
+  NoteLength10["Quarter4Dots"] = "4....";
+  NoteLength10["Eighth"] = "8n";
+  NoteLength10["EighthTriplet"] = "8t";
+  NoteLength10["EighthDot"] = "8.";
+  NoteLength10["Eighth2Dots"] = "8..";
+  NoteLength10["Eighth3Dots"] = "8...";
+  NoteLength10["Sixteenth"] = "16n";
+  NoteLength10["SixteenthTriplet"] = "16t";
+  NoteLength10["SixteenthDot"] = "16.";
+  NoteLength10["Sixteenth2Dots"] = "16..";
+  NoteLength10["ThirtySecond"] = "32n";
+  NoteLength10["ThirtySecondTriplet"] = "32t";
+  NoteLength10["ThirtySecondDot"] = "32.";
+  NoteLength10["SixtyFourth"] = "64n";
+  NoteLength10["SixtyFourthTriplet"] = "64t";
+  return NoteLength10;
+})(NoteLength4 || {});
+function validateNoteLength(noteLength) {
+  if (import_ts_utils_lib5.Utils.Is.isEnumValue(noteLength, NoteLength4)) {
+    return noteLength;
+  } else {
+    throw new import_core8.MusicError(import_core8.MusicErrorType.InvalidArg, `Invalid noteLength: ${noteLength}`);
+  }
+}
+var _NoteLengthProps = class _NoteLengthProps {
+  constructor(noteLength) {
+    /** Note length. */
+    __publicField(this, "noteLength");
+    /** Note size (whole=1, half=2, quarter=4, ...). */
+    __publicField(this, "noteSize");
+    /** Number of ticks (not altered by isTriplet). */
+    __publicField(this, "ticks");
+    /** Flag count. */
+    __publicField(this, "flagCount");
+    /** Dot count. */
+    __publicField(this, "dotCount");
+    /** Max dot count. */
+    __publicField(this, "maxDotCount");
+    /** Is triplet? */
+    __publicField(this, "isTriplet");
+    /** Has note stem. */
+    __publicField(this, "hasStem");
+    /** Is note head solid (black)? */
+    __publicField(this, "isSolid");
+    this.noteLength = validateNoteLength(noteLength);
+    this.noteSize = parseInt(noteLength);
+    this.isTriplet = noteLength.endsWith("t");
+    this.maxDotCount = this.isTriplet ? 0 : Math.floor(Math.log2(_NoteLengthProps.ShortestNoteSize / this.noteSize));
+    this.dotCount = import_ts_utils_lib5.Utils.Str.charCount(noteLength, ".");
+    this.flagCount = this.noteSize > 4 ? Math.floor(Math.log2(this.noteSize / 4)) : 0;
+    this.ticks = TicksMultiplier * _NoteLengthProps.ShortestNoteSize / this.noteSize;
+    this.hasStem = this.noteSize > 1;
+    this.isSolid = this.noteSize > 2;
+    if (this.dotCount > this.maxDotCount) {
+      throw new import_core8.MusicError(import_core8.MusicErrorType.Note, `dotCount ${this.dotCount} > maxDotCount ${this.maxDotCount}, for noteLength "${this.noteLength}".`);
+    } else if (this.isTriplet && this.dotCount > 0) {
+      throw new import_core8.MusicError(import_core8.MusicErrorType.Note, `noteLength "${this.noteLength}" is both triplet and dotted!`);
+    }
+  }
+  /**
+   * Get note length props.
+   * @param noteLength - Note length.
+   * @returns - Note length props.
+   */
+  static get(noteLength) {
+    let p = this.cache.get(noteLength);
+    if (!p) {
+      this.cache.set(noteLength, p = new _NoteLengthProps(noteLength));
+    }
+    return p;
+  }
+  /**
+   * Create note length props.
+   * @param noteLength - Note length or note size.
+   * @param dotCount - Dot count.
+   * @returns - Note length props.
+   */
+  static create(noteLength, dotCount = 0) {
+    let noteSize = typeof noteLength === "number" ? noteLength : this.get(noteLength).noteSize;
+    return this.get(noteSize + (import_ts_utils_lib5.Utils.Is.isIntegerGte(dotCount, 1) ? ".".repeat(dotCount) : "n"));
+  }
+  /**
+   * Compare note lengths/sizes. Whole (1) > half (2) > quarter (4), etc.
+   * Ignores possible triplet property of note length.
+   * @param a - NoteLengthProps, NoteLength/Str or noteSize
+   * @param b - NoteLengthProps, NoteLength/Str or noteSize
+   * @returns - -1: a < b, 0: a === b, +1: a > b (note length/size comparisons)
+   */
+  static cmp(a, b) {
+    let aNoteSize = a instanceof _NoteLengthProps ? a.noteSize : typeof a === "number" ? a : _NoteLengthProps.get(a).noteSize;
+    let bNoteSize = b instanceof _NoteLengthProps ? b.noteSize : typeof b === "number" ? b : _NoteLengthProps.get(b).noteSize;
+    return cmp(bNoteSize, aNoteSize);
+  }
+  /**
+   * Compare note lengths/sizes for equality.
+   * Ignores possible triplet property of note length.
+   * @param a - NoteLengthProps, NoteLength/Str or noteSize
+   * @param b - NoteLengthProps, NoteLength/Str or noteSize
+   * @returns - true: a === b, false: a !== b (note length/size comparisons)
+   */
+  static equals(a, b) {
+    let aNoteSize = a instanceof _NoteLengthProps ? a.noteSize : typeof a === "number" ? a : _NoteLengthProps.get(a).noteSize;
+    let bNoteSize = b instanceof _NoteLengthProps ? b.noteSize : typeof b === "number" ? b : _NoteLengthProps.get(b).noteSize;
+    return aNoteSize === bNoteSize;
+  }
+};
+/** Longest note size (e.g. 1 = whole note). */
+__publicField(_NoteLengthProps, "LongestNoteSize", Math.min(...import_ts_utils_lib5.Utils.Enum.getEnumValues(NoteLength4).map((noteLength) => parseInt(noteLength))));
+/** Shortest note size (e.g. 64 = sixtyfourth note). */
+__publicField(_NoteLengthProps, "ShortestNoteSize", Math.max(...import_ts_utils_lib5.Utils.Enum.getEnumValues(NoteLength4).map((noteLength) => parseInt(noteLength))));
+__publicField(_NoteLengthProps, "cache", /* @__PURE__ */ new Map());
+var NoteLengthProps4 = _NoteLengthProps;
+function validateTupletRatio(tupletRatio) {
+  if (import_ts_utils_lib5.Utils.Is.isObject(tupletRatio) && import_ts_utils_lib5.Utils.Is.isIntegerBetween(tupletRatio.parts, 2, MaxTupletRatioValue) && import_ts_utils_lib5.Utils.Is.isIntegerBetween(tupletRatio.inTimeOf, 2, MaxTupletRatioValue)) {
+    return tupletRatio;
+  } else {
+    throw new import_core8.MusicError(import_core8.MusicErrorType.Note, `Invalid tupletRatio ${JSON.stringify(tupletRatio)}`);
+  }
+}
+var Tuplet4 = {
+  /** Duplet: 2 in the time of 3 */
+  Duplet: { parts: 2, inTimeOf: 3 },
+  /** Triplet: 3 in the time of 2 */
+  Triplet: { parts: 3, inTimeOf: 2 },
+  /** Quadruplet: 4 in the time of 3 */
+  Quadruplet: { parts: 4, inTimeOf: 3 }
+};
+var _RhythmProps = class _RhythmProps {
+  constructor(noteLength, dotCount, tupletRatio) {
+    /** Note length. */
+    __publicField(this, "noteLength");
+    /** Note size (whole=1, half=2, quarter=4, ...). */
+    __publicField(this, "noteSize");
+    /** Dot count. */
+    __publicField(this, "dotCount");
+    /** Tuplet ratio. */
+    __publicField(this, "tupletRatio");
+    /** Number of ticks. */
+    __publicField(this, "ticks");
+    /** Flag count. */
+    __publicField(this, "flagCount");
+    /** Has note stem. */
+    __publicField(this, "hasStem");
+    /** Is note head solid (black)? */
+    __publicField(this, "isSolidNoteHead");
+    this.noteLength = validateNoteLength(noteLength);
+    let p = NoteLengthProps4.get(noteLength);
+    this.noteSize = p.noteSize;
+    this.ticks = p.ticks;
+    this.flagCount = p.flagCount;
+    this.dotCount = dotCount != null ? dotCount : p.dotCount;
+    this.hasStem = p.hasStem;
+    this.isSolidNoteHead = p.isSolid;
+    if (import_ts_utils_lib5.Utils.Is.isObject(tupletRatio)) {
+      this.tupletRatio = validateTupletRatio(tupletRatio);
+    } else if (p.isTriplet) {
+      this.tupletRatio = Tuplet4.Triplet;
+    } else {
+      this.tupletRatio = void 0;
+    }
+    if (this.dotCount > 0 && this.tupletRatio !== void 0) {
+      throw new import_core8.MusicError(import_core8.MusicErrorType.Note, `Note cannot be both dotted and tuplet!`);
+    } else if (this.dotCount > p.maxDotCount) {
+      throw new import_core8.MusicError(import_core8.MusicErrorType.Note, `Too big dot count ${this.dotCount} for note length ${this.noteLength}.`);
+    }
+    for (let add = this.ticks / 2, i = 1; i <= this.dotCount; i++, add /= 2) {
+      this.ticks += add;
+    }
+    if (this.tupletRatio) {
+      this.ticks *= this.tupletRatio.inTimeOf / this.tupletRatio.parts;
+    }
+  }
+  /**
+   * Get string presentation of rhythm props.
+   * @returns - String presentation.
+   */
+  toString() {
+    let sym = _RhythmProps.NoteSymbolMap.get(this.noteSize);
+    let dots = ".".repeat(this.dotCount);
+    return sym ? sym + dots : "" + this.noteSize + (dots.length > 0 ? dots : "n");
+  }
+  /**
+   * Get rhythm props with given arguments.
+   * @param noteLength - Note length.
+   * @param dotCount - Dot count.
+   * @param tupletRatio - Tuplet ratio.
+   * @returns - Rhythm props.
+   */
+  static get(noteLength, dotCount, tupletRatio) {
+    if (dotCount !== void 0 || tupletRatio !== void 0) {
+      return new _RhythmProps(noteLength, dotCount, tupletRatio);
+    } else {
+      let rhythmProps = this.cache.get(noteLength);
+      if (!rhythmProps) {
+        this.cache.set(noteLength, rhythmProps = new _RhythmProps(noteLength));
+      }
+      return rhythmProps;
+    }
+  }
+  /**
+   * Compare duration of rhythm props.
+   * @param a - RhythmProps
+   * @param b - RhythmProps
+   * @returns - -1: a < b, 0: a === b, +1: a > b (duration comparisons)
+   */
+  static cmp(a, b) {
+    return cmp(a.ticks, b.ticks);
+  }
+  /**
+   * Compare duration equality of rhythm props.
+   * @param a - RhythmProps
+   * @param b - RhythmProps
+   * @returns - true: a === b, false: a !== b (duration comparisons)
+   */
+  static equals(a, b) {
+    return a.ticks === b.ticks;
+  }
+};
+__publicField(_RhythmProps, "NoteSymbolMap", /* @__PURE__ */ new Map([[1, "\u{1D15D}"], [2, "\u{1D15E}"], [4, "\u{1D15F}"], [8, "\u{1D160}"], [16, "\u{1D161}"], [32, "\u{1D162}"], [64, "\u{1D163}"], [128, "\u{1D164}"]]));
+__publicField(_RhythmProps, "cache", /* @__PURE__ */ new Map());
+var RhythmProps3 = _RhythmProps;
+
+// src/score/engine/obj-lyrics.ts
+var import_ts_utils_lib6 = require("@tspro/ts-utils-lib");
+var LyricsContainer = class {
+  constructor(col, lyricsLength) {
+    this.col = col;
+    __publicField(this, "lyricsObjects", []);
+    __publicField(this, "rhythmProps");
+    this.rhythmProps = RhythmProps3.get(lyricsLength);
+  }
+  addLyricsObject(lyricsObj) {
+    var _a;
+    this.lyricsObjects.push(lyricsObj);
+    (_a = lyricsObj.measure.getPrevLyricsObject(lyricsObj)) == null ? void 0 : _a.setNextLyricsObject(lyricsObj);
+  }
+};
+var ObjLyrics = class extends MusicObject {
+  constructor(col, verse, line, vpos, lyricsText, lyricsOptions) {
+    super(col);
+    this.col = col;
+    this.verse = verse;
+    this.line = line;
+    this.vpos = vpos;
+    __publicField(this, "nextLyricsObject");
+    __publicField(this, "color", "black");
+    __publicField(this, "hyphen");
+    __publicField(this, "text");
+    __publicField(this, "mi");
+    let halign = (lyricsOptions == null ? void 0 : lyricsOptions.align) === "left" /* Left */ ? 0 : (lyricsOptions == null ? void 0 : lyricsOptions.align) === "right" /* Right */ ? 1 : 0.5;
+    this.hyphen = import_ts_utils_lib6.Utils.Is.isEnumValue(lyricsOptions == null ? void 0 : lyricsOptions.hyphen, LyricsHyphen) ? lyricsOptions == null ? void 0 : lyricsOptions.hyphen : void 0;
+    this.text = new ObjText(this, { text: lyricsText, color: this.color, scale: 0.8 }, halign, 0);
+    this.rect = new DivRect();
+    this.mi = new MLyrics(this);
+  }
+  getMusicInterface() {
+    return this.mi;
+  }
+  get measure() {
+    return this.col.measure;
+  }
+  getText() {
+    return this.text.getText();
+  }
+  setNextLyricsObject(lyricsObj) {
+    this.nextLyricsObject = lyricsObj;
+  }
+  pick(x, y) {
+    return this.rect.contains(x, y) ? [this] : [];
+  }
+  layout(renderer) {
+    this.text.layout(renderer);
+    this.rect = this.text.getRect().copy();
+  }
+  offset(dx, dy) {
+    this.text.offset(dx, dy);
+    this.rect.offsetInPlace(dx, dy);
+  }
+  draw(renderer) {
+    var _a;
+    this.text.draw(renderer);
+    const ctx = renderer.getCanvasContext();
+    if (ctx && this.hyphen !== void 0) {
+      let l = this.getRect();
+      let r = (_a = this.nextLyricsObject) == null ? void 0 : _a.getRect();
+      let hyphenw = renderer.unitSize * 1.5;
+      let maxw = r ? (r.left - l.right) * 0.85 : hyphenw;
+      let w = this.hyphen === "-" /* Hyphen */ ? Math.min(hyphenw, maxw) : maxw;
+      if (w > 0) {
+        ctx.lineWidth = renderer.lineWidth;
+        ctx.strokeStyle = ctx.fillStyle = this.color;
+        let cx = r ? (r.left + l.right) / 2 : l.right + w / 0.85;
+        let cy = (l.top + l.bottom) / 2;
+        ctx.moveTo(cx - w / 2, cy);
+        ctx.lineTo(cx + w / 2, cy);
+        ctx.stroke();
+      }
+    }
+  }
+};
+
+// src/score/engine/obj-rhythm-column.ts
 var noteHeadDataCompareFunc = (a, b) => {
-  let cmp = import_theory6.Note.compareFunc(a.note, b.note);
-  if (cmp === 0) {
-    cmp = a.noteGroup.stemDir === b.noteGroup.stemDir ? 0 : a.noteGroup.stemDir === "up" /* Up */ ? 1 : -1;
+  let cmp3 = import_theory6.Note.compareFunc(a.note, b.note);
+  if (cmp3 === 0) {
+    cmp3 = a.noteGroup.stemDir === b.noteGroup.stemDir ? 0 : a.noteGroup.stemDir === "up" /* Up */ ? 1 : -1;
   }
-  return cmp;
+  return cmp3;
 };
 var ObjRhythmColumn = class extends MusicObject {
   constructor(measure, positionTicks) {
@@ -3091,6 +3447,7 @@ var ObjRhythmColumn = class extends MusicObject {
     this.measure = measure;
     this.positionTicks = positionTicks;
     __publicField(this, "voiceSymbol", []);
+    __publicField(this, "lyricsContainers", []);
     __publicField(this, "minDiatonicId");
     __publicField(this, "maxDiatonicId");
     __publicField(this, "staffMinDiatonicId", /* @__PURE__ */ new Map());
@@ -3120,7 +3477,7 @@ var ObjRhythmColumn = class extends MusicObject {
     if (colId >= 0 && colId < this.measure.getColumnCount()) {
       return this.measure.getColumn(colId + 1);
     } else {
-      throw new import_core8.MusicError(import_core8.MusicErrorType.Score, "Cannot get next column in measure because current column's id in mesure is invalid.");
+      throw new import_core9.MusicError(import_core9.MusicErrorType.Score, "Cannot get next column in measure because current column's id in mesure is invalid.");
     }
   }
   /**
@@ -3216,6 +3573,19 @@ var ObjRhythmColumn = class extends MusicObject {
   getVoiceSymbol(voiceId) {
     return this.voiceSymbol[voiceId];
   }
+  getLyricsContainerDatas() {
+    return this.lyricsContainers;
+  }
+  getLyricsContainer(verse, line, vpos, lyricsLength) {
+    let data = this.lyricsContainers.find((data2) => data2.verse === verse && data2.line === line && data2.vpos === vpos);
+    if (data === void 0 && lyricsLength !== void 0) {
+      data = { lyricsContainer: new LyricsContainer(this, (0, import_theory6.validateNoteLength)(lyricsLength)), verse, line, vpos };
+      this.lyricsContainers.push(data);
+      this.requestLayout();
+      this.requestRectUpdate();
+    }
+    return data == null ? void 0 : data.lyricsContainer;
+  }
   getMinWidth() {
     let maxNoteSize = Math.max(...this.voiceSymbol.map((s) => s.rhythmProps.noteSize));
     let w = DocumentSettings.NoteHeadWidth;
@@ -3432,10 +3802,10 @@ var ObjRhythmColumn = class extends MusicObject {
 };
 
 // src/score/engine/extension.ts
-var import_core9 = require("@tspro/web-music-score/core");
+var import_core10 = require("@tspro/web-music-score/core");
 
 // src/score/engine/element-data.ts
-var import_ts_utils_lib5 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib7 = require("@tspro/ts-utils-lib");
 
 // src/score/engine/obj-special-text.ts
 var _ObjSpecialText = class _ObjSpecialText extends MusicObject {
@@ -3557,23 +3927,23 @@ function getNavigationString(navigation) {
   }
 }
 function isDynamicsText(text) {
-  return import_ts_utils_lib5.Utils.Is.isEnumValue(text, DynamicsAnnotation);
+  return import_ts_utils_lib7.Utils.Is.isEnumValue(text, DynamicsAnnotation);
 }
 function getDynamicsVolume(text) {
   if (/^(p+|f+|m|mp|mf)$/.test(text)) {
-    let volume = 0.5 - import_ts_utils_lib5.Utils.Str.charCount(text, "p") * 0.1 + import_ts_utils_lib5.Utils.Str.charCount(text, "f") * 0.1;
-    return import_ts_utils_lib5.Utils.Math.clamp(volume, 0, 1);
+    let volume = 0.5 - import_ts_utils_lib7.Utils.Str.charCount(text, "p") * 0.1 + import_ts_utils_lib7.Utils.Str.charCount(text, "f") * 0.1;
+    return import_ts_utils_lib7.Utils.Math.clamp(volume, 0, 1);
   } else {
     return void 0;
   }
 }
 function isTempoText(text) {
-  return import_ts_utils_lib5.Utils.Is.isEnumValue(text, TempoAnnotation);
+  return import_ts_utils_lib7.Utils.Is.isEnumValue(text, TempoAnnotation);
 }
 function getAnnotation(text) {
-  if (import_ts_utils_lib5.Utils.Is.isEnumValue(text, DynamicsAnnotation)) {
+  if (import_ts_utils_lib7.Utils.Is.isEnumValue(text, DynamicsAnnotation)) {
     return "dynamics" /* Dynamics */;
-  } else if (import_ts_utils_lib5.Utils.Is.isEnumValue(text, TempoAnnotation)) {
+  } else if (import_ts_utils_lib7.Utils.Is.isEnumValue(text, TempoAnnotation)) {
     return "tempo" /* Tempo */;
   } else {
     return void 0;
@@ -3616,7 +3986,7 @@ var Extension = class extends MusicObjectLink {
     if (head instanceof ObjText) {
       head.updateAnchorY(getTextAnchorY(linePos));
     } else {
-      throw new import_core9.MusicError(import_core9.MusicErrorType.Score, "Update anchor's y-coordinate is only implemented for text objects.");
+      throw new import_core10.MusicError(import_core10.MusicErrorType.Score, "Update anchor's y-coordinate is only implemented for text objects.");
     }
   }
   isVisible() {
@@ -3729,7 +4099,7 @@ var PlayerColumnProps = class {
     return this.speed;
   }
   getTempo() {
-    let speed = import_ts_utils_lib6.Utils.Math.clamp(this.getSpeed(), 0.1, 10);
+    let speed = import_ts_utils_lib8.Utils.Math.clamp(this.getSpeed(), 0.1, 10);
     return (0, import_theory7.alterTempoSpeed)(this.measure.getTempo(), speed);
   }
   setVolume(volume) {
@@ -3754,7 +4124,7 @@ var PlayerColumnProps = class {
       if (symbolsTicks.length === 0) {
         return 0;
       } else {
-        return import_ts_utils_lib6.Utils.Math.sum(symbolsTicks) / symbolsTicks.length;
+        return import_ts_utils_lib8.Utils.Math.sum(symbolsTicks) / symbolsTicks.length;
       }
     }
   }
@@ -3903,7 +4273,7 @@ var Player = class _Player {
         } else if (layoutObj.musicObj.getLink() instanceof Extension) {
           let extension = layoutObj.musicObj.getLink();
           let { columnRange, extensionBreakText } = extension.getExtensionRangeInfo();
-          let totalTicks = import_ts_utils_lib6.Utils.Math.sum(columnRange.map((c) => c.getTicksToNextColumn()));
+          let totalTicks = import_ts_utils_lib8.Utils.Math.sum(columnRange.map((c) => c.getTicksToNextColumn()));
           switch (text) {
             case "accel." /* accel */: {
               let startSpeed = curSpeed;
@@ -3957,11 +4327,11 @@ var Player = class _Player {
       });
       let speedArr = (_a = speedMap.get(col)) != null ? _a : [];
       if (speedArr.length > 0) {
-        curSpeed = import_ts_utils_lib6.Utils.Math.sum(speedArr) / speedArr.length;
+        curSpeed = import_ts_utils_lib8.Utils.Math.sum(speedArr) / speedArr.length;
       }
       let volumeArr = (_b = volumeMap.get(col)) != null ? _b : [];
       if (volumeArr.length > 0) {
-        curVolume = import_ts_utils_lib6.Utils.Math.sum(volumeArr) / volumeArr.length;
+        curVolume = import_ts_utils_lib8.Utils.Math.sum(volumeArr) / volumeArr.length;
       }
       col.getPlayerProps().setSpeed(curSpeed);
       col.getPlayerProps().setVolume(curVolume);
@@ -4291,8 +4661,8 @@ var ObjBarLineRight = class extends ObjBarLine {
 };
 
 // src/score/engine/obj-ending.ts
-var import_ts_utils_lib7 = require("@tspro/ts-utils-lib");
-var import_core10 = require("@tspro/web-music-score/core");
+var import_ts_utils_lib9 = require("@tspro/ts-utils-lib");
+var import_core11 = require("@tspro/web-music-score/core");
 var ObjEnding = class extends MusicObject {
   constructor(measure, passages) {
     super(measure);
@@ -4302,10 +4672,10 @@ var ObjEnding = class extends MusicObject {
     __publicField(this, "shapeRects", []);
     __publicField(this, "mi");
     this.mi = new MEnding(this);
-    if (!import_ts_utils_lib7.Utils.Is.isIntegerGte(passages.length, 1)) {
-      throw new import_core10.MusicError(import_core10.MusicErrorType.Score, "Passages is empty.");
-    } else if (!this.passages.every((p) => import_ts_utils_lib7.Utils.Is.isIntegerGte(p, 1))) {
-      throw new import_core10.MusicError(import_core10.MusicErrorType.Score, "Invalid passages: " + this.passages);
+    if (!import_ts_utils_lib9.Utils.Is.isIntegerGte(passages.length, 1)) {
+      throw new import_core11.MusicError(import_core11.MusicErrorType.Score, "Passages is empty.");
+    } else if (!this.passages.every((p) => import_ts_utils_lib9.Utils.Is.isIntegerGte(p, 1))) {
+      throw new import_core11.MusicError(import_core11.MusicErrorType.Score, "Invalid passages: " + this.passages);
     }
     this.passages.sort((a, b) => a - b);
     let text = this.passages.map((p) => p + ".").join("");
@@ -4513,14 +4883,14 @@ var ObjExtensionLine = class extends MusicObject {
 };
 
 // src/score/engine/obj-measure.ts
-var import_core13 = require("@tspro/web-music-score/core");
+var import_core14 = require("@tspro/web-music-score/core");
 
 // src/score/engine/connective-props.ts
 var import_theory8 = require("@tspro/web-music-score/theory");
 
 // src/score/engine/obj-connective.ts
-var import_ts_utils_lib8 = require("@tspro/ts-utils-lib");
-var import_core11 = require("@tspro/web-music-score/core");
+var import_ts_utils_lib10 = require("@tspro/ts-utils-lib");
+var import_core12 = require("@tspro/web-music-score/core");
 var ObjConnective = class extends MusicObject {
   constructor(connectiveProps, line, measure, leftNoteGroup, leftNoteId, ...args) {
     super(measure);
@@ -4548,7 +4918,7 @@ var ObjConnective = class extends MusicObject {
       this.rightNoteGroup = args[0];
       this.rightNoteId = args[1];
       this.tieType = void 0;
-    } else if (import_ts_utils_lib8.Utils.Is.isEnumValue(args[0], TieType)) {
+    } else if (import_ts_utils_lib10.Utils.Is.isEnumValue(args[0], TieType)) {
       this.rightNoteGroup = void 0;
       this.rightNoteId = void 0;
       this.tieType = args[0];
@@ -4609,7 +4979,7 @@ var ObjConnective = class extends MusicObject {
       rx = contentRect.right;
       ry = leftPos.y + (rightPos.y - leftPos.y) * tLeft / (tLeft + tRight);
     } else {
-      throw new import_core11.MusicError(import_core11.MusicErrorType.Score, "Cannot layout connective object because no valid left and right note groups.");
+      throw new import_core12.MusicError(import_core12.MusicErrorType.Score, "Cannot layout connective object because no valid left and right note groups.");
     }
     let spanDy = arcDir === "up" ? -1 : 1;
     let arcHeight = spanDy * unitSize * Math.log2(rx - lx) / 3;
@@ -4618,7 +4988,7 @@ var ObjConnective = class extends MusicObject {
     this.rx = rx;
     this.ry = ry;
     this.arcHeight = this.connectiveProps.connective === "slide" /* Slide */ ? 0 : arcHeight;
-    let { nx, ny } = import_ts_utils_lib8.Utils.Math.calcNormal(lx, ly, rx, ry);
+    let { nx, ny } = import_ts_utils_lib10.Utils.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;
@@ -4678,8 +5048,8 @@ var ObjConnective = class extends MusicObject {
 };
 
 // src/score/engine/connective-props.ts
-var import_core12 = require("@tspro/web-music-score/core");
-var import_ts_utils_lib9 = require("@tspro/ts-utils-lib");
+var import_core13 = require("@tspro/web-music-score/core");
+var import_ts_utils_lib11 = require("@tspro/ts-utils-lib");
 var ConnectiveProps = class {
   constructor(connective, span, noteAnchor, startNoteGroup) {
     this.connective = connective;
@@ -4749,7 +5119,7 @@ var ConnectiveProps = class {
     this.computeParams();
     let { connective, span } = this;
     if (connective === "tie" /* Tie */) {
-      if (import_ts_utils_lib9.Utils.Is.isEnumValue(span, TieType)) {
+      if (import_ts_utils_lib11.Utils.Is.isEnumValue(span, TieType)) {
         let leftNoteGroup = this.noteGroups[0];
         for (let noteId = 0; noteId < leftNoteGroup.notes.length; noteId++) {
           this.createObjConnectiveWithTieType(leftNoteGroup, noteId, span);
@@ -4814,15 +5184,16 @@ var ConnectiveProps = class {
       addConnective(leftNoteGroup.measure, leftNoteGroup, leftNoteId, rightNoteGroup, rightNoteId);
       addConnective(rightNoteGroup.measure, leftNoteGroup, leftNoteId, rightNoteGroup, rightNoteId);
     } else {
-      throw new import_core12.MusicError(import_core12.MusicErrorType.Score, "Cannot create connective because it is jumping measures.");
+      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot create connective because it is jumping measures.");
     }
   }
 };
 
 // src/score/engine/obj-measure.ts
+var cmp2 = (a, b) => a === b ? 0 : a < b ? -1 : 1;
 function validateVoiceId(voiceId) {
-  if (getVoiceIds().indexOf(voiceId) < 0) {
-    throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Invalid voiceId: " + voiceId);
+  if (typeof voiceId === "number" && getVoiceIds().indexOf(voiceId) < 0) {
+    throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Invalid voiceId: " + voiceId);
   } else {
     return voiceId;
   }
@@ -4831,7 +5202,7 @@ function getExtensionTicks(extensionLength) {
   if (typeof extensionLength === "string") {
     extensionLength = [extensionLength];
   }
-  if (import_ts_utils_lib10.Utils.Is.isArray(extensionLength)) {
+  if (import_ts_utils_lib12.Utils.Is.isArray(extensionLength)) {
     let totalTicks = 0;
     for (let i = 0; i < extensionLength.length; ) {
       let str = extensionLength[i];
@@ -4853,6 +5224,18 @@ function getExtensionTicks(extensionLength) {
     return extensionLength;
   }
 }
+function getVerseLayoutGroupId(verse) {
+  switch (verse) {
+    case 1:
+      return 7 /* LyricsVerse1 */;
+    case 2:
+      return 8 /* LyricsVerse2 */;
+    case 3:
+      return 9 /* LyricsVerse3 */;
+    default:
+      throw new import_core14.MusicError(import_core14.MusicErrorType.Unknown, "VerseNumber is not 1, 2 or 3.");
+  }
+}
 var _ObjMeasure = class _ObjMeasure extends MusicObject {
   constructor(row) {
     super(row);
@@ -4897,6 +5280,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     // play twice.
     __publicField(this, "endRepeatPlayCountText");
     __publicField(this, "staticObjectsCache", /* @__PURE__ */ new Map());
+    __publicField(this, "lyricsObjectsCache", /* @__PURE__ */ new Map());
     __publicField(this, "mi");
     this.mi = new MMeasure(this);
     this.prevMeasure = row.doc.getLastMeasure();
@@ -5080,7 +5464,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
       this.alterKeySignature = args[0];
     } else if (args[0] instanceof import_theory9.Scale) {
       this.alterKeySignature = args[0];
-    } else if (import_ts_utils_lib10.Utils.Is.isNonEmptyString(args[0])) {
+    } else if (import_ts_utils_lib12.Utils.Is.isNonEmptyString(args[0])) {
       if (args.length === 1) {
         this.alterKeySignature = (0, import_theory9.getScale)(args[0]);
       } else if (args.length === 2) {
@@ -5089,7 +5473,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
           let scaleType = (0, import_theory9.validateScaleType)("" + args[1]);
           this.alterKeySignature = (0, import_theory9.getScale)(tonic, scaleType);
         } catch (e) {
-          throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot set key signature because invalid args: " + args);
+          throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Cannot set key signature because invalid args: " + args);
         }
       }
     }
@@ -5111,7 +5495,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   setTimeSignature(timeSignature) {
     var _a;
     (_a = this.getPrevMeasure()) == null ? void 0 : _a.endSection();
-    this.alterTimeSignature = timeSignature instanceof import_theory10.TimeSignature ? timeSignature : new import_theory10.TimeSignature(timeSignature);
+    this.alterTimeSignature = timeSignature;
     this.updateTimeSignature();
   }
   updateTimeSignature() {
@@ -5191,7 +5575,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
           let grp = this.doc.getStaffGroup(staffTabOrGroup);
           if (grp && !prevGroups.includes(staffTabOrGroup)) {
             let curGroups = [...prevGroups, staffTabOrGroup];
-            (import_ts_utils_lib10.Utils.Is.isArray(grp.staffsTabsAndGroups) ? grp.staffsTabsAndGroups : [grp.staffsTabsAndGroups]).forEach((staffTabOrGroup2) => {
+            (import_ts_utils_lib12.Utils.Is.isArray(grp.staffsTabsAndGroups) ? grp.staffsTabsAndGroups : [grp.staffsTabsAndGroups]).forEach((staffTabOrGroup2) => {
               switch (grp.verticalPosition) {
                 case "above" /* Above */:
                   addToStaffTabOrGroup(staffTabOrGroup2, 0 /* Above */, curGroups);
@@ -5218,7 +5602,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
       } else {
         addToStaffTabOrGroup(0, defaultVerticalPos);
       }
-    } else if (import_ts_utils_lib10.Utils.Is.isArray(staffTabOrGroups)) {
+    } else if (import_ts_utils_lib12.Utils.Is.isArray(staffTabOrGroups)) {
       staffTabOrGroups.forEach((staffTabOrGroup) => addToStaffTabOrGroup(staffTabOrGroup, defaultVerticalPos));
     } else {
       addToStaffTabOrGroup(staffTabOrGroups, defaultVerticalPos);
@@ -5227,7 +5611,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   addFermata(staffTabOrGroups, fermata) {
     let anchor = fermata === "atMeasureEnd" /* AtMeasureEnd */ ? this.barLineRight : this.lastAddedRhythmColumn;
     if (!anchor) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add Fermata because anchor is undefined.");
+      throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Cannot add Fermata because anchor is undefined.");
     }
     this.forEachStaffGroup(staffTabOrGroups, 0 /* Above */, (line, vpos) => {
       this.addLayoutObject(new ObjFermata(anchor, vpos), line, 0 /* Fermata */, vpos);
@@ -5243,7 +5627,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     switch (navigation) {
       case "ending" /* Ending */:
         if (this.navigationSet.has(navigation)) {
-          throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add ending beasure measure already has one.");
+          throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Cannot add ending beasure measure already has one.");
         }
         let anchor = this;
         let passages = args;
@@ -5302,10 +5686,10 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
       case "endRepeat" /* EndRepeat */:
         if (args.length === 0) {
           this.endRepeatPlayCount = 2;
-        } else if (import_ts_utils_lib10.Utils.Is.isIntegerGte(args[0], 2)) {
+        } else if (import_ts_utils_lib12.Utils.Is.isIntegerGte(args[0], 2)) {
           this.endRepeatPlayCount = args[0];
         } else {
-          throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Invalid end repeat play count (should be 2 or greater integer): " + args[0]);
+          throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Invalid end repeat play count (should be 2 or greater integer): " + args[0]);
         }
         if (this.endRepeatPlayCount !== 2) {
           let textProps = {
@@ -5330,9 +5714,9 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   addAnnotation(staffTabOrGroups, annotation, text) {
     let anchor = this.lastAddedRhythmColumn;
     if (!anchor) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add annotation because anchor is undefined.");
+      throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Cannot add annotation because anchor is undefined.");
     } else if (text.length === 0) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add annotation because annotation text is empty.");
+      throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Cannot add annotation because annotation text is empty.");
     }
     let textProps = { text };
     let layoutGroupId;
@@ -5359,9 +5743,9 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   addLabel(staffTabOrGroups, label, text) {
     let anchor = this.lastAddedRhythmColumn;
     if (!anchor) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add label because anchor is undefined.");
+      throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Cannot add label because anchor is undefined.");
     } else if (text.length === 0) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add label because label text is empty.");
+      throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Cannot add label because label text is empty.");
     }
     let textProps = { text };
     let layoutGroupId;
@@ -5386,18 +5770,18 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   addConnective(connective, ...args) {
     let anchor = this.lastAddedRhythmSymbol;
     if (!(anchor instanceof ObjNoteGroup)) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Connective can be added to note group only.");
+      throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Connective can be added to note group only.");
     }
     if (connective === "tie" /* Tie */) {
-      let tieSpan = import_ts_utils_lib10.Utils.Is.isInteger(args[0]) || import_ts_utils_lib10.Utils.Is.isEnumValue(args[0], TieType) ? args[0] : 2;
-      let noteAnchor = import_ts_utils_lib10.Utils.Is.isEnumValue(args[1], NoteAnchor) ? args[1] : "auto" /* Auto */;
+      let tieSpan = import_ts_utils_lib12.Utils.Is.isInteger(args[0]) || import_ts_utils_lib12.Utils.Is.isEnumValue(args[0], TieType) ? args[0] : 2;
+      let noteAnchor = import_ts_utils_lib12.Utils.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 = import_ts_utils_lib10.Utils.Is.isInteger(args[0]) ? args[0] : 2;
-      let noteAnchor = import_ts_utils_lib10.Utils.Is.isEnumValue(args[1], NoteAnchor) ? args[1] : "auto" /* Auto */;
+      let slurSpan = import_ts_utils_lib12.Utils.Is.isInteger(args[0]) ? args[0] : 2;
+      let noteAnchor = import_ts_utils_lib12.Utils.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 = import_ts_utils_lib10.Utils.Is.isEnumValue(args[0], NoteAnchor) ? args[0] : "auto" /* Auto */;
+      let noteAnchor = import_ts_utils_lib12.Utils.Is.isEnumValue(args[0], NoteAnchor) ? args[0] : "auto" /* Auto */;
       anchor.startConnective(new ConnectiveProps("slide" /* Slide */, 2, noteAnchor, anchor));
     }
   }
@@ -5410,11 +5794,11 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
         let extension = new Extension(musicObj, anchor, getExtensionTicks(extensionLength), extensionVisible, lineStyle, linePos);
         musicObj.setLink(extension);
       } else {
-        throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add extension becaue no compatible music object to attach it to.");
+        throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Cannot add extension becaue no compatible music object to attach it to.");
       }
     });
     if (this.addExtensionToMusicObjects.length === 0) {
-      throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Cannot add extension because music object to attach it to is undefined.");
+      throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Cannot add extension because music object to attach it to is undefined.");
     }
     this.disableExtension();
     this.requestLayout();
@@ -5451,10 +5835,11 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     this.doc.requestNewRow();
     this.disableExtension();
   }
-  addRhythmSymbol(voiceId, symbol) {
-    let { col } = symbol;
+  addRhythmSymbol(symbol) {
+    var _a, _b;
+    let { col, voiceId } = symbol;
     col.setVoiceSymbol(voiceId, symbol);
-    this.getVoiceSymbols(voiceId);
+    (_b = (_a = this.voiceSymbols)[voiceId]) != null ? _b : _a[voiceId] = [];
     this.voiceSymbols[voiceId].push(symbol);
     if (symbol.oldStyleTriplet) {
       this.createOldStyleTriplets(voiceId);
@@ -5467,25 +5852,40 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     let realNotes = notes.map((note) => typeof note === "string" ? import_theory9.Note.getNote(note) : note);
     let col = this.getRhythmColumn(voiceId);
     let noteGroup = new ObjNoteGroup(col, voiceId, realNotes, noteLength, options, tupletRatio);
-    this.addRhythmSymbol(voiceId, noteGroup);
+    this.addRhythmSymbol(noteGroup);
     return noteGroup;
   }
   addRest(voiceId, restLength, options, tupletRatio) {
     let col = this.getRhythmColumn(voiceId);
     let rest = new ObjRest(col, voiceId, restLength, options, tupletRatio);
-    this.addRhythmSymbol(voiceId, rest);
+    this.addRhythmSymbol(rest);
     return rest;
   }
+  addLyrics(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions) {
+    this.forEachStaffGroup(staffTabOrGroups, 1 /* Below */, (line, vpos) => {
+      let col = this.getRhythmColumn({ verse, line, vpos });
+      let lyricsContainer = col.getLyricsContainer(verse, line, vpos, (0, import_theory9.validateNoteLength)(lyricsLength));
+      if (lyricsContainer) {
+        let lyricsObj = new ObjLyrics(col, verse, line, vpos, lyricsText, lyricsOptions);
+        let lyricsArr = this.getLyricsObjects(lyricsObj.line, lyricsObj.vpos, lyricsObj.verse);
+        lyricsArr.push(lyricsObj);
+        lyricsArr.sort((a, b) => cmp2(a.col.positionTicks, b.col.positionTicks));
+        lyricsContainer.addLyricsObject(lyricsObj);
+        this.addLayoutObject(lyricsObj, line, getVerseLayoutGroupId(verse), vpos);
+      }
+      this.lastAddedRhythmColumn = col;
+    });
+  }
   /**
    * 
    * @param positionTicks - get ObjRhythmColumn with positionTicks. Insert new if necessary.
    * @returns 
    */
-  getRhythmColumn(voiceId) {
+  getRhythmColumn(arg) {
     let positionTicks = 0;
     for (let i = this.columns.length - 1; i >= 0 && positionTicks === 0; i--) {
       let col = this.columns[i];
-      let symbol = col.getVoiceSymbol(voiceId);
+      let symbol = typeof arg === "number" ? col.getVoiceSymbol(arg) : col.getLyricsContainer(arg.verse, arg.line, arg.vpos);
       if (symbol) {
         positionTicks = col.positionTicks + symbol.rhythmProps.ticks;
       }
@@ -5500,7 +5900,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
         return col2;
       }
     }
-    throw new import_core13.MusicError(import_core13.MusicErrorType.Score, "Error in rhythm column. Should never get here.");
+    throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Error in rhythm column. Should never get here.");
   }
   getMeasureTicks() {
     return this.getTimeSignature().measureTicks;
@@ -5552,6 +5952,38 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
   getStaffLineRight() {
     return this.barLineRight.getRect().centerX;
   }
+  getLyricsObjects(line, vpos, verse) {
+    let vposMap = this.lyricsObjectsCache.get(line);
+    if (vposMap === void 0) {
+      vposMap = /* @__PURE__ */ new Map();
+      this.lyricsObjectsCache.set(line, vposMap);
+    }
+    let verseMap = vposMap.get(vpos);
+    if (verseMap === void 0) {
+      verseMap = /* @__PURE__ */ new Map();
+      vposMap.set(vpos, verseMap);
+    }
+    let lyricsArr = verseMap.get(verse);
+    if (lyricsArr === void 0) {
+      lyricsArr = [];
+      verseMap.set(verse, lyricsArr);
+    }
+    return lyricsArr;
+  }
+  getPrevLyricsObject(lyricsObj) {
+    var _a;
+    let lyricsArr = this.getLyricsObjects(lyricsObj.line, lyricsObj.vpos, lyricsObj.verse);
+    let i = lyricsArr.indexOf(lyricsObj);
+    if (i > 0) {
+      return lyricsArr[i - 1];
+    } else if (i === 0) {
+      let lyricsArr2 = (_a = lyricsObj.measure.getPrevMeasure()) == null ? void 0 : _a.getLyricsObjects(lyricsObj.line, lyricsObj.vpos, lyricsObj.verse);
+      if (lyricsArr2 && lyricsArr2.length > 0) {
+        return lyricsArr2[lyricsArr2.length - 1];
+      }
+    }
+    return void 0;
+  }
   getStaticObjects(line) {
     let staticObjects = this.staticObjectsCache.get(line);
     if (!staticObjects) {
@@ -5641,52 +6073,77 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
         return false;
       }
     });
+    let ts = this.getTimeSignature();
+    if (!this.needBeamsUpdate || ts.beamGroupSizes.length === 0) {
+      return;
+    }
     getVoiceIds().forEach((voiceId) => {
-      let symbols = this.getVoiceSymbols(voiceId);
-      if (symbols.length <= 2) {
-        return;
-      }
-      if (!DebugSettings.DisableBeams) {
-        let groupSymbols = [];
+      let symbols = this.getVoiceSymbols(voiceId).slice();
+      if (symbols.length >= 2) {
+        let symbolsStartTicks = this.isUpBeat() ? Math.max(0, this.getMeasureTicks() - this.getConsumedTicks()) : 0;
         let groupStartTicks = 0;
-        let groupEndTicks = 0;
-        if (this.isUpBeat()) {
-          let startTicks = Math.max(0, this.getMeasureTicks() - this.getConsumedTicks());
-          groupStartTicks = groupEndTicks = startTicks;
-        }
-        let ts = this.getTimeSignature();
-        symbols.forEach((symbol) => {
-          groupSymbols.push(symbol);
-          groupEndTicks += symbol.rhythmProps.ticks;
-          if (groupStartTicks === 0 && groupEndTicks === ts.beamGroupLength) {
-            _ObjMeasure.setupBeamGroup(groupSymbols);
-          }
-          while (groupEndTicks >= ts.beamGroupLength) {
-            groupSymbols = [];
-            groupStartTicks = groupEndTicks = groupEndTicks - ts.beamGroupLength;
+        for (let groupId = 0; groupId < ts.beamGroupSizes.length; groupId++) {
+          let beamGroupSize = ts.beamGroupSizes[groupId];
+          let groupSizeSum = 0;
+          beamGroupSize.forEach((s) => groupSizeSum += s);
+          let groupLength = groupSizeSum * import_theory9.NoteLengthProps.get("8n").ticks;
+          let groupSymbols = [];
+          let groupSymbolsLength = 0;
+          while (symbols.length > 0 && groupSymbolsLength < groupLength) {
+            let symbol = symbols[0];
+            if (symbol.col.positionTicks >= groupStartTicks) {
+              groupSymbols.push(symbol);
+              groupSymbolsLength += symbol.rhythmProps.ticks;
+              symbols.shift();
+            } else {
+              break;
+            }
           }
-        });
+          _ObjMeasure.setupBeamGroup(groupSymbols, beamGroupSize);
+          symbolsStartTicks += groupSymbolsLength;
+          groupStartTicks += groupLength;
+        }
       }
     });
     this.needBeamsUpdate = false;
     this.requestLayout();
   }
-  static setupBeamGroup(groupSymbols) {
+  static setupBeamGroup(groupSymbols, mainBeamGroupSizeArr) {
+    if (mainBeamGroupSizeArr.length === 0) {
+      return false;
+    }
     let groupNotes = groupSymbols.map((s) => {
       var _a;
       return s instanceof ObjNoteGroup && ((_a = s.getBeamGroup()) == null ? void 0 : _a.isTuplet()) !== true ? s : void 0;
     });
     ObjNoteGroup.setBeamCounts(groupNotes);
-    let beamNotes = [];
-    groupNotes.forEach((noteGroup) => {
-      if (noteGroup && noteGroup.hasBeamCount()) {
-        beamNotes.push(noteGroup);
-      } else {
-        ObjBeamGroup.createBeam(beamNotes);
-        beamNotes = [];
-      }
-    });
-    ObjBeamGroup.createBeam(beamNotes);
+    let beamGroupSizeArrList = [mainBeamGroupSizeArr];
+    if (mainBeamGroupSizeArr.length > 1) {
+      let sum = 0;
+      mainBeamGroupSizeArr.forEach((s) => sum += s);
+      beamGroupSizeArrList.unshift([sum]);
+    }
+    let beamsCreated = false;
+    while (beamGroupSizeArrList.length > 0 && !beamsCreated) {
+      let beamGroupSizeArr = beamGroupSizeArrList.shift();
+      let groupSymbolsCopy = groupSymbols.slice();
+      beamGroupSizeArr.forEach((beamGroupSize) => {
+        var _a;
+        let beamGroupLength = beamGroupSize * import_theory9.NoteLengthProps.get("8n").ticks;
+        let beamNotesLength = 0;
+        let beamNotes = [];
+        while (beamNotesLength < beamGroupLength && groupSymbolsCopy.length > 0) {
+          let symbol = groupSymbolsCopy.shift();
+          beamNotesLength += symbol.rhythmProps.ticks;
+          beamNotes.push(symbol instanceof ObjNoteGroup && ((_a = symbol.getBeamGroup()) == null ? void 0 : _a.isTuplet()) !== true ? symbol : void 0);
+        }
+        if (beamNotesLength === beamGroupLength && beamNotes.every((n) => n !== void 0) && (beamNotes.every((n) => n.rhythmProps.flagCount === 1) || beamGroupSizeArrList.length === 0)) {
+          ObjBeamGroup.createBeam(beamNotes);
+          beamsCreated = true;
+        }
+      });
+    }
+    return beamsCreated;
   }
   getBarLineLeft() {
     return this.barLineLeft;
@@ -5695,10 +6152,9 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
     return this.barLineRight;
   }
   getVoiceSymbols(voiceId) {
+    var _a, _b;
     validateVoiceId(voiceId);
-    if (this.voiceSymbols[voiceId] === void 0) {
-      this.voiceSymbols[voiceId] = [];
-    }
+    (_b = (_a = this.voiceSymbols)[voiceId]) != null ? _b : _a[voiceId] = [];
     return this.voiceSymbols[voiceId];
   }
   completeRests(voiceId) {
@@ -5709,7 +6165,7 @@ var _ObjMeasure = class _ObjMeasure extends MusicObject {
         this.completeRests(getVoiceIds().filter((id) => this.getConsumedTicks(id) > 0));
       }
       return;
-    } else if (import_ts_utils_lib10.Utils.Is.isArray(voiceId)) {
+    } else if (import_ts_utils_lib12.Utils.Is.isArray(voiceId)) {
       voiceId.forEach((id) => this.completeRests(id));
       return;
     } else {
@@ -5824,7 +6280,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 = import_ts_utils_lib10.Utils.Math.sum(this.columns.map((col) => col.getRect().width));
+    let columnsWidth = import_ts_utils_lib12.Utils.Math.sum(this.columns.map((col) => col.getRect().width));
     let columnScale = columnsAreaWidth / columnsWidth;
     let columnLeft = columnsAreaLeft;
     this.columns.forEach((col) => {
@@ -5943,9 +6399,21 @@ __publicField(_ObjMeasure, "MinFlexContentWidth", 10);
 var ObjMeasure2 = _ObjMeasure;
 
 // src/score/engine/layout-object.ts
-var import_core14 = require("@tspro/web-music-score/core");
-var WidenColumnList = [1 /* NoteLabel */, 6 /* ChordLabel */];
-var RowAlignList = [2 /* Navigation */, 3 /* Ending */, 4 /* TempoAnnotation */, 5 /* DynamicsAnnotation */, 6 /* ChordLabel */];
+var import_core15 = require("@tspro/web-music-score/core");
+var WidenColumnList = [
+  1 /* NoteLabel */,
+  6 /* ChordLabel */
+];
+var RowAlignList = [
+  2 /* Navigation */,
+  3 /* Ending */,
+  4 /* TempoAnnotation */,
+  5 /* DynamicsAnnotation */,
+  6 /* ChordLabel */,
+  7 /* LyricsVerse1 */,
+  8 /* LyricsVerse2 */,
+  9 /* LyricsVerse3 */
+];
 function requireParentMeasure(p) {
   while (p) {
     if (p instanceof ObjMeasure2) {
@@ -5953,7 +6421,7 @@ function requireParentMeasure(p) {
     }
     p = p.getParent();
   }
-  throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Parent measure is required but not found!");
+  throw new import_core15.MusicError(import_core15.MusicErrorType.Score, "Parent measure is required but not found!");
 }
 var StaffGroup = class {
   constructor(groupName, staffsTabsAndGroups, verticalPosition) {
@@ -5977,7 +6445,7 @@ var LayoutObjectWrapper = class {
     this.row = this.measure.row;
     let anchor = this.musicObj.getParent();
     if (!anchor) {
-      throw new import_core14.MusicError(import_core14.MusicErrorType.Score, "Parent music object is required as an anchor.");
+      throw new import_core15.MusicError(import_core15.MusicErrorType.Score, "Parent music object is required as an anchor.");
     }
     this.anchor = anchor;
     this.anchor.addAnchoredLayoutObject(this);
@@ -6169,7 +6637,7 @@ var ObjStaff = class extends ObjNotationLine4 {
       this.clefLineDiatonicId = getDiatonicId("F3", staffConfig.isOctaveDown === true);
       this.middleLineDiatonicId = this.clefLineDiatonicId - 2;
     } else {
-      throw new import_core15.MusicError(import_core15.MusicErrorType.Score, `Invalid staffConfig.clef ${staffConfig.clef}.`);
+      throw new import_core16.MusicError(import_core16.MusicErrorType.Score, `Invalid staffConfig.clef ${staffConfig.clef}.`);
     }
     this.topLineDiatonicId = this.middleLineDiatonicId + 4;
     this.bottomLineDiatonicId = this.middleLineDiatonicId - 4;
@@ -6217,7 +6685,7 @@ var ObjStaff = class extends ObjNotationLine4 {
     } else if (this.joinedGrandStaff && this.joinedGrandStaff.containsDiatonicId(diatonicId)) {
       return this.joinedGrandStaff.getDiatonicIdY(diatonicId);
     } else {
-      throw new import_core15.MusicError(import_core15.MusicErrorType.Score, "Staff does not contain diatonicId " + diatonicId);
+      throw new import_core16.MusicError(import_core16.MusicErrorType.Score, "Staff does not contain diatonicId " + diatonicId);
     }
   }
   getActualStaff(diatonicId) {
@@ -6226,7 +6694,7 @@ var ObjStaff = class extends ObjNotationLine4 {
     } else if (this.joinedGrandStaff && this.joinedGrandStaff.containsDiatonicId(diatonicId)) {
       return this.joinedGrandStaff;
     } else {
-      throw new import_core15.MusicError(import_core15.MusicErrorType.Score, "Staff does not contain diatonicId " + diatonicId);
+      throw new import_core16.MusicError(import_core16.MusicErrorType.Score, "Staff does not contain diatonicId " + diatonicId);
     }
   }
   getDiatonicIdAt(y) {
@@ -6305,7 +6773,7 @@ var ObjTab = class extends ObjNotationLine4 {
     __publicField(this, "tuningName");
     __publicField(this, "tuningStrings");
     __publicField(this, "mi");
-    if (import_ts_utils_lib11.Utils.Is.isArray(tabConfig.tuning)) {
+    if (import_ts_utils_lib13.Utils.Is.isArray(tabConfig.tuning)) {
       this.tuningName = void 0;
       this.tuningStrings = tabConfig.tuning.map((noteName) => import_theory11.Note.getNote(noteName)).reverse();
     } else if (typeof tabConfig.tuning === "string") {
@@ -6395,7 +6863,7 @@ var ObjTab = class extends ObjNotationLine4 {
 };
 
 // src/score/engine/obj-score-row.ts
-var import_core16 = require("@tspro/web-music-score/core");
+var import_core17 = require("@tspro/web-music-score/core");
 var ObjScoreRow = class extends MusicObject {
   constructor(doc, prevRow, scoreConfig) {
     super(doc);
@@ -6453,7 +6921,7 @@ var ObjScoreRow = class extends MusicObject {
     if (topStaff) {
       return topStaff;
     } else {
-      throw new import_core16.MusicError(import_core16.MusicErrorType.Score, "Top staff is required!");
+      throw new import_core17.MusicError(import_core17.MusicErrorType.Score, "Top staff is required!");
     }
   }
   getBottomStaff() {
@@ -6461,7 +6929,7 @@ var ObjScoreRow = class extends MusicObject {
     if (bottomStaff) {
       return bottomStaff;
     } else {
-      throw new import_core16.MusicError(import_core16.MusicErrorType.Score, "Bottom staff is required!");
+      throw new import_core17.MusicError(import_core17.MusicErrorType.Score, "Bottom staff is required!");
     }
   }
   getStaff(diatonicId) {
@@ -6760,7 +7228,7 @@ var ObjHeader = class extends MusicObject {
 };
 
 // src/score/engine/obj-document.ts
-var import_ts_utils_lib12 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib14 = require("@tspro/ts-utils-lib");
 var ObjDocument = class extends MusicObject {
   constructor() {
     super(void 0);
@@ -6781,7 +7249,7 @@ var ObjDocument = class extends MusicObject {
     return this.mi;
   }
   setScoreConfiguration(config) {
-    if (import_ts_utils_lib12.Utils.Is.isEnumValue(config, StaffPreset)) {
+    if (import_ts_utils_lib14.Utils.Is.isEnumValue(config, StaffPreset)) {
       switch (config) {
         default:
         case "treble" /* Treble */:
@@ -6809,7 +7277,7 @@ var ObjDocument = class extends MusicObject {
           ];
           break;
       }
-    } else if (import_ts_utils_lib12.Utils.Is.isArray(config)) {
+    } else if (import_ts_utils_lib14.Utils.Is.isArray(config)) {
       this.curScoreConfig = config;
     } else {
       this.curScoreConfig = [config];
@@ -7036,10 +7504,10 @@ var ObjDocument = class extends MusicObject {
 
 // src/score/pub/document-builder.ts
 var import_theory13 = require("@tspro/web-music-score/theory");
-var import_core17 = require("@tspro/web-music-score/core");
+var import_core18 = require("@tspro/web-music-score/core");
 function assertArg(condition, argName, argValue) {
   if (!condition) {
-    throw new import_core17.MusicError(import_core17.MusicErrorType.Score, `Invalid arg: ${argName} = ${argValue}`);
+    throw new import_core18.MusicError(import_core18.MusicErrorType.Score, `Invalid arg: ${argName} = ${argValue}`);
   }
 }
 function isNote(note) {
@@ -7051,56 +7519,64 @@ function isNote(note) {
   }
 }
 function isVoiceId(value) {
-  return import_ts_utils_lib13.Utils.Is.isNumber(value) && getVoiceIds().indexOf(value) >= 0;
+  return import_ts_utils_lib15.Utils.Is.isNumber(value) && getVoiceIds().indexOf(value) >= 0;
 }
 function isStringNumber(value) {
-  return import_ts_utils_lib13.Utils.Is.isNumber(value) && getStringNumbers().indexOf(value) >= 0;
+  return import_ts_utils_lib15.Utils.Is.isNumber(value) && getStringNumbers().indexOf(value) >= 0;
+}
+function isVerseNumber(value) {
+  return import_ts_utils_lib15.Utils.Is.isNumber(value) && getVerseNumbers().indexOf(value) >= 0;
 }
 function assertStaffConfig(staffConfig) {
-  assertArg(import_ts_utils_lib13.Utils.Is.isObject(staffConfig), "staffConfig", staffConfig);
+  assertArg(import_ts_utils_lib15.Utils.Is.isObject(staffConfig), "staffConfig", staffConfig);
   assertArg(staffConfig.type === "staff", "staffConfig.type", staffConfig.type);
-  assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(staffConfig.clef, Clef), "staffConfig.clef", staffConfig.clef);
-  assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(staffConfig.isOctaveDown), "staffConfig.isOctaveDown", staffConfig.isOctaveDown);
-  assertArg(import_ts_utils_lib13.Utils.Is.isUndefined(staffConfig.minNote) || isNote(staffConfig.minNote), "staffConfig.minNote", staffConfig.minNote);
-  assertArg(import_ts_utils_lib13.Utils.Is.isUndefined(staffConfig.maxNote) || isNote(staffConfig.maxNote), "staffConfig.maxNote", staffConfig.maxNote);
-  assertArg(import_ts_utils_lib13.Utils.Is.isUndefined(staffConfig.voiceIds) || import_ts_utils_lib13.Utils.Is.isArray(staffConfig.voiceIds) && staffConfig.voiceIds.every((voiceId) => import_ts_utils_lib13.Utils.Is.isNumber(voiceId)), "staffConfig.voiceIds", staffConfig.voiceIds);
-  assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(staffConfig.isGrand), "staffConfig.isGrand", staffConfig.isGrand);
+  assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(staffConfig.clef, Clef), "staffConfig.clef", staffConfig.clef);
+  assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(staffConfig.isOctaveDown), "staffConfig.isOctaveDown", staffConfig.isOctaveDown);
+  assertArg(import_ts_utils_lib15.Utils.Is.isUndefined(staffConfig.minNote) || isNote(staffConfig.minNote), "staffConfig.minNote", staffConfig.minNote);
+  assertArg(import_ts_utils_lib15.Utils.Is.isUndefined(staffConfig.maxNote) || isNote(staffConfig.maxNote), "staffConfig.maxNote", staffConfig.maxNote);
+  assertArg(import_ts_utils_lib15.Utils.Is.isUndefined(staffConfig.voiceIds) || import_ts_utils_lib15.Utils.Is.isArray(staffConfig.voiceIds) && staffConfig.voiceIds.every((voiceId) => import_ts_utils_lib15.Utils.Is.isNumber(voiceId)), "staffConfig.voiceIds", staffConfig.voiceIds);
+  assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(staffConfig.isGrand), "staffConfig.isGrand", staffConfig.isGrand);
 }
 function assertTabConfig(tabConfig) {
-  assertArg(import_ts_utils_lib13.Utils.Is.isObject(tabConfig), "tabConfig", tabConfig);
+  assertArg(import_ts_utils_lib15.Utils.Is.isObject(tabConfig), "tabConfig", tabConfig);
   assertArg(tabConfig.type === "tab", "tabConfig.type", tabConfig.type);
   if (typeof tabConfig.tuning === "string") {
     assertArg(import_theory13.TuningNameList.includes(tabConfig.tuning), "tabConfig.tuning", tabConfig.tuning);
-  } else if (import_ts_utils_lib13.Utils.Is.isArray(tabConfig.tuning)) {
+  } else if (import_ts_utils_lib15.Utils.Is.isArray(tabConfig.tuning)) {
     assertArg(tabConfig.tuning.length === getStringNumbers().length && tabConfig.tuning.every((s) => isNote(s)), "tabConfig.tuning", tabConfig.tuning);
   }
-  assertArg(import_ts_utils_lib13.Utils.Is.isUndefined(tabConfig.voiceIds) || import_ts_utils_lib13.Utils.Is.isArray(tabConfig.voiceIds) && tabConfig.voiceIds.every((voiceId) => import_ts_utils_lib13.Utils.Is.isNumber(voiceId)), "tabConfig.voiceIds", tabConfig.voiceIds);
+  assertArg(import_ts_utils_lib15.Utils.Is.isUndefined(tabConfig.voiceIds) || import_ts_utils_lib15.Utils.Is.isArray(tabConfig.voiceIds) && tabConfig.voiceIds.every((voiceId) => import_ts_utils_lib15.Utils.Is.isNumber(voiceId)), "tabConfig.voiceIds", tabConfig.voiceIds);
+}
+function assertNoteOptions(noteOptions) {
+  assertArg(import_ts_utils_lib15.Utils.Is.isObject(noteOptions), "noteOptions", noteOptions);
+  assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(noteOptions.dotted) || import_ts_utils_lib15.Utils.Is.isIntegerGte(noteOptions.dotted, 0), "noteOptions.dotted", noteOptions.dotted);
+  assertArg(import_ts_utils_lib15.Utils.Is.isEnumValueOrUndefined(noteOptions.stem, Stem), "noteOptions.stem", noteOptions.stem);
+  assertArg(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(noteOptions.color), "noteOptions.color", noteOptions.color);
+  assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(noteOptions.arpeggio) || import_ts_utils_lib15.Utils.Is.isEnumValue(noteOptions.arpeggio, Arpeggio), "noteOptions.arpeggio", noteOptions.arpeggio);
+  assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(noteOptions.staccato), "noteOptions.staccato", noteOptions.staccato);
+  assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(noteOptions.diamond), "noteOptions.diamond", noteOptions.diamond);
+  assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(noteOptions.triplet), "noteOptions.triplet", noteOptions.triplet);
+  assertArg(import_ts_utils_lib15.Utils.Is.isUndefined(noteOptions.string) || isStringNumber(noteOptions.string) || import_ts_utils_lib15.Utils.Is.isNonEmptyArray(noteOptions.string) && noteOptions.string.every((string) => isStringNumber(string)), "noteOptions.string", noteOptions.string);
+  assertArg(import_ts_utils_lib15.Utils.Is.isUndefined(noteOptions.tieSpan), 'NoteOptions.tieSpan was removed. Use addConnective("tie", tieSpan)', "");
+  assertArg(import_ts_utils_lib15.Utils.Is.isUndefined(noteOptions.slurSpan), 'NoteOptions.slurSpan was removed. Use addConnective("slur", slurSpan)', "");
 }
-function assertNoteOptions(options) {
-  assertArg(import_ts_utils_lib13.Utils.Is.isObject(options), "noteOptions", options);
-  assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(options.dotted) || import_ts_utils_lib13.Utils.Is.isIntegerGte(options.dotted, 0), "noteOptions.dotted", options.dotted);
-  assertArg(import_ts_utils_lib13.Utils.Is.isEnumValueOrUndefined(options.stem, Stem), "noteOptions.stem", options.stem);
-  assertArg(import_ts_utils_lib13.Utils.Is.isStringOrUndefined(options.color), "noteOptions.color", options.color);
-  assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(options.arpeggio) || import_ts_utils_lib13.Utils.Is.isEnumValue(options.arpeggio, Arpeggio), "noteOptions.arpeggio", options.arpeggio);
-  assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(options.staccato), "noteOptions.staccato", options.staccato);
-  assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(options.diamond), "noteOptions.diamond", options.diamond);
-  assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(options.triplet), "noteOptions.triplet", options.triplet);
-  assertArg(import_ts_utils_lib13.Utils.Is.isUndefined(options.string) || isStringNumber(options.string) || import_ts_utils_lib13.Utils.Is.isNonEmptyArray(options.string) && options.string.every((string) => isStringNumber(string)), "noteOptions.string", options.string);
-  assertArg(import_ts_utils_lib13.Utils.Is.isUndefined(options.tieSpan), 'NoteOptions.tieSpan was removed. Use addConnective("tie", tieSpan)', "");
-  assertArg(import_ts_utils_lib13.Utils.Is.isUndefined(options.slurSpan), 'NoteOptions.slurSpan was removed. Use addConnective("slur", slurSpan)', "");
+function assertRestOptions(restOptions) {
+  assertArg(import_ts_utils_lib15.Utils.Is.isObject(restOptions), "restOptions", restOptions);
+  assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(restOptions.dotted) || import_ts_utils_lib15.Utils.Is.isIntegerGte(restOptions.dotted, 0), "restOptions.dotted", restOptions.dotted);
+  assertArg(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(restOptions.staffPos) || import_ts_utils_lib15.Utils.Is.isInteger(restOptions.staffPos) || restOptions.staffPos instanceof import_theory13.Note, "restOptions.staffPos", restOptions.staffPos);
+  assertArg(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(restOptions.color), "restOptions.color", restOptions.color);
+  assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(restOptions.hide), "restOptions.hide", restOptions.hide);
+  assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(restOptions.triplet), "restOptions.triplet", restOptions.triplet);
 }
-function assertRestOptions(options) {
-  assertArg(import_ts_utils_lib13.Utils.Is.isObject(options), "restOptions", options);
-  assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(options.dotted) || import_ts_utils_lib13.Utils.Is.isIntegerGte(options.dotted, 0), "restOptions.dotted", options.dotted);
-  assertArg(import_ts_utils_lib13.Utils.Is.isStringOrUndefined(options.staffPos) || import_ts_utils_lib13.Utils.Is.isInteger(options.staffPos) || options.staffPos instanceof import_theory13.Note, "restOptions.staffPos", options.staffPos);
-  assertArg(import_ts_utils_lib13.Utils.Is.isStringOrUndefined(options.color), "restOptions.color", options.color);
-  assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(options.hide), "restOptions.hide", options.hide);
-  assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(options.triplet), "restOptions.triplet", options.triplet);
+function assertLyricsOptions(lyricsOptions) {
+  assertArg(import_ts_utils_lib15.Utils.Is.isObject(lyricsOptions), "lyricsOptions", lyricsOptions);
+  assertArg(import_ts_utils_lib15.Utils.Is.isEnumValueOrUndefined(lyricsOptions.align, LyricsAlign), "lyricsOptions.align", lyricsOptions.align);
+  assertArg(import_ts_utils_lib15.Utils.Is.isEnumValueOrUndefined(lyricsOptions.hyphen, LyricsHyphen), "lyricsOptions.hyphen", lyricsOptions.hyphen);
 }
 function assertStaffTabOrGRoups(staffTabOrGroups) {
   assertArg(
-    import_ts_utils_lib13.Utils.Is.isStringOrUndefined(staffTabOrGroups) || import_ts_utils_lib13.Utils.Is.isIntegerGte(staffTabOrGroups, 0) || import_ts_utils_lib13.Utils.Is.isNonEmptyArray(staffTabOrGroups) && staffTabOrGroups.every(
-      (staffTabOrGroup) => import_ts_utils_lib13.Utils.Is.isString(staffTabOrGroup) || import_ts_utils_lib13.Utils.Is.isIntegerGte(staffTabOrGroup, 0)
+    import_ts_utils_lib15.Utils.Is.isStringOrUndefined(staffTabOrGroups) || import_ts_utils_lib15.Utils.Is.isIntegerGte(staffTabOrGroups, 0) || import_ts_utils_lib15.Utils.Is.isNonEmptyArray(staffTabOrGroups) && staffTabOrGroups.every(
+      (staffTabOrGroup) => import_ts_utils_lib15.Utils.Is.isString(staffTabOrGroup) || import_ts_utils_lib15.Utils.Is.isIntegerGte(staffTabOrGroup, 0)
     ),
     "staffTabOrGroup",
     staffTabOrGroups
@@ -7128,22 +7604,23 @@ var DocumentBuilder = class {
    */
   constructor() {
     __publicField(this, "doc");
+    __publicField(this, "currentLyricsAlign", "center" /* Center */);
     this.doc = new ObjDocument();
   }
   setScoreConfiguration(config) {
-    if (import_ts_utils_lib13.Utils.Is.isEnumValue(config, StaffPreset)) {
+    if (import_ts_utils_lib15.Utils.Is.isEnumValue(config, StaffPreset)) {
       this.doc.setScoreConfiguration(config);
-    } else if (import_ts_utils_lib13.Utils.Is.isObject(config) && config.type === "staff") {
+    } else if (import_ts_utils_lib15.Utils.Is.isObject(config) && config.type === "staff") {
       assertStaffConfig(config);
       this.doc.setScoreConfiguration(config);
-    } else if (import_ts_utils_lib13.Utils.Is.isObject(config) && config.type === "tab") {
+    } else if (import_ts_utils_lib15.Utils.Is.isObject(config) && config.type === "tab") {
       assertTabConfig(config);
       this.doc.setScoreConfiguration(config);
-    } else if (import_ts_utils_lib13.Utils.Is.isNonEmptyArray(config)) {
+    } else if (import_ts_utils_lib15.Utils.Is.isNonEmptyArray(config)) {
       config.forEach((c) => {
-        if (import_ts_utils_lib13.Utils.Is.isObject(c) && c.type === "staff") {
+        if (import_ts_utils_lib15.Utils.Is.isObject(c) && c.type === "staff") {
           assertStaffConfig(c);
-        } else if (import_ts_utils_lib13.Utils.Is.isObject(c) && c.type === "tab") {
+        } else if (import_ts_utils_lib15.Utils.Is.isObject(c) && c.type === "tab") {
           assertTabConfig(c);
         } else {
           assertArg(false, "config", config);
@@ -7174,9 +7651,9 @@ var DocumentBuilder = class {
    * @returns - This document builder instance.
    */
   setHeader(title, composer, arranger) {
-    assertArg(import_ts_utils_lib13.Utils.Is.isStringOrUndefined(title), "title", title);
-    assertArg(import_ts_utils_lib13.Utils.Is.isStringOrUndefined(composer), "composer", composer);
-    assertArg(import_ts_utils_lib13.Utils.Is.isStringOrUndefined(arranger), "arranger", arranger);
+    assertArg(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(title), "title", title);
+    assertArg(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(composer), "composer", composer);
+    assertArg(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(arranger), "arranger", arranger);
     this.doc.setHeader(title, composer, arranger);
     return this;
   }
@@ -7186,7 +7663,7 @@ var DocumentBuilder = class {
    * @returns - This document builder instance.
    */
   setMeasuresPerRow(measuresPerRow) {
-    assertArg(import_ts_utils_lib13.Utils.Is.isIntegerGte(measuresPerRow, 1) || import_ts_utils_lib13.Utils.Is.isPosInfinity(measuresPerRow), "measuresPerRow", measuresPerRow);
+    assertArg(import_ts_utils_lib15.Utils.Is.isIntegerGte(measuresPerRow, 1) || import_ts_utils_lib15.Utils.Is.isPosInfinity(measuresPerRow), "measuresPerRow", measuresPerRow);
     this.doc.setMeasuresPerRow(measuresPerRow);
     return this;
   }
@@ -7199,80 +7676,88 @@ var DocumentBuilder = class {
     return this;
   }
   setKeySignature(...args) {
-    assertArg(args[0] instanceof import_theory13.Scale || args[0] instanceof import_theory13.KeySignature || import_ts_utils_lib13.Utils.Is.isNonEmptyString(args[0]) && (args.length === 1 || import_ts_utils_lib13.Utils.Is.isEnumValue(args[1], import_theory13.ScaleType)), "keySignature", args);
+    assertArg(args[0] instanceof import_theory13.Scale || args[0] instanceof import_theory13.KeySignature || import_ts_utils_lib15.Utils.Is.isNonEmptyString(args[0]) && (args.length === 1 || import_ts_utils_lib15.Utils.Is.isEnumValue(args[1], import_theory13.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 import_theory13.TimeSignature || import_ts_utils_lib13.Utils.Is.isNonEmptyString(timeSignature), "timeSignature", timeSignature);
-    this.getMeasure().setTimeSignature(timeSignature);
+  setTimeSignature(...args) {
+    if (args[0] instanceof import_theory13.TimeSignature) {
+      this.getMeasure().setTimeSignature(args[0]);
+    } else if (import_ts_utils_lib15.Utils.Is.isEnumValue(args[0], import_theory13.TimeSignatures) && import_ts_utils_lib15.Utils.Is.isEnumValueOrUndefined(args[1], import_theory13.BeamGrouping)) {
+      this.getMeasure().setTimeSignature(new import_theory13.TimeSignature(args[0], args[1]));
+    } else if (import_ts_utils_lib15.Utils.Is.isIntegerGte(args[0], 1) && import_ts_utils_lib15.Utils.Is.isIntegerGte(args[1], 1) && import_ts_utils_lib15.Utils.Is.isEnumValueOrUndefined(args[2], import_theory13.BeamGrouping)) {
+      this.getMeasure().setTimeSignature(new import_theory13.TimeSignature(args[0], args[1], args[2]));
+    } else {
+      assertArg(false, "timeSignature args", args);
+    }
     return this;
   }
   setTempo(beatsPerMinute, beatLength, dotted) {
-    assertArg(import_ts_utils_lib13.Utils.Is.isIntegerGte(beatsPerMinute, 1), "beatsPerMinute", beatsPerMinute);
+    assertArg(import_ts_utils_lib15.Utils.Is.isIntegerGte(beatsPerMinute, 1), "beatsPerMinute", beatsPerMinute);
     if (beatLength === void 0) {
-      assertArg(import_ts_utils_lib13.Utils.Is.isUndefined(dotted), "dotted", dotted);
+      assertArg(import_ts_utils_lib15.Utils.Is.isUndefined(dotted), "dotted", dotted);
     } else {
-      assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(beatLength, import_theory13.NoteLength) || isNoteLength(beatLength), "beatLength", beatLength);
-      assertArg(import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(dotted) || import_ts_utils_lib13.Utils.Is.isIntegerGte(dotted, 0), "dotted", dotted);
+      assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(beatLength, import_theory13.NoteLength) || isNoteLength(beatLength), "beatLength", beatLength);
+      assertArg(import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(dotted) || import_ts_utils_lib15.Utils.Is.isIntegerGte(dotted, 0), "dotted", dotted);
     }
     this.getMeasure().setTempo(beatsPerMinute, beatLength, dotted);
     return this;
   }
   /**
-   * Add note o current measure.
+   * Add note to current measure.
    * @param voiceId - Voice id to add note to.
-   * @param note - Note instance of Note or string (e.g. "D4").
+   * @param note - Instance of Note or string, single value (e.g. "C4") or array (e.g. ["C4", "E4", "G4"]).
    * @param noteLength - Note length (e.g. "4n").
-   * @param options - Note options.
+   * @param noteOptions - Note options.
    * @returns - This document builder instance.
    */
-  addNote(voiceId, note, noteLength, options) {
+  addNote(voiceId, note, noteLength, noteOptions) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
-    assertArg(note instanceof import_theory13.Note || import_ts_utils_lib13.Utils.Is.isNonEmptyString(note), "note", note);
-    assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(noteLength, import_theory13.NoteLength) || isNoteLength(noteLength), "noteLength", noteLength);
-    if (options !== void 0) {
-      assertNoteOptions(options);
+    assertArg(
+      note instanceof import_theory13.Note || import_ts_utils_lib15.Utils.Is.isNonEmptyString(note) || import_ts_utils_lib15.Utils.Is.isArray(note) && note.every((note2) => note2 instanceof import_theory13.Note || import_ts_utils_lib15.Utils.Is.isNonEmptyString(note2)),
+      "note",
+      note
+    );
+    assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(noteLength, import_theory13.NoteLength) || isNoteLength(noteLength), "noteLength", noteLength);
+    noteOptions != null ? noteOptions : noteOptions = {};
+    assertNoteOptions(noteOptions);
+    if (import_ts_utils_lib15.Utils.Is.isArray(note)) {
+      note.forEach((note2) => this.getMeasure().addNoteGroup(voiceId, [note2], noteLength, noteOptions));
+    } else {
+      this.getMeasure().addNoteGroup(voiceId, [note], noteLength, noteOptions);
     }
-    this.getMeasure().addNoteGroup(voiceId, [note], noteLength, options);
     return this;
   }
   /**
+   * Add chord to current measure.
    * @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. 
+   * @param noteOptions - Note options. 
    * @returns - This document builder instance.
    */
-  addChord(voiceId, notes, noteLength, options) {
+  addChord(voiceId, notes, noteLength, noteOptions) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
-    assertArg(import_ts_utils_lib13.Utils.Is.isNonEmptyArray(notes) && notes.every((note) => note instanceof import_theory13.Note || import_ts_utils_lib13.Utils.Is.isNonEmptyString(note)), "notes", notes);
-    assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(noteLength, import_theory13.NoteLength) || isNoteLength(noteLength), "noteLength", noteLength);
-    if (options !== void 0) {
-      assertNoteOptions(options);
-    }
-    this.getMeasure().addNoteGroup(voiceId, notes, noteLength, options);
+    assertArg(import_ts_utils_lib15.Utils.Is.isNonEmptyArray(notes) && notes.every((note) => note instanceof import_theory13.Note || import_ts_utils_lib15.Utils.Is.isNonEmptyString(note)), "notes", notes);
+    assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(noteLength, import_theory13.NoteLength) || isNoteLength(noteLength), "noteLength", noteLength);
+    noteOptions != null ? noteOptions : noteOptions = {};
+    assertNoteOptions(noteOptions);
+    this.getMeasure().addNoteGroup(voiceId, notes, noteLength, noteOptions);
     return this;
   }
   /**
-   * 
+   * Add rest to current measure.
    * @param voiceId - Voice id to add rest to.
    * @param restLength - Rest length (e.g. "4n").  
-   * @param options - Rest options.
+   * @param restOptions - Rest options.
    * @returns - This document builder instance.
    */
-  addRest(voiceId, restLength, options) {
+  addRest(voiceId, restLength, restOptions) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
-    assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(restLength, import_theory13.NoteLength) || isNoteLength(restLength), "restLength", restLength);
-    if (options !== void 0) {
-      assertRestOptions(options);
-    }
-    this.getMeasure().addRest(voiceId, restLength, options);
+    assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(restLength, import_theory13.NoteLength) || isNoteLength(restLength), "restLength", restLength);
+    restOptions != null ? restOptions : restOptions = {};
+    assertRestOptions(restOptions);
+    this.getMeasure().addRest(voiceId, restLength, restOptions);
     return this;
   }
   /**
@@ -7292,39 +7777,47 @@ var DocumentBuilder = class {
    */
   addTuplet(voiceId, tupletRatio, tupletBuilder) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
-    assertArg(import_ts_utils_lib13.Utils.Is.isFunction(tupletBuilder), "tupletBuilder", tupletBuilder);
-    assertArg(isTupletRatio(tupletRatio) && import_ts_utils_lib13.Utils.Is.isBooleanOrUndefined(tupletRatio.showRatio), "tupletRatio", tupletRatio);
+    assertArg(import_ts_utils_lib15.Utils.Is.isFunction(tupletBuilder), "tupletBuilder", tupletBuilder);
+    assertArg(isTupletRatio(tupletRatio) && import_ts_utils_lib15.Utils.Is.isBooleanOrUndefined(tupletRatio.showRatio), "tupletRatio", tupletRatio);
     let tupletSymbols = [];
     const helper = {
-      addNote: (note, noteLength, options) => {
-        assertArg(note instanceof import_theory13.Note || import_ts_utils_lib13.Utils.Is.isNonEmptyString(note), "note", note);
-        assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(noteLength, import_theory13.NoteLength) || isNoteLength(noteLength), "noteLength", noteLength);
-        if (options !== void 0) {
-          delete options.triplet;
-          assertNoteOptions(options);
+      addNote: (note, noteLength, noteOptions) => {
+        assertArg(
+          note instanceof import_theory13.Note || import_ts_utils_lib15.Utils.Is.isNonEmptyString(note) || import_ts_utils_lib15.Utils.Is.isArray(note) && note.every((note2) => note2 instanceof import_theory13.Note || import_ts_utils_lib15.Utils.Is.isNonEmptyString(note2)),
+          "note",
+          note
+        );
+        assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(noteLength, import_theory13.NoteLength) || isNoteLength(noteLength), "noteLength", noteLength);
+        noteOptions != null ? noteOptions : noteOptions = {};
+        delete noteOptions.triplet;
+        assertNoteOptions(noteOptions);
+        if (import_ts_utils_lib15.Utils.Is.isArray(note)) {
+          note.forEach((note2) => {
+            let s = this.getMeasure().addNoteGroup(voiceId, [note2], noteLength, noteOptions, tupletRatio);
+            tupletSymbols.push(s);
+          });
+        } else {
+          let s = this.getMeasure().addNoteGroup(voiceId, [note], noteLength, noteOptions, tupletRatio);
+          tupletSymbols.push(s);
         }
-        let s = this.getMeasure().addNoteGroup(voiceId, [note], noteLength, options, tupletRatio);
-        tupletSymbols.push(s);
         return helper;
       },
-      addChord: (notes, noteLength, options) => {
-        assertArg(import_ts_utils_lib13.Utils.Is.isNonEmptyArray(notes) && notes.every((note) => note instanceof import_theory13.Note || import_ts_utils_lib13.Utils.Is.isNonEmptyString(note)), "notes", notes);
-        assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(noteLength, import_theory13.NoteLength) || isNoteLength(noteLength), "noteLength", noteLength);
-        if (options !== void 0) {
-          delete options.triplet;
-          assertNoteOptions(options);
-        }
-        let s = this.getMeasure().addNoteGroup(voiceId, notes, noteLength, options, tupletRatio);
+      addChord: (notes, noteLength, noteOptions) => {
+        assertArg(import_ts_utils_lib15.Utils.Is.isNonEmptyArray(notes) && notes.every((note) => note instanceof import_theory13.Note || import_ts_utils_lib15.Utils.Is.isNonEmptyString(note)), "notes", notes);
+        assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(noteLength, import_theory13.NoteLength) || isNoteLength(noteLength), "noteLength", noteLength);
+        noteOptions != null ? noteOptions : noteOptions = {};
+        delete noteOptions.triplet;
+        assertNoteOptions(noteOptions);
+        let s = this.getMeasure().addNoteGroup(voiceId, notes, noteLength, noteOptions, tupletRatio);
         tupletSymbols.push(s);
         return helper;
       },
-      addRest: (restLength, options) => {
-        assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(restLength, import_theory13.NoteLength) || isNoteLength(restLength), "restLength", restLength);
-        if (options !== void 0) {
-          delete options.triplet;
-          assertRestOptions(options);
-        }
-        let s = this.getMeasure().addRest(voiceId, restLength, options, tupletRatio);
+      addRest: (restLength, restOptions) => {
+        assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(restLength, import_theory13.NoteLength) || isNoteLength(restLength), "restLength", restLength);
+        restOptions != null ? restOptions : restOptions = {};
+        delete restOptions.triplet;
+        assertRestOptions(restOptions);
+        let s = this.getMeasure().addRest(voiceId, restLength, restOptions, tupletRatio);
         tupletSymbols.push(s);
         return helper;
       }
@@ -7333,9 +7826,52 @@ var DocumentBuilder = class {
     ObjBeamGroup.createTuplet(tupletSymbols, tupletRatio);
     return this;
   }
+  addLyricsInternal(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions) {
+    var _a;
+    assertStaffTabOrGRoups(staffTabOrGroups);
+    assertArg(isVerseNumber(verse), "verse", verse);
+    assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(lyricsLength, import_theory13.NoteLength), "lyricsLength", lyricsLength);
+    assertArg(import_ts_utils_lib15.Utils.Is.isString(lyricsText) || import_ts_utils_lib15.Utils.Is.isArray(lyricsText) && lyricsText.every((text) => import_ts_utils_lib15.Utils.Is.isString(text)), "lyricsText", lyricsText);
+    lyricsOptions != null ? lyricsOptions : lyricsOptions = {};
+    assertLyricsOptions(lyricsOptions);
+    if (lyricsOptions.align !== void 0) {
+      this.currentLyricsAlign = lyricsOptions.align;
+    } else {
+      (_a = lyricsOptions.align) != null ? _a : lyricsOptions.align = this.currentLyricsAlign;
+    }
+    if (import_ts_utils_lib15.Utils.Is.isArray(lyricsText)) {
+      lyricsText.forEach((text) => this.getMeasure().addLyrics(staffTabOrGroups, verse, lyricsLength, text, lyricsOptions));
+    } else {
+      this.getMeasure().addLyrics(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions);
+    }
+    return this;
+  }
+  /**
+   * Add lyrics to current measure.
+   * @param verse - Verse number (e.g. 1).
+   * @param lyricsLength - Lyrics text length (e.g. "2n").
+   * @param lyricsText - Lyrics text (empty space if omitted), single value or array.
+   * @param lyricsOptions - Lyrics options.
+   * @returns - This document builder instance.
+   */
+  addLyrics(verse, lyricsLength, lyricsText, lyricsOptions) {
+    return this.addLyricsInternal(void 0, verse, lyricsLength, lyricsText != null ? lyricsText : "", lyricsOptions);
+  }
+  /**
+   * Add lyrics to current measure to given staff/tab/group.
+   * @param staffTabOrGroups - staff/tab index (0=top), staff/tab name, or staff group name.
+   * @param verse - Verse number (e.g. 1).
+   * @param lyricsLength - Lyrics text length (e.g. "2n").
+   * @param lyricsText - Lyrics text (empty space if omitted), single value or array.
+   * @param lyricsOptions - Lyrics options.
+   * @returns - This document builder instance.
+   */
+  addLyricsTo(staffTabOrGroups, verse, lyricsLength, lyricsText, lyricsOptions) {
+    return this.addLyricsInternal(staffTabOrGroups, verse, lyricsLength, lyricsText != null ? lyricsText : "", lyricsOptions);
+  }
   addFermataInternal(staffTabOrGroups, fermata) {
     assertStaffTabOrGRoups(staffTabOrGroups);
-    assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(fermata, Fermata), "fermata", fermata);
+    assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(fermata, Fermata), "fermata", fermata);
     this.getMeasure().addFermata(staffTabOrGroups, fermata);
     return this;
   }
@@ -7358,11 +7894,11 @@ var DocumentBuilder = class {
   }
   addNavigationInternal(staffTabOrGroups, navigation, ...args) {
     assertStaffTabOrGRoups(staffTabOrGroups);
-    assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(navigation, Navigation), "navigation", navigation);
+    assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(navigation, Navigation), "navigation", navigation);
     if (navigation === "endRepeat" /* EndRepeat */ && args.length > 0) {
-      assertArg(import_ts_utils_lib13.Utils.Is.isIntegerGte(args[0], 1), "playCount", args[0]);
+      assertArg(import_ts_utils_lib15.Utils.Is.isIntegerGte(args[0], 1), "playCount", args[0]);
     } else if (navigation === "ending" /* Ending */ && args.length > 0) {
-      assertArg(args.every((passage) => import_ts_utils_lib13.Utils.Is.isIntegerGte(passage, 1)), "passages", args);
+      assertArg(args.every((passage) => import_ts_utils_lib15.Utils.Is.isIntegerGte(passage, 1)), "passages", args);
     }
     this.getMeasure().addNavigation(staffTabOrGroups, navigation, ...args);
     return this;
@@ -7376,11 +7912,11 @@ var DocumentBuilder = class {
   addAnnotationInternal(staffTabOrGroups, annotation, text) {
     annotation != null ? annotation : annotation = getAnnotation(text);
     if (annotation === void 0) {
-      throw new import_core17.MusicError(import_core17.MusicErrorType.Score, `Annotation text "${text}" is not known annotation.`);
+      throw new import_core18.MusicError(import_core18.MusicErrorType.Score, `Annotation text "${text}" is not known annotation.`);
     }
     assertStaffTabOrGRoups(staffTabOrGroups);
-    assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(annotation, Annotation), "annotation", annotation);
-    assertArg(import_ts_utils_lib13.Utils.Is.isNonEmptyString(text), "text", text);
+    assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(annotation, Annotation), "annotation", annotation);
+    assertArg(import_ts_utils_lib15.Utils.Is.isNonEmptyString(text), "text", text);
     this.getMeasure().addAnnotation(staffTabOrGroups, annotation, text);
     return this;
   }
@@ -7400,8 +7936,8 @@ var DocumentBuilder = class {
   }
   addLabelInternal(staffTabOrGroups, label, text) {
     assertStaffTabOrGRoups(staffTabOrGroups);
-    assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(label, Label), "label", label);
-    assertArg(import_ts_utils_lib13.Utils.Is.isNonEmptyString(text), "text", text);
+    assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(label, Label), "label", label);
+    assertArg(import_ts_utils_lib15.Utils.Is.isNonEmptyString(text), "text", text);
     this.getMeasure().addLabel(staffTabOrGroups, label, text);
     return this;
   }
@@ -7425,21 +7961,21 @@ var DocumentBuilder = class {
     return this.addLabelInternal(staffTabOrGroups, label, text);
   }
   addConnective(connective, ...args) {
-    assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(connective, Connective), "connective", connective);
+    assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(connective, Connective), "connective", connective);
     if (connective === "tie" /* Tie */) {
-      assertArg(import_ts_utils_lib13.Utils.Is.isIntegerOrUndefined(args[0]) || import_ts_utils_lib13.Utils.Is.isEnumValue(args[0], TieType), "tieSpan", args[0]);
-      assertArg(import_ts_utils_lib13.Utils.Is.isEnumValueOrUndefined(args[1], NoteAnchor), "noteAnchor", args[1]);
+      assertArg(import_ts_utils_lib15.Utils.Is.isIntegerOrUndefined(args[0]) || import_ts_utils_lib15.Utils.Is.isEnumValue(args[0], TieType), "tieSpan", args[0]);
+      assertArg(import_ts_utils_lib15.Utils.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 === "slur" /* Slur */) {
-      assertArg(import_ts_utils_lib13.Utils.Is.isIntegerOrUndefined(args[0]), "slurSpan", args[0]);
-      assertArg(import_ts_utils_lib13.Utils.Is.isEnumValueOrUndefined(args[1], NoteAnchor), "noteAnchor", args[1]);
+      assertArg(import_ts_utils_lib15.Utils.Is.isIntegerOrUndefined(args[0]), "slurSpan", args[0]);
+      assertArg(import_ts_utils_lib15.Utils.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 === "slide" /* Slide */) {
-      assertArg(import_ts_utils_lib13.Utils.Is.isEnumValueOrUndefined(args[0], NoteAnchor), "noteAnchor", args[0]);
+      assertArg(import_ts_utils_lib15.Utils.Is.isEnumValueOrUndefined(args[0], NoteAnchor), "noteAnchor", args[0]);
       let noteAnchor = args[0];
       this.getMeasure().addConnective(connective, noteAnchor);
     }
@@ -7458,18 +7994,18 @@ var DocumentBuilder = class {
    * @returns - This document builder instance.
    */
   addExtension(extensionBuilder) {
-    assertArg(import_ts_utils_lib13.Utils.Is.isFunctionOrUndefined(extensionBuilder), "addExtension() has new usage, for e.g. addExtension(ext => ext.measures(2)). Please refer to README or API Reference.", extensionBuilder);
+    assertArg(import_ts_utils_lib15.Utils.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(import_ts_utils_lib13.Utils.Is.isEnumValue(noteLength, import_theory13.NoteLength) || isNoteLength(noteLength), "noteLength", noteLength);
-        assertArg(import_ts_utils_lib13.Utils.Is.isUndefined(noteCount) || import_ts_utils_lib13.Utils.Is.isNumber(noteCount) && noteCount >= 0, "noteCount", noteCount);
+        assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(noteLength, import_theory13.NoteLength) || isNoteLength(noteLength), "noteLength", noteLength);
+        assertArg(import_ts_utils_lib15.Utils.Is.isUndefined(noteCount) || import_ts_utils_lib15.Utils.Is.isNumber(noteCount) && noteCount >= 0, "noteCount", noteCount);
         ticks += import_theory13.RhythmProps.get(noteLength).ticks * (noteCount != null ? noteCount : 1);
         return helper;
       },
       measures: (measureCount) => {
-        assertArg(import_ts_utils_lib13.Utils.Is.isNumber(measureCount) && measureCount >= 1, "measureCount", measureCount);
+        assertArg(import_ts_utils_lib15.Utils.Is.isNumber(measureCount) && measureCount >= 1, "measureCount", measureCount);
         ticks += this.getMeasure().getMeasureTicks() * measureCount;
         return helper;
       },
@@ -7498,13 +8034,13 @@ var DocumentBuilder = class {
    * @returns - This document builder instance.
    */
   addStaffGroup(groupName, staffsTabsAndGroups, verticalPosition = "auto" /* Auto */) {
-    assertArg(import_ts_utils_lib13.Utils.Is.isNonEmptyString(groupName), "groupName", groupName);
+    assertArg(import_ts_utils_lib15.Utils.Is.isNonEmptyString(groupName), "groupName", groupName);
     assertArg(
-      import_ts_utils_lib13.Utils.Is.isNonEmptyString(staffsTabsAndGroups) || import_ts_utils_lib13.Utils.Is.isIntegerGte(staffsTabsAndGroups, 0) || import_ts_utils_lib13.Utils.Is.isNonEmptyArray(staffsTabsAndGroups) && staffsTabsAndGroups.every((line) => import_ts_utils_lib13.Utils.Is.isNonEmptyString(line) || import_ts_utils_lib13.Utils.Is.isIntegerGte(line, 0)),
+      import_ts_utils_lib15.Utils.Is.isNonEmptyString(staffsTabsAndGroups) || import_ts_utils_lib15.Utils.Is.isIntegerGte(staffsTabsAndGroups, 0) || import_ts_utils_lib15.Utils.Is.isNonEmptyArray(staffsTabsAndGroups) && staffsTabsAndGroups.every((line) => import_ts_utils_lib15.Utils.Is.isNonEmptyString(line) || import_ts_utils_lib15.Utils.Is.isIntegerGte(line, 0)),
       "staffsTabsAndGroups",
       staffsTabsAndGroups
     );
-    assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(verticalPosition, VerticalPosition), "verticalPosition", verticalPosition);
+    assertArg(import_ts_utils_lib15.Utils.Is.isEnumValue(verticalPosition, VerticalPosition), "verticalPosition", verticalPosition);
     this.doc.addStaffGroup(groupName, staffsTabsAndGroups, verticalPosition);
     return this;
   }
@@ -7539,7 +8075,7 @@ var DocumentBuilder = class {
    * @returns - This document builder instance.
    */
   completeRests(voiceId) {
-    assertArg(import_ts_utils_lib13.Utils.Is.isUndefined(voiceId) || isVoiceId(voiceId) || import_ts_utils_lib13.Utils.Is.isArray(voiceId) && voiceId.every((id) => isVoiceId(id)), "voiceId", voiceId);
+    assertArg(import_ts_utils_lib15.Utils.Is.isUndefined(voiceId) || isVoiceId(voiceId) || import_ts_utils_lib15.Utils.Is.isArray(voiceId) && voiceId.every((id) => isVoiceId(id)), "voiceId", voiceId);
     this.getMeasure().completeRests(voiceId);
     return this;
   }
@@ -7551,8 +8087,8 @@ var DocumentBuilder = class {
    * @returns - This document builder instance.
    */
   addScaleArpeggio(scale, bottomNote, numOctaves) {
-    assertArg(import_ts_utils_lib13.Utils.Is.isNonEmptyString(bottomNote), "bottomNote", bottomNote);
-    assertArg(import_ts_utils_lib13.Utils.Is.isIntegerGte(numOctaves, 1), "numOctaves", numOctaves);
+    assertArg(import_ts_utils_lib15.Utils.Is.isNonEmptyString(bottomNote), "bottomNote", bottomNote);
+    assertArg(import_ts_utils_lib15.Utils.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++) {
@@ -7568,7 +8104,7 @@ var DocumentBuilder = class {
 };
 
 // src/score/pub/event.ts
-var import_core18 = require("@tspro/web-music-score/core");
+var import_core19 = require("@tspro/web-music-score/core");
 var ScoreEvent = class {
   /**
    * Create new score event instance.
@@ -7605,7 +8141,7 @@ var ScoreObjectEvent = class extends ScoreEvent {
     this.renderer = renderer;
     this.objects = objects;
     if (arguments.length === 0) {
-      throw new import_core18.MusicError(import_core18.MusicErrorType.Score, "Empty array in score object event!");
+      throw new import_core19.MusicError(import_core19.MusicErrorType.Score, "Empty array in score object event!");
     }
   }
   /** Top object getter. */
@@ -7624,24 +8160,24 @@ var ScoreObjectEvent = class extends ScoreEvent {
 
 // src/score/pub/music-interface.ts
 var Audio2 = __toESM(require("@tspro/web-music-score/audio"));
-var import_ts_utils_lib15 = require("@tspro/ts-utils-lib");
+var import_ts_utils_lib17 = require("@tspro/ts-utils-lib");
 
 // src/score/pub/music-objects.ts
-var import_ts_utils_lib14 = require("@tspro/ts-utils-lib");
-var import_core19 = require("@tspro/web-music-score/core");
+var import_ts_utils_lib16 = require("@tspro/ts-utils-lib");
+var import_core20 = require("@tspro/web-music-score/core");
 function assertArg2(condition, argName, argValue) {
   if (!condition) {
-    throw new import_core19.MusicError(import_core19.MusicErrorType.Score, `Invalid arg: ${argName} = ${argValue}`);
+    throw new import_core20.MusicError(import_core20.MusicErrorType.Score, `Invalid arg: ${argName} = ${argValue}`);
   }
 }
 function isVoiceId2(value) {
-  return import_ts_utils_lib14.Utils.Is.isNumber(value) && getVoiceIds().indexOf(value) >= 0;
+  return import_ts_utils_lib16.Utils.Is.isNumber(value) && getVoiceIds().indexOf(value) >= 0;
 }
 function getNotationLine(line) {
   if (line instanceof ObjStaff || line instanceof ObjTab) {
     return line.getMusicInterface();
   } else {
-    throw new import_core19.MusicError(import_core19.MusicErrorType.Score, `Notation line not staff nor tab.`);
+    throw new import_core20.MusicError(import_core20.MusicErrorType.Score, `Notation line not staff nor tab.`);
   }
 }
 var MusicInterface6 = class {
@@ -7811,7 +8347,7 @@ var _MDocument = class _MDocument extends MusicInterface6 {
    * @returns - Player instance.
    */
   play(playStateChangeListener) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
+    assertArg2(import_ts_utils_lib16.Utils.Is.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
     return new MPlayer(this, playStateChangeListener).play();
   }
 };
@@ -7841,7 +8377,7 @@ var _MEnding = class _MEnding extends MusicInterface6 {
    * @returns - Boolean whether this ending has asked passage number.
    */
   hasPassage(passage) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isIntegerGte(passage, 1), "passage", passage);
+    assertArg2(import_ts_utils_lib16.Utils.Is.isIntegerGte(passage, 1), "passage", passage);
     return this.obj.hasPassage(passage);
   }
 };
@@ -7993,7 +8529,7 @@ var _MStaffTabBarLine = class _MStaffTabBarLine extends MusicInterface6 {
     if (barLine instanceof ObjBarLineLeft || barLine instanceof ObjBarLineRight) {
       return barLine.getMusicInterface();
     } else {
-      throw new import_core19.MusicError(import_core19.MusicErrorType.Score, `Bar line not let nor right.`);
+      throw new import_core20.MusicError(import_core20.MusicErrorType.Score, `Bar line not let nor right.`);
     }
   }
   /**
@@ -8420,6 +8956,27 @@ var _MText = class _MText extends MusicInterface6 {
 /** Object name. */
 __publicField(_MText, "Name", "Text");
 var MText = _MText;
+var _MLyrics = class _MLyrics extends MusicInterface6 {
+  /** @internal */
+  constructor(obj) {
+    super(_MLyrics.Name);
+    this.obj = obj;
+  }
+  /** @internal */
+  getMusicObject() {
+    return this.obj;
+  }
+  /**
+   * Get lyrics text.
+   * @returns - Lyrics text.
+   */
+  getText() {
+    return this.obj.getText();
+  }
+};
+/** Object name. */
+__publicField(_MLyrics, "Name", "Lyrics");
+var MLyrics = _MLyrics;
 var _MExtensionLine = class _MExtensionLine extends MusicInterface6 {
   /** @internal */
   constructor(obj) {
@@ -8436,10 +8993,10 @@ __publicField(_MExtensionLine, "Name", "ExtensionLine");
 var MExtensionLine = _MExtensionLine;
 
 // src/score/pub/music-interface.ts
-var import_core20 = require("@tspro/web-music-score/core");
+var import_core21 = require("@tspro/web-music-score/core");
 function assertArg3(condition, argName, argValue) {
   if (!condition) {
-    throw new import_core20.MusicError(import_core20.MusicErrorType.Score, `Invalid arg: ${argName} = ${argValue}`);
+    throw new import_core21.MusicError(import_core21.MusicErrorType.Score, `Invalid arg: ${argName} = ${argValue}`);
   }
 }
 function require_t(t, message) {
@@ -8458,7 +9015,7 @@ var _MPlayer = class _MPlayer {
   constructor(doc, playStateChangeListener) {
     __publicField(this, "player");
     assertArg3(doc instanceof MDocument2, "doc", doc);
-    assertArg3(import_ts_utils_lib15.Utils.Is.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
+    assertArg3(import_ts_utils_lib17.Utils.Is.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
     this.player = new Player();
     this.player.setDocument(doc.getMusicObject());
     this.player.setCursorPositionChangeListener((cursorRect) => doc.getMusicObject().updateCursorRect(cursorRect));
@@ -8516,7 +9073,7 @@ var MRenderer2 = class {
    * @returns - This renderer instance.
    */
   setDocument(doc) {
-    assertArg3(import_ts_utils_lib15.Utils.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
+    assertArg3(import_ts_utils_lib17.Utils.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
     this.renderer.setDocument(doc);
     return this;
   }
@@ -8526,7 +9083,7 @@ var MRenderer2 = class {
    * @returns - This renderer instance.
    */
   setCanvas(canvas) {
-    canvas = require_t(import_ts_utils_lib15.Utils.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(import_ts_utils_lib17.Utils.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;
   }
@@ -8535,7 +9092,7 @@ var MRenderer2 = class {
    * @param scoreEventListener - Score event listener.
    */
   setScoreEventListener(scoreEventListener) {
-    assertArg3(import_ts_utils_lib15.Utils.Is.isFunctionOrUndefined(scoreEventListener), "scoreEventListener", scoreEventListener);
+    assertArg3(import_ts_utils_lib17.Utils.Is.isFunctionOrUndefined(scoreEventListener), "scoreEventListener", scoreEventListener);
     this.renderer.setScoreEventListener(scoreEventListener);
   }
   /**
@@ -8609,7 +9166,7 @@ var _MPlaybackButtons = class _MPlaybackButtons {
    * @returns 
    */
   setDocument(doc) {
-    assertArg3(import_ts_utils_lib15.Utils.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
+    assertArg3(import_ts_utils_lib17.Utils.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
     this.onStop();
     if (doc) {
       this.player = new MPlayer(doc, (playState) => {
@@ -8653,9 +9210,9 @@ var _MPlaybackButtons = class _MPlaybackButtons {
    * @returns - This playback buttons class instance.
    */
   setPlayButton(btn, btnLabel) {
-    assertArg3(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(import_ts_utils_lib17.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.playButton, this.onPlay);
-    this.playButton = require_t(import_ts_utils_lib15.Utils.Dom.getButton(btn), "Play button required!");
+    this.playButton = require_t(import_ts_utils_lib17.Utils.Dom.getButton(btn), "Play button required!");
     this.playLabel = btnLabel != null ? btnLabel : "Play";
     _MPlaybackButtons.removeOnClickListeners(this.playButton, "all");
     _MPlaybackButtons.addOnClickListener(this.playButton, this.onPlay);
@@ -8669,9 +9226,9 @@ var _MPlaybackButtons = class _MPlaybackButtons {
    * @returns - This playback buttons class instance.
    */
   setStopButton(btn, btnLabel) {
-    assertArg3(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(import_ts_utils_lib17.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.stopButton, this.onStop);
-    this.stopButton = require_t(import_ts_utils_lib15.Utils.Dom.getButton(btn), "Stop button required!");
+    this.stopButton = require_t(import_ts_utils_lib17.Utils.Dom.getButton(btn), "Stop button required!");
     this.stopLabel = btnLabel != null ? btnLabel : "Stop";
     _MPlaybackButtons.removeOnClickListeners(this.stopButton, "all");
     _MPlaybackButtons.addOnClickListener(this.stopButton, this.onStop);
@@ -8686,10 +9243,10 @@ var _MPlaybackButtons = class _MPlaybackButtons {
    * @returns - This playback buttons class instance.
    */
   setPlayStopButton(btn, playLabel, stopLabel) {
-    assertArg3(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(playLabel), "playLabel", playLabel);
-    assertArg3(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(stopLabel), "stopLabel", stopLabel);
+    assertArg3(import_ts_utils_lib17.Utils.Is.isStringOrUndefined(playLabel), "playLabel", playLabel);
+    assertArg3(import_ts_utils_lib17.Utils.Is.isStringOrUndefined(stopLabel), "stopLabel", stopLabel);
     _MPlaybackButtons.removeOnClickListeners(this.playStopButton, this.onPlayStop);
-    this.playStopButton = require_t(import_ts_utils_lib15.Utils.Dom.getButton(btn), "Play/stop button required!");
+    this.playStopButton = require_t(import_ts_utils_lib17.Utils.Dom.getButton(btn), "Play/stop button required!");
     this.playLabel = playLabel != null ? playLabel : "Play";
     this.stopLabel = stopLabel != null ? stopLabel : "Stop";
     _MPlaybackButtons.removeOnClickListeners(this.playStopButton, "all");
@@ -8704,9 +9261,9 @@ var _MPlaybackButtons = class _MPlaybackButtons {
    * @returns - This playback buttons class instance.
    */
   setPauseButton(btn, btnLabel) {
-    assertArg3(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(import_ts_utils_lib17.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.pauseButton, this.onPause);
-    this.pauseButton = require_t(import_ts_utils_lib15.Utils.Dom.getButton(btn), "Pause button required!");
+    this.pauseButton = require_t(import_ts_utils_lib17.Utils.Dom.getButton(btn), "Pause button required!");
     this.pauseLabel = btnLabel != null ? btnLabel : "Pause";
     _MPlaybackButtons.removeOnClickListeners(this.pauseButton, "all");
     _MPlaybackButtons.addOnClickListener(this.pauseButton, this.onPause);
@@ -8728,7 +9285,7 @@ var _MPlaybackButtons = class _MPlaybackButtons {
     }
   }
   static addOnClickListener(btn, onClick) {
-    assertArg3(import_ts_utils_lib15.Utils.Is.isFunction(onClick), "onClick", onClick);
+    assertArg3(import_ts_utils_lib17.Utils.Is.isFunction(onClick), "onClick", onClick);
     btn.addEventListener("click", onClick);
     let clickListeners = this.savedOnClickListeners.get(btn) || [];
     this.savedOnClickListeners.set(btn, [...clickListeners, onClick]);
@@ -8738,8 +9295,8 @@ __publicField(_MPlaybackButtons, "savedOnClickListeners", /* @__PURE__ */ new Ma
 var MPlaybackButtons = _MPlaybackButtons;
 
 // src/score/index.ts
-var import_core21 = require("@tspro/web-music-score/core");
-(0, import_core21.init)();
+var import_core22 = require("@tspro/web-music-score/core");
+(0, import_core22.init)();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Annotation,
@@ -8751,6 +9308,8 @@ var import_core21 = require("@tspro/web-music-score/core");
   DynamicsAnnotation,
   Fermata,
   Label,
+  LyricsAlign,
+  LyricsHyphen,
   MAccidental,
   MArpeggio,
   MBarLineLeft,
@@ -8763,6 +9322,7 @@ var import_core21 = require("@tspro/web-music-score/core");
   MFermata,
   MHeader,
   MImage,
+  MLyrics,
   MMeasure,
   MNoteGroup,
   MPlaybackButtons,
@@ -8794,6 +9354,7 @@ var import_core21 = require("@tspro/web-music-score/core");
   TieType,
   VerticalPosition,
   getStringNumbers,
+  getVerseNumbers,
   getVoiceIds
 });
 //# sourceMappingURL=index.js.map