@tspro/web-music-score 4.0.0 → 4.0.1

package/dist/score/index.js

@@ -1,4 +1,4 @@
-/* WebMusicScore v4.0.0 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
+/* WebMusicScore v4.0.1 | (c) 2023 PahkaSoft | MIT License | Includes: Tone.js (MIT License) */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -39,6 +39,7 @@ __export(score_exports, {
   Connective: () => Connective,
   DivRect: () => DivRect,
   DocumentBuilder: () => DocumentBuilder,
+  DynamicsAnnotation: () => DynamicsAnnotation,
   Fermata: () => Fermata,
   Label: () => Label,
   MAccidental: () => MAccidental,
@@ -80,6 +81,7 @@ __export(score_exports, {
   ScoreStaffPosEvent: () => ScoreStaffPosEvent,
   StaffPreset: () => StaffPreset,
   Stem: () => Stem,
+  TempoAnnotation: () => TempoAnnotation,
   TieType: () => TieType,
   VerticalPosition: () => VerticalPosition,
   getStringNumbers: () => getStringNumbers,
@@ -445,6 +447,27 @@ var Annotation = /* @__PURE__ */ ((Annotation2) => {
   Annotation2["Tempo"] = "tempo";
   return Annotation2;
 })(Annotation || {});
+var DynamicsAnnotation = /* @__PURE__ */ ((DynamicsAnnotation2) => {
+  DynamicsAnnotation2["cresc"] = "cresc.";
+  DynamicsAnnotation2["decresc"] = "decresc.";
+  DynamicsAnnotation2["dim"] = "dim.";
+  DynamicsAnnotation2["ppp"] = "ppp";
+  DynamicsAnnotation2["pp"] = "pp";
+  DynamicsAnnotation2["p"] = "p";
+  DynamicsAnnotation2["mp"] = "mp";
+  DynamicsAnnotation2["m"] = "m";
+  DynamicsAnnotation2["mf"] = "mf";
+  DynamicsAnnotation2["f"] = "f";
+  DynamicsAnnotation2["ff"] = "ff";
+  DynamicsAnnotation2["fff"] = "fff";
+  return DynamicsAnnotation2;
+})(DynamicsAnnotation || {});
+var TempoAnnotation = /* @__PURE__ */ ((TempoAnnotation2) => {
+  TempoAnnotation2["accel"] = "accel.";
+  TempoAnnotation2["rit"] = "rit.";
+  TempoAnnotation2["a_tempo"] = "a tempo";
+  return TempoAnnotation2;
+})(TempoAnnotation || {});
 var Label = /* @__PURE__ */ ((Label2) => {
   Label2["Note"] = "note";
   Label2["Chord"] = "chord";
@@ -3408,6 +3431,9 @@ var ObjRhythmColumn = class extends MusicObject {
   }
 };
 
+// src/score/engine/extension.ts
+var import_core9 = require("@tspro/web-music-score/core");
+
 // src/score/engine/element-data.ts
 var import_ts_utils_lib5 = require("@tspro/ts-utils-lib");
 
@@ -3530,29 +3556,8 @@ function getNavigationString(navigation) {
       return navigation[0].toUpperCase() + navigation.substring(1);
   }
 }
-var DynamicsAnnotations = /* @__PURE__ */ ((DynamicsAnnotations2) => {
-  DynamicsAnnotations2["cresc"] = "cresc.";
-  DynamicsAnnotations2["decresc"] = "decresc.";
-  DynamicsAnnotations2["dim"] = "dim.";
-  DynamicsAnnotations2["ppp"] = "ppp";
-  DynamicsAnnotations2["pp"] = "pp";
-  DynamicsAnnotations2["p"] = "p";
-  DynamicsAnnotations2["mp"] = "mp";
-  DynamicsAnnotations2["m"] = "m";
-  DynamicsAnnotations2["mf"] = "mf";
-  DynamicsAnnotations2["f"] = "f";
-  DynamicsAnnotations2["ff"] = "ff";
-  DynamicsAnnotations2["fff"] = "fff";
-  return DynamicsAnnotations2;
-})(DynamicsAnnotations || {});
-var TempoAnnotations = /* @__PURE__ */ ((TempoAnnotations2) => {
-  TempoAnnotations2["accel"] = "accel.";
-  TempoAnnotations2["rit"] = "rit.";
-  TempoAnnotations2["a_tempo"] = "a tempo";
-  return TempoAnnotations2;
-})(TempoAnnotations || {});
 function isDynamicsText(text) {
-  return import_ts_utils_lib5.Utils.Is.isEnumValue(text, DynamicsAnnotations);
+  return import_ts_utils_lib5.Utils.Is.isEnumValue(text, DynamicsAnnotation);
 }
 function getDynamicsVolume(text) {
   if (/^(p+|f+|m|mp|mf)$/.test(text)) {
@@ -3563,12 +3568,12 @@ function getDynamicsVolume(text) {
   }
 }
 function isTempoText(text) {
-  return import_ts_utils_lib5.Utils.Is.isEnumValue(text, TempoAnnotations);
+  return import_ts_utils_lib5.Utils.Is.isEnumValue(text, TempoAnnotation);
 }
 function getAnnotation(text) {
-  if (import_ts_utils_lib5.Utils.Is.isEnumValue(text, DynamicsAnnotations)) {
+  if (import_ts_utils_lib5.Utils.Is.isEnumValue(text, DynamicsAnnotation)) {
     return "dynamics" /* Dynamics */;
-  } else if (import_ts_utils_lib5.Utils.Is.isEnumValue(text, TempoAnnotations)) {
+  } else if (import_ts_utils_lib5.Utils.Is.isEnumValue(text, TempoAnnotation)) {
     return "tempo" /* Tempo */;
   } else {
     return void 0;
@@ -3576,7 +3581,6 @@ function getAnnotation(text) {
 }
 
 // src/score/engine/extension.ts
-var import_core9 = require("@tspro/web-music-score/core");
 function getTextAnchorY(linePos) {
   switch (linePos) {
     case "bottom":
@@ -7119,6 +7123,9 @@ function isTupletRatio(tupletRatio) {
   }
 }
 var DocumentBuilder = class {
+  /**
+   * Create new document builder instance.
+   */
   constructor() {
     __publicField(this, "doc");
     this.doc = new ObjDocument();
@@ -7152,9 +7159,20 @@ var DocumentBuilder = class {
     var _a;
     return (_a = this.doc.getLastMeasure()) != null ? _a : this.doc.addMeasure();
   }
+  /**
+   * Get music document after finished building.
+   * @returns - Music document.
+   */
   getDocument() {
     return this.doc.getMusicInterface();
   }
+  /**
+   * Set header texts.
+   * @param title - Title of this docmument/musical piece.
+   * @param composer - Composer of this document/musical piece.
+   * @param arranger - Arranger of this document/musical piece.
+   * @returns - This document builder instance.
+   */
   setHeader(title, composer, arranger) {
     assertArg(import_ts_utils_lib13.Utils.Is.isStringOrUndefined(title), "title", title);
     assertArg(import_ts_utils_lib13.Utils.Is.isStringOrUndefined(composer), "composer", composer);
@@ -7162,11 +7180,20 @@ var DocumentBuilder = class {
     this.doc.setHeader(title, composer, arranger);
     return this;
   }
+  /**
+   * Automatically limit number of measures per score row.
+   * @param measuresPerRow - Number of measures per row. Must be integer >=1 or Infinity.
+   * @returns - This document builder instance.
+   */
   setMeasuresPerRow(measuresPerRow) {
     assertArg(import_ts_utils_lib13.Utils.Is.isIntegerGte(measuresPerRow, 1) || import_ts_utils_lib13.Utils.Is.isPosInfinity(measuresPerRow), "measuresPerRow", measuresPerRow);
     this.doc.setMeasuresPerRow(measuresPerRow);
     return this;
   }
+  /**
+   * Add new measure.
+   * @returns - This document builder instance.
+   */
   addMeasure() {
     this.doc.addMeasure();
     return this;
@@ -7176,6 +7203,11 @@ var DocumentBuilder = class {
     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);
@@ -7192,6 +7224,14 @@ var DocumentBuilder = class {
     this.getMeasure().setTempo(beatsPerMinute, beatLength, dotted);
     return this;
   }
+  /**
+   * Add note o current measure.
+   * @param voiceId - Voice id to add note to.
+   * @param note - Note instance of Note or string (e.g. "D4").
+   * @param noteLength - Note length (e.g. "4n").
+   * @param options - Note options.
+   * @returns - This document builder instance.
+   */
   addNote(voiceId, note, noteLength, options) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
     assertArg(note instanceof import_theory13.Note || import_ts_utils_lib13.Utils.Is.isNonEmptyString(note), "note", note);
@@ -7202,6 +7242,13 @@ var DocumentBuilder = class {
     this.getMeasure().addNoteGroup(voiceId, [note], noteLength, options);
     return this;
   }
+  /**
+   * @param voiceId - Voice id to add chord to.
+   * @param notes - Array of notes, each instance of Note or string (e.g. "D4"). 
+   * @param noteLength - Note length (e.g. "4n"). 
+   * @param options - Note options. 
+   * @returns - This document builder instance.
+   */
   addChord(voiceId, notes, noteLength, options) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
     assertArg(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);
@@ -7212,6 +7259,13 @@ var DocumentBuilder = class {
     this.getMeasure().addNoteGroup(voiceId, notes, noteLength, options);
     return this;
   }
+  /**
+   * 
+   * @param voiceId - Voice id to add rest to.
+   * @param restLength - Rest length (e.g. "4n").  
+   * @param options - Rest options.
+   * @returns - This document builder instance.
+   */
   addRest(voiceId, restLength, options) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
     assertArg(import_ts_utils_lib13.Utils.Is.isEnumValue(restLength, import_theory13.NoteLength) || isNoteLength(restLength), "restLength", restLength);
@@ -7231,10 +7285,10 @@ var DocumentBuilder = class {
    * });
    * </pre>
    * 
-   * @param voiceId 
+   * @param voiceId - Voice id to add tuplet to.
    * @param tupletRatio - You can also use Theory.Tuplet presets (e.g. Theory.Tuplet.Triplet).
-   * @param tupletBuilder 
-   * @returns 
+   * @param tupletBuilder - Tuplet builder function to build tuplet.
+   * @returns - This document builder instance.
    */
   addTuplet(voiceId, tupletRatio, tupletBuilder) {
     assertArg(isVoiceId(voiceId), "voiceId", voiceId);
@@ -7285,10 +7339,20 @@ var DocumentBuilder = class {
     this.getMeasure().addFermata(staffTabOrGroups, fermata);
     return this;
   }
+  /**
+   * Add fermata to current measure.
+   * @param fermata - Fermata type (e.g. "atNote" or Fermata.AtrNote).
+   * @returns - This document builder instance.
+   */
   addFermata(fermata = "atNote" /* AtNote */) {
     return this.addFermataInternal(void 0, fermata);
   }
-  /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
+  /**
+   * Add Fermata to current measure to given staff/tab/group.
+   * @param staffTabOrGroups - staff/tab index (0=top), staff/tab name, or staff group name.
+   * @param fermata - Fermata type (e.g. "atNote" or Fermata.AtrNote).
+   * @returns - This document builder instance.
+   */
   addFermataTo(staffTabOrGroups, fermata = "atNote" /* AtNote */) {
     return this.addFermataInternal(staffTabOrGroups, fermata);
   }
@@ -7341,10 +7405,22 @@ var DocumentBuilder = class {
     this.getMeasure().addLabel(staffTabOrGroups, label, text);
     return this;
   }
+  /**
+   * Add label text to column of last added note/chord/rest in current measure.
+   * @param label - Label type (e.g. "chord" or Label.Chord).
+   * @param text - label text (e.g. "Am").
+   * @returns - This document builder instance.
+   */
   addLabel(label, text) {
     return this.addLabelInternal(void 0, label, text);
   }
-  /** @param staffTabOrGroups  - staff/tab index (0=top), staff/tab name, or staff group name. */
+  /**
+   * Add label text to column of last added note/chord/rest in current measure to given staff/tab/group.
+   * @param staffTabOrGroups - staff/tab index (0=top), staff/tab name, or staff group name.
+   * @param label - Label type (e.g. "chord" or Label.Chord).
+   * @param text - label text (e.g. "Am").
+   * @returns - This document builder instance.
+   */
   addLabelTo(staffTabOrGroups, label, text) {
     return this.addLabelInternal(staffTabOrGroups, label, text);
   }
@@ -7370,16 +7446,16 @@ var DocumentBuilder = class {
     return this;
   }
   /**
-   * Extension length example:
+   * Add extension line to previously added annotation or label element.
    * <pre>
+   *     // Example
    *     addExtension(ext => ext.notes("1n", 2))          // length is 2 whole notes
    *     addExtension(ext => ext.measures(3).hide())      // length is 3 measures, hidden
    *     addExtension(ext => ext.measures(1).notes("8n")) // length is 1 measure + 1 eigth note
    *     addExtension(ext => ext.infinity())              // length is as long as possible
    * </pre>
-   * @param extensionLength
-   * @param extensionVisible
-   * @returns 
+   * @param extensionBuilder - Extension builder function used to build exstension.
+   * @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);
@@ -7415,11 +7491,11 @@ var DocumentBuilder = class {
     return this;
   }
   /**
-   * 
+   * Add staff group.
    * @param groupName - Name of staff group.
    * @param staffsTabsAndGroups - staff/tab index (0=top), staff/tab name, or staff group name. Single value or array.
    * @param verticalPosition - Vertical position, are elements added above, below or both.
-   * @returns 
+   * @returns - This document builder instance.
    */
   addStaffGroup(groupName, staffsTabsAndGroups, verticalPosition = "auto" /* Auto */) {
     assertArg(import_ts_utils_lib13.Utils.Is.isNonEmptyString(groupName), "groupName", groupName);
@@ -7432,24 +7508,48 @@ var DocumentBuilder = class {
     this.doc.addStaffGroup(groupName, staffsTabsAndGroups, verticalPosition);
     return this;
   }
+  /**
+   * Add song end. Adds certain bar line at the end of measure.
+   * @returns - This document builder instance.
+   */
   endSong() {
     this.getMeasure().endSong();
     return this;
   }
+  /**
+   * Add section end. Adds certain bar line at the end of measure.
+   * @returns - This document builder instance.
+   */
   endSection() {
     this.getMeasure().endSection();
     return this;
   }
+  /**
+   * End current score row. Next measure will start new row.
+   * @returns - This document builder instance.
+   */
   endRow() {
     var _a;
     (_a = this.doc.getLastMeasure()) == null ? void 0 : _a.endRow();
     return this;
   }
+  /**
+   * Add rests to fill current measure.
+   * @param voiceId - Voice id to add rests to. Single value, array or all if omitted.
+   * @returns - This document builder instance.
+   */
   completeRests(voiceId) {
     assertArg(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);
     this.getMeasure().completeRests(voiceId);
     return this;
   }
+  /**
+   * Add notes of given scale in ascending order.
+   * @param scale - Scale.
+   * @param bottomNote - Scale starts from note >= bottom note.
+   * @param numOctaves - Number of octaves to add.
+   * @returns - This document builder instance.
+   */
   addScaleArpeggio(scale, bottomNote, numOctaves) {
     assertArg(import_ts_utils_lib13.Utils.Is.isNonEmptyString(bottomNote), "bottomNote", bottomNote);
     assertArg(import_ts_utils_lib13.Utils.Is.isIntegerGte(numOctaves, 1), "numOctaves", numOctaves);
@@ -7470,11 +7570,22 @@ var DocumentBuilder = class {
 // src/score/pub/event.ts
 var import_core18 = require("@tspro/web-music-score/core");
 var ScoreEvent = class {
+  /**
+   * Create new score event instance.
+   * @param type - Score event type.
+   */
   constructor(type) {
     this.type = type;
   }
 };
 var ScoreStaffPosEvent = class extends ScoreEvent {
+  /**
+   * Create new score staff position event.
+   * @param type - Score event type.
+   * @param renderer - Renderer.
+   * @param scoreRow - Score row.
+   * @param diatonicId - Diatonic id that was clicked/entered/left.
+   */
   constructor(type, renderer, scoreRow, diatonicId) {
     super(type);
     this.renderer = renderer;
@@ -7483,6 +7594,12 @@ var ScoreStaffPosEvent = class extends ScoreEvent {
   }
 };
 var ScoreObjectEvent = class extends ScoreEvent {
+  /**
+   * Create new score object event.
+   * @param type - Score event type.
+   * @param renderer - Renderer.
+   * @param objects - Array of objects, last object in this array is the top object that was clicked/entered/left, previous objects are it's parent objects.
+   */
   constructor(type, renderer, objects) {
     super(type);
     this.renderer = renderer;
@@ -7491,16 +7608,25 @@ var ScoreObjectEvent = class extends ScoreEvent {
       throw new import_core18.MusicError(import_core18.MusicErrorType.Score, "Empty array in score object event!");
     }
   }
+  /** Top object getter. */
   get topObject() {
     return this.objects[this.objects.length - 1];
   }
+  /**
+   * Find object.
+   * @param fn - Compare function.
+   * @returns - First object that matched compare function, or undefined if no match.
+   */
   findObject(fn) {
     return this.objects.find((obj) => fn(obj));
   }
 };
 
-// src/score/pub/interface.ts
+// src/score/pub/music-interface.ts
 var Audio2 = __toESM(require("@tspro/web-music-score/audio"));
+var import_ts_utils_lib15 = 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");
 function assertArg2(condition, argName, argValue) {
@@ -7508,13 +7634,6 @@ function assertArg2(condition, argName, argValue) {
     throw new import_core19.MusicError(import_core19.MusicErrorType.Score, `Invalid arg: ${argName} = ${argValue}`);
   }
 }
-function require_t(t, message) {
-  if (t === void 0 || t === null) {
-    throw new TypeError(message);
-  } else {
-    return t;
-  }
-}
 function isVoiceId2(value) {
   return import_ts_utils_lib14.Utils.Is.isNumber(value) && getVoiceIds().indexOf(value) >= 0;
 }
@@ -7526,9 +7645,17 @@ function getNotationLine(line) {
   }
 }
 var MusicInterface6 = class {
+  /**
+   * Create new music interface object.
+   * @param name - OBject name.
+   */
   constructor(name) {
     this.name = name;
   }
+  /**
+   * Get parent object.
+   * @returns - Parent object or undefined.
+   */
   getParent() {
     var _a;
     return (_a = this.getMusicObject().getParent()) == null ? void 0 : _a.getMusicInterface();
@@ -7544,10 +7671,15 @@ var _MAccidental = class _MAccidental extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get accidental.
+   * @returns - Accidental (e.g. 1 = #).
+   */
   getAccidental() {
     return this.obj.accidental;
   }
 };
+/** Object name. */
 __publicField(_MAccidental, "Name", "Accidental");
 var MAccidental = _MAccidental;
 var _MConnective = class _MConnective extends MusicInterface6 {
@@ -7561,6 +7693,7 @@ var _MConnective = class _MConnective extends MusicInterface6 {
     return this.obj;
   }
 };
+/** Object name. */
 __publicField(_MConnective, "Name", "Connective");
 var MConnective = _MConnective;
 var _MArpeggio = class _MArpeggio extends MusicInterface6 {
@@ -7573,13 +7706,22 @@ var _MArpeggio = class _MArpeggio extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get rhythm column this arpeggio is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.obj.col.getMusicInterface();
   }
+  /**
+   * Get notation line this arpeggio is in.
+   * @returns - Staff or tab object.
+   */
   getNotationLine() {
     return getNotationLine(this.obj.line);
   }
 };
+/** Object name. */
 __publicField(_MArpeggio, "Name", "Arpeggio");
 var MArpeggio = _MArpeggio;
 var _MBeamGroup = class _MBeamGroup extends MusicInterface6 {
@@ -7593,6 +7735,7 @@ var _MBeamGroup = class _MBeamGroup extends MusicInterface6 {
     return this.obj;
   }
 };
+/** OBject name. */
 __publicField(_MBeamGroup, "Name", "BeamGroup");
 var MBeamGroup = _MBeamGroup;
 var _MStaffBeamGroup = class _MStaffBeamGroup extends MusicInterface6 {
@@ -7605,10 +7748,15 @@ var _MStaffBeamGroup = class _MStaffBeamGroup extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get staff this beam group is in.
+   * @returns - Staff object.
+   */
   getStaff() {
     return this.obj.staff.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MStaffBeamGroup, "Name", "StaffBeamGroup");
 var MStaffBeamGroup = _MStaffBeamGroup;
 var _MDocument = class _MDocument extends MusicInterface6 {
@@ -7621,27 +7769,53 @@ var _MDocument = class _MDocument extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get title.
+   * @returns - Title string or undefined.
+   */
   getTitle() {
     return this.obj.getTitle();
   }
+  /**
+   * Get composer.
+   * @returns - Composer string or undefined.
+   */
   getComposer() {
     return this.obj.getComposer();
     3;
   }
+  /**
+   * Get arranger.
+   * @returns - Arranger string or undefined.
+   */
   getArranger() {
     return this.obj.getArranger();
   }
+  /**
+   * Get score rows.
+   * @returns - Array or score rows.
+   */
   getRows() {
     return this.obj.getRows().map((r) => r.getMusicInterface());
   }
+  /**
+   * Get measures.
+   * @returns - Array of measures.
+   */
   getMeasures() {
     return this.obj.getMeasures().map((m) => m.getMusicInterface());
   }
-  play(fn) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isFunctionOrUndefined(fn), "playStateChangeListener", fn);
-    return new MPlayer(this, fn).play();
+  /**
+   * Play this document.
+   * @param playStateChangeListener - Play state change listener function or undefined.
+   * @returns - Player instance.
+   */
+  play(playStateChangeListener) {
+    assertArg2(import_ts_utils_lib14.Utils.Is.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
+    return new MPlayer(this, playStateChangeListener).play();
   }
 };
+/** Object name. */
 __publicField(_MDocument, "Name", "Document");
 var MDocument2 = _MDocument;
 var _MEnding = class _MEnding extends MusicInterface6 {
@@ -7654,14 +7828,24 @@ var _MEnding = class _MEnding extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get passages.
+   * @returns - Array of passage numbers, e.g. passage number 1 means that this ending is played on first pass.
+   */
   getPassages() {
     return this.obj.passages;
   }
+  /**
+   * Has passage number?
+   * @param passage - Passage number to find out.
+   * @returns - Boolean whether this ending has asked passage number.
+   */
   hasPassage(passage) {
     assertArg2(import_ts_utils_lib14.Utils.Is.isIntegerGte(passage, 1), "passage", passage);
     return this.obj.hasPassage(passage);
   }
 };
+/** Object name. */
 __publicField(_MEnding, "Name", "Ending");
 var MEnding = _MEnding;
 var _MFermata = class _MFermata extends MusicInterface6 {
@@ -7675,6 +7859,7 @@ var _MFermata = class _MFermata extends MusicInterface6 {
     return this.obj;
   }
 };
+/** OBject name. */
 __publicField(_MFermata, "Name", "Fermata");
 var MFermata = _MFermata;
 var _MHeader = class _MHeader extends MusicInterface6 {
@@ -7687,16 +7872,29 @@ var _MHeader = class _MHeader extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get title.
+   * @returns - Title string or undefined.
+   */
   getTitle() {
     return this.obj.title;
   }
+  /**
+   * Get composer.
+   * @returns - Composer string or undefined.
+   */
   getComposer() {
     return this.obj.composer;
   }
+  /**
+   * Get arranger.
+   * @returns - Arranger string or undefined.
+   */
   getArranger() {
     return this.obj.arranger;
   }
 };
+/** OBject name. */
 __publicField(_MHeader, "Name", "Header");
 var MHeader = _MHeader;
 var _MImage = class _MImage extends MusicInterface6 {
@@ -7710,6 +7908,7 @@ var _MImage = class _MImage extends MusicInterface6 {
     return this.obj;
   }
 };
+/** Object name. */
 __publicField(_MImage, "Name", "Image");
 var MImage = _MImage;
 var _MMeasure = class _MMeasure extends MusicInterface6 {
@@ -7722,16 +7921,29 @@ var _MMeasure = class _MMeasure extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get measure number.
+   * @returns - Measure number starting from 1, or 0 if upbeat.
+   */
   getMeasureNumber() {
     return this.obj.getMeasureNumber();
   }
+  /**
+   * Get rhythm columns.
+   * @returns - Array of rhythm columns.
+   */
   getRhythmColumns() {
     return this.obj.getColumns().map((col) => col.getMusicInterface());
   }
+  /**
+   * Get score row that this measure is in.
+   * @returns - Score row.
+   */
   getRow() {
     return this.obj.row.getMusicInterface();
   }
 };
+/** OBject name. */
 __publicField(_MMeasure, "Name", "Measure");
 var MMeasure = _MMeasure;
 var _MBarLineRight = class _MBarLineRight extends MusicInterface6 {
@@ -7745,6 +7957,7 @@ var _MBarLineRight = class _MBarLineRight extends MusicInterface6 {
     return this.obj;
   }
 };
+/** OBject name. */
 __publicField(_MBarLineRight, "Name", "BarLineRight");
 var MBarLineRight = _MBarLineRight;
 var _MBarLineLeft = class _MBarLineLeft extends MusicInterface6 {
@@ -7758,6 +7971,7 @@ var _MBarLineLeft = class _MBarLineLeft extends MusicInterface6 {
     return this.obj;
   }
 };
+/** Object name. */
 __publicField(_MBarLineLeft, "Name", "BarLineLeft");
 var MBarLineLeft = _MBarLineLeft;
 var _MStaffTabBarLine = class _MStaffTabBarLine extends MusicInterface6 {
@@ -7770,6 +7984,10 @@ var _MStaffTabBarLine = class _MStaffTabBarLine extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get parent bar line object.
+   * @returns - Parent bar line object.
+   */
   getBarLine() {
     let barLine = this.obj.barLine;
     if (barLine instanceof ObjBarLineLeft || barLine instanceof ObjBarLineRight) {
@@ -7778,10 +7996,15 @@ var _MStaffTabBarLine = class _MStaffTabBarLine extends MusicInterface6 {
       throw new import_core19.MusicError(import_core19.MusicErrorType.Score, `Bar line not let nor right.`);
     }
   }
+  /**
+   * Get staff or tab this bar lien object is in.
+   * @returns - Staff or tab.
+   */
   getNotationLine() {
     return getNotationLine(this.obj.line);
   }
 };
+/** Object name. */
 __publicField(_MStaffTabBarLine, "Name", "StaffTabBarLine");
 var MStaffTabBarLine = _MStaffTabBarLine;
 var _MNoteGroup = class _MNoteGroup extends MusicInterface6 {
@@ -7794,19 +8017,36 @@ var _MNoteGroup = class _MNoteGroup extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get notes of this note group.
+   * @returns - Array of Note instances.
+   */
   getNotes() {
     return this.obj.notes;
   }
+  /**
+   * Get rhythm props of this note group.
+   * @returns - Rhythm props.
+   */
   getRhythmProps() {
     return this.obj.rhythmProps;
   }
+  /**
+   * Get rhythm column this note group is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.obj.col.getMusicInterface();
   }
+  /**
+   * Get the measure this note group is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.obj.measure.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MNoteGroup, "Name", "NoteGroup");
 var MNoteGroup = _MNoteGroup;
 var _MStaffNoteGroup = class _MStaffNoteGroup extends MusicInterface6 {
@@ -7819,19 +8059,36 @@ var _MStaffNoteGroup = class _MStaffNoteGroup extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get parent note group.
+   * @returns - Parent note group.
+   */
   getNoteGroup() {
     return this.obj.noteGroup.getMusicInterface();
   }
+  /**
+   * Get rhythm column this note group is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.getNoteGroup().getRhythmColumn();
   }
+  /**
+   * Get the measure this note group is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.getNoteGroup().getMeasure();
   }
+  /**
+   * Get staff notation line this note group is in.
+   * @returns - Staff object.
+   */
   getStaff() {
     return this.obj.staff.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MStaffNoteGroup, "Name", "StaffNoteGroup");
 var MStaffNoteGroup = _MStaffNoteGroup;
 var _MTabNoteGroup = class _MTabNoteGroup extends MusicInterface6 {
@@ -7844,19 +8101,36 @@ var _MTabNoteGroup = class _MTabNoteGroup extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get parent note group.
+   * @returns - Parent note group.
+   */
   getNoteGroup() {
     return this.obj.noteGroup.getMusicInterface();
   }
+  /**
+   * Get rhythm column this note group is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.getNoteGroup().getRhythmColumn();
   }
+  /**
+   * Get the measure this note group is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.getNoteGroup().getMeasure();
   }
+  /**
+   * Get guitar tab this note group is in.
+   * @returns - Tab object.
+   */
   getTab() {
     return this.obj.tab.getMusicInterface();
   }
 };
+/** OBject name. */
 __publicField(_MTabNoteGroup, "Name", "TabNoteGroup");
 var MTabNoteGroup = _MTabNoteGroup;
 var _MRest = class _MRest extends MusicInterface6 {
@@ -7869,16 +8143,29 @@ var _MRest = class _MRest extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get rhythm props of this rest.
+   * @returns - Rhythm props.
+   */
   getRhythmProps() {
     return this.obj.rhythmProps;
   }
+  /**
+   * Get rhythm column this rest is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.obj.col.getMusicInterface();
   }
+  /**
+   * Get the measure this rest is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.obj.measure.getMusicInterface();
   }
 };
+/** OBject name. */
 __publicField(_MRest, "Name", "Rest");
 var MRest = _MRest;
 var _MStaffRest = class _MStaffRest extends MusicInterface6 {
@@ -7891,19 +8178,36 @@ var _MStaffRest = class _MStaffRest extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get parent rest object.
+   * @returns - Parent rest object.
+   */
   getRest() {
     return this.obj.rest.getMusicInterface();
   }
+  /**
+   * Get rhythm column this rest is in.
+   * @returns - Rhythm column.
+   */
   getRhythmColumn() {
     return this.getRest().getRhythmColumn();
   }
+  /**
+   * Get the measure this rest is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.getRest().getMeasure();
   }
+  /**
+   * Get staff notation line this rest is in.
+   * @returns - Staff object.
+   */
   getStaff() {
     return this.obj.staff.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MStaffRest, "Name", "StaffRest");
 var MStaffRest = _MStaffRest;
 var _MRhythmColumn = class _MRhythmColumn extends MusicInterface6 {
@@ -7916,19 +8220,36 @@ var _MRhythmColumn = class _MRhythmColumn extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get symbol (note group or rest) of this column for given voice id.
+   * @param voiceId - Voice id.
+   * @returns - Note group, rest or undefined.
+   */
   getRhythmSymbol(voiceId) {
     var _a;
     assertArg2(isVoiceId2(voiceId), "voiceId", voiceId);
     return (_a = this.obj.getVoiceSymbol(voiceId)) == null ? void 0 : _a.getMusicInterface();
   }
+  /**
+   * Get symbol (note group or rest) of this column for given voice id.
+   * @deprecated - Use getRhythmSymbol(voiceId) instead.
+   * @param voiceId - Voice id.
+   * @returns - Note group, rest or undefined.
+   */
+  getVoiceSymbol(voiceId) {
+    var _a;
+    assertArg2(isVoiceId2(voiceId), "voiceId", voiceId);
+    return (_a = this.obj.getVoiceSymbol(voiceId)) == null ? void 0 : _a.getMusicInterface();
+  }
+  /**
+   * Get the measure this rhythm column is in.
+   * @returns - Measure.
+   */
   getMeasure() {
     return this.obj.measure.getMusicInterface();
   }
-  getVoiceSymbol(voiceId) {
-    let s = this.obj.getVoiceSymbol(voiceId);
-    return s instanceof ObjNoteGroup || s instanceof ObjRest ? s.getMusicInterface() : void 0;
-  }
 };
+/** OBject name. */
 __publicField(_MRhythmColumn, "Name", "RhythmColumn");
 var MRhythmColumn = _MRhythmColumn;
 var _MScoreRow = class _MScoreRow extends MusicInterface6 {
@@ -7941,16 +8262,29 @@ var _MScoreRow = class _MScoreRow extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Parent music document.
+   * @returns - Parent music document.
+   */
   getDocument() {
     return this.obj.doc.getMusicInterface();
   }
+  /**
+   * Get measures of this score row.
+   * @returns - Array of measures.
+   */
   getMeasures() {
     return this.obj.getMeasures().map((m) => m.getMusicInterface());
   }
+  /**
+   * Get notation lines (staves and tabs) of this score row.
+   * @returns - Array of staves and tabs.
+   */
   getNotationLines() {
     return this.obj.getNotationLines().map((line) => getNotationLine(line));
   }
 };
+/** Object name. */
 __publicField(_MScoreRow, "Name", "ScoreRow");
 var MScoreRow = _MScoreRow;
 var _MStaff = class _MStaff extends MusicInterface6 {
@@ -7963,16 +8297,29 @@ var _MStaff = class _MStaff extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get index of this staff in score row.
+   * @returns - Index (0=top notation line).
+   */
   getId() {
     return this.obj.id;
   }
+  /**
+   * Get name of this staff.
+   * @returns - Staff name.
+   */
   getName() {
     return this.obj.name.length > 0 ? this.obj.name : void 0;
   }
+  /**
+   * Get the score row this staff is in.
+   * @returns - Score row.
+   */
   getRow() {
     return this.obj.row.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MStaff, "Name", "Staff");
 var MStaff = _MStaff;
 var _MTab = class _MTab extends MusicInterface6 {
@@ -7985,16 +8332,29 @@ var _MTab = class _MTab extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get index of this guitar tab in score row.
+   * @returns - Index (0=top notation line).
+   */
   getId() {
     return this.obj.id;
   }
+  /**
+   * Get name of this guitar tab.
+   * @returns - Staff name.
+   */
   getName() {
     return this.obj.name.length > 0 ? this.obj.name : void 0;
   }
+  /**
+   * Get the score row this guitar tab is in.
+   * @returns - Score row.
+   */
   getRow() {
     return this.obj.row.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MTab, "Name", "Tab");
 var MTab = _MTab;
 var _MSignature = class _MSignature extends MusicInterface6 {
@@ -8007,10 +8367,15 @@ var _MSignature = class _MSignature extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get staff notation line this signature is in.
+   * @returns - Staff object.
+   */
   getStaff() {
     return this.obj.staff.getMusicInterface();
   }
 };
+/** Object name. */
 __publicField(_MSignature, "Name", "Signature");
 var MSignature = _MSignature;
 var _MSpecialText = class _MSpecialText extends MusicInterface6 {
@@ -8023,10 +8388,15 @@ var _MSpecialText = class _MSpecialText extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get text content.
+   * @returns - Text content.
+   */
   getText() {
     return this.obj.getText();
   }
 };
+/** Object name. */
 __publicField(_MSpecialText, "Name", "SpecialText");
 var MSpecialText = _MSpecialText;
 var _MText = class _MText extends MusicInterface6 {
@@ -8039,10 +8409,15 @@ var _MText = class _MText extends MusicInterface6 {
   getMusicObject() {
     return this.obj;
   }
+  /**
+   * Get text content.
+   * @returns - Text content.
+   */
   getText() {
     return this.obj.getText();
   }
 };
+/** Object name. */
 __publicField(_MText, "Name", "Text");
 var MText = _MText;
 var _MExtensionLine = class _MExtensionLine extends MusicInterface6 {
@@ -8056,33 +8431,69 @@ var _MExtensionLine = class _MExtensionLine extends MusicInterface6 {
     return this.obj;
   }
 };
+/** OBject name. */
 __publicField(_MExtensionLine, "Name", "ExtensionLine");
 var MExtensionLine = _MExtensionLine;
+
+// src/score/pub/music-interface.ts
+var import_core20 = 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}`);
+  }
+}
+function require_t(t, message) {
+  if (t === void 0 || t === null) {
+    throw new TypeError(message);
+  } else {
+    return t;
+  }
+}
 var _MPlayer = class _MPlayer {
-  constructor(doc, fn) {
+  /**
+   * Create new music player.
+   * @param doc - Music document to play.
+   * @param playStateChangeListener - Play state change listener.
+   */
+  constructor(doc, playStateChangeListener) {
     __publicField(this, "player");
-    assertArg2(doc instanceof MDocument2, "doc", doc);
-    assertArg2(import_ts_utils_lib14.Utils.Is.isFunctionOrUndefined(fn), "playStateChangeListener", fn);
+    assertArg3(doc instanceof MDocument2, "doc", doc);
+    assertArg3(import_ts_utils_lib15.Utils.Is.isFunctionOrUndefined(playStateChangeListener), "playStateChangeListener", playStateChangeListener);
     this.player = new Player();
     this.player.setDocument(doc.getMusicObject());
     this.player.setCursorPositionChangeListener((cursorRect) => doc.getMusicObject().updateCursorRect(cursorRect));
-    if (fn) {
-      this.player.setPlayStateChnageListener(fn);
+    if (playStateChangeListener) {
+      this.player.setPlayStateChnageListener(playStateChangeListener);
     }
   }
+  /**
+   * Stop all playing.
+   */
   static stopAll() {
     this.currentlyPlaying.forEach((p) => p.stop());
     Audio2.stop();
   }
+  /**
+   * Playe attached document.
+   * @returns - This player instance.
+   */
   play() {
     _MPlayer.currentlyPlaying.add(this);
     this.player.play();
     return this;
   }
+  /**
+   * Pause playback of attached document.
+   * @returns - This player instance.
+   */
   pause() {
     this.player.pause();
     return this;
   }
+  /**
+   * Stop playback of attached document.
+   * @returns - This player instance.
+   */
   stop() {
     this.player.stop();
     _MPlayer.currentlyPlaying.delete(this);
@@ -8092,33 +8503,61 @@ var _MPlayer = class _MPlayer {
 __publicField(_MPlayer, "currentlyPlaying", /* @__PURE__ */ new Set());
 var MPlayer = _MPlayer;
 var MRenderer2 = class {
+  /**
+   * Create new renderer instance.
+   */
   constructor() {
     __publicField(this, "renderer");
     this.renderer = new Renderer(this);
   }
+  /**
+   * Attach music document to this renderer.
+   * @param doc - Music document.
+   * @returns - This renderer instance.
+   */
   setDocument(doc) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
+    assertArg3(import_ts_utils_lib15.Utils.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
     this.renderer.setDocument(doc);
     return this;
   }
+  /**
+   * Set target canvas html element for this renderer.
+   * @param canvas - HTML canvas element or element id.
+   * @returns - This renderer instance.
+   */
   setCanvas(canvas) {
-    canvas = require_t(import_ts_utils_lib14.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_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.");
     this.renderer.setCanvas(canvas);
     return this;
   }
-  setScoreEventListener(fn) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isFunctionOrUndefined(fn), "scoreEventListener", fn);
-    this.renderer.setScoreEventListener(fn);
+  /**
+   * Set score event listener.
+   * @param scoreEventListener - Score event listener.
+   */
+  setScoreEventListener(scoreEventListener) {
+    assertArg3(import_ts_utils_lib15.Utils.Is.isFunctionOrUndefined(scoreEventListener), "scoreEventListener", scoreEventListener);
+    this.renderer.setScoreEventListener(scoreEventListener);
   }
+  /**
+   * Draw given music object hilighted.
+   * @param obj - Music object or undefined to remove hilighting.
+   */
   hilightObject(obj) {
     this.renderer.hilightObject(obj == null ? void 0 : obj.getMusicObject());
   }
+  /**
+   * Draw given staff position hilighted.
+   * @param staffPos - Staff position (score row and diatonic id) or undefined to remove hilighting.
+   */
   hilightStaffPos(staffPos) {
     this.renderer.hilightStaffPos(staffPos ? {
       scoreRow: staffPos.scoreRow.getMusicObject(),
       diatonicId: staffPos.diatonicId
     } : void 0);
   }
+  /**
+   * Draw contents of attached music document to attached canvas.
+   */
   draw() {
     try {
       this.renderer.draw();
@@ -8129,6 +8568,9 @@ var MRenderer2 = class {
   }
 };
 var _MPlaybackButtons = class _MPlaybackButtons {
+  /**
+   * Create new playback buttons helper class instance.
+   */
   constructor() {
     __publicField(this, "playButton");
     __publicField(this, "stopButton");
@@ -8161,8 +8603,13 @@ var _MPlaybackButtons = class _MPlaybackButtons {
     };
     this.updateButtons();
   }
+  /**
+   * Attach music document whose playcak will be controlled by this playback buttons helper class instance.
+   * @param doc - Music document.
+   * @returns 
+   */
   setDocument(doc) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
+    assertArg3(import_ts_utils_lib15.Utils.Is.isUndefined(doc) || doc instanceof MDocument2, "doc", doc);
     this.onStop();
     if (doc) {
       this.player = new MPlayer(doc, (playState) => {
@@ -8175,6 +8622,9 @@ var _MPlaybackButtons = class _MPlaybackButtons {
     this.updateButtons();
     return this;
   }
+  /**
+   * Detach attached music document.
+   */
   detachDocument() {
     this.setDocument(void 0);
   }
@@ -8196,31 +8646,50 @@ var _MPlaybackButtons = class _MPlaybackButtons {
       this.pauseButton.innerText = this.pauseLabel;
     }
   }
+  /**
+   * Set play button.
+   * @param btn - HTML button element or element id.
+   * @param btnLabel - Custom button label (e.g. "Play").
+   * @returns - This playback buttons class instance.
+   */
   setPlayButton(btn, btnLabel) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.playButton, this.onPlay);
-    this.playButton = require_t(import_ts_utils_lib14.Utils.Dom.getButton(btn), "Play button required!");
+    this.playButton = require_t(import_ts_utils_lib15.Utils.Dom.getButton(btn), "Play button required!");
     this.playLabel = btnLabel != null ? btnLabel : "Play";
     _MPlaybackButtons.removeOnClickListeners(this.playButton, "all");
     _MPlaybackButtons.addOnClickListener(this.playButton, this.onPlay);
     this.updateButtons();
     return this;
   }
+  /**
+   * Set stop button.
+   * @param btn - HTML button element or element id.
+   * @param btnLabel - Custom button label (e.g. "Stop").
+   * @returns - This playback buttons class instance.
+   */
   setStopButton(btn, btnLabel) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.stopButton, this.onStop);
-    this.stopButton = require_t(import_ts_utils_lib14.Utils.Dom.getButton(btn), "Stop button required!");
+    this.stopButton = require_t(import_ts_utils_lib15.Utils.Dom.getButton(btn), "Stop button required!");
     this.stopLabel = btnLabel != null ? btnLabel : "Stop";
     _MPlaybackButtons.removeOnClickListeners(this.stopButton, "all");
     _MPlaybackButtons.addOnClickListener(this.stopButton, this.onStop);
     this.updateButtons();
     return this;
   }
+  /**
+   * Set play/stop button.
+   * @param btn - HTML button element or element id.
+   * @param playLabel - Custom button label for play action (e.g. "Play").
+   * @param stopLabel - Custom button label for stop action (e.g. "Stop").
+   * @returns - This playback buttons class instance.
+   */
   setPlayStopButton(btn, playLabel, stopLabel) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isStringOrUndefined(playLabel), "playLabel", playLabel);
-    assertArg2(import_ts_utils_lib14.Utils.Is.isStringOrUndefined(stopLabel), "stopLabel", stopLabel);
+    assertArg3(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(playLabel), "playLabel", playLabel);
+    assertArg3(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(stopLabel), "stopLabel", stopLabel);
     _MPlaybackButtons.removeOnClickListeners(this.playStopButton, this.onPlayStop);
-    this.playStopButton = require_t(import_ts_utils_lib14.Utils.Dom.getButton(btn), "Play/stop button required!");
+    this.playStopButton = require_t(import_ts_utils_lib15.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");
@@ -8228,10 +8697,16 @@ var _MPlaybackButtons = class _MPlaybackButtons {
     this.updateButtons();
     return this;
   }
+  /**
+   * Set pause button.
+   * @param btn - HTML button element or element id.
+   * @param btnLabel - Custom button label (e.g. "Pause").
+   * @returns - This playback buttons class instance.
+   */
   setPauseButton(btn, btnLabel) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
+    assertArg3(import_ts_utils_lib15.Utils.Is.isStringOrUndefined(btnLabel), "btnLabel", btnLabel);
     _MPlaybackButtons.removeOnClickListeners(this.pauseButton, this.onPause);
-    this.pauseButton = require_t(import_ts_utils_lib14.Utils.Dom.getButton(btn), "Pause button required!");
+    this.pauseButton = require_t(import_ts_utils_lib15.Utils.Dom.getButton(btn), "Pause button required!");
     this.pauseLabel = btnLabel != null ? btnLabel : "Pause";
     _MPlaybackButtons.removeOnClickListeners(this.pauseButton, "all");
     _MPlaybackButtons.addOnClickListener(this.pauseButton, this.onPause);
@@ -8253,7 +8728,7 @@ var _MPlaybackButtons = class _MPlaybackButtons {
     }
   }
   static addOnClickListener(btn, onClick) {
-    assertArg2(import_ts_utils_lib14.Utils.Is.isFunction(onClick), "onClick", onClick);
+    assertArg3(import_ts_utils_lib15.Utils.Is.isFunction(onClick), "onClick", onClick);
     btn.addEventListener("click", onClick);
     let clickListeners = this.savedOnClickListeners.get(btn) || [];
     this.savedOnClickListeners.set(btn, [...clickListeners, onClick]);
@@ -8263,8 +8738,8 @@ __publicField(_MPlaybackButtons, "savedOnClickListeners", /* @__PURE__ */ new Ma
 var MPlaybackButtons = _MPlaybackButtons;
 
 // src/score/index.ts
-var import_core20 = require("@tspro/web-music-score/core");
-(0, import_core20.init)();
+var import_core21 = require("@tspro/web-music-score/core");
+(0, import_core21.init)();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Annotation,
@@ -8273,6 +8748,7 @@ var import_core20 = require("@tspro/web-music-score/core");
   Connective,
   DivRect,
   DocumentBuilder,
+  DynamicsAnnotation,
   Fermata,
   Label,
   MAccidental,
@@ -8314,6 +8790,7 @@ var import_core20 = require("@tspro/web-music-score/core");
   ScoreStaffPosEvent,
   StaffPreset,
   Stem,
+  TempoAnnotation,
   TieType,
   VerticalPosition,
   getStringNumbers,